weaver-work-cli 0.1.2 → 0.1.5

package/dist/shortcuts/jiuchuanhui/cache.js

@@ -0,0 +1,441 @@
+/**
+ * jiuchuanhui.cache.init —— 九氚汇配置缓存初始化/刷新（CLI operation）。
+ *
+ * 说明：
+ * - 将 Skill 编排层的缓存初始化能力下沉为真正的 CLI operation（weaver-work-cli jiuchuanhui run jiuchuanhui.cache.init）。
+ * - 复用 host.request 直连 E10 接口（与其它 operation 同一认证链），直接写
+ *   `~/.weaver-e10-jiuchuanhui/{tenantKey}/{userId}/` 下的缓存文件（主文件 + config/{pk}.json）。
+ * - risk: local-file-write —— 只写本地缓存文件，不写任何业务数据，无需 prepare/apply 确认链；
+ *   但写入前保留旧 region/options/spVersion，避免误刷新丢失旧值。
+ * - 7 步：应用发现+13 objId+版本校验 -> cfgId(12 pk) -> 配置详情+字段 data_key -> ebuilder(8 类)
+ *   -> 字段选项(Select/RadioBox/CheckBox) -> 搜索参数(3 搜索 pk) -> 行政区划(按需/保留旧)。
+ * - 入参：{ dryRun?: boolean, verbose?: boolean }。dryRun 只拉取不写入；verbose 打印步骤明细。
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { jiuchuanhuiValidationError } from './errors.js';
+const APP_TAG = 'jch-crm-project';
+const MIN_VERSION = '1.5.11';
+const MODULE_TAGS = [
+    'uf_jch_customer', 'uf_jch_sale', 'uf_jch_clue', 'uf_jch_contact',
+    'uf_jch_customer_open_sea', 'uf_jch_remind', 'uf_jch_rival',
+    'uf_jch_sale_process', 'uf_jch_sale_stage', 'uf_jch_clue_pool',
+    'uf_jch_lose_reason', 'uf_jch_customer_cmt', 'uf_jch_sale_cmt',
+];
+const CREATE_PKS = ['customer_create_api', 'sale_create_api', 'ebclue_ai_create_api', 'contact_create_api', 'ebcontact_plan_create_api'];
+const SEARCH_PKS = ['ebcustomer_search_api', 'ebsale_search_api', 'ebclue_ai_search_api'];
+const UPDATE_PKS = ['customer_update_api', 'sale_update_api', 'ebclue_ai_update_api', 'contact_update_api'];
+const ALL_PKS = [...CREATE_PKS, ...SEARCH_PKS, ...UPDATE_PKS];
+const PK_TO_TAG = {
+    customer_create_api: 'uf_jch_customer',
+    sale_create_api: 'uf_jch_sale',
+    ebclue_ai_create_api: 'uf_jch_clue',
+    contact_create_api: 'uf_jch_contact',
+    ebcontact_plan_create_api: 'uf_jch_remind',
+    ebcustomer_search_api: 'uf_jch_customer',
+    ebsale_search_api: 'uf_jch_sale',
+    ebclue_ai_search_api: 'uf_jch_clue',
+    customer_update_api: 'uf_jch_customer',
+    sale_update_api: 'uf_jch_sale',
+    ebclue_ai_update_api: 'uf_jch_clue',
+    contact_update_api: 'uf_jch_contact',
+};
+// detail 顶层与字段仅保留运行必需键（对齐缓存规范 DETAIL_KEEP_KEYS / FIELD_KEEP_KEYS）
+const DETAIL_KEEP_KEYS = ['id', 'interfacePk', 'interfaceName', 'datasNumber', 'datasSize', 'mainFields', 'detailFields', 'interfaceType', 'relevanceForm'];
+const FIELD_KEEP_KEYS = ['fieldid', 'isRequired', 'isInput', 'data_key', 'title', 'component_type'];
+const OPT_COMP = ['Select', 'RadioBox', 'CheckBox'];
+// Ebuilder 关联数据 8 类（缓存 key -> 接口路径 -> 名称字段优先级）
+const EBUILDER_QUERIES = [
+    { key: 'customer_open_sea', path: '/api/ebuilder/form/formdata/v2/getFormDataList/customer_open_sea_search_api', nameFields: ['open_sea_name', 'name'] },
+    { key: 'sale_stage', path: '/api/ebuilder/form/formdata/v2/getFormDataList/sale_stage_search_api', nameFields: ['stage_name', 'name'] },
+    { key: 'sale_process', path: '/api/ebuilder/form/formdata/v2/getFormDataList/sale_process_sear_api', nameFields: ['process_name', 'name'] },
+    { key: 'clue_pool', path: '/api/ebuilder/form/formdata/v2/getFormDataList/ebcluepool_ai_search_api', nameFields: ['clue_pool_name', 'name'] },
+    { key: 'sale_lose_reason', path: '/api/ebuilder/form/formdata/v2/getFormDataList/sale_lose_reason', nameFields: ['reason_name', 'name'] },
+    { key: 'customer_industry', path: '/api/ebuilder/form/formdata/v2/getFormDataList/ebcustomer_industry_search_api', nameFields: ['industry_name', 'name'] },
+    { key: 'customer_type', path: '/api/ebuilder/form/formdata/v2/getFormDataList/ebcustomer_type_search_api', nameFields: ['type_name', 'name'] },
+    { key: 'customer_status', path: '/api/ebuilder/form/formdata/v2/getFormDataList/ebcustomer_status_search_api', nameFields: ['state_name', 'name'] },
+];
+// 行政区划预取城市（22 个）
+const REGION_CITIES = [
+    '北京市', '上海市', '天津市', '重庆市', '成都市', '广州市', '深圳市', '东莞市',
+    '杭州市', '南京市', '苏州市', '武汉市', '长沙市', '西安市', '郑州市', '济南市',
+    '青岛市', '厦门市', '福州市', '合肥市', '沈阳市', '大连市',
+];
+function pickKeys(obj, keys) {
+    const out = {};
+    for (const k of keys)
+        if (obj?.[k] !== undefined)
+            out[k] = obj[k];
+    return out;
+}
+const isInputOne = (f) => String(f?.isInput) === '1';
+function semverGte(a, b) {
+    const pa = String(a || '').split('.').map((x) => parseInt(x, 10) || 0);
+    const pb = b.split('.').map((x) => parseInt(x, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) !== (pb[i] || 0))
+            return (pa[i] || 0) > (pb[i] || 0);
+    }
+    return true;
+}
+function successCheck(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    if (value.resultCode !== undefined && value.resultCode !== null)
+        return Number(value.resultCode) === 200;
+    if (value.datajson && typeof value.datajson === 'object') {
+        const status = value.datajson.status;
+        if (status === 'true' || status === true)
+            return true;
+        if (status === 'false' || status === false)
+            return false;
+    }
+    const code = value.code ?? value.res_base?.ret;
+    if (code !== undefined && code !== null)
+        return Number(code) === 0 || Number(code) === 200;
+    return typeof value.success === 'boolean' ? value.success : false;
+}
+export class CacheInitOperation {
+    name = 'jiuchuanhui.cache.init';
+    async execute(input, { host }) {
+        const dryRun = input.dryRun === true;
+        const verbose = input.verbose === true;
+        const session = await host.getSession();
+        const tenantKey = session.tenantKey || '';
+        const userId = session.userId || '';
+        if (!tenantKey || !userId) {
+            throw jiuchuanhuiValidationError('session_context_missing', '无法获取缓存隔离上下文：session 缺少 tenantKey/userId，请确认 E10 登录态');
+        }
+        const baseDir = join(process.env.WEAVER_E10_JIUCHUANHUI_HOME || join(homedir(), '.weaver-e10-jiuchuanhui'), tenantKey, String(userId));
+        const mainFile = join(baseDir, 'weaver-e10-jiuchuanhui.json');
+        const cfgDir = join(baseDir, 'config');
+        // 保留旧 region / options / spVersion
+        let old = {};
+        if (existsSync(mainFile)) {
+            try {
+                old = JSON.parse(readFileSync(mainFile, 'utf-8'));
+            }
+            catch { /* ignore */ }
+        }
+        // ── 步骤 1：应用发现 + 13 objId + 版本校验 ──────────────────────────
+        const discovery = {};
+        const appResp = await host.request({
+            method: 'GET',
+            path: '/api/bs/ebuilder/app/tags/getAppIds',
+            query: { tag: APP_TAG },
+            operation: this.name,
+        });
+        if (!successCheck(appResp))
+            throw jiuchuanhuiValidationError('init_failed', 'app.discovery 未成功，无法初始化缓存');
+        const rawApp = appResp?.data ?? appResp?.datajson?.datas;
+        const appId = Array.isArray(rawApp) && rawApp[0] ? String(rawApp[0]) : null;
+        if (!appId)
+            throw jiuchuanhuiValidationError('init_failed', '步骤 1 未取得 appId，请检查 E10 登录态');
+        discovery[`appId:${APP_TAG}`] = appId;
+        for (const tag of MODULE_TAGS) {
+            const resp = await host.request({
+                method: 'GET',
+                path: '/api/ebuilder/form/obj/getObjsByTag',
+                query: { tag, appId },
+                operation: this.name,
+            });
+            const list = Array.isArray(resp?.data) ? resp.data : resp?.datajson?.datas ?? [];
+            const hit = list.find((o) => o?.formId && String(o.formId) !== '0') ?? list?.[0];
+            if (hit?.id)
+                discovery[`objId:${tag}`] = String(hit.id);
+        }
+        // spVersion：querySpAppVersionInfo 接口（源包约束 3）
+        try {
+            const spResp = await host.request({
+                method: 'GET',
+                path: '/api/installer/public/querySpAppVersionInfo',
+                query: { appId },
+                operation: this.name,
+            });
+            const sp = spResp?.data;
+            const commitVersion = typeof sp === 'object' && sp !== null ? String(sp.commitVersion ?? sp.version ?? '') : '';
+            if (commitVersion) {
+                discovery[`spVersion:${APP_TAG}`] = { commitVersion, passed: semverGte(commitVersion, MIN_VERSION) };
+            }
+        }
+        catch {
+            // 版本接口不可用时不阻塞（保留旧缓存 spVersion）
+        }
+        // ── 步骤 2：接口标识 → cfgId（12 个 pk）─────────────────────────────
+        const cfgMap = {};
+        for (const pk of ALL_PKS) {
+            const resp = await host.request({
+                path: '/api/esb/server/event/triggerActionFlow',
+                body: { customParams: { mainTable: { interface_pk: pk } }, uniqueIndent: '4F6E1A9702864666803CCA6B77B86227', employeeId: userId },
+                operation: this.name,
+            });
+            const cfgId = resp?.actionData?.responseData?.customData?.mainTable?.cfgId
+                ?? resp?.customData?.mainTable?.cfgId
+                ?? resp?.datajson?.mainTable?.cfgId
+                ?? resp?.data?.mainTable?.cfgId
+                ?? resp?.mainTable?.cfgId;
+            if (cfgId)
+                cfgMap[pk] = String(cfgId);
+        }
+        // ── 步骤 3：创建/更新接口配置 + 字段 data_key 映射 ───────────────────
+        const perPk = {};
+        for (const pk of Object.keys(cfgMap)) {
+            const cfgId = cfgMap[pk];
+            const resp = await host.request({
+                method: 'GET',
+                path: '/api/bs/ebuilder/form/formdata/getRestCfgById',
+                query: { apid: appId, id: cfgId },
+                operation: this.name,
+            });
+            const detail = resp?.data ?? {};
+            if (!detail?.id && !detail?.mainFields)
+                continue;
+            const allFields = [
+                ...(detail.mainFields || []),
+                ...(detail.detailFields || []).flatMap((df) => df.fields || []),
+            ];
+            const fieldIds = [...new Set(allFields.filter(isInputOne).map((f) => String(f.fieldid)).filter(Boolean))];
+            const infoMap = new Map();
+            if (fieldIds.length > 0) {
+                try {
+                    const infoResp = await host.request({
+                        path: '/api/esb/server/event/triggerActionFlow',
+                        body: { customParams: { mainTable: { fieldids: fieldIds.join(',') } }, uniqueIndent: '10351A4DC8D4454A9F1957FBE647CD9F', employeeId: userId },
+                        operation: this.name,
+                    });
+                    const list = infoResp?.actionData?.responseData?.customData?.mainTable?.fieldInfoList
+                        ?? infoResp?.customData?.mainTable?.fieldInfoList
+                        ?? infoResp?.datajson?.mainTable?.fieldInfoList
+                        ?? infoResp?.fieldInfoList ?? [];
+                    for (const it of list)
+                        infoMap.set(String(it.id), it);
+                }
+                catch {
+                    // data_key 缺失可接受（业务侧按缓存规范兜底）
+                }
+            }
+            const merge = (f) => {
+                const info = infoMap.get(String(f?.fieldid));
+                if (info) {
+                    f.data_key = info.data_key ?? f.data_key;
+                    f.title = info.title ?? f.title;
+                    f.component_type = info.component_type ?? f.component_type;
+                }
+            };
+            detail.mainFields = (detail.mainFields || []).filter(isInputOne);
+            detail.detailFields = (detail.detailFields || [])
+                .map((df) => ({ ...df, fields: (df.fields || []).filter(isInputOne) }))
+                .filter((df) => Array.isArray(df.fields) && df.fields.length > 0);
+            for (const f of detail.mainFields)
+                merge(f);
+            for (const df of detail.detailFields)
+                for (const f of df.fields)
+                    merge(f);
+            const kept = pickKeys(detail, DETAIL_KEEP_KEYS);
+            if (Array.isArray(kept.mainFields))
+                kept.mainFields = kept.mainFields.map((f) => pickKeys(f, FIELD_KEEP_KEYS));
+            if (Array.isArray(kept.detailFields)) {
+                kept.detailFields = kept.detailFields.map((df) => ({
+                    ...pickKeys(df, ['id', 'fieldName', 'title', 'fields']),
+                    fields: Array.isArray(df.fields) ? df.fields.map((f) => pickKeys(f, FIELD_KEEP_KEYS)) : [],
+                }));
+            }
+            perPk[pk] = { cfgId, detail: kept };
+        }
+        // ── 步骤 4：Ebuilder 关联数据（8 类）───────────────────────────────
+        const ebuilder = {};
+        for (const { key, path, nameFields } of EBUILDER_QUERIES) {
+            const list = [];
+            let pageNo = 1;
+            for (;;) {
+                const resp = await host.request({
+                    path,
+                    body: { datajson: { mainTable: {}, pageInfo: { pageNo, pageSize: 100 }, header: { operator: userId } } },
+                    operation: this.name,
+                });
+                const items = resp?.datajson?.datas ?? resp?.data ?? [];
+                list.push(...(Array.isArray(items) ? items : []));
+                const hasMore = resp?.hasMore ?? (Array.isArray(items) && items.length === 100);
+                if (!hasMore || list.length >= 500 || pageNo >= 5)
+                    break;
+                pageNo += 1;
+            }
+            ebuilder[key] = list.map((it) => {
+                const mt = it?.mainTable ?? it ?? {};
+                let name = '';
+                for (const nf of nameFields) {
+                    if (mt[nf] !== undefined && mt[nf] !== null && String(mt[nf]) !== '') {
+                        name = String(mt[nf]);
+                        break;
+                    }
+                }
+                const item = { id: String(mt.id ?? ''), name };
+                if (key === 'sale_stage' && mt.sale_process !== undefined) {
+                    const sp = Array.isArray(mt.sale_process) ? mt.sale_process[0] : mt.sale_process;
+                    if (sp && typeof sp === 'object')
+                        item.sale_process = { id: String(sp.id ?? ''), name: String(sp.name ?? '') };
+                }
+                return item;
+            }).filter((x) => x.id);
+        }
+        // ── 步骤 5：字段选项（Select/RadioBox/CheckBox）────────────────────────
+        const options = {};
+        for (const pk of Object.keys(perPk)) {
+            const tag = PK_TO_TAG[pk];
+            const objId = discovery[`objId:${tag}`];
+            if (!objId)
+                continue;
+            const detail = perPk[pk].detail ?? {};
+            const fields = [
+                ...(detail.mainFields || []),
+                ...(detail.detailFields || []).flatMap((d) => d.fields || []),
+            ];
+            for (const f of fields) {
+                if (!f?.fieldid)
+                    continue;
+                if (!OPT_COMP.includes(f.component_type))
+                    continue;
+                const key = `options:${f.fieldid}:*:1`;
+                if (options[key])
+                    continue;
+                try {
+                    const resp = await host.request({
+                        method: 'GET',
+                        path: '/api/ebuilder/common/ds/options',
+                        query: { fieldName: String(f.fieldid), objId, groupId: appId, optionLevel: 1 },
+                        operation: this.name,
+                    });
+                    const values = resp?.data ?? resp?.datajson?.datas ?? [];
+                    options[key] = {
+                        lable: `${pk}.${f.data_key ?? f.fieldid}`,
+                        lableTitle: `${pk}.${f.title ?? f.data_key ?? f.fieldid}`,
+                        value: (Array.isArray(values) ? values : []).map((v) => ({
+                            label: String(v?.lable ?? v?.label ?? v?.text ?? v?.name ?? ''),
+                            value: String(v?.value ?? v?.val ?? v?.id ?? ''),
+                        })),
+                    };
+                }
+                catch {
+                    // 失败不阻塞：保留旧缓存 options，业务侧读字段 optionList / 主缓存 options 兜底
+                }
+            }
+        }
+        // ── 步骤 6：搜索接口 URL 可传参数（searchParams）──────────────────────
+        const searchPerPk = {};
+        for (const pk of SEARCH_PKS) {
+            const cfgId = cfgMap[pk];
+            if (!cfgId)
+                continue;
+            try {
+                const resp = await host.request({
+                    method: 'GET',
+                    path: '/api/bs/ebuilder/form/formdata/getRestCfgById',
+                    query: { apid: appId, id: cfgId },
+                    operation: this.name,
+                });
+                const cfgObj = resp?.data ?? {};
+                let conditions = cfgObj.conditions;
+                if (typeof conditions === 'string') {
+                    try {
+                        conditions = JSON.parse(conditions);
+                    }
+                    catch {
+                        conditions = null;
+                    }
+                }
+                const params = [];
+                for (const d of conditions?.datas ?? []) {
+                    const value = d?.conditions?.value;
+                    if (typeof value === 'string') {
+                        const m = value.match(/\{([^}]+)\}/);
+                        if (m) {
+                            params.push({
+                                key: m[1],
+                                text: d?.text ?? '',
+                                fieldType: d?.fieldType ?? '',
+                                compType: d?.compType ?? '',
+                                func: d?.conditions?.func ?? '',
+                                fieldid: d?.fieldName ?? '',
+                            });
+                        }
+                    }
+                }
+                searchPerPk[pk] = { cfgId, searchParams: params };
+            }
+            catch {
+                // 搜索参数解析失败不阻塞
+            }
+        }
+        for (const [pk, entry] of Object.entries(searchPerPk)) {
+            if (perPk[pk])
+                perPk[pk] = { ...perPk[pk], ...entry };
+            else
+                perPk[pk] = entry;
+        }
+        // ── 步骤 7：行政区划（按需预取 22 城；失败跳过，保留旧缓存 region）───
+        const region = {};
+        for (const city of REGION_CITIES) {
+            try {
+                const resp = await host.request({
+                    path: '/api/esb/server/event/triggerActionFlow',
+                    body: {
+                        customParams: { mainTable: { moduleType: 'administrativeDivision', name: city, fromType: 'agentSkill' } },
+                        uniqueIndent: '7EC1639D5AC24B4DBCEE8D2CB85D4025',
+                        employeeId: userId,
+                    },
+                    operation: this.name,
+                });
+                if (Number(resp?.resultCode ?? 0) === 200) {
+                    region[`administrativeDivision:${city}`] = resp;
+                }
+            }
+            catch {
+                // 单城市失败跳过
+            }
+        }
+        // ── 落盘 ───────────────────────────────────────────────────────────
+        const cache = { discovery, ebuilder, options, region };
+        cache.region = { ...(old.region || {}), ...(cache.region || {}) };
+        cache.options = { ...(old.options || {}), ...(cache.options || {}) };
+        if (!cache.discovery[`spVersion:${APP_TAG}`] && old.discovery?.[`spVersion:${APP_TAG}`]) {
+            cache.discovery[`spVersion:${APP_TAG}`] = old.discovery[`spVersion:${APP_TAG}`];
+        }
+        const summary = {
+            dryRun,
+            cacheDir: baseDir,
+            mainFile,
+            namespaces: {
+                discovery: Object.keys(cache.discovery).length,
+                ebuilder: Object.keys(cache.ebuilder).length,
+                options: Object.keys(cache.options).length,
+                region: Object.keys(cache.region).length,
+            },
+            configFiles: Object.keys(perPk).length,
+            objIdCount: Object.keys(discovery).filter((k) => k.startsWith('objId:')).length,
+            cfgIdCount: Object.keys(cfgMap).length,
+            version: cache.discovery[`spVersion:${APP_TAG}`] ?? null,
+            warnings: [],
+        };
+        // 版本基线检查：不达标时仍写入缓存，但提示业务侧应停止调用
+        if (cache.discovery[`spVersion:${APP_TAG}`] && cache.discovery[`spVersion:${APP_TAG}`].passed === false) {
+            summary.warnings.push(`九氚汇营销管理包版本（${cache.discovery[`spVersion:${APP_TAG}`].commitVersion}）低于 ${MIN_VERSION}，业务调用应停止`);
+        }
+        if (dryRun)
+            return { status: 'COMPLETE', data: { ...summary, written: false, note: 'dry-run：只拉取未写入' } };
+        mkdirSync(cfgDir, { recursive: true });
+        writeFileSync(mainFile, JSON.stringify(cache, null, 2), 'utf-8');
+        for (const [pk, entry] of Object.entries(perPk)) {
+            const tag = PK_TO_TAG[pk];
+            const objId = cache.discovery[`objId:${tag}`];
+            writeFileSync(join(cfgDir, `${pk}.json`), JSON.stringify({ ...entry, objId: objId ?? '' }, null, 2), 'utf-8');
+        }
+        if (verbose) {
+            summary.warnings.push(`${JSON.stringify({ step1: 'discovery', step2: 'cfgId', step3: 'cfg.detail', step4: 'ebuilder', step5: 'options', step6: 'searchParams', step7: 'region' })}`);
+        }
+        return {
+            status: 'COMPLETE',
+            data: { ...summary, written: true },
+        };
+    }
+}

package/dist/shortcuts/jiuchuanhui/continuation.js

@@ -0,0 +1,70 @@
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { jiuchuanhuiValidationError } from './errors.js';
+function stateRoot(ctx) {
+    const configured = ctx?.config?.path();
+    if (configured)
+        return resolve(configured, '..');
+    return process.env.WEAVER_WORK_CLI_HOME || process.env.WORK_CLI_HOME || resolve(homedir(), '.weaver-work-cli');
+}
+async function loadKey(ctx) {
+    const keysDir = resolve(stateRoot(ctx), 'keys');
+    const filename = resolve(keysDir, 'jiuchuanhui-continuation.key');
+    await mkdir(keysDir, { recursive: true, mode: 0o700 });
+    if (existsSync(filename))
+        return readFile(filename);
+    const key = randomBytes(32);
+    try {
+        await writeFile(filename, key, { flag: 'wx', mode: 0o600 });
+        if (process.platform !== 'win32')
+            await chmod(filename, 0o600).catch(() => undefined);
+        return key;
+    }
+    catch {
+        return readFile(filename);
+    }
+}
+function encode(value) {
+    return Buffer.from(JSON.stringify(value)).toString('base64url');
+}
+function signature(payload, key) {
+    return createHmac('sha256', key).update(payload).digest('base64url');
+}
+export function createJiuchuanhuiContinuationSigner(ctx) {
+    return {
+        async issue(payload, ttlMs = 10 * 60_000) {
+            const issuedAt = Date.now();
+            const body = encode({ ...payload, issuedAt, expiresAt: issuedAt + ttlMs });
+            const sig = signature(body, await loadKey(ctx));
+            return `${body}.${sig}`;
+        },
+        async verify(token, expectedOperation) {
+            if (typeof token !== 'string' || !token.includes('.')) {
+                throw jiuchuanhuiValidationError('continuation_invalid', 'continuation 无效');
+            }
+            const [body, provided] = token.split('.');
+            const expected = signature(body, await loadKey(ctx));
+            const valid = provided.length === expected.length
+                && timingSafeEqual(Buffer.from(provided), Buffer.from(expected));
+            if (!valid)
+                throw jiuchuanhuiValidationError('continuation_invalid', 'continuation 签名校验失败');
+            let value;
+            try {
+                value = JSON.parse(Buffer.from(body, 'base64url').toString('utf8'));
+            }
+            catch {
+                throw jiuchuanhuiValidationError('continuation_invalid', 'continuation 内容无法解析');
+            }
+            if (value.operation !== expectedOperation) {
+                throw jiuchuanhuiValidationError('continuation_mismatch', 'continuation 不属于当前操作');
+            }
+            if (!Number.isSafeInteger(value.expiresAt) || value.expiresAt < Date.now()) {
+                throw jiuchuanhuiValidationError('continuation_expired', 'continuation 已过期');
+            }
+            return value;
+        },
+    };
+}

package/dist/shortcuts/jiuchuanhui/errors.js

@@ -0,0 +1,59 @@
+import { CliError, ExitCode } from '../../core/errors.js';
+export class JiuchuanhuiCliError extends CliError {
+    type;
+    subtype;
+    code;
+    retryable;
+    stage;
+    details;
+    partialData;
+    constructor(type, subtype, message, options = {}) {
+        super(message, options.exitCode ?? ExitCode.InternalError);
+        this.name = 'JiuchuanhuiCliError';
+        this.type = type;
+        this.subtype = subtype;
+        this.code = options.code;
+        this.retryable = options.retryable ?? false;
+        this.stage = options.stage;
+        this.details = options.details;
+        this.partialData = options.partialData;
+    }
+}
+export function jiuchuanhuiValidationError(subtype, message, details) {
+    return new JiuchuanhuiCliError('validation', subtype, message, {
+        details,
+        exitCode: ExitCode.UsageError,
+    });
+}
+export function jiuchuanhuiAuthError(subtype, message, details) {
+    return new JiuchuanhuiCliError('authentication', subtype, message, {
+        details,
+        exitCode: ExitCode.AuthError,
+    });
+}
+export function jiuchuanhuiNetworkError(subtype, message, options = {}) {
+    return new JiuchuanhuiCliError('network', subtype, message, {
+        ...options,
+        retryable: options.retryable ?? true,
+        exitCode: ExitCode.NetworkError,
+    });
+}
+export function jiuchuanhuiConfirmationError(action, details) {
+    return new JiuchuanhuiCliError('confirmation', 'required', '该操作需要明确确认', {
+        details: { action, ...details },
+        exitCode: ExitCode.ConfirmationRequired,
+    });
+}
+export function jiuchuanhuiPartialError(message, partialData, details) {
+    return new JiuchuanhuiCliError('partial', 'write_uncertain', message, {
+        details,
+        partialData,
+        exitCode: ExitCode.Partial,
+    });
+}
+export function isJiuchuanhuiNetworkError(error) {
+    return Boolean(error
+        && typeof error === 'object'
+        && 'type' in error
+        && error.type === 'network');
+}