dsh-shipgate: 本地優先的 DSH 預合併交付收據生成器

在 DeepSeek Harness (DSH) 的開發流程中，構建產物和檢查結果的驗證往往依賴遠程或複雜的 CI 流水線。本地開發者需要一個輕量級的機制，在合併代碼前生成確定的交付證明。dsh-shipgate 提供了這種本地優先的方案。

定位與背景¶

dsh-shipgate 是一個本地優先的預合併交付收據生成插件。它作爲 DSH Bundle 使用，向 Harness 注入 tools 服務，並註冊 shipgate_inspect 工具。該插件複用本地的 inspect 核心作爲 CLI，不執行檢查、不上傳源碼，也不宣稱代碼正確。

核心能力¶

• 本地優先的預合併收據生成。
• 注入 DSH tools 服務，註冊 shipgate_inspect 工具。
• 複用本地 inspect 核心作爲命令行接口。
• 不執行檢查邏輯、不上傳源碼、不宣稱代碼正確。

安裝與啓用¶

根據你的 DSH Bundle 工作流進行安裝。插件會將 DSH tools 服務注入 Harness 環境，並完成 shipgate_inspect 工具的註冊。

典型用法¶

命令行調用¶

運行構建好的 CLI，指定 Git 對比基準、檢查證據文件和意圖說明。

node /Users/albert.liu/Projects/dsh-delivery-gate/shipgate/dist/cli.js inspect --base origin/main --checks checks. --intent "Add checkout validation"

DSH 工具調用¶

在 Harness 中調用註冊好的 shipgate_inspect 工具。至少需要提供 base 和 checks 參數。

{
  "base": "origin/main",
  "checks": "checks.",
  "ci": true
}

工具返回收據 ID、結果狀態、風險級別、產物路徑以及 Markdown 摘要。默認情況下 ci: false 爲建議模式；設置 ci: true 會應用項目的配置失敗策略。

適用場景與注意¶

適用場景: 需要在本地生成交付證明，或在 CI 中快速驗證檢查結果，而不希望上傳源碼或依賴遠程執行環境。

注意:
* 本地模式是建議性的。若需應用項目的失敗策略，請在調用時添加 ci: true。
* 產品的邊界和驗證標準定義在 PROJECT.md 中。
* 插件在用戶的 GitHub Runner 中執行，不上傳源碼或 Receipt。
* 環境要求 Node.js 20 或更高版本。
* 使用 GitHub Action 時，必須配合 actions/checkout@v4 並設置 fetch-depth: 0 以解析 merge base。

總結¶

dsh-shipgate 專注於本地交付證明的生成，通過複用 inspect 核心，爲 DSH 流程提供了一個輕量、可控的驗證方案。

• 插件目錄
• GitHub 倉庫