funcoding-cli 0.2.1 → 0.4.0

package/skill/funcoding-cli/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: funcoding-cli
+version: 0.4.0
+description: 用 funcoding 命令行（funcoding-cli）从 funcoding.ai 查找并安装 Agent Skills 和 MCP Server，管理已安装的 Skill，同步用户在网站上的收藏和别人分享的清单，查看 AI 热点和日报，搜索和阅读 Claude Code、Codex、Cursor 等智能体的中文文档。当用户想找某类 Skill 或 MCP Server、安装或更新 Skill、配置 MCP、同步收藏，了解最近的 AI 新闻，或查阅 AI 编程工具的中文文档时使用。
+requires:
+  bins: ["funcoding"]
+---
+
+# funcoding-cli
+
+`funcoding` 命令（npm 包 `funcoding-cli`，简写 `fun`）连接 funcoding.ai：Skill 和 MCP Server 目录、用户的收藏、AI 热点、中文文档。
+
+> **核心规则：直接运行命令，始终加 `--json`。** 不要自己拼网站接口、不要去 GitHub 上找文件、不要手改各智能体的配置文件，这些 CLI 都会做，并且会先备份。
+
+## 约定
+
+- **`--json`**：stdout 只有一个 JSON 对象。成功 `{ "ok": true, ... }`；失败 `{ "ok": false, "error": { "code", "message", "hint" } }`。过程提示在 stderr，可以忽略。
+- **出错先看 `error.hint`**：通常是下一步该运行的命令或该补的参数。
+- **退出码**：0 成功，1 一般错误，2 参数错误或缺少必填项，3 未找到，4 目标已存在（需要 `--force`），5 未登录或登录已过期。
+- **`--agent=<name>`**：`claude-code`、`codex`、`cursor`，多个用逗号分隔，`all` 是本机检测到的全部。不写时在 Claude Code 里默认 `claude-code`，**在其他智能体里必须写**。
+- **`--project`**：安装到当前项目（可以随仓库提交）；不加时安装到用户目录。
+- **不确定参数时**：先读 `references/` 下对应的文件，或运行 `funcoding <命令> --help`。
+- **环境**：`funcoding info --json` 返回版本、登录状态、本机检测到的智能体和各自的 Skill 目录。
+
+没有 `funcoding` 命令时运行 `npx --yes funcoding-cli@latest cli setup --json`；`cli.status` 为 `failed` 时把 `cli.hint` 告诉用户，在那之前用 `npx --yes funcoding-cli@latest <命令>` 代替。
+
+## 安装 Skill
+
+1. `funcoding skills find <关键词> --json`：结果的 `skills[].id` 形如 `owner/repo/skill`。
+2. **安装前检查**：`funcoding skills info <id> --json` 返回 SKILL.md 全文（`skill.content`）和文件清单（`skill.files`，可执行脚本在 `skill.scripts`）。用一两句话告诉用户它做什么；有执行任意命令、读取或外传密钥和个人数据、修改系统设置等操作时要明确指出。**得到用户确认后再安装。**
+3. `funcoding skills add <id> --json`：目录已存在时以退出码 4 停下，向用户确认后再加 `--force`（旧版本会先备份）。
+4. 告诉用户安装位置（`installed[].dir`）和调用方式：Claude Code、Cursor 输入 `/<目录名>`，Codex 输入 `$<目录名>`，也可以直接描述任务。新开会话后生效。
+
+`skills list` 列出已安装的 Skill（`source` 不为空的是 funcoding 安装的）；`skills update [--check]` 检查或更新；`skills remove` 删除前会备份，删除其他来源的 Skill 要 `--force`，先征得用户同意。
+
+## 配置 MCP Server
+
+1. `funcoding mcp find <关键词> --json`，再用 `funcoding mcp info <id> --json` 看启动方式（`server.launches`）和需要的环境变量（`env`）或请求头（`headers`）。
+2. `funcoding mcp add <id> --env=KEY=VALUE --header=KEY=VALUE --json`：
+   - 缺少必填项时以退出码 2 返回，`error.missing` 列出缺少的项。**向用户索取，不要编造**；密钥只通过参数传入，不要写进别的文件。
+   - 没有标准安装包时以退出码 3 返回，`error.readme` 是 README 地址，按 README 手动配置。
+3. 重启智能体或新开会话后生效。Claude Code 当前项目的 Server 需要用户在 Claude Code 里确认。
+
+## 收藏和清单
+
+- 收藏需要登录：`funcoding auth status --json` 退出码 5 表示未登录；`funcoding auth login` 会在 stderr 输出验证码和链接，并尝试打开浏览器，把链接和验证码告诉用户，命令会等到用户确认后才返回。
+- `funcoding favorites sync --dry-run --json` 先给用户看会安装什么，再去掉 `--dry-run` 执行。
+- 用户发来 `https://funcoding.ai/share/<id>/` 时：`funcoding lists info <链接> --json` 查看，`funcoding lists add <链接> --dry-run --json` 预览后安装。不需要登录。
+- 两者结果的 `items[].status`：`installed` 已安装，`present` 已存在，`skipped` 跳过（附 `reason` 和 `hint`，多半是 MCP 缺少必填的环境变量），`planned` 待安装（`--dry-run`）。
+
+## 热点和文档
+
+- `funcoding news list --json`：当前 AI 热榜；`funcoding news daily [YYYY-MM-DD] --json`：AI 日报。数据来自 AIHOT，转述时保留来源。
+- `funcoding docs search <关键词> [--agent=<slug>] --json`，`funcoding docs fetch <智能体>/<路径> --json`：中文文档全文，附官方来源和核实日期；命令、配置和价格以官方文档为准。
+
+## 命令参考
+
+| 文件 | 命令 |
+| --- | --- |
+| [references/cli.md](references/cli.md) | `cli setup`、`cli upgrade` |
+| [references/skills.md](references/skills.md) | `skills find / info / add / list / update / remove` |
+| [references/mcp.md](references/mcp.md) | `mcp find / info / add / list / remove` |
+| [references/favorites.md](references/favorites.md) | `favorites list / sync` |
+| [references/lists.md](references/lists.md) | `lists info / add` |
+| [references/auth.md](references/auth.md) | `auth login / logout / status` |
+| [references/news.md](references/news.md) | `news list / daily` |
+| [references/docs.md](references/docs.md) | `docs search / fetch` |

package/skill/funcoding-cli/references/auth.md

@@ -0,0 +1,21 @@
+# funcoding auth
+
+登录 funcoding.ai
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding auth login
+
+在浏览器中授权登录（设备码）
+
+选项：
+
+- `--no-browser`：不自动打开浏览器
+
+## funcoding auth logout
+
+退出登录，并使登录凭证失效
+
+## funcoding auth status
+
+查看当前登录的账号

package/skill/funcoding-cli/references/cli.md

@@ -0,0 +1,27 @@
+# funcoding cli
+
+安装、升级本工具
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding cli setup
+
+全局安装本工具，并为本机的智能体安装 funcoding-cli Skill
+
+选项：
+
+- `--no-global`：不全局安装
+- `--no-agent-skills`：不为智能体安装 funcoding-cli Skill
+- `-f, --force`：目标已存在时覆盖（原内容先备份到配置目录）
+- `-q, --quiet`：不输出给人看的文字（脚本里用）
+
+示例：
+
+```bash
+npx --yes funcoding-cli@latest cli setup
+funcoding cli setup --no-agent-skills
+```
+
+## funcoding cli upgrade
+
+升级到最新版本，并刷新已安装的 funcoding-cli Skill

package/skill/funcoding-cli/references/docs.md

@@ -0,0 +1,26 @@
+# funcoding docs
+
+AI 编程智能体的中文文档
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding docs search <query>
+
+搜索文档
+
+参数：
+
+- `<query>`：关键词
+
+选项：
+
+- `-a, --agent=<slug>`：只搜这个智能体的文档，比如 claude-code、codex、gemini-cli
+- `--limit=<n>`：返回条数（1–30，默认 10）
+
+## funcoding docs fetch <path>
+
+读取文档全文（Markdown），开头附官方来源和核实日期
+
+参数：
+
+- `<path>`：<智能体>/<路径>，比如 claude-code/build/hooks；也可以是网站上的文档地址

package/skill/funcoding-cli/references/favorites.md

@@ -0,0 +1,19 @@
+# funcoding favorites
+
+网站上收藏的 Skill 和 MCP Server（需要登录）
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding favorites list
+
+列出收藏
+
+## funcoding favorites sync
+
+安装全部收藏，已安装的跳过
+
+选项：
+
+- `-a, --agent=<name>`：目标智能体：claude-code、codex、cursor，多个用逗号分隔，all 表示本机检测到的全部（默认：当前所在的智能体，否则 claude-code）
+- `-p, --project`：安装到当前项目（可随仓库提交），不加时安装到用户目录
+- `--dry-run`：只列出将要执行的操作

package/skill/funcoding-cli/references/lists.md

@@ -0,0 +1,27 @@
+# funcoding lists
+
+别人分享的 Skill 和 MCP 清单（不需要登录）
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding lists info <link>
+
+查看清单里的 Skill 和 MCP Server
+
+参数：
+
+- `<link>`：清单链接（https://funcoding.ai/share/<id>/）或 id
+
+## funcoding lists add <link>
+
+安装清单里的全部 Skill 和 MCP Server，已安装的跳过
+
+参数：
+
+- `<link>`：清单链接（https://funcoding.ai/share/<id>/）或 id
+
+选项：
+
+- `-a, --agent=<name>`：目标智能体：claude-code、codex、cursor，多个用逗号分隔，all 表示本机检测到的全部（默认：当前所在的智能体，否则 claude-code）
+- `-p, --project`：安装到当前项目（可随仓库提交），不加时安装到用户目录
+- `--dry-run`：只列出将要执行的操作

package/skill/funcoding-cli/references/mcp.md

@@ -0,0 +1,73 @@
+# funcoding mcp
+
+查找 MCP Server，并写入各智能体的 MCP 配置
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding mcp find <query>
+
+按关键词查找 MCP Server
+
+参数：
+
+- `<query>`：关键词
+
+选项：
+
+- `--limit=<n>`：返回条数（1–30，默认 10）
+
+## funcoding mcp info <id>
+
+查看启动方式，以及需要提供的环境变量或请求头
+
+参数：
+
+- `<id>`：owner/repo 或 owner/repo/sub，或网站上的详情页地址
+
+## funcoding mcp add <id>
+
+把 MCP Server 写入智能体的配置
+
+参数：
+
+- `<id>`：owner/repo 或 owner/repo/sub，或网站上的详情页地址
+
+选项：
+
+- `-a, --agent=<name>`：目标智能体：claude-code、codex、cursor，多个用逗号分隔，all 表示本机检测到的全部（默认：当前所在的智能体，否则 claude-code）
+- `-p, --project`：安装到当前项目（可随仓库提交），不加时安装到用户目录
+- `-f, --force`：目标已存在时覆盖（原内容先备份到配置目录）
+- `-e, --env=<KEY=VALUE>`：stdio Server 的环境变量，可重复
+- `--header=<KEY=VALUE>`：远程 Server 的请求头，可重复
+- `--via=<kind>`：指定启动方式：remote、npm 或 pypi
+- `--name=<name>`：自定义配置名（默认取自 Server 名称）
+
+示例：
+
+```bash
+funcoding mcp add vexa-ai/vexa --header=Authorization="Bearer <key>" --agent=cursor
+```
+
+## funcoding mcp list
+
+列出已配置的 MCP Server
+
+选项：
+
+- `-a, --agent=<name>`：只看这些智能体：claude-code、codex、cursor，多个用逗号分隔（默认全部）
+- `-p, --project`：只看当前项目
+- `-u, --user`：只看用户目录（默认用户目录和当前项目都看）
+
+## funcoding mcp remove <name>...
+
+删除 MCP Server 配置（先备份原文件）
+
+参数：
+
+- `<name>...`：配置名，见 mcp list
+
+选项：
+
+- `-a, --agent=<name>`：只看这些智能体：claude-code、codex、cursor，多个用逗号分隔（默认全部）
+- `-p, --project`：只看当前项目
+- `-u, --user`：只看用户目录（默认用户目录和当前项目都看）

package/skill/funcoding-cli/references/news.md

@@ -0,0 +1,21 @@
+# funcoding news
+
+AI 热点
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding news list
+
+当前 AI 热榜：过去 48 小时被多个来源共同报道的事件，前 10 名
+
+选项：
+
+- `--limit=<n>`：返回条数（1–30，默认 10）
+
+## funcoding news daily <date>
+
+某一天的 AI 日报
+
+参数：
+
+- `<date>`：YYYY-MM-DD；不写时为最新一期

package/skill/funcoding-cli/references/skills.md

@@ -0,0 +1,86 @@
+# funcoding skills
+
+查找、安装和管理 Agent Skills
+
+所有命令都支持 `--json`、`-h, --help`、`-V, --version`。本文件由 scripts/gen-skill.ts 根据命令表生成。
+
+## funcoding skills find <query>
+
+按关键词查找 Skill
+
+参数：
+
+- `<query>`：关键词
+
+选项：
+
+- `--limit=<n>`：返回条数（1–30，默认 10）
+
+## funcoding skills info <id>
+
+查看 Skill 的描述、文件清单和 SKILL.md 全文（安装前检查用）
+
+参数：
+
+- `<id>`：owner/repo/skill，或网站上的详情页地址
+
+## funcoding skills add <id>...
+
+安装一个或多个 Skill
+
+参数：
+
+- `<id>...`：owner/repo/skill，或网站上的详情页地址
+
+选项：
+
+- `-a, --agent=<name>`：目标智能体：claude-code、codex、cursor，多个用逗号分隔，all 表示本机检测到的全部（默认：当前所在的智能体，否则 claude-code）
+- `-p, --project`：安装到当前项目（可随仓库提交），不加时安装到用户目录
+- `-f, --force`：目标已存在时覆盖（原内容先备份到配置目录）
+
+示例：
+
+```bash
+funcoding skills add anthropics/skills/pdf
+funcoding skills add anthropics/skills/pdf --agent=codex,cursor --project
+```
+
+## funcoding skills list
+
+列出已安装的 Skill
+
+选项：
+
+- `-a, --agent=<name>`：只看这些智能体：claude-code、codex、cursor，多个用逗号分隔（默认全部）
+- `-p, --project`：只看当前项目
+- `-u, --user`：只看用户目录（默认用户目录和当前项目都看）
+
+## funcoding skills update <name>
+
+按原来源重新安装由 funcoding 安装的 Skill
+
+参数：
+
+- `<name>`：目录名或 Skill id；不写时更新全部
+
+选项：
+
+- `--check`：只检查远端有没有更新，不安装
+- `-a, --agent=<name>`：只看这些智能体：claude-code、codex、cursor，多个用逗号分隔（默认全部）
+- `-p, --project`：只看当前项目
+- `-u, --user`：只看用户目录（默认用户目录和当前项目都看）
+
+## funcoding skills remove <name>...
+
+删除由 funcoding 安装的 Skill（先备份）
+
+参数：
+
+- `<name>...`：目录名或 Skill id
+
+选项：
+
+- `-f, --force`：目标已存在时覆盖（原内容先备份到配置目录）
+- `-a, --agent=<name>`：只看这些智能体：claude-code、codex、cursor，多个用逗号分隔（默认全部）
+- `-p, --project`：只看当前项目
+- `-u, --user`：只看用户目录（默认用户目录和当前项目都看）

package/dist/init.js

@@ -1,90 +0,0 @@
-/**
- * init：
- * 1. 没有全局安装时用 npm 全局安装本 CLI，之后终端里可以直接用 funcoding 或简写 fun（--no-global 跳过）
- * 2. 把随 CLI 发布的 funcoding Skill（skill/funcoding/SKILL.md）装到智能体，让它知道什么时候、怎么用这个 CLI。
- *    这个 Skill 不在网站目录里，来源记录标成 builtin，update 时从当前版本的 CLI 重新复制
- */
-import { spawnSync } from 'node:child_process';
-import { randomBytes } from 'node:crypto';
-import { existsSync } from 'node:fs';
-import { mkdir, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
-import { delimiter, dirname, join } from 'node:path';
-import { AGENTS, skillsRoot } from './agents.js';
-import { USER_AGENT, VERSION } from './api.js';
-import { META_FILE, moveAway } from './install.js';
-import { cyan, dim, done, fail, green, info, warn } from './ui.js';
-const isWindows = process.platform === 'win32';
-/** PATH 上能不能找到这个命令；npx 运行时会把临时目录加进 PATH，那些目录不算 */
-export function onPath(command, env = process.env) {
-    const exts = isWindows ? ['.cmd', '.exe', ''] : [''];
-    return (env.PATH ?? '')
-        .split(delimiter)
-        .filter((dir) => dir && !/[\\/]_npx[\\/]/.test(dir))
-        .some((dir) => exts.some((ext) => existsSync(join(dir, command + ext))));
-}
-const EACCES_DOC = '权限不足时参考 https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally';
-/** 全局安装当前版本；npm 的输出写到 stderr，不影响 --json 的 stdout */
-function installGlobal() {
-    if (onPath('funcoding'))
-        return { status: 'present' };
-    const pkg = `funcoding-cli@${VERSION}`;
-    info(dim(`正在全局安装 ${pkg}，之后可以直接使用 funcoding 或 fun 命令…`));
-    const r = spawnSync('npm', ['install', '--global', pkg], { stdio: ['ignore', process.stderr, process.stderr], shell: isWindows });
-    if (r.status === 0)
-        return { status: 'installed' };
-    return { status: 'failed', hint: `手动运行 npm install -g ${pkg}（${EACCES_DOC}）` };
-}
-/** update：全局安装最新版，再用新版刷新已安装的 funcoding Skill */
-export function selfUpdate() {
-    info(dim('正在用 npm 全局安装 funcoding-cli@latest…'));
-    const r = spawnSync('npm', ['install', '--global', 'funcoding-cli@latest'], { stdio: ['ignore', process.stderr, process.stderr], shell: isWindows });
-    if (r.status !== 0)
-        fail('error', '更新失败。', `手动运行 npm install -g funcoding-cli@latest（${EACCES_DOC}）`);
-    const version = spawnSync('funcoding', ['--version'], { encoding: 'utf8', shell: isWindows }).stdout?.trim() || null;
-    // 让新版本把随包的 funcoding Skill 复制过去；没装过这个 Skill 时会报未找到，忽略
-    spawnSync('funcoding', ['skills', 'update', BUILTIN_ID, '--json'], { stdio: 'ignore', shell: isWindows });
-    done({ from: VERSION, to: version }, () => info(green(version && version !== VERSION ? `✓ 已从 ${VERSION} 更新到 ${version}` : `✓ 已是最新版本 ${version ?? VERSION}`)));
-}
-export const BUILTIN_ID = 'funcoding';
-const SOURCE = new URL('../skill/funcoding/SKILL.md', import.meta.url);
-export const builtinContent = () => readFile(SOURCE, 'utf8');
-export async function installBuiltin(targets, force) {
-    const content = await builtinContent();
-    const dirs = targets.map((t) => ({ ...t, dir: join(skillsRoot(t.agent, t.scope), BUILTIN_ID) }));
-    const foreign = [];
-    for (const d of dirs) {
-        const meta = await readFile(join(d.dir, META_FILE), 'utf8').catch(() => null);
-        const present = meta !== null || (await stat(d.dir).then(() => true, () => false));
-        // 之前 init 装的直接换成新版；同名的其他 Skill 要 --force，并且先备份
-        if (present && !(meta && JSON.parse(meta).builtin))
-            foreign.push(d);
-    }
-    if (foreign.length > 0 && !force)
-        fail('exists', `${foreign.map((d) => d.dir).join('、')} 已存在，且不是 funcoding init 安装的。`, '确认要覆盖就加 --force（会先备份到配置目录）');
-    for (const d of dirs) {
-        const tmp = join(dirname(d.dir), `.funcoding-tmp-${randomBytes(4).toString('hex')}`);
-        await mkdir(tmp, { recursive: true });
-        await writeFile(join(tmp, 'SKILL.md'), content);
-        await writeFile(join(tmp, META_FILE), `${JSON.stringify({ id: BUILTIN_ID, name: BUILTIN_ID, builtin: true, installedAt: new Date().toISOString(), cli: USER_AGENT }, null, 2)}\n`);
-        if (foreign.includes(d))
-            await moveAway(d.dir, d.agent, BUILTIN_ID);
-        else
-            await rm(d.dir, { recursive: true, force: true });
-        await rename(tmp, d.dir);
-    }
-    return dirs;
-}
-export async function init(targets, force, global) {
-    const cli = global ? installGlobal() : { status: 'skipped' };
-    const dirs = await installBuiltin(targets, force);
-    done({ cli, installed: dirs.map((d) => ({ id: BUILTIN_ID, agent: d.agent, scope: d.scope, dir: d.dir })) }, () => {
-        if (cli.status === 'installed')
-            info(green(`✓ 已全局安装 funcoding-cli，在终端里输入 ${cyan('funcoding')} 或 ${cyan('fun')} 即可使用`));
-        if (cli.status === 'failed')
-            warn(`全局安装失败，${cli.hint}`);
-        for (const d of dirs)
-            info(green(`✓ 已把 funcoding Skill 装到 ${d.dir}`));
-        info(`之后可以直接让 ${dirs.map((d) => AGENTS[d.agent].label).join('、')} 帮你查找和安装 Skill、配置 MCP，例如「找一个处理 PDF 的 Skill 装上」。`);
-        info(dim(`也可以输入 ${[...new Set(dirs.map((d) => cyan(AGENTS[d.agent].invoke(BUILTIN_ID))))].join(' / ')} 主动调用。新开会话后生效。`));
-    });
-}

package/skill/funcoding/SKILL.md

@@ -1,96 +0,0 @@
----
-name: funcoding
-description: 用 funcoding 命令行（funcoding-cli）从 funcoding.ai 查找并安装 Agent Skills 和 MCP Server，管理已安装的 Skill，同步用户在网站上的收藏，查看 AI 热点和日报，搜索和阅读 Claude Code、Codex、Cursor 等智能体的中文文档。当用户想找某类 Skill 或 MCP Server、安装或更新 Skill、配置 MCP、同步收藏、了解 AI 圈最近的新闻，或查阅 AI 编程工具的中文文档时使用。
----
-
-# funcoding
-
-本 Skill 说明如何使用 `funcoding` 命令行（npm 包 `funcoding-cli`，命令可简写为 `fun`）。
-
-## 安装
-
-如果 PATH 里找不到 `funcoding` 命令，运行下面的命令安装（需要 Node.js 18.17 及以上）：
-
-```bash
-npx --yes funcoding-cli@latest init --json
-```
-
-`init` 会全局安装本工具，并装上本 Skill。返回结果里 `cli.status` 为 `failed` 时（比如没有权限），把 `cli.hint` 告诉用户；在用户处理好之前，可以用 `npx --yes funcoding-cli@latest <命令>` 临时代替 `funcoding <命令>`。
-
-`funcoding update` 会把本工具更新到最新版本，并同时更新本 Skill。
-
-## 使用约定
-
-- **始终加 `--json`**：stdout 只输出一个 JSON 对象。成功时是 `{ "ok": true, ... }`，失败时是 `{ "ok": false, "error": { "code", "message", "hint" } }`。过程提示写在 stderr，可以忽略。
-- 出错时先看 `error.hint`，里面通常是下一步该运行的命令或该补的参数。
-- 退出码：0 成功，1 一般错误，2 参数错误或缺少必填项，3 未找到，4 目标已存在（需要 `--force`），5 未登录或登录已过期。
-- `--agent=<name>` 指定装给哪个智能体：`claude-code`、`codex`、`cursor`，多个用逗号分隔；`all` 表示本机检测到的全部智能体。不指定时默认装给 Claude Code。**如果你不是 Claude Code，请显式加上 `--agent`。**
-- `--project` 装到当前项目（可以随仓库提交，团队共用）；不加时装到用户目录，对所有项目生效。
-- 不确定某条命令的参数时，运行 `funcoding <命令> --help`，比如 `funcoding skills add --help`。
-- `funcoding info --json` 返回本机环境：已安装的智能体、各自的 Skill 目录、登录状态。
-
-## Skill 管理
-
-使用 `skills` 命令：
-
-1. `funcoding skills find <query>`：查找 Skill。结果里的 `skills[].id` 形如 `owner/repo/skill`。
-2. **安装前先检查**：`funcoding skills info <id>` 返回 SKILL.md 全文（`skill.content`）和文件清单（`skill.files`，其中的可执行脚本列在 `skill.scripts`）。用一两句话告诉用户这个 Skill 做什么；如果有执行任意命令、读取或外传密钥和个人数据、修改系统设置等危险操作，要明确指出。**得到用户确认后再安装。**
-3. `funcoding skills add <id>... [--agent=<name>] [--project]`：安装。目录已存在时会以退出码 4 停下；向用户确认后再加 `--force`，旧版本会备份到配置目录。
-4. 告诉用户装到了哪个目录（`installed[].dir`），以及如何调用：Claude Code 和 Cursor 输入 `/<目录名>`，Codex 输入 `$<目录名>`，也可以直接描述任务，让智能体自动选用。新装的 Skill 可能需要新开会话才会加载。
-
-管理已安装的 Skill：
-
-- `funcoding skills list`：列出所有智能体在用户目录和当前项目里的 Skill。`source` 不为空的是通过 funcoding 安装的。
-- `funcoding skills update --check`：检查远端 SKILL.md 是否有变化，不安装。`funcoding skills update [<name>]`：按原来源重新安装。
-- `funcoding skills remove <name>...`：删除前会先备份。只能删除通过 funcoding 安装的 Skill；删除其他 Skill 需要加 `--force`，务必先征得用户同意。
-
-## MCP 配置
-
-使用 `mcp` 命令：
-
-1. `funcoding mcp find <query>`：查找 MCP Server。结果里的 `servers[].id` 形如 `owner/repo`。
-2. `funcoding mcp info <id>`：查看可用的启动方式（`server.launches`），每种方式需要的环境变量（`env`）或请求头（`headers`），以及是否必填。
-3. `funcoding mcp add <id> [--agent=<name>] [--project] [--env=KEY=VALUE ...] [--header=KEY=VALUE ...] [--via=remote|npm|pypi]`：
-   - 缺少必填项时，会以退出码 2 返回，`error.missing` 列出缺少的项。**向用户索取这些值，不要编造。** 密钥只通过参数传入，不要写进其他文件。
-   - 没有登记标准安装包时，会以退出码 3 返回，`error.readme` 是 README 地址。这时按 README 手动配置。
-4. 配置在重启智能体或新开会话后生效。Claude Code 项目范围的 Server 需要用户在 Claude Code 里确认后才会启用。
-5. `funcoding mcp list` 列出已配置的 Server；`funcoding mcp remove <name>...` 删除，删除前会备份原文件。
-
-## 收藏
-
-用户在 funcoding.ai 上收藏的 Skill 和 MCP Server，需要先登录：
-
-- `funcoding auth status`：查看是否已登录。返回退出码 5 表示未登录。
-- `funcoding auth login`：会显示验证码和授权地址（在 stderr 中），并尝试打开浏览器。把地址和验证码告诉用户，请用户在浏览器中确认；命令会一直等到用户确认后才返回。
-- `funcoding favorites list`：列出收藏。
-- `funcoding favorites sync [--agent=<name>] [--project] [--dry-run]`：安装全部收藏，已装的跳过。建议先用 `--dry-run` 给用户看将要安装什么。`items[]` 里 `status` 为 `skipped` 的条目附有原因和提示，通常是 MCP 缺少必填的环境变量。
-
-## AI 热点
-
-- `funcoding news list [--limit=<n>]`：当前 AI 热榜（多家来源报道的事件，按热度排序，附中文标题和摘要）。
-- `funcoding news daily [<YYYY-MM-DD>]`：某一天的 AI 日报，不写日期时为最新一期。
-
-## 文档
-
-`docs` 命令用来查阅 AI 编程智能体的中文文档。这些文档按官方文档的章节结构整理，并标注了官方来源和核实日期。
-
-- `funcoding docs search <query> [--agent=<slug>]`：搜索文档。这里的 `--agent` 可以是站内任意智能体，比如 `claude-code`、`codex`、`cursor`、`gemini-cli`。
-- `funcoding docs fetch <agent>/<path>`：读取文档全文（Markdown），开头附官方来源链接和核实日期。命令、配置和价格以官方文档为准。
-
-## `funcoding help` 输出
-
-```
-Usage: funcoding [-hV] [--json] <command>
-
-Commands:
-  init       初始化：全局安装本工具（之后可用 funcoding 或 fun），并给智能体装上 funcoding Skill
-  update     把本工具更新到最新版本，并刷新已安装的 funcoding Skill
-  info       环境信息：版本、站点、登录状态、本机的智能体和 Skill 目录、配置目录
-  help       显示帮助
-  skills     查找、安装和管理 Agent Skills（find / info / add / list / update / remove）
-  mcp        查找 MCP Server，并写入各智能体的 MCP 配置（find / info / add / list / remove）
-  favorites  网站上收藏的 Skill 和 MCP Server（list / sync）
-  auth       登录 funcoding.ai（login / logout / status）
-  news       AI 热点（list / daily）
-  docs       AI 编程智能体的中文文档（search / fetch）
-```