funcoding-cli 0.2.0 → 0.3.0

package/README.md

@@ -13,41 +13,58 @@
 
 把这句话发给你的智能体：
 
-> 运行 `npx --yes funcoding-cli@latest setup`，然后帮我找一个处理 PDF 的 Skill 并安装。
+> 运行 `npx --yes funcoding-cli@latest init`，然后帮我找一个处理 PDF 的 Skill 并安装。
 
-`setup` 会给当前智能体装上 funcoding Skill（[skill/funcoding/SKILL.md](skill/funcoding/SKILL.md)）。Skill 里写明了：
+`init` 做两件事：
 
-- 什么时候用哪条命令
-- 安装前先用 `info` 检查内容，并征得用户同意
-- 缺少 MCP 密钥时向用户索取，不要编造
+1. 没有全局安装时，用 npm 全局安装本工具，之后终端里可以直接用 `funcoding`，或者简写 `fun`。加 `--no-global` 跳过这一步。
+2. 给当前智能体装上 funcoding Skill（[skill/funcoding/SKILL.md](skill/funcoding/SKILL.md)）。Skill 里写明了：
+   - 什么时候用哪条命令
+   - 安装前先用 `skills info` 检查内容，并征得用户同意
+   - 缺少 MCP 密钥时向用户索取，不要编造
 
-也可以全局安装，之后的命令是 `funcoding`：
+也可以自己全局安装：
 
 ```bash
 npm i -g funcoding-cli
-funcoding --help
+fun --help
 ```
 
+没有用简写 `fc`：它是 zsh 和 bash 的内建命令（编辑历史命令用），shell 会优先执行内建命令。
+
 ## 命令
 
+格式参照 [android CLI](https://github.com/android/skills/blob/main/devtools/android-cli/SKILL.md)：
+
+- 顶层是 `init`、`update`、`info`、`help` 这几条。
+- 其余命令按「名词 动词」分组。
+- 每条命令都可以加 `--help`，查看它的用法、选项和位置参数，比如 `funcoding skills add --help`。
+- 选项可以写成 `--agent=codex`，也可以写成 `--agent codex`。
+
 | 命令 | 说明 |
 | --- | --- |
-| `search <关键词>` | 搜索 Skill 和 MCP Server |
-| `info <owner/repo/skill>` | 查看 Skill 的描述、文件清单和 SKILL.md 全文 |
-| `install <id…>` | 安装一个或多个 Skill，也可以粘贴网站上的详情页地址 |
-| `list` | 列出已安装的 Skill：默认列出全部智能体，包括用户目录和当前项目 |
-| `update [名称] [--check]` | 按原来源重新安装；`--check` 只比较远端的 SKILL.md，不安装 |
-| `remove <名称…>` | 删除通过 funcoding 安装的 Skill，删除前先备份；删除其他来源的 Skill 需要 `--force` |
-| `mcp info <owner/repo>` | 查看启动方式（远程地址、npm 或 PyPI 包），以及需要的环境变量或请求头 |
-| `mcp add <owner/repo>` | 写入智能体的 MCP 配置；必填项用 `--env KEY=VALUE` 或 `--header KEY=VALUE` 提供，`--via remote\|npm\|pypi` 指定启动方式 |
-| `mcp list` / `mcp remove <配置名…>` | 列出或删除 MCP 配置，修改前备份原文件 |
-| `login` / `logout` / `whoami` | 在浏览器中授权登录（设备码）、退出登录并使登录凭证失效、查看当前账号 |
-| `favorites` | 列出网站上收藏的 Skill 和 MCP Server |
-| `sync [--dry-run]` | 安装全部收藏，已安装的跳过；需要密钥的 MCP 会列出缺少哪些值 |
-| `news [--daily [YYYY-MM-DD]]` | 查看 AI 热榜，或某一天的 AI 日报 |
-| `docs search <关键词> [--agent <智能体>]` | 搜索中文文档 |
-| `docs read <智能体/路径>` | 读取文档的 Markdown 原文，开头附官方来源和核实日期 |
-| `setup` | 给智能体装上 funcoding Skill；`update` 时会一起更新到当前 CLI 版本 |
+| `init` | 全局安装本工具，并给智能体装上 funcoding Skill |
+| `update` | 把本工具更新到最新版本，并刷新已安装的 funcoding Skill |
+| `info [<field>]` | 环境信息：版本、站点、是否全局安装、登录状态、本机的智能体和 Skill 目录、配置目录 |
+| `help [<command>]` | 显示帮助 |
+| `skills find <query>` | 查找 Skill |
+| `skills info <id>` | 查看 Skill 的描述、文件清单和 SKILL.md 全文 |
+| `skills add <id>...` | 安装一个或多个 Skill，也可以粘贴网站上的详情页地址 |
+| `skills list` | 列出已安装的 Skill：默认列出全部智能体，包括用户目录和当前项目 |
+| `skills update [<name>] [--check]` | 按原来源重新安装；`--check` 只比较远端的 SKILL.md，不安装 |
+| `skills remove <name>...` | 删除通过 funcoding 安装的 Skill，删除前先备份；删除其他来源的 Skill 需要 `--force` |
+| `mcp find <query>` | 查找 MCP Server |
+| `mcp info <id>` | 查看启动方式（远程地址、npm 或 PyPI 包），以及需要的环境变量或请求头 |
+| `mcp add <id>` | 写入智能体的 MCP 配置；必填项用 `--env=KEY=VALUE` 或 `--header=KEY=VALUE` 提供，`--via=remote\|npm\|pypi` 指定启动方式 |
+| `mcp list` / `mcp remove <name>...` | 列出或删除 MCP 配置，修改前备份原文件 |
+| `favorites list` | 列出网站上收藏的 Skill 和 MCP Server |
+| `favorites sync [--dry-run]` | 安装全部收藏，已安装的跳过；需要密钥的 MCP 会列出缺少哪些值 |
+| `lists info <link>` | 查看别人分享的清单（`https://funcoding.ai/share/<id>/`），不需要登录 |
+| `lists add <link> [--dry-run]` | 安装清单里的全部 Skill 和 MCP Server，已安装的跳过 |
+| `auth login` / `auth logout` / `auth status` | 在浏览器中授权登录（设备码）、退出登录并使登录凭证失效、查看当前账号 |
+| `news list` / `news daily [<YYYY-MM-DD>]` | AI 热榜，或某一天的 AI 日报 |
+| `docs search <query> [--agent=<slug>]` | 搜索中文文档 |
+| `docs fetch <agent>/<path>` | 读取文档的 Markdown 原文，开头附官方来源和核实日期 |
 
 ## 给智能体的约定
 
@@ -55,9 +72,9 @@ funcoding --help
   - 成功时为 `{ "ok": true, ... }`
   - 失败时为 `{ "ok": false, "error": { "code", "message", "hint", ... } }`
   - 过程提示一律写到 stderr。
-- **不交互**：需要确认的操作通过参数表达，比如覆盖时加 `--force`，`sync` 可以先加 `--dry-run` 预览。
+- **不交互**：需要确认的操作通过参数表达，比如覆盖时加 `--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` 装到当前项目，不加时装到用户目录。`list`、`update`、`remove`、`mcp list`、`mcp remove` 默认同时查看两处，可以用 `--project` 或 `--user` 缩小范围。
+- **范围**：`--project` 装到当前项目，不加时装到用户目录。`skills list`、`skills update`、`skills remove`、`mcp list`、`mcp remove` 默认同时查看两处，可以用 `--project` 或 `--user` 缩小范围。
 
 | 退出码 | 含义 |
 | --- | --- |

package/dist/api.js

@@ -11,7 +11,7 @@ export class ApiError extends CliError {
     status;
     body;
     constructor(message, status, body) {
-        super(codeOf(status), message, status === 401 ? '运行 funcoding login 重新登录' : undefined);
+        super(codeOf(status), message, status === 401 ? '运行 funcoding auth login 重新登录' : undefined);
         this.status = status;
         this.body = body;
     }

package/dist/auth.js

@@ -23,7 +23,7 @@ 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 logout')}。`));
+            return done({ user: me.user, alreadyLoggedIn: true }, () => info(`已经登录：${bold(me.user.name)}${me.user.githubLogin ? dim(` (@${me.user.githubLogin})`) : ''}。要换账号先运行 ${cyan('funcoding auth logout')}。`));
         }
     }
     const code = await api('/api/auth/device/code', { method: 'POST', body: JSON.stringify({ client_id: CLIENT_ID }) });
@@ -62,11 +62,11 @@ export async function login(opts) {
             if (e?.error === 'access_denied')
                 fail('auth', '你在浏览器里拒绝了这次登录。');
             if (e?.error === 'expired_token')
-                fail('auth', '验证码过期了。', '重新运行 funcoding login');
+                fail('auth', '验证码过期了。', '重新运行 funcoding auth login');
             throw err;
         }
     }
-    fail('auth', '验证码过期了。', '重新运行 funcoding login');
+    fail('auth', '验证码过期了。', '重新运行 funcoding auth login');
 }
 export async function logout() {
     const c = await loadCredentials(SITE);
@@ -84,13 +84,13 @@ export async function fetchMe(token) {
 export async function requireToken() {
     const c = await loadCredentials(SITE);
     if (!c)
-        return fail('auth', '还没有登录。', '运行 funcoding login');
+        return fail('auth', '还没有登录。', '运行 funcoding auth login');
     return c.token;
 }
-export async function whoami() {
+export async function status() {
     const c = await loadCredentials(SITE);
     if (!c)
-        return fail('auth', '未登录。', '运行 funcoding 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})`) : ''}`);