vps-work 2.5.0 → 2.5.1

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

@@ -0,0 +1,127 @@
+import { Command } from 'commander';
+import { OdooClient, extractSessionIdFromSetCookie } from '../core/client.js';
+import { loadCredentials, loadPassword, persistPassword, persistSession, } from '../core/auth.js';
+import { PRIMARY_ALIAS, isValidAlias, listEndpoints, readConfig, } from '../core/config.js';
+import { promptSecret } from '../utils/prompt.js';
+import { VertuError } from '../core/errors.js';
+export function buildReauthCommand() {
+    return new Command('reauth')
+        .description('仅供人工刷新 legacy Odoo AI CLI 会话；Agent/Bot/Hermes 禁止使用。')
+        .option('--endpoint <alias>', 'Refresh only the named endpoint (default = primary). Defaults to refreshing every configured endpoint.')
+        .option('--all', 'Explicitly request all endpoints (default behavior when --endpoint is omitted).')
+        .option('--no-remember-password', 'When prompting for a missing password, do not persist it for next time (default: persist).')
+        .action(async (opts) => {
+        const targets = await collectTargets(opts);
+        if (!targets.length) {
+            throw new VertuError('No legacy endpoints to refresh. Human operators may configure one with `vps-work auth login --legacy-odoo-cli`; Agent/Bot/Hermes must use injected app_key credentials instead.');
+        }
+        const results = [];
+        for (const target of targets) {
+            results.push(await refreshOne(target, opts));
+        }
+        printSummary(results);
+        const failed = results.filter((r) => r.status === 'failed').length;
+        if (failed > 0) {
+            process.exitCode = 2;
+        }
+    });
+}
+async function collectTargets(opts) {
+    const config = await readConfig();
+    if (opts.endpoint) {
+        const alias = opts.endpoint.trim();
+        if (alias !== PRIMARY_ALIAS && !isValidAlias(alias)) {
+            throw new VertuError(`Invalid --endpoint alias "${alias}"; expected ^[a-z][a-z0-9-]*$ (e.g. "im", "default").`);
+        }
+        let baseUrl;
+        if (alias === PRIMARY_ALIAS) {
+            baseUrl = config.defaultBaseUrl;
+        }
+        else {
+            baseUrl = config.endpoints[alias]?.baseUrl;
+        }
+        if (!baseUrl) {
+            throw new VertuError(`Endpoint "${alias}" is not configured. A human operator may configure this legacy endpoint; Agent/Bot/Hermes must not log in with a password.`);
+        }
+        return [{ alias, baseUrl }];
+    }
+    // Default = all known endpoints (primary + every alias).
+    return listEndpoints(config);
+}
+async function refreshOne(target, opts) {
+    const { alias, baseUrl } = target;
+    const existing = await loadCredentials({ baseUrlOverride: baseUrl });
+    const login = existing.profile.login;
+    if (!login) {
+        return {
+            alias,
+            baseUrl,
+            status: 'skipped',
+            detail: 'no human legacy login recorded; Agent/Bot/Hermes must use injected app_key credentials',
+        };
+    }
+    let password = await loadPassword(baseUrl);
+    let promptedPassword = false;
+    if (!password) {
+        if (!process.stdin.isTTY) {
+            return {
+                alias,
+                baseUrl,
+                status: 'skipped',
+                detail: 'no password remembered and stdin is not a TTY',
+            };
+        }
+        password = await promptSecret(`Password for ${login} @ ${alias} (${baseUrl})`);
+        promptedPassword = true;
+    }
+    const db = existing.profile.db;
+    try {
+        const client = new OdooClient({ baseUrl });
+        const params = { login, password };
+        if (db)
+            params.db = db;
+        const { result, setCookie } = await client.jsonRpc('/ai/cli/v1/login', params, { noBearer: true });
+        const sessionId = extractSessionIdFromSetCookie(setCookie) ?? result.session_id;
+        if (!sessionId) {
+            return {
+                alias,
+                baseUrl,
+                status: 'failed',
+                detail: 'login succeeded but no session_id was returned',
+            };
+        }
+        // skipDefaultUpdate=true：reauth 只刷新会话，绝不应改动 defaultBaseUrl。
+        // 默认行为是遍历所有端点（primary + 各 alias），若不跳过则最后被处理的 alias
+        // （字母序如 `im`）会把主端点的 defaultBaseUrl 覆盖掉，导致后续无 --endpoint 的
+        // 普通命令全部错误地路由到次端点。
+        const skipDefaultUpdate = alias !== PRIMARY_ALIAS;
+        await persistSession(baseUrl, sessionId, { db: result.db ?? db ?? undefined, login: result.login }, skipDefaultUpdate ? { skipDefaultUpdate: true } : undefined);
+        if (promptedPassword && opts.rememberPassword !== false) {
+            await persistPassword(baseUrl, password);
+        }
+        return {
+            alias,
+            baseUrl,
+            status: 'ok',
+            detail: 'session refreshed',
+            uid: result.uid,
+            login: result.login,
+        };
+    }
+    catch (err) {
+        return {
+            alias,
+            baseUrl,
+            status: 'failed',
+            detail: err.message,
+        };
+    }
+}
+function printSummary(results) {
+    const labelWidth = Math.max(5, ...results.map((r) => r.alias.length));
+    for (const r of results) {
+        const tag = r.status === 'ok' ? 'OK    ' : r.status === 'skipped' ? 'SKIP  ' : 'FAIL  ';
+        const who = r.uid && r.login ? ` ${r.login} (uid=${r.uid})` : '';
+        console.log(`[${tag}] ${r.alias.padEnd(labelWidth)}  ${r.baseUrl}  →${who} ${r.detail}`);
+    }
+}

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

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import { attachReportShortcuts } from './shortcuts.js';
+export function buildReportCommand() {
+    const report = new Command('report').description('Daily report shortcuts: required/check-in missing, personal/department reports, tasks, channel options, submit, sync.');
+    attachReportShortcuts(report);
+    return report;
+}

package/dist/packages/vps-work/src/commands/report/missing-daily-reports.js

@@ -0,0 +1,9 @@
+import { resolveVpsServiceUrl, vpsServiceGet } from '../../core/sales-query-client.js';
+export const MISSING_DAILY_REPORTS_PATH = '/v1/daily-report/missing';
+export function missingDailyReportsUrl(date, serviceBaseUrl) {
+    const query = new URLSearchParams({ date, response_format: 'json' });
+    return `${resolveVpsServiceUrl(serviceBaseUrl)}${MISSING_DAILY_REPORTS_PATH}?${query.toString()}`;
+}
+export async function queryMissingDailyReports(date, serviceBaseUrl) {
+    return vpsServiceGet(MISSING_DAILY_REPORTS_PATH, { date, response_format: 'json' }, serviceBaseUrl, '应填未交日报');
+}

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

@@ -0,0 +1,251 @@
+import { VertuError } from '../../core/errors.js';
+import { imRequest, printImResult } from '../../core/im-client.js';
+import { parseJsonArg } from '../../utils/parse-json-arg.js';
+import { attachSharedShortcutOptions, mergeShortcutParams, parseOptionalFloat, parseOptionalInt, previewShortcutRequest, runSkillShortcutExecute, } from '../shortcut-common.js';
+import { missingDailyReportsUrl, queryMissingDailyReports, } from './missing-daily-reports.js';
+const REPORT_SKILL = 'vps-daily-report-assistant';
+function resolveBaseUrl(opts, cmd) {
+    const merged = cmd.optsWithGlobals();
+    return opts.baseUrl ?? merged.baseUrl;
+}
+function putString(target, key, raw) {
+    const value = raw?.trim();
+    if (value) {
+        target[key] = value;
+    }
+}
+function putInt(target, key, raw, flag) {
+    const value = parseOptionalInt(raw, flag);
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}
+function putFloat(target, key, raw, flag) {
+    const value = parseOptionalFloat(raw, flag);
+    if (value !== undefined) {
+        target[key] = value;
+    }
+}
+function requireYmd(raw, flag) {
+    const value = raw?.trim();
+    if (!value || !/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        throw new VertuError(`${flag} YYYY-MM-DD is required.`);
+    }
+    return value;
+}
+function parseItemsJson(raw) {
+    const value = raw?.trim();
+    if (!value) {
+        return undefined;
+    }
+    const parsed = parseJsonArg(value, '--items-json');
+    if (!Array.isArray(parsed) || parsed.length === 0) {
+        throw new VertuError('--items-json must be a non-empty JSON array.');
+    }
+    return parsed;
+}
+function hasSubmitItems(body) {
+    return Array.isArray(body.items) && body.items.length > 0;
+}
+function validateSubmitBody(body) {
+    if (typeof body.tomorrow !== 'string' || body.tomorrow.trim().length === 0) {
+        throw new VertuError('--tomorrow is required.');
+    }
+    if (hasSubmitItems(body)) {
+        return;
+    }
+    const missing = ['task_id', 'progress', 'spent_hours', 'content'].filter((key) => {
+        const value = body[key];
+        return value === undefined || value === null || value === '';
+    });
+    if (missing.length) {
+        throw new VertuError('Either provide --items-json/--params items, or provide --task-id --progress --spent-hours --content.');
+    }
+}
+export function attachReportShortcuts(parent) {
+    attachSharedShortcutOptions(parent
+        .command('+missing-daily-reports')
+        .description('每日应填但未提交日报名单（/v1/daily-report/missing）')
+        .requiredOption('--date <ymd>', 'YYYY-MM-DD')).action(async (opts, cmd) => {
+        const date = requireYmd(opts.date, '--date');
+        const baseUrl = resolveBaseUrl(opts, cmd);
+        if (opts.validateOnly || opts.dryRun) {
+            printImResult(opts.json, {
+                validateOnly: true,
+                method: 'GET',
+                endpoint: missingDailyReportsUrl(date, baseUrl),
+            });
+            return;
+        }
+        const result = await queryMissingDailyReports(date, baseUrl);
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+checkin-missing')
+        .description('打卡但未提交日报名单（wechat.checkin.daily.report.compare）')
+        .requiredOption('--date <ymd>', 'YYYY-MM-DD')
+        .option('--department-id <id>', 'hr.department id；包含子部门')
+        .option('--limit <n>', '最多返回条数', '500')).action(async (opts, cmd) => {
+        const base = {
+            date: requireYmd(opts.date, '--date'),
+            limit: parseOptionalInt(opts.limit, '--limit') ?? 500,
+        };
+        const departmentId = parseOptionalInt(opts.departmentId, '--department-id');
+        if (departmentId !== undefined) {
+            base.department_id = departmentId;
+        }
+        await runSkillShortcutExecute(REPORT_SKILL, 'checkin_missing', base, opts, cmd);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+mine')
+        .description('日报列表（/v1/daily-report/mine）')
+        .option('--user-id <id>', '管理员查询的 res.users id；省略=当前登录用户')
+        .option('--start-time <date>', 'YYYY-MM-DD，默认今天')
+        .option('--end-time <date>', 'YYYY-MM-DD，默认今天')).action(async (opts, cmd) => {
+        const query = {};
+        putInt(query, 'user_id', opts.userId, '--user-id');
+        putString(query, 'start_time', opts.startTime);
+        putString(query, 'end_time', opts.endTime);
+        const result = await imRequest('GET', '/v1/daily-report/mine', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+department')
+        .description('本部门及子部门成员日报（/v1/daily-report/department）')
+        .requiredOption('--date <ymd>', 'YYYY-MM-DD')
+        .option('--limit <n>', '最多返回条数', '500')
+        .option('--department-path <path>', '指定其他部门完整路径；需要跨部门日报权限')
+        .option('--all-departments', '查询所有部门；需要全公司日报权限', false)).action(async (opts, cmd) => {
+        if (opts.allDepartments && opts.departmentPath?.trim()) {
+            throw new VertuError('--department-path and --all-departments cannot be used together.');
+        }
+        const query = {
+            date: requireYmd(opts.date, '--date'),
+            limit: parseOptionalInt(opts.limit, '--limit') ?? 500,
+        };
+        putString(query, 'department_path', opts.departmentPath);
+        if (opts.allDepartments) {
+            query.all_departments = true;
+        }
+        const result = await imRequest('GET', '/v1/daily-report/department', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+tasks')
+        .description('我的可汇报研发任务（/v1/daily-report/tasks）')
+        .option('--limit <n>', '最多返回条数', '50')).action(async (opts, cmd) => {
+        const query = { limit: parseOptionalInt(opts.limit, '--limit') ?? 50 };
+        const result = await imRequest('GET', '/v1/daily-report/tasks', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent.command('+im-channel-options')
+        .description('查看当前账号可选择的日报群聊及默认群（/v1/daily-report/im-channel-options）')
+        .option('--user-id <id>', '仅集成 API Key 查询指定员工时使用；账号会话始终查询本人')).action(async (opts, cmd) => {
+        const result = await imRequest('GET', '/v1/daily-report/im-channel-options', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            query: opts.userId ? { user_id: parseOptionalInt(opts.userId, '--user-id') } : undefined,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+submit')
+        .description('提交今日日报（/v1/daily-report/submit）')
+        .option('--task-id <id>', '任务中心 UUID；单任务提交时必填')
+        .option('--progress <n>', '目标进度 0-100；单任务提交时必填')
+        .option('--spent-hours <h>', '今日投入小时数；单任务提交时必填')
+        .option('--content <text>', '今日工作内容；多行会拆成多条进度')
+        .option('--tomorrow <text>', '明日计划')
+        .option('--items-json <json>', '多任务 items 数组，元素含任务中心 UUID task_id/progress/spent_hours/content')
+        .option('--im-channel-id <id>', '本系统 IM 群聊 id；先用 +im-channel-options 查看，省略时由服务端选择默认日报群或部门群')
+        .option('--legacy-push', '改走旧 PMS/小小V IM 推送接口（默认关闭）', false)
+        .option('--channel-id <id>', '旧 IM channel_id；仅 --legacy-push 时有效')
+        .option('--chat-group-name <name>', '旧 IM 群名称；仅 --legacy-push 时有效')).action(async (opts, cmd) => {
+        const base = {};
+        const items = parseItemsJson(opts.itemsJson);
+        if (items) {
+            base.items = items;
+        }
+        putString(base, 'task_id', opts.taskId);
+        putInt(base, 'progress', opts.progress, '--progress');
+        putFloat(base, 'spent_hours', opts.spentHours, '--spent-hours');
+        putString(base, 'content', opts.content);
+        putString(base, 'tomorrow', opts.tomorrow);
+        putString(base, 'im_channel_id', opts.imChannelId);
+        if (opts.legacyPush) {
+            base.legacy_push = true;
+        }
+        putInt(base, 'channel_id', opts.channelId, '--channel-id');
+        putString(base, 'chat_group_name', opts.chatGroupName);
+        const body = await mergeShortcutParams(base, opts);
+        validateSubmitBody(body);
+        if (previewShortcutRequest(opts, cmd, 'POST', '/v1/daily-report/submit', { body }))
+            return;
+        const result = await imRequest('POST', '/v1/daily-report/submit', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+submit-existing-progress')
+        .description('提交今天已经记录的任务进展，不重复更新任务进度')
+        .requiredOption('--tomorrow <text>', '明日计划，至少一条')
+        .option('--im-channel-id <id>', '本系统 IM 群聊 id；先用 +im-channel-options 查看，省略时由服务端选择默认日报群或部门群')).action(async (opts, cmd) => {
+        const base = {};
+        putString(base, 'tomorrow', opts.tomorrow);
+        putString(base, 'im_channel_id', opts.imChannelId);
+        const body = await mergeShortcutParams(base, opts);
+        if (typeof body.tomorrow !== 'string' || body.tomorrow.trim().length === 0) {
+            throw new VertuError('--tomorrow is required.');
+        }
+        const path = '/v1/daily-report/submit-existing-progress';
+        if (previewShortcutRequest(opts, cmd, 'POST', path, { body }))
+            return;
+        const result = await imRequest('POST', path, {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent
+        .command('+delete-today')
+        .description('管理员删除今天的日报测试数据（/v1/daily-report/admin/delete-today）')
+        .option('--user-id <id>', '被删除用户 res.users id；省略=当前登录用户')
+        .option('--with-progress', '同时删除日报 payload 中的今日任务进度并回算任务进度', false)
+        .option('--keep-im-message', '保留本系统 IM 中的日报消息；默认撤回', false)
+        .option('--confirm', '确认删除当日日报测试数据', false)).action(async (opts, cmd) => {
+        if (!opts.confirm) {
+            throw new VertuError('删除今日日报需要 --confirm。');
+        }
+        const body = { confirm: true };
+        putInt(body, 'user_id', opts.userId, '--user-id');
+        if (opts.withProgress) {
+            body.with_progress = true;
+        }
+        if (opts.keepImMessage) {
+            body.keep_im_message = true;
+        }
+        const result = await imRequest('POST', '/v1/daily-report/admin/delete-today', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body,
+        });
+        printImResult(opts.json, result);
+    });
+    attachSharedShortcutOptions(parent.command('+sync').description('同步日报助手会话与今日日报卡片（/v1/daily-report/sync）')).action(async (opts, cmd) => {
+        const body = await mergeShortcutParams({}, opts);
+        const result = await imRequest('POST', '/v1/daily-report/sync', {
+            baseUrl: resolveBaseUrl(opts, cmd),
+            body,
+        });
+        printImResult(opts.json, result);
+    });
+}

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

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+import { attachSalesPersonnelShortcuts } from './shortcuts-personnel.js';
+import { attachSalesShortcuts } from './shortcuts.js';
+/** Features · 销售与经营 — Lark 风格 `vps-work sales +…` 快捷命令。 */
+export function buildSalesCommand() {
+    const sales = new Command('sales')
+        .description('Sales shortcuts: +headline-kpi, +orders, +order-finance, +invoice-status, +reconciled-receipts, +dealer-orders 等。');
+    attachSalesShortcuts(sales);
+    attachSalesPersonnelShortcuts(sales);
+    return sales;
+}

package/dist/packages/vps-work/src/commands/sales/period-params.js

@@ -0,0 +1,75 @@
+import { parseOptionalInt } from '../shortcut-common.js';
+const DAILY_SALES_SKILL = 'vps-daily-sales-report';
+export function dailySalesSkillKey() {
+    return DAILY_SALES_SKILL;
+}
+/**
+ * 时间窗 + 部门 + 通用 limit / include_deposit / 商品维度过滤。
+ * `defaultPeriod` 仅在未传 period 且未传 start/end 时生效。
+ */
+export function buildSalesPeriodParams(opts, defaultPeriod) {
+    const p = {};
+    if (opts.startDate) {
+        p.start_date = opts.startDate;
+    }
+    if (opts.endDate) {
+        p.end_date = opts.endDate;
+    }
+    if (opts.period) {
+        p.period = opts.period;
+    }
+    else if (!opts.startDate && !opts.endDate && defaultPeriod) {
+        p.period = defaultPeriod;
+    }
+    const days = parseOptionalInt(opts.days, '--days');
+    if (days !== undefined) {
+        p.days = days;
+    }
+    if (opts.deptL1) {
+        p.dept_l1 = opts.deptL1;
+    }
+    if (opts.deptL2) {
+        p.dept_l2 = opts.deptL2;
+    }
+    if (opts.deptL3) {
+        p.dept_l3 = opts.deptL3;
+    }
+    if (opts.deptL4) {
+        p.dept_l4 = opts.deptL4;
+    }
+    if (opts.deptL5) {
+        p.dept_l5 = opts.deptL5;
+    }
+    if (opts.departmentMode) {
+        p.department_mode = opts.departmentMode;
+    }
+    const limit = parseOptionalInt(opts.limit, '--limit');
+    if (limit !== undefined) {
+        p.limit = limit;
+    }
+    if (opts.includeDeposit) {
+        p.include_deposit = true;
+    }
+    if (opts.productSubcategory) {
+        p.product_subcategory = opts.productSubcategory;
+    }
+    if (opts.productSubcategories) {
+        p.product_subcategories = opts.productSubcategories;
+    }
+    if (opts.productCategory) {
+        p.product_category = opts.productCategory;
+    }
+    if (opts.productMajorCategories) {
+        p.product_major_categories = opts.productMajorCategories;
+    }
+    if (opts.productStyle) {
+        p.product_style = opts.productStyle;
+    }
+    if (opts.productStyleDetails) {
+        p.product_style_details = opts.productStyleDetails;
+    }
+    if (opts.smartWearable) {
+        p.smart_wearable = true;
+    }
+    return p;
+}

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

@@ -0,0 +1,124 @@
+import { attachSharedShortcutOptions, parseOptionalInt, runSkillShortcutExecute, } from '../shortcut-common.js';
+import { buildSalesPeriodParams, } from './period-params.js';
+const PERSONNEL_SKILL = 'vps-sale-personnel-efficiency';
+function withOkrSource(params, opts) {
+    if (opts.okrSource) {
+        params.okr_source = opts.okrSource;
+    }
+    return params;
+}
+function personnelPeriod(cmd) {
+    return cmd
+        .option('--period <name>', 'this_month | last_month | this_quarter | YYYY-MM-DD | …')
+        .option('--start-date <date>', 'YYYY-MM-DD；单独传表示单日，配合 --end-date 表示范围')
+        .option('--end-date <date>', 'YYYY-MM-DD；单独传表示单日，配合 --start-date 表示范围')
+        .option('--days <n>', 'With period=last_n_days')
+        .option('--dept-l1 <name>', '一级部门')
+        .option('--dept-l2 <name>', '二级部门')
+        .option('--dept-l3 <name>', '三级部门')
+        .option('--dept-l4 <name>', '四级部门')
+        .option('--dept-l5 <name>', '五级部门')
+        .option('--include-deposit', '含定金口径', false);
+}
+export function attachSalesPersonnelShortcuts(parent) {
+    attachSharedShortcutOptions(personnelPeriod(parent
+        .command('+per-person-kpi')
+        .description('销售人效 / 人均产出（per_person_kpi）')
+        .option('--dept-level <n>', '聚合层级 1-3', '2')
+        .option('--on-duty-status <label>', '在职 | 全部', '在职')
+        .option('--page <n>', '页码，从 1 开始', '1'))).action(async (opts, cmd) => {
+        const p = buildSalesPeriodParams(opts, 'last_month');
+        const level = parseOptionalInt(opts.deptLevel, '--dept-level');
+        if (level !== undefined) {
+            p.dept_level = level;
+        }
+        if (opts.onDutyStatus) {
+            p.on_duty_status = opts.onDutyStatus;
+        }
+        const page = parseOptionalInt(opts.page, '--page');
+        if (page !== undefined) {
+            p.page = page;
+        }
+        await runSkillShortcutExecute(PERSONNEL_SKILL, 'per_person_kpi', p, opts, cmd);
+    });
+    attachSharedShortcutOptions(personnelPeriod(parent
+        .command('+personal-okr')
+        .description('销售员个人业绩目标达成（personal_okr_achievement）')
+        .option('--salesperson-like <name>', '姓名 ILIKE')
+        .option('--work-id <code>', '工号')
+        .option('--only-below-target', '仅未达标', false)
+        .option('--order-by <field>', 'rate_asc | rate_desc | amount_desc | name', 'rate_asc')
+        .option('--limit <n>', 'Max rows', '30')
+        .option('--page <n>', '页码，从 1 开始', '1')
+        .option('--okr-source <source>', 'postgres | legacy（默认 postgres；旧 PMS/BI 口径传 legacy）'))).action(async (opts, cmd) => {
+        const p = buildSalesPeriodParams(opts, 'this_quarter');
+        withOkrSource(p, opts);
+        if (opts.salespersonLike) {
+            p.salesperson_like = opts.salespersonLike;
+        }
+        if (opts.workId) {
+            p.work_id = opts.workId;
+        }
+        if (opts.onlyBelowTarget) {
+            p.only_below_target = true;
+        }
+        if (opts.orderBy) {
+            p.order_by = opts.orderBy;
+        }
+        const limit = parseOptionalInt(opts.limit, '--limit');
+        if (limit !== undefined) {
+            p.limit = limit;
+        }
+        const page = parseOptionalInt(opts.page, '--page');
+        if (page !== undefined) {
+            p.page = page;
+        }
+        await runSkillShortcutExecute(PERSONNEL_SKILL, 'personal_okr_achievement', p, opts, cmd);
+    });
+    attachSharedShortcutOptions(personnelPeriod(parent
+        .command('+personal-monthly-okr')
+        .description('个人月度业绩目标明细（personal_monthly_okr）')
+        .option('--name <text>', '姓名 ILIKE')
+        .option('--barcode <code>', '工号')
+        .option('--limit <n>', 'Max rows', '100')
+        .option('--page <n>', '页码，从 1 开始', '1')
+        .option('--okr-source <source>', 'postgres | legacy（默认 postgres；旧 PMS/BI 口径传 legacy）'))).action(async (opts, cmd) => {
+        const p = buildSalesPeriodParams(opts, 'this_month');
+        withOkrSource(p, opts);
+        if (opts.name) {
+            p.name = opts.name;
+        }
+        if (opts.barcode) {
+            p.barcode = opts.barcode;
+        }
+        const limit = parseOptionalInt(opts.limit, '--limit');
+        if (limit !== undefined) {
+            p.limit = limit;
+        }
+        const page = parseOptionalInt(opts.page, '--page');
+        if (page !== undefined) {
+            p.page = page;
+        }
+        await runSkillShortcutExecute(PERSONNEL_SKILL, 'personal_monthly_okr', p, opts, cmd);
+    });
+    attachSharedShortcutOptions(personnelPeriod(parent
+        .command('+team-pk')
+        .description('团队/个人 PK 榜（team_pk_ranking）')
+        .option('--mode <name>', 'team | person', 'person')
+        .option('--limit <n>', 'Max rows', '20')
+        .option('--page <n>', '页码，从 1 开始', '1'))).action(async (opts, cmd) => {
+        const p = buildSalesPeriodParams(opts, 'this_month');
+        if (opts.mode) {
+            p.mode = opts.mode;
+        }
+        const limit = parseOptionalInt(opts.limit, '--limit');
+        if (limit !== undefined) {
+            p.limit = limit;
+        }
+        const page = parseOptionalInt(opts.page, '--page');
+        if (page !== undefined) {
+            p.page = page;
+        }
+        await runSkillShortcutExecute(PERSONNEL_SKILL, 'team_pk_ranking', p, opts, cmd);
+    });
+}