weaver-work-cli 0.1.39 → 0.1.42

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

@@ -13,10 +13,10 @@ requires:
 cliHelp: "weaver-work-cli invoice --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`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
+**CRITICAL — 开始前 MUST 直接执行本技能的业务命令（`weaver-work-cli --json invoice run ...`）；不要预先读取共享规则，也不要先跑 `auth status`、`doctor --e10`、`auth xiaoe` 等登录或状态检查。** 小e（XiaoE）环境下登录由 CLI 自己在公共会话加载层完成：进程内存在任意 `XIAOE_*` 环境变量（宿主新增 `XIAOE_CLIENT_TYPE=client|cloud`，分别表示桌面客户端与网页端）时，缺少本地会话会自动换取登录信息并继续执行原请求，已有会话被拒绝为失效时静默恢复并原样重放 1 次，换票结果落盘供后续命令复用。Agent 不参与该过程，**也不得在思考过程或回复中描述登录、换票、重登、会话恢复等中间步骤**，只呈现业务结果。仅以下三种情形才读取 `[../weaver-e10-shared/SKILL.md](../weaver-e10-shared/SKILL.md)`：① 命令不可用（`command not found` / 退出码 127），或返回 `authentication` / `session_expired` 且 CLI 自动恢复后仍失败、`subtype=xiaoe_credential_unavailable`；② 即将执行写入/删除/导入类操作（确认、continuation 与回查协议）；③ 需要判定是否传 `--is-connector`。若共享规则不存在、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 ...` 命令判断；禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
+登录与会话由 CLI 托管，Agent 不做登录前置；只有本文件 CRITICAL 列出的三种情形才按共享规则使用 `weaver-work-cli auth ...` 命令体系判断登录态。禁止直接读取、列出、打印或解析用户主目录下的旧 `.e10-cli`、auth、config 或 Keychain 数据。
 所有命令通过 `weaver-work-cli --json invoice run <operation>` 执行（唯一例外：报销单与开票流程的创建/修改调用 `weaver-e10-workflow` 技能的 `weaver-work-cli --json workflow run workflow.*`，见下方「报销填单」「AI 开票」）：简单 JSON 优先传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli invoice schema` 是 operation、字段和风险等级的合约来源。
 命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。
 涉及发票附件、图片、本地文件、远程 URL 文件或 OCR/文件解析的操作，执行前必须提醒用户：文件内容可能被上传到 E10 业票通、OCR/查验服务，并可能进入当前大模型上下文用于理解和处理；必须等待用户明确确认后才继续。
@@ -27,7 +27,7 @@ cliHelp: "weaver-work-cli invoice --help"
 
 本文件在技能加载时已整体注入上下文，**不要再用 Read 读本 SKILL.md**；仅需核对 `version` / `agent_created` 时读前 15 行，且**修改本包内文件不必先确认 `agent_created`**（此处已声明 `true`）。
 
-- **共享规则 `../weaver-e10-shared/SKILL.md` 同一会话只读一次**：内容已在本轮上下文时直接复用；仅新会话或内容明显过期时重读。
+- **共享规则 `../weaver-e10-shared/SKILL.md` 不是前置**：只有 CRITICAL 列出的三种情形才读，同一会话只读一次；内容已在本轮上下文时直接复用。
 - **只读命中路由的那个 reference**。reference 是参数与字段的第一信息源；reference 已覆盖的参数不要再跑 `--help`，`schema` 只用于确认 operation 清单与风险等级。
 - **单点查询压缩成三个动作**：读 1 个 reference → 1 条 CLI 命令 → 直接输出。已给出 `fid` / `number` 时禁止 `list → filter → get` 链路。
 - **同一字段不重复查**：一轮内已有新鲜结果就复用，不要为"再确认一次"重跑同一个只读 operation。
@@ -163,13 +163,12 @@ cliHelp: "weaver-work-cli invoice --help"
 - 失败后先看进程退出码、`error.type`、`error.subtype` 和 `error.message`
 - **除非错误明确提示可恢复或需要补充参数，否则不要重复刷同一个 operation**
 - 写请求已经发出后，遇到结果不确定必须停止；不要把 `.apply` 当成可重试读操作
-- **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：立即停止当前操作，不要用示例占位域名或自行猜域名登录，也不要盲目重试**。
-- 认证失败后先读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`：
-  - 已有 XiaoE 会话的 `session_expired` 已由 CLI 底层自动换票并重放一次；若错误最终仍返回，Agent 只反馈并停止，不执行任何登录命令、其他登录 Skill 或原业务命令。
-  - 仅首次无会话或明确的 `auth not found` 才由 Agent 复用任务开始时的宿主判定。
-  - 首次认证明确为 XiaoE 时，执行一次 `weaver-work-cli auth xiaoe`；返回 `authentication/xiaoe_credential_unavailable` 时停止，不回退浏览器登录。
-  - 首次认证且非 XiaoE 时不得执行 `auth xiaoe`；取得用户确认的真实 E10 登录域名后，执行 `weaver-work-cli auth login --base-url "<用户确认的 E10 登录域名>" --agent_type "<当前智能体名称>"`。环境不能完成本机浏览器回调时停止并反馈。
-  - 显式登录后读操作可重新执行；写操作不得复用旧 continuation，必须重新 prepare 并重新确认。已返回 `partial/write_uncertain` 时先只读回查，禁止直接重放写入。
+- **错误为 `authentication`（未登录，如 `E10 auth not found`）或 `session_expired`（登录态失效）时：不要盲目重试、不要换域名重试、不要用示例占位域名登录**。先判断 CLI 是否已经自动处理：
+  - **小e 环境（进程内存在任意 `XIAOE_*`，含 `XIAOE_CLIENT_TYPE=client|cloud`）**：登录缺失与过期都由 CLI 底层在公共请求层静默换取并原样重放 1 次，Agent 不执行任何登录命令——包括 `weaver-work-cli auth xiaoe`——也不重跑原业务命令，**也不在思考或回复里复述登录、换票、重登、会话恢复过程**。仍返回 `session_expired` 或 `authentication/xiaoe_credential_unavailable` 时，用一句话告知「小e 当前登录态不可用，请在小e 中重新登录后重试」并停止，不回退浏览器登录。
+  - **非小e 环境**才读取共享规则 `../weaver-e10-shared/references/e10-auth-and-session.md`，并按其中流程处理：
+    - 仅首次无会话或明确的 `auth not found`，才由 Agent 复用任务开始时的宿主判定。
+    - 首次认证且非 XiaoE 时不得执行 `auth xiaoe`；取得用户确认的真实 E10 登录域名后，执行 `weaver-work-cli auth login --base-url "<用户确认的 E10 登录域名>" --agent_type "<当前智能体名称>"`。环境不能完成本机浏览器回调时停止并反馈。
+- 显式登录后读操作可重新执行；写操作不得复用旧 continuation，必须重新 prepare 并重新确认。已返回 `partial/write_uncertain` 时先只读回查，禁止直接重放写入。
 - 登录类命令必须带 timeout 限时（上限 300 秒 / 5 分钟，后台运行 + 限时观察）：输出一旦出现 `Open browser login`、`Waiting for E10 authorization callback` 或 `Could not open browser automatically`，即判定已降级到浏览器 OAuth，立即终止该命令并反馈，不得继续等待。登录失败不自动重试。
 - 需要浏览器登录时必须携带发起方标识 `--agent_type "<当前智能体名称>"`（授权确认页展示用；宿主无法确认名称时才可省略，交由 CLI 从环境变量推断）。
 

package/skills/weaver-e10-yepiaotong/references/invoice-agent-entry.md

@@ -6,13 +6,16 @@
 
 ## 准备命令
 
+直接用一条不依赖登录态的只读命令确认可用：
+
 ```text
-weaver-work-cli --version
-weaver-work-cli doctor --e10
 weaver-work-cli invoice schema
 ```
 
-如未登录，按共享规则读取 `../../weaver-e10-shared/references/e10-auth-and-session.md` 后处理。
+- **小e 环境（进程内存在任意 `XIAOE_*`，含 `XIAOE_CLIENT_TYPE=client|cloud`）**：不要执行 `weaver-work-cli --version` 或 `doctor --e10`，版本更新与登录由小e 客户端和 CLI 会话层托管；业务命令缺少会话时会自动换取登录信息并继续执行，已有会话失效时静默恢复并重放 1 次。
+- **非小e 环境**首次使用才执行 `weaver-work-cli --version` 与 `doctor --e10`。
+
+仅在认证最终失败（`authentication` / `session_expired` / `xiaoe_credential_unavailable`）时，才按共享规则读取 `../../weaver-e10-shared/references/e10-auth-and-session.md`。
 
 ## 固定入口