dsh-crwu-workbench 0.0.10

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "dsh-crwu-workbench",
+  "version": "0.0.10",
+  "description": "中瑞世联工作台 / CRWU audit workbench for DeepSeek Harness: pick a pending audit report, dispatch one AI audit subagent, watch and stop/restart it, auto-upload deliverables to Aliyun OSS.",
+  "keywords": [
+    "deepseek-harness",
+    "dsh-plugin",
+    "dsh",
+    "cordis",
+    "plugin",
+    "audit",
+    "workbench",
+    "crwu"
+  ],
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mmungdong/crwu-ai.git",
+    "directory": "plugins/dsh-crwu-workbench"
+  },
+  "bugs": {
+    "url": "https://github.com/mmungdong/crwu-ai/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "scripts/prepare.mjs",
+    "config/crwu-workbench.yml",
+    "cordis.patch.yml",
+    "bin/",
+    "README.md",
+    "README.en.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "LICENSE",
+    "skills/README.md",
+    "skills/crwu/",
+    "skills/dws/",
+    "common/skills/"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": "^0.1.7-rc.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "npm run skills:sync && tsdown",
+    "build:lib": "node scripts/prepare.mjs --force",
+    "prepare": "node scripts/prepare.mjs",
+    "prepack": "npm run config:check && npm run skills:sync && npm run dws:check && npm run build:lib",
+    "test": "node --test \"tests/*.test.mjs\" \"tests/**/*.test.mjs\"",
+    "typecheck": "tsc --noEmit",
+    "version:check": "node scripts/sync-version.mjs --check",
+    "version:set": "node scripts/sync-version.mjs",
+    "check": "npm run version:check && npm run config:check && npm run skills:check && npm run skills:cli-guard && npm run dws:check && npm run typecheck && npm test && npm run build && npm run smoke:built",
+    "config:check": "node scripts/check-config.mjs",
+    "pack:assert": "node scripts/assert-pack.mjs",
+    "pack:assert:strict": "node scripts/assert-pack.mjs --strict",
+    "prepublishOnly": "npm run check && npm run pack:assert:strict",
+    "smoke:built": "node scripts/smoke-built.mjs",
+    "skills:sync": "node scripts/sync-common-skills.mjs",
+    "skills:check": "node scripts/sync-common-skills.mjs --check",
+    "skills:cli-guard": "node scripts/check-skill-cli-guard.mjs",
+    "bin:check": "node scripts/sync-binaries.mjs --check",
+    "dws:sync": "node scripts/sync-dws-skills.mjs",
+    "dws:check": "node scripts/sync-dws-skills.mjs --check"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ],
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-skill-filesystem": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.2",
+    "react": "^18.2.0"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-agent": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-fs": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-shell": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.2",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.3.1",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3"
+  }
+}

package/scripts/prepare.mjs

@@ -0,0 +1,59 @@
+/**
+ * 构建入口：`prepare`（git 安装 / 本地开发）与 `prepack`（发布前）都用它。
+ *
+ * **这个文件必须随包发布**（在 package.json 的 `files` 里）：npm 在**安装已发布的 tarball** 时
+ * 也会执行 `prepare`，如果它不在包里，装包的人会看到
+ * `npm error command sh -c node scripts/prepare.mjs`。这里连踩了两次，都记下来：
+ *   1. `prepare: "tsdown"` → tarball 里没有 `tsconfig.json` / `tsdown.config.ts`，tsdown 直接失败；
+ *   2. `prepare: "node scripts/build.mjs"` → `scripts/` 不在 `files` 里，脚本本身找不到。
+ *
+ * 两条路径怎么区分（判据是源码在不在）：
+ *   - **git 安装 / 本地开发**：源码在 → 真的构建。
+ *   - **npm 安装已发布产物**：源码不在 → 跳过（`lib/` 已随包提供）。
+ *
+ * 发布路径不允许静默出一个没有 `lib/` 的包：`prepack` 用 `--force`，源码不在即失败。
+ */
+import { spawnSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const ROOT = dirname(dirname(fileURLToPath(import.meta.url)))
+const SOURCE_MARKERS = ['tsconfig.json', 'tsdown.config.ts', join('src', 'index.ts'), join('src', 'client', 'index.ts')]
+
+/** 源码是否齐备（齐备 = 我们在 git 克隆里，可以构建）。 */
+export function missingSources() {
+  return SOURCE_MARKERS.filter((marker) => !existsSync(join(ROOT, marker)))
+}
+
+export function build() {
+  // 进度日志一律走 **stderr**：stdout 留给机器可读输出。npm 10（Node 22 自带）在
+  // `npm pack --dry-run --json --ignore-scripts` 下仍然会执行 prepare，这些日志一旦混进
+  // stdout，消费 `--json` 的脚本 `JSON.parse` 就炸了（CI 的 ubuntu/no​de22 就是这么红的）。
+  console.error('[build] tsdown 构建 lib/ …')
+  // 子进程的 stdout 也转去 stderr（'inherit' 会让 tsdown 的 ℹ 行落进我们的 stdout）。
+  const result = spawnSync('tsdown', { cwd: ROOT, stdio: ['inherit', 2, 'inherit'], shell: process.platform === 'win32' })
+  if (result.error) {
+    console.error(`[build] 构建失败：${result.error.message}`)
+    return 1
+  }
+  return result.status ?? 1
+}
+
+/** 供测试使用：按给定模式决定跳过还是构建。 */
+export function run({ force }) {
+  const missing = missingSources()
+  if (missing.length > 0) {
+    if (force) {
+      console.error(`[build] 缺少构建所需文件：${missing.join(', ')}`)
+      return 1
+    }
+    console.error(`[build] 跳过构建：这是已发布的预构建产物（缺 ${missing.join(', ')}），lib/ 已随包提供。`)
+    return 0
+  }
+  return build()
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  process.exit(run({ force: process.argv.includes('--force') }))
+}

package/skills/README.md

@@ -0,0 +1,26 @@
+# skills/ —— 分层技能目录
+
+`skills/` 本身**不是**技能根，而是**技能层的容器**。`cordis.patch.yml` 把每一层分别注册成一个
+DSH 技能根（`@deepseek-ai/dsh-skill-filesystem` 的 `customSkillDirs`）。
+
+| 层 | 目录 | 归属 | 改动方式 |
+| --- | --- | --- | --- |
+| `crwu` | `skills/crwu/` | 本仓自研的审核能力族 | 正常评审后改；必须过 Skill 自洽性 lint |
+| `dws` | `skills/dws/` | 上游 `dingtalk-workspace-cli` 的钉钉技能（vendored） | **只能**由 `npm run dws:sync` 改写 |
+| 公共 | 包内 `common/skills/`（源在 `plugins/common/skills/`） | 跨插件公共技能 | 改源仓，再 `npm run skills:sync` |
+
+## 为什么一层一个技能根
+
+DSH 对每个技能根**只扫一层**（`<根>/<技能名>/SKILL.md`），不递归。所以 `skills/` 自己不能当根：
+那样 `skills/crwu/` 会被当成"一个没有 `SKILL.md` 的技能"被跳过，**整层静默消失**（症状是
+provider 装配成功、技能表里 0 个技能）。
+
+## `dws` 层
+
+- 内容与版本身份记录在 `skills/dws/provenance.json`：上游包名、版本、集合、逐技能 sha256。
+- 同步：`npm run dws:sync`（自动找本机 `dws` 的上游副本；也可 `--source <dir>` 显式指定）。
+- 校验：`npm run dws:check`（只对照 `provenance.json`，不需要上游；`npm run check` 已含）。
+- 升级上游：`npm run dws:sync -- --allow-version-change`，审 diff，并把版本写进 `CHANGELOG.md`。
+- 上游以 Apache-2.0 发布：`LICENSE` / `NOTICE` 随技能一并保留，不得删除。
+- 这一层是**上游正文**，不受本仓「Skill 自洽性」lint 约束（上游按自己的跨技能相对链接组织）。
+  要改 dws 正文请回上游提 issue / PR，不要在这里就地改 —— 下次同步会覆盖。

package/skills/crwu/crwu-audit/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: crwu-audit
+description: Use when routing or orchestrating report audits from a material package, SeqNo, or ObjectId.
+---
+
+# crwu-audit 多维并集路由
+
+## 角色定位（审核立场 · 执行前先读）
+
+你是一名**资深资产评估师**，以严谨、克制、可复核的职业态度接管以下全部审核工作。三条硬立场：
+
+1. **报告说明与法律依据必须落到条文**：报告/评估说明中引用的每一处依据（法律法规、评估准则、监管规定、
+   协会要求），都必须回溯到**本次经 `crwu-dws` 实时下载的规则正文**，给出条款与出处；
+   **不得凭印象、经验或常识引用法条**，不得把"行业通常做法"写成"合规要求"。
+   法律或监管适用存疑时，只登记 `manualConfirmationItems[]`（待人工确认）或 `capability gap`，
+   **不擅自下确定性结论**——本次审核的底线是：**结论不越出证据，审核不违反法律法规与执业准则**。
+2. **测算表的计算必须逐格可复算**：一切涉及数字的结论以表内公式/缓存值或引擎重算值为准，
+   **禁止心算、估算与"看起来合理"**；合计与口径、跨表一致、公式错误、单位/小数按本技能与
+   `crwu-audit-datacheck` 的检查项核（含可见区公式链重算）。算不出来的（未重算、缺依赖、隐藏区引用）
+   必须**明示"未核"**，不得写成"已核"或"材料缺失"，也不得替代人工判断。
+3. **严谨 ≠ 加严**：不确定就写明不确定，证据不足就标证据不足；**不制造问题、不上调严重度**，
+   也不因"资深"身份发表超出规则与材料的价值判断——严重度只由规则影响与证据强度决定。
+
+本定位不改变任何既有门禁：H0 隐藏区禁读、两阶段隔离（阶段一不读复核记录）、防幻觉协议、双证据链、
+"未核 ≠ 缺失"。与上述门禁冲突时，**以门禁为准**。
+H0 的机制 owner 是 `references/00-input-and-route-profile.md`，隐藏区的去向、定级与边界以 `references/12-leaf-common-contract.md` §7.1 为唯一权威（运行时细则见 14）。
+
+## 职责与边界
+
+本技能是全部 `crwu-audit-*` 叶子的唯一入口，只负责定位报告、生成画像、准备和隔离材料、计算多轴并集、分发、独立审核结果汇总，以及后续复核对照和交付。本技能不产出具体专业审核判断；判断由实际加载的专业技能执行。
+
+- 叶子技能只能由本 router 编排，禁止单独调用，也不得自行重新查询报告记录。
+- 叶子不得替代其他轴；禁止创建或选择“资产 × 业务”等组合技能。
+- 规则正文与检查点必须覆盖完整 `skills_to_load`（含 public skill），经 `crwu-dws` 在本次运行实时下载。目录缓存只能定位，不能充当正文或证据；下载失败时记录缺口，不编造判断。
+- 评估目的、方法、结论方法及位置只能来自真实读取并定位的报告材料。字段、附件名和经验只能作为提示，不能补写原文或伪造位置。
+
+## 必读 references
+
+按下列顺序理解所有权；运行时只在对应阶段读取：
+
+1. [99-maintenance.md](references/99-maintenance.md)：仅在维护 router、references 或叶子时先读；普通审核运行不加载。
+2. [00-input-and-route-profile.md](references/00-input-and-route-profile.md)：每次运行开始时读取；定义输入字段、五轴画像、证据、文件读取和隐藏数据隔离。
+3. [01-report-id-resolution.md](references/01-report-id-resolution.md)：输入为 `SeqNo` 或 `ObjectId` 时读取；材料包输入无需记录查询。
+4. [02-scope-classification.md](references/02-scope-classification.md)：材料准备并真实读取报告后，生成 `scope_types[]`，并判定企业价值底层资产的 `materiality`。
+5. [03-asset-classification.md](references/03-asset-classification.md)：同阶段生成多标签 `asset_types[]`。
+6. [04-business-classification.md](references/04-business-classification.md)：同阶段按字段与已定位的目的原文生成多标签 `business_types[]`。
+7. [05-method-classification.md](references/05-method-classification.md)：报告方法与结论章节已真实读取后生成 `methods[]` 和 `conclusion_method`。
+8. [06-overlay-classification.md](references/06-overlay-classification.md)：生成 `overlays[]` 并处理 ROUTE001–004 冲突。
+9. [07-skill-registry.md](references/07-skill-registry.md)：所有轴完成分类后，把每个 `axis+label` 解析为 `available`、`pending` 或 `profile-only`。
+10. [08-union-dispatch-rules.md](references/08-union-dispatch-rules.md)：registry 解析完毕后形成稳定并集 `skills_to_load`，并按来源归并结果。
+11. [09-review-risk-classification.md](references/09-review-risk-classification.md)：构建画像时生成 `review_risk_class`；它只提示审核严谨度，不增删业务标签或技能。
+12. [10-capability-gap-proposal.md](references/10-capability-gap-proposal.md)：出现 `pending`、未注册标签或能力缺口时读取，逐标签记录 gap 或非审核提案。
+13. [11-html-delivery-spec.md](references/11-html-delivery-spec.md)：阶段一定稿冻结后、阶段二对照与交付（步骤 14）时读取；**送达与交付层正文**（CRWU 审核意见 HTML 送达规范 v1.6：AuditResult 单一事实源、JSON 校验先行、员工单文件 HTML + 同源监控 JSON、双证据链、两阶段门禁、客观命中率与验收清单）。
+14. [12-leaf-common-contract.md](references/12-leaf-common-contract.md)：加载任一 `crwu-audit-asset-*` / `crwu-audit-biz-*` 叶子时读取；**叶子共同约束**（轴边界、输入、一级根装配、二级选择、执行顺序、条目状态、来源优先级、证据出处、capability gap）。公共规则只在该文件写一份，叶子不各自复述；叶子与它冲突时以它为准。
+15. [13-dingtalk-result-publish.md](references/13-dingtalk-result-publish.md)：步骤 14 已生成最终态监控 JSON 后读取；定义固定组织/团队空间/结果目录的精确解析、按审核年月建目录、带生成时间戳文件名、DWS 上传与写后验证契约。
+16. [14-orchestration-workflow.md](references/14-orchestration-workflow.md)：**正式执行前必读**；router 运行时执行顺序与条件分支的唯一落点——脚本运行时（Python）、路由流程步骤 1–15、KB 兼容与运行时装配边界；步骤 14 的交付细节仍以 `11-html-delivery-spec.md` 为权威、钉钉回传仍以 `13-dingtalk-result-publish.md` 为权威，本文件不复述它们的正文。
+
+## 输入
+
+接受材料包、`SeqNo` 或 `ObjectId`。
+
+- `SeqNo` / `ObjectId` 只按 `01-report-id-resolution.md` 解析。`SeqNo` 必须精确查询；返回 0 条或多条时停止，不自行选择。
+- 不得硬编码或猜测 `ObjectId`、schema code 或 schema。schema 必须来自现场可验证结果或已确认配置。
+- 对记录型输入，router 只 fetch 一次完整报告记录，以同一快照构建画像并准备材料。H3Yun 项目附件与知识库规则/契约使用两条隔离的下载链，禁止混用。
+- 材料包输入直接盘点并准备其中材料；标识冲突、缺件或不可读项写入 `route_profile.conflicts[]` 或 `route_profile.material_gaps[]`。
+
+## 执行纪律：长任务不得空转（3 分钟介入准则）
+
+适用于本技能编排的全部外部命令与后台作业（附件下载、知识库批量下载、材料准备、脚本与交付渲染等），**包括叶子与子任务里启动的命令**：
+
+- **停滞判据**：同一任务（同一条命令／同一个后台作业）连续 **3 分钟既无新输出、也无状态变化**，即视为停滞——**不得**继续静默等待，也**不得**反复空轮询充作"在跑"。
+- **必须介入查因**（3 分钟是**介入触发器**，不是无条件终止）：
+  1. 查状态——进程/作业是否仍存活，是否在等输入、等凭据、等锁，或被沙箱/审批拦住；
+  2. 查原因——读最近输出与 stderr/日志，区分网络慢、审批未答、单件过大、死锁与命令写错；
+  3. 处置——能修就修（补参数、缩小范围、改分批或后台并周期查看）；确认无法推进时终止该任务并如实记 `capability gap`；
+  4. 留痕汇报——写明停滞时长、观察到的事实、已做处置与残余影响。
+- **禁止**把停滞静默当作"只是慢"或"再等等看"；**禁止**把停滞叙述成"材料缺失／无数据"。
+- **人工等待不适用**：等待用户本人操作（确认、授权、提供材料、扫码等）不计入 3 分钟，也不得因"无动静"而终止该流程或替用户作决定。
+
+## 运行时编排入口
+
+router 的运行时执行顺序与条件分支**只在** [14-orchestration-workflow.md](references/14-orchestration-workflow.md) 维护；入口不复述、不并行维护第二份。
+
+1. **正式执行前必须读取** `references/14-orchestration-workflow.md`——Python 运行时、路由流程步骤 1–15、KB 兼容与运行时装配边界都在那里。
+2. 必须**按 14 的步骤 1–15 顺序执行**：不得跳步、不得调序、不得改写已冻结的阶段产物。
+3. **阶段一隔离与冻结、阶段二复核不得合并**：读取任何复核记录前，阶段一正式意见与 `route_profile` 必须已定稿并冻结。
+4. Python 运行时与 KB 装配边界服从 14；交付与送达服从 [11-html-delivery-spec.md](references/11-html-delivery-spec.md)（**JSON 校验先行**、`validate` → `render --json-out` 调用序列与字段契约以 11 为唯一权威）；钉钉回传服从 [13-dingtalk-result-publish.md](references/13-dingtalk-result-publish.md)。
+5. 任一步门禁失败**按「失败与冲突」处理**，不得静默跳过，也不得降级叙述成"材料缺失"。
+
+## 失败与冲突
+
+- `SeqNo` 精确查询为 0 条或多条、`ObjectId` 身份冲突时是定位级硬停止：不得 fetch 候选记录、准备其附件或开始审核，先返回证据并等待人工处理。
+- 阶段一源材料必须经 `crwu_h3yun_file_get` **单附件**定向下载；该 Tool 不可见、返回 capability gap，或没有已隔离源材料包时停止材料准备并如实记录——本链路**没有**整单下载能力，因此不存在「用整单下载跨过复核记录隔离门禁」这条退化路径。
+- 单个标签或单个轴画像含混时，只挂起受影响标签/候选并写入 `route_profile.material_gaps[]`；其他已确认标签和轴必须继续求值、并集加载和审核。不得把局部歧义扩大为整体停止。
+- ROUTE001–004 只按 06 挂起受影响的业务/范围/资产标签、基准日或价值类型及其依赖规则；未受影响的技能继续执行。证据冲突不得静默任选一边。
+- 单个专业技能 `pending`、未注册、下载失败或执行失败时逐标签记录原因，其他 `available` 技能和满足条件的公共能力继续执行。
+- 钉钉回传的目标组织、团队空间或结果根目录零命中/多命中时停止回传；只有审核年份和月份目录允许缺失后创建。回传失败不删除本地交付件，也不得换组织、选相似目录或覆盖同名远端文件。
+- 只有所有分发维度均无可靠命中时，才停止专业审核结论，输出已知画像、证据、缺口与候选，请求人工确认；表格等不依赖画像的公共能力仍可按条件执行，但不得冒充专业结论。
+
+## 输出
+
+`skills_to_load` 专指 08 计算出的、可实际同时加载的 `available` 技能稳定并集，不包含 `pending` 候选或 `profile-only` 标签。输出 schema 中，画像字段只属于 `route_profile`；六个候选数组及稳定并集只属于 `dispatch`。下列字段必须完整保留，具体结构和定义以 `00-input-and-route-profile.md` 为准：
+
+```jsonc
+{
+  "route_profile": {
+    "identity": {},
+    "report_form": null,
+    "record_context": {},
+    "scope_types": [],
+    "asset_types": [], // 企业价值范围下每项另含 materiality=key|non-key|unknown
+    "business_types": [],
+    "methods": [],
+    "conclusion_method": null,
+    "overlays": [],
+    "review_risk_class": {},
+    "conflicts": [],
+    "material_gaps": [],
+    "weak_structured": false,
+    "confidence": {}
+  },
+  "dispatch": {
+    "scope_skills": [],
+    "asset_skills": [],
+    "business_skills": [],
+    "method_skills": [],
+    "overlay_skills": [],
+    "public_skills": [],
+    "skills_to_load": []
+  }
+}
+```
+
+稳定并集按 08 固定为：
+
+```text
+dispatch.skills_to_load = stable_unique(
+  dispatch.scope_skills + dispatch.asset_skills + dispatch.business_skills +
+  dispatch.method_skills + dispatch.overlay_skills + dispatch.public_skills
+)
+```
+
+最终编排结果还必须保留：
+
+- `route_profile`（内含五轴、各资产 `materiality`、`review_risk_class`、`conflicts[]` 和 `material_gaps[]`）与 `dispatch`（内含六数组和 `skills_to_load`）；
+- 材料工作路径、规则材料路径、未读取或未装载原因及适用规则集快照；
+- findings 及每条的 `source_skills[]`；
+- `references/11-html-delivery-spec.md`（v1.6 送达规范）要求的逐条裁定、复核对照与综合对比、《本次审核记录清单》、未检查项，以及最终**员工单文件 HTML + 内部同源监控 JSON**（AuditResult 单一事实源渲染）。
+- 脚本目录、用法与维护入口见 [scripts/README.md](scripts/README.md)（脚本清单、命令用法、强制校验规则与维护规则）；交付字段与编排层调用映射仍以 `references/11-html-delivery-spec.md` 为唯一权威，本入口不复述。
+- `references/13-dingtalk-result-publish.md` 要求的钉钉回传状态：成功时保留精确远端路径与节点 ID；失败时保留失败层级与真实原因。
+
+无专业技能可用时仍交付画像、逐标签 gap 与已执行公共能力结果，不以“无能力”空返。

package/skills/crwu/crwu-audit/references/00-input-and-route-profile.md

@@ -0,0 +1,232 @@
+# 输入与 route_profile
+
+| 版本 | v1.0 | 状态 | 2026-09-09 多维路由定稿 | 维护 | 输入字段与画像 schema 唯一事实源 |
+| --- | --- | --- | --- | --- | --- |
+
+## 导航
+
+- [输入字段](#输入字段)
+- [route_profile](#route_profile)
+- [文件级读取与溯源](#文件级读取与溯源)
+- [方法角色概要](#方法角色概要)
+- [KB 装配输入](#kb-装配输入)
+- [Excel 隐藏数据隔离（工作版重建）](#excel-隐藏数据隔离工作版重建)
+- [材料缺口与降级](#材料缺口与降级)
+
+## 输入字段
+
+报告审核记录的输入标识与必读字段如下。标识解析只按 [01-report-id-resolution.md](01-report-id-resolution.md) 执行。
+
+| 信号 | 字段 | 用途 |
+| --- | --- | --- |
+| 报告标识 | `SeqNo`、`ObjectId` | 定位唯一记录 |
+| 报告名称 | `F0000049` | 对象与业务弱结构化补充证据 |
+| 报告形态 | `F0000056` | `report_form` |
+| 业务大类 | `F0000065` | 业务类型主证据 |
+| 评估目的 | `F0000064` | 业务类型主证据 |
+| 评估范围 | `F0000066` | 范围与底层资产分类 |
+| 对象大类 | `F0000119` | 资产类型分类 |
+| 价值类型 | `F0000072` | 市场、公允、可收回、清算、残余等口径 |
+| 法定性 | `F0000051` | 报告条款强制力 |
+| 评估基准日 | `F0000067` | 时效性和冲突核查 |
+| 报告文号 | `F0000092` | 披露一致性 |
+| 监管归属 | `F0000082` | 国资覆盖层 |
+| 金融标志 | `F0000124` | 金融/银行覆盖层 |
+| 司法标志 | `F0000126` | 司法覆盖层 |
+| 证券标志 | `F0000127` | 证券覆盖层 |
+| 附件字段 | `F0000076` 等所有附件键 | 文件清单、下载和材料路径准备；文件名只是提示 |
+
+`F0000020`、`F0000158`、`F0000178` 等风险等级/级次/状态只是背景或对照信号，不参与范围、资产、业务、方法或覆盖层路由。业务大类/评估目的为空时可读 `F0000049` 推断；名称仍含混时记录“画像歧义，需人工确认”，不猜测分发。
+
+`F0000056` 的报告形态先于五个分发轴记录，并决定表述强制力：评估业务可使用评估结论等法定口径；咨询/估值文书使用参照口径，不得表述为“评估结论”或虚构结论有效期；矿业权评估同时继续识别 `asset_types[]=矿业权`。报告形态不能替代任何轴标签。
+
+## route_profile
+
+```jsonc
+{
+  "route_profile": {
+    "identity": {
+      "input": "用户提供的标识",
+      "input_type": "SeqNo|ObjectId|material-package",
+      "seq_no": "真实输入或查询返回值|null",
+      "object_id": "用户提供或精确查询所得|null"
+    },
+    "report_form": "资产评估业务",
+    "record_context": {
+      "report_name": "F0000049 原值",
+      "value_type": "F0000072 原值",
+      "legal_status": "F0000051 原值",
+      "base_date": "F0000067 原值",
+      "document_number": "F0000092 原值",
+      "recorded_risk_level": "F0000020 原值，仅作对照"
+    },
+    "scope_types": [],
+    "asset_types": [],
+    "business_types": [],
+    "methods": [],
+    "conclusion_method": null,
+    "overlays": [],
+    "review_risk_class": {},
+    "material_gaps": [],
+    "conflicts": [],
+    "weak_structured": false,
+    "confidence": {"overall": "high|medium|low", "note": ""}
+  }
+}
+```
+
+`scope_types[]`、`asset_types[]`、`business_types[]`、`methods[]` 和 `overlays[]` 中的每个分类标签必须具有：
+
+```jsonc
+{
+  "type": "清算",
+  "source": ["F0000064", "报告目的原文"],
+  "evidence": ["企业清算", "为破产清算提供价值参考"],
+  "location": ["record.F0000064", "评估报告·摘要·评估目的段(L60-68)"],
+  "confidence": "high|medium|low",
+  "review_required": false
+}
+```
+
+`source/evidence/location` 是不可拆分的数组三元组：`source[]` 说明来自记录字段、报告文件或名称推断，`evidence[]` 保留实际字段值或原文，`location[]` 给出字段键或文件·章节/页/行号；文件未读取时用 `evidence=["未抽验（文件未读取）"]`、`location=[]`，不得伪造。企业价值范围下的 `asset_types[]` 另必须包含 `materiality: key|non-key|unknown`，并保留判定理由。字段直读或真实报告原文为高置信度；报告名称推断为中或低置信度；来源冲突、弱信号或 `materiality=unknown` 时 `review_required=true`。
+
+## 文件级读取与溯源
+
+评估目的原文、评估方法、结论方法及其位置只能来自真实读取的文件：
+
+1. 源材料附件**只经单附件定向下载**取回：先 `crwu_h3yun_files_list` 取附件元数据，再对源材料件逐个 `crwu_h3yun_file_get({fileId, caseDir, relativePath: '材料-源/<文件名>'})`；复核件只记入《排除清单》、**永不下载**（阶段一门禁见 SKILL.md 步骤 2）。确认 Tool 返回的 `ok:true` 且 `sizeBytes` 非零。记录本体用 `crwu_h3yun_record_get` 一次取全字段。**不得**改用任何批量/整单下载方式。
+2. 先用 `file` 识别格式：旧 `.doc` OLE 可用 `textutil -convert txt`；`.docx` 读 OOXML；`.pdf` 用文本提取工具；`.xlsx/.xls` 用相应表格工具。先探测现有工具，不得凭印象宣称不可读。
+3. 在文件中定位原文，为文件级字段回填数组 `source`、`evidence` 与 `location`。没有定位不得用于冲突定论。
+4. 文件未下载或不可读时，字段显式标记 `未抽验（文件未读取）`，不填定位。
+
+附件名只能标记为提示或待抽验，不能据此表述“已采用某法”。严禁从氚云字段、附件名、行业经验补写报告原文，或编造章节、页码、行号。
+
+## 方法角色概要
+
+`methods[]` 保留报告披露/采用的全部方法。每项严格使用 00 的通用标签 schema：canonical 方法写入 `type`，`source/evidence/location` 均为数组，并保留 `confidence/review_required`；方法项额外使用 `role=采用-作结论|采用-未作结论|测算-参考`。`conclusion_method` 单独保留结论所用方法并引用相同 canonical `type` 和证据结构。详细判定与多方法检查见 [05-method-classification.md](05-method-classification.md)。
+
+## KB 装配输入
+
+五轴 `route_profile` 是 router 的唯一画像契约。**装配清单不再由本仓工具生成**：命中某个轴标签后，下载清单 = 命中叶子 `references/01-kb-assembly.md` 中该轴的路径键（一级目录根 `request_kind=directory`/`recursive=true`，或明确的单文件路径）＋公共执行契约路径并集。
+
+router 只负责把五轴画像映射成轴标签并选出 available 叶子；不得为兼容而生成旧画像键，也不得自行挑选叶子装配表以外的知识库文件。叶子按自身装配表声明的一级目录根，经 `crwu-dws` 递归实时下载该根下全部支持正文并准备材料；下载失败、空目录或不支持导出的节点记 capability gap，不静默忽略。
+
+## Excel 隐藏数据隔离（工作版重建）
+
+对下载的 `.xlsx/.xls`，在任何解析、提取或勾稽前制作工作副本。
+
+**为什么必须排除**：Excel 中的隐藏 sheet / 行 / 列 / 折叠分组是**员工（检查人）手动隐藏**的，
+表示其已明确不纳入本次审核。因此隐藏区**整体排除在审核范围之外**：不读取、不解析、不核对、不引用其任何
+单元格内容，不产生差异、不产生意见、不写入证据值；对隐藏区**既不报错也不报漏**。
+
+> **本节是隔离的「机制 owner」（mechanism owner），不是「口径 owner」。** 隐藏区事项的**定级、状态与去向**
+> （含是否进入人工确认清单、是否计入 `fail`、H1 授权的完整条件、可见公式引用隐藏输入时的处理方式）
+> **唯一权威是 `12-leaf-common-contract.md` §7.1** —— 本节**不复述、不另立一份**，执行时按名回指该节。
+
+本节负责实现的机制：
+
+- **隐藏结构识别**：只允许读取"哪些 sheet / 行 / 列被隐藏"这类**结构元数据**
+  （`ws.sheet_state`、`ws.row_dimensions[r].hidden`、`ws.column_dimensions[c].hidden`；折叠分组
+  `outlineLevel>0` 且组头 `collapsed=True` 视同隐藏），用途是把隐藏区从工作版中剔除并输出忽略清单。
+  隐藏段位以**原件 raw XML 的真实区段**（`<col min max hidden>` / `<row hidden>`）为准；工具集合与
+  raw XML 不一致时按 raw XML 判定，并按 §7.1 纪律 5 另记一条 `capability gap`（不得写成被审件缺陷）。
+- **可见区工作版重建**：只能用**重建法**（新建簿，只复制**可见 sheet × 可见行 × 可见列**的值与格式）；
+  禁止用 openpyxl `delete_rows`/`delete_cols` 逐行逐列删除（会残留维度元数据）。
+- **隐藏区引用审计**（H0 内唯一允许、且必须做的深化动作）：只解析**可见格公式里的引用坐标**，判断它是否
+  指向隐藏行/列/隐藏工作表 —— **只读坐标，不读隐藏区任何内容或公式**；判定"是否参与计算"**只看引用关系，
+  不看隐藏与否**；**不得**因"被引用"就把隐藏列并入工作版或纳入审核范围；命中项的**去向按 §7.1 第 3 行**处理。
+- **raw 坐标映射**：工作版因剔除隐藏行列导致坐标收缩时，形成 finding 前必须按重建时的行列对应关系
+  **映射回原件坐标**；只允许映射、引用 raw 可见区，不得借坐标回映读取或披露隐藏区内容。
+- **媒体锚点隔离**：锚点落在隐藏 sheet / 隐藏行 / 隐藏列上的**不导出、不定位**，只记数量与未核原因。
+- **`prepare_materials.py` 的输入输出**：输入 `<案例>/材料-源`；输出 `工作版/`、`提取/`、
+  `材料盘点.json`、`媒体证据/` + `媒体索引.json`。隐藏状态无法判定时按隐藏剔除，并记录"隐藏状态未知 · 已剔除"。
+- **不得自证正确**：仍**不得**读取隐藏区的值或公式来"自证正确"；要读取属 H1 例外，其授权口径见 §7.1。
+
+- raw 原件保留不动，只由编排层持有；隐藏状态无法判定时按隐藏剔除，并记录"隐藏状态未知 · 已剔除"。
+- 只能用**重建法**：新建簿并只复制**可见 sheet × 可见行 × 可见列**的值与格式。禁止用 openpyxl
+  `delete_rows`/`delete_cols` 逐行列删除（会残留维度元数据）。折叠分组（`outlineLevel>0` 且组头
+  `collapsed=True`）**视同隐藏**，一并剔除。
+- **缓存值优先**：单元格有缓存值（`data_only=True`）就写缓存值，**仅当无缓存值**才写公式串。
+  重建簿不会被 Excel 重算，写公式串会让后续 `data_only=True` 读回 `None`，把"公式未重算"误读成
+  "数据缺失"（曾据此误报"评估结果列全空"）。
+- **「值不可得」≠「数据缺失」**：无缓存值且为公式（含引用外部工作簿）的格，按表计数登记为
+  「值不可得（未重算/外部引用）」元数据（不含内容值）；后续只能**如实声明该格取不到值**，
+  **禁止**表述为"空白／缺失／未填"，也不得据此产生差异或下结论。
+- **输出名唯一 + 来源可追溯**：同名不同版本（如定稿与送审稿同名）必须消歧（追加来源目录后缀），
+  盘点须记录每份材料的来源子目录（`stage`）与工作版路径一一对应，**禁止静默覆盖**（曾因送审稿
+  覆盖定稿，把"使用状况"误判为"自用"）。
+- **不得改变格式语义**：逐格复制 `number_format`，数值／日期语义与原件一致；遇"疑似被日期化的
+  数值列"，结论前必须回 raw 原件核对格式（不得把原件问题与重建问题混为一谈）。
+- **遍历边界按"有值格"定，四层各归各的**（原件常见游离的 `value=None`、只有样式的"格式格"，
+  如整列刷格式残留；它们会让任何按声明用区遍历的工具退化成百万行扫描）：
+  **① 扫描边界** = **有值**格（缓存值 ∪ 公式串）的精确集合，不按声明用区扫矩形、不设阈值；
+  **② 内容边界** = 同一集合的 max 行列（即 `stats.maxRow/maxCol/visibleRows` 的口径）；
+  **③ 异常提示** = 声明用区与有值区相差 >1000 行/列 → 记入 `材料盘点.json` 的 `sheetAnomalies[]`
+  （属**可见区表格规范缺陷**，只提示、**不改变遍历、不改变审核范围**）；
+  **④ 规模护栏** = 单表有值格 >2,000,000 → 记 `capabilityGaps` 并跳过该表，**其余表继续**（不静默截断）。
+  未触发③的表若声明用区与有值区不一致，逐个在 `stats[].declaredSpan` 留痕，不丢信息。
+  注意：**"空洞大"≠"表大"**——按空洞裁会漏掉"游离格落在阈值以内"的病态表，故④按规模裁。
+- 保存后重新打开工作版，验证隐藏区数量为 0。失败则按重建法重做；仍残留则挂起，不继续审核。
+- 工作版剔除行列后坐标会收缩，而公式串仍保留 raw 坐标。公式／引用／合计范围类勾稽以 raw 坐标为准，
+  只读可见单元格；纯数值勾稽可在工作版执行。
+- **交付物中的 Excel 证据定位必须使用 raw 原件坐标**：最终意见、AuditResult、HTML、复核对照和
+  审核记录中的 Excel `locator`，必须写原件的工作表名与单元格／区域坐标；**工作版坐标仅限审核执行内部使用**，
+  不得作为对员工或复核人员的证据定位下发。工作版因剔除隐藏行列导致坐标收缩时，形成 finding 前必须按重建时的
+  行列对应关系**映射回原件坐标**，且只允许映射、引用 raw 可见区；不得借坐标回映读取或披露隐藏区内容。
+  **无法可靠映射**时，**不得下发该定位**，也不得猜测原件坐标；应将该项降为「待人工确认事项」并记录
+  `capability gap`，直至取得可验证的原件定位。
+- **任何"未列示／缺失／为空"类结论下发前，必须回到 raw 原件（定稿）逐条复读确认**——不得凭工作版、
+  更不得凭同名送审稿下此类结论（同一项目曾因此复发三次）。
+- **非单元格证据（媒体/页眉页脚/批注/形状/图表）不得据工作版判断，必须走「媒体证据通道」**：
+  重建法只复制单元格值与 `number_format`，**必然**丢弃 `xl/media/`、`word/media/`、`xl/drawings/`、
+  页眉页脚（`xl/worksheets/*.xml` 的 `headerFooter`）、批注（`xl/comments*.xml`）与形状/图表。
+  编排层由 `scripts/prepare_materials.py`（内部调用 `scripts/media_extract.py`）把媒体**导出**到
+  `<案例>/媒体证据/`，并写放行清单 `<案例>/媒体索引.json`；叶子按下述口径消费：
+  ① **"工作版中不存在" ≠ "原件中不存在"**——对媒体类证据，只看工作版（甚至只看 raw 的单元格）
+  都会得出错误的"为空/缺失"；
+  ② 判读媒体**只经放行清单**：`媒体索引.json` 的每条含 `mediaId`、`kind`、受控 `locator`
+  （如 `1-2市场案例位置图!图片#1（锚点 4:4）`、`<文件名>#第<N>页图片#<序号>`、
+  `评估说明.docx!第<段落号>段图片#<序号>（前文：…）`、`<文件名>（整图）`）、`localPath`
+  （案例内相对路径）、`sha256`。**叶子不得自行解析 raw 原件包**（raw 只由编排层持有）；
+  ③ **判读交宿主多模态读图**（DeepSeek Harness 的 `read_image` 等）；读不到（宿主无视觉能力、
+  图片损坏、媒体未导出）只能出「**未核验**」，**严禁**表述为"为空／缺失／未列示"——
+  **未核 ≠ 缺失**（真实失效 2026-302150-LX9757-BG8677：`MKT-004` 判"可比实例位置图为空、
+  询价截图缺失"，而原件 `04评估计算表.xlsx` 实有 26 个媒体对象、位置图带 4.6/5.4/3.8 km 标注）；
+  ④ **H0 同样适用于媒体锚点**：锚点落在隐藏 sheet / 隐藏行 / 隐藏列上的媒体**不导出、不定位**，
+  只在盘点里记数量（`hiddenSkippedCount`，无内容、无 locator）；锚点不可判定（`absoluteAnchor`、
+  未被任何 drawing 引用的部件、图表、页眉页脚）与**隐藏结构不可得**时一律**保守不导出**并记
+  `unresolvedReasons[]`（fail-closed）。媒体内容本身若呈现隐藏区内容，属 H1，须书面授权；
+  ⑤ 盘点汇总在 `材料盘点.json` 的 `nonCellEvidence`（`filesWithMedia` / `rawMediaCount` /
+  `exportedMediaCount` / `hiddenSkippedCount` / `unresolvedCount`）与逐件的 `mediaEvidence`；
+  `rawMediaCount` 与 `hiddenSkippedCount` **只记数字**，不含内容与定位。
+- raw 原件只由编排层持有，叶子/下游只接收工作版路径**与编排层导出的媒体证据副本**（`媒体索引.json`
+  放行的 `媒体证据/` 文件）。唯一其他例外是公式/引用坐标核查可对 raw 可见区做限定只读访问。
+  叶子整簿读 raw、读 raw 隐藏区或读仍含隐藏区的工作文件时立即阻断并记录违规。
+- **读不到 ≠ 材料缺失**：因缺依赖（`openpyxl`/`python-docx`/`pypdf`/`xlrd`）、无文本层（扫描件）、
+  加密或格式不支持而读不到的材料，一律记 `capability gap` 并**如实声明"该件本次未核"**；
+  **禁止**表述为"材料缺失/未提供"，更不得据此产生差异或结论。脚本每次运行都会汇报缺失依赖。
+  `.docx` 在缺 `python-docx` 时自动回退 `textutil`（评估说明/报告正文多为 `.docx`，读不到会直接
+  改变结论），回退会在盘点中标注。
+- **图片/扫描件同理**：本机不保证 OCR 与渲染能力（`tesseract`/`pdftoppm`/`soffice`/`PyMuPDF` 可能
+  全缺），媒体判读只能由**宿主多模态**完成。宿主无视觉能力、图片不可读或媒体未导出时，逐条写
+  `scope.notCheckedItems`（`reasonCode=unreadable|unsupported`）并给 `requiredAction`，
+  **不得**计入"缺失材料"，也不得据此下"为空/缺失"结论。
+- **压缩包必须先解压再审核**：盘点时遇 `.zip/.tar/.tar.gz/.tar.bz2/.tar.xz/.tgz` 等归档，**必须先解压，再对解压产物实施审核**——归档内的测算底稿、明细表与源材料同等对待（同样提取文本、重建工作版、执行隐藏区隔离）。**不得把归档登记为"未解压"就跳过**（真实案例中一个归档内的"土地使用权-工业拟变更住宅-测算底稿"因此长期未被审核，属潜在漏检）。
+  - **落点**：解压到 `<案例目录>/解压/<归档名>/`，**源材料目录零写入**；盘点记录 `originArchive` 指向来源归档，可追溯，避免"解压产物来源不明"。
+  - **阶段一隔离门禁优先于解压**：归档内含复核记录类文件（复核/质控/外审/答复/审核意见等）时**不解压该条目**，只记名字，不得让其内容进入阶段一工作集。
+  - **安全**：拒绝绝对路径、`..` 越界（zip-slip）与符号链接条目；条目数与解压总量设上限，超限记 capability gap，不静默放过。
+  - **文件名编码**：zip 内中文名常为 GBK 且未置 UTF-8 标志位，默认按 cp437 解码会得到乱码文件名——**必须按 GBK 重解码**，否则连"这份材料是什么"都无法判断。
+  - **不支持的格式**：`.rar/.7z` 等在本机无 `7z/unar` 时，记 capability gap「该件本次未核」并如实声明，**不得记作"材料缺失"，也不得静默跳过**；嵌套归档限深解压（默认 2 层）。
+- **实施（技能自带脚本，随技能安装）**：`scripts/prepare_materials.py`
+  （`<DSH Python 绝对路径> scripts/prepare_materials.py --case <案例目录>`（解释器路径的口径见 SKILL.md「脚本运行时（Python）」））产出 `材料盘点.json` / `媒体索引.json` /
+  `提取/` / `工作版/` / `媒体证据/`；媒体抽取通道在同目录 `scripts/media_extract.py`
+  （xlsx 锚点、docx 段落序、`.doc` 经 `textutil` 中转、PDF 内嵌图、独立图片；H0 与 fail-closed 见上）。
+  **阶段二复核件**用 `--src <案例>/复核-人工 --label 复核` 复跑（产出 `复核盘点.json` /
+  `复核媒体索引.json` / `媒体证据-复核/`），**禁止覆盖阶段一冻结的 `材料盘点.json`**。
+  契约测试 `scripts/test_prepare_materials.py` 与 `scripts/test_media_extract.py` 覆盖缓存值优先、
+  隐藏区零泄漏（含折叠分组与**媒体锚点**）、同名消歧、「值不可得」登记、缺依赖不静默空返、
+  源目录只读、格式保留、媒体导出与阶段二产物隔离。
+
+## 材料缺口与降级
+
+缺失材料、未抽验字段、未注册标签或 pending 能力按标签分别写入 `material_gaps[]`。不可用的单个技能不得导致其他 available 技能短路；不得以“无能力”空返，应附非审核结论的能力缺口说明。

package/skills/crwu/crwu-audit/references/01-report-id-resolution.md

@@ -0,0 +1,13 @@
+# 报告标识解析
+
+| 版本 | v1.0 | 状态 | 2026-09-09 定稿 | 维护 | 报告记录唯一定位规则 |
+| --- | --- | --- | --- | --- | --- |
+
+1. `ObjectId` 只能来自用户明确输入，或一次真实查询的返回结果。
+2. 输入为 `SeqNo` 时，必须对报告审核（report-audit）schema 的 `SeqNo` 字段做精确查询，并解析为唯一 `ObjectId`。schema code 必须来自现场可验证的 schema 查询结果或已确认的配置。
+3. 精确查询返回 0 条时立即停止，返回：“未找到该报告流水号”。
+4. 返回多条时，列出可供识别的候选记录（至少 `SeqNo`、报告名称、更新时间、`ObjectId` 尾段），然后停止并等待人工确认。
+5. 不得猜测 schema code 或 `ObjectId`；不得用模糊报告标题匹配代替精确 `SeqNo` 查询；不得在 0 条或多条时自行选择。
+6. router 只获取一次报告记录，以该快照构建 `route_profile`并准备材料路径。leaf skill 只消费 `route_profile` 与已准备好的材料路径，不重复查询报告记录。
+
+字段与报告材料出现标识冲突时，将真实值和来源写入 `conflicts[]`，停止使用受影响的记录身份，等待人工确认。