vps-work 2.5.0 → 2.5.1

package/dist/packages/vps-work/src/core/sales-query-client.js

@@ -0,0 +1,452 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { request } from 'undici';
+import { VertuError } from './errors.js';
+import { configFilePath, vpsServiceConfigFilePath } from './paths.js';
+import { resolveServerSkillKey } from './skill-key.js';
+import { readVertuAgentEnvFromProcess, } from './vertu-agent-env.js';
+import { vpsServiceAuthHeaders } from './vps-service-http.js';
+import { publicBusinessErrorMessage, publicBusinessResult } from './public-result.js';
+const DAILY_SALES_LOCAL = 'vps-daily-sales-report';
+const DAILY_SALES_SERVER = 'odoo-daily-sales-report';
+const STORE_MANAGEMENT = 'vps-store-management';
+const PERSONNEL_LOCAL = 'vps-sale-personnel-efficiency';
+const PERSONNEL_SERVER = 'odoo-sale-personnel-efficiency';
+const HR_COMPENSATION_LOCAL = 'vps-hr-compensation-documents';
+const HR_COMPENSATION_SERVER = 'odoo-hr-compensation-documents';
+const OKR_MANAGEMENT_LOCAL = 'vps-okr-management-assistant';
+const OKR_MANAGEMENT_SERVER = 'odoo-okr-management-assistant';
+const OKR_LOCAL = 'vps-okr';
+const OKR_SERVER = 'odoo-okr';
+const DAILY_REPORT_LOCAL = 'vps-daily-report-assistant';
+const DAILY_REPORT_SERVER = 'odoo-daily-report-assistant';
+const DEV_MANAGEMENT_LOCAL = 'vps-task-management-assistant';
+const DEV_MANAGEMENT_SERVER = 'odoo-dev-management-assistant';
+const DEALER_OPS = 'vps-dealer-ops';
+/** 未配置时的 vps-service 生产根地址（可被 `--base-url` / 环境变量 / config 覆盖）。 */
+export const DEFAULT_VPS_SERVICE_BASE_URL = 'https://vps-service.vertu.cn';
+let dotenvCache = null;
+function readVpsServiceConnectionSync() {
+    const path = vpsServiceConfigFilePath();
+    if (existsSync(path)) {
+        try {
+            const parsed = JSON.parse(readFileSync(path, 'utf8'));
+            return {
+                baseUrl: parsed.baseUrl?.trim() || undefined,
+                apiKey: parsed.apiKey?.trim() || undefined,
+                sessionToken: parsed.sessionToken?.trim() || undefined,
+                expiresAt: parsed.expiresAt?.trim() || undefined,
+                login: parsed.login?.trim() || undefined,
+                agentAppId: parsed.agentAppId?.trim() || undefined,
+                agentKeyExpiresAt: parsed.agentKeyExpiresAt?.trim() || undefined,
+            };
+        }
+        catch {
+            return {};
+        }
+    }
+    const legacy = readLocalCliConfig()?.salesQuery;
+    if (!legacy) {
+        return {};
+    }
+    return {
+        baseUrl: legacy.baseUrl?.trim() || undefined,
+        apiKey: legacy.apiKey?.trim() || undefined,
+    };
+}
+function readDotenv() {
+    if (dotenvCache) {
+        return dotenvCache;
+    }
+    const out = {};
+    const filePath = resolve(process.cwd(), '.env');
+    if (!existsSync(filePath)) {
+        dotenvCache = out;
+        return out;
+    }
+    const raw = readFileSync(filePath, 'utf8');
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        const eq = trimmed.indexOf('=');
+        if (eq <= 0) {
+            continue;
+        }
+        const key = trimmed.slice(0, eq).trim();
+        const value = trimmed.slice(eq + 1).trim().replace(/^['"]|['"]$/g, '');
+        if (key) {
+            out[key] = value;
+        }
+    }
+    dotenvCache = out;
+    return out;
+}
+function envTrim(key) {
+    const v = (process.env[key] ?? readDotenv()[key])?.trim();
+    return v || undefined;
+}
+function readLocalCliConfig() {
+    const filePath = configFilePath();
+    if (!existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+function readCurrentCliLogin() {
+    const config = readLocalCliConfig();
+    if (!config) {
+        return undefined;
+    }
+    try {
+        const baseUrl = envTrim('VERTU_BASE_URL') ?? config.defaultBaseUrl;
+        if (baseUrl && config.profiles?.[baseUrl]?.login) {
+            return config.profiles[baseUrl].login;
+        }
+        return Object.values(config.profiles ?? {}).find((profile) => profile.login)?.login;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 当前 vps-service 请求可携带的用户登录身份。 */
+export function resolveVpsServiceIdentity() {
+    const fileCfg = readVpsServiceConnectionSync();
+    const agentEnv = readVertuAgentEnvFromProcess();
+    return { login: agentEnv.login ?? fileCfg.login ?? readCurrentCliLogin() };
+}
+function normalizeServiceRoot(url) {
+    let trimmed = url.trim().replace(/\/+$/, '');
+    if (!trimmed) {
+        return DEFAULT_VPS_SERVICE_BASE_URL;
+    }
+    if (!/^https?:\/\//i.test(trimmed)) {
+        trimmed = `https://${trimmed}`;
+    }
+    return trimmed;
+}
+/**
+ * vps-service 根 URL：`--base-url` > `VERTU_VPS_SERVICE_URL` > `~/.vps-work/vps-service.json` >
+ * （兼容）`VERTU_SALES_QUERY_URL` / 旧 config.json `salesQuery` > 默认生产地址。
+ */
+export function resolveVpsServiceUrl(override) {
+    const fileCfg = readVpsServiceConnectionSync();
+    const url = override?.trim() ||
+        envTrim('VERTU_VPS_SERVICE_URL') ||
+        envTrim('VERTU_SALES_QUERY_URL') ||
+        fileCfg.baseUrl ||
+        DEFAULT_VPS_SERVICE_BASE_URL;
+    return normalizeServiceRoot(url);
+}
+/** @deprecated 使用 {@link resolveVpsServiceUrl} */
+export function resolveSalesQueryServiceUrl(override) {
+    return resolveVpsServiceUrl(override);
+}
+function serviceHeaders(serviceBaseUrl, extra) {
+    const headers = {
+        'content-type': 'application/json',
+        accept: 'application/json',
+        ...vpsServiceAuthHeaders(serviceBaseUrl),
+    };
+    const fileCfg = readVpsServiceConnectionSync();
+    const agentEnv = readVertuAgentEnvFromProcess();
+    const agentLogin = agentEnv.login ?? fileCfg.login ?? readCurrentCliLogin();
+    if (headers.authorization && agentLogin && !headers['x-vertu-user-login']) {
+        headers['x-vps-user-login'] = encodeURIComponent(agentLogin);
+    }
+    for (const [key, value] of Object.entries(extra ?? {})) {
+        const clean = value?.trim();
+        if (clean) {
+            headers[key] = clean;
+        }
+    }
+    return headers;
+}
+function isVpsServiceSkill(skillKey) {
+    const server = resolveServerSkillKey(skillKey);
+    return (skillKey === DAILY_SALES_LOCAL ||
+        server === DAILY_SALES_SERVER ||
+        skillKey === STORE_MANAGEMENT ||
+        skillKey === PERSONNEL_LOCAL ||
+        server === PERSONNEL_SERVER ||
+        skillKey === HR_COMPENSATION_LOCAL ||
+        server === HR_COMPENSATION_SERVER ||
+        skillKey === OKR_MANAGEMENT_LOCAL ||
+        server === OKR_MANAGEMENT_SERVER ||
+        skillKey === OKR_LOCAL ||
+        server === OKR_SERVER ||
+        skillKey === DAILY_REPORT_LOCAL ||
+        server === DAILY_REPORT_SERVER ||
+        skillKey === DEV_MANAGEMENT_LOCAL ||
+        server === DEV_MANAGEMENT_SERVER ||
+        skillKey === DEALER_OPS);
+}
+function isDailyReportServiceSkill(skillKey) {
+    const server = resolveServerSkillKey(skillKey);
+    return skillKey === DAILY_REPORT_LOCAL || server === DAILY_REPORT_SERVER;
+}
+function isOkrServiceSkill(skillKey) {
+    const server = resolveServerSkillKey(skillKey);
+    return (skillKey === OKR_MANAGEMENT_LOCAL ||
+        server === OKR_MANAGEMENT_SERVER ||
+        skillKey === OKR_LOCAL ||
+        server === OKR_SERVER);
+}
+function isDevManagementServiceSkill(skillKey) {
+    const server = resolveServerSkillKey(skillKey);
+    return skillKey === DEV_MANAGEMENT_LOCAL || server === DEV_MANAGEMENT_SERVER;
+}
+function vpsServiceRequestLabel(skillKey, scriptKey) {
+    if (isDailyReportServiceSkill(skillKey)) {
+        return scriptKey ? `Vertu 日报（${scriptKey}）` : 'Vertu 日报查询';
+    }
+    if (isDevManagementServiceSkill(skillKey)) {
+        return scriptKey ? `Vertu 研发任务（${scriptKey}）` : 'Vertu 研发任务查询';
+    }
+    if (isOkrServiceSkill(skillKey)) {
+        return scriptKey ? `Vertu OKR（${scriptKey}）` : 'Vertu OKR 查询';
+    }
+    if (skillKey === HR_COMPENSATION_LOCAL ||
+        resolveServerSkillKey(skillKey) === HR_COMPENSATION_SERVER) {
+        return 'Vertu 薪酬查询';
+    }
+    if (skillKey === PERSONNEL_LOCAL ||
+        resolveServerSkillKey(skillKey) === PERSONNEL_SERVER) {
+        return 'Vertu 销售人效查询';
+    }
+    return 'Vertu 数据查询';
+}
+async function parseJsonBody(res, requestLabel) {
+    const text = await res.body.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        const preview = text.replace(/\s+/g, ' ').trim().slice(0, 240);
+        const detail = preview ? `：${preview}` : '';
+        throw new VertuError(`${requestLabel} 返回非 JSON（HTTP ${res.statusCode}）${detail}`);
+    }
+}
+export async function vpsServiceHealth(serviceBaseUrl) {
+    const base = resolveVpsServiceUrl(serviceBaseUrl);
+    const label = 'Vertu 服务';
+    const res = await request(`${base}/health`, {
+        method: 'GET',
+        headers: serviceHeaders(base, { 'x-vertu-request-kind': 'health' }),
+    });
+    const data = await parseJsonBody(res, label);
+    if (res.statusCode >= 400) {
+        throw new VertuError(`${label} /health 失败：HTTP ${res.statusCode}`);
+    }
+    return data;
+}
+/** @deprecated 使用 {@link vpsServiceHealth} */
+export async function salesQueryHealth(serviceBaseUrl) {
+    return vpsServiceHealth(serviceBaseUrl);
+}
+/**
+ * 服务端支持该脚本时返回 result；否则 null（可走 Odoo execute）。
+ */
+export async function tryVpsServiceExecute(skillKey, scriptKey, params, serviceBaseUrl) {
+    const base = resolveVpsServiceUrl(serviceBaseUrl);
+    if (!base || !isVpsServiceSkill(skillKey)) {
+        return null;
+    }
+    const requestLabel = vpsServiceRequestLabel(skillKey, scriptKey);
+    const serverSkillKey = resolveServerSkillKey(skillKey);
+    const res = await request(`${base}/v1/execute`, {
+        method: 'POST',
+        headers: serviceHeaders(base, {
+            'x-vertu-request-kind': 'execute',
+            'x-vertu-skill-key': serverSkillKey,
+            'x-vertu-script-key': scriptKey,
+        }),
+        body: JSON.stringify({
+            skill_key: serverSkillKey,
+            script_key: scriptKey,
+            params,
+        }),
+    });
+    const data = await parseJsonBody(res, requestLabel);
+    if (res.statusCode === 404) {
+        return null;
+    }
+    if (res.statusCode >= 400) {
+        const errMsg = data && typeof data === 'object' && 'error' in data
+            ? publicBusinessErrorMessage(data.error)
+            : `HTTP ${res.statusCode}`;
+        throw new VertuError(`${requestLabel} 失败：${errMsg}${errMsg === 'Unauthorized'
+            ? `（Agent/Bot/Hermes 请检查宿主注入的 app_key；仅人工用户可交互执行 \`vps-work auth login\`）`
+            : ''}`);
+    }
+    if (data && typeof data === 'object' && 'result' in data) {
+        return publicBusinessResult(data.result);
+    }
+    return publicBusinessResult(data);
+}
+/** 通用执行：按 catalog 给出的 skill_key/script_key 直打 /v1/execute，不改写键名。 */
+export async function executeVpsServiceScript(skillKey, scriptKey, params, serviceBaseUrl) {
+    const base = resolveVpsServiceUrl(serviceBaseUrl);
+    const requestLabel = `execute ${skillKey}/${scriptKey}`;
+    const res = await request(`${base}/v1/execute`, {
+        method: 'POST',
+        headers: serviceHeaders(base, {
+            'x-vertu-request-kind': 'execute',
+            'x-vertu-skill-key': skillKey,
+            'x-vertu-script-key': scriptKey,
+        }),
+        body: JSON.stringify({
+            skill_key: skillKey,
+            script_key: scriptKey,
+            params,
+        }),
+    });
+    const data = await parseJsonBody(res, requestLabel);
+    if (res.statusCode >= 400) {
+        const errMsg = data && typeof data === 'object' && 'error' in data
+            ? publicBusinessErrorMessage(data.error)
+            : `HTTP ${res.statusCode}`;
+        throw new VertuError(`${requestLabel} 失败：${errMsg}`);
+    }
+    if (data && typeof data === 'object' && 'result' in data) {
+        return publicBusinessResult(data.result);
+    }
+    return publicBusinessResult(data);
+}
+/** @deprecated 使用 {@link tryVpsServiceExecute} */
+export async function trySalesQueryExecute(skillKey, scriptKey, params, serviceBaseUrl) {
+    return tryVpsServiceExecute(skillKey, scriptKey, params, serviceBaseUrl);
+}
+/**
+ * 直连 vps-service 的 REST GET 路由（区别于 `/v1/execute` 脚本通道）。
+ * 用于 meeting-center 等已由服务直连数据库实现的接口。
+ */
+export async function vpsServiceGet(path, query, serviceBaseUrl, requestLabel = 'Vertu 服务') {
+    const base = resolveVpsServiceUrl(serviceBaseUrl);
+    const qs = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined && `${value}`.trim() !== '') {
+            qs.set(key, `${value}`);
+        }
+    }
+    const suffix = qs.toString() ? `?${qs.toString()}` : '';
+    const res = await request(`${base}${path}${suffix}`, {
+        method: 'GET',
+        headers: serviceHeaders(base, {
+            'x-vertu-request-kind': 'rest',
+            'x-vertu-rest-path': path,
+        }),
+    });
+    const data = await parseJsonBody(res, requestLabel);
+    if (res.statusCode === 401) {
+        throw new VertuError(`${requestLabel} 失败：Unauthorized（Agent/Bot/Hermes 请检查宿主注入的 app_key；仅人工用户可交互登录）`);
+    }
+    if (res.statusCode >= 400) {
+        const errMsg = data && typeof data === 'object' && 'error' in data
+            ? publicBusinessErrorMessage(data.error)
+            : `HTTP ${res.statusCode}`;
+        throw new VertuError(`${requestLabel} 失败：${errMsg}`);
+    }
+    return data;
+}
+/**
+ * 直连 vps-service 的 REST POST 路由（区别于 `/v1/execute` 脚本通道与 GET）。
+ * 用于 creative（创意工坊生图/生视频/生音频）等由服务直连实现的写接口。
+ */
+export async function vpsServicePost(path, body, serviceBaseUrl, requestLabel = 'Vertu 服务') {
+    const base = resolveVpsServiceUrl(serviceBaseUrl);
+    const res = await request(`${base}${path}`, {
+        method: 'POST',
+        headers: serviceHeaders(base, {
+            'x-vertu-request-kind': 'rest',
+            'x-vertu-rest-path': path,
+        }),
+        body: JSON.stringify(body),
+    });
+    const data = await parseJsonBody(res, requestLabel);
+    if (res.statusCode === 401) {
+        throw new VertuError(`${requestLabel} 失败：Unauthorized（Agent/Bot/Hermes 请检查宿主注入的 app_key；仅人工用户可交互登录）`);
+    }
+    if (res.statusCode >= 400) {
+        throw new VertuError(`${requestLabel} 失败：${extractRemoteErrorMessage(data, res.statusCode)}`);
+    }
+    return data;
+}
+/** 直连 vps-service 的 multipart/form-data POST，供上传类公共工具复用。 */
+export async function vpsServiceMultipartPost(path, body, serviceBaseUrl, requestLabel = 'Vertu 服务') {
+    const base = resolveVpsServiceUrl(serviceBaseUrl);
+    const res = await request(`${base}${path}`, {
+        method: 'POST',
+        headers: vpsServiceAuthHeaders(base),
+        body,
+    });
+    const data = await parseJsonBody(res, requestLabel);
+    if (res.statusCode === 401) {
+        throw new VertuError(`${requestLabel} 失败：Unauthorized（Agent/Bot/Hermes 请检查宿主注入的 app_key；仅人工用户可交互登录）`);
+    }
+    if (res.statusCode >= 400) {
+        throw new VertuError(`${requestLabel} 失败：${extractRemoteErrorMessage(data, res.statusCode)}`);
+    }
+    return data;
+}
+/** 兼容创意工坊等接口两种错误形态：`{error:"..."}` 与 `{error:{message:"..."}}`。 */
+function extractRemoteErrorMessage(data, statusCode) {
+    if (data && typeof data === 'object' && 'error' in data) {
+        const error = data.error;
+        if (typeof error === 'string' && error.trim()) {
+            return error;
+        }
+        if (error && typeof error === 'object' && 'message' in error) {
+            const message = error.message;
+            if (typeof message === 'string' && message.trim()) {
+                return message;
+            }
+        }
+        if (error !== null && error !== undefined) {
+            return String(error);
+        }
+    }
+    return `HTTP ${statusCode}`;
+}
+export async function runVpsServiceDataView(viewId, filters, optionsOrLimit, serviceBaseUrl) {
+    const base = resolveVpsServiceUrl(serviceBaseUrl);
+    const options = typeof optionsOrLimit === 'number'
+        ? { limit: optionsOrLimit }
+        : (optionsOrLimit ?? {});
+    const res = await request(`${base}/v1/data-view/query`, {
+        method: 'POST',
+        headers: serviceHeaders(base, {
+            'x-vertu-request-kind': 'data-view',
+            'x-vertu-data-view-id': viewId,
+        }),
+        body: JSON.stringify({
+            view_id: viewId,
+            filters,
+            ...(options.limit !== undefined ? { limit: options.limit } : {}),
+            ...(options.page !== undefined ? { page: options.page } : {}),
+            ...(options.pageSize !== undefined ? { page_size: options.pageSize } : {}),
+            ...(options.groupBy ? { group_by: options.groupBy } : {}),
+        }),
+    });
+    const data = await parseJsonBody(res, 'Vertu 数据视图');
+    if (res.statusCode >= 400) {
+        const errMsg = data && typeof data === 'object' && 'error' in data
+            ? publicBusinessErrorMessage(data.error)
+            : `HTTP ${res.statusCode}`;
+        throw new VertuError(`Vertu 数据视图查询失败：${errMsg}`, { statusCode: res.statusCode });
+    }
+    if (data && typeof data === 'object' && 'result' in data) {
+        return publicBusinessResult(data.result);
+    }
+    return publicBusinessResult(data);
+}
+/** @deprecated 使用 {@link runVpsServiceDataView} */
+export async function runSalesQueryDataView(viewId, filters, limit, serviceBaseUrl) {
+    return runVpsServiceDataView(viewId, filters, limit, serviceBaseUrl);
+}

package/dist/packages/vps-work/src/core/skill-catalog.js

@@ -0,0 +1,158 @@
+import { cp, readFile, readdir, rm, stat } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { VertuError } from './errors.js';
+import { packageRootDir, packageSkillsDir } from './paths.js';
+export const AGENT_TARGETS = [
+    { id: 'cursor', rootName: '.cursor', aliases: [] },
+    { id: 'claude-code', rootName: '.claude', aliases: ['claude'] },
+    { id: 'trae', rootName: '.trae', aliases: [] },
+    { id: 'trae-cn', rootName: '.trae-cn', aliases: [] },
+    { id: 'openclaw', rootName: '.openclaw', aliases: ['open-claw', 'claw'] },
+    { id: 'hermes', rootName: '.hermes', aliases: ['hermes-agent', 'nous'] },
+];
+/** `skills/<key>/SKILL.md` 内 frontmatter 的 description（取首个 description 行/块）。 */
+function parseFrontmatterDescription(md) {
+    const match = /^---\s*\n([\s\S]*?)\n---/.exec(md);
+    if (!match) {
+        return '';
+    }
+    const body = match[1] ?? '';
+    const line = /^description:\s*(.+)$/m.exec(body);
+    if (!line) {
+        return '';
+    }
+    const raw = (line[1] ?? '').trim();
+    if (raw === '|' || raw === '>') {
+        const block = new RegExp('^description:\\s*[|>]\\s*\\n([\\s\\S]*?)(?=\\n\\S|$)', 'm').exec(body);
+        return (block?.[1] ?? '')
+            .split('\n')
+            .map((l) => l.trim())
+            .filter(Boolean)
+            .join(' ');
+    }
+    return raw.replace(/^["']|["']$/g, '').trim();
+}
+/**
+ * 扫描包内 `skills/` 下所有含 `SKILL.md` 的目录，组成公开 skill 目录。
+ * 不依赖任何远端服务或登录态。
+ */
+export async function loadPublicSkills() {
+    const root = packageSkillsDir();
+    let entries;
+    try {
+        entries = await readdir(root);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new VertuError(`未找到包内 skills 目录：${root}（包安装可能不完整）。`);
+        }
+        throw err;
+    }
+    const skills = [];
+    for (const name of entries.sort()) {
+        const sourceDir = join(root, name);
+        const skillFile = join(sourceDir, 'SKILL.md');
+        try {
+            const info = await stat(skillFile);
+            if (!info.isFile()) {
+                continue;
+            }
+        }
+        catch {
+            continue;
+        }
+        const md = await readFile(skillFile, 'utf8');
+        skills.push({ key: name, description: parseFrontmatterDescription(md), sourceDir });
+    }
+    return skills;
+}
+/** 把 `--agent` 输入（id/别名，逗号或空格分隔；`all` 表示全部）解析为目标列表。 */
+export function resolveAgentTargets(input) {
+    if (!input?.trim()) {
+        return [];
+    }
+    const tokens = input
+        .split(/[,\s]+/)
+        .map((t) => t.trim().toLowerCase())
+        .filter(Boolean);
+    if (tokens.includes('all')) {
+        return [...AGENT_TARGETS];
+    }
+    const resolved = [];
+    for (const token of tokens) {
+        const hit = AGENT_TARGETS.find((t) => t.id === token || t.aliases.includes(token));
+        if (!hit) {
+            throw new VertuError(`未知 --agent "${token}"。可用：${AGENT_TARGETS.map((t) => t.id).join(', ')}, all。`);
+        }
+        if (!resolved.some((t) => t.id === hit.id)) {
+            resolved.push(hit);
+        }
+    }
+    return resolved;
+}
+function agentSkillsRoot(target) {
+    return join(homedir(), target.rootName, 'skills');
+}
+/** HOME 下已存在根目录（`~/.cursor` 等）的 Agent —— 视为"用户在用"。 */
+export async function detectInstalledAgents() {
+    const found = [];
+    for (const target of AGENT_TARGETS) {
+        try {
+            const info = await stat(join(homedir(), target.rootName));
+            if (info.isDirectory()) {
+                found.push(target);
+            }
+        }
+        catch {
+            // 根目录不存在 → 用户未使用该 Agent，跳过
+        }
+    }
+    return found;
+}
+export function resolveDestinations(targets, dirs) {
+    const dests = [];
+    const seen = new Set();
+    const push = (label, skillsRoot) => {
+        if (seen.has(skillsRoot)) {
+            return;
+        }
+        seen.add(skillsRoot);
+        dests.push({ label, skillsRoot });
+    };
+    for (const target of targets) {
+        push(target.id, agentSkillsRoot(target));
+    }
+    for (const raw of dirs) {
+        const expanded = raw.trim().startsWith('~')
+            ? join(homedir(), raw.trim().slice(1).replace(/^[\\/]/, ''))
+            : raw.trim();
+        if (expanded) {
+            push(`dir:${expanded}`, expanded);
+        }
+    }
+    return dests;
+}
+/** 把单个公开 skill 递归拷贝到目的地 `<skillsRoot>/<key>/`（覆盖式同步）。 */
+export async function copySkillTo(skill, skillsRoot) {
+    const dest = join(skillsRoot, skill.key);
+    await rm(dest, { recursive: true, force: true });
+    await cp(skill.sourceDir, dest, { recursive: true });
+    return dest;
+}
+/** 从目的地移除某个 skill 目录；返回是否真的删除过。 */
+export async function removeSkillFrom(key, skillsRoot) {
+    const dest = join(skillsRoot, key);
+    try {
+        await stat(dest);
+    }
+    catch {
+        return false;
+    }
+    await rm(dest, { recursive: true, force: true });
+    return true;
+}
+/** 包根目录（供 install 提示用户公开 skill 源位置）。 */
+export function publicSkillsSourceRoot() {
+    return join(packageRootDir(), 'skills');
+}

package/dist/packages/vps-work/src/core/skill-key.js

@@ -0,0 +1,19 @@
+/**
+ * 仓库与文档使用 vps-*；遗留 Odoo execute 仍多为 odoo-*，在此统一映射。
+ */
+const LOCAL_TO_SERVER = {
+    'vps-domain-skill-creator': 'odoo-vps-domain-skill-creator',
+    'vps-store-management': 'vps-store-management',
+    'vps-dealer-ops': 'vps-dealer-ops',
+};
+/** 传给 /ai/skills/v1/execute 等 API 的 skill_key */
+export function resolveServerSkillKey(localKey) {
+    const aliased = LOCAL_TO_SERVER[localKey];
+    if (aliased) {
+        return aliased;
+    }
+    if (localKey.startsWith('vps-')) {
+        return `odoo-${localKey.slice(4)}`;
+    }
+    return localKey;
+}