在审查 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。
