weaver-work-cli 0.1.2 → 0.1.5

package/docs/yimiaoban.md

@@ -0,0 +1,86 @@
+# 易秒办即时通讯（yimiaoban）
+
+`yimiaoban` 是 E10 易秒办即时通讯的聚合命令，覆盖**消息（msg）**、**必达（ding）**、**群组（group）**、**会话（session）**、**系统消息（sysmsg）**，以及支撑能力人员解析（person）、文件上传/预览（file）、用户状态（user）、i18n 标签（i18n）。
+
+```text
+weaver-work-cli yimiaoban --help
+weaver-work-cli yimiaoban schema
+weaver-work-cli --json yimiaoban run <operation> --input -
+```
+
+`schema` 是能力清单的唯一事实来源，包含每个 operation 的 `inputSchema`、`risk`、`requiresConfirmation`。
+
+## 实现位置
+
+| 路径 | 职责 |
+| --- | --- |
+| `src/shortcuts/yimiaoban/index.ts` | 命令注册与 JSON envelope |
+| `src/shortcuts/yimiaoban/manifest.ts` | `schema` 契约 |
+| `src/shortcuts/yimiaoban/host.ts` | E10 会话桥接、认证头、executeIm/文件上传、hrm 人员解析、i18n、媒体 URL |
+| `src/shortcuts/yimiaoban/continuation.ts` | 写操作确认链的 HMAC-SHA256 token |
+| `src/shortcuts/yimiaoban/operations/` | 按业务域拆分的 operation 实现 |
+| `src/shortcuts/yimiaoban/operations/registry.ts` | operation 注册表与去重校验 |
+
+## 认证
+
+复用 `src/internal/e10` 的 E10 会话（`requireE10Session`），请求自动携带 `Cookie`、`eteamsid` 与 `X-Requested-With: XMLHttpRequest`。IM 接口前缀 `/api/em/msg/executeIm`，必达例外走 `/api/em/msg/createDing`。业务代码不接触认证目录，路径强制以 `/api/` 开头。
+
+## 红线（模块内强制）
+
+- 请求体禁止传操作人字段（user/sender/creator/operator），操作者由 `eteamsid` 识别。
+- 人名一律走 hrm：`/api/hrm/common/getEmployeeByIds` 解析，禁止用 IM 群成员 `name` 字段。
+- uid/cid/群 id 是 uint64，一律字符串传输且非 0。
+- 过滤全部服务端完成；分页单页默认 20（群搜索 100），不自动翻页拉全量。
+- 时间范围查询换算为消息 id 区间（`resolveStartEnd`/`makeMinMaxIdByTm`）。
+- 全空白文本不算内容（拒绝发送空白消息）；普通请求 15 秒超时即失败不重试（上传 15/60 秒）。
+- 媒体只给需登录态的 URL，真要看内容用 `file.download` 落地到本地（父目录须存在、拒绝覆盖）。
+- 消息内容完整透出，不截断；展示规则见 Skill `safety-boundaries.md`。
+
+## 消息拉取与展示
+
+`msg.sync.single`（对方 `fromUid`+`fromCid` 必填）、`msg.sync.group`（`groupId` 必填，type=0 固定）为倒序单页拉取；`actionMsg.code=1303` 表示无聊天记录，按成功空列表处理，并返回 `empty:true` + `emptyReason`（区分当天无消息/时间范围无消息/会话无历史）。单页有更多数据时返回 `nextStart`（下页 `start` 锚点）与 `dedupeHint`（边界消息会重复，需按 `msgid` 去重）。
+
+返回的 `messages[]` 已按 msgParser 语义解析为结构化行：
+
+- `sender`：自己显示「我」（按会话 uid 判定），他人优先消息 `sname`、其次 hrm 姓名、最后回退 uid；`time`；`typeName`；`content`：完整正文（@ 提及已还原、媒体显示 `[图片]名称`/`[视频]名称`/`[文件]名称`）。
+- `fileName`：媒体消息原始文件名（便于单独渲染）；富文本分段解析支持图片/文件/视频/语音/位置。
+- `media`：图片/视频/文件的预览与下载 URL（weappAuthStr 构造，需登录态）。
+- `must`：必达标记。会话副标题媒体消息按 `[类型]名称` 展示，必达保留 `[必达]` 前缀。
+
+## 写协议与 continuation
+
+所有写操作（send/withdraw/top.set/ding/group 系列）统一 `prepare → apply`：
+
+- `prepare`：只读校验（成员解析、源消息读取、接收人计算），返回 `summary` + `continuation`（HMAC-SHA256 签名，10 分钟有效，含 baseUrl/profile/userId 指纹与 snapshot 指纹）。
+- `apply`：必须 `confirm:true` + 有效 continuation；校验租户/账号一致（`context_mismatch`）与目标指纹（`target_changed`）；执行后不确定结果返回 `partial/write_uncertain`，禁止自动重试。
+
+## 分组速览（以 schema 为准）
+
+| 前缀 | 覆盖 |
+| --- | --- |
+| `yimiaoban.person.*` | resolve / resolveByIds |
+| `yimiaoban.msg.sync.*` / `msg.top.sync` / `msg.read.*` | 消息拉取/置顶/阅读状态 |
+| `yimiaoban.msg.send.*` / `msg.withdraw` / `msg.top.set` | 发送/撤回/置顶（写，两段式） |
+| `yimiaoban.ding.send.*` | 必达/转必达（写，两段式） |
+| `yimiaoban.group.search/info/users/admins/exist/userExist/announce.*` | 群读 |
+| `yimiaoban.group.create/invite/kick/exit/destroy/join/modify/rename/announce.modify` | 群写（两段式） |
+| `yimiaoban.session.list` / `sysmsg.*` | 会话与系统消息 |
+| `yimiaoban.file.upload/preview/download` / `user.state` / `i18n.labels` | 文件/状态/翻译 |
+
+## 平台示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json yimiaoban run yimiaoban.msg.sync.group --input-json '{"groupId":"1788334281700000004","num":20,"latest":true}'
+weaver-work-cli --json yimiaoban run yimiaoban.group.users --input-json '{"groupId":"1788334281700000004"}'
+weaver-work-cli --json yimiaoban run yimiaoban.session.list --input-json '{"num":20}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json yimiaoban run yimiaoban.msg.sync.group --input-json '{"groupId":"1788334281700000004","num":20,"latest":true}'
+weaver-work-cli --json yimiaoban run yimiaoban.group.users --input-json '{"groupId":"1788334281700000004"}'
+weaver-work-cli --json yimiaoban run yimiaoban.session.list --input-json '{"num":20}'
+```

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.2",
+  "version": "0.1.5",
   "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,18 @@
 {
-  "weaver-work-cli-invoice": ["业票通", "发票", "票夹", "OCR", "查验", "报销发票"],
-  "weaver-work-cli-shared": ["安装", "登录", "认证", "E10", "profile", "JSON 输出", "高风险写入"]
+  "weaver-e10-calendar": ["日程", "日程管理", "创建日程", "日程列表", "日程详情", "删除日程", "日程类型", "紧急程度", "日历"],
+  "weaver-e10-meeting": ["会议", "会议室", "预约会议", "建会", "会议冲突", "签到", "回执", "会议类型", "会议室占用", "今天会议", "下一场会议", "会议列表", "请假回执"],
+  "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": ["资管家", "资产管理", "固定资产", "资产", "资产领用", "资产归还", "资产报修", "资产采购", "折旧", "资产地点", "资产状态", "资产类型"],
+  "weaver-e10-yimiaoban": ["易秒办", "即时通讯", "聊天", "单聊消息", "群聊消息", "群消息", "发消息", "撤回", "置顶", "必达", "Ding", "建群", "拉群", "群成员", "踢人", "退群", "解散群", "群公告", "群主", "管理员", "会话列表", "最近会话", "系统消息", "聊天记录", "历史消息", "发送文件", "发送图片", "在线状态", "下载附件", "查看图片"]
 }

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`）未暴露，需单独授权处理。

package/skill-template/domains/meeting.md

@@ -0,0 +1,3 @@
+# 会议（meeting）业务域
+
+会议域覆盖 E10 标准版会议应用：环境模式探测、会议列表、会议室与占用视图、会议类型、冲突检测、预约会议（prepare/apply 确认链）、回执与签到查询。入口 `SKILL.md` 只做路由；具体命令、字段约束与失败处理拆到 `references/`（meeting-queries / meeting-create / meeting-receipts-signs）。关键安全边界：预约与回执更新是高风险写，必须走 prepare→用户确认→apply；冲突命中（含仅提醒）绝不提供"强制新建"选项；EB 版链路与工作流建会在 v1 未实现，见 manifest 的 withheldOperations。

package/skill-template/domains/plan.md

@@ -0,0 +1,17 @@
+本业务域用于 E10 计划报告管理，覆盖「汇总生成报告」与「查询/管理已有报告」两条链路。入口 `SKILL.md` 按 weaver 风格组织：CRITICAL 共享前置、意图判定 A/B、路由优先级、高优先级语义、写操作确认链、执行原则、失败处理和「不在范围」。具体用法拆到 `references/`：
+
+- `plan-overview-and-routing.md`：意图判定、版本路由与租户缓存、operation 总表、通用基础规则。
+- `plan-report-query.md`：报告详情、报告分页列表、报告评论及评论输出规则。
+- `plan-report-write.md`：新建/修改/发布/撤回的 `prepare -> apply` 写入协议与查重规则。
+- `plan-report-remind.md`：提交提醒的触发前提、默认文案与发送确认链。
+- `plan-collect-and-compose.md`：A 链路多模块采集作业链、唯一指定技能映射与内容输出规范。
+
+Agent 调优重点：
+
+- `weaver-work-cli plan schema` 是 operation 合约第一信息源。
+- 意图判定先于接口调用：命中查询类信号走 B 链路，禁止采集业务数据；判定为生成类走 A 链路，必须按作业链采集。
+- 报告接口链路由 CLI 判定并缓存（1 天），Agent 不选接口、不混用链路；采集阶段禁止调用报告侧接口。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段；需 CLI 自动补的字段（创建人、时间戳）不要手工传。
+- 人员 ID 只取 `id` / `employeeId`，禁止 `userId`；姓名先由 weaver-e10-hrm 解析。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用；`confirm=true` 必须由用户明确确认后传入。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。

package/skill-template/domains/qiyecheng.md

@@ -0,0 +1,17 @@
+本业务域用于 E10 齐业成费控中心（FNA）。入口 `SKILL.md` 沿用 weaver 风格：CRITICAL 共享前置、能力范围、路由优先级、逐 operation 命令表、执行原则、写操作失败决策树和“不在本 skill 范围”。具体用法拆到 `references/`：
+
+- `catalog.md`：接口目录与按模块路由（四大模块 11 接口 ↔ 13 operations），通用约定与写操作边界。
+- `budget.md`：预算查询（事前申请单预算详情、预算执行报表），含 `formDatas` 二层嵌套与金额列名口径。
+- `expense-center.md`：费用中心（报销金额 / 借款分段 / 预付核销），含日期口径差异、借款接口缺陷与空响应处理。
+- `loan-management.md`：借款管理（汇总/列表/提醒还款 prepare→apply 写链），含 menuCode 核对与回查策略。
+- `invoice-writeoff.md`：发票核销（金额 tab/列表/催票 prepare→apply 写链），含 invoiceStatus 枚举与回查策略。
+- `source-manifest.json`：源资料指纹与生成产物基线，供更新检测。
+
+Agent 调优重点：
+
+- `weaver-work-cli fna schema` 是 operation 合约第一信息源（inputSchema/required/withheldOperations）。
+- 业务输入只包含数字 ID 与业务字段，不含 Cookie、ETEAMSID、Token 等认证字段。
+- 借款费用中心接口只认数字 ID；`menuCode`/`permissionSetCode` 环境相关需与环境核对。
+- 提醒还款/催票必须走 `fna.*.prepare -> 用户明确确认 -> apply`，只接受 CLI 生成的 continuation，不手工构造。
+- 结果为 `partial/write_uncertain` 时停止并做一次只读回查，不自动重放写请求。
+- 借款金额查询已知只统计首条记录，对外汇报注明口径。