dsh-site-log-check

把监理日志的缺日、重复与旁站记录的漏项、对不上，逐条指到具体日期、具体栏目与所引条款。

面向监理工程师与总监代表的 DeepSeek Harness 检查插件：读一份机器可读的监理资料导出，套用 14 条带条款出处的规则，只列字面差异——不下合规结论、不认定责任、不改原件。

安装 · 配置 · FAQ · 简体中文 · English · Español · Português · हिन्दी

dsh plugin --profile <name> add dsh-site-log-check

_{社区插件，与 DeepSeek 官方无关。唯一仓库：https://github.com/PerryLink/dsh-site-log-check（Gitee 为镜像）。}

dsh-site-log-check 读取一个工程项目的监理资料——监理服务期、逐日监理日志、声明需要旁站的关键部位与关键工序清单、旁站记录——并按规则库引用的条款逐项核对：同一日历日是否出现两条以上日志、日志日期是否落在服务期内、服务期内哪些日子没有日志、每条日志是否填写了各项栏目与记录人、声明的旁站清单是否存在且每项都有对应的旁站记录、旁站记录是否填写了起止时间且先后顺序正确、关键部位与工序、施工单位、发现的问题及处理情况与签字，以及日志里声明的旁站当日是否有旁站记录对应。报出的都是字面差异，每条差异都带出它依据的条款，供人工复核。

边界： 本插件核对一个施工项目的日常监理日志的连续性以及现场监理记录的覆盖情况——即工程监理领域。它不是 dsh-archive-check（该插件核对项目记录在归档层面是否齐备），不是 dsh-hazplan-check（该插件核对危险性较大分部分项工程专项方案的章节），也不是现场安全检查员。它读取监理机构自身记录的机器可读导出，报出与所引条款之间的字面差异。

1. 安装（三选一）：

   # npm 通道（已发布版本）
   dsh plugin --profile web add dsh-site-log-check
   # git 通道（最新 main；安装时执行 package.json#prepare 里的 tsdown 产出 lib/）
   dsh plugin --profile web add github:PerryLink/dsh-site-log-check
   # tarball 通道：本仓库 pnpm pack 后
   dsh plugin --profile web add ./dsh-site-log-check-<version>.tgz

   也可以在 WorkBuddy / 扣子搜「职业文档核对全集」（总包，本检查是其中一项；上架以商城为准）。

2. 最小配置（默认即可用）：

   - insert:
       - id: dsh-site-log-check
         name: dsh-site-log-check

   全部可调项都在 src/config.ts 的 Schemastery schema 里，逐条阈值在 rules/site-log-check.yaml 中。

3. 验证已生效：

   dsh --profile <name> --dump-config | grep 'dsh-site-log-check'

   再用自带样例跑一次（约 1 分钟；样例脚本从 lib/index.mjs import，先构建）：

   pnpm install && pnpm run build
   node samples/quickstart/run.mjs

   $ node samples/quickstart/run.mjs
   site_log_check: 5 issue(s) — error 0, warn 1, info 4
   skipped: 12
   

   样例输入在 samples/quickstart/input/SL-001-unsafe.yaml，期望输出在 samples/quickstart/expected/result.json；node samples/quickstart/run.mjs --json 给出同一份摘要的 JSON。

卸载：dsh plugin --profile <name> remove dsh-site-log-check（或从 profile patch 删掉该行）。

dsh-site-log-check 注册 site_log_check 工具：读入一份监理资料（JSON 或 YAML），套用带版本的规则包，返回一份结构化报告——每条差异都带 found / expected / fix 与所引条款。

• 规则包即数据 —— 14 条规则全部在 rules/site-log-check.yaml；替换该文件即切换规则集，不用改 TypeScript。规则包在加载期校验，而不是被信任。
• 严重级跟着依据走 —— 依据为原则性条款（derived-from-principle）的规则封顶 warn；依据为本机构配置（institutional-configuration）的阈值封顶 info；绝不会把原则或本地配置标成 error（有测试断言）。
• 空清单不等于没问题 —— 每一项无法执行的检查都会在 skipped 里自报规则 id 与原因；必填清单未配置的规则自报 skipped，而不是静默通过。
• 不裁决 —— 报告只列差异，永不判定合规、责任或对错；措辞守卫拦下裁决用词，报告始终携带免责声明。
• 引文必须逐字 —— 每条规则带文件名、文号、按原文自身编号体系的条款号、逐字摘录（不少于八个字符）与来源链接；原文取不到时在摘录里明说，并把规则标为 derived-from-principle，绝不把转述包装成引文。
• 三种交付形态 —— 同一次检查同时给出 markdown（给模型读）、reportJson（机器可读）与 workbookBase64（xlsx：汇总 / 差异清单 / 未执行 三张工作表），可直接附在记录里存档。

监理资料（服务期 · 日志 · 旁站清单 · 旁站记录）──site_log_check──▶ 规则包 SL-001…SL-014 ──▶ 报告（findings + skipped）
        ▲                                                                                          │
        └────────────────────────────── 只读输入，原件永不修改 ────────────────────────────────────┘

本规则库没有 error 级规则，原因见「依据的标准」。

以下为插件真实入口；安装后调用一次即可。

详细输出 —— 工具 site_log_check，输入：

project:
  serviceStart: "2026-03-01"
  serviceEnd: "2026-03-05"
logs:
  - date: "2026-03-01"
  - date: "2026-03-05"

输出：

{
  "id": "dsh-site-log-check.SL-002.378ce636",
  "ruleId": "SL-002",
  "severity": "info",
  "locator": {
    "cell": "2026-03-02"
  },
  "found": "2026-03-02 无监理日志记录",
  "expected": "监理服务期 2026-03-01 ~ 2026-03-05 内应按日历日记录",
  "fix": "核对是否因停工、节假日或日志未归档；确无施工活动的应有说明"
}

Observed from dsh-site-log-check/tests/fixtures/SL-002/SL-002-unsafe.yaml

简短示例：site_log_check · only: ["SL-001"] · rulesFile: rules/site-log-check.yaml（可在调用时覆盖规则库，做一次性对比）。

全部可调参数都在 src/config.ts 的 Schemastery schema 中，只改 cordis.yml 即可生效，无需改代码；逐条阈值在 rules/ 下的规则库文件里。全部配置键即下表 5 个；规则级参数见表后。

值得知道的规则级参数：

• SL-001 maxPerDay —— 同一日历日允许的日志条数，默认 1。
• SL-002 minCoverageRatio（默认 0.9）与 ignoreWeekends（默认 false）—— 覆盖率达标时本条只进 skipped 并列出缺日，不逐日列差异。
• SL-009 requireEndTime（默认 true）—— 设为 false 则不再要求填写结束时间。
• SL-011 requireContractorSignature（默认 true）—— 合同不适用双方签字要求时设为 false。
• SL-012 keyWorks —— 需旁站的关键部位、关键工序清单，默认逐字取自建市〔2002〕189号第二条；该条只覆盖房屋建筑工程，其他专业工程按该办法第十二条「可以参照本办法实施」，请替换清单。

profile patch 覆盖示例：

- insert:
    - id: dsh-site-log-check
      name: dsh-site-log-check
      config:
        onlyRules: [SL-001, SL-002]
        skipNotes: 本机构实施细则 2026 版

⚠️ 这里没有 error，因为标准是推荐性的

GB/T 50319-2013 是推荐性国家标准 —— 住房和城乡建设部公告第 35 号批准其为「国家标准， 编号为 GB/T 50319-2013」，其前言未声明任何章为强制性。对比 GB 26860—2011，其前言 明写「第5章和7.3.4为推荐性，其余为强制性」。条文里的「应」是工程建设标准的起草惯例， 不等于法律强制，因此每条规则最高只到 warn，本插件不阻断任何流程。

这不表示这些要求不重要：监理日志与旁站监理是《建设工程质量管理条例》规定的法定义务。 但承载此处所核具体条款的标准是推荐性的，所以只提示、不阻断。

工具接受 JSON 或 YAML。字段在读取层是可选的，由检查引擎校验，因此部分导出的材料会产生「缺项」类差异，而不是让程序崩溃。

target: 某住宅楼工程 监理日志与旁站记录
project:
  name: 某住宅楼工程
  serviceStart: "2026-03-01"
  serviceEnd: "2026-03-05"
logs:
  - date: "2026-03-01"
    weather: 晴，具备施工条件
    progress: 三层顶板钢筋绑扎完成 80%
    supervision: 巡视 2 次；旁站混凝土浇筑 1 次
    issues: 个别箍筋间距偏大，已要求班组整改并复查
    recorder: 张监理
keyWorks:
  - name: 土方回填
    contractor: 某基础工程公司
onsite:
  - id: PZ-0001
    keyWork: 混凝土浇筑
    contractor: 某建筑公司
    startedAt: "2026-03-04 08:00"
    endedAt: "2026-03-04 12:30"
    issues: 未发现问题；坍落度经检测符合要求
    supervisorSignature: 张监理
    contractorSignature: 李质检

• project.serviceStart / project.serviceEnd 决定监理服务期，SL-001、SL-002、SL-013 都以它为准。
• logs[] 的 weather / progress / supervision / issues / recorder 分别对应 SL-003 到 SL-007。
• keyWorks[] 是声明的旁站清单，SL-008 核对它是否存在、SL-012 核对每项是否有旁站记录。
• onsite[] 的 startedAt / endedAt 对应 SL-009，issues 对应 SL-010，两处签名对应 SL-011，keyWork / contractor 对应 SL-014。

规则数据在 rules/site-log-check.yaml，与代码分离。每条规则携带文件名、文号、按原文自身编号体系的条款号、逐字摘录与来源链接。加载器强制：摘录必须是真实引文且不少于八个字符；依据仅为一般原则（kind: derived-from-principle，上限 warn）或本机构配置（kind: institutional-configuration，上限 info）的检查永远不能标为 error。夸大依据的规则库会在加载期失败，而不会产出一份看起来很有底气的报告。

条款号已对照《建设工程监理规范》GB/T 50319-2013 与《房屋建筑工程施工旁站监理管理办法（试行）》建市〔2002〕189号全文核对。三处核验结论塑造了本规则包，一并记在这里，供复核者看出哪些结论是刻意没有作出的：

1. 「每日连续」没有国家标准条文。 GB/T 50319-2013 只在监理日志的定义里写了「每日」（第2.0.21条）；「日期应连续」的明文出自福建省 DBJT 13-144-2019 这一地方标准，因此 SL-002 封顶为 info。
2. 双方签字不是 50319 的要求。 表 A.0.6 只有一个签字栏「旁站监理人员（签字）」。要求施工企业质检人员也签字的是建市〔2002〕189号第七条，SL-011 把两份依据分别标注，而不是合并成一条。
3. 每日签字与总监签阅是地方要求。 它们出自山东省 DB37/T 5009，不是国家标准，因此本规则包只核对是否留下记录人（SL-007），不虚构签字义务。

SL-012 里的关键工序清单也逐字对照过建市〔2002〕189号第二条。完整的条款核验记录（含经核查后被弃用的来源）见 rules/evidence/。

• 只核对可机上判读的字面项。 它不判断补记是否成立、缺日究竟因停工/节假日/日志未归档、签字是否真实、栏位里的内容写得对不对——这些留给人。
• 没有 error 级规则。 承载此处所核具体条款的 GB/T 50319-2013 是推荐性国家标准，所以 14 条最高只到 warn 或 info；义务本身在《建设工程质量管理条例》第三十八条，做法在推荐性标准。
• 连续性阈值是本机构配置。 SL-002 的 minCoverageRatio（默认 0.9）在覆盖率达标时只把缺日列进 skipped，不逐日列差异；ignoreWeekends 默认 false，周末同样计入。
• SL-012 的关键工序清单只适用房屋建筑工程。 清单逐字取自建市〔2002〕189号第二条；其他专业工程按该办法第十二条「可以参照本办法实施」，需替换 keyWorks。
• 第7.2.2条第4款两种读法并存。 「及处理情况」与「及协调解决情况」两种来源措辞不同，官方件本轮未能复核；SL-006 因此只看栏位是否填写，不对措辞作判断——这是核对范围的边界，不是「另一种读法有误」的断言。
• 「每日签字、总监签阅」不是国标要求。 出自山东省 DB37/T 5009，本插件只核对是否留下记录人，不虚构签字义务。
• 日期是墙上时钟字符串运算。 全部计算都是对输入字符串做墙上时钟运算，不做时区换算。

• 插件装上了但工具不出现。 确认 main 指向 lib/index.mjs 且 pnpm run build 已生成该文件；main 写错会让加载器静默跳过该条目。
• dsh plugin add 报版本不兼容。 peer 范围覆盖 0.1.x 与 0.2.x；若运行时在其之外，可显式豁免：dsh plugin --profile <name> allow-version [email protected] --dsh-version <runtime> --accept-risk。
• SL-002 什么也没报。 覆盖率仍在 minCoverageRatio 之上，缺日列在该条 skipped 说明里；想把每个缺日都看成一条差异，把比例调低即可。
• 某条规则没有执行。 查看报告末尾的「未执行的检查」，其中写明了规则 id 与原因（停用、清单未配置、无可用输入）。
• check 报 manifest-peers 失败。 静态检查器比对的是一份早于 0.2 世代的硬编码 peer 范围；安装期的 peer 校验以运行时为准，声明的范围才是正确的。这是 dsh-plugin-dev 的已知上游问题。
• 发现里写着条款原文未取得。 规则库不伪造引文：取不到原文时严重级停在 warn / info 并在 excerpt 里说明，这属于核验缺口，不是「材料没问题」的证据。
• 时间看起来偏移。 全部计算都是对输入字符串做墙上时钟运算，不做时区换算。

• Gitee 镜像（同步镜像，以 GitHub 为准）
• dshfind 插件页（安装量与排名）
• OpenSSF Scorecard 报告（由 .github/workflows/scorecard.yml 驱动）
• DSH Market（已上架）
• 生态实测知识库 · 按材料选核查器（完整家族清单：62 个核查器 + 通用插件）

pnpm install
pnpm run typecheck        # tsc --noEmit
pnpm test                 # vitest，每条规则配对正/反夹具（tests/fixtures/<RULE>/）
pnpm run build            # tsdown -> lib/index.mjs + lib/index.d.mts
pnpm run verify:self-contained   # 依赖 spec 均来自 registry
pnpm run check:lockfile   # pnpm-lock 未漂移
pnpm run check:readmes    # 五语 README 一致性
pnpm run check:citations  # 每条 excerpt（含 alsoBasis）都是逐字引文
pnpm pack                 # 发布 tarball
node ../scripts/sync-shared.mjs dsh-site-log-check   # 从 ../_shared 刷新 src/shared

目录布局：

规则包是数据不是代码：改 rules/*.yaml 即切换规则集，无需动 TypeScript；规则包在加载期校验，而非被信任。README 配图由 scripts/gen-readme-assets.py 程序化生成（Python + Pillow）：hero 为 1440×576 的四版 WebP（中英 × 深浅），结构图为手写 SVG（深浅双版），均可重复执行；本插件无 UI，图内只画材料面、规则闸与报告通道。

Topics：dsh, dsh-plugin, deepseek-harness, deepseek, cordis, site, log

本项目是 PerryLink 维护的 DeepSeek Harness 插件家族成员（全部 Apache-2.0）。如果这个插件帮到了你，给个 star——它不解锁任何功能，但会让下一个人更容易找到它。

• @PerryLink —— 创建者与维护者：site_log_check 工具、逐字引文的规则包与条款核验记录（rules/evidence/）、五语文档。

LICENSE（Apache License 2.0）© 2026 dsh-site-log-check contributors

_{Apache-2.0 · 社区插件，与 DeepSeek 无关。}