funcoding-cli 0.2.0 → 0.3.0

package/dist/content.js

@@ -1,4 +1,4 @@
-/** search / news / docs：只读查询网站内容 */
+/** skills find / mcp find / news / docs：只读查询网站内容 */
 import { api, siteUrl } from './api.js';
 import { bold, CliError, cyan, dim, done, fail, info, stars, truncate } from './ui.js';
 function printCards(title, cards, hrefOf) {
@@ -13,60 +13,72 @@ function printCards(title, cards, hrefOf) {
     }
     info('');
 }
-export async function search(query, limit) {
+/** skills find / mcp find */
+export async function find(kind, query, limit) {
+    const cmd = kind === 'skill' ? 'skills' : 'mcp';
     if (!query)
-        fail('usage', '缺少搜索词。', '例如 funcoding search pdf');
+        fail('usage', '缺少关键词。', `例如 funcoding ${cmd} find pdf`);
     const r = await api(`/api/cli/search?q=${encodeURIComponent(query)}&limit=${limit}`);
-    done({ skills: r.skills, mcp: r.mcp }, () => {
-        if (r.skills.length + r.mcp.length === 0)
-            return info(`没有找到「${query}」相关的 Skill 或 MCP Server。`);
-        printCards('Skills', r.skills, (c) => `funcoding install ${c.id}`);
-        printCards('MCP Server', r.mcp, (c) => `funcoding mcp add ${c.id}`);
+    const items = kind === 'skill' ? r.skills : r.mcp;
+    done({ [kind === 'skill' ? 'skills' : 'servers']: items }, () => {
+        if (items.length === 0)
+            return info(`没有找到「${query}」相关的${kind === 'skill' ? ' Skill' : ' MCP Server'}。`);
+        printCards(kind === 'skill' ? 'Skills' : 'MCP Server', items, (c) => `funcoding ${cmd} add ${c.id}`);
     });
 }
-function printStory(s, n) {
-    info(`${n ? `${String(n).padStart(2)}. ` : '  · '}${bold(s.title)}${dim(`  ${s.sourceCount} 家报道`)}`);
-    if (s.summary)
-        info(`    ${truncate(s.summary, (process.stdout.columns || 100) - 6)}`);
-    info(dim(`    ${s.url}`));
-}
-export async function news(opts) {
-    if (opts.daily !== undefined) {
-        const day = opts.daily || 'latest';
-        if (day !== 'latest' && !/^\d{4}-\d{2}-\d{2}$/.test(day))
-            fail('usage', '日期要写成 YYYY-MM-DD。');
-        const issue = await api(`/api/cli/news?daily=${day}`);
-        return done({ daily: issue }, () => {
-            info(bold(`AI 日报 · 第 ${issue.no} 期 · ${issue.day}`));
-            info(dim(issue.url));
+const width = () => (process.stdout.columns || 100) - 6;
+export async function newsDaily(date) {
+    const day = date || 'latest';
+    if (day !== 'latest' && !/^\d{4}-\d{2}-\d{2}$/.test(day))
+        fail('usage', `日期要写成 YYYY-MM-DD：${day}`);
+    const issue = await api(`/api/cli/news?daily=${day}`);
+    done({ daily: issue }, () => {
+        info(bold(`AI 日报 · ${issue.day}`));
+        info(dim(issue.url));
+        if (issue.lead) {
             info('');
-            info(bold('头条'));
-            printStory(issue.headline);
-            for (const sec of issue.sections) {
-                info('');
-                info(bold(sec.label));
-                for (const s of sec.stories)
-                    printStory(s);
-            }
-            if (issue.flash.length > 0) {
-                info('');
-                info(bold('快讯'));
-                for (const s of issue.flash)
-                    info(`  · ${s.title} ${dim(s.url)}`);
+            info(bold(issue.lead.title));
+            info(`  ${truncate(issue.lead.summary, width())}`);
+        }
+        for (const sec of issue.sections) {
+            info('');
+            info(bold(sec.label));
+            for (const i of sec.items) {
+                info(`  · ${bold(i.title)}${dim(`  ${i.source}`)}`);
+                if (i.summary)
+                    info(`    ${truncate(i.summary, width())}`);
+                info(dim(`    ${i.url}`));
             }
-        });
-    }
-    const r = await api(`/api/cli/news?limit=${opts.limit}`);
+        }
+        if (issue.flashes.length > 0) {
+            info('');
+            info(bold('快讯'));
+            for (const i of issue.flashes)
+                info(`  · ${i.title} ${dim(i.url)}`);
+        }
+        info('');
+        info(dim('数据来自 AIHOT（aihot.news）'));
+    });
+}
+export async function newsList(limit) {
+    const r = await api(`/api/cli/news?limit=${limit}`);
     done({ updatedAt: r.updatedAt, stories: r.stories }, () => {
         if (r.stories.length === 0)
             return info('暂无热点。');
         info(bold('AI 热榜') + dim(`  ${siteUrl('/news/')}`));
-        r.stories.forEach((s, i) => printStory(s, i + 1));
+        for (const s of r.stories) {
+            info(`${String(s.rank).padStart(2)}. ${bold(s.title)}${dim(`  ${s.sourceCount} 个来源`)}`);
+            if (s.latest)
+                info(`    最新进展：${truncate(s.latest, width() - 5)}`);
+            info(dim(`    ${s.url}`));
+        }
+        info('');
+        info(dim('数据来自 AIHOT（aihot.news）'));
     });
 }
 export async function docsSearch(query, agent, limit) {
     if (!query)
-        fail('usage', '缺少搜索词。', '例如 funcoding docs search hooks --agent claude-code');
+        fail('usage', '缺少搜索词。', '例如 funcoding docs search hooks --agent=claude-code');
     const params = new URLSearchParams({ q: query, limit: String(limit), ...(agent ? { agent } : {}) });
     const r = await api(`/api/cli/docs/search?${params}`);
     done({ docs: r.docs }, () => {
@@ -78,10 +90,10 @@ export async function docsSearch(query, agent, limit) {
                 info(`  ${truncate(d.description, (process.stdout.columns || 100) - 4)}`);
         }
         info('');
-        info(dim(`运行 ${cyan('funcoding docs read <id>')} 阅读全文。`));
+        info(dim(`运行 ${cyan('funcoding docs fetch <id>')} 阅读全文。`));
     });
 }
-export async function docsRead(id) {
+export async function docsFetch(id) {
     const path = id
         .trim()
         .replace(/^https?:\/\/[^/]+/, '')

package/dist/info.js

@@ -0,0 +1,40 @@
+/** info：环境信息，只读本机状态，不访问网络 */
+import { AGENT_IDS, AGENTS, currentAgent, installedAgents, skillsRoot } from './agents.js';
+import { SITE, VERSION } from './api.js';
+import { configDir, credentialsPath, loadCredentials } from './credentials.js';
+import { onPath } from './init.js';
+import { bold, dim, done, fail, info } from './ui.js';
+export async function envInfo(field) {
+    const creds = await loadCredentials(SITE);
+    const found = installedAgents();
+    const data = {
+        version: VERSION,
+        site: SITE,
+        node: process.versions.node,
+        /** 是否已全局安装（终端里能直接用 funcoding / fun） */
+        global: onPath('funcoding'),
+        user: creds?.user ?? null,
+        currentAgent: currentAgent(),
+        agents: AGENT_IDS.map((id) => ({ id, installed: found.includes(id), skills: { user: skillsRoot(id, 'user'), project: skillsRoot(id, 'project') } })),
+        configDir: configDir(),
+        credentials: credentialsPath(),
+    };
+    if (field) {
+        if (!(field in data))
+            fail('usage', `没有这一项：${field}`, `可选：${Object.keys(data).join('、')}`);
+        const value = data[field];
+        return done({ [field]: value }, () => info(typeof value === 'object' && value !== null ? JSON.stringify(value, null, 2) : String(value)));
+    }
+    done(data, () => {
+        const row = (k, v) => info(`${bold(k.padEnd(14))}${v}`);
+        row('version', VERSION);
+        row('site', SITE);
+        row('node', process.versions.node);
+        row('global', data.global ? '已全局安装（funcoding / fun）' : '未全局安装，运行 npx --yes funcoding-cli@latest init');
+        row('user', creds?.user ? `${creds.user.name}${creds.user.githubLogin ? ` (@${creds.user.githubLogin})` : ''}` : '未登录');
+        row('currentAgent', data.currentAgent ? AGENTS[data.currentAgent].label : '无');
+        for (const id of AGENT_IDS)
+            row(id, `${found.includes(id) ? '已安装' : dim('未检测到')}  ${dim(skillsRoot(id, 'user'))}`);
+        row('configDir', configDir());
+    });
+}

package/dist/init.js

@@ -0,0 +1,90 @@
+/**
+ * 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/dist/install.js

@@ -10,7 +10,7 @@ import { AGENT_IDS, AGENTS, skillsRoot } from './agents.js';
 import { api, SITE, siteUrl, USER_AGENT } from './api.js';
 import { configDir } from './credentials.js';
 import { isSafeFolderName, resolveInside } from './paths.js';
-import { builtinContent, installBuiltin } from './setup.js';
+import { builtinContent, installBuiltin } from './init.js';
 import { bold, CliError, cyan, dim, done, fail, green, info, stars, warn } from './ui.js';
 /** 和服务端一致的上限 */
 const MAX_FILES = 200;
@@ -66,7 +66,7 @@ export async function fetchSkill(spec) {
     }
     catch (err) {
         if (err instanceof CliError && err.code === 'not_found')
-            fail('not_found', `没有找到 Skill：${id}`, `运行 funcoding search <关键词> 查找`);
+            fail('not_found', `没有找到 Skill：${id}`, '运行 funcoding skills find <关键词> 查找');
         throw err;
     }
 }
@@ -160,7 +160,7 @@ function printInstalled(r) {
 }
 export async function install(specs, targets, force) {
     if (specs.length === 0)
-        fail('usage', '缺少要安装的 Skill。', '例如 funcoding install anthropics/skills/pdf');
+        fail('usage', '缺少要安装的 Skill。', '例如 funcoding skills add anthropics/skills/pdf');
     const installed = [];
     for (const spec of specs)
         installed.push(...(await installSkill(await fetchSkill(spec), targets, force)));
@@ -200,7 +200,7 @@ export async function list(sel) {
     const items = await scanAll(sel);
     done({ skills: items }, () => {
         if (items.length === 0)
-            return info(`还没有安装 Skill。可以运行 ${cyan('funcoding search <关键词>')} 查找。`);
+            return info(`还没有安装 Skill。可以运行 ${cyan('funcoding skills find <关键词>')} 查找。`);
         for (const agent of AGENT_IDS) {
             for (const scope of sel.scopes) {
                 const group = items.filter((s) => s.agent === agent && s.scope === scope);
@@ -220,7 +220,7 @@ const matches = (s, name) => !name || s.folder === name || s.source?.id === name
 export async function update(name, sel, check) {
     const items = (await scanAll(sel)).filter((s) => s.source && matches(s, name));
     if (items.length === 0)
-        fail('not_found', name ? `没有找到由 funcoding 安装的 ${name}` : '没有由 funcoding 安装的 Skill', '运行 funcoding list 查看已安装的 Skill');
+        fail('not_found', name ? `没有找到由 funcoding 安装的 ${name}` : '没有由 funcoding 安装的 Skill', '运行 funcoding skills list 查看已安装的 Skill');
     const results = [];
     const cache = new Map();
     for (const s of items) {
@@ -252,19 +252,19 @@ export async function update(name, sel, check) {
         for (const r of results)
             info(`${label[r.status]}  ${r.id} ${dim(r.dir)}`);
         if (check && results.some((r) => r.status === 'outdated'))
-            info(dim(`运行 ${cyan('funcoding update')} 更新。`));
+            info(dim(`运行 ${cyan('funcoding skills update')} 更新。`));
     });
 }
 // ---------------- remove ----------------
 export async function remove(names, sel, force) {
     if (names.length === 0)
-        fail('usage', '缺少要删除的 Skill。', '运行 funcoding list 查看已安装的 Skill');
+        fail('usage', '缺少要删除的 Skill。', '运行 funcoding skills list 查看已安装的 Skill');
     const all = await scanAll(sel);
     const removed = [];
     for (const name of names) {
         const found = all.filter((s) => s.folder === name || s.source?.id === name.toLowerCase());
         if (found.length === 0)
-            fail('not_found', `没有找到已安装的 ${name}`, '运行 funcoding list 查看已安装的 Skill');
+            fail('not_found', `没有找到已安装的 ${name}`, '运行 funcoding skills list 查看已安装的 Skill');
         const manual = found.filter((s) => !s.source);
         if (manual.length > 0 && !force)
             fail('usage', `${manual.map((s) => s.dir).join('、')} 不是由 funcoding 安装的。`, '确认要删除就加 --force（会先备份到配置目录）', { paths: manual.map((s) => s.dir) });

package/dist/lists.js

@@ -0,0 +1,42 @@
+import { api } from './api.js';
+import { installCards, printCards, printItems } from './sync.js';
+import { bold, cyan, dim, done, fail, info } from './ui.js';
+const SHARE_ID = /^[23456789abcdefghijkmnpqrstuvwxyz]{10}$/;
+/** 从分享链接或裸 id 里取出清单 id，不合法返回 undefined */
+export function parseShareId(input) {
+    const s = input.trim();
+    const m = /\/share\/([^/?#]+)/.exec(s);
+    const id = (m ? m[1] : s).toLowerCase();
+    return SHARE_ID.test(id) ? id : undefined;
+}
+async function fetchList(input) {
+    const id = parseShareId(input);
+    if (!id)
+        fail('usage', `不是清单链接：${input}`, '清单链接形如 https://funcoding.ai/share/k3x9q2abcd/');
+    return api(`/api/cli/lists/${id}`);
+}
+export async function listInfo(input) {
+    const list = await fetchList(input);
+    done({ ...list }, () => {
+        info(`${bold(list.title)} ${dim(`· ${list.owner.name} 分享`)}`);
+        if (list.description)
+            info(list.description);
+        info(dim(list.url));
+        info('');
+        if (list.skills.length + list.mcp.length === 0)
+            return info('清单里还没有条目。');
+        printCards('Skill', list.skills, (c) => `funcoding skills add ${c.id}`);
+        printCards('MCP Server', list.mcp, (c) => `funcoding mcp add ${c.id}`);
+        info(dim(`运行 ${cyan(`funcoding lists add ${list.shareId}`)} 一次安装全部。`));
+    });
+}
+export async function listAdd(input, targets, dryRun) {
+    const list = await fetchList(input);
+    const items = await installCards(list, targets, dryRun);
+    done({ dryRun, list: { shareId: list.shareId, title: list.title, url: list.url }, items }, () => {
+        info(`${bold(list.title)} ${dim(`· ${list.owner.name} 分享`)}`);
+        if (items.length === 0)
+            return info('清单里还没有条目。');
+        printItems(items);
+    });
+}

package/dist/mcp.js

@@ -28,7 +28,7 @@ export async function fetchMcp(spec) {
     }
     catch (err) {
         if (err instanceof CliError && err.code === 'not_found')
-            fail('not_found', `没有找到 MCP Server：${id}`, '运行 funcoding search <关键词> 查找');
+            fail('not_found', `没有找到 MCP Server：${id}`, '运行 funcoding mcp find <关键词> 查找');
         throw err;
     }
 }

package/dist/sync.js

@@ -3,7 +3,7 @@ import { fetchMe, requireToken } from './auth.js';
 import { fetchSkill, installSkill, scanAll } from './install.js';
 import { addServer, fetchMcp } from './mcp.js';
 import { bold, CliError, cyan, dim, done, green, info, stars, truncate, yellow } from './ui.js';
-function printCards(title, cards, hrefOf) {
+export function printCards(title, cards, hrefOf) {
     if (cards.length === 0)
         return;
     info(bold(title));
@@ -21,18 +21,27 @@ export async function favorites() {
     done({ skills, mcp }, () => {
         if (skills.length + mcp.length === 0)
             return info(`还没有收藏。可以在 ${siteUrl('/skills/')} 收藏 Skill 和 MCP Server。`);
-        printCards('收藏的 Skill', skills, (c) => `funcoding install ${c.id}`);
+        printCards('收藏的 Skill', skills, (c) => `funcoding skills add ${c.id}`);
         printCards('收藏的 MCP Server', mcp, (c) => `funcoding mcp add ${c.id}`);
-        info(dim(`运行 ${cyan('funcoding sync')} 一次安装全部收藏。`));
+        info(dim(`运行 ${cyan('funcoding favorites sync')} 一次安装全部收藏。`));
     });
 }
 export async function sync(targets, dryRun) {
     const me = await fetchMe(await requireToken());
+    const items = await installCards(me.favorites, targets, dryRun);
+    done({ dryRun, items }, () => {
+        if (items.length === 0)
+            return info(`还没有收藏。可以在 ${siteUrl('/skills/')} 收藏 Skill 和 MCP Server。`);
+        printItems(items);
+    });
+}
+/** 把一组 Skill 和 MCP Server 装到 targets，已装的跳过；单个条目失败只记为跳过 */
+export async function installCards(cards, targets, dryRun) {
     const items = [];
     const agents = [...new Set(targets.map((t) => t.agent))];
     const scopes = [...new Set(targets.map((t) => t.scope))];
     const installed = await scanAll({ agents, scopes });
-    for (const card of me.favorites.skills) {
+    for (const card of cards.skills) {
         const missing = targets.filter((t) => !installed.some((s) => s.agent === t.agent && s.scope === t.scope && s.source?.id === card.id));
         if (missing.length === 0) {
             items.push({ kind: 'skill', id: card.id, status: 'present', agents });
@@ -53,7 +62,7 @@ export async function sync(targets, dryRun) {
             items.push({ kind: 'skill', id: card.id, status: 'skipped', agents: missing.map((t) => t.agent), reason: err.message, hint: err.hint });
         }
     }
-    for (const card of me.favorites.mcp) {
+    for (const card of cards.mcp) {
         try {
             const server = await fetchMcp(card.id);
             if (dryRun) {
@@ -73,14 +82,14 @@ export async function sync(targets, dryRun) {
                 items.push({ kind: 'mcp', id: card.id, status: 'skipped', agents, reason: err.message, hint: err.hint ?? (err.code === 'usage' ? undefined : `funcoding mcp info ${card.id}`) });
         }
     }
-    done({ dryRun, items }, () => {
-        if (items.length === 0)
-            return info(`还没有收藏。可以在 ${siteUrl('/skills/')} 收藏 Skill 和 MCP Server。`);
-        const label = { installed: green('新装'), present: dim('已装'), skipped: yellow('跳过'), planned: cyan('将安装') };
-        for (const i of items) {
-            info(`${label[i.status]}  ${i.kind === 'skill' ? 'Skill' : 'MCP'} ${i.id}${i.reason ? dim(`：${i.reason}`) : ''}`);
-            if (i.hint)
-                info(dim(`        ${i.hint}`));
-        }
-    });
+    return items;
+}
+/** 按「新装 / 已装 / 跳过 / 将安装」逐行打印 installCards 的结果 */
+export function printItems(items) {
+    const label = { installed: green('新装'), present: dim('已装'), skipped: yellow('跳过'), planned: cyan('将安装') };
+    for (const i of items) {
+        info(`${label[i.status]}  ${i.kind === 'skill' ? 'Skill' : 'MCP'} ${i.id}${i.reason ? dim(`：${i.reason}`) : ''}`);
+        if (i.hint)
+            info(dim(`        ${i.hint}`));
+    }
 }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "funcoding-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "funcoding.ai 的命令行：给 AI 编程智能体用，查找和安装 Agent Skills、配置 MCP Server、同步收藏、查看 AI 热点和中文文档",
   "type": "module",
   "bin": {
     "funcoding": "dist/cli.js",
+    "fun": "dist/cli.js",
     "funcoding-cli": "dist/cli.js"
   },
   "files": [
@@ -12,7 +13,7 @@
     "skill"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "rm -rf dist && tsc -p tsconfig.json",
     "test": "node --experimental-strip-types --no-warnings --test 'src/**/*.test.ts'",
     "prepublishOnly": "pnpm build && pnpm test"
   },

package/skill/funcoding/SKILL.md

@@ -1,61 +1,104 @@
 ---
 name: funcoding
-description: 用 funcoding-cli 从 funcoding.ai 查找并安装 Agent Skills 和 MCP Server，管理已安装的 Skill，同步用户在网站上的收藏，查看 AI 热点和日报，搜索和阅读 Claude Code、Codex、Cursor 等智能体的中文文档。当用户想找某类 Skill 或 MCP Server、安装或更新 Skill、配置 MCP、同步收藏、了解 AI 圈最近的新闻，或查阅 AI 编程工具的中文文档时使用。
+description: 用 funcoding 命令行（funcoding-cli）从 funcoding.ai 查找并安装 Agent Skills 和 MCP Server，管理已安装的 Skill，同步用户在网站上的收藏，查看 AI 热点和日报，搜索和阅读 Claude Code、Codex、Cursor 等智能体的中文文档。当用户想找某类 Skill 或 MCP Server、安装或更新 Skill、配置 MCP、同步收藏、了解 AI 圈最近的新闻，或查阅 AI 编程工具的中文文档时使用。
 ---
 
-# funcoding-cli
+# funcoding
 
-funcoding-cli 是 funcoding.ai 的命令行工具。运行方式：
+本 Skill 说明如何使用 `funcoding` 命令行（npm 包 `funcoding-cli`，命令可简写为 `fun`）。
+
+## 安装
+
+如果 PATH 里找不到 `funcoding` 命令，运行下面的命令安装（需要 Node.js 18.17 及以上）：
 
 ```bash
-npx --yes funcoding-cli@latest <命令> --json
+npx --yes funcoding-cli@latest init --json
 ```
 
-已全局安装时（`npm i -g funcoding-cli`）可以直接用 `funcoding <命令>`。需要 Node.js 18.17 及以上。
+`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` 指定装给哪个智能体：`claude-code`、`codex`、`cursor`，多个用逗号分隔；`all` 表示本机检测到的全部智能体。不指定时，在 Claude Code 里运行默认装给 Claude Code，其他情况也默认 Claude Code。如果你不是 Claude Code，请显式加上 `--agent`。
+- `--agent=<name>` 指定装给哪个智能体：`claude-code`、`codex`、`cursor`，多个用逗号分隔；`all` 表示本机检测到的全部智能体。不指定时默认装给 Claude Code。**如果你不是 Claude Code，请显式加上 `--agent`。**
 - `--project` 装到当前项目（可以随仓库提交，团队共用）；不加时装到用户目录，对所有项目生效。
+- 不确定某条命令的参数时，运行 `funcoding <命令> --help`，比如 `funcoding skills add --help`。
+- `funcoding info --json` 返回本机环境：已安装的智能体、各自的 Skill 目录、登录状态。
+
+## Skill 管理
 
-## 安装 Skill
+使用 `skills` 命令：
 
-1. 查找：`search <关键词>`。结果里的 `skills[].id` 形如 `owner/repo/skill`。
-2. **安装前先检查**：`info <id>` 会返回 SKILL.md 全文（`skill.content`）和文件清单（`skill.files`，`skill.scripts` 是其中的可执行脚本）。用一两句话告诉用户这个 Skill 做什么；如果有执行任意命令、读取或外传密钥和个人数据、修改系统设置等危险操作，要明确指出。**得到用户确认后再安装。**
-3. 安装：`install <id> [--agent ...] [--project]`。目录已存在时会以退出码 4 停下；向用户确认后再加 `--force`，旧版本会备份到配置目录。
+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：
 
-- `list`：列出所有智能体在用户目录和当前项目里的 Skill。`source` 不为空的是通过 funcoding 安装的。
-- `update --check`：检查远端 SKILL.md 是否有变化，不安装。`update [名称]`：按原来源重新安装。
-- `remove <名称>`：删除前会先备份。只能删除通过 funcoding 安装的 Skill；删除其他 Skill 需要加 `--force`，务必先征得用户同意。
+- `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 Server
+## MCP 配置
 
-1. `search <关键词>` 结果里的 `mcp[].id` 形如 `owner/repo`。
-2. `mcp info <id>`：查看可用的启动方式（`server.launches`），每种方式需要的环境变量（`env`）或请求头（`headers`），以及是否必填。
-3. `mcp add <id> [--agent ...] [--project] [--env KEY=VALUE ...] [--header KEY=VALUE ...] [--via remote|npm|pypi]`。
+使用 `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. `mcp list` 列出已配置的 Server，`mcp remove <配置名>` 删除，删除前会备份原文件。
+4. 配置在重启智能体或新开会话后生效。Claude Code 项目范围的 Server 需要用户在 Claude Code 里确认后才会启用。
+5. `funcoding mcp list` 列出已配置的 Server；`funcoding mcp remove <name>...` 删除，删除前会备份原文件。
 
 ## 收藏
 
-用户在 funcoding.ai 上收藏的 Skill 和 MCP Server：
+用户在 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 缺少必填的环境变量。
+
+## 别人分享的清单
+
+用户发来 `https://funcoding.ai/share/<id>/` 这样的链接，是别人在 funcoding.ai 上整理并公开的一组 Skill 和 MCP Server，不需要登录：
 
-- `whoami`：查看是否已登录。返回退出码 5 表示未登录。
-- `login`：会显示验证码和授权地址（在 stderr 中），并尝试打开浏览器。把地址和验证码告诉用户，请用户在浏览器中确认；命令会一直等到用户确认后才返回。
-- `favorites`：列出收藏。
-- `sync [--agent ...] [--project] [--dry-run]`：安装全部收藏，已装的跳过。建议先用 `--dry-run` 给用户看将要安装什么。`items[]` 里 `status` 为 `skipped` 的条目附有原因和提示，通常是 MCP 缺少必填的环境变量。
+- `funcoding lists info <链接或 id>`：查看清单里有什么。
+- `funcoding lists add <链接或 id> [--agent=<name>] [--project] [--dry-run]`：安装清单里的全部条目，已装的跳过。建议先用 `--dry-run` 给用户看将要安装什么；结果的 `items[]` 和 `favorites sync` 相同。链接已关闭或重置时返回退出码 3。
 
-## 热点与文档
+## AI 热点
 
-- `news [--limit N]`：当前 AI 热榜（多家来源报道的事件，按热度排序，中文标题和摘要）。
-- `news --daily [YYYY-MM-DD]`：某天的 AI 日报，不带日期时为最新一期。
-- `docs search <关键词> [--agent <智能体>]`：搜索中文文档。这里的 `--agent` 可以是站内任意智能体，比如 `claude-code`、`codex`、`cursor`、`gemini-cli`。
-- `docs read <id>`：读取文档全文（Markdown），开头附官方来源链接和核实日期。命令、配置和价格以官方文档为准。
+- `funcoding news list [--limit=<n>]`：当前 AI 热榜（过去 48 小时被多个来源共同报道的事件，最多 10 个，附最新进展；数据来自 AIHOT）。
+- `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）
+  lists      别人分享的 Skill 和 MCP 清单（info / add）
+  auth       登录 funcoding.ai（login / logout / status）
+  news       AI 热点（list / daily）
+  docs       AI 编程智能体的中文文档（search / fetch）
+```