政策简报核对 PerryLink/dsh-policy-brief-draft

dsh-policy-brief-draft — 政策简报要素完整性与数据新鲜度检查

dsh-policy-brief-draft 读取一份政策简报大纲——文档头部加上每节一行——检查这份大纲自身的完整性与内部一致性：每节是否写明要点，要点是否带有支撑证据，证据是否标注来源，数据截止日期能否解析且不晚于评审日期，数字是否落在你配置的数据新鲜度窗口内，建议是否写明由谁落实，头部是否声明简报标题与接收方，以及节号有无重复。

它能回答什么

| 你的疑问 | 它给出的答案 |
| 有一节全是材料、没有结论：要点列是空的。 | PB-001 会报出这一节，因为每节都应写明要点。它只检查 point 单元格是否填了，不判断要点对不对、有没有新意。该规则上限为 warn，因为条款编号没拿到。 |
| 我们填了证据列和来源列。检查到底验了什么？ | 只验两个单元格都填了。PB-002 要求每个要点都有 evidence，PB-003 要求旁边有 sourceRef。PB-002 不判断证据是否充分、是否真实、是否真能支撑要点；PB-003 查不了来源是否存在、数字是否对得上，因为插件只读清单、从不读来源，所以编造的引用也能通过。 |
| 数据截止日期写的是 2026-03-15 09:30，有一节带的日期比今天还晚。 | 2026-03-15 和 2026-03-15 09:30 都能读。PB-004 会报出晚于评审日期的 dataAsOf，说明要么日期填错了，要么该节引用了尚不存在的数据；解析不了的值会单独报出，不会悄悄跳过。它不判断数据本身可不可靠。 |
| 新鲜度规则报 skipped。这是说数据没问题吗？ | 不是。PB-005 默认 maxDays: 0，意思是未配置，所以它把自己报进 skipped，而不是凭空编个数；设置 maxDays（比如 maxDays: 90）即可启用。命中只说明数据比你设的窗口更旧，绝不等于不能用，引用旧数据有时是对的，所以在备注里说明理由。该规则级别为 info。 |
| 有一节提了建议，却没说由谁落实。 | PB-006 会报出这一节：recommendation 单元格一旦填了，implementer 单元格就是必填。只分析现状、不提建议的节不会被报，所以该规则不会去烦纯现状节。它检查落实方是否写明，不判断建议是否可行、落实机构是否选对。 |
| 简报本身必须声明什么，同一个章节号可以出现两次吗？ | PB-007 要求表头声明 title 和 recipient，如果你的表单还记录密级或主题等表头字段，可以加进它的 fields。PB-008 会报告表格中出现两次的 sectionNo，忽略空白，因为重复的编号会让审阅人无法明确指向某一处。PB-007 只检查那些表头单元格是否填写，不检查标题是否贴切、收件单位是否对口；PB-008 只比较编号本身。 |

遵循的标准

| 文件 | 编号 | 引用它的规则 |
| 《党政机关公文处理工作条例》 | 中办发〔2012〕14号（本次未取得条文） | PB-001, PB-002, PB-003, PB-004, PB-005, PB-006, PB-007, PB-008 |

边界： 这个插件检查政策专报要素核对表中哪些是简报可以被机械核对的部分——每个章节是否陈述了自己的观点，观点是否有支撑证据，证据是否引用了来源，数据日期能否解析且不在未来，在你的时间窗口下数字是否足够新，建议是否指明了由谁落实，简报是否写明了标题和收件单位，以及章节号是否唯一。它不判断观点是否正确、证据是否充分、建议是否可行、数据是否可靠，也不判断简报是否应当提交。那些是对研究质量和决策价值的判断。

⚠️ 这个插件能看到什么、看不到什么

它读的是核对表，不是来源或数据。 所以它只能检查来源是否被引用——永远无法检查来源是否存在、数字是否与来源一致。PB-003 在自己的注释里说明了这一点，README 的故障排查部分也重复了：伪造的引用会通过，因为核实来源是另一回事。

《党政机关公文处理工作条例》(中办发〔2012〕14号) 已取得并逐字阅读，rules/evidence/clause-verification.md 记录了引用了哪些条文——第八条第（十）项（报告用于向上级机关汇报工作）、第十九条（起草：「分析问题实事求是」「所提政策措施和办法切实可行」「观点鲜明」）以及第二十条第（四）项，其中把「引文等是否准确」列为发文前的审核要点。

规则的 excerpt 字段仍然写着「本次未取得」，每条规则也仍然是 warn 或 info。 该条例管的是文件如何起草和发布；这个插件检查的是简报的提纲是否记录了观点、证据、来源和建议。把空白栏称作对「观点鲜明」的 direct 违反，等于把登记表的缺口包装成法规问题——这正是这一系列规则要避免的过度主张。何况有一半规则本来就依赖你自己的编辑惯例。

数据新鲜度窗口默认未设置。 多旧算太旧是你的编辑规则——快报可能要求上个月的数字，而年度分析引用当年的数据也完全合理——所以 PB-005 的 maxDays 从 0 开始，规则会在 skipped 里说明自己，而不是凭空编一个数字。这里出现 finding，意思是「比你设定的窗口更旧」，绝不是「不能用」；引用更早的数据有时是对的，正确的做法是在备注里说明理由。

兼容性

| 层面 | 状态 |
| Harness | 对等版本范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0 —— 已验证可接受 0.2.0-rc.2 和 0.2.1-alpha.1。故意不声明 engines.dsh：它没有读取方，也无法拒绝宿主 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码，无网络，不调用模型） |
| 工具模式 | 在 native、ptc 和 both 下都能用；长简报请用 ptc |

它做什么

注册 policy_brief_draft 工具。它读取一份简报大纲——文档头部加上每个章节一行——套用带版本的规则包，返回一份报告。

| 规则 | 检查内容 | 严重级别 | 依据类型 |
| PB-001 | 每个章节都说明自己的观点 | warn | principle |
| PB-002 | 每个观点都有支撑依据 | warn | principle |
| PB-003 | 依据引用了出处 | warn | principle |
| PB-004 | 数据日期能解析，且不在未来 | warn | principle |
| PB-005 | 按你设定的窗口，数据足够新（默认关闭） | info | local |
| PB-006 | 建议写明了实施方 | warn | principle |
| PB-007 | 简报写明了标题和报送对象 | warn | principle |
| PB-008 | 章节编号唯一 | warn | principle |

安装

dsh plugin --profile <name> add dsh-policy-brief-draft
dsh --profile <name> --dump-config | grep 'dsh-policy-brief-draft'

配置

| 键 | 类型 | 默认值 | 说明 |
| rulesFile | string | rules/policy-brief-draft.yaml | 规则包路径，相对于包根目录 |
| disabledRules | string[] | [] | 要停止运行的规则 id；每个都会出现在 skipped 里 |
| onlyRules | string[] | [] | 只运行这些规则 id；留空则运行全部规则 |
| skipNotes | string | "" | 附加到每条 skipped 原因后面的备注 |
| timeoutMs | number | 120000 | 协作式工具超时预算 |

几个值得了解的规则级参数：

- PB-005 maxDays —— 新鲜度窗口，单位天。0 表示该规则不运行。
- PB-006 conditionField / requiredFields —— 什么会触发实施方要求；默认是建议列。只做分析、不提建议的章节不会被要求写实施方。
- PB-007 fields —— 必须存在的头部字段；默认是标题和报送对象。如果你的简报带密级标注，加上 classification。

材料格式

工具接受 JSON 或 YAML：

title: 某某领域投资形势分析专报 topic: 投资形势 recipient: 某某部门 draftedAt: 2026-03-12 classification: 内部 rows:
- { 序号: '1', 章节: 一、现状,
核心观点: 本领域投资增速连续三个季度回落，结构性分化明显, 支撑依据: 全国固定资产投资统计月报（2026 年 2 月）显示本领域投资同比增长 3.1%, 出处: 国家统计局月度数据，2026 年 3 月发布, 数据截止日期: 2026-02-28, 风险提示：月度数据存在季节因素，需结合同比口径判断 }

列名匹配不区分大小写，并忽略空格、下划线和连字符；大纲自己的列名会保留，所以一条发现会写明它读取的是哪一列。日期可以写成 2026-02-28 或 2026-02-28 09:30。

规则来源

规则数据放在 rules/policy-brief-draft.yaml。规则包的头部完整说明了引用缺口，每条规则的 note 会重复该规则相关的部分。加载时的守卫通常要求「摘录必须是至少八个字符的真实引文」，但它分不清引文和描述——所以这个规则包靠头部、每条规则的 note，以及一个断言每条 excerpt 都承认该缺口的测试来兜底。

故障排查

- PB-003 放过了我明知是编造的来源。 它查不了这个：它只验证来源被引用了，不验证来源是否存在、或是否说了简报声称的内容。
- PB-005 报告自己被跳过。 没有设置时效窗口。多旧算太旧是你的编辑规则，插件不会替你编一个。
- PB-005 对我特意引用的数据报警。 更旧的数据有时才是对的数据。要么放宽 maxDays，要么在 remark 里记下原因——这条发现针对的是窗口，不是数据。
- PB-006 在分析章节不报警。 这是有意为之：只有真正给出建议时才要求有实施者。
- PB-004 对未来的日期报警。 要么数据日期错了，要么起草日期错了；简报不能建立在尚不存在的数字上。
- 插件装上了，但工具一直不出现。 检查 main 是否指向 lib/index.mjs，以及 pnpm run build 是否生成了它；main 写错会让加载器静默跳过入口。
- dsh plugin add 以不兼容为由拒绝该包。 peer 范围覆盖 0.1.x 和 0.2.x；如果你的运行时不在其中，显式授予豁免： dsh plugin --profile <name> allow-version dsh-policy-brief-draft@0.1.0 --dsh-version <runtime> --accept-risk
- check 报告 manifest-peers 失败。 静态检查器比对的是一个硬编码的 peer 范围，它早于 0.2 系列。运行时会在安装时强制校验 peer 兼容性，所以声明的范围才是正确的；这是 dsh-plugin-dev 里已知的上游问题。

开发

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # vitest, the shared table-plugin suite plus paired fixtures
pnpm run build # tsdown -> lib/index.mjs + lib/index.d.mts
node ../scripts/sync-shared.mjs dsh-policy-brief-draft # refresh src/shared from ../_shared

这个插件是纯数据的：src/model.ts 声明表结构，共享工具包提供读取器和检查引擎，规则包声明每一项检查。

许可证

Apache License 2.0 © 2026 dsh-policy-brief-draft contributors.