funcoding-cli 0.3.0 → 0.4.0

package/README.md

@@ -9,20 +9,28 @@
 
 人也可以直接使用。需要 Node.js 18.17 及以上。
 
-## 让智能体用起来
+## 给智能体用
 
-把这句话发给你的智能体：
+做法参照 [sentry-cli](https://cli.sentry.dev/agentic-usage/)：命令全局可用，智能体通过一个 Skill 知道什么时候、怎么用它。把这句话发给你的智能体：
 
-> 运行 `npx --yes funcoding-cli@latest init`，然后帮我找一个处理 PDF 的 Skill 并安装。
+> 运行 `npx --yes funcoding-cli@latest cli setup`，然后帮我找一个处理 PDF 的 Skill 并安装。
 
-`init` 做两件事：
+`cli setup` 做两件事：
 
-1. 没有全局安装时，用 npm 全局安装本工具，之后终端里可以直接用 `funcoding`，或者简写 `fun`。加 `--no-global` 跳过这一步。
-2. 给当前智能体装上 funcoding Skill（[skill/funcoding/SKILL.md](skill/funcoding/SKILL.md)）。Skill 里写明了：
-   - 什么时候用哪条命令
+1. 没有全局安装时，用 npm 全局安装本工具，之后终端里可以直接用 `funcoding`，或者简写 `fun`。加 `--no-global` 跳过。
+2. 为本机检测到的智能体安装 funcoding-cli Skill（[skill/funcoding-cli/](skill/funcoding-cli/SKILL.md)），安装到各自的用户目录（如 `~/.claude/skills/funcoding-cli/`；`~/.agents` 存在时也安装到 `~/.agents/skills/`）。加 `--no-agent-skills` 跳过。Skill 里写明了：
+   - 什么时候用哪条命令（详细用法在 `references/`，由命令表生成）
    - 安装前先用 `skills info` 检查内容，并征得用户同意
    - 缺少 MCP 密钥时向用户索取，不要编造
 
+`cli upgrade` 升级本工具，并用新版本刷新已安装的 Skill。Skill 的 frontmatter 带 `version`，和 CLI 版本一致。
+
+只要 Skill、不全局安装命令时，也可以用 [skills](https://github.com/vercel-labs/skills) 从网站安装（网站在 `/.well-known/skills/` 提供同一份文件）：
+
+```bash
+npx skills add https://funcoding.ai
+```
+
 也可以自己全局安装：
 
 ```bash
@@ -36,15 +44,15 @@ fun --help
 
 格式参照 [android CLI](https://github.com/android/skills/blob/main/devtools/android-cli/SKILL.md)：
 
-- 顶层是 `init`、`update`、`info`、`help` 这几条。
+- 顶层是 `info`、`help`，安装和升级本工具在 `cli` 组。
 - 其余命令按「名词 动词」分组。
 - 每条命令都可以加 `--help`，查看它的用法、选项和位置参数，比如 `funcoding skills add --help`。
 - 选项可以写成 `--agent=codex`，也可以写成 `--agent codex`。
 
 | 命令 | 说明 |
 | --- | --- |
-| `init` | 全局安装本工具，并给智能体装上 funcoding Skill |
-| `update` | 把本工具更新到最新版本，并刷新已安装的 funcoding Skill |
+| `cli setup` | 全局安装本工具，并为本机的智能体安装 funcoding-cli Skill；`--no-global`、`--no-agent-skills` 跳过对应步骤，`--quiet` 不输出提示 |
+| `cli upgrade` | 升级到最新版本，并刷新已安装的 funcoding-cli Skill |
 | `info [<field>]` | 环境信息：版本、站点、是否全局安装、登录状态、本机的智能体和 Skill 目录、配置目录 |
 | `help [<command>]` | 显示帮助 |
 | `skills find <query>` | 查找 Skill |
@@ -73,8 +81,8 @@ fun --help
   - 失败时为 `{ "ok": false, "error": { "code", "message", "hint", ... } }`
   - 过程提示一律写到 stderr。
 - **不交互**：需要确认的操作通过参数表达，比如覆盖时加 `--force`，`favorites sync`、`lists add` 可以先加 `--dry-run` 预览。
-- **`--agent`**：可选 `claude-code`、`codex`、`cursor`，多个用逗号分隔。`all` 表示本机检测到的全部智能体，检测方法是看用户目录下有没有对应的配置目录。不指定时，在 Claude Code 中运行（`CLAUDECODE=1`）默认装给 Claude Code，其他情况也默认 Claude Code。Codex 和 Cursor 没有文档化的环境变量，CLI 不去猜，需要显式指定。
-- **范围**：`--project` 装到当前项目，不加时装到用户目录。`skills list`、`skills update`、`skills remove`、`mcp list`、`mcp remove` 默认同时查看两处，可以用 `--project` 或 `--user` 缩小范围。
+- **`--agent`**：可选 `claude-code`、`codex`、`cursor`，多个用逗号分隔。`all` 表示本机检测到的全部智能体，检测方法是看用户目录下有没有对应的配置目录。不指定时，在 Claude Code 中运行（`CLAUDECODE=1`）默认安装到 Claude Code，其他情况也默认 Claude Code。Codex 和 Cursor 没有文档化的环境变量，CLI 不去猜，需要显式指定。
+- **范围**：`--project` 安装到当前项目，不加时安装到用户目录。`skills list`、`skills update`、`skills remove`、`mcp list`、`mcp remove` 默认同时查看两处，可以用 `--project` 或 `--user` 缩小范围。
 
 | 退出码 | 含义 |
 | --- | --- |
@@ -85,6 +93,24 @@ fun --help
 | 4 | 目标已存在，需要 `--force` |
 | 5 | 未登录或登录已过期 |
 
+## 输出
+
+不加 `--json` 时是给人看的文字，只用这几种行（`src/ui.ts`）：
+
+```text
+正在安装 anthropics/skills/pdf（12 个文件）…
+✓ 已安装 pdf（Claude Code）
+  ~/.claude/skills/pdf
+! Skill 可能运行其中的脚本，使用前先阅读 SKILL.md
+下一步：新开会话，Claude Code 输入 /pdf
+```
+
+- `正在…`：进度，灰色
+- `✓ 已<动词><对象>`：结果；下面缩进两格的是细节（路径、版本、备份位置），用户主目录写成 `~`
+- `!`：提醒；`✗`：错误，下一行是怎么办
+- `下一步：`：只在确实需要时出现
+- 用简洁书面语，不用「装到」「即可」之类口语和公文腔；`--quiet` 时只输出错误
+
 ## 安装位置
 
 | `--agent` | Skill（用户目录 / 项目） | MCP（用户 / 项目） |

package/dist/auth.js

@@ -5,7 +5,7 @@
 import { spawn } from 'node:child_process';
 import { api, SITE } from './api.js';
 import { clearCredentials, credentialsPath, loadCredentials, saveCredentials } from './credentials.js';
-import { bold, cyan, dim, done, fail, green, info, warn } from './ui.js';
+import { bold, cyan, dim, done, fail, info, step, success, warn } from './ui.js';
 const CLIENT_ID = 'funcoding-cli';
 const absolute = (u) => new URL(u, SITE).href;
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -23,18 +23,16 @@ export async function login(opts) {
     if (existing) {
         const me = await fetchMe(existing.token).catch(() => null);
         if (me) {
-            return done({ user: me.user, alreadyLoggedIn: true }, () => info(`已经登录：${bold(me.user.name)}${me.user.githubLogin ? dim(` (@${me.user.githubLogin})`) : ''}。要换账号先运行 ${cyan('funcoding auth logout')}。`));
+            return done({ user: me.user, alreadyLoggedIn: true }, () => success(`已登录：${me.user.name}${me.user.githubLogin ? ` (@${me.user.githubLogin})` : ''}`, [`换账号先运行 funcoding auth logout`]));
         }
     }
     const code = await api('/api/auth/device/code', { method: 'POST', body: JSON.stringify({ client_id: CLIENT_ID }) });
     const url = absolute(code.verification_uri_complete ?? `${code.verification_uri}?user_code=${code.user_code}`);
-    info('');
-    info(`  在浏览器里确认这个验证码：${bold(pretty(code.user_code))}`);
-    info(`  ${cyan(url)}`);
-    info('');
+    info(`验证码：${bold(pretty(code.user_code))}`);
+    info(`打开：${cyan(url)}`);
     if (opts.browser)
         openBrowser(url);
-    info(dim('等待浏览器里确认…（Ctrl+C 取消）'));
+    step('正在等待浏览器确认（Ctrl+C 取消）');
     let interval = Math.max(code.interval ?? 5, 1) * 1000;
     const deadline = Date.now() + code.expires_in * 1000;
     while (Date.now() < deadline) {
@@ -47,8 +45,7 @@ export async function login(opts) {
             const me = await fetchMe(token.access_token);
             await saveCredentials({ token: token.access_token, site: SITE, user: { name: me.user.name, githubLogin: me.user.githubLogin }, savedAt: new Date().toISOString() });
             return done({ user: me.user, credentials: credentialsPath() }, () => {
-                info(green(`✓ 已登录：${me.user.name}${me.user.githubLogin ? ` (@${me.user.githubLogin})` : ''}`));
-                info(dim(`凭证保存在 ${credentialsPath()}`));
+                success(`已登录：${me.user.name}${me.user.githubLogin ? ` (@${me.user.githubLogin})` : ''}`, [`凭证：${credentialsPath()}`]);
             });
         }
         catch (err) {
@@ -60,22 +57,22 @@ export async function login(opts) {
                 continue;
             }
             if (e?.error === 'access_denied')
-                fail('auth', '你在浏览器里拒绝了这次登录。');
+                fail('auth', '已在浏览器中拒绝登录');
             if (e?.error === 'expired_token')
-                fail('auth', '验证码过期了。', '重新运行 funcoding auth login');
+                fail('auth', '验证码已过期', '重新运行 funcoding auth login');
             throw err;
         }
     }
-    fail('auth', '验证码过期了。', '重新运行 funcoding auth login');
+    fail('auth', '验证码已过期', '重新运行 funcoding auth login');
 }
 export async function logout() {
     const c = await loadCredentials(SITE);
     if (!c)
-        return done({ loggedOut: true, wasLoggedIn: false }, () => info('当前没有登录。'));
+        return done({ loggedOut: true, wasLoggedIn: false }, () => info('当前未登录'));
     // 顺便让服务端的会话失效；失败也照样删除本地凭证
-    await api('/api/auth/sign-out', { method: 'POST', token: c.token, body: '{}' }).catch(() => warn('没能通知服务端退出，本地凭证已删除。'));
+    await api('/api/auth/sign-out', { method: 'POST', token: c.token, body: '{}' }).catch(() => warn('无法通知服务端退出，已删除本地凭证'));
     await clearCredentials();
-    done({ loggedOut: true, wasLoggedIn: true }, () => info(green('✓ 已退出登录')));
+    done({ loggedOut: true, wasLoggedIn: true }, () => success('已退出登录'));
 }
 export async function fetchMe(token) {
     return api('/api/cli/me', { token });
@@ -84,16 +81,17 @@ export async function fetchMe(token) {
 export async function requireToken() {
     const c = await loadCredentials(SITE);
     if (!c)
-        return fail('auth', '还没有登录。', '运行 funcoding auth login');
+        return fail('auth', '未登录', '运行 funcoding auth login');
     return c.token;
 }
 export async function status() {
     const c = await loadCredentials(SITE);
     if (!c)
-        return fail('auth', '未登录。', '运行 funcoding auth login');
+        return fail('auth', '未登录', '运行 funcoding auth login');
     const me = await fetchMe(c.token);
     done({ user: me.user, favorites: { skills: me.favorites.skills.length, mcp: me.favorites.mcp.length }, site: SITE }, () => {
         info(`${bold(me.user.name)}${me.user.githubLogin ? dim(` (@${me.user.githubLogin})`) : ''}`);
-        info(dim(`${me.favorites.skills.length} 个收藏的 Skill，${me.favorites.mcp.length} 个收藏的 MCP · ${SITE}`));
+        info(dim(`收藏：${me.favorites.skills.length} 个 Skill，${me.favorites.mcp.length} 个 MCP Server`));
+        info(dim(`站点：${SITE}`));
     });
 }

package/dist/cli.js

@@ -1,238 +1,12 @@
 #!/usr/bin/env node
 /**
  * funcoding-cli：给 AI 编程智能体用的 funcoding.ai 命令行（人也能用），命令是 funcoding，简写 fun。
- * 命令格式参照 android CLI：顶层是 init / update / info / help，其余按「名词 动词」分组（skills add、mcp list…），
- * 每条命令都有自己的 --help。命令表 COMMANDS 同时用来解析参数和生成帮助
+ * 命令表在 commands.ts；这里负责解析参数、生成 --help 和运行命令
  */
 import { parseArgs } from 'node:util';
-import { AGENT_IDS, resolveAgents } from './agents.js';
 import { SITE, VERSION } from './api.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 { listAdd, listInfo } from './lists.js';
-import { favorites, sync } from './sync.js';
+import { BIN, COMMANDS, GLOBAL, OPTIONS } from './commands.js';
 import { bold, CliError, dim, fail, info, reportError, setJsonMode } from './ui.js';
-/** 帮助和提示里统一写全名；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 Array.isArray(list) ? list : []) {
-        const i = item.indexOf('=');
-        if (i <= 0)
-            fail('usage', `${flag} 要写成 KEY=VALUE：${item}`);
-        out[item.slice(0, i)] = item.slice(i + 1);
-    }
-    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;
@@ -253,8 +27,8 @@ 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'));
+        out.push(`funcoding ${VERSION}：从 ${SITE} 查找和安装 Agent Skills、MCP Server，查阅 AI 热点和中文文档`);
+        out.push(dim('简写 fun，如 fun skills find pdf；智能体调用时加 --json'));
     }
     else
         out.push(cmd.summary);
@@ -271,7 +45,7 @@ function helpText(path) {
         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 查看每条命令的用法。`);
+        out.push('', dim(`每条命令的用法：${BIN} <command> --help`));
     }
     return out.join('\n');
 }
@@ -284,7 +58,7 @@ function resolve(words) {
         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 查看可用命令`);
+            fail('usage', `没有这条命令：${[where, words[i]].filter(Boolean).join(' ')}`, `运行 ${BIN} ${where ? `${where} ` : ''}--help`);
         }
         path.push(c);
         list = c.commands;
@@ -330,8 +104,8 @@ main().catch((err) => {
     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 查看这条命令支持的选项`));
+        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)));
 });