vps-work 2.5.0 → 2.5.1

package/dist/packages/vps-work/src/commands/drive/index.js

@@ -0,0 +1,435 @@
+import { createReadStream, createWriteStream, existsSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { basename, dirname, extname, join, resolve } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { Command } from 'commander';
+import { request } from 'undici';
+import { VertuError } from '../../core/errors.js';
+import { imRequest } from '../../core/im-client.js';
+import { VDriveStore } from '../../core/v-drive-store.js';
+import { readStdinText, readUtf8File } from '../../utils/read-text.js';
+function required(value, flag) {
+    const normalized = value?.trim();
+    if (!normalized)
+        throw new VertuError(`${flag} 为必填。`);
+    return normalized;
+}
+function parentId(value) {
+    const normalized = value?.trim();
+    return !normalized || normalized === 'root' ? null : normalized;
+}
+function record(value, message = 'V盘服务返回格式无效。') {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new VertuError(message);
+    return value;
+}
+function records(value) {
+    return Array.isArray(value) ? value.filter((item) => Boolean(item) && typeof item === 'object' && !Array.isArray(item)) : [];
+}
+function itemFrom(value) {
+    return record(record(value).item, 'V盘服务未返回项目。');
+}
+function print(payload) {
+    console.log(JSON.stringify(payload, null, 2));
+}
+function attachBaseOption(command) {
+    return command.option('--base-url <url>', 'Override Vertu service URL');
+}
+function collect(value, previous) {
+    return [...previous, value];
+}
+function positiveInteger(value, flag) {
+    const normalized = value?.trim();
+    if (!normalized || !/^\d+$/.test(normalized))
+        throw new VertuError(`${flag} 需为正整数。`);
+    const parsed = Number(normalized);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0)
+        throw new VertuError(`${flag} 需为正整数。`);
+    return parsed;
+}
+async function resolveContent(opts, requiredInput = false) {
+    if (opts.content !== undefined && opts.contentFile !== undefined) {
+        throw new VertuError('--content 和 --content-file 不能同时使用。');
+    }
+    if (requiredInput && opts.content === undefined && opts.contentFile === undefined) {
+        throw new VertuError('--content 或 --content-file 至少传一个。');
+    }
+    if (opts.contentFile === '-')
+        return readStdinText();
+    if (opts.contentFile !== undefined)
+        return readUtf8File(opts.contentFile);
+    return opts.content ?? '';
+}
+function mimeType(name) {
+    const types = {
+        '.csv': 'text/csv', '.doc': 'application/msword',
+        '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        '.gif': 'image/gif', '.jpeg': 'image/jpeg', '.jpg': 'image/jpeg', '.md': 'text/markdown',
+        '.mp3': 'audio/mpeg', '.mp4': 'video/mp4', '.pdf': 'application/pdf', '.png': 'image/png',
+        '.ppt': 'application/vnd.ms-powerpoint',
+        '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+        '.txt': 'text/plain', '.webp': 'image/webp', '.xls': 'application/vnd.ms-excel',
+        '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', '.zip': 'application/zip',
+    };
+    return types[extname(name).toLowerCase()] ?? 'application/octet-stream';
+}
+async function driveGet(opts, view) {
+    return record(await imRequest('GET', '/v1/v-drive', {
+        baseUrl: opts.baseUrl,
+        query: view ? { view } : undefined,
+    }));
+}
+async function driveAction(opts, action, body = {}) {
+    return record(await imRequest('POST', '/v1/v-drive', {
+        baseUrl: opts.baseUrl,
+        body: { action, ...body },
+    }));
+}
+async function putOss(uploadUrl, body, size, type, signedHeaders = {}) {
+    const response = await request(uploadUrl, {
+        method: 'PUT',
+        headers: { 'content-type': type, 'content-length': String(size), ...Object.fromEntries(Object.entries(signedHeaders).map(([key, value]) => [key, String(value)])) },
+        body,
+    });
+    if (response.statusCode < 200 || response.statusCode >= 300) {
+        const message = await response.body.text();
+        throw new VertuError(`OSS 上传失败：HTTP ${response.statusCode}${message ? ` ${message.slice(0, 200)}` : ''}`);
+    }
+    await response.body.dump();
+}
+async function uploadContent(opts, input) {
+    const initialized = await driveAction(opts, 'upload-init', {
+        name: input.name,
+        parent_id: input.parentId ?? null,
+        mime_type: input.type,
+        size_bytes: input.size,
+    });
+    const uploadUrl = String(initialized.upload_url ?? '');
+    const storageKey = String(initialized.storage_key ?? '');
+    if (!storageKey)
+        throw new VertuError('V盘服务未返回 OSS 存储路径。');
+    try {
+        if (initialized.upload_type === 'multipart') {
+            const partSize = Number(initialized.part_size);
+            const urls = initialized.part_urls;
+            if (!Number.isSafeInteger(partSize) || partSize <= 0 || !Array.isArray(urls)
+                || urls.length !== Math.ceil(input.size / partSize)
+                || urls.some((url) => typeof url !== 'string' || !url)) {
+                throw new VertuError('V盘服务返回的 OSS 分片上传参数无效。');
+            }
+            for (let index = 0; index < urls.length; index += 1) {
+                const start = index * partSize;
+                const size = Math.min(partSize, input.size - start);
+                const body = Buffer.isBuffer(input.body)
+                    ? input.body.subarray(start, start + size)
+                    : createReadStream(input.body, { start, end: start + size - 1 });
+                await putOss(String(urls[index]), body, size, 'application/octet-stream', initialized.part_headers ? record(initialized.part_headers) : {});
+            }
+        }
+        else {
+            if (!uploadUrl)
+                throw new VertuError('V盘服务未返回 OSS 上传地址。');
+            await putOss(uploadUrl, Buffer.isBuffer(input.body) ? input.body : createReadStream(input.body), input.size, input.type, initialized.headers ? record(initialized.headers) : {});
+        }
+    }
+    catch (error) {
+        // Release the reservation and any uploaded parts without masking the original error.
+        await driveAction(opts, 'upload-abort', { storage_key: storageKey }).catch(() => undefined);
+        throw error;
+    }
+    return driveAction(opts, input.itemId ? 'replace-complete' : 'upload-complete', {
+        ...(input.itemId ? { item_id: input.itemId } : { name: input.name, parent_id: input.parentId ?? null }),
+        mime_type: input.type,
+        size_bytes: input.size,
+        storage_key: storageKey,
+    });
+}
+async function uploadFile(opts, path, targetParentId) {
+    const source = resolve(path);
+    if (!existsSync(source) || !statSync(source).isFile())
+        throw new VertuError(`源文件不存在：${path}`);
+    const size = statSync(source).size;
+    const name = basename(source);
+    if (size === 0) {
+        return driveAction(opts, 'create-file', { name, parent_id: targetParentId });
+    }
+    return uploadContent(opts, {
+        name,
+        parentId: targetParentId,
+        type: mimeType(name),
+        size,
+        body: source,
+    });
+}
+async function downloadResponse(opts, id) {
+    const result = await driveAction(opts, 'download', { item_id: id });
+    const item = itemFrom(result);
+    if (result.empty_text_file === true)
+        return { item, response: null };
+    const url = String(result.download_url ?? '');
+    if (!url)
+        throw new VertuError('V盘服务未返回 OSS 下载地址。');
+    const response = await request(url);
+    if (response.statusCode >= 400) {
+        await response.body.dump();
+        throw new VertuError(`OSS 下载失败：HTTP ${response.statusCode}`);
+    }
+    return { item, response };
+}
+function scopedItems(items, parent, recursive, query) {
+    const descendants = new Set();
+    if (recursive) {
+        let changed = true;
+        while (changed) {
+            changed = false;
+            for (const item of items) {
+                const id = String(item.id ?? '');
+                const itemParent = item.parentId == null ? null : String(item.parentId);
+                if (id && (parent === null || itemParent === parent || (itemParent && descendants.has(itemParent))) && !descendants.has(id)) {
+                    descendants.add(id);
+                    changed = true;
+                }
+            }
+        }
+    }
+    const normalizedQuery = query?.trim().toLocaleLowerCase();
+    return items.filter((item) => {
+        const inScope = recursive
+            ? descendants.has(String(item.id ?? ''))
+            : (item.parentId == null ? null : String(item.parentId)) === parent;
+        return inScope && (!normalizedQuery || String(item.name ?? '').toLocaleLowerCase().includes(normalizedQuery));
+    });
+}
+function migrationState(path) {
+    if (!existsSync(path))
+        return { items: {}, spaces: {} };
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        return { items: parsed.items ?? {}, spaces: parsed.spaces ?? {} };
+    }
+    catch {
+        throw new VertuError(`迁移状态文件无法解析：${path}`);
+    }
+}
+async function migrateLocalVDrive(opts) {
+    const local = new VDriveStore(opts.root?.trim() || undefined);
+    const items = local.list(null, true);
+    let spaces = [];
+    const legacyIndexPath = join(local.root, 'index.json');
+    if (existsSync(legacyIndexPath)) {
+        const parsed = record(JSON.parse(readFileSync(legacyIndexPath, 'utf8')), '旧 V盘索引无法解析。');
+        spaces = records(parsed.spaces).map((space) => ({
+            id: String(space.id ?? ''),
+            name: String(space.name ?? '团队共享空间'),
+            members: Array.isArray(space.members) ? space.members : [],
+            security: space.security && typeof space.security === 'object' && !Array.isArray(space.security)
+                ? space.security
+                : {},
+            deletedAt: typeof space.deletedAt === 'string' ? space.deletedAt : null,
+        })).filter((space) => space.id && !space.deletedAt);
+    }
+    const statePath = join(local.root, 'oss-migration-v1.json');
+    const state = migrationState(statePath);
+    const save = () => writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf8');
+    let migratedItems = 0;
+    let migratedSpaces = 0;
+    const pendingFolders = items.filter((item) => item.kind === 'folder' && !state.items[item.id]);
+    while (pendingFolders.length) {
+        const index = pendingFolders.findIndex((item) => !item.parentId || state.items[item.parentId]);
+        if (index < 0)
+            throw new VertuError('旧 V盘文件夹层级无法迁移。');
+        const item = pendingFolders.splice(index, 1)[0];
+        const result = await driveAction(opts, 'create-folder', {
+            name: item.name,
+            parent_id: item.parentId ? state.items[item.parentId] : null,
+        });
+        state.items[item.id] = String(itemFrom(result).id);
+        migratedItems += 1;
+        save();
+    }
+    for (const item of items.filter((candidate) => candidate.kind === 'file')) {
+        if (state.items[item.id])
+            continue;
+        const bytes = local.readFile(item.id).bytes;
+        const result = bytes.length === 0
+            ? await driveAction(opts, 'create-file', { name: item.name, parent_id: item.parentId ? state.items[item.parentId] : null })
+            : await uploadContent(opts, {
+                name: item.name,
+                parentId: item.parentId ? state.items[item.parentId] : null,
+                type: item.mimeType || mimeType(item.name),
+                size: bytes.length,
+                body: bytes,
+            });
+        state.items[item.id] = String(itemFrom(result).id);
+        migratedItems += 1;
+        save();
+    }
+    for (const space of spaces) {
+        if (state.spaces[space.id])
+            continue;
+        const result = await driveAction(opts, 'create-space', {
+            name: space.name,
+            members: space.members.filter((member) => Boolean(member)
+                && typeof member === 'object'
+                && !Array.isArray(member)
+                && member.role !== 'owner'),
+            security: space.security,
+        });
+        const createdSpace = result.space && typeof result.space === 'object'
+            ? record(result.space)
+            : records(result.spaces).find((candidate) => candidate.name === space.name
+                && !Object.values(state.spaces).includes(String(candidate.id ?? '')));
+        if (!createdSpace)
+            throw new VertuError('V盘服务未返回新建共享空间。');
+        state.spaces[space.id] = String(createdSpace.id);
+        migratedSpaces += 1;
+        save();
+    }
+    for (const item of items) {
+        for (const oldSpaceId of item.sharedSpaceIds) {
+            const newItemId = state.items[item.id];
+            const newSpaceId = state.spaces[oldSpaceId];
+            if (newItemId && newSpaceId) {
+                await driveAction(opts, 'share', { item_id: newItemId, space_id: newSpaceId, enabled: true });
+            }
+        }
+    }
+    return {
+        storage_provider: 'aliyun-oss',
+        source_root: local.root,
+        state_file: statePath,
+        migrated_items: migratedItems,
+        migrated_spaces: migratedSpaces,
+        total_items: items.length,
+        local_source_preserved: true,
+    };
+}
+export function buildDriveCommand() {
+    const drive = new Command('drive')
+        .aliases(['vdrive', 'v-drive'])
+        .description('账号级云端 V盘：文件内容存储于 OSS。');
+    attachBaseOption(drive.command('+list').description('列出 V盘文件和文件夹')
+        .option('--parent-id <id>', '父文件夹 ID；省略或 root 表示根目录')
+        .option('--recursive', '递归列出全部后代').option('--query <text>', '按名称过滤')).action(async (opts) => {
+        const snapshot = await driveGet(opts);
+        const parent = parentId(opts.parentId);
+        print({ storage_provider: 'aliyun-oss', parent_id: parent, recursive: opts.recursive === true,
+            items: scopedItems(records(snapshot.items), parent, opts.recursive === true, opts.query), used_bytes: snapshot.usedBytes ?? 0 });
+    });
+    attachBaseOption(drive.command('+info').description('读取单个项目元数据').requiredOption('--item-id <id>')).action(async (opts) => {
+        print(await driveAction(opts, 'info', { item_id: required(opts.itemId, '--item-id') }));
+    });
+    attachBaseOption(drive.command('+mkdir').description('新建文件夹').requiredOption('--name <name>')
+        .option('--parent-id <id>')).action(async (opts) => {
+        print(await driveAction(opts, 'create-folder', { name: required(opts.name, '--name'), parent_id: parentId(opts.parentId) }));
+    });
+    attachBaseOption(drive.command('+create-file').description('新建 UTF-8 文本文件').requiredOption('--name <name>')
+        .option('--parent-id <id>').option('--content <text>').option('--content-file <path>')).action(async (opts) => {
+        const name = required(opts.name, '--name');
+        const content = Buffer.from(await resolveContent(opts));
+        const result = content.length === 0
+            ? await driveAction(opts, 'create-file', { name, parent_id: parentId(opts.parentId) })
+            : await uploadContent(opts, { name, parentId: parentId(opts.parentId), type: mimeType(name), size: content.length, body: content });
+        print(result);
+    });
+    attachBaseOption(drive.command('+upload').description('把本地文件上传到 OSS V盘')
+        .requiredOption('--source <path>', '源文件路径；可重复传入', collect, []).option('--parent-id <id>')).action(async (opts) => {
+        const sources = opts.source ?? [];
+        if (!sources.length)
+            throw new VertuError('--source 至少传一次。');
+        const items = [];
+        for (const source of sources)
+            items.push(itemFrom(await uploadFile(opts, source, parentId(opts.parentId))));
+        print({ storage_provider: 'aliyun-oss', items });
+    });
+    attachBaseOption(drive.command('+read').description('读取 OSS V盘文件内容').requiredOption('--item-id <id>')
+        .option('--encoding <encoding>', 'utf8 或 base64', 'utf8').option('--max-bytes <number>', '', '1048576')).action(async (opts) => {
+        const encoding = opts.encoding?.trim().toLowerCase();
+        if (encoding !== 'utf8' && encoding !== 'base64')
+            throw new VertuError('--encoding 需为 utf8 或 base64。');
+        const maxBytes = positiveInteger(opts.maxBytes, '--max-bytes');
+        const { item, response } = await downloadResponse(opts, required(opts.itemId, '--item-id'));
+        if (Number(item.sizeBytes ?? 0) > maxBytes) {
+            if (response)
+                await response.body.dump();
+            throw new VertuError(`文件超过 --max-bytes=${maxBytes}；请用 +download。`);
+        }
+        const bytes = response ? Buffer.from(await response.body.arrayBuffer()) : Buffer.alloc(0);
+        if (bytes.length > maxBytes)
+            throw new VertuError(`文件超过 --max-bytes=${maxBytes}；请用 +download。`);
+        print({ item, encoding, content: bytes.toString(encoding) });
+    });
+    attachBaseOption(drive.command('+write').description('覆盖 OSS V盘文件内容').requiredOption('--item-id <id>')
+        .option('--content <text>').option('--content-file <path>').option('--source <path>', '以二进制文件替换原项目，保留项目 ID')).action(async (opts) => {
+        if ([opts.content, opts.contentFile, opts.source].filter(value => value !== undefined).length !== 1) {
+            throw new VertuError('--content / --content-file / --source 必须且只能指定一个。');
+        }
+        const id = required(opts.itemId, '--item-id');
+        const current = itemFrom(await driveAction(opts, 'info', { item_id: id }));
+        if (opts.source) {
+            const source = resolve(opts.source);
+            const info = statSync(source);
+            if (!info.isFile())
+                throw new VertuError('--source 必须是文件。');
+            const result = info.size === 0
+                ? await driveAction(opts, 'replace-empty', { item_id: id, mime_type: current.mimeType ?? mimeType(source) })
+                : await uploadContent(opts, { name: String(current.name ?? basename(source)), itemId: id,
+                    type: String(current.mimeType ?? mimeType(source)), size: info.size, body: source });
+            print(result);
+            return;
+        }
+        const content = Buffer.from(await resolveContent(opts, true));
+        const result = content.length === 0
+            ? await driveAction(opts, 'replace-empty', { item_id: id, mime_type: current.mimeType ?? 'text/plain' })
+            : await uploadContent(opts, { name: String(current.name ?? 'file'), itemId: id,
+                type: String(current.mimeType ?? mimeType(String(current.name ?? 'file'))), size: content.length, body: content });
+        print(result);
+    });
+    attachBaseOption(drive.command('+download').description('下载 OSS V盘文件').requiredOption('--item-id <id>')
+        .requiredOption('--output <path>').option('--overwrite')).action(async (opts) => {
+        const { item, response } = await downloadResponse(opts, required(opts.itemId, '--item-id'));
+        const requested = resolve(required(opts.output, '--output'));
+        const target = existsSync(requested) && statSync(requested).isDirectory() ? join(requested, basename(String(item.name ?? 'file'))) : requested;
+        if (existsSync(target) && !opts.overwrite) {
+            if (response)
+                await response.body.dump();
+            throw new VertuError('目标文件已存在；如需覆盖请显式传 --overwrite。');
+        }
+        await mkdir(dirname(target), { recursive: true });
+        if (response)
+            await pipeline(response.body, createWriteStream(target));
+        else
+            writeFileSync(target, Buffer.alloc(0));
+        print({ item, file_path: target });
+    });
+    attachBaseOption(drive.command('+rename').description('重命名项目').requiredOption('--item-id <id>').requiredOption('--name <name>')).action(async (opts) => {
+        const id = required(opts.itemId, '--item-id');
+        await driveAction(opts, 'rename', { item_id: id, name: required(opts.name, '--name') });
+        print(await driveAction(opts, 'info', { item_id: id }));
+    });
+    attachBaseOption(drive.command('+move').description('移动项目').requiredOption('--item-id <id>').requiredOption('--parent-id <id>')).action(async (opts) => {
+        const id = required(opts.itemId, '--item-id');
+        await driveAction(opts, 'move', { item_id: id, parent_id: parentId(required(opts.parentId, '--parent-id')) });
+        print(await driveAction(opts, 'info', { item_id: id }));
+    });
+    attachBaseOption(drive.command('+remove').description('移入回收站').requiredOption('--item-id <id>')).action(async (opts) => {
+        const id = required(opts.itemId, '--item-id');
+        const item = itemFrom(await driveAction(opts, 'info', { item_id: id }));
+        await driveAction(opts, 'remove', { item_id: id });
+        print({ trashed_item: item });
+    });
+    attachBaseOption(drive.command('+trash').description('列出回收站')).action(async (opts) => print(await driveGet(opts, 'trash')));
+    attachBaseOption(drive.command('+restore').description('恢复回收站项目').requiredOption('--item-id <id>')).action(async (opts) => {
+        const id = required(opts.itemId, '--item-id');
+        await driveAction(opts, 'restore', { item_id: id });
+        print(await driveAction(opts, 'info', { item_id: id }));
+    });
+    attachBaseOption(drive.command('+purge').description('永久删除回收站项目').requiredOption('--item-id <id>')).action(async (opts) => {
+        print(await driveAction(opts, 'purge', { item_id: required(opts.itemId, '--item-id') }));
+    });
+    attachBaseOption(drive.command('+empty-trash').description('永久清空回收站')).action(async (opts) => print(await driveAction(opts, 'empty-trash')));
+    attachBaseOption(drive.command('+transfers').description('列出传输记录')).action(async (opts) => print(await driveGet(opts, 'transfers')));
+    attachBaseOption(drive.command('+migrate-local').description('把旧版本地 V盘迁移到 OSS，保留本地源文件')
+        .option('--root <path>', '旧版 v-drive 目录；默认自动定位')).action(async (opts) => print(await migrateLocalVDrive(opts)));
+    return drive;
+}

package/dist/packages/vps-work/src/commands/exec.js

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+import { executeVpsServiceScript, resolveVpsServiceUrl } from '../core/sales-query-client.js';
+import { VertuError } from '../core/errors.js';
+import { resolveParamsArg } from './shortcut-params.js';
+import { attachSharedShortcutOptions } from './shortcut-common.js';
+function parseParamAssignments(raw) {
+    const out = {};
+    for (const item of raw ?? []) {
+        const eq = item.indexOf('=');
+        if (eq <= 0) {
+            throw new VertuError(`无效 --param "${item}"，需要 key=value`);
+        }
+        out[item.slice(0, eq).trim()] = item.slice(eq + 1);
+    }
+    return out;
+}
+/** 通用执行入口：新快捷命令只需服务端登记 script，不必再发 npm。 */
+export function buildExecCommand() {
+    const exec = new Command('exec')
+        .description('按 catalog 中的 skill_key / script_key 执行查询')
+        .requiredOption('--skill <key>', 'catalog.skill_key，如 vps-daily-sales-report / vps-dealer-ops')
+        .requiredOption('--script <key>', 'catalog.script_key')
+        .option('--param <assignment>', '追加单个参数，格式 key=value，可重复', (value, previous) => {
+        previous.push(value);
+        return previous;
+    }, []);
+    attachSharedShortcutOptions(exec);
+    return exec.action(async (opts, cmd) => {
+        const merged = cmd.optsWithGlobals();
+        const extra = await resolveParamsArg(opts);
+        const params = { ...parseParamAssignments(opts.param), ...extra };
+        if (opts.validateOnly === true || opts.dryRun === true) {
+            const payload = {
+                validateOnly: true,
+                source: 'vps-service-execute',
+                skill_key: opts.skill,
+                script_key: opts.script,
+                params,
+            };
+            console.log(JSON.stringify(payload, null, 2));
+            return;
+        }
+        const result = await executeVpsServiceScript(opts.skill, opts.script, params, opts.baseUrl ?? merged.baseUrl ?? resolveVpsServiceUrl());
+        console.log(typeof result === 'string' && opts.json === false ? result : JSON.stringify(result, null, 2));
+    });
+}

package/dist/packages/vps-work/src/commands/hr/business.js

@@ -0,0 +1,22 @@
+import { attachSharedShortcutOptions, runSkillShortcutExecute } from '../shortcut-common.js';
+const SKILL = 'vps-hr-business';
+export function attachHrBusinessShortcuts(parent) {
+    const entries = [
+        ['+business-list', '读取原生新人事人员及办理状态', 'list'],
+        ['+create-employee', '创建企业员工档案', 'create_employee'],
+        ['+onboarding', '发起入职办理', 'onboarding'],
+        ['+confirm-onboarding', '确认员工入职', 'confirm_onboarding'],
+        ['+transfer', '办理调岗、晋升或降级', 'transfer'],
+        ['+resignation', '创建离职申请草稿（本人或HR代办）', 'resignation'],
+        ['+resignations', '查看离职申请和核对清单', 'resignations'],
+        ['+resignation-action', '补资料、核验、提交或撤回离职申请', 'resignation_action'],
+        ['+resignation-file', '管理离职申请附件', 'resignation_file'],
+        ['+confirm-regular', '确认员工转正', 'confirm_regular'],
+        ['+confirm-resignation', '复核并生效已批准的离职申请', 'confirm_resignation'],
+        ['+business-action', '执行 catalog 公布的新人事动作', 'mutate'],
+    ];
+    for (const [name, description, script] of entries) {
+        attachSharedShortcutOptions(parent.command(name).description(`${description}；业务参数通过 --params 或 --params-file 传入`))
+            .action(async (opts, cmd) => runSkillShortcutExecute(SKILL, script, {}, opts, cmd));
+    }
+}