weaver-work-cli 0.1.21 → 0.1.22

package/dist/shortcuts/invoice/host.js

@@ -135,10 +135,11 @@ export function createInvoiceHost(ctx, dependencies = {}) {
         if (typeof token !== 'string' || !token.trim()) {
             throw invoiceAuthError('invoice_token_missing', '未取得业票通业务 Token');
         }
-        const saved = await tokenStore.save(token);
-        if (!saved) {
-            throw invoiceAuthError('invoice_token_cache_failed', '发票 Token 安全缓存写入失败，已停止业务请求');
-        }
+        // Headless Web/Linux hosts may not provide a system keyring (for example,
+        // Secret Service over D-Bus). Persistence is only an optimization: keep
+        // the token in this process so the current business request can proceed,
+        // without falling back to an insecure plaintext cache.
+        await tokenStore.save(token);
         invoiceToken = token;
         return token;
     }

package/dist/shortcuts/meeting/operations/eb/association.js

@@ -0,0 +1,151 @@
+/**
+ * EB 建会后的**关联数据补建**（占用 / 回执 / 签到）。
+ *
+ * 为什么必须补（2026-09-21 真机确认，应用设置 `open_mt_approve=0` + `only_flow_create=0`）：
+ * eBuilder 的**自定义接口** `create_meeting` 只写会议主表，**不会**像页面建会那样
+ * 自动生成占用视图 / 回执 / 签到记录；而这三样恰好是后续能力的硬依赖：
+ *
+ * - 没有**占用**（roomusage）⇒ 会议室冲突检测（`query_roomusage_list`）查不到这场会，
+ *   以后别人在同一时段订同一间会议室不会被拦住；
+ * - 没有**回执**（receipt）⇒ 参会人冲突检测（以回执表 member_id 为准）对本场会议失效；
+ * - 没有**签到**记录（sign）⇒ `meeting.eb.sign.mark`（补签）报「未找到签到记录」。
+ *
+ * 因此建会成功后由本模块按「会议 + 参会人」逐条补齐，语义与页面建会一致。
+ *
+ * 失败语义（重要）：主写入（建会）**已经成功**，这里任何一步失败都**不抛错**，
+ * 只把失败原因汇总进 `warnings` 并标明后果 —— 否则调用方会以为建会失败而重试，导致重复建会。
+ */
+import { EB_BASE, ebBusinessSuccess, normalizeEbWrite, writeBody } from './factory.js';
+import { EB_ENDPOINTS } from './catalog.js';
+/** 只在建会后补建关联数据；其他写操作直接跳过。 */
+const CREATE_MEETING_PK = 'create_meeting';
+/** 回执人员类型：1 = 参会人员（参会人冲突检测只统计该类型）。 */
+const MEMBER_TYPE_ATTENDEE = '1';
+function requireEndpoint(interfacePk) {
+    const endpoint = EB_ENDPOINTS.find((item) => item.interfacePk === interfacePk);
+    if (!endpoint)
+        throw new Error(`EB catalog 缺少 ${interfacePk}，请检查 catalog.ts 声明`);
+    return endpoint;
+}
+/** 逗号分隔 id 串（`hrm_members` 等）→ 去重去空后的数组。 */
+function splitIds(value) {
+    if (value === undefined || value === null)
+        return [];
+    const text = String(value).trim();
+    if (text === '')
+        return [];
+    const seen = new Set();
+    for (const part of text.split(',')) {
+        const id = part.trim();
+        if (id !== '')
+            seen.add(id);
+    }
+    return [...seen];
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * 单条 EB 写入。**不抛错**：返回失败原因交由调用方汇总（主写入已成功，不可中断）。
+ * 复用 `normalizeEbWrite` 以保证字段白名单 / 必填 / 日期格式与手动调用完全一致。
+ */
+async function writeOne(env, interfacePk, args) {
+    try {
+        const session = await env.host.getSession();
+        const payload = normalizeEbWrite(requireEndpoint(interfacePk), args, session.userId);
+        const response = await env.host.request({
+            method: 'POST',
+            path: `${EB_BASE}/saveFormData/${interfacePk}`,
+            operation: 'meeting.eb.meeting.create.apply',
+            body: writeBody(session.userId, payload),
+            acceptBusiness: ebBusinessSuccess,
+        });
+        if (response?.datajson?.status === false) {
+            return { ok: false, error: `${interfacePk} 返回 status=false` };
+        }
+        return { ok: true };
+    }
+    catch (error) {
+        return { ok: false, error: `${interfacePk}: ${errorText(error)}` };
+    }
+}
+export const ebMeetingAssociation = async (ctx) => {
+    if (ctx.endpoint.interfacePk !== CREATE_MEETING_PK)
+        return undefined;
+    const mtId = ctx.dataIds[0];
+    if (!mtId) {
+        return {
+            status: 'SKIPPED',
+            reason: 'create_meeting 未返回会议 id，无法补建占用/回执/签到，请到会议详情页确认。',
+        };
+    }
+    const main = ctx.payload.mainTable;
+    const warnings = [];
+    const created = {};
+    // ① 会议室占用：仅在指定了会议室时写入。
+    const address = main.address === undefined || main.address === null ? '' : String(main.address).trim();
+    if (address === '') {
+        warnings.push('会议未指定会议室（address），已跳过占用写入。');
+    }
+    else {
+        const result = await writeOne(ctx.env, 'create_roomusage', {
+            mt_id: mtId,
+            room_id: address,
+            startdate: main.begin_datetime,
+            enddate: main.end_datetime,
+        });
+        if (result.ok)
+            created.roomUsage = [address];
+        else {
+            warnings.push(`会议室占用写入失败（${result.error}）：该会议不会被会议室冲突检测识别，`
+                + '建议到会议详情页确认，或按需重新创建占用。');
+        }
+    }
+    // ② 回执 + ③ 签到：按 hrm_members 逐人补齐。
+    const members = splitIds(main.hrm_members);
+    if (members.length === 0) {
+        warnings.push('会议未提供具体参会人员（hrm_members 为空），已跳过回执与签到写入：'
+            + '参会人冲突检测与签到/补签都依赖这些记录；若通过 org_members 指定了部门，本 CLI 不展开部门成员，'
+            + '请到会议详情页确认参会人后按需补建。');
+    }
+    else {
+        const receiptFailed = [];
+        const signFailed = [];
+        for (const memberId of members) {
+            const receipt = await writeOne(ctx.env, 'create_meeting_receipt', {
+                mt_id: mtId,
+                member_type: MEMBER_TYPE_ATTENDEE,
+                member_id: memberId,
+                member_manager: memberId,
+            });
+            if (receipt.ok)
+                (created.receipt ??= []).push(memberId);
+            else
+                receiptFailed.push(`${memberId}（${receipt.error}）`);
+            const sign = await writeOne(ctx.env, 'create_meeting_sign', {
+                mt_id: mtId,
+                user_id: memberId,
+            });
+            if (sign.ok)
+                (created.sign ??= []).push(memberId);
+            else
+                signFailed.push(`${memberId}（${sign.error}）`);
+        }
+        if (receiptFailed.length > 0) {
+            warnings.push(`回执写入失败 ${receiptFailed.length}/${members.length} 人：${receiptFailed.join('、')}。`
+                + '参会人冲突检测以回执表为准，缺失将导致该会议的参会人冲突漏检。');
+        }
+        if (signFailed.length > 0) {
+            warnings.push(`签到记录写入失败 ${signFailed.length}/${members.length} 人：${signFailed.join('、')}。`
+                + '这些人将无法通过 meeting.eb.sign.mark 补签（无签到记录可定位）。');
+        }
+    }
+    return {
+        status: warnings.length === 0 ? 'COMPLETE' : 'PARTIAL',
+        mtId,
+        created,
+        ...(warnings.length > 0 ? { warnings } : {}),
+        note: 'eBuilder 自定义接口 create_meeting 不会像页面建会那样自动生成占用/回执/签到，'
+            + '本步骤由 CLI 按「会议 + 参会人」补齐，供会议室/参会人冲突检测与签到补签使用。',
+    };
+};

package/dist/shortcuts/meeting/operations/eb/attendance-summary.js

@@ -0,0 +1,153 @@
+/**
+ * 签到 / 回执列表的**出席情况汇总**（供 `meeting.eb.sign.list` 与 `meeting.eb.receipt.list`
+ * 声明式挂载，见 catalog 的 `summarizeRows`）。机制与 `task-progress.ts` 一致：
+ * 只**增**一个 `data.progress` 字段，原始 `rows` 原样返回。
+ *
+ * 真机确立的取值口径（2026-09-21/22，实现前务必看清）：
+ * - `is_sign` / `attend_status` 回的是**数字字符串**（`"1"` / `""`），不是中文渲染值；
+ * - **"未签到 / 未回执" = 空字符串**，而 `is_sign="0"` 是**缺席**（是"已表态"而非"没签"）——
+ *   两者语义不同，混在一起会得出错误的出席率；
+ * - `sign_out_status`：`0` 已签退 / `1` 未签退 / `2` 早退 / 空 = 未签到；
+ * - ⚠️ **两张表的 `mt_id` 语义不同**：签到表回的是**会议名称文本**，回执表回的是**会议 id** ——
+ *   故汇总里统一命名为 `mtRef`（原样透出），不硬称为 id 或 name。
+ */
+function toText(value) {
+    return value === undefined || value === null ? '' : String(value).trim();
+}
+/** 百分比字符串（保留 1 位小数）；分母为 0 时返回 "0.0%"。 */
+function rate(part, whole) {
+    if (whole <= 0)
+        return '0.0%';
+    return `${((part / whole) * 100).toFixed(1)}%`;
+}
+/**
+ * `is_sign` 归一化。
+ *
+ * 数字字符串为主（实测 `"1"` / `""`），同时兼容中文渲染值与"已签退但未填 is_sign"的兜底：
+ * **空值一律算「未签到」**（不是缺席）。
+ */
+export function normalizeSignState(isSign, signTime) {
+    const text = toText(isSign);
+    if (text === '') {
+        // is_sign 为空：只要 sign_time 有值说明实际签过，按正常处理，避免误判成"未签到"。
+        return toText(signTime) === '' ? 'notSigned' : 'normal';
+    }
+    if (text.includes('正常'))
+        return 'normal';
+    if (text.includes('请假'))
+        return 'leave';
+    if (text.includes('迟到早退'))
+        return 'lateAndEarlyLeave';
+    if (text.includes('迟到未签退'))
+        return 'lateAndNotSignedOut';
+    if (text.includes('迟到'))
+        return 'late';
+    if (text.includes('早退'))
+        return 'earlyLeave';
+    if (text.includes('未签退'))
+        return 'notSignedOut';
+    if (text === '0' || text.includes('缺席'))
+        return 'absent';
+    switch (text) {
+        case '1': return 'normal';
+        case '2': return 'leave';
+        case '3': return 'late';
+        case '4': return 'earlyLeave';
+        case '5': return 'notSignedOut';
+        case '6': return 'lateAndNotSignedOut';
+        case '7': return 'lateAndEarlyLeave';
+        default: return 'unknown';
+    }
+}
+const SIGN_STATES = [
+    'normal', 'leave', 'late', 'earlyLeave', 'notSignedOut', 'lateAndNotSignedOut',
+    'lateAndEarlyLeave', 'absent', 'notSigned', 'unknown',
+];
+/** `meeting.eb.sign.list` 的结果后处理。 */
+export function summarizeSignRows(rows) {
+    const byState = Object.fromEntries(SIGN_STATES.map((key) => [key, 0]));
+    const items = rows.map((row) => {
+        const main = (row?.mainTable ?? row ?? {});
+        const state = normalizeSignState(main.is_sign, main.sign_time);
+        byState[state] += 1;
+        return {
+            id: toText(main.id),
+            userId: toText(main.user_id),
+            mtRef: toText(main.mt_id),
+            state,
+            signTime: toText(main.sign_time),
+            signBackTime: toText(main.signback_time),
+            signOutStatus: toText(main.sign_out_status),
+        };
+    });
+    const total = items.length;
+    const notSigned = byState.notSigned;
+    const signed = total - notSigned;
+    return {
+        summary: {
+            total,
+            signed,
+            notSigned,
+            signedOut: items.filter((item) => item.signOutStatus === '0').length,
+            // 出席率按"已签到"口径（未签到 = 没来），比把"缺席"也算作出席更直观。
+            attendanceRate: rate(signed, total),
+            byState,
+        },
+        items,
+    };
+}
+/** `attend_status` 归一化：空 = 未回执；`0` = 不参加；`1` = 参加。 */
+export function normalizeReceiptState(raw) {
+    const text = toText(raw);
+    if (text === '')
+        return 'noReply';
+    if (text === '1' || text.includes('参加') && !text.includes('不参加'))
+        return 'attend';
+    if (text === '0' || text.includes('不参加'))
+        return 'decline';
+    return 'unknown';
+}
+/** `meeting.eb.receipt.list` 的结果后处理。 */
+export function summarizeReceiptRows(rows) {
+    const byMemberType = { attendee: 0, customer: 0, other: 0, unknown: 0 };
+    const items = rows.map((row) => {
+        const main = (row?.mainTable ?? row ?? {});
+        const memberType = toText(main.member_type);
+        if (memberType === '1')
+            byMemberType.attendee += 1;
+        else if (memberType === '2')
+            byMemberType.customer += 1;
+        else if (memberType === '3')
+            byMemberType.other += 1;
+        else
+            byMemberType.unknown += 1;
+        return {
+            id: toText(main.id),
+            memberId: toText(main.member_id),
+            mtRef: toText(main.mt_id),
+            state: normalizeReceiptState(main.attend_status),
+            memberType,
+            attendStatus: toText(main.attend_status),
+            bookRoom: toText(main.book_room),
+            bookTicket: toText(main.book_ticket),
+        };
+    });
+    const total = items.length;
+    const attend = items.filter((item) => item.state === 'attend').length;
+    const decline = items.filter((item) => item.state === 'decline').length;
+    const replied = attend + decline;
+    return {
+        summary: {
+            total,
+            attend,
+            decline,
+            noReply: total - replied,
+            replyRate: rate(replied, total),
+            attendRate: rate(attend, total),
+            byMemberType,
+            bookRoom: items.filter((item) => item.bookRoom !== '').length,
+            bookTicket: items.filter((item) => item.bookTicket !== '').length,
+        },
+        items,
+    };
+}

package/dist/shortcuts/meeting/operations/eb/catalog.js

@@ -13,6 +13,8 @@
  * - 详情 / 写：只用 body（详情 body 顶层 mainTable；写操作 body 用 datas 数组包裹 mainTable）。
  * - 写操作日期字段统一 `yyyy-MM-dd HH:mm`（不带秒）；create 不传 id，update/delete 必传 id。
  */
+import { summarizeReceiptRows, summarizeSignRows } from './attendance-summary.js';
+import { summarizeTaskProgress } from './task-progress.js';
 const MEETING_FIELDS_CREATE = [
     'mt_creator', 'mt_name', 'begin_datetime', 'end_datetime', 'mt_status', 'operate_type',
     'is_decision', 'mt_type', 'caller', 'contacter', 'mt_format', 'mt_desc', 'mt_hours',
@@ -27,6 +29,20 @@ const MEETING_FIELDS_CHANGE = [
     'next_occur_date', 'repeat_status', 'repeat_id', 'request_id', 'mt_status',
     'attend_user', 'reporting_user',
 ];
+/**
+ * 签到字段（2026-09-21 按最新接口文档 `RestfulDocumentation (6)` 补全）。
+ * 原清单缺 `map_typeback` / `signback_longitude` / `signback_latitude` / `external_*` 7 个字段，
+ * 会导致签退经纬度与外部人员信息写不进去。
+ */
+const SIGN_FIELDS_CREATE = [
+    'mt_id', 'hylx', 'site', 'sign_flag', 'user_id', 'attend_type', 'sign_time', 'sign_reson',
+    'is_sign', 'longitude', 'latitude', 'sign_remark', 'signback_time', 'backsite', 'map_type', 'map_typeback',
+    'signback_longitude', 'signback_latitude', 'allow_late_time', 'sign_out_status',
+    'external_flag', 'external_name', 'external_email', 'external_phone', 'external_remark',
+    'sub_dept', 'department',
+];
+/** 更新签到：在 create 字段基础上加 id（必填）。 */
+const SIGN_FIELDS_UPDATE = ['id', ...SIGN_FIELDS_CREATE];
 const ROOM_FIELDS = [
     'id', 'room_name', 'hrm_ids', 'org_id', 'status', 'mr_type', 'place', 'room_attr',
     'allow_minnum', 'allow_maxnum', 'rs_style', 'room_desc', 'equipments', 'dsporder', 'images',
@@ -82,6 +98,8 @@ export const EB_ENDPOINTS = [
         fields: MEETING_FIELDS_CHANGE,
         requiredFields: ['id', 'operate_type'],
         dateFields: ['begin_datetime', 'end_datetime', 'next_occur_date'],
+        // 主键必须走 URL（updateFormData 端点统一要求，2026-09-21 真机实测）
+        pkQueryParam: 'id',
         summary: 'EB 版变更会议（change_meeting）：必传 id + operate_type；取消会议也用本接口',
         notes: ['变更用 CHANGE；取消用 CANCEL 并置 mt_status=4。'],
     },
@@ -126,6 +144,8 @@ export const EB_ENDPOINTS = [
         interfacePk: 'update_room',
         fields: ROOM_FIELDS,
         requiredFields: ['id'],
+        // 主键必须走 URL（updateFormData 端点统一要求）
+        pkQueryParam: 'id',
         summary: 'EB 版更新会议室（update_room）：仅 id 必填',
     },
     {
@@ -176,6 +196,8 @@ export const EB_ENDPOINTS = [
         countPk: 'query_meeting_sign_count',
         queryParams: ['mt_id', 'signMember', 'sign_status', 'sign_back_status'],
         summary: 'EB 版签到列表（query_meeting_sign_list + count）',
+        // 附带出席汇总（data.progress）：各状态人数 / 已签退 / 出席率；原始 rows 原样保留。
+        summarizeRows: summarizeSignRows,
         notes: [
             'sign_status：0缺席/1正常/2请假/3迟到/4早退/5未签退/6迟到未签退/7迟到早退；sign_back_status：0已签退/1未签退/2早退。',
             '未签到判断：sign_time 为空或查不到记录。',
@@ -194,28 +216,33 @@ export const EB_ENDPOINTS = [
         operation: 'meeting.eb.sign.create',
         kind: 'create',
         interfacePk: 'create_meeting_sign',
-        fields: [
-            'mt_id', 'hylx', 'site', 'sign_flag', 'user_id', 'attend_type', 'sign_time', 'sign_reson',
-            'is_sign', 'longitude', 'latitude', 'sign_remark', 'signback_time', 'backsite', 'map_type',
-            'allow_late_time', 'external_flag', 'sub_dept', 'department', 'sign_out_status',
-        ],
+        fields: SIGN_FIELDS_CREATE,
         requiredFields: ['mt_id'],
-        dateFields: ['sign_time', 'signback_time', 'allow_late_time'],
+        // 签到表时间字段**必须带秒**（真机实测：传 yyyy-MM-dd HH:mm 被拒，要求 yyyy-MM-dd HH:mm:ss）
+        secondDateFields: ['sign_time', 'signback_time', 'allow_late_time'],
         summary: 'EB 版新建签到记录（create_meeting_sign）：必填 mt_id',
+        notes: [
+            '仅用于「建会后初始化签到记录」等**该会议尚无签到记录**的场景。',
+            '⚠️ **补签不是本接口**：已有记录再 create 会产生重复签到数据，补签请用 meeting.eb.sign.mark。',
+        ],
     },
     {
         domain: 'sign',
         operation: 'meeting.eb.sign.update',
         kind: 'update',
         interfacePk: 'update_meeting_sign_info',
-        fields: [
-            'id', 'mt_id', 'hylx', 'site', 'sign_flag', 'user_id', 'attend_type', 'sign_time', 'sign_reson',
-            'is_sign', 'longitude', 'latitude', 'sign_remark', 'signback_time', 'backsite', 'map_type',
-            'allow_late_time', 'external_flag', 'sub_dept', 'department', 'sign_out_status',
-        ],
+        fields: SIGN_FIELDS_UPDATE,
         requiredFields: ['id', 'mt_id'],
-        dateFields: ['sign_time', 'signback_time', 'allow_late_time'],
+        // 同 create：签到时间字段必须带秒（yyyy-MM-dd HH:mm:ss）
+        secondDateFields: ['sign_time', 'signback_time', 'allow_late_time'],
+        // 主键必须走 URL（真机实测：只在 body 里传 id 会报「主键传入不能为空」）
+        pkQueryParam: 'id',
         summary: 'EB 版更新签到记录（update_meeting_sign_info）：必传 id + mt_id',
+        notes: [
+            '**补签 / 补签退的正确入口**（`meeting.eb.sign.mark` 即封装本接口）。',
+            '必传 id = **签到记录 id**（从 meeting.eb.sign.list 的 rows[].mainTable.id 取），不是会议 id；mt_id 也要带。',
+            'is_sign：0缺席/1正常/2请假/3迟到/4早退/5未签退/6迟到未签退/7迟到早退；sign_out_status 对应签退状态。',
+        ],
     },
     {
         domain: 'receipt',
@@ -225,7 +252,9 @@ export const EB_ENDPOINTS = [
         countPk: 'query_meeting_receipt_count',
         queryParams: ['mt_id', 'hrmmember', 'is_attend'],
         summary: 'EB 版回执列表（query_meeting_receipt_list + count）',
-        notes: ['is_attend：0否/1是。'],
+        // 附带出席汇总（data.progress）：参加 / 不参加 / 未回执、回执率、人员类型分布；原始 rows 原样保留。
+        summarizeRows: summarizeReceiptRows,
+        notes: ['is_attend：0否/1是（URL query 筛选）；`attend_status` 空 = 未回执，`0` = 不参加、`1` = 参加。'],
     },
     {
         domain: 'receipt',
@@ -263,6 +292,8 @@ export const EB_ENDPOINTS = [
         ],
         requiredFields: ['id', 'mt_id', 'member_id', 'attend_status'],
         dateFields: ['arrive_date_time', 'return_date_time'],
+        // 主键必须走 URL（updateFormData 端点统一要求）
+        pkQueryParam: 'id',
         summary: 'EB 版更新回执（update_meeting_receipt）：attend_status 0否/1是',
     },
     {
@@ -324,6 +355,8 @@ export const EB_ENDPOINTS = [
         interfacePk: 'update_mt_topicType_info',
         fields: ['id', 'name', 'topic_type_num', 'topic_type_name', 'data_status'],
         requiredFields: ['id'],
+        // 主键必须走 URL（updateFormData 端点统一要求）
+        pkQueryParam: 'id',
         summary: 'EB 版更新议题类型（update_mt_topicType_info）：必传 id',
     },
     {
@@ -362,6 +395,8 @@ export const EB_ENDPOINTS = [
         ],
         requiredFields: ['id'],
         dateFields: ['start_time', 'end_time'],
+        // 主键必须走 URL（updateFormData 端点统一要求）
+        pkQueryParam: 'id',
         summary: 'EB 版更新会议议题（update_mt_topic_info）：必传 id',
         notes: ['topic_status：0待开始/1进行中/2已结束。'],
     },
@@ -383,6 +418,143 @@ export const EB_ENDPOINTS = [
             '据此判断 EB 版建会是否需走流程（审批开启 → 走 workflow，不由 CLI 直接建会）。',
         ],
     },
+    // ---------------------------------------------------------------------------
+    // 会议决议（决议概述表 + 决议任务表）—— 2026-09-21 新增
+    // 链路：create_mt_decision 写「概述 + 明细」→ 用户配置的 ESB 联动按明细生成决议任务
+    //      → update_mt_isdecision 把会议标记为已决议（is_decision=2 + decision_Id + mt_status）
+    //      → 后续用 decisionTask.* 查进度、更新完成状态
+    // ---------------------------------------------------------------------------
+    {
+        domain: 'decision',
+        operation: 'meeting.eb.decision.list',
+        kind: 'list',
+        interfacePk: 'query_mt_decision_list',
+        countPk: 'query_mt_decision_count',
+        queryParams: ['mt_id', 'name', 'creator', 'data_status'],
+        summary: 'EB 版会议决议列表（query_mt_decision_list + count）',
+        notes: [
+            '一个会议**只有一个**决议概述（按 mt_id 查即可）。',
+            '主表为概述（mt_content 为决议概述文本），detail1 为决议明细。',
+        ],
+    },
+    {
+        domain: 'decision',
+        operation: 'meeting.eb.decision.detail',
+        kind: 'detail',
+        interfacePk: 'query_mt_decision_info',
+        summary: 'EB 版会议决议详情（query_mt_decision_info）：含 detail1 决议明细',
+    },
+    {
+        domain: 'decision',
+        operation: 'meeting.eb.decision.create',
+        kind: 'create',
+        interfacePk: 'create_mt_decision',
+        // ⚠️ data_status **不在**写入字段内：2026-09-21 真机实测该接口拒绝它
+        // （DataError:dataKey:data_status,该字段不存在）；提交状态由系统自动置为 1（回查列表 data_status=1）。
+        fields: ['mt_id', 'mt_content'],
+        requiredFields: ['mt_id', 'mt_content'],
+        summary: 'EB 版创建会议决议（create_mt_decision）：主表概述 + detail1 决议明细',
+        notes: [
+            'mt_id 关联会议；mt_content 为概述文本（由调用方结合议题 / 纪要 / 材料汇总后传入）。',
+            '**不要传 data_status**：该接口不接受该字段（真机报 DataError:该字段不存在），提交状态由系统自动置 1。',
+            'detail1 至少 1 条：ESB 按明细逐条生成决议任务；`rummager`（检查人）已改为非必填。',
+            'decision_status 默认 0（未完成）、related_type 默认 0（未关联）；executors 必须是**员工 id**。',
+        ],
+        details: [
+            {
+                node: 'detail1',
+                fields: [
+                    'sort_number', 'decision_title', 'executors', 'rummager', 'begin_datetime', 'end_datetime',
+                    'related_type', 'relate_agenda', 'decision_status', 'relate_task',
+                ],
+                requiredFields: ['decision_title', 'executors', 'begin_datetime', 'end_datetime', 'decision_status'],
+                dateFields: ['begin_datetime', 'end_datetime'],
+                // 0未完成 / 1已完成 / 2已延期（非法值 EB 常静默忽略，故入口拦下）
+                enumFields: { decision_status: ['0', '1', '2'] },
+                minRows: 1,
+                purpose: '决议明细：每条 = 一项待办任务',
+            },
+        ],
+    },
+    {
+        domain: 'decision',
+        operation: 'meeting.eb.decision.delete',
+        kind: 'delete',
+        interfacePk: 'delete_mt_decision',
+        summary: 'EB 版删除会议决议（delete_mt_decision）：仅传 id（概述 id）',
+        notes: ['删除概述**不会**自动回收已生成的决议任务，需要时另行处理。'],
+    },
+    {
+        domain: 'decisionTask',
+        operation: 'meeting.eb.decisionTask.list',
+        kind: 'list',
+        interfacePk: 'query_mt_decision_task_list',
+        countPk: 'query_mt_decision_task_count',
+        queryParams: ['mt_id', 'relate_decision', 'decision_status', 'executors', 'decision_title'],
+        summary: 'EB 版决议任务列表（query_mt_decision_task_list + count）：一条任务 = 一条决议明细',
+        // 声明式进度汇总：结果进 `data.progress`（原始 rows 原样保留），实现见 task-progress.ts。
+        summarizeRows: summarizeTaskProgress,
+        notes: [
+            '★ **`data.progress` 已直接给出进度与延误**，不需要自己解析 detail1：`progress.summary` 是整页汇总（total/done/overdue/inProgress/pending）；`progress.items[]` 逐任务给出 `progress.status`（done 全员完成 / overdue 有人延期 / inProgress 部分完成 / pending 尚未开始）与 `members[]`（每人 executorId / executorName / status / finishDate）。',
+            '任务由用户配置的 **ESB 联动**生成：一条**决议明细**生成**一个任务**；明细里写多个执行人 ⇒ 该任务**多人共同跟进**（真机实测：1 明细 + 2 执行人 → 仅 1 个任务）。',
+            '看某会议的全部任务 → 传 mt_id；看某人的任务 → 传 executors（员工 id）；分页用 pageNo/pageSize（分页必须走 body.pageInfo，CLI 已处理）。',
+            '★ **读进度请看 `detail1`**：每条 = 一个执行人的跟进记录，含 `finish_status`（未完成/已完成/已延期）、`finish_date`、`executor`；**同一执行人重复更新会覆盖其记录，不同执行人是追加**（真机实测互不覆盖）。',
+            '⚠️ **`mainTable.decision_status` 不能作为进度依据**：真机实测它**始终为「未完成」**，既不随 detail1 变化，也无法经 `update_mt_decision_task` 写入（该接口只映射 detail1），故 catalog 未暴露该字段。',
+            '任务由明细带出 `begin_datetime`/`end_datetime`/`decision_title`，可用于展示计划周期。',
+        ],
+    },
+    {
+        domain: 'decisionTask',
+        operation: 'meeting.eb.decisionTask.update',
+        kind: 'update',
+        interfacePk: 'update_mt_decision_task',
+        // ⚠️ 只开放 id：真机实测即使传主表 `decision_status`，接口返回成功但**值不生效**
+        // （该接口只映射 detail1 明细），故不暴露它以免误导。
+        fields: ['id'],
+        requiredFields: ['id'],
+        // 主键必须走 URL（updateFormData 端点统一要求）
+        pkQueryParam: 'id',
+        summary: 'EB 版更新决议任务完成状态（update_mt_decision_task）：按执行人更新 detail1',
+        notes: [
+            'id = **任务 id**（decisionTask.list 的 rows[].mainTable.id），不是会议 id、不是决议 id。',
+            'detail1 传 executor（员工 id）+ finish_status（0未完成/1已完成/2已延期）+ finish_date（**带秒**：yyyy-MM-dd HH:mm:ss）。',
+            '⚠️ **finish_date 是服务端必填**（真机：不传报「存为未填写的必填字段: finish_date」）；把任务改回「未完成」时传一个**空格**即可显式清空（CLI 会落库为空串，与页面生成的未完成记录一致）。',
+            '不传 operationinfo.operateType 时为「更新追加」，不会覆盖其他执行人的记录 —— 真机实测：同一任务上两人分别跟进后，detail1 保留**两条**记录。',
+            '⚠️ **任务主表的 decision_status 不随 detail1 变化**（真机实测始终为「未完成」）；查任务进度请看 detail1 的 finish_status。',
+            '写入后建议回查 decisionTask.list 确认；EB 写接口报错**不代表没有写入**。',
+        ],
+        details: [
+            {
+                node: 'detail1',
+                fields: ['executor', 'finish_status', 'finish_date'],
+                // finish_date 服务端也是必填；「未完成」时传空格显式清空（见 factory 的 normalizeDetailRow）。
+                requiredFields: ['executor', 'finish_status', 'finish_date'],
+                // 0未完成 / 1已完成 / 2已延期（非法值 EB 常静默忽略，故入口拦下并提示可选值）
+                enumFields: { finish_status: ['0', '1', '2'] },
+                // finish_date 必须**带秒**：真机实测传 "2026-09-21 18:30" 被拒（要求 yyyy-MM-dd HH:mm:ss）。
+                secondDateFields: ['finish_date'],
+                minRows: 1,
+                purpose: '执行人跟进：同一任务的每个执行人分别记录完成状态',
+            },
+        ],
+    },
+    {
+        domain: 'meeting',
+        operation: 'meeting.eb.meeting.markDecided',
+        kind: 'update',
+        interfacePk: 'update_mt_isdecision',
+        fields: ['id', 'decision_Id', 'is_decision', 'mt_status'],
+        requiredFields: ['id', 'is_decision'],
+        // 主键必须走 URL（updateFormData 端点统一要求）
+        pkQueryParam: 'id',
+        summary: 'EB 版把会议标记为已决议（update_mt_isdecision）：写回关联决议 + 决议状态 + 会议状态',
+        notes: [
+            'is_decision：0未决议 / 1决议临时保存 / **2决议提交完成**。',
+            'decision_Id：关联的决议概述 id（decision.create 的 dataIds[0]）。',
+            'mt_status：**8结束**（产生决议即视为会议结束），也可按需传 9进行中 等。',
+            'detail1（汇报人）/ detail2（服务项目）已由接口配置清空，**无需传**。',
+        ],
+    },
 ];
 /** 写操作（create/update/delete）需要确认链。 */
 export function isWriteKind(kind) {