@huyuan-ai/cli 1.0.0 → 1.0.1

package/vendor/opencli/dist/clis/yuanbao/shared.js

@@ -0,0 +1,49 @@
+import { AuthRequiredError } from '../../errors.js';
+export const YUANBAO_DOMAIN = 'yuanbao.tencent.com';
+export const YUANBAO_URL = 'https://yuanbao.tencent.com/';
+const SESSION_HINT = 'Likely login/auth/challenge/session issue in the existing yuanbao.tencent.com browser session.';
+/**
+ * Reusable visibility check for injected browser scripts.
+ * Embed in page.evaluate strings via `${IS_VISIBLE_JS}`.
+ */
+export const IS_VISIBLE_JS = `const isVisible = (node) => {
+  if (!(node instanceof HTMLElement)) return false;
+  const rect = node.getBoundingClientRect();
+  const style = window.getComputedStyle(node);
+  return rect.width > 0
+    && rect.height > 0
+    && style.display !== 'none'
+    && style.visibility !== 'hidden';
+};`;
+export function authRequired(message) {
+    return new AuthRequiredError(YUANBAO_DOMAIN, `${message} ${SESSION_HINT}`);
+}
+export async function isOnYuanbao(page) {
+    const url = await page.evaluate('window.location.href').catch(() => '');
+    if (typeof url !== 'string' || !url)
+        return false;
+    try {
+        const hostname = new URL(url).hostname;
+        return hostname === YUANBAO_DOMAIN || hostname.endsWith(`.${YUANBAO_DOMAIN}`);
+    }
+    catch {
+        return false;
+    }
+}
+export async function ensureYuanbaoPage(page) {
+    if (!(await isOnYuanbao(page))) {
+        await page.goto(YUANBAO_URL, { waitUntil: 'load', settleMs: 2500 });
+        await page.wait(1);
+    }
+}
+export async function hasLoginGate(page) {
+    const result = await page.evaluate(`(() => {
+    const bodyText = document.body.innerText || '';
+    const hasWechatLoginText = bodyText.includes('微信扫码登录');
+    const hasWechatIframe = Array.from(document.querySelectorAll('iframe'))
+      .some((frame) => (frame.getAttribute('src') || '').includes('open.weixin.qq.com/connect/qrconnect'));
+
+    return hasWechatLoginText || hasWechatIframe;
+  })()`);
+    return Boolean(result);
+}

package/vendor/opencli/dist/clis/zhihu/download.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Zhihu download — export articles to Markdown format.
+ *
+ * Usage:
+ *   opencli zhihu download --url "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
+ */
+export {};

package/vendor/opencli/dist/clis/zhihu/download.js

@@ -0,0 +1,79 @@
+/**
+ * Zhihu download — export articles to Markdown format.
+ *
+ * Usage:
+ *   opencli zhihu download --url "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
+ */
+import { cli, Strategy } from '../../registry.js';
+import { downloadArticle } from '../../download/article-download.js';
+cli({
+    site: 'zhihu',
+    name: 'download',
+    description: '导出知乎文章为 Markdown 格式',
+    domain: 'zhuanlan.zhihu.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'url', required: true, help: 'Article URL (zhuanlan.zhihu.com/p/xxx)' },
+        { name: 'output', default: './zhihu-articles', help: 'Output directory' },
+        { name: 'download-images', type: 'boolean', default: false, help: 'Download images locally' },
+    ],
+    columns: ['title', 'author', 'publish_time', 'status', 'size'],
+    func: async (page, kwargs) => {
+        const url = kwargs.url;
+        // Navigate to article page
+        await page.goto(url);
+        await page.wait(3);
+        // Extract article content
+        const data = await page.evaluate(`
+      (() => {
+        const result = {
+          title: '',
+          author: '',
+          publishTime: '',
+          contentHtml: '',
+          imageUrls: []
+        };
+
+        // Get title
+        const titleEl = document.querySelector('.Post-Title, h1.ContentItem-title, .ArticleTitle');
+        result.title = titleEl?.textContent?.trim() || 'untitled';
+
+        // Get author
+        const authorEl = document.querySelector('.AuthorInfo-name, .UserLink-link');
+        result.author = authorEl?.textContent?.trim() || 'unknown';
+
+        // Get publish time
+        const timeEl = document.querySelector('.ContentItem-time, .Post-Time');
+        result.publishTime = timeEl?.textContent?.trim() || '';
+
+        // Get content HTML
+        const contentEl = document.querySelector('.Post-RichTextContainer, .RichText, .ArticleContent');
+        if (contentEl) {
+          result.contentHtml = contentEl.innerHTML;
+
+          // Extract image URLs
+          contentEl.querySelectorAll('img').forEach(img => {
+            const src = img.getAttribute('data-original') || img.getAttribute('data-actualsrc') || img.src;
+            if (src && !src.includes('data:image')) {
+              result.imageUrls.push(src);
+            }
+          });
+        }
+
+        return result;
+      })()
+    `);
+        return downloadArticle({
+            title: data?.title || '',
+            author: data?.author,
+            publishTime: data?.publishTime,
+            sourceUrl: url,
+            contentHtml: data?.contentHtml || '',
+            imageUrls: data?.imageUrls,
+        }, {
+            output: kwargs.output,
+            downloadImages: kwargs['download-images'],
+            imageHeaders: { Referer: 'https://zhuanlan.zhihu.com/' },
+        });
+    },
+});

package/vendor/opencli/dist/clis/zhihu/download.test.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/zhihu/download.test.js

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest';
+import TurndownService from 'turndown';
+describe('article markdown conversion', () => {
+    it('renders ordered lists with the original list item content', () => {
+        const html = '<ol><li>First item</li><li>Second item</li></ol>';
+        const td = new TurndownService({ headingStyle: 'atx', bulletListMarker: '-' });
+        const md = td.turndown(html);
+        expect(md).toMatch(/1\.\s+First item/);
+        expect(md).toMatch(/2\.\s+Second item/);
+        expect(md).not.toContain('$1');
+    });
+});

package/vendor/opencli/dist/clis/zhihu/hot.yaml

@@ -0,0 +1,46 @@
+site: zhihu
+name: hot
+description: 知乎热榜
+domain: www.zhihu.com
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of items to return
+
+pipeline:
+  - navigate: https://www.zhihu.com
+
+  - evaluate: |
+      (async () => {
+        const res = await fetch('https://www.zhihu.com/api/v3/feed/topstory/hot-lists/total?limit=50', {
+          credentials: 'include'
+        });
+        const text = await res.text();
+        const d = JSON.parse(
+          text.replace(/("id"\s*:\s*)(\d{16,})/g, '$1"$2"')
+        );
+        return (d?.data || []).map((item) => {
+          const t = item.target || {};
+          const questionId = t.id == null ? '' : String(t.id);
+          return {
+            title: t.title,
+            url: 'https://www.zhihu.com/question/' + questionId,
+            answer_count: t.answer_count,
+            follower_count: t.follower_count,
+            heat: item.detail_text || '',
+          };
+        });
+      })()
+
+  - map:
+      rank: ${{ index + 1 }}
+      title: ${{ item.title }}
+      heat: ${{ item.heat }}
+      answers: ${{ item.answer_count }}
+      url: ${{ item.url }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, title, heat, answers]

package/vendor/opencli/dist/clis/zhihu/question.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/zhihu/question.js

@@ -0,0 +1,53 @@
+import { cli, Strategy } from '../../registry.js';
+import { AuthRequiredError, CliError } from '../../errors.js';
+function stripHtml(html) {
+    return html
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&')
+        .trim();
+}
+cli({
+    site: 'zhihu',
+    name: 'question',
+    description: '知乎问题详情和回答',
+    domain: 'www.zhihu.com',
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: 'id', required: true, positional: true, help: 'Question ID (numeric)' },
+        { name: 'limit', type: 'int', default: 5, help: 'Number of answers' },
+    ],
+    columns: ['rank', 'author', 'votes', 'content'],
+    func: async (page, kwargs) => {
+        const { id, limit = 5 } = kwargs;
+        const questionId = String(id);
+        if (!/^\d+$/.test(questionId)) {
+            throw new CliError('INVALID_INPUT', 'Question ID must be numeric', 'Example: opencli zhihu question 123456789');
+        }
+        const answerLimit = Number(limit);
+        await page.goto(`https://www.zhihu.com/question/${questionId}`);
+        const url = `https://www.zhihu.com/api/v4/questions/${questionId}/answers?limit=${answerLimit}&offset=0&sort_by=default&include=data[*].content,voteup_count,comment_count,author`;
+        const data = await page.evaluate(`
+      (async () => {
+        const r = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+        if (!r.ok) return { __httpError: r.status };
+        return await r.json();
+      })()
+    `);
+        if (!data || data.__httpError) {
+            const status = data?.__httpError;
+            if (status === 401 || status === 403) {
+                throw new AuthRequiredError('www.zhihu.com', 'Failed to fetch question data from Zhihu');
+            }
+            throw new CliError('FETCH_ERROR', status ? `Zhihu question answers request failed (HTTP ${status})` : 'Zhihu question answers request failed', 'Try again later or rerun with -v for more detail');
+        }
+        return (data.data || []).map((item, i) => ({
+            rank: i + 1,
+            author: item.author?.name || 'anonymous',
+            votes: item.voteup_count || 0,
+            content: stripHtml(item.content || '').substring(0, 200),
+        }));
+    },
+});

package/vendor/opencli/dist/clis/zhihu/question.test.d.ts

@@ -0,0 +1 @@
+import './question.js';

package/vendor/opencli/dist/clis/zhihu/question.test.js

@@ -0,0 +1,72 @@
+import { describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import { AuthRequiredError, CliError } from '../../errors.js';
+import './question.js';
+describe('zhihu question', () => {
+    it('returns answers from the Zhihu API', async () => {
+        const cmd = getRegistry().get('zhihu/question');
+        expect(cmd?.func).toBeTypeOf('function');
+        const goto = vi.fn().mockResolvedValue(undefined);
+        const evaluate = vi.fn().mockImplementation(async (js) => {
+            expect(js).toContain('questions/2021881398772981878/answers?limit=3');
+            expect(js).toContain("credentials: 'include'");
+            return {
+                data: [
+                    {
+                        author: { name: 'alice' },
+                        voteup_count: 12,
+                        content: 'Hello Zhihu',
+                    },
+                ],
+            };
+        });
+        const page = { goto, evaluate };
+        await expect(cmd.func(page, { id: '2021881398772981878', limit: 3 })).resolves.toEqual([
+            {
+                rank: 1,
+                author: 'alice',
+                votes: 12,
+                content: 'Hello Zhihu',
+            },
+        ]);
+        expect(goto).toHaveBeenCalledWith('https://www.zhihu.com/question/2021881398772981878');
+        expect(evaluate).toHaveBeenCalledTimes(1);
+    });
+    it('maps auth-like answer failures to AuthRequiredError', async () => {
+        const cmd = getRegistry().get('zhihu/question');
+        const page = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue({ __httpError: 403 }),
+        };
+        await expect(cmd.func(page, { id: '2021881398772981878', limit: 3 })).rejects.toBeInstanceOf(AuthRequiredError);
+    });
+    it('preserves non-auth fetch failures as CliError', async () => {
+        const cmd = getRegistry().get('zhihu/question');
+        const page = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue({ __httpError: 500 }),
+        };
+        await expect(cmd.func(page, { id: '2021881398772981878', limit: 3 })).rejects.toMatchObject({
+            code: 'FETCH_ERROR',
+            message: 'Zhihu question answers request failed (HTTP 500)',
+        });
+    });
+    it('handles null evaluate response as fetch error', async () => {
+        const cmd = getRegistry().get('zhihu/question');
+        const page = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn().mockResolvedValue(null),
+        };
+        await expect(cmd.func(page, { id: '2021881398772981878', limit: 3 })).rejects.toMatchObject({
+            code: 'FETCH_ERROR',
+            message: 'Zhihu question answers request failed',
+        });
+    });
+    it('rejects non-numeric question IDs', async () => {
+        const cmd = getRegistry().get('zhihu/question');
+        const page = { goto: vi.fn(), evaluate: vi.fn() };
+        await expect(cmd.func(page, { id: "abc'; alert(1); //", limit: 1 })).rejects.toBeInstanceOf(CliError);
+        expect(page.goto).not.toHaveBeenCalled();
+        expect(page.evaluate).not.toHaveBeenCalled();
+    });
+});

package/vendor/opencli/dist/clis/zhihu/search.yaml

@@ -0,0 +1,59 @@
+site: zhihu
+name: search
+description: 知乎搜索
+domain: www.zhihu.com
+
+args:
+  query:
+    positional: true
+    type: str
+    required: true
+    description: Search query
+  limit:
+    type: int
+    default: 10
+    description: Number of results
+
+pipeline:
+  - navigate: https://www.zhihu.com
+
+  - evaluate: |
+      (async () => {
+        const strip = (html) => (html || '').replace(/<[^>]+>/g, '').replace(/&nbsp;/g, ' ').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&').replace(/<em>/g, '').replace(/<\/em>/g, '').trim();
+        const keyword = ${{ args.query | json }};
+        const limit = ${{ args.limit }};
+        const res = await fetch('https://www.zhihu.com/api/v4/search_v3?q=' + encodeURIComponent(keyword) + '&t=general&offset=0&limit=' + limit, {
+          credentials: 'include'
+        });
+        const d = await res.json();
+        return (d?.data || [])
+          .filter(item => item.type === 'search_result')
+          .map(item => {
+            const obj = item.object || {};
+            const q = obj.question || {};
+            return {
+              type: obj.type,
+              title: strip(obj.title || q.name || ''),
+              excerpt: strip(obj.excerpt || '').substring(0, 100),
+              author: obj.author?.name || '',
+              votes: obj.voteup_count || 0,
+              url: obj.type === 'answer'
+                ? 'https://www.zhihu.com/question/' + q.id + '/answer/' + obj.id
+                : obj.type === 'article'
+                ? 'https://zhuanlan.zhihu.com/p/' + obj.id
+                : 'https://www.zhihu.com/question/' + obj.id,
+            };
+          });
+      })()
+
+  - map:
+      rank: ${{ index + 1 }}
+      title: ${{ item.title }}
+      type: ${{ item.type }}
+      author: ${{ item.author }}
+      votes: ${{ item.votes }}
+      url: ${{ item.url }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, title, type, author, votes, url]

package/vendor/opencli/dist/clis/zsxq/dynamics.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/zsxq/dynamics.js

@@ -0,0 +1,47 @@
+import { cli, Strategy } from '../../registry.js';
+import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getTopicText, getTopicAuthor, getTopicUrl, } from './utils.js';
+cli({
+    site: 'zsxq',
+    name: 'dynamics',
+    description: '获取所有星球的最新动态',
+    domain: 'wx.zsxq.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 20, help: 'Number of dynamics to return' },
+    ],
+    columns: ['time', 'group', 'author', 'title', 'comments', 'likes', 'url'],
+    func: async (page, kwargs) => {
+        await ensureZsxqPage(page);
+        await ensureZsxqAuth(page);
+        const limit = Math.max(1, Number(kwargs.limit) || 20);
+        const { data } = await fetchFirstJson(page, [
+            `https://api.zsxq.com/v2/dynamics?scope=general&count=${limit}`,
+        ]);
+        const respData = data?.resp_data || data;
+        const dynamics = respData?.dynamics || [];
+        return dynamics.slice(0, limit).map((d) => {
+            const topic = d.topic;
+            if (!topic) {
+                return {
+                    time: d.create_time || '',
+                    group: '',
+                    author: '',
+                    title: `[${d.action || 'unknown'}]`,
+                    comments: 0,
+                    likes: 0,
+                    url: '',
+                };
+            }
+            return {
+                time: d.create_time || topic.create_time || '',
+                group: topic.group?.name || '',
+                author: getTopicAuthor(topic),
+                title: getTopicText(topic).slice(0, 120),
+                comments: topic.comments_count ?? 0,
+                likes: topic.likes_count ?? 0,
+                url: getTopicUrl(topic.topic_id),
+            };
+        });
+    },
+});

package/vendor/opencli/dist/clis/zsxq/groups.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/zsxq/groups.js

@@ -0,0 +1,32 @@
+import { cli, Strategy } from '../../registry.js';
+import { ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGroupsFromResponse, } from './utils.js';
+cli({
+    site: 'zsxq',
+    name: 'groups',
+    description: '列出当前账号加入的星球',
+    domain: 'wx.zsxq.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'limit', type: 'int', default: 50, help: 'Number of groups to return' },
+    ],
+    columns: ['group_id', 'name', 'category', 'members', 'topics', 'joined_at', 'url'],
+    func: async (page, kwargs) => {
+        await ensureZsxqPage(page);
+        await ensureZsxqAuth(page);
+        const limit = Math.max(1, Number(kwargs.limit) || 50);
+        const { data } = await fetchFirstJson(page, [
+            `https://api.zsxq.com/v2/groups`,
+        ]);
+        return getGroupsFromResponse(data).slice(0, limit).map((group) => ({
+            group_id: group.group_id ?? '',
+            name: group.name || '',
+            category: group.category?.title || '',
+            members: group.statistics?.subscriptions_count ?? 0,
+            topics: group.statistics?.topics_count ?? 0,
+            joined_at: group.user_specific?.join_time || '',
+            valid_until: group.user_specific?.validity?.end_time || '',
+            url: group.group_id ? `https://wx.zsxq.com/group/${group.group_id}` : 'https://wx.zsxq.com',
+        }));
+    },
+});

package/vendor/opencli/dist/clis/zsxq/search.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/zsxq/search.js

@@ -0,0 +1,43 @@
+import { cli, Strategy } from '../../registry.js';
+import { getActiveGroupId, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getGroupsFromResponse, getTopicsFromResponse, toTopicRow, } from './utils.js';
+cli({
+    site: 'zsxq',
+    name: 'search',
+    description: '搜索星球内容',
+    domain: 'wx.zsxq.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'keyword', required: true, positional: true, help: 'Search keyword' },
+        { name: 'limit', type: 'int', default: 20, help: 'Number of results to return' },
+        { name: 'group_id', help: 'Optional group id; defaults to the active group in Chrome' },
+    ],
+    columns: ['topic_id', 'group', 'author', 'title', 'comments', 'likes', 'time', 'url'],
+    func: async (page, kwargs) => {
+        await ensureZsxqPage(page);
+        await ensureZsxqAuth(page);
+        const keyword = String(kwargs.keyword || '').trim();
+        const limit = Math.max(1, Number(kwargs.limit) || 20);
+        const groupId = String(kwargs.group_id || await getActiveGroupId(page));
+        const query = encodeURIComponent(keyword);
+        // Resolve group name from groups API
+        let groupName = groupId;
+        try {
+            const { data: groupsData } = await fetchFirstJson(page, [
+                `https://api.zsxq.com/v2/groups`,
+            ]);
+            const groups = getGroupsFromResponse(groupsData);
+            const found = groups.find(g => String(g.group_id) === groupId);
+            if (found?.name)
+                groupName = found.name;
+        }
+        catch { /* ignore */ }
+        const { data } = await fetchFirstJson(page, [
+            `https://api.zsxq.com/v2/search/groups/${groupId}/topics?keyword=${query}&count=${limit}`,
+        ]);
+        return getTopicsFromResponse(data).slice(0, limit).map((topic) => ({
+            ...toTopicRow(topic),
+            group: groupName,
+        }));
+    },
+});

package/vendor/opencli/dist/clis/zsxq/search.test.d.ts

@@ -0,0 +1 @@
+import './search.js';

package/vendor/opencli/dist/clis/zsxq/search.test.js

@@ -0,0 +1,24 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './search.js';
+describe('zsxq search command', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('requires an explicit group_id when there is no active group context', async () => {
+        const command = getRegistry().get('zsxq/search');
+        expect(command?.func).toBeTypeOf('function');
+        const mockPage = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn()
+                .mockResolvedValueOnce(true)
+                .mockResolvedValueOnce(null),
+        };
+        await expect(command.func(mockPage, { keyword: 'opencli', limit: 20 })).rejects.toMatchObject({
+            code: 'ARGUMENT',
+            message: 'Cannot determine active group_id',
+        });
+        expect(mockPage.goto).toHaveBeenCalledWith('https://wx.zsxq.com');
+        expect(mockPage.evaluate).toHaveBeenCalledTimes(2);
+    });
+});

package/vendor/opencli/dist/clis/zsxq/topic.d.ts

@@ -0,0 +1 @@
+export {};

package/vendor/opencli/dist/clis/zsxq/topic.js

@@ -0,0 +1,47 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { browserJsonRequest, ensureZsxqAuth, ensureZsxqPage, fetchFirstJson, getCommentsFromResponse, getTopicFromResponse, getTopicUrl, summarizeComments, toTopicRow, } from './utils.js';
+cli({
+    site: 'zsxq',
+    name: 'topic',
+    description: '获取单个话题详情和评论',
+    domain: 'wx.zsxq.com',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    args: [
+        { name: 'id', required: true, positional: true, help: 'Topic ID' },
+        { name: 'comment_limit', type: 'int', default: 20, help: 'Number of comments to fetch' },
+    ],
+    columns: ['topic_id', 'type', 'author', 'title', 'comments', 'likes', 'comment_preview', 'url'],
+    func: async (page, kwargs) => {
+        await ensureZsxqPage(page);
+        await ensureZsxqAuth(page);
+        const topicId = String(kwargs.id);
+        const commentLimit = Math.max(1, Number(kwargs.comment_limit) || 20);
+        const detailUrl = `https://api.zsxq.com/v2/topics/${topicId}`;
+        const detailResp = await browserJsonRequest(page, detailUrl);
+        if (detailResp.status === 404) {
+            throw new CliError('NOT_FOUND', `Topic ${topicId} not found`);
+        }
+        if (!detailResp.ok) {
+            throw new CliError('FETCH_ERROR', detailResp.error || `Failed to fetch topic ${topicId}`, `Checked endpoint: ${detailUrl}`);
+        }
+        const commentsResp = await fetchFirstJson(page, [
+            `https://api.zsxq.com/v2/topics/${topicId}/comments?sort=asc&count=${commentLimit}`,
+        ]);
+        const topic = getTopicFromResponse(detailResp.data);
+        if (!topic)
+            throw new CliError('NOT_FOUND', `Topic ${topicId} not found`);
+        const comments = getCommentsFromResponse(commentsResp.data);
+        const row = toTopicRow({
+            ...topic,
+            comments,
+            comments_count: topic.comments_count ?? comments.length,
+        });
+        return [{
+                ...row,
+                comment_preview: summarizeComments(comments, 5),
+                url: getTopicUrl(topic.topic_id ?? topicId),
+            }];
+    },
+});

package/vendor/opencli/dist/clis/zsxq/topic.test.d.ts

@@ -0,0 +1 @@
+import './topic.js';

package/vendor/opencli/dist/clis/zsxq/topic.test.js

@@ -0,0 +1,29 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './topic.js';
+describe('zsxq topic command', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('maps topic detail 404 responses to NOT_FOUND before fetching comments', async () => {
+        const command = getRegistry().get('zsxq/topic');
+        expect(command?.func).toBeTypeOf('function');
+        const mockPage = {
+            goto: vi.fn().mockResolvedValue(undefined),
+            evaluate: vi.fn()
+                .mockResolvedValueOnce(true)
+                .mockResolvedValueOnce({
+                ok: true,
+                status: 404,
+                url: 'https://api.zsxq.com/v2/topics/404',
+                data: null,
+            }),
+        };
+        await expect(command.func(mockPage, { id: '404', comment_limit: 20 })).rejects.toMatchObject({
+            code: 'NOT_FOUND',
+            message: 'Topic 404 not found',
+        });
+        expect(mockPage.goto).toHaveBeenCalledWith('https://wx.zsxq.com');
+        expect(mockPage.evaluate).toHaveBeenCalledTimes(2);
+    });
+});

package/vendor/opencli/dist/clis/zsxq/topics.d.ts

@@ -0,0 +1 @@
+export {};