weaver-work-cli 0.1.4 → 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/_catalog.md

@@ -8,6 +8,7 @@
 | 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` |
@@ -27,4 +28,9 @@
 | 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/meeting.md

@@ -0,0 +1,48 @@
+# meeting：E10 会议管理（标准版）
+
+## 模块来源
+
+由 `weaver-e10-skill-maker` 按 standalone 会议 Skill（weaver-e10-meeting v2.4.2）的接口契约生成，v1 覆盖**标准版（Java REST）**能力；EB 版（eBuilder formdata）链路列入禁用边界，待后续版本。
+
+## 命令结构
+
+```text
+weaver-work-cli meeting schema                       # 输出 operation manifest
+weaver-work-cli meeting run <operation> --input-json '<json>'
+weaver-work-cli meeting today                        # 今天会议（meeting.list 薄包装）
+```
+
+## operation 表
+
+| operation | 风险 | 说明 |
+| --- | --- | --- |
+| `meeting.env.detect` | read | EB/标准模式探测（EB 冒烟优先，失败回退标准） |
+| `meeting.calendar.base` | read | 建会前置判断（onlyFlowCreate/工作流配置） |
+| `meeting.list` | read | 会议列表（空 body 拉全量 + `filterDate` 客户端过滤） |
+| `meeting.detail.field` | read | 会议详情表单结构与 options |
+| `meeting.room.list` | read | 会议室列表（带时间范围返回 `disabled` 占用判断） |
+| `meeting.room.usage` | read | 会议室占用视图（bywhat 2=月 3=周 4=日） |
+| `meeting.type.list` | read | 会议类型列表（可选 count） |
+| `meeting.conflict.room` | read | 会议室冲突（cansub 语义） |
+| `meeting.conflict.member` | read | 参会人员冲突 |
+| `meeting.conflict.roomAttribute` | read | 会议室属性冲突 |
+| `meeting.create.prepare` | read-before-write | 归一化 + 建会路径检查 + 强制冲突检测 + continuation |
+| `meeting.create.apply` | high-risk-write | `operateMeetingByType SUBMIT`（需 confirm + continuation） |
+| `meeting.receipt.list` | read | 回执列表（isMobile 托管默认 false） |
+| `meeting.receipt.update.prepare` | read-before-write | 回查回执记录 id + 预览 |
+| `meeting.receipt.update.apply` | high-risk-write | 回执更新（需 confirm + continuation） |
+| `meeting.sign.list` | read | 签到记录 + 已签/未签统计 |
+
+## 关键契约（源资料实测坑位）
+
+- 新建会议 `operateType=SUBMIT` + `id:""` → 正常状态；`ADD` 只生成草稿，勿用。
+- 冲突处理看接口返回 `cansub`：false=禁止提交（直接拒绝）；true=仅提醒（建议换时间/地点）；检测失败视为冲突。**绝不提供"强制新建"选项**。
+- 周期会议 `finishAt` 必填（仅 1=次数 / 2=日期，禁止 0）；`repeatDesc` 由 CLI 自动拼接。
+- 回执更新必须传回执记录 `id`（prepare 自动按 `memberId` 回查）；`attendStatus` 0/1/2。
+- 超 2^53 的 id 一律字符串传递。
+
+## 已知限制（withheld）
+
+- EB 版业务链路（create_meeting/三件套/议题/纪要/报表）未实现。
+- `onlyFlowCreate=1`、周期会议工作流需要 workflow 集成，`create.prepare` 会主动拒绝。
+- 签到二维码（getQrCode 入参未确认）、签到写、会议室/类型管理、会议变更/取消/结束未实现。

package/docs/yimiaoban.md

@@ -0,0 +1,86 @@
+# 易秒办即时通讯（yimiaoban）
+
+`yimiaoban` 是 E10 易秒办即时通讯的聚合命令，覆盖**消息（msg）**、**必达（ding）**、**群组（group）**、**会话（session）**、**系统消息（sysmsg）**，以及支撑能力人员解析（person）、文件上传/预览（file）、用户状态（user）、i18n 标签（i18n）。
+
+```text
+weaver-work-cli yimiaoban --help
+weaver-work-cli yimiaoban schema
+weaver-work-cli --json yimiaoban run <operation> --input -
+```
+
+`schema` 是能力清单的唯一事实来源，包含每个 operation 的 `inputSchema`、`risk`、`requiresConfirmation`。
+
+## 实现位置
+
+| 路径 | 职责 |
+| --- | --- |
+| `src/shortcuts/yimiaoban/index.ts` | 命令注册与 JSON envelope |
+| `src/shortcuts/yimiaoban/manifest.ts` | `schema` 契约 |
+| `src/shortcuts/yimiaoban/host.ts` | E10 会话桥接、认证头、executeIm/文件上传、hrm 人员解析、i18n、媒体 URL |
+| `src/shortcuts/yimiaoban/continuation.ts` | 写操作确认链的 HMAC-SHA256 token |
+| `src/shortcuts/yimiaoban/operations/` | 按业务域拆分的 operation 实现 |
+| `src/shortcuts/yimiaoban/operations/registry.ts` | operation 注册表与去重校验 |
+
+## 认证
+
+复用 `src/internal/e10` 的 E10 会话（`requireE10Session`），请求自动携带 `Cookie`、`eteamsid` 与 `X-Requested-With: XMLHttpRequest`。IM 接口前缀 `/api/em/msg/executeIm`，必达例外走 `/api/em/msg/createDing`。业务代码不接触认证目录，路径强制以 `/api/` 开头。
+
+## 红线（模块内强制）
+
+- 请求体禁止传操作人字段（user/sender/creator/operator），操作者由 `eteamsid` 识别。
+- 人名一律走 hrm：`/api/hrm/common/getEmployeeByIds` 解析，禁止用 IM 群成员 `name` 字段。
+- uid/cid/群 id 是 uint64，一律字符串传输且非 0。
+- 过滤全部服务端完成；分页单页默认 20（群搜索 100），不自动翻页拉全量。
+- 时间范围查询换算为消息 id 区间（`resolveStartEnd`/`makeMinMaxIdByTm`）。
+- 全空白文本不算内容（拒绝发送空白消息）；普通请求 15 秒超时即失败不重试（上传 15/60 秒）。
+- 媒体只给需登录态的 URL，真要看内容用 `file.download` 落地到本地（父目录须存在、拒绝覆盖）。
+- 消息内容完整透出，不截断；展示规则见 Skill `safety-boundaries.md`。
+
+## 消息拉取与展示
+
+`msg.sync.single`（对方 `fromUid`+`fromCid` 必填）、`msg.sync.group`（`groupId` 必填，type=0 固定）为倒序单页拉取；`actionMsg.code=1303` 表示无聊天记录，按成功空列表处理，并返回 `empty:true` + `emptyReason`（区分当天无消息/时间范围无消息/会话无历史）。单页有更多数据时返回 `nextStart`（下页 `start` 锚点）与 `dedupeHint`（边界消息会重复，需按 `msgid` 去重）。
+
+返回的 `messages[]` 已按 msgParser 语义解析为结构化行：
+
+- `sender`：自己显示「我」（按会话 uid 判定），他人优先消息 `sname`、其次 hrm 姓名、最后回退 uid；`time`；`typeName`；`content`：完整正文（@ 提及已还原、媒体显示 `[图片]名称`/`[视频]名称`/`[文件]名称`）。
+- `fileName`：媒体消息原始文件名（便于单独渲染）；富文本分段解析支持图片/文件/视频/语音/位置。
+- `media`：图片/视频/文件的预览与下载 URL（weappAuthStr 构造，需登录态）。
+- `must`：必达标记。会话副标题媒体消息按 `[类型]名称` 展示，必达保留 `[必达]` 前缀。
+
+## 写协议与 continuation
+
+所有写操作（send/withdraw/top.set/ding/group 系列）统一 `prepare → apply`：
+
+- `prepare`：只读校验（成员解析、源消息读取、接收人计算），返回 `summary` + `continuation`（HMAC-SHA256 签名，10 分钟有效，含 baseUrl/profile/userId 指纹与 snapshot 指纹）。
+- `apply`：必须 `confirm:true` + 有效 continuation；校验租户/账号一致（`context_mismatch`）与目标指纹（`target_changed`）；执行后不确定结果返回 `partial/write_uncertain`，禁止自动重试。
+
+## 分组速览（以 schema 为准）
+
+| 前缀 | 覆盖 |
+| --- | --- |
+| `yimiaoban.person.*` | resolve / resolveByIds |
+| `yimiaoban.msg.sync.*` / `msg.top.sync` / `msg.read.*` | 消息拉取/置顶/阅读状态 |
+| `yimiaoban.msg.send.*` / `msg.withdraw` / `msg.top.set` | 发送/撤回/置顶（写，两段式） |
+| `yimiaoban.ding.send.*` | 必达/转必达（写，两段式） |
+| `yimiaoban.group.search/info/users/admins/exist/userExist/announce.*` | 群读 |
+| `yimiaoban.group.create/invite/kick/exit/destroy/join/modify/rename/announce.modify` | 群写（两段式） |
+| `yimiaoban.session.list` / `sysmsg.*` | 会话与系统消息 |
+| `yimiaoban.file.upload/preview/download` / `user.state` / `i18n.labels` | 文件/状态/翻译 |
+
+## 平台示例
+
+Windows PowerShell：
+
+```powershell
+weaver-work-cli --json yimiaoban run yimiaoban.msg.sync.group --input-json '{"groupId":"1788334281700000004","num":20,"latest":true}'
+weaver-work-cli --json yimiaoban run yimiaoban.group.users --input-json '{"groupId":"1788334281700000004"}'
+weaver-work-cli --json yimiaoban run yimiaoban.session.list --input-json '{"num":20}'
+```
+
+macOS/Linux（bash/zsh）：
+
+```bash
+weaver-work-cli --json yimiaoban run yimiaoban.msg.sync.group --input-json '{"groupId":"1788334281700000004","num":20,"latest":true}'
+weaver-work-cli --json yimiaoban run yimiaoban.group.users --input-json '{"groupId":"1788334281700000004"}'
+weaver-work-cli --json yimiaoban run yimiaoban.session.list --input-json '{"num":20}'
+```

package/package.json

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

package/skill-template/business-info.json

@@ -1,4 +1,6 @@
 {
+  "weaver-e10-calendar": ["日程", "日程管理", "创建日程", "日程列表", "日程详情", "删除日程", "日程类型", "紧急程度", "日历"],
+  "weaver-e10-meeting": ["会议", "会议室", "预约会议", "建会", "会议冲突", "签到", "回执", "会议类型", "会议室占用", "今天会议", "下一场会议", "会议列表", "请假回执"],
   "weaver-e10-wenshuding": ["文书定", "档案", "全宗", "预归档", "档案检索", "全文检索", "借阅车", "借阅单", "借阅", "续借", "档案下载", "原文下载", "预归档上传", "电子文件库"],
   "weaver-e10-yepiaotong": ["业票通", "发票", "票夹", "OCR", "查验", "报销发票", "自动填单", "事前申请报销", "开票", "存台账", "发票浏览按钮"],
   "weaver-e10-jucailin": ["聚才林", "人事", "人事档案", "通讯录", "出勤", "考勤", "打卡", "申诉", "薪酬", "工资单", "社保", "招聘", "人才", "候选人", "面试", "Offer", "入职"],
@@ -11,5 +13,6 @@
   "weaver-e10-jiuchuanhui": ["九氚汇", "营销管理", "CRM", "客户", "联系人", "商机", "线索", "联系计划", "联系记录", "跟进记录", "公海", "客户公海", "赢单", "输单", "线索转客户", "客户经理"],
   "weaver-e10-skill-maker": ["业务模块 CLI", "业务模块 Skill", "生成 Skill", "生成 operation", "自定义 Skill", "能力封装", "源资料更新检测"],
   "weaver-e10-shared": ["安装", "登录", "认证", "E10", "profile", "JSON 输出", "高风险写入"],
-  "weaver-e10-ziguanjia": ["资管家", "资产管理", "固定资产", "资产", "资产领用", "资产归还", "资产报修", "资产采购", "折旧", "资产地点", "资产状态", "资产类型"]
+  "weaver-e10-ziguanjia": ["资管家", "资产管理", "固定资产", "资产", "资产领用", "资产归还", "资产报修", "资产采购", "折旧", "资产地点", "资产状态", "资产类型"],
+  "weaver-e10-yimiaoban": ["易秒办", "即时通讯", "聊天", "单聊消息", "群聊消息", "群消息", "发消息", "撤回", "置顶", "必达", "Ding", "建群", "拉群", "群成员", "踢人", "退群", "解散群", "群公告", "群主", "管理员", "会话列表", "最近会话", "系统消息", "聊天记录", "历史消息", "发送文件", "发送图片", "在线状态", "下载附件", "查看图片"]
 }

package/skill-template/domains/meeting.md

@@ -0,0 +1,3 @@
+# 会议（meeting）业务域
+
+会议域覆盖 E10 标准版会议应用：环境模式探测、会议列表、会议室与占用视图、会议类型、冲突检测、预约会议（prepare/apply 确认链）、回执与签到查询。入口 `SKILL.md` 只做路由；具体命令、字段约束与失败处理拆到 `references/`（meeting-queries / meeting-create / meeting-receipts-signs）。关键安全边界：预约与回执更新是高风险写，必须走 prepare→用户确认→apply；冲突命中（含仅提醒）绝不提供"强制新建"选项；EB 版链路与工作流建会在 v1 未实现，见 manifest 的 withheldOperations。

package/skill-template/domains/yimiaoban.md

@@ -0,0 +1,21 @@
+本业务域用于泛微 E10 易秒办即时通讯（消息/群组/会话/系统消息），包括读与写。入口 `SKILL.md` 先路由到 `weaver-e10-shared/SKILL.md`，再给出 Reference 路由表、关键差异（消息行已解析且标注「我」、人名走 hrm、uid/cid 字符串化、单页不翻全量且边界去重、时间范围转 id 区间、1303 空页说明、媒体需下载落地、展示完整不截断）与写操作 prepare→apply 协议。具体用法拆到 `references/`：
+
+- `person.md`：姓名/工号/手机/邮箱解析、uid 批量解析（人名唯一合法来源，走 hrm）。
+- `field-resolution.md`：名称 → ID 判定、同名消歧、未匹配处理、接口间上下文传递契约。
+- `msg-read.md`：单聊/群聊消息拉取、群置顶、阅读状态（只读；1303=无记录按空处理）。
+- `msg-write.md`：发单聊/群聊（文本/图片/文件）、撤回、群消息置顶的 prepare→apply 写入协议。
+- `ding-write.md`：普通必达与转必达（createDing）、仅未读/指定接收人的 prepare→apply 写入协议。
+- `group-read.md`：群搜索/信息/成员/群主管理员/存在性/公告（只读）。
+- `group-write.md`：建群/邀请/踢/退/解散/申请入群/改群属性/群名/群公告的 prepare→apply 写入协议。
+- `session-sysmsg.md`：会话列表与系统消息分组/类型/消息查询。
+- `file-user-i18n.md`：文件上传/预览 URL/下载落地、用户在线状态、i18n 标签翻译。
+- `safety-boundaries.md`：红线（禁操作人字段、人名走 hrm、id 非 0 字符串、不本地过滤、不自动全量翻页、拒绝空白消息、15 秒超时、未匹配不猜测、禁止拉全量统计、完整展示）、写链停止条件、已知限制、数据对不上提问模板。
+- `error-codes.md`：业务错误码含义与处理建议（群 12xx / 消息 15xx / 数据 13xx + CLI 校验错误）。
+- `source-manifest.json`：源资料清单与 sha256 指纹，用于源资料更新检测。
+
+调优重点：
+
+- `weaver-work-cli yimiaoban schema` 是 operation 合约第一信息源；所有 operation 名与 `inputSchema` 以它为准。
+- 人名/群成员姓名一律由 CLI 走 hrm 解析；会话副标题与消息内容媒体展示用 `[图片]名称`/`[文件]名称`/`[视频]名称`、必达加 `[必达]`，媒体预览/下载 URL 需登录态，真正查看用 `file.download` 落地。
+- 消息正文完整展示不截断；`|` 转义、换行保留提示；禁止把长文缩成摘要后再展示。
+- 写操作只接受 CLI 签发的 continuation；`apply` 不确定结果时先只读回查，不自动重试。

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

@@ -17,6 +17,7 @@ cliHelp: "weaver-work-cli calendar --help"
 
 **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
 
+
 本技能覆盖日程管理业务域：**创建日程**、**查询列表**、**查询详情**、**查询总数**、**更新日程**、**删除日程**、**查询类型/紧急程度字典**、**应用版本检测**。写操作（创建/更新/删除）全部走 prepare→apply 确认协议。
 
 ## 命令入口

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

@@ -17,6 +17,7 @@ cliHelp: "weaver-work-cli esb --help"
 
 **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
 
+
 本技能覆盖 ESB 中心的**自定义触发类型动作流**：取入参模板（只读）与执行动作流（写操作，需确认）。按动作流名称解析 ID、唯一值对应的 `primary_key` SQL 查询都不在本技能范围内，见「不在范围」。
 
 ## 命令入口

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

@@ -104,7 +104,7 @@
     }
   },
   "artifactBaseline": {
-    "aggregateSha256": "c0a7668d9def3681808407bdea47ad53bdba6e90003bfd8a64f09473a4fed4b7",
+    "aggregateSha256": "37985ab4ee42990df1edf9d9922f820f199116dfb4da0f3127402884d25e5325",
     "files": [
       {
         "path": "docs/_catalog.md",
@@ -148,8 +148,8 @@
       },
       {
         "path": "skills/weaver-e10-esb/SKILL.md",
-        "size": 6644,
-        "sha256": "f0e9bb98576a438bbd18898a2fe53dd0f3d9efa2b7f1a22f22cefe08c21a207a"
+        "size": 6799,
+        "sha256": "20b0eb14c79a31188c7dfefd4de0adc9e5c53dfb93b10bdd18d71d4c228a84b9"
       },
       {
         "path": "src/shortcuts/esb/continuation.ts",

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

@@ -17,6 +17,7 @@ cliHelp: "weaver-work-cli hrm --help"
 
 **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
 
+
 本技能覆盖组织管理三大业务域：**员工（employee）**、**组织（org）**、**岗位（position）**，全部为只读查询，无写操作。代理商查询（`containsDls=true`）属于禁用边界，见 [`references/employee.md`](references/employee.md)。
 
 ## 命令入口

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

@@ -14,6 +14,7 @@ cliHelp: "weaver-work-cli jiuchuanhui --help"
 ---
 
 **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
+
 认证和登录态只能按共享规则通过 `weaver-work-cli auth ...` 命令判断；CLI 会自动携带完整 Cookie、`eteamsid` 与 `User-Agent: AgentType=<agentType>,IsAgent=true`，业务调用方不得覆盖这三条 header，也不得在业务 JSON 中传入这些 key。禁止直接读取、列出、打印或解析用户主目录下的 `.e10-cli`、auth、config 或 Keychain 数据。
 所有命令通过 `weaver-work-cli --json jiuchuanhui run <operation>` 执行：简单 JSON 传 `--input-json '<json>'`，复杂或多行 JSON 先写入 UTF-8 文件再传 `--input <path>`，只有确认当前 shell 能稳定传管道时才使用 `--input -`。调用前先按需读取 references 下对应的文件，查参数结构，不要猜字段；**references 是第一信息源**，`weaver-work-cli jiuchuanhui schema` 是 operation、字段和风险等级的合约来源。
 命令示例、提示词和临时说明必须同时兼容 Windows 和 macOS/Linux；涉及 JSON 输入、用户目录、路径分隔符、Python 启动器、文件删除、目录查看或文件比对时，同时给 Windows PowerShell 与 macOS/Linux（bash/zsh）两套示例。Agent 先根据当前系统和 shell 选择对应示例，不确定时用 `node -p "process.platform"` 判断。Windows/PowerShell 下不要使用 `printf`、`$HOME/...`、`~/...`、bash 反斜杠续行、`rm/ls/diff/python3` 等 Unix-only 写法。

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

@@ -17,6 +17,7 @@ cliHelp: "weaver-work-cli ehr --help"
 
 **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../weaver-e10-shared/SKILL.md`](../weaver-e10-shared/SKILL.md)，其中包含安装、E10 认证、JSON 输出和高风险写入规则。若不存在则必须先执行 `weaver-work-cli skills install shared --skills-dir <当前Agent的Skills目录>`，若 CLI 未安装则先执行 `npm install -g weaver-work-cli`，安装或读取失败时必须停止执行。**
 
+
 本技能覆盖聚才林业务域：**人事档案（hr）**、**出勤管理（attend）**、**薪酬管理（salary）**、**招聘（recruit，读 + 写）**。招聘写操作走 prepare→apply 确认协议；撤销类写操作不实现，原因见 [`references/safety-boundaries.md`](references/safety-boundaries.md)。
 
 ## 命令入口