前言¶
在 DeepSeek Harness（DSH）裏做智能體或項目開發時，需求往往在對話裏一點點浮現，卻難以及時沉澱成可執行的規範與文檔。常見做法是事後整理聊天記錄，或邊寫代碼邊補文檔，容易漏項、口徑不一。下面介紹社區插件 dsh-spec-mode（維護者 LMQ00，分類：工作流）：用模型主導的增量訪談，把逐步明確的需求固化成開發規範與項目文檔；訪談期間工作樹只讀，避免邊聊邊改代碼帶來的漂移。
這是什麼¶
dsh-spec-mode 是 DSH 的工作流類插件。倉庫描述爲：Spec mode for the DeepSeek Harness: interview-driven requirements capture with a read-only working tree.（package.json 版本 1.5.0，協議 MIT。）
插件通過倉庫根目錄的入口模塊接收 DSH 上下文並掛載能力；運行時僅依賴 Node 自帶的 crypto、fs、path，不引入額外宿主運行時包。安裝形態爲：以鏈接方式掛進 web profile，加載器行爲名爲 include:spec-mode。
核心功能¶
增量訪談與規範產出¶
訪談由用戶真實輸入觸發，模型在對話中追問、收斂需求，產出面向項目的開發規範與項目文檔。產出文檔遵循插件內置的六條寫作規則：只寫結論與硬事實，不寫動機與背景鋪陳；信息密度高，能表格則表格；AGENTS.md 僅作文檔索引與開發規範規則，不寫進度、待辦或變更記錄。
只讀工作樹與草稿寫入¶
訪談激活後，工作樹處於只讀狀態，一般文件修改會被攔截。唯一允許寫入的目標是項目文檔目錄下的訪談草稿，便於在訪談過程中持續落盤而不動代碼樹。
進入與退出¶
- 進入：
/spec [初始想法] - 退出：
/spec off
裸命令 /spec 只切換模式，不向模型提交任何消息；訪談從用戶寫在 /spec 後的想法，或隨後發送的第一條普通消息開始。結束時模型會彈出確認，用戶可選「退出並落盤」或「繼續訪談」，通常不必手動執行 /spec off。
安裝與啓用¶
官方 README 未給出 dsh plugin add github:… 形式的一行命令，安裝以 web profile 鏈接 + 加載器行爲 爲準：
- 將插件以鏈接方式掛進你的 DSH web profile。
- 在 profile 配置中啓用加載器行爲
include:spec-mode。
具體 profile 字段名與鏈接寫法以你當前 DSH 版本與 profile 文檔爲準；安裝前建議在 GitHub 倉庫 閱讀 docs/插件說明.md 與 README.md，並覈對 MIT 許可證與源碼。
插件在 當前 dsh 進程權限 下運行，安裝前應自行審查代碼與權限影響。
典型用法¶
在已啓用 spec mode 的會話中：
帶初始想法進入訪談：
/spec 我想做一個內部工具，用來彙總各服務的健康檢查接口
僅進入模式，等第一條用戶消息再開題：
/spec
（隨後發送你的第一條普通消息即可開始訪談。）
手動退出模式：
/spec off
維護者在倉庫內對純邏輯模塊提供自測（不依賴宿主）：
node selftest.mjs
共 24 項斷言，覆蓋草稿錨點、路徑判定、投影摺疊分支及產出文件的提醒判據。改投影狀態字段或摺疊語義時，須同時將狀態版本號加一，否則持久化緩存中的舊行可能被錯誤摺疊。
適用場景與注意¶
適合： 希望在 DSH 對話裏系統梳理需求、把結論寫成規範與項目文檔的團隊或個人；需要在訪談階段禁止改工作樹、只允許寫文檔草稿的場景。
注意：
- 社區目錄 SkillHub 插件頁 與 GitHub 爲獨立信息源，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文介紹的是社區工作流插件，非官方應用商店條目。
- GitHub 公開星標數爲 0（以目錄頁/倉庫頁面當時展示爲準），不代表功能完備度，使用前請自行驗證。
- 改插件行爲前可查閱倉庫內
docs/實現邏輯.md（狀態、守衛、提醒掛載）與docs/交接文檔.md（驗證清單、宿主升級排查）。
