dsh-crwu-workbench 0.0.10

package/bin/manifest.json

@@ -0,0 +1,82 @@
+{
+  "schemaVersion": "crwu.plugin-bin-manifest.v1",
+  "generatedAt": "2026-09-28T01:55:47.678Z",
+  "platforms": [
+    {
+      "platform": "darwin-arm64",
+      "tools": [
+        {
+          "tool": "crwu",
+          "file": "crwu",
+          "platform": "darwin-arm64",
+          "source": "repo-build",
+          "sourceVersion": "0.0.1",
+          "target": "darwin/arm64",
+          "buildCommit": "d90d55efe18bd6ae01bd3102959ed7a62c4381c2",
+          "size": 7351330,
+          "sha256": "864496c621bcfaddd23a433ce4dcd36b32a882f5281e2ebc223bbdca57c64816"
+        },
+        {
+          "tool": "ossutil",
+          "file": "ossutil",
+          "platform": "darwin-arm64",
+          "source": "https://gosspublic.alicdn.com/ossutil/1.7.19/ossutil-v1.7.19-mac-arm64.zip",
+          "sourceVersion": "1.7.19",
+          "target": "darwin-arm64",
+          "archiveSha256": "10ece4d328c5d2440833adc5f4167168e9b2a4c5d364f673b0c45bcc4fd02ec5",
+          "size": 10849218,
+          "sha256": "84ca0ada6b040e1814291b78f94159de53a698b5ca5bb007217ba26560b82d4b"
+        },
+        {
+          "tool": "dws",
+          "file": "dws",
+          "platform": "darwin-arm64",
+          "source": "dingtalk-workspace-cli@1.0.61/dws-darwin-arm64.tar.gz",
+          "sourceVersion": "1.0.61",
+          "target": "darwin-arm64",
+          "archiveSha256": "9a122f6322983c45e44db7274788dbb5c62d1762268e45d18e0e72ed40d39978",
+          "size": 32432720,
+          "sha256": "b41b5d3250fc809dbb80e1471b9a3768e0df3af088e296b457bd381f5e1df3de"
+        }
+      ]
+    },
+    {
+      "platform": "win32-x64",
+      "tools": [
+        {
+          "tool": "crwu",
+          "file": "crwu.exe",
+          "platform": "win32-x64",
+          "source": "repo-build",
+          "sourceVersion": "0.0.1",
+          "target": "windows/amd64",
+          "buildCommit": "d90d55efe18bd6ae01bd3102959ed7a62c4381c2",
+          "size": 8122880,
+          "sha256": "ca0d055a2335bf0ddefaf3b448e59a3999ed328e88c868e47873e73b29fdadb3"
+        },
+        {
+          "tool": "ossutil",
+          "file": "ossutil.exe",
+          "platform": "win32-x64",
+          "source": "https://gosspublic.alicdn.com/ossutil/1.7.19/ossutil-v1.7.19-windows-amd64.zip",
+          "sourceVersion": "1.7.19",
+          "target": "win32-x64",
+          "archiveSha256": "8e9176aedc87d230ccd97dc7236b16564f2a068609ed301acdc73dc27faf7e77",
+          "size": 11647488,
+          "sha256": "a90ff4fdb7d282652a5b50d39a6c74640afd1a505bd925ccc58940373cb8d398"
+        },
+        {
+          "tool": "dws",
+          "file": "dws.exe",
+          "platform": "win32-x64",
+          "source": "dingtalk-workspace-cli@1.0.61/dws-windows-amd64.zip",
+          "sourceVersion": "1.0.61",
+          "target": "win32-x64",
+          "archiveSha256": "defdcf217bddfb74254c6eeaff408f8b23dddb44729cd997b6d85aa6ce7727a0",
+          "size": 34613248,
+          "sha256": "134111858af3ed250d294c9ed9c4ccfb6c46dd70df3bc5cefe78bd8f06ca90ef"
+        }
+      ]
+    }
+  ]
+}

package/bin/win32-x64/dws.exe

@@ -0,0 +1,4 @@
+[diffend] Oversized file quarantined before diffing.
+name: package/bin/win32-x64/dws.exe
+size: 34613248 bytes
+sha256: 134111858af3ed250d294c9ed9c4ccfb6c46dd70df3bc5cefe78bd8f06ca90ef

package/common/skills/.synced.json

@@ -0,0 +1,8 @@
+{
+  "source": "plugins/common/skills",
+  "skills": [
+    "crwu-dws",
+    "crwu-h3yun-login",
+    "crwu-h3yun-query"
+  ]
+}

package/common/skills/crwu-dws/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: crwu-dws
+description: >-
+  中瑞世联评估审核知识库（钉钉 wiki）【只读域】技能：M1 查询/导出该知识库（按精确库名解析
+  组织+个人全范围，多命中全导）的完整层级目录，并缓存目录/索引到本地 ~/.crwu/knowledge
+  的 dws-dir-cache 下；M2 按本次审核文件清单（crwu-audit 路由/子技能装配产出）**实时下载**
+  知识文档（**按节点 extension 双通道取数**：adoc→`doc +export` 导出 markdown；可读原生文本
+  md/txt→`drive +download` 原样取回；其余类型记 skipped 不伪造正文；逐文件 exportedAt）到与源审核数据文件同级的案例目录 knowledge/ 下
+  ——清单同时支持单文件路径与目录路径，文件零缓存：每次审核重新下载，下载时刻即最新；
+  M3 缓存兜底查找：按文件名/nodeId/库内层级路径 先查本地目录缓存，未命中自动刷新缓存后再查，
+  仍无则如实报告"没找到"；正文一律实时从钉钉取回（永不落缓存，保证最新）。
+  缓存原则：目录可缓存、正文不缓存；缓存库名与 skill 目标库名不一致 → 先清理缓存、在线重下目录结构（防跨库误命中）。对钉钉零写操作。泛化钉钉知识库/doc 管理走
+  dingtalk-wiki/dingtalk-doc；审核意见不属本技能。
+  宿主分流：DSH 环境只走工作台注册的结构化 Tool；非 DSH 宿主见文末兼容层。
+metadata:
+  cli_version: ">=0.2.14"
+  category: crwu
+  requires:
+    bins:
+      - dws
+---
+
+# crwu-dws（钉钉知识库只读域：M1 目录查询+缓存 / M2 按清单实时下载 / M3 路径·缓存兜底查找）
+
+## 0.0 宿主分流（先读这一节）
+
+**本技能有两种执行形态，不要混用：**
+
+| 宿主 | 执行入口 | 说明 |
+| --- | --- | --- |
+| **DSH（DeepSeek Harness）** | 结构化 Tool `crwu_audit_knowledge_materialize` | **唯一**入口。空间解析、目录遍历、节点读取、文档导出/下载全部在 Tool 内部经 `ctx.shell` 完成；模型只提交 `caseDir`、`paths[]`（可选 `spaceName`）。**禁止**在 shell 里拼命令、**禁止**查找或猜命令路径、**禁止**改 PATH。 |
+| 非 DSH 宿主 | 下列 M1/M2/M3 的 CLI 路径 | 见文末「非 DSH 宿主兼容层（legacy CLI）」，保留给仍以命令行集成的宿主与人工排障。 |
+
+DSH 下的三条硬规则：
+
+1. **只调 Tool**：M2（按清单实时下载）等价于一次
+   `crwu_audit_knowledge_materialize({ caseDir, paths })` 调用；返回的
+   `manifest[]`/`counts`/`failures` 就是本文档要求的记账结果（`status` 取
+   `exported|downloaded|skipped|failed`）。
+2. **capability gap 不降级**：Tool 不可见或返回能力缺失时，如实报告
+   「capability gap：缺少 <工具名>」并停止 —— **不要**退回命令行、**不要**去搜 PATH。
+3. **兼容层不参与自动审核**：DSH 自动审核链路（`crwu-audit` 技能 + 审核子代理提示词）
+   **不引用**兼容层里的任何命令。
+
+下面 §1–§9 描述的是**语义契约**（寻址、通道分流、记账、缓存红线、完整性判定）。
+它们在两种形态下都成立；只有"用哪条命令实现"这一点在 DSH 下由 Tool 内部承担。
+
+
+## 0. 目录结构与加载
+- `SKILL.md`（本文件，入口；三模式流程 + 取数通道分流 + 缓存语义 + 只读白名单）
+- `references/00-目录快照schema.md` —— 快照 schema / 字段语义（含 `extension` 通道判据）/ 渲染规则（M1/M2/M3 共用）
+- `references/01-审核下载与manifest规范.md` —— M2 双通道下载布局 / 文件与目录项语义 / manifest、skipped 与失败记账
+- `references/02-缓存与兜底查找规范.md` —— 缓存身份与名一致性清理 / 目录缓存布局 / node-index（含全路径键与 `extension`）/ M3 路径·查找与刷新协议 / 正文不落缓存红线
+- 改前必读本技能 `references/00`–`references/02`（缓存语义与决策口径）；改动只落源仓并提交，运行时部署由用户 skills 管理机制负责（不直接写/ln/cp/rm `~/.skills-manager`、`~/.dsh`、`~/.workbuddy` 等运行时目录）
+
+## 1. 触发与模式消歧
+
+| 用户意图（例） | 模式 | 主要产物 |
+| --- | --- | --- |
+| "看/查/列 中瑞世联评估审核知识库 的 目录/层级/树/结构" | **M1 目录查询** | 摘要 + 目录缓存（`~/.crwu/knowledge/dws-dir-cache/<库名>/`：`目录快照.json`/`目录树.md`/`node-index.json`/`.cache-meta.json`） |
+| 审核编排：路由/装配已定文件清单，"下载本次审核需要的知识文档（最新实时版）" | **M2 按清单实时下载**（审核消费主路径） | `<案例目录>/knowledge/` 本次工作集（逐文件 exportedAt）+ `.crwu-manifest.jsonl` + `.crwu-directory.json` |
+| "找/查 文件 XX / 层级路径 …（在不在库里、哪个目录）"、"nodeId … 是什么"、"取 XX 最新内容" | **M3 缓存兜底查找（含路径寻址）** | 命中：元数据+树路径（要正文 → 实时拉取入本次工作目录/即弃）；未命中→刷新→仍无："未找到"报告 |
+
+- 目标库名默认「中瑞世联评估审核知识库」；其他库名同流程处理（产物目录以实际库名为准）。
+- **缓存名一致性（清理层，§5.0）**：缓存目录按 `<库名>` 分目录、只对与 skill 目标库名一致的库有效；缓存库名与目标不一致（改名/换库/历史残留）→ **先清理该缓存目录，再在线重下目标库目录结构**；禁止把别的库的缓存当目标库索引（跨库误命中）。
+- **不触发**：泛化钉钉知识库/doc 管理（→ `dingtalk-wiki`/`dingtalk-doc`）；审核报告材料（→ `crwu-audit`）。
+- M2 由 crwu-audit 编排者在路由/装配确定本次文件清单后调用（清单 = 命中子技能装配路径表 + 执行契约路径并集）；M3 供 skill（audit 族等）定位并现场获取参考文档，也可对用户直接服务。
+
+## 2. 执行契约（dws 最小集）
+- 只通过 `dws` CLI；结构化读取用 `--format json`，按真实返回判断；已知命令直接执行，只有 leaf 参数/flag 不确定时读一次精确 Schema/Help；不加载产品级 Catalog。
+- 不猜命令、flag、字段、ID、名称；后续 ID 必须来自真实返回；解析/读取/导出全程同一 profile（多账号只用 `isOrgCurrent=true` 默认账号或用户明确指定）。
+- 不输出或记录 token 等凭据；认证/权限/profile/未知错误 → 只读 `dingtalk-shared` 对应 reference，不连续猜测；时间戳面向用户时转当前时区。
+- **对钉钉零写（硬白名单）**：wiki 域仅 `space-list/space-search/space-get/node-list/node-search/node-get`；doc 域仅 `+export`；drive 域仅 `+download`（三者均远端只读、产物落本地）。禁止其余一切命令。
+- **取数通道按节点 `extension` 分流（v0.6，硬规则）**：知识库文档并非全是钉钉在线文档——`doc +export` **只支持 `extension=adoc`**，对原生文件必失败。分流口径见 §6.2：
+  | `extension` | 通道（Tool 内部实现） | manifest 里的 `channel` | 说明 |
+  | --- | --- | --- | --- |
+  | `adoc` | 导出为 markdown | `export` | 钉钉在线文档 |
+  | 可读原生文本（`md`/`txt`） | 原样取回 | `download` | 原件即正文，**不得**走导出通道 |
+  | 其它（`pdf`/`docx`/`xlsx`/`able`/`axls`/二进制 …） | 不取正文 | `skipped` | 记 `skipped` + 真实 `extension`，**不是 failure**、不伪造正文 |
+  禁止"先用 `doc +export` 试、失败再换通道"的试错式取数：通道必须由 `extension` 判定（真实返回，缺席时按 §6.2 第 2 步补查），试错会把必然失败记成 failure 并污染 manifest。
+- 本技能唯一的"写" = 本地：① 目录缓存写入/清理（M1/M3 刷新；库名不一致清理见 §5.0）② 当前审核工作集（M2）③ 临时区（正文实时取用，用后即弃）。**正文永不写入目录缓存**（红线：references/02 §1.2）。
+
+## 3. P1 库解析（三模式共用，只读）
+1. 确认 profile；M2 额外确认案例目录（§6.1）；M3 输入 = 精确文件名 / nodeId / **库内层级路径（文件级或目录前缀）**（用户/调用方给出，不猜近似）。
+2. 分范围（组织 / 个人）**全量**取空间并精确名匹配；候选浏览不能作为唯一性证据。DSH 下这一步由 `crwu_audit_knowledge_materialize` 内部完成，并把命中的库写进返回的 `spaces[]`。
+3. 判据：`requestedType` 与请求范围一致；`autoPageComplete=true` 才可用"缺席"证无；命中 0 → 报告范围+相似候选，不编造；命中 ≥1 → 全部进入处理列表，保留真实 `workspaceId/spaceType`（只取服务端真实返回）与范围标注。
+
+## 4. P2 目录遍历（三模式共用，只读，DFS 递归）
+1. 根层与每一层都用同一种「按库（`workspace`）+ 可选父目录」的完整分页列举，直至无 folder。
+   **分页页数上限必须显式放大**（默认只翻 20 页，大库会被静默截断成"遍历完成"）。
+   DSH 下这一步由 `crwu_audit_knowledge_materialize` 内部完成；遍历不完整时它返回
+   `complete=false` 并逐条记 failures，不会把截断报成全量。
+2. 纪律：每层记录分页证据并写入快照；`hasChildren` 仅提示不作剪枝；folder 按 nodeId 去重（二次展开停+标注）；节点字段只取真实返回，未知 type 原样保留；**文档节点必须同时记录 `extension`/`contentType`**（服务端真实返回，缺席记 `null` 不推断）——它们是 §6.2 取数通道分流的唯一判据；体量上限 10,000 节点 / 20 层 → 停止并如实报告部分结果。
+3. 遍历结果 = 内存树（前序展开序）；任何一次**成功完整遍历**都更新目录缓存（P3-M1 原子替换）。
+
+## 5. P3-M1 目录查询 → 写缓存
+### 5.0 缓存名一致性校验与清理（缓存清理层；M1/M3 用缓存前置，M2 不涉及）
+目的：目录缓存按 `<库名>` 分目录、只对与 skill 目标库名一致的库有效；历史改名/换库/临时其它库运行会留下**别的库名**的缓存目录，若被当成目标缓存查找 = **跨库误命中**。规则：缓存库名 ≠ 本次目标库名 → **先清理缓存、再在线重下目标库目录结构**，绝不复用。
+- **对账基准 = 本次目标库名**（skill 默认「中瑞世联评估审核知识库」或本次指定库名；M1 与 M3 刷新路径叠加 P1 解析结果，按 name+workspaceId **双匹配**对账；M3 **命中路径不发起在线遍历**（§7.1 约定），以请求库名为准做名级对账——workspaceId 一致性在每次写缓存时已由 P1 校验并固化于 `.cache-meta.json.space`）。
+- **判据**：缓存目录身份 = `.cache-meta.json.space`（`name`+`workspaceId`）。身份与目标（名级或双匹配）**不一致**，或 meta 缺失/损坏且目录名 ≠ 目标库名（身份不可证实）→ 该目录**整体删除**；meta 缺失/损坏但目录名 == 目标库名 → 不删除，按 §7.1 缓存损坏走刷新覆盖重建。
+- **清理动作**：删除不一致缓存目录（正式 4 文件 + 任何残留 `.tmp-*`）。目录缓存 = 可再生中间产物、不含正文 → 删除安全，红线不受影响；只作用于 `dws-dir-cache`，不碰 M2 当前审核 `knowledge/` 工作集或远端。删除失败 → 报告路径问题，该缓存按不可用处理，不静默复用。
+- **重建**：对目标库在线重跑 P1+P2 全量遍历，重新下载远程目录结构并原子写缓存（即本 § 下方 1–4 写缓存流程）；M3 侧进入 §7.2 刷新路径后重查。
+- **报告**：清理动作必须可见——"已清理不一致缓存：<目录>（缓存=<库名>，目标=<库名>）"；重建后附新 generated_at。
+
+1. 组快照/树/索引：`目录快照.json`（references/00 schema，含 space 元数据、evidence、failures）、`目录树.md`、`node-index.json`（references/02 §3）。
+2. 落盘：`~/.crwu/knowledge/dws-dir-cache/<库名>/`；**原子替换**——先写 `.tmp-*` 再 rename 覆盖（防半截缓存）；目录不存在则创建（父目录知识根只读不可写时报告路径问题，不静默改落点）。
+3. 更新 `.cache-meta.json`：`{schema:"crwu.kb-dir-cache.meta.v1", space:{name,workspaceId,spaceType}, last_successful_at, source:"dingtalk-live", stats, evidence}`。
+4. 聊天摘要：命中库数、每库 节点/folder/深度/缓存路径；failures 非空附清单；`complete=false` 不写缓存、不宣称全量（保留旧缓存并在摘要说明"缓存未更新：遍历不完整"）。
+
+## 6. P3-M2 按本次清单下载（远端只读 + 本地写）
+### 6.1 目标目录决议（禁止猜）
+`knowledge/` 的父目录 = 案例目录（= crwu-audit 源审核数据文件所在目录的父级，二者同级）：① 编排者/用户显式给出；② 部署约定 `CRWU_CASE_DIR`（若注入的是材料包目录则取其父级）；③ 都没有 → 询问用户。
+
+### 6.2 M2 按清单实时下载（审核消费主路径；文件零缓存 R2/R3）
+输入：本次审核文件清单 = 层级路径列表 `paths[]`，来自 crwu-audit 路由/子技能装配路径表；**同一清单**可混合以下两种条目：
+
+- **单文件路径**（不以 `/` 结尾，如 `<目录>/<文档>.md`）：精确解析并**只下载该文件**。
+- **目录路径**（以 `/` 结尾，如 `<目录>/`）：展开并**递归下载**该目录下全部支持的正文文件。
+
+1. 建 `<案例目录>/knowledge/`；按清单逐条处理（顺序、不并发）：
+   - **定位**：目录缓存 path 键命中 → 取 nodeId（快路径，不发起在线遍历）；未命中/缓存缺失 → 在线 P1+P2 全量遍历并原子更新缓存 → 重查；仍无该路径 → 记 failures（"清单项在库内不存在：<路径>"），继续后续项；
+   - 单文件清单项 → 只处理精确命中的该节点；命中 folder 或歧义多节点则记 failure，不猜；
+   - 目录清单项 → 展开为该目录下**全部**支持的正文文件（folder 递归至无子目录）并逐一实时下载，展开内容如实记账；
+2. **通道判定 + 实时下载**（逐节点、串行；通道由 `extension` 决定，禁止试错）：
+   - **取 `extension`**：目录缓存条目带 `extension` → 直接用（快路径）；缺失/`null`（旧缓存）→ 对该 nodeId 补一次节点元数据读取（只读、逐节点、结果写入 manifest evidence），仍为 `null` → 记 `skipped`（"类型不可判定"），**不猜、不试**；DSH 下这一步由 Tool 内部完成；
+   - `extension=adoc` → 走**导出**通道，落地为 `knowledge/<同构层级路径>.md`（manifest 里 `channel=export`、`status=exported`）；
+   - `extension ∈ {md, txt}`（可读原生文本）→ 走**原样下载**通道，落地为 `knowledge/<同构层级路径>.<extension>`（`channel=download`、`status=downloaded`），**原件即正文，不做格式转换**；
+   - 其余类型 → 记 `skipped`（原因含真实 `extension`），**不下载、不伪造正文**；
+   - 两条通道的 `--output` 均为**工作目录内相对路径**，因此命令在 `<案例目录>` 下执行；回执 `localPath`+`sizeBytes>0` 即终态；同 nodeId 已存在 → 原位覆盖=更新；异 nodeId 同名 → 追加 `-<nodeId前8>`；
+3. 记账 `.crwu-manifest.jsonl`（每文件 entry：nodeId/name/**extension**/**channel**/folderPath/localPath/**exportedAt**/evidence；`skipped` 单独成行；下载失败 → failure 行不中断；认证类系统性错误 → 停止，读 dingtalk-shared）；
+4. 收尾写入 `.crwu-directory.json`（目录快照副本）；摘要：成功 N / 跳过 S / 失败 F（逐项原因）+ **清单外零下载**声明 + 产物路径。
+> 语义：本次下载物 = 本次审核工作材料（下载时刻即最新）；跨审核/重跑一律重新下载（R2）；**禁止**写入 `dws-dir-cache`（R4）。
+
+## 7. P3-M3 缓存兜底查找（目录可缓存 / 正文实时 / 未命中刷新；含路径寻址）
+输入：精确文件名 或 nodeId 或 **库内层级路径（文件级或目录前缀）**。
+0. **缓存清理层前置（§5.0）**：先用**本次请求的库名**对 `dws-dir-cache` 下缓存目录做名级对账——库名不一致的缓存目录先清理删除（动作须在结论中注明）；目标库无一致缓存（含刚被清理）→ 跳过 1，直接走 2 刷新路径（在线重下目录结构后重查）。
+1. **查缓存**：读 `<缓存>/node-index.json`（nodeId → 条目；名称 → 条目列表）：
+   - 命中（nodeId/名称/路径任一键）→ 报告：条目元数据（type/parentFolderId/所在库）+ **树路径上下文**（顶层 folder 链），结论标注"缓存命中（generated_at=<…>）"；不发起在线遍历；
+   - 名称/路径多命中（同名不同路径等）→ 全部列出路径上下文，请调用方/用户消歧（不猜）；
+   - **路径寻址**：全路径（`目录/…/文档`）精确命中 → 同上；目录前缀（`目录/…/`）→ 该目录下条目列表（限定层级展示）；未命中 → 进入刷新（node-index 全路径键见 references/02 §3）；
+   - 缓存缺失/损坏（JSON 解析失败等）→ 视为未命中，进入刷新。
+2. **未命中 → 刷新缓存**：重跑 P1+P2 在线全量遍历 → 原子更新缓存（§5 同款）→ **重查索引**。
+3. **刷新后仍未命中 → 报告**："未找到：<名称/nodeId>（目录已刷新至 <时间> 后仍不存在）"+ 名称相近候选（≤5 条，来自新快照），**不编造、不猜测近似即命中**。
+4. **命中且调用方要正文** → 现场实时拉取到本次审核工作目录或系统临时目录：按 §6.2 第 2 步同一 `extension` 分流规则取数（`adoc` → `doc +export`；`md`/`txt` → `drive +download`；其余 → 如实报告"该类型不提供正文"）；登记 manifest 后仅供本次审核使用；**正文任何情况下不写入目录缓存，也不得跨审核复用**。
+5. **刷新失败降级**：在线遍历失败（认证/网络/分页未完成）→ 旧缓存可用：用旧缓存作答并显式标注"**缓存可能过期（generated_at=<…>），刷新失败：<原因>**"；无旧缓存 → 报告"无法确认（缓存缺失且在线刷新失败）"。
+
+## 8. P4 一致性自查
+- **写缓存前先校验快照 schema（硬门禁，不通过不得写、不得宣称全量）**：`目录快照.json` 的
+  `schema` 必须逐字等于 `crwu.kb-catalog.snapshot.v1`；`generated_at` / `profile` / `mode` /
+  `space` / `stats.complete` / `nodes` / `failures` 齐备；`nodes` 为**嵌套 `children`**
+  （扁平自带 `path` 的是 `node-index.json` 形态，写错会让映射检查器直接拒收整份缓存）。
+  三个 schema 名与时间字段名不得混用（见 references/00 §3）。
+- M1/M3 刷新：快照节点计数 == 遍历完成计数且 `failures=[]` 才写缓存/宣称全量；缓存 meta 的 `last_successful_at` 与快照 `generated_at` 一致。
+- M2：清单项 = 成功 + 跳过 + 失败（目录条目按展开计数），失败逐项原因；**`skipped` 不得计入 failure**（非可读类型是正常结论，不是错误）；每个 entry 的 `channel` 必须与 `extension` 分流口径一致（`adoc`→`export`，`md`/`txt`→`download`）；manifest 幂等可复跑；**清单外文件零下载**（manifest 只含清单命中项及其目录展开项）。
+- M3 报告：必须带结论依据标签（缓存命中/刷新后命中/刷新后仍无/降级可能过期/无法确认），禁止无来源结论。
+- 缓存清理层：所用/所写缓存身份与本次目标库名一致；被清理的目录（如有）出现在摘要/结论的清理报告。
+
+## 9. 边界与纪律
+- 结果只读自钉钉、不推断；目录/正文是**企业数据**：产物按约定落盘，不外传。
+- **红线（用户口径 R1–R5）**：目录元数据可缓存、**知识正文不缓存**；知识正文唯一来源是钉钉知识库，每次审核都按本次清单现场下载。本次下载物只属本次审核，跨审核一律重新下载（R2）；只下载单文件命中项或目录展开项，**清单外零下载**（R3）。
+- 目录缓存只用于查找加速，不能提供正文或成为正文兜底。差异由人工/复核判定。
+- 变更登记纪律：只改源仓并提交 + 源仓变更纪要；运行时部署由用户 skills 管理机制负责。
+
+## 10. 错误最短路径
+1. 空响应/缺失集合/分页未完成：停止后续并返回证据；不拿 `+space-search` 首页候选断言。
+2. 认证/权限/profile 错：读 `dingtalk-shared` 对应 reference；不重试猜测命令。
+3. M2 单节点下载失败：记 failure 继续；系统性（连续 >10 或认证类）→ 停止报告已得部分。**`extension` 非 adoc/可读文本时不得记为 failure**——那是 `skipped`；把类型不支持记成失败会掩盖真实故障。
+4. M3 缓存损坏/缺失：按 §7.1 视为未命中自动刷新；刷新也失败 → §7.5 降级，不假装权威。缓存 meta 缺失/损坏（身份不可证实）且目录名 ≠ 目标库名 → 按 §5.0 视为不一致，清理后在线重下。
+5. 缓存目录不可写：报告路径问题请用户处理；不静默改落点、不把正文改存他处以绕过红线。
+6. 未知 flag/命令：只查当前 leaf Help/一次 shortcut 清单；不跨产品试探。
+
+<!-- crwu-cli-guard:legacy-compat-start -->
+## 非 DSH 宿主兼容层（legacy CLI）
+
+以下命令形态**只**适用于非 DSH 宿主与人工排障。DSH 环境下这些步骤全部由
+`crwu_audit_knowledge_materialize` 内部完成，**不要在 DSH 里执行它们**。
+
+- M1/P1 库解析（分范围全量取空间，精确名匹配）：
+
+  ```bash
+  dws wiki +space-list --type orgWikiSpace --limit 50 --page-all --format json
+  dws wiki +space-list --type myWikiSpace --limit 50 --page-all --format json
+  ```
+
+- P2 目录遍历（`--workspace` 必填；子层追加 `--folder`；页数上限显式放大）：
+
+  ```bash
+  dws wiki +node-list --workspace <ID> --page-all --page-limit 200 --format json
+  dws wiki +node-list --workspace <ID> --folder <folderId> --page-all --page-limit 200 --format json
+  ```
+
+- M2/M3 取节点元数据（判 `extension`）：
+
+  ```bash
+  dws wiki +node-get --node <nodeId> --format json
+  ```
+
+- M2/M3 双通道取正文：
+
+  ```bash
+  dws doc +export --node <nodeId> --export-format markdown --output <相对路径>
+  dws drive +download --node <nodeId> --output <相对路径>
+  ```
+
+- 缓存兜底查找（M3）：先用 `dws wiki +node-search` 在库内按关键词找候选，
+  再按同一 `by_path` 口径精确定位；未命中就刷新缓存后重查，仍无则如实报告"未找到"。
+
+<!-- crwu-cli-guard:legacy-compat-end -->

package/common/skills/crwu-dws/references/00-/347/233/256/345/275/225/345/277/253/347/205/247schema.md

@@ -0,0 +1,113 @@
+# crwu-dws references/00 —— 目录快照 schema / 渲染规则（M1/M2/M3 共用）
+
+> 版本 v3（2026-09-15，随 crwu-dws v0.6：文档节点新增 `extension`/`contentType`，作为 M2/M3 取数通道分流的唯一判据）。
+> 版本 v2（2026-09-08，随 crwu-dws v0.3：落点迁移到目录缓存层 + M3 支持）。
+> 本文档随技能安装（源仓与运行时双份）；
+> 改前先读本技能 `SKILL.md` §5–§6（缓存与实时性模型）与 `references/02`。
+
+## 1. 用途
+
+"知识库层级目录"的机器可读形态，三模式共用：
+
+- M1：写目录缓存（`~/.crwu/knowledge/dws-dir-cache/<库名>/目录快照.json`）并展示。
+- M2：收尾写入 `knowledge/.crwu-directory.json`（本次审核目录证据，同 schema）。
+- M3：node-index 的数据源（快照更新后重建索引，见 references/02）。
+
+**内容红线**：本 schema 只承载目录元数据；任何正文内容（文档正文/单元格/附件内容）不属于本文件及本缓存层（红线：references/02 §1.2 正文不缓存）。
+
+## 2. 快照 JSON schema（`crwu.kb-catalog.snapshot.v1`）
+
+```jsonc
+{
+  "schema": "crwu.kb-catalog.snapshot.v1",
+  "generated_at": "2026-09-08T10:30:00+08:00",   // ISO8601 带时区（=本次在线遍历完成时刻）
+  "profile": { "id": "…", "isOrgCurrent": true }, // 执行 profile 证据（真实返回）
+  "mode": "M1|M2",                                // 产出方
+  "space": {
+    "name": "中瑞世联评估审核知识库",
+    "workspaceId": "…",                            // 来自真实返回
+    "spaceType": "orgWikiSpace|myWikiSpace",        // 只取服务端真实返回；缺席=null，不按请求值伪造
+    "scope_evidence": {
+      "requestedType": "orgWikiSpace",              // 顶层请求范围
+      "autoPageComplete": true,
+      "pagesFetched": 1
+    }
+  },
+  "stats": { "total_nodes": 0, "folders": 0, "docs": 0, "max_depth": 0, "complete": true },
+  "nodes": [                                        // 前序展开序（根层在前，children 紧跟父节点）
+    {
+      "nodeId": "…",                                // 服务端 ID，名称永不替代 ID
+      "name": "…",                                  // 原文
+      "type": "folder|file|未知原值",                 // 服务端 nodeType；文档一律为 file，不承载格式信息
+      "extension": "adoc",                          // ★ 取数通道判据（服务端真实返回；文档节点必记，缺席=null）
+      "contentType": "ALIDOC",                      // 辅助判据（adoc=ALIDOC，原生文件=OTHER）；缺席=null
+      "parentFolderId": null,                        // 根层=null
+      "depth": 0,                                    // 根层=0
+      "children": [ … ],                             // 嵌套子节点（同构）
+      "evidence": {
+        "hasChildren": null,                          // 服务端/规范化别名；缺席=null，不作剪枝依据
+        "page": { "autoPageComplete": true, "pagesFetched": 1, "itemsInPage": 20 }
+      }
+    }
+  ],
+  "failures": []                                     // 空=完整；否则逐条 {nodeId?, step, error}
+}
+```
+
+## 3. 字段语义（不变量）
+
+- **`schema` 字面与必填键逐字固定，不得混名、不得缺键**（v0.6 起列为硬门禁）：
+  `目录快照.json` 的 `schema` 必须**逐字**写 `crwu.kb-catalog.snapshot.v1`；必填
+  `generated_at` / `profile` / `mode` / `space` / `stats` / `nodes` / `failures`，其中
+  `stats.complete` **必填**（缺席即无法判完整性）。
+  三个 schema 名字**不得互相混用**：快照 `crwu.kb-catalog.snapshot.v1`、
+  节点索引 `crwu.kb-dir-cache.nodeindex.v1`（`node-index.json`）、
+  缓存元数据 `crwu.kb-dir-cache.meta.v1`（`.cache-meta.json`）。
+  时间字段同理：快照用 `generated_at`，`.cache-meta.json` 用 `last_successful_at`，
+  **不得写成 `fetched_at`**（该名不是本域任何 schema 的字段）。
+  > 真实失效：实时缓存把 `node-index.json` 的**扁平节点形态**（节点自带 `path`）写进了
+  > `目录快照.json`，`schema` 字面写成 `crwu.kb-dir-cache.snapshot.v1`（由 meta 名与快照名
+  > 混合而成，本仓历史中从未存在），时间字段写 `fetched_at` 且缺 `profile`/`mode`/`stats.complete`；
+  > 后果是映射检查器直接拒收（`unsupported catalog schema`），整条映射校验链不可用。
+- **`nodes` 必须是嵌套 `children`**（前序展开序）：父节点内嵌 `children`，根层 `parentFolderId=null`。
+  扁平节点数组（每个节点自带完整 `path`）属 `node-index.json` 的形态，**禁止**写入 `目录快照.json`。
+- **名称不替代 ID**：所有在线操作只认 `nodeId`；`name` 仅展示与本地文件命名（M2）。
+- **type 只表示节点形态**：服务端 `nodeType` 取值 `folder|file`；文档一律 `file`，**不承载格式信息**，禁止用它推断是 adoc 还是原生文件。
+- **`extension` 是取数通道的唯一判据（v0.6 起强制记录）**：文档节点必须写服务端真实返回的 `extension`（`adoc`/`md`/`pdf`/`docx`/`xlsx`/`exe`…）与 `contentType`（`ALIDOC`/`OTHER`…）；缺失记 `null`，**不推断、不按名称后缀猜测**（节点名不带后缀，`.md` 只是导出后的本地文件名）。M2/M3 按它分流（SKILL.md §2/§6.2）：`adoc` → `doc +export`；`md`/`txt` → `drive +download`；其余 → `skipped`。
+- **白名单外原样保留**：`extension`/`contentType` 未识别时原样记原值字符串，禁止归类或猜测。
+- **parentFolderId**：根层 null；服务端未提供 → null 且 evidence 注明，不推断补值。
+- **hasChildren**：只提示，**不作剪枝依据**；与实际 `+node-list` 展开不一致时如实记录，不当作失败也不反向剪枝。
+- **complete 判定**：仅当遍历全部完成、`failures=[]`、每页 `autoPageComplete=true` → `stats.complete=true`；否则 false。
+- **快照绝不携带正文**：任何字段不得内嵌/外链"取到的正文内容"（临时文件路径若被记录，仅作一次性传递用，随临时区清理）。
+
+## 4. 渲染规则（`目录树.md`）
+
+```
+# <库名> 目录树
+> workspaceId: <…> ｜ spaceType: <…> ｜ 扫取: <ISO8601> ｜ profile: <…>
+> 节点 <total>（folder <folders> / 文档 <docs>）/ 深度 <max> ｜ complete: true|false
+
+<顶层folder或文档>/
+├─ <子folder>/                    [F]
+│  └─ <文档名>                    adoc
+└─ <根层文档名>                    axls
+```
+
+- folder 名后接 `/` 且行尾标 `[F]`；文档行尾标 **`extension`**（不是 `type`——`type` 恒为 `file`，标它等于没标）；`extension` 为 `null` 时输出 `ext:未提供`，未识别时原样输出 + 注"类型未识别"。
+- 树内条目不得超出快照 nodes；快照是事实源、树是视图；库身份标注（workspaceId/spaceType/时间/统计/complete）不允许缺失（多库并存不混库）。
+
+## 5. 摘要口径（聊天展示）
+
+- M1：`命中 <n> 库` → 每库一行：`<库名>（<spaceType>）workspaceId=<…>：节点 <total>/folder <folders>/深度 <max>，缓存 <绝对路径>（generated_at=<…>）`；failures 非空附"部分失败"清单；`complete=false` 显式"目录未完整（缓存未更新）"。
+- M2：`knowledge/ 更新：成功 N / 跳过 S / 失败 F`，失败逐项一行；附本次清单类型（单文件/目录）与"清单外零下载"声明，并提示跨审核必须重新下载。
+- M3：见 references/02 §6 报告口径。
+- 全部产物给出绝对路径。
+
+## 6. 命名与落盘（M1 = 目录缓存层，v0.3 起）
+
+- 缓存根：`~/.crwu/knowledge/dws-dir-cache/`；此层只存目录元数据，不是知识正文来源。
+- 每库子目录：`dws-dir-cache/<精确库名>/`；库名清洗非法字符 `\/:*?"<>|` 与首尾空白（空 → workspaceId）；同名不同 spaceType 多库 → 子目录追加 `-<spaceType>`。
+- 文件：`目录快照.json`、`目录树.md`、`node-index.json`（references/02 §3 schema）、`.cache-meta.json`（references/02 §3 schema；身份语义见 §2）。
+- 缓存身份与清理：缓存目录身份 = `.cache-meta.json.space`（name+workspaceId，真实返回）；身份与目标库名不一致 → 目录被清理层整体删除后在线重下（references/02 §2 / SKILL.md §5.0）。
+- **原子替换**：先写 `.tmp-*` 再 rename 覆盖；写失败不得留下半截"正式"文件（宁可保留旧缓存并在 meta 说明）。
+- 旧落点 `~/.crwu/kb-catalog/`（v0.1/0.2）：不再写入；既有文件保留待人工清理，本技能不迁移不删除。

package/common/skills/crwu-dws/references/01-/345/256/241/346/240/270/344/270/213/350/275/275/344/270/216manifest/350/247/204/350/214/203.md

@@ -0,0 +1,115 @@
+# crwu-dws references/01 —— M2 审核下载与 manifest 规范
+
+> 版本 v4（2026-09-15，随 crwu-dws v0.6：按节点 `extension` 分流的**双取数通道**——`adoc` 走 `doc +export`，可读原生文本 `md`/`txt` 走 `drive +download`，其余记 `skipped`）。
+> 版本 v3（2026-09-08）：钉钉是知识正文唯一来源；M2 仅按本次审核清单下载，支持单文件与目录条目。
+> 本文档随技能安装；改前先读 references/00 与 references/02。
+
+## 1. 目标布局
+
+```
+<案例目录>/
+├── <源审核数据文件…>
+└── knowledge/                    # 本次审核工作集，跨审核不得复用
+    ├── <顶层folder>/<子folder>/<文档名>.md      # extension=adoc（导出）
+    ├── <顶层folder>/<子folder>/<文档名>.md      # extension=md（原件即正文，原样下载）
+    ├── <顶层folder>/<子folder>/<文档名>.txt     # extension=txt（同上）
+    ├── <文档名>-<nodeId前8>.md   # 仅不同 nodeId 同名冲突时
+    ├── .crwu-manifest.jsonl
+    └── .crwu-directory.json
+```
+
+- 点文件是本次下载的追溯元数据，不映射远端节点；读取正文时跳过。
+- folder 映射本地目录；**文档按 `extension` 分流**（SKILL.md §2/§6.2）：
+  | `extension` | 通道 | 落地 |
+  | --- | --- | --- |
+  | `adoc` | 导出通道（`channel=export`） | `<节点名>.md` |
+  | `md` / `txt` | 原样下载通道（`channel=download`） | `<节点名>.<extension>`（**原件即正文，不转换**） |
+  | 其余 | 不取正文 | 记 `skipped` + 真实 `extension`，不伪造正文 |
+- `knowledge/` 不是知识库副本。它只包含本次清单命中的正文，跨审核或重跑必须重新从钉钉下载。
+- `dws-dir-cache/` 只存目录元数据，禁止接收 M2 正文。
+
+## 2. 清单项语义
+
+同一清单允许混合：
+
+1. **单文件路径**：不以 `/` 结尾。精确解析到一个节点后只下载该文件；命中目录、零命中或多命中均记 failure。
+2. **目录路径**：以 `/` 结尾。精确解析目录后递归下载该目录下全部支持的正文文件。
+
+清单按声明顺序展开并去重；同一 nodeId 只下载一次。清单外零下载。无法解析或下载失败时，记录原始清单项、节点信息（如有）和原因，不得改读本地正文或推测内容。
+
+**展开范围（v0.6 澄清）**："全部支持的正文文件" = `extension` 为 `adoc`/`md`/`txt` 的节点。目录内其余类型（`pdf`/`docx`/`xlsx`/`exe`…）**必须出现在结果里**，但以 `skipped` + 真实 `extension` 记录——**不得静默丢弃**（静默丢弃会让"清单已覆盖"成为假象），也**不得记为 failure**。
+
+**通道判定**：每条展开项先取 `extension`（缓存命中则直接读；缓存缺 `extension` → 对该 nodeId 补一次 `wiki +node-get`，只读，结果入 evidence），再按 §1 表格选通道。**禁止"先 `doc +export` 试一次、失败再换 `drive +download`"**——原生文件必然失败，试错会制造假 failure 并把通道缺陷掩盖成偶发错误。
+
+## 3. 命名与冲突
+
+1. 本地目录/文件名去除 `\\/:*?"<>|` 与首尾空白；清洗后为空时使用 nodeId 前 8 位。
+2. folder 同名冲突时后建者追加 `-<nodeId前8>`。
+3. 文档规范名 = `<节点名>.<落地后缀>`：`adoc` → `.md`（导出格式）；`md`/`txt` → 保持原 `extension`。不同 nodeId 同名时追加 `-<nodeId前8>`。
+4. 同一审核重跑可依据 manifest 保持 `nodeId → localPath` 稳定，但正文必须重新取回并更新 `exportedAt`（`adoc` 重新导出、原生文件重新下载）。
+
+## 4. manifest JSONL
+
+首行 header，其后按清单展开顺序记录 entry、skipped 或 failure：
+
+```jsonc
+{ "schema": "crwu.audit-download.manifest.v1", "mode": "M2",
+  "space": { "name": "…", "workspaceId": "…", "spaceType": "…" },
+  "case_dir": "<案例目录绝对路径>", "started_at": "ISO8601" }
+
+{ "kind": "entry", "requestPath": "06-规则库/某文件",
+  "requestKind": "file", "nodeId": "…", "name": "…",
+  "extension": "adoc", "channel": "export",
+  "folderPath": "knowledge/06-规则库",
+  "localPath": "knowledge/06-规则库/某文件.md",
+  "exportedAt": "ISO8601",
+  "evidence": { "export": { "localPath": "…", "sizeBytes": 1234 } } }
+
+{ "kind": "entry", "requestPath": "03-评估方法/01-市场法",
+  "requestKind": "directory", "nodeId": "…", "name": "01-定义与适用前提",
+  "extension": "md", "channel": "download",
+  "folderPath": "knowledge/03-评估方法/01-市场法",
+  "localPath": "knowledge/03-评估方法/01-市场法/01-定义与适用前提.md",
+  "exportedAt": "ISO8601",
+  "evidence": { "download": { "savedPath": "…", "sizeBytes": 3631 },
+                "extensionSource": "catalog|node-get" } }
+
+{ "kind": "skipped", "requestPath": "相关工具/windows/crwu",
+  "requestKind": "file", "nodeId": "…", "name": "crwu",
+  "extension": "exe", "reason": "extension 非可读正文类型（adoc/md/txt）" }
+
+{ "kind": "failure", "requestPath": "06-规则库/不存在",
+  "requestKind": "file", "nodeId": null, "error": "清单项在库内不存在" }
+```
+
+- 目录条目展开出的 entry 保留原始 `requestPath`，并使用 `requestKind:"directory"`。
+- `localPath` 相对案例目录；绝对路径只在 header 的 `case_dir` 出现。
+- **`extension` 与 `channel` 必填**：`channel ∈ {export, download}`，且必须与 `extension` 分流口径一致（`adoc`→`export`；`md`/`txt`→`download`）。`extension` 为 `null`（补查后仍不可判定）→ 记 `skipped`，不得进 entry。
+- `extension` 来自补查（缓存缺字段）时，`evidence.extensionSource` 记 `node-get`；来自目录缓存时记 `catalog`——这是"通道判定有据"的留痕。
+- **`requestPath` 必须逐字等于库内节点名**（`by_path` 键 = 原样精确名，不折叠大小写/全半角）：
+  目录项以 `/` 结尾；**单文件项不要加 `.md` 后缀**——`.md` 只是导出后的本地文件名
+  （§3.3「文档规范名 = `<节点名>.<落地后缀>`」），写进 `requestPath` 会与 `by_path` 键不匹配而记 failure。
+  旧库（节点名自带 `.md`）留下的带后缀写法属历史残留，迁移到新库后必须去掉后缀。
+- 取数回执 `sizeBytes>0` 才算成功；证据按真实返回记录（`doc +export` 用 `localPath`/`sizeBytes`，`drive +download` 用 `savedPath`/`sizeBytes`）。
+
+## 5. 收敛与摘要
+
+- 原始清单项都必须得到"成功展开"或 failure；目录条目的展开数量单独记录。
+- 展开后的唯一 nodeId 集合必须等于 **entry + skipped + failure** 的节点集合。
+- manifest 不得出现清单命中项及其目录展开项之外的正文 entry。
+- **`skipped` 是正常结论、不是失败**：摘要与 `failures[]` 分开统计，禁止把类型不支持并入 failure（会把真实故障淹掉）。
+- 摘要报告成功、跳过、失败数量，逐项列出 failure，并明确"清单外零下载；本工作集只用于本次审核，跨审核重新下载"。
+
+## 6. 边界
+
+- 知识正文唯一来源是钉钉知识库。
+- M2 产物不得复制到任何目录缓存或作为后续审核的正文来源。
+- 远端节点在审核过程中被删除或改变时，以本次实际导出结果和 `exportedAt` 为准；不使用历史正文补齐。
+
+<!-- crwu-cli-guard:legacy-compat-start -->
+> **非 DSH 宿主兼容层（legacy CLI）**：上表的两个通道在非 DSH 宿主分别对应
+> `dws doc +export --export-format markdown`（adoc 导出）与
+> `dws drive +download`（原生文本原样取回）。DSH 环境下两者都由
+> `crwu_audit_knowledge_materialize` 内部完成，技能正文不再给出命令。
+
+<!-- crwu-cli-guard:legacy-compat-end -->