weaver-work-cli 0.1.25 → 0.1.28

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

@@ -7,6 +7,7 @@
 // 顺序定位约定：查询类 operation 把"序号 → requestId"写入本地检索索引
 // （saveSearchIndex / findIndexedItem，由 CLI 托管，本文件不读写索引文件）；
 // 查看/操作类 operation 允许用 requestId 或 group+index 定位（findIndexedItem）。
+import { E10_REAUTH_GUIDANCE } from '../../../internal/e10/auth/messages.js';
 import { workflowSuccess, schemaOf, SCHEMA_REQUEST_ID, SCHEMA_CATEGORY, SCHEMA_INDEX, SCHEMA_PAGE_SIZE, } from './types.js';
 import { asString, asInt, asStringArray, asBool, compact, responseData, detailDataOf, toArray, resolveMemoryAppId, withLeadingMeta, STDOUT_SAFE_BYTES, stdoutBytesOf, parseNameWithId, } from './shared.js';
 import { workflowValidationError, WorkflowCliError, workflowClarificationError, CLARIFICATION_SUBTYPE, } from '../errors.js';
@@ -1478,6 +1479,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 +1586,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 +1600,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 +1610,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 +1674,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 +1696,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 +1710,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 +4837,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）——
@@ -4895,8 +4919,10 @@ const workflowMemoryPrompt = {
         result.oaContext = hasOaContext ? oaContext : null;
         result.oaContextMissing = !hasOaContext;
         if (!hasOaContext) {
-            result.oaContextMissingReason = '当前 E10 会话中未包含 OA 版本与用户身份信息。请先运行 weaver-work-cli auth status 确认登录态；若会话确已失效，请用 weaver-work-cli auth login --base-url <域名> --agent_type <当前智能体名称> 重新登录后重试。';
+            result.oaContextMissingReason = `当前 E10 会话中未包含 OA 版本与用户身份信息。请先确认登录态；若会话确已失效，${E10_REAUTH_GUIDANCE}`;
         }
+        // 命令耗时（毫秒）：与 createForm / workflow.search 同口径，`data` 顶层。
+        result.durationMs = Date.now() - startedAt;
         return workflowSuccess('workflow.memoryPrompt', result, {
             oaContextMissing: !hasOaContext,
         });
@@ -4939,6 +4965,18 @@ export const workflowReadOperations = [
 export const HISTORY_REQUEST_LIMIT = 5;
 /** 历史参考数据回溯窗口（天）：近一年。 */
 const HISTORY_LOOKBACK_DAYS = 365;
+/**
+ * 历史取数列表**只要这两列**（2026-10-26 用户口径）。
+ *
+ * 不带 `customDisplayColumns` 时服务端按"我发起的"默认列集全量解析、格式化、拼装
+ * （响应里 `columns` / `data` / `displayData` 三份都要出一遍），而我们实际只读
+ * `requestId` / `requestnameTitle` / `createdatetime` 三个字段 ⇒ 把列压到两列能直接砍掉
+ * 这部分服务端开销，接口更快返回。
+ */
+const HISTORY_LIST_COLUMNS = [
+    { dataIndex: 'requestname', type: 'text', title: '标题', width: 200, orderKey: 'requestname' },
+    { dataIndex: 'createdatetime', type: 'date', title: '创建时间', width: 150, orderKey: 'createdatetime' },
+];
 /** 本地日期 → `YYYY-MM-DD`（不用 `toISOString`：那是 UTC，会跨日）。 */
 function formatLocalDate(date) {
     const pad = (value) => String(value).padStart(2, '0');
@@ -5129,7 +5167,17 @@ export async function fetchHistoryListSnapshot(env, options = {}) {
             path: WORKFLOW_ENDPOINTS.MINE_LIST,
             operation: 'workflow.createRequest.history',
             body: {
-                params: { tabid: DEFAULT_TABID.mine, dimension: 'mine', flowSpareType: 1, outType: 0 },
+                // `needIutData: false`：关掉本次取数用不到的 IUT 附加数据（我们只看标题/创建时间）。
+                params: {
+                    tabid: DEFAULT_TABID.mine,
+                    dimension: 'mine',
+                    flowSpareType: 1,
+                    outType: 0,
+                    needIutData: false,
+                },
+                // `needParseData: true`：让服务端把日期等字段直接解析成可读文本（`displayData`），
+                // 客户端不再自己转。
+                needParseData: true,
                 searchParams: {
                     formDatas: {
                         // 非草稿 = 「未结束」+「已结束」（选项类系统条件必须是 multiContent，见 flow-status.ts；
@@ -5151,6 +5199,7 @@ export async function fetchHistoryListSnapshot(env, options = {}) {
                 },
                 customDisplayPage: { current: 1, size: HISTORY_REQUEST_LIMIT },
                 sortParams: [{ orderkey: SORT_OPTIONS['发起时间'], sortType: 'desc' }],
+                customDisplayColumns: HISTORY_LIST_COLUMNS,
             },
         });
         const listed = normalizeListResponse(listResponse, 'mine', CATEGORY_NAMES.mine);
@@ -5165,6 +5214,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,22 @@
  * 两边都正向引用，依赖图仍是单向的。
  */
 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',
+    ],
+    // `createRequestDirect`（2026-10-22 起只取数、不发起）：返回面就是「fields + historyRequestData +
+    // userMemory」，前两个同样是"逐条长、层级深"的数组 —— 压掉缩进省 24%~31%，直接把大量表单从
+    // 触线降到线下。`userMemory` 是单行 Markdown 字符串，本身没有缩进可压，不必登记。
+    'workflow.createRequestDirect': [
+        'data.fields',
+        'data.historyRequestData',
+    ],
 };
 /** 该 operation 的紧凑路径（不声明 = 维持全量缩进）。导出让用例锁住接线。 */
 export function compactStdoutPaths(operation) {

package/docs/SKILL.md

@@ -32,7 +32,7 @@ skills/weaver-e10-<name>/
 ## 已内置业务模块
 
 - `invoice`：E10 业票通发票管理。源码说明先读 `docs/invoice.md`；面向 Agent 时先读 `skills/weaver-e10-yepiaotong/SKILL.md`，再按入口路由读取对应 reference。
-- `fna`：E10 齐业成费控中心（预算查询/费用中心/借款管理/发票核销）。源码说明先读 `docs/fna.md`；面向 Agent 时先读 `skills/weaver-e10-qiyecheng/SKILL.md`，再按入口路由读取对应 reference。写操作（提醒还款/催票）走 prepare/apply 确认链。
+- `fna`：E10 齐业成费控中心（预算查询/费用中心/报销报表 AI 问答/借款管理/发票核销）。源码说明先读 `docs/fna.md`；面向 Agent 时先读 `skills/weaver-e10-qiyecheng/SKILL.md`，再按入口路由读取对应 reference。写操作（提醒还款/催票）走 prepare/apply 确认链。
 - `plan`：E10 计划报告（报告查询/新建/修改/发布/撤回/提交提醒/评论），自动适配标准版与 e10-ebuilder 两套报告接口链路。源码说明先读 `docs/plan.md`；面向 Agent 时先读 `skills/weaver-e10-plan/SKILL.md`，再按入口路由读取对应 reference。写操作走 prepare/apply 确认链。
 - `esb`：E10 ESB 中心自定义触发动作流（入参模板查询 + 触发）。源码说明先读 `docs/esb.md`；面向 Agent 时先读 `skills/weaver-e10-esb/SKILL.md`，再按入口路由读取对应 reference。触发动作流是写操作，走 prepare/apply 确认链。
 - `okr`：E10 OKR 目标管理（目标分页查询/详情、关键成果查询与保存、目标对齐、目标评论、详情页链接），按 `ver_name` 自动适配 e10 标准版与 e10-ebuilder 两套接口链路。源码说明先读 `docs/okr.md`；面向 Agent 时先读 `skills/weaver-e10-okr/SKILL.md`，再按入口路由读取对应 reference。写操作（新建/编辑目标、保存关键成果、添加目标对齐）走 prepare/apply 确认链。

package/docs/_catalog.md

@@ -10,7 +10,7 @@
 | 业票通发票管理、报销填单、智能开票、invoice operation、写操作 prepare/apply | `docs/invoice.md` |
 | E10 会议管理（标准版：查询/冲突/预约/回执/签到）、meeting operation、写操作 prepare/apply | `docs/meeting.md` |
 | 聚才林人事云（人事档案/出勤/薪酬）、ehr operation、写操作 prepare/apply | `docs/ehr.md` |
-| 齐业成费控中心（预算/费用中心/借款管理/发票核销）、fna operation、提醒还款与催票 prepare/apply | `docs/fna.md` |
+| 齐业成费控中心（预算/费用中心/报销报表 AI 问答/借款管理/发票核销）、fna operation、提醒还款与催票 prepare/apply | `docs/fna.md` |
 | 文书定档案管理（全宗/检索/借阅车/借阅单/发起借阅/预归档上传）、wenshuding operation | `docs/wenshuding.md` |
 | 计划报告管理（报告查询/新建/修改/发布/撤回/提交提醒/评论）、plan operation、写操作 prepare/apply | `docs/plan.md` |
 | OKR 目标管理（目标查询/详情、关键成果、目标对齐、评论）、okr operation、标准版与 ebuilder 双链路、写操作 prepare/apply | `docs/okr.md` |

package/docs/agent-invoice.md

@@ -67,7 +67,7 @@ weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"s
 
 删除、编辑、新增同样必须使用 `prepare -> apply`。出现 `partial/write_uncertain` 时停止，不能自动重试写操作。
 
-处理“把发票填进流程表单”的场景，使用 `invoice.browse-field.data` 生成浏览按钮控件所需 JSON。处理“报销发票/自动填单”时，先读取 `invoice-reim.md`，用报销相关只读 operation 获取事前申请、工作流、表单结构、预填信息和人员上级；Agent 组装报销单结构化 JSON 后，必须通过 `invoice.reim.flow.create.prepare/apply` 或 `invoice.reim.flow.update.prepare/apply` 写入，创建报销单的 `work_flow_id/mainFormId/request_name/main_fields/detail_rows` 等字段在 operation 顶层传入，不包通用 `payload`。处理“开票/存台账”时，先读取 `invoice-issuing.md` 和 `invoice-issuing-field-rules.md`，从用户输入或附件提取购方、税号、明细、税率和金额；资料不足时追问用户补齐，再走 `invoice.issuing.make.prepare/apply`。当前修正资料包没有客户档案查询或红字发票红冲接口，`invoice.customer.*` 和 `invoice.red.*` 不能调用或绕过。
+处理“把发票填进流程表单”的场景，使用 `invoice.browse-field.data` 生成浏览按钮控件所需 JSON。处理“报销发票/自动填单”时，先读取 `invoice-reim.md`，用报销相关只读 operation 获取事前申请、工作流、表单结构、预填信息和人员上级；Agent 组装报销单结构化 JSON 后，必须通过 `invoice.reim.flow.create.prepare/apply` 或 `invoice.reim.flow.update.prepare/apply` 写入，创建报销单的 `work_flow_id/mainFormId/request_name/main_fields/detail_rows` 等字段在 operation 顶层传入，不包通用 `payload`。处理“开票”时默认读取 `invoice-issuing-workflow.md`：用 `invoice.issuing.qys.list` 的 `groups` 按合同号选定一组，确认后调用 `weaver-e10-workflow` 的 `workflow.createForm` / `workflow.createRequest`（`action` 固定 `draft`）发起开票流程草稿。只有用户明确要求“直接开票/不走流程/存待开台账”时，才读取 `invoice-issuing-qys-ledger.md`（台账行）或 `invoice-issuing.md` + `invoice-issuing-field-rules.md`（口述字段），走 `invoice.issuing.make.prepare/apply`。当前修正资料包没有客户档案查询或红字发票红冲接口，`invoice.customer.*` 和 `invoice.red.*` 不能调用或绕过。
 
 ## 暂缓能力
 

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/caizhilian.md

@@ -4,7 +4,7 @@
 
 源码位于 `src/shortcuts/caizhilian`。命令注册、`operation manifest` 和业务执行逻辑分离：`manifest.ts` 汇总对外契约（含 `withheldOperations`），`operations/registry.ts` 由 `operations/specs.ts` 的 60 条操作规格展开成 87 条对外 operation（写操作展开为 `.prepare` / `.apply`），具体执行逻辑在 `src/shortcuts/caizhilian/operations/handlers` 中按业务分组维护（document、folder、collab、search、fileops、system），公共能力在 `operations/api.ts`、`operations/files.ts`、`operations/form.ts`、`operations/shared.ts`。
 
-面向 Agent 的说明位于 `skills/weaver-e10-caizhilian`。入口 `SKILL.md` 只负责共享规则和 reference 路由；具体细节拆在 `skills/weaver-e10-caizhilian/references/`。
+面向 Agent 的说明位于 `skills/weaver-e10-caizhilian`。入口 `SKILL.md` 只负责接入前置和 reference 路由；具体细节拆在 `skills/weaver-e10-caizhilian/references/`。
 
 ## 公共前置
 

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 登录态，首次使用仍需显式执行 `auth xiaoe`。已有会话被 E10 接口明确拒绝为失效时，公共请求运行时会静默换票并重放原请求一次；不会打印中间登录步骤，不会自动打开浏览器，也不会对流式请求、网络错误、`partial` / `write_uncertain` 做重放。桌面客户端需要 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/docs/fna.md

@@ -1,16 +1,16 @@
 # 齐业成费控中心（FNA）CLI
 
-对应 `src/shortcuts/fna`，把泛微齐业成 FNA 费控中心 11 个源接口固化为 13 个 operation（预算 2 / 费用中心 3 / 借款管理 4 / 发票核销 4，其中提醒还款与催票为 prepare/apply 写链）。源资料：`/Users/zhufangyuan/Desktop/weaver-e10-qiyecheng`（指纹见 `skills/weaver-e10-qiyecheng/references/source-manifest.json`）。
+对应 `src/shortcuts/fna`，把泛微齐业成 FNA 费控中心 12 个源接口固化为 14 个 operation（预算 2 / 费用中心 3 + 报销报表 AI 问答 1 / 借款管理 4 / 发票核销 4，其中提醒还款与催票为 prepare/apply 写链）。源资料：`/Users/zhufangyuan/Desktop/weaver-e10-qiyecheng`（指纹见 `skills/weaver-e10-qiyecheng/references/source-manifest.json`）。
 
 ## 公共前置
 
-- 认证、profile、HTTP client 由 `src/internal/e10` 托管；业务 host 只适配 `/api/fna/` 与 `/api/app/fna/` 路径（`src/shortcuts/fna/host.ts` 的 `assertPath` 白名单）。
+- 认证、profile、HTTP client 由 `src/internal/e10` 托管；业务 host 只适配 `/api/fna/`、`/api/app/fna/` 与 `/api/secondev/fna/` 路径（`src/shortcuts/fna/host.ts` 的 `assertPath` 白名单）。
 - 成功判定统一走 WeaResult（`success` 或 `status` 布尔 / `code==200`）；费用中心 AI 查询用 `success`，预算/借款/核销用 `status`。
 - JSON 输出与错误 envelope、退出码遵循共享规则；写操作不满足确认条件返回 `confirmation.required`（exit 10），请求发出后结果不确定返回 `partial/write_uncertain`（exit 11）。
 
 ## Agent 入口
 
-面向 Agent 时先读 `skills/weaver-e10-qiyecheng/SKILL.md`，再按入口路由读取 `references/`（catalog/budget/expense-center/loan-management/invoice-writeoff）。
+面向 Agent 时先读 `skills/weaver-e10-qiyecheng/SKILL.md`，再按入口路由读取 `references/`（catalog/budget/expense-center/expense-chart/loan-management/invoice-writeoff）。
 
 ## Operation 目录
 
@@ -21,6 +21,7 @@
 | `fna.expense.reimbursed.sum` | read | POST `expense/center/getSumReimbursedAmountByAi`；body 可空 |
 | `fna.expense.loan.sum` | read | POST `expense/center/getSumLoanAmountByAi`；只认数字 ID；空 data 自动重试 2 次；已知仅统计首条记录缺陷 |
 | `fna.expense.prepay.writeoff.sum` | read | POST `expense/center/selectPrepayWriteOffAmountBySkill`；body 可空 |
+| `fna.expense.chart` | read | GET `getExpenseChart`（`/api/secondev/fna/`）；`userInput` 必填 ≤500 字；`maxRows` 本地截断 1-5000，默认 200；超时 180s；返回 `kind=rows/empty/clarify/blocked/unexpected` |
 | `fna.loan.main.page` | read | POST `loanManagementMenu/mainPage` |
 | `fna.loan.main.list` | read | POST `loanManagementMenu/mainPageList`；`current`/`pageSize`/`menuCode`/`permissionSetCode` 必填 |
 | `fna.loan.remind.repay.prepare` | write | 校验 displayData 行并预览，不发送 |
@@ -39,6 +40,7 @@ Windows PowerShell：
 ```powershell
 weaver-work-cli --json fna run fna.budget.application.detail --input-json '{"requestId":"1001"}'
 weaver-work-cli --json fna run fna.expense.reimbursed.sum --input-json '{"startDate":"2026-01-01","endDate":"2026-08-31"}'
+weaver-work-cli --json fna run fna.expense.chart --input-json '{"userInput":"2026-08 各部门报销金额排名前三"}'
 weaver-work-cli --json fna run fna.loan.main.list --input-json '{"current":1,"pageSize":20,"menuCode":"fesx_fna_borrowingManagement","permissionSetCode":"fesx_fna_borrowingManagement.default"}'
 weaver-work-cli --json fna run fna.invoice.writeoff.list --input-json '{"current":1,"pageSize":20,"invoiceStatus":"unarrivedTicket"}'
 ```
@@ -48,6 +50,7 @@ macOS/Linux（bash/zsh）：
 ```bash
 weaver-work-cli --json fna run fna.budget.application.detail --input-json '{"requestId":"1001"}'
 weaver-work-cli --json fna run fna.expense.reimbursed.sum --input-json '{"startDate":"2026-01-01","endDate":"2026-08-31"}'
+weaver-work-cli --json fna run fna.expense.chart --input-json '{"userInput":"2026-08 各部门报销金额排名前三"}'
 weaver-work-cli --json fna run fna.loan.main.list --input-json '{"current":1,"pageSize":20,"menuCode":"fesx_fna_borrowingManagement","permissionSetCode":"fesx_fna_borrowingManagement.default"}'
 weaver-work-cli --json fna run fna.invoice.writeoff.list --input-json '{"current":1,"pageSize":20,"invoiceStatus":"unarrivedTicket"}'
 ```
@@ -61,6 +64,7 @@ weaver-work-cli --json fna run fna.invoice.writeoff.list --input-json '{"current
 - 日期口径：报销按明细费用日期、借款按流程创建时间、预付核销按核销记录创建时间。
 - `menuCode`/`permissionSetCode` 环境相关，示例值需与环境核对。
 - 超 2^53 的 requestId 无法用 JS 数字精确表达，保留字符串并提示人工核验（真实环境 ID 一般在安全整数内，已按数字发送）。
+- `fna.expense.chart`：`code` 恒为 200，必须按 `data` 类型/`kind` 判成败；追问与安全拦截都是字符串 `data`，`meta.messageKindInferred=true` 表示归类为 CLI 推断。实测真实查询 3.3~66.6s，CLI 超时设 180s，禁止自动重试（每次都会消耗模型额度）。不做当前人强制过滤，结果可能是全租户范围；`userInput` 为商品化输入，个人口径必须改用 `fna.expense.reimbursed.sum`。二开包未安装时该 operation 会 404/500，需与其它 `fna.*` 正常但本 operation 失败区分。
 
 ## 验证