Maglev for DSH: DeepSeek Harness 插件介紹

前言¶

DeepSeek Harness（dsh）目前處於開發者預覽階段，提供了強大的執行能力（agent 循環、工具、沙箱等），但在軟件研發的流程語義上有所欠缺，例如階段門禁、驗收證據、不可變 Spec 和流程紀律。dsh 缺少一種機制，讓項目迭代在可控範圍內進行，並將過程中的知識沉澱爲資產。

Maglev for DSH 是一個針對 dsh 的獨立插件，旨在補上這一層。它通過技能注入、GUI 交互和機械約束，幫助研發團隊和個人在 dsh 中實現長期可控的項目迭代，並降低項目對特定人員和 AI 體系的依賴。

是什麼¶

這是一個自包含的 dsh 插件。安裝後，dsh 將獲得以下能力：

1. 29 個 Maglev 技能：技能通過 maglev-bundled provider 自動注入，包含收斂 → 設計 → 驗證 → 結晶的主鏈路，以及治理紀律和知識沉澱相關技能。任意項目（無需本地 .agents/skills）都能發現並使用。
2. Maglev GUI：提供“真相卡片”和“結晶卡片”。真相卡片展示 AI 讀取的項目現狀（能力域、進行中主題、願景、契約）；結晶卡片展示每次迭代沉澱的結論。
3. spec 工具與驗證門禁：提供 spec 完整性檢查，並在結晶前設置機械門禁，將“驗證”從模型自覺轉變爲機械約束。

核心功能¶

29 個 Maglev 技能¶

插件內置 29 個技能，覆蓋研發全流程的主鏈路。這些技能會自動註冊到 dsh 的技能發現機制中，無需手動配置。

Maglev GUI¶

GUI 提供了兩種卡片視圖：
* 真相卡片：對人可見，展示 AI 讀到的項目能力域、進行中主題、願景和契約狀態。
* 結晶卡片：展示每次迭代沉澱了什麼，以卡片形式彈在會話流裏。

spec 工具與驗證門禁¶

• spec 完整性檢查：對 spec 文件的完整性進行機械檢查。
• 結晶門禁：在調用結晶工具前，必須先通過 spec 完整性門禁，確保只有符合規範的結論才能被沉澱。

安裝與啓用¶

1. 前提條件
   dsh 目前處於開發者預覽階段，沒有全局 dsh 命令。所有 dsh 操作必須在 dsh 源碼 checkout 目錄下執行 pnpm dsh <子命令>。

2. 安裝插件
   在源碼 checkout 目錄下，運行以下命令將插件安裝到 web profile：

    pnpm dsh plugin --profile web add @idea-maglev/maglev-for-dsh

3. 啓動 Web
   安裝後啓動 web 服務：

    pnpm dsh web

啓動後打開頁面（默認 http://127.0.0.1:3080），即會出現 Maglev 卡片（真相卡片 + 結晶卡片）。

典型用法¶

在會話中直接讓 AI 調用工具即可完成主要操作：

• maglev_reality_status：讀取項目現狀（能力域、進行中主題、願景、契約），生成真相卡片。
• maglev_crystallize：將已驗證的結論結晶到 specs/ 目錄，生成結晶卡片（需先通過 spec 完整性門禁）。
• maglev_spec_check：對 spec 的完整性進行機械檢查。

依賴與關係¶

• 獨立性：本插件從 Maglev 源倉庫一次性派生，與 Maglev 源零運行時依賴。
• 工具依賴：本插件 host 側不直接依賴 @deepseek-ai/dsh-tools（工具定義手動構造），避免了 dsh-tools 多實例導致的工具調度器符號分裂問題。
• 技能注入：技能通過 ctx.skills.registerProvider 注入，rank 低於項目技能，項目技能優先級更高。

總結¶

Maglev for DSH 通過引入 29 個技能、GUI 卡片和 spec 驗證門禁，爲 dsh 增加了研發流程的語義和紀律。它幫助用戶在 dsh 中實現可控迭代，並確保知識資產被正確沉澱和可追溯。