@remixmate/cli 0.9.72 → 0.9.73

package/dist/install.js

@@ -1,448 +1,40 @@
-/**
- * `remixmate install` / `remixmate uninstall` — 把包内 skills/ 铺进 agent 宿主。
- *
- * 为什么需要一条命令，而不是让站点给出 `cp -R "$(npm root -g)/…/skills/." ~/.claude/skills/`：
- *
- *   1. 目标已经不止一个。Claude Code 与 Codex 现在用同一套 SKILL.md 格式
- *      （Codex 装到 $CODEX_HOME/skills/<name>），手工 cp 的心智成本直接翻倍。
- *   2. 拷贝出去的副本没有主人。`npm update -g` 之后包升了级、副本停在旧版；
- *      `npm uninstall -g` 之后副本原地变成孤儿。两种都是静默的 —— 本项目作者机器上
- *      就留着一批 5 月建的、指向早已不存在路径的 skill 目录，没有任何东西负责清理。
- *
- * 所以这里的安装是**受管**的：每个宿主的 skills 目录下写一份装机回执
- * (.remixmate-install.json)，记下版本、来源与这次铺下去的 skill 名单。升级照名单
- * 覆盖、卸载照名单删除、doctor 照名单比对版本 —— 三件事都不靠猜目录里哪些是我们的。
- *
- * 刻意不做的两件事：
- *   - 不挂 npm postinstall。`npm i -g` 时往 ~/.claude、~/.codex 写东西太越界，
- *     且 `--ignore-scripts` 下会静默失效。安装必须是用户显式发起的动作。
- *   - 不用软链。指向 $(npm root -g) 看着优雅，但 node 版本管理器一切换路径就变，
- *     全部断掉且极难排查。拷贝 + 回执 + doctor 漂移检查更稳。
- */
-import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { SKILLS_DIR } from './registry.js';
-import { EXIT } from './errors.js';
-import { padDisplay } from './text.js';
-export const INSTALL_VERB = 'install';
-export const UNINSTALL_VERB = 'uninstall';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PKG_ROOT = path.resolve(__dirname, '..');
-/** 装机回执。升级 / 卸载 / 漂移检查都只认它。 */
-const RECEIPT = '.remixmate-install.json';
-const PACKAGE_NAME = '@remixmate/cli';
-/**
- * 支持的 agent 宿主。
- *
- * 共同点是 skill 的格式：`<某个目录>/skills/<name>/SKILL.md`，frontmatter 都是
- * name + description —— 一份 skills/ 能喂给所有宿主。这张表记的是各家把那个「某个
- * 目录」放在哪、能不能被环境变量改、有没有用户级 / 项目级。
- *
- * 每一条的依据：
- *   - Claude Code / Codex：各自的官方安装位置（Codex 见其内置 skill-installer，
- *     原话是装到 $CODEX_HOME/skills）。
- *   - WorkBuddy / CodeBuddy：WorkBuddy 内置的 find-skills skill 给了两条路径,
- *     它按 __CFBundleIdentifier 区分。这里不做那个区分 —— 检测到哪个装哪个,
- *     两个都在就都装,比猜「当前跑在哪个客户端里」稳。
- *   - Trae：内置的 skill-creator skill 只给了一个位置 —— 工作区的
- *     `.trae/skills/<name>/`。注意它的应用数据目录叫 ~/.trae-cn(国内版),
- *     跟 skill 目录名 .trae 不是一个东西,而且 ~/.trae-cn/skills 并不存在。
- *     没有任何证据表明存在用户级位置,所以 userDirName 留空:Trae 只能项目级装。
- */
-const HOSTS = [
-    {
-        id: 'claude',
-        label: 'Claude Code',
-        detectDirNames: ['.claude'],
-        homeEnv: 'CLAUDE_CONFIG_DIR',
-        userDirName: '.claude',
-        projectDirName: '.claude',
-    },
-    {
-        id: 'codex',
-        label: 'Codex',
-        detectDirNames: ['.codex'],
-        homeEnv: 'CODEX_HOME',
-        userDirName: '.codex',
-    },
-    {
-        id: 'workbuddy',
-        label: 'WorkBuddy',
-        detectDirNames: ['.workbuddy'],
-        userDirName: '.workbuddy',
-        projectDirName: '.workbuddy',
-    },
-    {
-        id: 'codebuddy',
-        label: 'CodeBuddy',
-        detectDirNames: ['.codebuddy'],
-        userDirName: '.codebuddy',
-        projectDirName: '.codebuddy',
-    },
-    {
-        id: 'trae',
-        // Trae CN 与 TraeWork CN（安装出来叫 TRAE SOLO CN.app，bundle id cn.trae.solo.app）
-        // 共用 ~/.trae-cn —— 后者的内置 skill(dynamic-ui 等)就躺在那底下的
-        // builtin/*/skills/，所以一条 host 覆盖两个客户端。
-        label: 'Trae / TraeWork',
-        detectDirNames: ['.trae-cn', '.trae'],
-        projectDirName: '.trae',
-    },
-];
-const HOST_IDS = HOSTS.map((h) => h.id);
-function spec(id) {
-    return HOSTS.find((h) => h.id === id);
-}
-/**
- * 用户级 skills 目录；宿主没有用户级位置时返回 null。声明了环境变量的宿主要跟着
- * 变量走 —— 否则把 CODEX_HOME 指到别处的用户会看到「未检测到 Codex」。
- */
-function userSkillsDir(id) {
-    const h = spec(id);
-    if (!h.userDirName)
-        return null;
-    const override = h.homeEnv ? process.env[h.homeEnv] : undefined;
-    return path.join(override || path.join(os.homedir(), h.userDirName), 'skills');
-}
-/** 检测用的候选目录 —— 存在任意一个就算这台机器上装了这个 agent。 */
-function detectDirs(id) {
-    const h = spec(id);
-    const override = h.homeEnv ? process.env[h.homeEnv] : undefined;
-    if (override)
-        return [override];
-    return h.detectDirNames.map((d) => path.join(os.homedir(), d));
-}
-function isInstalled(id) {
-    return detectDirs(id).some((d) => existsSync(d));
-}
-function hostOf(id) {
-    const dir = userSkillsDir(id);
-    return dir ? { id, label: spec(id).label, skillsDir: dir } : null;
-}
-/** 项目级安装目标：当前目录下的 ./<projectDirName>/skills。 */
-function projectHostOf(id) {
-    const h = spec(id);
-    if (!h.projectDirName)
-        return null;
-    return {
-        id,
-        label: `${h.label}（项目级）`,
-        skillsDir: path.join(process.cwd(), h.projectDirName, 'skills'),
-    };
-}
-/** 已检测到、且**有用户级位置**的宿主。 */
-export function detectHosts() {
-    return HOST_IDS.filter(isInstalled)
-        .map(hostOf)
-        .filter((h) => h !== null);
-}
-/**
- * 检测到了、但只能项目级安装的宿主（当前只有 Trae）。
- *
- * 单独拎出来是为了别把它们**静默**跳过：用户装了 Trae 却在全局 install 的输出里
- * 完全看不到它，只会以为这个 CLI 不支持 —— 正是这次 WorkBuddy 的翻车方式。
- */
-export function projectOnlyHosts() {
-    return HOST_IDS.filter((id) => isInstalled(id) && !spec(id).userDirName);
-}
-export function packageVersion() {
-    try {
-        const raw = readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf-8');
-        return JSON.parse(raw).version ?? 'unknown';
-    }
-    catch {
-        return 'unknown';
-    }
-}
-/**
- * 包内可安装的 skill 名单。
- *
- * 用 SKILLS_DIR 而不是 resolveBaseDir()：install 铺的永远是**本包自带**的那份，
- * SKILL_BASE_DIR 是给 ab-agent 之类宿主在运行期改 skill 树用的，不该改变安装来源。
- */
-function bundledSkills() {
-    if (!existsSync(SKILLS_DIR))
-        return [];
-    return readdirSync(SKILLS_DIR, { withFileTypes: true })
-        .filter((e) => e.isDirectory() && existsSync(path.join(SKILLS_DIR, e.name, 'SKILL.md')))
-        .map((e) => e.name)
-        .sort();
-}
-function readReceipt(skillsDir) {
-    const file = path.join(skillsDir, RECEIPT);
-    if (!existsSync(file))
-        return null;
-    try {
-        return JSON.parse(readFileSync(file, 'utf-8'));
-    }
-    catch {
-        // 回执损坏时按「没装过」处理:那样只会退化成需要 --force,而不是把用户的目录删错。
-        return null;
-    }
-}
-const nonNull = (h) => h !== null;
-function parseArgs(argv, verb) {
-    const out = { hosts: [], force: false, help: false };
-    const picked = [];
-    let all = false;
-    let dir = '';
-    let project = false;
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        const eq = a.indexOf('=');
-        const key = eq > 0 ? a.slice(0, eq) : a;
-        const inline = eq > 0 ? a.slice(eq + 1) : null;
-        const next = () => inline ?? argv[++i] ?? '';
-        switch (key) {
-            case '--host': {
-                const v = next();
-                // `all` 是「所有**适用**的宿主」，不是「表里每一行」—— 展开成后者会让
-                // `--host all` 撞上 Trae 这种只有项目级的宿主而整条命令失败。
-                if (v === 'all')
-                    all = true;
-                else if (HOST_IDS.includes(v))
-                    picked.push(v);
-                else {
-                    out.error = `未知参数: --host ${v}`;
-                    return out;
-                }
-                break;
-            }
-            case '--dir':
-                dir = next();
-                break;
-            case '--project':
-                project = true;
-                break;
-            case '--force':
-                out.force = true;
-                break;
-            case '-h':
-            case '--help':
-                out.help = true;
-                return out;
-            default:
-                out.error = `未知参数: ${a}`;
-                return out;
-        }
-    }
-    if (dir) {
-        out.hosts = [{ id: 'custom', label: '自定义目录', skillsDir: path.resolve(dir) }];
-        return out;
-    }
-    if (project) {
-        // Codex 的官方安装位置只有 $CODEX_HOME/skills（见其内置 skill-installer），
-        // 没有项目级约定,不臆造一个 —— 点名 --host codex --project 直接报错,
-        // 不声不响装到一个宿主永远不会读的目录才是最糟的。
-        const chosen = all
-            ? HOST_IDS.filter((id) => spec(id).projectDirName)
-            : picked.length > 0
-                ? [...new Set(picked)]
-                : HOST_IDS.filter((id) => isInstalled(id) && spec(id).projectDirName);
-        const unsupported = chosen.filter((id) => !spec(id).projectDirName);
-        if (unsupported.length > 0) {
-            out.error = `${unsupported.map((id) => spec(id).label).join('、')} 没有项目级 skill 目录，不能和 --project 一起用`;
-            return out;
-        }
-        out.hosts = chosen.map(projectHostOf).filter(nonNull);
-        return out;
-    }
-    if (all) {
-        out.hosts = HOST_IDS.map(hostOf).filter(nonNull);
-        return out;
-    }
-    if (picked.length > 0) {
-        const chosen = [...new Set(picked)];
-        // 点名了一个只有项目级的宿主(Trae)却没给 --project:报错而不是默默装到别处。
-        const userless = chosen.filter((id) => !spec(id).userDirName);
-        if (userless.length > 0) {
-            out.error =
-                `${userless.map((id) => spec(id).label).join('、')} 只有项目级 skill 目录 —— ` +
-                    '进到项目根目录后加 --project 重跑。';
-            return out;
-        }
-        out.hosts = chosen.map(hostOf).filter(nonNull);
-    }
-    else {
-        // 卸载时不做检测:配置目录可能已经随 agent 一起被删掉,而我们铺出去的副本还在。
-        out.hosts = verb === UNINSTALL_VERB ? HOST_IDS.map(hostOf).filter(nonNull) : detectHosts();
-    }
-    return out;
-}
-export function installUsage() {
-    process.stdout.write('Usage: remixmate install [options]\n' +
-        '\n' +
-        '把本包自带的 skill 装进已检测到的 agent 宿主，让它们能自动发现这些能力。\n' +
-        '重复运行即升级。支持的宿主：\n' +
-        HOSTS.map((h) => `  ${padDisplay(h.label, 14)}${h.userDirName ? `~/${h.userDirName}/skills` : '（仅项目级）'}${h.projectDirName ? `   项目级 ./${h.projectDirName}/skills` : ''}\n`).join('') +
-        '\n' +
-        'Options:\n' +
-        `  --host <${HOST_IDS.join('|')}|all>\n` +
-        '                             只装指定宿主（默认：装到所有检测到的宿主）\n' +
-        '  --project                  装到当前目录 ./<配置目录>/skills（Codex 不支持）\n' +
-        '  --dir <path>               自定义 skills 父目录（覆盖上面两者）\n' +
-        '  --force                    覆盖同名的、非本 CLI 安装的 skill 目录\n');
-}
-export function uninstallUsage() {
-    process.stdout.write('Usage: remixmate uninstall [options]\n' +
-        '\n' +
-        '按装机回执删除本 CLI 装过的 skill —— 只删回执里列出的目录，不碰其它 skill。\n' +
-        '\n' +
-        'Options:\n' +
-        `  --host <${HOST_IDS.join('|')}|all>\n` +
-        '                             只卸载指定宿主（默认：所有宿主都查）\n' +
-        '  --project                  卸载当前目录 ./.claude/skills 下的安装\n' +
-        '  --dir <path>               自定义 skills 父目录\n');
-}
-function installInto(host, names, version, force) {
-    const prev = readReceipt(host.skillsDir);
-    const owned = new Set(prev?.skills ?? []);
-    // 目录已存在、又不在上一次的回执里 —— 那是别人的 skill(同名很容易撞:gen-image
-    // 这种名字一点也不独特)。默认拒绝而不是覆盖,让用户显式 --force。
-    const conflicts = names.filter((n) => existsSync(path.join(host.skillsDir, n)) && !owned.has(n));
-    if (conflicts.length > 0 && !force) {
-        return (`${host.skillsDir} 下已存在同名目录，且不是本 CLI 装的：${conflicts.join('、')}\n` +
-            '   确认可以覆盖后加 --force 重跑。');
-    }
-    mkdirSync(host.skillsDir, { recursive: true });
-    // 上一版装过、这一版没有了的 skill（上游改名或下线）要一并清掉，否则宿主会一直
-    // 加载一个已经没有后端支撑的 SKILL.md。
-    for (const stale of owned) {
-        if (!names.includes(stale))
-            rmSync(path.join(host.skillsDir, stale), { recursive: true, force: true });
-    }
-    for (const name of names) {
-        const dest = path.join(host.skillsDir, name);
-        // 先删再拷:直接覆盖会把上一版多出来的文件留在原地,攒出一个既非旧版也非新版的目录。
-        rmSync(dest, { recursive: true, force: true });
-        cpSync(path.join(SKILLS_DIR, name), dest, { recursive: true });
-    }
-    const receipt = {
-        package: PACKAGE_NAME,
-        version,
-        installedAt: new Date().toISOString(),
-        source: SKILLS_DIR,
-        skills: names,
-    };
-    writeFileSync(path.join(host.skillsDir, RECEIPT), JSON.stringify(receipt, null, 2) + '\n', 'utf-8');
-    return null;
-}
-export function runInstall(argv) {
-    const opts = parseArgs(argv, INSTALL_VERB);
-    if (opts.help) {
-        installUsage();
-        return EXIT.OK;
-    }
-    if (opts.error) {
-        process.stderr.write(`❌ ${opts.error}\n`);
-        installUsage();
-        return EXIT.USAGE;
-    }
-    const names = bundledSkills();
-    if (names.length === 0) {
-        process.stderr.write(`❌ 包内没有可安装的 skill（${SKILLS_DIR}）\n`);
-        return EXIT.ERROR;
-    }
-    const projectOnly = projectOnlyHosts();
-    if (opts.hosts.length === 0) {
-        // 只检测到项目级宿主(比如只装了 Trae)时,这不是「没检测到」,而是「装法不同」。
-        if (projectOnly.length > 0) {
-            process.stderr.write(`❌ 只检测到 ${projectOnly.map((id) => spec(id).label).join('、')}，` +
-                '它只有项目级 skill 目录。\n' +
-                '   进到项目根目录后运行：remixmate install --project\n');
-            return EXIT.USAGE;
-        }
-        process.stderr.write('❌ 没有检测到任何 agent 宿主。找过这些位置：\n' +
-            HOST_IDS.map((id) => `     ${padDisplay(spec(id).label, 14)}${detectDirs(id).join('、')}\n`).join('') +
-            '   先把 agent 装好再重跑，或用 --dir <path> 指定目录。\n');
-        return EXIT.USAGE;
-    }
-    const version = packageVersion();
-    let failures = 0;
-    for (const host of opts.hosts) {
-        const err = installInto(host, names, version, opts.force);
-        if (err) {
-            failures += 1;
-            process.stderr.write(`❌ ${padDisplay(host.label, 16)}${err}\n`);
-            continue;
-        }
-        process.stdout.write(`✅ ${padDisplay(host.label, 16)}${host.skillsDir}（${names.length} 个 skill，${version}）\n`);
-    }
-    if (failures > 0)
-        return EXIT.ERROR;
-    // 检测到了但这一轮装不了的宿主要说出来 —— 静默跳过会让用户以为不支持。
-    if (projectOnly.length > 0 && !opts.hosts.some((h) => projectOnly.includes(h.id))) {
-        process.stdout.write(`\nℹ️  还检测到 ${projectOnly.map((id) => spec(id).label).join('、')}，` +
-            '它只有项目级 skill 目录 —— 在项目根目录里运行 remixmate install --project 即可。\n');
-    }
-    process.stdout.write('\n重启 agent 后即可生效。升级后重跑 remixmate install 覆盖即可。\n');
-    return EXIT.OK;
-}
-export function runUninstall(argv) {
-    const opts = parseArgs(argv, UNINSTALL_VERB);
-    if (opts.help) {
-        uninstallUsage();
-        return EXIT.OK;
-    }
-    if (opts.error) {
-        process.stderr.write(`❌ ${opts.error}\n`);
-        uninstallUsage();
-        return EXIT.USAGE;
-    }
-    let removed = 0;
-    for (const host of opts.hosts) {
-        const receipt = readReceipt(host.skillsDir);
-        if (!receipt)
-            continue;
-        for (const name of receipt.skills) {
-            rmSync(path.join(host.skillsDir, name), { recursive: true, force: true });
-        }
-        rmSync(path.join(host.skillsDir, RECEIPT), { force: true });
-        removed += 1;
-        process.stdout.write(`✅ ${padDisplay(host.label, 16)}已移除 ${receipt.skills.length} 个 skill（${host.skillsDir}）\n`);
-    }
-    if (removed === 0) {
-        process.stdout.write('没有找到本 CLI 的装机记录，无需卸载。\n');
-    }
-    return EXIT.OK;
-}
-/**
- * 供 doctor 使用：每个宿主的安装状态。
- *
- * 漂移是这套方案唯一的静默失败模式 —— `npm update -g` 只动包，不动铺出去的副本，
- * 用户会拿着旧 SKILL.md 打新后端。doctor 是「为什么跑不起来」的统一入口，检查放这里。
- */
-export function installStates() {
-    const current = packageVersion();
-    return detectHosts().map((h) => {
-        const receipt = readReceipt(h.skillsDir);
-        return {
-            label: h.label,
-            skillsDir: h.skillsDir,
-            installedVersion: receipt?.version ?? null,
-            currentVersion: current,
-            drifted: receipt != null && receipt.version !== current,
-        };
-    });
-}
-/**
- * 首次使用提示：检测到了宿主、但还没跑过 `remixmate install`（或装的是旧版）时返回一行提示，
- * 否则 null。
- *
- * 不用 postinstall 做这件事：npm 7+ 默认吞掉生命周期脚本的输出，而在安装期往用户家目录
- * 写文件太侵入。改为在用户/agent 一定会看到的地方（--list、--help 页脚、template init 的
- * 下一步、doctor）提示。纯本地读文件，不发网络请求。
- */
-export function skillInstallHint(states = installStates()) {
-    const missing = states.filter((s) => s.installedVersion == null).map((s) => s.label);
-    const drifted = states.filter((s) => s.drifted).map((s) => s.label);
-    if (missing.length > 0) {
-        return `💡 检测到 ${missing.join('、')}，但还没装 skill → 运行 remixmate install，重启 agent 后它才能自动发现 RemixMate 的能力`;
-    }
-    if (drifted.length > 0) {
-        return `💡 ${drifted.join('、')} 里的 skill 是旧版本 → 运行 remixmate install 覆盖`;
-    }
-    return null;
-}
+var K=Object.defineProperty;var s=(e,r)=>K(e,"name",{value:r,configurable:!0});import{cpSync as G,existsSync as D,mkdirSync as H,readdirSync as V,readFileSync as O,rmSync as b,writeFileSync as B}from"node:fs";import v from"node:os";import c from"node:path";import{fileURLToPath as F}from"node:url";import{SKILLS_DIR as k}from"./registry.js";import{EXIT as d}from"./errors.js";import{padDisplay as j}from"./text.js";const P="install",E="uninstall",J=c.dirname(F(import.meta.url)),M=c.resolve(J,".."),S=".remixmate-install.json",W="@remixmate/cli",w=[{id:"claude",label:"Claude Code",detectDirNames:[".claude"],homeEnv:"CLAUDE_CONFIG_DIR",userDirName:".claude",projectDirName:".claude"},{id:"codex",label:"Codex",detectDirNames:[".codex"],homeEnv:"CODEX_HOME",userDirName:".codex"},{id:"workbuddy",label:"WorkBuddy",detectDirNames:[".workbuddy"],userDirName:".workbuddy",projectDirName:".workbuddy"},{id:"codebuddy",label:"CodeBuddy",detectDirNames:[".codebuddy"],userDirName:".codebuddy",projectDirName:".codebuddy"},{id:"trae",label:"Trae / TraeWork",detectDirNames:[".trae-cn",".trae"],projectDirName:".trae"}],m=w.map(e=>e.id);function u(e){return w.find(r=>r.id===e)}s(u,"spec");function X(e){const r=u(e);if(!r.userDirName)return null;const t=r.homeEnv?process.env[r.homeEnv]:void 0;return c.join(t||c.join(v.homedir(),r.userDirName),"skills")}s(X,"userSkillsDir");function I(e){const r=u(e),t=r.homeEnv?process.env[r.homeEnv]:void 0;return t?[t]:r.detectDirNames.map(n=>c.join(v.homedir(),n))}s(I,"detectDirs");function x(e){return I(e).some(r=>D(r))}s(x,"isInstalled");function N(e){const r=X(e);return r?{id:e,label:u(e).label,skillsDir:r}:null}s(N,"hostOf");function q(e){const r=u(e);return r.projectDirName?{id:e,label:`${r.label}（项目级）`,skillsDir:c.join(process.cwd(),r.projectDirName,"skills")}:null}s(q,"projectHostOf");function R(){return m.filter(x).map(N).filter(e=>e!==null)}s(R,"detectHosts");function z(){return m.filter(e=>x(e)&&!u(e).userDirName)}s(z,"projectOnlyHosts");function C(){try{const e=O(c.join(M,"package.json"),"utf-8");return JSON.parse(e).version??"unknown"}catch{return"unknown"}}s(C,"packageVersion");function Q(){return D(k)?V(k,{withFileTypes:!0}).filter(e=>e.isDirectory()&&D(c.join(k,e.name,"SKILL.md"))).map(e=>e.name).sort():[]}s(Q,"bundledSkills");function g(e){const r=c.join(e,S);if(!D(r))return null;try{return JSON.parse(O(r,"utf-8"))}catch{return null}}s(g,"readReceipt");const $=s(e=>e!==null,"nonNull");function L(e,r){const t={hosts:[],force:!1,help:!1},n=[];let f=!1,p="",o=!1;for(let a=0;a<e.length;a++){const i=e[a],l=i.indexOf("="),T=l>0?i.slice(0,l):i,_=l>0?i.slice(l+1):null,y=s(()=>_??e[++a]??"","next");switch(T){case"--host":{const h=y();if(h==="all")f=!0;else if(m.includes(h))n.push(h);else return t.error=`未知参数: --host ${h}`,t;break}case"--dir":p=y();break;case"--project":o=!0;break;case"--force":t.force=!0;break;case"-h":case"--help":return t.help=!0,t;default:return t.error=`未知参数: ${i}`,t}}if(p)return t.hosts=[{id:"custom",label:"自定义目录",skillsDir:c.resolve(p)}],t;if(o){const a=f?m.filter(l=>u(l).projectDirName):n.length>0?[...new Set(n)]:m.filter(l=>x(l)&&u(l).projectDirName),i=a.filter(l=>!u(l).projectDirName);return i.length>0?(t.error=`${i.map(l=>u(l).label).join("、")} 没有项目级 skill 目录，不能和 --project 一起用`,t):(t.hosts=a.map(q).filter($),t)}if(f)return t.hosts=m.map(N).filter($),t;if(n.length>0){const a=[...new Set(n)],i=a.filter(l=>!u(l).userDirName);if(i.length>0)return t.error=`${i.map(l=>u(l).label).join("、")} 只有项目级 skill 目录 —— 进到项目根目录后加 --project 重跑。`,t;t.hosts=a.map(N).filter($)}else t.hosts=r===E?m.map(N).filter($):R();return t}s(L,"parseArgs");function A(){process.stdout.write(`Usage: remixmate install [options]
+
+把本包自带的 skill 装进已检测到的 agent 宿主，让它们能自动发现这些能力。
+重复运行即升级。支持的宿主：
+`+w.map(e=>`  ${j(e.label,14)}${e.userDirName?`~/${e.userDirName}/skills`:"（仅项目级）"}${e.projectDirName?`   项目级 ./${e.projectDirName}/skills`:""}
+`).join("")+`
+Options:
+  --host <${m.join("|")}|all>
+                             只装指定宿主（默认：装到所有检测到的宿主）
+  --project                  装到当前目录 ./<配置目录>/skills（Codex 不支持）
+  --dir <path>               自定义 skills 父目录（覆盖上面两者）
+  --force                    覆盖同名的、非本 CLI 安装的 skill 目录
+`)}s(A,"installUsage");function U(){process.stdout.write(`Usage: remixmate uninstall [options]
+
+按装机回执删除本 CLI 装过的 skill —— 只删回执里列出的目录，不碰其它 skill。
+
+Options:
+  --host <${m.join("|")}|all>
+                             只卸载指定宿主（默认：所有宿主都查）
+  --project                  卸载当前目录 ./.claude/skills 下的安装
+  --dir <path>               自定义 skills 父目录
+`)}s(U,"uninstallUsage");function Y(e,r,t,n){const f=g(e.skillsDir),p=new Set(f?.skills??[]),o=r.filter(i=>D(c.join(e.skillsDir,i))&&!p.has(i));if(o.length>0&&!n)return`${e.skillsDir} 下已存在同名目录，且不是本 CLI 装的：${o.join("、")}
+   确认可以覆盖后加 --force 重跑。`;H(e.skillsDir,{recursive:!0});for(const i of p)r.includes(i)||b(c.join(e.skillsDir,i),{recursive:!0,force:!0});for(const i of r){const l=c.join(e.skillsDir,i);b(l,{recursive:!0,force:!0}),G(c.join(k,i),l,{recursive:!0})}const a={package:W,version:t,installedAt:new Date().toISOString(),source:k,skills:r};return B(c.join(e.skillsDir,S),JSON.stringify(a,null,2)+`
+`,"utf-8"),null}s(Y,"installInto");function ce(e){const r=L(e,P);if(r.help)return A(),d.OK;if(r.error)return process.stderr.write(`❌ ${r.error}
+`),A(),d.USAGE;const t=Q();if(t.length===0)return process.stderr.write(`❌ 包内没有可安装的 skill（${k}）
+`),d.ERROR;const n=z();if(r.hosts.length===0)return n.length>0?(process.stderr.write(`❌ 只检测到 ${n.map(o=>u(o).label).join("、")}，它只有项目级 skill 目录。
+   进到项目根目录后运行：remixmate install --project
+`),d.USAGE):(process.stderr.write(`❌ 没有检测到任何 agent 宿主。找过这些位置：
+`+m.map(o=>`     ${j(u(o).label,14)}${I(o).join("、")}
+`).join("")+`   先把 agent 装好再重跑，或用 --dir <path> 指定目录。
+`),d.USAGE);const f=C();let p=0;for(const o of r.hosts){const a=Y(o,t,f,r.force);if(a){p+=1,process.stderr.write(`❌ ${j(o.label,16)}${a}
+`);continue}process.stdout.write(`✅ ${j(o.label,16)}${o.skillsDir}（${t.length} 个 skill，${f}）
+`)}return p>0?d.ERROR:(n.length>0&&!r.hosts.some(o=>n.includes(o.id))&&process.stdout.write(`
+ℹ️  还检测到 ${n.map(o=>u(o).label).join("、")}，它只有项目级 skill 目录 —— 在项目根目录里运行 remixmate install --project 即可。
+`),process.stdout.write(`
+重启 agent 后即可生效。升级后重跑 remixmate install 覆盖即可。
+`),d.OK)}s(ce,"runInstall");function ae(e){const r=L(e,E);if(r.help)return U(),d.OK;if(r.error)return process.stderr.write(`❌ ${r.error}
+`),U(),d.USAGE;let t=0;for(const n of r.hosts){const f=g(n.skillsDir);if(f){for(const p of f.skills)b(c.join(n.skillsDir,p),{recursive:!0,force:!0});b(c.join(n.skillsDir,S),{force:!0}),t+=1,process.stdout.write(`✅ ${j(n.label,16)}已移除 ${f.skills.length} 个 skill（${n.skillsDir}）
+`)}}return t===0&&process.stdout.write(`没有找到本 CLI 的装机记录，无需卸载。
+`),d.OK}s(ae,"runUninstall");function Z(){const e=C();return R().map(r=>{const t=g(r.skillsDir);return{label:r.label,skillsDir:r.skillsDir,installedVersion:t?.version??null,currentVersion:e,drifted:t!=null&&t.version!==e}})}s(Z,"installStates");function ue(e=Z()){const r=e.filter(n=>n.installedVersion==null).map(n=>n.label),t=e.filter(n=>n.drifted).map(n=>n.label);return r.length>0?`💡 检测到 ${r.join("、")}，但还没装 skill → 运行 remixmate install，重启 agent 后它才能自动发现 RemixMate 的能力`:t.length>0?`💡 ${t.join("、")} 里的 skill 是旧版本 → 运行 remixmate install 覆盖`:null}s(ue,"skillInstallHint");export{P as INSTALL_VERB,E as UNINSTALL_VERB,R as detectHosts,Z as installStates,A as installUsage,C as packageVersion,z as projectOnlyHosts,ce as runInstall,ae as runUninstall,ue as skillInstallHint,U as uninstallUsage};

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.9.72",
-  "generatedAt": "2026-10-08T04:30:08.225Z",
+  "version": "0.9.73",
+  "generatedAt": "2026-10-08T10:57:35.046Z",
   "skills": [
     {
       "id": "doc-parse",
@@ -594,6 +594,22 @@
             "type": "string",
             "description": "Template id (from template_registry). The template owns outputLanguage and may also declare a defaultVoiceId; both flow into the produced DSL."
           },
+          "template_source": {
+            "type": "string",
+            "enum": [
+              "user-explicit",
+              "user-confirmed",
+              "auto"
+            ],
+            "description": "How template_id was chosen; recorded at meta.templateSelection.source. **Always pass it with template_id.** `user-explicit`: the user named this template — its id or name, a pasted template detail-page prompt or link, or it was settled earlier in this conversation. `user-confirmed`: the user did not name one, you offered candidates and the user picked or approved this one in the chat. `auto`: you picked it yourself and the user has not confirmed — gen_script refuses, so instead of calling it, show the candidates and end the turn. Never mark a template user-confirmed that the user has not seen and approved."
+          },
+          "template_candidates": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The template ids you offered the user, recommended first; recorded at meta.templateSelection.candidates. Pass with template_source=user-confirmed — template_id must then be one of them (a template the user named outside the shortlist is user-explicit)."
+          },
           "source_document_url": {
             "type": "string",
             "description": "Source document URL (.pptx) for a template that builds its per-scene picture from that document (capabilities.payloadHydration). **Must** pass it for such a template: it is recorded at meta.sourceDocument, and prepare_video_assets then fetches the layout itself and fills the customPayload field the template declares (payloadHydration.payloadField) on every scene. Pass the same URL you gave doc_parse. You are NOT expected to author or even read that layout data — one page is hundreds of KB, so it never travels through the conversation; without this reference the DSL is rejected downstream after you have already written all the narration."
@@ -666,6 +682,8 @@
           "variant",
           "background_preset",
           "template_id",
+          "template_source",
+          "template_candidates",
           "source_document_url",
           "headline",
           "subheadline",
@@ -1157,13 +1175,33 @@
             "type": "string",
             "description": "Show only templates whose contentLanguage includes this code ('zh' or 'en'). Templates with no declared language are always shown (treated as language-agnostic)."
           },
+          "user_media": {
+            "type": "string",
+            "enum": [
+              "yes",
+              "no"
+            ],
+            "description": "Shortlisting when the user named no template. 'yes' = the user handed over their own images/videos: drops templates with nowhere to put them. 'no' = they did not: drops templates that cannot run without them. Leave unset when it does not matter."
+          },
+          "source_doc": {
+            "type": "string",
+            "description": "Shortlisting: the user gave a source document of this kind (e.g. 'pptx') — keeps only templates that build their scenes from one. 'none' drops those templates. Leave unset otherwise."
+          },
+          "narration": {
+            "type": "string",
+            "enum": [
+              "yes",
+              "no"
+            ],
+            "description": "Shortlisting: 'yes' = the video needs voice-over (drops narration-free templates); 'no' = the user wants none (keeps only narration-free templates). Leave unset unless the user said so."
+          },
           "include_beta": {
             "type": "boolean",
             "description": "Also list templates with status='beta'. Default off (only 'stable' shows). The ENABLE_BETA_TEMPLATES env var has the same effect process-wide."
           },
           "json_output": {
             "type": "boolean",
-            "description": "Emit a JSON result instead of the human-readable table: { templates: [...] } — summaries, or full definitions when template_id / full is set — or { examples: [...] }. List summaries carry pageUrl (the template's web detail page — show it to the user as a link) and, when the backend serves samples, showcases { count, pageUrl, items }; the template_id view carries top-level pageUrls / showcases maps."
+            "description": "Emit a JSON result instead of the human-readable table: { templates: [...] } — summaries (each with notFor when the template declares which requests it is the wrong pick for), or full definitions when template_id / full is set — or { examples: [...] }. List summaries carry pageUrl (the template's web detail page — show it to the user as a link) and, when the backend serves samples, showcases { count, pageUrl, items }; the template_id view carries top-level pageUrls / showcases maps."
           },
           "open": {
             "type": "string",
@@ -1182,6 +1220,9 @@
           "filter_tag",
           "filter_aspect",
           "filter_language",
+          "user_media",
+          "source_doc",
+          "narration",
           "include_beta",
           "json_output",
           "open"

package/dist/progress.js

@@ -1,15 +1,2 @@
-/**
- * Progress reporting — emits __progress__ JSON lines that ab-agent's
- * executor parses (see apps/ab-agent/src/skills/executor.ts).
- *
- * Always writes to stdout because the consumer reads stdout line-by-line.
- * Each event is a single JSON object on its own line, with the marker
- * field `__progress__: true` so non-progress stdout content is ignored.
- *
- * The consumer flattens the entire parsed JSON into `extra`, so any
- * additional context (model id, generationId, ...) can be passed as
- * top-level keys and will reach the SSE client unchanged.
- */
-export function emitProgress(ev) {
-    process.stdout.write(JSON.stringify({ __progress__: true, ...ev }) + '\n');
-}
+var e=Object.defineProperty;var s=(r,t)=>e(r,"name",{value:t,configurable:!0});function i(r){process.stdout.write(JSON.stringify({__progress__:!0,...r})+`
+`)}s(i,"emitProgress");export{i as emitProgress};