weaver-work-cli 0.1.7 → 0.1.20

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

@@ -5,7 +5,7 @@ display_name_en: Weaver CLI Shared Rules
 description: weaver-work-cli 共享规则：安装检查、E10 认证、JSON 输出、高风险写入、安全边界和引用路由。
 description_zh: weaver-work-cli 共享规则：安装检查、E10 认证、JSON 输出、高风险写入、安全边界和引用路由。
 description_en: Shared rules for weaver-work-cli, including installation checks, E10 authentication, JSON output, high-risk writes, safety boundaries, and reference routing.
-version: 1.2.0
+version: 1.2.1
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -16,6 +16,23 @@ requires:
 
 所有 `weaver-e10-*` Skill 共享的底座：命令可用性、E10 认证、JSON 输出契约、大结果渲染与高风险操作。
 
+## 连接器模式：--is-connector
+
+同一条 `weaver-work-cli` 命令，认证来源由 `--is-connector true` 区分。**按下面的判据决定传不传，只判断一次，本任务内所有命令沿用同一写法：**
+
+| 本次任务的情形 | 是否传 `--is-connector true` |
+| --- | --- |
+| 用户明确使用连接器，或上下文中要求使用连接器完成任务 | **传** |
+| 本次任务或上下文中直接选择单独技能 | **不传** |
+| 用户没有明确说明 | **按正在运行的这份 Skill 是哪一级定**：用户级 → **不传**；连接器级 → **传** |
+
+- **怎么分辨级别**：技能条目标 `(user)`、从 `~/.workbuddy/skills/` 加载的就是**用户级**；标 `(connector)`、从连接器安装目录加载的就是**连接器级**。
+- 同名 Skill 只会运行**用户级**那一份（WorkBuddy 按 Skill 名去重、用户级优先），所以这种情况一律按用户级处理。
+- 用户级 → CLI 读取**本机活跃 profile**；连接器级 → CLI 读取**连接器托管的 eteams 认证与登录域名**。
+- 连接器级**不要再写 `--profile` / `--base-url`**：认证与域名由连接器托管，手工指定会与它冲突。
+- 漏传 `--is-connector` **不会报错**，但会退回本机活跃 profile，可能操作到与预期不同的租户。
+- **本套 Skill 里的命令示例一律省略 `--is-connector`**（示例只示意参数形态，不代表最终命令）：执行前必须先按上表判定，命中「传」的要在 `weaver-work-cli` 之后补上 `--is-connector true`，且**本任务内每条命令都要带**——包括记忆读取、记忆保存这类无入参的命令。
+
 ## 业务 Skill 安装前版本检查
 
 用户要求安装任一业务模块 Skill 时，必须先执行 `weaver-work-cli --version` 与 `npm view weaver-work-cli version` 比对本地版本和 npm 源版本。若本地版本低于 npm 源版本，先询问用户是否使用（推荐）最新版 `weaver-work-cli`；用户确认后先执行 `npm install -g weaver-work-cli` 更新 CLI，再继续安装业务模块 Skill。用户拒绝时，说明将沿用本地版本后再继续。
@@ -24,31 +41,23 @@ requires:
 
 如果当前运行在 XiaoE 宿主环境，或任务上下文/环境变量显示存在 `XIAOE_*` / `xiaoeUserData/tokens.py`，登录处理必须优先走 XiaoE 统一登录：
 
-### XiaoE Token 获取（顶层强规则）
-
-需要Token时执行：
-
-Windows PowerShell：
+### XiaoE 凭据由 CLI 独占处理（顶层强规则）
 
-```powershell
-python -c "import os,runpy;runpy.run_path(os.path.join(os.environ['LOCALAPPDATA'],'xiaoeUserData','tokens.py'),run_name='__main__')"
-```
-
-macOS/Linux（bash/zsh）：
+Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读取和消费**。Agent 禁止：
 
-```bash
-python3 -c "import os,runpy;runpy.run_path(os.path.join(os.path.expanduser('~'),'Library','Application Support','xiaoeUserData','tokens.py'),run_name='__main__')"
-```
+- 自行执行宿主 `xiaoeUserData/tokens.py`（或任何取 Token 的脚本）并把 stdout 读进上下文——stdout 含 ETEAMSID/Cookie/Token，会进入对话、日志与缓存；
+- 执行 `weaver-work-cli auth export-weaver-env` 并 `eval` / `Invoke-Expression` 到当前 shell，或把 `WEAVER_*` 值写进命令、日志、报告；
+- 要求用户粘贴、或在回复中展示、转述任何凭证。
 
-读取 stdout 作为结果，stdout 期望是 JSON 对象；失败时返回实际错误。典型结果包含 `eteamId`。Token、Cookie、ETEAMSID 和业务凭证不得要求用户粘贴，也不得在回复中展示。脚本不存在、Python 依赖缺失、stdout 非法、接口失败或进程非 0 时，停止当前手动取 Token 的流程并反馈实际错误，不猜测或伪造 Token；但如果只是通过 `weaver-work-cli auth xiaoe` 取登录态，CLI 自己会在脚本不可用时改用内置原生实现，不需要 Agent 去安装 Python 依赖或中断认证流程。
+需要登录态时只运行 `weaver-work-cli auth xiaoe`（业务命令也会自动尝试）。CLI 内部按「平台注入 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN` → 宿主 `tokens.py` → 桌面 XiaoE 客户端会话 → `WEAVER_XIAOE_*` 环境映射」顺序取凭据；沙箱（Linux、无桌面客户端、无 `tokens.py`）只会命中第一条，其余链路不可用时由 CLI 自行报错降级，Agent 不要替它安装 Python 依赖或手工取 Token。
 
 1. 未登录、登录失效、准备执行业务命令前需要确认 E10 会话，或 `auth status --no-check` 显示未登录时，先运行：
    ```text
    weaver-work-cli auth xiaoe
    ```
 2. 不得因为本地存在旧 profile、`auth profile current` 指向旧环境，或 `auth profile list` 里只有旧环境，就跳过 XiaoE 统一登录；也不得先要求用户选择旧 profile 或输入域名。
-3. XiaoE 统一登录由 CLI 优先读取宿主 `xiaoeUserData/tokens.py`，用脚本 stdout JSON 中的 ETEAMSID 写入统一登录态；脚本不可用（不存在、执行失败，或所用 Python 缺少 `requests` 等依赖）时，CLI 会自动改用内置原生实现读取 XiaoE 客户端本地会话（`XiaoE/Robots/*/user_settings.json` 或 `XIAOE_USER_TOKEN`）换取 `eteamId`，该链路不需要本机 Python；仍拿不到凭证时，才消费宿主注入的 `XIAOE_*` 域名/凭证映射。Agent 不要打印、转述、索取或要求用户手动设置 `XIAOE_*`、Cookie、ETEAMSID、业务 Token，也不要因为脚本报缺依赖就中断登录或让用户装 Python 包。
-4. `auth xiaoe` 和未显式指定 `--auth` / `--profile` 的业务命令都会先尝试上述统一登录；`tokens.py` 只返回 `eteamId` 时，CLI 采用 CLI 资料包内置的兜底 E10 域名（地址由资料包提供，不在文档中写死）作为兜底。Token、Cookie、ETEAMSID 仍属于凭证，禁止在回复中展示。
+3. XiaoE 统一登录由 CLI 按序取凭证：① 平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`（沙箱唯一可用来源，不依赖桌面客户端与 Python）；② 宿主 `xiaoeUserData/tokens.py`（仅桌面宿主）；③ 内置原生实现读取桌面 XiaoE 客户端会话（`XiaoE/Robots/<id>/user_settings.json`）换取 `eteamId`；④ `WEAVER_XIAOE_*` 环境映射。宿主只注入 `XIAOE_DOMAIN`、`XIAOE_USER_TOKEN` 等平台变量，不会注入 ETEAMSID 环境变量，CLI 也不读取 `XIAOE_ETEAMSID`。Agent 不要打印、转述、索取或要求用户手动设置这些凭证，也不要因为脚本报缺依赖就中断登录或让用户装 Python 包——降级由 CLI 内部完成。
+4. `auth xiaoe` 和未显式指定 `--auth` / `--profile` 的业务命令都会先尝试上述统一登录；`tokens.py` 只返回 `eteamId` 时，CLI 优先用宿主注入的 `XIAOE_DOMAIN` 作为兜底域名，没有时才采用 CLI 资料包内置的兜底 E10 域名（地址由资料包提供，不在文档中写死）。Token、Cookie、ETEAMSID 仍属于凭证，禁止在回复中展示。
 5. XiaoE 统一登录走不通时，CLI 必须先反馈未拿到登录信息的原因；`auth xiaoe` 随后再降级打开浏览器 OAuth，降级等待必须遵守「浏览器 OAuth 降级防挂起」规则。业务命令不得自动沿用旧 profile；如需网页登录，先运行 `weaver-work-cli auth xiaoe` 或由用户明确改用 `weaver-work-cli auth login`。
 6. `auth status --no-check` 只是本地诊断，不会主动触发 XiaoE 统一登录；业务命令和 `auth xiaoe` 才会尝试写入统一登录态。具体读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
 
@@ -77,7 +86,9 @@ weaver-work-cli doctor --e10
 
 如果命令不可用（尤其是 `command not found` 或退出码 127），先读 [`weaver-e10-installation.md`](references/weaver-e10-installation.md)：先区分「已安装但不在 PATH」与「未安装」（前者只需把全局 bin 目录前置到 PATH，不要重装），确认未安装后再让用户选择 npm 源安装或本地代码安装；本地代码必须提供仓库目录。用户明确同意后才执行 `npm install -g weaver-work-cli`、`npm install`、`npm run build` 或 `npm link`。
 
-3. 业务输入只描述业务对象和意图。认证、Cookie、ETEAMSID、业务 Token、接口地址和回查细节都由 CLI 托管。调用业务 operation 时，简单 JSON 优先使用 `--input-json '<json>'`；复杂或多行 JSON 先写入 UTF-8 `.json` 文件再传 `--input <path>`；只有确认当前 shell 能稳定传管道时才使用 `--input -`。生成或改写 docs、reference、提示词和命令示例时，必须同时兼容 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 写法。
+3. 业务输入只描述业务对象和意图。认证、Cookie、ETEAMSID、业务 Token、接口地址和回查细节都由 CLI 托管。调用业务 operation 时，简单 JSON 优先使用 `--input-json '<json>'`；多步传递优先用 shell 变量，超大结果用 `--input-ref <refId>`，不要把上一步 stdout 写入临时文件再作为下一步输入。`--input <path>` 只用于用户提供的 JSON 文件或明确的文件业务输入；复杂 JSON 可在确有需要时使用，不能用它中转 CLI 上一步的输出。只有确认当前 shell 能稳定传管道时才使用 `--input -`。生成或改写 docs、reference、提示词和命令示例时，必须同时兼容 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 写法。
+
+   CLI 对 `--input <path>` 默认只告警；需要拒绝文件 JSON 输入时使用 `--no-file-input`，或设置 `WEAVER_WORK_CLI_FILE_INPUT=deny` / config `io.fileInput=deny`。一次性允许时可用 `--allow-file-input`。`--input -` 和业务附件参数（如 `--file`）不受这条策略影响。
 
 4. 认证诊断只能通过 `weaver-work-cli auth root/status/profile list/profile current`、`weaver-work-cli doctor --e10` 和业务命令 JSON 错误完成。禁止直接列目录、打印、复制或解析用户态认证目录和认证文件。
 
@@ -111,19 +122,21 @@ Agent 调用业务能力时优先加 `--json`。成功看进程退出码 0 和 J
 
 ### 请求头契约（E10 接口调用强制）
 
+**本段是请求头三件套的唯一权威声明**：业务 Skill 与 reference 一律引用本段，不再各自复制完整代码块；引用处只需一行紧凑指针指向本节（发布门禁 B10c 已停用，不再按技能目录逐个校验这三项参数名）。
+
 `weaver-work-cli` 发往 E10 的每个请求都由 CLI 统一携带以下三项用户信息参数，缺一不可（业务入参里不要传这些字段，也不要手工拼装请求头）：
 
 ```text
-Cookie: <登录 skill 返回的完整原始 Cookie 串，原样透传，禁止裁剪/去重/改写>
-eteamsid: <登录 skill 返回的 ETEAMSID>
+Cookie: <weaver-work-cli 托管登录态的完整原始 Cookie 串，原样透传，禁止裁剪/去重/改写>
+eteamsid: <weaver-work-cli 托管登录态的 ETEAMSID>
 User-Agent: AgentType=<agentType>,IsAgent=true
 ```
 
-登录与会话统一由 E10 登录能力提供：文档型约定为 `weaver-e10-login` 技能，本 CLI 场景下等价入口是 `weaver-work-cli auth ...` 命令体系；业务 Skill 不得自建登录流程，也不得读取、打印、转存任何认证目录或凭证。
+登录与会话统一由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系托管；业务 Skill 不得自建登录流程，也不得读取、打印、转存任何认证目录或凭证。
 
 返回 `partial`、`write_uncertain`、登录失效、回查失败或网络中断时，立即停止当前写流程，不自动重试写入或删除。
 
-当前 CLI 的 JSON 输出是完整 envelope 直接写 stdout；没有飞书 CLI 那种通用 `--jq`、`--format table/ndjson` 或 `--page-all`。列表、详情、OCR、导出等可能产生大响应时，必须先读 [`json-output-contract.md`](references/json-output-contract.md) 的“大结果渲染与提效规则”：默认小页读取、只保留任务所需字段、分页有预算，回复用户时给摘要和路径，不要原样粘贴超长 JSON。
+当前 CLI 的普通大小 JSON 输出是完整 envelope；超过预算时会暂存完整结果，并在 stdout 返回精简摘要和 `refId`。CLI 没有飞书 CLI 那种通用 `--jq`、`--format table/ndjson` 或 `--page-all`。列表、详情、OCR、导出等可能产生大响应时，必须先读 [`json-output-contract.md`](references/json-output-contract.md) 的“大结果渲染与提效规则”：默认小页读取、只保留任务所需字段、分页有预算，回复用户时给摘要，不要原样粘贴超长 JSON。
 
 ## Reference 强触发索引
 
@@ -153,6 +166,4 @@ User-Agent: AgentType=<agentType>,IsAgent=true
 
 7. 附件、图片上传或文件解析属于敏感数据处理。即便 operation 风险等级不是高风险写入，也必须先取得用户对“文件内容可能进入大模型/外部解析服务”的明确确认；不能把用户仅提供文件路径或文件名视为同意解析或上传。
 
-8. 在 XiaoE 宿主环境中，CLI 可以按顺序从宿主 `xiaoeUserData/tokens.py`、内置原生实现读取的 XiaoE 客户端本地会话（`XiaoE/Robots/*/user_settings.json` 或 `XIAOE_USER_TOKEN`）、宿主注入的 `XIAOE_*` 环境变量读取支持统一登录的凭证；未显式传域名时优先使用凭证结果或资料包默认域名，再使用 XiaoE 环境支持域名，再其次才使用当前 profile，最后兜底 CLI 资料包内置默认域名（地址由资料包提供，不在文档中写死）。业务命令会在未显式指定 `--auth` / `--profile` 时自动优先尝试 XiaoE 统一登录；Agent 也可以显式调用 `weaver-work-cli auth xiaoe`。不要要求用户提供、展示或手动设置这些凭证。XiaoE 统一登录失败、当前域名不在支持范围内或用户切换访问域名时，`auth xiaoe` 必须先反馈原因，再自动降级到浏览器 OAuth，降级等待必须遵守「浏览器 OAuth 降级防挂起」规则。
-
-
+8. 在 XiaoE 宿主环境中，CLI 按顺序从平台注入凭证（`XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`）、宿主 `xiaoeUserData/tokens.py`、内置原生实现读取的桌面 XiaoE 客户端会话（`XiaoE/Robots/<id>/user_settings.json`）、`WEAVER_XIAOE_*` 环境映射读取支持统一登录的凭证（宿主不会注入 ETEAMSID 环境变量）；未显式传域名时优先使用凭证结果或 `XIAOE_DOMAIN`，再其次才使用当前 profile，最后兜底 CLI 资料包内置默认域名（地址由资料包提供，不在文档中写死）。业务命令会在未显式指定 `--auth` / `--profile` 时自动优先尝试 XiaoE 统一登录；Agent 也可以显式调用 `weaver-work-cli auth xiaoe`。不要要求用户提供、展示或手动设置这些凭证。XiaoE 统一登录失败、当前域名不在支持范围内或用户切换访问域名时，`auth xiaoe` 必须先反馈原因，再自动降级到浏览器 OAuth，降级等待必须遵守「浏览器 OAuth 降级防挂起」规则。

package/skills/weaver-e10-shared/references/e10-auth-and-session.md

@@ -83,7 +83,7 @@ weaver-work-cli auth whoami
 weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_type "<当前智能体名称>"
 ```
 
-在 XiaoE 宿主环境中，`auth xiaoe` 会先读取宿主 `xiaoeUserData/tokens.py`，把 stdout JSON 中的 `eteamId` / `eteamsId` 作为 ETEAMSID 写入登录态；脚本不可用（不存在、执行失败，或所用 Python 缺少 `requests` 等依赖）时，CLI 会改用内置原生实现读取 XiaoE 客户端本地会话（`XiaoE/Robots/*/user_settings.json` 或 `XIAOE_USER_TOKEN`）换取 `eteamId`，该链路不需要本机 Python；仍未识别到可用凭证时，才读取宿主注入的 `XIAOE_*` 环境变量，查找“当前登录域名 -> ETEAMSID”的统一登录映射，并且保存的 `agentType` 固定为 `XiaoE`。如果命令没有显式传入域名，CLI 会优先使用凭证结果中的域名或 CLI 资料包内置默认域名（地址由资料包提供，不在文档中写死）；没有脚本凭证但环境映射可用时，使用 XiaoE 环境变量里的首个支持域名；再没有时才使用当前 profile 配置。XiaoE 凭证校验失败、当前域名不在支持范围内，或用户切换了访问域名时，`auth xiaoe` 必须先反馈未拿到登录信息的原因，然后再降级打开浏览器 OAuth，降级等待必须遵守上方「浏览器 OAuth 降级防挂起」。
+在 XiaoE 宿主环境中，`auth xiaoe` 先使用平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN` 换取 ETEAMSID（沙箱唯一可用来源）；拿不到时再读宿主 `xiaoeUserData/tokens.py` 的 stdout JSON（仅桌面宿主），再退回内置原生实现读取桌面 XiaoE 客户端会话（`XiaoE/Robots/<id>/user_settings.json`，不需要本机 Python）；仍未识别到可用凭证时，才读取 `WEAVER_XIAOE_*` 环境变量里的“当前登录域名 -> ETEAMSID”统一登录映射，并且保存的 `agentType` 固定为 `XiaoE`。如果命令没有显式传入域名，CLI 会优先使用凭证结果中的域名或宿主注入的 `XIAOE_DOMAIN`，再使用 CLI 资料包内置默认域名（地址由资料包提供，不在文档中写死）；没有脚本凭证但环境映射可用时，使用 XiaoE 环境变量里的首个支持域名；再没有时才使用当前 profile 配置。XiaoE 凭证校验失败、当前域名不在支持范围内，或用户切换了访问域名时，`auth xiaoe` 必须先反馈未拿到登录信息的原因，然后再降级打开浏览器 OAuth，降级等待必须遵守上方「浏览器 OAuth 降级防挂起」。
 
 需要显式表达“XiaoE 优先”的场景也可以使用等价入口：
 
@@ -118,41 +118,20 @@ weaver-work-cli --profile PROFILE_NAME auth status --no-check
 
 通过 `weaver-work-cli run` 执行外部命令时，CLI 会按当前 profile 注入 `WEAVER_BASE_URL`、`WEAVER_ETEAMSID`、`WEAVER_COOKIE`、`WEAVER_USER_AGENT` 和 `WEAVER_AGENT_TYPE`。这些值只给子进程使用，不应在回复或日志中明文展示。
 
-XiaoE 的 `XIAOE_*` 环境变量只由宿主/客户端注入给 CLI 消费；Agent 不要打印、转述、要求用户手动填写或将其导出到当前 shell。CLI 当前支持 JSON 域名映射和单域名变量两类宿主格式，但这些格式属于宿主集成细节，不作为用户操作步骤。
+`XIAOE_*` 是平台保留前缀，只由宿主注入给 CLI 消费（`XIAOE_DOMAIN` 业务服务地址、`XIAOE_USER_TOKEN` 业务凭据，均按次注入；`XIAOE_SKILL_*` 为包内目录变量）。本 CLI 自己的宿主集成变量使用自有前缀 `WEAVER_XIAOE_*`，例如 `WEAVER_XIAOE_AUTH_MAP`（JSON 域名映射）、`WEAVER_XIAOE_TOKEN_SCRIPT_PATH`/`WEAVER_XIAOE_TOKEN_SCRIPT_PYTHON`（指定宿主 `tokens.py` 及解释器）、`WEAVER_XIAOE_DEFAULT_DOMAIN`（默认域名）；旧名 `XIAOE_E10_AUTH_MAP`、`XIAOE_TOKEN_SCRIPT_PATH` 等仅作兼容别名，新集成一律用 `WEAVER_XIAOE_*`。
 
-## XiaoE Token 获取
+宿主不会注入 ETEAMSID 环境变量，CLI 也不读取 `XIAOE_ETEAMSID`；ETEAMSID 一律由登录链路换取。CLI 支持两类宿主格式：平台注入的 `XIAOE_DOMAIN` + `XIAOE_USER_TOKEN`，以及 `WEAVER_XIAOE_*` 域名映射。这些格式属于宿主集成细节，不作为用户操作步骤；Agent 不要打印、转述、要求用户手动填写或将其导出到当前 shell。
 
-`auth xiaoe` 或业务命令需要 XiaoE 统一登录时，由 CLI 优先读取本流程中的宿主脚本；未识别到可用脚本凭证时，才考虑 `XIAOE_*` 映射。只有在业务流程明确需要 XiaoE Token，且 CLI 没有更专用的认证/业务命令可用时，Agent 才直接执行本流程。Token 获取脚本属于宿主能力，Agent 不要要求用户粘贴 Token，也不要在回复中展示 stdout 里的 Token、Cookie、ETEAMSID 或业务凭证。
+## XiaoE 凭据由 CLI 独占处理
 
-脚本固定从 XiaoE 用户数据目录读取。执行后读取 stdout 作为结果；stdout 期望是 JSON 对象，典型结果包含 `eteamId`。若脚本不存在、Python 依赖缺失、stdout 不是合法 JSON、接口失败或进程非 0 退出，停止当前认证流程，并把实际错误反馈给用户，不要猜测或伪造 Token。
+`auth xiaoe` 或业务命令触发统一登录时，CLI 按以下顺序自行取凭据，Agent **不参与、也不得复现**：
 
-Windows PowerShell：
+1. **平台注入凭据**：`XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`（小 e 业务服务地址）。这是沙箱/Linux 环境唯一可用的来源，不依赖桌面客户端与 Python。
+2. **宿主 `tokens.py`**：桌面宿主 `xiaoeUserData/tokens.py`（macOS `~/Library/Application Support/xiaoeUserData/tokens.py`，Windows `%LOCALAPPDATA%\xiaoeUserData\tokens.py`）；可用 `WEAVER_XIAOE_TOKEN_SCRIPT_PATH` 指定路径。
+3. **桌面 XiaoE 客户端会话**：`XiaoE/Robots/<id>/user_settings.json` 的 `session_id` + `erpa`，由 CLI 内置 Node 实现换取 `eteamId`，不需要本机 Python。
+4. **`WEAVER_XIAOE_*` 环境映射**：当前登录域名到 ETEAMSID 的映射。
 
-```powershell
-python -c "import os,runpy;runpy.run_path(os.path.join(os.environ['LOCALAPPDATA'],'xiaoeUserData','tokens.py'),run_name='__main__')"
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-python3 -c "import os,runpy;runpy.run_path(os.path.join(os.path.expanduser('~'),'Library','Application Support','xiaoeUserData','tokens.py'),run_name='__main__')"
-```
-
-如必须导出到当前 shell，按环境选择：
-
-Windows PowerShell：
-
-```powershell
-Invoke-Expression (weaver-work-cli auth export-weaver-env --shell powershell)
-```
-
-macOS/Linux（bash/zsh）：
-
-```bash
-eval "$(weaver-work-cli auth export-weaver-env --shell posix)"
-```
-
-`auth export-weaver-env` 默认 `--shell auto` 会在 Windows 输出 PowerShell 语法，在 macOS/Linux 输出 POSIX shell 语法；不确定时先用 `node -p "process.platform"` 判断。
+Agent 禁止自行执行 `tokens.py` 或任何取 Token 脚本（其 stdout 含 ETEAMSID/Cookie/Token，会进入对话与日志），禁止 `eval` / `Invoke-Expression` `auth export-weaver-env` 的输出，也禁止要求用户粘贴或展示任何凭证。脚本不存在、Python 依赖缺失、stdout 非法或接口失败，都由 CLI 内部记录并降级；Agent 只需把 CLI 反馈的原因转述给用户，不猜测或伪造 Token。
 
 ## 安全边界
 

package/skills/weaver-e10-shared/references/json-output-contract.md

@@ -76,27 +76,35 @@ macOS/Linux（bash/zsh）：
 weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
 ```
 
-复杂或多行 JSON 使用临时 UTF-8 文件。Windows PowerShell 示例：
+复杂或多行 JSON 优先拆成简单参数并使用 `--input-json`；需要在同一个 shell 内连续调用时，把 stdout 保存在变量里传递。不要把上一步 CLI 的 stdout 重定向到临时文件，再用 `--input <path>` 喂给下一条命令。`--input <path>` 留给用户提供的 JSON 文件或明确需要文件的业务操作。
+
+`--input <path>` 默认会告警但继续执行。可用 `--no-file-input` 或 `WEAVER_WORK_CLI_FILE_INPUT=deny` / config `io.fileInput=deny` 拒绝；需要临时放行时可传 `--allow-file-input`。`--input -`（stdin）和业务附件参数（如 `--file`）不受此策略影响。
+
+Windows PowerShell 的多步传递示例：
 
 ```powershell
-$inputFile = Join-Path $env:TEMP "weaver-work-cli-input.json"
-@{ page_size = 10; start_pos = 0 } | ConvertTo-Json -Depth 20 -Compress | Set-Content -Encoding UTF8 -NoNewline $inputFile
-weaver-work-cli --json invoice run invoice.list --input $inputFile
+$cli = "weaver-work-cli"
+$out = (& $cli --json invoice run invoice.list --input-json '{"page_size":200}') -join "`n"
+if ($LASTEXITCODE -ne 0) { throw $out }
+$refId = ($out | ConvertFrom-Json).refId
+& $cli --json invoice run invoice.get --input-ref $refId --pick 'items[0].fid' --pick-as fid
 ```
 
-macOS/Linux（bash/zsh）示例：
+macOS/Linux（bash/zsh）的多步传递示例：
 
 ```bash
-input_file="$(mktemp)"
-printf '%s\n' '{"page_size":10,"start_pos":0}' > "$input_file"
-weaver-work-cli --json invoice run invoice.list --input "$input_file"
+out="$(weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":200}')"
+ref_id="$(node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>process.stdout.write(JSON.parse(s).refId||""))' <<<"$out")"
+weaver-work-cli --json invoice run invoice.get --input-ref "$ref_id" --pick 'items[0].fid' --pick-as fid
 ```
 
+`--pick` 选出一个对象时，会把该对象直接作为下一条命令的输入。选出单个值时，必须同时用 `--pick-as <字段名>` 指定输入字段，例如 `--pick items[0].fid --pick-as fid`。
+
 Windows/PowerShell 下不要使用 `printf`、bash 反斜杠续行、`$HOME/...` 或 `~/...` 路径、`rm/ls/diff/python3` 等 Unix-only 写法；目录查看用 `Get-ChildItem`，删除用 `Remove-Item`，文件比对用 `Get-FileHash`，Python 启动器优先用 `py -3`。
 
 ## 大结果渲染与提效规则
 
-当前 `weaver-work-cli` 输出层是轻量封装：JSON 模式把完整结果写 stdout，文本模式写人类可读文本；不像飞书 CLI 已内置 `--format table/pretty/ndjson`、`--jq` 或通用 `--page-all`。Agent 因此必须在调用和回复阶段主动控量，避免把超长接口响应原样渲染给用户。
+当前 `weaver-work-cli` 输出层是轻量封装：JSON 模式对普通结果写完整 envelope，超预算结果会写入 CLI state 并返回摘要和 `refId`；文本模式写人类可读文本。CLI 不像飞书 CLI 已内置 `--format table/pretty/ndjson`、`--jq` 或通用 `--page-all`。Agent 仍需在调用和回复阶段主动控量，避免把超长接口响应原样渲染给用户。
 
 ### 调用前控量
 
@@ -110,11 +118,12 @@ Windows/PowerShell 下不要使用 `printf`、bash 反斜杠续行、`$HOME/...`
 - 不要把完整 stdout JSON 直接粘给用户。优先输出结论、命中数量、关键字段、下一页/剩余数据提示和必要的文件路径。
 - 列表结果只展示最相关的前 `10` 条；如果用户要求更多，分批展示并说明还可以继续读取。
 - 详情结果只展示与用户问题相关的字段。发票类详情通常优先展示 `fid`、号码/代码、购销方、金额、日期、查验/报销状态和附件摘要。
-- 超长文本、大数组、OCR 原文、逐项明细或调试需要的完整 JSON，优先写入本地文件再给路径；不要在对话里展开。可用 shell 重定向保存完整 stdout，或业务 operation 暴露 `output` 参数时使用其文件输出。
+- 大结果会由 CLI 暂存在用户级 state 目录，并返回 `refId`。后续操作用 `--input-ref <refId>` 和可选的 `--pick` / `--pick-as` 取所需数据；不要直接读取暂存文件，也不要用 `head` / `tail` 截取 JSON。
+- 如果用户确实需要一个可交付文件，使用业务 operation 提供的下载/导出参数或用户指定的输出路径；不要把 CLI stdout 当成临时中转文件。
 - 如果为了调试必须引用原始 envelope，只截取必要字段：`ok`、`operation`、`meta`、`warnings`、`error` 或 `data` 的相关子树。
 
 ### 参考飞书 CLI 的实践
 
 - 飞书 CLI 用 `--format json` 保留机器可读 envelope，用 `pretty/table/ndjson/csv` 降低人读成本；本 CLI 目前主要依赖 `--json` envelope，因此 Agent 回复时承担 pretty/table 摘要职责。
 - 飞书 CLI 的分页实践是显式页预算（如 `--page-limit`）和页间延迟；本 CLI 业务 operation 应使用自身 schema 中的 `page_size/start_pos` 等字段模拟同样的预算控制。
-- 飞书 CLI 对大产物倾向返回 artifact 文件路径；本 CLI 遇到下载、导出、OCR 或超长 JSON 时也应优先落盘并只向用户展示路径和摘要。
+- 下载和导出产物属于用户文件，按用户指定路径交付；超长命令结果属于 CLI 暂存数据，使用 `refId` 传递并只展示必要摘要。

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

@@ -23,7 +23,8 @@ cliHelp: "weaver-work-cli project --help"
 
 ## CRITICAL：共享规则
 
-先读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)。若该文件不存在，先执行 `weaver-work-cli skills install shared --target-dir <当前Agent的Skills目录>`；若 CLI 未安装，先执行 `npm install -g weaver-work-cli`。安装或读取失败时必须停止执行。
+先读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须先提示用户先补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行），并把下面两条待执行命令原样完整展示给用户；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)。
 
 ## 路由
 

package/skills/weaver-e10-shijingran/references/source-manifest.json

@@ -1241,13 +1241,13 @@
     }
   },
   "artifactBaseline": {
-    "aggregateSha256": "084fd449a1270b77670a27b4bfd8fccec32b838306714e761ea2858c22d239e9",
+    "aggregateSha256": "60eafebefaa0b7d6e75758ae78e3e5e1349ee453f33826de54c7293fb6e0fa41",
     "files": [
       {
         "path": "docs/_catalog.md",
         "role": "generated-doc",
-        "size": 4580,
-        "sha256": "7ec48267965b4ccd35dcc463ed0a73dd71c3f4d2fc3d978165f508261945d4b3"
+        "size": 5332,
+        "sha256": "a81903939aea5bf1196d1e3243709d2facf50d9bdcf74d8a6ca731061310dbbe"
       },
       {
         "path": "docs/project.md",
@@ -1258,8 +1258,8 @@
       {
         "path": "skill-template/business-info.json",
         "role": "generated-template",
-        "size": 6294,
-        "sha256": "7af8cc1b35564b11a4c33cf566b22919d75c8a4daeec488d6ff8979c098c8ff7"
+        "size": 8216,
+        "sha256": "370a45e86c6b7e33869c5df1bf08d9f22bd98fa8b157b49716e13bca0e7b63c3"
       },
       {
         "path": "skill-template/domains/shijingran.md",
@@ -1288,14 +1288,14 @@
       {
         "path": "skills/weaver-e10-shijingran/SKILL.md",
         "role": "generated-skill-entry",
-        "size": 6944,
-        "sha256": "e9556f31837163d637057981bdf5dddb7a1feed7653c61f0647c9d0a5ab38432"
+        "size": 8174,
+        "sha256": "597968607ca3321aac3b91e687c5963bdf1baee16d5f394aad64910e1ece53bf"
       },
       {
         "path": "src/shortcuts/index.ts",
         "role": "generated-cli",
-        "size": 1274,
-        "sha256": "54df058151b6f3602a2d112a49396b4ad4121cdba06d31c4c368ebd3235192c4"
+        "size": 1420,
+        "sha256": "569bef374df2d86b511150a0c609ce1abee63f8317994513bce6241276b5be40"
       },
       {
         "path": "src/shortcuts/project/continuation.ts",

package/skills/weaver-e10-skill-maker/SKILL.md

@@ -11,13 +11,13 @@ agent_created: true
 requires:
   bins: ["weaver-work-cli"]
 dependencies:
-  - weaver-e10-login
+  - weaver-e10-shared
 cliHelp: "weaver-work-cli skills --help"
 ---
 
 # weaver-work-cli Skill Maker
 
-**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --target-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若共享规则不存在、CLI 未安装或读取失败，说明本技能的必需依赖缺失，必须先提示用户先补齐 `weaver-work-cli` 与共享 skill `weaver-e10-shared`（不补齐本技能无法执行），并把下面两条待执行命令原样完整展示给用户；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`——省略会装进默认目录，导致本技能依然读不到共享规则。命令均成功后重新读取共享规则；仍读不到就停止并把结果报告用户，不得凭猜测继续。**
 
 
 本 Skill 参考飞书 CLI 的 `lark-skill-maker`，但输出范围更完整：Agent 需要把已经给出的业务模块资料同步固化为 `weaver-e10-*` Agent Skill 和对应 `src/shortcuts/<module>` TypeScript CLI 能力。新业务模块一开始没有对应 `weaver-work-cli` 业务命令是正常输入，但不能只生成文档型 Skill；默认要把 CLI 一并设计、实现、测试并让 Skill 调用真实 operation。转换时以**业务语义保真**为第一目标：入口 `SKILL.md` 可以轻量，但 `references/`、schema、handler、测试和禁用边界必须承接源资料里的可执行业务细节，不能把多份源 MD 压缩成泛泛概述导致能力退化。
@@ -26,15 +26,8 @@ cliHelp: "weaver-work-cli skills --help"
 
 ## 认证与请求头契约
 
-登录与会话由 E10 登录能力统一提供：文档型约定为 `weaver-e10-login` 技能，本 CLI 场景下等价入口是 `weaver-work-cli auth ...` 命令体系。业务 Skill 不自建登录流程，不索取、打印或转存任何凭证。
+登录与会话由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系统一托管。业务 Skill 不自建登录流程，不索取、打印或转存任何凭证。
 
-CLI 发往 E10 的每个请求都自动携带以下三项用户信息参数，**缺一不可**（业务入参里不要传这些字段，也不要手工拼装请求头）：
-
-```text
-Cookie: <登录返回的完整原始 Cookie 串，原样透传，禁止裁剪/去重/改写>
-eteamsid: <登录返回的 ETEAMSID>
-User-Agent: AgentType=<agentType>,IsAgent=true
-```
 
 ## 适用范围
 
@@ -53,6 +46,7 @@ User-Agent: AgentType=<agentType>,IsAgent=true
 - 用户已明确作为输入提供的业务文档、代码目录、接口说明或样例，视为本次转换的源资料；先读取与当前模块直接相关的原文和现有 reference，再判断是否缺口。不要只因为“需要读取 reference 原文”就停止。
 - 转换不得以摘要替代业务规则。源 MD 中的字段表、枚举/状态、默认值、固定参数、权限前置、分页/排序口径、ID 解析规则、流程分支、写入确认条件、错误码、返回结构、示例和禁用能力，必须分别落到 `manifest.ts` / handler / reference / 测试 / 禁用边界之一；确实不能迁移的细节要在待确认清单或禁用边界说明原因。
 - 源资料给出结构化 JSON 请求体字段表时，`inputSchema.properties` 必须逐字段转换字段名、类型、必填、数组元素和嵌套对象；禁止只暴露 `payload`、`body`、`requestPayload` 或 `object` 这类通用包裹字段来替代字段转换。确需兼容旧 `payload` 输入时，只能在 handler 归一化层保留兼容，schema/reference 仍以逐字段 canonical 入参为准。
+- 源资料给出接口响应、出参或返回值字段表时，`outputSchema.properties` 必须按 CLI 成功 envelope 的 `data` 逐字段转换字段名、类型、必填、数组元素和嵌套对象；禁止只写 `result`、`data`、`raw` 或 `object` 这类通用包裹字段来替代返回值转换。确需透传服务端原始响应时，要在 `outputSchema` 中同时声明已知稳定字段和 raw 字段边界。
 - 缺口只阻断受影响的 operation；已能从源资料确认的只读、预览、准备或文档索引部分要继续实现。不能实现的能力写入待确认清单或禁用边界，不要生成假 operation。
 - 如果确实必须等用户补充，回复必须列出具体缺口并提出明确问题，例如缺少哪个 operation 的接口路径、请求方法、关键字段、权限边界、幂等键、回查接口或写入确认条件。不能只说“需要确认细节”，也不要以“实现前需要确认几个细节”“随后开始实现”这类状态句作为最终回复。
 

package/skills/weaver-e10-skill-maker/references/business-skill-generation.md

@@ -51,7 +51,9 @@
 - `deprecatedAlias`：兼容旧字段，写入 `deprecatedInputAliases` 并测试冲突规则。
 - `withheld`：源资料有该参数或能力，但当前 CLI 不支持，写清原因。
 - `needs-confirmation`：源资料只出现字段名或片段，缺少类型、是否必填、来源、枚举、权限、回查或绑定规则，等待用户补充。
-- `not-applicable`：接口内部字段、展示字段或返回字段，不应暴露为 Agent 入参。
+- `not-applicable`：接口内部字段或展示字段，不应暴露为 Agent 入参；返回字段不得仅标为 not-applicable，必须继续纳入 `outputSchema` 或输出覆盖矩阵。
+
+还要为每个 operation 写入或更新输出覆盖矩阵，至少记录在 `source-manifest.json` 的 `operationImpact[operation].outputFields` / `outputSchemaCoverage` 或等价结构中。矩阵必须以源资料响应字段表、返回示例或代码中的稳定返回对象为起点，逐项记录返回字段名、源位置、类型、必填或可选、数组元素、嵌套对象、枚举/状态码和落到的 `outputSchema` 路径。源资料缺少响应字段表但有响应示例时，可以从示例抽取稳定字段并标注来源；源资料完全缺少响应事实时，登记 `missingOutputSchema` 或 `needs-confirmation`，不能用通用 `object`、`raw` 或 `result` 代替逐字段转换。
 
 入参 example 采用分级规则，不能因源资料没有 example 就阻断整个生成：
 
@@ -76,12 +78,12 @@
 不要把多份源 MD 压缩成一个“能力概述”。对每个业务对象或 operation，至少检查并迁移以下可执行细节：
 
 - 字段表：字段名、类型、必填、默认值、枚举/状态、单位、时间格式、ID 精度、别名、互斥/二选一/至少一个、固定参数和废弃字段兼容策略。
-- 请求与响应：接口路径、请求方法、query/body/form/file 位置、分页/排序/筛选口径、返回结构、成功判定、错误码、空结果语义和大结果展示规则。
+- 请求与响应：接口路径、请求方法、query/body/form/file 位置、分页/排序/筛选口径、返回结构、返回字段名/类型/必填/数组元素/嵌套对象、成功判定、错误码、空结果语义和大结果展示规则。
 - 业务流程：前置查询、版本门禁、权限/scope、对象状态流转、跨链路差异、ID/名称解析、缓存或字典依赖、写前回查、写后回查和不确定结果处理。
 - 示例与边界：源资料已有入参 example 时必须迁移到 manifest 和 reference；源资料没有 example 时按参数完整度生成 `synthetic` 样例或登记 `missingExamples`，并在最终报告中列出待补充项；如果源资料区分成功、失败、不同链路或不同对象类型，要分别保留能影响执行的差异。
 - 禁用与缺口：源资料出现但未生成 CLI operation 的能力，必须进入 schema 的 withheld/disabled 信息或 reference 的禁用边界，并写清缺少的事实和为什么阻断。
 
-迁移方式要按所有权落点分配：`manifest.ts` / `schema` 承载 WHAT，handler 和 host 承载请求形状与校验，`references/` 承载条件化 HOW，测试承载关键语义回归。不能只把细节写在自然语言里，也不能只在代码里实现而不让 Skill/reference 指到对应用法。若源资料给出 JSON 请求体字段表，`inputSchema.properties` 必须逐项暴露这些业务字段；不能把整段请求体塌缩成 `payload`/`body`/`requestPayload` 一个 object 后宣称已转换。
+迁移方式要按所有权落点分配：`manifest.ts` / `schema` 承载 WHAT，handler 和 host 承载请求形状与校验，`references/` 承载条件化 HOW，测试承载关键语义回归。不能只把细节写在自然语言里，也不能只在代码里实现而不让 Skill/reference 指到对应用法。若源资料给出 JSON 请求体字段表，`inputSchema.properties` 必须逐项暴露这些业务字段；不能把整段请求体塌缩成 `payload`/`body`/`requestPayload` 一个 object 后宣称已转换。若源资料给出响应字段表或返回示例，`outputSchema.properties` 必须按 CLI 成功 envelope 的 `data` 结构逐项暴露稳定返回字段；不能只把整段响应塌缩成 `result`/`data`/`raw` 一个 object 后宣称已转换。
 
 如果源资料描述的是底层接口，但仓库还没有对应 operation，按 [`module-cli-generation.md`](module-cli-generation.md) 先实现 CLI，再让 Skill 调用该 operation。确实缺少实现依据时，把缺口列入待确认清单并问用户，不能生成假 operation；缺口只阻断对应 operation，已确认的能力继续生成 CLI、测试、docs 和 Skill reference。
 

package/skills/weaver-e10-skill-maker/references/module-cli-generation.md

@@ -76,6 +76,7 @@ export interface <Module>OperationContract {
     source?: string;
   }>;
   inputSchema: Record<string, unknown>;
+  outputSchema: Record<string, unknown>;
 }
 
 export const <module>Operations: <Module>OperationContract[] = [
@@ -86,6 +87,11 @@ export const <module>Operations: <Module>OperationContract[] = [
       type: 'object',
       additionalProperties: false,
       properties: {}
+    },
+    outputSchema: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {}
     }
   }
 ];
@@ -93,6 +99,8 @@ export const <module>Operations: <Module>OperationContract[] = [
 
 operation 名称使用 `<module>.<action>`，多级动作可用 `<module>.<object>.<action>`。`inputSchema` 必须禁止额外字段；需要二选一、至少一个、互斥、固定值或默认值时用 JSON Schema 表达，不把规则只写在说明里。源资料给出结构化 JSON 请求体字段表时，必须把字段逐项转换进 `inputSchema.properties`，包括必填、数组元素、嵌套对象、枚举和默认值；不得只写 `{ payload: { type: "object" } }`、`requestPayload`、`body` 或 `additionalProperties: true` 来代替参数转换。若为了兼容旧版本继续接受 `payload`，只能在 handler 归一化中处理，并用测试证明 canonical 顶层字段仍是 schema/reference 的唯一推荐输入。源资料给出权限、scope、角色、身份或接口前置条件时，记录到 `auth`、`permissions`、`scope` 或 `fixed` 中；如果当前模块不需要这些字段，可以省略，但不能把已知权限事实只放在正文里。
 
+`outputSchema` 描述 `--json run` 成功 envelope 中的 `data` 字段，不描述外层 `{schemaVersion, ok, operation, meta, warnings}`。源资料给出接口响应、出参、返回值字段表或响应示例时，必须把稳定字段逐项转换进 `outputSchema.properties`，包括字段名、类型、必填、数组元素、嵌套对象、枚举、状态码和分页/汇总字段；不得只写 `{ result: { type: "object" } }`、`raw`、`data` 或 `additionalProperties: true` 来代替返回值转换。handler 对服务端响应做过归一化时，`outputSchema` 以 CLI 实际返回的 `data` 结构为准，并在属性说明里标注原始接口字段来源；确需保留服务端原始响应时，只能把 raw 字段作为附加属性暴露，同时仍要声明 CLI 已知的稳定字段。源资料没有返回字段表但有示例时，从示例抽取稳定字段并标明 `sourceType: "synthetic"` 或在 source-manifest 记录待复核；源资料完全缺少响应事实时，写入 `missingOutputSchema` 或等价待确认项，不要编造字段。
+
 `inputExamples` 是 Agent 入参格式的优先参考，按以下规则生成：
 
 - 源资料、历史 Skill、测试脚本或接口文档已有入参样例时，必须迁移到 `inputExamples`，`sourceType` 为 `source-provided`，`source` 指到源文件、标题、脚本或稳定 chunk；这类样例缺失时测试失败。
@@ -174,33 +182,10 @@ operation 名称使用 `<module>.<action>`，多级动作可用 `<module>.<objec
 
 生成的 E10 业务 Skill 必须遵守登录与凭证红线：
 
-- 登录与会话统一由 `weaver-e10-login` 提供；CLI 场景下的等价入口是 `weaver-work-cli auth ...`，业务 Skill 不得自行实现任何登录流程。
-- 生成的 SKILL.md frontmatter 必须声明 `dependencies:\n  - weaver-e10-login`。
-- 每个请求必须携带 `weaver-e10-login` 返回的三项用户信息参数，缺一不可：
-
-```text
-Cookie: <weaver-e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
-eteamsid: <weaver-e10-login 返回的 ETEAMSID>
-User-Agent: AgentType=<agentType>,IsAgent=true
-```
-
-- Skill 与 reference 文档中若描述了接口请求，必须同时写明上述请求头契约，否则发布门禁会阻断。
-
-### 登录与凭证契约（生成产物必须遵循）
-
-生成的 E10 业务 Skill 必须遵守登录与凭证红线：
-
-- 登录与会话统一由 `weaver-e10-login` 提供；CLI 场景下的等价入口是 `weaver-work-cli auth ...`，业务 Skill 不得自行实现任何登录流程。
-- 生成的 SKILL.md frontmatter 必须声明 `dependencies:\n  - weaver-e10-login`。
-- 每个请求必须携带 `weaver-e10-login` 返回的三项用户信息参数，缺一不可：
-
-```text
-Cookie: <weaver-e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
-eteamsid: <weaver-e10-login 返回的 ETEAMSID>
-User-Agent: AgentType=<agentType>,IsAgent=true
-```
-
-- Skill 与 reference 文档中若描述了接口请求，必须同时写明上述请求头契约，否则发布门禁会阻断。
+- 登录与会话统一由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系托管，业务 Skill 不得自行实现任何登录流程。
+- 生成的 SKILL.md frontmatter 必须声明 `dependencies:\n  - weaver-e10-shared`。
+- 每个请求的请求头三件套（Cookie 完整原始串 / `eteamsid` / `User-Agent`）由 `weaver-work-cli` 统一注入，业务侧不得手工拼装或覆盖；唯一权威声明见 [`../../weaver-e10-shared/SKILL.md`](../../weaver-e10-shared/SKILL.md) 的「请求头契约」章节。
+- Skill 与 reference 文档中若描述了接口请求，只需一行指针引用 `weaver-e10-shared` 的「请求头契约」，不要复制完整代码块。
 
 E10 业务模块必须复用 `src/internal/e10` 的 session、profile 和 request runtime，不直接读取认证文件、Cookie、Keychain 或 legacy auth 目录，也不在业务 `host.ts` 中直接调用 `fetch`。业务 host 只封装本模块需要的请求方法，负责：
 

package/skills/weaver-e10-skill-maker/references/module-gap-audit-and-repair.md

@@ -17,7 +17,7 @@
 
 先构建单模块现状清单：
 
-- CLI manifest：`weaver-work-cli <command> schema` 或 `src/shortcuts/<command>/manifest.ts` 中的 operation、`inputSchema`、risk、fixed、权限、`inputExamples`、`missingExamples`。
+- CLI manifest：`weaver-work-cli <command> schema` 或 `src/shortcuts/<command>/manifest.ts` 中的 operation、`inputSchema`、`outputSchema`、risk、fixed、权限、`inputExamples`、`missingExamples`。
 - handler/host：registry 是否一一对应，handler 是否使用 schema 字段，host 请求 method/path/query/body/form/file 是否可被测试断言。
 - Skill：`SKILL.md` 路由表、reference 文件、命令示例、禁用边界、写操作确认链说明。
 - Source manifest：`sources`、`sourceChunks`、`operationImpact`、`sourceCoverage`、`artifactBaseline`、参数覆盖矩阵和 notes。
@@ -28,6 +28,7 @@
 - 基线缺口：manifest 旧版、弱检测、源文件为空、artifactBaseline 缺失或聚合 hash 不一致。
 - 映射缺口：CLI operation 没有 `operationImpact`；`operationImpact` 指向不存在的 operation；sourceChunk 没有映射 operation/reference；业务源文件没有 `sourceCoverage`。
 - 参数缺口：源资料参数没有进入 `inputSchema`，也没有标记为 `fixed`、`derived`、`deprecatedAlias`、`withheld`、`needs-confirmation` 或 `not-applicable`。
+- 输出缺口：源资料响应字段、出参或返回示例没有进入 `outputSchema`，也没有在 `operationImpact` 的 `outputFields` / `outputSchemaCoverage` / `missingOutputSchema` 中说明；只用 `result`、`data`、`raw` 或通用 `object` 包裹返回值视为未逐字段转换。
 - 示例缺口：源资料已有 example 但 manifest/reference 没迁移；源资料没有 example 但未记录 `missingExamples` 或 `synthetic` 样例。
 - 业务逻辑缺口：源资料里的接口路径、请求方法、固定参数、枚举、默认值、分页、状态流转、权限、ID 解析、写前/写后回查、错误码或返回结构没有落到 schema/handler/reference/test。
 - 写入安全缺口：新增、编辑、删除、导入、同步等真实写入缺少 `prepare -> apply`、`confirm: true`、continuation、指纹校验或 `partial/write_uncertain` 处理。
@@ -49,11 +50,11 @@
 修复必须按 contract-first 顺序推进：
 
 1. 锁定源事实：读对应 source chunk、源文档标题、接口定义、历史脚本或用户补充说明；记录来源锚点。
-2. 更新 schema：补 `inputSchema`、required、enum、默认值、oneOf/anyOf、fixed、权限、`inputExamples` 或 `missingExamples`。
+2. 更新 schema：补 `inputSchema`、`outputSchema`、required、enum、默认值、oneOf/anyOf、fixed、权限、`inputExamples`、`missingExamples`、`missingOutputSchema`。
 3. 更新执行逻辑：补 handler 输入归一化、host 请求形状、固定参数、派生参数、错误映射、分页和写入确认链。
 4. 更新 Skill/reference：命令示例优先引用 manifest `inputExamples`；缺 example 时写 `missingExamples` 和待补事实，不伪装成源样例。
-5. 更新 source-manifest：补 `sourceChunks`、`operationImpact`、`sourceCoverage`、`parameterCoverage`、`artifactBaseline` 和 notes。
-6. 更新测试：至少覆盖 schema 字段、请求形状、reference 示例字段、source-manifest 映射、高风险写入确认链和缺口登记。
+5. 更新 source-manifest：补 `sourceChunks`、`operationImpact`、`sourceCoverage`、`parameterCoverage`、`outputFields` / `outputSchemaCoverage`、`artifactBaseline` 和 notes。
+6. 更新测试：至少覆盖 schema 字段、输出字段 schema、请求形状、reference 示例字段、source-manifest 映射、高风险写入确认链和缺口登记。
 7. 运行验证：业务测试、`weaver-work-cli <command> schema`、`weaver-work-cli skills read weaver-e10-<skill>`、layout 测试；创建或更新 Skill 后按 detector 规则询问是否质检。
 
 如果发现源资料中有底层接口但当前没有 operation，先判断是否能形成稳定、业务友好的高层 operation。能实现时补 CLI operation、reference 和测试；不能实现时写入 withheld，不要把原始接口路径直接暴露给 Agent。
@@ -67,10 +68,21 @@
 - 可由当前用户、前置查询、名称解析、prepare continuation 或上下文推导的字段，标为 `derived` 并测试解析失败路径。
 - 旧 Skill/历史脚本字段需要兼容时，进入 `deprecatedInputAliases`，并测试新旧字段冲突。
 - 源资料提到但缺少类型、必填、枚举或来源时，标为 `needs-confirmation`，最终报告列出具体问题。
-- 接口内部字段、返回字段或展示字段，标为 `not-applicable`。
+- 接口内部字段或展示字段，标为 `not-applicable`。返回字段不能因为“不作为入参”就结束处理；必须继续进入输出修复规则。
 
 严禁为了让业务逻辑“跑起来”把不确定字段放进 `additionalProperties: true`。除非已有模块明确是通用 datajson 透传能力，否则业务 operation 的顶层 `inputSchema.additionalProperties` 必须为 `false`。
 
+## 输出修复规则
+
+补返回值时逐项判断归属：
+
+- CLI 成功 envelope 外层字段固定为 `{schemaVersion, ok, operation, data, meta, warnings}`，`outputSchema` 只描述其中的 `data`。
+- handler 已经归一化的字段，以 CLI 实际返回字段为准，并把源接口字段来源写入 description、reference 或 `operationImpact.outputFields`。
+- 服务端原始响应需要保留时，可暴露 `result`、`raw` 等字段，但这只能作为附加调试/追溯字段；仍要逐项声明已知稳定的业务字段。
+- 源资料响应字段表中的数组必须声明 `items`；嵌套对象必须声明 `properties`；确定必返字段必须进入 `required`；枚举、状态码、分页结束标记和金额/时间格式能确认时要写入 schema。
+- 源资料只有响应示例时，从示例抽取稳定字段并标注示例来源；缺少类型、必填或嵌套结构时，在 `missingOutputSchema` 或 `outputSchemaCoverage` 中标记 `needs-confirmation`。
+- 不要为了规避不确定性把整个输出写成 `additionalProperties: true`。只有明确的原始服务端透传字段可以 `additionalProperties: true`，且必须和稳定业务字段分开。
+
 ## 审计报告格式
 
 单模块扫描完成后，先输出或保留一份结构化报告，再动手修复。报告至少包含：

package/skills/weaver-e10-skill-maker/references/source-update-detection.md

@@ -113,33 +113,10 @@
 
 生成的 E10 业务 Skill 必须遵守登录与凭证红线：
 
-- 登录与会话统一由 `weaver-e10-login` 提供；CLI 场景下的等价入口是 `weaver-work-cli auth ...`，业务 Skill 不得自行实现任何登录流程。
-- 生成的 SKILL.md frontmatter 必须声明 `dependencies:\n  - weaver-e10-login`。
-- 每个请求必须携带 `weaver-e10-login` 返回的三项用户信息参数，缺一不可：
-
-```text
-Cookie: <weaver-e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
-eteamsid: <weaver-e10-login 返回的 ETEAMSID>
-User-Agent: AgentType=<agentType>,IsAgent=true
-```
-
-- Skill 与 reference 文档中若描述了接口请求，必须同时写明上述请求头契约，否则发布门禁会阻断。
-
-### 登录与凭证契约（生成产物必须遵循）
-
-生成的 E10 业务 Skill 必须遵守登录与凭证红线：
-
-- 登录与会话统一由 `weaver-e10-login` 提供；CLI 场景下的等价入口是 `weaver-work-cli auth ...`，业务 Skill 不得自行实现任何登录流程。
-- 生成的 SKILL.md frontmatter 必须声明 `dependencies:\n  - weaver-e10-login`。
-- 每个请求必须携带 `weaver-e10-login` 返回的三项用户信息参数，缺一不可：
-
-```text
-Cookie: <weaver-e10-login 返回的完整原始 Cookie 串>（禁止裁剪/去重/改写）
-eteamsid: <weaver-e10-login 返回的 ETEAMSID>
-User-Agent: AgentType=<agentType>,IsAgent=true
-```
-
-- Skill 与 reference 文档中若描述了接口请求，必须同时写明上述请求头契约，否则发布门禁会阻断。
+- 登录与会话统一由 `weaver-e10-shared` 共享规则和 `weaver-work-cli auth ...` 命令体系托管，业务 Skill 不得自行实现任何登录流程。
+- 生成的 SKILL.md frontmatter 必须声明 `dependencies:\n  - weaver-e10-shared`。
+- 每个请求的请求头三件套（Cookie 完整原始串 / `eteamsid` / `User-Agent`）由 `weaver-work-cli` 统一注入，业务侧不得手工拼装或覆盖；唯一权威声明见 [`../../weaver-e10-shared/SKILL.md`](../../weaver-e10-shared/SKILL.md) 的「请求头契约」章节。
+- Skill 与 reference 文档中若描述了接口请求，只需一行指针引用 `weaver-e10-shared` 的「请求头契约」，不要复制完整代码块。
 
 只有源资料存在稳定锚点时才写 `sourceChunks`。可用锚点包括：