前言¶
DeepSeek Harness (DSH) 支持通过 Bundle 扩展功能。yanxu-dsh-plugin 解决的是如何将 Yanxu Dev 的证据绑定 AI 编码交付工作流集成到 DSH 环境中的问题。它不改变 DSH 的核心权限模型，而是通过加载一个名为 yanxu-delivery-workflow 的技能，指导代理在代码生成和交付的各个阶段遵循特定的流程规范。
插件定位¶
这是一个供 DSH 使用的 Bundle 插件。它为 DSH 添加了 yanxu-delivery-workflow 技能，使代理能够执行证据绑定的 AI 编码交付。该插件利用 DSH 现有的 bash 或 pwsh 工具执行命令，确保所有操作仍在 Harness 的权限和沙箱模型之内。
核心功能¶
插件加载后，代理将遵循以下工作流指引：
- 仓库就绪与合同：在 AI 代码生成之前，先运行
doctor并创建需求合同。 - 代码实现规范：在使用
implement时，必须提供显式的源文件白名单和测试命令。 - 隔离与审查：将生成的更改保留在隔离的存档中，直到人工审查通过。
- 状态管理：将草稿 PR、CI 成功、合并和部署视为不同的状态。
- 效率测量：使用匹配的、质量通过的实时任务来衡量开发效率 claims。
- 证据收集：指导代理完成 PR/CI 证据的收集。
安装与启用¶
通过 DSH 的官方安装机制将 GitHub 仓库的 v0.1.0 版本添加到指定 profile：
dsh plugin --profile web add github:guannan1031/yanxu-dsh-plugin#v0.1.0
安装后需要重启该 profile。DSH 会通过解析 cordis.patch.yml 将插件层加入 profile 的 bundle 列表。开发阶段若需本地调试，可使用绝对路径安装。
典型用法¶
在 DSH 会话中加载该技能后，即可在授权仓库中开展工作。代理会自动执行以下步骤：
- 执行环境检查并确立任务合同。
- 依据白名单和测试命令进行代码实现。
- 维护代码的隔离状态。
- 管理不同阶段的 PR 状态（草稿、CI、合并、部署）。
- 基于真实任务数据输出效率评估。
适用场景与注意¶
- 前置依赖：必须在目标项目的环境中安装 Yanxu Dev 本身。
- 权限边界：插件不绕过 DSH 权限，不从插件进程运行任意主机进程，不存储凭据，不自动合并 PR 或部署应用程序。所有实际执行均由 DSH 的现有沙箱工具完成。
- 许可证：插件本身为 MIT 许可证，DeepSeek Harness 和 Yanxu Dev 为独立项目，各自拥有许可证和认证要求。
验证¶
安装完成后，可以通过以下命令验证插件是否正确集成：
npm test
dsh --profile web --dump-config
第一个命令用于验证 Bundle 导出的契约，第二个命令用于确认 DSH 是否正确组合了插件层。正常的 dsh 会话应在技能目录中列出 yanxu-delivery-workflow。
