weaver-work-cli 0.1.29 → 0.1.31

package/dist/shortcuts/meeting/operations/minute-content.js

@@ -0,0 +1,266 @@
+/**
+ * 纪要内容回写与状态查询（配合 ESB 解析链路）。
+ *
+ * 背景（2026-10-26 与用户确认的链路）：
+ * ```
+ * 上传附件 → 建纪要挂附件 → ESB「解析附件」(1325287772302863627)
+ *   ├ 文档：同步出原文
+ *   └ 音视频：后台定时任务写表单（**最小间隔 1 分钟**）
+ * → 原文写 minutes_content → 智能体生成纪要 → 写 parse_content
+ * → ESB「保存解析并生成文档」(1325287772302863628)
+ * ```
+ *
+ * 本文件负责其中两件事（都不依赖 ESB 细节）：
+ * 1. `meeting.minute.writeContent` —— 把智能体/调用方产出的文字写回纪要，并**正确推进状态**；
+ * 2. `meeting.minute.parseStatus` —— 单次查询解析进展，**不阻塞、不轮询**。
+ *
+ * ⚠️ 状态口径（真机验证过，别再依赖 minutes_status 判断完成）：
+ * - 全库 33 条纪要里 28 条 `minutes_status=1（生成中）`，但 `parse_content` 早已有内容 ——
+ *   该字段没有任何环节负责推进，**它是"标签"不是"事实"**。
+ * - 判断解析是否完成，看 `video_taskResult`（后台任务写）+ 内容是否为空。
+ *
+ * ⚠️ 音频等待：后台任务最小间隔 1 分钟，所以**不要同步等待**。
+ * 触发解析后立刻返回 `pending`，让调用方 1 分钟后再来查（`parseStatus`）。
+ */
+import { meetingValidationError } from '../errors.js';
+import { meetingSuccess, SCHEMA_ID } from './types.js';
+/** minutes_status 枚举（接口文档口径）。 */
+const MINUTE_STATUS = {
+    parsing: '0',
+    generating: '1',
+    done: '2',
+    extracting: '3',
+    extracted: '4',
+};
+const STATUS_LABEL = {
+    '0': '解析中',
+    '1': '生成中',
+    '2': '已完成',
+    '3': '文字提取中',
+    '4': '文字提取完成',
+};
+const TASK_RESULT_LABEL = {
+    '0': '生成中',
+    '1': '生成成功',
+    '2': '生成失败',
+};
+function textOf(value) {
+    return value === undefined || value === null ? '' : String(value);
+}
+/** 读一条纪要（走已实现的 EB detail 操作，不复制接口契约）。 */
+async function readMinute(env, id) {
+    const { getMeetingOperation } = await import('./registry.js');
+    const detail = getMeetingOperation('meeting.eb.minute.detail');
+    const result = await detail.handler({ id }, env);
+    const row = result?.data?.data;
+    if (!row || typeof row !== 'object') {
+        throw meetingValidationError('not_found', `未找到纪要 id=${id}，或当前账号无权限查看`, { id });
+    }
+    return row;
+}
+const meetingMinuteWriteContent = {
+    name: 'meeting.minute.writeContent',
+    resource: 'minute',
+    method: 'writeContent',
+    action: 'meeting.minute.writeContent',
+    summary: '把解析出的原文 / 生成的纪要写回会议纪要，并按内容自动推进 minutes_status（原文就绪→文档4/音频2；纪要写完→2）',
+    capability: 'minute',
+    risk: 'high-risk-write',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            id: { ...SCHEMA_ID, description: '纪要 id（minute.list / create 返回的 id）' },
+            mt_id: { ...SCHEMA_ID, description: '所属会议 id（update_mt_minute 服务端必填）' },
+            minutes_content: {
+                type: 'string',
+                description: '原始文字（文档 OCR 提取结果 / 音频转写原文）。传了就写，不传则保持原值',
+            },
+            parse_content: {
+                type: 'string',
+                description: '会议纪要文案（富文本 HTML）。写完会把状态置为 2（已完成）',
+            },
+            file_type: {
+                type: 'string',
+                enum: ['0', '1'],
+                description: '0 文档 / 1 音频。省略时自动读纪要当前值，用于决定原文就绪后状态是 4 还是 2',
+            },
+            minutes_status: {
+                type: 'string',
+                enum: ['0', '1', '2', '3', '4'],
+                description: '显式指定状态（一般不要传，交给自动规则）。传了以你为准',
+            },
+        },
+        required: ['id', 'mt_id'],
+    },
+    handler: async (args, env) => {
+        const id = textOf(args.id).trim();
+        const mtId = textOf(args.mt_id).trim();
+        if (!id)
+            throw meetingValidationError('id_required', '必须提供纪要 id（id）');
+        if (!mtId)
+            throw meetingValidationError('mt_id_required', '必须提供会议 id（mt_id）');
+        const minutesContent = args.minutes_content === undefined ? undefined : textOf(args.minutes_content);
+        const parseContent = args.parse_content === undefined ? undefined : textOf(args.parse_content);
+        if (minutesContent === undefined && parseContent === undefined && args.minutes_status === undefined) {
+            throw meetingValidationError('nothing_to_update', 'minutes_content / parse_content / minutes_status 至少要给一个，否则这次调用什么都不会改变');
+        }
+        // file_type 决定"原文就绪"后的状态：文档=4（文字提取完成），音频=2（已完成，用户 2026-10-26 确认）
+        let fileType = textOf(args.file_type).trim();
+        let current = null;
+        if (!fileType) {
+            current = await readMinute(env, id);
+            fileType = textOf(current.file_type).trim();
+        }
+        const patch = {};
+        if (minutesContent !== undefined)
+            patch.minutes_content = minutesContent;
+        if (parseContent !== undefined)
+            patch.parse_content = parseContent;
+        let statusReason;
+        if (args.minutes_status !== undefined) {
+            patch.minutes_status = textOf(args.minutes_status);
+            statusReason = `调用方显式指定为 ${patch.minutes_status}（${STATUS_LABEL[patch.minutes_status] ?? '未知'}）`;
+        }
+        else if (parseContent !== undefined && parseContent.trim() !== '') {
+            // ⚠️ 2026-10-26 真机：生成纪要文案后状态是 **1（生成中）**，不是 2。
+            // 2 由「保存解析并生成文档」那个 ESB 在生成完文档后自己写（实测 status 1 → 2、mt_minutes 拿到 wdID）。
+            patch.minutes_status = MINUTE_STATUS.generating;
+            statusReason = '纪要文案已写入 ⇒ 1（生成中），等待 ESB 生成文档后由服务端置 2';
+        }
+        else if (minutesContent !== undefined && minutesContent.trim() !== '') {
+            // ⚠️ 2026-10-26 真机更正：**文档和音频**在"原文就绪"阶段，服务端自己写的都是
+            // `4（文字提取完成）`，不是 2。音频那条实测：status 3（文字提取中）→ 4，
+            // 同时 video_taskResult 0 → 1、minutes_content 3986 字。
+            // 所以这里统一写 4，等纪要文案生成后再置 2 —— 与平台口径保持一致，
+            // 避免同一条链路上出现"服务端写 4、CLI 写 2"的自相矛盾。
+            patch.minutes_status = MINUTE_STATUS.extracted;
+            statusReason = '原文就绪 ⇒ 4（文字提取完成），与平台口径一致；待生成纪要后置 1、生成文档后置 2';
+        }
+        else {
+            statusReason = '仅清空内容，未改状态';
+        }
+        const { getMeetingOperation } = await import('./registry.js');
+        const prepare = getMeetingOperation('meeting.eb.minute.update.prepare');
+        const apply = getMeetingOperation('meeting.eb.minute.update.apply');
+        const prepared = await prepare.handler({ id, mt_id: mtId, ...patch }, env);
+        const applied = await apply.handler({ confirm: true, continuation: prepared?.data?.continuation }, env);
+        const after = await readMinute(env, id);
+        const warnings = [];
+        if (textOf(after.minutes_content) !== textOf(patch.minutes_content ?? after.minutes_content)) {
+            warnings.push('minutes_content 回读与写入值不一致，建议人工核对（服务端可能做了富文本处理）');
+        }
+        return meetingSuccess('meeting.minute.writeContent', {
+            id,
+            mtId,
+            written: Object.keys(patch),
+            statusReason,
+            // 回读结果（以服务端为准，不信本地假设）
+            minutesStatus: textOf(after.minutes_status),
+            minutesStatusLabel: STATUS_LABEL[textOf(after.minutes_status)] ?? '',
+            minutesContentLength: textOf(after.minutes_content).length,
+            parseContentLength: textOf(after.parse_content).length,
+            videoTaskId: textOf(after.video_taskId),
+            videoTaskResult: textOf(after.video_taskResult),
+            applyResult: applied?.data ?? null,
+        }, warnings.length > 0 ? { warnings } : undefined);
+    },
+};
+const meetingMinuteParseStatus = {
+    name: 'meeting.minute.parseStatus',
+    resource: 'minute',
+    method: 'parseStatus',
+    action: 'meeting.minute.parseStatus',
+    summary: '单次查询纪要解析进展（不阻塞、不轮询）：返回 pending / extracted / completed / failed / idle，并给出下次复查建议',
+    capability: 'minute',
+    risk: 'read',
+    inputSchema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+            id: { ...SCHEMA_ID, description: '纪要 id' },
+        },
+        required: ['id'],
+    },
+    handler: async (args, env) => {
+        const id = textOf(args.id).trim();
+        if (!id)
+            throw meetingValidationError('id_required', '必须提供纪要 id（id）');
+        const row = await readMinute(env, id);
+        const minutesContent = textOf(row.minutes_content).trim();
+        const parseContent = textOf(row.parse_content).trim();
+        const taskResult = textOf(row.video_taskResult).trim();
+        const taskId = textOf(row.video_taskId).trim();
+        const status = textOf(row.minutes_status).trim();
+        const fileType = textOf(row.file_type).trim();
+        /** 生成的纪要文档 id（ESB「保存解析并生成文档」回写的 `mt_minutes` 字段）。 */
+        const documentId = textOf(row.mt_minutes).trim();
+        /**
+         * 状态判定顺序（2026-10-26 全链路真机验证后定稿）：
+         * 文档已生成 > 失败 > 纪要文案就绪（待生成文档） > 原文就绪（待生成纪要） > 后台在跑 > 未触发
+         */
+        let state;
+        let hint;
+        /** 下一步该干什么（让 Agent 不用自己推理，直接照做）。 */
+        let nextAction;
+        if (documentId !== '' && status === MINUTE_STATUS.done) {
+            state = 'done';
+            nextAction = 'none';
+            hint = `整条链已完成：纪要文档已生成并回写 OA（mt_minutes=${documentId}）`;
+        }
+        else if (taskResult === '2') {
+            state = 'failed';
+            nextAction = 'manual_check';
+            hint = '后台解析失败：请到会议详情页看失败原因；不要把状态改成已完成';
+        }
+        else if (parseContent !== '') {
+            state = 'minutes_ready';
+            nextAction = 'generate_document';
+            hint =
+                `纪要文案已就绪（当前状态 ${status || '空'}${STATUS_LABEL[status] ? ` ${STATUS_LABEL[status]}` : ''}）。`
+                    + '**直接调用 ESB「保存解析并生成文档」**（流程 id 从本租户配置取，见 `meeting.minute.fromGroupChat` 的 `flowGenerateDocument`），'
+                    + '传 `parse_content` + `mt_minute_id`；该动作流会生成文档、回写 `mt_minutes` 并把状态置 2。**不用再问用户**';
+        }
+        else if (minutesContent !== '') {
+            state = 'extracted';
+            nextAction = 'generate_minutes';
+            hint =
+                '原文已就绪（状态 4 文字提取完成）。调用 ESB「根据智能体解析文本生成智能纪要文本」（流程 id 见 `flowGenerateMinutes`），'
+                    + '只需传 `minuteId`，它会把纪要文案写进 `parse_content` 并把状态置 1';
+        }
+        else if (taskResult === '0' || status === MINUTE_STATUS.parsing || status === MINUTE_STATUS.extracting) {
+            state = 'pending';
+            nextAction = 'wait_then_check';
+            hint = '后台定时任务最小间隔 60 秒，建议 60 秒后再查一次；不要连续轮询';
+        }
+        else {
+            state = 'idle';
+            nextAction = 'trigger_parse';
+            hint = '尚未触发解析：确认已挂附件后再调用 ESB「解析附件」';
+        }
+        return meetingSuccess('meeting.minute.parseStatus', {
+            id,
+            state,
+            hint,
+            nextAction,
+            fileType,
+            minutesStatus: status,
+            minutesStatusLabel: STATUS_LABEL[status] ?? '',
+            videoTaskId: taskId,
+            videoTaskResult: taskResult,
+            videoTaskResultLabel: TASK_RESULT_LABEL[taskResult] ?? '',
+            minutesContentLength: minutesContent.length,
+            parseContentLength: parseContent.length,
+            /** 生成的纪要文档 id（空 = 还没生成文档）。 */
+            documentId,
+            // 判断"完成"永远用这几个布尔，不要用 minutes_status
+            contentReady: minutesContent !== '',
+            minutesReady: parseContent !== '',
+            documentReady: documentId !== '',
+        });
+    },
+};
+export const meetingMinuteContentOperations = [
+    meetingMinuteWriteContent,
+    meetingMinuteParseStatus,
+];