@foggy-projects/deepseek-harness-plugin 0.4.0-rc.3 → 0.4.1-rc.1

package/README.md

@@ -7,23 +7,38 @@ are downloaded only when the user selects **Initialize and start** (or the
 equivalent component action). Existing installations are not silently changed
 when the plugin package is upgraded.
 
-DeepSeek Harness uses a system Node.js (`^22.19.0 || >=24.0.0`) and Foggy's Java
-Launcher uses a system Java 17+. Foggy manages its own pinned Python 3.12 runtime
+The `0.4.1-rc.1` compatibility candidate targets DeepSeek Harness `0.1.5-rc.2`
+and requires a system Node.js `>=24.0.0`. Foggy's Java Launcher uses a system
+Java 17+. Foggy manages its own pinned Python 3.12 runtime
 inside the per-user component directory; it does not require a system Python,
 modify `PATH`, or register Python globally. Advanced users may explicitly set
 `FOGGY_PYTHON` to a compatible Python 3.11+ executable.
 
-## Local beta installation
+## Local release-candidate installation
 
 ```powershell
-dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.0-rc.3.tgz
+dsh plugin --profile web add --workspace-root ./foggy-projects-deepseek-harness-plugin-0.4.1-rc.1.tgz
 ```
 
 Restart `dsh web`, use the browser it opens (or the complete printed URL,
 including `?token=...`), open Settings → Plugins → Foggy Data Analysis, and
 initialize the components from there. Do not share the launch-token URL.
 
-After npm beta publication, the corresponding one-line install is:
+For the DSH 0.1.5-rc.2 compatibility pre-release, install the exact candidate
+so the stable `beta` channel is not changed:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.1-rc.1
+```
+
+The published candidate is also available through the dedicated `dsh015` npm
+dist-tag:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@dsh015
+```
+
+For the existing stable beta channel, the corresponding one-line install is:
 
 ```powershell
 dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@beta
@@ -36,7 +51,7 @@ versions. Updates are blocked while Runtime is running so the active Java
 process and the next-launcher state cannot diverge. Component-specific repair
 actions remain available under **Advanced repair**.
 
-DeepSeek Harness 0.1.2-rc.1 applies pnpm's minimum-release-age policy to its
+DeepSeek Harness 0.1.5-rc.2 applies pnpm's minimum-release-age policy to its
 profile lockfile. An upgrade performed shortly after publication can therefore
 fail while naming either the new plugin or the previously installed Beta. This
 is a DSH profile-policy failure, not a damaged Foggy package. Use the exact
@@ -113,10 +128,21 @@ rollback plan.
 
 See [`docs/PUBLIC-BETA-READINESS.md`](./docs/PUBLIC-BETA-READINESS.md) for the
 tested public Beta scope, release gates, and stable-release blockers.
+The DSH 0.1.5-rc.2 compatibility candidate is documented in
+[`docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md`](./docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md).
 Native Windows acceptance instructions are in
 [`docs/WINDOWS-BETA-ACCEPTANCE.md`](./docs/WINDOWS-BETA-ACCEPTANCE.md); database
 credentials intentionally remain outside the public repository.
 
+## Community discovery
+
+DeepSeek Harness does not currently publish a first-party plugin marketplace.
+For discoverability, this repository is intended to carry the GitHub
+[`dsh-plugin`](https://github.com/topics/dsh-plugin) topic. Independent community
+directories and their submission rules are tracked in
+[`docs/COMMUNITY-MARKETPLACES.md`](./docs/COMMUNITY-MARKETPLACES.md); inclusion in
+any directory is community curation, not an endorsement by DeepSeek or Foggy.
+
 ## Linux and WSL2 experience
 
 Ubuntu and WSL2 users can use the checked-in preflighted installer under

package/docs/COMMUNITY-MARKETPLACES.md

@@ -0,0 +1,64 @@
+# DeepSeek Harness 社区插件目录准备
+
+状态记录：2026-09-06。DeepSeek Harness 官方页面仍标注为开发者预览版，
+官方公开入口是源码、开发者文档、GitHub `dsh-plugin` Topic 和社区讨论，
+目前没有看到官方一方插件市场或官方审核收录入口。
+
+## 推荐顺序
+
+### 1. `awesome-dsh-plugin`（优先提交）
+
+- 目录仓库：<https://github.com/awesome-dsh-plugin/awesome-dsh-plugin>
+- 提交方式：向该仓库提交 PR，只新增一个
+  `data/plugins/foggy-projects__foggy-deepseek-harness-plugin.yml` 文件。
+- 主要要求：真实可用代码、仓库至少存在 1 天、添加 `dsh-plugin` Topic、
+  描述准确且不使用夸张营销语句、根包声明 `dsh.bundle`。
+- 可选增强：在 npm 发布包中保留正确的 `repository` 字段；如提供 GitHub
+  Release `.tgz`，可在条目中声明固定版本的 `tarball`。
+- 评审说明：CI 检查格式和 manifest，维护者会阅读目标仓库；收录不等于
+  安全审计或官方认证。
+
+建议条目草稿：
+
+```yaml
+url: https://github.com/foggy-projects/foggy-deepseek-harness-plugin
+name: foggy-projects/foggy-deepseek-harness-plugin
+category: tools
+description:
+  en: Foggy Java data-analysis integration for DeepSeek Harness with a managed Runtime, CLI, Launcher, onboarding Skills, and semantic-layer workflows.
+  zh: 在 DeepSeek Harness 中管理 Foggy Java 数据分析 Runtime、CLI、Launcher 与 onboarding/语义查询 Skill，支持数据库接入和语义层建模。
+```
+
+### 2. `dsh-market`（市场应用，目录来自上游）
+
+- 项目：<https://github.com/dsh-market/dsh-market>
+- 它是可安装到 DSH 设置页的社区市场应用，本身不是目录数据源。
+- 目录来自 `awesome-dsh-plugin`；其说明要求向上游目录提交 PR，
+  市场会自动同步，通常不需要重复提交到 `dsh-market`。
+- 适合验证“一键安装”体验，但它不是 DeepSeek 官方产品。
+
+### 3. `DSH-Plugins-Marketplace`（Topic 自动聚合）
+
+- 项目：<https://github.com/bradeGithub/DSH-Plugins-Marketplace>
+- 通过 GitHub `dsh-plugin` Topic 自动聚合，项目讨论中说明无需手工 PR，
+  Topic 出现后等待索引刷新即可。
+- 它会安装到 DSH Web profile，适合做第二个发现入口；必须标注为第三方市场。
+
+### 4. `dshplugin.app`（独立目录与证据页）
+
+- 目录：<https://dshplugin.app/>
+- 支持提交公开 GitHub 仓库，随后进行源码、manifest、依赖、安装路径和兼容性
+  信号分析。
+- 页面明确声明其为独立社区项目，不隶属于 DeepSeek；“Indexed”不等于安全认证。
+- 适合补充兼容性说明和安全信号展示，但不应把它描述为官方市场。
+
+## 当前可执行清单
+
+1. 保持当前 npm `rc` 预发布与 GitHub Release，不切换 `latest`。
+2. 给 GitHub 仓库添加 `dsh-plugin` Topic；可同时保留
+   `deepseek-harness`、`data-analysis`、`semantic-layer` 等描述性 Topic。
+3. 确认下一次 npm 发布继续携带 `repository`、`homepage`、`bugs` 和
+   `dsh-plugin` keywords，便于目录把 npm 包与源码仓库关联。
+4. 优先向 `awesome-dsh-plugin` 提交上面的单文件 PR，再等待 `dsh-market`
+   同步；随后向 `dshplugin.app` 提交公开仓库 URL。
+5. 对外文案统一使用“社区目录/第三方市场”，不使用“官方市场/官方认证”。

package/docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md

@@ -0,0 +1,60 @@
+# Foggy DeepSeek Harness plugin 0.4.1-rc.1
+
+This release candidate is the compatibility line for DeepSeek Harness
+`0.1.5-rc.2`. It is published as a separate pre-release so the existing
+`0.4.0-rc.3`/`beta` installation path remains unchanged while the new Harness
+client is evaluated.
+
+## Compatibility changes
+
+- Align DSH peer packages with `0.1.5-rc.2` and Cordis `4.0.2`.
+- Remove the obsolete `@deepseek-ai/dsh-client-runtime` injection. DSH
+  `0.1.5-rc.2` does not ship that package and the plugin does not use its API.
+- Require Node.js `>=24.0.0`. DSH 0.1.5 uses modern ESM entry-point behavior;
+  the plugin fails early with a visible prerequisite error on older Node lines.
+- Pin the onboarding manifest to DSH `0.1.5-rc.2` and keep the Foggy CLI,
+  Launcher, and Skills pins unchanged.
+
+The plugin's remote service, native Skill provider, locale registration, and
+Settings → Plugins tab continue to use the same public APIs. The DSH 0.1.5
+web client adds file/sidebar features, but none of those changes are required
+by Foggy's integration.
+
+## Installation
+
+Use Node.js 24 or newer and install the exact candidate in a separate profile:
+
+```powershell
+dsh plugin --profile web add --workspace-root @foggy-projects/deepseek-harness-plugin@0.4.1-rc.1
+dsh web
+```
+
+The npm `dsh015` dist-tag points to this candidate. Existing users of the
+stable `beta` tag are not moved automatically.
+
+## Verification gate
+
+The candidate must pass all of the following before it replaces the stable
+baseline:
+
+1. npm package shape and Node syntax checks;
+2. the repository onboarding/unit test suite;
+3. a clean DSH `0.1.5-rc.2` profile can add the package without an impossible
+   `dsh-client-runtime` peer resolution;
+4. `dsh --version` reports `0.1.5-rc.2` and `dsh web --no-open` starts under
+   Node 24;
+5. the web Settings → Plugins page loads Foggy's tab, native Skills are
+   discoverable, and the plugin status remote responds;
+6. Foggy initialization remains development-only and does not restart a
+   healthy Runtime during datasource/model onboarding.
+
+The candidate does not change Foggy Runtime/Launcher binaries or production
+deployment policy. If a DSH profile reports
+`ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`, rebuild only that profile's lockfile
+and retry the exact add command; do not disable pnpm's policy globally.
+
+## Upstream references
+
+- [DeepSeek Harness v0.1.5-rc.2 release](https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.5-rc.2)
+- [DeepSeek Harness release history](https://github.com/deepseek-ai/deepseek-harness/releases)
+- [Node entry-point compatibility discussion](https://github.com/deepseek-ai/deepseek-harness/discussions/6124)

package/experience/linux/README.md

@@ -5,7 +5,7 @@ It has been designed for Ubuntu 22.04/24.04 x86_64 and WSL2.
 
 ## Prerequisites
 
-- Node.js `^22.19.0` or `>=24.0.0`
+- Node.js `>=24.0.0` (the DSH 0.1.5-rc.2 compatibility candidate)
 - Java 17 or newer
 - Git, npm, and `tar`
 - At least 4 GiB free disk space and 2 GiB available memory; 4 GiB memory is recommended
@@ -22,7 +22,7 @@ bash experience/linux/prepare.sh --dry-run
 bash experience/linux/prepare.sh
 ```
 
-The script installs pinned pnpm and DeepSeek Harness versions inside
+The script installs pinned pnpm and DeepSeek Harness 0.1.5-rc.2 inside
 `~/.local/share/foggy-deepseek-harness-experience`, clones and packs the public Foggy Bundle, and
 adds it to a clean DSH web profile. It does not use `sudo`, install operating-system packages, write
 model credentials, initialize Foggy components, or start the web process.

package/experience/linux/prepare.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-DSH_VERSION="0.1.2-rc.1"
+DSH_VERSION="0.1.5-rc.2"
 PNPM_VERSION="11.7.0"
-PLUGIN_VERSION="0.4.0-rc.1"
+PLUGIN_VERSION="0.4.1-rc.1"
 PLUGIN_REF="v${PLUGIN_VERSION}"
 PLUGIN_REPOSITORY="https://github.com/foggy-projects/foggy-deepseek-harness-plugin.git"
 
@@ -73,8 +73,8 @@ require_command git
 require_command df
 require_command tar
 
-node -e 'const [major, minor] = process.versions.node.split(".").map(Number); if (!((major === 22 && minor >= 19) || major >= 24)) process.exit(1)' \
-  || fail "Node ^22.19.0 or >=24 required; detected $(node --version 2>/dev/null || echo unknown)"
+node -e 'const [major] = process.versions.node.split(".").map(Number); if (major < 24) process.exit(1)' \
+  || fail "Node >=24 required for DeepSeek Harness 0.1.5-rc.2; detected $(node --version 2>/dev/null || echo unknown)"
 
 java_major="$(java -version 2>&1 | awk -F'[\".]' '/version/ { print $2; exit }')"
 [[ "$java_major" =~ ^[0-9]+$ ]] || fail "could not detect Java version"

package/lib/index.js

@@ -155,7 +155,7 @@ async function runOnboarding(args, timeout = 15 * 60_000, options = {}) {
 
 async function assertSystemPrerequisites(kind) {
   if (kind === 'initialize' && !compatibleNode(process.versions.node)) {
-    throw new Error(`DeepSeek Harness requires Node.js ^22.19.0 or >=24.0.0; detected ${process.versions.node}`)
+    throw new Error(`DeepSeek Harness 0.1.5-rc.2 requires Node.js >=24.0.0; detected ${process.versions.node}`)
   }
   if (kind === 'initialize' || kind === 'runtime-start') {
     const java = compatible(await commandVersion(process.env.JAVA_EXE || 'java', ['-version']), '17.0')

package/lib/version.js

@@ -15,6 +15,6 @@ export function compatible(probe, minimum) {
 }
 
 export function compatibleNode(version) {
-  const [major, minor] = String(version).split('.').map(Number)
-  return (major === 22 && minor >= 19) || major >= 24
+  const [major] = String(version).split('.').map(Number)
+  return major >= 24
 }

package/package.json

@@ -1,7 +1,24 @@
 {
   "name": "@foggy-projects/deepseek-harness-plugin",
-  "version": "0.4.0-rc.3",
+  "version": "0.4.1-rc.1",
   "description": "Foggy Java data analysis engine integration for DeepSeek Harness",
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "foggy",
+    "data-analysis",
+    "semantic-layer",
+    "runtime"
+  ],
+  "homepage": "https://github.com/foggy-projects/foggy-deepseek-harness-plugin#readme",
+  "bugs": {
+    "url": "https://github.com/foggy-projects/foggy-deepseek-harness-plugin/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/foggy-projects/foggy-deepseek-harness-plugin.git"
+  },
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
@@ -22,13 +39,15 @@
     "docs/PUBLIC-BETA-READINESS.md",
     "docs/RELEASE-CANDIDATE-0.4.0-RC.2.md",
     "docs/RELEASE-CANDIDATE-0.4.0-RC.3.md",
+    "docs/RELEASE-CANDIDATE-0.4.1-DSH-0.1.5-RC.1.md",
+    "docs/COMMUNITY-MARKETPLACES.md",
     "docs/WINDOWS-BETA-ACCEPTANCE.md",
     "THIRD-PARTY-RUNTIME-NOTICES.md",
     "README.md"
   ],
   "license": "Apache-2.0",
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": ">=24.0.0"
   },
   "dsh": {
     "bundle": {
@@ -38,7 +57,6 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-api-remotes",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-settings-plugins"
@@ -49,14 +67,13 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-skill": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1"
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-skill": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2"
   },
   "scripts": {
     "check": "node --check lib/index.js && node --check lib/atomic-json.js && node --check lib/diagnostics.js && node --check lib/python-runtime.js && node --check lib/runtime-settings.js && node --check lib/skill-provider.js && node --check lib/client.js && node --check lib/typert.js && node --check lib/remote.js",

package/skills/foggy-deepseek-onboarding/assets/versions.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": "foggy-deepseek-onboarding-versions/v1",
-  "packageVersion": "0.4.0-rc.3",
-  "validatedAt": "2026-09-06",
+  "packageVersion": "0.4.1-rc.1",
+  "validatedAt": "2026-09-13",
   "components": {
     "deepseekHarness": {
-      "version": "0.1.2-rc.1",
-      "minimumNodeVersion": "22.19.0"
+      "version": "0.1.5-rc.2",
+      "minimumNodeVersion": "24.0.0"
     },
     "python": {
       "version": "3.12.13",