funcoding-cli 0.2.1 → 0.3.0

package/README.md

@@ -59,6 +59,8 @@ fun --help
 | `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>]` | 搜索中文文档 |
@@ -70,7 +72,7 @@ fun --help
   - 成功时为 `{ "ok": true, ... }`
   - 失败时为 `{ "ok": false, "error": { "code", "message", "hint", ... } }`
   - 过程提示一律写到 stderr。
-- **不交互**：需要确认的操作通过参数表达，比如覆盖时加 `--force`，`favorites 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` 装到当前项目，不加时装到用户目录。`skills list`、`skills update`、`skills remove`、`mcp list`、`mcp remove` 默认同时查看两处，可以用 `--project` 或 `--user` 缩小范围。
 

package/dist/cli.js

@@ -13,6 +13,7 @@ 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 { bold, CliError, dim, fail, info, reportError, setJsonMode } from './ui.js';
 /** 帮助和提示里统一写全名；fun 是同一个命令的简写 */
@@ -182,6 +183,25 @@ const COMMANDS = [
             { 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',
@@ -195,7 +215,7 @@ const COMMANDS = [
         name: 'news',
         summary: 'AI 热点',
         commands: [
-            { name: 'list', summary: '当前 AI 热榜：多家来源报道的事件，按热度排序', options: ['limit'], run: ({ values }) => newsList(limitOf(values)) },
+            { 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]) },
         ],
     },

package/dist/content.js

@@ -26,35 +26,38 @@ export async function find(kind, query, limit) {
         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}`));
-}
+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.no} 期 · ${issue.day}`));
+        info(bold(`AI 日报 · ${issue.day}`));
         info(dim(issue.url));
-        info('');
-        info(bold('头条'));
-        printStory(issue.headline);
+        if (issue.lead) {
+            info('');
+            info(bold(issue.lead.title));
+            info(`  ${truncate(issue.lead.summary, width())}`);
+        }
         for (const sec of issue.sections) {
             info('');
             info(bold(sec.label));
-            for (const s of sec.stories)
-                printStory(s);
+            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}`));
+            }
         }
-        if (issue.flash.length > 0) {
+        if (issue.flashes.length > 0) {
             info('');
             info(bold('快讯'));
-            for (const s of issue.flash)
-                info(`  · ${s.title} ${dim(s.url)}`);
+            for (const i of issue.flashes)
+                info(`  · ${i.title} ${dim(i.url)}`);
         }
+        info('');
+        info(dim('数据来自 AIHOT（aihot.news）'));
     });
 }
 export async function newsList(limit) {
@@ -63,7 +66,14 @@ export async function newsList(limit) {
         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) {

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/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));
@@ -28,11 +28,20 @@ export async function favorites() {
 }
 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,6 +1,6 @@
 {
   "name": "funcoding-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "funcoding.ai 的命令行：给 AI 编程智能体用，查找和安装 Agent Skills、配置 MCP Server、同步收藏、查看 AI 热点和中文文档",
   "type": "module",
   "bin": {
@@ -13,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

@@ -65,9 +65,16 @@ npx --yes funcoding-cli@latest init --json
 - `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，不需要登录：
+
+- `funcoding lists info <链接或 id>`：查看清单里有什么。
+- `funcoding lists add <链接或 id> [--agent=<name>] [--project] [--dry-run]`：安装清单里的全部条目，已装的跳过。建议先用 `--dry-run` 给用户看将要安装什么；结果的 `items[]` 和 `favorites sync` 相同。链接已关闭或重置时返回退出码 3。
+
 ## AI 热点
 
-- `funcoding news list [--limit=<n>]`：当前 AI 热榜（多家来源报道的事件，按热度排序，附中文标题和摘要）。
+- `funcoding news list [--limit=<n>]`：当前 AI 热榜（过去 48 小时被多个来源共同报道的事件，最多 10 个，附最新进展；数据来自 AIHOT）。
 - `funcoding news daily [<YYYY-MM-DD>]`：某一天的 AI 日报，不写日期时为最新一期。
 
 ## 文档
@@ -90,6 +97,7 @@ Commands:
   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）

package/dist/setup.js

@@ -1,78 +0,0 @@
-/**
- * setup：
- * 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))));
-}
-/** 全局安装当前版本；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}（权限不足时参考 https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally）` };
-}
-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));
-        // 之前 setup 装的直接换成新版；同名的其他 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 setup 安装的。`, '确认要覆盖就加 --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 setup(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(' / ')} 主动调用。新开会话后生效。`));
-    });
-}