@jackwener/opencli 1.4.0 → 1.5.0

package/tests/e2e/browser-public.test.ts

@@ -1,5 +1,5 @@
 /**
- * E2E tests for browser commands that access PUBLIC data (no login required).
+ * E2E tests for core browser commands (bilibili, zhihu, v2ex, IMDb).
  * These use OPENCLI_HEADLESS=1 to launch a headless Chromium.
  *
  * NOTE: Some sites may block headless browsers with bot detection.
@@ -7,11 +7,8 @@
  */
 
 import { describe, it, expect } from 'vitest';
-import { runCli, parseJsonOutput } from './helpers.js';
+import { runCli, parseJsonOutput, type CliResult } from './helpers.js';
 
-/**
- * Run a browser command — returns parsed data or null on failure.
- */
 async function tryBrowserCommand(args: string[]): Promise<any[] | null> {
   const { stdout, code } = await runCli(args, { timeout: 60_000 });
   if (code !== 0) return null;
@@ -23,10 +20,6 @@ async function tryBrowserCommand(args: string[]): Promise<any[] | null> {
   }
 }
 
-/**
- * Assert browser command returns data OR log a warning if blocked.
- * Empty results (bot detection, geo-blocking) are treated as a warning, not a failure.
- */
 function expectDataOrSkip(data: any[] | null, label: string) {
   if (data === null || data.length === 0) {
     console.warn(`${label}: skipped — no data returned (likely bot detection or geo-blocking)`);
@@ -35,53 +28,47 @@ function expectDataOrSkip(data: any[] | null, label: string) {
   expect(data.length).toBeGreaterThanOrEqual(1);
 }
 
-describe('browser public-data commands E2E', () => {
+function isImdbChallenge(result: CliResult): boolean {
+  const text = `${result.stderr}\n${result.stdout}`;
+  return /IMDb blocked this request|Robot Check|Are you a robot|verify that you are human|captcha/i.test(text);
+}
 
-  // ── bbc (browser: true, strategy: public) ──
-  it('bbc news returns headlines', async () => {
-    const data = await tryBrowserCommand(['bbc', 'news', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'bbc news');
-    if (data) {
-      expect(data[0]).toHaveProperty('title');
-    }
-  }, 60_000);
+function isBrowserBridgeUnavailable(result: CliResult): boolean {
+  const text = `${result.stderr}\n${result.stdout}`;
+  return /Browser Extension is not connected|Browser Bridge extension.*not connected|Daemon is running but the Browser Extension is not connected/i.test(text);
+}
 
-  it('bloomberg news returns article detail when the article page is accessible', async () => {
-    const feedResult = await runCli(['bloomberg', 'tech', '--limit', '1', '-f', 'json']);
-    if (feedResult.code !== 0) {
-      console.warn('bloomberg news: skipped — could not load Bloomberg tech feed');
-      return;
+async function expectImdbDataOrChallengeSkip(args: string[], label: string): Promise<any[] | null> {
+  const result = await runCli(args, { timeout: 60_000 });
+  if (result.code !== 0) {
+    if (isImdbChallenge(result)) {
+      console.warn(`${label}: skipped — IMDb challenge page detected`);
+      return null;
     }
-
-    const feedItems = parseJsonOutput(feedResult.stdout);
-    const link = Array.isArray(feedItems) ? feedItems[0]?.link : null;
-    if (!link) {
-      console.warn('bloomberg news: skipped — tech feed returned no link');
-      return;
+    if (isBrowserBridgeUnavailable(result)) {
+      console.warn(`${label}: skipped — Browser Bridge extension is unavailable in this environment`);
+      return null;
     }
+    throw new Error(`${label} failed:\n${result.stderr || result.stdout}`);
+  }
 
-    const data = await tryBrowserCommand(['bloomberg', 'news', link, '-f', 'json']);
-    expectDataOrSkip(data, 'bloomberg news');
-    if (data) {
-      expect(data[0]).toHaveProperty('title');
-      expect(data[0]).toHaveProperty('summary');
-      expect(data[0]).toHaveProperty('link');
-      expect(data[0]).toHaveProperty('mediaLinks');
-      expect(data[0]).toHaveProperty('content');
-    }
-  }, 60_000);
+  const data = parseJsonOutput(result.stdout);
+  if (!Array.isArray(data)) {
+    throw new Error(`${label} returned non-array JSON:\n${result.stdout.slice(0, 500)}`);
+  }
+  if (data.length === 0) {
+    throw new Error(`${label} returned an empty result`);
+  }
+  return data;
+}
 
-  // ── v2ex daily (browser: true) ──
-  it('v2ex daily returns topics', async () => {
-    const data = await tryBrowserCommand(['v2ex', 'daily', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'v2ex daily');
-  }, 60_000);
+describe('browser public-data commands E2E', () => {
 
-  // ── bilibili (browser: true, cookie strategy) ──
+  // ── bilibili ──
   it('bilibili hot returns trending videos', async () => {
     const data = await tryBrowserCommand(['bilibili', 'hot', '--limit', '5', '-f', 'json']);
     expectDataOrSkip(data, 'bilibili hot');
-    if (data) {
+    if (data?.length) {
       expect(data[0]).toHaveProperty('title');
     }
   }, 60_000);
@@ -96,22 +83,11 @@ describe('browser public-data commands E2E', () => {
     expectDataOrSkip(data, 'bilibili search');
   }, 60_000);
 
-  // ── weibo (browser: true, cookie strategy) ──
-  it('weibo hot returns trending topics', async () => {
-    const data = await tryBrowserCommand(['weibo', 'hot', '--limit', '5', '-f', 'json']);
-    expectDataOrSkip(data, 'weibo hot');
-  }, 60_000);
-
-  it('weibo search returns results', async () => {
-    const data = await tryBrowserCommand(['weibo', 'search', 'openai', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'weibo search');
-  }, 60_000);
-
-  // ── zhihu (browser: true, cookie strategy) ──
+  // ── zhihu ──
   it('zhihu hot returns trending questions', async () => {
     const data = await tryBrowserCommand(['zhihu', 'hot', '--limit', '5', '-f', 'json']);
     expectDataOrSkip(data, 'zhihu hot');
-    if (data) {
+    if (data?.length) {
       expect(data[0]).toHaveProperty('title');
     }
   }, 60_000);
@@ -121,90 +97,33 @@ describe('browser public-data commands E2E', () => {
     expectDataOrSkip(data, 'zhihu search');
   }, 60_000);
 
-  // ── reddit (browser: true, cookie strategy) ──
-  it('reddit hot returns posts', async () => {
-    const data = await tryBrowserCommand(['reddit', 'hot', '--limit', '5', '-f', 'json']);
-    expectDataOrSkip(data, 'reddit hot');
-  }, 60_000);
-
-  it('reddit frontpage returns posts', async () => {
-    const data = await tryBrowserCommand(['reddit', 'frontpage', '--limit', '5', '-f', 'json']);
-    expectDataOrSkip(data, 'reddit frontpage');
-  }, 60_000);
-
-  // ── twitter (browser: true) ──
-  it('twitter trending returns trends', async () => {
-    const data = await tryBrowserCommand(['twitter', 'trending', '--limit', '5', '-f', 'json']);
-    expectDataOrSkip(data, 'twitter trending');
-  }, 60_000);
-
-  // ── xueqiu (browser: true, cookie strategy) ──
-  it('xueqiu hot returns hot posts', async () => {
-    const data = await tryBrowserCommand(['xueqiu', 'hot', '--limit', '5', '-f', 'json']);
-    expectDataOrSkip(data, 'xueqiu hot');
-  }, 60_000);
-
-  it('xueqiu hot-stock returns stocks', async () => {
-    const data = await tryBrowserCommand(['xueqiu', 'hot-stock', '--limit', '5', '-f', 'json']);
-    expectDataOrSkip(data, 'xueqiu hot-stock');
-  }, 60_000);
-
-  // ── reuters (browser: true) ──
-  it('reuters search returns articles', async () => {
-    const data = await tryBrowserCommand(['reuters', 'search', 'technology', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'reuters search');
-  }, 60_000);
-
-  // ── youtube (browser: true) ──
-  it('youtube search returns videos', async () => {
-    const data = await tryBrowserCommand(['youtube', 'search', 'typescript tutorial', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'youtube search');
-  }, 60_000);
-
-  // ── smzdm (browser: true) ──
-  it('smzdm search returns deals', async () => {
-    const data = await tryBrowserCommand(['smzdm', 'search', '键盘', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'smzdm search');
-  }, 60_000);
-
-  // ── boss (browser: true) ──
-  it('boss search returns jobs', async () => {
-    const data = await tryBrowserCommand(['boss', 'search', 'golang', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'boss search');
-  }, 60_000);
-
-  // ── ctrip (browser: true) ──
-  it('ctrip search returns flights', async () => {
-    const data = await tryBrowserCommand(['ctrip', 'search', '-f', 'json']);
-    expectDataOrSkip(data, 'ctrip search');
-  }, 60_000);
-
-  // ── coupang (browser: true) ──
-  it('coupang search returns products', async () => {
-    const data = await tryBrowserCommand(['coupang', 'search', 'laptop', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'coupang search');
+  // ── v2ex ──
+  it('v2ex daily returns topics', async () => {
+    const data = await tryBrowserCommand(['v2ex', 'daily', '--limit', '3', '-f', 'json']);
+    expectDataOrSkip(data, 'v2ex daily');
   }, 60_000);
 
-  // ── xiaohongshu (browser: true) ──
-  it('xiaohongshu search returns notes', async () => {
-    const data = await tryBrowserCommand(['xiaohongshu', 'search', '美食', '--limit', '3', '-f', 'json']);
-    expectDataOrSkip(data, 'xiaohongshu search');
+  // ── imdb ──
+  it('imdb top returns chart data', async () => {
+    const data = await expectImdbDataOrChallengeSkip(['imdb', 'top', '--limit', '3', '-f', 'json'], 'imdb top');
+    if (data?.length) {
+      expect(data[0]).toHaveProperty('title');
+    }
   }, 60_000);
 
-  // ── google search (browser: true, public strategy) ──
-  it('google search returns results', async () => {
-    const data = await tryBrowserCommand(['google', 'search', 'typescript', '--limit', '5', '-f', 'json']);
-    expectDataOrSkip(data, 'google search');
-    if (data) {
-      expect(data[0]).toHaveProperty('type');
+  it('imdb search returns results', async () => {
+    const data = await expectImdbDataOrChallengeSkip(['imdb', 'search', 'inception', '--limit', '3', '-f', 'json'], 'imdb search');
+    if (data?.length) {
+      expect(data[0]).toHaveProperty('id');
       expect(data[0]).toHaveProperty('title');
-      expect(data[0]).toHaveProperty('url');
     }
   }, 60_000);
 
-  // ── yahoo-finance (browser: true) ──
-  it('yahoo-finance quote returns stock data', async () => {
-    const data = await tryBrowserCommand(['yahoo-finance', 'quote', '--symbol', 'AAPL', '-f', 'json']);
-    expectDataOrSkip(data, 'yahoo-finance quote');
+  it('imdb title returns movie details', async () => {
+    const data = await expectImdbDataOrChallengeSkip(['imdb', 'title', 'tt1375666', '-f', 'json'], 'imdb title');
+    if (data?.length) {
+      expect(data[0]).toHaveProperty('field');
+      expect(data[0]).toHaveProperty('value');
+    }
   }, 60_000);
 });

package/tests/e2e/helpers.ts

@@ -29,7 +29,8 @@ export async function runCli(
 ): Promise<CliResult> {
   const timeout = opts.timeout ?? 30_000;
   try {
-    const { stdout, stderr } = await exec('node', [MAIN, ...args], {
+    const runtime = process.env.OPENCLI_TEST_RUNTIME || 'node';
+    const { stdout, stderr } = await exec(runtime, [MAIN, ...args], {
       cwd: ROOT,
       timeout,
       env: {

package/tests/e2e/public-commands.test.ts

@@ -4,14 +4,19 @@
  */
 
 import { describe, expect, it } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
 import { parseJsonOutput, runCli } from './helpers.js';
 
 function isExpectedChineseSiteRestriction(code: number, stderr: string): boolean {
   if (code === 0) return false;
   // Overseas CI runners may get HTTP errors, geo-blocks, DNS failures,
-  // or receive mangled HTML that fails parsing.
+  // or receive mangled HTML that fails parsing. Some runners also fail
+  // without surfacing a useful stderr payload.
   return /Error \[(FETCH_ERROR|PARSE_ERROR|NOT_FOUND)\]/.test(stderr)
-    || /fetch failed/.test(stderr);
+    || /fetch failed/.test(stderr)
+    || stderr.trim() === '';
 }
 
 function isExpectedApplePodcastsRestriction(code: number, stderr: string): boolean {
@@ -126,6 +131,35 @@ describe('public commands E2E', () => {
     expect(data[0]).toHaveProperty('id');
   }, 30_000);
 
+  it('paperreview submit dry-run validates a local PDF without remote upload', async () => {
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'opencli-paperreview-'));
+    const pdfPath = path.join(tempDir, 'sample.pdf');
+    await fs.writeFile(pdfPath, Buffer.concat([Buffer.from('%PDF-1.4\n'), Buffer.alloc(256, 1)]));
+
+    const { stdout, code } = await runCli([
+      'paperreview',
+      'submit',
+      pdfPath,
+      '--email',
+      'wang2629651228@gmail.com',
+      '--venue',
+      'RAL',
+      '--dry-run',
+      'true',
+      '-f',
+      'json',
+    ]);
+
+    expect(code).toBe(0);
+    const data = parseJsonOutput(stdout);
+    expect(data).toMatchObject({
+      status: 'dry-run',
+      file: 'sample.pdf',
+      email: 'wang2629651228@gmail.com',
+      venue: 'RAL',
+    });
+  }, 30_000);
+
   // ── hackernews ──
   it('hackernews top returns structured data', async () => {
     const { stdout, code } = await runCli(['hackernews', 'top', '--limit', '3', '-f', 'json']);
@@ -235,7 +269,7 @@ describe('public commands E2E', () => {
 
   it('v2ex topic returns topic detail', async () => {
     // Topic 1000001 is a well-known V2EX topic
-    const { stdout, code } = await runCli(['v2ex', 'topic', '--id', '1000001', '-f', 'json']);
+    const { stdout, code } = await runCli(['v2ex', 'topic', '1000001', '-f', 'json']);
     // May fail if V2EX rate-limits, but should return structured data
     if (code === 0) {
       const data = parseJsonOutput(stdout);

package/tests/smoke/api-health.test.ts

@@ -38,7 +38,7 @@ describe('API health smoke tests', () => {
   }, 30_000);
 
   it('v2ex topic API is responsive', async () => {
-    const { stdout, code } = await runCli(['v2ex', 'topic', '--id', '1000001', '-f', 'json']);
+    const { stdout, code } = await runCli(['v2ex', 'topic', '1000001', '-f', 'json']);
     if (code === 0) {
       const data = parseJsonOutput(stdout);
       expect(data).toBeDefined();

package/vitest.config.ts

@@ -1,5 +1,7 @@
 import { defineConfig } from 'vitest/config';
 
+const includeExtendedE2e = process.env.OPENCLI_E2E === '1';
+
 export default defineConfig({
   test: {
     projects: [
@@ -8,37 +10,52 @@ export default defineConfig({
           name: 'unit',
           include: ['src/**/*.test.ts'],
           exclude: ['src/clis/**/*.test.ts'],
-          // Run unit tests before e2e tests to avoid project-level contention in CI.
-          sequence: {
-            groupOrder: 0,
-          },
+          sequence: { groupOrder: 0 },
         },
       },
       {
         test: {
           name: 'adapter',
           include: [
-            'src/clis/zhihu/**/*.test.ts',
-            'src/clis/twitter/**/*.test.ts',
-            'src/clis/reddit/**/*.test.ts',
             'src/clis/bilibili/**/*.test.ts',
-            'src/clis/linkedin/**/*.test.ts',
-            'src/clis/grok/**/*.test.ts',
-            'src/clis/pixiv/**/*.test.ts',
+            'src/clis/imdb/**/*.test.ts',
+            'src/clis/jd/**/*.test.ts',
+            'src/clis/linux-do/**/*.test.ts',
+            'src/clis/xiaohongshu/**/*.test.ts',
+            'src/clis/twitter/**/*.test.ts',
+            'src/clis/douban/**/*.test.ts',
+            'src/clis/zhihu/**/*.test.ts',
+            'src/clis/v2ex/**/*.test.ts',
+            'src/clis/weread/**/*.test.ts',
+            'src/clis/36kr/**/*.test.ts',
+            'src/clis/producthunt/**/*.test.ts',
+            'src/clis/paperreview/**/*.test.ts',
           ],
-          sequence: {
-            groupOrder: 1,
-          },
+          sequence: { groupOrder: 1 },
         },
       },
       {
         test: {
           name: 'e2e',
-          include: ['tests/**/*.test.ts'],
+          include: [
+            'tests/e2e/browser-public.test.ts',
+            'tests/e2e/public-commands.test.ts',
+            'tests/e2e/management.test.ts',
+            'tests/e2e/output-formats.test.ts',
+            'tests/e2e/plugin-management.test.ts',
+            // Extended browser tests (20+ sites) — opt-in only:
+            //   OPENCLI_E2E=1 npx vitest run
+            ...(includeExtendedE2e ? ['tests/e2e/browser-public-extended.test.ts', 'tests/e2e/browser-auth.test.ts'] : []),
+          ],
           maxWorkers: 2,
-          sequence: {
-            groupOrder: 2,
-          },
+          sequence: { groupOrder: 2 },
+        },
+      },
+      {
+        test: {
+          name: 'smoke',
+          include: ['tests/smoke/**/*.test.ts'],
+          sequence: { groupOrder: 3 },
         },
       },
     ],

package/dist/clis/linux-do/category.yaml

@@ -1,51 +0,0 @@
-site: linux-do
-name: category
-description: linux.do 分类内话题
-domain: linux.do
-browser: true
-
-args:
-  slug:
-    positional: true
-    type: str
-    required: true
-    description: Category slug (use 'categories' command to find)
-  id:
-    positional: true
-    type: int
-    required: true
-    description: Category ID (use 'categories' command to find)
-  limit:
-    type: int
-    default: 20
-    description: Number of topics
-
-pipeline:
-  - navigate: https://linux.do
-
-  - evaluate: |
-      (async () => {
-        const slug = ${{ args.slug | json }};
-        const res = await fetch('/c/' + encodeURIComponent(slug) + '/${{ args.id }}.json', { credentials: 'include' });
-        if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
-        let data;
-        try { data = await res.json(); } catch { throw new Error('响应不是有效 JSON - 请先登录 linux.do'); }
-        const topics = data?.topic_list?.topics || [];
-        return topics.slice(0, ${{ args.limit }}).map(t => ({
-          title: t.title,
-          replies: (t.posts_count || 1) - 1,
-          views: t.views,
-          likes: t.like_count,
-        }));
-      })()
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      replies: ${{ item.replies }}
-      views: ${{ item.views }}
-      likes: ${{ item.likes }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, replies, views, likes]

package/dist/clis/linux-do/hot.yaml

@@ -1,50 +0,0 @@
-site: linux-do
-name: hot
-description: linux.do 热门话题
-domain: linux.do
-browser: true
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of topics
-  period:
-    type: str
-    default: weekly
-    description: Time period
-    choices: [all, daily, weekly, monthly, yearly]
-
-pipeline:
-  - navigate: https://linux.do
-
-  - evaluate: |
-      (async () => {
-        const period = ${{ args.period | json }};
-        const res = await fetch('/top.json?period=' + encodeURIComponent(period), { credentials: 'include' });
-        if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
-        let data;
-        try { data = await res.json(); } catch { throw new Error('响应不是有效 JSON - 请先登录 linux.do'); }
-        const topics = data?.topic_list?.topics || [];
-        const cats = data?.topic_list?.categories || data?.categories || [];
-        const catMap = Object.fromEntries(cats.map(c => [c.id, c.name]));
-        return topics.slice(0, ${{ args.limit }}).map(t => ({
-          title: t.title,
-          replies: (t.posts_count || 1) - 1,
-          views: t.views,
-          likes: t.like_count,
-          category: catMap[t.category_id] || String(t.category_id),
-        }));
-      })()
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      replies: ${{ item.replies }}
-      views: ${{ item.views }}
-      likes: ${{ item.likes }}
-      category: ${{ item.category }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, replies, views, likes, category]

package/dist/clis/linux-do/latest.yaml

@@ -1,40 +0,0 @@
-site: linux-do
-name: latest
-description: linux.do 最新话题
-domain: linux.do
-browser: true
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of topics
-
-pipeline:
-  - navigate: https://linux.do
-
-  - evaluate: |
-      (async () => {
-        const res = await fetch('/latest.json', { credentials: 'include' });
-        if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
-        let data;
-        try { data = await res.json(); } catch { throw new Error('响应不是有效 JSON - 请先登录 linux.do'); }
-        const topics = data?.topic_list?.topics || [];
-        return topics.slice(0, ${{ args.limit }}).map(t => ({
-          title: t.title,
-          replies: (t.posts_count || 1) - 1,
-          views: t.views,
-          likes: t.like_count,
-        }));
-      })()
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      replies: ${{ item.replies }}
-      views: ${{ item.views }}
-      likes: ${{ item.likes }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, replies, views, likes]

package/src/clis/linux-do/category.yaml

@@ -1,51 +0,0 @@
-site: linux-do
-name: category
-description: linux.do 分类内话题
-domain: linux.do
-browser: true
-
-args:
-  slug:
-    positional: true
-    type: str
-    required: true
-    description: Category slug (use 'categories' command to find)
-  id:
-    positional: true
-    type: int
-    required: true
-    description: Category ID (use 'categories' command to find)
-  limit:
-    type: int
-    default: 20
-    description: Number of topics
-
-pipeline:
-  - navigate: https://linux.do
-
-  - evaluate: |
-      (async () => {
-        const slug = ${{ args.slug | json }};
-        const res = await fetch('/c/' + encodeURIComponent(slug) + '/${{ args.id }}.json', { credentials: 'include' });
-        if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
-        let data;
-        try { data = await res.json(); } catch { throw new Error('响应不是有效 JSON - 请先登录 linux.do'); }
-        const topics = data?.topic_list?.topics || [];
-        return topics.slice(0, ${{ args.limit }}).map(t => ({
-          title: t.title,
-          replies: (t.posts_count || 1) - 1,
-          views: t.views,
-          likes: t.like_count,
-        }));
-      })()
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      replies: ${{ item.replies }}
-      views: ${{ item.views }}
-      likes: ${{ item.likes }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, replies, views, likes]

package/src/clis/linux-do/hot.yaml

@@ -1,50 +0,0 @@
-site: linux-do
-name: hot
-description: linux.do 热门话题
-domain: linux.do
-browser: true
-
-args:
-  limit:
-    type: int
-    default: 20
-    description: Number of topics
-  period:
-    type: str
-    default: weekly
-    description: Time period
-    choices: [all, daily, weekly, monthly, yearly]
-
-pipeline:
-  - navigate: https://linux.do
-
-  - evaluate: |
-      (async () => {
-        const period = ${{ args.period | json }};
-        const res = await fetch('/top.json?period=' + encodeURIComponent(period), { credentials: 'include' });
-        if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
-        let data;
-        try { data = await res.json(); } catch { throw new Error('响应不是有效 JSON - 请先登录 linux.do'); }
-        const topics = data?.topic_list?.topics || [];
-        const cats = data?.topic_list?.categories || data?.categories || [];
-        const catMap = Object.fromEntries(cats.map(c => [c.id, c.name]));
-        return topics.slice(0, ${{ args.limit }}).map(t => ({
-          title: t.title,
-          replies: (t.posts_count || 1) - 1,
-          views: t.views,
-          likes: t.like_count,
-          category: catMap[t.category_id] || String(t.category_id),
-        }));
-      })()
-
-  - map:
-      rank: ${{ index + 1 }}
-      title: ${{ item.title }}
-      replies: ${{ item.replies }}
-      views: ${{ item.views }}
-      likes: ${{ item.likes }}
-      category: ${{ item.category }}
-
-  - limit: ${{ args.limit }}
-
-columns: [rank, title, replies, views, likes, category]