在審查 Clean Arch / DDD / 六邊形分層項目時，“標準答案”散落在各個參考倉的架構測試和文檔裏，每次審查都要重新翻閱。這個插件把 8 個釘版參考倉預先索引成本地 FTS5 庫，審查前一鍵拿“標準答案集”，審查完留賬，命中統計反哺參考庫策展。
是什麼¶
dsh-ca-ref 是 Clean Architecture 參考庫——DSH(DeepSeek Harness)插件，由 Ansonfishing 維護，開源協議爲 MIT。
安裝與啓用¶
前提條件：DSH (帶 web) + pnpm; Node ≥ 24 (node:sqlite 爲 Node 24 內置)。
cd ~/.dsh/profiles/web
pnpm add github:Ansonfishing/dsh-ca-ref
安裝完成後，在 package.json 的 dsh.profile.bundles 數組裏加上 "dsh-ca-ref"，重啓 dsh。會話區會出現“CA 參考庫” tab。
核心功能¶
- 8 個釘版參考倉：包含 Go / Java / C# / Python 等語言的公開參考倉，釘在固定 commit。
- FTS5 全文搜索：對參考倉的斷言、文檔、結構進行全文搜索，中文按子串、英文走 FTS5；引用帶
<repo>:<path>出處。 - 機器化規則清單：每條規則帶斷言模板與出處，可一次性獲取指定語言的“標準答案集”。
- 審查臺賬：記錄審查留賬（項目、語言、命中規則、證據），命中統計可反哺策展。
- 觀察窗面板：只讀 tab，30s 自動刷新，展示基線（倉列表 + 規則覆蓋表 + card 全文）、搜索記錄、審查留賬、命中統計。
典型用法¶
插件提供了以下 Agent 工具：
ca_ref_search：參考庫全文搜索斷言 / 文檔 / 結構ca_ref_baseline：獲取指定語言的參考倉摘要卡與規則清單（含 8 條紅旗）ca_ref_record：審查留賬（項目 / 語言 / 命中規則 / 證據）ca_ref_status：檢查參考庫健康（釘版 SHA、驗證結果、索引狀態、臺賬量）
另有命令通道 /ca-ref status \| search \| baseline \| ledger \| stats \| reindex 供面板使用（支持 --json 參數）。
配置與維護¶
- 語料路徑：語料默認在
~/AI/ca-ref，可通過環境變量CAREF_CORPUS指向別處。 - 數據缺失：某倉語料缺失時，相關搜索 / 索引會自動跳過（是數據缺失，不是代碼 bug）。
- 漂移檢查：每日 tick 用
git rev-parse HEAD只讀校驗釘版漂移。漂移時，面板基線 tab 會顯示 ⚠️，不自動 re-clone。
