dsh-plugin-lab
Manifest validZero-restart acceptance lab for DSH plugins: boots a real cordis Loader and ToolsService in a subprocess, drives the mounted plugin through scenario scripts, and reports PASS/FAIL per check with an ov
dsh-plugin-lab
DSH 插件开发者的实验环境:改完插件代码零重启验收。 在真实 cordis boot + 真实 ToolsService/SystemPrompt 的子进程里挂载你的插件、跑你的验收场景,回传逐项 PASS/FAIL 与 verdict。与 DSH 桌面进程同一启动路径 (@deepseek-ai/dsh-app-boot 的 boot()),不是 mock。
自带最小示例:example/fixture-plugin + example/scenarios/fixture.mjs(node selftest/run.mjs 一键自测)。
发布物
每次发版把可校验的 tarball 挂在 Releases, 安装量以 release 资产下载数为准(GitHub Insights 的 clone 计数包含扫描器与镜像抓取,不代表有人安装)。
- v0.1.5 —
dsh-plugin-lab-0.1.5.tgz(npm pack 产物)
安装
两种方式等价,二选一:
# 1) 从 GitHub 直装(拿到 main 的最新提交)
dsh plugin add github:Oseas031/dsh-plugin-lab
# 2) 从 npm 装(latest = 0.1.5,可钉版本)
npm i dsh-plugin-lab@0.1.5
npm 侧:包名 dsh-plugin-lab,维护者 osea31,latest 已指到 0.1.5。核对官方版本务必带 registry 参数——
本机 npm 若指向 registry.npmmirror.com 镜像,npm view 会显示滞后的旧版本:
npm view dsh-plugin-lab version --registry=https://registry.npmjs.org
装完仍需把包列入 profile 的 dsh.profile.bundles(见下)。
或直接装进 profile:profile package.json 加 "dsh-plugin-lab": "file:<本包路径>" 并列入 dsh.profile.bundles。
挂载后该 profile 所有会话可用 lab.run 工具(开发 profile 用;生产 profile 慎装——见 dsh.patch.yml)。
用法(会话内)
调用 lab.run 工具:
{
"target": "E:/x/dsh-foo",
"config": { "anyConfig": true },
"scenarios": ["E:/x/dsh-foo/scenarios/contract.mjs"],
"timeoutMs": 120000,
"keep": false
}
返回:{ pass, total, passed, failed[], dshVersion?, durationMs, stdoutTail[], stderrTail[], jobDir? }。
用法(CLI,不进会话)
node runner/child.mjs job.json
# job.json = { dshRoot, ymlPath, jobDir, scenarioPaths[], targetEntry, targetConfig }
场景契约
export default async ({ ctx, defs, step, jobDir, targetEntry, targetConfig }) => {
const deny = ctx.tools.checkGuards({ name: 'your.tool', args: { ... } }); // 官方守卫链
step('断言名', !!deny, deny?.reason);
const def = defs.find(d => d.name === 'your.tool'); // 官方 definitions()
const out = await def.execute({ ... }, { name: 'your.tool' }); // 真执行
step('真执行', out.ok === true);
};
工作原理
- 子进程 new 一个真实 cordis Context(boot(),与 DSH profile 同一启动函数)
- 目标插件按绝对路径挂载——改码即生效,下一次 lab.run 拿新的
- 官方
@deepseek-ai/*服务经bareModuleBaseUrl从本机 DSH 安装解析(Loader 的官方内嵌通道)
安全边界
本包按设计会执行本地代码——它就是在子进程里 boot 真实 cordis 并挂载你指定的插件。唯一的
code-exec 点是 lib/index.js 里的那一次 spawnSync:argv 数组传参、shell: false、固定只跑
内置 runner/child.mjs + 刚写出的 job.json、限时 120s、4 MiB 输出缓冲、独立 mkdtemp 工作目录、
不继承 stdin。无网络、无遥测、零 npm 依赖。静态扫描器一定会标 child_process 导入,那正是功能本体;
逐条约束与残余风险见 SECURITY.md。
兼容性与许可边界
- MIT(本包代码)。零 npm 依赖:不声明、不分发任何 @deepseek-ai 私有包;运行时从用户自己的 DSH 安装解析。
- boot()/bareModuleBaseUrl 是 DSH 内部接口,无稳定性承诺。已实测:DSH 0.2.2-rc.3(selftest 全绿)。 升级 DSH 后先跑 selftest;resolver 找不到 dsh-app-boot 会 fail-loud 并列出尝试过的路径。
- DSH 工具 output schema 不支持 type 数组(
['string','null']会被 assertSupportedJsonSchema 拒绝、 插件激活失败)——可空字段别进 schema。
限制(诚实声明)
- lab 验证插件契约层(守卫链/工具注册/执行);预设组合层(persona、工具面、技能根) 仍需一次 DSH 重启做一次性确认。
- CI 上没有 DSH 安装时只能跑纯函数测试;lab 类测试标
requires-DSH(self-hosted runner 或本地跑)。
License
MIT
Comments
Loading…
Similar plugins
by beartackler
Slash commands ported from other coding agents (setup, connect, install, trust, browse, doctor, status, model, memory, compact, resume, review, mcp, init, suggest, improve, refactor), a zero-dependenc
★ 1
↓ 506/wk
MIT
TypeScript
Aug 30, 2026
dsh plugin --profile web add dsh-bridgeby NexusAgentX
dsh plugin bundle porting the rpiv advisor subsystem: an on-demand zero-parameter advisor() tool that forwards the full session to a separately-configured reviewer model.
★ 0
MIT
TypeScript
Aug 23, 2026
dsh plugin --profile web add dsh-advisorby wly8691-jpg
Windows-native real-Office automation plugin (DSH). Contract, task-level, fault-injection and process-leak regressions covered; real-Office tests must be run on the target machine.
★ 6
↓ 377/wk
MIT
JavaScript
Oct 25, 2026
dsh plugin --profile web add @eqman00003/dsh-office-comby TLEWA
DSH plugin: normalize an omitted/undefined first argument for PTC run_code tool bindings. 修复 run_code 中 tools.foo() / tools.foo(undefined) 的 binding arguments 报错。
★ 1
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-ptc-noargsby heming-gmh
V0 capability-disclosure scanner for DeepSeek Harness (DSH) cordis plugins -- zero-execution static analysis of which sensitive services a plugin declares/references
★ 0
JavaScript
Aug 19, 2026
dsh plugin --profile web add dsh-capcheckby wang-kaopu
Give coding Agents runtime evidence for debugging and verifying DSH / Cordis plugins. 让 Coding Agent 获得用于调试和验证 DSH / Cordis 插件的运行时证据。
★ 0
Apache-2.0
TypeScript
Aug 29, 2026
dsh plugin --profile web add dsh-cordis-devtools