@stardustlc/dsh-suite 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +18 -5
- package/README.md +19 -6
- package/package.json +23 -4
package/README.en.md
CHANGED
|
@@ -10,20 +10,20 @@ Bundles five product lines — office flow (with dream-based memory), media stud
|
|
|
10
10
|
|
|
11
11
|
## Compatibility
|
|
12
12
|
|
|
13
|
-
Verified against `@deepseek-ai/dsh@0.1.
|
|
13
|
+
Verified against official `@deepseek-ai/dsh@0.1.5-rc.1` and Node `24.16.0` on 2026-09-11: 18 components plus separately installed Modlens register 97 host tools and 34 skills. All component tool schemas and both PTC SDK generators pass; Minimal PTC mounts in a real agent and exposes `run_code` to the model. Isolated Web startup, token authentication (303/401/200) and process shutdown pass. Requires Node 22.19 or later within 22.x, or 24 or later. The scripts below reproduce these checks; offline tests do not establish live external-service readiness.
|
|
14
14
|
|
|
15
15
|
## Install / Uninstall
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
Installing the suite automatically installs the verified versions of all 18 components. The profile activates one suite layer, which loads the components:
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
dsh plugin --profile web add @stardustlc/dsh-suite
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
Alternatively, install the suite source from GitHub; its components still come from npm:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
dsh plugin --profile web add github:STARDUSTLC666/dsh-suite
|
|
26
|
+
dsh plugin --profile web add github:STARDUSTLC666/dsh-suite
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
```bash
|
|
@@ -32,6 +32,16 @@ dsh plugin --profile web remove @stardustlc/dsh-suite
|
|
|
32
32
|
|
|
33
33
|
Restart the web service afterwards. Prefer a single component? Install its own repo directly without this suite.
|
|
34
34
|
|
|
35
|
+
### Migrate an older suite installation
|
|
36
|
+
|
|
37
|
+
If the suite and all components were previously installed as direct dependencies, first upgrade the suite to 0.1.3 or later with the command above, then remove the components' direct-install records. They remain installed as suite dependencies, avoiding the `duplicate loader entry id` startup failure:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
dsh plugin --profile web remove @stardustlc/dsh-docker @stardustlc/dsh-dream dsh-calendar dsh-cite dsh-code-security dsh-codex-port dsh-dingtalk dsh-email dsh-ffmpeg dsh-flakefinder dsh-hyperframes dsh-minimal-ptc dsh-ppt dsh-remotion dsh-rss dsh-slack dsh-sql dsh-voice
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Keep your profile's `cordis.patch.yml` configuration overrides, then restart Web.
|
|
44
|
+
|
|
35
45
|
## What's inside (18)
|
|
36
46
|
|
|
37
47
|
| Line | Component | Capability |
|
|
@@ -74,11 +84,14 @@ Place the 18 component checkouts beside `dsh-suite`, with development dependenci
|
|
|
74
84
|
node scripts/verify-local.mjs --harness-root C:/path/to/deepseek-harness --report ../.harness-validation/offline-report.json
|
|
75
85
|
node scripts/verify-local.mjs --harness-root C:/path/to/deepseek-harness --contracts-only --json
|
|
76
86
|
node scripts/smoke-harness.mjs --harness-root C:/path/to/deepseek-harness --contract-report ../.harness-validation/offline-report.json --report ../.harness-validation/smoke-report.json
|
|
87
|
+
node scripts/smoke-harness.mjs --harness-root C:/path/to/deepseek-harness --install-tarballs ../.harness-validation/tarballs.json --contract-report ../.harness-validation/offline-report.json --report ../.harness-validation/install-report.json
|
|
77
88
|
```
|
|
78
89
|
|
|
79
90
|
`--workspace-root` selects the parent of the component repositories. `--report` saves JSON, `--json` prints only JSON, and failures return a nonzero exit status. `--contracts-only` validates existing `lib/` artifacts without rebuilding or running unit tests.
|
|
80
91
|
|
|
81
|
-
|
|
92
|
+
Use `--install-tarballs` before release to test installation. The report must contain `{ "ok": true, "packages": [{ "name", "version", "tarball", "integrity" }] }` for the suite and all 18 components, with `sha512-...` integrity values. Only the temporary profile redirects those versions to local tarballs. The official CLI installs the suite; verification requires transitive component dependencies, no duplicate profile layers, successful startup, the complete registry and PTC mounting. Dependency installation can contact npm; this mode is not an offline test.
|
|
93
|
+
|
|
94
|
+
Contracts use the selected Harness's real `ToolRuntime` and `SkillRegistry`: required service declarations, all parameter/output schemas, skill registrations and collisions, both PTC SDKs, and the execution/rendering of 16 health fixtures plus `ppt_themes`. The preset is materialized in an isolated home and its Harness module references are resolved. Startup verification also mounts it in a real agent, requiring `run_code` as the model entry point and retention of plugin tools and the shell. Only these read-only output samples are executed; other business workflows rely on the component unit tests and mocked dependencies.
|
|
82
95
|
|
|
83
96
|
HyperFrames and Remotion also undergo a real registry regression: remove one registered skill and require unhealthy status, then restore the matching registration and require healthy status. The startup smoke check executes both health tools and requires all bundled skills to be active.
|
|
84
97
|
|
package/README.md
CHANGED
|
@@ -10,24 +10,34 @@
|
|
|
10
10
|
|
|
11
11
|
## 兼容性
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
已在官方 `@deepseek-ai/dsh@0.1.5-rc.1`、Node `24.16.0` 上验证（2026-09-11）：18 个组件与额外安装的 Modlens 同载，宿主共注册 97 个工具、34 个技能。全部组件工具 schema 与两种 PTC SDK 生成检查通过；极简 PTC 已在真实 agent 中挂载，模型入口为 `run_code`。隔离 Web 启动、token 鉴权（303/401/200）与进程退出通过。Node 要求为 22.19 及以上的 22.x，或 24 及以上。下方脚本可重复验收；离线检查不代表外部服务业务已实测。
|
|
14
14
|
|
|
15
15
|
## 安装
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
安装套件会自动拉取已验证版本的 18 个组件；profile 只启用套件这一层，组件由套件统一加载：
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
dsh plugin --profile web add @stardustlc/dsh-suite
|
|
21
21
|
```
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
也可以从 GitHub 安装套件源码，组件仍从 npm 安装：
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
dsh plugin --profile web add github:STARDUSTLC666/dsh-suite
|
|
26
|
+
dsh plugin --profile web add github:STARDUSTLC666/dsh-suite
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
安装后重启 Web 服务。只想装个别组件？直接装对应仓库即可（如 `github:STARDUSTLC666/dsh-rss`），不需要本套件。
|
|
30
30
|
|
|
31
|
+
### 从旧版全家桶迁移
|
|
32
|
+
|
|
33
|
+
如果之前按旧命令把套件和全部组件一起直装，先执行上方命令升级套件到 0.1.3 或以上，再移除组件的直接安装记录。组件仍保留为套件依赖；这样可避免 `duplicate loader entry id` 启动错误：
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
dsh plugin --profile web remove @stardustlc/dsh-docker @stardustlc/dsh-dream dsh-calendar dsh-cite dsh-code-security dsh-codex-port dsh-dingtalk dsh-email dsh-ffmpeg dsh-flakefinder dsh-hyperframes dsh-minimal-ptc dsh-ppt dsh-remotion dsh-rss dsh-slack dsh-sql dsh-voice
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
保留自己 profile 的 `cordis.patch.yml` 配置覆盖，随后重启 Web 服务。
|
|
40
|
+
|
|
31
41
|
## 卸载
|
|
32
42
|
|
|
33
43
|
```bash
|
|
@@ -75,7 +85,7 @@ dsh plugin --profile web remove @stardustlc/dsh-suite
|
|
|
75
85
|
## 排错
|
|
76
86
|
|
|
77
87
|
- 启动失败：逐个运行组件的 `*_health` 定位；或临时在 profile 补丁里 `disabled: true` 关掉可疑组件；
|
|
78
|
-
-
|
|
88
|
+
- 依赖拉取慢：优先使用上方 npm 安装命令；网络不佳时配置代理后重试。
|
|
79
89
|
|
|
80
90
|
## 开发
|
|
81
91
|
|
|
@@ -90,11 +100,14 @@ pnpm test # 套件清单、文档和离线执行环境的测试
|
|
|
90
100
|
node scripts/verify-local.mjs --harness-root C:/path/to/deepseek-harness --report ../.harness-validation/offline-report.json
|
|
91
101
|
node scripts/verify-local.mjs --harness-root C:/path/to/deepseek-harness --contracts-only --json
|
|
92
102
|
node scripts/smoke-harness.mjs --harness-root C:/path/to/deepseek-harness --contract-report ../.harness-validation/offline-report.json --report ../.harness-validation/smoke-report.json
|
|
103
|
+
node scripts/smoke-harness.mjs --harness-root C:/path/to/deepseek-harness --install-tarballs ../.harness-validation/tarballs.json --contract-report ../.harness-validation/offline-report.json --report ../.harness-validation/install-report.json
|
|
93
104
|
```
|
|
94
105
|
|
|
95
106
|
`--workspace-root` 可指定组件父目录；`--report` 保存 JSON，`--json` 让标准输出只包含 JSON。任何构建、测试或契约失败均返回非零退出码。`--contracts-only` 跳过重建与单元测试，检查当前 `lib/` 产物。
|
|
96
107
|
|
|
97
|
-
|
|
108
|
+
发布前使用 `--install-tarballs` 验证真实安装：报告格式为 `{ "ok": true, "packages": [{ "name", "version", "tarball", "integrity" }] }`，须包含套件和 18 个组件，`integrity` 为 `sha512-...`。验证器只在临时 profile 中将指定版本映射到本地 tarball，经官方 CLI 安装套件，要求组件为传递依赖且不重复启用 profile 层，再检查实际启动、完整目录和 PTC 挂载。开发依赖可能访问 npm；这个安装模式不属于离线测试。
|
|
109
|
+
|
|
110
|
+
契约检查使用指定 Harness 的真实 `ToolRuntime` 和 `SkillRegistry`：逐个校验服务注入声明、全部工具参数与输出 schema、技能注册和重名冲突，生成两种 PTC SDK，再通过宿主执行链运行 16 个 health 与 `ppt_themes` 输出样例。minimal-ptc 会物化到隔离目录，并校验预设引用的 Harness 模块可解析；启动验收还会创建真实 agent 挂载预设，确认模型入口为 `run_code` 且保留插件工具与 Shell。这里只覆盖这些只读样例的返回值；发信、合成、渲染等业务流程由组件测试中的模拟依赖验证。
|
|
98
111
|
|
|
99
112
|
HyperFrames 与 Remotion 另有真实注册表回归：卸载一个已注册技能，确认 health 报告异常，再恢复相同注册并确认 health 恢复正常。启动验收也会执行这两个 health，要求全部随包技能实际生效。
|
|
100
113
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stardustlc/dsh-suite",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"description": "DeepSeek Harness 插件全家桶：18 个组件覆盖邮件、日历、媒体创作、开发运维、消息通知与极简 PTC；通过 npm 一条命令安装，提供组合配置与整套兼容性验证脚本。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"dsh": {
|
|
7
7
|
"bundle": {
|
|
@@ -32,9 +32,28 @@
|
|
|
32
32
|
"access": "public"
|
|
33
33
|
},
|
|
34
34
|
"engines": {
|
|
35
|
-
"node": "
|
|
35
|
+
"node": "^22.19.0 || >=24.0.0"
|
|
36
|
+
},
|
|
37
|
+
"dependencies": {
|
|
38
|
+
"@stardustlc/dsh-docker": "0.3.3",
|
|
39
|
+
"@stardustlc/dsh-dream": "0.3.3",
|
|
40
|
+
"dsh-calendar": "0.5.3",
|
|
41
|
+
"dsh-cite": "0.3.3",
|
|
42
|
+
"dsh-code-security": "0.3.3",
|
|
43
|
+
"dsh-codex-port": "0.2.2",
|
|
44
|
+
"dsh-dingtalk": "0.2.1",
|
|
45
|
+
"dsh-email": "0.10.7",
|
|
46
|
+
"dsh-ffmpeg": "0.4.2",
|
|
47
|
+
"dsh-flakefinder": "0.3.3",
|
|
48
|
+
"dsh-hyperframes": "0.3.2",
|
|
49
|
+
"dsh-minimal-ptc": "0.4.5",
|
|
50
|
+
"dsh-ppt": "0.4.2",
|
|
51
|
+
"dsh-remotion": "0.3.2",
|
|
52
|
+
"dsh-rss": "0.3.2",
|
|
53
|
+
"dsh-slack": "0.3.1",
|
|
54
|
+
"dsh-sql": "0.4.3",
|
|
55
|
+
"dsh-voice": "0.3.3"
|
|
36
56
|
},
|
|
37
|
-
"dependencies": {},
|
|
38
57
|
"devDependencies": {
|
|
39
58
|
"js-yaml": "^4.1.0"
|
|
40
59
|
},
|