前言¶
在 DeepSeek Harness（DSH）中，把「原则审查」做成一个插件，让 agent 直接调用 principles_audit 工具，对 V2 原则库做一次结构化审查，输出 critical / warning / info 分级问题与 markdown/JSON 报告。插件只做可机器复核的结构与一致性检查，不修改任何原则源文件。
核心功能¶
- 结构审查：对原则库做结构化检查，输出分级 findings 与健康分。
- 门禁：内置审查门禁（pass/warn/fail），严重项全部豁免时为 warn，否则阻断。
- 只读：不修改原则源文件，只在
<V2根>/.principles-audit/写报告。 - 多输入模式：支持目录模式（自动发现汇总与分项目文件）、单文件模式、环境变量覆盖。
安装与启用¶
以 desktop profile 为例：
CLI="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$CLI" plugin --profile desktop add \
link:<plugin-dir>/dsh-principles-audit
安装后，确认 ~/.dsh/profiles/desktop/package.json 中的 dsh.profile.bundles 包含 dsh-principles-audit：
{
"dsh": {
"profile": {
"bundles": [ "...", "dsh-principles-audit" ]
}
}
}
GUI 工具列表中出现 principles_audit 即表示加载成功；未出现则重启 DSH。
卸载：
"$CLI" plugin --profile desktop remove dsh-principles-audit
典型用法¶
1. 在 DSH agent 中调用¶
principles_audit({
path: ".../principle-dashboard-v2", // 可省略，默认 V2 根目录
outputDir: "...", // 可省略，默认 <root>/.principles-audit
checks: ["id-collision", "stale"] // 可省略，只跑部分检查
})
工具返回 summary（严重/警告/提示/健康分）以及前 20 条 findings，并返回报告路径（markdown/JSON）。
2. 独立 CLI 调用¶
NODE="$HOME/.dsh/dsh-runtimes/dsh-primary-runtime/dependencies/node/bin/node"
cd "<plugin-dir>/dsh-principles-audit"
"$NODE" cli.js --path "$HOME/<principle-library>" \
--output ./test-output
也可以用 --json 输出完整 JSON，或 --checks stale 只跑某一类。
检查项¶
| code | 级别 | 内容 |
|---|---|---|
id-collision |
critical | 同一 principle_id 跨项目复用但名称不同 |
legacy-id |
info | 旧版项目内 ID（PR-###），提示迁移为全局 PR-D##-#### |
id-format |
warning | ID 既不是 PR-### 也不是 PR-D##-#### |
required-fields |
critical / warning / info | 缺 principle_id / name / causal_statement（critical）；缺边界/反例/证据（warning）；缺 updated_at / version（info） |
boundary-missing |
warning | applicable_conditions 或 counter_examples 为空 |
evidence-missing |
warning | evidence[] 为空 |
duplicate-name |
warning / info | 同名不同义（warning）或完全重复可合并（info） |
near-duplicate |
warning / info | 名称/因果句 2-gram Jaccard 相似度 ≥ 阈值（名称 0.85 / 因果句 0.8） |
status-confidence |
warning | 状态与 scoring.json 规则不一致；置信度越界 [0.2, 0.95] |
verification-records |
info | 有 verified_count 但没有 verification_records |
stale |
warning / info | >36 个月仍活跃（warning）；>24 个月未复核（info） |
dimension-unmapped |
warning / info | V1.5 映射缺失、dims 为空或汇总数据集未归一化 |
dimension-coverage |
warning | 维度 0 条；或支持集 <5 个项目 |
dataset-empty |
critical | principles[] 为空 |
generation-notes |
info | 缺 generation_notes |
aggregate-overlap |
info | 汇总数据集与某个分项目原则同名 |
说明：
- 不做 LLM 语义判断，只审可机器复核的结构与一致性。
- 维度覆盖只在目录模式（能发现汇总 + 分项目）下检查；单文件模式只做单文件字段/ID 检查。
- 报告分级是启发式，每条都带
principle_id/ 文件，便于人工复核。
审查门禁与豁免¶
门禁判定（gate.status，CLI 退出码 0/1/2）：
| 条件 | 状态 | 行为 |
|---|---|---|
| 严重 0 | pass |
放行 |
| 严重项全部有有效豁免（owner + 未过期到期日） | warn |
放行，findings 打豁免标注 |
| 任一严重项未豁免 / 豁免已过期 | fail |
阻断（CLI exit 1） |
豁免表 exemptions/exemptions.json（插件自带）可按以下顺序覆盖：
--exemptions参数DSH_PRINCIPLES_AUDIT_EXEMPTIONS环境变量<root>/.principles-audit/exemptions.json- 插件自带豁免表
适用场景与注意¶
- 适合需要结构化审查原则库、建立门禁、输出分级报告的场景。
- 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
- 维护者：zirscard。
- 分类：工作流。
- 插件名：dsh-principles-audit。
生态背景¶
DSH 理念是「一切皆插件」，社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
更多信息¶
- 插件目录页：https://www.skillhub.cn/plugins/zirscard/dsh-principles-audit
- GitHub：https://github.com/zirscard/dsh-principles-audit
