应急预案核对 PerryLink/dsh-emergency-plan

dsh-emergency-plan — 应急预案要素完整性检查与条款级页码定位

dsh-emergency-plan 读取一份应急预案——它的章节树、标题、页码和正文——再对照编制导则检查这份预案的要素完整性：哪些要素存在，哪些缺失，哪些只有标题、标题下没有正文，以及每个要素落在哪里——材料带页码时按页码定位，否则按行号定位。它把带版本号的规则包应用到材料声明的预案类型上，每条检查结果都会写明它出自哪一条条款，并说明该条款是直接要求、原则还是本地配置；跑不起来的检查会在 skipped 里说明原因，而不是悄悄算通过。

它能回答什么

| 你问 | 它答 |
| 我们的材料从没说自己是三种预案类型里的哪一种。会怎样？ | EP-004 会报告材料没有声明 planType，因为三种类型各自对应不同的要素清单。它只检查声明在不在，不检查声明得对不对；在声明缺失期间，EP-002 和 EP-003 会在 skipped 里说明自己假定了哪份要素清单。 |
| 一份综合应急预案没有后期处置章节。会被报告吗——它还需要编制目的章节吗？ | EP-002 会逐条查找现行导则第 6 章（6.1~6.5）的五个一级要素，找不到哪个就报告哪个，所以缺后期处置会被报告。编制目的不属于这五个：现行版本已将其删除，规则包只把它当作总则的别名接受。这条结果是 warn，因为编制导则是推荐性国家标准，不是强制性标准。 |
| 专项应急预案和现场处置方案里哪些要素是必选的？ | EP-001 要求专项应急预案的 7.1~7.4 要素，EP-003 要求现场处置方案的 8.1~8.4 要素，各自报告在章节树里找不到的要素；标题存在但标题下没有正文的，报告为空。两份清单都是下限，不是封闭清单——现场处置条款写的是包括但不限于——所以多出要素不算问题。在 EP-001 里，7.5 应急保障要素仍为推荐；在 EP-003 里，《生产安全事故应急预案管理办法》中那份更短的清单作为单独依据保留，绝不与导则的清单合并。 |
| 我们合并了两份预案，现在同一个要素标题出现了两次。这能查出来吗？ | EP-007 会报告出现多次的必选要素，并列出所有匹配到的标题。没有哪条条款直接这么规定——规则包是从目次顺序的唯一性推导出来的——所以它最高只能给 warn，并且规则包要求人工确认，因为重复通常来自合并多份预案。它比较的是自己应用的那份要素清单，不是材料里所有重复的标题。 |
| 报告把 EP-005 显示为 skipped，为什么？计划必须带页码吗？ | 只有当至少两个元素带有 page 或 line 时，EP-005 才能比较元素顺序；没有这些信息时，它会在 skipped 里说明情况，而不是擅自假定顺序。EP-006 把页码当作定位信息：一旦带页码的章节占比达到 minPageRatio（默认 0.5），它就不再出声；低于这个占比时，也只给出 info 级发现。两者的上限都是 info——顺序预期来自一份资料性附录，而非标准正文——并且没有页码的计划绝不会被报告为违反某条款：报告改用行号定位。 |
| 为什么 EP-008 和 EP-009 出现在 skipped 下，而不是通过？ | 两者都在等配置。EP-009 只在 requireAttachments 设为 true 时运行，因为调用方通常只提供计划正文、不提供附件，把附件报成缺失会误导人；启用后，它会查找那八个附件项，并报告找不到的项。EP-008 只在配置了 versionPatterns 时运行：列表为空时，它不规定版本标记该长什么样；一旦配置，它只检查配置的标记是否出现在章节标题中——从不检查修订内容是否正确。 |

遵循的标准

| 文件 | 编号 | 被哪些规则引用 |
| 《生产经营单位生产安全事故应急预案编制导则》 | GB/T 29639-2020 | EP-001, EP-002, EP-003, EP-004, EP-005, EP-006, EP-007, EP-008, EP-009 |
| 《生产安全事故应急预案管理办法》 | 国家安全生产监督管理总局令第88号（应急管理部令第2号修正） | EP-001, EP-002, EP-003, EP-009 |

边界： 这个插件对照编制导则检查应急预案的元素完整性，并按页码定位每个元素，报告与所引条款的字面差异。它不是 dsh-rulefile-check（那个审计法规文件的合法性），也不是 dsh-hidden-risk-map（那个把隐患台账映射到判定条款）。它读取一份计划，报告哪些元素存在、缺失或为空，以及它们的位置。

⚠️ 这个插件建立在两处纠正之上——请务必阅读

1.「八要素」不是现行要求。 大家熟悉的那份清单——总则、事故风险描述、应急组织机构及职责、预警及信息报告、应急响应、信息公开、后期处置、保障措施、应急预案管理——属于 GB/T 29639—2013，该标准已被整体替代。它的同名内容在任何现行国家文件中都找不到。
现行标准 GB/T 29639-2020 在第 6 章给出综合预案的五个一级要素（6.1 总则 / 6.2 应急组织机构及职责 / 6.3 应急响应 / 6.4 后期处置 / 6.5 应急保障），其前言记载编制目的已被删除。任何引用 2013 条款号的规则，引用的都是已废止的标准。本规则包只引用 2020 条款号，并有测试断言 2013 的编号绝不会出现。

2. 页码没有强制性依据。 没有任何国家文件要求计划必须带页编号；管辖目次的附录是资料性附录（informative，非规范性），其中不含「页码」二字。因此页码被视为帮助评审人定位的信息，在 info 级别报告，绝不表述为「不符合 X」。当计划不含页码时，报告回退到行号。

规则包中还记录了第三处较小的更正：《生产安全事故应急预案管理办法》的正确版本是国家安全生产监督管理总局令第88号（2016），经应急管理部令第2号（2019）修订——不是光秃秃的「应急管理部令第2号」——并且国办发〔2013〕101号已被国办发〔2024〕5号取代。

兼容性

| 层面 | 状态 |
| 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 |

功能

注册 emergency_plan 工具。它读取一份计划的章节树——标题、页码和正文——套用带版本的规则包，返回一份报告，其中每条发现都指明来自哪一条款，并说明该条款是直接要求、原则，还是本地配置。

| 规则 | 检查项 | 严重级别 | 依据类型 |
| EP-001 | 专项应急预案包含其 7.1–7.4 要素 | warn | direct |
| EP-002 | 综合应急预案包含其 6.1–6.5 要素 | warn | direct |
| EP-003 | 现场处置方案包含其 8.1–8.4 要素 | warn | direct |
| EP-004 | 材料声明自己属于三种类型中的哪一种 | warn | direct |
| EP-005 | 各要素按导则规定的顺序出现 | info | principle |
| EP-006 | 各章节带页码，便于定位发现 | info | principle |
| EP-007 | 没有要素标题重复出现 | warn | principle |
| EP-008 | 按配置要求存在版本或修订标记 | info | local |
| EP-009 | 计划包含附件信息（默认关闭） | info | direct |

要素清单放在规则包里，不放在代码里，因为它们随导则版本变化。严重级别反映了 GB/T 29639 是推荐性国家标准：要素清单不完整记为 warn，不是 error。

安装

dsh plugin --profile <name> add dsh-emergency-plan
dsh --profile <name> --dump-config | grep 'dsh-emergency-plan'

配置

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

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

- EP-001 / EP-002 / EP-003 的 elements —— 各预案类型的要素列表，格式为
[{ name, aliases }]。替换它就能对照别的导则版本，或对照你自己单位的模板。列表为空时，规则会报告无法运行。
- EP-006 的 minPageRatio —— 规则保持沉默所需的最低页码覆盖率，即必须带页码的章节占比。
- EP-008 的 versionPatterns —— 哪些字符串算作你模板里的版本标记。为空时规则不运行。
- EP-009 的 requireAttachments —— 默认关闭，因为调用方通常只给正文、不带附件；只有附件确实在材料里时才开启。

材料格式

工具接受 JSON 或 YAML，也接受纯文本预案。推荐用章节树形式，因为抽取预案的调用方本来就知道每个标题的位置：

name: 某公司生产安全事故综合应急预案 planType: comprehensive # comprehensive | special | on-site sections:
- { title: 总则, page: 1, body: 本预案适用于…… }
- { title: 应急组织机构及职责, page: 2, body: 明确应急组织形式…… }
- { title: 应急响应, page: 3, body: 规定信息报告、预警与响应程序。 }

标题与各要素的 aliases 分三步逐步放宽匹配：先归一化后精确相等，再包含，最后是小编辑距离。这样 五、保障措施 和 二、组织机构与职责 都能找到对应要素。比较前会剥掉编号前缀（一、、1.1、…）。直接粘贴 markdown（# 总则）也行，会按标题切分，但没有页码——报告里会说明这一点。

规则来源

规则数据放在 rules/emergency-plan.yaml。每条规则都带一份文件、一个文号、按来源自身编号的条款、一段逐字摘录，以及摘录的读取 URL。加载器强制要求：摘录必须是真实引用，至少八个字符；只靠一般原则或地方政策支撑的检查，永远不能判为 error。

引用的条款来自 GB/T 29639-2020 第 5.1、6、7、8 条和附录 C.1、C.3，以及 国家安全生产监督管理总局令第88号（应急管理部令第2号修正） 第 13、14、15、16 条。

有三项发现塑造了这套规则包，并记录在其头部：

1. 「八要素」出自一份已废止的标准。 现行综合预案要素列表只有五个一级要素，编制目的已被删除。
2. 页码没有强制依据，所以它只是 info 级别的定位辅助，绝不作为不符合项。
3. 标准代号前缀变了。 应急管理部公告 2025 年第 1 号把 AQ/T 9011-2019 等十一项标准迁到 YJ 前缀，编号、年份和内容不变——所以配套的评估导则现在写作 YJ/T 9011-2019（原 AQ/T 9011-2019）。评估导则与编制导则是两回事：GB/T 29639 管编制，YJ/T 9011 管评估。

故障排查

- 每个元素检查都报告自己被跳过。 该计划类型的规则包 elements 列表为空，或者材料从未声明 planType，检查便拒绝假定一个。
- 你明知存在的标题被报告为缺失。 把它加进该元素的 aliases。匹配是字面匹配（加上上面三步放宽），不是语义匹配，这是有意为之。
- EP-005 不报告任何顺序信息。 各章节既没有 page 也没有 line，没有可用来排序的依据；规则在 skipped 里说明了这一点。
- EP-006 对没有页码的计划抱怨页码。 这正是该规则的用意，而且它是 info：它在告诉你报告只能引用行号。调低 minPageRatio，或者忽略它。
- 插件装上了，工具却始终不出现。 检查 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-emergency-plan@0.1.0 --dsh-version <runtime> --accept-risk
- check 报告 manifest-peers 失败。 静态检查器比对的是一个硬编码的 peer 范围，它早于 0.2 系列。运行时在安装时强制校验 peer 兼容性，所以声明的范围才是正确的；这是 dsh-plugin-dev 中已知的上游问题。

Development

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # vitest, paired fixtures per rule
pnpm run build # tsdown -> lib/index.mjs + lib/index.d.mts
node ../scripts/sync-shared.mjs dsh-emergency-plan # refresh src/shared from ../_shared

License

Apache License 2.0 © 2026 dsh-emergency-plan contributors.