publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/zhihu/pins.js

@@ -1,41 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CommandExecutionError } from '@jackwener/opencli/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}`,
-            };
-        });
-    },
-});
+import{cli as c,Strategy as u}from"@jackwener/opencli/registry";import{CommandExecutionError as a}from"@jackwener/opencli/errors";import{parseZhihuUser as l}from"./user-arg.js";import{fetchZhihuList as p,validateLimit as h}from"./paginate.js";c({site:"zhihu",name:"pins",access:"read",description:"知乎某用户的想法（短内容）列表",domain:"www.zhihu.com",strategy:u.COOKIE,args:[{name:"user",type:"string",required:!0,positional:!0,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(e,i)=>{const r=l(i.user),n=h(i.limit);await e.goto("https://www.zhihu.com");const o=`https://www.zhihu.com/api/v4/members/${encodeURIComponent(r)}/pins?limit=20&offset=0`;return(await p(e,o,n,"pins")).map((t,s)=>{const m=Array.isArray(t.content)?t.content[0]:null;if(!t.id||!t.excerpt_title)throw new a("Zhihu pins returned malformed row identity");return{rank:s+1,excerpt:String(t.excerpt_title||""),type:String(m?.type||""),likes:t.like_count??t.reaction_count??0,comments:t.comment_count??0,reposts:t.repin_count??0,created:t.created??t.updated??0,url:`https://www.zhihu.com/pin/${t.id}`}})}});

package/clis/zhihu/question.js

@@ -1,113 +1,7 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { AuthRequiredError, CliError } from '@jackwener/opencli/errors';
-import { stripHtml } from './text.js';
-
-function answerIdFromUrl(url) {
-    if (typeof url !== 'string') return '';
-    try {
-        const parsed = new URL(url);
-        if (parsed.hostname !== 'www.zhihu.com' && parsed.hostname !== 'zhihu.com') return '';
-        return parsed.pathname.match(/^\/question\/\d+\/answer\/(\d+)\/?$/)?.[1]
-            || parsed.pathname.match(/^\/api\/v4\/answers\/(\d+)\/?$/)?.[1]
-            || parsed.pathname.match(/^\/answer\/(\d+)\/?$/)?.[1]
-            || '';
-    } catch {
-        return '';
-    }
-}
-
-function answerId(item) {
-    const fromUrl = answerIdFromUrl(item.url);
-    if (fromUrl) return fromUrl;
-    if (typeof item.id === 'string' && /^\d+$/.test(item.id)) return item.id;
-    if (typeof item.id === 'number' && Number.isSafeInteger(item.id) && item.id > 0) return String(item.id);
-    return '';
-}
-
-function answerDedupeKey(item) {
-    const id = answerId(item);
-    if (id) return `id:${id}`;
-    return `fallback:${item.author?.name || 'anonymous'}:${item.content || ''}`;
-}
-
-const MAX_LIMIT = 1000;
-
-cli({
-    site: 'zhihu',
-    name: 'question',
-    access: 'read',
-    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 (max 1000; use normal-sized requests)' },
-        { name: 'sort', default: 'default', choices: ['default', 'created'], help: 'Answer order: default or created' },
-    ],
-    columns: ['rank', 'id', 'author', 'votes', 'url', '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);
-        if (!Number.isInteger(answerLimit) || answerLimit <= 0 || answerLimit > MAX_LIMIT) {
-            throw new CliError('INVALID_INPUT', `Limit must be a positive integer no greater than ${MAX_LIMIT}`, 'Use a normal-sized limit to avoid slow requests or Zhihu risk controls');
-        }
-        const sort = String(kwargs.sort || 'default');
-        if (sort !== 'default' && sort !== 'created') {
-            throw new CliError('INVALID_INPUT', 'Sort must be one of: default, created', 'Example: opencli zhihu question 123456789 --sort created');
-        }
-        await page.goto(sort === 'created'
-            ? `https://www.zhihu.com/question/${questionId}/answers/updated`
-            : `https://www.zhihu.com/question/${questionId}`);
-        // Zhihu caps `limit` at 20 per request, so always ask for the API
-        // maximum. The pagination loop below trims to `answerLimit` via the
-        // `answers.length >= answerLimit` break, so a smaller --limit only
-        // costs one over-fetched page worth of bandwidth and never silently
-        // clamps the user-requested count.
-        const ZHIHU_PAGE_SIZE = 20;
-        let url = `https://www.zhihu.com/api/v4/questions/${questionId}/answers?limit=${ZHIHU_PAGE_SIZE}&offset=0&sort_by=${sort}&include=data[*].content,url,voteup_count,comment_count,author`;
-        const answers = [];
-        const seen = new Set();
-        const visited = new Set();
-        while (url && answers.length < answerLimit && !visited.has(url)) {
-            visited.add(url);
-            const data = await page.evaluate(`
+import{cli as H,Strategy as K}from"@jackwener/opencli/registry";import{AuthRequiredError as R,CliError as W}from"@jackwener/opencli/errors";import{stripHtml as S}from"./text.js";function f(b){if(typeof b!=="string")return"";try{const z=new URL(b);if(z.hostname!=="www.zhihu.com"&&z.hostname!=="zhihu.com")return"";return z.pathname.match(/^\/question\/\d+\/answer\/(\d+)\/?$/)?.[1]||z.pathname.match(/^\/api\/v4\/answers\/(\d+)\/?$/)?.[1]||z.pathname.match(/^\/answer\/(\d+)\/?$/)?.[1]||""}catch{return""}}function $(b){const z=f(b.url);if(z)return z;if(typeof b.id==="string"&&/^\d+$/.test(b.id))return b.id;if(typeof b.id==="number"&&Number.isSafeInteger(b.id)&&b.id>0)return String(b.id);return""}function h(b){const z=$(b);if(z)return`id:${z}`;return`fallback:${b.author?.name||"anonymous"}:${b.content||""}`}const x=1000;H({site:"zhihu",name:"question",access:"read",description:"知乎问题详情和回答",domain:"www.zhihu.com",strategy:K.COOKIE,args:[{name:"id",required:!0,positional:!0,help:"Question ID (numeric)"},{name:"limit",type:"int",default:5,help:"Number of answers (max 1000; use normal-sized requests)"},{name:"sort",default:"default",choices:["default","created"],help:"Answer order: default or created"}],columns:["rank","id","author","votes","url","content"],func:async(b,z)=>{const{id:D,limit:F=5}=z,N=String(D);if(!/^\d+$/.test(N))throw new W("INVALID_INPUT","Question ID must be numeric","Example: opencli zhihu question 123456789");const O=Number(F);if(!Number.isInteger(O)||O<=0||O>x)throw new W("INVALID_INPUT",`Limit must be a positive integer no greater than ${x}`,"Use a normal-sized limit to avoid slow requests or Zhihu risk controls");const Q=String(z.sort||"default");if(Q!=="default"&&Q!=="created")throw new W("INVALID_INPUT","Sort must be one of: default, created","Example: opencli zhihu question 123456789 --sort created");await b.goto(Q==="created"?`https://www.zhihu.com/question/${N}/answers/updated`:`https://www.zhihu.com/question/${N}`);let P=`https://www.zhihu.com/api/v4/questions/${N}/answers?limit=${20}&offset=0&sort_by=${Q}&include=data[*].content,url,voteup_count,comment_count,author`;const V=[],Y=new Set,Z=new Set;while(P&&V.length<O&&!Z.has(P)){Z.add(P);const B=await b.evaluate(`
       (async () => {
-        const r = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+        const r = await fetch(${JSON.stringify(P)}, { 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');
-            }
-            for (const item of data.data || []) {
-                const key = answerDedupeKey(item);
-                if (seen.has(key)) continue;
-                seen.add(key);
-                answers.push(item);
-                if (answers.length >= answerLimit) break;
-            }
-            if (data.paging?.is_end) break;
-            url = typeof data.paging?.next === 'string' ? data.paging.next : '';
-        }
-        return answers.map((item, i) => {
-            const id = answerId(item);
-            return {
-                rank: i + 1,
-                id,
-                author: item.author?.name || 'anonymous',
-                votes: item.voteup_count || 0,
-                url: id ? `https://www.zhihu.com/question/${questionId}/answer/${id}` : '',
-                content: stripHtml(item.content || '').substring(0, 200),
-            };
-        });
-    },
-});
+    `);if(!B||B.__httpError){const G=B?.__httpError;if(G===401||G===403)throw new R("www.zhihu.com","Failed to fetch question data from Zhihu");throw new W("FETCH_ERROR",G?`Zhihu question answers request failed (HTTP ${G})`:"Zhihu question answers request failed","Try again later or rerun with -v for more detail")}for(const G of B.data||[]){const J=h(G);if(Y.has(J))continue;Y.add(J);V.push(G);if(V.length>=O)break}if(B.paging?.is_end)break;P=typeof B.paging?.next==="string"?B.paging.next:""}return V.map((B,G)=>{const J=$(B);return{rank:G+1,id:J,author:B.author?.name||"anonymous",votes:B.voteup_count||0,url:J?`https://www.zhihu.com/question/${N}/answer/${J}`:"",content:S(B.content||"").substring(0,200)}})}});

package/clis/zhihu/recommend.js

@@ -1,103 +1,7 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { AuthRequiredError, CliError } from '@jackwener/opencli/errors';
-
-function normalizeUrl(item) {
-    const target = item.target || {};
-    const id = target.id == null ? '' : String(target.id);
-    if (target.type === 'answer') {
-        const questionId = target.question?.id == null ? '' : String(target.question.id);
-        return questionId && id ? `https://www.zhihu.com/question/${questionId}/answer/${id}` : '';
-    }
-    if (target.type === 'article') {
-        return id ? `https://zhuanlan.zhihu.com/p/${id}` : '';
-    }
-    if (target.type === 'question') {
-        return id ? `https://www.zhihu.com/question/${id}` : '';
-    }
-    return '';
-}
-
-function normalizeTitle(item) {
-    const target = item.target || {};
-    if (target.type === 'answer') return target.question?.title || '';
-    return target.title || target.question?.title || '';
-}
-
-const MAX_LIMIT = 1000;
-
-cli({
-    site: 'zhihu',
-    name: 'recommend',
-    access: 'read',
-    description: '知乎首页推荐',
-    domain: 'www.zhihu.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of items to return (max 1000; use normal-sized requests)' },
-    ],
-    columns: ['rank', 'type', 'title', 'author', 'votes', 'url'],
-    func: async (page, kwargs) => {
-        const itemLimit = Number(kwargs.limit ?? 20);
-        if (!Number.isInteger(itemLimit) || itemLimit <= 0 || itemLimit > MAX_LIMIT) {
-            throw new CliError('INVALID_INPUT', `Limit must be a positive integer no greater than ${MAX_LIMIT}`, 'Use a normal-sized limit to avoid slow requests or Zhihu risk controls');
-        }
-        await page.goto('https://www.zhihu.com');
-        let url = 'https://www.zhihu.com/api/v3/feed/topstory/recommend?limit=10&desktop=true';
-        const items = [];
-        const seen = new Set();
-        const visited = new Set();
-        while (url && items.length < itemLimit && !visited.has(url)) {
-            visited.add(url);
-            const data = await page.evaluate(`
+import{cli as Y,Strategy as Z}from"@jackwener/opencli/registry";import{AuthRequiredError as $,CliError as V}from"@jackwener/opencli/errors";function b(J){const x=J.target||{},B=x.id==null?"":String(x.id);if(x.type==="answer"){const G=x.question?.id==null?"":String(x.question.id);return G&&B?`https://www.zhihu.com/question/${G}/answer/${B}`:""}if(x.type==="article")return B?`https://zhuanlan.zhihu.com/p/${B}`:"";if(x.type==="question")return B?`https://www.zhihu.com/question/${B}`:"";return""}function f(J){const x=J.target||{};if(x.type==="answer")return x.question?.title||"";return x.title||x.question?.title||""}const W=1000;Y({site:"zhihu",name:"recommend",access:"read",description:"知乎首页推荐",domain:"www.zhihu.com",strategy:Z.COOKIE,args:[{name:"limit",type:"int",default:20,help:"Number of items to return (max 1000; use normal-sized requests)"}],columns:["rank","type","title","author","votes","url"],func:async(J,x)=>{const B=Number(x.limit??20);if(!Number.isInteger(B)||B<=0||B>W)throw new V("INVALID_INPUT",`Limit must be a positive integer no greater than ${W}`,"Use a normal-sized limit to avoid slow requests or Zhihu risk controls");await J.goto("https://www.zhihu.com");let G="https://www.zhihu.com/api/v3/feed/topstory/recommend?limit=10&desktop=true";const N=[],O=new Set,P=new Set;while(G&&N.length<B&&!P.has(G)){P.add(G);const D=await J.evaluate(`
       (async () => {
-        const r = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+        const r = await fetch(${JSON.stringify(G)}, { 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 Zhihu recommendations');
-                }
-                throw new CliError('FETCH_ERROR', status ? `Zhihu recommendations request failed (HTTP ${status})` : 'Zhihu recommendations request failed', 'Try again later or rerun with -v for more detail');
-            }
-            for (const item of data.data || []) {
-                const target = item.target || {};
-                // Dedup key uses semantic identity (type:targetId) and falls
-                // back to the feed cursor id when no target id exists. We avoid
-                // synthesizing a sentinel like 'unknown' for missing type
-                // because that would collapse distinct typed items into the
-                // same bucket. When no id is available at all we keep the row
-                // and skip dedup — surfacing potentially-duplicate items beats
-                // silently dropping them.
-                const targetId = target.id;
-                let key = null;
-                if (targetId != null) {
-                    key = `${target.type ?? ''}:${targetId}`;
-                } else if (item.id != null) {
-                    key = `__feed:${item.id}`;
-                }
-                if (key != null) {
-                    if (seen.has(key)) continue;
-                    seen.add(key);
-                }
-                items.push(item);
-                if (items.length >= itemLimit) break;
-            }
-            if (data.paging?.is_end) break;
-            url = typeof data.paging?.next === 'string' ? data.paging.next : '';
-        }
-        return items.map((item, i) => {
-            const target = item.target || {};
-            return {
-                rank: i + 1,
-                type: target.type || item.type || '',
-                title: normalizeTitle(item),
-                author: target.author?.name || '',
-                votes: target.voteup_count ?? target.reaction?.statistics?.like_count ?? 0,
-                url: normalizeUrl(item),
-            };
-        });
-    },
-});
+    `);if(!D||D.__httpError){const F=D?.__httpError;if(F===401||F===403)throw new $("www.zhihu.com","Failed to fetch Zhihu recommendations");throw new V("FETCH_ERROR",F?`Zhihu recommendations request failed (HTTP ${F})`:"Zhihu recommendations request failed","Try again later or rerun with -v for more detail")}for(const F of D.data||[]){const H=F.target||{},Q=H.id;let K=null;if(Q!=null)K=`${H.type??""}:${Q}`;else if(F.id!=null)K=`__feed:${F.id}`;if(K!=null){if(O.has(K))continue;O.add(K)}N.push(F);if(N.length>=B)break}if(D.paging?.is_end)break;G=typeof D.paging?.next==="string"?D.paging.next:""}return N.map((D,F)=>{const H=D.target||{};return{rank:F+1,type:H.type||D.type||"",title:f(D),author:H.author?.name||"",votes:H.voteup_count??H.reaction?.statistics?.like_count??0,url:b(D)}})}});

package/clis/zhihu/search.js

@@ -1,206 +1,11 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, AuthRequiredError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-import { stripHtml } from './text.js';
-
-function itemKey(item) {
-    const obj = item.object || {};
-    if (obj.id != null) return `${obj.type || ''}:${obj.id}`;
-    return null;
-}
-
-function itemUrl(obj) {
-    const id = obj.id == null ? '' : String(obj.id);
-    if (obj.type === 'answer') {
-        const questionId = obj.question?.id == null ? '' : String(obj.question.id);
-        return questionId && id ? `https://www.zhihu.com/question/${questionId}/answer/${id}` : '';
-    }
-    if (obj.type === 'article') {
-        return id ? `https://zhuanlan.zhihu.com/p/${id}` : '';
-    }
-    if (obj.type === 'question') {
-        return id ? `https://www.zhihu.com/question/${id}` : '';
-    }
-    return '';
-}
-
-function normalizeSearchUrl(url) {
-    if (typeof url !== 'string' || !url) return '';
-    try {
-        const parsed = new URL(url);
-        if (parsed.hostname === 'api.zhihu.com' && parsed.pathname === '/search_v3') {
-            return `https://www.zhihu.com/api/v4/search_v3${parsed.search}`;
-        }
-        if (parsed.hostname === 'www.zhihu.com' && parsed.pathname === '/api/v4/search_v3') {
-            return parsed.toString();
-        }
-    } catch {
-        return '';
-    }
-    return '';
-}
-
-const MAX_LIMIT = 1000;
-const PAGE_SIZE = 20;
-const TYPES = ['all', 'answer', 'article', 'question'];
-
-function parseLimit(value) {
-    const limit = Number(value ?? 10);
-    if (!Number.isInteger(limit) || limit <= 0 || limit > MAX_LIMIT) {
-        throw new ArgumentError(`zhihu search --limit must be a positive integer no greater than ${MAX_LIMIT}`, 'Use a normal-sized limit to avoid slow requests or Zhihu risk controls');
-    }
-    return limit;
-}
-
-function requireQuery(value) {
-    const query = String(value || '').trim();
-    if (!query) {
-        throw new ArgumentError('zhihu search query must not be empty', 'Example: opencli zhihu search codex');
-    }
-    return query;
-}
-
-function requireType(value) {
-    const type = String(value || 'all');
-    if (!TYPES.includes(type)) {
-        throw new ArgumentError(`zhihu search --type must be one of: ${TYPES.join(', ')}`, 'Example: opencli zhihu search codex --type answer');
-    }
-    return type;
-}
-
-function unwrapEvaluateResult(payload) {
-    if (payload && typeof payload === 'object' && 'data' in payload && 'session' in payload) return payload.data;
-    return payload;
-}
-
-function requireSearchPayload(data, url) {
-    const payload = unwrapEvaluateResult(data);
-    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
-        throw new CommandExecutionError('Zhihu search returned malformed payload');
-    }
-    if (payload.__httpError) {
-        const status = payload.__httpError;
-        if (status === 401 || status === 403) {
-            throw new AuthRequiredError('www.zhihu.com', 'Failed to fetch search results from Zhihu');
-        }
-        throw new CommandExecutionError(`Zhihu search request failed${status ? ` (HTTP ${status})` : ''}`, 'Try again later or rerun with -v for more detail');
-    }
-    if (payload.__fetchError) {
-        throw new CommandExecutionError('Zhihu search request failed', String(payload.__fetchError));
-    }
-    if (!Array.isArray(payload.data)) {
-        throw new CommandExecutionError('Zhihu search returned malformed data list', `URL: ${url}`);
-    }
-    if (!payload.paging || typeof payload.paging !== 'object') {
-        throw new CommandExecutionError('Zhihu search returned malformed paging data', `URL: ${url}`);
-    }
-    return payload;
-}
-
-function normalizeResultItem(item) {
-    if (!item || typeof item !== 'object' || item.type !== 'search_result' || !item.object || typeof item.object !== 'object') {
-        return null;
-    }
-    const obj = item.object;
-    if (obj.type !== 'answer' && obj.type !== 'article' && obj.type !== 'question') return null;
-    const key = itemKey(item);
-    const url = itemUrl(obj);
-    const question = obj.question || {};
-    const title = stripHtml(obj.title || question.name || question.title || '');
-    if (!key || !url || !title) {
-        throw new CommandExecutionError('Zhihu search returned malformed result row identity');
-    }
-    return {
-        item,
-        key,
-        row: {
-            title,
-            type: obj.type,
-            author: obj.author?.name || '',
-            votes: obj.voteup_count || 0,
-            url,
-        },
-    };
-}
-
-cli({
-    site: 'zhihu',
-    name: 'search',
-    access: 'read',
-    description: '知乎搜索',
-    domain: 'www.zhihu.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        { name: 'query', required: true, positional: true, help: 'Search query' },
-        { name: 'limit', type: 'int', default: 10, help: 'Number of results (max 1000; use normal-sized requests)' },
-        { name: 'type', default: 'all', choices: TYPES, help: 'Result type: all, answer, article, or question' },
-    ],
-    columns: ['rank', 'title', 'type', 'author', 'votes', 'url'],
-    func: async (page, kwargs) => {
-        const query = requireQuery(kwargs.query);
-        const resultLimit = parseLimit(kwargs.limit);
-        const type = requireType(kwargs.type);
-        await page.goto('https://www.zhihu.com');
-        let url = 'https://www.zhihu.com/api/v4/search_v3'
-            + `?q=${encodeURIComponent(query)}&t=general&offset=0&limit=${PAGE_SIZE}`;
-        const results = [];
-        const seen = new Set();
-        const visited = new Set();
-        while (url && results.length < resultLimit && !visited.has(url)) {
-            visited.add(url);
-            const data = requireSearchPayload(await page.evaluate(`
+import{cli as v,Strategy as h}from"@jackwener/opencli/registry";import{ArgumentError as K,AuthRequiredError as S,CommandExecutionError as $,EmptyResultError as q}from"@jackwener/opencli/errors";import{stripHtml as M}from"./text.js";function U(D){const B=D.object||{};if(B.id!=null)return`${B.type||""}:${B.id}`;return null}function A(D){const B=D.id==null?"":String(D.id);if(D.type==="answer"){const N=D.question?.id==null?"":String(D.question.id);return N&&B?`https://www.zhihu.com/question/${N}/answer/${B}`:""}if(D.type==="article")return B?`https://zhuanlan.zhihu.com/p/${B}`:"";if(D.type==="question")return B?`https://www.zhihu.com/question/${B}`:"";return""}function L(D){if(typeof D!=="string"||!D)return"";try{const B=new URL(D);if(B.hostname==="api.zhihu.com"&&B.pathname==="/search_v3")return`https://www.zhihu.com/api/v4/search_v3${B.search}`;if(B.hostname==="www.zhihu.com"&&B.pathname==="/api/v4/search_v3")return B.toString()}catch{return""}return""}const C=1000,w=20,Q=["all","answer","article","question"];function R(D){const B=Number(D??10);if(!Number.isInteger(B)||B<=0||B>C)throw new K(`zhihu search --limit must be a positive integer no greater than ${C}`,"Use a normal-sized limit to avoid slow requests or Zhihu risk controls");return B}function z(D){const B=String(D||"").trim();if(!B)throw new K("zhihu search query must not be empty","Example: opencli zhihu search codex");return B}function I(D){const B=String(D||"all");if(!Q.includes(B))throw new K(`zhihu search --type must be one of: ${Q.join(", ")}`,"Example: opencli zhihu search codex --type answer");return B}function H(D){if(D&&typeof D==="object"&&"data"in D&&"session"in D)return D.data;return D}function P(D,B){const N=H(D);if(!N||typeof N!=="object"||Array.isArray(N))throw new $("Zhihu search returned malformed payload");if(N.__httpError){const O=N.__httpError;if(O===401||O===403)throw new S("www.zhihu.com","Failed to fetch search results from Zhihu");throw new $(`Zhihu search request failed${O?` (HTTP ${O})`:""}`,"Try again later or rerun with -v for more detail")}if(N.__fetchError)throw new $("Zhihu search request failed",String(N.__fetchError));if(!Array.isArray(N.data))throw new $("Zhihu search returned malformed data list",`URL: ${B}`);if(!N.paging||typeof N.paging!=="object")throw new $("Zhihu search returned malformed paging data",`URL: ${B}`);return N}function T(D){return`
       (async () => {
         try {
-          const r = await fetch(${JSON.stringify(url)}, { credentials: 'include' });
+          const r = await fetch(${JSON.stringify(D)}, { credentials: 'include' });
           if (!r.ok) return { __httpError: r.status };
           return await r.json();
         } catch (err) {
           return { __fetchError: err?.message || String(err) };
         }
       })()
-    `), url);
-            for (const item of data.data) {
-                const rawType = item?.object?.type;
-                if (type !== 'all' && rawType && rawType !== type) continue;
-                const normalized = normalizeResultItem(item);
-                if (!normalized) continue;
-                if (type !== 'all' && normalized.row.type !== type) continue;
-                if (seen.has(normalized.key)) continue;
-                seen.add(normalized.key);
-                results.push(normalized.row);
-                if (results.length >= resultLimit) break;
-            }
-            if (results.length >= resultLimit) break;
-            if (data.paging?.is_end) break;
-            const next = normalizeSearchUrl(data.paging?.next);
-            if (!next) {
-                throw new CommandExecutionError('Zhihu search pagination returned malformed next URL');
-            }
-            if (visited.has(next)) {
-                throw new CommandExecutionError('Zhihu search pagination returned a repeated next URL');
-            }
-            url = next;
-        }
-        if (results.length === 0) {
-            throw new EmptyResultError('zhihu search', `No ${type === 'all' ? '' : `${type} `}results found for "${query}"`);
-        }
-        return results.map((row, i) => {
-            return {
-                rank: i + 1,
-                ...row,
-            };
-        });
-    },
-});
-
-export const __test__ = {
-    stripHtml,
-    itemKey,
-    itemUrl,
-    normalizeSearchUrl,
-    parseLimit,
-    requireQuery,
-    requireType,
-    unwrapEvaluateResult,
-    requireSearchPayload,
-    normalizeResultItem,
-};
+    `}async function k(D,B){let N=H(await D.evaluate(T(B)));if(N&&typeof N==="object"&&!Array.isArray(N)&&N.__fetchError){await D.goto("https://www.zhihu.com");N=H(await D.evaluate(T(B)))}return P(N,B)}function x(D){if(!D||typeof D!=="object"||D.type!=="search_result"||!D.object||typeof D.object!=="object")return null;const B=D.object;if(B.type!=="answer"&&B.type!=="article"&&B.type!=="question")return null;const N=U(D),O=A(B),V=B.question||{},W=M(B.title||V.name||V.title||"");if(!N||!O||!W)throw new $("Zhihu search returned malformed result row identity");return{item:D,key:N,row:{title:W,type:B.type,author:B.author?.name||"",votes:B.voteup_count||0,url:O}}}v({site:"zhihu",name:"search",access:"read",description:"知乎搜索",domain:"www.zhihu.com",strategy:h.COOKIE,args:[{name:"query",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (max 1000; use normal-sized requests)"},{name:"type",default:"all",choices:Q,help:"Result type: all, answer, article, or question"}],columns:["rank","title","type","author","votes","url"],func:async(D,B)=>{const N=z(B.query),O=R(B.limit),V=I(B.type);await D.goto("https://www.zhihu.com");let W=`https://www.zhihu.com/api/v4/search_v3?q=${encodeURIComponent(N)}&t=general&offset=0&limit=${w}`;const G=[],X=new Set,J=new Set;while(W&&G.length<O&&!J.has(W)){J.add(W);const Z=await k(D,W);for(const Y of Z.data){const _=Y?.object?.type;if(V!=="all"&&_&&_!==V)continue;const F=x(Y);if(!F)continue;if(V!=="all"&&F.row.type!==V)continue;if(X.has(F.key))continue;X.add(F.key);G.push(F.row);if(G.length>=O)break}if(G.length>=O)break;if(Z.paging?.is_end)break;const f=L(Z.paging?.next);if(!f)throw new $("Zhihu search pagination returned malformed next URL");if(J.has(f))throw new $("Zhihu search pagination returned a repeated next URL");W=f}if(G.length===0)throw new q("zhihu search",`No ${V==="all"?"":`${V} `}results found for "${N}"`);return G.map((Z,f)=>{return{rank:f+1,...Z}})}});export const __test__={stripHtml:M,itemKey:U,itemUrl:A,normalizeSearchUrl:L,parseLimit:R,requireQuery:z,requireType:I,unwrapEvaluateResult:H,requireSearchPayload:P,fetchSearchPage:k,normalizeResultItem:x};

package/clis/zhihu/stats.js

@@ -0,0 +1,41 @@
+import{cli as Z,Strategy as _}from"@jackwener/opencli/registry";import{AuthRequiredError as $,CommandExecutionError as b,EmptyResultError as f}from"@jackwener/opencli/errors";function h(B){if(!B)return"";const D=new Date(B*1000),K=(M)=>String(M).padStart(2,"0");return`${D.getFullYear()}-${K(D.getMonth()+1)}-${K(D.getDate())} ${K(D.getHours())}:${K(D.getMinutes())}`}function A(B,D,K){if(!D)return"";if(B==="article")return`https://zhuanlan.zhihu.com/p/${D}`;if(B==="answer")return K?`https://www.zhihu.com/question/${K}/answer/${D}`:`https://www.zhihu.com/answer/${D}`;if(B==="pin")return`https://www.zhihu.com/pin/${D}`;if(B==="zvideo")return`https://www.zhihu.com/zvideo/${D}`;if(B==="question")return`https://www.zhihu.com/question/${D}`;return""}function X(B){if(typeof B!=="string"||!B||B.includes("NaN"))return"";return B}Z({site:"zhihu",name:"stats",access:"read",description:"知乎内容数据（每篇阅读/赞同/收藏/评论等全量运营指标）",domain:"www.zhihu.com",strategy:_.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"number",default:20,help:"返回条数"}],columns:["id","type","title","url","published_at","views","likes","comments","collects","shares","shows","favors","reposts","new_followers","finish_read_rate","interact_rate","mark","extra"],func:async(B,D)=>{const K=Math.max(1,Number(D.limit)||20);await B.goto("https://www.zhihu.com/creator/manage/creation/all");await B.wait(2);const M=await B.evaluate(`(async () => {
+      const LIMIT = ${K};
+      // 大整数 id 加引号保精度（知乎内容 id 19 位，超出 JS Number 安全范围）
+      const safeParse = (text) => JSON.parse(
+        text.replace(/("(?:id|question_id|url_token)"\\s*:\\s*)(\\d{15,})/g, '$1"$2"')
+      );
+      const getJson = async (url) => {
+        const r = await fetch(url, { credentials: 'include' });
+        if (!r.ok) return { __http: r.status };
+        return safeParse(await r.text());
+      };
+      // 1) 内容列表，按页面原始参数逐页拉取（跟随 paging.next）
+      let url = '/api/v4/creators/creations/v2/all?start=0&end=0&limit=10&offset=0&need_co_creation=1&sort_type=created';
+      const items = [];
+      let totals = null;
+      for (let guard = 0; guard < 50 && items.length < LIMIT; guard++) {
+        const resp = await getJson(url);
+        if (resp && resp.__http) return { error: 'HTTP ' + resp.__http, stage: 'list' };
+        const data = Array.isArray(resp && resp.data) ? resp.data : [];
+        if (resp && resp.paging && typeof resp.paging.totals === 'number') totals = resp.paging.totals;
+        items.push(...data);
+        if (!resp || !resp.paging || resp.paging.is_end || !resp.paging.next || data.length === 0) break;
+        url = resp.paging.next;
+      }
+      // 2) 逐篇取单篇数据页的聚合指标（失败不阻断，仅缺列）
+      const today = new Date().toISOString().slice(0, 10);
+      const rows = [];
+      for (const item of items.slice(0, LIMIT)) {
+        const d = item.data || {};
+        let aggr = null;
+        try {
+          const a = await getJson('/api/v4/creators/analysis/realtime/content/aggr?type='
+            + encodeURIComponent(item.type) + '&token=' + encodeURIComponent(String(d.id || ''))
+            + '&end=' + today);
+          if (a && !a.__http && typeof a.pv !== 'undefined') aggr = a;
+        } catch (e) { /* 单篇聚合失败降级到列表指标 */ }
+        rows.push({ type: item.type, data: d, reaction: item.reaction || {}, aggr });
+        await new Promise((r) => setTimeout(r, 120));
+      }
+      return { rows, totals };
+    })()`),Q=M&&typeof M==="object"&&"data"in M&&"session"in M?M.data:M;if(!Q||Q.error){const F=Q&&Q.error;if(F==="HTTP 401"||F==="HTTP 403")throw new $("www.zhihu.com",`知乎创作中心接口返回 ${F}，请先在 Chrome 中登录知乎`);throw new b(`知乎内容列表获取失败（${F||"响应为空"}），请确认已登录 www.zhihu.com 且创作中心可访问`)}const V=Array.isArray(Q.rows)?Q.rows:[];if(V.length===0)throw new f("zhihu stats","未获取到任何内容。请确认已登录知乎且账号发布过内容（回答/文章/想法）。");return V.map((F)=>{const G=F.data||{},L=F.reaction||{},z=F.aggr||null,W=z&&z.advanced||{},Y=z&&z.content_mark?z.content_mark.is_collapsed?"被折叠":z.content_mark.is_suggest?"获推荐":"":"",H={};if(z){if(z.pageshow_uv)H.详情页访客uv=z.pageshow_uv;if(z.play)H.播放量=z.play;if(z.reaction)H.想法互动数=z.reaction;if(z.like_and_reaction)H.喜欢加互动=z.like_and_reaction;if(z.follower_conversion_rate)H.粉丝转化率=z.follower_conversion_rate}if(L.reviewing_comment_count)H.审核中评论数=L.reviewing_comment_count;if(G.question_id)H.问题id=String(G.question_id);if(G.answered_question_token)H.关联问题token=String(G.answered_question_token);return{id:String(G.id??""),type:F.type??"",title:G.title??"",url:A(F.type,String(G.id??""),G.question_id?String(G.question_id):""),published_at:h(G.created_time),views:z?z.pv??L.read_count??"":L.read_count??"",likes:L.vote_up_count??(z?z.upvote:"")??"",comments:L.comment_count??(z?z.comment:"")??"",collects:L.collect_count??(z?z.collect:"")??"",shares:z?z.share??"":"",shows:z?z.show??"":"",favors:L.like_count??(z?z.like:"")??"",reposts:z&&z.re_pin!=null?z.re_pin:L.repin_count??"",new_followers:z?z.new_follow_uv??"":"",finish_read_rate:X(W.finish_read_percent),interact_rate:X(W.positive_interact_percent),mark:Y,extra:Object.keys(H).length?JSON.stringify(H):""}})}});

package/clis/zhihu/target.js

@@ -1,91 +1 @@
-import { CliError } from '@jackwener/opencli/errors';
-const USER_RE = /^user:([A-Za-z0-9_-]+)$/;
-const QUESTION_RE = /^question:(\d+)$/;
-const ANSWER_RE = /^answer:(\d+):(\d+)$/;
-const ARTICLE_RE = /^article:(\d+)$/;
-const USER_PATH_RE = /^\/people\/([A-Za-z0-9_-]+)\/?$/;
-const QUESTION_PATH_RE = /^\/question\/(\d+)\/?$/;
-const ANSWER_PATH_RE = /^\/question\/(\d+)\/answer\/(\d+)\/?$/;
-const ARTICLE_PATH_RE = /^\/p\/(\d+)\/?$/;
-const EMPTY_AUTHORITY_RE = /^https:\/\/(?::)?@/i;
-function isAllowedZhihuUrl(url) {
-    return url.protocol === 'https:' && url.username === '' && url.password === '' && url.port === '';
-}
-export function parseTarget(input) {
-    const value = String(input).trim();
-    if (EMPTY_AUTHORITY_RE.test(value)) {
-        throw new CliError('INVALID_INPUT', 'Zhihu write commands require a normal HTTPS Zhihu URL without malformed authority', 'Example: https://www.zhihu.com/question/123456');
-    }
-    if (value.startsWith('answer:') && !ANSWER_RE.test(value)) {
-        throw new CliError('INVALID_INPUT', 'Invalid answer target, expected answer:<questionId>:<answerId>', 'Example: opencli zhihu like answer:123:456 --execute');
-    }
-    let match = value.match(USER_RE);
-    if (match) {
-        return { kind: 'user', slug: match[1], url: `https://www.zhihu.com/people/${match[1]}` };
-    }
-    match = value.match(QUESTION_RE);
-    if (match) {
-        return { kind: 'question', id: match[1], url: `https://www.zhihu.com/question/${match[1]}` };
-    }
-    match = value.match(ANSWER_RE);
-    if (match) {
-        return {
-            kind: 'answer',
-            questionId: match[1],
-            id: match[2],
-            url: `https://www.zhihu.com/question/${match[1]}/answer/${match[2]}`,
-        };
-    }
-    match = value.match(ARTICLE_RE);
-    if (match) {
-        return { kind: 'article', id: match[1], url: `https://zhuanlan.zhihu.com/p/${match[1]}` };
-    }
-    try {
-        const url = new URL(value);
-        if (!isAllowedZhihuUrl(url)) {
-            throw new Error('unsupported zhihu url variant');
-        }
-        if (url.hostname === 'www.zhihu.com') {
-            const userMatch = url.pathname.match(USER_PATH_RE);
-            if (userMatch) {
-                const slug = userMatch[1];
-                return { kind: 'user', slug, url: `https://www.zhihu.com/people/${slug}` };
-            }
-            const questionMatch = url.pathname.match(QUESTION_PATH_RE);
-            if (questionMatch) {
-                return { kind: 'question', id: questionMatch[1], url: `https://www.zhihu.com/question/${questionMatch[1]}` };
-            }
-            const answerMatch = url.pathname.match(ANSWER_PATH_RE);
-            if (answerMatch) {
-                return {
-                    kind: 'answer',
-                    questionId: answerMatch[1],
-                    id: answerMatch[2],
-                    url: `https://www.zhihu.com/question/${answerMatch[1]}/answer/${answerMatch[2]}`,
-                };
-            }
-        }
-        if (url.hostname === 'zhuanlan.zhihu.com') {
-            const articleMatch = url.pathname.match(ARTICLE_PATH_RE);
-            if (articleMatch) {
-                return { kind: 'article', id: articleMatch[1], url: `https://zhuanlan.zhihu.com/p/${articleMatch[1]}` };
-            }
-        }
-    }
-    catch { }
-    throw new CliError('INVALID_INPUT', 'Zhihu write commands require a Zhihu URL or typed target like question:123 or answer:123:456', 'Example: opencli zhihu like answer:123:456 --execute');
-}
-export function assertAllowedKinds(command, target) {
-    const allowed = {
-        follow: ['user', 'question'],
-        like: ['answer', 'article'],
-        favorite: ['answer', 'article'],
-        comment: ['answer', 'article'],
-        answer: ['question'],
-    };
-    if (!allowed[command]?.includes(target.kind)) {
-        throw new CliError('UNSUPPORTED_TARGET', `zhihu ${command} does not support ${target.kind} targets`);
-    }
-    return target;
-}
-export const __test__ = { parseTarget, assertAllowedKinds };
+import{CliError as o}from"@jackwener/opencli/errors";const c=/^user:([A-Za-z0-9_-]+)$/,w=/^question:(\d+)$/,u=/^answer:(\d+):(\d+)$/,l=/^article:(\d+)$/,p=/^\/people\/([A-Za-z0-9_-]+)\/?$/,d=/^\/question\/(\d+)\/?$/,m=/^\/question\/(\d+)\/answer\/(\d+)\/?$/,E=/^\/p\/(\d+)\/?$/,_=/^https:\/\/(?::)?@/i;function f(n){return n.protocol==="https:"&&n.username===""&&n.password===""&&n.port===""}export function parseTarget(n){const e=String(n).trim();if(_.test(e))throw new o("INVALID_INPUT","Zhihu write commands require a normal HTTPS Zhihu URL without malformed authority","Example: https://www.zhihu.com/question/123456");if(e.startsWith("answer:")&&!u.test(e))throw new o("INVALID_INPUT","Invalid answer target, expected answer:<questionId>:<answerId>","Example: opencli zhihu like answer:123:456 --execute");let t=e.match(c);if(t)return{kind:"user",slug:t[1],url:`https://www.zhihu.com/people/${t[1]}`};t=e.match(w);if(t)return{kind:"question",id:t[1],url:`https://www.zhihu.com/question/${t[1]}`};t=e.match(u);if(t)return{kind:"answer",questionId:t[1],id:t[2],url:`https://www.zhihu.com/question/${t[1]}/answer/${t[2]}`};t=e.match(l);if(t)return{kind:"article",id:t[1],url:`https://zhuanlan.zhihu.com/p/${t[1]}`};try{const i=new URL(e);if(!f(i))throw Error("unsupported zhihu url variant");if(i.hostname==="www.zhihu.com"){const r=i.pathname.match(p);if(r){const a=r[1];return{kind:"user",slug:a,url:`https://www.zhihu.com/people/${a}`}}const h=i.pathname.match(d);if(h)return{kind:"question",id:h[1],url:`https://www.zhihu.com/question/${h[1]}`};const s=i.pathname.match(m);if(s)return{kind:"answer",questionId:s[1],id:s[2],url:`https://www.zhihu.com/question/${s[1]}/answer/${s[2]}`}}if(i.hostname==="zhuanlan.zhihu.com"){const r=i.pathname.match(E);if(r)return{kind:"article",id:r[1],url:`https://zhuanlan.zhihu.com/p/${r[1]}`}}}catch{}throw new o("INVALID_INPUT","Zhihu write commands require a Zhihu URL or typed target like question:123 or answer:123:456","Example: opencli zhihu like answer:123:456 --execute")}export function assertAllowedKinds(n,e){if(!{follow:["user","question"],like:["answer","article"],favorite:["answer","article"],comment:["answer","article"],answer:["question"]}[n]?.includes(e.kind))throw new o("UNSUPPORTED_TARGET",`zhihu ${n} does not support ${e.kind} targets`);return e}export const __test__={parseTarget,assertAllowedKinds};