@jackwener/opencli 1.5.5 → 1.5.6

package/src/clis/zsxq/dynamics.ts

@@ -0,0 +1,60 @@
+import { cli, Strategy } from '../../registry.js';
+import type { ZsxqTopic } from './utils.js';
+import {
+  ensureZsxqAuth,
+  ensureZsxqPage,
+  fetchFirstJson,
+  toTopicRow,
+  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 as any)?.resp_data || data;
+    const dynamics = respData?.dynamics || [];
+    return dynamics.slice(0, limit).map((d: any) => {
+      const topic = d.topic as ZsxqTopic | undefined;
+      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/src/clis/zsxq/groups.ts

@@ -0,0 +1,41 @@
+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/src/clis/zsxq/search.test.ts

@@ -0,0 +1,29 @@
+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),
+    } as any;
+
+    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/src/clis/zsxq/search.ts

@@ -0,0 +1,54 @@
+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/src/clis/zsxq/topic.test.ts

@@ -0,0 +1,34 @@
+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,
+        }),
+    } as any;
+
+    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/src/clis/zsxq/topic.ts

@@ -0,0 +1,68 @@
+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/src/clis/zsxq/topics.test.ts

@@ -0,0 +1,29 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { getRegistry } from '../../registry.js';
+import './topics.js';
+
+describe('zsxq topics command', () => {
+  beforeEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('requires an explicit group_id when there is no active group context', async () => {
+    const command = getRegistry().get('zsxq/topics');
+    expect(command?.func).toBeTypeOf('function');
+
+    const mockPage = {
+      goto: vi.fn().mockResolvedValue(undefined),
+      evaluate: vi.fn()
+        .mockResolvedValueOnce(true)
+        .mockResolvedValueOnce(null),
+    } as any;
+
+    await expect(command!.func!(mockPage, { 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/src/clis/zsxq/topics.ts

@@ -0,0 +1,36 @@
+import { cli, Strategy } from '../../registry.js';
+import {
+  getActiveGroupId,
+  ensureZsxqAuth,
+  ensureZsxqPage,
+  fetchFirstJson,
+  getTopicsFromResponse,
+  toTopicRow,
+} from './utils.js';
+
+cli({
+  site: 'zsxq',
+  name: 'topics',
+  description: '获取当前星球的话题列表',
+  domain: 'wx.zsxq.com',
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: 'Number of topics to return' },
+    { name: 'group_id', help: 'Optional group id; defaults to the active group in Chrome' },
+  ],
+  columns: ['topic_id', 'type', 'author', 'title', 'comments', 'likes', 'time', 'url'],
+  func: async (page, kwargs) => {
+    await ensureZsxqPage(page);
+    await ensureZsxqAuth(page);
+
+    const limit = Math.max(1, Number(kwargs.limit) || 20);
+    const groupId = String(kwargs.group_id || await getActiveGroupId(page));
+
+    const { data } = await fetchFirstJson(page, [
+      `https://api.zsxq.com/v2/groups/${groupId}/topics?scope=all&count=${limit}`,
+    ]);
+
+    return getTopicsFromResponse(data).slice(0, limit).map(toTopicRow);
+  },
+});