插件锻造实验室 ynnmuraii/dsh-sandbox

dsh-lab

DeepSeek Harness 插件实验室：一个元仓库，用于编写、固定和验证以可安装包形式发布的外部插件。

该实验室是一个智能体优先的锻造厂：智能体及其 harness 将其用作创建和检查插件的有界环境。首批命令包括：

pnpm lab inspect |--path P [--json]
pnpm lab dev |--path P --target T
pnpm lab verify |--path P --target T [--json]
pnpm lab status |--path P [--json]
pnpm lab ui start |--path P --target T [--json]
pnpm lab ui status [--json]
pnpm lab ui finish --verdict pass|fail --summary "..." [--json]
pnpm lab ui abort [--json]

dev 是实时/原地运行，并且对插件是只读的：它读取当前源代码，包括未提交和未跟踪的文件，而配置文件和覆盖层保留在锻造厂的 .lab/runtime 下。verify 将当前源代码复制到临时工作区，并且始终删除临时工作区；锻造厂只保留最小证据作为结果的记忆。目录查找很方便，init/初始化是可选的；只有显式的编写命令才会修改插件仓库。可移植的智能体入口点是 .agents/skills/dsh-plugin-development/SKILL.md；它是为智能体手工编写的咨询性方法论。pnpm lab sync-context 从 context/.md 重新生成每个插件仓库内的 .dsh-lab/shared-context.md 快照，而 pnpm lab doctor 报告缺失或过期的快照，但不写入文件。

lab ui start/status/finish/abort 系列是一个独立协议，用于临时隔离运行时和最小事实性 UI 判定。外部浏览器或视觉智能体/harness 负责导航和视觉决策；截图和浏览器产物是临时的，实验室不会保留它们。

实验室还通过 MCP（pnpm lab mcp）暴露其控制平面。dsh_lab.ui_start/status/finish/abort 系列驱动上述临时隔离 UI 运行时，而 dsh_lab.dev_start/status/stop 驱动实时开发会话。dsh_lab.dev_start 针对插件的实时源代码路径（无包门禁）启动一个分离的监督进程，并返回一个 dev-YYYYMMDDTHHMMSSZ-xxxxxxxx 句柄以及一个有界回环 URL（http://127.0.0.1:）；它只阻塞到会话离开 starting 状态，然后报告一个 restartRequired 锁存，该锁存由插件清单/元数据摘要变更、目标固定变更或 src/ 下的任何编辑（会锁存原因 source-changed）设置。该锁存是单向的，并且从不自动重启：要获取源代码编辑，请停止会话并使用新源代码再次执行 dev_start。
dsh_lab.dev_status 重新读取该锁存和存活状态，而 dsh_lab.dev_stop 协作式停止会话，验证清理，并返回保留的 stopped 墓碑。开发会话对插件是只读的：所有写入都保留在 .lab/runtime 下。
第 5 阶段是诚实的 v1，没有经过验证的实时重载（HMR）。 在 0.1.2-alpha.2 中，共享的 hmr 行在 base 包中随附 disabled: true（在 alpha2 之前，它是在每个应用（web-app/headless）中禁用的）；client-hmr 是一个单独的行，仍然挂载在 web-app 中。lab dev 通过源覆盖为插件的 src/ 重新启用共享行，但重载投递在此 forge 中未经验证，因此开发会话不会热重载 src/*：一次编辑会以原因 source-changed 锁存 restartRequired，而停止→启动会加载新源。生成的 profile 始终携带 dsh.profile.patchReload: "startup" —— 该键管控配置补丁监视以及启动器的仅监视回退，这是与覆盖层的 src 根行不同的轴。当官方 DSH 发布提供经过测试的重载生命周期时，lab 可以移除重启要求。

- 作者指南与配方 — context/lab-author-guide.md
- 根上下文库 — context/（插件共享上下文快照派生自它）
- 可移植 agent 技能 — .agents/skills/dsh-plugin-development/SKILL.md
- 兼容性固定项 — workbench/compatibility.yaml
- 变更日志 — CHANGELOG.md（目标重新固定与策略变更）
- 插件索引 — catalog.yaml

快速开始

pnpm install
pnpm lab doctor # toolchain + pins
pnpm lab upstream check # compare pinned master with the configured remote
pnpm lab new my-plugin # scaffold a plugin
cd plugins/my-plugin
pnpm install --config.minimumReleaseAge=0 --config.strictDepBuilds=false
pnpm test

通过 pnpm lab upstream update 显式采用经过审查的上游 master。添加 --verify 以运行根检查、构建所采用的检出，并验证每个声明了 master 的已编目插件。更新器从不提交、推送、合并、重置或回滚更改。

有关完整的配方集和故障排除，请参阅 context/lab-author-guide.md。