施工资料检查 PerryLink/dsh-construction-doc-check

dsh-construction-doc-check — 施工资料检查

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

dshfind

dsh-construction-doc-check 会遍历项目的资料档案，报告哪些必备资料类型缺失、哪些看起来是旧版本和当前版本并排放在一起、哪些文件是空的。

它只读文件名，不读文件内容。这是有意设定的上限：真实档案里有上千份资料，先让资料员把它们抄进表格，只会给他添活，不会减负。文件夹和文件名本来就在他手上。

安装

dsh plugin --profile <name> add dsh-construction-doc-check
dsh --profile <name> --dump-config | grep 'dsh-construction-doc-check'

效果示意

dsh-construction-doc-check 的工作流示意图：资料 → 规则包 → 检查结果。

工作流概览：资料 → 规则包 → 检查结果。

边界： 这个工具不做三件事。它不打开资料，所以「存在」不等于「正确」——内容检查是后面一层的事。它不判断某类资料该有几份：一个分项可能要几十份检验批记录，这里只查有没有，不查够不够。文件缺失只说明档案无法证明工作做过，不等于工作没做。

它能回答什么

- 哪些必备资料类型在档案里完全找不到？
- 哪些资料有多个版本并排存放？
- 哪些文件是零字节，也就是存在但没法用？
- 哪条具名要求缺失，依据是哪一条条款？

遵循的标准

要求逐字引自产生它的条款：

- 《建筑工程施工质量验收统一标准》GB 50300-2013 — 检验批、隐蔽工程、分部验收、竣工验收四张表。
- 《建设工程质量管理条例》国务院令第279号 第十六条、第二十九条 — 竣工报告、保修书、材料检验。
- 《危险性较大的分部分项工程安全管理规定》住建部令第37号 — 专项方案与验收。

有两条要求标为 institutional-configuration，因为它们来自组织自己的归档制度，而不是国家标准；这两条永远不会是 error。

兼容性

| 层面 | 状态 |
| Harness | peer 范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码、无网络、不调用模型） |

它做什么

十四条规则。其中十二条按模式匹配相对路径，识别某类资料——文件夹也算，因为真实档案就是按文件夹分类的。另外两条是集合级规则：CD-040 报告同一资料名带版本标记（(1)、副本、最终、V2）重复出现，CD-041 报告零字节文件。
零字节文件也算满足「这类文件存在」的要求，但会单独报告：「有文件」和「文件可用」是两回事，报告里两者都会写。

配置

| 键 | 默认值 | 含义 |
| rulesFile | rules/construction-doc-check.yaml | 规则库路径 |

材料格式

输入是一个目录。规则包声明要查找什么：

- id: CD-020
title: 危大工程应有专项施工方案 category: 危大工程 severity: error
patterns: [专项施工方案]

scan.skipDirs 里列出的目录（.git、node_modules、旧版备份 等）整目录跳过。扫描深度上限由 scan.maxDepth 控制（默认 6），触到上限时报告会说明。

规则来源

引文存放在 rules/evidence/clauses.md 和规则包里；check:citations 会逐条核对，确认每段引文都原样出现。

已知限制：匹配只看名称，所以名称对、内容错的文档也会算作已提供。数量不做判断——那需要子项明细，属于 L1 层。另外扫描有深度上限，嵌套很深的归档可能把文档报成缺失，其实只是多深了一层；触到上限时报告会说明。

故障排查

- 插件装上了，工具却一直不出现：检查 main 是否指向 lib/index.mjs，以及 pnpm run build 是否生成了它。
- dsh plugin add 拒绝这个包：peer 范围覆盖 0.1.x 和 0.2.x；超出范围就显式授予豁免。
- 某条规则没跑：看 skipped 数组。

开发

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
node ../scripts/sync-shared.mjs dsh-construction-doc-check

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-construction-doc-check contributors。