AI-Scarlett/build-dsh-plugin

build-dsh-plugin

面向 DeepSeek Harness（DSH）插件开发的可复用 Agent Skill 与 DSH 原生 Skill Provider Bundle。它把自然语言或结构化 Brief 转换为标准插件方案、源码工程、工具卡片契约、审计、发行、安装和验收流程，同时把宿主边界、风险等级、权限、变更授权与证据门槛固化为可执行约束。

官网：DSH STORE Build Lab

仓库现在同时提供两种宿主入口：

- build-dsh-plugin/ 是可部署到 Codex、Claude、Grok 等兼容 SKILL.md 的 Agent Skill；
- 仓库根目录的 package.json + cordis.patch.yml 是标准 DSH Bundle；Patch 只插入插件自有的 dsh-build-plugin Host 适配器，再由适配器通过 0.1.2-alpha.4、0.1.2-alpha.5 和 0.1.2-rc.1 都提供的公开 ctx.skills.register() 服务接口，将同一份 Skill 挂载到 DSH。

DSH 入口要求 dsh >= 0.1.0-rc.8  --help：DSH CLI 可能在显示帮助前先创建该 Profile。

固定 GitHub Commit 的商城/远程安装入口需要在该 Commit 合并并通过 DSH STORE 独立校验后才能声明；仓库具备 Bundle 结构不等于已经上架，也不等于真实 Profile 已安装。

自检

npm test
node scripts/verify-distribution.mjs
cd build-dsh-plugin
node scripts/test-normalize-brief.mjs
node scripts/test-marketplace-entry.mjs
node scripts/test-candidate-entry.mjs
node scripts/normalize-brief.mjs assets/plugin-brief.readonly-example.json
node scripts/normalize-brief.mjs assets/plugin-brief.r3-example.json
node scripts/audit-marketplace-entry.mjs /path/to/plugin --entry /path/to/entry.json --registry /path/to/catalog.json
node scripts/audit-candidate-entry.mjs --entry /path/to/candidate.json --candidates /path/to/candidates.json --catalog /path/to/catalog.json

通用 Agent Skill 脚本需要 Node.js 18 或更高版本；DSH Bundle 0.5.0 要求 DSH 0.1.0-rc.8 <0.2.0 及其 Node.js 运行时。当前 0.1.2-alpha.4、alpha.5 和 rc.1 均通过一次性隔离 Profile 安装、配置合成与冷启动。预期测试输出包含 BRIEF_TEST_OK、MARKETPLACE_TEST_OK 和 CANDIDATE_TEST_OK；只读示例保持 R0，生命周期示例保持 R3 且不会直接执行真实 Profile 操作。

npm test 还会验证根目录 DSH Bundle、隔离 Provider、无生命周期脚本、卡片契约文档，以及审计器对不支持的卡片 discriminant、缺失 replay/fallback/bounds 测试的 fail-closed 行为。

使用示例

使用 $build-dsh-plugin，根据下面的 Brief 直接生成 DSH 插件源码：

当前问题：会话很多时，很难快速找到失败或长期无响应的任务。
期望结果：在 DSH 设置页看到异常会话及原因摘要。
成功标准：一次性 Profile 中页面可见；异常夹具分类正确；真实 Profile 保持不变。

发行完整性

- 发行版本：2026.09.07.1
- 固定发行标签：v0.5.0
- ZIP SHA-256：ab4d701648aab6df20cdb0aa8d9e844cf5e609855115b3311dc73f508dc8cdd9
- ZIP 内常规文件数：27（新增跨平台审计路径分类器；保留官方 DSH 动态版本解析器、候选审计器、Tool 卡片契约、可信 Catalog 模板与独立 LICENSE）
- 已通过 Skill 结构、Node 语法、Brief/商城/卡片审计测试、DSH Bundle 契约、0.1.5-alpha.1/.2 源码契约复核；旧版 alpha.4/alpha.5/rc.1 的一次性 CLI 安装、配置合成、冷启动、运行时 Skill 发现、卸载和 ZIP 解压复测
dist/manifest.json 是版本、下载地址、SHA-256、文件数和许可证的机器可读单一来源。README 与 INSTALL 只负责说明；DSH STORE 等分发页面必须读取“最新 GitHub Release → 对应标签下的 manifest”，不能把这些字段复制成另一份运行时数据。这样即使网页缓存暂时未刷新，下载页仍会把同一固定标签的 manifest、ZIP 和校验值绑定在一起。

开源许可证

本项目采用 MIT License。你可以使用、复制、修改、合并、发布、分发、再许可或销售本项目的副本，但必须在副本或主要部分中保留原版权声明和许可声明。发行 ZIP 内也包含相同许可证，解压后仍能保留授权信息。

0.5.0 已通过 0.1.5-alpha.2 官方源码宿主的隔离安装、配置合成与启动。GitHub-only 新版不会被当作已有 npm 包；真实 Profile、公共发布与下载链接回读仍分别验收。上述较早三版本测试为既有历史证据。