DSH Plugins Marketplace

DSH Plugins

Plugins

/

Development & Infrastructure

/

dsh-plugin-lab

d

dsh-plugin-lab

Manifest valid

Zero-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

hasBundlePatch

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

dsh-bridge

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

Tools & CapabilitiesDevelopment & InfrastructureManifest valid

★ 1

↓ 506/wk

MIT

TypeScript

Aug 30, 2026

dsh plugin --profile web add dsh-bridge

by 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.

Manifest valid

★ 0

MIT

TypeScript

Aug 23, 2026

dsh plugin --profile web add dsh-advisor

by 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.

Tools & CapabilitiesDevelopment & InfrastructureModels & ProvidersManifest valid

★ 6

↓ 377/wk

MIT

JavaScript

Oct 25, 2026

dsh plugin --profile web add @eqman00003/dsh-office-com

by TLEWA

DSH plugin: normalize an omitted/undefined first argument for PTC run_code tool bindings. 修复 run_code 中 tools.foo() / tools.foo(undefined) 的 binding arguments 报错。

Development & InfrastructureManifest valid

★ 1

MIT

JavaScript

Nov 9, 2026

dsh plugin --profile web add dsh-ptc-noargs

by heming-gmh

V0 capability-disclosure scanner for DeepSeek Harness (DSH) cordis plugins -- zero-execution static analysis of which sensitive services a plugin declares/references

Manifest valid

★ 0

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-capcheck

by wang-kaopu

Give coding Agents runtime evidence for debugging and verifying DSH / Cordis plugins. 让 Coding Agent 获得用于调试和验证 DSH / Cordis 插件的运行时证据。

Manifest valid

★ 0

Apache-2.0

TypeScript

Aug 29, 2026

dsh plugin --profile web add dsh-cordis-devtools