weaver-work-cli 0.1.25 → 0.1.26

package/skills/weaver-e10-archive-oa/references/source-manifest.json

@@ -0,0 +1,400 @@
+{
+  "schemaVersion": 2,
+  "module": "archive-oa",
+  "skill": "weaver-e10-archive-oa",
+  "generatedFrom": {
+    "sourceSkill": "weaver-e10-archive-oa",
+    "version": "1.0.0",
+    "path": "weaver-e10-archive-oa",
+    "kind": "workbuddy-documentation-pack"
+  },
+  "generatedAt": "2026-10-19T08:05:59Z",
+  "sourceSet": {
+    "aggregateSha256": "90d089fdb8206f7873acde633ee10ce17472803cebf1812124877334cb496be9",
+    "sourceRoots": [
+      "weaver-e10-archive-oa"
+    ],
+    "detectionStrength": "strong"
+  },
+  "generatedTargets": {
+    "cli": [
+      "src/shortcuts/archive-oa",
+      "src/shortcuts/index.ts"
+    ],
+    "skill": [
+      "skills/weaver-e10-archive-oa"
+    ],
+    "tests": [
+      "test/business/archive-oa-operations.test.ts"
+    ],
+    "docs": [
+      "docs/archive-oa.md",
+      "skill-template/domains/archive-oa.md"
+    ]
+  },
+  "sources": [
+    {
+      "path": "weaver-e10-archive-oa/SKILL.md",
+      "size": 16499,
+      "sha256": "c1aaf0ddfebb942bb82c58b8617500a6676d30700a72be0366b40dda26c1b139"
+    },
+    {
+      "path": "weaver-e10-archive-oa/agents/openai.yaml",
+      "size": 802,
+      "sha256": "63f270f016ca54465639bdefb22cd06d8cacbf905133fd3c3c51b2b9b0d179c2"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/catalog.md",
+      "size": 7551,
+      "sha256": "c53e5cc71248b79342aa7a4e9c3fbc9454bef34b162a78974ebbac5987b6dbd8"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/ebuilder-customapi-getArcIdByContractNo.md",
+      "size": 6528,
+      "sha256": "61a8cf78f4883755649693edfaf4583e345df2c913e103c62a35969495b5f2ca"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/qys-weaver-ebuilder-getListDatas-契约锁借阅车.md",
+      "size": 6182,
+      "sha256": "d989aba6d354dc32ee9dcb3f069ac01e14e65a02acff7c638ff86cc27adbee83"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/qys-weaver-ebuilder-getListDatas-契约锁合同查询.md",
+      "size": 12445,
+      "sha256": "15e98870aba3b0a4e9c41073c8c4a0cb91c34cf96ed9d70d382bdc6391defb4c"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/qys-weaver-ebuilder-runEsb-契约锁加入借阅车.md",
+      "size": 5536,
+      "sha256": "a4ec863798d3589b3bccd2f4de75eeff2895eb8a25b0595b3231a21c390e5109"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/qys-weaver-openserver-openesb-鍙戣捣鍊熼槄.md",
+      "size": 8898,
+      "sha256": "a5cd622704d0bb6bceade15a490c69538beda3322955e62341ce18cf21d0c9ef"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/weaver-ebuilder-getListDatas-合同查询.md",
+      "size": 20968,
+      "sha256": "87ce9609efe0b394050788b611c8d8521e99e750e2ce48f462749a5e43775dc4"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/weaver-ebuilder-getListDatas-合同借阅车.md",
+      "size": 7458,
+      "sha256": "ed70c2f381641867528202336baabade42a8035eb4813d769182030ed0283bb7"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/weaver-ebuilder-listFilter-showFilters-鍚堝悓鎼滅储鏉′欢.md",
+      "size": 5564,
+      "sha256": "2b6ee9528470808197fa6f825b5a571a92bbf8b74e1b15cdc92dc1cba0f405b1"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/weaver-ebuilder-runEsb-加入借阅车.md",
+      "size": 5199,
+      "sha256": "416854902f5142244733b150e1272b8413b25dfbabd1306f7262f8ae35fb1999"
+    },
+    {
+      "path": "weaver-e10-archive-oa/references/weaver-openserver-openesb-鍙戣捣鍊熼槄.md",
+      "size": 9280,
+      "sha256": "7bc8eb6a46ee1c41b935d35f985b337655505f97357d80679e9c31358e574f4b"
+    }
+  ],
+  "sourceChunks": [
+    {
+      "id": "archive.locate",
+      "mapsToOperations": [
+        "archive-oa.archive.locate"
+      ],
+      "sourceFiles": [
+        "weaver-e10-archive-oa/references/ebuilder-customapi-getArcIdByContractNo.md"
+      ]
+    },
+    {
+      "id": "borrow-car.add.qys",
+      "mapsToOperations": [
+        "archive-oa.qys.borrow-car.add.prepare",
+        "archive-oa.qys.borrow-car.add.apply"
+      ],
+      "sourceFiles": [
+        "weaver-e10-archive-oa/references/qys-weaver-ebuilder-runEsb-契约锁加入借阅车.md"
+      ]
+    },
+    {
+      "id": "borrow-car.add.weaver",
+      "mapsToOperations": [
+        "archive-oa.borrow-car.add.prepare",
+        "archive-oa.borrow-car.add.apply"
+      ],
+      "sourceFiles": [
+        "weaver-e10-archive-oa/references/weaver-ebuilder-runEsb-加入借阅车.md"
+      ]
+    },
+    {
+      "id": "borrow-car.list.weaver",
+      "mapsToOperations": [
+        "archive-oa.borrow-car.list"
+      ],
+      "sourceFiles": [
+        "weaver-e10-archive-oa/references/weaver-ebuilder-getListDatas-合同查询.md",
+        "weaver-e10-archive-oa/references/weaver-ebuilder-getListDatas-合同借阅车.md"
+      ]
+    },
+    {
+      "id": "contract.fields",
+      "mapsToOperations": [
+        "archive-oa.contract.fields"
+      ],
+      "sourceFiles": [
+        "weaver-e10-archive-oa/references/weaver-ebuilder-listFilter-showFilters-鍚堝悓鎼滅储鏉′欢.md"
+      ]
+    },
+    {
+      "id": "contract.list.weaver",
+      "mapsToOperations": [
+        "archive-oa.contract.list"
+      ],
+      "sourceFiles": []
+    },
+    {
+      "id": "qys.borrow-car.list",
+      "mapsToOperations": [
+        "archive-oa.qys.borrow-car.list"
+      ],
+      "sourceFiles": [
+        "weaver-e10-archive-oa/references/qys-weaver-ebuilder-getListDatas-契约锁借阅车.md",
+        "weaver-e10-archive-oa/references/qys-weaver-ebuilder-getListDatas-契约锁合同查询.md"
+      ]
+    },
+    {
+      "id": "qys.contract.list",
+      "mapsToOperations": [
+        "archive-oa.qys.contract.list"
+      ],
+      "sourceFiles": []
+    }
+  ],
+  "operationImpact": {
+    "archive-oa.archive.locate": {
+      "requiresConfirmationChain": false,
+      "references": [
+        "references/archive-locate.md"
+      ]
+    },
+    "archive-oa.contract.fields": {
+      "requiresConfirmationChain": false,
+      "references": [
+        "references/contract-search.md"
+      ]
+    },
+    "archive-oa.contract.list": {
+      "requiresConfirmationChain": false,
+      "references": [
+        "references/contract-search.md"
+      ]
+    },
+    "archive-oa.qys.contract.list": {
+      "requiresConfirmationChain": false,
+      "references": [
+        "references/qys-contract-search.md"
+      ]
+    },
+    "archive-oa.borrow-car.list": {
+      "requiresConfirmationChain": false,
+      "references": [
+        "references/borrow-car.md"
+      ]
+    },
+    "archive-oa.borrow-car.add.prepare": {
+      "requiresConfirmationChain": true,
+      "references": [
+        "references/borrow-car.md"
+      ]
+    },
+    "archive-oa.borrow-car.add.apply": {
+      "requiresConfirmationChain": true,
+      "references": [
+        "references/borrow-car.md"
+      ]
+    },
+    "archive-oa.qys.borrow-car.list": {
+      "requiresConfirmationChain": false,
+      "references": [
+        "references/borrow-car.md"
+      ]
+    },
+    "archive-oa.qys.borrow-car.add.prepare": {
+      "requiresConfirmationChain": true,
+      "references": [
+        "references/borrow-car.md"
+      ]
+    },
+    "archive-oa.qys.borrow-car.add.apply": {
+      "requiresConfirmationChain": true,
+      "references": [
+        "references/borrow-car.md"
+      ]
+    }
+  },
+  "artifactBaseline": {
+    "aggregateSha256": "d4d6cb77d029f442dc15d93e1ed7355ceccade69a4291037baaa3c64393f620d",
+    "files": [
+      {
+        "path": "docs/archive-oa.md",
+        "size": 4469,
+        "sha256": "c77dbb289d87900278c4c0ef0b06caa2660080172fcc3a5d6fec02d399748ff6"
+      },
+      {
+        "path": "skill-template/domains/archive-oa.md",
+        "size": 2524,
+        "sha256": "9c89963b015acbebe3f97a98f1703445b69f603c32ed60f99a9ea55733a25de7"
+      },
+      {
+        "path": "skills/weaver-e10-archive-oa/SKILL.md",
+        "size": 13962,
+        "sha256": "a21714898b5f96aac32ec25bea7470069a2e5c572451e868f7112be31da86df0"
+      },
+      {
+        "path": "skills/weaver-e10-archive-oa/references/archive-locate.md",
+        "size": 2159,
+        "sha256": "6f7c60be69374b9b6401b3eac40ae52b306d6971a5e107f244c976bd38889ca1"
+      },
+      {
+        "path": "skills/weaver-e10-archive-oa/references/borrow-car.md",
+        "size": 4878,
+        "sha256": "b264c7a079af5bd79ded945809edc3610f5fa4c31e70ba87cc11d923095df5a5"
+      },
+      {
+        "path": "skills/weaver-e10-archive-oa/references/borrow-flow.md",
+        "size": 3099,
+        "sha256": "d52c1e63c5e199fe10b3935694b202541dd3431dcaf4b174c926c9508c4d3eee"
+      },
+      {
+        "path": "skills/weaver-e10-archive-oa/references/contract-search.md",
+        "size": 4258,
+        "sha256": "4c65a5439242bfcb3b77f8462113457752fe2f70740d1cd074ea969ba91851a5"
+      },
+      {
+        "path": "skills/weaver-e10-archive-oa/references/disabled-capabilities.md",
+        "size": 1795,
+        "sha256": "7e4a13dd113c546c5f93dd316b11dc4e4fccc432225d7f6964c9e7a9f3e65add"
+      },
+      {
+        "path": "skills/weaver-e10-archive-oa/references/qys-contract-search.md",
+        "size": 2743,
+        "sha256": "dc62dd9f1bd55af2cc7000700c938ec5993276e45651bedce95f5584901acf9f"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/constants.ts",
+        "size": 3342,
+        "sha256": "3a8d05cc2f22a9c0626ba2f752ee2faf3e860abd44618c10adb6383bce43214f"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/continuation.ts",
+        "size": 3290,
+        "sha256": "e374b16dae04b3b7faa9c347f8a55086a5e29383fefd8b669713e5c8ba547f5b"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/errors.ts",
+        "size": 2306,
+        "sha256": "9cdb07ce9a0ab7370188268dfaf3391d9c864187dbce21e5dba9f1b1e747ce41"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/host.ts",
+        "size": 7950,
+        "sha256": "bbecdd1dc5d5bee66dd7d38bd2bad16261ce1a7fb8bce595842873c1dc17c039"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/index.ts",
+        "size": 10493,
+        "sha256": "f19278f78f0f6340b8bda0686cddc80f50d91bc43d1a3f4637f2c05dbe66e4a0"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/manifest.ts",
+        "size": 3500,
+        "sha256": "0b234ade625862fa81fcde443ecac2b90d16586aed8a855deb3bd812faf0a670"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations.ts",
+        "size": 1200,
+        "sha256": "a3a30bb9af006f35f6eff00043d5f99ebfa70c7be0cc49c94dcceb4d6b8f6660"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/borrow-car.ts",
+        "size": 7615,
+        "sha256": "6d086fada117a76fc0cb0b634a74e061903d08ae2fd98e8782a4cd31889b11ae"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/borrow-url.ts",
+        "size": 5350,
+        "sha256": "df98d40a1c64982df29a9502d5b6049a1cbaa8a752263cc4d02c078b4bb4a0eb"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/confirm.ts",
+        "size": 2822,
+        "sha256": "b2224fdcfbf168aa78f7477f7ad1b1214f22fffaab4a2526d39d1f2ad5c11bc7"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/contract.ts",
+        "size": 5591,
+        "sha256": "f97cfd955d7f7931ff66bc7bed3c735c84689b079b4d44b81a2bf08e12c3fc1b"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/locate.ts",
+        "size": 2332,
+        "sha256": "35e3bbbe7dcfe94a1821a1118459c86b160b2654e8259f7993f7424465f8c2ab"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/registry.ts",
+        "size": 1942,
+        "sha256": "d9d0b7d118b6601830adde135d589611d433e54953cf7ed626de894f604344ad"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/shared.ts",
+        "size": 8163,
+        "sha256": "999e9de1f182c05fa7dfe13ad061fb796a019521978314c1db235cd53ab76aeb"
+      },
+      {
+        "path": "src/shortcuts/archive-oa/operations/types.ts",
+        "size": 3210,
+        "sha256": "6552cc083a27a93e080db08470a2153ec9866eee6c50a2ba4fe4d4217c48a286"
+      },
+      {
+        "path": "test/business/archive-oa-operations.test.ts",
+        "size": 15876,
+        "sha256": "9a31824c094bc7f8dcb872d4f964fc619f960e3c8d31965a2e0a000dc54056d9"
+      }
+    ]
+  },
+  "notes": [
+    "源资料 weaver-e10-archive-oa 1.0.0 收录档案定位、泛微商务合同与契约锁协作采纳的查询/加入借阅车/发起借阅链路。",
+    "泛微商务合同与契约锁是两套独立应用，passid/listId/esbActionIds/objId 与流程页 fb 均不同，禁止交叉混用。",
+    "档案操作/利用记录接口未收录，归入 disabled；契约锁搜索字段 showFilters 未收录。",
+    "发起借阅（泛微 fb=0 / 契约锁 fb=1）的 OpenESB webhook 实现已从 CLI 下线：交互流程不暴露后台凭据，改由用户浏览器登录后自行发起与提交。"
+  ],
+  "withheldOperations": [
+    {
+      "name": "archive-oa.archive.usage-log",
+      "reason": "档案操作/利用记录接口源资料未收录"
+    },
+    {
+      "name": "archive-oa.qys.contract.fields",
+      "reason": "契约锁协作采纳的搜索字段 showFilters 接口源资料未收录"
+    },
+    {
+      "name": "archive-oa.borrow.start.prepare",
+      "reason": "发起借阅改由用户在浏览器登录后于界面自己完成，CLI 不提供 OpenESB 触发能力"
+    },
+    {
+      "name": "archive-oa.borrow.start.apply",
+      "reason": "同上：发起借阅不在 CLI operation 范围内"
+    },
+    {
+      "name": "archive-oa.qys.borrow.start.prepare",
+      "reason": "契约锁发起借阅同样由用户在浏览器界面自己完成"
+    },
+    {
+      "name": "archive-oa.qys.borrow.start.apply",
+      "reason": "同上：契约锁发起借阅不在 CLI operation 范围内"
+    }
+  ]
+}

package/skills/weaver-e10-builder/SKILL.md

@@ -13,6 +13,25 @@ auto: true
 
 # Ebuilder 智能搭建 Skill
 
+## 使用前检查（必须先做，任一项不通过就停下处理，不要继续）
+
+**① 是否安装** —— 运行 `e10-cli --version`
+
+- 报 `command not found`（Windows：`'e10-cli' 不是内部或外部命令`）⇒ **未安装**，执行：
+
+  ```shell
+  npm install -g weaver-e10-builder
+  ```
+
+  装完重新运行 `e10-cli --version` 确认；若仍失败，把完整报错原样交给用户，**不要继续执行后续命令**。
+
+**② 版本是否匹配** —— 本 skill 要求 `e10-cli` 为 **`1.5.11`**
+
+- `e10-cli --version` **低于 `1.5.11`** ⇒ 按下方「安装与升级」升级 CLI，升完重新确认
+- `e10-cli --version` **高于 `1.5.11`** ⇒ 本 skill 文档已滞后于本机 CLI，提示用户升级本 skill；**不要用旧文档去驱动新 CLI**
+
+两项都通过后，才执行 `e10-cli` 的业务命令。
+
 ## 安装与升级
 
 本 skill 需与 CLI **版本匹配**（当前对应 CLI `1.5.11`）。版本不一致时命令/文档/选项可能对不上——升级前先对齐：
@@ -88,6 +107,9 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 
 ```
 0. 远程操作前确认环境
+   ⚠️ 首次使用先过上面的「使用前检查」：`e10-cli` 未安装就先 `npm install -g weaver-e10-builder`，版本须为 `1.5.11`，未通过不要执行任何 e10-cli 命令
+   ⚠️ 本机装有 `weaver-work-cli`（泛微连接器环境）时，执行 `weaver-work-cli --is-connector true auth whoami --json` 取出授权信息，再执行 `e10-cli auth set --eteamsid "<eteamsId>" --base-url "<baseUrl>"` 设置授权（**不要让用户去浏览器 DevTools 抄 ETEAMSID**）；本机没有 `weaver-work-cli` 时才用下面的方式
+      - ⚠️ `whoami --json` 里的 `eteamsId` / `cookie` 是凭据，解析后直接传参、**不要回显到对话**；`auth set` 会切 e10-cli 活跃 profile（先 `e10-cli auth profile current` 记住原值，之后 `auth profile use <原值>` 切回，并一律用 `--profile <该 profile>` 调用）
    a. 仅在即将执行远程查询或写入前运行 `e10-cli auth status`；纯文档、代码、日志分析及本地 CLI 修改不鉴权
    b. 同一连续执行阶段已确认当前环境时不重复检查；切换系统地址、profile 或凭证后必须重新确认
    c. 需要读取配套文档但 skill 目录内不存在 `references/` 时，执行 `e10-cli skill sync`

package/skills/weaver-e10-caizhilian/SKILL.md

@@ -5,7 +5,7 @@ display_name_en: Weaver E10 Document Management
 description: "泛微E10采知连知识管理系统Skill，包含多个功能模块，覆盖文档创建/搜索/编辑/比对、附件管理、文件夹操作、参与人与标签管理、文档共享与权限设置、文件存储/备份/加解密/附件设置、FTP/SFTP文件采集、本地文件上传。"
 description_zh: "泛微E10采知连知识管理系统Skill，包含多个功能模块，覆盖文档创建/搜索/编辑/比对、附件管理、文件夹操作、参与人与标签管理、文档共享与权限设置、文件存储/备份/加解密/附件设置、FTP/SFTP文件采集、本地文件上传。"
 description_en: "Weaver E10 document management Skill with multiple functional modules covering document CRUD, attachments, folders, sharing, permissions, file settings, FTP/SFTP collection, and file upload."
-version: 1.1.33
+version: 1.1.34
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -13,14 +13,29 @@ requires:
 cliHelp: "weaver-work-cli caizhilian --help"
 ---
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须调用宿主提供的提问/确认弹框，向用户说明必须补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行）及补齐计划，并把下面两条待执行命令原样完整展示在确认信息中；Agent 不能在未确认时自行安装。用户明确确认后，Agent 必须直接代为按顺序执行且每条仅执行一次，不得要求或引导用户手动执行：① 缺 CLI 时执行 `npm install -g weaver-work-cli`；② 再执行 `weaver-work-cli skills install shared --target-dir <SKILLS_ROOT>` 装回共享 skill，`<SKILLS_ROOT>` 取本 SKILL.md 所在目录的上一级绝对目录（即与本技能同级的 skills 根目录），不要省略 `--target-dir`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
-**`--is-connector` 判据**：用户明确使用连接器、或上下文要求用连接器完成任务 → 传 `true`；本次任务或上下文直接选择单独技能 → 不传；用户没有明确说明时，按**正在运行的这份 Skill 是哪一级**定——**用户级（条目标 `(user)`）不传，连接器级（标 `(connector)`）传**（同名 Skill 只会运行用户级那一份）。传 `true` 时不要再写 `--profile` / `--base-url`。完整规则见 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)。
-
-认证与登录态只能按共享规则通过 `weaver-work-cli auth ...` 判断：本 Skill 不自行发起 HTTP 请求，请求头凭证由 CLI 统一注入，Agent 不手写、不索取、不转存，也不得直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。业务入参里出现认证字段会被 CLI 拒绝或剥离。请求头三件套由 CLI 统一注入、缺一不可：Cookie: <完整原始 Cookie 串>（禁止裁剪/去重/改写）、eteamsid: <ETEAMSID>、User-Agent: AgentType=<agentType>,IsAgent=true。完整契约见共享规则「请求头契约」章节。
-
-所有命令通过 `weaver-work-cli --json caizhilian run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。**不要写内联脚本包装调用**——自写脚本在中文与 Windows 环境下容易出现编码、转义问题，且脚本报错时无法判断调用是否已生效，容易导致误判或重复提交。调用前先按需读取 references 下对应的文件查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli caizhilian schema` 是 operation、字段和风险等级的合约来源，`weaver-work-cli caizhilian operations` 是按资源分组的能力目录（含 `withheldOperations`）。
-
-命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、文件上传下载、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
+**CRITICAL — 开始前先读共享规则**：同级目录存在 `weaver-e10-shared` 技能时，MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)（安装、E10 认证、JSON 输出和高风险写入规则）。
+若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须调用宿主提供的提问/确认弹框，向用户说明必须补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行）及补齐计划，并把下面两条待执行命令原样完整展示在确认信息中；Agent 不能在未确认时自行安装。
+用户明确确认后，Agent 必须直接代为按顺序执行且每条仅执行一次，不得要求或引导用户手动执行：① 缺 CLI 时执行 `npm install -g weaver-work-cli`；② 再执行 `weaver-work-cli skills install shared --target-dir <SKILLS_ROOT>` 装回共享 skill，
+`<SKILLS_ROOT>` 取本 SKILL.md 所在目录的上一级绝对目录（即与本技能同级的 skills 根目录），不要省略 `--target-dir`——省略会装进默认目录，
+导致本技能依然读不到共享规则。
+命令均成功后重新读取共享规则；若环境中确实无法补齐共享规则，按本文内置的最小认证指引继续：用 `weaver-work-cli auth status` 查登录态，未登录或失效时请用户提供 E10 登录域名，再执行 `weaver-work-cli auth login --base-url <域名>`，并在结果中告知用户共享规则缺失。
+**`--is-connector` 判据**：用户明确使用连接器、或上下文要求用连接器完成任务 → 传 `true`；本次任务或上下文直接选择单独技能 → 不传；用户没有明确说明时，按**正在运行的这份 Skill 是哪一级**定——**用户级（条目标 `(user)`）不传，连接器级（标 `(connector)`）传**（同名 Skill 只会运行用户级那一份）。
+传 `true` 时不要再写 `--profile` / `--base-url`。
+完整规则见同级 `weaver-e10-shared` 技能的共享规则。
+
+认证与登录态只能按共享规则通过 `weaver-work-cli auth ...` 判断：本 Skill 不自行发起 HTTP 请求，请求头凭证由 CLI 统一注入，Agent 不手写、不索取、不转存，也不得直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。业务入参里出现认证字段会被 CLI 拒绝或剥离。
+请求头三件套由 CLI 统一注入、缺一不可：Cookie: <完整原始 Cookie 串>（禁止裁剪/去重/改写）、eteamsid: <ETEAMSID>、
+User-Agent: AgentType=<agentType>,IsAgent=true。
+完整契约见共享规则「请求头契约」章节。
+
+所有命令通过 `weaver-work-cli --json caizhilian run <operation>` 执行：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。
+**不要写内联脚本包装调用**——自写脚本在中文与 Windows 环境下容易出现编码、转义问题，且脚本报错时无法判断调用是否已生效，
+容易导致误判或重复提交。
+调用前先按需读取 references 下对应的文件查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli caizhilian schema` 是 operation、字段和风险等级的合约来源，`weaver-work-cli caizhilian operations` 是按资源分组的能力目录（含 `withheldOperations`）。
+
+命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、文件上传下载、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。
+Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、
+`rm/ls/diff/python3` 等 Unix-only 写法。
 
 涉及附件、封面图片、正文文件、本地文件上传或下载落盘的操作，执行前必须提醒用户：文件内容可能被上传到 E10 采知连文档中心或文件服务器、下载内容会写入本地磁盘，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
 
@@ -82,7 +97,8 @@ cliHelp: "weaver-work-cli caizhilian --help"
 - 改文档：`caizhilian.document.get` 取现状 -> `caizhilian.document.update-*.prepare` -> 用户确认 -> `.apply` -> 必要时 `.get` 复核
 - 共享给某人：`caizhilian.org.search-user`（或 department/subcompany/...）取 `id` -> `caizhilian.share.form` 取 `obj_types[].id` 与 `share_level` 合法值 -> `caizhilian.share.add.prepare` -> 用户确认 -> `.apply`
 - 文件夹权限：`caizhilian.folder.permission.form` 取级联参数 -> `caizhilian.folder.permission.list` 看现状 -> `.add` / `.delete` / `.set-auth` 的 prepare -> 用户确认 -> `.apply`
-- 附件：`caizhilian.document.get` 或 `caizhilian.compare.list-file-objects` 取 `attachment_id` -> `caizhilian.attachment.upload｜replace.prepare` -> 用户确认 -> `.apply`；下载用 `caizhilian.attachment.download`（需要 PDF 版用 `.download-as-pdf`）
+- 附件：`caizhilian.document.get` 或 `caizhilian.compare.list-file-objects` 取 `attachment_id` -> `caizhilian.attachment.upload｜replace.prepare` -> 用户确认 -> `.apply`；
+  下载用 `caizhilian.attachment.download`（需要 PDF 版用 `.download-as-pdf`）
 - 附件历史版本：`caizhilian.attachment.list-versions` 直接按 `attachment_id` 查询（`doc_id` 可选）
 - 查流程附件上传目录：用户只给流程名称时先 `caizhilian.setting-attach.search-workflows` 拿流程 ID，再 `caizhilian.setting-attach.list-upload-folders` 查目录
 - 文档比对：`caizhilian.compare.search-documents` / `.list-file-objects`（本地文件用 `.upload-file`）取左右 `file_id` -> `caizhilian.compare.submit.prepare` -> 用户确认 -> `.apply` -> 把 `compare_link` 交给用户
@@ -119,7 +135,9 @@ cliHelp: "weaver-work-cli caizhilian --help"
 - 失败后先看进程退出码、`error.type`、`error.subtype` 和 `error.message`。
 - **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个 operation。**
 - 写请求已经发出后遇到结果不确定必须停止；不要把 `.apply` 当成可重试的读操作。
-- **错误为 `authentication` 或 `session_expired` 时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试。** 先读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`，按其中流程让用户输入 E10 登录域名或选择已有 profile，完成登录后再从 `prepare` 重新开始。
+- **错误为 `authentication` 或 `session_expired` 时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试。** 先按共享规则的认证流程处理（同级 `weaver-e10-shared` 技能）：让用户输入 E10 登录域名或选择已有 profile，完成登录后再从 `prepare` 重新开始；共享规则不可用时，
+  直接请用户提供 E10 登录域名，
+  用 `weaver-work-cli auth login --base-url <域名>` 完成登录。
 - `continuation_*` / `plan_changed` / `file_changed` 一律重新 prepare，不要试图修改票据或只改 apply 入参。
 - **明确的业务错误直接转达，不要深挖**：服务端返回的业务提示（如「该附件不支持转为 PDF」「无该文档的共享权限」）是权威结论，直接转述给用户并给出应对建议；不要翻查源码、写调试脚本或追查原始响应找「为什么」。只有错误提示本身含糊（空 message、`INTERNAL_ERROR`）时才进一步诊断。
 - **不要编造失败原因**：不了解真实原因时，直接说明并请用户联系文档负责人或管理员确认；禁止推测平台行为、杜撰因果关系（如「加了附件后权限会变」），也不要替用户断言其本地环境或文件状态。转达时用用户能理解的自然语言，不要把技术字段名、状态码原样抛给用户。
@@ -127,7 +145,9 @@ cliHelp: "weaver-work-cli caizhilian --help"
 
 ### 5) 附件、图片和文件解析确认
 
-- 执行 `caizhilian.attachment.upload｜replace`、`caizhilian.attachment.download｜download-as-pdf`、`caizhilian.cover.upload｜set`、`caizhilian.compare.upload-file`、`caizhilian.document.create-office｜create-by-upload｜replace-content`，或任何会读取本地文件、上传文件内容、下载落盘、解析图片/PDF/Office 的步骤前，必须先提醒用户：文件内容可能进入大模型上下文，也可能发送到 E10 采知连文档中心或文件服务器，或写入本地磁盘。
+- 执行 `caizhilian.attachment.upload｜replace`、`caizhilian.attachment.download｜download-as-pdf`、`caizhilian.cover.upload｜set`、`caizhilian.compare.upload-file`、
+  `caizhilian.document.create-office｜create-by-upload｜replace-content`，或任何会读取本地文件、上传文件内容、下载落盘、解析图片/PDF/Office 的步骤前，必须先提醒用户：文件内容可能进入大模型上下文，也可能发送到 E10 采知连文档中心或文件服务器，
+  或写入本地磁盘。
 - 用户未明确确认前，不要运行上传、下载或解析命令；确认摘要必须包含文件路径、文件名与大小。
 - 下载只在用户指定路径写入，同名文件按 `名称(1).扩展名` 自动改名，不覆盖已有文件。
 
@@ -180,7 +200,8 @@ cliHelp: "weaver-work-cli caizhilian --help"
    - 多步写入（`cover.set` = 上传 + 改字段，`document.replace-content` = 上传 + 替换 + 通知，`document.create-by-upload` = 批量上传）可能只完成了前几步；
    - 批量类操作可能部分成功，`data.summary` 与 `warnings` 里已有成功/失败计数；
    - continuation、目标对象、本地文件或登录上下文可能已经变化。
-3. 如需确认，只补 **一次** 只读查询（`document.search` / `document.get` / `folder.query-by-name` / `permission.list` / `tag.list` / `participant.list` / `share.list` / `compare.list-file-objects`），不要陷入 query/write 循环。
+3. 如需确认，只补 **一次** 只读查询（`document.search` / `document.get` / `folder.query-by-name` / `permission.list` / `tag.list` / `participant.list` / `share.list` / `compare.list-file-objects`），
+  不要陷入 query/write 循环。
 4. 最终给用户明确结论、已知状态、成功/失败项和下一步人工确认建议；未生效且需要重做时，从 `prepare` 重新开始并再次取得确认。
 
 **特别注意：** 附件上传与文档创建最容易因重复提交造成重复入库，更要严格执行上述规则。
@@ -221,7 +242,8 @@ weaver-work-cli --json caizhilian run caizhilian.attachment.download --input-jso
 - 禁止 curl、fetch、浏览器自动化或直接访问 E10 `/api/doc/**`、`/api/file/**`、`/api/hrm/**`、`/api/crm/**`。
 - 禁止读取或复制 CLI runtime 内部 Token、Cookie、ETEAMSID。
 - 禁止读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
-- 环境列表、配置快照、配置重载、环境切换（源 `list_systems` / `get_loaded_config` / `reload_config` / `switch_config`）不在本模块，改用 `weaver-work-cli config ...` 与 `weaver-work-cli e10 auth ...`，详见 [`withheld.md`](references/withheld.md)。
-- 源 Skill 目录内的系统设置（备份/加密/附件全局设置/存储）、文件收集、文件上传等模块已纳入本 CLI。
+- 环境列表、配置快照、配置重载、环境切换不在本模块（属 withheld 能力），改用 `weaver-work-cli config ...` 与 `weaver-work-cli e10 auth ...`，
+  详见 [`withheld.md`](references/withheld.md)。
+- 系统设置（备份/加密/附件全局设置/存储）、文件收集、文件上传等模块已纳入本 CLI。
 - 文档版本回滚、文档审批流转、全文检索高级语法、回收站还原等能力当前未纳入 CLI manifest，需要在 E10 页面操作。
 - 非文档中心类 E10 能力（流程、人事、财务、邮件、会议等）不由本 Skill 承载。

package/skills/weaver-e10-caizhilian/references/agent-entry.md

@@ -13,7 +13,8 @@
 - 简单 JSON 优先 `--input-json '<json>'`；多行或含中文引号的复杂 JSON 先写成 UTF-8 文件再 `--input <path>`；只有确认当前 shell 管道稳定时才用 `--input -`。
 - `--input` 与 `--input-json` 不能同时传，否则 `validation/input_conflict`。
 - 字段名必须与 `caizhilian schema` 完全一致：多传字段报 `validation/unknown_field`，入参不是对象报 `validation/input_not_object`，出现 `__proto__` / `constructor` / `prototype` 报 `validation/forbidden_key`。
-- ID 类字段（`doc_id`、`folder_id`、`user_id` 等）统一是纯数字字符串，**一律用字符串传**（如 `"5818986505368959471"`）：19 位 ID 写成 JSON 数字会在解析阶段被截断，查不到却看不出原因；超出安全整数范围的数字入参直接报 `validation/number_out_of_range`。不是数字报 `validation/id_invalid`。
+- ID 类字段（`doc_id`、`folder_id`、`user_id` 等）统一是纯数字字符串，**一律用字符串传**（如 `"5818986505368959471"`）：19 位 ID 写成 JSON 数字会在解析阶段被截断，查不到却看不出原因；超出安全整数范围的数字入参直接报 `validation/number_out_of_range`。
+  不是数字报 `validation/id_invalid`。
 - 分页统一 `page_no`（1 起）+ `page_size`；`<=0` 报 `validation/number_invalid`。返回的 `has_next` 按「本页条数 >= page_size」判定，不要依赖 `total`。
 - 业务入参禁止携带 Cookie、ETEAMSID、Token、Authorization 或任何内部控制字段；认证只通过 `weaver-work-cli auth ...`，CLI 运行时会剥离保留请求头。
 - 写操作 `.apply` 额外必须传 `confirm: true`（CLI 用 `--yes`）与 `continuation`（CLI 用 `--continuation <token>`）。
@@ -73,7 +74,10 @@ weaver-work-cli --json caizhilian run caizhilian.document.search --input ./searc
 ```
 
 - `data` 是业务结果；`meta` 只在有上下文时出现（例如 prepare 的 `status: "PREPARED"`、下载的 `doc_id` / `attachment_id`、`health` 的 `profile` / `tenantKey`）。
-- `caizhilian health`（`caizhilian.system.health`）返回 `{ environment, healthy, base_url, url, status_code, business_code, diagnosis, elapsed_ms, message? }`：`healthy=false` 时按 `diagnosis` 定位原因（`network_error` / `http_error` / `http_status_mismatch` / `business_code_mismatch` / `request_failed`，多项用逗号连接），`ok` 表示各项正常；未登录时改为报 `authentication/session_unavailable`，先按共享规则完成登录。
+- `caizhilian health`（`caizhilian.system.health`）返回 `{ environment, healthy, base_url, url, status_code, business_code, diagnosis, elapsed_ms, message? }`：
+  `healthy=false` 时按 `diagnosis` 定位原因（`network_error` / `http_error` / `http_status_mismatch` / `business_code_mismatch` / `request_failed`，多项用逗号连接），
+  `ok` 表示各项正常；
+  未登录时改为报 `authentication/session_unavailable`，先按共享规则完成登录。
 - `warnings` 是非阻断提醒（共享兜底被覆盖、只读回查发现差异、批量上传部分失败等），必须原样转述给用户，不要静默丢弃。
 - 当前输出层只有完整 JSON，没有 `--jq` / `--format table` / `--page-all`。回复时不要原样贴完整 JSON：先摘要关键字段与条数，列表默认小页（`page_size=10`），需要完整内容时落本地文件再给路径。
 
@@ -103,4 +107,4 @@ weaver-work-cli --json caizhilian run caizhilian.document.search --input ./searc
 | `api/http_error` | HTTP 非 2xx | 把 `code` 与 message 交给用户，写操作不要重复提交 |
 | `api/business_error` | 业务失败（code != 200） | 原样转述服务端 message，判断是否需要换参数 |
 | `confirmation/required` | apply 缺 `confirm` | 先向用户摘要并确认，再加 `--yes` |
-| `partial/write_uncertain` | 写结果不确定 | 立即停止，最多补一次只读回查，禁止自动重放 |
+| `partial/write_uncertain` | 写结果不确定 | 立即停止，最多补一次只读回查，禁止自动重放 |

package/skills/weaver-e10-caizhilian/references/collaboration.md

@@ -78,11 +78,13 @@ weaver-work-cli --json caizhilian run caizhilian.share.add.prepare --input-json
 
 - `tag.search` / `tag.list` 返回归一后的 `{ id, name, privacy }`，回复时只展示标签名，`id` 留给后续 `tag.add` / `tag.remove`。
 - `tag.add.apply` / `tag.remove.apply` 返回 `{ doc_id, tag_ids, count }`；标签是**批量两次请求**（公共组 + 个人组），部分组失败会抛错，此时不要自动重放，先用 `tag.list` 回查实际结果。
-- `participant.list` 返回 `{ participants[] }`，每项含 `share_entry_id`、`user_id`、`user_name`、`can_delete`；`participant.add.apply` 返回 `{ share_entry_id, doc_id, user_id, user_name }`，`participant.remove.apply` 返回 `{ share_entry_id, doc_id }`。
+- `participant.list` 返回 `{ participants[] }`，每项含 `share_entry_id`、`user_id`、`user_name`、`can_delete`；`participant.add.apply` 返回 `{ share_entry_id, doc_id, user_id, user_name }`，
+  `participant.remove.apply` 返回 `{ share_entry_id, doc_id }`。
 - `share.list` → `{ add_visible, shares[] }`，条目含 `id`、`object_type`、`object_name`、`share_level`、`sec_level`、`download`、`can_delete`；`share.delete.apply` 返回 `{ deleted: true, shares[] }`。
 - `share.form` → `{ obj_types[], param_options }`，`obj_types[].id` 是 `obj_type` 的合法取值。
 - `participant.list` / `share.list` 默认用 Markdown 表格摘要（姓名/类型/是否可下载/是否可删除），条目 ID 只作为入参。
-- `share.add.apply` 有两种成功形态：`{ added: true, shares: [...] }`（新增成功并回读列表）与 `{ added: false, message: "..." }`（服务端判定「已存在」，源用 `code=500 + status=true` 表达）。`added:false` 不是失败，必须把 message 转述给用户；其他业务失败会抛 `api/business_error`。
+- `share.add.apply` 有两种成功形态：`{ added: true, shares: [...] }`（新增成功并回读列表）与 `{ added: false, message: "..." }`（服务端判定「已存在」，源用 `code=500 + status=true` 表达）。`added:false` 不是失败，必须把 message 转述给用户；
+  其他业务失败会抛 `api/business_error`。
 - `share.add.apply` 成功后回读共享列表失败时仍算成功，只是 `shares` 为空数组——这种情况要提示用户稍后自行复核。
 - 所有 prepare 返回 `continuation` + `expires_in_ms` + `hint`，`meta.status = "PREPARED"`。
 
@@ -109,4 +111,4 @@ weaver-work-cli --json caizhilian run caizhilian.share.add.prepare --input-json
 | `empty_response` / `response_shape` | 服务端返回结构与预期不符 | 停止，把原始 message 交给用户，不要重放写请求 |
 | `plan_changed` | prepare 与 apply 之间请求体指纹变化（表单级联或共享条目已变） | 重新 prepare |
 | `continuation_*` | 票据缺失/过期/串用/入参漂移 | 见 `write-protocol.md` |
-| `partial/write_uncertain` | 写结果不确定 | 立即停止，最多补一次 `tag.list` / `participant.list` / `share.list` 只读回查 |
+| `partial/write_uncertain` | 写结果不确定 | 立即停止，最多补一次 `tag.list` / `participant.list` / `share.list` 只读回查 |