@agentrhq/webcmd 0.1.2 → 0.2.1

package/clis/zhihu/follow.js

@@ -1,50 +0,0 @@
-import { CliError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { assertAllowedKinds, parseTarget } from './target.js';
-import { buildResultRow, requireExecute } from './write-shared.js';
-cli({
-    site: 'zhihu',
-    name: 'follow',
-    access: 'write',
-    description: 'Follow a Zhihu user or question',
-    domain: 'www.zhihu.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'target', positional: true, required: true, help: 'Zhihu target URL or typed target' },
-        { name: 'execute', type: 'boolean', help: 'Actually perform the write action' },
-    ],
-    columns: ['status', 'outcome', 'message', 'target_type', 'target'],
-    func: async (page, kwargs) => {
-        if (!page)
-            throw new CommandExecutionError('Browser session required for zhihu follow');
-        requireExecute(kwargs);
-        const rawTarget = String(kwargs.target);
-        const target = assertAllowedKinds('follow', parseTarget(rawTarget));
-        await page.goto('https://www.zhihu.com');
-        await page.wait(2);
-        const apiResult = await page.evaluate(`(async () => {
-            var targetKind = ${JSON.stringify(target.kind)};
-            var targetId = ${JSON.stringify(target.kind === 'user' ? target.slug : target.id)};
-            var url;
-            if (targetKind === 'question') {
-                url = 'https://www.zhihu.com/api/v4/questions/' + targetId + '/followers';
-            } else if (targetKind === 'user') {
-                url = 'https://www.zhihu.com/api/v4/members/' + targetId + '/followers';
-            } else {
-                return { ok: false, message: 'unsupported target type: ' + targetKind };
-            }
-            var resp = await fetch(url, { method: 'POST', credentials: 'include' });
-            if (!resp.ok) {
-                var data = {};
-                try { data = await resp.json(); } catch(e) {}
-                return { ok: false, message: data.error ? data.error.message : 'HTTP ' + resp.status };
-            }
-            return { ok: true };
-        })()`);
-        if (!apiResult?.ok) {
-            throw new CliError('COMMAND_EXEC', apiResult?.message || 'Failed to follow');
-        }
-        return buildResultRow(`Followed ${target.kind} ${target.kind === 'user' ? target.slug : target.id}`, target.kind, rawTarget, 'applied');
-    },
-});

package/clis/zhihu/follow.test.js

@@ -1,42 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './follow.js';
-describe('zhihu follow', () => {
-    it('registers as a cookie browser command', () => {
-        const cmd = getRegistry().get('zhihu/follow');
-        expect(cmd).toBeDefined();
-        expect(cmd.strategy).toBe('cookie');
-    });
-    it('follows via API and returns result', async () => {
-        const cmd = getRegistry().get('zhihu/follow');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValueOnce({ ok: true }),
-        };
-        const rows = await cmd.func(page, { target: 'question:123', execute: true });
-        expect(rows).toEqual([expect.objectContaining({ outcome: 'applied' })]);
-    });
-    it('uses the parsed user slug for user follow API calls', async () => {
-        const cmd = getRegistry().get('zhihu/follow');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValueOnce({ ok: true }),
-        };
-        await cmd.func(page, { target: 'user:alice', execute: true });
-        expect(page.evaluate.mock.calls[0][0]).toContain("'https://www.zhihu.com/api/v4/members/' + targetId + '/followers'");
-        expect(page.evaluate.mock.calls[0][0]).toContain('var targetId = "alice"');
-        expect(page.evaluate.mock.calls[0][0]).not.toContain('undefined');
-    });
-    it('throws on API error', async () => {
-        const cmd = getRegistry().get('zhihu/follow');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValueOnce({ ok: false, message: 'already following' }),
-        };
-        await expect(cmd.func(page, { target: 'question:123', execute: true }))
-            .rejects.toMatchObject({ code: 'COMMAND_EXEC' });
-    });
-});

package/clis/zhihu/followers.js

@@ -1,40 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { parseZhihuUser } from './user-arg.js';
-import { fetchZhihuList, validateLimit } from './paginate.js';
-
-const INCLUDE = 'data[*].follower_count,headline,answer_count,articles_count';
-
-cli({
-    site: 'zhihu',
-    name: 'followers',
-    access: 'read',
-    description: '知乎某用户的粉丝列表',
-    domain: 'www.zhihu.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'user', type: 'string', required: true, positional: true, help: 'User url_token or people URL' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of followers to return (max 1000)' },
-    ],
-    columns: ['rank', 'name', 'url_token', 'headline', 'followers', 'url'],
-    func: async (page, kwargs) => {
-        const slug = parseZhihuUser(kwargs.user);
-        const limit = validateLimit(kwargs.limit);
-        await page.goto('https://www.zhihu.com');
-        const first = `https://www.zhihu.com/api/v4/members/${encodeURIComponent(slug)}/followers?limit=20&offset=0&include=${encodeURIComponent(INCLUDE)}`;
-        const items = await fetchZhihuList(page, first, limit, 'followers');
-        return items.map((u, i) => {
-            if (!u.url_token || !u.name) {
-                throw new CommandExecutionError('Zhihu followers returned malformed row identity');
-            }
-            return {
-                rank: i + 1,
-                name: String(u.name || ''),
-                url_token: String(u.url_token || ''),
-                headline: String(u.headline || ''),
-                followers: u.follower_count ?? 0,
-                url: `https://www.zhihu.com/people/${u.url_token}`,
-            };
-        });
-    },
-});

package/clis/zhihu/followers.test.js

@@ -1,42 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import { AuthRequiredError, CliError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import './followers.js';
-
-describe('zhihu followers', () => {
-    it('maps a followers list to rows', async () => {
-        const cmd = getRegistry().get('zhihu/followers');
-        expect(cmd?.func).toBeTypeOf('function');
-        const evaluate = vi.fn().mockImplementation(async (js) => {
-            expect(js).toContain('/api/v4/members/wen-jie-16-47/followers');
-            return {
-                data: [
-                    { url_token: 'chen-lei-26-17-63', name: 'Nyvo', follower_count: 15 },
-                ],
-                paging: { is_end: true },
-            };
-        });
-        await expect(cmd.func({ goto: vi.fn().mockResolvedValue(undefined), evaluate }, { user: 'wen-jie-16-47', limit: 1 })).resolves.toEqual([
-            { rank: 1, name: 'Nyvo', url_token: 'chen-lei-26-17-63', headline: '', followers: 15, url: 'https://www.zhihu.com/people/chen-lei-26-17-63' },
-        ]);
-    });
-
-    it('maps 403 to AuthRequiredError', async () => {
-        const cmd = getRegistry().get('zhihu/followers');
-        const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate: vi.fn().mockResolvedValue({ __httpError: 403 }) };
-        await expect(cmd.func(page, { user: 'foo', limit: 1 })).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('fails typed on malformed follower rows', async () => {
-        const cmd = getRegistry().get('zhihu/followers');
-        const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate: vi.fn().mockResolvedValue({ data: [{ url_token: 'no-name' }], paging: { is_end: true } }) };
-        await expect(cmd.func(page, { user: 'foo', limit: 1 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('rejects invalid limits before navigation', async () => {
-        const cmd = getRegistry().get('zhihu/followers');
-        const page = { goto: vi.fn(), evaluate: vi.fn() };
-        await expect(cmd.func(page, { user: 'foo', limit: 99999 })).rejects.toBeInstanceOf(CliError);
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-});

package/clis/zhihu/following.js

@@ -1,40 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { parseZhihuUser } from './user-arg.js';
-import { fetchZhihuList, validateLimit } from './paginate.js';
-
-const INCLUDE = 'data[*].follower_count,headline,answer_count,articles_count';
-
-cli({
-    site: 'zhihu',
-    name: 'following',
-    access: 'read',
-    description: '知乎某用户关注的人列表',
-    domain: 'www.zhihu.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'user', type: 'string', required: true, positional: true, help: 'User url_token or people URL' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of followees to return (max 1000)' },
-    ],
-    columns: ['rank', 'name', 'url_token', 'headline', 'followers', 'url'],
-    func: async (page, kwargs) => {
-        const slug = parseZhihuUser(kwargs.user);
-        const limit = validateLimit(kwargs.limit);
-        await page.goto('https://www.zhihu.com');
-        const first = `https://www.zhihu.com/api/v4/members/${encodeURIComponent(slug)}/followees?limit=20&offset=0&include=${encodeURIComponent(INCLUDE)}`;
-        const items = await fetchZhihuList(page, first, limit, 'following');
-        return items.map((u, i) => {
-            if (!u.url_token || !u.name) {
-                throw new CommandExecutionError('Zhihu following returned malformed row identity');
-            }
-            return {
-                rank: i + 1,
-                name: String(u.name || ''),
-                url_token: String(u.url_token || ''),
-                headline: String(u.headline || ''),
-                followers: u.follower_count ?? 0,
-                url: `https://www.zhihu.com/people/${u.url_token}`,
-            };
-        });
-    },
-});

package/clis/zhihu/following.test.js

@@ -1,44 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import { AuthRequiredError, CliError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import './following.js';
-
-describe('zhihu following', () => {
-    it('maps a followees list to rows', async () => {
-        const cmd = getRegistry().get('zhihu/following');
-        expect(cmd?.func).toBeTypeOf('function');
-        const evaluate = vi.fn().mockImplementation(async (js) => {
-            expect(js).toContain('/api/v4/members/wen-jie-16-47/followees');
-            return {
-                data: [
-                    { url_token: 'gaow0007', name: 'GAOW0007', headline: 'ML System', follower_count: 537 },
-                    { url_token: 'mfx', name: 'Meng' },
-                ],
-                paging: { is_end: true },
-            };
-        });
-        await expect(cmd.func({ goto: vi.fn().mockResolvedValue(undefined), evaluate }, { user: 'wen-jie-16-47', limit: 2 })).resolves.toEqual([
-            { rank: 1, name: 'GAOW0007', url_token: 'gaow0007', headline: 'ML System', followers: 537, url: 'https://www.zhihu.com/people/gaow0007' },
-            { rank: 2, name: 'Meng', url_token: 'mfx', headline: '', followers: 0, url: 'https://www.zhihu.com/people/mfx' },
-        ]);
-    });
-
-    it('maps 403 to AuthRequiredError', async () => {
-        const cmd = getRegistry().get('zhihu/following');
-        const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate: vi.fn().mockResolvedValue({ __httpError: 403 }) };
-        await expect(cmd.func(page, { user: 'foo', limit: 2 })).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('fails typed on malformed following rows', async () => {
-        const cmd = getRegistry().get('zhihu/following');
-        const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate: vi.fn().mockResolvedValue({ data: [{ name: 'No Token' }], paging: { is_end: true } }) };
-        await expect(cmd.func(page, { user: 'foo', limit: 2 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('rejects invalid limits before navigation', async () => {
-        const cmd = getRegistry().get('zhihu/following');
-        const page = { goto: vi.fn(), evaluate: vi.fn() };
-        await expect(cmd.func(page, { user: 'foo', limit: 0 })).rejects.toBeInstanceOf(CliError);
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-});

package/clis/zhihu/hot.js

@@ -1,44 +0,0 @@
-import { cli } from '@agentrhq/webcmd/registry';
-cli({
-    site: 'zhihu',
-    name: 'hot',
-    access: 'read',
-    description: '知乎热榜',
-    domain: 'www.zhihu.com',
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of items to return' },
-    ],
-    columns: ['rank', 'title', 'heat', 'answers'],
-    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 }}' },
-    ],
-});

package/clis/zhihu/like.js

@@ -1,47 +0,0 @@
-import { CliError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { assertAllowedKinds, parseTarget } from './target.js';
-import { buildResultRow, requireExecute } from './write-shared.js';
-cli({
-    site: 'zhihu',
-    name: 'like',
-    access: 'write',
-    description: 'Like a Zhihu answer or article',
-    domain: 'zhihu.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'target', positional: true, required: true, help: 'Zhihu target URL or typed target' },
-        { name: 'execute', type: 'boolean', help: 'Actually perform the write action' },
-    ],
-    columns: ['status', 'outcome', 'message', 'target_type', 'target'],
-    func: async (page, kwargs) => {
-        if (!page)
-            throw new CommandExecutionError('Browser session required for zhihu like');
-        requireExecute(kwargs);
-        const rawTarget = String(kwargs.target);
-        const target = assertAllowedKinds('like', parseTarget(rawTarget));
-        await page.goto('https://www.zhihu.com');
-        await page.wait(2);
-        const apiResult = await page.evaluate(`(async () => {
-            var targetKind = ${JSON.stringify(target.kind)};
-            var targetId = ${JSON.stringify(target.id)};
-            var resourceType = targetKind === 'answer' ? 'answers' : 'articles';
-            var url = 'https://www.zhihu.com/api/v4/' + resourceType + '/' + targetId + '/voters';
-            var resp = await fetch(url, {
-                method: 'POST',
-                credentials: 'include',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ type: 'up' }),
-            });
-            var data = await resp.json();
-            if (!resp.ok) return { ok: false, message: data.error ? data.error.message : 'unknown error' };
-            if (data && data.success === false) return { ok: false, message: 'Zhihu like API reported success=false' };
-            return { ok: true, success: data.success };
-        })()`);
-        if (!apiResult?.ok) {
-            throw new CliError('COMMAND_EXEC', apiResult?.message || 'Failed to like');
-        }
-        return buildResultRow(`Liked ${target.kind} ${target.id}`, target.kind, rawTarget, 'applied');
-    },
-});

package/clis/zhihu/like.test.js

@@ -1,41 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import './like.js';
-describe('zhihu like', () => {
-    it('registers as a cookie browser command', () => {
-        const cmd = getRegistry().get('zhihu/like');
-        expect(cmd).toBeDefined();
-        expect(cmd.strategy).toBe('cookie');
-    });
-    it('likes via API and returns result', async () => {
-        const cmd = getRegistry().get('zhihu/like');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValueOnce({ ok: true, success: true }),
-        };
-        const rows = await cmd.func(page, { target: 'answer:1:2', execute: true });
-        expect(rows).toEqual([expect.objectContaining({ outcome: 'applied' })]);
-    });
-    it('throws on API error', async () => {
-        const cmd = getRegistry().get('zhihu/like');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValueOnce({ ok: false, message: 'rate limited' }),
-        };
-        await expect(cmd.func(page, { target: 'answer:1:2', execute: true }))
-            .rejects.toMatchObject({ code: 'COMMAND_EXEC' });
-    });
-    it('does not treat success=false API responses as a successful like', async () => {
-        const cmd = getRegistry().get('zhihu/like');
-        const page = {
-            goto: vi.fn().mockResolvedValue(undefined),
-            wait: vi.fn().mockResolvedValue(undefined),
-            evaluate: vi.fn().mockResolvedValueOnce({ ok: false, message: 'Zhihu like API reported success=false' }),
-        };
-        await expect(cmd.func(page, { target: 'answer:1:2', execute: true }))
-            .rejects.toMatchObject({ code: 'COMMAND_EXEC' });
-        expect(page.evaluate.mock.calls[0][0]).toContain('data.success === false');
-    });
-});

package/clis/zhihu/paginate.js

@@ -1,128 +0,0 @@
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@agentrhq/webcmd/errors';
-
-export const MAX_LIMIT = 1000;
-
-export function validateLimit(raw, fallback = 20) {
-    const value = raw ?? fallback;
-    let limit;
-    if (typeof value === 'number') {
-        limit = value;
-    }
-    else {
-        const text = String(value).trim();
-        if (!/^\d+$/.test(text)) {
-            throw new ArgumentError(`--limit must be a positive integer no greater than ${MAX_LIMIT}`, 'Use a normal-sized decimal integer limit to avoid slow requests or Zhihu risk controls');
-        }
-        limit = Number(text);
-    }
-    if (!Number.isInteger(limit) || limit <= 0 || limit > MAX_LIMIT) {
-        throw new ArgumentError(`--limit must be a positive integer no greater than ${MAX_LIMIT}`, 'Use a normal-sized decimal integer limit to avoid slow requests or Zhihu risk controls');
-    }
-    return limit;
-}
-
-export function unwrapEvaluateResult(payload) {
-    if (payload && typeof payload === 'object' && 'data' in payload && 'session' in payload) return payload.data;
-    return payload;
-}
-
-export function requireZhihuListPayload(payload, label, url) {
-    const data = unwrapEvaluateResult(payload);
-    if (!data || typeof data !== 'object' || Array.isArray(data)) {
-        throw new CommandExecutionError(`Zhihu ${label} returned malformed payload`, `URL: ${url}`);
-    }
-    if (data.__httpError) {
-        const status = data.__httpError;
-        if (status === 401 || status === 403) {
-            throw new AuthRequiredError('www.zhihu.com', `Failed to fetch Zhihu ${label}`);
-        }
-        if (status === 404) {
-            throw new EmptyResultError(`zhihu ${label}`, 'Check the target identifier');
-        }
-        throw new CommandExecutionError(`Zhihu ${label} request failed${status ? ` (HTTP ${status})` : ''}`, 'Try again later or rerun with -v');
-    }
-    if (data.__fetchError) {
-        throw new CommandExecutionError(`Zhihu ${label} request failed`, String(data.__fetchError));
-    }
-    if (!Array.isArray(data.data)) {
-        throw new CommandExecutionError(`Zhihu ${label} returned malformed data list`, `URL: ${url}`);
-    }
-    if (!data.paging || typeof data.paging !== 'object') {
-        throw new CommandExecutionError(`Zhihu ${label} returned malformed paging data`, `URL: ${url}`);
-    }
-    return data;
-}
-
-function normalizeZhihuApiUrl(value) {
-    if (typeof value !== 'string' || !value) return '';
-    try {
-        const url = new URL(value);
-        if (url.protocol !== 'https:') return '';
-        if (url.hostname === 'api.zhihu.com' && url.pathname.startsWith('/members/')) {
-            return `https://www.zhihu.com/api/v4${url.pathname}${url.search}`;
-        }
-        if (url.hostname === 'www.zhihu.com' && url.pathname.startsWith('/api/v4/members/')) {
-            return url.toString();
-        }
-    }
-    catch {
-        return '';
-    }
-    return '';
-}
-
-function sameZhihuApiPath(a, b) {
-    try {
-        return new URL(a).pathname === new URL(b).pathname;
-    }
-    catch {
-        return false;
-    }
-}
-
-/**
- * Fetch a paginated Zhihu /api/v4 list endpoint (credentialed) and collect up
- * to `limit` raw items, following `paging.next`. `label` is used in error
- * messages. Returns the raw item array; callers map it to rows.
- */
-export async function fetchZhihuList(page, firstUrl, limit, label) {
-    const items = [];
-    const visited = new Set();
-    let url = firstUrl;
-    while (url && items.length < limit && !visited.has(url)) {
-        visited.add(url);
-        const data = requireZhihuListPayload(await page.evaluate(`
-      (async () => {
-        try {
-          const r = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
-          if (!r.ok) return { __httpError: r.status };
-          return await r.json();
-        } catch (err) {
-          return { __fetchError: err?.message || String(err) };
-        }
-      })()
-    `), label, url);
-        for (const item of data.data) {
-            items.push(item);
-            if (items.length >= limit) break;
-        }
-        if (data.paging?.is_end) break;
-        const next = normalizeZhihuApiUrl(data.paging?.next);
-        if (!next || !sameZhihuApiPath(next, firstUrl)) {
-            throw new CommandExecutionError(`Zhihu ${label} pagination returned malformed next URL`);
-        }
-        if (visited.has(next)) {
-            throw new CommandExecutionError(`Zhihu ${label} pagination returned a repeated next URL`);
-        }
-        url = next;
-    }
-    if (items.length === 0) {
-        throw new EmptyResultError(`zhihu ${label}`, 'No rows were returned for the requested Zhihu user.');
-    }
-    return items;
-}
-
-export const __test__ = {
-    normalizeZhihuApiUrl,
-    sameZhihuApiPath,
-};

package/clis/zhihu/pins.js

@@ -1,41 +0,0 @@
-import { cli, Strategy } from '@agentrhq/webcmd/registry';
-import { CommandExecutionError } from '@agentrhq/webcmd/errors';
-import { parseZhihuUser } from './user-arg.js';
-import { fetchZhihuList, validateLimit } from './paginate.js';
-
-cli({
-    site: 'zhihu',
-    name: 'pins',
-    access: 'read',
-    description: '知乎某用户的想法（短内容）列表',
-    domain: 'www.zhihu.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'user', type: 'string', required: true, positional: true, help: 'User url_token or people URL' },
-        { name: 'limit', type: 'int', default: 20, help: 'Number of pins to return (max 1000)' },
-    ],
-    columns: ['rank', 'excerpt', 'type', 'likes', 'comments', 'reposts', 'created', 'url'],
-    func: async (page, kwargs) => {
-        const slug = parseZhihuUser(kwargs.user);
-        const limit = validateLimit(kwargs.limit);
-        await page.goto('https://www.zhihu.com');
-        const first = `https://www.zhihu.com/api/v4/members/${encodeURIComponent(slug)}/pins?limit=20&offset=0`;
-        const items = await fetchZhihuList(page, first, limit, 'pins');
-        return items.map((p, i) => {
-            const firstContent = Array.isArray(p.content) ? p.content[0] : null;
-            if (!p.id || !p.excerpt_title) {
-                throw new CommandExecutionError('Zhihu pins returned malformed row identity');
-            }
-            return {
-                rank: i + 1,
-                excerpt: String(p.excerpt_title || ''),
-                type: String(firstContent?.type || ''),
-                likes: p.like_count ?? p.reaction_count ?? 0,
-                comments: p.comment_count ?? 0,
-                reposts: p.repin_count ?? 0,
-                created: p.created ?? p.updated ?? 0,
-                url: `https://www.zhihu.com/pin/${p.id}`,
-            };
-        });
-    },
-});

package/clis/zhihu/pins.test.js

@@ -1,44 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getRegistry } from '@agentrhq/webcmd/registry';
-import { AuthRequiredError, CliError, CommandExecutionError } from '@agentrhq/webcmd/errors';
-import './pins.js';
-
-describe('zhihu pins', () => {
-    it('maps a pins list to rows', async () => {
-        const cmd = getRegistry().get('zhihu/pins');
-        expect(cmd?.func).toBeTypeOf('function');
-        const evaluate = vi.fn().mockImplementation(async (js) => {
-            expect(js).toContain('/api/v4/members/wen-jie-16-47/pins');
-            return {
-                data: [
-                    { id: 'pin1', excerpt_title: 'About CrabClaw', content: [{ type: 'text' }], like_count: 4, comment_count: 1, repin_count: 2, created: 1772468804 },
-                    { id: 'pin2', excerpt_title: 'second', reaction_count: 9, updated: 1772468999 },
-                ],
-                paging: { is_end: true },
-            };
-        });
-        await expect(cmd.func({ goto: vi.fn().mockResolvedValue(undefined), evaluate }, { user: 'wen-jie-16-47', limit: 2 })).resolves.toEqual([
-            { rank: 1, excerpt: 'About CrabClaw', type: 'text', likes: 4, comments: 1, reposts: 2, created: 1772468804, url: 'https://www.zhihu.com/pin/pin1' },
-            { rank: 2, excerpt: 'second', type: '', likes: 9, comments: 0, reposts: 0, created: 1772468999, url: 'https://www.zhihu.com/pin/pin2' },
-        ]);
-    });
-
-    it('maps 403 to AuthRequiredError', async () => {
-        const cmd = getRegistry().get('zhihu/pins');
-        const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate: vi.fn().mockResolvedValue({ __httpError: 403 }) };
-        await expect(cmd.func(page, { user: 'foo', limit: 2 })).rejects.toBeInstanceOf(AuthRequiredError);
-    });
-
-    it('fails typed on malformed pin identity rows', async () => {
-        const cmd = getRegistry().get('zhihu/pins');
-        const page = { goto: vi.fn().mockResolvedValue(undefined), evaluate: vi.fn().mockResolvedValue({ data: [{ id: 'pin1' }], paging: { is_end: true } }) };
-        await expect(cmd.func(page, { user: 'foo', limit: 2 })).rejects.toBeInstanceOf(CommandExecutionError);
-    });
-
-    it('rejects invalid limits before navigation', async () => {
-        const cmd = getRegistry().get('zhihu/pins');
-        const page = { goto: vi.fn(), evaluate: vi.fn() };
-        await expect(cmd.func(page, { user: 'foo', limit: 0 })).rejects.toBeInstanceOf(CliError);
-        expect(page.goto).not.toHaveBeenCalled();
-    });
-});