vps-work 2.5.0 → 2.5.1

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

@@ -0,0 +1,36 @@
+import { Command } from 'commander';
+import { attachSharedShortcutOptions, runSkillShortcutExecute, } from '../shortcut-common.js';
+const SKILL = 'vps-knowledge';
+function action(parent, name, description, script, configure) {
+    let command = parent.command(name).description(description);
+    if (configure)
+        command = configure(command);
+    attachSharedShortcutOptions(command).action(async (opts, cmd) => {
+        await runSkillShortcutExecute(SKILL, script, {
+            ...(opts.baseId ? { base_id: opts.baseId } : {}),
+            ...(opts.name ? { name: opts.name } : {}),
+            ...(opts.description !== undefined ? { description: opts.description } : {}),
+            ...(opts.visibility ? { visibility: opts.visibility } : {}),
+            ...(opts.vDriveItemId ? { v_drive_item_id: opts.vDriveItemId } : {}),
+            ...(opts.question ? { question: opts.question } : {}),
+            ...(opts.model ? { model: opts.model } : {}),
+            ...(opts.node ? { node: opts.node } : {}),
+            ...(opts.keywords ? { keywords: opts.keywords } : {}),
+            ...(opts.topN ? { top_n: Number(opts.topN) } : {}),
+        }, opts, cmd);
+    });
+}
+export function buildKnowledgeCommand() {
+    const command = new Command('knowledge').description('VPS 企业知识库、资料检索、问答与知识图谱。');
+    action(command, '+list', '列出有权访问的知识库', 'list_bases');
+    action(command, '+create', '创建知识库', 'create_base', (cmd) => cmd.requiredOption('--name <name>').option('--description <text>').option('--visibility <value>', 'private|tenant'));
+    action(command, '+update', '更新知识库', 'update_base', (cmd) => cmd.requiredOption('--base-id <id>').option('--name <name>').option('--description <text>').option('--visibility <value>', 'private|tenant'));
+    action(command, '+delete', '删除知识库', 'delete_base', (cmd) => cmd.requiredOption('--base-id <id>'));
+    action(command, '+documents', '列出知识库资料', 'list_documents', (cmd) => cmd.requiredOption('--base-id <id>'));
+    action(command, '+import-vdrive', '从 V盘导入资料', 'import_vdrive', (cmd) => cmd.requiredOption('--base-id <id>').requiredOption('--v-drive-item-id <id>'));
+    action(command, '+search', '检索知识库', 'search', (cmd) => cmd.requiredOption('--base-id <id>').requiredOption('--question <text>'));
+    action(command, '+ask', '基于知识库回答问题', 'ask', (cmd) => cmd.requiredOption('--base-id <id>').requiredOption('--question <text>').option('--model <name>'));
+    action(command, '+graph', '读取知识星图', 'graph', (cmd) => cmd.requiredOption('--base-id <id>').option('--node <id>').option('--keywords <text>').option('--top-n <n>'));
+    action(command, '+build-graph', '生成知识图谱', 'build_graph', (cmd) => cmd.requiredOption('--base-id <id>'));
+    return command;
+}

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

@@ -0,0 +1,52 @@
+import { Command } from 'commander';
+import { promptSecret, promptText, normalizeBaseUrl } from '../utils/prompt.js';
+import { bindVpsServiceAgentCredential, defaultVpsServiceLoginUrl, loginVpsServiceWithPassword, persistVpsServiceAgentCredential, persistVpsServiceSession, pickVpsServiceUserInfo, } from '../core/vps-service-auth.js';
+import { DEFAULT_AGENT_APP_ID, VERTU_APP_ID_ENV } from '../core/vertu-agent-env.js';
+import { readVpsServiceConfig } from '../core/vps-service-config.js';
+import { resolveVpsServiceUrl } from '../core/sales-query-client.js';
+export function buildLoginCommand() {
+    return new Command('login')
+        .description('人工交互使用 Vertu 账号密码登录；Agent/Bot/Hermes 禁止使用此命令，应使用宿主注入的 app_key。')
+        .option('--service-url <url>', 'Vertu 服务地址（默认正式环境，可用 --base-url 同义覆盖）')
+        .option('--base-url <url>', '同 --service-url（兼容旧参数名）')
+        .option('--login <user>', 'VPS 登录名（邮箱或用户名）')
+        .option('--password <secret>', '人工登录密码（Agent/Bot/Hermes 禁止传入）')
+        .option('--app-id <id>', `智能体 app_id（cursor / openclaw / hermes，默认 ${DEFAULT_AGENT_APP_ID}）`)
+        .option('--no-agent-bind', '登录后不签发 Agent app_key')
+        .action(async (opts, cmd) => {
+        const merged = cmd.optsWithGlobals();
+        const existingVps = await readVpsServiceConfig();
+        const serviceUrlOverride = opts.serviceUrl ?? opts.baseUrl ?? merged.baseUrl ?? merged.serviceUrl;
+        const serviceUrlInput = serviceUrlOverride ??
+            existingVps.baseUrl ??
+            resolveVpsServiceUrl() ??
+            (await promptText('Vertu 服务地址', defaultVpsServiceLoginUrl()));
+        const serviceUrl = normalizeBaseUrl(serviceUrlInput);
+        const login = opts.login ?? existingVps.login ?? (await promptText('账号（邮箱 / 用户名）'));
+        const password = opts.password ?? (await promptSecret('密码'));
+        const agentAppId = opts.appId?.trim() ??
+            process.env[VERTU_APP_ID_ENV]?.trim() ??
+            DEFAULT_AGENT_APP_ID;
+        const session = await loginVpsServiceWithPassword(serviceUrl, login, password);
+        await persistVpsServiceSession(serviceUrl, session);
+        const userInfo = pickVpsServiceUserInfo(session.user);
+        console.log(`已登录：${session.login}${userInfo.employeeName ? `（${userInfo.employeeName}）` : ''}`);
+        if (userInfo.departmentPath ?? userInfo.departmentName) {
+            console.log(`部门：${userInfo.departmentPath ?? userInfo.departmentName}`);
+        }
+        console.log(`服务：${serviceUrl}`);
+        console.log('会话：已保存到本机配置');
+        const shouldBindAgent = opts.agentBind !== false;
+        if (shouldBindAgent) {
+            const appId = agentAppId;
+            try {
+                const bound = await bindVpsServiceAgentCredential(serviceUrl, session.token, appId);
+                await persistVpsServiceAgentCredential(serviceUrl, bound);
+                console.log(`Agent：app_id=${bound.appId}（宿主执行 \`vps-work agent env\` 获取环境变量）`);
+            }
+            catch (err) {
+                console.warn(`Agent 绑定跳过：${err.message}`);
+            }
+        }
+    });
+}

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

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+import { clearVpsServiceSession, logoutVpsServiceRemote } from '../core/vps-service-auth.js';
+export function buildLogoutCommand() {
+    return new Command('logout')
+        .description('退出 VPS 登录并清除本机会话。')
+        .option('--forget', '同时移除本地保存的登录名')
+        .action(async (opts) => {
+        await logoutVpsServiceRemote();
+        await clearVpsServiceSession(opts.forget === true);
+        console.log('已退出 VPS 登录（会话已清除）。');
+    });
+}

package/dist/packages/vps-work/src/commands/mail/email.js

@@ -0,0 +1,132 @@
+import { readFile } from 'node:fs/promises';
+import { VertuError } from '../../core/errors.js';
+import { printImResult } from '../../core/im-client.js';
+import { downloadMailFile, inspectMailFile, mailRequest, mailUrl, uploadMailFile } from '../../core/mail-client.js';
+const collect = (value, previous) => [...previous, value];
+function addresses(values = []) {
+    return values.flatMap((value) => value.split(',')).map((value) => {
+        const email = value.trim();
+        if (!/^[^\s<>@,]+@[^\s<>@,]+\.[^\s<>@,]+$/.test(email))
+            throw new VertuError(`邮箱地址无效：${email}`);
+        return { email };
+    });
+}
+function preview(opts, method, path, body, query) {
+    if (!opts.dryRun && !opts.validateOnly)
+        return false;
+    printImResult(opts.json, { validateOnly: true, method, endpoint: mailUrl(path, opts, query), ...(body ? { body } : {}) });
+    return true;
+}
+export function attachEmailCommands(parent) {
+    const command = (name, description) => parent.command(name).description(description)
+        .option('--mailbox-id <uuid>', '部门邮箱 UUID；省略时使用本人个人邮箱')
+        .option('--base-url <url>', 'VPS 服务地址')
+        .option('--dry-run', '仅预览，不发起请求')
+        .option('--validate-only', '同 --dry-run')
+        .option('--no-json', '紧凑 JSON 输出');
+    const options = (cmd) => {
+        const opts = cmd.optsWithGlobals();
+        if (opts.mailboxId && !/^[\da-f]{8}(-[\da-f]{4}){3}-[\da-f]{12}$/i.test(opts.mailboxId)) {
+            throw new VertuError('--mailbox-id 必须是部门邮箱 UUID。');
+        }
+        return opts;
+    };
+    for (const [name, path, description] of [
+        ['+account', '/account', '查看当前邮箱及权限'],
+        ['+mailboxes', '/shared-mailboxes', '列出可见的部门邮箱及成员角色'],
+        ['+folders', '/folders', '列出文件夹、邮件数与未读数'],
+        ['+identities', '/identities', '列出当前邮箱允许使用的发件身份'],
+    ]) {
+        command(name, description).action(async (_, cmd) => {
+            const opts = options(cmd);
+            if (preview(opts, 'GET', path))
+                return;
+            printImResult(opts.json, await mailRequest('GET', path, opts));
+        });
+    }
+    command('+messages', '查询已收取的邮件，支持搜索、文件夹与游标翻页')
+        .option('--folder-id <id>', '文件夹 ID（见 +folders）').option('--search <text>', '搜索文字')
+        .option('--limit <n>', '每页数量，1–100', '50').option('--cursor <cursor>', '上一页 next_cursor')
+        .option('--unread-only', '只查询未读邮件')
+        .action(async (_, cmd) => {
+        const opts = options(cmd), limit = Number(opts.limit);
+        if (!Number.isInteger(limit) || limit < 1 || limit > 100)
+            throw new VertuError('--limit 必须是 1–100 的整数。');
+        const query = { folder_id: opts.folderId, search: opts.search, limit, cursor: opts.cursor, unread: opts.unreadOnly ? true : undefined };
+        if (preview(opts, 'GET', '/messages', undefined, query))
+            return;
+        printImResult(opts.json, await mailRequest('GET', '/messages', opts, undefined, query));
+    });
+    for (const [name, resource, description] of [
+        ['+read', 'messages', '读取邮件正文与附件信息（不自动标记已读）'],
+        ['+submission', 'submissions', '查询发送提交状态'],
+    ]) {
+        command(name, description).requiredOption('--id <id>', '邮件或发送提交 ID')
+            .action(async (_, cmd) => {
+            const opts = options(cmd), path = `/${resource}/${encodeURIComponent(opts.id)}`;
+            if (preview(opts, 'GET', path))
+                return;
+            printImResult(opts.json, await mailRequest('GET', path, opts));
+        });
+    }
+    command('+mark-read', '标记邮件已读（只读成员不可用）').requiredOption('--id <id>', '邮件 ID')
+        .action(async (_, cmd) => {
+        const opts = options(cmd), path = `/messages/${encodeURIComponent(opts.id)}`;
+        if (preview(opts, 'PATCH', path, { unread: false }))
+            return;
+        printImResult(opts.json, await mailRequest('PATCH', path, opts, { unread: false }));
+    });
+    for (const draft of [false, true]) {
+        const c = command(draft ? '+draft' : '+send-email', draft ? '保存邮件草稿，不发送' : '发送真实电子邮件（保留 +send 的 IM 私信兼容行为）')
+            .requiredOption('--to <email>', '收件地址，可重复或逗号分隔', collect, [])
+            .option('--cc <email>', '抄送地址，可重复', collect, []).option('--bcc <email>', '密送地址，可重复', collect, [])
+            .requiredOption('--subject <text>', '邮件主题').option('--body <text>', '纯文本正文')
+            .option('--body-file <path>', '从 UTF-8 文件读取正文（与 --body 互斥）')
+            .option('--body-html-file <path>', '从 UTF-8 文件读取 HTML 正文，保留纯文本正文作为后备')
+            .option('--attachment-id <id>', '+upload 返回的附件 ID，可重复；须属于同一邮箱', collect, []);
+        if (!draft)
+            c.requiredOption('--request-id <id>', '8–128 字符的发送请求编号；中断重试必须复用同一编号和内容')
+                .option('--identity-id <id>', '+identities 返回的发件身份 ID')
+                .option('--reply-to <message-id>', '回复原邮件 ID，保留邮件会话引用');
+        c.action(async (_, cmd) => {
+            const opts = options(cmd);
+            if (opts.body !== undefined && opts.bodyFile)
+                throw new VertuError('--body 与 --body-file 不能同时使用。');
+            if (opts.body === undefined && !opts.bodyFile)
+                throw new VertuError('请提供 --body 或 --body-file。');
+            if (!draft && (!opts.requestId || opts.requestId.length < 8 || opts.requestId.length > 128))
+                throw new VertuError('--request-id 长度必须为 8–128。');
+            const body = { to: addresses(opts.to), cc: addresses(opts.cc), bcc: addresses(opts.bcc), subject: opts.subject,
+                body_text: opts.bodyFile ? await readFile(opts.bodyFile, 'utf8') : opts.body,
+                ...(opts.bodyHtmlFile ? { body_html: await readFile(opts.bodyHtmlFile, 'utf8') } : {}),
+                attachment_ids: opts.attachmentId,
+                ...(!draft ? { client_request_id: opts.requestId, identity_id: opts.identityId, reply_to_message_id: opts.replyTo } : {}),
+            };
+            const path = draft ? '/drafts' : '/messages/send';
+            if (preview(opts, 'POST', path, body))
+                return;
+            try {
+                printImResult(opts.json, await mailRequest('POST', path, opts, body));
+            }
+            catch (e) {
+                throw new VertuError(`${e instanceof Error ? e.message : String(e)}${draft ? '' : `；发送结果可能待确认，请使用原 request-id ${opts.requestId} 和相同内容重试，不要改用新编号。`}`);
+            }
+        });
+    }
+    command('+upload', '流式上传邮件附件，返回供草稿/发送使用的附件 ID')
+        .requiredOption('--file <path>', '本地附件路径，最大 1 GiB')
+        .action(async (_, cmd) => {
+        const opts = options(cmd), info = await inspectMailFile(opts.file);
+        if (preview(opts, 'POST', '/attachments', info))
+            return;
+        printImResult(opts.json, await uploadMailFile(opts.file, opts));
+    });
+    command('+download', '流式下载邮件附件；目标文件已存在时拒绝覆盖')
+        .requiredOption('--id <blob-id>', '+read 返回的附件 blob_id').requiredOption('--output <path>', '本地输出路径')
+        .action(async (_, cmd) => {
+        const opts = options(cmd), path = `/attachments/${encodeURIComponent(opts.id)}`;
+        if (preview(opts, 'GET', path, { output: opts.output }))
+            return;
+        printImResult(opts.json, await downloadMailFile(opts.id, opts.output, opts));
+    });
+}

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

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+import { attachEmailCommands } from './email.js';
+import { attachMailShortcuts } from './shortcuts.js';
+export function buildMailCommand() {
+    const mail = new Command('mail').description('企业邮箱收发、附件与部门邮箱；+send 保留旧 IM 私信兼容。');
+    attachMailShortcuts(mail);
+    attachEmailCommands(mail);
+    return mail;
+}

package/dist/packages/vps-work/src/commands/mail/shortcuts.js

@@ -0,0 +1,43 @@
+import { VertuError } from '../../core/errors.js';
+import { imRequest, printImResult } from '../../core/im-client.js';
+import { attachSharedShortcutOptions, mergeShortcutParams, parseOptionalInt, } from '../shortcut-common.js';
+import { buildImMessagePayload } from '../im/im-message-payload.js';
+function collectAttach(value, previous) {
+    return [...previous, value];
+}
+export function attachMailShortcuts(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+send')
+        .description('发送一对一私信（Vertu IM，自动创建/复用私聊）')
+        .requiredOption('--user-id <id>', '收件人 res.users id')
+        .option('--body <text>', '消息正文')
+        .option('--body-file <path>', '从文件读正文')
+        .option('--attach <path>', '附件路径，可重复', collectAttach, [])
+        .option('--attachments-json <json>', '附件 JSON 数组')).action(async (opts, cmd) => {
+        const userId = parseOptionalInt(opts.userId, '--user-id');
+        if (userId === undefined) {
+            throw new VertuError('Invalid --user-id.');
+        }
+        const globalOpts = cmd.optsWithGlobals();
+        const serviceBaseUrl = opts.baseUrl ?? globalOpts.baseUrl;
+        const message = await buildImMessagePayload({ ...opts, baseUrl: serviceBaseUrl });
+        const merged = await mergeShortcutParams({
+            body: message.body,
+            attachments: message.attachments,
+        }, opts);
+        const created = await imRequest('POST', '/v1/im/channels', {
+            baseUrl: serviceBaseUrl,
+            body: { channel_type: 'direct', user_id: userId },
+        });
+        const channel = typeof created === 'object' && created !== null && 'channel' in created
+            ? created.channel
+            : null;
+        if (!channel || typeof channel.id !== 'string') {
+            throw new VertuError('Vertu IM 未返回 channel.id。');
+        }
+        printImResult(opts.json, await imRequest('POST', `/v1/im/channels/${encodeURIComponent(channel.id)}/messages`, {
+            baseUrl: serviceBaseUrl,
+            body: merged,
+        }));
+    });
+}

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

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import { attachMeetingShortcuts } from './shortcuts.js';
+export function buildMeetingCommand() {
+    const meeting = new Command('meeting').description('Meeting center: recordings, transcripts, minutes, summaries, action items and statistics.');
+    attachMeetingShortcuts(meeting);
+    return meeting;
+}

package/dist/packages/vps-work/src/commands/meeting/shortcuts.js

@@ -0,0 +1,120 @@
+import { VertuError } from '../../core/errors.js';
+import { vpsServiceGet } from '../../core/sales-query-client.js';
+import { attachSharedShortcutOptions, resolveShortcutVpsServiceUrl, } from '../shortcut-common.js';
+function assertYmd(raw, flag) {
+    const value = raw?.trim();
+    if (!value)
+        return undefined;
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        throw new VertuError(`${flag} 需为 YYYY-MM-DD。`);
+    }
+    return value;
+}
+function resolveScope(raw) {
+    const value = raw?.trim().toLowerCase() || 'mine';
+    if (value === 'team')
+        return 'subordinates';
+    if (value === 'mine' || value === 'subordinates' || value === 'all' || value === 'selection') {
+        return value;
+    }
+    throw new VertuError('--scope 仅支持 mine、subordinates、all 或 selection。');
+}
+function csvIds(raw, flag) {
+    if (!raw?.trim())
+        return undefined;
+    const values = raw.split(',').map((value) => Number(value.trim()));
+    if (values.some((value) => !Number.isInteger(value) || value <= 0)) {
+        throw new VertuError(`${flag} 需为逗号分隔的正整数。`);
+    }
+    return [...new Set(values)].join(',');
+}
+function positiveInt(raw, flag) {
+    if (!raw?.trim())
+        return undefined;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value <= 0)
+        throw new VertuError(`${flag} 需为正整数。`);
+    return value;
+}
+function statisticsGroupBy(raw) {
+    const value = raw?.trim().toLowerCase() || 'department';
+    if (value === 'department' ||
+        value === 'template' ||
+        value === 'department_template') {
+        return value;
+    }
+    throw new VertuError('--group-by 仅支持 department、template 或 department_template。');
+}
+export function attachMeetingShortcuts(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+list')
+        .alias('+meetings')
+        .description('查询轻量会议列表；逐字稿、纪要和待办请使用 meeting +detail')
+        .option('--scope <scope>', 'mine（本人）、subordinates（递归下属）、all（全域）或 selection（指定范围）', 'mine')
+        .option('--employee-name <name>', '按员工姓名精确查询（仍受会议权限限制）')
+        .option('--user-ids <ids>', '指定人员 user_id，逗号分隔；配合 selection')
+        .option('--department-ids <ids>', '指定部门 ID，逗号分隔并包含子部门；配合 selection')
+        .option('--start-date <ymd>', 'YYYY-MM-DD，省略=近 30 天')
+        .option('--end-date <ymd>', 'YYYY-MM-DD，省略=今天')
+        .option('--template-type <type>', '按纪要模版类型精确筛选（如：团队内部会议）')
+        .option('--keyword <text>', '搜索会议 ID、主题或摘要')
+        .option('--page <number>', '页码', '1')
+        .option('--page-size <number>', '每页数量（1-50）', '20')).action(async (opts, cmd) => {
+        const scope = resolveScope(opts.scope);
+        const userIds = csvIds(opts.userIds, '--user-ids');
+        const departmentIds = csvIds(opts.departmentIds, '--department-ids');
+        if (scope === 'selection' && !opts.employeeName?.trim() && !userIds && !departmentIds) {
+            throw new VertuError('selection 范围需要 --user-ids 或 --department-ids。');
+        }
+        const pageSize = positiveInt(opts.pageSize, '--page-size');
+        if (pageSize && pageSize > 50)
+            throw new VertuError('--page-size 不能超过 50。');
+        const result = await vpsServiceGet('/v1/meeting-center/meetings', {
+            scope,
+            employee_name: opts.employeeName?.trim() || undefined,
+            user_ids: userIds,
+            department_ids: departmentIds,
+            start_date: assertYmd(opts.startDate, '--start-date'),
+            end_date: assertYmd(opts.endDate, '--end-date'),
+            template_type: opts.templateType?.trim() || undefined,
+            keyword: opts.keyword?.trim() || undefined,
+            page: positiveInt(opts.page, '--page'),
+            page_size: pageSize,
+        }, resolveShortcutVpsServiceUrl(opts, cmd), 'Vertu 会议中心');
+        console.log(JSON.stringify(result, null, opts.json === false ? 0 : 2));
+    });
+    attachSharedShortcutOptions(parent
+        .command('+statistics')
+        .description('按部门或会议模版统计会议、待办闭环和日程来源指标')
+        .option('--department-ids <ids>', '指定部门 ID，逗号分隔并包含子部门')
+        .option('--all-departments', '查询全部门；分组维度由 --group-by 决定', false)
+        .option('--group-by <dimension>', 'department、template 或 department_template', 'department')
+        .option('--start-date <ymd>', 'YYYY-MM-DD，省略=近 30 天')
+        .option('--end-date <ymd>', 'YYYY-MM-DD，省略=今天')
+        .option('--template-type <type>', '仅统计指定会议模版')).action(async (opts, cmd) => {
+        const departmentIds = csvIds(opts.departmentIds, '--department-ids');
+        if (opts.allDepartments === Boolean(departmentIds)) {
+            throw new VertuError('--all-departments 与 --department-ids 必须且只能指定一项。');
+        }
+        const groupBy = statisticsGroupBy(opts.groupBy);
+        const result = await vpsServiceGet('/v1/meeting-center/statistics', {
+            department_ids: departmentIds,
+            all_departments: opts.allDepartments ? 'true' : undefined,
+            group_by: groupBy,
+            start_date: assertYmd(opts.startDate, '--start-date'),
+            end_date: assertYmd(opts.endDate, '--end-date'),
+            template_type: opts.templateType?.trim() || undefined,
+        }, resolveShortcutVpsServiceUrl(opts, cmd), 'Vertu 会议统计');
+        console.log(JSON.stringify(result, null, opts.json === false ? 0 : 2));
+    });
+    attachSharedShortcutOptions(parent
+        .command('+detail')
+        .description('查询会议详情（逐字稿、手写笔记、总结和待办）')
+        .requiredOption('--meeting-id <id>', '会议列表返回的 id 或 minutes_id')).action(async (opts, cmd) => {
+        const meetingId = opts.meetingId.trim();
+        if (!meetingId)
+            throw new VertuError('--meeting-id 不能为空。');
+        const result = await vpsServiceGet(`/v1/meeting-center/meetings/${encodeURIComponent(meetingId)}`, {}, resolveShortcutVpsServiceUrl(opts, cmd), 'Vertu 会议详情');
+        console.log(JSON.stringify(result, null, opts.json === false ? 0 : 2));
+    });
+}

package/dist/packages/vps-work/src/commands/odoo-invoke.js

@@ -0,0 +1,21 @@
+import { buildClientFromOpts } from '../core/auth.js';
+import { ODOO_CLI_PROGRAM_SLUG } from '../core/cli-bin.js';
+import { unwrapExecuteEnvelope } from '../utils/unwrap-envelope.js';
+/**
+ * 调用 capabilities 中 `invoke_kind=ai_tool` 的叶子（与 `vps-work odoo data search` 等价）。
+ */
+export async function executeOdooAiTool(invokeKey, argvPrefix, args, opts) {
+    const { client } = await buildClientFromOpts({
+        baseUrlOverride: opts.baseUrl,
+        endpointOverride: opts.endpoint,
+        requireAuth: true,
+    });
+    const { result } = await client.jsonRpc('/ai/cli/v1/execute', {
+        program: ODOO_CLI_PROGRAM_SLUG,
+        invoke_key: invokeKey,
+        argv: [...argvPrefix],
+        payload: { arguments: args },
+    });
+    return unwrapExecuteEnvelope(result);
+}
+export { APPROVAL_LOGS, ODOO_ME, ODOO_SEARCH, } from './odoo-leaf-registry.js';

package/dist/packages/vps-work/src/commands/odoo-leaf-registry.js

@@ -0,0 +1,13 @@
+/** 遗留 Odoo `/ai/cli/v1/execute` 叶子 `invoke_key` / `argv_prefix` 对齐表（仅 --legacy-odoo-cli 路径使用）。 */
+export const ODOO_SEARCH = {
+    invokeKey: 'odoo_search',
+    argv: ['odoo', 'data', 'search'],
+};
+export const APPROVAL_LOGS = {
+    invokeKey: 'odoo_approval_logs',
+    argv: ['odoo', 'approval', 'logs'],
+};
+export const ODOO_ME = {
+    invokeKey: 'odoo_me',
+    argv: ['odoo', 'me'],
+};

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

@@ -0,0 +1,59 @@
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { readUtf8File, readStdinText } from '../../utils/read-text.js';
+import { applyOfficeFile, createOfficeFile, officeRuntime, readOfficeFile } from '../../core/office-files.js';
+import { officeRequest } from '../../core/office-client.js';
+const print = (value) => console.log(JSON.stringify(value, null, 2));
+async function jsonFile(path) {
+    return JSON.parse(path === '-' ? await readStdinText() : await readUtf8File(path));
+}
+export function buildOfficeCommand() {
+    const office = new Command('office').description('VPS Office：本地文件生成、结构化读写和桌面编辑会话');
+    office.command('+schema').description('获取格式能力、操作说明和生成示例').action(() => print(officeRuntime().capabilities()));
+    office.command('+create').description('生成 Office 文件（目标必须不存在）')
+        .requiredOption('--output <path>').requiredOption('--spec-file <path>', 'JSON 文件；- 表示 stdin')
+        .action(async (opts) => print(await createOfficeFile(opts.output, await jsonFile(opts.specFile))));
+    office.command('+read').description('读取文件结构和 SHA-256 版本').requiredOption('--file <path>')
+        .action(async (opts) => print(await readOfficeFile(opts.file)));
+    office.command('+apply').description('校验版本并整批修改文件；失败不写入')
+        .requiredOption('--file <path>').requiredOption('--ops-file <path>').requiredOption('--expected-version <sha256>')
+        .option('--output <path>', '另存为新文件').option('--dry-run', '计算修改结果但不写入')
+        .action(async (opts) => print(await applyOfficeFile(opts.file, await jsonFile(opts.opsFile), opts.expectedVersion, opts.output, opts.dryRun)));
+    const connected = (command) => command.option('--connection-file <path>', '桌面端生成的连接凭据文件');
+    connected(office.command('+new').description('在 VPS Office 桌面端新建空白文档').requiredOption('--type <type>', 'docx / xlsx / pptx / md / pdf'))
+        .action(async (opts) => {
+        if (!['docx', 'xlsx', 'pptx', 'md', 'pdf'].includes(opts.type))
+            throw new Error('--type 支持 docx / xlsx / pptx / md / pdf');
+        print(await officeRequest('open', { kind: opts.type }, opts.connectionFile));
+    });
+    connected(office.command('+status').description('检查桌面 Office 桥接状态')).action(async (opts) => print(await officeRequest('status', {}, opts.connectionFile)));
+    connected(office.command('+open').description('在 VPS Office 中打开本地文件或 V盘项目')
+        .option('--file <path>').option('--item-id <id>')).action(async (opts) => {
+        if (Boolean(opts.file) === Boolean(opts.itemId))
+            throw new Error('请只指定 --file 或 --item-id。');
+        print(await officeRequest('open', opts.file ? { filePath: resolve(opts.file) } : { itemId: opts.itemId }, opts.connectionFile));
+    });
+    connected(office.command('+sessions').description('列出正在编辑的 Office 文档')).action(async (opts) => print(await officeRequest('sessions', {}, opts.connectionFile)));
+    connected(office.command('+tools').description('发现当前编辑器的原生工具和参数 schema').requiredOption('--session-id <id>'))
+        .action(async (opts) => print(await officeRequest('session-tools', { sessionId: opts.sessionId }, opts.connectionFile)));
+    connected(office.command('+call').description('调用桌面编辑器原生工具；先用 +tools 发现参数')
+        .requiredOption('--session-id <id>').requiredOption('--tool <name>').requiredOption('--args-file <path>')
+        .requiredOption('--expected-version <version>')).action(async (opts) => {
+        const result = await officeRequest('session-apply', { sessionId: opts.sessionId, expectedVersion: opts.expectedVersion,
+            changes: { tool: opts.tool, arguments: await jsonFile(opts.argsFile) } }, opts.connectionFile);
+        print(result);
+        if (result.result?.isError)
+            process.exitCode = 1;
+    });
+    connected(office.command('+session-read').description('读取正在编辑的文档，包括未保存内容与会话版本').requiredOption('--session-id <id>')).action(async (opts) => print(await officeRequest('session-read', { sessionId: opts.sessionId }, opts.connectionFile)));
+    connected(office.command('+session-apply').description('执行 JSON {tool,arguments} 原生工具调用').requiredOption('--session-id <id>').requiredOption('--expected-version <version>').requiredOption('--ops-file <path>'))
+        .action(async (opts) => {
+        const result = await officeRequest('session-apply', { sessionId: opts.sessionId, expectedVersion: opts.expectedVersion, changes: await jsonFile(opts.opsFile) }, opts.connectionFile);
+        print(result);
+        if (result.result?.isError)
+            process.exitCode = 1;
+    });
+    connected(office.command('+session-save').description('通过桌面编辑器保存当前文档').requiredOption('--session-id <id>').requiredOption('--expected-version <version>'))
+        .action(async (opts) => print(await officeRequest('session-save', { sessionId: opts.sessionId, expectedVersion: opts.expectedVersion }, opts.connectionFile)));
+    return office;
+}

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

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import { attachOkrShortcuts } from './shortcuts.js';
+export function buildOkrCommand() {
+    const okr = new Command('okr').description('OKR（按周期读取正式关系表或历史表，含组织树）：+dept-okr、+employee-okr 等。');
+    attachOkrShortcuts(okr);
+    return okr;
+}

package/dist/packages/vps-work/src/commands/okr/shortcuts.js

@@ -0,0 +1,75 @@
+import { VertuError } from '../../core/errors.js';
+import { attachSharedShortcutOptions, parseOptionalInt, runSkillShortcutExecute, } from '../shortcut-common.js';
+const OKR_SKILL = 'vps-okr-management-assistant';
+function requireOkrPeriod(opts) {
+    const p = opts.okrPeriod?.trim();
+    if (!p || !/^\d{4}-(0[1-9]|1[0-2])$/.test(p)) {
+        throw new VertuError('--okr-period must be a valid YYYY-MM.');
+    }
+    return p;
+}
+async function runStructuredOkr(scriptKey, opts, cmd) {
+    const params = {
+        okr_period: requireOkrPeriod(opts),
+    };
+    if (opts.employeeName?.trim()) {
+        params.employee_name = opts.employeeName.trim();
+    }
+    const employeeId = parseOptionalInt(opts.employeeId, '--employee-id');
+    if (employeeId !== undefined) {
+        params.employee_id = employeeId;
+    }
+    if (opts.departmentName?.trim()) {
+        params.department_name = opts.departmentName.trim();
+    }
+    const departmentId = parseOptionalInt(opts.departmentId, '--department-id');
+    if (departmentId !== undefined) {
+        params.department_id = departmentId;
+    }
+    if (opts.matchDept?.trim()) {
+        params.match_dept = opts.matchDept.trim();
+    }
+    const rowLimit = parseOptionalInt(opts.rowLimit, '--row-limit');
+    if (rowLimit !== undefined) {
+        params.limit = rowLimit;
+    }
+    await runSkillShortcutExecute(OKR_SKILL, scriptKey, params, opts, cmd);
+}
+function attachDepartmentStructured(cmd) {
+    return cmd
+        .requiredOption('--okr-period <ym>', 'YYYY-MM')
+        .option('--department-name <text>', '部门模糊')
+        .option('--department-id <id>', 'hr.department id')
+        .option('--match-dept <text>', '部门名 / 管辖部门模糊')
+        .option('--row-limit <n>', '条数上限（默认不限）');
+}
+function attachPersonalStructured(cmd) {
+    return cmd
+        .requiredOption('--okr-period <ym>', 'YYYY-MM')
+        .option('--employee-name <text>', '姓名模糊')
+        .option('--employee-id <id>', 'res.users id')
+        .option('--department-name <text>', '部门模糊')
+        .option('--row-limit <n>', '条数上限（默认不限）');
+}
+export function attachOkrShortcuts(parent) {
+    attachSharedShortcutOptions(attachDepartmentStructured(parent
+        .command('+dept-okr')
+        .description('部门 OKR（2026-07 起读取正式 OKR，含组织树）'))).action(async (opts, cmd) => {
+        await runStructuredOkr('department_okr_structured', opts, cmd);
+    });
+    attachSharedShortcutOptions(attachPersonalStructured(parent
+        .command('+employee-okr')
+        .description('员工 OKR（2026-07 起读取正式 OKR，含组织树）'))).action(async (opts, cmd) => {
+        await runStructuredOkr('personal_okr_structured', opts, cmd);
+    });
+    attachSharedShortcutOptions(attachDepartmentStructured(parent
+        .command('+department-structured')
+        .description('同 +dept-okr（别名）'))).action(async (opts, cmd) => {
+        await runStructuredOkr('department_okr_structured', opts, cmd);
+    });
+    attachSharedShortcutOptions(attachPersonalStructured(parent
+        .command('+personal-structured')
+        .description('同 +employee-okr（别名）'))).action(async (opts, cmd) => {
+        await runStructuredOkr('personal_okr_structured', opts, cmd);
+    });
+}