publishport-opencli 1.0.20 → 1.0.21

package/clis/zhihu/answer-comments.js

@@ -1,4 +1,4 @@
-import{cli as S,Strategy as L}from"@jackwener/opencli/registry";import{ArgumentError as g,AuthRequiredError as N,CommandExecutionError as c,EmptyResultError as _}from"@jackwener/opencli/errors";import{stripHtml as T}from"./text.js";function E(e){return T(e,{preserveBlocks:!0})}const Z=/^\d+$/,C=/^answer:(\d+):(\d+)$/,I=/^\/question\/(\d+)\/answer\/(\d+)\/?$/,U=/^\/answer\/(\d+)\/?$/;function $(e){const n=String(e??"").trim();if(!n)return null;if(Z.test(n))return{answerId:n,questionId:""};const t=n.match(C);if(t)return{questionId:t[1],answerId:t[2]};try{const r=new URL(n);if(r.protocol!=="https:"||r.username||r.password||r.port||r.hostname!=="www.zhihu.com"&&r.hostname!=="zhihu.com")return null;let i=r.pathname.match(I);if(i)return{questionId:i[1],answerId:i[2]};i=r.pathname.match(U);if(i)return{answerId:i[1],questionId:""}}catch{return null}return null}function q(e){const n=String(e??"").trim();if(!n)return"";try{const t=new URL(n);if(t.protocol!=="https:"||t.hostname!=="www.zhihu.com"&&t.hostname!=="zhihu.com")return"";return t.pathname.match(I)?.[1]||""}catch{return""}}function x(e){return Number.isInteger(e)&&e>=0?e:0}function k(e){return typeof e==="number"&&Number.isFinite(e)&&e>0?new Date(e*1000).toISOString():""}function b(e){return e?.member?.name||e?.name||""}function v(e){if(typeof e==="string")return e.trim();if(typeof e==="number"&&Number.isSafeInteger(e)&&e>=0)return String(e);return""}function H(e,n,t,r){if(n&&t&&r)return`https://www.zhihu.com/question/${n}/answer/${t}#comment-${r}`;return typeof e==="string"?e:""}function R(e,n){if(typeof e!=="string"||!e)return"";try{const t=new URL(e),r=`/api/v4/answers/${n}/comments`,i=`/answers/${n}/comments`;if(t.protocol!=="https:"||t.username||t.password||t.port)return"";if(t.hostname==="www.zhihu.com"&&t.pathname===r)return t.toString();if(t.hostname==="api.zhihu.com"&&t.pathname===i)return`https://www.zhihu.com${r}${t.search}`}catch{return""}return""}function y(e,{answerId:n,questionId:t,topLevelLimit:r,repliesLimit:i}){const a=[];let w=0,l=0,u=0,f=!1,h=0;for(const s of e){if(!s||typeof s!=="object"||Array.isArray(s)){h+=1;continue}const o=v(s.id);if(!o){h+=1;continue}const d=b(s.author),p=b(s.reply_to_author),m=Boolean(p);if(!m){if(w>=r){f=!0;break}w+=1;l=w;u=0}else if(!l||u>=i)continue;else u+=1;a.push({rank:a.length+1,comment_rank:l,reply_rank:m?u:0,depth:0,id:o,parent_id:"",author:d||"anonymous",reply_to:p,likes:x(s.vote_count),created_at:k(s.created_time),url:H(s.url,t,n,o),content:E(s.content||"")})}return{rows:a,topLevelCount:w,reachedTopLevelLimit:f,malformedComments:h}}const A=1000,z=100,P=20;S({site:"zhihu",name:"answer-comments",access:"read",description:"知乎回答评论列表",domain:"www.zhihu.com",strategy:L.COOKIE,args:[{name:"id",required:!0,positional:!0,help:"Answer ID, full Zhihu answer URL, or typed target (answer:<qid>:<aid>)"},{name:"limit",type:"int",default:20,help:"Number of top-level comments (max 1000)"},{name:"replies-limit",type:"int",default:3,help:"Number of replies to include per top-level comment (max 100)"}],columns:["rank","comment_rank","reply_rank","depth","id","parent_id","author","reply_to","likes","created_at","url","content"],func:async(e,n)=>{const t=$(n.id);if(!t)throw new g("Answer ID must be a numeric id, a Zhihu answer URL, or answer:<qid>:<aid>","Example: ppcli zhihu answer-comments 1937205528846655537");const r=Number(n.limit??20);if(!Number.isInteger(r)||r<=0||r>A)throw new g(`--limit must be a positive integer no greater than ${A}`);const i=Number(n["replies-limit"]??3);if(!Number.isInteger(i)||i<0||i>z)throw new g(`--replies-limit must be an integer between 0 and ${z}`);const{answerId:a}=t;try{await e.goto(`https://www.zhihu.com/answer/${a}`)}catch(o){throw new c(`Failed to open Zhihu answer ${a}: ${o instanceof Error?o.message:String(o)}`,"Open the answer URL in Chrome and retry after the page is reachable.")}const w=e.getCurrentUrl?q(await e.getCurrentUrl().catch(()=>"")):"",l=t.questionId||w;let u=`https://www.zhihu.com/api/v4/answers/${a}/comments?order=normal&limit=${P}&offset=0&status=open`;const f=[],h=new Set;while(u&&!h.has(u)){h.add(u);const o=await e.evaluate(`
+import{cli as L,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentError as g,AuthRequiredError as T,CommandExecutionError as c,EmptyResultError as _}from"@jackwener/opencli/errors";import{stripHtml as Z}from"./text.js";function E(e){return Z(e,{preserveBlocks:!0})}const C=/^\d+$/,U=/^answer:(\d+):(\d+)$/,I=/^\/question\/(\d+)\/answer\/(\d+)\/?$/,q=/^\/answer\/(\d+)\/?$/;function b(e){const n=String(e??"").trim();if(!n)return null;if(C.test(n))return{answerId:n,questionId:""};const t=n.match(U);if(t)return{questionId:t[1],answerId:t[2]};try{const r=new URL(n);if(r.protocol!=="https:"||r.username||r.password||r.port||r.hostname!=="www.zhihu.com"&&r.hostname!=="zhihu.com")return null;let i=r.pathname.match(I);if(i)return{questionId:i[1],answerId:i[2]};i=r.pathname.match(q);if(i)return{answerId:i[1],questionId:""}}catch{return null}return null}function x(e){const n=String(e??"").trim();if(!n)return"";try{const t=new URL(n);if(t.protocol!=="https:"||t.hostname!=="www.zhihu.com"&&t.hostname!=="zhihu.com")return"";return t.pathname.match(I)?.[1]||""}catch{return""}}function k(e){return Number.isInteger(e)&&e>=0?e:0}function v(e){return typeof e==="number"&&Number.isFinite(e)&&e>0?new Date(e*1000).toISOString():""}function R(e){return e?.member?.name||e?.name||""}function H(e){if(typeof e==="string")return e.trim();if(typeof e==="number"&&Number.isSafeInteger(e)&&e>=0)return String(e);return""}function P(e,n,t,r){if(n&&t&&r)return`https://www.zhihu.com/question/${n}/answer/${t}#comment-${r}`;return typeof e==="string"?e:""}function A(e,n){if(typeof e!=="string"||!e)return"";try{const t=new URL(e),r=`/api/v4/answers/${n}/comments`,i=`/answers/${n}/comments`;if(t.protocol!=="https:"||t.username||t.password||t.port)return"";if(t.hostname==="www.zhihu.com"&&t.pathname===r)return t.toString();if(t.hostname==="api.zhihu.com"&&t.pathname===i)return`https://www.zhihu.com${r}${t.search}`}catch{return""}return""}function y(e,{answerId:n,questionId:t,topLevelLimit:r,repliesLimit:i}){const a=[];let w=0,l=0,u=0,f=!1,h=0;for(const s of e){if(!s||typeof s!=="object"||Array.isArray(s)){h+=1;continue}const o=H(s.id);if(!o){h+=1;continue}const d=R(s.author),p=R(s.reply_to_author),m=Boolean(p);if(!m){if(w>=r){f=!0;break}w+=1;l=w;u=0}else if(!l||u>=i)continue;else u+=1;a.push({rank:a.length+1,comment_rank:l,reply_rank:m?u:0,depth:0,id:o,parent_id:"",author:d||"anonymous",reply_to:p,likes:k(s.vote_count),created_at:v(s.created_time),url:P(s.url,t,n,o),content:E(s.content||"")})}return{rows:a,topLevelCount:w,reachedTopLevelLimit:f,malformedComments:h}}const z=1000,S=100,O=20;L({site:"zhihu",name:"answer-comments",access:"read",description:"知乎回答评论列表",domain:"www.zhihu.com",strategy:N.COOKIE,args:[{name:"id",required:!0,positional:!0,help:"Answer ID, full Zhihu answer URL, or typed target (answer:<qid>:<aid>)"},{name:"limit",type:"int",default:20,help:"Number of top-level comments (max 1000)"},{name:"replies-limit",type:"int",default:3,help:"Number of replies to include per top-level comment (max 100)"}],columns:["rank","comment_rank","reply_rank","depth","id","parent_id","author","reply_to","likes","created_at","url","content"],func:async(e,n)=>{const t=b(n.id);if(!t)throw new g("Answer ID must be a numeric id, a Zhihu answer URL, or answer:<qid>:<aid>","Example: ppcli zhihu answer-comments 1937205528846655537");const r=Number(n.limit??20);if(!Number.isInteger(r)||r<=0||r>z)throw new g(`--limit must be a positive integer no greater than ${z}`);const i=Number(n["replies-limit"]??3);if(!Number.isInteger(i)||i<0||i>S)throw new g(`--replies-limit must be an integer between 0 and ${S}`);const{answerId:a}=t;try{await e.goto(`https://www.zhihu.com/answer/${a}`)}catch(o){throw new c(`Failed to open Zhihu answer ${a}: ${o instanceof Error?o.message:String(o)}`,"Open the answer URL in Chrome and retry after the page is reachable.")}const w=e.getCurrentUrl?x(await e.getCurrentUrl().catch(()=>"")):"",l=t.questionId||w;let u=`https://www.zhihu.com/api/v4/answers/${a}/comments?order=normal&limit=${O}&offset=0&status=open`;const f=[],h=new Set;while(u&&!h.has(u)){h.add(u);const o=await e.evaluate(`
       (async () => {
         const r = await fetch(${JSON.stringify(u)}, { credentials: 'include' });
         if (!r.ok) return { __httpError: r.status };
@@ -8,4 +8,4 @@ import{cli as S,Strategy as L}from"@jackwener/opencli/registry";import{ArgumentE
           return { __malformedJson: error instanceof Error ? error.message : String(error) };
         }
       })()
-    `).catch((m)=>{throw new c(`Zhihu answer comments request failed: ${m instanceof Error?m.message:String(m)}`,"Try again later or rerun with -v for more detail.")});if(!o||o.__httpError){const m=o?.__httpError;if(m===401||m===403)throw new N("www.zhihu.com","Failed to fetch Zhihu answer comments");if(m===404)throw new _("zhihu answer-comments",`No Zhihu answer comments resource was found for ${a}.`);throw new c(m?`Zhihu answer comments request failed (HTTP ${m})`:"Zhihu answer comments request failed","Try again later or rerun with -v for more detail")}if(o.__malformedJson)throw new c(`Zhihu answer comments returned malformed JSON: ${o.__malformedJson}`,"Try again later or rerun with -v for more detail");if(!Array.isArray(o.data)||!o.paging||typeof o.paging!=="object")throw new c("Zhihu answer comments returned a malformed payload","Try again later or rerun with -v for more detail");f.push(...o.data);const d=y(f,{answerId:a,questionId:l,topLevelLimit:r,repliesLimit:i});if(d.malformedComments>0)throw new c("Zhihu answer comments contained rows without comment ids");if(d.reachedTopLevelLimit||o.paging?.is_end){if(d.rows.length===0)throw new _("zhihu answer-comments",`No comments found for answer ${a}.`);return d.rows}const p=R(o.paging?.next,a);if(!p)throw new c("Zhihu answer comments pagination returned malformed next URL");if(h.has(p))throw new c("Zhihu answer comments pagination returned a repeated next URL");u=p}const s=y(f,{answerId:a,questionId:l,topLevelLimit:r,repliesLimit:i});if(s.malformedComments>0)throw new c("Zhihu answer comments contained rows without comment ids");if(s.rows.length===0)throw new _("zhihu answer-comments",`No comments found for answer ${a}.`);return s.rows}});export const __test__={stripHtml:E,parseAnswerTarget:$,normalizeCommentsApiUrl:R,buildRows:y};
+    `).catch((m)=>{throw new c(`Zhihu answer comments request failed: ${m instanceof Error?m.message:String(m)}`,"Try again later or rerun with -v for more detail.")});if(!o||o.__httpError){const m=o?.__httpError;if(m===401||m===403)throw new T("www.zhihu.com","Failed to fetch Zhihu answer comments");if(m===404)throw new _("zhihu answer-comments",`No Zhihu answer comments resource was found for ${a}.`);throw new c(m?`Zhihu answer comments request failed (HTTP ${m})`:"Zhihu answer comments request failed","Try again later or rerun with -v for more detail")}if(o.__malformedJson)throw new c(`Zhihu answer comments returned malformed JSON: ${o.__malformedJson}`,"Try again later or rerun with -v for more detail");if(!Array.isArray(o.data)||!o.paging||typeof o.paging!=="object")throw new c("Zhihu answer comments returned a malformed payload","Try again later or rerun with -v for more detail");f.push(...o.data);const d=y(f,{answerId:a,questionId:l,topLevelLimit:r,repliesLimit:i});if(d.malformedComments>0)throw new c("Zhihu answer comments contained rows without comment ids");if(d.reachedTopLevelLimit||o.paging?.is_end){if(d.rows.length===0)throw new _("zhihu answer-comments",`No comments found for answer ${a}.`);return d.rows}const p=A(o.paging?.next,a);if(!p)throw new c("Zhihu answer comments pagination returned malformed next URL");if(h.has(p))throw new c("Zhihu answer comments pagination returned a repeated next URL");u=p}const s=y(f,{answerId:a,questionId:l,topLevelLimit:r,repliesLimit:i});if(s.malformedComments>0)throw new c("Zhihu answer comments contained rows without comment ids");if(s.rows.length===0)throw new _("zhihu answer-comments",`No comments found for answer ${a}.`);return s.rows}});export const __test__={stripHtml:E,parseAnswerTarget:b,normalizeCommentsApiUrl:A,buildRows:y};

package/clis/zhihu/answer-detail.js

@@ -1,6 +1,6 @@
-import{cli as y,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentError as O,AuthRequiredError as P,CommandExecutionError as $,EmptyResultError as q}from"@jackwener/opencli/errors";import{stripHtml as H}from"./text.js";function j(G){return H(G,{preserveBlocks:!0})}const U=/^\d+$/,S=/^answer:(\d+):(\d+)$/,F=/^\/question\/(\d+)\/answer\/(\d+)\/?$/,T=/^\/answer\/(\d+)\/?$/,R=/^\/question\/(\d+)\/?$/,C=/^\/api\/v4\/questions\/(\d+)\/?$/;function D(G){const X=String(G??"").trim();if(!X)return null;if(U.test(X))return{answerId:X,questionId:""};const L=X.match(S);if(L)return{questionId:L[1],answerId:L[2]};try{const K=new URL(X);if(K.protocol!=="https:"||K.username||K.password||K.port||K.hostname!=="www.zhihu.com"&&K.hostname!=="zhihu.com")return null;let Z=K.pathname.match(F);if(Z)return{questionId:Z[1],answerId:Z[2]};Z=K.pathname.match(T);if(Z)return{answerId:Z[1],questionId:""}}catch{return null}return null}function _(G){return D(G)?.answerId??null}function M(G){const X=String(G??"").trim();if(!X)return"";try{const L=new URL(X);if(L.protocol!=="https:"||L.hostname!=="www.zhihu.com"&&L.hostname!=="zhihu.com")return"";return L.pathname.match(F)?.[1]||L.pathname.match(R)?.[1]||L.pathname.match(C)?.[1]||""}catch{return""}}function z(G){return Number.isInteger(G)&&G>=0?G:0}function h(G){return typeof G==="number"&&Number.isFinite(G)&&G>0?new Date(G*1000).toISOString():""}y({site:"zhihu",name:"answer-detail",access:"read",description:"知乎单个回答完整内容（按 answer ID 获取）",domain:"www.zhihu.com",strategy:N.COOKIE,args:[{name:"id",required:!0,positional:!0,help:"Answer ID, full Zhihu answer URL, or typed target (answer:<qid>:<aid>)"},{name:"max-content",type:"int",default:0,help:"Optional cap on stripped content length in characters (0 = no truncation, return the full answer)"}],columns:["id","author","votes","comments","question_id","question_title","url","created_at","updated_at","content"],func:async(G,X)=>{const L=D(X.id);if(!L)throw new O("Answer ID must be a numeric id, a Zhihu answer URL, or answer:<qid>:<aid>","Example: ppcli zhihu answer-detail 1937205528846655537");const{answerId:K}=L,Z=X["max-content"],b=Z==null?0:Number(Z);if(!Number.isInteger(b)||b<0)throw new O("--max-content must be a non-negative integer (0 = no cap, full content)","Example: --max-content 2000");try{await G.goto(`https://www.zhihu.com/answer/${K}`)}catch(V){throw new $(`Failed to open Zhihu answer ${K}: ${V instanceof Error?V.message:String(V)}`,"Open the answer URL in Chrome and retry after the page is reachable.")}const W=G.getCurrentUrl?M(await G.getCurrentUrl().catch(()=>"")):"",k=`https://www.zhihu.com/api/v4/answers/${K}?include=content,voteup_count,comment_count,author,created_time,updated_time,question`,J=await G.evaluate(`
+import{cli as q,Strategy as A}from"@jackwener/opencli/registry";import{ArgumentError as l,AuthRequiredError as R,CommandExecutionError as s,EmptyResultError as S}from"@jackwener/opencli/errors";import{stripHtml as T}from"./text.js";function p(t){return T(t,{preserveBlocks:!0})}const z=/^\d+$/,x=/^answer:(\d+):(\d+)$/,f=/^\/question\/(\d+)\/answer\/(\d+)\/?$/,N=/^\/answer\/(\d+)\/?$/,v=/^\/question\/(\d+)\/?$/,U=/^\/api\/v4\/questions\/(\d+)\/?$/;function d(t){const a=String(t??"").trim();if(!a)return null;if(z.test(a))return{answerId:a,questionId:""};const n=a.match(x);if(n)return{questionId:n[1],answerId:n[2]};try{const r=new URL(a);if(r.protocol!=="https:"||r.username||r.password||r.port||r.hostname!=="www.zhihu.com"&&r.hostname!=="zhihu.com")return null;let i=r.pathname.match(f);if(i)return{questionId:i[1],answerId:i[2]};i=r.pathname.match(N);if(i)return{answerId:i[1],questionId:""}}catch{return null}return null}function Z(t){return d(t)?.answerId??null}function w(t){const a=String(t??"").trim();if(!a)return"";try{const n=new URL(a);if(n.protocol!=="https:"||n.hostname!=="www.zhihu.com"&&n.hostname!=="zhihu.com")return"";return n.pathname.match(f)?.[1]||n.pathname.match(v)?.[1]||n.pathname.match(U)?.[1]||""}catch{return""}}function _(t){return Number.isInteger(t)&&t>=0?t:0}function g(t){return typeof t==="number"&&Number.isFinite(t)&&t>0?new Date(t*1000).toISOString():""}q({site:"zhihu",name:"answer-detail",access:"read",description:"知乎单个回答完整内容（按 answer ID 获取）",domain:"www.zhihu.com",strategy:A.COOKIE,args:[{name:"id",required:!0,positional:!0,help:"Answer ID, full Zhihu answer URL, or typed target (answer:<qid>:<aid>)"},{name:"max-content",type:"int",default:0,help:"Optional cap on stripped content length in characters (0 = no truncation, return the full answer)"}],columns:["id","author","votes","comments","question_id","question_title","url","created_at","updated_at","content"],func:async(t,a)=>{const n=d(a.id);if(!n)throw new l("Answer ID must be a numeric id, a Zhihu answer URL, or answer:<qid>:<aid>","Example: ppcli zhihu answer-detail 1937205528846655537");const{answerId:r}=n,i=a["max-content"],u=i==null?0:Number(i);if(!Number.isInteger(u)||u<0)throw new l("--max-content must be a non-negative integer (0 = no cap, full content)","Example: --max-content 2000");try{await t.goto(`https://www.zhihu.com/answer/${r}`)}catch(o){throw new s(`Failed to open Zhihu answer ${r}: ${o instanceof Error?o.message:String(o)}`,"Open the answer URL in Chrome and retry after the page is reachable.")}const y=t.getCurrentUrl?w(await t.getCurrentUrl().catch(()=>"")):"",E=`https://www.zhihu.com/api/v4/answers/${r}?include=content,voteup_count,comment_count,author,created_time,updated_time,question`,e=await t.evaluate(`
       (async () => {
-        const r = await fetch(${JSON.stringify(k)}, { credentials: 'include' });
+        const r = await fetch(${JSON.stringify(E)}, { credentials: 'include' });
         if (!r.ok) return { __httpError: r.status };
         try {
           return await r.json();
@@ -8,4 +8,4 @@ import{cli as y,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentE
           return { __malformedJson: error instanceof Error ? error.message : String(error) };
         }
       })()
-    `).catch((V)=>{throw new $(`Zhihu answer detail request failed: ${V instanceof Error?V.message:String(V)}`,"Try again later or rerun with -v for more detail.")});if(!J||J.__httpError){const V=J?.__httpError;if(V===401||V===403)throw new P("www.zhihu.com","Failed to fetch Zhihu answer detail");if(V===404)throw new q("zhihu answer-detail",`No Zhihu answer was found for ${K}.`);throw new $(V?`Zhihu answer detail request failed (HTTP ${V})`:"Zhihu answer detail request failed","Try again later or rerun with -v for more detail")}if(J.__malformedJson)throw new $(`Zhihu answer detail returned malformed JSON: ${J.__malformedJson}`,"Try again later or rerun with -v for more detail");if(typeof J!=="object"||Array.isArray(J))throw new $("Zhihu answer detail returned a malformed payload","Try again later or rerun with -v for more detail");if(J.error||J.error_msg||J.message)throw new $(`Zhihu answer detail returned an error payload: ${J.error?.message||J.error_msg||J.message}`,"Try again later or rerun with -v for more detail");if(!Object.prototype.hasOwnProperty.call(J,"content"))throw new $("Zhihu answer detail payload did not include answer content","Try again later or rerun with -v for more detail");const f=J.question||{},B=L.questionId||W||M(f.url)||(f.id==null?"":String(f.id)),Y=j(J.content||""),Q=b>0&&Y.length>b?Y.substring(0,b):Y;return[{id:K,author:J.author?.name||"anonymous",votes:z(J.voteup_count),comments:z(J.comment_count),question_id:B,question_title:f.title||"",url:B?`https://www.zhihu.com/question/${B}/answer/${K}`:`https://www.zhihu.com/answer/${K}`,created_at:h(J.created_time),updated_at:h(J.updated_time),content:Q}]}});export const __test__={stripHtml:j,extractAnswerId:_,parseAnswerTarget:D,extractQuestionIdFromAnswerUrl:M};
+    `).catch((o)=>{throw new s(`Zhihu answer detail request failed: ${o instanceof Error?o.message:String(o)}`,"Try again later or rerun with -v for more detail.")});if(!e||e.__httpError){const o=e?.__httpError;if(o===401||o===403)throw new R("www.zhihu.com","Failed to fetch Zhihu answer detail");if(o===404)throw new S("zhihu answer-detail",`No Zhihu answer was found for ${r}.`);throw new s(o?`Zhihu answer detail request failed (HTTP ${o})`:"Zhihu answer detail request failed","Try again later or rerun with -v for more detail")}if(e.__malformedJson)throw new s(`Zhihu answer detail returned malformed JSON: ${e.__malformedJson}`,"Try again later or rerun with -v for more detail");if(typeof e!=="object"||Array.isArray(e))throw new s("Zhihu answer detail returned a malformed payload","Try again later or rerun with -v for more detail");if(e.error||e.error_msg||e.message)throw new s(`Zhihu answer detail returned an error payload: ${e.error?.message||e.error_msg||e.message}`,"Try again later or rerun with -v for more detail");if(!Object.prototype.hasOwnProperty.call(e,"content"))throw new s("Zhihu answer detail payload did not include answer content","Try again later or rerun with -v for more detail");const c=e.question||{},h=n.questionId||y||w(c.url)||(c.id==null?"":String(c.id)),m=p(e.content||""),I=u>0&&m.length>u?m.substring(0,u):m;return[{id:r,author:e.author?.name||"anonymous",votes:_(e.voteup_count),comments:_(e.comment_count),question_id:h,question_title:c.title||"",url:h?`https://www.zhihu.com/question/${h}/answer/${r}`:`https://www.zhihu.com/answer/${r}`,created_at:g(e.created_time),updated_at:g(e.updated_time),content:I}]}});export const __test__={stripHtml:p,extractAnswerId:Z,parseAnswerTarget:d,extractQuestionIdFromAnswerUrl:w};

package/clis/zhihu/answer.js

@@ -1 +1 @@
-import{CommandExecutionError as V}from"@jackwener/opencli/errors";import{cli as W,Strategy as X}from"@jackwener/opencli/registry";import{publishArticle as Y}from"../_shared/article/publish.js";import{zhihuImageProfile as Z}from"./image-profile.js";import{assertAllowedKinds as $,parseTarget as z}from"./target.js";import{buildResultRow as K,requireExecute as S,resolveCurrentUserIdentity as _,resolvePayload as v}from"./write-shared.js";function C(J){return{home:J,originRe:"https?://(www\\.)?zhihu\\.com",outputFormat:"html",preprocessConfig:{removeSpecialTags:!0,removeSpecialTagsWithParent:!0,processCodeBlocks:!0,convertSectionToDiv:!0,removeTrailingBr:!0,unwrapSingleChildContainers:!0,unwrapNestedFigures:!0,compactHtml:!0,removeEmptyLines:!0,removeEmptyDivs:!0,removeNestedEmptyContainers:!0},image:Z,publish:async(F,O)=>{const G=F.content.replace(/<img([^>]+?)\/?>/gi,"<figure><img$1></figure>"),L=F.params&&F.params.questionId;if(!L)return{ok:!1,stage:"publish",message:"缺少 questionId"};const D=await fetch("https://www.zhihu.com/api/v4/questions/"+L+"/answers",{method:"POST",credentials:"include",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:G,reshipment_settings:"disallowed"})}),M=await D.text();let B=null;try{B=JSON.parse(M)}catch(Q){}if(!D.ok)return{ok:!1,stage:"publish",status:D.status,message:B&&B.error&&B.error.message||M.slice(0,300),detail:B};if(!B||!B.id)return{ok:!1,stage:"publish",status:D.status,message:"回答接口没有返回回答 id："+M.slice(0,300)};const H=String(B.id);return{ok:!0,draft:!1,id:H,url:B.url||"https://www.zhihu.com/question/"+L+"/answer/"+H}}}}W({site:"zhihu",name:"answer",access:"write",description:"Answer a Zhihu question. Body is Markdown by default (paragraphs become <p>); pass --html for raw HTML. Images (including local file paths) are auto-rehosted to Zhihu.",domain:"www.zhihu.com",strategy:X.COOKIE,browser:!0,args:[{name:"target",positional:!0,required:!0,help:"Zhihu question URL (e.g. https://www.zhihu.com/question/461491497) or typed target question:461491497; bare numeric id is rejected"},{name:"text",positional:!0,help:"Answer body (Markdown by default; pass --html for raw HTML)"},{name:"file",help:"Answer body file path (UTF-8, Markdown by default)"},{name:"html",type:"boolean",help:"Treat body as raw HTML instead of Markdown"},{name:"execute",type:"boolean",help:"Actually perform the write action"}],columns:["status","outcome","message","target_type","target","created_target","created_url","author_identity"],func:async(J,F)=>{if(!J)throw new V("Browser session required for zhihu answer");S(F);const O=String(F.target),G=$("answer",z(O)),L=await v(F),D=await Y(J,{title:"",body:L,format:F.html?"html":"markdown",profile:C(G.url),publishParams:{questionId:G.id}}),M=await _(J),B=D.images.uploaded.length|0,H=D.images.failed.length|0;let Q=`Answered question ${G.id}`;if(B||H)Q+=` · images: ${B} rehosted${H?`, ${H} failed`:""}`;return K(Q,G.kind,O,"created",{created_target:"answer:"+G.id+":"+D.id,created_url:D.url,author_identity:M})}});
+import{CommandExecutionError as m}from"@jackwener/opencli/errors";import{cli as d,Strategy as h}from"@jackwener/opencli/registry";import{publishArticle as c}from"../_shared/article/publish.js";import{zhihuImageProfile as p}from"./image-profile.js";import{assertAllowedKinds as w,parseTarget as g}from"./target.js";import{buildResultRow as f,requireExecute as y,resolveCurrentUserIdentity as b,resolvePayload as q}from"./write-shared.js";function T(i){return{home:i,originRe:"https?://(www\\.)?zhihu\\.com",outputFormat:"html",preprocessConfig:{removeSpecialTags:!0,removeSpecialTagsWithParent:!0,processCodeBlocks:!0,convertSectionToDiv:!0,removeTrailingBr:!0,unwrapSingleChildContainers:!0,unwrapNestedFigures:!0,compactHtml:!0,removeEmptyLines:!0,removeEmptyDivs:!0,removeNestedEmptyContainers:!0},image:p,publish:async(r,u)=>{const s=r.content.replace(/<img([^>]+?)\/?>/gi,"<figure><img$1></figure>"),o=r.params&&r.params.questionId;if(!o)return{ok:!1,stage:"publish",message:"缺少 questionId"};const t=await fetch("https://www.zhihu.com/api/v4/questions/"+o+"/answers",{method:"POST",credentials:"include",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:s,reshipment_settings:"disallowed"})}),n=await t.text();let e=null;try{e=JSON.parse(n)}catch(l){}if(!t.ok)return{ok:!1,stage:"publish",status:t.status,message:e&&e.error&&e.error.message||n.slice(0,300),detail:e};if(!e||!e.id)return{ok:!1,stage:"publish",status:t.status,message:"回答接口没有返回回答 id："+n.slice(0,300)};const a=String(e.id);return{ok:!0,draft:!1,id:a,url:e.url||"https://www.zhihu.com/question/"+o+"/answer/"+a}}}}d({site:"zhihu",name:"answer",access:"write",description:"Answer a Zhihu question. Body is Markdown by default (paragraphs become <p>); pass --html for raw HTML. Images (including local file paths) are auto-rehosted to Zhihu.",domain:"www.zhihu.com",strategy:h.COOKIE,browser:!0,args:[{name:"target",positional:!0,required:!0,help:"Zhihu question URL (e.g. https://www.zhihu.com/question/461491497) or typed target question:461491497; bare numeric id is rejected"},{name:"text",positional:!0,help:"Answer body (Markdown by default; pass --html for raw HTML)"},{name:"file",help:"Answer body file path (UTF-8, Markdown by default)"},{name:"html",type:"boolean",help:"Treat body as raw HTML instead of Markdown"},{name:"execute",type:"boolean",help:"Actually perform the write action"}],columns:["status","outcome","message","target_type","target","created_target","created_url","author_identity"],func:async(i,r)=>{if(!i)throw new m("Browser session required for zhihu answer");y(r);const u=String(r.target),s=w("answer",g(u)),o=await q(r),t=await c(i,{title:"",body:o,format:r.html?"html":"markdown",profile:T(s.url),publishParams:{questionId:s.id}}),n=await b(i),e=t.images.uploaded.length|0,a=t.images.failed.length|0;let l=`Answered question ${s.id}`;if(e||a)l+=` · images: ${e} rehosted${a?`, ${a} failed`:""}`;return f(l,s.kind,u,"created",{created_target:"answer:"+s.id+":"+t.id,created_url:t.url,author_identity:n})}});

package/clis/zhihu/article-transform.js

@@ -1 +1 @@
-export function transformTables(A){let g=A.replace(/<figure[^>]*>\s*(<table[\s\S]*?<\/table>)\s*<\/figure>/gi,"$1");g=g.replace(/<table[^>]*>([\s\S]*?)<\/table>/gi,(E,q)=>{const v=q.match(/<thead[^>]*>([\s\S]*?)<\/thead>/i),x=q.match(/<tbody[^>]*>([\s\S]*?)<\/tbody>/i);let B="",j="";if(v)B=v[1].replace(/<td([^>]*)>/gi,"<th$1>").replace(/<\/td>/gi,"</th>");if(x)j=x[1];else j=q.replace(/<thead[^>]*>[\s\S]*?<\/thead>/gi,"").replace(/<\/?tbody[^>]*>/gi,"");if(!v){const z=j.match(/<tr[^>]*>([\s\S]*?)<\/tr>/i);if(z){const D=z[1];if(/<th[^>]*>/i.test(D)&&!/<td[^>]*>/i.test(D)){B=z[0];j=j.replace(z[0],"")}}}return`<table data-draft-node="block" data-draft-type="table" data-size="normal" data-row-style="normal"><tbody>${B}${j}</tbody></table>`});return g}export function transformZhihuHtml(A){let g=A;g=transformTables(g);g=g.replace(/<img([^>]+)src="([^"]+)"([^>]*?)\/?>/gi,(E,q,v,x)=>`<figure><img${q}src="${v}"${x}></figure>`);g=g.replace(/<figure>\s*(<figure>[\s\S]*?<\/figure>)\s*<\/figure>/gi,"$1");g=g.replace(/<pre><code class="language-(\w+)">/gi,'<pre lang="$1"><code>');g=g.replace(/\s*data-(?!draft)[a-z-]+="[^"]*"/gi,"");g=g.replace(/\s*style="[^"]*"/gi,"");return g}export const __test__={transformTables,transformZhihuHtml};
+export function transformTables(l){let e=l.replace(/<figure[^>]*>\s*(<table[\s\S]*?<\/table>)\s*<\/figure>/gi,"$1");e=e.replace(/<table[^>]*>([\s\S]*?)<\/table>/gi,(d,a)=>{const r=a.match(/<thead[^>]*>([\s\S]*?)<\/thead>/i),s=a.match(/<tbody[^>]*>([\s\S]*?)<\/tbody>/i);let c="",t="";if(r)c=r[1].replace(/<td([^>]*)>/gi,"<th$1>").replace(/<\/td>/gi,"</th>");if(s)t=s[1];else t=a.replace(/<thead[^>]*>[\s\S]*?<\/thead>/gi,"").replace(/<\/?tbody[^>]*>/gi,"");if(!r){const i=t.match(/<tr[^>]*>([\s\S]*?)<\/tr>/i);if(i){const o=i[1];if(/<th[^>]*>/i.test(o)&&!/<td[^>]*>/i.test(o)){c=i[0];t=t.replace(i[0],"")}}}return`<table data-draft-node="block" data-draft-type="table" data-size="normal" data-row-style="normal"><tbody>${c}${t}</tbody></table>`});return e}export function transformZhihuHtml(l){let e=l;e=transformTables(e);e=e.replace(/<img([^>]+)src="([^"]+)"([^>]*?)\/?>/gi,(d,a,r,s)=>`<figure><img${a}src="${r}"${s}></figure>`);e=e.replace(/<figure>\s*(<figure>[\s\S]*?<\/figure>)\s*<\/figure>/gi,"$1");e=e.replace(/<pre><code class="language-(\w+)">/gi,'<pre lang="$1"><code>');e=e.replace(/\s*data-(?!draft)[a-z-]+="[^"]*"/gi,"");e=e.replace(/\s*style="[^"]*"/gi,"");return e}export const __test__={transformTables,transformZhihuHtml};

package/clis/zhihu/article.js

@@ -1 +1 @@
-import{CliError as S,CommandExecutionError as _}from"@jackwener/opencli/errors";import{cli as z,Strategy as C}from"@jackwener/opencli/registry";import{buildResultRow as R,requireExecute as B,resolvePayload as H}from"./write-shared.js";import{publishArticle as E}from"../_shared/article/publish.js";import{zhihuImageProfile as j}from"./image-profile.js";export const zhihuProfile={home:"https://zhuanlan.zhihu.com",outputFormat:"html",preprocessConfig:{removeSpecialTags:!0,removeSpecialTagsWithParent:!0,processCodeBlocks:!0,convertSectionToDiv:!0,removeTrailingBr:!0,unwrapSingleChildContainers:!0,unwrapNestedFigures:!0,compactHtml:!0,removeEmptyLines:!0,removeEmptyDivs:!0,removeNestedEmptyContainers:!0},image:j,publish:async(F,J)=>{let Q=F.content;Q=Q.replace(/<img([^>]+?)\/?>/gi,"<figure><img$1></figure>");const L=F.params&&typeof F.params.cover==="string"?F.params.cover.trim():"";if(L&&L.indexOf("zhimg.com")===-1)return{ok:!1,stage:"cover",message:"题图必须是知乎图床（zhimg.com）地址，转存未生效："+L.slice(0,120)};const U={"Content-Type":"application/json","x-requested-with":"fetch","x-xsrftoken":J.xsrf()},G="https://zhuanlan.zhihu.com/api/articles",V=await fetch(G+"/drafts",{method:"POST",credentials:"include",headers:U,body:JSON.stringify({title:F.title})}),W=await V.text();let M=null;try{M=JSON.parse(W)}catch(q){}if(!V.ok||!M||!M.id)return{ok:!1,stage:"create",status:V.status,message:W.slice(0,300)};const K=String(M.id),X={title:F.title,content:Q,table_of_contents:!1,delta_time:30};if(L){X.titleImage=L;X.isTitleImageFullScreen=!1}const Y=await fetch(G+"/"+K+"/draft",{method:"PATCH",credentials:"include",headers:U,body:JSON.stringify(X)});if(!Y.ok){const q=await Y.text();return{ok:!1,stage:"update",status:Y.status,message:q.slice(0,300),id:K}}if(F.draftOnly)return{ok:!0,draft:!0,id:K,url:"https://zhuanlan.zhihu.com/p/"+K+"/edit"};const Z=await fetch(G+"/"+K+"/publish",{method:"PUT",credentials:"include",headers:U,body:JSON.stringify({})}),O=await Z.text();let $=null;try{$=JSON.parse(O)}catch(q){}if(!Z.ok)return{ok:!1,stage:"publish",status:Z.status,message:O.slice(0,300),id:K};return{ok:!0,draft:!1,id:K,url:$&&$.url||"https://zhuanlan.zhihu.com/p/"+K}}};z({site:"zhihu",name:"article",access:"write",description:"Publish a Zhihu article (文章/专栏). Body is Markdown by default; images (incl. local paths) and --cover are auto-rehosted to Zhihu.",domain:"zhuanlan.zhihu.com",strategy:C.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"Article title"},{name:"text",positional:!0,help:"Article body (Markdown by default; pass --html for raw HTML)"},{name:"file",help:"Article body file path (UTF-8, Markdown by default)"},{name:"html",type:"boolean",help:"Treat body as raw HTML instead of Markdown"},{name:"cover",help:"Cover image (题图): local file path or image URL; auto-rehosted to Zhihu (zhimg.com)"},{name:"draft",type:"boolean",help:"Save as draft only; do not publish"},{name:"execute",type:"boolean",help:"Actually create/publish. Without it the command refuses to write."}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(F,J)=>{if(!F)throw new _("Browser session required for zhihu article");B(J);const Q=String(J.title??"").trim();if(!Q)throw new S("INVALID_INPUT","Article title cannot be empty");const L=await H(J),A=Boolean(J.draft),U=typeof J.cover==="string"?J.cover.trim():"",G=await E(F,{title:Q,body:L,format:J.html?"html":"markdown",draftOnly:A,profile:zhihuProfile,publishParams:U?{cover:U}:null}),V=G.images.uploaded.length|0,W=G.images.failed.length|0;let M=G.draft?"Saved article draft":"Published article";if(V||W)M+=` · images: ${V} rehosted${W?`, ${W} failed`:""}`;return R(M,"article","",G.draft?"draft":"created",{created_target:"article:"+G.id,created_url:G.url})}});
+import{CliError as y,CommandExecutionError as b}from"@jackwener/opencli/errors";import{cli as v,Strategy as w}from"@jackwener/opencli/registry";import{buildResultRow as x,requireExecute as z,resolvePayload as T}from"./write-shared.js";import{publishArticle as S}from"../_shared/article/publish.js";import{zhihuImageProfile as C}from"./image-profile.js";export const zhihuProfile={home:"https://zhuanlan.zhihu.com",outputFormat:"html",preprocessConfig:{removeSpecialTags:!0,removeSpecialTagsWithParent:!0,processCodeBlocks:!0,convertSectionToDiv:!0,removeTrailingBr:!0,unwrapSingleChildContainers:!0,unwrapNestedFigures:!0,compactHtml:!0,removeEmptyLines:!0,removeEmptyDivs:!0,removeNestedEmptyContainers:!0},image:C,publish:async(e,r)=>{let s=e.content;s=s.replace(/<img([^>]+?)\/?>/gi,"<figure><img$1></figure>");const i=e.params&&typeof e.params.cover==="string"?e.params.cover.trim():"";if(i&&i.indexOf("zhimg.com")===-1)return{ok:!1,stage:"cover",message:"题图必须是知乎图床（zhimg.com）地址，转存未生效："+i.slice(0,120)};const l={"Content-Type":"application/json","x-requested-with":"fetch","x-xsrftoken":r.xsrf()},t="https://zhuanlan.zhihu.com/api/articles",n=await fetch(t+"/drafts",{method:"POST",credentials:"include",headers:l,body:JSON.stringify({title:e.title})}),c=await n.text();let o=null;try{o=JSON.parse(c)}catch(f){}if(!n.ok||!o||!o.id)return{ok:!1,stage:"create",status:n.status,message:c.slice(0,300)};const a=String(o.id),u={title:e.title,content:s,table_of_contents:!1,delta_time:30};if(i){u.titleImage=i;u.isTitleImageFullScreen=!1}const m=await fetch(t+"/"+a+"/draft",{method:"PATCH",credentials:"include",headers:l,body:JSON.stringify(u)});if(!m.ok){const f=await m.text();return{ok:!1,stage:"update",status:m.status,message:f.slice(0,300),id:a}}if(e.draftOnly)return{ok:!0,draft:!0,id:a,url:"https://zhuanlan.zhihu.com/p/"+a+"/edit"};const h=await fetch(t+"/"+a+"/publish",{method:"PUT",credentials:"include",headers:l,body:JSON.stringify({})}),g=await h.text();let d=null;try{d=JSON.parse(g)}catch(f){}if(!h.ok)return{ok:!1,stage:"publish",status:h.status,message:g.slice(0,300),id:a};return{ok:!0,draft:!1,id:a,url:d&&d.url||"https://zhuanlan.zhihu.com/p/"+a}}};v({site:"zhihu",name:"article",access:"write",description:"Publish a Zhihu article (文章/专栏). Body is Markdown by default; images (incl. local paths) and --cover are auto-rehosted to Zhihu.",domain:"zhuanlan.zhihu.com",strategy:w.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"Article title"},{name:"text",positional:!0,help:"Article body (Markdown by default; pass --html for raw HTML)"},{name:"file",help:"Article body file path (UTF-8, Markdown by default)"},{name:"html",type:"boolean",help:"Treat body as raw HTML instead of Markdown"},{name:"cover",help:"Cover image (题图): local file path or image URL; auto-rehosted to Zhihu (zhimg.com)"},{name:"draft",type:"boolean",help:"Save as draft only; do not publish"},{name:"execute",type:"boolean",help:"Actually create/publish. Without it the command refuses to write."}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(e,r)=>{if(!e)throw new b("Browser session required for zhihu article");z(r);const s=String(r.title??"").trim();if(!s)throw new y("INVALID_INPUT","Article title cannot be empty");const i=await T(r),p=Boolean(r.draft),l=typeof r.cover==="string"?r.cover.trim():"",t=await S(e,{title:s,body:i,format:r.html?"html":"markdown",draftOnly:p,profile:zhihuProfile,publishParams:l?{cover:l}:null}),n=t.images.uploaded.length|0,c=t.images.failed.length|0;let o=t.draft?"Saved article draft":"Published article";if(n||c)o+=` · images: ${n} rehosted${c?`, ${c} failed`:""}`;return x(o,"article","",t.draft?"draft":"created",{created_target:"article:"+t.id,created_url:t.url})}});

package/clis/zhihu/auth.js

@@ -1,4 +1,4 @@
-import{AuthRequiredError as F,CommandExecutionError as H}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as L}from"../_shared/site-auth.js";async function G(B){return(await B.getCookies({url:"https://www.zhihu.com"})).some((D)=>D.name==="z_c0"&&D.value)}async function J(B){await B.goto("https://www.zhihu.com/");await B.wait(2);return B.evaluate(`
+import{AuthRequiredError as r,CommandExecutionError as e}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as w}from"../_shared/site-auth.js";async function n(i){return(await i.getCookies({url:"https://www.zhihu.com"})).some((o)=>o.name==="z_c0"&&o.value)}async function h(i){await i.goto("https://www.zhihu.com/");await i.wait(2);return i.evaluate(`
     (async () => {
       try {
         const r = await fetch('https://www.zhihu.com/api/v4/me?include=url_token', { credentials: 'include' });
@@ -8,4 +8,4 @@ import{AuthRequiredError as F,CommandExecutionError as H}from"@jackwener/opencli
         return { __exception: String(e && e.message || e) };
       }
     })()
-  `)}async function K(B){if(!await G(B))throw new F("www.zhihu.com","Zhihu z_c0 cookie missing — anonymous");let z=await J(B);if(z&&(z.__httpError===401||z.__httpError===403)){await B.wait(2);z=await J(B)}if(z?.__exception)throw new H(`Zhihu whoami failed: ${z.__exception}`);if(!z||z.__httpError){const D=z?.__httpError;if(D===401||D===403)throw new F("www.zhihu.com",`Zhihu /api/v4/me returned HTTP ${D} — anonymous`);throw new H(`Zhihu identity probe failed (HTTP ${D??"unknown"})`)}if(!z.url_token)throw new F("www.zhihu.com","Zhihu /api/v4/me returned no url_token — anonymous session");return{url_token:String(z.url_token),name:String(z.name??""),uid:String(z.uid??z.id??"")}}L({site:"zhihu",domain:"www.zhihu.com",loginUrl:"https://www.zhihu.com/signin",columns:["url_token","name","uid"],quickCheck:G,verify:K,poll:async(B)=>{if(!await G(B))throw new F("www.zhihu.com","Waiting for Zhihu z_c0 cookie");return K(B)}});
+  `)}async function u(i){if(!await n(i))throw new r("www.zhihu.com","Zhihu z_c0 cookie missing — anonymous");let t=await h(i);if(t&&(t.__httpError===401||t.__httpError===403)){await i.wait(2);t=await h(i)}if(t?.__exception)throw new e(`Zhihu whoami failed: ${t.__exception}`);if(!t||t.__httpError){const o=t?.__httpError;if(o===401||o===403)throw new r("www.zhihu.com",`Zhihu /api/v4/me returned HTTP ${o} — anonymous`);throw new e(`Zhihu identity probe failed (HTTP ${o??"unknown"})`)}if(!t.url_token)throw new r("www.zhihu.com","Zhihu /api/v4/me returned no url_token — anonymous session");return{url_token:String(t.url_token),name:String(t.name??""),uid:String(t.uid??t.id??"")}}w({site:"zhihu",domain:"www.zhihu.com",loginUrl:"https://www.zhihu.com/signin",columns:["url_token","name","uid"],quickCheck:n,verify:u,poll:async(i)=>{if(!await n(i))throw new r("www.zhihu.com","Waiting for Zhihu z_c0 cookie");return u(i)}});

package/clis/zhihu/collection.js

@@ -1,7 +1,7 @@
-import{cli as y,Strategy as I}from"@jackwener/opencli/registry";import{ArgumentError as R,AuthRequiredError as L,CommandExecutionError as j,EmptyResultError as v}from"@jackwener/opencli/errors";import{log as w}from"@jackwener/opencli/logger";import{stripHtml as _}from"./text.js";function H(M,D){const z=Number(M);if(!Number.isInteger(z)||z<=0)throw new R(`zhihu collection --${D} must be a positive integer`,"Example: ppcli zhihu collection 83283292 --limit 20");return z}function C(M,D){const z=Number(M);if(!Number.isInteger(z)||z<0)throw new R(`zhihu collection --${D} must be a non-negative integer`,"Example: ppcli zhihu collection 83283292 --offset 0");return z}async function O(M,D,z,T){const V=`https://www.zhihu.com/api/v4/collections/${D}/items?offset=${z}&limit=${T}`,G=await M.evaluate(`
+import{cli as C,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentError as z,AuthRequiredError as S,CommandExecutionError as v,EmptyResultError as M}from"@jackwener/opencli/errors";import{log as E}from"@jackwener/opencli/logger";import{stripHtml as f}from"./text.js";function N(r,n){const t=Number(r);if(!Number.isInteger(t)||t<=0)throw new z(`zhihu collection --${n} must be a positive integer`,"Example: ppcli zhihu collection 83283292 --limit 20");return t}function k(r,n){const t=Number(r);if(!Number.isInteger(t)||t<0)throw new z(`zhihu collection --${n} must be a non-negative integer`,"Example: ppcli zhihu collection 83283292 --offset 0");return t}async function U(r,n,t,s){const c=`https://www.zhihu.com/api/v4/collections/${n}/items?offset=${t}&limit=${s}`,i=await r.evaluate(`
     (async () => {
-      const r = await fetch(${JSON.stringify(V)}, { credentials: 'include' });
+      const r = await fetch(${JSON.stringify(c)}, { credentials: 'include' });
       if (!r.ok) return { __httpError: r.status };
       return await r.json();
     })()
-  `);if(!G||G.__httpError){const B=G?.__httpError;if(B===401||B===403)throw new L("www.zhihu.com","Failed to fetch collection data from Zhihu. Please ensure you are logged in.");throw new j(B?`Zhihu collection request failed (HTTP ${B})`:"Zhihu collection request failed","Try again later or rerun with -v for more detail")}return G}function P(M){const D=M?.content||{};return`${D.type||""}:${D.id||D.url||JSON.stringify(D).slice(0,80)}`}function h(M,D){const z=M.content||{},T=z.type||"";if(!["answer","article","pin"].includes(T))throw new j(`Zhihu collection returned unsupported content type: ${T||"missing"}`,"Collection items require a supported content.type so the row identity, title, and URL are not silently blank.");let V="",G="",B="",Q="",W=0;if(T==="answer"){const J=z.question||{};V=J.title||"";G=_(z.content||"").substring(0,150);B=z.url||`https://www.zhihu.com/question/${J.id}/answer/${z.id}`;Q=z.author?.name||"匿名用户";W=z.voteup_count||0}else if(T==="article"){V=z.title||"";G=_(z.content||"").substring(0,150);B=z.url||`https://zhuanlan.zhihu.com/p/${z.id}`;Q=z.author?.name||"匿名用户";W=z.voteup_count||0}else if(T==="pin"){V="想法";G=_((z.content||[]).map((J)=>J.content||"").join(" ")).substring(0,150);B=z.url||`https://www.zhihu.com/pin/${z.id}`;Q=z.author?.name||"匿名用户";W=z.reaction_count||0}if(!String(V||"").trim()||!String(B||"").trim()||B.includes("undefined"))throw new j("Zhihu collection returned a malformed item without title or URL identity","Collection item rows require type, title, and URL so malformed payloads do not become blank listing rows.");return{rank:D,type:T,title:_(V).substring(0,100),author:Q,votes:W,excerpt:G,url:B}}y({site:"zhihu",name:"collection",access:"read",description:"知乎收藏夹内容列表（需要登录）",domain:"www.zhihu.com",strategy:I.COOKIE,browser:!0,args:[{name:"id",positional:!0,required:!0,help:"收藏夹 ID (数字，可从收藏夹 URL 中获取)"},{name:"offset",type:"int",default:0,help:"起始偏移量（用于分页）"},{name:"limit",type:"int",default:20,help:"每页数量（最大 20）"}],columns:["rank","type","title","author","votes","excerpt","url"],func:async(M,D)=>{const{id:z,offset:T=0,limit:V=20}=D,G=String(z);if(!/^\d+$/.test(G))throw new R("Collection ID must be numeric","Example: ppcli zhihu collection 83283292");const B=C(T,"offset"),Q=H(V,"limit"),W=Math.min(Q,20);await M.goto("https://www.zhihu.com");const J=[],A=new Set;let X=0,Y=B;const q=Math.ceil(Q/W)+2;for(let $=0;$<q&&J.length<Q;$+=1){const S=Math.min(W,Q-J.length),K=await O(M,G,Y,S),U=Array.isArray(K.data)?K.data:[],b=K.paging||{};X=Number(b.totals||X||0);for(const F of U){const Z=P(F);if(!A.has(Z)){A.add(Z);J.push(F)}if(J.length>=Q)break}if(U.length===0||b.is_end||J.length>=Q)break;if(typeof b.next==="string")try{const F=new URL(b.next),Z=Number(F.searchParams.get("offset"));if(Number.isInteger(Z)&&Z>Y){Y=Z;continue}}catch{}if(U.length<S)break;const N=Y+U.length;if(N<=Y)break;Y=N;if(X&&Y>=X)break}const k=Math.ceil(X/W),E=Math.floor(B/W)+1;if(X>0){w.info(`收藏夹共有 ${X} 条内容，共 ${k} 页`);w.info(`当前第 ${E} 页，显示第 ${B+1} - ${Math.min(B+J.length,X)} 条`)}if(J.length===0)throw new v("zhihu collection",`No items found for collection ${G}. The collection may be empty, private, or the offset may be out of range.`);return J.slice(0,Q).map(($,S)=>h($,B+S+1))}});export const __test__={stripHtml:_,validatePositiveInt:H,validateNonNegativeInt:C,itemKey:P,mapCollectionItem:h};
+  `);if(!i||i.__httpError){const e=i?.__httpError;if(e===401||e===403)throw new S("www.zhihu.com","Failed to fetch collection data from Zhihu. Please ensure you are logged in.");throw new v(e?`Zhihu collection request failed (HTTP ${e})`:"Zhihu collection request failed","Try again later or rerun with -v for more detail")}return i}function I(r){const n=r?.content||{};return`${n.type||""}:${n.id||n.url||JSON.stringify(n).slice(0,80)}`}function q(r,n){const t=r.content||{},s=t.type||"";if(!["answer","article","pin"].includes(s))throw new v(`Zhihu collection returned unsupported content type: ${s||"missing"}`,"Collection items require a supported content.type so the row identity, title, and URL are not silently blank.");let c="",i="",e="",l="",a=0;if(s==="answer"){const o=t.question||{};c=o.title||"";i=f(t.content||"").substring(0,150);e=t.url||`https://www.zhihu.com/question/${o.id}/answer/${t.id}`;l=t.author?.name||"匿名用户";a=t.voteup_count||0}else if(s==="article"){c=t.title||"";i=f(t.content||"").substring(0,150);e=t.url||`https://zhuanlan.zhihu.com/p/${t.id}`;l=t.author?.name||"匿名用户";a=t.voteup_count||0}else if(s==="pin"){c="想法";i=f((t.content||[]).map((o)=>o.content||"").join(" ")).substring(0,150);e=t.url||`https://www.zhihu.com/pin/${t.id}`;l=t.author?.name||"匿名用户";a=t.reaction_count||0}if(!String(c||"").trim()||!String(e||"").trim()||e.includes("undefined"))throw new v("Zhihu collection returned a malformed item without title or URL identity","Collection item rows require type, title, and URL so malformed payloads do not become blank listing rows.");return{rank:n,type:s,title:f(c).substring(0,100),author:l,votes:a,excerpt:i,url:e}}C({site:"zhihu",name:"collection",access:"read",description:"知乎收藏夹内容列表（需要登录）",domain:"www.zhihu.com",strategy:R.COOKIE,browser:!0,args:[{name:"id",positional:!0,required:!0,help:"收藏夹 ID (数字，可从收藏夹 URL 中获取)"},{name:"offset",type:"int",default:0,help:"起始偏移量（用于分页）"},{name:"limit",type:"int",default:20,help:"每页数量（最大 20）"}],columns:["rank","type","title","author","votes","excerpt","url"],func:async(r,n)=>{const{id:t,offset:s=0,limit:c=20}=n,i=String(t);if(!/^\d+$/.test(i))throw new z("Collection ID must be numeric","Example: ppcli zhihu collection 83283292");const e=k(s,"offset"),l=N(c,"limit"),a=Math.min(l,20);await r.goto("https://www.zhihu.com");const o=[],_=new Set;let u=0,h=e;const L=Math.ceil(l/a)+2;for(let p=0;p<L&&o.length<l;p+=1){const d=Math.min(a,l-o.length),b=await U(r,i,h,d),w=Array.isArray(b.data)?b.data:[],g=b.paging||{};u=Number(g.totals||u||0);for(const y of w){const m=I(y);if(!_.has(m)){_.add(m);o.push(y)}if(o.length>=l)break}if(w.length===0||g.is_end||o.length>=l)break;if(typeof g.next==="string")try{const y=new URL(g.next),m=Number(y.searchParams.get("offset"));if(Number.isInteger(m)&&m>h){h=m;continue}}catch{}if(w.length<d)break;const x=h+w.length;if(x<=h)break;h=x;if(u&&h>=u)break}const O=Math.ceil(u/a),P=Math.floor(e/a)+1;if(u>0){E.info(`收藏夹共有 ${u} 条内容，共 ${O} 页`);E.info(`当前第 ${P} 页，显示第 ${e+1} - ${Math.min(e+o.length,u)} 条`)}if(o.length===0)throw new M("zhihu collection",`No items found for collection ${i}. The collection may be empty, private, or the offset may be out of range.`);return o.slice(0,l).map((p,d)=>q(p,e+d+1))}});export const __test__={stripHtml:f,validatePositiveInt:N,validateNonNegativeInt:k,itemKey:I,mapCollectionItem:q};

package/clis/zhihu/collections.js

@@ -1,7 +1,7 @@
-import{cli as P,Strategy as I}from"@jackwener/opencli/registry";import{ArgumentError as h,AuthRequiredError as w,CommandExecutionError as F,EmptyResultError as O}from"@jackwener/opencli/errors";import{log as v}from"@jackwener/opencli/logger";function J(B,V){const D=Number(B);if(!Number.isInteger(D)||D<=0)throw new h(`zhihu collections --${V} must be a positive integer`,"Example: ppcli zhihu collections --limit 20");return D}async function K(B,V,D){const z=await B.evaluate(`
+import{cli as x,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentError as P,AuthRequiredError as Z,CommandExecutionError as y,EmptyResultError as I}from"@jackwener/opencli/errors";import{log as O}from"@jackwener/opencli/logger";function k(e,c){const i=Number(e);if(!Number.isInteger(i)||i<=0)throw new P(`zhihu collections --${c} must be a positive integer`,"Example: ppcli zhihu collections --limit 20");return i}async function b(e,c,i){const t=await e.evaluate(`
     (async () => {
-      const r = await fetch(${JSON.stringify(V)}, { credentials: 'include' });
+      const r = await fetch(${JSON.stringify(c)}, { credentials: 'include' });
       if (!r.ok) return { __httpError: r.status };
       return await r.json();
     })()
-  `);if(!z||z.__httpError){const W=z?.__httpError;if(W===401||W===403)throw new w("www.zhihu.com",`${D} from Zhihu failed. Please ensure you are logged in.`);throw new F(W?`${D} from Zhihu failed (HTTP ${W})`:`${D} from Zhihu failed`,"Try again later or rerun with -v for more detail")}return z}function R(B){return String(B?.id||B?.url||B?.title||"")}P({site:"zhihu",name:"collections",access:"read",description:"知乎收藏夹列表（需要登录）",domain:"www.zhihu.com",strategy:I.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:"每页数量（最大 20）"}],columns:["rank","title","item_count","description","collection_id"],func:async(B,V)=>{const{limit:D=20}=V,z=J(D,"limit");await B.goto("https://www.zhihu.com");const U=(await K(B,"https://www.zhihu.com/api/v4/me?include=url_token","Zhihu user info request")).url_token;if(!U)throw new F("Failed to get user url_token from Zhihu","Please ensure you are logged in.");const H=[],_=new Set;let Q=0,M=0;const A=Math.min(z,20),T=Math.ceil(z/A)+2;for(let G=0;G<T&&H.length<z;G+=1){const X=Math.min(A,z-H.length),j=`https://www.zhihu.com/api/v4/people/${U}/collections?include=data%5B*%5D.updated_time&offset=${M}&limit=${X}`,S=await K(B,j,"Zhihu favorite collections request"),Y=Array.isArray(S.data)?S.data:[],Z=S.paging||{};Q=Number(Z.totals||Q||0);for(const $ of Y){const N=R($);if(N&&!_.has(N)){_.add(N);H.push($)}if(H.length>=z)break}if(Y.length===0||Z.is_end||H.length>=z)break;if(typeof Z.next==="string")try{const $=new URL(Z.next),N=Number($.searchParams.get("offset"));if(Number.isInteger(N)&&N>M){M=N;continue}}catch{}if(Y.length<X)break;const C=M+Y.length;if(C<=M)break;M=C;if(Q&&M>=Q)break}if(Q>0)v.info(`共有 ${Q} 个收藏夹`);if(H.length===0)throw new O("zhihu collections","No favorite collections were returned for the logged-in user.");return H.slice(0,z).map((G,X)=>({rank:X+1,title:G.title||"未命名",item_count:G.item_count??G.answer_count??0,description:G.description||"",collection_id:String(G.id||"")}))}});export const __test__={validatePositiveInt:J,collectionKey:R};
+  `);if(!t||t.__httpError){const l=t?.__httpError;if(l===401||l===403)throw new Z("www.zhihu.com",`${i} from Zhihu failed. Please ensure you are logged in.`);throw new y(l?`${i} from Zhihu failed (HTTP ${l})`:`${i} from Zhihu failed`,"Try again later or rerun with -v for more detail")}return t}function E(e){return String(e?.id||e?.url||e?.title||"")}x({site:"zhihu",name:"collections",access:"read",description:"知乎收藏夹列表（需要登录）",domain:"www.zhihu.com",strategy:N.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:"每页数量（最大 20）"}],columns:["rank","title","item_count","description","collection_id"],func:async(e,c)=>{const{limit:i=20}=c,t=k(i,"limit");await e.goto("https://www.zhihu.com");const w=(await b(e,"https://www.zhihu.com/api/v4/me?include=url_token","Zhihu user info request")).url_token;if(!w)throw new y("Failed to get user url_token from Zhihu","Please ensure you are logged in.");const o=[],g=new Set;let s=0,r=0;const p=Math.min(t,20),v=Math.ceil(t/p)+2;for(let n=0;n<v&&o.length<t;n+=1){const u=Math.min(p,t-o.length),z=`https://www.zhihu.com/api/v4/people/${w}/collections?include=data%5B*%5D.updated_time&offset=${r}&limit=${u}`,d=await b(e,z,"Zhihu favorite collections request"),h=Array.isArray(d.data)?d.data:[],f=d.paging||{};s=Number(f.totals||s||0);for(const m of h){const a=E(m);if(a&&!g.has(a)){g.add(a);o.push(m)}if(o.length>=t)break}if(h.length===0||f.is_end||o.length>=t)break;if(typeof f.next==="string")try{const m=new URL(f.next),a=Number(m.searchParams.get("offset"));if(Number.isInteger(a)&&a>r){r=a;continue}}catch{}if(h.length<u)break;const _=r+h.length;if(_<=r)break;r=_;if(s&&r>=s)break}if(s>0)O.info(`共有 ${s} 个收藏夹`);if(o.length===0)throw new I("zhihu collections","No favorite collections were returned for the logged-in user.");return o.slice(0,t).map((n,u)=>({rank:u+1,title:n.title||"未命名",item_count:n.item_count??n.answer_count??0,description:n.description||"",collection_id:String(n.id||"")}))}});export const __test__={validatePositiveInt:k,collectionKey:E};

package/clis/zhihu/download.js

@@ -1,4 +1,4 @@
-import{cli as q,Strategy as v}from"@jackwener/opencli/registry";import{downloadArticle as x}from"@jackwener/opencli/download/article-download";q({site:"zhihu",name:"download",access:"read",description:"导出知乎文章为 Markdown 格式",domain:"zhuanlan.zhihu.com",strategy:v.COOKIE,args:[{name:"url",required:!0,help:"Article URL (zhuanlan.zhihu.com/p/xxx)"},{name:"output",default:"./zhihu-articles",help:"Output directory"},{name:"download-images",type:"boolean",default:!1,help:"Download images locally"}],columns:["title","author","publish_time","status","size"],func:async(f,h)=>{const m=h.url;await f.goto(m);await f.wait(3);const b=await f.evaluate(`
+import{cli as o,Strategy as n}from"@jackwener/opencli/registry";import{downloadArticle as r}from"@jackwener/opencli/download/article-download";o({site:"zhihu",name:"download",access:"read",description:"导出知乎文章为 Markdown 格式",domain:"zhuanlan.zhihu.com",strategy:n.COOKIE,args:[{name:"url",required:!0,help:"Article URL (zhuanlan.zhihu.com/p/xxx)"},{name:"output",default:"./zhihu-articles",help:"Output directory"},{name:"download-images",type:"boolean",default:!1,help:"Download images locally"}],columns:["title","author","publish_time","status","size"],func:async(e,l)=>{const i=l.url;await e.goto(i);await e.wait(3);const t=await e.evaluate(`
       (() => {
         const result = {
           title: '',
@@ -36,4 +36,4 @@ import{cli as q,Strategy as v}from"@jackwener/opencli/registry";import{downloadA
 
         return result;
       })()
-    `);return x({title:b?.title||"",author:b?.author,publishTime:b?.publishTime,sourceUrl:m,contentHtml:b?.contentHtml||"",imageUrls:b?.imageUrls},{output:h.output,downloadImages:h["download-images"],imageHeaders:{Referer:"https://zhuanlan.zhihu.com/"}})}});
+    `);return r({title:t?.title||"",author:t?.author,publishTime:t?.publishTime,sourceUrl:i,contentHtml:t?.contentHtml||"",imageUrls:t?.imageUrls},{output:l.output,downloadImages:l["download-images"],imageHeaders:{Referer:"https://zhuanlan.zhihu.com/"}})}});

package/clis/zhihu/image-profile.js

@@ -1,7 +1,7 @@
-export const zhihuImageProfile={skip:["zhimg.com"],uploadFn:async(J,L)=>{if(J.indexOf("data:")!==0){const q=await fetch("https://zhuanlan.zhihu.com/api/uploaded_images",{method:"POST",credentials:"include",headers:{"Content-Type":"application/x-www-form-urlencoded","x-requested-with":"fetch","x-xsrftoken":L.xsrf()},body:new URLSearchParams({url:J,source:"article"})}),Y=await q.text();let v=null;try{v=JSON.parse(Y)}catch($){}if(!q.ok||!v||!v.src)throw Error("URL 转存失败: HTTP "+q.status+" "+Y.slice(0,150));return{url:v.src}}const I=L.dataUriToBlob(J),h=await I.arrayBuffer(),m=L.md5(h),N=await fetch("https://api.zhihu.com/images",{method:"POST",credentials:"include",headers:{"Content-Type":"application/json","x-requested-with":"fetch"},body:JSON.stringify({image_hash:m,source:"article"})}),Q=await N.text();let G=null;try{G=JSON.parse(Q)}catch(q){}if(!N.ok||!G||!G.upload_file)throw Error("获取上传凭证失败: HTTP "+N.status+" "+Q.slice(0,150));const E=G.upload_file;if(E.state===1){for(let q=0;q<10;q++){const v=await(await fetch("https://api.zhihu.com/images/"+E.image_id,{credentials:"include",headers:{"x-requested-with":"fetch"}})).json();if(v&&(v.status==="completed"||v.original_hash))return{url:"https://pic4.zhimg.com/"+v.original_hash};await new Promise(($)=>setTimeout($,1000))}throw Error("图片处理超时（image_id="+E.image_id+"）")}const w=G.upload_token;if(!w||!w.access_id||!w.access_key||!w.access_token)throw Error("上传凭证响应无效: "+Q.slice(0,150));const Z=I.type||"application/octet-stream",U=new Date().toUTCString(),_={"x-oss-date":U,"x-oss-security-token":w.access_token,"x-oss-user-agent":"aliyun-sdk-js/6.8.0"},z=Object.keys(_).sort().map((q)=>q+":"+_[q]).join(`
-`),M=`PUT
+export const zhihuImageProfile={skip:["zhimg.com"],uploadFn:async(n,c)=>{if(n.indexOf("data:")!==0){const e=await fetch("https://zhuanlan.zhihu.com/api/uploaded_images",{method:"POST",credentials:"include",headers:{"Content-Type":"application/x-www-form-urlencoded","x-requested-with":"fetch","x-xsrftoken":c.xsrf()},body:new URLSearchParams({url:n,source:"article"})}),p=await e.text();let t=null;try{t=JSON.parse(p)}catch(y){}if(!e.ok||!t||!t.src)throw Error("URL 转存失败: HTTP "+e.status+" "+p.slice(0,150));return{url:t.src}}const i=c.dataUriToBlob(n),f=await i.arrayBuffer(),g=c.md5(f),r=await fetch("https://api.zhihu.com/images",{method:"POST",credentials:"include",headers:{"Content-Type":"application/json","x-requested-with":"fetch"},body:JSON.stringify({image_hash:g,source:"article"})}),h=await r.text();let o=null;try{o=JSON.parse(h)}catch(e){}if(!r.ok||!o||!o.upload_file)throw Error("获取上传凭证失败: HTTP "+r.status+" "+h.slice(0,150));const a=o.upload_file;if(a.state===1){for(let e=0;e<10;e++){const t=await(await fetch("https://api.zhihu.com/images/"+a.image_id,{credentials:"include",headers:{"x-requested-with":"fetch"}})).json();if(t&&(t.status==="completed"||t.original_hash))return{url:"https://pic4.zhimg.com/"+t.original_hash};await new Promise((y)=>setTimeout(y,1000))}throw Error("图片处理超时（image_id="+a.image_id+"）")}const s=o.upload_token;if(!s||!s.access_id||!s.access_key||!s.access_token)throw Error("上传凭证响应无效: "+h.slice(0,150));const m=i.type||"application/octet-stream",d=new Date().toUTCString(),w={"x-oss-date":d,"x-oss-security-token":s.access_token,"x-oss-user-agent":"aliyun-sdk-js/6.8.0"},k=Object.keys(w).sort().map((e)=>e+":"+w[e]).join(`
+`),x=`PUT
 
-`+Z+`
-`+U+`
-`+z+`
-/zhihu-pics/`+E.object_key,O=new TextEncoder().encode(w.access_key),W=await crypto.subtle.importKey("raw",O,{name:"HMAC",hash:"SHA-1"},!1,["sign"]),f=await crypto.subtle.sign("HMAC",W,new TextEncoder().encode(M)),A=btoa(String.fromCharCode.apply(null,Array.from(new Uint8Array(f)))),V=await fetch("https://zhihu-pics-upload.zhimg.com/"+E.object_key,{method:"PUT",headers:{"Content-Type":Z,Authorization:"OSS "+w.access_id+":"+A,"x-oss-date":U,"x-oss-security-token":w.access_token,"x-oss-user-agent":"aliyun-sdk-js/6.8.0"},body:I});if(!V.ok){const q=await V.text();throw Error("OSS 上传失败: HTTP "+V.status+" "+q.slice(0,150))}let X=E.object_key;if(I.type==="image/gif")X=X+".gif";return{url:"https://pic4.zhimg.com/"+X}}};
+`+m+`
+`+d+`
+`+k+`
+/zhihu-pics/`+a.object_key,T=new TextEncoder().encode(s.access_key),_=await crypto.subtle.importKey("raw",T,{name:"HMAC",hash:"SHA-1"},!1,["sign"]),S=await crypto.subtle.sign("HMAC",_,new TextEncoder().encode(x)),b=btoa(String.fromCharCode.apply(null,Array.from(new Uint8Array(S)))),l=await fetch("https://zhihu-pics-upload.zhimg.com/"+a.object_key,{method:"PUT",headers:{"Content-Type":m,Authorization:"OSS "+s.access_id+":"+b,"x-oss-date":d,"x-oss-security-token":s.access_token,"x-oss-user-agent":"aliyun-sdk-js/6.8.0"},body:i});if(!l.ok){const e=await l.text();throw Error("OSS 上传失败: HTTP "+l.status+" "+e.slice(0,150))}let u=a.object_key;if(i.type==="image/gif")u=u+".gif";return{url:"https://pic4.zhimg.com/"+u}}};

package/clis/zhihu/paginate.js

@@ -1,11 +1,11 @@
-import{ArgumentError as V,AuthRequiredError as F,CommandExecutionError as K,EmptyResultError as W}from"@jackwener/opencli/errors";export const MAX_LIMIT=1000;export function validateLimit(G,B=20){const J=G??B;let D;if(typeof J==="number")D=J;else{const H=String(J).trim();if(!/^\d+$/.test(H))throw new V(`--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");D=Number(H)}if(!Number.isInteger(D)||D<=0||D>MAX_LIMIT)throw new V(`--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 D}export function unwrapEvaluateResult(G){if(G&&typeof G==="object"&&"data"in G&&"session"in G)return G.data;return G}export function requireZhihuListPayload(G,B,J){const D=unwrapEvaluateResult(G);if(!D||typeof D!=="object"||Array.isArray(D))throw new K(`Zhihu ${B} returned malformed payload`,`URL: ${J}`);if(D.__httpError){const H=D.__httpError;if(H===401||H===403)throw new F("www.zhihu.com",`Failed to fetch Zhihu ${B}`);if(H===404)throw new W(`zhihu ${B}`,"Check the target identifier");throw new K(`Zhihu ${B} request failed${H?` (HTTP ${H})`:""}`,"Try again later or rerun with -v")}if(D.__fetchError)throw new K(`Zhihu ${B} request failed`,String(D.__fetchError));if(!Array.isArray(D.data))throw new K(`Zhihu ${B} returned malformed data list`,`URL: ${J}`);if(!D.paging||typeof D.paging!=="object")throw new K(`Zhihu ${B} returned malformed paging data`,`URL: ${J}`);return D}function Y(G){if(typeof G!=="string"||!G)return"";try{const B=new URL(G);if(B.protocol!=="https:"&&B.protocol!=="http:")return"";B.protocol="https:";if(B.hostname==="api.zhihu.com"&&B.pathname.startsWith("/members/"))return`https://www.zhihu.com/api/v4${B.pathname}${B.search}`;if(B.hostname==="www.zhihu.com"&&B.pathname.startsWith("/api/v4/members/"))return B.toString()}catch{return""}return""}function $(G,B){try{return new URL(G).pathname===new URL(B).pathname}catch{return!1}}export async function fetchZhihuList(G,B,J,D){const H=[],Q=new Set;let N=B;while(N&&H.length<J&&!Q.has(N)){Q.add(N);const S=requireZhihuListPayload(await G.evaluate(`
+import{ArgumentError as c,AuthRequiredError as d,CommandExecutionError as o,EmptyResultError as f}from"@jackwener/opencli/errors";export const MAX_LIMIT=1000;export function validateLimit(e,t=20){const n=e??t;let r;if(typeof n==="number")r=n;else{const i=String(n).trim();if(!/^\d+$/.test(i))throw new c(`--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");r=Number(i)}if(!Number.isInteger(r)||r<=0||r>MAX_LIMIT)throw new c(`--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 r}export function unwrapEvaluateResult(e){if(e&&typeof e==="object"&&"data"in e&&"session"in e)return e.data;return e}export function requireZhihuListPayload(e,t,n){const r=unwrapEvaluateResult(e);if(!r||typeof r!=="object"||Array.isArray(r))throw new o(`Zhihu ${t} returned malformed payload`,`URL: ${n}`);if(r.__httpError){const i=r.__httpError;if(i===401||i===403)throw new d("www.zhihu.com",`Failed to fetch Zhihu ${t}`);if(i===404)throw new f(`zhihu ${t}`,"Check the target identifier");throw new o(`Zhihu ${t} request failed${i?` (HTTP ${i})`:""}`,"Try again later or rerun with -v")}if(r.__fetchError)throw new o(`Zhihu ${t} request failed`,String(r.__fetchError));if(!Array.isArray(r.data))throw new o(`Zhihu ${t} returned malformed data list`,`URL: ${n}`);if(!r.paging||typeof r.paging!=="object")throw new o(`Zhihu ${t} returned malformed paging data`,`URL: ${n}`);return r}function m(e){if(typeof e!=="string"||!e)return"";try{const t=new URL(e);if(t.protocol!=="https:"&&t.protocol!=="http:")return"";t.protocol="https:";if(t.hostname==="api.zhihu.com"&&t.pathname.startsWith("/members/"))return`https://www.zhihu.com/api/v4${t.pathname}${t.search}`;if(t.hostname==="www.zhihu.com"&&t.pathname.startsWith("/api/v4/members/"))return t.toString()}catch{return""}return""}function w(e,t){try{return new URL(e).pathname===new URL(t).pathname}catch{return!1}}export async function fetchZhihuList(e,t,n,r){const i=[],s=new Set;let h=t;while(h&&i.length<n&&!s.has(h)){s.add(h);const u=requireZhihuListPayload(await e.evaluate(`
       (async () => {
         try {
-          const r = await fetch(${JSON.stringify(N)}, { credentials: 'include' });
+          const r = await fetch(${JSON.stringify(h)}, { credentials: 'include' });
           if (!r.ok) return { __httpError: r.status };
           return await r.json();
         } catch (err) {
           return { __fetchError: err?.message || String(err) };
         }
       })()
-    `),D,N);for(const j of S.data){H.push(j);if(H.length>=J)break}if(H.length>=J)break;if(S.paging?.is_end)break;const O=Y(S.paging?.next);if(!O||!$(O,B))throw new K(`Zhihu ${D} pagination returned malformed next URL`);if(Q.has(O))throw new K(`Zhihu ${D} pagination returned a repeated next URL`);N=O}if(H.length===0)throw new W(`zhihu ${D}`,"No rows were returned for the requested Zhihu user.");return H}export const __test__={normalizeZhihuApiUrl:Y,sameZhihuApiPath:$};
+    `),r,h);for(const p of u.data){i.push(p);if(i.length>=n)break}if(i.length>=n)break;if(u.paging?.is_end)break;const a=m(u.paging?.next);if(!a||!w(a,t))throw new o(`Zhihu ${r} pagination returned malformed next URL`);if(s.has(a))throw new o(`Zhihu ${r} pagination returned a repeated next URL`);h=a}if(i.length===0)throw new f(`zhihu ${r}`,"No rows were returned for the requested Zhihu user.");return i}export const __test__={normalizeZhihuApiUrl:m,sameZhihuApiPath:w};

package/clis/zhihu/pin.js

@@ -1,6 +1,6 @@
-import{CliError as J,CommandExecutionError as K}from"@jackwener/opencli/errors";import{cli as N,Strategy as O}from"@jackwener/opencli/registry";import{buildResultRow as Q,requireExecute as V,resolveCurrentUserIdentity as W,resolvePayload as X}from"./write-shared.js";N({site:"zhihu",name:"pin",access:"write",description:"Publish a Zhihu pin (想法/short post)",domain:"www.zhihu.com",strategy:O.COOKIE,browser:!0,args:[{name:"text",positional:!0,help:"Pin text content"},{name:"file",help:"Pin text file path (UTF-8)"},{name:"execute",type:"boolean",help:"Actually publish the pin. Without it the command refuses to write."}],columns:["status","outcome","message","target_type","target","created_target","created_url","author_identity"],func:async(f,A)=>{if(!f)throw new K("Browser session required for zhihu pin");V(A);const D=await X(A);await f.goto("https://www.zhihu.com");await f.wait(3);let B="";try{B=await W(f)}catch{}const F=D.split(`
-`).map((G)=>`<p>${Y(G)}</p>`).join(""),z=await f.evaluate(`(async () => {
-            var html = ${JSON.stringify(F)};
+import{CliError as n,CommandExecutionError as u}from"@jackwener/opencli/errors";import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{buildResultRow as l,requireExecute as p,resolveCurrentUserIdentity as h,resolvePayload as m}from"./write-shared.js";c({site:"zhihu",name:"pin",access:"write",description:"Publish a Zhihu pin (想法/short post)",domain:"www.zhihu.com",strategy:d.COOKIE,browser:!0,args:[{name:"text",positional:!0,help:"Pin text content"},{name:"file",help:"Pin text file path (UTF-8)"},{name:"execute",type:"boolean",help:"Actually publish the pin. Without it the command refuses to write."}],columns:["status","outcome","message","target_type","target","created_target","created_url","author_identity"],func:async(t,a)=>{if(!t)throw new u("Browser session required for zhihu pin");p(a);const i=await m(a);await t.goto("https://www.zhihu.com");await t.wait(3);let r="";try{r=await h(t)}catch{}const s=i.split(`
+`).map((o)=>`<p>${w(o)}</p>`).join(""),e=await t.evaluate(`(async () => {
+            var html = ${JSON.stringify(s)};
             var xsrf = (document.cookie.match(/_xsrf=([^;]+)/) || [])[1] || '';
             var body = new URLSearchParams();
             body.set('content', JSON.stringify([{ type: 'text', content: html }]));
@@ -21,4 +21,4 @@ import{CliError as J,CommandExecutionError as K}from"@jackwener/opencli/errors";
             if (!resp.ok) return { ok: false, status: resp.status, message: (data && data.error && data.error.message) || text.slice(0, 300) };
             if (!data || !data.id) return { ok: false, status: resp.status, message: 'Pin API response did not include a created pin id: ' + text.slice(0, 300) };
             return { ok: true, id: String(data.id), url: data.url || ('https://www.zhihu.com/pin/' + data.id) };
-        })()`);if(!z?.ok)throw new J("COMMAND_EXEC",z?.message||"Failed to publish pin");return Q("Published pin","pin","","created",{created_target:"pin:"+z.id,created_url:z.url,author_identity:B})}});function Y(f){return String(f).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}
+        })()`);if(!e?.ok)throw new n("COMMAND_EXEC",e?.message||"Failed to publish pin");return l("Published pin","pin","","created",{created_target:"pin:"+e.id,created_url:e.url,author_identity:r})}});function w(t){return String(t).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}

package/clis/zhihu/question.js

@@ -1,7 +1,7 @@
-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: ppcli 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: ppcli 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(`
+import{cli as g,Strategy as I}from"@jackwener/opencli/registry";import{AuthRequiredError as _,CliError as h}from"@jackwener/opencli/errors";import{stripHtml as q}from"./text.js";function y(t){if(typeof t!=="string")return"";try{const e=new URL(t);if(e.hostname!=="www.zhihu.com"&&e.hostname!=="zhihu.com")return"";return e.pathname.match(/^\/question\/\d+\/answer\/(\d+)\/?$/)?.[1]||e.pathname.match(/^\/api\/v4\/answers\/(\d+)\/?$/)?.[1]||e.pathname.match(/^\/answer\/(\d+)\/?$/)?.[1]||""}catch{return""}}function f(t){const e=y(t.url);if(e)return e;if(typeof t.id==="string"&&/^\d+$/.test(t.id))return t.id;if(typeof t.id==="number"&&Number.isSafeInteger(t.id)&&t.id>0)return String(t.id);return""}function E(t){const e=f(t);if(e)return`id:${e}`;return`fallback:${t.author?.name||"anonymous"}:${t.content||""}`}const m=1000;g({site:"zhihu",name:"question",access:"read",description:"知乎问题详情和回答",domain:"www.zhihu.com",strategy:I.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(t,e)=>{const{id:l,limit:p=5}=e,i=String(l);if(!/^\d+$/.test(i))throw new h("INVALID_INPUT","Question ID must be numeric","Example: ppcli zhihu question 123456789");const s=Number(p);if(!Number.isInteger(s)||s<=0||s>m)throw new h("INVALID_INPUT",`Limit must be a positive integer no greater than ${m}`,"Use a normal-sized limit to avoid slow requests or Zhihu risk controls");const u=String(e.sort||"default");if(u!=="default"&&u!=="created")throw new h("INVALID_INPUT","Sort must be one of: default, created","Example: ppcli zhihu question 123456789 --sort created");await t.goto(u==="created"?`https://www.zhihu.com/question/${i}/answers/updated`:`https://www.zhihu.com/question/${i}`);let a=`https://www.zhihu.com/api/v4/questions/${i}/answers?limit=${20}&offset=0&sort_by=${u}&include=data[*].content,url,voteup_count,comment_count,author`;const c=[],d=new Set,w=new Set;while(a&&c.length<s&&!w.has(a)){w.add(a);const r=await t.evaluate(`
       (async () => {
-        const r = await fetch(${JSON.stringify(P)}, { credentials: 'include' });
+        const r = await fetch(${JSON.stringify(a)}, { credentials: 'include' });
         if (!r.ok) return { __httpError: r.status };
         return await r.json();
       })()
-    `);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)}})}});
+    `);if(!r||r.__httpError){const n=r?.__httpError;if(n===401||n===403)throw new _("www.zhihu.com","Failed to fetch question data from Zhihu");throw new h("FETCH_ERROR",n?`Zhihu question answers request failed (HTTP ${n})`:"Zhihu question answers request failed","Try again later or rerun with -v for more detail")}for(const n of r.data||[]){const o=E(n);if(d.has(o))continue;d.add(o);c.push(n);if(c.length>=s)break}if(r.paging?.is_end)break;a=typeof r.paging?.next==="string"?r.paging.next:""}return c.map((r,n)=>{const o=f(r);return{rank:n+1,id:o,author:r.author?.name||"anonymous",votes:r.voteup_count||0,url:o?`https://www.zhihu.com/question/${i}/answer/${o}`:"",content:q(r.content||"").substring(0,200)}})}});

package/clis/zhihu/recommend.js

@@ -1,7 +1,7 @@
-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(`
+import{cli as w,Strategy as p}from"@jackwener/opencli/registry";import{AuthRequiredError as f,CliError as m}from"@jackwener/opencli/errors";function g(s){const t=s.target||{},e=t.id==null?"":String(t.id);if(t.type==="answer"){const n=t.question?.id==null?"":String(t.question.id);return n&&e?`https://www.zhihu.com/question/${n}/answer/${e}`:""}if(t.type==="article")return e?`https://zhuanlan.zhihu.com/p/${e}`:"";if(t.type==="question")return e?`https://www.zhihu.com/question/${e}`:"";return""}function y(s){const t=s.target||{};if(t.type==="answer")return t.question?.title||"";return t.title||t.question?.title||""}const d=1000;w({site:"zhihu",name:"recommend",access:"read",description:"知乎首页推荐",domain:"www.zhihu.com",strategy:p.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(s,t)=>{const e=Number(t.limit??20);if(!Number.isInteger(e)||e<=0||e>d)throw new m("INVALID_INPUT",`Limit must be a positive integer no greater than ${d}`,"Use a normal-sized limit to avoid slow requests or Zhihu risk controls");await s.goto("https://www.zhihu.com");let n="https://www.zhihu.com/api/v3/feed/topstory/recommend?limit=10&desktop=true";const u=[],l=new Set,h=new Set;while(n&&u.length<e&&!h.has(n)){h.add(n);const i=await s.evaluate(`
       (async () => {
-        const r = await fetch(${JSON.stringify(G)}, { credentials: 'include' });
+        const r = await fetch(${JSON.stringify(n)}, { credentials: 'include' });
         if (!r.ok) return { __httpError: r.status };
         return await r.json();
       })()
-    `);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)}})}});
+    `);if(!i||i.__httpError){const r=i?.__httpError;if(r===401||r===403)throw new f("www.zhihu.com","Failed to fetch Zhihu recommendations");throw new m("FETCH_ERROR",r?`Zhihu recommendations request failed (HTTP ${r})`:"Zhihu recommendations request failed","Try again later or rerun with -v for more detail")}for(const r of i.data||[]){const o=r.target||{},c=o.id;let a=null;if(c!=null)a=`${o.type??""}:${c}`;else if(r.id!=null)a=`__feed:${r.id}`;if(a!=null){if(l.has(a))continue;l.add(a)}u.push(r);if(u.length>=e)break}if(i.paging?.is_end)break;n=typeof i.paging?.next==="string"?i.paging.next:""}return u.map((i,r)=>{const o=i.target||{};return{rank:r+1,type:o.type||i.type||"",title:y(i),author:o.author?.name||"",votes:o.voteup_count??o.reaction?.statistics?.like_count??0,url:g(i)}})}});

package/clis/zhihu/search.js

@@ -1,11 +1,11 @@
-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: ppcli 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: ppcli 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`
+import{cli as j,Strategy as U}from"@jackwener/opencli/registry";import{ArgumentError as p,AuthRequiredError as k,CommandExecutionError as a,EmptyResultError as I}from"@jackwener/opencli/errors";import{stripHtml as g}from"./text.js";function q(e){const t=e.object||{};if(t.id!=null)return`${t.type||""}:${t.id}`;return null}function _(e){const t=e.id==null?"":String(e.id);if(e.type==="answer"){const r=e.question?.id==null?"":String(e.question.id);return r&&t?`https://www.zhihu.com/question/${r}/answer/${t}`:""}if(e.type==="article")return t?`https://zhuanlan.zhihu.com/p/${t}`:"";if(e.type==="question")return t?`https://www.zhihu.com/question/${t}`:"";return""}function z(e){if(typeof e!=="string"||!e)return"";try{const t=new URL(e);if(t.hostname==="api.zhihu.com"&&t.pathname==="/search_v3")return`https://www.zhihu.com/api/v4/search_v3${t.search}`;if(t.hostname==="www.zhihu.com"&&t.pathname==="/api/v4/search_v3")return t.toString()}catch{return""}return""}const E=1000,L=20,w=["all","answer","article","question"];function S(e){const t=Number(e??10);if(!Number.isInteger(t)||t<=0||t>E)throw new p(`zhihu search --limit must be a positive integer no greater than ${E}`,"Use a normal-sized limit to avoid slow requests or Zhihu risk controls");return t}function b(e){const t=String(e||"").trim();if(!t)throw new p("zhihu search query must not be empty","Example: ppcli zhihu search codex");return t}function v(e){const t=String(e||"all");if(!w.includes(t))throw new p(`zhihu search --type must be one of: ${w.join(", ")}`,"Example: ppcli zhihu search codex --type answer");return t}function l(e){if(e&&typeof e==="object"&&"data"in e&&"session"in e)return e.data;return e}function x(e,t){const r=l(e);if(!r||typeof r!=="object"||Array.isArray(r))throw new a("Zhihu search returned malformed payload");if(r.__httpError){const n=r.__httpError;if(n===401||n===403)throw new k("www.zhihu.com","Failed to fetch search results from Zhihu");throw new a(`Zhihu search request failed${n?` (HTTP ${n})`:""}`,"Try again later or rerun with -v for more detail")}if(r.__fetchError)throw new a("Zhihu search request failed",String(r.__fetchError));if(!Array.isArray(r.data))throw new a("Zhihu search returned malformed data list",`URL: ${t}`);if(!r.paging||typeof r.paging!=="object")throw new a("Zhihu search returned malformed paging data",`URL: ${t}`);return r}function R(e){return`
       (async () => {
         try {
-          const r = await fetch(${JSON.stringify(D)}, { credentials: 'include' });
+          const r = await fetch(${JSON.stringify(e)}, { credentials: 'include' });
           if (!r.ok) return { __httpError: r.status };
           return await r.json();
         } catch (err) {
           return { __fetchError: err?.message || String(err) };
         }
       })()
-    `}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};
+    `}async function Z(e,t){let r=l(await e.evaluate(R(t)));if(r&&typeof r==="object"&&!Array.isArray(r)&&r.__fetchError){await e.goto("https://www.zhihu.com");r=l(await e.evaluate(R(t)))}return x(r,t)}function A(e){if(!e||typeof e!=="object"||e.type!=="search_result"||!e.object||typeof e.object!=="object")return null;const t=e.object;if(t.type!=="answer"&&t.type!=="article"&&t.type!=="question")return null;const r=q(e),n=_(t),i=t.question||{},o=g(t.title||i.name||i.title||"");if(!r||!n||!o)throw new a("Zhihu search returned malformed result row identity");return{item:e,key:r,row:{title:o,type:t.type,author:t.author?.name||"",votes:t.voteup_count||0,url:n}}}j({site:"zhihu",name:"search",access:"read",description:"知乎搜索",domain:"www.zhihu.com",strategy:U.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:w,help:"Result type: all, answer, article, or question"}],columns:["rank","title","type","author","votes","url"],func:async(e,t)=>{const r=b(t.query),n=S(t.limit),i=v(t.type);await e.goto("https://www.zhihu.com");let o=`https://www.zhihu.com/api/v4/search_v3?q=${encodeURIComponent(r)}&t=general&offset=0&limit=${L}`;const s=[],m=new Set,f=new Set;while(o&&s.length<n&&!f.has(o)){f.add(o);const u=await Z(e,o);for(const d of u.data){const y=d?.object?.type;if(i!=="all"&&y&&y!==i)continue;const c=A(d);if(!c)continue;if(i!=="all"&&c.row.type!==i)continue;if(m.has(c.key))continue;m.add(c.key);s.push(c.row);if(s.length>=n)break}if(s.length>=n)break;if(u.paging?.is_end)break;const h=z(u.paging?.next);if(!h)throw new a("Zhihu search pagination returned malformed next URL");if(f.has(h))throw new a("Zhihu search pagination returned a repeated next URL");o=h}if(s.length===0)throw new I("zhihu search",`No ${i==="all"?"":`${i} `}results found for "${r}"`);return s.map((u,h)=>{return{rank:h+1,...u}})}});export const __test__={stripHtml:g,itemKey:q,itemUrl:_,normalizeSearchUrl:z,parseLimit:S,requireQuery:b,requireType:v,unwrapEvaluateResult:l,requireSearchPayload:x,fetchSearchPage:Z,normalizeResultItem:A};

package/clis/zhihu/stats.js

@@ -1,5 +1,5 @@
-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};
+import{cli as m,Strategy as d}from"@jackwener/opencli/registry";import{AuthRequiredError as h,CommandExecutionError as g,EmptyResultError as f}from"@jackwener/opencli/errors";function y(e){if(!e)return"";const r=new Date(e*1000),s=(c)=>String(c).padStart(2,"0");return`${r.getFullYear()}-${s(r.getMonth()+1)}-${s(r.getDate())} ${s(r.getHours())}:${s(r.getMinutes())}`}function v(e,r,s){if(!r)return"";if(e==="article")return`https://zhuanlan.zhihu.com/p/${r}`;if(e==="answer")return s?`https://www.zhihu.com/question/${s}/answer/${r}`:`https://www.zhihu.com/answer/${r}`;if(e==="pin")return`https://www.zhihu.com/pin/${r}`;if(e==="zvideo")return`https://www.zhihu.com/zvideo/${r}`;if(e==="question")return`https://www.zhihu.com/question/${r}`;return""}function w(e){if(typeof e!=="string"||!e||e.includes("NaN"))return"";return e}m({site:"zhihu",name:"stats",access:"read",description:"知乎内容数据（每篇阅读/赞同/收藏/评论等全量运营指标）",domain:"www.zhihu.com",strategy:d.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(e,r)=>{const s=Math.max(1,Number(r.limit)||20);await e.goto("https://www.zhihu.com/creator/manage/creation/all");await e.wait(2);const c=await e.evaluate(`(async () => {
+      const LIMIT = ${s};
       // 大整数 id 加引号保精度（知乎内容 id 19 位，超出 JS Number 安全范围）
       const safeParse = (text) => JSON.parse(
         text.replace(/("(?:id|question_id|url_token)"\\s*:\\s*)(\\d{15,})/g, '$1"$2"')
@@ -38,4 +38,4 @@ import{cli as Z,Strategy as _}from"@jackwener/opencli/registry";import{AuthRequi
         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):""}})}});
+    })()`),u=c&&typeof c==="object"&&"data"in c&&"session"in c?c.data:c;if(!u||u.error){const n=u&&u.error;if(n==="HTTP 401"||n==="HTTP 403")throw new h("www.zhihu.com",`知乎创作中心接口返回 ${n}，请先在 Chrome 中登录知乎`);throw new g(`知乎内容列表获取失败（${n||"响应为空"}），请确认已登录 www.zhihu.com 且创作中心可访问`)}const l=Array.isArray(u.rows)?u.rows:[];if(l.length===0)throw new f("zhihu stats","未获取到任何内容。请确认已登录知乎且账号发布过内容（回答/文章/想法）。");return l.map((n)=>{const i=n.data||{},o=n.reaction||{},t=n.aggr||null,p=t&&t.advanced||{},_=t&&t.content_mark?t.content_mark.is_collapsed?"被折叠":t.content_mark.is_suggest?"获推荐":"":"",a={};if(t){if(t.pageshow_uv)a.详情页访客uv=t.pageshow_uv;if(t.play)a.播放量=t.play;if(t.reaction)a.想法互动数=t.reaction;if(t.like_and_reaction)a.喜欢加互动=t.like_and_reaction;if(t.follower_conversion_rate)a.粉丝转化率=t.follower_conversion_rate}if(o.reviewing_comment_count)a.审核中评论数=o.reviewing_comment_count;if(i.question_id)a.问题id=String(i.question_id);if(i.answered_question_token)a.关联问题token=String(i.answered_question_token);return{id:String(i.id??""),type:n.type??"",title:i.title??"",url:v(n.type,String(i.id??""),i.question_id?String(i.question_id):""),published_at:y(i.created_time),views:t?t.pv??o.read_count??"":o.read_count??"",likes:o.vote_up_count??(t?t.upvote:"")??"",comments:o.comment_count??(t?t.comment:"")??"",collects:o.collect_count??(t?t.collect:"")??"",shares:t?t.share??"":"",shows:t?t.show??"":"",favors:o.like_count??(t?t.like:"")??"",reposts:t&&t.re_pin!=null?t.re_pin:o.repin_count??"",new_followers:t?t.new_follow_uv??"":"",finish_read_rate:w(p.finish_read_percent),interact_rate:w(p.positive_interact_percent),mark:_,extra:Object.keys(a).length?JSON.stringify(a):""}})}});

package/clis/zhihu/user-arg.js

@@ -1 +1 @@
-import{CliError as J}from"@jackwener/opencli/errors";const N=/^[A-Za-z0-9_-]+$/,Q=/^user:([A-Za-z0-9_-]+)$/,V=/^\/people\/([A-Za-z0-9_-]+)\/?$/;export function parseZhihuUser(K){const q=String(K??"").trim();if(!q)throw new J("INVALID_INPUT","A Zhihu user is required","Example: ppcli zhihu user wen-jie-16-47");const B=q.match(Q);if(B)return B[1];if(N.test(q))return q;try{const z=new URL(q);if(z.protocol==="https:"&&z.hostname==="www.zhihu.com"){const D=z.pathname.match(V);if(D)return D[1]}}catch{}throw new J("INVALID_INPUT",`Invalid Zhihu user: ${q}`,"Use a url_token (wen-jie-16-47) or a people URL (https://www.zhihu.com/people/wen-jie-16-47)")}
+import{CliError as i}from"@jackwener/opencli/errors";const h=/^[A-Za-z0-9_-]+$/,s=/^user:([A-Za-z0-9_-]+)$/,u=/^\/people\/([A-Za-z0-9_-]+)\/?$/;export function parseZhihuUser(n){const e=String(n??"").trim();if(!e)throw new i("INVALID_INPUT","A Zhihu user is required","Example: ppcli zhihu user wen-jie-16-47");const r=e.match(s);if(r)return r[1];if(h.test(e))return e;try{const t=new URL(e);if(t.protocol==="https:"&&t.hostname==="www.zhihu.com"){const o=t.pathname.match(u);if(o)return o[1]}}catch{}throw new i("INVALID_INPUT",`Invalid Zhihu user: ${e}`,"Use a url_token (wen-jie-16-47) or a people URL (https://www.zhihu.com/people/wen-jie-16-47)")}