weaver-work-cli 0.1.1 → 0.1.4

package/dist/shortcuts/mail/operations/mail-send.js

@@ -0,0 +1,474 @@
+import { randomBytes } from 'node:crypto';
+import { mailValidationError } from '../errors.js';
+import { WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
+const CONTINUATION_TTL_MS = 600_000;
+function b64(s) {
+    return Buffer.from(s, 'utf8').toString('base64');
+}
+function splitNames(s) {
+    if (!s)
+        return [];
+    return String(s).split(/[,，;；、\s]+/).map((x) => x.trim()).filter(Boolean);
+}
+function looksLikeEmail(s) {
+    return /@/.test(s);
+}
+class CandidateError extends Error {
+    pending;
+    constructor(pending) {
+        super('收件人存在重名/多候选，需用户确认后以 toId/ccId/bccId 精确指定');
+        this.pending = pending;
+    }
+}
+async function mailAdd(env, flag, mailResourceId) {
+    const params = { flag: String(flag) };
+    if (mailResourceId)
+        params.mailResourceId = String(mailResourceId);
+    if (flag === '3')
+        params.emlMailResourceIds = String(mailResourceId);
+    const rk = randomBytes(3).toString('hex').slice(0, 6);
+    const value = (await env.host.request({
+        path: '/api/mail/base/add/mailAdd',
+        method: 'POST',
+        query: { v: rk },
+        form: params,
+    }));
+    const d = value?.data || {};
+    if (!d.sessionUuid)
+        throw new Error('mailAdd 未返回 sessionUuid：' + JSON.stringify(value).slice(0, 300));
+    return d;
+}
+async function searchInternal(env, keyword) {
+    const value = (await env.host.request({
+        path: '/api/mail/base/common/browser/complete/resource',
+        method: 'POST',
+        body: {
+            browserMultiple: true,
+            authWecahtBook: false,
+            wxDepNeedConvertCount: 0,
+            wxEmpNeedConvertCount: 0,
+            wxTotalNeedConvertCount: 0,
+            secretLevel: '',
+            newly: 1,
+            searchValue: keyword,
+        },
+    }));
+    return value?.data?.data || [];
+}
+async function searchExternal(env, keyword) {
+    const value = (await env.host.request({
+        path: '/api/mail/base/add/addressFullsearch',
+        method: 'POST',
+        query: { keyword: encodeURIComponent(keyword), sf_request_type: 'ajax' },
+    }));
+    return value?.data || [];
+}
+async function resolveInternal(env, names) {
+    const out = [];
+    const pending = [];
+    for (const n of names) {
+        if (/^\d+$/.test(n)) {
+            out.push({ id: n, type: 'resource', userids: n, name: n });
+            continue;
+        }
+        const list = await searchInternal(env, n);
+        const exact = list.filter((x) => x.name === n || x.content === n);
+        const toItem = (x) => ({ id: x.id, type: 'resource', userids: x.id, name: x.name || x.content || n });
+        const cand = (x) => ({ id: x.id, name: x.name || x.content, department: x.department, position: x.position });
+        if (exact.length === 1)
+            out.push(toItem(exact[0]));
+        else if (exact.length > 1)
+            pending.push({ keyword: n, reason: '重名', candidates: exact.map(cand) });
+        else if (list.length === 1)
+            out.push(toItem(list[0]));
+        else if (list.length > 1)
+            pending.push({ keyword: n, reason: '多候选（无精确匹配）', candidates: list.slice(0, 5).map(cand) });
+        else
+            throw new Error('未找到内部人员：' + n + '（可尝试姓名/工号；若是部门请用 to-dep/cc-dep/bcc-dep 指定）');
+    }
+    if (pending.length)
+        throw new CandidateError(pending);
+    return out;
+}
+async function searchDepartmentTree(env, parentId) {
+    const body = {
+        browserMultiple: true,
+        authWecahtBook: false,
+        wxDepNeedConvertCount: 0,
+        wxEmpNeedConvertCount: 0,
+        wxTotalNeedConvertCount: 0,
+        secretLevel: '',
+        cmd: 'teams',
+        containsPartTimeEmployee: false,
+        browserLeftTreeDefaultExpandedLevel: '1',
+        pageSize: 30,
+        current: 1,
+    };
+    if (parentId)
+        Object.assign(body, { leftCompanyId: '1', type: 'department', id: parentId });
+    const value = (await env.host.request({
+        path: '/api/mail/base/common/browser/leftData/resource',
+        method: 'POST',
+        body,
+    }));
+    return value?.data?.data || [];
+}
+async function collectDepartmentMatches(env, name) {
+    const matches = [];
+    async function walk(nodes, depth) {
+        for (const n of nodes || []) {
+            const nm = n.content || n.contentDesc || '';
+            if (nm === name)
+                matches.push({ id: n.id, name: nm, isLeaf: !!n.isLeaf });
+            if (!n.isLeaf) {
+                if (n.children?.length)
+                    await walk(n.children, depth + 1);
+                else if (depth < 5) {
+                    try {
+                        await walk(await searchDepartmentTree(env, n.id), depth + 1);
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+            }
+        }
+    }
+    await walk(await searchDepartmentTree(env, undefined), 0);
+    return matches;
+}
+async function resolveDepartmentMemberIds(env, deptId) {
+    const value = (await env.host.request({
+        path: '/api/mail/base/common/browser/data/resource',
+        method: 'POST',
+        body: {
+            browserMultiple: true,
+            authWecahtBook: false,
+            wxDepNeedConvertCount: 0,
+            wxEmpNeedConvertCount: 0,
+            wxTotalNeedConvertCount: 0,
+            secretLevel: '',
+            cmd: 'teams',
+            current: 1,
+            leftTreeSelectedId: String(deptId),
+            pageSize: 200,
+            formDatas: {
+                username: [{ usernameOpt: 'in' }],
+                status: [{ statusSelect: ['normal'] }],
+                subcompany: [{ subcompanyOpt: 'in' }],
+                department: [{ departmentOpt: 'in' }],
+                role: [{ roleOpt: 'in' }],
+                position: [{ positionOpt: 'in' }],
+            },
+        },
+    }));
+    const arr = value?.data?.data || [];
+    return arr.map((x) => x.id).filter(Boolean);
+}
+async function resolveDepartment(env, names) {
+    const out = [];
+    const pending = [];
+    for (const n of names) {
+        const matches = await collectDepartmentMatches(env, n);
+        if (matches.length === 1) {
+            const ids = await resolveDepartmentMemberIds(env, matches[0].id);
+            out.push({
+                id: matches[0].id,
+                type: 'department',
+                userids: ids.join(','),
+                leftAllLevel: true,
+                name: matches[0].name,
+                memberCount: ids.length,
+            });
+        }
+        else if (matches.length > 1) {
+            pending.push({ keyword: n, reason: '同名部门（请在结果中选择）', candidates: matches.map((x) => ({ id: x.id, name: x.name, type: '部门' })) });
+        }
+        else {
+            throw new Error('未找到部门：' + n + '（请确认部门名称，或用 to 指定人员）');
+        }
+    }
+    if (pending.length)
+        throw new CandidateError(pending);
+    return out;
+}
+async function resolveExternal(env, emails) {
+    const out = [];
+    for (const e of emails) {
+        if (looksLikeEmail(e)) {
+            out.push({ mailAddress: e, mailNickName: e.split('@')[0] });
+            continue;
+        }
+        const list = await searchExternal(env, e);
+        const hit = list.find((x) => x.mailAddress?.includes(e)) || list[0];
+        if (!hit)
+            throw new Error('未找到外部邮箱：' + e + '（可尝试完整邮箱地址）');
+        out.push({ mailAddress: hit.mailAddress, mailNickName: hit.mailNickName });
+    }
+    return out;
+}
+function wrapContent(userHtml, clobContent) {
+    const u = userHtml ? '<div>' + userHtml + '</div><div>&nbsp;</div><div>&nbsp;</div>' : '';
+    return '<div class="cke__pc cke_editable cke_editable_themed cke_contents_ltr" style="font-size: 12px;">' + u + (clobContent || '') + '</div>';
+}
+async function parseRecipients(env, add, args) {
+    const flag = String(args.flag ?? '-1');
+    const explicit = args.external === true ? 'external' : (args.internal === true ? 'internal' : null);
+    const toList = splitNames(args.to);
+    const ccList = splitNames(args.cc);
+    const bccList = splitNames(args.bcc);
+    const toIdList = splitNames(args.toId);
+    const ccIdList = splitNames(args.ccId);
+    const bccIdList = splitNames(args.bccId);
+    const toDepList = splitNames(args.toDep);
+    const ccDepList = splitNames(args.ccDep);
+    const bccDepList = splitNames(args.bccDep);
+    let prefilled = null;
+    if ((flag === '1' || flag === '4') && toList.length === 0) {
+        const inner = (add.sendTo_internal || []).map((x) => ({ id: x.id, type: 'resource', userids: x.id }));
+        const outer = add.sendTo_outer || [];
+        if (outer.length)
+            prefilled = { kind: 'external', to: outer.map((x) => x.mailAddress), cc: [], bcc: [] };
+        else if (inner.length)
+            prefilled = { kind: 'internal', to: inner.map((x) => x.id), cc: [], bcc: [] };
+    }
+    let kind = explicit || (prefilled ? prefilled.kind : null);
+    if (!kind) {
+        const hasDep = toDepList.length || ccDepList.length || bccDepList.length;
+        const hasId = toIdList.length || ccIdList.length || bccIdList.length;
+        if (hasDep || hasId)
+            kind = 'internal';
+        else {
+            const all = [...toList, ...ccList, ...bccList];
+            const hasEmail = all.some(looksLikeEmail);
+            const hasName = all.some((x) => !looksLikeEmail(x));
+            if (hasEmail && hasName) {
+                throw new Error('收件人内外部混用：邮箱地址=外部邮件、姓名=内部邮件，请统一，或用 --internal/--external 明确邮件类型');
+            }
+            if (!all.length)
+                throw new Error('请先说明收件人（姓名=内部邮件 / 邮箱地址=外部邮件 / 部门用 to-dep）');
+            kind = hasEmail ? 'external' : 'internal';
+        }
+    }
+    const to = prefilled ? prefilled.to : toList;
+    const cc = prefilled ? prefilled.cc : ccList;
+    const bcc = prefilled ? prefilled.bcc : bccList;
+    if (kind === 'internal') {
+        const resolveGroup = async (nameList, idList, depList) => {
+            const persons = idList.length ? await resolveInternal(env, idList) : nameList.length ? await resolveInternal(env, nameList) : [];
+            const deps = depList.length ? await resolveDepartment(env, depList) : [];
+            return [...persons, ...deps];
+        };
+        const rawTo = await resolveGroup(to, toIdList, toDepList);
+        const rawCc = await resolveGroup(cc, ccIdList, ccDepList);
+        const rawBcc = await resolveGroup(bcc, bccIdList, bccDepList);
+        const clean = (arr) => arr.map((x) => (x.type === 'department'
+            ? { id: x.id, type: 'department', userids: x.userids, leftAllLevel: x.leftAllLevel }
+            : { id: x.id, type: 'resource', userids: x.userids }));
+        const ids = (arr) => [...new Set(arr.flatMap((x) => String(x.userids || '').split(',').filter(Boolean)))].join(',');
+        const names = (arr) => arr.map((x) => (x.type === 'department' ? `${x.name}（${x.memberCount}人）` : x.name)).join('、');
+        const totalCount = ids([...rawTo, ...rawCc, ...rawBcc]).split(',').filter(Boolean).length;
+        return {
+            fields: {
+                isInternal: 1,
+                internalTo: clean(rawTo),
+                internalCc: clean(rawCc),
+                internalBcc: clean(rawBcc),
+                internaltonewIds: ids(rawTo),
+                internalccnewIds: ids(rawCc),
+                internalbccnewIds: ids(rawBcc),
+                usernameTo: JSON.stringify(clean(rawTo)),
+                usernameCc: JSON.stringify(clean(rawCc)),
+                usernameBcc: JSON.stringify(clean(rawBcc)),
+            },
+            display: { to: names(rawTo), cc: names(rawCc), bcc: names(rawBcc) },
+            recipientCount: totalCount,
+        };
+    }
+    const rawTo = to.length ? await resolveExternal(env, to) : [];
+    const rawCc = cc.length ? await resolveExternal(env, cc) : [];
+    const rawBcc = bcc.length ? await resolveExternal(env, bcc) : [];
+    const emails = (arr) => arr.map((x) => x.mailAddress).join(',');
+    const names = (arr) => arr.map((x) => x.mailNickName || x.mailAddress).join('、');
+    const from = (add.sendFrom_outer || []).find((x) => x.selected) || (add.sendFrom_outer || [])[0];
+    if (!from || !from.mailAddress) {
+        throw new Error('当前账号未配置外部邮箱发件账号（mailAdd.sendFrom_outer 为空），无法发送外部邮件；请先在邮件设置中绑定外部邮箱账号');
+    }
+    const totalCount = [...rawTo, ...rawCc, ...rawBcc].length;
+    return {
+        fields: {
+            isInternal: 0,
+            sendTo: emails(rawTo),
+            sendCc: emails(rawCc),
+            sendBcc: emails(rawBcc),
+            usernameTo: JSON.stringify(rawTo),
+            usernameCc: JSON.stringify(rawCc),
+            usernameBcc: JSON.stringify(rawBcc),
+            mailAccountId: from.id ? String(from.id) : '',
+            sendFrom: from.mailAddress || '',
+        },
+        display: { to: names(rawTo) || '(未指定收件人)', cc: names(rawCc), bcc: names(rawBcc) },
+        recipientCount: totalCount,
+    };
+}
+async function checkMailConfig(env, isInternal) {
+    const value = (await env.host.request({
+        path: '/api/mail/base/getEmailAllConfig',
+        method: 'POST',
+        query: { from: 'mailadd' },
+    }));
+    const sys = value?.data?.sysConfig || {};
+    if (isInternal === 1) {
+        if (sys.innerMail !== undefined && Number(sys.innerMail) !== 1) {
+            throw new Error('当前环境未启用内部邮件（getEmailAllConfig.sysConfig.innerMail=' + sys.innerMail + '），无法发送内部邮件');
+        }
+    }
+    else {
+        if (sys.outterMail !== undefined && Number(sys.outterMail) !== 1) {
+            throw new Error('当前环境未启用外部邮件（getEmailAllConfig.outterMail=0），无法发送外部邮件');
+        }
+    }
+    if (sys.innerMail !== undefined && sys.outterMail !== undefined && Number(sys.innerMail) !== 1 && Number(sys.outterMail) !== 1) {
+        throw new Error('系统未启用邮件功能（内部/外部邮件均未开启），无法发送邮件');
+    }
+}
+async function precheckSend(env, body) {
+    const c = (await env.host.request({ path: '/api/mail/send/canSendMail', method: 'POST', body }));
+    const cdata = c?.data || {};
+    if (cdata.success !== undefined && cdata.success !== 1) {
+        throw new Error('发送前校验未通过：' + (cdata.msg || '未知拦截（canSendMail）'));
+    }
+}
+async function buildBody(env, add, args, draft) {
+    const flag = String(args.flag ?? '-1');
+    const isReply = flag === '1' || flag === '3';
+    const fullHtml = wrapContent(String(args.content || ''), isReply ? (add.clobContent || '') : '');
+    const { fields, display, recipientCount } = await parseRecipients(env, add, args);
+    const body = {
+        saveDraft: draft,
+        content: b64(fullHtml),
+        sessionUuid: add.sessionUuid,
+        subject: args.subject || add.mailSubject || '',
+        mailResourceId: args.id ? String(args.id) : '',
+        isInternal: fields.isInternal,
+        flag: Number(flag),
+        files: args.files || '',
+        filesizes: args.filesizes || '',
+        ...fields,
+        mailPriority: '0',
+        saveToSent: true,
+        isHtmlMode: '1',
+        op_isTimingSend: args.timing ? '1' : '0',
+        timingdate: args.timing || '',
+        secretLevel: '40',
+        fromModule: 'mail',
+    };
+    if (isReply)
+        body.oldMailId = String(args.id);
+    return { body, display, recipientCount };
+}
+// ---------------------------------------------------------------------------
+// prepare / apply
+// ---------------------------------------------------------------------------
+const SEND_SCHEMA = schemaOf({
+    flag: { type: 'string', description: '新建 -1 / 回复 1 / 转发 3 / 编辑草稿 4' },
+    id: SCHEMA_STRING,
+    to: SCHEMA_STRING,
+    cc: SCHEMA_STRING,
+    bcc: SCHEMA_STRING,
+    toDep: SCHEMA_STRING,
+    ccDep: SCHEMA_STRING,
+    bccDep: SCHEMA_STRING,
+    toId: SCHEMA_STRING,
+    ccId: SCHEMA_STRING,
+    bccId: SCHEMA_STRING,
+    external: { type: 'boolean' },
+    internal: { type: 'boolean' },
+    subject: SCHEMA_STRING,
+    content: SCHEMA_STRING,
+    timing: SCHEMA_STRING,
+    files: SCHEMA_STRING,
+    filesizes: SCHEMA_STRING,
+    draft: { type: 'boolean' },
+    confirm: { type: 'boolean' },
+    continuation: SCHEMA_STRING,
+}, { description: '邮件发送（prepare/apply）' });
+const opSendPrepare = {
+    name: 'mail.send.prepare',
+    resource: 'mail/base/add/mailAdd',
+    method: 'POST',
+    action: 'mail.send.prepare',
+    summary: '准备发送（组装请求 + 安全预检 + 输出摘要，不发送）',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: SEND_SCHEMA,
+    async handler(args, env) {
+        const flag = String(args.flag ?? '-1');
+        const draft = args.draft === true;
+        const session = await env.host.getSession();
+        const add = await mailAdd(env, flag, args.id ? String(args.id) : undefined);
+        const { body, display, recipientCount } = await buildBody(env, add, args, draft);
+        await checkMailConfig(env, body.isInternal);
+        await precheckSend(env, body);
+        const flagText = { '-1': '新建', '1': '回复', '3': '转发', '4': '编辑草稿' }[flag] || flag;
+        const continuation = await env.continuation.issue({
+            operation: 'mail.send.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            body,
+            draft,
+            subject: body.subject,
+        }, CONTINUATION_TTL_MS);
+        return mailSuccess('mail.send.prepare', {
+            action: flagText,
+            type: body.isInternal === 1 ? '内部邮件' : '外部邮件',
+            subject: body.subject,
+            to: display.to || '(未指定收件人)',
+            cc: display.cc || '',
+            bcc: display.bcc || '',
+            recipientCount: recipientCount || 0,
+            contentPreview: String(args.content || '').slice(0, 100),
+            includeOriginal: flag === '1' || flag === '3' ? '是（含原邮件引用）' : '否',
+            timing: args.timing ? String(args.timing) : '即时发送',
+            tip: '发送前安全预检已通过；用户确认后以 mail send apply --continuation <token> --yes 执行',
+        }, { continuation });
+    },
+};
+const opSendApply = {
+    name: 'mail.send.apply',
+    resource: 'mail/send/sendMail',
+    method: 'POST',
+    action: 'mail.send.apply',
+    summary: '执行发送（需 continuation 与 confirm）',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: SEND_SCHEMA,
+    async handler(args, env) {
+        if (args.confirm !== true) {
+            throw mailValidationError('confirm_required', 'mail.send.apply 必须传入 confirm=true 与 prepare 返回的 continuation');
+        }
+        if (!args.continuation) {
+            throw mailValidationError('continuation_required', 'mail.send.apply 必须传入 prepare 返回的 continuation');
+        }
+        const lease = await env.continuation.verify(String(args.continuation), 'mail.send.apply');
+        const session = await env.host.getSession();
+        if (lease.baseUrl !== session.baseUrl || lease.profile !== session.profile || lease.userId !== session.userId) {
+            throw mailValidationError('context_mismatch', '确认上下文已变化（租户或登录账号不同），请重新执行 prepare');
+        }
+        const body = lease.body;
+        const draft = lease.draft === true;
+        // 兜底再次校验：配置开关 + canSendMail
+        await checkMailConfig(env, body.isInternal);
+        if (!draft)
+            await precheckSend(env, body);
+        const path = draft ? '/api/mail/send/saveDraft' : '/api/mail/send/sendMail';
+        const value = (await env.host.request({ path, method: 'POST', body }));
+        const d = value?.data || {};
+        if (draft) {
+            return mailSuccess('mail.send.apply', { success: d.status === 1, draft: true, mailResourceId: d.mailResourceId, subject: lease.subject }, { savedDraft: true });
+        }
+        return mailSuccess('mail.send.apply', { success: d.success === 1, msg: d.msg || '邮件已发送', subject: lease.subject }, { sent: true });
+    },
+};
+export const mailSendOperations = [opSendPrepare, opSendApply];

package/dist/shortcuts/mail/operations/mail-sign.js

@@ -0,0 +1,203 @@
+import { mailValidationError } from '../errors.js';
+import { READ, WRITE, mailSuccess, schemaOf, SCHEMA_STRING } from './types.js';
+const CONTINUATION_TTL_MS = 600_000;
+const SIGN_SCHEMA = schemaOf({
+    id: SCHEMA_STRING,
+    signName: SCHEMA_STRING,
+    clobContent: SCHEMA_STRING,
+    signDesc: SCHEMA_STRING,
+    defaultUse: SCHEMA_STRING,
+    signType: SCHEMA_STRING,
+    electronSignEnable: SCHEMA_STRING,
+    confirm: { type: 'boolean' },
+    continuation: SCHEMA_STRING,
+}, { description: '签名保存（prepare/apply）' });
+function buildSignBody(args) {
+    const signName = String(args.signName || '').trim();
+    const clobContent = String(args.clobContent || '').trim();
+    if (!signName)
+        throw new Error('signName（签名名称）必填');
+    if (!clobContent)
+        throw new Error('clobContent（Base64 编码的 HTML 内容）必填');
+    const body = {
+        signName,
+        clobContent,
+        signDesc: args.signDesc ? String(args.signDesc) : '',
+        defaultUse: args.defaultUse !== undefined ? Number(args.defaultUse) : 0,
+        signType: args.signType ? String(args.signType) : '0',
+        electronSignEnable: args.electronSignEnable !== undefined ? Number(args.electronSignEnable) : 0,
+    };
+    if (args.id)
+        body.id = String(args.id);
+    return body;
+}
+const opSignSavePrepare = {
+    name: 'mail.sign.save.prepare',
+    resource: 'mail/base/setting/sign/saveMailSign',
+    method: 'POST',
+    action: 'mail.sign.save.prepare',
+    summary: '新增签名（prepare，不保存）',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: SIGN_SCHEMA,
+    async handler(args, env) {
+        const body = buildSignBody(args);
+        const session = await env.host.getSession();
+        const continuation = await env.continuation.issue({
+            operation: 'mail.sign.save.apply',
+            baseUrl: session.baseUrl,
+            profile: session.profile,
+            userId: session.userId,
+            body,
+        }, CONTINUATION_TTL_MS);
+        return mailSuccess('mail.sign.save.prepare', {
+            signName: body.signName,
+            defaultUse: body.defaultUse,
+            tip: '确认后以 mail sign save --apply --continuation <token> --yes 执行保存',
+        }, { continuation });
+    },
+};
+const opSignSaveApply = {
+    name: 'mail.sign.save.apply',
+    resource: 'mail/base/setting/sign/saveMailSign',
+    method: 'POST',
+    action: 'mail.sign.save.apply',
+    summary: '执行新增签名',
+    risk: WRITE,
+    requiresConfirmation: true,
+    inputSchema: SIGN_SCHEMA,
+    async handler(args, env) {
+        if (args.confirm !== true)
+            throw new Error('mail.sign.save.apply 必须传入 confirm=true 与 prepare 返回的 continuation');
+        if (!args.continuation)
+            throw new Error('mail.sign.save.apply 必须传入 prepare 返回的 continuation');
+        const lease = await env.continuation.verify(String(args.continuation), 'mail.sign.save.apply');
+        const session = await env.host.getSession();
+        if (lease.baseUrl !== session.baseUrl || lease.profile !== session.profile || lease.userId !== session.userId) {
+            throw mailValidationError('context_mismatch', '确认上下文已变化（租户或登录账号不同），请重新执行 prepare');
+        }
+        const value = (await env.host.request({ path: '/api/mail/base/setting/sign/saveMailSign', method: 'POST', body: lease.body }));
+        return mailSuccess('mail.sign.save.apply', { id: value?.data ?? 'SUCCESS' }, {});
+    },
+};
+const opSignUpdate = {
+    name: 'mail.sign.update',
+    resource: 'mail/base/setting/sign/updateMailSign',
+    method: 'POST',
+    action: 'mail.sign.update',
+    summary: '编辑签名（GET 全量 + 保存）',
+    risk: WRITE,
+    inputSchema: schemaOf({
+        id: { type: 'string', description: '签名 id' },
+        signName: SCHEMA_STRING,
+        clobContent: SCHEMA_STRING,
+        signDesc: SCHEMA_STRING,
+        defaultUse: SCHEMA_STRING,
+        signType: SCHEMA_STRING,
+        electronSignEnable: SCHEMA_STRING,
+    }, { required: ['id'], description: '编辑签名' }),
+    async handler(args, env) {
+        const id = String(args.id || '').trim();
+        if (!id)
+            throw new Error('id（签名 id）必填');
+        const form = (await env.host.request({ path: '/api/mail/base/setting/sign/getMailSignForm', method: 'POST', body: { id } }));
+        const cur = form?.data?.formData || {};
+        const body = {
+            id,
+            signName: args.signName ? String(args.signName) : (cur.signName ?? ''),
+            clobContent: args.clobContent ? String(args.clobContent) : (cur.clobContent ?? ''),
+            signDesc: args.signDesc ? String(args.signDesc) : (cur.signDesc ?? ''),
+            defaultUse: args.defaultUse !== undefined ? Number(args.defaultUse) : (cur.defaultUse ?? 0),
+            signType: args.signType ? String(args.signType) : (cur.signType ?? '0'),
+            electronSignEnable: args.electronSignEnable !== undefined ? Number(args.electronSignEnable) : (cur.electronSignEnable ?? 0),
+        };
+        if (!body.signName)
+            throw new Error('签名名称为空（原值缺失且未提供 signName）');
+        if (!body.clobContent)
+            throw new Error('签名内容为空（原值缺失且未提供 clobContent）');
+        const value = (await env.host.request({ path: '/api/mail/base/setting/sign/updateMailSign', method: 'POST', body }));
+        return mailSuccess('mail.sign.update', value?.data ?? 'SUCCESS', { id });
+    },
+};
+const opSignDelete = {
+    name: 'mail.sign.delete',
+    resource: 'mail/base/setting/sign/deleteMailSign',
+    method: 'POST',
+    action: 'mail.sign.delete',
+    summary: '删除签名',
+    risk: WRITE,
+    inputSchema: schemaOf({ id: { type: 'string', description: '签名 id' } }, { required: ['id'], description: '删除签名' }),
+    async handler(args, env) {
+        const id = String(args.id || '').trim();
+        if (!id)
+            throw new Error('id（签名 id）必填');
+        const value = (await env.host.request({ path: '/api/mail/base/setting/sign/deleteMailSign', method: 'POST', body: { id } }));
+        return mailSuccess('mail.sign.delete', value?.data ?? 'SUCCESS', { id });
+    },
+};
+const opSignDefault = {
+    name: 'mail.sign.default',
+    resource: 'mail/base/setting/sign/defaultMailSign',
+    method: 'POST',
+    action: 'mail.sign.default',
+    summary: '设为默认签名',
+    risk: WRITE,
+    inputSchema: schemaOf({ id: { type: 'string', description: '签名 id' } }, { required: ['id'], description: '设默认签名' }),
+    async handler(args, env) {
+        const id = String(args.id || '').trim();
+        if (!id)
+            throw new Error('id（签名 id）必填');
+        const value = (await env.host.request({ path: '/api/mail/base/setting/sign/defaultMailSign', method: 'POST', body: { id } }));
+        return mailSuccess('mail.sign.default', value?.data ?? 'SUCCESS', { id });
+    },
+};
+const opSignQrcode = {
+    name: 'mail.sign.qrcode',
+    resource: 'mail/base/setting/sign/createQRcode',
+    method: 'POST',
+    action: 'mail.sign.qrcode',
+    summary: '生成二维码名片',
+    risk: READ,
+    inputSchema: schemaOf({
+        id: SCHEMA_STRING,
+        userName: SCHEMA_STRING,
+        jobtitle: SCHEMA_STRING,
+        email: SCHEMA_STRING,
+        signLocation: SCHEMA_STRING,
+        mobile: SCHEMA_STRING,
+        telephone: SCHEMA_STRING,
+        fax: SCHEMA_STRING,
+        selected: SCHEMA_STRING,
+    }, { description: '二维码名片' }),
+    async handler(args, env) {
+        let userName = args.userName ? String(args.userName) : '';
+        if (!userName && args.id) {
+            try {
+                const form = (await env.host.request({ path: '/api/mail/base/setting/sign/getMailSignForm', method: 'POST', body: { id: String(args.id) } }));
+                const cur = form?.data?.formData || {};
+                userName = cur.signName || '';
+            }
+            catch { /* 忽略，后续校验 */ }
+        }
+        const body = {
+            userName,
+            jobtitle: args.jobtitle ? String(args.jobtitle) : '',
+            email: args.email ? String(args.email) : '',
+            signLocation: args.signLocation ? String(args.signLocation) : '',
+            mobile: args.mobile ? String(args.mobile) : '',
+            telephone: args.telephone ? String(args.telephone) : '',
+            fax: args.fax ? String(args.fax) : '',
+            selected: args.selected ? String(args.selected) : (userName ? '1,2,3,5' : '1'),
+        };
+        const value = (await env.host.request({ path: '/api/mail/base/setting/sign/createQRcode', method: 'POST', body }));
+        return mailSuccess('mail.sign.qrcode', { qrcode: value?.data ?? '' }, {});
+    },
+};
+export const mailSignOperations = [
+    opSignSavePrepare,
+    opSignSaveApply,
+    opSignUpdate,
+    opSignDelete,
+    opSignDefault,
+    opSignQrcode,
+];