前言¶
DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在构建插件时，开发者需要同时处理宿主兼容性检查、风险等级评估（R0–R3）、权限申请、工具卡片契约设计以及商城上架合规性。手动处理这些环节容易遗漏细节或引入风险。
build-dsh-plugin 提供了一套标准化的工作流。它将自然语言或结构化的 Brief 转换为可执行的插件方案、源码工程和验收流程，并将安全默认值、证据门槛和商城兼容性要求固化为开发约束。
它是什么¶
这是一个面向 DeepSeek Harness (DSH) 插件开发的可复用 Agent Skill 与 DSH 原生 Skill Provider Bundle。
维护者：AI-Scarlett
许可证：MIT License
它主要解决从需求到上架过程中的碎片化问题：将开发流程拆解为工程生成、风险审计、卡片契约设计和商城结构构建，确保插件从开发第一天起就符合 DSH STORE 的规范。
核心能力¶
1. Brief 转换与工程生成¶
输入当前问题、期望结果和成功标准，插件会补齐安全默认值，并输出插件源码工程、工具卡片契约、审计步骤和发行流程。
2. 风险与兼容性分析¶
在生成代码前，会判断 DSH 宿主兼容性，评估 R0–R3 风险等级。针对注册模型 Tool 的插件，会设计符合 DSH 规范的卡片契约，包括 JSON 输出规范、意图定义 (presentCall/presentResult) 和持久化投影。
3. 商城兼容结构¶
从开发第一天保持商城兼容结构。对于准备上架的插件，它会将第三方仓库分流为 direct、monorepo、adapter-required 或 blocked，并生成与可信安装库物理分离的发现候选。
安装¶
安装到 DSH 时，使用的是仓库根目录的标准 Bundle。为了不影响真实环境，建议在一次性 Profile 中进行验收。
export DSH_HOME="$(mktemp -d)"
dsh plugin --profile build-plugin-e3 add /absolute/path/to/build-dsh-plugin-repository
dsh --profile build-plugin-e3 --dump-config
上述命令会安装一个 Provider，该 Provider 仅扫描本仓库的 build-dsh-plugin/ 目录。配置中应包含唯一条目 dsh-build-plugin-skill-provider。
依赖要求：
* DSH 版本：>=0.1.0-rc.8 <0.2.0
* Node.js 运行时：>=22.13.0
使用¶
安装成功后，即可在 DSH 中调用该 Skill。通过提供 Brief，获取完整的插件设计方案。
示例 Brief：
当前问题：会话很多时，很难快速找到失败或长期无响应的任务。
期望结果：在 DSH 设置页看到异常会话及原因摘要。
成功标准：一次性 Profile 中页面可见；异常夹具分类正确；真实 Profile 保持不变。
插件将基于上述 Brief 输出分析报告、优势劣势、适用条件以及执行步骤。
边界与约束¶
为了保证安全和一致性，该插件在设计上有明确的边界：
- 不修改核心：构建标准 DSH Bundle 时，不修改 DSH 源码或
@deepseek-ai/*包，也不禁用、替换或遮蔽官方插件清单。 - 只读优先：只读优先原则。真实 Profile、重启、凭据、设备及公网操作必须单独满足条件并授权。
- 隔离测试：测试只使用一次性 Profile/夹具，不写入真实
~/.dsh。 - 商城上架要求：若要上架 DSH STORE，必须满足：公开 GitHub 仓库、40 位固定 Commit、匹配的 manifest/Patch/Entry ID/生命周期/许可证和保守权限元数据。
相关链接¶
- 目录页：https://www.skillhub.cn/plugins/AI-Scarlett/build-dsh-plugin
- GitHub 仓库：https://github.com/AI-Scarlett/build-dsh-plugin
- 官方文档：https://dsh.store/build/
