环评导则核对 PerryLink/dsh-eia-guide-check

dsh-eia-guide-check — 环境影响评价导则适用性表检查

dsh-eia-guide-check 读取环境影响评价的一张导则适用性表——项目表头，加上每个受评要素一行——并检查这张表自身的可追溯性：每个要素是否都写明了适用导则、导则编号是否符合公布格式、导则状态是否取自你配置的词表、是否记录了评价方法或适用标准、是否有要素重复登记、表头是否声明了项目和报告类型，以及标准列里是否还残留未替换的模板占位符。

它能回答什么

| 你问 | 它回答 |
| 某个要素行把导则名称和导则编号都留空了，这会被报出来吗？ | 会。guideName 和 guideCode 都为空时，EG-001 会报出这一行，因为这一行至少要写明其中之一。它只检查有没有写明导则，从不检查写明的导则对该要素是否合适：插件里没有导则目录，也不把要素映射到导则。 |
| 导则编号写成 HJ 2.3，没写年份，这能查出来吗？ | 能。EG-002 检查 HJ <number>—<four-digit year> 这种格式，比如 HJ 2.3—2018，所以没有四位年份的值匹配不上，会逐行报出。它只检查格式：不检查编号是否存在、是否现行，也不检查它和旁边的名称是否对得上。guideCode 单元格为空则不管——空值不参与这项格式检查。 |
| 状态列写着 现行，为什么从没检查过？ | 因为 EG-003 的 values 列表出厂是空的，也就是说状态词表还没配置：这条规则会在 skipped 里报告自己，理由是这个词表属于机构自定，而不是悄悄放过。配置好之后，它只检查填的值在不在这个列表里——不检查导则是否真的现行。 |
| 评价方法填了，但标准列还写着 【待填】，这能查出来吗？ | EG-004 只要求 method 或 standard 填了其中之一，所以填了方法就算满足；它不判断方法是否适用、标准是否正确。残留的占位符由 EG-007 查出，它会报出标准列里找到的第一个已配置词项（【、】、XXX、待填、TBD、示例 之类）。这些词项可以调整，而标准单元格完全为空时，两条规则都不会报。 |
| 地表水 注册了两次，一次用于水质，一次用于沉积物。会发生什么？ | EG-005 会报告重复的 element 值，并指出它匹配到的较早那一行，因为重复之后就无法判断哪个导则管辖该要素。它只比较去掉空白后的文本，且该发现需要人工确认：按介质分别评估同一要素是正常做法，所以应把子项写进要素名称，而不是删掉那一行。如果没有 element 列，该规则会报告无法运行，而不是静默通过。 |
| 表头没有项目名称，也没有报告类型。会发生什么？ | EG-006 会报告表头缺少 project 和 reportType，因为报告类型（报告书／报告表／登记表）决定适用哪一套要求。它只检查表头是否声明了这两项，不判断类型分类是否正确。 |

遵循的标准

| 文件 | 编号 | 引用它的规则 |
| 《环境影响评价技术导则》系列 | 各导则现行版本号本次未逐一核实 | EG-001, EG-002 |
| 本机构环评质量管理口径（本机构配置） | 无统一标准（本条依据为本机构配置的状态口径） | EG-003 |
| 《环境影响评价技术导则 总纲》 | HJ 2.1（现行版本号与条号本次未核实） | EG-004, EG-005, EG-007 |
| 《建设项目环境影响评价分类管理名录》 | 现行版本与条号本次未核实 | EG-006 |

边界： 本插件检查 环评导则适用性核对表 的可追溯性——每个环境要素是否写明其适用导则、导则编号是否符合发布形式、导则状态是否取自你的词表、是否记录了评估方法或适用标准、要素是否重复注册、表格是否写明项目和报告类型、是否残留占位符。它不判定环评是否合规、评估等级是否正确、预测模型是否适用、结论是否成立。

⚠️ 本插件刻意做不到的事

它不含导则目录，也不把要素映射到应当管辖它的导则。 因此它找不到后果最严重的错误：给某个要素用错导则。 在 HJ 2.2、HJ 2.3、HJ 2.4、HJ 964 等之间做选择，取决于项目类别和所涉要素，要确认就得读分类名录和每部导则的适用范围。这一限制写在本包的表头、EG-001 的说明，以及下面的疑难解答一节。

所以「适用导则」列只是登记表自己的陈述。这里检查的都是能机械检查的东西：有没有写下来、编号看起来像不像导则编号、状态是不是你认得的值、有没有记录方法或标准。

本插件也不附带现行版本表——要跟踪哪些导则现行有效、哪些已被替代，得跟进部里的公告，而状态词表由你自行配置。
EG-002 只检查编号的形式（HJ 2.3—2018），从不检查这个编号是否存在、是否现行，也不检查它和旁边的名称是否对得上。

规则包里每一条 excerpt 都明说了：条款原文没有拿到 —— 校验环节既没有取回导则的逐字原文，也没有核对每一份导则的现行版本。等原文到手后，把每条 excerpt 换成真正的条款，并把 kind 提升为 direct。

兼容性

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

它做什么

注册 eia_guide_check 工具。它读取一份导则适用性表 —— 项目表头加上每个要素一行 —— 套用带版本的规则包，返回报告。

| 规则 | 检查内容 | 严重级别 | 依据类型 |
| EG-001 | 每个要素都写明适用的导则 | warn | principle |
| EG-002 | 导则编号符合其公布形式 | warn | principle |
| EG-003 | 导则状态取自你的词表（默认关闭） | info | local |
| EG-004 | 记录了方法或适用标准 | warn | principle |
| EG-005 | 要素没有重复登记 | warn | principle |
| EG-006 | 表中写明项目和报告类型 | warn | principle |
| EG-007 | 标准列里没有未替换的占位符 | warn | principle |

安装

dsh plugin --profile <name> add dsh-eia-guide-check
dsh --profile <name> --dump-config | grep 'dsh-eia-guide-check'

配置

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

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

- EG-002 pattern —— 编号的形状，默认是 HJ 数字（可带小数）—四位年份。如果你的台账用别的方式写编号，把它放宽。
- EG-003 values —— 你的状态词表，例如 [现行, 已废止, 被替代, 部分适用]。留空表示不检查；没有内置的现行版本对照表。
- EG-007 terms —— 要查找的占位符。

材料格式

工具接受 JSON 或 YAML：

project: 某某建设项目 industry: 某某行业 reportType: 报告书 compiler: 某某环评单位 rows:
- { 序号: '1', 评价要素: 环境空气, 导则名称: 环境影响评价技术导则 大气环境,
导则编号代码: HJ 2.2—2018, 导则状态: 现行, 应用章节: 第 5 章 大气环境影响预测与评价, 评价方法: AERMOD 预测模式, 评价范围: 二级评价，边长 5 km 矩形, 评价因子: PM10、PM2.5、SO2、NOx, 执行标准: GB 3095—2012 环境空气质量标准 }

列名匹配不区分大小写，并忽略空格、下划线和连字符；工作表自己的列名会保留，所以一条发现会写出它读取的列名。

规则来源

规则数据放在 rules/eia-guide-check.yaml。它的头部说明：插件不持有导则目录，不做要素到导则的映射，也没有核实每条导则的当前版本。加载时的守卫仍然要求每条规则都有文档、条款、摘录和来源，也仍然禁止把源自原则的检查或本地配置的检查标为 error。

故障排查

- 它没有为某个要素标出错误的导则。 这是设计如此：它没有目录，也从不把要素映射到导则。请自己对照分类清单和每条导则的适用范围核实。
- EG-002 放过了我知道已废止的编号。 这项检查只读编号的形式，从不判断它是否有效或是否现行。跟踪版本是另一件事。
- EG-002 对我写对的编号报了错。 模式要求有 HJ 前缀、编号，以及用连字符或破折号分隔的四位年份。调整模式，或者修正单元格。
- EG-003 从不运行。 它的词表是空的；请填入你的质量体系使用的状态。
- EG-005 对同一个要素的两行都报了错。 按介质评价同一个要素（比如地表水质量和沉积物）是合理的——把子项写进要素名称，而不是删掉一行。
- 插件装上了，但工具一直不出现。 检查 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-eia-guide-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-eia-guide-check # refresh src/shared from ../_shared

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

许可证

Apache License 2.0 © 2026 dsh-eia-guide-check contributors。