dsh-eia-guide-check — Environmental impact assessment guideline applicability sheet check

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

What it is — Environmental impact assessment guideline applicability sheet check. It returns a list of what is inconsistent, where, and what to fix. Who it is for — EIA preparers and environmental officers; no command line required. What you give it — the source material the check works on (a table, register or document); the original is never modified. Excel can be converted to JSON/YAML first, in chat if the platform supports it. What it does not do — no compliance verdict, no liability finding, no replacement for the reviewer; differences only. How to start — search "Professional Document Check Suite" in WorkBuddy / Coze (the full set; this check is one part of it; availability as listed); or: dsh plugin --profile <name> add dsh-eia-guide-check

dsh-eia-guide-check reads one guideline-applicability sheet for an environmental impact assessment — the project header plus one row per assessed element — and checks that sheet's own traceability: that every element names its applicable guideline, that the guideline number follows the published form, that the guideline's status comes from the vocabulary you configure, that an assessment method or an applicable standard is recorded, that no element is registered twice, that the header declares the project and the report type, and that no unreplaced template placeholder survives in the standard column.

Install

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

What it looks like

Workflow overview: document → rule pack → findings. The examples below use the real command surface.

What it answers

Examples

The table below is the example set: the first row is the detailed walkthrough, the remaining rows are short cases.

Detailed output

Tool eia_guide_check

Input

{"rows":[{"序号":"1","评价要素":"环境空气","导则名称":"","导则编号代码":"", ...}]}

Output

{
  "id": "dsh-eia-guide-check.EG-001.de09b5a6",
  "ruleId": "EG-001",
  "severity": "warn",
  "locator": {
    "row": 1,
    "field": "guideName"
  },
  "found": "第 1 行 guideName、guideCode 都为空",
  "expected": "guideName、guideCode 至少应填写一项",
  "fix": "补填适用导则名称与编号；本条只核对是否指明，不判断适用是否正确"
}

Observed from dsh-eia-guide-check/tests/fixtures/EG-001/EG-001-unsafe.json; dsh-eia-guide-check/tests/fixtures/EG-001/cases.json; dsh-eia-guide-check/rules/eia-guide-check.yaml; dsh-eia-guide-check/tests/index.test.ts

| You ask | What it answers | |---|---| | One element row leaves both the guideline name and the guideline number blank. Is that reported? | Yes. EG-001 reports the row when guideName and guideCode are both empty, because the row has to name at least one of them. It checks only whether a guideline is named, never whether the named guideline is the right one for that element: the plugin holds no guideline catalogue and does not map an element onto a guideline. | | The guideline number is written as HJ 2.3, with no year. Is that caught? | Yes. EG-002 checks the form HJ <number>—<four-digit year>, as in HJ 2.3—2018, so a value without the four-digit year does not match and is reported row by row. It checks the form only: not whether the number exists, not whether it is current, and not whether it matches the name beside it. A blank guideCode cell is left alone — empty values stay outside this form check. | | The status column says 现行. Why was it never checked? | Because EG-003's values list ships empty, meaning the status vocabulary is not configured yet: the rule reports itself in skipped, with the reason that this vocabulary is the institution's own, rather than passing silently. Once configured, it checks only whether the filled value is on that list — not whether the guideline is really in force. | | The assessment method is filled in, but the standard column still reads 【待填】. Is that caught? | EG-004 requires only that one of method or standard is filled, so a filled method satisfies it; it does not judge whether the method applies or the standard is correct. The leftover placeholder is caught by EG-007, which reports the first configured term it finds in the standard column (【, 】, XXX, 待填, TBD, 示例 and similar). Those terms are adjustable, and a wholly empty standard cell is reported by neither rule. | | 地表水 is registered twice, once for water quality and once for sediment. What happens? | EG-005 reports the repeated element value and names the earlier row it matches, because a duplicate makes it impossible to tell which guideline governs that element. It compares the text with whitespace removed only, and the finding needs human confirmation: assessing one element by medium is normal, so write the sub-item into the element name instead of deleting the row. With no element column the rule reports that it could not run rather than passing silently. | | The header carries no project name and no report type. What happens? | EG-006 reports the header as missing project and reportType, because the report type (报告书／报告表／登记表) decides which set of requirements applies. It checks only that the header declares them; it does not judge whether the type was classified correctly. |

Standards it follows

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

Boundary: this plugin checks an 环评导则适用性核对表 for traceability — that each environmental element names its applicable guideline, that the guideline number follows its published form, that the guideline's status comes from your vocabulary, that an assessment method or an applicable standard is recorded, that elements are not double-registered, that the sheet names its project and report type, and that no placeholder survives. It does not decide whether an environmental assessment is compliant, whether the assessment level is right, whether a prediction model applies, or whether the conclusions hold.

⚠️ Read this before trusting a citation in the report

excerpt status is per rule, not uniform. Some rules quote the clause verbatim (kind: direct), some are derived from the principle of the cited articles (kind: derived-from-principle, capped at warn), and some use thresholds your institution configures (kind: institutional-configuration, capped at info). The pack never paraphrases a quotation: when the text was not obtained, the excerpt field says so and the reasoning lives in note; a test asserts that no rule claims a quotation it does not have. For any rule still marked as not obtained, replace the excerpt with the real clause and raise kind to direct once the text is in hand.

The conclusion is the reviewer's: this plugin lists differences it can point to in the material and does not decide facts or compliance.

Compatibility

| Surface | Status | |---|---| | Harness | Peer range >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0 — verified to accept both 0.2.0-rc.2 and 0.2.1-rc.2. engines.dsh is declared as >=0.2.1-0 <0.3.0 and is enforced by the host since 0.2.1 | | Node | ^22.19.0 || >=24.0.0 | | Platforms | All (plain ESM; no native code, no network, no model call) | | Tool mode | Works in native and ptc; for a full assessment sheet use ptc |

What it does

Registers the eia_guide_check tool. It reads one guideline-applicability sheet — the project header plus one row per element — applies a versioned rule pack, and returns a report.

| Rule | Check | Severity | Basis kind | |---|---|---|---| | EG-001 | each element names its applicable guideline | warn | principle | | EG-002 | the guideline number follows its published form | warn | principle | | EG-003 | the guideline status comes from your vocabulary (off by default) | info | local | | EG-004 | a method or an applicable standard is recorded | warn | principle | | EG-005 | elements are not double-registered | warn | principle | | EG-006 | the sheet names its project and report type | warn | principle | | EG-007 | the standard column holds no unreplaced placeholder | warn | principle |

Configuration

| Key | Type | Default | Description | |---|---|---|---| | rulesFile | string | rules/eia-guide-check.yaml | Rule-pack path, relative to the package root | | disabledRules | string[] | [] | Rule ids to stop running; each appears in skipped | | onlyRules | string[] | [] | Run only these rule ids; empty runs every rule | | skipNotes | string | "" | Note appended to every skipped reason | | timeoutMs | number | 120000 | Cooperative tool timeout budget |

Rule-level parameters worth knowing:

• EG-002 pattern — the number's shape, HJ 数字（可带小数）—四位年份 by default. Widen it if your register writes numbers another way.
• EG-003 values — your status vocabulary, e.g. [现行, 已废止, 被替代, 部分适用]. Empty means no check; no current-version table is built in.
• EG-007 terms — the placeholders to look for.

Material format

The tool accepts JSON or YAML:

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

Column names are matched case-insensitively and ignoring spaces, underscores and hyphens; the sheet's own column names are kept, so a finding names the column it read.

Rule sources

Rule data lives in rules/eia-guide-check.yaml. Its header explains that the plugin holds no guideline catalogue, does no element-to-guideline mapping, and did not verify each guideline's current version. The load-time guard still requires a document, clause, excerpt and source per rule, and still forbids a principle-derived or locally configured check from being error.

Troubleshooting

• It did not flag the wrong guideline for an element. By design: it has no catalogue and never maps an element to one. Confirm against the classification list and each guideline's scope yourself.
• EG-002 passes a number I know is withdrawn. The check reads the number's form, never its validity or currency. Tracking versions is a different job.
• EG-002 fires on a number I wrote correctly. The pattern wants the HJ prefix, the number, and a four-digit year separated by a dash or em dash. Adjust the pattern, or fix the cell.
• EG-003 never runs. Its vocabulary is empty; fill it with the statuses your quality system uses.
• EG-005 fires on two rows for one element. Assessing one element by medium (surface water quality and sediment, for instance) is legitimate — write the sub-item into the element name rather than deleting a row.
• The plugin installs but the tool never appears. Check that main resolves to lib/index.mjs and that pnpm run build produced it; a wrong main makes the loader skip the entry silently.
• dsh plugin add refuses the package as incompatible. The peer range covers 0.1.x and 0.2.x; if your runtime sits outside it, grant an explicit exemption: dsh plugin --profile <name> allow-version [email protected] --dsh-version <runtime> --accept-risk
• check reports manifest-peers as failed. The static checker compares against a hard-coded peer range that predates the 0.2 line. The runtime enforces peer compatibility at install time, so the declared range is the correct one; this is a known upstream issue in dsh-plugin-dev.

Development

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

The plugin is data-only: src/model.ts declares the table shape, the shared kit supplies the reader and the check engine, and the rule pack declares every check.

PerryLink DSH Plugin Family

Full family index: choose a checker by material and all plugins. This repository is one of them.

License

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