funcoding-cli 0.2.0 → 0.3.0

package/dist/cli.js

@@ -1,75 +1,72 @@
 #!/usr/bin/env node
-/** funcoding-cli：给 AI 编程智能体用的 funcoding.ai 命令行（人也能用） */
+/**
+ * funcoding-cli：给 AI 编程智能体用的 funcoding.ai 命令行（人也能用），命令是 funcoding，简写 fun。
+ * 命令格式参照 android CLI：顶层是 init / update / info / help，其余按「名词 动词」分组（skills add、mcp list…），
+ * 每条命令都有自己的 --help。命令表 COMMANDS 同时用来解析参数和生成帮助
+ */
 import { parseArgs } from 'node:util';
-import { AGENT_IDS, DEFAULT_AGENT, resolveAgents } from './agents.js';
+import { AGENT_IDS, resolveAgents } from './agents.js';
 import { SITE, VERSION } from './api.js';
-import { login, logout, whoami } from './auth.js';
-import { docsRead, docsSearch, news, search } from './content.js';
+import { login, logout, status } from './auth.js';
+import { docsFetch, docsSearch, find, newsDaily, newsList } from './content.js';
+import { envInfo } from './info.js';
+import { init, selfUpdate } from './init.js';
 import { install, list, remove, skillInfo, update } from './install.js';
 import { mcpAdd, mcpInfo, mcpList, mcpRemove } from './mcp.js';
-import { setup } from './setup.js';
+import { listAdd, listInfo } from './lists.js';
 import { favorites, sync } from './sync.js';
 import { bold, CliError, dim, fail, info, reportError, setJsonMode } from './ui.js';
-const HELP = `${bold('funcoding')} ${dim(`v${VERSION}`)} — 从 ${SITE} 查找和安装 Agent Skills、MCP Server
-
-${bold('Skill')}
-  search <关键词>              搜索 Skill 和 MCP Server
-  info <owner/repo/skill>      查看 Skill：描述、文件清单和 SKILL.md 全文（安装前检查用）
-  install <id…>                安装 Skill（也可以粘贴网站上的详情页地址）
-  list                         列出已安装的 Skill
-  update [名称] [--check]      按原来源重新安装；--check 只检查有没有更新
-  remove <名称…>               删除由 funcoding 安装的 Skill（先备份）
-
-${bold('MCP')}
-  mcp info <owner/repo>        查看启动方式和需要的环境变量
-  mcp add <owner/repo>         写入智能体的 MCP 配置（--env / --header 提供必填项）
-  mcp list                     列出已配置的 MCP Server
-  mcp remove <配置名…>         删除配置（先备份）
-
-${bold('收藏')}
-  login / logout / whoami      在浏览器中授权登录 / 退出 / 查看当前账号
-  favorites                    列出网站上收藏的 Skill 和 MCP Server
-  sync [--dry-run]             安装全部收藏，已装的跳过
-
-${bold('热点与文档')}
-  news [--daily [日期]]        AI 热榜，或某天的 AI 日报
-  docs search <关键词>         搜索中文文档（--agent 可按智能体筛选）
-  docs read <智能体/路径>      读取文档全文（Markdown）
-
-${bold('其他')}
-  setup                        给智能体装上 funcoding Skill，让它学会使用本工具
-
-${bold('选项')}
-  --json                 只向 stdout 输出一个 JSON 对象（给智能体用）
-  -a, --agent <名称>     ${AGENT_IDS.join(' | ')} | all，多个用逗号分隔（默认：当前所在的智能体，否则 ${DEFAULT_AGENT}）
-  -p, --project          装到当前项目；list / update / remove / mcp list 时只看当前项目
-  -u, --user             list / update / remove / mcp list 时只看用户目录（默认两处都看）
-  -f, --force            目标已存在时覆盖（旧版本先备份）
-  -e, --env KEY=VALUE    mcp add：stdio Server 的环境变量，可重复
-      --header KEY=VALUE mcp add：远程 Server 的请求头，可重复
-      --via <方式>       mcp add：remote | npm | pypi
-      --name <配置名>    mcp add：自定义配置名
-      --dry-run          sync：只列出将要执行的操作
-      --check            update：只检查不安装
-      --daily [日期]     news：日报，YYYY-MM-DD，不写为最新一期
-      --limit <N>        search / news / docs search：返回条数
-      --no-browser       login：不自动打开浏览器
-  -h, --help             显示帮助
-  -v, --version          显示版本
-
-${bold('退出码')}
-  0 成功  1 一般错误  2 参数错误或缺少必填项  3 未找到  4 目标已存在  5 未登录或登录已过期
-
-${bold('例子')}
-  npx funcoding-cli search pdf --json
-  npx funcoding-cli info anthropics/skills/pdf --json
-  npx funcoding-cli install anthropics/skills/pdf --agent codex --project
-  npx funcoding-cli mcp add upstash/context7 --agent all
-`;
+/** 帮助和提示里统一写全名；fun 是同一个命令的简写 */
+const BIN = 'funcoding';
+const OPTIONS = {
+    json: { type: 'boolean', flag: '--json', desc: '只向 stdout 输出一个 JSON 对象（给智能体用）' },
+    help: { type: 'boolean', short: 'h', flag: '-h, --help', desc: '显示这条命令的帮助' },
+    version: { type: 'boolean', short: 'V', flag: '-V, --version', desc: '显示版本' },
+    agent: { type: 'string', short: 'a', flag: '-a, --agent=<name>', desc: `目标智能体：${AGENT_IDS.join('、')}，多个用逗号分隔，all 表示本机检测到的全部（默认：当前所在的智能体，否则 claude-code）` },
+    'scope-agent': { type: 'string', short: 'a', flag: '-a, --agent=<name>', desc: `只看这些智能体：${AGENT_IDS.join('、')}，多个用逗号分隔（默认全部）` },
+    'doc-agent': { type: 'string', short: 'a', flag: '-a, --agent=<slug>', desc: '只搜这个智能体的文档，比如 claude-code、codex、gemini-cli' },
+    project: { type: 'boolean', short: 'p', flag: '-p, --project', desc: '装到当前项目（可随仓库提交），不加时装到用户目录' },
+    'only-project': { type: 'boolean', short: 'p', flag: '-p, --project', desc: '只看当前项目' },
+    user: { type: 'boolean', short: 'u', flag: '-u, --user', desc: '只看用户目录（默认用户目录和当前项目都看）' },
+    force: { type: 'boolean', short: 'f', flag: '-f, --force', desc: '目标已存在时覆盖（原内容先备份到配置目录）' },
+    env: { type: 'string', short: 'e', multiple: true, flag: '-e, --env=<KEY=VALUE>', desc: 'stdio Server 的环境变量，可重复' },
+    header: { type: 'string', multiple: true, flag: '--header=<KEY=VALUE>', desc: '远程 Server 的请求头，可重复' },
+    via: { type: 'string', flag: '--via=<kind>', desc: '指定启动方式：remote、npm 或 pypi' },
+    name: { type: 'string', flag: '--name=<name>', desc: '自定义配置名（默认取自 Server 名称）' },
+    'dry-run': { type: 'boolean', flag: '--dry-run', desc: '只列出将要执行的操作' },
+    check: { type: 'boolean', flag: '--check', desc: '只检查远端有没有更新，不安装' },
+    limit: { type: 'string', flag: '--limit=<n>', desc: '返回条数（1–30，默认 10）' },
+    'no-browser': { type: 'boolean', flag: '--no-browser', desc: '不自动打开浏览器' },
+    'no-global': { type: 'boolean', flag: '--no-global', desc: '不全局安装，只装 funcoding Skill' },
+};
+const GLOBAL = ['json', 'help', 'version'];
+const str = (v) => (typeof v === 'string' ? v : undefined);
+const limitOf = (v) => Math.min(30, Math.max(1, Number(str(v.limit)) || 10));
+const need = (args, what, example) => {
+    if (!args[0])
+        fail('usage', `缺少${what}。`, `例如 ${example}`);
+    return args;
+};
+/** 写入类命令的目标：智能体 × 一个范围 */
+function targets(v) {
+    const agents = resolveAgents(str(v.agent));
+    if (!agents)
+        return fail('usage', `不认识的智能体：${str(v.agent)}`, `可选：${AGENT_IDS.join('、')}、all`);
+    const scope = v.project ? 'project' : 'user';
+    return agents.map((agent) => ({ agent, scope }));
+}
+/** 读取和维护类命令的范围：默认全部智能体、两个范围 */
+function selection(v) {
+    const agents = str(v.agent) ? resolveAgents(str(v.agent)) : AGENT_IDS;
+    if (!agents)
+        return fail('usage', `不认识的智能体：${str(v.agent)}`, `可选：${AGENT_IDS.join('、')}、all`);
+    const scopes = v.project && !v.user ? ['project'] : v.user && !v.project ? ['user'] : ['user', 'project'];
+    return { agents, scopes };
+}
 /** KEY=VALUE 列表转成对象 */
 function pairs(list, flag) {
     const out = {};
-    for (const item of list ?? []) {
+    for (const item of Array.isArray(list) ? list : []) {
         const i = item.indexOf('=');
         if (i <= 0)
             fail('usage', `${flag} 要写成 KEY=VALUE：${item}`);
@@ -77,144 +74,264 @@ function pairs(list, flag) {
     }
     return out;
 }
+const COMMANDS = [
+    {
+        name: 'init',
+        summary: '初始化：全局安装本工具（之后可用 funcoding 或 fun），并给智能体装上 funcoding Skill',
+        options: ['agent', 'project', 'force', 'no-global'],
+        examples: ['npx --yes funcoding-cli@latest init', `${BIN} init --agent=all`],
+        run: ({ values: v }) => init(targets(v), !!v.force, !v['no-global']),
+    },
+    {
+        name: 'update',
+        summary: '把本工具更新到最新版本，并刷新已安装的 funcoding Skill',
+        run: () => selfUpdate(),
+    },
+    {
+        name: 'info',
+        summary: '环境信息：版本、站点、登录状态、本机的智能体和 Skill 目录、配置目录',
+        params: [['<field>', '只输出这一项，比如 version、user、agents；不写时输出全部']],
+        run: ({ args }) => envInfo(args[0]),
+    },
+    {
+        name: 'help',
+        summary: '显示帮助',
+        params: [['<command>', '要查看帮助的命令，比如 skills add']],
+    },
+    {
+        name: 'skills',
+        summary: '查找、安装和管理 Agent Skills',
+        commands: [
+            { name: 'find', summary: '按关键词查找 Skill', params: [['<query>', '关键词']], options: ['limit'], run: ({ args, values }) => find('skill', args.join(' '), limitOf(values)) },
+            {
+                name: 'info',
+                summary: '查看 Skill 的描述、文件清单和 SKILL.md 全文（安装前检查用）',
+                params: [['<id>', 'owner/repo/skill，或网站上的详情页地址']],
+                run: ({ args }) => skillInfo(need(args, ' Skill', `${BIN} skills info anthropics/skills/pdf`)[0]),
+            },
+            {
+                name: 'add',
+                summary: '安装一个或多个 Skill',
+                params: [['<id>...', 'owner/repo/skill，或网站上的详情页地址']],
+                options: ['agent', 'project', 'force'],
+                examples: [`${BIN} skills add anthropics/skills/pdf`, `${BIN} skills add anthropics/skills/pdf --agent=codex,cursor --project`],
+                run: ({ args, values: v }) => install(need(args, '要安装的 Skill', `${BIN} skills add anthropics/skills/pdf`), targets(v), !!v.force),
+            },
+            { name: 'list', summary: '列出已安装的 Skill', options: ['scope-agent', 'only-project', 'user'], run: ({ values }) => list(selection(values)) },
+            {
+                name: 'update',
+                summary: '按原来源重新安装由 funcoding 安装的 Skill',
+                params: [['<name>', '目录名或 Skill id；不写时更新全部']],
+                options: ['check', 'scope-agent', 'only-project', 'user'],
+                run: ({ args, values: v }) => update(args[0], selection(v), !!v.check),
+            },
+            {
+                name: 'remove',
+                summary: '删除由 funcoding 安装的 Skill（先备份）',
+                params: [['<name>...', '目录名或 Skill id']],
+                options: ['force', 'scope-agent', 'only-project', 'user'],
+                run: ({ args, values: v }) => remove(need(args, '要删除的 Skill', `${BIN} skills remove pdf`), selection(v), !!v.force),
+            },
+        ],
+    },
+    {
+        name: 'mcp',
+        summary: '查找 MCP Server，并写入各智能体的 MCP 配置',
+        commands: [
+            { name: 'find', summary: '按关键词查找 MCP Server', params: [['<query>', '关键词']], options: ['limit'], run: ({ args, values }) => find('mcp', args.join(' '), limitOf(values)) },
+            {
+                name: 'info',
+                summary: '查看启动方式，以及需要提供的环境变量或请求头',
+                params: [['<id>', 'owner/repo 或 owner/repo/sub，或网站上的详情页地址']],
+                run: ({ args }) => mcpInfo(need(args, ' MCP Server', `${BIN} mcp info github/github-mcp-server`)[0]),
+            },
+            {
+                name: 'add',
+                summary: '把 MCP Server 写入智能体的配置',
+                params: [['<id>', 'owner/repo 或 owner/repo/sub，或网站上的详情页地址']],
+                options: ['agent', 'project', 'force', 'env', 'header', 'via', 'name'],
+                examples: [`${BIN} mcp add vexa-ai/vexa --header=Authorization="Bearer <key>" --agent=cursor`],
+                run: ({ args, values: v }) => {
+                    const via = str(v.via);
+                    if (via && !['remote', 'npm', 'pypi'].includes(via))
+                        fail('usage', `--via 只能是 remote、npm 或 pypi：${via}`);
+                    return mcpAdd(need(args, ' MCP Server', `${BIN} mcp add github/github-mcp-server`)[0], {
+                        targets: targets(v),
+                        env: pairs(v.env, '--env'),
+                        headers: pairs(v.header, '--header'),
+                        via: via,
+                        name: str(v.name),
+                        force: !!v.force,
+                    });
+                },
+            },
+            { name: 'list', summary: '列出已配置的 MCP Server', options: ['scope-agent', 'only-project', 'user'], run: ({ values }) => mcpList(selection(values)) },
+            {
+                name: 'remove',
+                summary: '删除 MCP Server 配置（先备份原文件）',
+                params: [['<name>...', '配置名，见 mcp list']],
+                options: ['scope-agent', 'only-project', 'user'],
+                run: ({ args, values }) => mcpRemove(need(args, '要删除的配置名', `${BIN} mcp remove vexa`), selection(values)),
+            },
+        ],
+    },
+    {
+        name: 'favorites',
+        summary: '网站上收藏的 Skill 和 MCP Server（需要登录）',
+        commands: [
+            { name: 'list', summary: '列出收藏', run: () => favorites() },
+            { name: 'sync', summary: '安装全部收藏，已安装的跳过', options: ['agent', 'project', 'dry-run'], run: ({ values: v }) => sync(targets(v), !!v['dry-run']) },
+        ],
+    },
+    {
+        name: 'lists',
+        summary: '别人分享的 Skill 和 MCP 清单（不需要登录）',
+        commands: [
+            {
+                name: 'info',
+                summary: '查看清单里的 Skill 和 MCP Server',
+                params: [['<link>', '清单链接（https://funcoding.ai/share/<id>/）或 id']],
+                run: ({ args }) => listInfo(need(args, '清单链接', `${BIN} lists info https://funcoding.ai/share/k3x9q2abcd/`)[0]),
+            },
+            {
+                name: 'add',
+                summary: '安装清单里的全部 Skill 和 MCP Server，已安装的跳过',
+                params: [['<link>', '清单链接（https://funcoding.ai/share/<id>/）或 id']],
+                options: ['agent', 'project', 'dry-run'],
+                run: ({ args, values: v }) => listAdd(need(args, '清单链接', `${BIN} lists add https://funcoding.ai/share/k3x9q2abcd/`)[0], targets(v), !!v['dry-run']),
+            },
+        ],
+    },
+    {
+        name: 'auth',
+        summary: '登录 funcoding.ai',
+        commands: [
+            { name: 'login', summary: '在浏览器中授权登录（设备码）', options: ['no-browser'], run: ({ values }) => login({ browser: !values['no-browser'] }) },
+            { name: 'logout', summary: '退出登录，并使登录凭证失效', run: () => logout() },
+            { name: 'status', summary: '查看当前登录的账号', run: () => status() },
+        ],
+    },
+    {
+        name: 'news',
+        summary: 'AI 热点',
+        commands: [
+            { name: 'list', summary: '当前 AI 热榜：过去 48 小时被多个来源共同报道的事件，前 10 名', options: ['limit'], run: ({ values }) => newsList(limitOf(values)) },
+            { name: 'daily', summary: '某一天的 AI 日报', params: [['<date>', 'YYYY-MM-DD；不写时为最新一期']], run: ({ args }) => newsDaily(args[0]) },
+        ],
+    },
+    {
+        name: 'docs',
+        summary: 'AI 编程智能体的中文文档',
+        commands: [
+            { name: 'search', summary: '搜索文档', params: [['<query>', '关键词']], options: ['doc-agent', 'limit'], run: ({ args, values }) => docsSearch(args.join(' '), str(values.agent)?.toLowerCase(), limitOf(values)) },
+            {
+                name: 'fetch',
+                summary: '读取文档全文（Markdown），开头附官方来源和核实日期',
+                params: [['<path>', '<智能体>/<路径>，比如 claude-code/build/hooks；也可以是网站上的文档地址']],
+                run: ({ args }) => docsFetch(need(args, '文档路径', `${BIN} docs fetch claude-code/build/hooks`)[0]),
+            },
+        ],
+    },
+];
+// ---------------- 帮助 ----------------
+const pad = (rows, indent = '  ') => {
+    const w = Math.max(...rows.map(([a]) => a.length)) + 2;
+    return rows.map(([a, b]) => `${indent}${a.padEnd(w)}${b}`).join('\n');
+};
+function usageLine(path) {
+    const cmd = path.at(-1);
+    const names = path.map((c) => c.name).join(' ');
+    if (!cmd)
+        return `${BIN} [-hV] [--json] <command>`;
+    if (cmd.commands)
+        return `${BIN} ${names} <command> [options]`;
+    const opts = (cmd.options ?? []).map((k) => `[${OPTIONS[k].flag.split(', ').pop()}]`).join(' ');
+    const params = (cmd.params ?? []).map(([p]) => (cmd.name === 'help' || cmd.name === 'info' || p === '<name>' || p === '<date>' ? `[${p}]` : p)).join(' ');
+    return [BIN, names, opts, params].filter(Boolean).join(' ');
+}
+function helpText(path) {
+    const cmd = path.at(-1);
+    const out = [`${bold('Usage:')} ${usageLine(path)}`];
+    if (!cmd) {
+        out.push(`${dim(`funcoding v${VERSION}`)} — 从 ${SITE} 查找和安装 Agent Skills、配置 MCP Server、查看 AI 热点和中文文档`);
+        out.push(dim('可以简写为 fun，比如 fun skills find pdf；给智能体用时加 --json'));
+    }
+    else
+        out.push(cmd.summary);
+    const options = cmd?.options ?? [];
+    if (options.length)
+        out.push('', bold('Options:'), pad(options.map((k) => [OPTIONS[k].flag, OPTIONS[k].desc])));
+    out.push('', bold(cmd ? 'Global options:' : 'Options:'), pad(GLOBAL.map((k) => [OPTIONS[k].flag, OPTIONS[k].desc])));
+    if (cmd?.params)
+        out.push('', bold('Positional parameters:'), pad(cmd.params));
+    const subs = cmd ? cmd.commands : COMMANDS;
+    if (subs)
+        out.push('', bold('Commands:'), pad(subs.map((c) => [c.name, c.summary])));
+    if (cmd?.examples)
+        out.push('', bold('Examples:'), cmd.examples.map((e) => `  ${e}`).join('\n'));
+    if (!cmd) {
+        out.push('', bold('Exit codes:'), '  0 成功  1 一般错误  2 参数错误或缺少必填项  3 未找到  4 目标已存在  5 未登录或登录已过期');
+        out.push('', `运行 ${BIN} <command> --help 查看每条命令的用法。`);
+    }
+    return out.join('\n');
+}
+/** 从位置参数里找出命令路径，剩下的是这条命令的参数 */
+function resolve(words) {
+    const path = [];
+    let list = COMMANDS;
+    let i = 0;
+    while (list && i < words.length) {
+        const c = list.find((x) => x.name === words[i]);
+        if (!c) {
+            const where = path.map((p) => p.name).join(' ');
+            fail('usage', `不认识的命令：${[where, words[i]].filter(Boolean).join(' ')}`, `运行 ${BIN} ${where ? `${where} ` : ''}--help 查看可用命令`);
+        }
+        path.push(c);
+        list = c.commands;
+        i++;
+    }
+    return { path, rest: words.slice(i) };
+}
+function parserConfig(keys) {
+    const out = {};
+    for (const k of keys) {
+        const { type, ...o } = OPTIONS[k];
+        // scope-agent / doc-agent 等是同一个 --agent 的不同说明
+        const name = k === 'scope-agent' || k === 'doc-agent' ? 'agent' : k === 'only-project' ? 'project' : k;
+        out[name] = { type, ...(o.short ? { short: o.short } : {}), ...(o.multiple ? { multiple: true } : {}) };
+    }
+    return out;
+}
+// ---------------- 入口 ----------------
 async function main() {
     const argv = process.argv.slice(2);
     // 参数解析出错时也要按 JSON 输出
     setJsonMode(argv.includes('--json'));
-    // --daily 后面的日期可选：没跟日期时补一个空串，避免把后面的参数当成日期
-    const i = argv.indexOf('--daily');
-    if (i >= 0 && !/^\d{4}-\d{2}-\d{2}$|^latest$/.test(argv[i + 1] ?? ''))
-        argv.splice(i + 1, 0, '');
-    const { values, positionals } = parseArgs({
-        args: argv,
-        allowPositionals: true,
-        options: {
-            json: { type: 'boolean', default: false },
-            agent: { type: 'string', short: 'a' },
-            project: { type: 'boolean', short: 'p', default: false },
-            user: { type: 'boolean', short: 'u', default: false },
-            force: { type: 'boolean', short: 'f', default: false },
-            env: { type: 'string', short: 'e', multiple: true },
-            header: { type: 'string', multiple: true },
-            via: { type: 'string' },
-            name: { type: 'string' },
-            'dry-run': { type: 'boolean', default: false },
-            check: { type: 'boolean', default: false },
-            daily: { type: 'string' },
-            limit: { type: 'string' },
-            'no-browser': { type: 'boolean', default: false },
-            help: { type: 'boolean', short: 'h', default: false },
-            version: { type: 'boolean', short: 'v', default: false },
-        },
-    });
-    setJsonMode(values.json);
+    // 先宽松解析一遍，找出命令路径
+    const loose = parseArgs({ args: argv, allowPositionals: true, strict: false, options: parserConfig(Object.keys(OPTIONS)) });
+    const { path, rest } = resolve(loose.positionals);
+    const cmd = path.at(-1);
+    if (cmd?.name === 'help' && path.length === 1)
+        return info(helpText(resolve(rest).path));
+    // 再按这条命令允许的选项严格解析
+    const parsed = parseArgs({ args: argv, allowPositionals: true, options: parserConfig([...GLOBAL, ...(cmd?.options ?? [])]) });
+    const values = parsed.values;
+    const positionals = parsed.positionals;
     if (values.version)
         return info(VERSION);
-    const [command, ...args] = positionals;
-    if (values.help || !command)
-        return info(HELP);
-    const limit = Math.min(30, Math.max(1, Number(values.limit) || 10));
-    /** 写入类命令的目标：智能体 × 一个范围 */
-    const targets = () => {
-        const agents = resolveAgents(values.agent);
-        if (!agents)
-            return fail('usage', `不认识的智能体：${values.agent}`, `可选：${AGENT_IDS.join('、')}、all`);
-        const scope = values.project ? 'project' : 'user';
-        return agents.map((agent) => ({ agent, scope }));
-    };
-    /** 读取和维护类命令的范围：默认全部智能体、两个范围 */
-    const selection = () => {
-        const agents = values.agent ? resolveAgents(values.agent) : AGENT_IDS;
-        if (!agents)
-            return fail('usage', `不认识的智能体：${values.agent}`, `可选：${AGENT_IDS.join('、')}、all`);
-        const scopes = values.project && !values.user ? ['project'] : values.user && !values.project ? ['user'] : ['user', 'project'];
-        return { agents, scopes };
-    };
-    switch (command) {
-        case 'search':
-        case 's':
-            return search(args.join(' '), limit);
-        case 'info':
-            if (!args[0])
-                fail('usage', '缺少 Skill。', '例如 funcoding info anthropics/skills/pdf');
-            return skillInfo(args[0]);
-        case 'install':
-        case 'add':
-        case 'i':
-            return install(args, targets(), values.force);
-        case 'list':
-        case 'ls':
-            return list(selection());
-        case 'update':
-        case 'up':
-            return update(args[0], selection(), values.check);
-        case 'remove':
-        case 'uninstall':
-        case 'rm':
-            return remove(args, selection(), values.force);
-        case 'mcp': {
-            const [sub, ...rest] = args;
-            if (sub === 'info') {
-                if (!rest[0])
-                    fail('usage', '缺少 MCP Server。', '例如 funcoding mcp info upstash/context7');
-                return mcpInfo(rest[0]);
-            }
-            if (sub === 'add' || sub === 'install') {
-                if (!rest[0])
-                    fail('usage', '缺少 MCP Server。', '例如 funcoding mcp add upstash/context7');
-                if (values.via && !['remote', 'npm', 'pypi'].includes(values.via))
-                    fail('usage', `--via 只能是 remote、npm 或 pypi：${values.via}`);
-                return mcpAdd(rest[0], {
-                    targets: targets(),
-                    env: pairs(values.env, '--env'),
-                    headers: pairs(values.header, '--header'),
-                    via: values.via,
-                    name: values.name,
-                    force: values.force,
-                });
-            }
-            if (sub === 'list' || sub === 'ls')
-                return mcpList(selection());
-            if (sub === 'remove' || sub === 'rm')
-                return mcpRemove(rest, selection());
-            return fail('usage', `不认识的命令：mcp ${sub ?? ''}`.trim(), '可用：mcp info / add / list / remove');
-        }
-        case 'login':
-            return login({ browser: !values['no-browser'] });
-        case 'logout':
-            return logout();
-        case 'whoami':
-            return whoami();
-        case 'favorites':
-        case 'fav':
-            return favorites();
-        case 'sync':
-            return sync(targets(), values['dry-run']);
-        case 'news':
-            return news({ daily: values.daily, limit });
-        case 'docs': {
-            const [sub, ...rest] = args;
-            // 文档的 --agent 是站内任意智能体的 slug，不限于能装 Skill 的三个
-            if (sub === 'search')
-                return docsSearch(rest.join(' '), values.agent?.toLowerCase(), limit);
-            if (sub === 'read') {
-                if (!rest[0])
-                    fail('usage', '缺少文档。', '例如 funcoding docs read claude-code/hooks');
-                return docsRead(rest[0]);
-            }
-            return fail('usage', `不认识的命令：docs ${sub ?? ''}`.trim(), '可用：docs search / read');
-        }
-        case 'setup':
-            return setup(targets(), values.force);
-        default:
-            return fail('usage', `不认识的命令：${command}`, '运行 funcoding --help 查看用法');
-    }
+    if (values.help || !cmd?.run)
+        return info(helpText(path));
+    await cmd.run({ args: positionals.slice(path.length), values });
 }
 main().catch((err) => {
     if (err instanceof CliError)
         return reportError(err);
-    // parseArgs 的参数错误
-    if (err instanceof TypeError && err.code?.startsWith('ERR_PARSE_ARGS'))
-        return reportError(new CliError('usage', err.message, '运行 funcoding --help 查看用法'));
+    // parseArgs 的参数错误，比如这条命令不支持的选项
+    if (err instanceof TypeError && err.code?.startsWith('ERR_PARSE_ARGS')) {
+        const unknown = /Unknown option '([^']+)'/.exec(err.message)?.[1];
+        const missing = /Option '([^']+)' argument missing/.exec(err.message)?.[1];
+        const message = unknown ? `这条命令不支持选项 ${unknown}` : missing ? `选项 ${missing.split(', ').pop()?.replace(' <value>', '')} 缺少取值` : err.message;
+        return reportError(new CliError('usage', message, `运行 ${BIN} <command> --help 查看这条命令支持的选项`));
+    }
     reportError(new CliError('error', err instanceof Error ? err.message : String(err)));
 });