weaver-work-cli 0.1.1 → 0.1.4

package/docs/wenshuding.md

@@ -0,0 +1,129 @@
+# 文书定档案管理 CLI
+
+来源 Skill：`weaver-e10-wenshuding`。本模块把接口文档中可安全自动化的能力封装为 `weaver-work-cli archive` 命令，供 AI Agent 通过结构化 JSON 调用。
+
+源码位于 `src/shortcuts/archive`。命令注册、`operation manifest` 和业务执行逻辑分离：manifest 由 `operations/registry.ts` 汇总各 operation 定义生成，具体执行逻辑在 `src/shortcuts/archive/operations` 中按业务分组维护（全宗、检索、档案信息、借阅车、借阅单、下载、流程 URL、上传）。
+
+面向 Agent 的说明位于 `skills/weaver-e10-wenshuding`。入口 `SKILL.md` 只负责共享规则和 reference 路由；具体细节拆在 `skills/weaver-e10-wenshuding/references/`，与飞书 CLI 的业务 Skill 组织方式保持一致。
+
+## 公共前置
+
+先通过 E10 鉴权模块登录：
+
+```text
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn" --agent_type "<当前智能体名称>"
+weaver-work-cli auth status --no-check
+```
+
+每个档案业务请求由 CLI 托管：
+
+1. 读取当前 `weaver-work-cli auth` Profile 的 E10 会话。
+2. 请求统一走 `/api/` 路径，由 CLI 携带 E10 Cookie/ETEAMSID 与必要的业务头。
+3. 响应按 WeaResult（`code`/`status`/`data`）或 ebuilder 自定义接口（`datajson.status`）判定业务成功。
+
+Agent 不得在业务 JSON 中传 Cookie、ETEAMSID、Token 或内部控制字段。
+
+## Agent 入口
+
+优先使用 `archive run <operation>`：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli archive schema
+weaver-work-cli --json archive run archive.borrow-car.list --input-json '{"pageNo":1,"pageSize":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli archive schema
+weaver-work-cli --json archive run archive.borrow-car.list --input-json '{"pageNo":1,"pageSize":10}'
+```
+
+成功和失败都使用 JSON envelope。成功写 stdout；失败写 stderr，并设置非 0 退出码。
+
+当前输出层是完整 JSON 直接写 stdout，不提供飞书 CLI 的 `--jq`、`--format table/ndjson` 或通用 `--page-all`。Agent 使用时应默认小页读取和摘要渲染：列表先 `pageSize=10`，按 `pageNo` 继续；回复只展示关键字段和数量，超长响落本地文件后给路径。
+
+## Operation 目录
+
+| Operation | 风险 | 固定规则 |
+| --- | --- | --- |
+| `archive.fonds.list` | 只读 | 默认 `menuSign=collectLib`；`id` 供后续链路复用 |
+| `archive.prelib.tree` | 只读 | 只返回识别出的电子文件库节点，其 `id` 即上传 `treeId` |
+| `archive.search.run` | 只读 | `key` 必填；结果行 `id`+`formId` 组成 `{档案ID}_{表单ID}` |
+| `archive.info.get` | 只读 | `arcDangan` 与 `dataId`+`formId` 二选一 |
+| `archive.borrow-car.list` | 只读 | 首选自定义接口 `myBorrowCar`，不可用时自动回退 ebuilder 链路 |
+| `archive.borrow-car.add` | 写（免确认） | 直接传 `formAndIds` 分组；`logFlag=archiveSet`；全宗字段不参与加入借阅车 |
+| `archive.borrow-list.list` | 只读 | 首选自定义接口 `myBorrowList`，不可用时回退「我的借阅」视图 |
+| `archive.borrow-list.detail` | 只读 | 返回明细、可下载判定与流程 requestId |
+| `archive.borrow-list.download.prepare/apply` | 高风险写 | prepare 校验未超期且有可下载原文；apply 轮询打包并落盘「下载」目录 |
+| `archive.flow.borrow-car.prepare/apply` | 高风险写 | 缓存档案与借阅车两组参数，返回流程创建页 URL |
+| `archive.flow.search.prepare/apply` | 高风险写 | 只缓存档案参数，返回流程创建页 URL |
+| `archive.flow.renew.prepare/apply` | 高风险写 | 不缓存，`arcDataId` 直接传借阅单 `dataId`，URL 带 `isReNew=1` |
+| `archive.upload.prelib.prepare/apply` | 高风险写 | continuation 绑定本地文件路径、全宗和 treeId；`preUploadCheck` → `module/upload` → `saveFile` |
+
+未绑定借阅流程时，`archive.flow.*.prepare` 返回 `validation/borrow_flow_unbound`，需要管理员先在档案设置中绑定借阅流程。
+
+## 常用命令
+
+```text
+weaver-work-cli --json archive fonds --input-json '{"menuSign":"collectLib"}'
+weaver-work-cli --json archive search --key 会计凭证 --page-size 10
+weaver-work-cli archive search --key 会计凭证 --page-size 10 --format card
+weaver-work-cli archive search --key 会计凭证 --page-size 10 --format html --output ./search.html
+weaver-work-cli --json archive borrow-car list --page-no 1 --page-size 10
+weaver-work-cli --json archive borrow-list list --page-no 1 --page-size 10
+weaver-work-cli --json archive borrow-list detail --data-id BORROW_DATA_ID
+weaver-work-cli --json archive info --arc-dangan 1252600626189156465_1190991330335571989
+```
+
+加入借阅车是低风险写操作，直接调用、不需要确认：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.borrow-car.add --input .\borrow-car-add.json
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.borrow-car.add --input ./borrow-car-add.json
+```
+
+`borrow-car-add.json` 示例：
+
+```json
+{ "formAndIds": [{ "formId": "1190991330335571989", "ids": ["1252600626189156465"] }] }
+```
+
+其余写操作（下载、发起借阅/续借、预归档上传）仍需 prepare、再 apply：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json archive run archive.borrow-list.download.prepare --input-json '{"dataId":"BORROW_DATA_ID"}'
+
+weaver-work-cli --json archive run archive.upload.prelib.prepare --input-json '{"file":"./档案.pdf","fondsId":"FONDS_ID"}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json archive run archive.borrow-list.download.prepare --input-json '{"dataId":"BORROW_DATA_ID"}'
+
+weaver-work-cli --json archive run archive.upload.prelib.prepare --input-json '{"file":"./档案.pdf","fondsId":"FONDS_ID"}'
+```
+
+## 行为约定
+
+- 全文检索结果的**默认返回显示样式是「卡片视图」**：`archive search --format card` 直接输出三段式 Markdown 卡片（标题可点击档案视图、命中词加粗、全宗/分类/日期一行），除用户明确要求外一律用该样式，不要用普通表格或 JSON 代替；`--format html` 可渲染成可落盘的 HTML。
+- 借阅车/借阅单列表的默认返回显示样式是 **Markdown 表格**（列：序号/题名/类型/分类/时间/状态等可读字段），表头与各列内容 **居中显示**（分隔行用 `| :---: |`），不要用卡片、编号列表或 JSON 代替。
+- 借阅车/借阅单列表优先自定义接口；接口未发布或报错时自动回退，回退行额外提供 `fields`/`display`。
+- 加入借阅车（`archive.borrow-car.add`）是免确认写操作，直接提交；全宗信息只在预归档上传（`upload`）时查询，检索/借阅/下载流程不需要。
+- 下载的 `.apply` 是异步任务：提交后每 2 秒轮询进度，完成后把 zip 保存到当前用户的「下载」目录（可用 `output` 指定路径），已存在同名文件时自动加序号。
+- 发起借阅/续借只返回流程创建页 URL，CLI 不自动打开浏览器；上层 Agent 收到 URL 后默认调用**系统默认浏览器**打开，只有用户明确要求内置视图时才使用 IDE 内置浏览器。
+- 写操作的 continuation 由 CLI 签发并绑定环境与登录账号，换环境或换账号必须重新 prepare。
+- 写操作出现网络中断、部分成功或回查失败时返回 `partial/write_uncertain`，Agent 禁止自动重复提交。
+- 涉及本地文件上传或原文下载时，必须先提醒用户文件内容可能进入大模型上下文，并取得明确确认。

package/docs/ziguanjia.md

@@ -0,0 +1,89 @@
+# 资管家资产管理 CLI
+
+来源目录：`weaver-e10-ziguanjia`，内容版本未知。本模块把源资料中可安全自动化的能力封装为 `weaver-work-cli asset` 命令，供 AI Agent 通过结构化 JSON 调用。
+
+源码位于 `src/shortcuts/asset`。命令注册、operation manifest 和业务执行逻辑分离；具体执行逻辑在 `src/shortcuts/asset/operations` 中按 operation class 维护。
+
+面向 Agent 的说明位于 `skills/weaver-e10-ziguanjia`。入口 `SKILL.md` 只负责共享规则和 reference 路由；具体细节拆在 `skills/weaver-e10-ziguanjia/references/`，与飞书 CLI 的业务 Skill 组织方式保持一致。
+
+## 公共前置
+
+先通过 E10 鉴权模块登录：
+
+```text
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn" --agent_type "<当前智能体名称>"
+weaver-work-cli auth status --no-check
+```
+
+每个资管家业务请求由 CLI 托管：读取当前 `weaver-work-cli auth` Profile 的 E10 会话，并调用 eBuilder 自定义接口（`/api/ebuilder/form/formdata/v2/*`）或 ESB 动作流（`/api/esb/server/event/triggerActionFlow`）。Agent 不得在业务 JSON 中传 Cookie、ETEAMSID、Token 或内部控制字段。
+
+## 版本门禁
+
+源资料约定：任何资产查询或写操作前，必须先确认 `zgjasset_search_appver` 存在 `ver_name ≥ V14` 的记录。CLI 在每个写操作中内置门禁，并额外暴露 `asset.gate.check` 供只读校验。门禁未通过时写操作会 STOP，不执行任何资产请求，也不走任何降级路径。
+
+## Agent 入口
+
+优先使用 `asset run <operation>`：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli asset schema
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli asset schema
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+```
+
+成功和失败都使用 JSON envelope。成功写 stdout；失败写 stderr，并设置非 0 退出码。
+
+当前输出层是完整 JSON 直接写 stdout，不提供飞书 CLI 的 `--jq`、`--format table/ndjson` 或通用 `--page-all`。Agent 使用时应默认小页读取和摘要渲染：列表先 `page_size=10`，按 `page_no` 继续；回复只展示关键字段和数量，超长详情/OCR/调试 JSON 落本地文件后给路径。
+
+## Operation 目录
+
+| Operation | 风险 | 固定规则 |
+| --- | --- | --- |
+| `asset.gate.check` | 只读 | 版本门禁校验，返回是否通过 |
+| `asset.list` | 只读 | 资产台账列表，按 mainTable 字段筛选 |
+| `asset.detail` | 只读 | 资产详情，至少传 id / asset_number / asset_name 之一 |
+| `asset.uselist` | 只读 | 领用列表，person_id 缺省查当前登录人 |
+| `asset.repaillist` | 只读 | 报修列表，person_id 缺省查当前登录人 |
+| `asset.purchaselist` | 只读 | 采购申请列表，person_id 缺省查当前登录人 |
+| `asset.resolve.location` | 只读 | 按 house_name 解析存放地点 ID |
+| `asset.resolve.status` | 只读 | 按 status_name 解析资产状态 ID |
+| `asset.resolve.type` | 只读 | 按 type_name 解析资产类型 ID |
+| `asset.create` | 高风险写 | eBuilder saveFormData；prepare 返回 continuation |
+| `asset.update` | 高风险写 | eBuilder updateFormData；prepare 返回 continuation |
+| `asset.use` | 高风险写 | ESB 动作流领用；prepare 返回 continuation |
+| `asset.return.query` | 写前只读 | ESB 动作流查询可归还候选 |
+| `asset.return.create` | 高风险写 | ESB 动作流归还；prepare 返回 continuation |
+| `asset.repair.query` | 写前只读 | ESB 动作流查询报修候选 |
+| `asset.repair.create` | 高风险写 | ESB 动作流报修；prepare 返回 continuation |
+| `asset.purch` | 高风险写 | ESB 动作流采购申请；prepare 返回 continuation |
+| `asset.depre` | 高风险写 | 折旧设置读取 + 预检 + 任务创建；prepare 返回 continuation |
+
+暂未暴露：资产调拨（`asset.transfer`）、流程审批（`asset.approve`）、图片上传（`asset.file.upload`）。原因见 `skills/weaver-e10-ziguanjia/references/ziguanjia-disabled-capabilities.md`。
+
+## 常用命令
+
+```text
+weaver-work-cli --json asset run asset.gate.check --input-json '{}'
+weaver-work-cli --json asset run asset.list --input-json '{"page_size":10}'
+weaver-work-cli --json asset run asset.resolve.type --input-json '{"type_name":"EXAMPLE_TYPE"}'
+weaver-work-cli --json asset run asset.create --input-json '{"asset_name":"EXAMPLE_ASSET","asset_type_browse":"EXAMPLE_TYPE_ID"}'
+weaver-work-cli --json asset run asset.create --input-json '{"continuation":"PREPARE_CONTINUATION","confirm":true}'
+```
+
+## 编辑白名单
+
+写操作的 `prepare` 阶段只接受 manifest 已声明字段；其中：
+
+- `asset.update` 的 `changes` 只允许：`asset_name`、`stateid`、`admin_istrator`、`resourceid`、`location_browse`、`unit_price`、`value`。
+- `asset.create` 不接受 `id`、内部控制字段或文件上传；图片仅接受已上传得到的裸 `file_id`。
+- 所有写操作都不接受 `Cookie`、`ETEAMSID`、`token`、`sedit`、`app_key`、`app_secret`、`access_token` 等内部控制/凭据字段（CLI 会在输入层拒绝）。
+
+写请求已发送后如遇网络中断、部分成功或回查失败，CLI 返回 `partial/write_uncertain`，Agent 禁止自动重复提交。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weaver-work-cli",
-  "version": "0.1.1",
+  "version": "0.1.4",
   "description": "面向泛微工作工具链的可扩展 TypeScript CLI 基础框架（E10 业票通等能力）",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,11 +18,11 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "clean": "node scripts/clean.mjs",
-    "build": "npm run clean && tsc",
-    "test": "node --test --import tsx \"test/**/*.test.ts\"",
+    "build": "npm run clean && tsc && node scripts/postbuild.mjs",
+    "test": "node --import tsx --test $(find test -name '*.test.ts' -type f | sort)",
     "start": "node dist/index.js",
     "build:skill": "node scripts/package-skill.mjs",
-    "build:invoice-skill": "node scripts/package-skill.mjs invoice",
+    "build:yepiaotong-skill": "node scripts/package-skill.mjs yepiaotong",
     "prepublishOnly": "npm run build && npm run test",
     "prepack": "npm run build"
   },

package/scripts/package-skill.mjs

@@ -1,33 +1,24 @@
 #!/usr/bin/env node
 
 import { createHash } from 'node:crypto'
-import { copyFile, mkdir, mkdtemp, readFile, readdir, rm, stat } from 'node:fs/promises'
+import { copyFile, mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from 'node:fs/promises'
 import os from 'node:os'
 import path from 'node:path'
-import { spawn } from 'node:child_process'
 import { fileURLToPath } from 'node:url'
+import { deflateRawSync } from 'node:zlib'
 
 const repositoryRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
 const skillsRoot = path.join(repositoryRoot, 'skills')
-const sharedSkillName = 'weaver-work-cli-shared'
+const sharedSkillName = 'weaver-e10-shared'
+const legacySharedSkillName = 'weaver-work-cli-shared'
+const skillPrefix = 'weaver-e10-'
+const legacySkillPrefix = 'weaver-work-cli-'
 const [requestedSkillArg, outputArg] = process.argv.slice(2)
 
 function sha256(value) {
   return createHash('sha256').update(value).digest('hex')
 }
 
-function run(command, args, cwd) {
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, { cwd, stdio: ['ignore', 'pipe', 'pipe'] })
-    let stdout = ''
-    let stderr = ''
-    child.stdout.on('data', (chunk) => { stdout += chunk })
-    child.stderr.on('data', (chunk) => { stderr += chunk })
-    child.once('error', reject)
-    child.once('close', (code) => resolve({ code: code ?? 1, stdout, stderr }))
-  })
-}
-
 function normalizeSkillName(value) {
   if (!value || value === 'all') return null
   if (value.includes('/') || value.includes('\\') || value === '.' || value === '..') {
@@ -36,7 +27,8 @@ function normalizeSkillName(value) {
   if (!/^[A-Za-z0-9._-]+$/u.test(value)) {
     throw new Error(`非法 Skill 名称：${value}`)
   }
-  return value.startsWith('weaver-work-cli-') ? value : `weaver-work-cli-${value}`
+  if (value.startsWith(legacySkillPrefix)) return `${skillPrefix}${value.slice(legacySkillPrefix.length)}`
+  return value.startsWith(skillPrefix) ? value : `${skillPrefix}${value}`
 }
 
 async function exists(filename) {
@@ -76,7 +68,7 @@ function defaultOutput(skillNames) {
     return path.join(repositoryRoot, 'dist', `${requestedSkill}-skill.zip`)
   }
   if (skillNames.length === 1) return path.join(repositoryRoot, 'dist', `${skillNames[0]}-skill.zip`)
-  return path.join(repositoryRoot, 'dist', 'weaver-work-cli-skills.zip')
+  return path.join(repositoryRoot, 'dist', 'weaver-e10-skills.zip')
 }
 
 function shouldSkip(entry, relativePath) {
@@ -91,9 +83,111 @@ function assertSafeRelativePath(relativePath) {
   }
 }
 
-async function copySkill(skillName, stagingRoot, packagedEntries) {
+function crc32(buffer) {
+  let crc = 0xffffffff
+  for (const byte of buffer) {
+    crc ^= byte
+    for (let bit = 0; bit < 8; bit += 1) {
+      crc = (crc >>> 1) ^ (crc & 1 ? 0xedb88320 : 0)
+    }
+  }
+  return (crc ^ 0xffffffff) >>> 0
+}
+
+function dosTimestamp() {
+  return { time: 0, date: 33 }
+}
+
+function uint16(value) {
+  const buffer = Buffer.alloc(2)
+  buffer.writeUInt16LE(value)
+  return buffer
+}
+
+function uint32(value) {
+  const buffer = Buffer.alloc(4)
+  buffer.writeUInt32LE(value)
+  return buffer
+}
+
+async function createZipArchive(root, entries) {
+  const timestamp = dosTimestamp()
+  const localParts = []
+  const centralParts = []
+  let offset = 0
+
+  for (const entry of entries) {
+    const name = Buffer.from(entry, 'utf8')
+    const body = await readFile(path.join(root, ...entry.split('/')))
+    const deflated = deflateRawSync(body, { level: 9 })
+    const compressed = deflated.length < body.length ? deflated : body
+    const method = compressed === deflated ? 8 : 0
+    const checksum = crc32(body)
+    const flags = 0x0800
+
+    const localHeader = Buffer.concat([
+      uint32(0x04034b50),
+      uint16(20),
+      uint16(flags),
+      uint16(method),
+      uint16(timestamp.time),
+      uint16(timestamp.date),
+      uint32(checksum),
+      uint32(compressed.length),
+      uint32(body.length),
+      uint16(name.length),
+      uint16(0),
+      name,
+    ])
+    localParts.push(localHeader, compressed)
+
+    const centralHeader = Buffer.concat([
+      uint32(0x02014b50),
+      uint16(20),
+      uint16(20),
+      uint16(flags),
+      uint16(method),
+      uint16(timestamp.time),
+      uint16(timestamp.date),
+      uint32(checksum),
+      uint32(compressed.length),
+      uint32(body.length),
+      uint16(name.length),
+      uint16(0),
+      uint16(0),
+      uint16(0),
+      uint16(0),
+      uint32(0),
+      uint32(offset),
+      name,
+    ])
+    centralParts.push(centralHeader)
+    offset += localHeader.length + compressed.length
+  }
+
+  const centralDirectory = Buffer.concat(centralParts)
+  const end = Buffer.concat([
+    uint32(0x06054b50),
+    uint16(0),
+    uint16(0),
+    uint16(entries.length),
+    uint16(entries.length),
+    uint32(centralDirectory.length),
+    uint32(offset),
+    uint16(0),
+  ])
+
+  return Buffer.concat([...localParts, centralDirectory, end])
+}
+
+function rewriteSkillContent(skillName, relativePath, content) {
+  if (skillName !== legacySharedSkillName || relativePath !== 'SKILL.md') return content
+  return content.replace(/^name:\s*weaver-e10-shared\s*$/mu, `name: ${legacySharedSkillName}`)
+}
+
+async function copySkill(skillName, stagingRoot, packagedEntries, packageName = skillName) {
   const sourceRoot = path.join(skillsRoot, skillName)
-  const packageRoot = path.join(stagingRoot, skillName)
+  const packageRoot = path.join(stagingRoot, packageName)
   await stat(path.join(sourceRoot, 'SKILL.md'))
 
   async function copyDir(relativeDir = '') {
@@ -113,8 +207,13 @@ async function copySkill(skillName, stagingRoot, packagedEntries) {
         await copyDir(relativePath)
       } else if (entry.isFile()) {
         await mkdir(path.dirname(target), { recursive: true, mode: 0o700 })
-        await copyFile(source, target)
-        packagedEntries.push(`${skillName}/${relativePath}`)
+        if (packageName === skillName) {
+          await copyFile(source, target)
+        } else {
+          const content = await readFile(source, 'utf8')
+          await writeFile(target, rewriteSkillContent(packageName, relativePath, content))
+        }
+        packagedEntries.push(`${packageName}/${relativePath}`)
       }
     }
   }
@@ -134,31 +233,25 @@ const skillNames = await resolveSkillNames()
 if (skillNames.length === 0) throw new Error('没有可打包的 Skill')
 
 const output = path.resolve(outputArg || defaultOutput(skillNames))
-const stagingRoot = await mkdtemp(path.join(os.tmpdir(), 'weaver-work-cli-skill-'))
+const stagingRoot = await mkdtemp(path.join(os.tmpdir(), 'weaver-e10-skill-'))
 const packagedEntries = []
 
 try {
   await mkdir(path.dirname(output), { recursive: true, mode: 0o700 })
   for (const skillName of skillNames) {
     await copySkill(skillName, stagingRoot, packagedEntries)
+    if (skillName === sharedSkillName) {
+      await copySkill(skillName, stagingRoot, packagedEntries, legacySharedSkillName)
+    }
   }
 
   await rm(output, { force: true })
-  const zipResult = await run('zip', ['-X', '-q', '-r', output, ...skillNames], stagingRoot)
-  if (zipResult.code !== 0) throw new Error(`Skill ZIP 打包失败：${zipResult.stderr.trim()}`)
-
-  const archive = await readFile(output)
-  const listResult = await run('unzip', ['-Z1', output], repositoryRoot)
-  if (listResult.code !== 0) throw new Error(`Skill ZIP 校验失败：${listResult.stderr.trim()}`)
-
-  const actualEntries = listResult.stdout.trim().split(/\r?\n/u).filter((entry) => entry && !entry.endsWith('/')).sort()
   const expectedEntries = packagedEntries.sort()
-  if (JSON.stringify(actualEntries) !== JSON.stringify(expectedEntries)) {
-    throw new Error(`Skill ZIP 闭包不匹配：${JSON.stringify(actualEntries)}`)
-  }
+  const archive = await createZipArchive(stagingRoot, expectedEntries)
+  await writeFile(output, archive)
   if (archive.length > 256 * 1024) throw new Error(`Skill ZIP 超过 256 KiB：${archive.length}`)
 
-  console.log(JSON.stringify({ ok: true, output, bytes: (await stat(output)).size, sha256: sha256(archive), skills: skillNames, entries: actualEntries }, null, 2))
+  console.log(JSON.stringify({ ok: true, output, bytes: (await stat(output)).size, sha256: sha256(archive), skills: skillNames, entries: expectedEntries }, null, 2))
 } finally {
   await rm(stagingRoot, { recursive: true, force: true })
 }

package/scripts/postbuild.mjs

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+// 构建后把 bin 入口设为可执行，保证 `npm link` 场景下全局命令可运行。
+// tsc 每次重建 dist/index.js 都会把权限重置为 644，因此放在 build 之后执行。
+import { chmodSync, existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+const entry = fileURLToPath(new URL('../dist/index.js', import.meta.url));
+
+if (existsSync(entry)) {
+  chmodSync(entry, 0o755);
+  console.log('postbuild: dist/index.js mode set to 755');
+}

package/skill-template/business-info.json

@@ -1,4 +1,15 @@
 {
-  "weaver-work-cli-invoice": ["业票通", "发票", "票夹", "OCR", "查验", "报销发票"],
-  "weaver-work-cli-shared": ["安装", "登录", "认证", "E10", "profile", "JSON 输出", "高风险写入"]
+  "weaver-e10-wenshuding": ["文书定", "档案", "全宗", "预归档", "档案检索", "全文检索", "借阅车", "借阅单", "借阅", "续借", "档案下载", "原文下载", "预归档上传", "电子文件库"],
+  "weaver-e10-yepiaotong": ["业票通", "发票", "票夹", "OCR", "查验", "报销发票", "自动填单", "事前申请报销", "开票", "存台账", "发票浏览按钮"],
+  "weaver-e10-jucailin": ["聚才林", "人事", "人事档案", "通讯录", "出勤", "考勤", "打卡", "申诉", "薪酬", "工资单", "社保", "招聘", "人才", "候选人", "面试", "Offer", "入职"],
+  "weaver-e10-qiyecheng": ["齐业成", "费控", "FNA", "预算", "事前申请", "预算执行", "报销", "借款", "还款提醒", "预付", "核销", "发票核销", "催票", "对公支付"],
+  "weaver-e10-hrm": ["组织管理", "员工", "人员", "工号", "下属", "部门", "分部", "组织架构", "岗位", "职位", "批量查人员", "批量查岗位"],
+  "weaver-e10-esb": ["ESB", "动作流", "触发动作流", "执行动作流", "自定义触发", "入参模板", "ESB中心"],
+  "weaver-e10-mail": ["邮件", "收件箱", "发件箱", "草稿箱", "已删除", "待办邮件", "垃圾箱", "邮件正文", "附件", "发送邮件", "回复", "转发", "存草稿", "标星", "已读", "待办提醒", "移动邮件", "删除邮件", "撤回", "文件夹", "联系人", "联系人分组", "邮件模板", "签名", "二维码名片", "黑名单"],
+  "weaver-e10-calendar": ["日程", "日历", "安排", "提醒", "日程列表", "日程详情", "创建日程", "更新日程", "删除日程", "日程类型", "紧急程度", "参与人"],
+  "weaver-e10-plan": ["计划报告", "报告", "周报", "月报", "季报", "年报", "年中报告", "工作总结", "汇总工作", "新建报告", "修改报告", "发布报告", "撤回报告", "共享报告", "提交提醒", "报告评论", "报告详情"],
+  "weaver-e10-jiuchuanhui": ["九氚汇", "营销管理", "CRM", "客户", "联系人", "商机", "线索", "联系计划", "联系记录", "跟进记录", "公海", "客户公海", "赢单", "输单", "线索转客户", "客户经理"],
+  "weaver-e10-skill-maker": ["业务模块 CLI", "业务模块 Skill", "生成 Skill", "生成 operation", "自定义 Skill", "能力封装", "源资料更新检测"],
+  "weaver-e10-shared": ["安装", "登录", "认证", "E10", "profile", "JSON 输出", "高风险写入"],
+  "weaver-e10-ziguanjia": ["资管家", "资产管理", "固定资产", "资产", "资产领用", "资产归还", "资产报修", "资产采购", "折旧", "资产地点", "资产状态", "资产类型"]
 }

package/skill-template/domains/calendar.md

@@ -0,0 +1,15 @@
+本业务域用于 E10 日程管理。入口 `SKILL.md` 按 weaver 风格组织：CRITICAL 共享前置、路由优先级、高优先级语义、写操作确认链、执行原则、失败处理和「不在范围」。具体用法拆到 `references/`：
+
+- `calendar-query.md`：日程列表（ESB 流程触发）、日程详情、日程总数。
+- `calendar-dict.md`：日程类型、紧急程度字典（创建/更新前取选项 ID）。
+- `calendar-write.md`：创建、更新（全量覆盖）、删除日程的 `prepare -> apply` 写入协议。
+- `calendar-app-check.md`：应用版本检测与详情卡片页链接。
+
+Agent 调优重点：
+
+- `weaver-work-cli calendar schema` 是 operation 合约第一信息源。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段；`header.operator` 由 CLI 自动填充。
+- `agn_type`/`priority` 传选项 ID（先查字典），`participants` 传人员 ID（先由 weaver-e10-hrm 解析姓名）。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用；`confirm=true` 必须由用户明确确认后传入。
+- 更新为全量覆盖，`update.prepare` 先查当前详情再合并；删除不可逆，务必 prepare 展示后确认。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。

package/skill-template/domains/esb.md

@@ -0,0 +1,13 @@
+本业务域用于泛微 E10 ESB 中心的自定义触发动作流（取入参模板 + 触发执行）。入口 `SKILL.md` 先路由到 `weaver-e10-shared/SKILL.md`，再给出触发标识语义、写操作确认链和失败决策树。具体用法拆到 `references/`：
+
+- `input-format.md`：按动作流 ID 取 `customParams` 模板、识别 `#可选` 占位字段、只读查询的失败处理。
+- `trigger.md`：`esb.trigger.prepare` → `esb.trigger.apply` 确认链、请求体组装、结果判读（`resultCode` / `actionData` / `followUp`）与失败处置。
+- `source-manifest.json`：源资料清单与 sha256 指纹，用于源资料更新检测。
+
+调优重点：
+
+- `weaver-work-cli esb schema` 是 operation 合约第一信息源；`withheldOperations` 声明按名称解析 ID（`esb.actionflow.resolve`）与唯一值 `primary_key` 查询（`esb.unique-indent.resolve`）两条禁用边界，直接说明不可用，不引导用户绕过。
+- 触发标识 `esbFlowId` 与 `uniqueIndent` 二选一：都传或多缺均为结构化校验错误，不得静默回退；唯一值触发存在「同租户多流同唯一值只执行 create_time 最新一条」的歧义，精确控制要求用户改传 `esbFlowId`。
+- **trigger 是写操作**：必须先 `prepare` 并把 `requestPreview` 展示给用户确认，再 `apply` 且 `confirm: true`。
+- `write_uncertain` 出现时必须立即停止：请求已发出但结果未知，禁止重试，先查动作流运行日志。
+- 限流类错误（`throttled`）只提示稍后重试，不做高频轮询。

package/skill-template/domains/hrm.md

@@ -0,0 +1,16 @@
+本业务域用于泛微 E10 组织管理（员工查询 / 组织架构 / 岗位查询，全部只读）。入口 `SKILL.md` 先路由到 `weaver-e10-shared/SKILL.md`，再给出跨模块约定、Reference 路由表和安全边界。具体用法拆到 `references/`：
+
+- `employee.md`：按工号/姓名/手机/邮箱查员工、批量人员、资料名片、下属查询（当前登录人 + 按 id）、部门成员。
+- `org.md`：分部/部门浏览、组织详情、多级路径 drill-down 编排。
+- `position.md`：岗位浏览、岗位详情、岗位批量（岗位地址簿）。
+- `source-manifest.json`：源资料清单与 sha256 指纹，用于源资料更新检测。
+
+调优重点：
+
+- `weaver-work-cli hrm schema` 是 operation 合约第一信息源，`withheldOperations` 声明代理商查询禁用边界。
+- 三个业务域统一 `WeaResult` 响应契约，已在 CLI 内归一化；但「员工浏览/下属查询的 total 需额外请求 count/resource」这一差异必须由 Agent 正确解读。
+- 长整型 id 一律按字符串传递；手机号已由 CLI 脱敏。
+- **无条件禁止全量拉取**：`employee.query`/`org.query`/`position.query` 必须带收敛条件；`position.list` 无过滤需显式 `all=true`；`employee.query` 的 `status` 不能单独使用。
+- 姓名/工号/名称模糊匹配多人命中时必须列候选让用户选择，不得自动取第一条；部门重名改传组织 id。
+- 批量查询禁止循环单查：批量人员走 `employee.batch`，岗位批量走 `position.list`。
+- 代理商查询（`containsDls=true`）属禁用边界，直接说明不可用，不引导用户绕过。

package/skill-template/domains/jiuchuanhui.md

@@ -0,0 +1,23 @@
+本业务域用于 E10 九氚汇营销管理 CRM。入口 `SKILL.md` 按飞书 `lark-approval` 风格组织：CRITICAL 共享前置、路由优先级、高优先级语义、逐 operation 命令表、处理链、执行原则、写操作失败决策树和“不在范围”。具体用法拆到 `references/`：
+
+- `jiuchuanhui-entry.md`：schema、统一 `jiuchuanhui run` 入口、JSON 输入方式。
+- `customer.md`：客户创建/详情/搜索/修改/转移/公海/查重/联系记录的写入协议与搜索约束。
+- `contact.md`：联系人创建/详情/修改/按事项查询。
+- `sale.md`：商机创建/详情/搜索/修改/阶段/赢单/输单/无效/暂停/重启/转移/关联联系人/联系记录。
+- `clue.md`：线索创建/详情/搜索/修改/状态变更/转客户/线索池/跟进记录。
+- `contact-plan.md`：创建/完成联系计划的 `type` 联动规则。
+- `contact-records.md`：按事项或按人员+时间范围查询联系记录。
+- `discovery-config.md`：应用/表单/字段/选项/接口配置/文件预览的发现与配置，含缓存初始化边界。
+- `general-helpers.md`：按名称查事项/人员 ID、当前人员、权限校验、工商照面、字段信息、自定义浏览选项。
+- `disabled-capabilities.md`：缓存初始化、商机阶段推进等未暴露能力的处理边界。
+- `source-manifest.json`：源资料指纹、`sourceChunks`/`operationImpact` 影响索引和产物基线。
+
+Agent 调优重点：
+
+- `weaver-work-cli jiuchuanhui schema` 是 operation 合约第一信息源。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用。
+- 选项字段先取选项 ID 再传值；`RelateBrowser` 用 `browser-option.search`；行政区划用逗号分隔全路径 ID。
+- 客户搜索必须显式传 `mine`/`all`/`customerSea`，没有 `scope` 快捷参数。
+- 新建客户前先查重；赢单/输单/无效/释放公海前提示不可逆或关键影响。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。

package/skill-template/domains/jucailin.md

@@ -0,0 +1,22 @@
+本业务域用于泛微聚才林（E10 人事云）的人事档案、出勤管理、薪酬管理、招聘查询（只读）。入口 `SKILL.md` 先路由到 `weaver-e10-shared/SKILL.md`，再给出跨子系统差异、Reference 路由表和安全边界。具体用法拆到 `references/`：
+
+- `salary.md`：工资单、福利、调薪记录、社保台账、员工薪资明细查询。
+- `attend-read.md`：出勤统计、异常考勤、打卡记录、外勤轨迹、假期统计、申诉查询。
+- `attend-write.md`：PC 端打卡、创建申诉、处理申诉、报表重算的 `prepare -> apply` 写入协议。
+- `hr-contact.md`：通讯录、字段列表、浏览器选择器、生日查询、人员状态变更台账。
+- `hr-datasource.md`：HR 数据源通用查询（历史时点名册、离职名册、编制、流动分析等）。
+- `hr-report.md`：部门/岗位/职务/职类人数、流失离职、占编人员、流动明细、属性合计。
+- `recruit-read.md`：人才库搜索、招聘需求/职位/入职/录用列表、人才详情卡片（只读）。
+- `safety-boundaries.md`：招聘写操作与移动端打卡的禁用边界，以及通用禁止项。
+- `source-manifest.json`：源资料清单与 sha256 指纹，用于源资料更新检测。
+
+调优重点：
+
+- `weaver-work-cli ehr schema` 是 operation 合约第一信息源，`dataSourceIds` 提供固定 formId 常量表。
+- 三个子系统的响应成功判定与分页结构不统一，已在 CLI 内归一化；但「通讯录默认在职、状态变更默认含离职」的语义差异必须由 Agent 正确解读。
+- 姓名、工号等模糊条件多人命中时必须列候选让用户选择，浏览器选择器返回多条时看 `requiresDisambiguation`。
+- 占编人员查询的 `cfgId`/`id` 必须先从数据源记录解析，禁止编造。
+- 招聘查询的运行时参数由 CLI 自动五层解析并缓存，业务输入只描述业务对象与意图；人才/需求等模糊命中多人时同样必须列候选让用户确认。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用；`apply` 不自动重试。
+- 招聘写操作与移动端打卡属禁用边界，直接说明不可用，不引导用户绕过。
+- 结果为 `partial/write_uncertain` 时停止，先做只读回查。

package/skill-template/domains/mail.md

@@ -0,0 +1,21 @@
+本业务域用于 E10 邮件管理。入口 `SKILL.md` 按飞书风格组织：CRITICAL 共享前置、路由优先级、高优先级语义、逐 operation 命令表、处理链、执行原则、写操作失败决策树和“不在范围”。具体用法拆到 `references/`：
+
+- `mail-agent-entry.md`：schema、统一 `mail run` 入口、stdin JSON 调用方式。
+- `mail-read.md`：邮件列表/详情/正文/未读统计/配置、收件人解析、联系人/分组/模板/签名/黑名单列表与附件中心。
+- `mail-send.md`：发送/回复/转发/存草稿的 `prepare -> apply` 写入协议。
+- `mail-manage.md`：标星、已读、全部已读、待办、移动、逻辑删除、文件夹、撤回。
+- `mail-contacts.md`：联系人/分组的 `prepare -> apply` 保存与删除。
+- `mail-template.md`：模板的 `prepare -> apply` 保存、编辑、删除与默认。
+- `mail-sign.md`：签名的 `prepare -> apply` 保存、编辑、删除、默认与二维码名片。
+- `mail-blacklist.md`：黑名单新增/删除的 `prepare -> apply` 协议。
+- `mail-attachment.md`：附件上传（预检→上传→绑定）与批量下载。
+- `safety-boundaries.md`：已暂缓的破坏性/缺口 operation（物理永久删除、重发）与高风险写约束。
+
+Agent 调优重点：
+
+- `weaver-work-cli mail schema` 是 operation 合约第一信息源。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用。
+- 发送、联系人/分组/模板/签名保存、黑名单操作必须先展示摘要并取得明确确认。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。
+- 物理永久删除（`mail.delete.batch`）与重发（`mail.resend`）未暴露，需单独授权处理。