weaver-work-cli 0.1.25 → 0.1.26

package/dist/shortcuts/workflow/operations/read.js

@@ -1478,6 +1478,25 @@ async function enforceSearchStdoutBudget(result, env, fileName) {
     };
 }
 // ---------------------------------------------------------------------------
+// 命令耗时（`durationMs`）
+// ---------------------------------------------------------------------------
+/**
+ * 给 envelope 的 `data` 顶层补一个 `durationMs`（整数毫秒）。
+ *
+ * 口径与 `createForm` 的 `durationMs` **完全一致**（2026-10-19 用户裁定把这条命令也纳入）：
+ * 起点 = 命令 handler 入口（含会话解析、取数、落盘等全部动作），终点 = 返回之前；
+ * 放在 `data` 顶层而不是信封 `meta`，这样「超线落盘」那一档 `data` 只剩一句提示时耗时依然在。
+ *
+ * 只在 `workflow.search` / `workflow.memoryPrompt` 两条命令上接线（用户明确「其他命令暂时不动」）。
+ * `data` 不是普通对象（数组/字符串/空）时原样返回，绝不因为加耗时而改变返回形态。
+ */
+function stampDurationMs(envelope, startedAt) {
+    const data = envelope?.data;
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        return envelope;
+    return { ...envelope, data: { ...data, durationMs: Date.now() - startedAt } };
+}
+// ---------------------------------------------------------------------------
 // 序号定位（查询类写索引；查看类读索引）
 // ---------------------------------------------------------------------------
 async function saveListIndex(env, normalized) {
@@ -1566,6 +1585,8 @@ const workflowSearch = {
         queryJson: { type: 'object', description: '已生成的完整查询 JSON（跳过 build-query）' },
     }),
     handler: async (args, env) => {
+        // 耗时起点：整条命令的入口（含 plan 门禁的版本探测、取数、落盘）。
+        const startedAt = Date.now();
         const plan = args.planJson;
         if (plan && typeof plan === 'object') {
             // plan 批量编排仅智能分组模式支持（来源：Python cmd_workflow_search_plan 首行的
@@ -1578,7 +1599,7 @@ const workflowSearch = {
                 throw workflowValidationError('plan_requires_smart_mode', `plan 批量编排模式仅支持智能分组模式（OA ≥ ${formatOaVersion(SMART_GROUPING_MIN_OA_VERSION)}）；低版本请改用单条 workflow.search`, { retryAllowed: false });
             }
             // 顶层 pageSize 即 plan 的展示窗口 page_cap（来源：Python cmd_workflow_search_plan 的 page_cap）
-            return executePlanSearch(env, plan, asInt(args.pageSize) ?? 10);
+            return stampDurationMs(await executePlanSearch(env, plan, asInt(args.pageSize) ?? 10), startedAt);
         }
         const category = (asString(args.category) || 'todo');
         const searchMode = await resolveSearchMode(env);
@@ -1588,7 +1609,7 @@ const workflowSearch = {
         // grouping_active 分支）：未显式指定子分类、非 total-only、非批量取数时按「待处理/超时/紧急」
         // 分组取数并输出分组统计。smart 模式不做 CLI 侧分组（分组由模型按 countDetails 规划）。
         if (searchMode === 'legacy' && category === 'todo' && !batchType && !totalOnly && !hasExplicitTab(args)) {
-            return executeLegacyGroupedTodoSearch(env, args);
+            return stampDurationMs(await executeLegacyGroupedTodoSearch(env, args), startedAt);
         }
         const { query, tabid } = await buildSearchQuery(env, { ...args, searchMode }, 'list');
         const prefix = ENDPOINT_PREFIX[category];
@@ -1652,13 +1673,13 @@ const workflowSearch = {
             }
         }
         if (totalOnly) {
-            return workflowSuccess('workflow.search', {
+            return stampDurationMs(workflowSuccess('workflow.search', {
                 type: 'workflowSearch',
                 category,
                 categoryName: CATEGORY_NAMES[category],
                 total,
                 finalMarkdown: buildSearchFinalMarkdown(null, probes, total, category, true, searchMode === 'smart', waitReadTotal),
-            });
+            }), startedAt);
         }
         // 卡片摘要行只在 **legacy（低版本模式）** 生成——契约见 references/workflow-query.md
         // 「执行模式与返回形态」的「卡片摘要行」一行（低版本=标题/摘要/辅助三行；智能分组=标题/辅助
@@ -1674,7 +1695,7 @@ const workflowSearch = {
             await enrichWorkflowCardSummaries(env, normalized, asInt(args.pageSize) ?? normalized.pageSize);
         }
         const index = await saveListIndex(env, normalized);
-        return workflowSuccess('workflow.search', await enforceSearchStdoutBudget({
+        return stampDurationMs(workflowSuccess('workflow.search', await enforceSearchStdoutBudget({
             type: 'workflowSearch',
             category,
             categoryName: CATEGORY_NAMES[category],
@@ -1688,7 +1709,7 @@ const workflowSearch = {
             finalMarkdown: buildSearchFinalMarkdown(normalized, probes, total, category, false, searchMode === 'smart', waitReadTotal, withCardSummaries),
             queryId: index.queryId,
             sessionMap: { queryId: index.queryId, itemCount: normalized.items.length },
-        }, env, { json: 'last_search.json', md: 'last_search.md' }));
+        }, env, { json: 'last_search.json', md: 'last_search.md' })), startedAt);
     },
 };
 // ---------------------------------------------------------------------------
@@ -4815,6 +4836,8 @@ const workflowMemoryPrompt = {
         dynamicContext: { type: 'object', description: '动态上下文参数（可选，合并进 dynamicContextParams）' },
     }),
     handler: async (args, env) => {
+        // 耗时起点：整条命令的入口（含记忆接口那一趟与会话解析）。
+        const startedAt = Date.now();
         // 记忆接口契约（来源：Python memory_chat_params）：
         //   { appid: <记忆应用 ID>, dynamicContextParams: { workflowId?, ...额外上下文 } }
         // 缺 appid 时接口判为无效应用，直接返回空 promptText（available=false）——
@@ -4897,6 +4920,8 @@ const workflowMemoryPrompt = {
         if (!hasOaContext) {
             result.oaContextMissingReason = '当前 E10 会话中未包含 OA 版本与用户身份信息。请先运行 weaver-work-cli auth status 确认登录态；若会话确已失效，请用 weaver-work-cli auth login --base-url <域名> --agent_type <当前智能体名称> 重新登录后重试。';
         }
+        // 命令耗时（毫秒）：与 createForm / workflow.search 同口径，`data` 顶层。
+        result.durationMs = Date.now() - startedAt;
         return workflowSuccess('workflow.memoryPrompt', result, {
             oaContextMissing: !hasOaContext,
         });
@@ -5165,6 +5190,86 @@ export async function fetchHistoryListSnapshot(env, options = {}) {
         return null;
     }
 }
+/**
+ * 「多候选里按用户近一年的发起记录消歧」——`createForm` 澄清前的最后一次尝试。
+ *
+ * 场景（2026-10-20 用户裁定）：`workflow` 只给了名称、**多命中又没有全名精确匹配**，本来要返回
+ * 多候选澄清。但用户往往只发起过其中之一 ⇒ 用「我发起的」**工作流树**把候选里他真发起过的捞出来：
+ * 只剩一个就直接用它，不必再问一遍；否则照旧澄清。
+ *
+ * 请求 = `getMineListData` 的 body **去掉分页**（`customDisplayPage`），外加一个 `workflowid`
+ * 条件把范围**限定在待澄清候选上**（"涉及这次要澄清的那些工作流的流程"）。`workflowid` 属
+ * 浏览按钮类条件，**只认 `browserDatas`**——`multiContent` 会被服务端静默忽略（2026-09-29 实测）。
+ *
+ * 判据（用户逐字给定）：`data.data` 恰一个根、该根 `children` 恰一个子 ⇒ 唯一。子节点 id 形如
+ * `wf_<workflowId>`，去掉 `wf_` 即工作流 ID。
+ *
+ * 返回 `null` 的**所有**情形（候选不足 2 个 / 无数据 / 多个根 / 单个根多个子 / 命中项不在候选内 /
+ * 接口失败或返回异常）都由调用方**回落原澄清**：本函数只回答"能不能确定"，绝不上抛错误
+ * ——兜底查询的失败不能顶掉用户本来要看到的那条澄清文案。
+ */
+export async function pickUniqueMineWorkflow(candidates, env) {
+    const candidateIds = [];
+    const nameById = new Map();
+    for (const item of toArray(candidates)) {
+        const id = String(item?.id ?? '').trim();
+        if (!id || nameById.has(id))
+            continue;
+        candidateIds.push(id);
+        nameById.set(id, String(item?.name ?? ''));
+    }
+    // 只有一个候选时上游已经直接采用了，不会走到这里；0 个也没得消歧。
+    if (candidateIds.length < 2)
+        return null;
+    try {
+        const now = new Date();
+        const start = new Date(now.getTime() - HISTORY_LOOKBACK_DAYS * 24 * 60 * 60 * 1000);
+        const response = await env.host.workflowRequest({
+            method: 'POST',
+            path: WORKFLOW_ENDPOINTS.MINE_TREE,
+            operation: 'workflow.createForm.mineTree',
+            body: {
+                params: { tabid: DEFAULT_TABID.mine, dimension: 'mine', flowSpareType: 1, outType: 0 },
+                searchParams: {
+                    formDatas: {
+                        // 与历史取数同一口径：非草稿（未结束 + 已结束）。选项类条件必须是 `multiContent`。
+                        flowstatus: flowStatusCondition('notFinish,finish')?.condition ?? [],
+                        createdatetime: [{
+                                dateContent: [formatLocalDate(start), formatLocalDate(now)],
+                                term: 'like',
+                            }],
+                        workflowid: [{
+                                term: 'in',
+                                browserDatas: candidateIds.map((id) => ({ id, name: nameById.get(id) ?? '' })),
+                            }],
+                    },
+                    type: 'and',
+                    initSearch: false,
+                },
+            },
+        });
+        const body = (response && typeof response === 'object' ? response : {});
+        if (body.fail === true || body.status === false)
+            return null;
+        const roots = toArray(body.data?.data);
+        if (roots.length !== 1)
+            return null;
+        const children = toArray(roots[0]?.children);
+        if (children.length !== 1)
+            return null;
+        const rawId = String(children[0]?.id ?? '').trim();
+        const id = rawId.startsWith('wf_') ? rawId.slice(3) : rawId;
+        // 双保险：服务端若没认 `workflowid` 条件、回了别的流程，这里必须挡掉（宁可澄清也不猜）。
+        if (!id || !nameById.has(id))
+            return null;
+        const title = String(children[0]?.title ?? '').trim();
+        return { id, name: title || (nameById.get(id) ?? '') };
+    }
+    catch {
+        // 认证/网络/格式错误一律按"没能确定"处理 —— 澄清才是用户能继续操作的出口。
+        return null;
+    }
+}
 export async function buildHistoryRequestData(env, fields, targets, options = {}, 
 /**
  * 已提前发起的列表请求（见 `fetchHistoryListSnapshot`）。传入即直接复用，不再重复发请求；

package/dist/shortcuts/workflow/operations/sign-input.js

@@ -0,0 +1,106 @@
+import { AJAX_QUERY, FORM_ENDPOINTS } from '../endpoints.js';
+/** 接口没给出可用值时的兜底 —— 与真机默认值一致（`微软雅黑/Microsoft YaHei`、`18/18px`）。 */
+const DEFAULT_FONT_FAMILY = 'Microsoft YaHei';
+const DEFAULT_FONT_SIZE = '18px';
+const DEFAULT_FONT_ID = 'wea_rich_text_default_font';
+/**
+ * `defaultFontFamily` / `defaultFontSize` 都是「中文名/实际值」的双段形态
+ * （`微软雅黑/Microsoft YaHei`、`18/18px`）。CSS 要的是斜杠**后面**那段；没有斜杠就整段用。
+ */
+function cssValue(raw, fallback) {
+    const text = String(raw ?? '').trim();
+    if (!text)
+        return fallback;
+    const segments = text.split('/').map((item) => item.trim()).filter(Boolean);
+    const value = segments.length ? segments[segments.length - 1] : '';
+    if (!value)
+        return fallback;
+    return value;
+}
+/** 字号只给数字（`18`）时补单位 —— 否则拼出来的 `font-size:18` 是无效 CSS，浏览器会整条丢弃。 */
+function cssFontSize(raw) {
+    const value = cssValue(raw, DEFAULT_FONT_SIZE);
+    return /^\d+(\.\d+)?$/u.test(value) ? `${value}px` : value;
+}
+/**
+ * 取签字意见的默认样式。**失败一律返回 `null`**（调用方据此退回原行为），绝不阻断提交 ——
+ * 这只是给意见加样式，不能因为样式接口挂了就让整条流程发不出去。
+ */
+export async function loadSignInputCfg(env, target) {
+    const workflowId = String(target.workflowId ?? '').trim();
+    const requestId = String(target.requestId ?? '').trim();
+    // 发起流程用 `workflowId` + `isCreate:1`；提交已有流程用 `requestId` + `isCreate:0`。
+    const isCreate = workflowId && !requestId;
+    if (!isCreate && !requestId)
+        return null;
+    const body = isCreate
+        ? { isRemark: '', workflowId, isCreate: 1 }
+        : {
+            isRemark: 0,
+            operResultType: 'SUCCESS_RELOAD_CURRENT_PAGE',
+            userSpecifiedNodeId: '0',
+            autoMaxDisplay: '0',
+            isCreate: 0,
+            requestId,
+        };
+    try {
+        const response = await env.host.workflowRequest({
+            method: 'POST',
+            path: FORM_ENDPOINTS.signInputInfo,
+            // 与同族 `flowPage/*` 接口（loadBaseParam / loadFrameParam / loadMinorInfo）取同一份公共 query。
+            query: AJAX_QUERY,
+            body,
+            operation: isCreate ? 'workflow.createRequest' : 'workflow.operateApply',
+        });
+        const cfg = response?.data?.signInputCfg;
+        if (!cfg || typeof cfg !== 'object')
+            return null;
+        const raw = cfg.plainTextSignInput;
+        return {
+            plainText: raw === true || String(raw ?? '').toLowerCase() === 'true',
+            fontFamily: cssValue(cfg.defaultFontFamily, DEFAULT_FONT_FAMILY),
+            fontSize: cssFontSize(cfg.defaultFontSize),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function escapeText(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/**
+ * 把签字意见包成服务端能正确渲染的形态。
+ *
+ * - 空内容 ⇒ `_weaverMte_`（与历史一致，表示"没有意见"）；
+ * - 已带 `_weaverMte_` 前缀（模型自己给了富文本）⇒ 原样，不重复嵌套；
+ * - `cfg` 取不到 ⇒ 退回历史行为 `_weaverMte_<p>内容</p>`（不知道协商格式就不猜）；
+ * - `plainTextSignInput` 为真 ⇒ `<span id=... style=...>内容</span>`；
+ * - 否则 ⇒ `_weaverMte_<div id=... style=...><p>内容</p></div>`。
+ */
+export function wrapSignRemark(raw, cfg) {
+    const text = String(raw ?? '').trim();
+    if (!text)
+        return '_weaverMte_';
+    if (text.startsWith('_weaverMte_'))
+        return text;
+    if (!cfg)
+        return `_weaverMte_<p>${escapeText(text)}</p>`;
+    const style = `font-family:${cfg.fontFamily};font-size:${cfg.fontSize};`;
+    const escaped = escapeText(text);
+    if (cfg.plainText) {
+        return `<span id="${DEFAULT_FONT_ID}" style="${style}">${escaped}</span>`;
+    }
+    return `_weaverMte_<div id="${DEFAULT_FONT_ID}" style="${style}"><p>${escaped}</p></div>`;
+}
+/**
+ * 提交侧的入口：**只在真有意见、且还没带富文本前缀时**才去问样式接口。
+ *
+ * 没有意见 / 已经是 `_weaverMte_` 富文本 ⇒ 一次请求都不发（这两档包与不包结果一样）。
+ */
+export async function resolveSignRemark(env, raw, target) {
+    const text = String(raw ?? '').trim();
+    if (!text || text.startsWith('_weaverMte_'))
+        return wrapSignRemark(raw, null);
+    return wrapSignRemark(text, await loadSignInputCfg(env, target));
+}

package/dist/shortcuts/workflow/operations/write.js

@@ -5,6 +5,7 @@ import { defaultTabIdOf, rethrowAuthOrNetworkError, runWorkflowSearch } from './
 import { CONTINUATION_INPUT, SCHEMA_CATEGORY, SCHEMA_CONFIRM, SCHEMA_INDEX, SCHEMA_REQUEST_ID, schemaOf, workflowSuccess, } from './types.js';
 import { asInt, asString, asStringArray, compact, responseData, detailDataOf, toArray, resolveMemoryAppId } from './shared.js';
 import { WORKFLOW_ENDPOINTS } from '../endpoints.js';
+import { resolveSignRemark } from './sign-input.js';
 import { findIndexedItem, loadSearchIndex, } from '../state.js';
 // ===========================================================================
 // 工作流写操作（operate / share / batch / memory）
@@ -1013,7 +1014,14 @@ const workflowOperateApply = {
                         verification,
                     });
                 }
-                const payload = await withUserId(env, { requestId, remark });
+                // 提交前先按租户配置把签字意见包成带默认字体/字号的形态（已有流程 ⇒ `isCreate:0` + `requestId`）。
+                // 取不到样式时 `resolveSignRemark` 内部已退回原形态，不会阻断提交。
+                // **没意见就原样传空串**：这条命令历史上空意见就是 `''`（不像发起侧用 `_weaverMte_` 占位），
+                // 改成占位符会改变提交请求体，没有必要。
+                const signRemark = String(remark ?? '').trim()
+                    ? await resolveSignRemark(env, remark, { requestId })
+                    : remark;
+                const payload = await withUserId(env, { requestId, remark: signRemark });
                 if (nodeId)
                     payload.userCurrentNodeId = nodeId;
                 if (prepared.requestName)

package/dist/shortcuts/workflow/stdout-compact.js

@@ -25,7 +25,15 @@
  * 两边都正向引用，依赖图仍是单向的。
  */
 export const COMPACT_STDOUT_PATHS = {
-    'workflow.createForm': ['data.fields', 'data.historyRequestData', 'data.systemFields'],
+    // `data.data`（智能填参算出的字段值）与 `fields` 同构：键是字段 id、层级深，压掉缩进省得可观。
+    // 它与 `historyRequestData` / `systemFields` **互斥出现**（智能体成功时后两者已被删），
+    // 三个都登记在这里不会互相干扰。
+    'workflow.createForm': [
+        'data.fields',
+        'data.historyRequestData',
+        'data.systemFields',
+        'data.data',
+    ],
 };
 /** 该 operation 的紧凑路径（不声明 = 维持全量缩进）。导出让用例锁住接线。 */
 export function compactStdoutPaths(operation) {

package/docs/archive-oa.md

@@ -0,0 +1,79 @@
+# 泛微商务合同档案查询 CLI
+
+来源 Skill：`weaver-e10-archive-oa`。本模块把接口文档中可安全自动化的能力封装为 `weaver-work-cli archive-oa` 命令，供 AI Agent 通过结构化 JSON 调用。
+
+源码位于 `src/shortcuts/archive-oa`。命令注册、`operation manifest` 和业务执行逻辑分离：manifest 由 `operations/registry.ts` 汇总各 operation 定义生成，具体执行逻辑在 `src/shortcuts/archive-oa/operations` 中按业务分组维护（档案定位、合同查询、借阅车、发起借阅）。
+
+面向 Agent 的说明位于 `skills/weaver-e10-archive-oa`。入口 `SKILL.md` 只负责共享规则和 reference 路由；具体细节拆在 `skills/weaver-e10-archive-oa/references/`，与飞书 CLI 的业务 Skill 组织方式保持一致。
+
+## 公共前置
+
+先通过 E10 鉴权模块登录：
+
+```text
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn" --agent_type "<当前智能体名称>"
+weaver-work-cli auth status --no-check
+```
+
+每个业务请求由 CLI 托管：
+
+1. 读取当前 `weaver-work-cli auth` Profile 的 E10 会话。
+2. 请求只允许 `/api/`（ebuilder 业务接口）与 `/openserver/`（E10 开放服务）路径，由 CLI 携带 E10 Cookie/ETEAMSID 与必要的业务头。
+3. 响应按以下规则判定业务成功：ebuilder 列表/ESB 看 `code=200` 与 `status=true`；ebuilder 自定义接口看 `datajson.status`。
+
+Agent 不得在业务 JSON 中传 Cookie、ETEAMSID、Token 或内部控制字段。
+
+## Agent 入口
+
+优先使用 `archive-oa run <operation>`：
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli archive-oa schema
+weaver-work-cli --json archive-oa run archive-oa.contract.list --input-json '{"pageNo":1}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli archive-oa schema
+weaver-work-cli --json archive-oa run archive-oa.contract.list --input-json '{"pageNo":1}'
+```
+
+复杂或多行 JSON：先写成 UTF-8 文件，再用 `--input <path>`（`--input -` 读 stdin）。不要存在 `~/.tmp` 之类的路径假设；Windows 用 `$env:TEMP`，macOS/Linux 用临时目录。
+
+## operation 划分
+
+| 分组 | operation |
+| --- | --- |
+| 档案定位 | `archive-oa.archive.locate` |
+| 泛微合同 | `archive-oa.contract.list`、`archive-oa.contract.fields` |
+| 泛微借阅车 | `archive-oa.borrow-car.list`、`archive-oa.borrow-car.add.prepare`、`archive-oa.borrow-car.add.apply` |
+| 契约锁合同 | `archive-oa.qys.contract.list` |
+| 契约锁借阅车 | `archive-oa.qys.borrow-car.list`、`archive-oa.qys.borrow-car.add.prepare`、`archive-oa.qys.borrow-car.add.apply` |
+
+| 发起借阅（生成流程页 URL） | `archive-oa.borrow.start.url`、`archive-oa.qys.borrow.start.url` |
+
+**发起借阅由 `archive-oa.borrow.start.url` 生成流程创建页 URL**：`<baseUrl>/sp/workflow/flowpage/fullCreate/100003460000002090?fb=<fb>&data=<JSON>`，`data` 为 `[{hth, htmc, yfhd, fph}]`。该 operation 只读：不写数据、不触发流程、不需要后台应用凭据；URL 可直接在浏览器打开，表单由用户填写并提交。已下线的 `archive-oa.borrow.start.prepare` / `.apply`（OpenESB webhook）不再提供。
+
+## 两套链路的参数差异
+
+| 项 | 泛微商务合同 | 契约锁协作采纳 |
+| --- | --- | --- |
+| 合同查询 `passid` / `listId` | `850741972510941185` / `850741985437786120` | `850742853046345728` / `1190611964371984450` |
+| 借阅车 `listId` | `882393480417296390` | `883819516961857839` |
+| 加入借阅车 `esbActionIds` | `882395911377174530` | `892706856573648911` |
+
+## 写操作确认协议
+
+- `*.prepare`：只读回查与参数校验（加入借阅车会查一次借阅车现状），返回 `preview` 与 `continuation`。
+- `*.apply`：必须带 `continuation` 且 `confirm: true`（CLI `--yes`）；票据含环境与登录账号指纹，10 分钟有效。
+- 发起借阅用 `archive-oa.borrow.start.url` 生成流程页 URL（只读，`risk: read`）：生成后优先用系统默认浏览器打开，无法打开时原样输出完整 URL；流程表单由用户在浏览器确认并提交。OpenESB 版 `borrow.start.prepare` / `.apply` 已下线。
+- `failNum > 0` 时返回 `partial / write_uncertain`，不自动重放。
+
+## 参考
+
+- `skills/weaver-e10-archive-oa/SKILL.md`：Agent 路由与执行原则。
+- `skills/weaver-e10-archive-oa/references/`：按意图拆分的用法说明。
+- `skill-template/domains/archive-oa.md`：业务域 Agent 调优要点。

package/docs/e10-auth.md

@@ -57,18 +57,19 @@ Chrome/Edge 原生确认框。宿主需要返回特定会话时，可以传
 返回地址只接受桌面应用自定义协议，不接受 `http(s)`、脚本或本地文件 URL。“始终打开”
 偏好保存在当前本地回调地址的浏览器存储中。本地 CLI 打开通道默认保留 15 分钟；通道
 结束后页面会自动退回浏览器自定义协议打开方式，不直接显示网络请求错误。
-智能小 E 统一登录成功时不会经过浏览器；只有统一登录不可用并降级为桌面浏览器 OAuth 时，
-才显示“返回智能小 E”弹层。
+智能小 E 统一登录不会经过浏览器，也不会显示“返回智能小 E”弹层；该弹层只属于用户另行显式发起的 `auth login` 浏览器 OAuth。
 
-只有当前智能体身份明确为 XiaoE 时，`auth xiaoe` 和未显式指定认证来源的业务命令才先使用统一登录。Web/沙箱宿主可由成对的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN` 识别；桌面客户端则可由其精确注入的 `XIAOE_DATA_ROOT`、`XIAOE_ROBOT_DATA_ROOT`、`XIAOE_USER_SETTINGS_PATH`、`XIAOE_ROBOT_ROOT` 运行时路径标记识别。通用 `WORKBUDDY_*` / `CODEX_*` 变量可能来自 XiaoE 复用的智能体运行时，不能覆盖这些 XiaoE 信号；明确的 `WORKBUDDY_AGENT_TYPE` / `CODEX_AGENT_TYPE` 非 XiaoE 身份除外。普通 `XIAOE_SKILL_*`、`WEAVER_XIAOE_*` 配置或仅在磁盘上发现客户端文件仍不足以触发。这里的 `XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 登录地址。Node 主路径调用与 `xiaoe_env.py` / `tokens.py` 相同的接口，校验业务 `code`（`"0000"` 或 `200`）及 `data.eteamId`，保留系统 CA 校验，并只跟随同源重定向或同主机 HTTP→HTTPS 升级。Node 路径失败时，CLI 会在内部执行 npm 包自带的 `scripts/xiaoe_env.py` 兼容路径；它只依赖 Python 标准库，凭证 stdout 由 CLI 内部消费，不进入 Agent 上下文，也不会关闭 TLS 证书校验。之后才依次读取宿主 `xiaoeUserData/tokens.py`、桌面 XiaoE 客户端本地会话和 `WEAVER_XIAOE_*` ETEAMSID 映射。客户端会话优先读取 `XIAOE_USER_SETTINGS_PATH`，再从 `XIAOE_ROBOT_DATA_ROOT` / `XIAOE_ROBOT_ROOT` 查找，最后回退 macOS `~/Library/Application Support/XiaoE/Robots/<id>/user_settings.json` 或 Windows `%LOCALAPPDATA%/XiaoE/Robots/<id>/user_settings.json`；只要其中的 `session_id` 与 `erpa` 有效，Node 即可在没有 `tokens.py` 时直接换票。宿主不会注入 ETEAMSID 环境变量，CLI 也不读取 `XIAOE_ETEAMSID`。
+XiaoE 宿主身份有两种判定入口：桌面客户端由 Agent 根据“智能小 e 客户端”“小 E”、`XiaoE`、`xiaoe-client` 等明确上下文判断，并传入 `--runtime-agent xiaoe`；网页端沿用原有环境变量规则，成对的 `XIAOE_USER_TOKEN` + `XIAOE_DOMAIN` 会被识别为 XiaoE。工作目录、客户端文件、内置 Node.js、历史登录、路径变量或单个凭据变量都不能单独用于判定。判定为 XiaoE 后，Agent 显式执行 `weaver-work-cli auth xiaoe`。
 
-E10 目标地址按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → `https://www.e-cology.com.cn`”解析，绝不会把 `XIAOE_DOMAIN` 当作 E10 地址。凭证可用时，CLI 直接保存登录态，保存的 `agentType` 固定为 `XiaoE`；业务命令在未显式指定 `--auth` / `--profile` 时，也会自动优先尝试 XiaoE 统一登录。统一登录失败后，`auth xiaoe` 仅在 macOS/Windows 桌面宿主自动降级浏览器 OAuth；Web/Linux 环境直接返回 `authentication/xiaoe_web_credential_unavailable`，不再启动无法回调的 localhost 登录。用户明确希望浏览器授权且宿主能够接收本地回调时，可以显式运行 `auth login`。
+CLI 依次尝试成对的平台凭据、npm 包自带的 `scripts/xiaoe_env.py` 兼容路径、宿主 `xiaoeUserData/tokens.py`、桌面 XiaoE 客户端本地会话和 `WEAVER_XIAOE_*` ETEAMSID 映射。客户端会话优先读取 `XIAOE_USER_SETTINGS_PATH`，再从 `XIAOE_ROBOT_DATA_ROOT` / `XIAOE_ROBOT_ROOT` 查找，最后回退 macOS `~/Library/Application Support/XiaoE/Robots/<id>/user_settings.json` 或 Windows `%LOCALAPPDATA%/XiaoE/Robots/<id>/user_settings.json`。这些变量和文件只用于定位凭据，不能用于识别宿主。`XIAOE_DOMAIN` 是 XiaoE/erpa 换票服务地址，不是 E10 登录地址。
+
+E10 目标地址按“显式 `--base-url` → 专用 `WEAVER_XIAOE_*` E10 配置/映射 → 当前 profile → `https://www.e-cology.com.cn`”解析。凭证可用时，CLI 直接保存登录态，保存的 `agentType` 固定为 `XiaoE`。统一登录失败时，所有操作系统都返回 `authentication/xiaoe_credential_unavailable`，不启动浏览器 OAuth。需要浏览器授权时必须另行显式执行 `auth login`。
 
 脚本兼容链路会先自动发现桌面 XiaoE 客户端内置 Python（macOS 应用包与 Windows 按用户/全局安装均支持），再回退到系统 `python3`、`/usr/bin/python3`、`python`；Windows 的系统回退顺序为 `python`、`python3`、`py`。可用 `WEAVER_XIAOE_TOKEN_SCRIPT_PYTHON` 精确指定解释器，用 `WEAVER_XIAOE_TOKEN_SCRIPT_PATH` 指定桌面宿主脚本路径（旧名 `XIAOE_TOKEN_SCRIPT_PYTHON` / `XIAOE_TOKEN_SCRIPT_PATH` 仍兼容）。CLI 自带的 `xiaoe_env.py` 位于 npm 包 `scripts/`，不会放入 `weaver-e10-shared` Skill；Skill 包禁止携带或直接执行 Token 脚本。`XIAOE_` 是平台保留前缀，本 CLI 的自定义变量统一使用 `WEAVER_XIAOE_*`。
 
-`auth xiaoe` 会先打印不含凭证的 preflight 摘要，明确给出 `hostDetected`、`attempted`、`tokenScriptDetected`、`clientSettingsDetected` 和目标 `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 xiaoe` 会先打印不含凭证的 preflight 摘要，给出 `authMode=xiaoe`、`credentialSourceDetected`、`attempted`、各凭据源检测结果和目标 `baseUrl`。进入脚本分支时会打印 `Trying XiaoE token script credential...`；进入内置 Node 会话分支时会打印 `Trying built-in XiaoE client session credential...`。成功结果和后续 `auth status` 会显示 `credentialSourceStep`、`credentialSourceType`、`credentialSourceLabel`。
 
-上述“业务命令自动优先尝试”仅适用于当前智能体身份明确为 XiaoE 的进程。WorkBuddy、Codex 及其他智能体不会因为本机存在 XiaoE 文件或配置而进入该分支，并必须使用 `auth login --base-url <url> --agent_type <agent_type>` 的浏览器 OAuth 流程。
+业务命令不会自动建立 XiaoE 登录态。桌面客户端需要 XiaoE 专属业务行为时，Agent 必须显式传全局参数，例如 `weaver-work-cli --runtime-agent xiaoe workflow ...`；网页端由原有环境变量规则自动识别，不要求补这个参数。`--runtime-agent` 只控制运行时行为，不携带也不选择凭据。WorkBuddy、Codex 及其他智能体使用 `auth login --base-url <url> --agent_type <agent_type>` 的浏览器 OAuth 流程。
 
 无法使用浏览器回调时，可以用 `auth set` 直接写入浏览器中复制到的
 `ETEAMSID`。命令会调用 `teamsCheck` 解析当前用户、租户和组织信息，并写入

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weaver-work-cli",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "面向泛微工作工具链的可扩展 TypeScript CLI 基础框架（E10 业票通等能力）",
   "type": "module",
   "main": "./dist/index.js",

package/skill-template/business-info.json

@@ -454,5 +454,21 @@
     "审批进度",
     "审批意见",
     "今承达"
+  ],
+  "weaver-e10-archive-oa": [
+    "档案定位",
+    "合同号定位",
+    "泛微合同",
+    "契约锁",
+    "商务合同查询",
+    "合同查询",
+    "借阅车",
+    "加入借阅车",
+    "发起借阅",
+    "案例",
+    "契约锁案例",
+    "合同借阅",
+    "档案记录",
+    "合同编号"
   ]
 }

package/skill-template/domains/archive-oa.md

@@ -0,0 +1,19 @@
+本业务域为「泛微商务合同档案查询」：E10 档案定位与 OA 商务合同借阅。入口 `SKILL.md` 按飞书 `lark-approval` 风格组织：CRITICAL 共享前置、路由优先级、逐 operation 命令表、处理链、执行原则、写操作失败决策树和「不在范围」。具体用法拆到 `references/`：
+
+- `archive-locate.md`：按合同号定位档案（`htbh` 必须放 body 顶层）。
+- `contract-search.md`：泛微商务合同查询与可搜索字段配置（`commonSearchFields` 构造规则）。
+- `qys-contract-search.md`：契约锁协作采纳（案例）合同查询（默认只查已归档）。
+- `borrow-car.md`：借阅车列表；加入借阅车是临时铺垫操作，`prepare -> apply` **免用户确认、直接执行**。
+- `borrow-flow.md`：发起借阅的职责边界（用户在浏览器登录后自己操作）与给用户的指引。
+- `disabled-capabilities.md`：接口未收录与必须由用户在界面完成的操作边界。
+
+Agent 调优重点：
+
+- `weaver-work-cli archive-oa schema` 是 operation 合约第一信息源。
+- 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段；**禁止向用户索要后台应用凭据**（如 OpenESB 的 appKey / corpid / appSecret），交互中不暴露此类概念。
+- 泛微商务合同与契约锁协作采纳是两套独立应用：`passid` / `listId` / `esbActionIds` / `objId` 与流程页 `fb` 均不同，禁止交叉混用。
+- 合同行 ID（`data[*].id`）与档案记录 ID 只作为后续 operation 入参，不展示给最终用户。
+- 列表结果**只查 `pageNo=1`、禁止翻页**（不得请求 `pageNo≥2`，不循环翻页累加），单次最多展示 20 条；需要更多数据时提示用户缩小筛选条件，不得翻页获取。
+- 写操作只接受 CLI 生成的 continuation，不手工构造或复用；**加入借阅车每次最多 6 条，且免用户确认**（临时铺垫操作，只为后续发起借阅做准备，不产生最终业务结果，直接 prepare → apply 后事后回报）。发起借阅不在 CLI 能力内，由用户在界面完成。
+- 发起借阅用 `archive-oa.borrow.start.url` 生成流程页 URL（`fullCreate/<flowId>?fb=<fb>&data=<JSON>`，只读、无需后台凭据）：优先用系统默认浏览器直接打开，打不开时原样输出完整 URL 让用户手动打开；表单填写与提交由用户完成，不代填、不代提交。
+- 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。

package/skill-template/domains/yepiaotong.md

@@ -13,7 +13,7 @@
 - `invoice-add.md`：手工新增发票的 `prepare -> apply` 写入协议。
 - `invoice-update.md`：编辑发票的 `prepare -> apply` 写入协议。
 - `invoice-delete.md`：删除发票的 `prepare -> apply` 写入协议。
-- `invoice-reim.md`：发票报销自动填单的查询、组装和报销单创建/更新确认链。
+- `invoice-reim.md`：发票报销自动填单的数据准备；报销单创建/修改调用 `weaver-e10-workflow` 的 `workflow.createForm` / `workflow.createRequest` / `workflow.edit*`。
 - `invoice-issuing.md`：智能开票或存台账的开票 payload 确认链。
 - `invoice-disabled-capabilities.md`：共享、转让、标签等暂未暴露能力的处理边界。
 
@@ -23,7 +23,7 @@ Agent 调优重点：
 - 业务输入不得包含 Cookie、ETEAMSID、Token 或内部控制字段。
 - 写操作只接受 CLI 生成的 continuation，不手工构造或复用。
 - `validate=false` 只能说明跳过查验，不能描述为查验通过。
-- 报销单创建、报销单更新、开票和存台账必须先展示结构化 JSON 摘要并取得明确确认；报销单创建字段在 operation 顶层逐项传入，不包通用 `payload`。
+- 报销单创建、报销单修改、开票和存台账必须先展示摘要并取得明确确认；报销单按 `workflow.createRequest` 的 `{main, details}` 结构组装 `data`。
 - 开票前从用户输入、附件或对话上下文提取购方字段；当前资料包没有客户档案查询 operation，资料不足时追问用户补齐。
 - 当前资料包没有红字发票红冲接口，`invoice.red.*` 不属于可用 operation。
 - 结果为 `partial/write_uncertain` 时停止，不自动重放写请求。