公文登记核对 PerryLink/dsh-gongwen-word-check

dsh-gongwen-word-check — 公文版式要素检查

English · 简体中文 · Español · Português · हिन्दी

DSH Market
dshfind

dsh-gongwen-word-check 读取一份发文登记簿——一行对应一份已发公文——拿登记簿里记录的文本对照一份带版本号的规则包做检查：发文字号 是否符合「机关代字〔年份〕序号」的写法、年份是否用六角括号〔〕括起；成文日期 能否解析成日期、是否不晚于检查当天；文种 是否出自你所在单位自己配置的词表；主送机关 是否填写；标题 是否在配置的长度之内；发文字号 是否在登记簿里重复出现；标题里是否还留着没替换掉的模板占位符。

安装

dsh plugin --profile <name> add dsh-gongwen-word-check
dsh --profile <name> --dump-config | grep 'dsh-gongwen-word-check'

效果预览

dsh-gongwen-word-check 的工作流示意图：公文 → 规则包 → 检查结果。

工作流概览：公文 → 规则包 → 检查结果。下面的示例都用真实的命令接口。

它能回答什么

示例

下表就是示例集：第一行是详细走查，其余各行是简短案例。

详细输出

工具 gongwen_word_check

输入

~~~json
{"rows":[{"发文字号":"某政发〔2026〕15号","成文日期":"二〇二六年三月十日"}]}

输出

~~~json
{
"id": "dsh-gongwen-word-check.GW-002.de09b5a6",
"ruleId": "GW-002",
"severity": "warn",
"locator": {
"field": "signedAt",
"row": 1
},
"found": "第 1 行「signedAt」的值「二〇二六年三月十日」无法解析为日期", "expected": "「signedAt」应为 2026-03-15 或 2026-03-15 09:30 这样的可解析日期", "fix": "核对日期写法；本条不会因为无法解析而跳过该行" }

取自 tests/fixtures/GW-002/GW-002-unsafe.json (cases.json expects GW-002 count 1); run via lib/index.mjs rules/gongwen-word-check.yaml

| 你会问 | 它怎么答 |
| 发文字号写成了 某政发[2026]15号，用的是方括号。 | GW-001 会报出这一行：它配置的模式要求年份用六角括号〔〕括起，所以该写成 某政发〔2026〕15号 这种形式。这条规则只检查发文字号的写法——机关代字本身由你所在单位设定，所以它不判断代字对不对，也不判断序号是否连续或是否重复使用。 |
| 签署日期按公文通常的写法填写：二〇二六年三月十五日。 | GW-002 报告无法解析这个值。它只认 2026-03-15 和 2026-03-15 09:30；汉字日期必须写成这两种形式之一，否则就关掉这条规则。该规则也不核对签署日期与成文日期是否一致——那属于发文工作流的内部事务。 |
| 我们单位从未配置过文种清单。GW-003 会悄悄通过吗？ | 不会。GW-003 没有内置清单，values 未设置时它会出现在报告的 skipped 里，而不是静默通过。《党政机关公文处理工作条例》列出十五种主要文种，但规则包并未把它们写死——你单位可以用哪些文种，由你自己决定。该规则也不判断某份公文本该用哪种文种。 |
| 某行的主送机关为空。 | GW-004 会报告该行，因为没有主送机关，就无法确认公文发给了谁。它只检查该列是否填写，不检查收文范围是否正确——主送谁、抄送谁，属于拟稿决策。 |
| 我们的标题很长。长度上限从哪来？ | GW-005 会报告超过配置上限 60 个字符的 标题。这个数字是规则包的默认值，不是标准数字：GB/T 9704-2012 只规定标题用「2 号小标宋体字」，没有给出字数限制，所以你单位如果标题写得长，就调高 maxLength 或关掉这条规则。该规则只数字符，不评判标题措辞。 |
| 两行用了同一个发文字号。 | GW-006 会报告重复的编号；比较时忽略空白，命中通常意味着编号被复用或写错，需要人工确认。它不判定这两份公文里哪一份该用这个编号。 |

遵循的标准

| 文件 | 编号 | 引用它的规则 |
| 《党政机关公文格式》 | GB/T 9704-2012（现行，本次未取得条文） | GW-001, GW-002, GW-004, GW-005, GW-007 |
| 《党政机关公文处理工作条例》 | 中办发〔2012〕14号（自 2012 年 7 月 1 日起施行） | GW-003, GW-006 |

边界： 本插件检查公文台账的版头与主体要素中台账能够机械约束的部分——发文字号符合「机关代字〔年份〕序号」的形态、签署日期可解析、文种出自你的词表、主送机关有记录、标题不过长、编号不重复、没有残留的模板占位符。它检查的是台账记录的文本，不是版式——字体、字号、页边距和印章位置只能从公文本身判断。

⚠️ 本插件报告中的引文究竟依据什么

《党政机关公文处理工作条例》（中办发〔2012〕14号）已取得并逐字阅读， rules/evidence/clause-verification.md 记录了引用了哪些条款——第八条（十五种文种）、第九条（格式要素，包括「发文字号。由发文机关代字、年份、发文顺序号组成」和「主送机关。公文的主要受理机关」）、第十条（将版式委托给 GB/T 9704-2012）以及第四十二条（2012-07-01 起施行，取代此前两份文件，因此本规则包从不引用它们。）

GB/T 9704-2012 本身未取得。 这一点对某个细节有影响，值得直说：GW-001 模式里的六角括号〔〕是版式标准的惯例，不是条例规定的——第 9 条第 5 项只要求「发文机关代字、年份、发文顺序号」。

各规则的 excerpt 字段仍写着「本次未取得」，所有规则仍为 warn 或 info。 本插件检查的是文本登记簿所写的内容；条例管的是文件本身，所以把空列判为「文件应由……组成」的 direct 违规，会夸大结论。何况有一半规则本来就依据版式标准，或者依据你自己的惯例。

有两个阈值是本地约定，规则包也写明了。标题长度上限（GW-005，60 字符）是本规则包的默认值，不是标准数字——第 9 条第 7 项只规定标题由发文机关、事由和文种组成，两份文件都没有出现字数。文种词表（GW-003）出厂时为空，尽管第 8 条列出了十五种文种，因为该条说的是「主要有」，各单位也会使用列表之外的名称。

占位符检查有意不收录「某」：模板标题常写成「关于某某工作的通知」，但「某」在正式标题里也会作为涉密事由的代称出现。

兼容性

| 层面 | 状态 |
| Harness | 对等范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0——已验证同时接受 0.2.0-rc.2 和 0.2.1-rc.2。engines.dsh 声明为 >=0.2.1-0 <0.3.0，自 0.2.1 起由宿主强制执行 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码、无网络、不调用模型） |
| 工具模式 | 在 native 和 ptc 下均可运行；处理整年登记簿请用 ptc |

功能说明

注册 gongwen_word_check 工具。它读取一份文件登记簿——每行一份已发文件——套用带版本的规则包，返回报告。

| 规则 | 检查内容 | 严重级别 | 依据类型 |
| GW-001 | 发文字号符合「代字〔年份〕序号」 | warn | 原则 |
| GW-002 | 成文日期可解析且不在未来 | warn | 原则 |
| GW-003 | 文种来自你的词表（默认关闭） | info | 本地 |
| GW-004 | 记录了主送机关 | warn | 原则 |
| GW-005 | 标题未超过配置长度 | warn | 原则 |
| GW-006 | 登记簿内发文字号唯一 | warn | 原则 |
| GW-007 | 标题中没有未替换的占位符 | warn | 原则 |

配置

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

值得了解的规则级参数：

- GW-001 pattern —— 发文字号的形态。联合发文或没有编号的纪要，放宽它，或者禁用该规则。
- GW-003 values —— 你的文种，例如 [决议, 决定, 命令, 公报, 公告, 通告, 意见, 通知, 通报, 报告, 请示, 批复, 议案, 函, 纪要]。
- GW-005 maxLength / minLength —— 你的标题长度上下限。默认上限 60 是本地惯例，不是标准数字。
- GW-007 terms —— 要查找的占位符；「某」是故意不在其中的。

材料格式

工具接受 JSON 或 YAML：

issuer: 某某机关 year: 2026 rows:
- { 发文字号: 某政发〔2026〕15号, 标题: 某某机关关于印发某某管理办法的通知, 文种: 通知,
发文机关: 某某机关, 成文日期: 2026-03-10, 主送机关: 各直属单位, 抄送机关: 某某办公室, 密级: 公开, 紧急程度: 平件 }

列名匹配不区分大小写，并忽略空格、下划线和连字符；登记表自己的列名会保留，所以问题报告会指出它读取的是哪一列。日期可以写成 2026-03-10 或 2026-03-10 09:30 —— 中文数字日期会按设计报告为无法解析。

规则来源

规则数据放在 rules/gongwen-word-check.yaml。规则包的头部完整说明了引用缺口，每条规则的 note 又重复了与该规则相关的那部分。加载时的守卫通常强制「摘录必须是至少八个字符的真实引文」，但它分不清引文和描述 —— 所以这个规则包依赖头部、逐条规则的 note，以及一个测试，该测试断言每个 excerpt 都承认这个缺口。

故障排查

- GW-001 在我认为正确的编号上报错。 该模式要求年份写在六角括号〔〕里；用 []、（） 或连字符写的编号会失败。按你的行文习惯调整 pattern。
- GW-002 在中文数字日期上报错。 读取器接受 2026-03-10；二〇二六年三月十日 会按设计报告为无法解析，这样你可以决定要不要规范化导出。
- GW-003 从不运行。 它的词表是空的。哪些文种名称算作文种，由你的机构决定，插件不会去猜。
- GW-005 在页面上放得下的标题上报错。 默认上限是 60 个字符，属于本地惯例。调高它，或者禁用该规则。
- GW-007 在含「某」的标题上不报错。 这是故意的；如果你的模板确实把它当占位符用，就把这个字符加进 terms。
- 插件装上了，但工具一直不出现。 检查 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-gongwen-word-check@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-gongwen-word-check # refresh src/shared from ../_shared

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

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下面的名单默认折叠，好让每个 README 首屏都保持简短；展开即可看到每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 — 见仓库 README |
| dsh-claude-move | 🧊 已冻结 — 见仓库 README |
| dsh-defend | 🧊 已冻结 — 见仓库 README |
| dsh-draw | 🧊 已冻结 — 见仓库 README |
| dsh-reach | 🧊 已冻结 — 见仓库 README |
| dsh-background-agents | 🚫 已退役 — 见仓库 README |
| dsh-session-pin | 🚫 已退役 — 见仓库 README |
| dsh-team-rooms | 🚫 已退役 — 见仓库 README |

许可证

Apache License 2.0 © 2026 dsh-gongwen-word-check contributors。