前言¶
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。
