前言¶
DeepSeek Harness (DSH) 的核心設計之一是插件化。插件 dsh-ditto 針對的是批量任務的人工審覈痛點。當需要處理 30 個相似文件時，直接讓 AI 執行容易累積錯誤，且缺乏人工複覈的環節。該插件引入“先審覈，後應用”的機制，通過少量樣本的校驗來確立標準，再進行全量預覽和執行。
是什麼¶
dsh-ditto 是一款 DeepSeek Harness (DSH) 插件，作者爲 darrien1998。它是一個 Review-first（先審覈）的批量自動化工具。其核心流程爲：先讓 AI 抽取並處理 3 個樣本供人工審覈和修正，確立標準；隨後基於此標準預覽所有剩餘文件；最後在人工確認後，安全地批量寫入文件。
安裝與啓用¶
插件通過 DSH 的插件命令安裝。安裝前需確保目標 profile 的 pnpm 可用。
dsh plugin --profile web add dsh-ditto
安裝後，可通過 doctor 命令檢查環境與權限：
dsh plugin --profile web exec dsh-ditto doctor
注：--profile 參數需根據實際環境替換（如 headless、acp 或自定義名稱）。
核心功能¶
該插件提供以下能力：
- Review-first batch automation：先審覈，後批量。
- Evidence-backed Code to Spec：生成帶行號證據的代碼轉規格文檔。
- Safe bulk file organization with manifests：安全的批量文件組織，支持生成 CSV、SQL、Markdown 等清單。
- Deterministic ZIP delivery：確定性的 ZIP 交付，支持校驗清單和側邊欄文件。
- Human-in-the-loop approval：全量預覽前必須經過人工審批。
使用示例¶
Code → Spec¶
從代碼庫生成統一的 Markdown 規格文檔：
- Discover：掃描目錄，報告作用域與排除項。
- Review：抽取 3 個結構不同的樣本（如導出最多的、導入最多的、最小的），生成帶行號證據的草稿，人工編輯直至滿意。
- Approve：確認樣本爲標準。
- Preview：基於樣本標準，預覽所有剩餘模塊的文檔。無法由證據支持的內容會被標記爲“Needs confirmation”。
- Apply：審批通過後，將 Markdown 文件寫入輸出文件夾（不修改源文件）。
File organization¶
對 PDF 文件進行批量重命名和遷移：
- Define Rule：使用正則表達式匹配文件名，設定源路徑和目標路徑。
- Review：預覽所有 proposed copy 和 deliverable。
- Manifests：在審批前，可導出 CSV、JSON 或 Markdown 格式的映射清單，或生成 SQL Server INSERT 語句（僅文本生成，不執行）。
- Apply：確認無誤後，執行復制操作。生成 ZIP 歸檔。
注意事項¶
- 不涉及模型調用：插件本身不調用大模型 API，也不存儲 API Key。模型調用由 DSH agent 負責，插件僅接收結構化證據和草稿。
- 數據安全：原始文件永不移動或修改；現有文件永不被覆蓋。所有操作基於預覽，僅在確認後寫入。
- 環境要求：需要 Node.js 22 或更高版本，以及 DSH 0.1.5-rc.1 或更高版本。
- SQL 安全：插件雖能生成 SQL 語句，但絕不連接數據庫或執行 SQL。
結語¶
dsh-ditto 爲 DSH 提供了一種在批量自動化場景下保持安全與可控的方案。通過將“決策”權保留給人類，將“執行”權交由確定性的插件邏輯，它降低了批量任務出錯的風險。
