weaver-work-cli 0.1.24 → 0.1.26

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

@@ -1232,6 +1232,48 @@
         "references/folder.md"
       ]
     },
+    {
+      "id": "fetch_workflow_upload_folder",
+      "sourcePath": "weaver-doc-workflow-business/operations/fetch_workflow_upload_folder.json",
+      "anchor": "operations/fetch_workflow_upload_folder.json",
+      "sha256": "1d13fc918d3f40a7d9f19a397e42c9d9873930f7ed57e7c0ff8f1ebafb23a654",
+      "sourceKind": "plugin",
+      "pluginModule": "scripts/workflow_plugins.py",
+      "mapsToOperations": [
+        "caizhilian.setting-attach.list-upload-folders"
+      ],
+      "mapsToReferences": [
+        "references/setting-attach.md"
+      ]
+    },
+    {
+      "id": "find_version_list",
+      "sourcePath": "har/获取附件历史版本.har#/api/file/base/upload/findVersionList",
+      "anchor": "POST /api/file/base/upload/findVersionList",
+      "sha256": "332a6fc9a838465ea39e77bd6fc28622e7786768244b1ddfac31621950345e5c",
+      "sourceKind": "har_capture",
+      "pluginModule": "web filePreview version drawer",
+      "mapsToOperations": [
+        "caizhilian.attachment.list-versions"
+      ],
+      "mapsToReferences": [
+        "references/files.md"
+      ]
+    },
+    {
+      "id": "search_workflows",
+      "sourcePath": "weaver-doc-workflow-business/operations/search_workflows.json",
+      "anchor": "operations/search_workflows.json",
+      "sha256": "424f403de07c655500f38ac0e9d3dc4fe1bacc7e8dcce178185031ebdbd5aca1",
+      "sourceKind": "plugin",
+      "pluginModule": "scripts/search_plugins.py",
+      "mapsToOperations": [
+        "caizhilian.setting-attach.search-workflows"
+      ],
+      "mapsToReferences": [
+        "references/setting-attach.md"
+      ]
+    },
     {
       "id": "list_folder_permission",
       "sourcePath": "weaver-e10-caizhilian/doc-business-operations/folder_permission_operations.json",
@@ -4776,6 +4818,59 @@
       "risk": "read",
       "requiresConfirmationChain": false
     },
+    "caizhilian.setting-attach.list-upload-folders": {
+      "sourceChunkIds": [
+        "fetch_workflow_upload_folder"
+      ],
+      "schemaFields": [
+        "workflow_id"
+      ],
+      "references": [
+        "references/setting-attach.md"
+      ],
+      "tests": [
+        "test/business/caizhilian-operations.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
+    "caizhilian.setting-attach.search-workflows": {
+      "sourceChunkIds": [
+        "search_workflows"
+      ],
+      "schemaFields": [
+        "keyword",
+        "page_no",
+        "page_size"
+      ],
+      "references": [
+        "references/setting-attach.md"
+      ],
+      "tests": [
+        "test/business/caizhilian-operations.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
+    "caizhilian.attachment.list-versions": {
+      "sourceChunkIds": [
+        "find_version_list"
+      ],
+      "schemaFields": [
+        "attachment_id",
+        "doc_id",
+        "page_no",
+        "page_size"
+      ],
+      "references": [
+        "references/files.md"
+      ],
+      "tests": [
+        "test/business/caizhilian-operations.test.ts"
+      ],
+      "risk": "read",
+      "requiresConfirmationChain": false
+    },
     "caizhilian.setting-attach.list-workflows-by-folders": {
       "sourceChunkIds": [
         "list_approval_workflows_by_folders"
@@ -6200,6 +6295,9 @@
     "验证口径为离线契约等价：tsc --noEmit、npm run build、node:test 全量用例与 caizhilian schema/operations 自检；未在真实 E10 环境完成端到端调用，真实响应字段以现场实测为准。",
     "11 项已知实现偏差（兜底覆盖、时间时区、coordinate 语义、share.add 已存在判定、page<=0 显式报错等）记录在 docs/caizhilian.md 与生成报告 .temp/caizhilian-generation-report.md。",
     "sourceChunks[].sha256 为对应源规格文件指纹；manifest 只记录路径、hash、影响映射与转换摘要，不保存 Cookie、Token 或大段源正文，localSourceRoot 仅用于后续增量检测定位。",
-    "文件上传协议按 weaver-file-upload 1.0.0-node.1 的契约迁入 src/shortcuts/caizhilian/file-upload；保留 CLI 统一认证，补齐秒传、流式普通/分片上传、终态大小校验和私有回执；由本机 HTTP 测试验证，尚未验证真实 E10 租户。"
+    "文件上传协议按 weaver-file-upload 1.0.0-node.1 的契约迁入 src/shortcuts/caizhilian/file-upload；保留 CLI 统一认证，补齐秒传、流式普通/分片上传、终态大小校验和私有回执；由本机 HTTP 测试验证，尚未验证真实 E10 租户。",
+    "caizhilian.setting-attach.list-upload-folders 按源 Skill weaver-doc-workflow-business（skill-workflow-folder）的 fetch_workflow_upload_folder 契约迁入；该操作不在 weaver-e10-caizhilian 1.1.17 基线内，其 chunk 指纹（sha256）取自 weaver-doc-workflow-business/operations/fetch_workflow_upload_folder.json 源文件。",
+    "caizhilian.setting-attach.search-workflows 按源 Skill weaver-doc-workflow-business（skill-workflow-folder）的 search_workflows 契约迁入（scripts/search_plugins.py 的 SearchWorkflowsPlugin）；该操作不在 weaver-e10-caizhilian 1.1.17 基线内，其 chunk 指纹（sha256）取自 weaver-doc-workflow-business/operations/search_workflows.json 源文件。源 keyword 别名 name 记录为 deprecatedInputAliases。",
+    "caizhilian.attachment.list-versions 按用户提供的抓包（har/获取附件历史版本.har 的 POST /api/file/base/upload/findVersionList，filePreview 页附件历史版本抽屉）迁入；该操作不在 weaver-e10-caizhilian 1.1.17 基线内，其 chunk 指纹（sha256）取自 har_extractor 提取的该请求规格文件，请求体字段按抓包逐字段复刻（startTime/endTime/userIds 抓包为空串且语义不明，按空串固定并记录为 withheld）。"
   ]
 }

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

@@ -1,52 +1,27 @@
-# 采知连：明确不提供的能力（withheld）与源 Skill 范围外模块
+# 采知连：明确不提供的能力与替代方案
 
 ## 何时使用
 
-- 用户要求「列一下有哪些环境 / 看看当前配置 / 重新加载配置 / 切换到测试环境」这类源 Skill 的系统管理能力。
-- 用户拿着源 Skill（`weaver-e10-caizhilian` 1.1.17）的 operation 名来调用，但 CLI 里没有对应 operation。
+- 用户要求「列一下有哪些环境 / 看看当前配置 / 重新加载配置 / 切换到测试环境」这类系统管理能力。
+- 用户用本 Skill 不提供的操作名来调用，但 CLI 里没有对应 operation。
 - `caizhilian operations` 的 `withheldOperations` 里给出了名称与理由，需要向用户解释替代方案。
 
 ## 输入要点
 
-### 4 个 withheld 系统操作
+### 4 个不提供的系统操作
 
-源 `scripts/system_plugins.py` 的这 4 个插件**没有**转换成 CLI operation。原因都是同一个：它们操作的是源 Skill 自带的 `assets/config.json` 多环境配置与本地登录态缓存，而在 weaver-work-cli 里，环境、配置与登录态由框架统一管理，业务模块不得自建一套。
+以下 4 个系统管理能力**没有**做成业务 operation。原因相同：环境、配置与登录态由 `weaver-work-cli` 框架统一管理，业务模块不自建一套配置与登录缓存。
 
-| 源 operation |  withheld 名称 | 不提供的原因 | 替代命令 |
-| --- | --- | --- | --- |
-| `list_systems` | `caizhilian.system.list-systems` | 读取 Skill 自带 config.json 的多环境列表与登录态 | `weaver-work-cli config list`、`weaver-work-cli e10 auth status`；连通性自检用 `weaver-work-cli --json caizhilian health` |
-| `get_loaded_config` | `caizhilian.system.get-loaded-config` | 输出 Skill 本地配置生效内容（含 cookies 掩码、下载目录） | `weaver-work-cli config list`；不在业务模块内暴露配置快照 |
-| `reload_config` | `caizhilian.system.reload-config` | 重新加载 Skill 本地 config.json | 无需替代：CLI 每次进程启动即读取框架配置，没有进程内缓存需要刷新 |
-| `switch_config` | `caizhilian.system.switch-config` | 在 Skill 本地多套环境配置间切换 | `weaver-work-cli config set ...`、`weaver-work-cli e10 auth login --base-url <域名>` |
-
-只保留了 `caizhilian.system.health`（源 `check_system_health`）：探测 `/api/doc/config/getUserConfiguration?configKeys`，返回 `{ environment, healthy, base_url, url, status_code, business_code, diagnosis, elapsed_ms }`，其中 `environment.provider` 固定为 `weaver-work-cli:e10-auth`；本地无登录态时抛 `authentication/session_unavailable`。
-
-### 源 Skill 目录内的已补充模块
-
-以下模块已补充到 caizhilian CLI 中：
-
-| 源模块 | CLI 操作 | 说明 |
+| withheld 名称 | 不提供的原因 | 替代命令 |
 | --- | --- | --- |
-| 系统设置-附件 | `caizhilian.setting-attach.get` / `.set.prepare` / `.set.apply` | 附件全局设置（上传最大、格式控制、批量下载等 11 项） |
-| 系统设置-备份 | `caizhilian.setting-backup.get` / `.set.prepare` / `.set.apply` / `.rule.*` | 备份设置（开关、规则 CRUD、启停） |
-| 系统设置-加密 | `caizhilian.setting-encrypt.get` / `.set.prepare` / `.set.apply` | 加解密设置（8 项配置） |
-| 系统设置-存储 | `caizhilian.setting-storage.instance.*` / `.rule.*` | 存储实例与规则管理 |
-| 文件收集 | `caizhilian.file-collection.task.*` / `.scan.*` / `.run.*` / `.cancel.*` / `.delete.*` | FTP/SFTP 文件采集任务管理 |
-| 文件上传 | `caizhilian.file-upload.contract` / `.prepare` / `.upload.prepare` / `.upload.apply` | 本地文件上传到文件服务 |
-
-### 源基础设施脚本的处理方式
-
-源的通用基础设施不是业务 operation，已按 weaver-work-cli 的框架能力**等价替换**，不单独暴露：
-
-| 源文件 | 处理方式 |
-| --- | --- |
-| `scripts/cli.py`、`scripts/engine.py`、`scripts/plugin_base.py` | 由 `src/shortcuts/caizhilian/index.ts` + `operations/registry.ts` 承担（命令注册、operation 分派、prepare/apply 展开） |
-| `scripts/http_client.py` | 由 `src/shortcuts/caizhilian/host.ts` + 框架 E10 HTTP client 承担（Cookie/ETEAMSID/User-Agent 注入、超时、重试、下载流处理） |
-| `scripts/_session_helper.py`、`scripts/environment_provider.py`、`scripts/cache_manager.py`、`.cache/` | 由框架登录态管理承担（`weaver-work-cli e10 auth ...`）；业务模块不读写登录缓存 |
-| `scripts/_utils.py`、`scripts/_plugin_helpers.py` | 直译进 `operations/shared.ts`、`operations/files.ts`、`operations/api.ts`（文件元数据、上传下载、Python 语义小工具） |
-| `scripts/response_templates.py` | 输出归一逻辑直译进各 handler（`users[]` / `departments[]` / `documents[]` 等键名与字段） |
-| `scripts/reply_lint.py`、`scripts/collection_lint_skill.py` | 属于源 Skill 的回复与 Skill 自检工具，不在业务 CLI 范围 |
-| `doc-business-orchestrations/*.json` | 编排建议已落进各 reference 的「典型链路」，不作为可执行 operation 暴露 |
+| `caizhilian.system.list-systems` | 列多环境配置与登录态 | `weaver-work-cli config list`、`weaver-work-cli e10 auth status`；连通性自检用 `weaver-work-cli --json caizhilian health` |
+| `caizhilian.system.get-loaded-config` | 输出本地配置生效内容（含凭证掩码、下载目录） | `weaver-work-cli config list`；不在业务模块内暴露配置快照 |
+| `caizhilian.system.reload-config` | 重新加载本地配置 | 无需替代：CLI 每次进程启动即读取框架配置，没有进程内缓存需要刷新 |
+| `caizhilian.system.switch-config` | 在多套环境配置间切换 | `weaver-work-cli config set ...`、`weaver-work-cli e10 auth login --base-url <域名>` |
+
+系统管理能力只保留 `caizhilian.system.health`：探测接口连通性与登录态，返回
+`{ environment, healthy, base_url, url, status_code, business_code, diagnosis, elapsed_ms }`；
+本地无登录态时抛 `authentication/session_unavailable`。
 
 ## 命令
 
@@ -73,15 +48,16 @@ weaver-work-cli e10 auth status
 ## 输出处理
 
 - 用户点名要 withheld 能力时：**不要报「做不到」就结束**，要给出上表里的替代命令，并说明「环境与登录态由 weaver-work-cli 框架统一管理」。
-- 用户拿源 operation 名（如 `create_html_document`、`search_documents`）来调用时，用 `caizhilian operations` 的 `sourceOperation` 字段反查 CLI operation 名（如 `caizhilian.document.create-html.prepare` / `.apply`），再按 `write-protocol.md` 走确认链。
-- `caizhilian health` 的 `diagnosis` 字段是逗号分隔的判定项：`ok`、`network_error`、`http_error`、`http_status_mismatch`、`business_code_mismatch`、`request_failed`。非 `ok` 时把 `status_code`、`business_code`、`elapsed_ms` 一起给用户。
+- 用户用未提供的旧操作名来调用时，用 `caizhilian operations` 的 `sourceOperation` 字段反查对应的 CLI operation 名，再按 `write-protocol.md` 走确认链。
+- `caizhilian health` 的 `diagnosis` 字段是逗号分隔的判定项：`ok`、`network_error`、`http_error`、`http_status_mismatch`、`business_code_mismatch`、`request_failed`。非 `ok` 时把 `status_code`、`business_code`、
+  `elapsed_ms` 一起给用户。
 
 ## 注意
 
 - 不要为了让用户满意而**临时补出** withheld 操作，也不要用 curl / 脚本绕过 CLI 去读框架配置或登录态。
 - 不要读取、列出、打印或解析 CLI runtime 内部的登录凭据文件；认证相关一律通过 `weaver-work-cli auth` / `weaver-work-cli e10 auth` 命令。
-- 源 Skill 范围外模块的能力**不要**用 caizhilian 的 operation 去近似模拟（例如用附件上传去替代「附件全局设置」）。
-- 如果用户确实需要范围外模块，回复「需要按 skill-maker 单独生成对应模块 CLI 与 Skill」，不要在本模块里扩权。
+- 范围外的能力**不要**用相近的 operation 去近似模拟（例如用附件上传去替代「附件全局设置」）。
+- 如果用户确实需要范围外能力，回复「该能力暂未提供，需要单独评估支持」，不要在本模块里扩权。
 
 ## 失败处理
 
@@ -90,4 +66,4 @@ weaver-work-cli e10 auth status
 | `validation/operation_unknown` | 调用了 withheld 或范围外的 operation 名 | 用 `caizhilian operations` 校对，按本文件的替代命令回复用户 |
 | `authentication/session_unavailable` | `caizhilian health` 时本地无登录态 | 引导用户执行 `weaver-work-cli e10 auth login`，不要猜域名 |
 | `api/http_error` / `api/business_error` | health 探测返回非成功码 | 把 `diagnosis`、`status_code`、`business_code` 交给用户 |
-| `network/*` | health 探测网络失败 | `retryable=true` 时最多重试一次 |
+| `network/*` | health 探测网络失败 | `retryable=true` 时最多重试一次 |

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.1
+version: 1.2.3
 author: 泛微网络科技股份有限公司
 agent_created: true
 requires:
@@ -39,12 +39,16 @@ requires:
 
 ## 最高优先级：XiaoE 统一登录
 
-只有**当前智能体身份明确是 XiaoE** 时才允许走 XiaoE 统一登录。判定依据只能是宿主/任务上下文明确标识 XiaoE，或当前命令进程由 XiaoE 按次注入了成对的平台凭据。不得把以下任一情况当成 XiaoE 宿主证据：
+XiaoE 环境有两种识别入口：桌面客户端由 Agent 根据宿主或任务上下文明确识别，可接受标识包括“智能小 e 客户端”、“小 E”、`XiaoE` 或 `xiaoe-client`；传入 CLI 的环境中只要存在任意 `XIAOE_*` 变量，也直接识别为 XiaoE，包括 `XIAOE_DATA_ROOT` 等路径变量。本任务开始时只判断一次，后续命令沿用同一结论。没有 `XIAOE_*` 环境变量时，不得把以下任一情况单独当成 XiaoE 宿主证据：
 
 - 本机存在 `xiaoeUserData/tokens.py` 或 XiaoE 客户端目录；
-- 环境中只有 `XIAOE_SKILL_*`、`WEAVER_XIAOE_*` 配置或历史兼容变量；
+- 文件系统中存在客户端目录、配置文件或 Token 脚本，但这些路径没有通过 `XIAOE_*` 环境变量传入；
+- 仅有 `WEAVER_XIAOE_*`、`WORKBUDDY_*`、`CODEX_*` 环境变量；
+- 工作目录名含 `xiaoeUserData`、使用 XiaoE 内置 Node.js，或已安装相关 CLI；
 - 过去在同一台机器上登录或安装过 XiaoE。
 
+桌面客户端中，Agent 判定为 XiaoE 后先显式执行 `weaver-work-cli auth xiaoe`；后续业务命令在 `weaver-work-cli` 之后统一加 `--runtime-agent xiaoe`，例如 `weaver-work-cli --runtime-agent xiaoe workflow ...`。命令进程中已存在任意 `XIAOE_*` 变量时，不要求补这个参数。`--runtime-agent` 只控制 XiaoE 专属业务行为，不携带、不选择凭据。
+
 WorkBuddy、Codex 及其他智能体一律使用 `weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_type "<当前智能体名称>"` 走浏览器 OAuth。`auth login` / `auth oidc` 不会读取或消费 XiaoE 凭据。
 
 ### XiaoE 凭据由 CLI 独占处理（顶层强规则）
@@ -55,27 +59,29 @@ Token、Cookie、ETEAMSID 和业务凭证**只能由 `weaver-work-cli` 内部读
 - 执行 `weaver-work-cli auth export-weaver-env` 并 `eval` / `Invoke-Expression` 到当前 shell，或把 `WEAVER_*` 值写进命令、日志、报告；
 - 要求用户粘贴、或在回复中展示、转述任何凭证。
 
-下述 `auth xiaoe` 流程仅适用于上述已确认的 XiaoE 智能体环境；其他智能体不执行宿主脚本检测，直接进入浏览器 OAuth 流程。
+下述 `auth xiaoe` 流程仅适用于上述已确认的 XiaoE 智能体环境；其他智能体不执行宿主脚本检测，直接进入浏览器 OAuth 流程。`auth xiaoe` 命令本身就是认证方式的显式选择；`hasXiaoEEnv` 使用桌面的 `--runtime-agent xiaoe` 或任意 `XIAOE_*` 环境变量识别运行环境。
 
-需要登录态时只运行 `weaver-work-cli auth xiaoe`（业务命令也会自动尝试）。CLI 内部按「平台凭证 Node 换票 → CLI 自带 `xiaoe_env.py` 兼容换票 → 宿主 `tokens.py` → 桌面 XiaoE 客户端会话 → `WEAVER_XIAOE_*` 环境映射」顺序取凭据；其中 `XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 地址。`xiaoe_env.py` 属于 CLI npm 包，不放入 shared Skill，且只能由 CLI 内部执行和解析。失败时 CLI 返回结构化错误，Agent 不要替它执行脚本、安装 Python 依赖、手工取 Token 或自动引导用户在本地终端重复登录。
+需要登录态时只运行 `weaver-work-cli auth xiaoe`。CLI 内部按「平台凭证 Node 换票 → CLI 自带 `xiaoe_env.py` 兼容换票 → 宿主 `tokens.py` → 桌面 XiaoE 客户端会话 → `WEAVER_XIAOE_*` 环境映射」顺序取凭据；其中 `XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 地址。`xiaoe_env.py` 属于 CLI npm 包，不放入 shared Skill，且只能由 CLI 内部执行和解析。业务命令不再自动探测或建立 XiaoE 登录态。失败时 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 按序取凭证：① 平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`，先走 Node 换票，再由 CLI npm 包自带的标准库 `xiaoe_env.py` 作兼容回退；② 宿主 `xiaoeUserData/tokens.py`（仅桌面宿主，CLI 在 macOS/Windows 都会先自动发现 XiaoE 客户端内置 Python，再回退到系统 Python）；③ 内置原生实现读取桌面 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` 的业务命令都会先尝试上述统一登录。E10 目标地址按「显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → CLI 内置默认值」解析，绝不能把 `XIAOE_DOMAIN` 当作 E10 地址。Token、Cookie、ETEAMSID 仍属于凭证，禁止在回复中展示。
-5. XiaoE 统一登录走不通时，CLI 必须反馈未拿到登录信息的原因。Web/Linux 环境的 `auth xiaoe` 返回 `authentication/xiaoe_web_credential_unavailable`，不会自动打开 localhost 浏览器 OAuth；macOS/Windows 桌面宿主才允许自动降级。用户明确要求网页登录、且 CLI 与浏览器同机时，再显式运行 `weaver-work-cli auth login`。
-6. `auth status --no-check` 只是本地诊断，不会主动触发 XiaoE 统一登录；业务命令和 `auth xiaoe` 才会尝试写入统一登录态。具体读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
+3. XiaoE 统一登录由 CLI 按序取凭证：① 平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`，先走 Node 换票，再由 CLI npm 包自带的标准库 `xiaoe_env.py` 作兼容回退；② 宿主 `xiaoeUserData/tokens.py`（仅桌面宿主，CLI 在 macOS/Windows 都会先自动发现 XiaoE 客户端内置 Python，再回退到系统 Python）；③ 内置原生实现读取桌面 XiaoE 客户端会话换取 `eteamId`，依次查找 `XIAOE_USER_SETTINGS_PATH`、`XIAOE_ROBOT_DATA_ROOT` / `XIAOE_ROBOT_ROOT` 和默认 `XiaoE/Robots/<id>/user_settings.json`，因此会话有效时不要求存在 `tokens.py`；④ `WEAVER_XIAOE_*` 环境映射。宿主只注入 `XIAOE_DOMAIN`、`XIAOE_USER_TOKEN` 等平台变量，不会注入 ETEAMSID 环境变量，CLI 也不读取 `XIAOE_ETEAMSID`。Agent 不要打印、转述、索取或要求用户手动设置这些凭证，也不要直接执行任一脚本或因为脚本报缺依赖就让用户安装 Python 包——凭据链内部的兼容回退由 CLI 完成。
+4. `auth xiaoe` 是 XiaoE 认证方式的显式入口：CLI 不再判断当前宿主，只检查并消费可用凭据源。E10 目标地址按「显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → CLI 内置默认值」解析，绝不能把 `XIAOE_DOMAIN` 当作 E10 地址。Token、Cookie、ETEAMSID 仍属于凭证，禁止在回复中展示。
+5. XiaoE 统一登录走不通时，无论 macOS、Windows、Linux 或 Web，CLI 都返回 `authentication/xiaoe_credential_unavailable`，绝不自动打开浏览器或降级到 `auth login`。若用户明确需要浏览器 OAuth，Agent 必须另行显式运行 `auth login`。
+6. `auth status --no-check` 和业务命令都不会主动触发 XiaoE 统一登录。业务命令只读取已有登录态；具体读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
+
+`auth xiaoe` 的 preflight 会输出不含凭证的 `authMode=xiaoe`、`credentialSourceDetected`、`attempted`、`platformCredentialDetected`、`tokenScriptDetected`、`clientSettingsDetected`、`environmentCredentialDetected` 和 `baseUrl`；命中脚本分支时会出现 `Trying XiaoE token script credential...`，命中内置 Node 会话分支时会出现 `Trying built-in XiaoE client session credential...`。成功后登录结果和 `auth status` 中的 `credentialSourceStep`、`credentialSourceType`、`credentialSourceLabel` 用于确认实际来源；`2 / token_script / xiaoeUserData/tokens.py` 表示宿主脚本换票成功，`3 / xiaoe_client / XiaoE client settings` 表示不依赖 `tokens.py`、由 Node 直接换票成功。
 
-`auth login` / `auth oidc` 是严格的浏览器 OAuth 入口，即使同一台机器上存在 XiaoE 凭据或客户端文件，也不得先尝试 XiaoE 统一登录。未显式指定 `--auth` / `--profile` 的业务命令也只能在当前进程身份明确为 XiaoE 时自动尝试统一登录。
+`auth login` / `auth oidc` 是严格的浏览器 OAuth 入口，即使同一台机器上存在 XiaoE 凭据或客户端文件，也不得先尝试 XiaoE 统一登录。
 
 ### 浏览器 OAuth 防挂起（顶层强规则）
 
-`auth login`（以及 macOS/Windows 桌面宿主上的 `auth xiaoe` 降级）会在本机 `127.0.0.1:19800` 监听浏览器回调，最长等待 5 分钟。在 Agent 沙箱/托管环境中，外部浏览器无法回调容器内 `127.0.0.1:19800`，因此：
+`auth login` 会在本机 `127.0.0.1:19800` 监听浏览器回调，最长等待 5 分钟。在 Agent 沙箱/托管环境中，外部浏览器无法回调容器内 `127.0.0.1:19800`，因此：
 
-1. Web/Linux 中运行 `auth xiaoe` 时，收到 `xiaoe_web_credential_unavailable` 即反馈宿主登录态/凭据注入异常，不要自动切换 `auth login`，也不要要求用户去本地终端重复执行命令。
+1. 任意系统运行 `auth xiaoe` 时，收到 `xiaoe_credential_unavailable` 即反馈宿主登录态/凭据注入异常，不要自动切换 `auth login`，也不要要求用户去本地终端重复执行命令。
 2. 只有用户明确要求浏览器授权且确认 CLI 与浏览器同机时，才运行 `auth login`；仍须限时等待，超时未完成即终止并反馈。
 3. 用户无法本地执行浏览器登录时，经用户明确同意后改用保底方式 `weaver-work-cli auth set --eteamsid "<ETEAMSID>" --base-url "<用户确认的登录域名>"`，由用户从已登录浏览器主动提供 ETEAMSID；Agent 不得索取、展示或转述该值。
 4. 严禁不加限制地前台运行 `auth xiaoe` / `auth login` 并等待 OAuth 回调。
@@ -109,13 +115,13 @@ weaver-work-cli doctor --e10
 
 | 命令类别 | 单次超时预算 | 重试策略 |
 | --- | --- | --- |
-| 登录类（`auth xiaoe` / `auth login` / `auth set`） | 300 秒（5 分钟，后台运行 + 限时观察） | **禁止自动重试**；出现降级信号立即终止并移交用户 |
+| 登录类（`auth xiaoe` / `auth login` / `auth set`） | 300 秒（5 分钟，后台运行 + 限时观察） | **禁止自动重试**；出现浏览器 OAuth 等待信号时立即终止并移交用户 |
 | 只读业务查询（list / get / schema / preview） | 120 秒 | 最多 1 次；仅在网络类错误且未产生副作用时 |
 | 写入类（prepare / apply / import / update / delete） | 600 秒（10 分钟） | **禁止自动重试**（存在重复入账/重复提交风险）；结果不确定时只补一次只读回查 |
 | 安装与构建（`npm install` / `npm run build` / `npm link`） | 1800 秒（30 分钟） | 禁止自动重试；失败即停止并报告，不加 `sudo` |
 | 诊断类（`--version` / `doctor` / `auth status --no-check` / `skills list`） | 60 秒 | 最多 1 次 |
 
-预算是**上限**而不是必须等满：登录类一旦出现降级信号（`Open browser login` / `Waiting for E10 authorization callback` / `Could not open browser automatically`）就立即终止，不必等满 300 秒；写入类一旦拿到确定结果或返回 `partial` / `write_uncertain` 也立即停止。慢环境（容器冷启动、大依赖安装、批量导入）可以撑到上限，快环境不要人为等待。
+预算是**上限**而不是必须等满：`auth login` 一旦出现浏览器 OAuth 等待信号（`Open browser login` / `Waiting for E10 authorization callback` / `Could not open browser automatically`）就立即终止，不必等满 300 秒；写入类一旦拿到确定结果或返回 `partial` / `write_uncertain` 也立即停止。慢环境（容器冷启动、大依赖安装、批量导入）可以撑到上限，快环境不要人为等待。
 
 补充约束：
 
@@ -152,8 +158,8 @@ User-Agent: AgentType=<agentType>,IsAgent=true
 | 强触发条件 | Reference |
 | --- | --- |
 | 命令不可用、Agent 自动安装 CLI、安装、构建、全局 link、检查可用 skill | [`weaver-e10-installation.md`](references/weaver-e10-installation.md) |
-| 登录、profile、E10 会话、baseUrl、auth 文件、`WEAVER_*` / `XIAOE_*` 环境变量；**未登录或登录失效（仅 XiaoE 智能体环境先自动尝试，其它场景需要用户提供登录域名）** | [`e10-auth-and-session.md`](references/e10-auth-and-session.md) |
-| 容器/沙箱/CI/无 GUI 环境、无人值守、登录类命令超过 180 秒未结束、出现 `Open browser login` / `Waiting for E10 authorization callback` / `Could not open browser automatically`、显式传域名后仍降级、认证目录 `EACCES` | [`non-interactive-environment.md`](references/non-interactive-environment.md) |
+| 登录、profile、E10 会话、baseUrl、auth 文件、`WEAVER_*` / `XIAOE_*` 环境变量；**未登录或登录失效（明确为 XiaoE 时先显式执行 `auth xiaoe`，其它场景需要用户提供登录域名）** | [`e10-auth-and-session.md`](references/e10-auth-and-session.md) |
+| 容器/沙箱/CI/无 GUI 环境、无人值守、登录类命令超过 180 秒未结束、出现 `Open browser login` / `Waiting for E10 authorization callback` / `Could not open browser automatically`、`auth xiaoe` 返回凭据不可用、认证目录 `EACCES` | [`non-interactive-environment.md`](references/non-interactive-environment.md) |
 | 判断 stdout/stderr、JSON envelope、退出码、脚本封装、自动化调用、大结果渲染/分页控量 | [`json-output-contract.md`](references/json-output-contract.md) |
 | 准备执行写入/删除/导入/更新、遇到 `confirmation.required`、`partial.write_uncertain`、网络中断或回查失败 | [`high-risk-write.md`](references/high-risk-write.md) |
 
@@ -169,8 +175,8 @@ User-Agent: AgentType=<agentType>,IsAgent=true
 
 5. 不能猜测 CLI 未暴露的内部字段、接口路径、ID 解析逻辑或回查语义。
 
-6. 未登录或登录失效（`authentication` / `session_expired` / `auth status` 未登录）时，XiaoE 宿主环境必须先运行 `weaver-work-cli auth xiaoe` 尝试统一登录；统一登录不可用时必须反馈 CLI 原因。Web/Linux 环境不得把 `xiaoe_web_credential_unavailable` 自动改成浏览器 OAuth 或本地终端操作；只有用户明确要求且 CLI 与浏览器同机时才运行 `auth login`。执行浏览器登录时必须传入 `--agent_type "<当前智能体名称>"`，让授权确认页展示发起登录验证的智能体；**禁止**使用示例占位域名登录，也禁止在拿到域名前反复重试业务命令。具体流程读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
+6. 未登录或登录失效（`authentication` / `session_expired` / `auth status` 未登录）时，Agent 若已根据桌面端明确上下文或网页端原有环境变量规则判定为 XiaoE，必须先运行 `weaver-work-cli auth xiaoe` 尝试统一登录；统一登录不可用时必须反馈 CLI 原因。任意系统都不得把 `xiaoe_credential_unavailable` 自动改成浏览器 OAuth 或本地终端操作；只有用户明确要求且 CLI 与浏览器同机时才另行运行 `auth login`。执行浏览器登录时必须传入 `--agent_type "<当前智能体名称>"`，让授权确认页展示发起登录验证的智能体；**禁止**使用示例占位域名登录，也禁止在拿到域名前反复重试业务命令。具体流程读取 [`e10-auth-and-session.md`](references/e10-auth-and-session.md)。
 
 7. 附件、图片上传或文件解析属于敏感数据处理。即便 operation 风险等级不是高风险写入，也必须先取得用户对“文件内容可能进入大模型/外部解析服务”的明确确认；不能把用户仅提供文件路径或文件名视为同意解析或上传。
 
-8. 在 XiaoE 宿主环境中，CLI 按顺序从平台注入凭证（Node 换票后由 CLI npm 包自带 `xiaoe_env.py` 兼容回退）、宿主 `xiaoeUserData/tokens.py`、内置原生实现读取的桌面 XiaoE 客户端会话（`XiaoE/Robots/<id>/user_settings.json`）、`WEAVER_XIAOE_*` 环境映射读取支持统一登录的凭证（宿主不会注入 ETEAMSID 环境变量）。shared Skill 不携带任何 Token 脚本。`XIAOE_DOMAIN` 仅是 XiaoE/erpa 换票服务地址；E10 目标按显式参数、专用 E10 配置/映射、当前 profile、CLI 默认值的顺序解析。业务命令会在未显式指定 `--auth` / `--profile` 时自动优先尝试 XiaoE 统一登录；Agent 也可以显式调用 `weaver-work-cli auth xiaoe`。不要要求用户提供、展示或手动设置这些凭证。Web/Linux 失败时反馈结构化错误，不自动降级浏览器；macOS/Windows 桌面宿主可由 CLI 自动降级。
+8. Agent 明确选择 `auth xiaoe` 后，CLI 按顺序从平台注入凭证（Node 换票后由 CLI npm 包自带 `xiaoe_env.py` 兼容回退）、宿主 `xiaoeUserData/tokens.py`、内置原生实现读取的桌面 XiaoE 客户端会话（宿主注入路径优先、默认 `XiaoE/Robots/<id>/user_settings.json` 回退）、`WEAVER_XIAOE_*` 环境映射读取支持统一登录的凭证（宿主不会注入 ETEAMSID 环境变量）。桌面会话有效时 Node 可直接换票，不要求存在 `tokens.py`；shared Skill 也不携带任何 Token 脚本。`XIAOE_DOMAIN` 仅是 XiaoE/erpa 换票服务地址；E10 目标按显式参数、专用 E10 配置/映射、当前 profile、CLI 默认值的顺序解析。业务命令不会自动尝试 XiaoE 统一登录；桌面端需要 XiaoE 专属业务行为时，Agent 必须添加 `--runtime-agent xiaoe`，命令进程中存在任意 `XIAOE_*` 变量时也会直接识别为 XiaoE。不要要求用户提供、展示或手动设置这些凭证。任意系统失败时都反馈结构化错误，不自动降级浏览器。

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

@@ -3,7 +3,7 @@
 ## 什么时候读取
 
 用户需要登录、切换 profile、诊断 E10 连接、处理登录失效，或任务涉及 `base-url`、auth 文件、Keychain、`WEAVER_*` 环境变量时读取本文件。
-当当前智能体身份明确为 XiaoE，且认证流程涉及 `XIAOE_*` 环境变量或 `xiaoeUserData/tokens.py` 时也读取本文件。仅本机存在这些变量、文件或 XiaoE 客户端，不能用来判定当前智能体是 XiaoE。
+当宿主或任务上下文明确说明当前智能体为 XiaoE，且认证流程涉及 `XIAOE_*` 环境变量或 `xiaoeUserData/tokens.py` 时也读取本文件。桌面客户端可根据“智能小 e 客户端”“小 E”、`XiaoE`、`xiaoe-client` 等明确上下文判断，并给 CLI 传 `--runtime-agent xiaoe`；传入 CLI 的环境中存在任意 `XIAOE_*` 变量时也直接判断为 XiaoE。工作目录、客户端文件、内置 Node.js 或已安装 CLI 本身不能单独判定宿主身份。
 
 ## 基本检查
 
@@ -20,7 +20,7 @@ weaver-work-cli auth whoami
 
 登录态判断只允许通过 `weaver-work-cli auth status --no-check`、`weaver-work-cli auth profile list/current`、`weaver-work-cli doctor --e10` 和业务命令返回的 JSON 错误完成。只有用户明确提供外部 auth 文件路径时，才可按用户要求使用 `--auth <path>` 或 `E10_AUTH_PATH`；不能主动搜索旧认证目录。
 
-## 未登录 / 登录失效：仅 XiaoE 智能体自动尝试统一登录
+## 未登录 / 登录失效：由 Agent 显式选择认证方式
 
 业务命令依赖 E10 登录态。出现以下任一情况即判定为未登录或登录失效：
 
@@ -38,12 +38,12 @@ weaver-work-cli auth whoami
 
 **正确流程（按序执行，缺一不可）：**
 
-0. **仅 XiaoE 智能体环境优先自动尝试统一登录**：只有宿主/任务上下文明确标识当前智能体为 XiaoE，或当前命令进程收到 XiaoE 按次注入的成对平台凭据时，才运行：
+0. **仅 XiaoE 智能体环境由 Agent 主动选择统一登录**：桌面端宿主/任务上下文明确标识为 XiaoE，或网页端命中原有环境变量判断时，才运行：
    ```text
    weaver-work-cli auth xiaoe
    ```
-   本机存在 `xiaoeUserData/tokens.py`、XiaoE 客户端目录、`XIAOE_SKILL_*` 或 `WEAVER_XIAOE_*` 配置都只表示“凭据可能可用”，不表示“当前智能体是 XiaoE”。WorkBuddy、Codex 及其他智能体必须跳过此步，进入下方浏览器 OAuth 流程。
-   CLI 会按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile `config.baseUrl` → CLI 内置默认值”解析 E10 登录域名；`XIAOE_DOMAIN` 只作为 XiaoE/erpa 换票服务地址。业务命令在未显式指定 `--auth` / `--profile` 时，也会自动优先尝试这一步。若凭证有效，会直接保存登录态，`agentType` 固定为 `XiaoE`，然后继续原业务操作。若 Web/Linux 返回 `authentication/xiaoe_web_credential_unavailable`，反馈宿主登录态/凭据注入异常后停止，不要自动进入下方浏览器流程，也不要要求用户去本地终端重复登录。Agent 不得因为本地存在旧 profile 就跳过统一登录，也不得要求用户提供或展示 `XIAOE_*` / ETEAMSID。
+   本机存在 `xiaoeUserData/tokens.py`、XiaoE 客户端目录、工作目录或历史登录，都不能作为宿主身份依据。桌面客户端可由 `--runtime-agent xiaoe` 标识；命令进程中存在任意 `XIAOE_*` 变量时也直接标识为 XiaoE。未命中这两类判断的 WorkBuddy、Codex 及其他智能体必须跳过此步，进入下方浏览器 OAuth 流程。
+   CLI 会按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile `config.baseUrl` → CLI 内置默认值”解析 E10 登录域名；`XIAOE_DOMAIN` 只作为 XiaoE/erpa 换票服务地址。`auth xiaoe` 命令本身即代表 Agent 已选择 XiaoE 认证，CLI 只负责发现和消费凭据。业务命令不会自动触发统一登录；桌面客户端需要 XiaoE 专属业务行为时，Agent 在业务命令上显式添加全局参数 `--runtime-agent xiaoe`，命令进程中存在任意 `XIAOE_*` 变量时也会自动识别。统一登录失败时返回 `authentication/xiaoe_credential_unavailable` 并停止，任何操作系统都不自动进入浏览器流程。Agent 不得因为本地存在旧 profile 就跳过统一登录，也不得要求用户提供或展示 `XIAOE_*` / ETEAMSID。
 
 1. **先调用宿主提供的提问 / 弹框能力询问用户**，让用户二选一：
    - 输入本次要登录的 E10 登录域名（base URL），形如 `https://<企业域名>`；或
@@ -64,9 +64,9 @@ weaver-work-cli auth whoami
 
 ## 浏览器 OAuth 防挂起
 
-`auth login`（以及 macOS/Windows 桌面宿主上的 `auth xiaoe` 降级）会在本机 `127.0.0.1:19800` 监听浏览器回调，最长等待 5 分钟。Agent 沙箱/托管环境中的外部浏览器无法回调容器内地址。执行规则：
+`auth login` 会在本机 `127.0.0.1:19800` 监听浏览器回调，最长等待 5 分钟。Agent 沙箱/托管环境中的外部浏览器无法回调容器内地址。`auth xiaoe` 不会进入这条浏览器流程。执行规则：
 
-1. Web/Linux 中运行 `auth xiaoe` 时，收到 `xiaoe_web_credential_unavailable` 即反馈并停止；不要自动改跑 `auth login`。
+1. 任意系统运行 `auth xiaoe` 时，收到 `xiaoe_credential_unavailable` 即反馈并停止；不要自动改跑 `auth login`。
 2. 只有用户明确要求浏览器授权且确认 CLI 与浏览器同机时，才执行 `auth login`；仍须限时等待，超时未完成即终止并反馈。
 3. 用户无法本地执行浏览器登录时，经用户明确同意后改用保底方式 `weaver-work-cli auth set --eteamsid "<ETEAMSID>" --base-url "<用户确认的登录域名>"`，由用户从已登录浏览器主动提供 ETEAMSID；Agent 不得索取、展示或转述该值。
 4. 严禁不加限制地前台运行 `auth xiaoe` / `auth login` 并等待 OAuth 回调。
@@ -81,15 +81,17 @@ weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_ty
 
 `auth login` / `auth oidc` 是严格的浏览器 OAuth 入口，不会因为本机可发现 XiaoE 凭据、脚本或客户端文件而改走 XiaoE 统一登录。
 
-在 XiaoE 宿主环境中，`auth xiaoe` 先使用平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN` 换取 ETEAMSID（沙箱唯一可用来源）：先走 Node 主路径，失败后由 CLI npm 包自带的 `scripts/xiaoe_env.py` 作标准库兼容回退；拿不到时再读宿主 `xiaoeUserData/tokens.py` 的 stdout JSON（仅桌面宿主），再退回内置原生实现读取桌面 XiaoE 客户端会话（`XiaoE/Robots/<id>/user_settings.json`，不需要本机 Python）；仍未识别到可用凭证时，才读取 `WEAVER_XIAOE_*` 环境变量里的“当前登录域名 -> ETEAMSID”统一登录映射，并且保存的 `agentType` 固定为 `XiaoE`。`XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不能作为 E10 地址；E10 目标按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → CLI 内置默认值”解析。Node 和 Python 兼容路径都校验业务码及 `data.eteamId`，保留系统 CA 校验，只允许同源重定向或同主机 HTTP→HTTPS 升级。统一登录失败时，Web/Linux 返回 `authentication/xiaoe_web_credential_unavailable`，不自动启动 localhost 浏览器 OAuth；macOS/Windows 桌面宿主才允许自动降级。
+Agent 明确执行 `auth xiaoe` 后，CLI 先使用平台注入的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN` 换取 ETEAMSID：先走 Node 主路径，失败后由 CLI npm 包自带的 `scripts/xiaoe_env.py` 作标准库兼容回退；拿不到时再读宿主 `xiaoeUserData/tokens.py` 的 stdout JSON（仅桌面宿主），再退回内置原生实现读取桌面 XiaoE 客户端会话（优先 `XIAOE_USER_SETTINGS_PATH`，其次 `XIAOE_ROBOT_DATA_ROOT` / `XIAOE_ROBOT_ROOT`，最后默认 `XiaoE/Robots/<id>/user_settings.json`，不需要 `tokens.py` 或本机 Python）；仍未识别到可用凭证时，才读取 `WEAVER_XIAOE_*` 环境变量里的“当前登录域名 -> ETEAMSID”统一登录映射，并且保存的 `agentType` 固定为 `XiaoE`。`XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不能作为 E10 地址；E10 目标按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → CLI 内置默认值”解析。Node 和 Python 兼容路径都校验业务码及 `data.eteamId`，保留系统 CA 校验，只允许同源重定向或同主机 HTTP→HTTPS 升级。统一登录失败时，所有系统都返回 `authentication/xiaoe_credential_unavailable`，不启动 localhost 浏览器 OAuth。
 
-需要显式表达“XiaoE 优先”的场景也可以使用等价入口：
+XiaoE 认证只使用这个显式入口：
 
 ```text
 weaver-work-cli auth xiaoe
 ```
 
-该命令先尝试 XiaoE 统一登录；统一登录不可用时先反馈原因。Web/Linux 环境直接结束并返回结构化错误，不自动切换浏览器 OAuth；macOS/Windows 桌面宿主可以继续降级。用户明确切换域名时再追加 `--base-url "<用户确认的登录域名>"`。
+该命令按凭据可用性尝试 XiaoE 统一登录；统一登录不可用时直接返回结构化错误，不自动切换浏览器 OAuth，也不提供浏览器降级参数。用户明确切换域名时再追加 `--base-url "<用户确认的登录域名>"`。
+
+命令首先输出不含凭证的 preflight 摘要：`authMode=xiaoe` 表示当前命令已显式选择 XiaoE 认证，`credentialSourceDetected` 表示是否发现可用凭据源，`attempted` 表示是否实际进入统一登录链路，其余字段分别标记各来源。脚本分支开始时会打印 `Trying XiaoE token script credential...`，Node 会话分支开始时会打印 `Trying built-in XiaoE client session credential...`。成功结果及后续 `auth status` 的 `credentialSourceStep=2`、`credentialSourceType=token_script`、`credentialSourceLabel=xiaoeUserData/tokens.py` 可确认脚本换票已完成；`credentialSourceStep=3`、`credentialSourceType=xiaoe_client`、`credentialSourceLabel=XiaoE client settings` 表示未依赖 `tokens.py`、由 Node 直接换票。
 
 如果端口冲突：
 
@@ -111,8 +113,7 @@ weaver-work-cli auth login --base-url "<用户确认的登录域名>" --agent_ty
 本地文件 URL。“始终打开”偏好保存在当前本地回调地址的浏览器存储中；未识别到返回协议
 时，页面只提示用户手动返回智能体或终端。本地 CLI 打开通道默认保留 15 分钟；通道结束
 后页面会自动退回浏览器自定义协议打开方式，不直接显示网络请求错误。
-智能小 E 统一登录成功时不会经过浏览器；只有统一登录不可用并降级为桌面浏览器 OAuth 时，
-才显示“返回智能小 E”弹层。
+智能小 E 统一登录不会经过浏览器，也不会显示“返回智能小 E”弹层；该弹层只属于用户另行显式发起的 `auth login` 浏览器 OAuth。
 
 保底方式是让用户手动写入浏览器中的 `ETEAMSID`：
 
@@ -137,14 +138,14 @@ weaver-work-cli --profile PROFILE_NAME auth status --no-check
 
 ## XiaoE 凭据由 CLI 独占处理
 
-`auth xiaoe` 或业务命令触发统一登录时，CLI 按以下顺序自行取凭据，Agent **不参与、也不得复现**：
+运行 `auth xiaoe` 时，CLI 按以下顺序自行取凭据，Agent **不参与、也不得复现**；业务命令不会触发此流程：
 
 1. **平台注入凭据**：`XIAOE_USER_TOKEN` + `XIAOE_DOMAIN`（小 e 业务服务地址）。先由 Node 直接换票；失败时 CLI 可调用 npm 包自带的 `scripts/xiaoe_env.py` 兼容换票。脚本不属于 Skill，由 CLI 内部执行、解析并隐藏凭证 stdout。
 2. **宿主 `tokens.py`**：桌面宿主 `xiaoeUserData/tokens.py`（macOS `~/Library/Application Support/xiaoeUserData/tokens.py`，Windows `%LOCALAPPDATA%\xiaoeUserData\tokens.py`）；CLI 在 macOS 应用包与 Windows 按用户/全局安装目录中自动查找 XiaoE 客户端内置 Python，并优先用它执行脚本；可用 `WEAVER_XIAOE_TOKEN_SCRIPT_PATH` 指定脚本路径，用 `WEAVER_XIAOE_TOKEN_SCRIPT_PYTHON` 指定解释器。
-3. **桌面 XiaoE 客户端会话**：`XiaoE/Robots/<id>/user_settings.json` 的 `session_id` + `erpa`，由 CLI 内置 Node 实现换取 `eteamId`，不需要本机 Python。
+3. **桌面 XiaoE 客户端会话**：优先读取 `XIAOE_USER_SETTINGS_PATH`，其次从 `XIAOE_ROBOT_DATA_ROOT` / `XIAOE_ROBOT_ROOT` 查找，最后回退 `XiaoE/Robots/<id>/user_settings.json`；其中的 `session_id` + `erpa` 由 CLI 内置 Node 实现换取 `eteamId`，不需要宿主 `tokens.py` 或本机 Python。
 4. **`WEAVER_XIAOE_*` 环境映射**：当前登录域名到 ETEAMSID 的映射。
 
-Agent 禁止自行执行 `tokens.py`、`xiaoe_env.py` 或任何取 Token 脚本（其 stdout 含 ETEAMSID/Cookie/Token，会进入对话与日志），也禁止把这些脚本放入 shared Skill；禁止 `eval` / `Invoke-Expression` `auth export-weaver-env` 的输出，也禁止要求用户粘贴或展示任何凭证。脚本不存在、Python 依赖缺失、stdout 非法或接口失败，都由 CLI 内部记录并降级；Agent 只需把 CLI 反馈的原因转述给用户，不猜测或伪造 Token。
+Agent 禁止自行执行 `tokens.py`、`xiaoe_env.py` 或任何取 Token 脚本（其 stdout 含 ETEAMSID/Cookie/Token，会进入对话与日志），也禁止把这些脚本放入 shared Skill；禁止 `eval` / `Invoke-Expression` `auth export-weaver-env` 的输出，也禁止要求用户粘贴或展示任何凭证。脚本不存在、Python 依赖缺失、stdout 非法或接口失败，都由 CLI 内部记录并继续检查下一凭据源；Agent 只需把 CLI 反馈的原因转述给用户，不猜测或伪造 Token。
 
 ## 安全边界
 

package/skills/weaver-e10-shared/references/non-interactive-environment.md

@@ -6,7 +6,7 @@
 
 - 运行在容器、沙箱、CI、远程执行器或任何无 GUI / 无本地浏览器的环境
 - 无法向用户弹出输入框、选择框或确认框（无人值守）
-- `auth xiaoe` / `auth login` 输出中出现浏览器 OAuth 相关字样（见下方「降级信号」）
+- `auth login` 输出中出现浏览器 OAuth 相关字样（见下方「浏览器 OAuth 信号」）
 - 登录类命令执行时间超过 180 秒仍未结束（300 秒为硬上限，见 SKILL.md「超时与重试预算」）
 
 ## 环境判定：可交互 vs 非交互
@@ -22,19 +22,19 @@
 
 ## 登录失败信号判读
 
-Web/Linux 中 `auth xiaoe` 统一登录失败时会直接返回结构化错误：
+任意系统中 `auth xiaoe` 统一登录失败时都会直接返回结构化错误：
 
 ```text
 error.type = authentication
-error.subtype = xiaoe_web_credential_unavailable
+error.subtype = xiaoe_credential_unavailable
 error.stage = xiaoe_unified_login
 ```
 
 收到该错误后，反馈宿主登录态或凭据注入不可用并停止。不要自动执行 `auth login`，也不要要求用户在本地终端重复执行登录。
 
-只有用户明确要求浏览器授权，或 macOS/Windows 桌面宿主允许 `auth xiaoe` 自动降级时，才可能出现下列浏览器 OAuth 信号：
+`auth xiaoe` 不会自动降级到浏览器。只有用户明确要求并另行执行 `auth login` 时，才可能出现下列浏览器 OAuth 信号：
 
-| 降级信号 | 含义 |
+| 浏览器 OAuth 信号 | 含义 |
 | --- | --- |
 | `Open browser login: <url>` | 已生成浏览器授权 URL，准备跳转 OAuth |
 | `Waiting for E10 authorization callback...` | 已在本地 `127.0.0.1:<port>` 监听回调并等待 |
@@ -44,7 +44,7 @@ error.stage = xiaoe_unified_login
 在非交互环境中出现任一信号时的处置顺序：
 
 1. **立即终止**该命令，不要等待本地回调。
-2. 向用户反馈统一登录未命中的**实际原因**（凭证未取到 / 域名不在支持范围 / 当前域名与凭证不匹配 / CLI 侧能力缺口）。
+2. 向用户反馈浏览器 OAuth 在当前环境无法完成本地回调的实际原因。
 3. 不自动给出“去本地终端执行”的操作；只有用户明确要求改用浏览器授权时，才说明该方式必须在 CLI 与浏览器同机的环境执行。
 4. 用户明确要求保底方式时，可说明 `auth set`，但 Agent 不得索取、展示、转述或记录 ETEAMSID：
    ```text
@@ -57,15 +57,15 @@ error.stage = xiaoe_unified_login
 显式传入 E10 域名后仍返回统一登录错误：
 
 ```text
-weaver-work-cli auth xiaoe --base-url "<用户确认的 E10 域名>" --agent_type "<当前智能体名称>"
-# authentication/xiaoe_web_credential_unavailable
+weaver-work-cli auth xiaoe --base-url "<用户确认的 E10 域名>"
+# authentication/xiaoe_credential_unavailable
 ```
 
 判定结论与处置：
 
 - 域名与网络**不是**失败原因，不要再反复更换域名重试。
 - 这属于宿主登录态、凭据注入或当前 CLI 版本消费凭证的异常；停止并反馈，同时可记录 CLI 版本（`weaver-work-cli --version`）便于定位。
-- 不要因为一次降级就断言 CLI 不可用；只读诊断命令（`auth status --no-check`、`doctor --e10`）仍可作为环境检查手段。
+- 不要因为一次认证失败就断言 CLI 不可用；只读诊断命令（`auth status --no-check`、`doctor --e10`）仍可作为环境检查手段。
 
 ## 可写性相关说明
 
@@ -75,7 +75,7 @@ weaver-work-cli auth xiaoe --base-url "<用户确认的 E10 域名>" --agent_typ
 
 ## 收尾流程（每次登录尝试后必做）
 
-1. 记录本次结果：成功 / 降级 / 权限失败 / 超时，以及耗时与退出码。
+1. 记录本次结果：成功 / 凭据不可用 / 权限失败 / 超时，以及耗时与退出码。
 2. 非成功结果一律**不自动重试**登录类命令（见 SKILL.md「超时与重试预算」）。
 3. 用只读命令确认真实登录态，再决定是否继续业务操作：
    ```text