weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/yimiaoban/operations/shared.js

@@ -0,0 +1,236 @@
+import { ymbValidationError, ymbBusinessError } from '../errors.js';
+/**
+ * 禁止出现在输入对象中的键：
+ * - 原型污染防护：`__proto__`/`constructor`/`prototype`
+ * - 操作人红线：`user`/`sender`/`operator`（操作者由会话 eteamsid 识别，请求体一律不传）
+ */
+const FORBIDDEN_KEYS = new Set(['__proto__', 'constructor', 'prototype', 'user', 'sender', 'operator']);
+export function asObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw ymbValidationError('input_not_object', '输入必须是 JSON 对象');
+    }
+    return value;
+}
+export function assertNoForbiddenKeys(input) {
+    for (const key of Object.keys(input)) {
+        if (FORBIDDEN_KEYS.has(key)) {
+            throw ymbValidationError('forbidden_key', `输入包含非法字段：${key}`);
+        }
+    }
+}
+/** 校验 uid/cid 非空且非 0（易秒办红线：uid/cid 不得为 0）。 */
+export function assertNonZeroId(value, field) {
+    if (value === undefined || value === null || value === '') {
+        throw ymbValidationError('id_required', `${field} 必填`);
+    }
+    const text = String(value).trim();
+    if (!/^\d+$/.test(text) || text === '0') {
+        throw ymbValidationError('id_invalid', `${field} 必须是非 0 数字 ID`);
+    }
+    return text;
+}
+/** 拆分逗号分隔 id 列表（uint64 按字符串保留），去空。 */
+export function splitIds(value, field) {
+    if (value === undefined || value === null || value === '') {
+        throw ymbValidationError('id_list_required', `${field} 必填`);
+    }
+    const list = String(value).split(',').map((s) => s.trim()).filter(Boolean);
+    if (list.length === 0) {
+        throw ymbValidationError('id_list_empty', `${field} 不能为空`);
+    }
+    for (const item of list) {
+        if (!/^\d+$/.test(item) || item === '0') {
+            throw ymbValidationError('id_invalid', `${field} 含非法 id（必须非 0 数字）：${item}`);
+        }
+    }
+    return list;
+}
+/** 无符号整数转换（uint32 等），拒绝小数/负数。 */
+export function toUint(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const numeric = Number(value);
+    if (!Number.isInteger(numeric) || numeric < 0) {
+        throw ymbValidationError('number_invalid', `${field} 必须是非负整数`);
+    }
+    return numeric;
+}
+/** 正整数转换。 */
+export function toPositiveInt(value, field) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const numeric = Number(value);
+    if (!Number.isInteger(numeric) || numeric <= 0) {
+        throw ymbValidationError('number_invalid', `${field} 必须是正整数`);
+    }
+    return numeric;
+}
+/** 移除值为 undefined 的键。 */
+export function compact(body) {
+    for (const key of Object.keys(body)) {
+        if (body[key] === undefined)
+            delete body[key];
+    }
+    return body;
+}
+/** 时间（unix 秒）→ 消息 id 最小/最大值（fwutils MakeMinAndMaxIdByTm）。返回字符串（超 JS 安全整数）。 */
+export function makeMinMaxIdByTm(tmSec) {
+    if (!tmSec || tmSec <= 0)
+        return { min: '0', max: '0' };
+    const base = BigInt(Math.floor(tmSec)) * 1000000000n;
+    return { min: base.toString(), max: (base + 999999999n).toString() };
+}
+/**
+ * 解析时间参数为 unix 秒（按本地时区）：
+ *   - 10 位纯数字：视为 unix 秒
+ *   - YYYY-MM-DD：isEnd=false → 当天 00:00:00；isEnd=true → 当天 23:59:59
+ *   - YYYY-MM-DD HH:mm[:ss]
+ */
+export function parseTimeToSec(arg, isEnd) {
+    if (arg === undefined || arg === null || arg === '')
+        return 0;
+    const s = String(arg).trim();
+    if (/^\d{10}$/.test(s))
+        return Number(s);
+    const m = s.match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:[ T](\d{1,2}):(\d{1,2})(?::(\d{1,2}))?)?$/);
+    if (!m) {
+        throw ymbValidationError('time_invalid', `无法解析时间参数: ${s}（支持 unix 秒 / YYYY-MM-DD / YYYY-MM-DD HH:mm:ss）`);
+    }
+    const hh = m[4] !== undefined ? Number(m[4]) : (isEnd ? 23 : 0);
+    const mm = m[5] !== undefined ? Number(m[5]) : (isEnd ? 59 : 0);
+    const ss = m[6] !== undefined ? Number(m[6]) : (isEnd ? 59 : 0);
+    return Math.floor(new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]), hh, mm, ss).getTime() / 1000);
+}
+/** 当天 00:00:00 / 23:59:59 的 unix 秒（本地时区）。 */
+export function todayRange() {
+    const now = new Date();
+    const start = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0);
+    const end = new Date(now.getFullYear(), now.getMonth(), now.getDate(), 23, 59, 59);
+    return { fromSec: Math.floor(start.getTime() / 1000), toSec: Math.floor(end.getTime() / 1000) };
+}
+/** 时间展示统一格式：YYYY/M/D HH:MM:SS（unix 秒输入）。 */
+export function formatFullTime(ts) {
+    if (ts === undefined || ts === null || ts === '')
+        return '-';
+    const d = new Date(Number(ts) * 1000);
+    if (Number.isNaN(d.getTime()))
+        return '-';
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}/${d.getMonth() + 1}/${d.getDate()} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+/** 校验枚举取值。 */
+export function assertEnum(value, allowed, field) {
+    const text = typeof value === 'string' ? value : String(value);
+    if (!allowed.includes(text)) {
+        throw ymbValidationError('enum_invalid', `${field} 取值必须是 ${allowed.join(' / ')} 之一`);
+    }
+    return text;
+}
+/** 从 IM 响应 JSON 中提取 actionMsg（路径多样兼容）。 */
+export function findActionMsg(value) {
+    const candidate = value?.data?.actionMsg ?? value?.actionMsg;
+    if (candidate === undefined || candidate === null)
+        return null;
+    return {
+        code: candidate.code !== undefined ? candidate.code : 0,
+        message: candidate.message ?? candidate.msg ?? '',
+    };
+}
+/** 判断 IM 业务是否成功（actionMsg.code === 0）。失败抛 business_error。 */
+export function assertImOk(value, actionLabel) {
+    const msg = findActionMsg(value);
+    if (msg === null) {
+        // 无 actionMsg 时回退顶层 code===200 && status 判定（sendDing 等路径）
+        if (Number(value?.code) === 200 && value?.status)
+            return;
+        throw ymbBusinessError('business_error', `${actionLabel}失败：缺少 actionMsg`, {
+            details: { raw: value },
+        });
+    }
+    if (Number(msg.code) === 0)
+        return;
+    const message = msg.message || `${actionLabel}失败（actionMsg.code=${msg.code}）`;
+    throw ymbBusinessError('action_failed', message, { code: msg.code });
+}
+/** 取出响应 data 主体（兼容 data.data.data / data.data 等路径）。 */
+export function unwrapInner(value) {
+    return value?.data?.data ?? value?.data;
+}
+/** 群成员条目判定（成员行至少含 uid 或 user 身份）。 */
+function isMemberRow(value) {
+    return Boolean(value) && typeof value === 'object' && (value.uid !== undefined || value.user !== undefined);
+}
+/**
+ * 从 getGroupUsers 响应主体提取成员数组。
+ * 兼容服务端历史形态：`users` / `members` / `datas`（含 `datas[].datas` 嵌套），
+ * 避免因响应包裹层不同导致「群内没有可接收成员」这类误判。
+ */
+export function extractGroupMembers(inner) {
+    if (!inner || typeof inner !== 'object')
+        return [];
+    for (const key of ['users', 'members']) {
+        const list = inner[key];
+        if (Array.isArray(list) && list.some(isMemberRow))
+            return list;
+    }
+    const datas = Array.isArray(inner.datas) ? inner.datas : [];
+    if (datas.some(isMemberRow))
+        return datas;
+    const nested = [];
+    for (const group of datas) {
+        if (Array.isArray(group?.datas))
+            nested.push(...group.datas);
+    }
+    return nested;
+}
+/**
+ * 当前登录用户 uid（易秒办 IM uid = E10 登录 userId）。
+ * 仅用于展示层识别「我」，请求体依旧不携带任何操作人字段。
+ */
+export async function resolveAuthUid(host) {
+    try {
+        const session = await host.getSession();
+        return str(session?.userId);
+    }
+    catch {
+        return '';
+    }
+}
+/** 消息页最小 ser_msgid（`hasMore` 时作为下一页 `start` 锚点；服务端返回含边界那条，需按 msgid 去重）。 */
+export function minMsgId(messages) {
+    let min = null;
+    for (const message of messages) {
+        const id = str(message?.msgid);
+        if (!/^\d+$/.test(id))
+            continue;
+        if (min === null || BigInt(id) < BigInt(min))
+            min = id;
+    }
+    return min ?? '';
+}
+/** 枚举值转成 string（可能为字符串数字）。 */
+export function str(value) {
+    if (value === undefined || value === null)
+        return '';
+    return String(value);
+}
+/** 解析消息 JSON 字符串或对象。 */
+export function parseMsg(value) {
+    if (!value)
+        return null;
+    if (typeof value === 'string') {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (typeof value === 'object')
+        return value;
+    return null;
+}
+/**
+ * 媒体文件上传所需文件大小上限（消息图片/文件常规场景按服务端约束执行）。
+ */
+export const MAX_UPLOAD_BYTES = 1024 * 1024 * 200;

package/dist/shortcuts/yimiaoban/operations/types.js

@@ -0,0 +1,27 @@
+export const READ = 'read';
+export const WRITE = 'write';
+export function ymbSuccess(action, data, meta) {
+    const payload = { ok: true, action, data };
+    if (meta && Object.keys(meta).length > 0)
+        payload.meta = meta;
+    return payload;
+}
+/** 构造「对象类型 + 严格禁止额外字段」的 JSON Schema。 */
+export function schemaOf(properties, options = {}) {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        ...(options.required?.length ? { required: options.required } : {}),
+        ...(options.description ? { description: options.description } : {}),
+    };
+}
+export const SCHEMA_INTEGER_POSITIVE = { type: 'integer', minimum: 1 };
+export const SCHEMA_NUMBER_POSITIVE = { type: 'number', exclusiveMinimum: 0 };
+export const SCHEMA_ID = { oneOf: [{ type: 'integer' }, { type: 'string', pattern: '^\\d+$' }] };
+export const SCHEMA_ID_LIST = { type: 'array', items: SCHEMA_ID };
+export const SCHEMA_STRING = { type: 'string' };
+export const SCHEMA_STRING_LIST = { type: 'array', items: { type: 'string' } };
+export const SCHEMA_BOOLEAN = { type: 'boolean' };
+export const SCHEMA_INTEGER = { type: 'integer' };
+export const SCHEMA_NUMBER = { type: 'number' };

package/dist/shortcuts/yimiaoban/operations/write-util.js

@@ -0,0 +1,78 @@
+import { createHash } from 'node:crypto';
+import { ymbConfirmationError, ymbValidationError } from '../errors.js';
+import { ymbSuccess } from './types.js';
+import { assertNoForbiddenKeys } from './shared.js';
+function fingerprint(value) {
+    return createHash('sha256').update(JSON.stringify(value ?? null)).digest('hex').slice(0, 32);
+}
+function requireConfirm(action) {
+    throw ymbConfirmationError(action, { hint: '重新调用时传入 confirm=true 与 prepare 返回的 continuation' });
+}
+async function verifyLease(continuationToken, action, env) {
+    const lease = await env.continuation.verify(continuationToken, action);
+    const session = await env.host.getSession();
+    if (lease.baseUrl !== session.baseUrl || lease.profile !== session.profile || lease.userId !== session.userId) {
+        throw ymbValidationError('context_mismatch', '确认上下文已变化（租户或登录账号不同），请重新执行 prepare');
+    }
+    return lease;
+}
+export function makeWritePair(options) {
+    return {
+        async prepare(args, env) {
+            assertNoForbiddenKeys(args);
+            const plan = await options.plan(args, env);
+            const session = await env.host.getSession();
+            const token = await env.continuation.issue({
+                operation: options.action,
+                baseUrl: session.baseUrl,
+                profile: session.profile,
+                userId: session.userId,
+                snapshotFingerprint: fingerprint(plan.snapshot),
+                plan: plan.snapshot,
+            });
+            return ymbSuccess(`${options.action}.prepare`, {
+                summary: plan.summary,
+                continuation: token,
+                hint: '确认无误后调用 ' + options.action + '.apply，传 confirm:true 与 continuation',
+            });
+        },
+        async apply(args, env) {
+            assertNoForbiddenKeys(args);
+            if (args.confirm !== true)
+                requireConfirm(options.action);
+            const lease = await verifyLease(String(args.continuation ?? ''), options.action, env);
+            const plan = lease.plan;
+            if (lease.snapshotFingerprint !== fingerprint(plan)) {
+                throw ymbValidationError('target_changed', '写入目标/内容与 prepare 时不一致，请重新执行 prepare');
+            }
+            const data = await options.execute(plan, env);
+            return ymbSuccess(`${options.action}.apply`, data);
+        },
+    };
+}
+/** fileObj → 图片消息 img 对象。 */
+export function fileObjToImg(fileObj) {
+    const img = { src: String(fileObj.id || fileObj.fileid) };
+    if (fileObj.name)
+        img.nm = String(fileObj.name);
+    if (fileObj.type)
+        img.t = String(fileObj.type);
+    if (fileObj.imgWidth !== undefined && fileObj.imgWidth !== null)
+        img.w = String(fileObj.imgWidth);
+    if (fileObj.imgHeight !== undefined && fileObj.imgHeight !== null)
+        img.h = String(fileObj.imgHeight);
+    if (fileObj.size !== undefined && fileObj.size !== null)
+        img.s = String(fileObj.size);
+    return img;
+}
+/** fileObj → 文件消息 file 对象。 */
+export function fileObjToFile(fileObj) {
+    const f = { id: String(fileObj.id || fileObj.fileid) };
+    if (fileObj.name)
+        f.nm = String(fileObj.name);
+    if (fileObj.type)
+        f.t = String(fileObj.type);
+    if (fileObj.size !== undefined && fileObj.size !== null)
+        f.s = String(fileObj.size);
+    return f;
+}

package/dist/shortcuts/yimiaoban/operations.js

@@ -0,0 +1,8 @@
+import { getYmbOperation } from './operations/registry.js';
+import { asObject, assertNoForbiddenKeys } from './operations/shared.js';
+export async function executeYmbOperation(operation, rawInput, context) {
+    const definition = getYmbOperation(operation);
+    const input = asObject(rawInput);
+    assertNoForbiddenKeys(input);
+    return definition.handler(input, context);
+}

package/docs/SKILL.md

@@ -6,22 +6,22 @@
 
 - `src/cmd`：框架内置命令、平台命令和 `skills list/read`。
 - `src/internal/e10`：E10 session、profile、auth 文件和 API client。
-- `src/shortcuts`：面向人和 Agent 的高层业务 CLI 能力，按业务模块分目录；模块内每个业务 operation 用相对独立的 class 封装。
-- `skills`：随包发布的 Agent Skill，按业务模块分目录；每个模块对应一个独立 Skill，入口 `SKILL.md` 只做路由，具体操作细节放到 `references/`，公共约束通过 `weaver-work-cli-shared` 复用。
+- `src/shortcuts`：面向人和 Agent 的高层业务 CLI 能力，按业务模块分目录；模块内每个业务 operation 用相对独立的 class 封装。使用 Skill Maker 新增业务模块时，默认同步生成或更新对应 shortcut。
+- `skills`：随包发布的 Agent Skill，按业务模块分目录；每个模块对应一个独立 Skill，入口 `SKILL.md` 只做路由，具体操作细节放到 `references/`，公共约束通过 `weaver-e10-shared` 复用。
 - `skill-template`：新增或重写业务 Skill 的模板来源；结构参考飞书 CLI 的 `skill-template`，用于保持入口、路由关键词、业务域说明和 reference 拆分方式一致。
 
 使用内置 docs 命令可以把当前文档目录复制到业务工作区：
 
-```bash
+```text
 weaver-work-cli docs copy
 ```
 
-后续业务 shortcut 应在 `src/shortcuts/<name>` 下维护源码，在 `skills/weaver-work-cli-<name>` 下维护对应 Agent Skill，在 `_catalog.md` 和 `skill-template/business-info.json` 中补充对应的加载规则。业务 Skill 直接声明并调用 `weaver-work-cli` bin，不为每个业务模块复制 bootstrap 脚本。
+后续业务模块应在 `src/shortcuts/<name>` 下维护源码，在 `skills/weaver-e10-<name>` 下维护对应 Agent Skill，在 `_catalog.md` 和 `skill-template/business-info.json` 中补充对应的加载规则。新增或更新模块时，先按 `skills/weaver-e10-skill-maker/references/module-cli-generation.md` 定正确实现面、operation 合约、测试断言和 Skill/CLI 一致性。业务 Skill 直接声明并调用 `weaver-work-cli` bin，不为每个业务模块复制 bootstrap 脚本。
 
 业务 Skill 目录约定：
 
 ```text
-skills/weaver-work-cli-<name>/
+skills/weaver-e10-<name>/
   SKILL.md                  入口路由：共享规则、schema、reference 索引、禁用边界。
   product.json              可选：Skill 包元信息。
   references/               具体业务 reference，按用户意图和 operation 分文件。
@@ -31,6 +31,10 @@ skills/weaver-work-cli-<name>/
 
 ## 已内置业务模块
 
-- `invoice`：E10 业票通发票管理。源码说明先读 `docs/invoice.md`；面向 Agent 时先读 `skills/weaver-work-cli-invoice/SKILL.md`，再按入口路由读取对应 reference。
+- `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 确认链。
+- `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 确认链。
+- `skill-maker`：把用户提供的新业务模块文档或代码转换成 `weaver-e10-*` Agent Skill，通过源资料指纹检测更新，用泛微技能检测工具做发布前静态质检，并在检测通过后询问是否安装到当前智能体。面向 Agent 时先读 `skills/weaver-e10-skill-maker/SKILL.md`。
 
-Agent 调用业务能力时优先使用 `weaver-work-cli --json invoice run <operation> --input -`，不要绕过 CLI 直接拼业务 HTTP。
+Agent 调用业务能力时优先使用 `weaver-work-cli --json <command> run <operation> --input-json '<json>'`；复杂或多行 JSON 用 UTF-8 文件和 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。不要绕过 CLI 直接拼业务 HTTP。新增业务模块时，如果源资料不足以实现 CLI，先向用户列出缺口并确认，不生成假 operation。

package/docs/_catalog.md

@@ -5,9 +5,32 @@
 | CLI 框架、钩子、system/platform/business 分层、新增模块 | `docs/SKILL.md` |
 | E10 鉴权、profile、共享 API client | `docs/e10-auth.md` |
 | Agent Skill 模板、业务域关键词、入口和 reference 拆分方式 | `skill-template/` |
-| Agent 共享规则、安装检查、JSON 输出、高风险写入 | `skills/weaver-work-cli-shared/SKILL.md` |
-| Agent 共享规则细节：安装、E10 登录、JSON 输出、写入协议 | `skills/weaver-work-cli-shared/references/` |
-| 业票通发票管理、invoice operation、写操作 prepare/apply | `docs/invoice.md` |
+| Agent 共享规则、安装检查、JSON 输出、高风险写入 | `skills/weaver-e10-shared/SKILL.md` |
+| Agent 共享规则细节：安装、E10 登录、JSON 输出、写入协议 | `skills/weaver-e10-shared/references/` |
+| 业票通发票管理、报销填单、智能开票、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` |
+| 文书定档案管理（全宗/检索/借阅车/借阅单/发起借阅/预归档上传）、wenshuding operation | `docs/wenshuding.md` |
+| 计划报告管理（报告查询/新建/修改/发布/撤回/提交提醒/评论）、plan operation、写操作 prepare/apply | `docs/plan.md` |
+| E10 ESB 中心自定义触发动作流（入参模板查询 / prepare-apply 触发）、esb operation | `docs/esb.md` |
+| 快速安装 CLI，并使用 CLI/Skill Maker 生成、验证、打包和安装业务模块 Skill | `docs/operation-manual.md` |
 | 把随包 Agent Skill 安装/升级到本机 Agent（Codex/WorkBuddy 目录、从本地仓库发布最新版） | `docs/agent-skill-install.md` |
-| Agent 调用业票通 CLI 的入口路由 | `skills/weaver-work-cli-invoice/SKILL.md` |
-| Agent 调用业票通 CLI 的具体 reference | `skills/weaver-work-cli-invoice/references/` |
+| Agent 调用业票通 CLI 的入口路由 | `skills/weaver-e10-yepiaotong/SKILL.md` |
+| Agent 调用业票通 CLI 的具体 reference | `skills/weaver-e10-yepiaotong/references/` |
+| Agent 调用聚才林 CLI 的入口路由 | `skills/weaver-e10-jucailin/SKILL.md` |
+| Agent 调用聚才林 CLI 的具体 reference | `skills/weaver-e10-jucailin/references/` |
+| Agent 调用文书定 CLI 的入口路由 | `skills/weaver-e10-wenshuding/SKILL.md` |
+| Agent 调用文书定 CLI 的具体 reference | `skills/weaver-e10-wenshuding/references/` |
+| Agent 调用齐业成费控 CLI 的入口路由 | `skills/weaver-e10-qiyecheng/SKILL.md` |
+| Agent 调用齐业成费控 CLI 的具体 reference | `skills/weaver-e10-qiyecheng/references/` |
+| Agent 调用计划报告 CLI 的入口路由 | `skills/weaver-e10-plan/SKILL.md` |
+| Agent 调用计划报告 CLI 的具体 reference | `skills/weaver-e10-plan/references/` |
+| Agent 调用 ESB 动作流 CLI 的入口路由 | `skills/weaver-e10-esb/SKILL.md` |
+| Agent 调用 ESB 动作流 CLI 的具体 reference | `skills/weaver-e10-esb/references/` |
+| Agent 调用会议管理 CLI 的入口路由 | `skills/weaver-e10-meeting/SKILL.md` |
+| Agent 调用会议管理 CLI 的具体 reference | `skills/weaver-e10-meeting/references/` |
+| 易秒办即时通讯（消息/群组/会话/系统消息）、yimiaoban operation、写操作 prepare/apply | `docs/yimiaoban.md` |
+| Agent 调用易秒办 CLI 的入口路由 | `skills/weaver-e10-yimiaoban/SKILL.md` |
+| Agent 调用易秒办 CLI 的具体 reference | `skills/weaver-e10-yimiaoban/references/` |
+| 将新业务模块文档或代码同步转换为 weaver-work-cli 业务 CLI 与 Skill、检测源资料更新 | `skills/weaver-e10-skill-maker/SKILL.md` |

package/docs/agent-invoice.md

@@ -4,13 +4,13 @@
 
 安装后的 Agent Skill 已拆为入口和 references：
 
-- `skills/weaver-work-cli-shared/SKILL.md`：安装检查、E10 认证、JSON 输出、高风险写入和安全边界。
-- `skills/weaver-work-cli-invoice/SKILL.md`：业票通入口路由。
-- `skills/weaver-work-cli-invoice/references/`：按 schema、查询、文件预览、写入、暂缓能力拆分的具体说明。
+- `skills/weaver-e10-shared/SKILL.md`：安装检查、E10 认证、JSON 输出、高风险写入和安全边界。
+- `skills/weaver-e10-yepiaotong/SKILL.md`：业票通入口路由。
+- `skills/weaver-e10-yepiaotong/references/`：按 schema、查询、文件预览、流程发票字段、报销、开票、写入和暂缓能力拆分的具体说明。
 
 ## 准备
 
-```bash
+```text
 weaver-work-cli --version
 weaver-work-cli doctor --e10
 weaver-work-cli invoice schema
@@ -18,16 +18,24 @@ weaver-work-cli invoice schema
 
 如未登录，先让用户完成：
 
-```bash
-weaver-work-cli auth login --base-url "https://weapp.xxx.cn"
+```text
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn" --agent_type "<当前智能体名称>"
 ```
 
 ## 固定入口
 
-Agent 优先使用：
+Agent 优先使用统一 operation 入口。简单 JSON 用 `--input-json`，复杂 JSON 用临时文件和 `--input <path>`；只有确认当前 shell 能稳定传管道时才使用 `--input -`。
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
+```
+
+macOS/Linux（bash/zsh）：
 
 ```bash
-weaver-work-cli --json invoice run <operation> --input -
+weaver-work-cli --json invoice run invoice.list --input-json '{"page_size":10,"start_pos":0}'
 ```
 
 不要直接 `curl`、`fetch` 或浏览器自动化访问 E10 `/api/inc/*`。不要输出或索取 Cookie、ETEAMSID、发票 Token。
@@ -55,9 +63,11 @@ weaver-work-cli --json invoice run <operation> --input -
 
 删除、编辑、新增同样必须使用 `prepare -> apply`。出现 `partial/write_uncertain` 时停止，不能自动重试写操作。
 
+处理“把发票填进流程表单”的场景，使用 `invoice.browse-field.data` 生成浏览按钮控件所需 JSON。处理“报销发票/自动填单”时，先读取 `invoice-reim.md`，用报销相关只读 operation 获取事前申请、工作流、表单结构、预填信息和人员上级；Agent 组装 payload 后，必须通过 `invoice.reim.flow.create.prepare/apply` 或 `invoice.reim.flow.update.prepare/apply` 写入。处理“开票/存台账”时，先读取 `invoice-issuing.md`，字段提取、税率确认和金额校验完成后，再走 `invoice.issuing.make.prepare/apply`。
+
 ## 暂缓能力
 
-以下原始接口文档存在，但当前不暴露为 Agent 操作：
+以下新版源资料已有提交接口，但当前仍不暴露为 Agent 操作：
 
 - 共享发票：缺接收人的稳定 `appid/cid/uid` 解析和共享关系回查契约。
 - 转让发票：会改变持有人，缺接收人侧归属回查契约。