weaver-work-cli 0.1.29 → 0.1.31

package/dist/shortcuts/meeting/operations/pipeline.js

@@ -0,0 +1,489 @@
+/**
+ * 一条命令跑完：群聊 → 纪要 → 文档 → 决议任务 → 推回群聊。
+ *
+ * 背景（2026-10-27 用户确认）：前面四段各自验证通过，但小程序里要调 3~4 次、
+ * 每次多 1.7 秒冷启动，串起来才好用。
+ *
+ * 设计原则：
+ * - **默认跑到文档为止**（`level` 默认 `document`）；`tasks` / `notify` 属写操作，
+ *   必须显式 `confirm:true` 才执行 —— 不带 confirm 时给出"将要创建的任务 + 将要发出的
+ *   群消息"预览，由调用方给用户确认后再跑第二次。
+ * - **不重复建决议**：会议已有任务时默认跳过（`skipExistingTasks` 默认 true），
+ *   否则每次重跑都会再糊一层任务上去（这个坑我在测试环境踩过）。
+ * - 群消息内容用**本次刚创建的任务**拼，不去回查服务端 —— ESL 联动生成任务有延迟，
+ *   回查可能拿到空列表，导致发出"没有任务"的通知。
+ */
+import { meetingValidationError } from '../errors.js';
+import { meetingSuccess } from './types.js';
+import { formatTaskMessage } from './task-notify.js';
+function textOf(value) {
+    return value === undefined || value === null ? '' : String(value);
+}
+const LEVELS = ['text', 'minutes', 'document', 'tasks', 'notify'];
+/** 从纪要原文里提取「@某人 负责 xxx」式分工。 */
+export function extractAssignments(transcript) {
+    const found = [];
+    const seen = new Set();
+    for (const rawLine of transcript.split('\n')) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('【'))
+            continue; // 摘要表头不是发言
+        const colon = line.indexOf('：');
+        if (colon < 0)
+            continue;
+        const body = line.slice(colon + 1).trimStart();
+        // 跳过我们自己推送到群里的通知/摘要（内容以【开头），否则会把"测试（@王五）"
+        // 这类转述又提取一遍，凭空多出任务
+        if (body.startsWith('【'))
+            continue;
+        if (!body.includes('负责'))
+            continue;
+        // ⚠️ `@` 必须处在词首（行首/空白/中文标点之后）：
+        // 否则 `yanfa3@163.com` 里的 `@163.com` 会被当成"@了 163.com 这个人"。
+        // 账号本身允许含 `@` 与 `.`（邮箱式账号 `caiwu2@163.com`），所以不能按 `@` 截断。
+        const mentions = [...body.matchAll(/(^|[\s，,。；;、：:（(])[@＠]([^\s，,。；;、：:（）()]+)/gu)].map((match) => {
+            const at = (match.index ?? 0) + match[1].length;
+            const account = match[2].replace(/[）)】\]，,。；;、：:]+$/u, '');
+            return { at, account, end: at + 1 + match[2].length };
+        }).filter((mention) => mention.account.length > 0);
+        // 没有 @ 的写法也要能抽：`卜伟领：负责竞品梳理，周五前给初稿`
+        // （用户提供的会议材料/纪要文件里常见这种句式，不一定带 @）。
+        if (mentions.length === 0) {
+            // 「负责人是 xxx」是描述，不是分工；带 @ 的行交给上面的提及逻辑，这里不重复处理
+            if (!/^负责(?!人)/u.test(body))
+                continue;
+            if (/[@＠]/u.test(body))
+                continue;
+            const speaker = line.slice(0, colon).trim().split(/\s+/u).pop() ?? '';
+            if (!speaker)
+                continue;
+            const title = body
+                .slice('负责'.length)
+                .replace(/^[\s:：,，、-]+/u, '')
+                .replace(/[。；;，,、\s]+$/u, '')
+                .trim()
+                .slice(0, 60);
+            if (!title)
+                continue;
+            const key = `${speaker}|${title}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            found.push({ account: speaker, title });
+            continue;
+        }
+        mentions.forEach((mention, index) => {
+            const segmentEnd = index + 1 < mentions.length ? mentions[index + 1].at : body.length;
+            const segment = body.slice(mention.end, segmentEnd);
+            // 「负责」归属于它前面那个人；隔着别人的 @ 就说明不是这句的主语
+            if (!segment.includes('负责'))
+                return;
+            const after = segment.slice(segment.indexOf('负责') + '负责'.length);
+            const title = after.replace(/^[\s:：,，、-]+/u, '').replace(/[。；;，,、\s]+$/u, '').trim().slice(0, 60);
+            if (!title)
+                return;
+            const key = `${mention.account}|${title}`;
+            if (seen.has(key))
+                return;
+            seen.add(key);
+            found.push({ account: mention.account, title });
+        });
+    }
+    return found;
+}
+/** 计划截止时间：从起点往后 N 天的 18:00。 */
+export function defaultDueDate(begin, days) {
+    const trimmed = begin.trim();
+    // ⚠️ 只给日期时不能拼 `:00`（会变成 `2026-10-30:00`，解析成 Invalid Date 后静默退回今天）
+    const normalized = /^\d{4}-\d{2}-\d{2}$/u.test(trimmed)
+        ? `${trimmed} 00:00:00`
+        : trimmed.length <= 16
+            ? `${trimmed}:00`
+            : trimmed;
+    const base = new Date(normalized.replace(/-/g, '/'));
+    const start = Number.isNaN(base.getTime()) ? new Date() : base;
+    const due = new Date(start.getTime() + Math.max(days, 1) * 24 * 3600_000);
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${due.getFullYear()}-${pad(due.getMonth() + 1)}-${pad(due.getDate())} 18:00`;
+}
+/**
+ * 等「决议任务」被 ESB 联动生成出来。任务数涨了才算成功。
+ * 抽出来是为了能单测 —— 这段等待直接决定群消息内容对不对，不能只靠"看着像通了"。
+ */
+export async function waitForTaskIncrease(fetchTotal, baseline, timeoutMs = 15_000, intervalMs = 2_000) {
+    const start = Date.now();
+    let total = baseline;
+    while (Date.now() - start < timeoutMs) {
+        await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        total = await fetchTotal();
+        if (total > baseline)
+            return { total, waitedMs: Date.now() - start, increased: true };
+    }
+    return { total, waitedMs: Date.now() - start, increased: false };
+}
+/**
+ * 决定"要建哪些任务"。
+ * 主路径是调用方（智能体）读原文后自己分析出的 `decisions` —— 任务该由模型按语义理解；
+ * 关键词匹配只是没传 decisions 时的兜底，覆盖不到「我来出方案」「先请 @某人 梳理」这类句式。
+ */
+export function resolveTaskAssignments(decisions, transcript) {
+    const provided = Array.isArray(decisions) ? decisions : [];
+    const providedAssignments = provided
+        .map((item) => ({
+        account: textOf(item?.executor).trim(),
+        title: textOf(item?.title).trim(),
+    }))
+        .filter((item) => item.account !== '' && item.title !== '');
+    if (providedAssignments.length > 0)
+        return { assignments: providedAssignments, source: 'agent' };
+    return {
+        assignments: extractAssignments(transcript),
+        source: 'keyword',
+        ...(provided.length > 0
+            ? { warning: '传入的 decisions 没有可用条目（executor/title 为空），已回退到关键词兜底' }
+            : {}),
+    };
+}
+const meetingPipelineRun = {
+    name: 'meeting.pipeline.run',
+    resource: 'pipeline',
+    method: 'run',
+    action: 'meeting.pipeline.run',
+    summary: '一条命令从群聊跑到任务：群消息→纪要原文→纪要文案(ESB633)→文档(ESB628)→提交决议(ESB 自动生成任务)→推送群聊；提交决议/发群需 confirm:true',
+    capability: 'pipeline',
+    risk: 'high-risk-write',
+    requiresConfirmation: true,
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            mt_id: { type: 'string', pattern: '^\\d+$', description: '会议 id（必填）' },
+            level: {
+                type: 'string',
+                enum: [...LEVELS],
+                description: 'text=只出原文；minutes=生成纪要文案；document=再生成文档（默认）；'
+                    + 'tasks=再提交决议（决议任务由 ESB 自动生成，CLI 不手工建）；notify=再把任务推到群聊。'
+                    + 'tasks/notify 需要 confirm:true',
+            },
+            confirm: {
+                type: 'boolean',
+                description: '执行 tasks/notify（建任务、发群消息）必须显式 true；不传则只跑到文档并给出预览',
+            },
+            skipExistingTasks: {
+                type: 'boolean',
+                description: '会议已有决议任务时跳过创建（默认 true），避免重复叠加',
+            },
+            taskDueDays: { type: 'integer', minimum: 1, maximum: 90, description: '任务计划截止 = 会议结束 + N 天（默认 7）' },
+            subject: { type: 'string', description: '纪要标题，默认「群聊纪要-<会议名>」' },
+            minuteId: {
+                type: 'string',
+                pattern: '^\\d+$',
+                description: '复用已有纪要 id（跳过「群聊→纪要」这一段）。预览后确认时传回，避免重复建纪要',
+            },
+            files: {
+                type: 'array',
+                items: { type: 'string' },
+                description: '用户提供的会议材料本地路径（可多个）；只要会议有 imchat_groupid，群聊仍会自动并入',
+            },
+            content: { type: 'string', description: '用户直接给的纪要正文/要点，与 files 可同时给' },
+            decisions: {
+                type: 'array',
+                description: '**主路径**：调用方（智能体）自己读完纪要原文后分析出的任务。'
+                    + '给了就以它为准，不再走关键词兜底 —— 任务该由模型理解语义，不该靠正则猜',
+                items: {
+                    type: 'object',
+                    additionalProperties: false,
+                    properties: {
+                        executor: { type: 'string', description: '执行人姓名或账号（HRM 查得到即可）' },
+                        title: { type: 'string', description: '任务标题' },
+                    },
+                    required: ['executor', 'title'],
+                },
+            },
+            groupId: { type: 'string', description: '群 id；省略时取会议 imchat_groupid' },
+            onlyPending: { type: 'boolean', description: '推送时只列未完成任务（默认 true）' },
+            aiPageId: { type: 'string', description: '智能纪要页面 id，省略时自动反查' },
+            employeeId: { type: 'string', description: 'ESB 触发人 id，省略时用当前登录人' },
+        },
+        required: ['mt_id'],
+    },
+    handler: async (args, env) => {
+        const startedAt = Date.now();
+        const timings = {};
+        const warnings = [];
+        const mtId = textOf(args.mt_id).trim();
+        if (!mtId)
+            throw meetingValidationError('mt_id_required', '必须提供会议 id（mt_id）');
+        const level = LEVELS.includes(String(args.level))
+            ? String(args.level)
+            : 'document';
+        const needsConfirm = level === 'tasks' || level === 'notify';
+        const confirmed = args.confirm === true;
+        // 未确认时只跑到文档，把"要写什么"先摆出来
+        const executedLevel = needsConfirm && !confirmed ? 'document' : level;
+        const { getMeetingOperation } = await import('./registry.js');
+        const ctx = env.ctx;
+        // ① 群聊 → 纪要（复用已固化的操作，含摘要版与时间窗口径）
+        // 传 minuteId 可复用已有纪要：预览→确认的两步走时，避免每次都新建一条纪要（每次 20~30 秒）
+        let stepStart = Date.now();
+        const reuseMinuteId = textOf(args.minuteId).trim();
+        let minuteId = '';
+        if (reuseMinuteId) {
+            minuteId = reuseMinuteId;
+            timings.minute = 0;
+        }
+        else {
+            const upstreamPipeline = executedLevel === 'text' ? 'text' : executedLevel === 'minutes' ? 'minutes' : 'document';
+            const minuteResult = await getMeetingOperation('meeting.minute.fromGroupChat').handler({
+                mt_id: mtId,
+                pipeline: upstreamPipeline,
+                ...(args.subject ? { subject: String(args.subject) } : {}),
+                ...(args.groupId ? { groupId: String(args.groupId) } : {}),
+                // 用户提供的材料也要一起进纪要（会议有 imchat_groupid 时群聊照样自动并入）
+                ...(Array.isArray(args.files) ? { files: args.files } : {}),
+                ...(args.content ? { content: String(args.content) } : {}),
+                ...(args.aiPageId ? { aiPageId: String(args.aiPageId) } : {}),
+                ...(args.employeeId ? { employeeId: String(args.employeeId) } : {}),
+            }, env);
+            warnings.push(...(minuteResult?.warnings ?? []));
+            const minuteData = minuteResult?.data ?? {};
+            minuteId = textOf(minuteData.minuteId);
+            timings.minute = Date.now() - stepStart;
+        }
+        if (!minuteId) {
+            return meetingSuccess('meeting.pipeline.run', { id: mtId, level, executedLevel, minuteId: null, timings }, { warnings: [...warnings, '未能创建纪要，流程中止（详见 minute 阶段返回）'] });
+        }
+        // ② 回读原文（任务提取要用，且以服务端为准）
+        stepStart = Date.now();
+        const detail = await getMeetingOperation('meeting.eb.minute.detail').handler({ id: minuteId }, env);
+        const minute = detail?.data?.data ?? {};
+        const transcript = textOf(minute.minutes_content);
+        const parseContent = textOf(minute.parse_content);
+        timings.readMinute = Date.now() - stepStart;
+        const base = {
+            id: mtId,
+            level,
+            executedLevel,
+            minuteId,
+            transcriptLength: transcript.length,
+            parseContentLength: parseContent.length,
+            documentId: textOf(minute.mt_minutes) || null,
+            finalStatus: textOf(minute.minutes_status),
+        };
+        // ③ 目标里没有 tasks/notify 就到此为止
+        // ⚠️ 这里必须看**原始 level**，不能看 executedLevel —— 未确认时 executedLevel 被降级成
+        // `document`，若按它判断就会在给出预览之前直接返回（曾踩过）。
+        if (level !== 'tasks' && level !== 'notify')
+            return finish(base);
+        // ④ 确定分工
+        // 主路径是**调用方（智能体）自己读原文分析后传进来的 decisions**：任务该由模型按语义理解，
+        // 关键词匹配只是没传 decisions 时的兜底（覆盖不到「我来出方案」「先请 @某人 梳理」这类句式）。
+        stepStart = Date.now();
+        const decided = resolveTaskAssignments(args.decisions, transcript);
+        const assignments = decided.assignments;
+        const taskSource = decided.source;
+        timings.extractTasks = Date.now() - stepStart;
+        if (decided.warning)
+            warnings.push(decided.warning);
+        if (assignments.length === 0) {
+            return finish({
+                ...base,
+                tasks: { source: taskSource, extracted: 0, resolved: 0, created: false, unresolved: [] },
+                notify: null,
+            }, [
+                '没有可提交的任务，未创建。关键词兜底没识别到「负责」式分工 —— '
+                    + '**推荐由智能体读 minutes_content 自己分析，用 decisions 参数传进来**（能覆盖「我来出方案」「先请 @某人 梳理」等句式）',
+            ]);
+        }
+        // ⑤ 账号 → HRM 员工 id（邮箱式账号必须用 username 查，email/keyword 查不到）
+        stepStart = Date.now();
+        const { createHrmHost } = await import('../../hrm/host.js');
+        const { getHrmOperation } = await import('../../hrm/operations/registry.js');
+        const hrmEnv = { ctx, host: createHrmHost(ctx) };
+        const queryOp = getHrmOperation('hrm.employee.query');
+        const resolved = [];
+        const unresolved = [];
+        for (const item of assignments) {
+            let person = null;
+            for (const params of [{ username: item.account }, { keyword: item.account }]) {
+                try {
+                    const found = await queryOp.handler({ ...params, pageSize: 5 }, hrmEnv);
+                    const row = (found?.data?.rows ?? [])[0];
+                    if (row?.id) {
+                        person = row;
+                        break;
+                    }
+                }
+                catch {
+                    // 查不到就换下一种方式，不中断
+                }
+            }
+            if (person) {
+                resolved.push({ account: item.account, title: item.title, id: textOf(person.id), name: textOf(person.name) || item.account });
+            }
+            else {
+                unresolved.push(item.account);
+            }
+        }
+        timings.resolveExecutors = Date.now() - stepStart;
+        if (unresolved.length > 0) {
+            warnings.push(`以下执行人在 HRM 里没查到，已跳过对应任务（不猜人）：${[...new Set(unresolved)].join('、')}`);
+        }
+        // 任务行（本地构造，供预览与推送共用）
+        const meetingInfo = await (async () => {
+            const listed = await getMeetingOperation('meeting.eb.meeting.list').handler({ mt_id: mtId, pageNo: 1, pageSize: 1 }, env);
+            return (listed?.data?.rows ?? [])[0]?.mainTable ?? {};
+        })();
+        const beginAt = textOf(meetingInfo.end_datetime).trim()
+            || textOf(meetingInfo.begin_datetime).trim()
+            || (() => {
+                const now = new Date();
+                const pad = (n) => String(n).padStart(2, '0');
+                return `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}`;
+            })();
+        const dueDays = typeof args.taskDueDays === 'number' && args.taskDueDays > 0 ? args.taskDueDays : 7;
+        const dueAt = defaultDueDate(beginAt, dueDays);
+        const plannedRows = resolved.map((item) => ({
+            decision_title: item.title,
+            executors: [{ name: item.name, id: item.id }],
+            begin_datetime: beginAt,
+            end_datetime: dueAt,
+            decision_status: [{ id: '0', name: '未完成' }],
+        }));
+        // ⑥ 未确认 / 只到 tasks → 给出预览或只建任务
+        const existing = await getMeetingOperation('meeting.eb.decisionTask.list').handler({ mt_id: mtId, pageNo: 1, pageSize: 1 }, env);
+        const existingTotal = Number(existing?.data?.total ?? 0);
+        const skipExisting = args.skipExistingTasks !== false;
+        if (needsConfirm && !confirmed) {
+            const preview = formatTaskMessage({
+                meetingName: textOf(meetingInfo.mt_name),
+                begin: textOf(meetingInfo.begin_datetime),
+                end: textOf(meetingInfo.end_datetime),
+                tasks: plannedRows,
+                onlyPending: args.onlyPending !== false,
+            });
+            return finish({
+                ...base,
+                needsConfirm: true,
+                tasks: {
+                    source: taskSource,
+                    extracted: assignments.length,
+                    resolved: resolved.length,
+                    created: false,
+                    existingTasks: existingTotal,
+                    unresolved: [...new Set(unresolved)],
+                    planned: resolved.map((item) => ({
+                        title: item.title,
+                        executor: item.name,
+                        begin: beginAt,
+                        end: dueAt,
+                    })),
+                },
+                notifyPreview: level === 'notify' ? preview.text : null,
+            }, [
+                ...warnings,
+                `这是预览，**尚未建任务、也尚未发群消息**。确认后带 \`confirm:true\` 重跑；`
+                    + `建议同时带 \`minuteId=${minuteId}\` 复用本次纪要，避免再生成一条`,
+            ]);
+        }
+        // ⑦ 提交决议（概述 + 明细 + 标记已决议）——**不手工建任务**
+        // ⚠️ 2026-10-27 用户澄清 + 真机复核：`update_mt_isdecision`（标记已决议）会触发用户配置的 ESB，
+        // 按每条决议明细**自动生成**一个决议任务；本文不调用 `meeting.eb.decisionTask.create`，
+        // 否则同一件事会有两个任务（create_mt_decision_task 只在 ESB 没触发时补建）。
+        let created = false;
+        if (plannedRows.length === 0) {
+            warnings.push('没有可指派的执行人，未创建决议任务');
+        }
+        else if (skipExisting && existingTotal > 0) {
+            warnings.push(`该会议已有 ${existingTotal} 条决议任务，按 skipExistingTasks 跳过创建（要重建立传 skipExistingTasks=false）`);
+        }
+        else {
+            stepStart = Date.now();
+            const published = await getMeetingOperation('meeting.eb.decision.publish.prepare').handler({
+                mt_id: mtId,
+                mt_content: `群聊纪要自动提取的 ${plannedRows.length} 项分工：${plannedRows.map((row) => row.decision_title).join('、')}`,
+                detail1: plannedRows.map((row) => ({
+                    decision_title: row.decision_title,
+                    executors: row.executors[0].id,
+                    begin_datetime: row.begin_datetime,
+                    end_datetime: row.end_datetime,
+                    decision_status: '0',
+                })),
+            }, env);
+            await getMeetingOperation('meeting.eb.decision.publish.apply').handler({ confirm: true, continuation: published?.data?.continuation }, env);
+            created = true;
+            timings.publishTasks = Date.now() - stepStart;
+        }
+        // ⑧ 推送群聊（前提：服务端确实已经有决议任务了才发）
+        let notify = null;
+        if (executedLevel === 'notify') {
+            stepStart = Date.now();
+            const readTaskTotal = async () => {
+                const check = await getMeetingOperation('meeting.eb.decisionTask.list').handler({ mt_id: mtId, pageNo: 1, pageSize: 1 }, env);
+                return Number(check?.data?.total ?? 0);
+            };
+            // ⚠️ 任务由用户配置的 ESB 联动生成，**有 3~6 秒延迟**。刚 publish 完立刻推群，
+            // 通知里会还是上一批任务（实测踩过：新任务 4 条已建，群里列的还是旧 7 条）。
+            let taskTotal = existingTotal;
+            if (created) {
+                const waited = await waitForTaskIncrease(readTaskTotal, existingTotal);
+                timings.waitTasks = waited.waitedMs;
+                taskTotal = waited.total;
+            }
+            else {
+                taskTotal = await readTaskTotal();
+            }
+            // ⛔ 没有任务就不发：群里收到"共 0 项"的通知比不发更糟
+            if (taskTotal <= 0) {
+                warnings.push(created
+                    ? '决议已提交，但服务端仍未生成任务（ESB 联动延迟或未启用），**本次未推送群消息**；'
+                        + '稍后确认任务生成后再用 meeting.decision.notifyGroup 推送'
+                    : '该会议没有决议任务，**本次未推送群消息**');
+                return finish({
+                    ...base,
+                    tasks: {
+                        source: taskSource,
+                        extracted: assignments.length,
+                        resolved: resolved.length,
+                        created,
+                        existingTasks: existingTotal,
+                        unresolved: [...new Set(unresolved)],
+                        planned: resolved.map((item) => ({ title: item.title, executor: item.name, begin: beginAt, end: dueAt })),
+                    },
+                    notify: { sent: false, groupId: null, charCount: 0, skipped: 'no_tasks' },
+                });
+            }
+            const notifyData = await getMeetingOperation('meeting.decision.notifyGroup').handler({
+                mt_id: mtId,
+                ...(args.groupId ? { groupId: String(args.groupId) } : {}),
+                // 用户提供的材料也要一起进纪要（会议有 imchat_groupid 时群聊照样自动并入）
+                ...(Array.isArray(args.files) ? { files: args.files } : {}),
+                ...(args.content ? { content: String(args.content) } : {}),
+                onlyPending: args.onlyPending !== false,
+                confirm: true,
+            }, env);
+            const nd = notifyData?.data ?? {};
+            notify = { sent: nd.sent === true, groupId: nd.groupId ?? null, charCount: nd.charCount ?? 0 };
+            warnings.push(...(notifyData?.warnings ?? []));
+            timings.notify = Date.now() - stepStart;
+        }
+        return finish({
+            ...base,
+            tasks: {
+                source: taskSource,
+                extracted: assignments.length,
+                resolved: resolved.length,
+                created,
+                existingTasks: existingTotal,
+                unresolved: [...new Set(unresolved)],
+                planned: resolved.map((item) => ({ title: item.title, executor: item.name, begin: beginAt, end: dueAt })),
+            },
+            notify,
+        });
+        function finish(payload, extraWarnings = []) {
+            const allWarnings = [...warnings, ...extraWarnings];
+            return meetingSuccess('meeting.pipeline.run', { ...payload, timings: { ...timings, total: Date.now() - startedAt } }, allWarnings.length > 0 ? { warnings: [...new Set(allWarnings)] } : undefined);
+        }
+    },
+};
+export const meetingPipelineOperations = [meetingPipelineRun];

package/dist/shortcuts/meeting/operations/qrcode.js

@@ -0,0 +1,131 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { meetingValidationError } from '../errors.js';
+import { meetingSuccess, schemaOf } from './types.js';
+import { meetingStateDir } from './env.js';
+import { encodeQrText } from '../qr/encoder.js';
+import { renderQrPng, renderQrSvg } from '../qr/render.js';
+const ECC_LEVELS = ['L', 'M', 'Q', 'H'];
+function stamp() {
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+}
+function safeName(input) {
+    return input.replace(/[\\/:*?"<>|\s]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 60);
+}
+/**
+ * `meeting.qrcode.render` —— 文本 → 二维码图片（PNG / SVG），本地零依赖生成。
+ *
+ * 适用场景：参会码（门禁/食堂）、签到码、会议链接码、议程扫码等「一段文本要变成能被扫的图」。
+ * 只负责**画码**，不负责**造码内容**：码里装什么由业务接口决定（例如 ESB 短信里的免登链接、
+ * 平台 getQrCode 返回的签到票据）。内容来源那一层单独接，避免把外部契约猜进 CLI。
+ */
+const meetingQrRender = {
+    name: 'meeting.qrcode.render',
+    resource: 'qrcode',
+    method: 'render',
+    action: 'meeting.qrcode.render',
+    summary: '把一段文本渲染成二维码图片（PNG/SVG，零依赖本地生成）；参会码/签到码/链接码通用，默认输出到 ~/.weaver-work-cli/meeting/qrcodes/',
+    capability: 'qrcode',
+    risk: 'read',
+    inputSchema: schemaOf({
+        text: {
+            type: 'string',
+            description: '二维码内容（必填）。URL / JSON / 票据串均可；UTF-8 编码，中文按 3 字节计容量',
+        },
+        outPath: {
+            type: 'string',
+            description: '输出文件完整路径（可选）。相对路径按当前工作目录解析；缺省写到 ~/.weaver-work-cli/meeting/qrcodes/qr-<时间戳>.png',
+        },
+        fileName: {
+            type: 'string',
+            description: '仅指定文件名（不含目录），与缺省目录组合，如 参会码-张三.png；outPath 优先',
+        },
+        format: {
+            type: 'string',
+            enum: ['png', 'svg'],
+            description: '输出格式（默认 png）；svg 为矢量，适合印刷或嵌文档',
+        },
+        ecc: {
+            type: 'string',
+            enum: ECC_LEVELS,
+            description: '纠错等级（默认 M）：L≈7% / M≈15% / Q≈25% / H≈30% 冗余。会场灯光差、码面易磨损用 Q 或 H；内容越长等级越高版本越大',
+        },
+        scale: {
+            type: 'number',
+            description: '每个模块的像素边长（默认 8，范围 1-64）。屏幕展示 ≥6，打印 ≥10',
+        },
+        margin: {
+            type: 'number',
+            description: '静区宽度，单位=模块（默认 4，规范要求 ≥4，不要小于 4，否则扫码器识别率下降）',
+        },
+        mask: {
+            type: 'number',
+            description: '强制掩码 0-7（一般不用传）；不传按罚分自动择优',
+        },
+    }, { required: ['text'] }),
+    handler: async (args, env) => {
+        const text = typeof args.text === 'string' ? args.text : '';
+        if (text.trim() === '') {
+            throw meetingValidationError('qrcode_text_required', '生成二维码必须提供 text（二维码内容）');
+        }
+        const format = args.format === 'svg' ? 'svg' : 'png';
+        const ecc = ECC_LEVELS.includes(args.ecc) ? args.ecc : 'M';
+        const scale = args.scale === undefined ? 8 : Number(args.scale);
+        const margin = args.margin === undefined ? 4 : Number(args.margin);
+        if (!Number.isFinite(scale) || scale < 1 || scale > 64) {
+            throw meetingValidationError('qrcode_scale_invalid', `scale 必须是 1-64 的数字，收到 ${String(args.scale)}`);
+        }
+        if (!Number.isFinite(margin) || margin < 0 || margin > 32) {
+            throw meetingValidationError('qrcode_margin_invalid', `margin 必须是 0-32 的数字，收到 ${String(args.margin)}`);
+        }
+        if (args.mask !== undefined) {
+            const maskValue = Number(args.mask);
+            if (!Number.isInteger(maskValue) || maskValue < 0 || maskValue > 7) {
+                throw meetingValidationError('qrcode_mask_invalid', `mask 必须是 0-7 的整数，收到 ${String(args.mask)}`);
+            }
+        }
+        let matrix;
+        try {
+            matrix = encodeQrText(text, {
+                ecc,
+                mask: args.mask === undefined ? undefined : Number(args.mask),
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw meetingValidationError('qrcode_encode_failed', `二维码编码失败：${message}`);
+        }
+        const imageScale = Math.floor(scale);
+        const imageMargin = Math.floor(margin);
+        const imageSize = (matrix.size + imageMargin * 2) * imageScale;
+        const defaultDir = join(meetingStateDir(env.ctx), 'qrcodes');
+        const fallbackName = `qr-${stamp()}.${format}`;
+        const explicitName = typeof args.fileName === 'string' && args.fileName.trim() !== ''
+            ? `${safeName(args.fileName.replace(/\.(png|svg)$/i, ''))}.${format}`
+            : fallbackName;
+        const target = typeof args.outPath === 'string' && args.outPath.trim() !== ''
+            ? (isAbsolute(args.outPath) ? resolve(args.outPath) : resolve(process.cwd(), args.outPath))
+            : join(defaultDir, explicitName);
+        await mkdir(dirname(target), { recursive: true });
+        const payload = format === 'svg'
+            ? Buffer.from(renderQrSvg(matrix, { scale: imageScale, margin: imageMargin }), 'utf8')
+            : renderQrPng(matrix, { scale: imageScale, margin: imageMargin });
+        await writeFile(target, payload);
+        return meetingSuccess('meeting.qrcode.render', {
+            path: target,
+            format,
+            imageSize,
+            scale: imageScale,
+            margin: imageMargin,
+            modules: matrix.size,
+            version: matrix.version,
+            ecc: matrix.ecc,
+            mask: matrix.mask,
+            byteLength: matrix.byteLength,
+            textPreview: text.length > 60 ? `${text.slice(0, 60)}…` : text,
+        });
+    },
+};
+export const meetingQrOperations = [meetingQrRender];

package/dist/shortcuts/meeting/operations/receipts.js

@@ -49,7 +49,7 @@ const meetingReceiptList = {
         const body = {
             mtId: toIdString(args.mtId, 'mtId'),
             isMobile: args.isMobile === undefined ? false : args.isMobile === true,
-            // 2026-10-08 真机实测（10.12.105.186）：**不传 memberType 必 500「系统内部错误」**，
+            // 2026-10-08 真机实测（某环境）：**不传 memberType 必 500「系统内部错误」**，
             // 传 1 即正常返回。历史文档只提醒了 isMobile，实际 memberType 同样不能缺省。
             memberType: args.memberType === undefined ? 1 : args.memberType,
             current: typeof args.current === 'number' && args.current > 0 ? args.current : 1,

package/dist/shortcuts/meeting/operations/registry.js

@@ -10,6 +10,15 @@ import { meetingLifecycleOperations } from './lifecycle.js';
 import { meetingReceiptOperations } from './receipts.js';
 import { meetingSignOperations } from './signs.js';
 import { meetingLinkOperations } from './link.js';
+import { meetingAttachmentOperations } from './attachment.js';
+import { meetingAttachmentContentOperations } from './attachment-content.js';
+import { meetingMinuteContentOperations } from './minute-content.js';
+import { meetingMinuteFromGroupChatOperations } from './from-group-chat.js';
+import { meetingDecisionNotifyOperations } from './task-notify.js';
+import { meetingPipelineOperations } from './pipeline.js';
+import { meetingInvitationOperations } from './invitation.js';
+import { meetingQrOperations } from './qrcode.js';
+import { meetingSummaryOperations } from './summary.js';
 import { meetingEbOperations } from './eb/index.js';
 function buildRegistry() {
     const registry = new Map();
@@ -25,6 +34,15 @@ function buildRegistry() {
         ...meetingReceiptOperations,
         ...meetingSignOperations,
         ...meetingLinkOperations,
+        ...meetingAttachmentOperations,
+        ...meetingAttachmentContentOperations,
+        ...meetingMinuteContentOperations,
+        ...meetingMinuteFromGroupChatOperations,
+        ...meetingDecisionNotifyOperations,
+        ...meetingPipelineOperations,
+        ...meetingInvitationOperations,
+        ...meetingQrOperations,
+        ...meetingSummaryOperations,
         ...meetingEbOperations,
     ];
     for (const definition of definitions) {