publishport-opencli 1.0.0

package/clis/zhihu/download.js

@@ -0,0 +1,39 @@
+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(`
+      (() => {
+        const result = {
+          title: '',
+          author: '',
+          publishTime: '',
+          contentHtml: '',
+          imageUrls: []
+        };
+
+        // Get title
+        const titleEl = document.querySelector('.Post-Title, h1.ContentItem-title, .ArticleTitle');
+        result.title = titleEl?.textContent?.trim() || 'untitled';
+
+        // Get author
+        const authorEl = document.querySelector('.AuthorInfo-name, .UserLink-link');
+        result.author = authorEl?.textContent?.trim() || '';
+
+        // Get publish time
+        const timeEl = document.querySelector('.ContentItem-time, .Post-Time');
+        result.publishTime = timeEl?.textContent?.trim() || '';
+
+        // Get content HTML
+        const contentEl = document.querySelector('.Post-RichTextContainer, .RichText, .ArticleContent');
+        if (contentEl) {
+          result.contentHtml = contentEl.innerHTML;
+
+          // Extract image URLs
+          contentEl.querySelectorAll('img').forEach(img => {
+            const src = img.getAttribute('data-original') || img.getAttribute('data-actualsrc') || img.src;
+            if (src && !src.includes('data:image')) {
+              result.imageUrls.push(src);
+            }
+          });
+        }
+
+        return result;
+      })()
+    `);return 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/"}})}});

package/clis/zhihu/favorite.js

@@ -0,0 +1,39 @@
+import{CliError as n,CommandExecutionError as c}from"@jackwener/opencli/errors";import{cli as s,Strategy as m}from"@jackwener/opencli/registry";import{assertAllowedKinds as d,parseTarget as u}from"./target.js";import{buildResultRow as p,requireExecute as f}from"./write-shared.js";function y(e){return e.replace(/\s+/g," ").replace(/\s+\d+\s*(条内容|个内容|items?)$/i,"").replace(/\s+(公开|私密|默认)$/i,"").trim()}s({site:"zhihu",name:"favorite",access:"write",description:"Favorite a Zhihu answer or article into a specific collection",domain:"zhihu.com",strategy:m.COOKIE,browser:!0,args:[{name:"target",positional:!0,required:!0,help:"Zhihu target URL or typed target"},{name:"collection",help:"Collection name"},{name:"collection-id",help:"Stable collection id"},{name:"execute",type:"boolean",help:"Actually perform the write action"}],columns:["status","outcome","message","target_type","target","collection_name","collection_id"],func:async(e,t)=>{if(!e)throw new c("Browser session required for zhihu favorite");f(t);const r=String(t.target),i=d("favorite",u(r)),o=typeof t.collection==="string"?t.collection:void 0,a=typeof t["collection-id"]==="string"?t["collection-id"]:void 0;if((o?1:0)+(a?1:0)!==1)throw new n("INVALID_INPUT","Use exactly one of --collection or --collection-id");await e.goto("https://www.zhihu.com");await e.wait(2);const l=await e.evaluate(`(async () => {
+            var collectionId = ${JSON.stringify(a||null)};
+            var collectionName = ${JSON.stringify(o||null)};
+            var targetKind = ${JSON.stringify(i.kind)};
+            var targetId = ${JSON.stringify(i.id)};
+            var normalizeCollectionName = function(value) {
+                return String(value || '')
+                    .replace(/\\s+/g, ' ')
+                    .replace(/\\s+\\d+\\s*(条内容|个内容|items?)$/i, '')
+                    .replace(/\\s+(公开|私密|默认)$/i, '')
+                    .trim()
+                    .toLowerCase();
+            };
+
+            if (!collectionId && collectionName) {
+                var listResp = await fetch('https://www.zhihu.com/api/v4/people/self/collections?limit=50', { credentials: 'include' });
+                if (!listResp.ok) return { ok: false, message: 'Failed to list collections: HTTP ' + listResp.status };
+                var listData = {};
+                try { listData = await listResp.json(); } catch(e) {
+                    return { ok: false, message: 'Failed to parse collection list' };
+                }
+                var needle = normalizeCollectionName(collectionName);
+                var matches = (listData.data || []).filter(function(c) { return normalizeCollectionName(c.title) === needle; });
+                if (matches.length === 0) return { ok: false, message: 'Collection not found: ' + collectionName };
+                if (matches.length > 1) return { ok: false, message: 'Collection name is ambiguous: ' + collectionName };
+                collectionId = String(matches[0].id);
+            }
+
+            var resp = await fetch('https://www.zhihu.com/api/v4/favlists/' + collectionId + '/items', {
+                method: 'POST',
+                credentials: 'include',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ item_id: targetId, item_type: targetKind }),
+            });
+            if (resp.ok || resp.status === 204) return { ok: true, collectionId: collectionId };
+            var data = {};
+            try { data = await resp.json(); } catch(e) {}
+            return { ok: false, message: data.error ? data.error.message : 'HTTP ' + resp.status };
+        })()`);if(!l?.ok)throw new n("COMMAND_EXEC",l?.message||"Failed to favorite");return p(`Favorited ${i.kind} ${i.id}`,i.kind,r,"applied",{collection_name:o||"",collection_id:l.collectionId||a||""})}});

package/clis/zhihu/follow.js

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

package/clis/zhihu/followers.js

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

package/clis/zhihu/following.js

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

package/clis/zhihu/hot.js

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

package/clis/zhihu/like.js

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

package/clis/zhihu/paginate.js

@@ -0,0 +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:")return"";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(`
+      (async () => {
+        try {
+          const r = await fetch(${JSON.stringify(N)}, { 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(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:$};

package/clis/zhihu/pin.js

@@ -0,0 +1,24 @@
+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)};
+            var xsrf = (document.cookie.match(/_xsrf=([^;]+)/) || [])[1] || '';
+            var body = new URLSearchParams();
+            body.set('content', JSON.stringify([{ type: 'text', content: html }]));
+            body.set('reaction_instruction', JSON.stringify({}));
+            var resp = await fetch('https://www.zhihu.com/api/v4/pins', {
+                method: 'POST',
+                credentials: 'include',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    'x-requested-with': 'fetch',
+                    'x-xsrftoken': xsrf,
+                },
+                body: body.toString(),
+            });
+            var text = await resp.text();
+            var data;
+            try { data = JSON.parse(text); } catch (e) { data = null; }
+            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;")}

package/clis/zhihu/pins.js

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

package/clis/zhihu/question.js

@@ -0,0 +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: opencli zhihu question 123456789");const O=Number(F);if(!Number.isInteger(O)||O<=0||O>x)throw new W("INVALID_INPUT",`Limit must be a positive integer no greater than ${x}`,"Use a normal-sized limit to avoid slow requests or Zhihu risk controls");const Q=String(z.sort||"default");if(Q!=="default"&&Q!=="created")throw new W("INVALID_INPUT","Sort must be one of: default, created","Example: opencli zhihu question 123456789 --sort created");await b.goto(Q==="created"?`https://www.zhihu.com/question/${N}/answers/updated`:`https://www.zhihu.com/question/${N}`);let P=`https://www.zhihu.com/api/v4/questions/${N}/answers?limit=${20}&offset=0&sort_by=${Q}&include=data[*].content,url,voteup_count,comment_count,author`;const V=[],Y=new Set,Z=new Set;while(P&&V.length<O&&!Z.has(P)){Z.add(P);const B=await b.evaluate(`
+      (async () => {
+        const r = await fetch(${JSON.stringify(P)}, { 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)}})}});

package/clis/zhihu/recommend.js

@@ -0,0 +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(`
+      (async () => {
+        const r = await fetch(${JSON.stringify(G)}, { 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)}})}});

package/clis/zhihu/search.js

@@ -0,0 +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: opencli zhihu search codex");return B}function I(D){const B=String(D||"all");if(!Q.includes(B))throw new K(`zhihu search --type must be one of: ${Q.join(", ")}`,"Example: opencli zhihu search codex --type answer");return B}function H(D){if(D&&typeof D==="object"&&"data"in D&&"session"in D)return D.data;return D}function P(D,B){const N=H(D);if(!N||typeof N!=="object"||Array.isArray(N))throw new $("Zhihu search returned malformed payload");if(N.__httpError){const O=N.__httpError;if(O===401||O===403)throw new S("www.zhihu.com","Failed to fetch search results from Zhihu");throw new $(`Zhihu search request failed${O?` (HTTP ${O})`:""}`,"Try again later or rerun with -v for more detail")}if(N.__fetchError)throw new $("Zhihu search request failed",String(N.__fetchError));if(!Array.isArray(N.data))throw new $("Zhihu search returned malformed data list",`URL: ${B}`);if(!N.paging||typeof N.paging!=="object")throw new $("Zhihu search returned malformed paging data",`URL: ${B}`);return N}function T(D){return`
+      (async () => {
+        try {
+          const r = await fetch(${JSON.stringify(D)}, { 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};

package/clis/zhihu/stats.js

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

package/clis/zhihu/target.js

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

package/clis/zhihu/text.js

@@ -0,0 +1,6 @@
+function n(e){return Number.isInteger(e)&&e>=0&&e<=1114111?String.fromCodePoint(e):null}export function stripHtml(e,{preserveBlocks:p=!1}={}){if(!e)return"";let r=String(e);if(p)r=r.replace(/<br\s*\/?\s*>/gi,`
+`).replace(/<\/(?:p|div|h[1-6]|li|blockquote)>/gi,`
+
+`);return r.replace(/<[^>]+>/g,"").replace(/&nbsp;/g," ").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/&amp;/g,"&").replace(/&quot;/g,'"').replace(/&#39;/g,"'").replace(/&#(\d+);/g,(t,l)=>n(Number(l))??t).replace(/&#x([0-9a-f]+);/gi,(t,l)=>n(Number.parseInt(l,16))??t).replace(/\n{3,}/g,`
+
+`).trim()}export const __test__={decodeEntity:n};

package/clis/zhihu/user-answers.js

@@ -0,0 +1 @@
+import{cli as u,Strategy as c}from"@jackwener/opencli/registry";import{CommandExecutionError as a}from"@jackwener/opencli/errors";import{parseZhihuUser as d}from"./user-arg.js";import{fetchZhihuList as h,validateLimit as w}from"./paginate.js";const l="data[*].voteup_count,comment_count,created_time,question";u({site:"zhihu",name:"user-answers",access:"read",description:"知乎某用户的回答列表",domain:"www.zhihu.com",strategy:c.COOKIE,args:[{name:"user",type:"string",required:!0,positional:!0,help:"User url_token or people URL"},{name:"limit",type:"int",default:20,help:"Number of answers to return (max 1000)"}],columns:["rank","question","votes","comments","created","url"],func:async(i,o)=>{const r=d(o.user),n=w(o.limit);await i.goto("https://www.zhihu.com");const s=`https://www.zhihu.com/api/v4/members/${encodeURIComponent(r)}/answers?limit=20&offset=0&include=${encodeURIComponent(l)}`;return(await h(i,s,n,"user answers")).map((t,m)=>{const e=t.question||{};if(!t.id||!e.id||!e.title)throw new a("Zhihu user answers returned malformed row identity");return{rank:m+1,question:String(e.title||""),votes:t.voteup_count??t.reaction?.statistics?.like_count??0,comments:t.comment_count??0,created:t.created_time??t.created??0,url:e.id&&t.id?`https://www.zhihu.com/question/${e.id}/answer/${t.id}`:""}})}});

package/clis/zhihu/user-arg.js

@@ -0,0 +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: opencli 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)")}

package/clis/zhihu/user-articles.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as u}from"@jackwener/opencli/registry";import{CommandExecutionError as c}from"@jackwener/opencli/errors";import{parseZhihuUser as a}from"./user-arg.js";import{fetchZhihuList as l,validateLimit as h}from"./paginate.js";const p="data[*].voteup_count,comment_count";s({site:"zhihu",name:"user-articles",access:"read",description:"知乎某用户的文章/专栏列表",domain:"www.zhihu.com",strategy:u.COOKIE,args:[{name:"user",type:"string",required:!0,positional:!0,help:"User url_token or people URL"},{name:"limit",type:"int",default:20,help:"Number of articles to return (max 1000)"}],columns:["rank","title","votes","comments","created","url"],func:async(e,i)=>{const r=a(i.user),o=h(i.limit);await e.goto("https://www.zhihu.com");const n=`https://www.zhihu.com/api/v4/members/${encodeURIComponent(r)}/articles?limit=20&offset=0&include=${encodeURIComponent(p)}`;return(await l(e,n,o,"user articles")).map((t,m)=>{if(!t.id||!t.title)throw new c("Zhihu user articles returned malformed row identity");return{rank:m+1,title:String(t.title||""),votes:t.voteup_count??0,comments:t.comment_count??0,created:t.created??t.updated??0,url:`https://zhuanlan.zhihu.com/p/${t.id}`}})}});

package/clis/zhihu/user.js

@@ -0,0 +1,11 @@
+import{cli as s,Strategy as a}from"@jackwener/opencli/registry";import{AuthRequiredError as h,CommandExecutionError as n,EmptyResultError as l}from"@jackwener/opencli/errors";import{parseZhihuUser as c}from"./user-arg.js";import{unwrapEvaluateResult as w}from"./paginate.js";const _="follower_count,following_count,answer_count,articles_count,question_count,voteup_count,thanked_count,favorited_count,headline,gender";s({site:"zhihu",name:"user",access:"read",description:"知乎用户主页资料（粉丝/关注/回答/文章/获赞数）",domain:"www.zhihu.com",strategy:a.COOKIE,args:[{name:"user",type:"string",required:!0,positional:!0,help:"User url_token or people URL, e.g. wen-jie-16-47"}],columns:["url_token","name","headline","followers","following","answers","articles","voteup","url"],func:async(t,i)=>{const o=c(i.user);await t.goto("https://www.zhihu.com");const u=`https://www.zhihu.com/api/v4/members/${encodeURIComponent(o)}?include=${encodeURIComponent(_)}`,r=w(await t.evaluate(`
+      (async () => {
+        try {
+          const r = await fetch(${JSON.stringify(u)}, { credentials: 'include' });
+          if (!r.ok) return { __httpError: r.status };
+          return await r.json();
+        } catch (err) {
+          return { __fetchError: err?.message || String(err) };
+        }
+      })()
+    `));if(!r||typeof r!=="object"||Array.isArray(r)||r.__httpError||r.__fetchError){const e=r?.__httpError;if(e===401||e===403)throw new h("www.zhihu.com","Failed to fetch Zhihu user profile");if(e===404)throw new l("zhihu user",`No Zhihu user was found for ${o}.`);throw new n(e?`Zhihu user request failed (HTTP ${e})`:"Zhihu user request failed",r?.__fetchError?String(r.__fetchError):"Try again later or rerun with -v")}if(!r.url_token||!r.id||!r.name)throw new n("Zhihu user response missing identity fields","Zhihu may have changed its API shape");return[{url_token:String(r.url_token||""),name:String(r.name||""),headline:String(r.headline||""),followers:r.follower_count??0,following:r.following_count??0,answers:r.answer_count??0,articles:r.articles_count??0,voteup:r.voteup_count??0,url:r.url_token?`https://www.zhihu.com/people/${r.url_token}`:""}]}});

package/clis/zhihu/write-shared.js

@@ -0,0 +1,71 @@
+import{readFile as h,stat as A}from"node:fs/promises";import{CliError as Q}from"@jackwener/opencli/errors";const T=new Set(["status","outcome","message","target_type","target"]),$='header, nav, [role="banner"], [role="navigation"]',J='a[href^="/people/"]',W='img, [class*="Avatar"], [data-testid*="avatar" i], [aria-label*="头像"]',Y=["我","我的","个人主页"],z=[["self"],["current","user"],["account","profile"],["my","profile"],["my","account"]],C=JSON.stringify(z);function F(){return{readFile:h,stat:(j)=>A(j),decodeUtf8:(j)=>new TextDecoder("utf-8",{fatal:!0}).decode(j)}}function f(j){const q=j.toLowerCase();return Y.some((G)=>j.includes(G))||q.includes("my profile")||q.includes("my account")}function I(j){return j.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean)}function _(j){const q=new Set(I(j));return z.some((G)=>G.every((B)=>q.has(B)))}function O(j){return typeof j==="object"&&j!==null&&"querySelectorAll"in j&&typeof j.querySelectorAll==="function"}function c(j){return typeof j==="object"&&j!==null&&"getAttribute"in j&&"querySelector"in j&&typeof j.getAttribute==="function"&&typeof j.querySelector==="function"}function L(j){const q=j?.topstory?.me?.slug||j?.me?.slug||j?.initialState?.me?.slug;return typeof q==="string"&&q?q:null}function x(j,q){const B=(j.getAttribute("href")||"").match(/^\/people\/([A-Za-z0-9_-]+)/);if(!B)return null;const H=j.getAttribute("aria-label")||"",X=j.getAttribute("title")||"",Z=j.getAttribute("data-testid")||"",M=j.getAttribute("class")||"",K=j.getAttribute("rel")||"",U=`${H} ${X} ${j.textContent||""}`,V=`${Z} ${M} ${K}`,b=Boolean(j.querySelector(W)),P=f(U),N=_(V);if(P||N)return B[1];if(q&&b)return B[1];return null}function D(j,q){for(const G of j)for(const B of Array.from(G.querySelectorAll(J)).filter(c)){const H=x(B,q);if(H)return H}return null}export function resolveCurrentUserSlugFromDom(j,q){const G=L(j);if(G)return G;const B=Array.from(q.querySelectorAll($)).filter(O);return D(B,!0)||D([q],!1)}export function requireExecute(j){if(!j.execute)throw new Q("INVALID_INPUT","此知乎写命令需要 --execute 才会真正执行。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}export async function resolvePayload(j,q=F()){const G=typeof j.text==="string"?j.text:void 0,B=typeof j.file==="string"?j.file:void 0;if(G&&B)throw new Q("INVALID_INPUT","Use either <text> or --file, not both");let H=G??"";if(B){let X;try{X=await q.stat(B)}catch{throw new Q("INVALID_INPUT",`File not found: ${B}`)}if(!X.isFile())throw new Q("INVALID_INPUT",`File must be a readable text file: ${B}`);let Z;try{Z=await q.readFile(B)}catch{throw new Q("INVALID_INPUT",`File could not be read: ${B}`)}try{H=q.decodeUtf8(Z)}catch{throw new Q("INVALID_INPUT",`File could not be decoded as UTF-8 text: ${B}`)}}if(!H.trim())throw new Q("INVALID_INPUT","Payload cannot be empty or whitespace only");return H}function R(){return`(() => {
+    const selfLabelTokens = ${JSON.stringify(Y)};
+    const explicitIdentityMetaTokenGroups = ${C};
+    const navScopeSelector = ${JSON.stringify($)};
+    const profileLinkSelector = ${JSON.stringify(J)};
+    const avatarSelector = ${JSON.stringify(W)};
+
+    const hasExplicitIdentityLabel = (text) => {
+      const normalized = String(text || '').toLowerCase();
+      return selfLabelTokens.some((token) => String(text || '').includes(token))
+        || normalized.includes('my profile')
+        || normalized.includes('my account');
+    };
+
+    const tokenizeIdentityMeta = (text) => String(text || '')
+      .toLowerCase()
+      .split(/[^a-z0-9]+/)
+      .filter(Boolean);
+
+    const hasExplicitIdentityMeta = (text) => {
+      const tokens = new Set(tokenizeIdentityMeta(text));
+      return explicitIdentityMetaTokenGroups.some((group) => group.every((token) => tokens.has(token)));
+    };
+
+    const getSlugFromIdentityLink = (node, allowAvatarOnly) => {
+      const href = node.getAttribute('href') || '';
+      const match = href.match(/^\\/people\\/([A-Za-z0-9_-]+)/);
+      if (!match) return null;
+
+      const aria = node.getAttribute('aria-label') || '';
+      const title = node.getAttribute('title') || '';
+      const testid = node.getAttribute('data-testid') || '';
+      const className = node.getAttribute('class') || '';
+      const rel = node.getAttribute('rel') || '';
+      const identityLabel = \`\${aria} \${title} \${node.textContent || ''}\`;
+      const identityMeta = \`\${testid} \${className} \${rel}\`;
+      const hasAvatar = Boolean(node.querySelector(avatarSelector));
+
+      if (hasExplicitIdentityLabel(identityLabel) || hasExplicitIdentityMeta(identityMeta)) return match[1];
+      if (allowAvatarOnly && hasAvatar) return match[1];
+      return null;
+    };
+
+    const findCurrentUserSlugFromRoots = (roots, allowAvatarOnly) => {
+      for (const root of roots) {
+        for (const node of Array.from(root.querySelectorAll(profileLinkSelector))) {
+          const slug = getSlugFromIdentityLink(node, allowAvatarOnly);
+          if (slug) return slug;
+        }
+      }
+      return null;
+    };
+
+    const scopedGlobal = globalThis;
+    const state = scopedGlobal.__INITIAL_STATE__ || (scopedGlobal.window && scopedGlobal.window.__INITIAL_STATE__) || null;
+    const slugFromState = state && (state.topstory && state.topstory.me && state.topstory.me.slug)
+      || (state && state.me && state.me.slug)
+      || (state && state.initialState && state.initialState.me && state.initialState.me.slug);
+    if (typeof slugFromState === 'string' && slugFromState) return { slug: slugFromState };
+
+    const navScopes = Array.from(document.querySelectorAll(navScopeSelector));
+    const slug = findCurrentUserSlugFromRoots(navScopes, true) || findCurrentUserSlugFromRoots([document], false);
+    if (slug) return { slug };
+
+    var avatarImgs = document.querySelectorAll('header img[alt*="\\u4e3b\\u9875"]');
+    for (var ai = 0; ai < avatarImgs.length; ai++) {
+      var altMatch = (avatarImgs[ai].alt || '').match(/\\u70b9\\u51fb\\u6253\\u5f00(.+?)\\u7684\\u4e3b\\u9875/);
+      if (altMatch) return { slug: altMatch[1] };
+    }
+    return null;
+  })()`}export async function resolveCurrentUserIdentity(j){let q=null;for(let G=0;G<30;G++){q=await j.evaluate(R());if(q?.slug)break;await j.wait({time:0.5})}if(!q?.slug)throw new Q("ACTION_NOT_AVAILABLE","Could not resolve the logged-in Zhihu user identity before write");return q.slug}export function buildResultRow(j,q,G,B,H={}){for(const X of Object.keys(H))if(T.has(X))throw new Q("INVALID_INPUT",`Result extra field cannot overwrite reserved key: ${X}`);return[{status:"success",outcome:B,message:j,target_type:q,target:G,...H}]}export const __test__={requireExecute,resolvePayload,resolveCurrentUserIdentity,resolveCurrentUserSlugFromDom,buildResultRow};

package/clis/zlibrary/info.js

@@ -0,0 +1 @@
+import{cli as i,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as n}from"@jackwener/opencli/errors";import{ZLIBRARY_DOMAIN as s,extractBookTitle as d,extractFormats as m,normalizeZlibraryBookUrl as b}from"./utils.js";i({site:"zlibrary",name:"info",access:"read",description:"Get book details and available download formats from a Z-Library book page",domain:s,strategy:l.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"url",positional:!0,required:!0,help:"Z-Library book page URL (e.g. https://z-library.im/book/...)"}],columns:["title","pdf","epub","url"],func:async(t,e)=>{const a=b(e.url);await t.goto(a,{waitUntil:"load",settleMs:3000});await t.wait({time:5});const o=await d(t),r=await m(t);if(!o||!r.pdf&&!r.epub)throw new n("zlibrary info","Could not extract a book title and download formats. Check the URL, login state, and whether Z-Library changed its page layout.");return[{title:o,pdf:r.pdf||"",epub:r.epub||"",url:a}]}});

package/clis/zlibrary/search.js

@@ -0,0 +1 @@
+import{cli as i,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as s}from"@jackwener/opencli/errors";import{ZLIBRARY_DOMAIN as n,buildSearchUrl as u,extractSearchResults as c}from"./utils.js";i({site:"zlibrary",name:"search",access:"read",description:"Search Z-Library for books by title, author, ISBN, or keyword",domain:n,strategy:l.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword (title, author, ISBN, etc.)"},{name:"limit",type:"int",default:10,help:"Max results (1–25)"}],columns:["rank","title","author","url"],func:async(r,t)=>{const a=Math.max(1,Math.min(Number(t.limit)||10,25)),o=u(t.query);await r.goto(o,{waitUntil:"load",settleMs:3000});await r.wait({time:5});const e=await c(r,a);if(!e.length)throw new s("zlibrary search","No books found. Try a different keyword or check that you are logged into Z-Library.");return e}});

package/clis/zlibrary/utils.js

@@ -0,0 +1,48 @@
+import{ArgumentError as K}from"@jackwener/opencli/errors";const ZLIBRARY_DOMAIN="z-library.im",ZLIBRARY_ORIGIN=`https://${ZLIBRARY_DOMAIN}`,P=new Set([ZLIBRARY_DOMAIN,`www.${ZLIBRARY_DOMAIN}`]);export function normalizeZlibraryBookUrl(C){const F=String(C||"").trim();let J;try{J=new URL(F)}catch{throw new K("Z-Library book URL must be a valid http(s) URL",`Example: ${ZLIBRARY_ORIGIN}/book/...`)}if(!["http:","https:"].includes(J.protocol)||!P.has(J.hostname))throw new K(`Unsupported Z-Library URL host: ${J.hostname}`,`Pass a book URL under ${ZLIBRARY_DOMAIN}, for example ${ZLIBRARY_ORIGIN}/book/...`);return J.toString()}export function buildSearchUrl(C){const F=String(C||"").trim();if(!F)throw new K("zlibrary search query cannot be empty");return`${ZLIBRARY_ORIGIN}/s/${encodeURIComponent(F)}`}export async function extractBookTitle(C){const F=await C.evaluate(`
+      (() => {
+        const card = document.querySelector('z-bookcard');
+        if (card && card.shadowRoot) {
+          const el = card.shadowRoot.querySelector('[class*="title"], h1, a');
+          if (el) return el.textContent.trim().split('\\n')[0].trim();
+        }
+        return document.title.replace(/\\s*[-|].*$/, '').trim();
+      })()
+    `);return String(F||"").trim()}export async function extractFormats(C){await C.evaluate(`
+      (() => {
+        const btn = document.querySelector(
+          'button[aria-label*="more" i], [class*="dots" i], [class*="more" i]'
+        );
+        if (btn) btn.click();
+      })()
+    `);await C.wait({time:3});const F=await C.evaluate(`
+      JSON.stringify((() => {
+        const res = { pdf: '', epub: '' };
+        document.querySelectorAll('a[href]').forEach(a => {
+          const h = a.href || '';
+          const t = (a.textContent || '').toUpperCase();
+          if (h.includes('/dl/') && t.includes('PDF')) res.pdf = h;
+          if (h.includes('/dl/') && t.includes('EPUB')) res.epub = h;
+        });
+        return res;
+      })())
+    `);return JSON.parse(F)}export async function extractSearchResults(C,F){const J=await C.evaluate(`
+    JSON.stringify(
+      Array.from(document.querySelectorAll('z-bookcard'))
+        .slice(0, ${F})
+        .map((card, index) => {
+          const text = card.textContent.trim();
+          const lines = text.split('\\n').map(l => l.trim()).filter(Boolean);
+          const title = lines[0] || '';
+          const author = lines[1] || '';
+          let url = '';
+          try {
+            if (card.shadowRoot) {
+              const link = card.shadowRoot.querySelector('a');
+              if (link) url = link.href || '';
+            }
+          } catch(e) {}
+          return { rank: index + 1, title, author, url };
+        })
+        .filter(item => item.url && item.title)
+    )
+  `);try{return JSON.parse(J)}catch{return[]}}export{ZLIBRARY_DOMAIN,ZLIBRARY_ORIGIN};

package/clis/zsxq/auth.js

@@ -0,0 +1,33 @@
+import{AuthRequiredError as D,CommandExecutionError as F}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as H}from"../_shared/site-auth.js";async function G(B){await B.goto("https://wx.zsxq.com/");await B.wait(2);const z=await B.evaluate(`
+    (async () => {
+      const url = location.href;
+      if (/\\/login(\\b|$)/.test(url)) {
+        return { kind: 'auth', detail: 'zsxq wx page redirected to /login — anonymous session' };
+      }
+      try {
+        const r = await fetch('https://api.zsxq.com/v2/users/self', {
+          credentials: 'include',
+          headers: { Accept: 'application/json' },
+        });
+        if (r.status === 401 || r.status === 403) {
+          return { kind: 'auth', detail: 'zsxq /v2/users/self returned HTTP ' + r.status };
+        }
+        if (!r.ok) return { kind: 'http', httpStatus: r.status };
+        const d = await r.json();
+        if (d?.succeeded === false || !d?.resp_data?.user) {
+          return { kind: 'auth', detail: 'zsxq /v2/users/self returned succeeded=false — anonymous' };
+        }
+        const u = d.resp_data.user;
+        return { ok: true, user_id: String(u.user_id || u.id || ''), name: String(u.name || u.nickname || '') };
+      } catch (e) {
+        return { kind: 'exception', detail: String(e && e.message || e) };
+      }
+    })()
+  `);if(z?.kind==="auth")throw new D("zsxq.com",z.detail);if(z?.kind==="http")throw new F(`HTTP ${z.httpStatus} from zsxq /v2/users/self`);if(z?.kind==="exception")throw new F(`zsxq whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected zsxq probe: ${JSON.stringify(z)}`);if(!z.user_id)throw new D("zsxq.com","zsxq /v2/users/self 200 but user_id missing — incomplete session");return{user_id:z.user_id,name:z.name}}H({site:"zsxq",domain:"zsxq.com",loginUrl:"https://wx.zsxq.com/login",columns:["user_id","name"],verify:G,poll:async(B)=>{if(!await B.evaluate(`(async () => {
+      try {
+        const r = await fetch('https://api.zsxq.com/v2/users/self', { credentials: 'include', headers: { Accept: 'application/json' } });
+        if (!r.ok) return false;
+        const d = await r.json();
+        return !!(d?.resp_data?.user);
+      } catch { return false; }
+    })()`))throw new D("zsxq.com","Waiting for zsxq login");return G(B)}});

package/clis/zsxq/dynamics.js

@@ -0,0 +1 @@
+import{cli as o,Strategy as c}from"@jackwener/opencli/registry";import{ensureZsxqAuth as n,ensureZsxqPage as m,fetchFirstJson as u,getTopicText as l,getTopicAuthor as p,getTopicUrl as d}from"./utils.js";o({site:"zsxq",name:"dynamics",access:"read",description:"获取所有星球的最新动态",domain:"wx.zsxq.com",strategy:c.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:"Number of dynamics to return"}],columns:["time","group","author","title","comments","likes","url"],func:async(i,a)=>{await m(i);await n(i);const r=Math.max(1,Number(a.limit)||20),{data:s}=await u(i,[`https://api.zsxq.com/v2/dynamics?scope=general&count=${r}`]);return((s?.resp_data||s)?.dynamics||[]).slice(0,r).map((e)=>{const t=e.topic;if(!t)return{time:e.create_time||"",group:"",author:"",title:`[${e.action||"unknown"}]`,comments:0,likes:0,url:""};return{time:e.create_time||t.create_time||"",group:t.group?.name||"",author:p(t),title:l(t),comments:t.comments_count??0,likes:t.likes_count??0,url:d(t.topic_id)}})}});

package/clis/zsxq/groups.js

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

package/clis/zsxq/search.js

@@ -0,0 +1 @@
+import{cli as V,Strategy as W}from"@jackwener/opencli/registry";import{getActiveGroupId as X,ensureZsxqAuth as Y,ensureZsxqPage as _,fetchFirstJson as L,getGroupsFromResponse as $,getTopicsFromResponse as D,toTopicRow as S}from"./utils.js";V({site:"zsxq",name:"search",access:"read",description:"搜索星球内容",domain:"wx.zsxq.com",strategy:W.COOKIE,browser:!0,args:[{name:"keyword",required:!0,positional:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Number of results to return"},{name:"group_id",help:"Optional group id; defaults to the active group in Chrome"}],columns:["topic_id","group","author","title","comments","likes","time","url"],func:async(b,z)=>{await _(b);await Y(b);const M=String(z.keyword||"").trim(),E=Math.max(1,Number(z.limit)||20),B=String(z.group_id||await X(b)),O=encodeURIComponent(M);let H=B;try{const{data:C}=await L(b,["https://api.zsxq.com/v2/groups"]),K=$(C).find((U)=>String(U.group_id)===B);if(K?.name)H=K.name}catch{}const{data:Q}=await L(b,[`https://api.zsxq.com/v2/search/groups/${B}/topics?keyword=${O}&count=${E}`]);return D(Q).slice(0,E).map((C)=>({...S(C),group:H}))}});

package/clis/zsxq/topic.js

@@ -0,0 +1 @@
+import{cli as u,Strategy as d}from"@jackwener/opencli/registry";import{CliError as s}from"@jackwener/opencli/errors";import{getActiveGroupId as l,browserJsonRequest as h,ensureZsxqAuth as w,ensureZsxqPage as f,fetchFirstJson as _,getCommentsFromResponse as g,getTopicFromResponse as R,getTopicUrl as T,summarizeComments as $,toTopicRow as q}from"./utils.js";u({site:"zsxq",name:"topic",access:"read",description:"获取单个话题详情和评论",domain:"wx.zsxq.com",strategy:d.COOKIE,browser:!0,args:[{name:"id",required:!0,positional:!0,help:"Topic ID"},{name:"group_id",help:"Group ID (optional; defaults to active group in Chrome)"},{name:"comment_limit",type:"int",default:20,help:"Number of comments to fetch"}],columns:["topic_id","type","author","title","comments","likes","comment_preview","url"],func:async(o,n)=>{await f(o);await w(o);const t=String(n.id),c=String(n.group_id||await l(o)),p=Math.max(1,Number(n.comment_limit)||20),m=`https://api.zsxq.com/v2/groups/${c}/topics/${t}`,e=await h(o,m);if(e.status===404)throw new s("NOT_FOUND",`Topic ${t} not found`);if(!e.ok)throw new s("FETCH_ERROR",e.error||`Failed to fetch topic ${t}`,`Checked endpoint: ${m}`);const a=await _(o,[`https://api.zsxq.com/v2/groups/${c}/topics/${t}/comments?sort=asc&count=${p}`]),i=R(e.data);if(!i)throw new s("NOT_FOUND",`Topic ${t} not found`);const r=g(a.data);return[{...q({...i,comments:r,comments_count:i.comments_count??r.length}),comment_preview:$(r,5),url:T(i.topic_id??t)}]}});

package/clis/zsxq/topics.js

@@ -0,0 +1 @@
+import{cli as r,Strategy as a}from"@jackwener/opencli/registry";import{getActiveGroupId as c,ensureZsxqAuth as m,ensureZsxqPage as n,fetchFirstJson as p,getTopicsFromResponse as u,toTopicRow as l}from"./utils.js";r({site:"zsxq",name:"topics",access:"read",description:"获取当前星球的话题列表",domain:"wx.zsxq.com",strategy:a.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:"Number of topics to return"},{name:"group_id",help:"Optional group id; defaults to the active group in Chrome"}],columns:["topic_id","type","author","title","comments","likes","time","url"],func:async(t,o)=>{await n(t);await m(t);const i=Math.max(1,Number(o.limit)||20),e=String(o.group_id||await c(t)),{data:s}=await p(t,[`https://api.zsxq.com/v2/groups/${e}/topics?scope=all&count=${i}`]);return u(s).slice(0,i).map(l)}});