@jackwener/opencli 1.4.1 → 1.5.1

package/src/cli.ts

@@ -76,9 +76,10 @@ export function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void {
       for (const [site, cmds] of sites) {
         console.log(chalk.bold.cyan(`  ${site}`));
         for (const cmd of cmds) {
-          const tag = strategyLabel(cmd) === 'public'
+          const label = strategyLabel(cmd);
+          const tag = label === 'public'
             ? chalk.green('[public]')
-            : chalk.yellow(`[${strategyLabel(cmd)}]`);
+            : chalk.yellow(`[${label}]`);
           console.log(`    ${cmd.name} ${tag}${cmd.description ? chalk.dim(` — ${cmd.description}`) : ''}`);
         }
         console.log();
@@ -252,15 +253,23 @@ export function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void {
 
   pluginCmd
     .command('install')
-    .description('Install a plugin from GitHub')
+    .description('Install a plugin from a git repository')
     .argument('<source>', 'Plugin source (e.g. github:user/repo)')
     .action(async (source: string) => {
       const { installPlugin } = await import('./plugin.js');
       const { discoverPlugins } = await import('./discovery.js');
       try {
-        const name = installPlugin(source);
+        const result = installPlugin(source);
         await discoverPlugins();
-        console.log(chalk.green(`✅ Plugin "${name}" installed successfully. Commands are ready to use.`));
+        if (Array.isArray(result)) {
+          if (result.length === 0) {
+            console.log(chalk.yellow('No plugins were installed (all skipped or incompatible).'));
+          } else {
+            console.log(chalk.green(`\u2705 Installed ${result.length} plugin(s) from monorepo: ${result.join(', ')}`));
+          }
+        } else {
+          console.log(chalk.green(`\u2705 Plugin "${result}" installed successfully. Commands are ready to use.`));
+        }
       } catch (err) {
         console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
         process.exitCode = 1;
@@ -368,17 +377,71 @@ export function runCli(BUILTIN_CLIS: string, USER_CLIS: string): void {
       console.log();
       console.log(chalk.bold('  Installed plugins'));
       console.log();
+
+      // Group by monorepo
+      const standalone = plugins.filter((p) => !p.monorepoName);
+      const monoGroups = new Map<string, typeof plugins>();
       for (const p of plugins) {
+        if (!p.monorepoName) continue;
+        const g = monoGroups.get(p.monorepoName) ?? [];
+        g.push(p);
+        monoGroups.set(p.monorepoName, g);
+      }
+
+      for (const p of standalone) {
         const version = p.version ? chalk.green(` @${p.version}`) : '';
+        const desc = p.description ? chalk.dim(` — ${p.description}`) : '';
         const cmds = p.commands.length > 0 ? chalk.dim(` (${p.commands.join(', ')})`) : '';
         const src = p.source ? chalk.dim(` ← ${p.source}`) : '';
-        console.log(`  ${chalk.cyan(p.name)}${version}${cmds}${src}`);
+        console.log(`  ${chalk.cyan(p.name)}${version}${desc}${cmds}${src}`);
       }
+
+      for (const [mono, group] of monoGroups) {
+        console.log();
+        console.log(chalk.bold.magenta(`  📦 ${mono}`) + chalk.dim(' (monorepo)'));
+        for (const p of group) {
+          const version = p.version ? chalk.green(` @${p.version}`) : '';
+          const desc = p.description ? chalk.dim(` — ${p.description}`) : '';
+          const cmds = p.commands.length > 0 ? chalk.dim(` (${p.commands.join(', ')})`) : '';
+          console.log(`    ${chalk.cyan(p.name)}${version}${desc}${cmds}`);
+        }
+      }
+
       console.log();
       console.log(chalk.dim(`  ${plugins.length} plugin(s) installed`));
       console.log();
     });
 
+  pluginCmd
+    .command('create')
+    .description('Create a new plugin scaffold')
+    .argument('<name>', 'Plugin name (lowercase, hyphens allowed)')
+    .option('-d, --dir <path>', 'Output directory (default: ./<name>)')
+    .option('--description <text>', 'Plugin description')
+    .action(async (name: string, opts: { dir?: string; description?: string }) => {
+      const { createPluginScaffold } = await import('./plugin-scaffold.js');
+      try {
+        const result = createPluginScaffold(name, {
+          dir: opts.dir,
+          description: opts.description,
+        });
+        console.log(chalk.green(`✅ Plugin scaffold created at ${result.dir}`));
+        console.log();
+        console.log(chalk.bold('  Files created:'));
+        for (const f of result.files) {
+          console.log(`    ${chalk.cyan(f)}`);
+        }
+        console.log();
+        console.log(chalk.dim('  Next steps:'));
+        console.log(chalk.dim(`    cd ${result.dir}`));
+        console.log(chalk.dim(`    opencli plugin install file://${result.dir}`));
+        console.log(chalk.dim(`    opencli ${name} hello`));
+      } catch (err) {
+        console.error(chalk.red(`Error: ${getErrorMessage(err)}`));
+        process.exitCode = 1;
+      }
+    });
+
   // ── External CLIs ─────────────────────────────────────────────────────────
 
   const externalClis = loadExternalClis();

package/src/clis/36kr/article.ts

@@ -0,0 +1,69 @@
+/**
+ * 36kr article detail — INTERCEPT strategy.
+ *
+ * Fetches the full content of a 36kr article given its ID or URL.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import type { IPage } from '../../types.js';
+
+/** Extract article ID from a full URL or a bare numeric ID string */
+function parseArticleId(input: string): string {
+  const m = input.match(/\/p\/(\d+)/);
+  return m ? m[1] : input.replace(/\D/g, '');
+}
+
+cli({
+  site: '36kr',
+  name: 'article',
+  description: '获取36氪文章正文内容',
+  domain: 'www.36kr.com',
+  strategy: Strategy.INTERCEPT,
+  args: [
+    { name: 'id', positional: true, required: true, help: 'Article ID or full 36kr article URL' },
+  ],
+  columns: ['field', 'value'],
+  func: async (page: IPage, args) => {
+    const articleId = parseArticleId(String(args.id ?? ''));
+    if (!articleId) {
+      throw new CliError('INVALID_ARGUMENT', 'Invalid article ID or URL');
+    }
+
+    await page.installInterceptor('36kr.com/api');
+    await page.goto(`https://www.36kr.com/p/${articleId}`);
+    await page.wait(5);
+
+    const data: any = await page.evaluate(`
+      (() => {
+        // Title: 36kr uses class "article-title" on h1
+        const title = document.querySelector('.article-title, h1')?.textContent?.trim() || '';
+        // Author: second .author-name (first is empty nav link, second has real name)
+        const authorEls = document.querySelectorAll('.author-name');
+        const author = Array.from(authorEls).map(el => el.textContent?.trim()).filter(Boolean)[0] || '';
+        // Date: 36kr uses class "title-icon-item item-time" for the publish date
+        const dateRaw = document.querySelector('.item-time')?.textContent?.trim() || '';
+        const date = dateRaw.replace(/^[·\s]+/, '').trim();
+        // Article body paragraphs
+        const bodyEls = document.querySelectorAll('[class*="article-content"] p, [class*="rich-text"] p, .article p');
+        const body = Array.from(bodyEls)
+          .map(el => el.textContent?.trim())
+          .filter(t => t && t.length > 10)
+          .join(' ')
+          .slice(0, 800);
+        return { title, author, date, body };
+      })()
+    `);
+
+    if (!data?.title) {
+      throw new CliError('NOT_FOUND', 'Article not found or failed to load', 'Check the article ID');
+    }
+
+    return [
+      { field: 'title',  value: data.title },
+      { field: 'author', value: data.author || '-' },
+      { field: 'date',   value: data.date || '-' },
+      { field: 'url',    value: `https://36kr.com/p/${articleId}` },
+      { field: 'body',   value: data.body || '-' },
+    ];
+  },
+});

package/src/clis/36kr/hot.test.ts

@@ -0,0 +1,19 @@
+import { describe, expect, it } from 'vitest';
+
+import { buildHotListUrl, getShanghaiDate } from './hot.js';
+
+describe('36kr/hot date routing', () => {
+  it('formats dates in Asia/Shanghai instead of UTC', () => {
+    const date = new Date('2026-03-25T18:30:00.000Z');
+    expect(getShanghaiDate(date)).toBe('2026-03-26');
+  });
+
+  it('builds dated hot-list routes with Shanghai-local date', () => {
+    const date = new Date('2026-03-25T18:30:00.000Z');
+    expect(buildHotListUrl('renqi', date)).toBe('https://www.36kr.com/hot-list/renqi/2026-03-26/1');
+  });
+
+  it('keeps catalog on the static route', () => {
+    expect(buildHotListUrl('catalog')).toBe('https://www.36kr.com/hot-list/catalog');
+  });
+});

package/src/clis/36kr/hot.ts

@@ -0,0 +1,100 @@
+/**
+ * 36kr hot-list — INTERCEPT strategy.
+ *
+ * Navigates to the 36kr hot-list page and scrapes rendered article links.
+ * Supports category types: renqi (人气), zonghe (综合), shoucang (收藏), catalog (综合热门).
+ */
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import type { IPage } from '../../types.js';
+
+const TYPE_MAP: Record<string, string> = {
+  renqi:   '人气榜',
+  zonghe:  '综合榜',
+  shoucang: '收藏榜',
+  catalog: '热门资讯',
+};
+
+function getShanghaiDate(date = new Date()): string {
+  // Shanghai stays on UTC+8 year-round, so a fixed offset is sufficient here
+  // and avoids the slow Intl timezone path that timed out on Windows CI.
+  return new Date(date.getTime() + 8 * 60 * 60 * 1000).toISOString().slice(0, 10);
+}
+
+function buildHotListUrl(listType: string, date = new Date()): string {
+  if (listType === 'catalog') {
+    return 'https://www.36kr.com/hot-list/catalog';
+  }
+
+  return `https://www.36kr.com/hot-list/${listType}/${getShanghaiDate(date)}/1`;
+}
+
+cli({
+  site: '36kr',
+  name: 'hot',
+  description: '36氪热榜 — trending articles (renqi/zonghe/shoucang/catalog)',
+  domain: 'www.36kr.com',
+  strategy: Strategy.INTERCEPT,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of items (max 50)' },
+    {
+      name: 'type',
+      type: 'string',
+      default: 'catalog',
+      help: 'List type: renqi (人气), zonghe (综合), shoucang (收藏), catalog (热门资讯)',
+    },
+  ],
+  columns: ['rank', 'title', 'url'],
+  func: async (page: IPage, args) => {
+    const count = Math.min(Number(args.limit) || 20, 50);
+    const listType = String(args.type ?? 'catalog');
+
+    if (!TYPE_MAP[listType]) {
+      throw new CliError(
+        'INVALID_ARGUMENT',
+        `Unknown type "${listType}". Valid types: ${Object.keys(TYPE_MAP).join(', ')}`,
+      );
+    }
+
+    const url = buildHotListUrl(listType);
+
+    await page.installInterceptor('36kr.com/api');
+    await page.goto(url);
+    await page.wait(6);
+
+    // Scrape rendered article links from DOM (deduplicated)
+    const domItems: any = await page.evaluate(`
+      (() => {
+        const seen = new Set();
+        const results = [];
+        const links = document.querySelectorAll('a[href*="/p/"]');
+        for (const el of links) {
+          const href = el.getAttribute('href') || '';
+          const title = el.textContent?.trim() || '';
+          if (!title || title.length < 5 || seen.has(href) || seen.has(title)) continue;
+          seen.add(href);
+          seen.add(title);
+          results.push({ title, url: href.startsWith('http') ? href : 'https://36kr.com' + href });
+        }
+        return results;
+      })()
+    `);
+
+    const items = Array.isArray(domItems) ? (domItems as any[]) : [];
+    if (items.length === 0) {
+      throw new CliError(
+        'NO_DATA',
+        'Could not retrieve 36kr hot list',
+        '36kr may have changed its DOM structure',
+      );
+    }
+
+    return items.slice(0, count).map((item: any, i: number) => ({
+      rank: i + 1,
+      title: item.title,
+      url: item.url,
+    }));
+  },
+});
+
+export { buildHotListUrl, getShanghaiDate };

package/src/clis/36kr/news.test.ts

@@ -0,0 +1,90 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+
+const SAMPLE_RSS = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0"><channel><title>36氪</title>
+<item>
+  <title>红杉中国领投AI公司「示例」，金额近2亿元</title>
+  <link><![CDATA[https://36kr.com/p/1111111111111111?f=rss]]></link>
+  <pubDate>2026-03-26 10:00:00  +0800</pubDate>
+</item>
+<item>
+  <title>马斯克旗下xAI估值突破1000亿美元</title>
+  <link><![CDATA[https://36kr.com/p/2222222222222222?f=rss]]></link>
+  <pubDate>2026-03-26 09:00:00  +0800</pubDate>
+</item>
+<item>
+  <title>OpenAI发布GPT-5，多模态能力大幅提升</title>
+  <link><![CDATA[https://36kr.com/p/3333333333333333?f=rss]]></link>
+  <pubDate>2026-03-25 20:00:00  +0800</pubDate>
+</item>
+</channel></rss>`;
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+describe('36kr/news RSS parsing', () => {
+  it('parses RSS feed into ranked news items', async () => {
+    vi.spyOn(globalThis, 'fetch').mockResolvedValue({
+      ok: true,
+      text: async () => SAMPLE_RSS,
+    } as Response);
+
+    // Direct RSS parse test using the same regex logic as news.ts
+    const xml = SAMPLE_RSS;
+    const items: { rank: number; title: string; date: string; url: string }[] = [];
+    const itemRegex = /<item>([\s\S]*?)<\/item>/g;
+    let match;
+    while ((match = itemRegex.exec(xml)) && items.length < 10) {
+      const block = match[1];
+      const title = block.match(/<title>([\s\S]*?)<\/title>/)?.[1]?.trim() ?? '';
+      const url =
+        block.match(/<link><!\[CDATA\[(.*?)\]\]>/)?.[1] ??
+        block.match(/<link>(.*?)<\/link>/)?.[1] ??
+        '';
+      const pubDate = block.match(/<pubDate>(.*?)<\/pubDate>/)?.[1]?.trim() ?? '';
+      const date = pubDate.slice(0, 10);
+      if (title) items.push({ rank: items.length + 1, title, date, url: url.trim() });
+    }
+
+    expect(items).toHaveLength(3);
+    expect(items[0].rank).toBe(1);
+    expect(items[0].title).toBe('红杉中国领投AI公司「示例」，金额近2亿元');
+    expect(items[0].date).toBe('2026-03-26');
+    expect(items[0].url).toBe('https://36kr.com/p/1111111111111111?f=rss');
+  });
+
+  it('respects limit — returns at most N items', async () => {
+    const xml = SAMPLE_RSS;
+    const limit = 2;
+    const items: { rank: number; title: string; date: string; url: string }[] = [];
+    const itemRegex = /<item>([\s\S]*?)<\/item>/g;
+    let match;
+    while ((match = itemRegex.exec(xml)) && items.length < limit) {
+      const block = match[1];
+      const title = block.match(/<title>([\s\S]*?)<\/title>/)?.[1]?.trim() ?? '';
+      const url = block.match(/<link><!\[CDATA\[(.*?)\]\]>/)?.[1] ?? '';
+      const pubDate = block.match(/<pubDate>(.*?)<\/pubDate>/)?.[1]?.trim() ?? '';
+      const date = pubDate.slice(0, 10);
+      if (title) items.push({ rank: items.length + 1, title, date, url: url.trim() });
+    }
+    expect(items).toHaveLength(2);
+  });
+
+  it('skips items with empty title', async () => {
+    const xml = `<rss><channel>
+      <item><title></title><link>https://36kr.com/p/0</link><pubDate>2026-01-01</pubDate></item>
+      <item><title>有标题的文章</title><link>https://36kr.com/p/1</link><pubDate>2026-01-01</pubDate></item>
+    </channel></rss>`;
+    const items: any[] = [];
+    const itemRegex = /<item>([\s\S]*?)<\/item>/g;
+    let match;
+    while ((match = itemRegex.exec(xml))) {
+      const block = match[1];
+      const title = block.match(/<title>([\s\S]*?)<\/title>/)?.[1]?.trim() ?? '';
+      if (title) items.push({ title });
+    }
+    expect(items).toHaveLength(1);
+    expect(items[0].title).toBe('有标题的文章');
+  });
+});

package/src/clis/36kr/news.ts

@@ -0,0 +1,54 @@
+/**
+ * 36kr latest news — public RSS feed, no browser needed.
+ */
+import { cli, Strategy } from '../../registry.js';
+
+cli({
+  site: '36kr',
+  name: 'news',
+  description: 'Latest tech/startup news from 36kr (36氪)',
+  domain: 'www.36kr.com',
+  strategy: Strategy.PUBLIC,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of articles (max 50)' },
+  ],
+  columns: ['rank', 'title', 'summary', 'date', 'url'],
+  func: async (_page, kwargs) => {
+    const count = Math.min(kwargs.limit || 20, 50);
+    const resp = await fetch('https://www.36kr.com/feed', {
+      headers: { 'User-Agent': 'Mozilla/5.0 (compatible; opencli/1.0)' },
+    });
+    if (!resp.ok) return [];
+    const xml = await resp.text();
+
+    const items: { rank: number; title: string; summary: string; date: string; url: string }[] = [];
+    const itemRegex = /<item>([\s\S]*?)<\/item>/g;
+    let match;
+    while ((match = itemRegex.exec(xml)) && items.length < count) {
+      const block = match[1];
+      const title = block.match(/<title>([\s\S]*?)<\/title>/)?.[1]?.trim() ?? '';
+      const url =
+        block.match(/<link><!\[CDATA\[(.*?)\]\]>/)?.[1] ??
+        block.match(/<link>(.*?)<\/link>/)?.[1] ??
+        '';
+      const pubDate = block.match(/<pubDate>(.*?)<\/pubDate>/)?.[1]?.trim() ?? '';
+      const date = pubDate.slice(0, 10);
+      // Extract plain-text summary from HTML description (first ~120 chars)
+      const rawDesc = block.match(/<description><!\[CDATA\[([\s\S]*?)\]\]>/)?.[1] ?? '';
+      const summary = rawDesc
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 120);
+
+      if (title) {
+        items.push({ rank: items.length + 1, title, summary, date, url: url.trim() });
+      }
+    }
+    return items;
+  },
+});

package/src/clis/36kr/search.ts

@@ -0,0 +1,78 @@
+/**
+ * 36kr article search — INTERCEPT strategy.
+ *
+ * Navigates to the 36kr search results page and scrapes rendered articles.
+ */
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import type { IPage } from '../../types.js';
+
+cli({
+  site: '36kr',
+  name: 'search',
+  description: '搜索36氪文章',
+  domain: 'www.36kr.com',
+  strategy: Strategy.INTERCEPT,
+  args: [
+    { name: 'query', positional: true, required: true, help: 'Search keyword (e.g. "AI", "OpenAI")' },
+    { name: 'limit', type: 'int', default: 20, help: 'Number of results (max 50)' },
+  ],
+  columns: ['rank', 'title', 'date', 'url'],
+  func: async (page: IPage, args) => {
+    const count = Math.min(Number(args.limit) || 20, 50);
+    const query = encodeURIComponent(String(args.query ?? ''));
+
+    await page.installInterceptor('36kr.com/api');
+    await page.goto(`https://www.36kr.com/search/articles/${query}`);
+    await page.wait(6);
+
+    const domItems: any = await page.evaluate(`
+      (() => {
+        const seen = new Set();
+        const results = [];
+        // article-item-title contains the clickable title link
+        const titleEls = document.querySelectorAll('.article-item-title a[href*="/p/"], .article-item-title[href*="/p/"]');
+        for (const el of titleEls) {
+          const href = el.getAttribute('href') || '';
+          const title = el.textContent?.trim() || '';
+          if (!title || seen.has(href)) continue;
+          seen.add(href);
+          // Look for date near the article item
+          const item = el.closest('[class*="article-item"]') || el.parentElement;
+          const dateEl = item?.querySelector('[class*="time"], [class*="date"], time');
+          const date = dateEl?.textContent?.trim() || '';
+          results.push({
+            title,
+            url: href.startsWith('http') ? href : 'https://36kr.com' + href,
+            date,
+          });
+        }
+        // Fallback: generic /p/ links with meaningful text
+        if (results.length === 0) {
+          const links = document.querySelectorAll('a[href*="/p/"]');
+          for (const el of links) {
+            const href = el.getAttribute('href') || '';
+            const title = el.textContent?.trim() || '';
+            if (!title || title.length < 8 || seen.has(href) || seen.has(title)) continue;
+            seen.add(href);
+            seen.add(title);
+            results.push({ title, url: href.startsWith('http') ? href : 'https://36kr.com' + href, date: '' });
+          }
+        }
+        return results;
+      })()
+    `);
+
+    const items = Array.isArray(domItems) ? (domItems as any[]) : [];
+    if (items.length === 0) {
+      throw new CliError('NO_DATA', 'No results found', `Try a different query or check your keyword`);
+    }
+
+    return items.slice(0, count).map((item: any, i: number) => ({
+      rank: i + 1,
+      title: item.title,
+      date: item.date,
+      url: item.url,
+    }));
+  },
+});

package/src/clis/bilibili/comments.test.ts

@@ -0,0 +1,102 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const { mockApiGet } = vi.hoisted(() => ({
+  mockApiGet: vi.fn(),
+}));
+
+vi.mock('./utils.js', () => ({
+  apiGet: mockApiGet,
+}));
+
+import { getRegistry } from '../../registry.js';
+import './comments.js';
+
+describe('bilibili comments', () => {
+  const command = getRegistry().get('bilibili/comments');
+
+  beforeEach(() => {
+    mockApiGet.mockReset();
+  });
+
+  it('resolves bvid to aid and fetches replies', async () => {
+    mockApiGet
+      .mockResolvedValueOnce({ data: { aid: 12345 } }) // view endpoint
+      .mockResolvedValueOnce({
+        data: {
+          replies: [
+            {
+              member: { uname: 'Alice' },
+              content: { message: 'Great video!' },
+              like: 42,
+              rcount: 3,
+              ctime: 1700000000,
+            },
+          ],
+        },
+      });
+
+    const result = await command!.func!({} as any, { bvid: 'BV1WtAGzYEBm', limit: 5 });
+
+    expect(mockApiGet).toHaveBeenNthCalledWith(1, {}, '/x/web-interface/view', { params: { bvid: 'BV1WtAGzYEBm' } });
+    expect(mockApiGet).toHaveBeenNthCalledWith(2, {}, '/x/v2/reply/main', {
+      params: { oid: 12345, type: 1, mode: 3, ps: 5 },
+      signed: true,
+    });
+
+    expect(result).toEqual([
+      {
+        rank: 1,
+        author: 'Alice',
+        text: 'Great video!',
+        likes: 42,
+        replies: 3,
+        time: new Date(1700000000 * 1000).toISOString().slice(0, 16).replace('T', ' '),
+      },
+    ]);
+  });
+
+  it('throws when aid cannot be resolved', async () => {
+    mockApiGet.mockResolvedValueOnce({ data: {} }); // no aid
+
+    await expect(command!.func!({} as any, { bvid: 'BV_invalid', limit: 5 })).rejects.toThrow(
+      'Cannot resolve aid for bvid: BV_invalid',
+    );
+  });
+
+  it('returns empty array when replies is missing', async () => {
+    mockApiGet
+      .mockResolvedValueOnce({ data: { aid: 99 } })
+      .mockResolvedValueOnce({ data: {} }); // no replies key
+
+    const result = await command!.func!({} as any, { bvid: 'BV1xxx', limit: 5 });
+    expect(result).toEqual([]);
+  });
+
+  it('caps limit at 50', async () => {
+    mockApiGet
+      .mockResolvedValueOnce({ data: { aid: 1 } })
+      .mockResolvedValueOnce({ data: { replies: [] } });
+
+    await command!.func!({} as any, { bvid: 'BV1xxx', limit: 999 });
+
+    expect(mockApiGet).toHaveBeenNthCalledWith(2, {}, '/x/v2/reply/main', {
+      params: { oid: 1, type: 1, mode: 3, ps: 50 },
+      signed: true,
+    });
+  });
+
+  it('collapses newlines in comment text', async () => {
+    mockApiGet
+      .mockResolvedValueOnce({ data: { aid: 1 } })
+      .mockResolvedValueOnce({
+        data: {
+          replies: [
+            { member: { uname: 'Bob' }, content: { message: 'line1\nline2\nline3' }, like: 0, rcount: 0, ctime: 0 },
+          ],
+        },
+      });
+
+    const result = (await command!.func!({} as any, { bvid: 'BV1xxx', limit: 5 })) as any[];
+    expect(result[0].text).toBe('line1 line2 line3');
+  });
+});

package/src/clis/bilibili/comments.ts

@@ -0,0 +1,44 @@
+/**
+ * Bilibili comments — fetches top-level replies via the official API with WBI signing.
+ * Uses the /x/v2/reply/main endpoint which is stable and doesn't depend on DOM structure.
+ */
+
+import { cli, Strategy } from '../../registry.js';
+import { apiGet } from './utils.js';
+
+cli({
+  site: 'bilibili',
+  name: 'comments',
+  description: '获取 B站视频评论（使用官方 API + WBI 签名）',
+  domain: 'www.bilibili.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'bvid', required: true, positional: true, help: 'Video BV ID (e.g. BV1WtAGzYEBm)' },
+    { name: 'limit', type: 'int', default: 20, help: 'Number of comments (max 50)' },
+  ],
+  columns: ['rank', 'author', 'text', 'likes', 'replies', 'time'],
+  func: async (page, kwargs) => {
+    const bvid = String(kwargs.bvid).trim();
+    const limit = Math.min(Number(kwargs.limit) || 20, 50);
+
+    // Resolve bvid → aid (required by reply API)
+    const view = await apiGet(page, '/x/web-interface/view', { params: { bvid } });
+    const aid = view?.data?.aid;
+    if (!aid) throw new Error(`Cannot resolve aid for bvid: ${bvid}`);
+
+    const payload = await apiGet(page, '/x/v2/reply/main', {
+      params: { oid: aid, type: 1, mode: 3, ps: limit },
+      signed: true,
+    });
+
+    const replies: any[] = payload?.data?.replies ?? [];
+    return replies.slice(0, limit).map((r: any, i: number) => ({
+      rank: i + 1,
+      author: r.member?.uname ?? '',
+      text: (r.content?.message ?? '').replace(/\n/g, ' ').trim(),
+      likes: r.like ?? 0,
+      replies: r.rcount ?? 0,
+      time: new Date(r.ctime * 1000).toISOString().slice(0, 16).replace('T', ' '),
+    }));
+  },
+});