publishport-opencli 1.0.0

package/clis/youtube/watch-later.js

@@ -0,0 +1,41 @@
+import{cli as s,Strategy as r}from"@jackwener/opencli/registry";import{FETCH_BROWSE_FN as c,extractPlaylistVideos as l}from"./utils.js";import{CommandExecutionError as n,EmptyResultError as d}from"@jackwener/opencli/errors";s({site:"youtube",name:"watch-later",access:"read",description:"Get your YouTube Watch Later queue",domain:"www.youtube.com",strategy:r.COOKIE,args:[{name:"limit",type:"int",default:50,help:"Max videos to return (default 50, max 200)"}],columns:["rank","title","channel","duration","views","published","url"],func:async(e,o)=>{const i=Math.min(o.limit||50,200);await e.goto("https://www.youtube.com/playlist?list=WL");await e.wait(3);const t=await e.evaluate(`
+      (async () => {
+        const d = window.ytInitialData;
+        if (!d) return { error: 'YouTube data not found — are you logged in?' };
+
+        const limit = ${i};
+        const cfg = window.ytcfg?.data_ || {};
+        const apiKey = cfg.INNERTUBE_API_KEY;
+        const context = cfg.INNERTUBE_CONTEXT;
+
+        const header = d.header?.playlistHeaderRenderer;
+        const title = header?.title?.simpleText || 'Watch Later';
+        const stats = (header?.stats || [])
+          .map(s => s.runs?.map(r => r.text)?.join('') || s.simpleText || '')
+          .filter(Boolean);
+
+        const tabs = d.contents?.twoColumnBrowseResultsRenderer?.tabs || [];
+        let listContents = tabs[0]?.tabRenderer?.content?.sectionListRenderer?.contents?.[0]?.itemSectionRenderer?.contents?.[0]?.playlistVideoListRenderer?.contents || [];
+
+        ${c}
+
+        const extractVideos = ${l.toString()};
+
+        let videos = extractVideos(listContents);
+
+        let contItem = listContents[listContents.length - 1];
+        while (videos.length < limit && contItem?.continuationItemRenderer && apiKey && context) {
+          const token = contItem.continuationItemRenderer?.continuationEndpoint?.continuationCommand?.token;
+          if (!token) break;
+          const contData = await fetchBrowse(apiKey, { context, continuation: token });
+          if (contData.error) break;
+          const newItems = contData.onResponseReceivedActions?.[0]?.appendContinuationItemsAction?.continuationItems || [];
+          if (!newItems.length) break;
+          videos = videos.concat(extractVideos(newItems));
+          contItem = newItems[newItems.length - 1];
+        }
+
+        return { title, stats, videos: videos.slice(0, limit) };
+      })()
+    `);if(!t||typeof t!=="object")throw new n("Failed to fetch Watch Later — make sure you are logged into YouTube");if(t.error)throw new n(String(t.error));if(!t.videos?.length)throw new d("youtube watch-later");const a=(t.stats||[]).join(" | ");process.stderr.write(`${t.title}  ${a}
+`);return t.videos}});

package/clis/yuanbao/ask.js

@@ -0,0 +1,145 @@
+import{cli as N,Strategy as U}from"@jackwener/opencli/registry";import{htmlToMarkdown as O}from"@jackwener/opencli/utils";import{ArgumentError as _,CommandExecutionError as h,TimeoutError as R}from"@jackwener/opencli/errors";import{YUANBAO_DOMAIN as Y,IS_VISIBLE_JS as Z,authRequired as H,isOnYuanbao as z,ensureYuanbaoPage as M,hasLoginGate as P,normalizeBooleanFlag as Q,sendYuanbaoMessage as k}from"./shared.js";const L=2,w=8000,C=3;function S(j,y){const q=y?` Detail: ${y}`:"";return new h(`${j||"Unknown Yuanbao send failure."}${q}`,"Make sure the Yuanbao chat composer is visible and ready before retrying.")}function I(j){return typeof j==="string"?j.trim():""}export function convertYuanbaoHtmlToMarkdown(j){return O(j,(y)=>{y.addRule("table",{filter:"table",replacement:(q)=>`
+
+${q}
+
+`});y.addRule("tableSection",{filter:["thead","tbody","tfoot"],replacement:(q)=>q});y.addRule("tableRow",{filter:"tr",replacement:(q,F)=>{const G=F,J=Array.from(G.children),W=G.parentElement?.tagName==="THEAD"||J.length>0&&J.every((X)=>X.tagName==="TH"),K=`${q}
+`;if(!W)return K;const V=`| ${J.map(()=>"---").join(" | ")} |
+`;return`${K}${V}`}});y.addRule("tableCell",{filter:["th","td"],replacement:(q,F)=>{const G=F;return`${(G.parentElement?Array.from(G.parentElement.children).indexOf(G):0)===0?"| ":" "}${q.trim()} |`}})})}export function sanitizeYuanbaoResponseText(j,y){let q=j.replace(/内容由AI生成，仅供参考/gi,"").replace(/重新回答/gi,"").trim();if(/^(正在搜索资料|搜索资料中|正在思考|思考中)[.。…]*$/u.test(q))return"";const F=y.trim();if(!F)return q;if(q===F)return"";for(const G of[`
+
+`,`
+`,`\r
+\r
+`,`\r
+`," "]){const J=`${F}${G}`;if(q.startsWith(J)){q=q.slice(J.length).trim();break}}return q}export function collectYuanbaoTranscriptAdditions(j,y,q){const F=new Set(j);return y.filter((J)=>!F.has(J)).map((J)=>sanitizeYuanbaoResponseText(J,q)).filter((J)=>J&&J!==q).join(`
+`).trim()}export function pickLatestYuanbaoAssistantCandidate(j,y,q){const F=j.slice(Math.max(0,y)).map((G)=>sanitizeYuanbaoResponseText(G,q)).filter(Boolean);for(let G=F.length-1;G>=0;G-=1)if(F[G]!==q.trim())return F[G];return""}export function updateStableState(j,y,q){if(!q)return{previousText:"",stableCount:0};if(q===j)return{previousText:j,stableCount:y+1};return{previousText:q,stableCount:0}}function A(){return`
+    (() => {
+      const clean = (value) => (value || '')
+        .replace(/\\u00a0/g, ' ')
+        .replace(/\\n{3,}/g, '\\n\\n')
+        .trim();
+
+      const root = (
+        document.querySelector('.agent-dialogue__content--common')
+        || document.querySelector('.agent-dialogue__content')
+        || document.querySelector('.agent-dialogue')
+        || document.body
+      ).cloneNode(true);
+
+      const removableSelectors = [
+        '.agent-dialogue__content--common__input',
+        '.agent-dialogue__tool',
+        '.agent-dialogue__content-copyright',
+        '.index_chatLandingBox__G7hAT',
+        '.index_chatLandingBoxMobile__J8i8v',
+        '.index_chatLandingHintList__M69Lr',
+        '.yb-nav',
+        '.agent-dialogue__content--common__input .ql-toolbar',
+        '.agent-dialogue__content--common__input .ql-container',
+        '.agent-dialogue__content--common__input .ql-editor',
+        '[role="dialog"]',
+        'iframe',
+        'button',
+        'script',
+        'style',
+        'noscript',
+      ];
+
+      for (const selector of removableSelectors) {
+        root.querySelectorAll(selector).forEach((node) => node.remove());
+      }
+
+      const stopLines = new Set([
+        '元宝',
+        'DeepSeek',
+        '深度思考',
+        '联网搜索',
+        '工具',
+        '登录',
+        '安装电脑版',
+        '内容由AI生成，仅供参考',
+        '有问题，尽管问，shift+enter换行',
+        '立即创建团队',
+        '微信',
+        '手机',
+        'QQ',
+        '微信扫码登录',
+        '扫码默认已阅读并同意',
+        '用户服务协议',
+        '隐私协议',
+      ]);
+
+      const noisyPatterns = [
+        /^支持文件格式[:：]/,
+        /^文件拖动到此处即可上传/,
+        /^下载元宝电脑版/,
+      ];
+
+      return clean(root.innerText || root.textContent || '')
+        .split('\\n')
+        .map((line) => clean(line))
+        .filter((line) => line
+          && line.length <= 4000
+          && !stopLines.has(line)
+          && !noisyPatterns.some((pattern) => pattern.test(line)));
+    })()
+  `}async function B(j){const y=await j.evaluate(A());return Array.isArray(y)?y.map(I).filter(Boolean):[]}async function E(j){const y=await j.evaluate(`(() => {
+    ${Z}
+
+    const roots = Array.from(document.querySelectorAll('.agent-chat__list__item--ai'))
+      .filter((node) => isVisible(node));
+
+    return roots.map((root) => {
+      const doneContent = root.querySelector('.hyc-content-md-done');
+      const markdownContent = doneContent || root.querySelector('.hyc-content-md');
+      const speechContent = root.querySelector('.agent-chat__speech-text');
+      const bubbleContent = root.querySelector('.agent-chat__bubble__content');
+      const content = markdownContent || speechContent || bubbleContent;
+
+      if (content instanceof HTMLElement) {
+        return content.innerHTML || content.textContent || '';
+      }
+
+      return root instanceof HTMLElement ? (root.innerHTML || root.textContent || '') : '';
+    }).filter(Boolean);
+  })()`);return Array.isArray(y)?y.map((q)=>convertYuanbaoHtmlToMarkdown(typeof q==="string"?q:"")).map(I).filter(Boolean):[]}async function f(j){return await j.evaluate(`(() => {
+    ${Z}
+
+    const button = Array.from(document.querySelectorAll('[dt-button-id="internet_search"]'))
+      .find((node) => isVisible(node));
+
+    if (!(button instanceof HTMLElement)) return { found: false, enabled: false };
+
+    const attr = button.getAttribute('dt-internet-search') || '';
+    const className = button.className || '';
+    return {
+      found: true,
+      enabled: attr === 'openInternetSearch' || className.includes('index_v2_active__'),
+    };
+  })()`)}async function v(j,y){const q=await f(j);if(!q.found||q.enabled===y)return;await j.evaluate(`(() => {
+    ${Z}
+
+    const button = Array.from(document.querySelectorAll('[dt-button-id="internet_search"]'))
+      .find((node) => isVisible(node));
+
+    if (button instanceof HTMLElement) button.click();
+  })()`);await j.wait(0.5)}async function b(j){return await j.evaluate(`(() => {
+    ${Z}
+
+    const button = Array.from(document.querySelectorAll('[dt-button-id="deep_think"]'))
+      .find((node) => isVisible(node));
+
+    if (!(button instanceof HTMLElement)) return { found: false, enabled: false };
+
+    const className = button.className || '';
+    return {
+      found: true,
+      enabled: className.includes('ThinkSelector_selected__'),
+    };
+  })()`)}async function T(j,y){const q=await b(j);if(!q.found||q.enabled===y)return;await j.evaluate(`(() => {
+    ${Z}
+
+    const button = Array.from(document.querySelectorAll('[dt-button-id="deep_think"]'))
+      .find((node) => isVisible(node));
+
+    if (button instanceof HTMLElement) button.click();
+  })()`);await j.wait(0.5)}async function c(j,y,q,F,G){const J=Date.now();let W="",K=0,V="";while(Date.now()-J<G*1000){await j.wait(L);if(await P(j))return"blocked";const X=await E(j),$=pickLatestYuanbaoAssistantCandidate(X,y,F)||collectYuanbaoTranscriptAdditions(q,await B(j),F);if(!$)continue;V=$;const D=updateStableState(W,K,$);W=D.previousText;K=D.stableCount;if(Date.now()-J>=w&&K>=C)return $}return V||null}export const askCommand=N({site:"yuanbao",name:"ask",access:"write",description:"Send a prompt to Yuanbao web chat and wait for the assistant response",domain:Y,strategy:U.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,defaultFormat:"plain",args:[{name:"prompt",required:!0,positional:!0,help:"Prompt to send"},{name:"timeout",type:"int",required:!1,help:"Max seconds to wait (default: 60)",default:60},{name:"search",type:"boolean",required:!1,help:"Enable Yuanbao internet search (default: true)",default:!0},{name:"think",type:"boolean",required:!1,help:"Enable Yuanbao deep thinking (default: false)",default:!1}],columns:["Role","Text"],func:async(j,y)=>{const{prompt:q,timeout:F}=y;if(!Number.isInteger(F)||F<1)throw new _("--timeout must be a positive integer (seconds)");const G=Q(y.search,!0),J=Q(y.think,!1);await M(j);if(await P(j))throw H("Yuanbao opened a login gate before sending the prompt.");await v(j,G);await T(j,J);const W=await E(j),K=await B(j),V=await k(j,q);if(!V?.ok){if(await P(j))throw H("Yuanbao opened a login gate instead of accepting the prompt.");throw S(V?.reason,V?.detail)}const X=await c(j,W.length,K,q,F);if(X==="blocked")throw H("Yuanbao opened a login gate instead of returning a chat response.");if(!X)throw new R("yuanbao ask",F,"No Yuanbao response was observed before the timeout. Retry with --timeout, and verify the current browser session is still interactive.");return[{Role:"User",Text:q},{Role:"Assistant",Text:X}]}}),__test__={collectYuanbaoTranscriptAdditions,convertYuanbaoHtmlToMarkdown,isOnYuanbao:z,normalizeBooleanFlag:Q,pickLatestYuanbaoAssistantCandidate,sanitizeYuanbaoResponseText,updateStableState};

package/clis/yuanbao/auth.js

@@ -0,0 +1,23 @@
+import{AuthRequiredError as t,CommandExecutionError as y}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as u}from"../_shared/site-auth.js";import{hasLoginGate as k,ensureYuanbaoPage as m,YUANBAO_DOMAIN as o,YUANBAO_URL as d}from"./shared.js";async function a(n){return(await n.getCookies({url:"https://yuanbao.tencent.com"})).some((e)=>e.name==="hy_user"&&e.value)}async function i(n){await m(n);if(await k(n))throw new t(o,"Yuanbao showed wx login gate — anonymous session");const e=(await n.getCookies({url:"https://yuanbao.tencent.com"})).find((r)=>r.name==="hy_user")?.value||"";if(!e)throw new t(o,"Yuanbao hy_user cookie missing — anonymous session");const c=await n.evaluate(`
+    (() => {
+      const bodyText = document.body?.innerText || '';
+      const nickMatch = bodyText.match(/用户[a-z0-9]{4,}/i);
+      const state = window.__INITIAL_STATE__ || {};
+      const seen = new Set();
+      const stack = [state];
+      let stateNick = '';
+      while (stack.length) {
+        const node = stack.pop();
+        if (!node || typeof node !== 'object' || seen.has(node)) continue;
+        seen.add(node);
+        if (Array.isArray(node)) { stack.push(...node); continue; }
+        const u = node.userInfo || node.user;
+        if (u && typeof u === 'object' && (u.nickname || u.nick)) {
+          stateNick = String(u.nickname || u.nick);
+          break;
+        }
+        for (const v of Object.values(node)) if (v && typeof v === 'object') stack.push(v);
+      }
+      return { nickname: stateNick || (nickMatch ? nickMatch[0] : '') };
+    })()
+  `);return{user_id:String(e),nickname:String(c.nickname||"")}}u({site:"yuanbao",domain:o,loginUrl:d,columns:["user_id","nickname"],quickCheck:a,verify:i,poll:async(n)=>{if(!await a(n))throw new t(o,"Waiting for Yuanbao hy_user cookie");return i(n)}});

package/clis/yuanbao/detail.js

@@ -0,0 +1 @@
+import{cli as $,Strategy as q}from"@jackwener/opencli/registry";import{EmptyResultError as x}from"@jackwener/opencli/errors";import{YUANBAO_DOMAIN as G,YUANBAO_URL as H,getYuanbaoMessageBubbles as V,parseYuanbaoSessionId as P,hasLoginGate as T,authRequired as f}from"./shared.js";import{convertYuanbaoHtmlToMarkdown as m}from"./ask.js";$({site:"yuanbao",name:"detail",access:"read",description:"Open a Yuanbao conversation by ID and read its messages",domain:G,strategy:q.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"id",positional:!0,required:!0,help:'Full https://yuanbao.tencent.com/chat/<agentId>/<convId> URL or "<agentId>/<convId>" pair (a UUID alone is not enough — Yuanbao requires the agent slug)'}],columns:["Role","Text"],func:async(C,Q)=>{const{agentId:J,convId:K}=P(Q.id);await C.goto(`${H}chat/${J}/${K}`,{waitUntil:"load",settleMs:2500});await C.wait(2);if(await T(C))throw f("Yuanbao opened a login gate when navigating to the conversation.");let F=[];const W=20000,X=1,Z=Date.now();while(Date.now()-Z<W){F=await V(C);if(F.length>0)break;await C.wait(X)}if(!F.length)throw new x("yuanbao detail",`No visible messages found for conversation ${J}/${K}. Verify the IDs are correct and that the session belongs to the current login.`);return F.map((z)=>({Role:z.role,Text:z.role==="Assistant"&&z.html?m(z.html).trim()||z.text:z.text}))}});

package/clis/yuanbao/history.js

@@ -0,0 +1 @@
+import{cli as o,Strategy as s}from"@jackwener/opencli/registry";import{ArgumentError as u,EmptyResultError as l}from"@jackwener/opencli/errors";import{YUANBAO_DOMAIN as d,YUANBAO_URL as c,ensureYuanbaoPage as h,getYuanbaoSessionList as m,hasLoginGate as g,authRequired as b}from"./shared.js";o({site:"yuanbao",name:"history",access:"read",description:"List recent Yuanbao conversations from the sidebar (requires login)",domain:d,strategy:s.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"limit",type:"int",default:20,help:"Max conversations to list (sidebar virtual scroll caps actual count)"}],columns:["Index","Title","AgentId","SessionId","Url"],func:async(t,r)=>{const i=Number(r.limit??20);if(!Number.isInteger(i)||i<=0)throw new u("limit","must be a positive integer");await h(t);if(await g(t))throw b("Yuanbao opened a login gate when reading the sidebar.");await t.wait(1.5);const a=await m(t,i);if(!a.length)throw new l("yuanbao history","No Yuanbao conversations found in the sidebar. Either the account is logged out, the sidebar is collapsed, or the user truly has no chat history yet.");return a.map((e,n)=>({Index:n+1,Title:e.title||"(untitled)",AgentId:e.agentId,SessionId:e.cid,Url:`${c}chat/${e.agentId}/${e.cid}`}))}});

package/clis/yuanbao/new.js

@@ -0,0 +1,16 @@
+import{cli as c,Strategy as s}from"@jackwener/opencli/registry";import{YUANBAO_DOMAIN as u,YUANBAO_URL as n,IS_VISIBLE_JS as l,authRequired as w,ensureYuanbaoPage as d,hasLoginGate as a}from"./shared.js";async function o(t){const e=await t.evaluate("window.location.href").catch(()=>"");return typeof e==="string"?e:""}async function f(t){const e=await t.evaluate(`(() => {
+    const composer = document.querySelector('.ql-editor, [contenteditable="true"]');
+    return composer ? (composer.textContent || '').trim() : '';
+  })()`);return typeof e==="string"?e.trim():""}async function m(t){await d(t);if(await a(t))return"blocked";const e=await o(t);if(await t.evaluate(`(() => {
+    ${l}
+
+    const trigger = Array.from(document.querySelectorAll('.yb-common-nav__trigger[data-desc="new-chat"]'))
+      .find((node) => isVisible(node));
+
+    if (trigger instanceof HTMLElement) {
+      trigger.click();
+      return 'clicked';
+    }
+
+    return 'navigate';
+  })()`)==="navigate"){await t.goto(n,{waitUntil:"load",settleMs:2500});await t.wait(1);if(await a(t))return"blocked";return"navigate"}await t.wait(1);if(await a(t))return"blocked";const i=await o(t),r=await f(t);if(i!==e||!r)return"clicked";await t.goto(n,{waitUntil:"load",settleMs:2500});await t.wait(1);return"navigate"}export const newCommand=c({site:"yuanbao",name:"new",access:"read",description:"Start a new conversation in Yuanbao web chat",domain:u,strategy:s.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[],columns:["Status","Action"],func:async(t)=>{const e=await m(t);if(e==="blocked")throw w("Yuanbao opened a login gate instead of starting a new chat.");return[{Status:"Success",Action:e==="navigate"?"Reloaded Yuanbao homepage as fallback":"Clicked New chat"}]}});

package/clis/yuanbao/read.js

@@ -0,0 +1 @@
+import{cli as C,Strategy as E}from"@jackwener/opencli/registry";import{YUANBAO_DOMAIN as F,ensureYuanbaoPage as G,getYuanbaoMessageBubbles as J}from"./shared.js";import{convertYuanbaoHtmlToMarkdown as K}from"./ask.js";C({site:"yuanbao",name:"read",access:"read",description:"Read messages in the current Yuanbao conversation",domain:F,strategy:E.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[],columns:["Role","Text"],func:async(q)=>{await G(q);await q.wait(1.5);const z=await J(q);if(!z.length)return[{Role:"system",Text:"No visible messages in the current Yuanbao conversation."}];return z.map((f)=>({Role:f.role,Text:f.role==="Assistant"&&f.html?K(f.html).trim()||f.text:f.text}))}});

package/clis/yuanbao/send.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as u,CommandExecutionError as m}from"@jackwener/opencli/errors";import{YUANBAO_DOMAIN as d,authRequired as o,ensureYuanbaoPage as l,hasLoginGate as r,normalizeBooleanFlag as c,sendYuanbaoMessage as w,startNewYuanbaoChat as f}from"./shared.js";s({site:"yuanbao",name:"send",access:"write",description:"Fire-and-forget: send a prompt to Yuanbao without waiting for the reply",domain:d,strategy:p.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"prompt",positional:!0,required:!0,help:"Prompt to send to Yuanbao"},{name:"new",type:"boolean",default:!1,help:"Start a new chat before sending"}],columns:["Status","Prompt"],func:async(t,n)=>{const a=String(n.prompt||"").trim();if(!a)throw new u("prompt","is required");const i=c(n.new,!1);await l(t);if(await r(t))throw o("Yuanbao opened a login gate before sending the prompt.");if(i){if(await f(t)==="blocked")throw o("Yuanbao opened a login gate while starting a new chat.")}const e=await w(t,a);if(!e?.ok){if(await r(t))throw o("Yuanbao opened a login gate instead of accepting the prompt.");throw new m(e?.reason||"Failed to send Yuanbao prompt",e?.detail?`Detail: ${e.detail}`:"Make sure the Yuanbao chat composer is visible and not in a disabled state.")}return[{Status:"sent",Prompt:a}]}});

package/clis/yuanbao/shared.js

@@ -0,0 +1,127 @@
+import{ArgumentError as j,AuthRequiredError as P}from"@jackwener/opencli/errors";export const YUANBAO_DOMAIN="yuanbao.tencent.com",YUANBAO_URL="https://yuanbao.tencent.com/";const W="Likely login/auth/challenge/session issue in the existing yuanbao.tencent.com browser session.",q=/^[A-Za-z0-9_-]{4,40}$/,H=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;export const IS_VISIBLE_JS=`const isVisible = (node) => {
+  if (!(node instanceof HTMLElement)) return false;
+  const rect = node.getBoundingClientRect();
+  const style = window.getComputedStyle(node);
+  return rect.width > 0
+    && rect.height > 0
+    && style.display !== 'none'
+    && style.visibility !== 'hidden';
+};`;export function authRequired(x){return new P(YUANBAO_DOMAIN,`${x} ${W}`)}export function normalizeBooleanFlag(x,F=!1){if(typeof x==="boolean")return x;if(x==null||x==="")return F;const K=String(x).trim().toLowerCase();return K==="true"||K==="1"||K==="yes"||K==="on"}export async function isOnYuanbao(x){const F=await x.evaluate("window.location.href").catch(()=>"");if(typeof F!=="string"||!F)return!1;try{const K=new URL(F).hostname;return K===YUANBAO_DOMAIN||K.endsWith(`.${YUANBAO_DOMAIN}`)}catch{return!1}}export async function ensureYuanbaoPage(x){if(!await isOnYuanbao(x)){await x.goto(YUANBAO_URL,{waitUntil:"load",settleMs:2500});await x.wait(1)}}export async function hasLoginGate(x){const F=await x.evaluate(`(() => {
+    const bodyText = document.body.innerText || '';
+    const hasWechatLoginText = bodyText.includes('微信扫码登录');
+    const hasWechatIframe = Array.from(document.querySelectorAll('iframe'))
+      .some((frame) => (frame.getAttribute('src') || '').includes('open.weixin.qq.com/connect/qrconnect'));
+
+    return hasWechatLoginText || hasWechatIframe;
+  })()`);return Boolean(F)}export async function isLoggedIn(x){return!await hasLoginGate(x)}export function parseYuanbaoSessionId(x){const F=String(x??"").trim();if(!F)throw new j("id",'must be a non-empty Yuanbao chat URL or "<agentId>/<convId>" pair');const K=F.match(/yuanbao\.tencent\.com\/chat\/([A-Za-z0-9_-]+)\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:[/?#]|$)/i);if(K){const[,X,$]=K;if(!q.test(X)||!H.test($))throw new j("id",`not a valid Yuanbao chat URL (got "${x}"); expected https://yuanbao.tencent.com/chat/<agentId>/<convId>`);return{agentId:X,convId:$.toLowerCase()}}const Z=F.match(/^([A-Za-z0-9_-]+)\/([0-9a-f-]{36})$/i);if(Z){const[,X,$]=Z;if(!q.test(X)||!H.test($))throw new j("id",`not a valid Yuanbao "<agentId>/<convId>" pair (got "${x}"); agentId must be 4-40 word chars, convId must be a UUID`);return{agentId:X,convId:$.toLowerCase()}}throw new j("id",`not a valid Yuanbao session reference (got "${x}"); pass either a full https://yuanbao.tencent.com/chat/<agentId>/<convId> URL or a bare "<agentId>/<convId>" pair. A UUID alone is not enough — Yuanbao requires the agentId.`)}export async function getCurrentYuanbaoSessionId(x){const F=await x.evaluate("window.location.href").catch(()=>"");if(typeof F!=="string")return null;const K=F.match(/yuanbao\.tencent\.com\/chat\/([A-Za-z0-9_-]+)\/([0-9a-f-]{36})(?:[/?#]|$)/i);if(!K)return null;const[,Z,X]=K;if(!q.test(Z)||!H.test(X))return null;return{agentId:Z,convId:X.toLowerCase()}}export async function getYuanbaoModelLabel(x){const F=await x.evaluate(`(() => {
+    const btn = document.querySelector('[dt-button-id="model_switch"]');
+    if (!(btn instanceof HTMLElement)) return null;
+    const label = (btn.querySelector('.t-button__text')?.textContent || btn.textContent || '').trim();
+    const modelId = btn.getAttribute('dt-model-id') || '';
+    return { label, modelId };
+  })()`);if(!F||typeof F!=="object")return{label:null,modelId:null};return{label:typeof F.label==="string"&&F.label?F.label:null,modelId:typeof F.modelId==="string"&&F.modelId?F.modelId:null}}export async function getYuanbaoMessageBubbles(x){const F=await x.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const items = Array.from(document.querySelectorAll('.agent-chat__list__item--human, .agent-chat__list__item--ai'))
+      .filter((node) => isVisible(node));
+    return items.map((node, positional) => {
+      const isAi = node.classList.contains('agent-chat__list__item--ai');
+      const role = isAi ? 'Assistant' : 'User';
+      const id = node.getAttribute('data-conv-id') || ('pos-' + positional + (isAi ? '-ai' : '-human'));
+      const idx = Number(node.getAttribute('data-conv-idx') || positional + 1);
+      const contentNode = isAi
+        ? (node.querySelector('.hyc-content-md-done')
+          || node.querySelector('.hyc-content-md')
+          || node.querySelector('.agent-chat__speech-text')
+          || node.querySelector('.agent-chat__bubble__content'))
+        : (node.querySelector('.hyc-component-text .hyc-content-text')
+          || node.querySelector('.hyc-content-text')
+          || node.querySelector('.agent-chat__bubble__content'));
+      const html = contentNode instanceof HTMLElement ? (contentNode.innerHTML || '') : '';
+      const rawText = contentNode instanceof HTMLElement
+        ? (contentNode.innerText || contentNode.textContent || '')
+        : ((node.innerText || node.textContent) || '');
+      return {
+        id,
+        idx,
+        role,
+        text: String(rawText || '').replace(/\\u00a0/g, ' ').trim(),
+        html,
+      };
+    });
+  })()`);if(!Array.isArray(F))return[];return F.map((K)=>({id:String(K?.id||""),idx:Number.isInteger(K?.idx)?K.idx:0,role:K?.role==="Assistant"?"Assistant":"User",text:String(K?.text||"").trim(),html:String(K?.html||"")})).filter((K)=>K.id&&(K.text||K.html))}export async function getYuanbaoSessionList(x,F){const K=Number(F??20);if(!Number.isInteger(K)||K<=0)throw new j("limit","must be a positive integer");const Z=await x.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const nodes = Array.from(document.querySelectorAll('.yb-recent-conv-list__item'))
+      .filter((node) => isVisible(node));
+    return nodes.map((node) => {
+      const cid = node.getAttribute('dt-cid') || '';
+      const agentId = node.getAttribute('dt-agent-id') || '';
+      const titleEl = node.querySelector('[data-item-name]');
+      const title = (titleEl?.getAttribute('data-item-name') || titleEl?.textContent || '').trim();
+      return { cid, agentId, title };
+    });
+  })()`);if(!Array.isArray(Z))return[];return Z.map((X)=>({cid:String(X?.cid||"").toLowerCase(),agentId:String(X?.agentId||""),title:String(X?.title||"").trim()})).filter((X)=>H.test(X.cid)&&q.test(X.agentId)).slice(0,K)}export async function startNewYuanbaoChat(x){await ensureYuanbaoPage(x);if(await hasLoginGate(x))return"blocked";const F=await x.evaluate("window.location.href").catch(()=>"");if(await x.evaluate(`(() => {
+    ${IS_VISIBLE_JS}
+    const trigger = Array.from(document.querySelectorAll('.yb-common-nav__trigger[data-desc="new-chat"], [dt-button-id="new_temp_chat"]'))
+      .find((node) => isVisible(node));
+    if (trigger instanceof HTMLElement) {
+      trigger.click();
+      return 'clicked';
+    }
+    return 'navigate';
+  })()`)==="navigate"){await x.goto(YUANBAO_URL,{waitUntil:"load",settleMs:2500});await x.wait(1);return await hasLoginGate(x)?"blocked":"navigate"}await x.wait(1);if(await hasLoginGate(x))return"blocked";const Z=await x.evaluate("window.location.href").catch(()=>"");if(typeof Z==="string"&&typeof F==="string"&&Z!==F)return"clicked";await x.goto(YUANBAO_URL,{waitUntil:"load",settleMs:2500});await x.wait(1);return"navigate"}export async function sendYuanbaoMessage(x,F){return await x.evaluate(`(async () => {
+    const waitFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    ${IS_VISIBLE_JS}
+
+    const composer = Array.from(document.querySelectorAll('.ql-editor[contenteditable="true"], .ql-editor, [contenteditable="true"]'))
+      .find(isVisible);
+
+    if (!(composer instanceof HTMLElement)) {
+      return {
+        ok: false,
+        reason: 'Yuanbao composer was not found.',
+      };
+    }
+
+    try {
+      composer.focus();
+      const selection = window.getSelection();
+      const range = document.createRange();
+      range.selectNodeContents(composer);
+      range.collapse(false);
+      selection?.removeAllRanges();
+      selection?.addRange(range);
+      composer.textContent = '';
+      document.execCommand('insertText', false, ${JSON.stringify(F)});
+      composer.dispatchEvent(new InputEvent('input', { bubbles: true, data: ${JSON.stringify(F)}, inputType: 'insertText' }));
+    } catch (error) {
+      return {
+        ok: false,
+        reason: 'Failed to insert the prompt into the Yuanbao composer.',
+        detail: error instanceof Error ? error.message : String(error),
+      };
+    }
+
+    const findEnabledSubmit = () => Array.from(document.querySelectorAll('a[class*="send-btn"], button[class*="send-btn"]'))
+      .find((node) => {
+        if (!(node instanceof HTMLElement) || !isVisible(node)) return false;
+        const className = typeof node.className === 'string' ? node.className : '';
+        return !className.includes('send-btn--disabled') && !className.includes('disabled');
+      });
+
+    let submit = null;
+    const deadline = Date.now() + 3_000;
+    while (Date.now() < deadline) {
+      submit = findEnabledSubmit();
+      if (submit) break;
+      await waitFor(150);
+    }
+
+    if (submit instanceof HTMLElement) {
+      submit.click();
+      return { ok: true, action: 'click' };
+    }
+
+    composer.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+    composer.dispatchEvent(new KeyboardEvent('keyup', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+    return { ok: true, action: 'enter' };
+  })()`)}

package/clis/yuanbao/status.js

@@ -0,0 +1 @@
+import{cli as F,Strategy as G}from"@jackwener/opencli/registry";import{YUANBAO_DOMAIN as H,ensureYuanbaoPage as J,isLoggedIn as K,getCurrentYuanbaoSessionId as Q,getYuanbaoModelLabel as R}from"./shared.js";F({site:"yuanbao",name:"status",access:"read",description:"Check Yuanbao page availability, login state, current session and model",domain:H,strategy:G.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[],columns:["Status","Login","Model","ModelId","AgentId","SessionId","Url"],func:async(q)=>{await J(q);await q.wait(1.5);const[E,v,x,z]=await Promise.all([K(q),Q(q),R(q),q.evaluate("window.location.href").catch(()=>"")]);return[{Status:"Connected",Login:E?"Yes":"No (login gate)",Model:x.label,ModelId:x.modelId,AgentId:v?.agentId??null,SessionId:v?.convId??null,Url:typeof z==="string"?z:""}]}});

package/clis/yuque/article.js

@@ -0,0 +1 @@
+import{CliError as W,CommandExecutionError as n}from"@jackwener/opencli/errors";import{cli as R,Strategy as m}from"@jackwener/opencli/registry";import{publishArticle as w}from"../_shared/article/publish.js";export const yuqueProfile={home:"https://www.yuque.com/dashboard",outputFormat:"markdown",preprocessConfig:null,image:null,publish:async(X,K)=>{const $=K.cookie("yuque_ctoken");if(!$)return{ok:!1,stage:"auth",message:"未检测到语雀登录态，请先在 Chrome 中登录语雀（缺少 yuque_ctoken cookie）"};const L={"Content-Type":"application/json","x-csrf-token":$},q=await fetch("https://www.yuque.com/api/mine/common_used",{method:"GET",credentials:"include",headers:L});let G=null;try{G=await q.json()}catch(z){}if(!q.ok||!G?.data?.books?.length)return{ok:!1,stage:"auth",status:q.status,message:"无法获取语雀知识库列表，请确认已登录语雀"};const Q=G.data.books[0].target_id,A=await fetch("https://www.yuque.com/api/docs",{method:"POST",credentials:"include",headers:L,body:JSON.stringify({title:X.title,type:"Doc",format:"lake",book_id:Q,status:0})});let V=null;try{V=await A.json()}catch(z){}if(!A.ok||!V?.data?.id)return{ok:!1,stage:"create",status:A.status,message:V?.message||"创建语雀草稿文档失败"};const J=V.data.id,H="https://www.yuque.com/go/doc/"+J+"/edit";let F=X.content;const N=["yuque.com","cdn.nlark.com"],j=/!\[([^\]]*)\]\(\s*<?([^)\s>]+)>?\s*\)/g,O=[];let S;while((S=j.exec(F))!==null)O.push({full:S[0],alt:S[1],src:S[2]});const _=[],B=[],D="https://www.yuque.com/api/upload/attach?attachable_type=Doc&attachable_id="+J+"&type=image";for(let z=0;z<O.length;z++){const Y=O[z],Z=Y.src;if(!Z)continue;if(Z.indexOf("data:")===0)continue;if(N.some(function(M){return Z.indexOf(M)!==-1}))continue;try{const M=await fetch(Z,{credentials:"omit"});if(!M.ok)throw Error("图片下载失败 HTTP "+M.status);const I=await M.blob(),C=new FormData;C.append("file",I,"image.jpg");const T=await fetch(D,{method:"POST",credentials:"include",headers:{"x-csrf-token":$},body:C});let h=null;try{h=await T.json()}catch(u){}if(!T.ok||!h?.data?.url)throw Error(h&&h.message||"图片上传失败 HTTP "+T.status);const b=h.data.url;F=F.split(Y.full).join("!["+Y.alt+"]("+b+")");_.push({src:Z.slice(0,120),url:b})}catch(M){B.push({src:Z.slice(0,120),error:String(M&&M.message||M)})}}const P=await fetch("https://www.yuque.com/api/docs/convert",{method:"POST",credentials:"include",headers:L,body:JSON.stringify({from:"markdown",to:"lake",content:F})});let U=null;try{U=await P.json()}catch(z){}if(!P.ok||!U?.data?.content)return{ok:!1,stage:"convert",status:P.status,message:"内容格式转换失败（markdown→lake）",id:String(J),uploaded:_,failed:B};const E=U.data.content,v='<div class="lake-content" typography="traditional">'+E+"</div>",x=await fetch("https://www.yuque.com/api/docs/"+J+"/content",{method:"PUT",credentials:"include",headers:L,body:JSON.stringify({format:"lake",body_asl:E,body:v,body_html:v,draft_version:0,sync_dynamic_data:!1,save_type:"auto",edit_type:"Lake"})});if(!x.ok){let z="";try{z=await x.text()}catch(Y){}return{ok:!1,stage:"save",status:x.status,message:"保存正文失败："+z.slice(0,300),id:String(J),uploaded:_,failed:B}}if(!X.draftOnly){const z=await fetch("https://www.yuque.com/api/docs/"+J+"/publish",{method:"PUT",credentials:"include",headers:L,body:JSON.stringify({status:1})});if(!z.ok){let Y="";try{Y=await z.text()}catch(Z){}return{ok:!1,stage:"publish",status:z.status,message:"发布失败："+Y.slice(0,300),id:String(J),url:H,uploaded:_,failed:B}}}return{ok:!0,id:String(J),url:H,draft:Boolean(X.draftOnly),uploaded:_,failed:B}}};R({site:"yuque",name:"article",access:"write",description:"发布语雀文章（知识库文档）。正文默认为 Markdown，外链图片自动转存到语雀图床。",domain:"www.yuque.com",strategy:m.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题"},{name:"text",positional:!0,help:"文章正文（Markdown 格式；或用 --file 读文件）"},{name:"file",help:"正文文件路径（UTF-8，Markdown 格式）"},{name:"html",type:"boolean",help:"把正文当 HTML 输入（语雀仍转 lake 发布）"},{name:"draft",type:"boolean",help:"仅保存草稿，不发布"},{name:"execute",type:"boolean",help:"实际执行写操作。不加此参数命令拒绝写入。"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(X,K)=>{if(!X)throw new n("语雀文章发布需要浏览器会话");if(!K.execute)throw new W("INVALID_INPUT","此命令需要加 --execute 才会实际写入（防误操作）");const $=String(K.title??"").trim();if(!$)throw new W("INVALID_INPUT","文章标题不能为空");let L="";const q=typeof K.text==="string"?K.text:void 0,G=typeof K.file==="string"?K.file:void 0;if(q&&G)throw new W("INVALID_INPUT","正文和 --file 不能同时使用");if(G){const{readFile:F,stat:N}=await import("node:fs/promises");let j;try{j=await N(G)}catch{throw new W("INVALID_INPUT",`文件不存在：${G}`)}if(!j.isFile())throw new W("INVALID_INPUT",`路径不是文件：${G}`);let O;try{O=await F(G)}catch{throw new W("INVALID_INPUT",`文件无法读取：${G}`)}try{L=new TextDecoder("utf-8",{fatal:!0}).decode(O)}catch{throw new W("INVALID_INPUT",`文件无法以 UTF-8 解码：${G}`)}}else L=q??"";if(!L.trim())throw new W("INVALID_INPUT","正文不能为空");const y=Boolean(K.draft),Q=await w(X,{title:$,body:L,format:K.html?"html":"markdown",draftOnly:y,profile:yuqueProfile}),A=Q.images.uploaded.length|0,V=Q.images.failed.length|0;let J=Q.draft?"已保存语雀草稿":"语雀文章发布成功";if(A||V)J+=`（图片：${A} 张已转存${V?`，${V} 张失败`:""}）`;return[{status:"success",outcome:Q.draft?"draft":"created",message:J,target_type:"article",target:"",created_target:"article:"+Q.id,created_url:Q.url}]}});

package/clis/yuque/whoami.js

@@ -0,0 +1 @@
+import{cli as B,Strategy as C}from"@jackwener/opencli/registry";import{checkLogin as D}from"../_shared/article/auth.js";const yuqueAuthProfile={home:"https://www.yuque.com/dashboard",checkAuth:async(v)=>{const m=v.cookie("yuque_ctoken");if(!m)return{isAuthenticated:!1,error:"未检测到 yuque_ctoken cookie，请先登录语雀"};try{const b=await fetch("https://www.yuque.com/api/mine/common_used",{method:"GET",credentials:"include",headers:{"x-csrf-token":m}});if(!b.ok)return{isAuthenticated:!1,error:"接口返回 HTTP "+b.status};let x=null;try{x=await b.json()}catch(E){}if(!x?.data?.books?.length)return{isAuthenticated:!1,error:"未获取到语雀知识库信息"};const z=x.data.books[0].user;return{isAuthenticated:!0,userId:String(z.id),username:z.name,avatar:z.avatar_url||""}}catch(b){return{isAuthenticated:!1,error:String(b&&b.message||b)}}}};B({site:"yuque",name:"whoami",access:"read",description:"查看当前语雀登录账号信息。",domain:"www.yuque.com",strategy:C.COOKIE,browser:!0,columns:["logged_in","user_id","username"],func:async(v)=>{const m=await D(v,yuqueAuthProfile);return[{logged_in:m.isAuthenticated,user_id:m.userId||"",username:m.username||""}]}});export{yuqueAuthProfile};

package/clis/zhihu/answer-comments.js

@@ -0,0 +1,11 @@
+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: opencli 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(`
+      (async () => {
+        const r = await fetch(${JSON.stringify(u)}, { credentials: 'include' });
+        if (!r.ok) return { __httpError: r.status };
+        try {
+          return await r.json();
+        } catch (error) {
+          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};

package/clis/zhihu/answer-detail.js

@@ -0,0 +1,11 @@
+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: opencli 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(`
+      (async () => {
+        const r = await fetch(${JSON.stringify(k)}, { credentials: 'include' });
+        if (!r.ok) return { __httpError: r.status };
+        try {
+          return await r.json();
+        } catch (error) {
+          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};

package/clis/zhihu/answer.js

@@ -0,0 +1,15 @@
+import{CliError as Q,CommandExecutionError as V}from"@jackwener/opencli/errors";import{cli as W,Strategy as X}from"@jackwener/opencli/registry";import{markdownToHtml as Y}from"../_shared/article/format.js";import{assertAllowedKinds as Z,parseTarget as $}from"./target.js";import{buildResultRow as b,requireExecute as f,resolveCurrentUserIdentity as q,resolvePayload as A}from"./write-shared.js";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.",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(z,D)=>{if(!z)throw new V("Browser session required for zhihu answer");f(D);const G=String(D.target),B=Z("answer",$(G)),J=await A(D),N=D.html?J:Y(J);await z.goto(B.url);await z.wait(3);const O=await q(z),F=await z.evaluate(`(async () => {
+            var questionId = ${JSON.stringify(B.id)};
+            var content = ${JSON.stringify(N)};
+            var url = 'https://www.zhihu.com/api/v4/questions/' + questionId + '/answers';
+            var resp = await fetch(url, {
+                method: 'POST',
+                credentials: 'include',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ content: content, reshipment_settings: 'disallowed' }),
+            });
+            var data = await resp.json();
+            if (!resp.ok) return { ok: false, status: resp.status, message: data.error ? data.error.message : 'unknown error' };
+            if (!data || !data.id) return { ok: false, status: resp.status, message: 'Answer API response did not include a created answer id' };
+            return { ok: true, id: String(data.id), url: data.url || ('https://www.zhihu.com/question/' + questionId + '/answer/' + data.id) };
+        })()`);if(!F?.ok)throw new Q("COMMAND_EXEC",F?.message||"Failed to create answer");return b(`Answered question ${B.id}`,B.kind,G,"created",{created_target:"answer:"+B.id+":"+F.id,created_url:F.url,author_identity:O})}});

package/clis/zhihu/article-transform.js

@@ -0,0 +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};

package/clis/zhihu/article.js

@@ -0,0 +1,7 @@
+import{CliError as H,CommandExecutionError as m}from"@jackwener/opencli/errors";import{cli as v,Strategy as R}from"@jackwener/opencli/registry";import{buildResultRow as h,requireExecute as f,resolvePayload as T}from"./write-shared.js";import{publishArticle as x}from"../_shared/article/publish.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:{skip:["zhimg.com"],uploadFn:async(J,M)=>{if(J.indexOf("data:")!==0){const V=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":M.xsrf()},body:new URLSearchParams({url:J,source:"article"})}),S=await V.text();let $=null;try{$=JSON.parse(S)}catch(N){}if(!V.ok||!$||!$.src)throw Error("URL 转存失败: HTTP "+V.status+" "+S.slice(0,150));return{url:$.src}}const W=M.dataUriToBlob(J),Z=await W.arrayBuffer(),O=M.md5(Z),Y=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:O,source:"article"})}),L=await Y.text();let U=null;try{U=JSON.parse(L)}catch(V){}if(!Y.ok||!U||!U.upload_file)throw Error("获取上传凭证失败: HTTP "+Y.status+" "+L.slice(0,150));const Q=U.upload_file;if(Q.state===1){for(let V=0;V<10;V++){const $=await(await fetch("https://api.zhihu.com/images/"+Q.image_id,{credentials:"include",headers:{"x-requested-with":"fetch"}})).json();if($&&($.status==="completed"||$.original_hash))return{url:"https://pic4.zhimg.com/"+$.original_hash};await new Promise((N)=>setTimeout(N,1000))}throw Error("图片处理超时（image_id="+Q.image_id+"）")}const G=U.upload_token;if(!G||!G.access_id||!G.access_key||!G.access_token)throw Error("上传凭证响应无效: "+L.slice(0,150));const X=W.type||"application/octet-stream",q=new Date().toUTCString(),A={"x-oss-date":q,"x-oss-security-token":G.access_token,"x-oss-user-agent":"aliyun-sdk-js/6.8.0"},_=Object.keys(A).sort().map((V)=>V+":"+A[V]).join(`
+`),B=`PUT
+
+`+X+`
+`+q+`
+`+_+`
+/zhihu-pics/`+Q.object_key,z=new TextEncoder().encode(G.access_key),C=await crypto.subtle.importKey("raw",z,{name:"HMAC",hash:"SHA-1"},!1,["sign"]),F=await crypto.subtle.sign("HMAC",C,new TextEncoder().encode(B)),j=btoa(String.fromCharCode.apply(null,Array.from(new Uint8Array(F)))),E=await fetch("https://zhihu-pics-upload.zhimg.com/"+Q.object_key,{method:"PUT",headers:{"Content-Type":X,Authorization:"OSS "+G.access_id+":"+j,"x-oss-date":q,"x-oss-security-token":G.access_token,"x-oss-user-agent":"aliyun-sdk-js/6.8.0"},body:W});if(!E.ok){const V=await E.text();throw Error("OSS 上传失败: HTTP "+E.status+" "+V.slice(0,150))}let K=Q.object_key;if(W.type==="image/gif")K=K+".gif";return{url:"https://pic4.zhimg.com/"+K}}},publish:async(J,M)=>{let W=J.content;W=W.replace(/<img([^>]+?)\/?>/gi,"<figure><img$1></figure>");const Z=J.params&&typeof J.params.cover==="string"?J.params.cover.trim():"";if(Z&&Z.indexOf("zhimg.com")===-1)return{ok:!1,stage:"cover",message:"题图必须是知乎图床（zhimg.com）地址，转存未生效："+Z.slice(0,120)};const Y={"Content-Type":"application/json","x-requested-with":"fetch","x-xsrftoken":M.xsrf()},L="https://zhuanlan.zhihu.com/api/articles",U=await fetch(L+"/drafts",{method:"POST",credentials:"include",headers:Y,body:JSON.stringify({title:J.title})}),Q=await U.text();let G=null;try{G=JSON.parse(Q)}catch(C){}if(!U.ok||!G||!G.id)return{ok:!1,stage:"create",status:U.status,message:Q.slice(0,300)};const X=String(G.id),q={title:J.title,content:W,table_of_contents:!1,delta_time:30};if(Z){q.titleImage=Z;q.isTitleImageFullScreen=!1}const A=await fetch(L+"/"+X+"/draft",{method:"PATCH",credentials:"include",headers:Y,body:JSON.stringify(q)});if(!A.ok){const C=await A.text();return{ok:!1,stage:"update",status:A.status,message:C.slice(0,300),id:X}}if(J.draftOnly)return{ok:!0,draft:!0,id:X,url:"https://zhuanlan.zhihu.com/p/"+X+"/edit"};const _=await fetch(L+"/"+X+"/publish",{method:"PUT",credentials:"include",headers:Y,body:JSON.stringify({})}),B=await _.text();let z=null;try{z=JSON.parse(B)}catch(C){}if(!_.ok)return{ok:!1,stage:"publish",status:_.status,message:B.slice(0,300),id:X};return{ok:!0,draft:!1,id:X,url:z&&z.url||"https://zhuanlan.zhihu.com/p/"+X}}};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:R.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(J,M)=>{if(!J)throw new m("Browser session required for zhihu article");f(M);const W=String(M.title??"").trim();if(!W)throw new H("INVALID_INPUT","Article title cannot be empty");const Z=await T(M),O=Boolean(M.draft),Y=typeof M.cover==="string"?M.cover.trim():"",L=await x(J,{title:W,body:Z,format:M.html?"html":"markdown",draftOnly:O,profile:zhihuProfile,publishParams:Y?{cover:Y}:null}),U=L.images.uploaded.length|0,Q=L.images.failed.length|0;let G=L.draft?"Saved article draft":"Published article";if(U||Q)G+=` · images: ${U} rehosted${Q?`, ${Q} failed`:""}`;return h(G,"article","",L.draft?"draft":"created",{created_target:"article:"+L.id,created_url:L.url})}});

package/clis/zhihu/auth.js

@@ -0,0 +1,11 @@
+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(`
+    (async () => {
+      try {
+        const r = await fetch('https://www.zhihu.com/api/v4/me?include=url_token', { credentials: 'include' });
+        if (!r.ok) return { __httpError: r.status };
+        return await r.json();
+      } catch (e) {
+        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)}});

package/clis/zhihu/collection.js

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

package/clis/zhihu/collections.js

@@ -0,0 +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: opencli zhihu collections --limit 20");return D}async function K(B,V,D){const z=await B.evaluate(`
+    (async () => {
+      const r = await fetch(${JSON.stringify(V)}, { 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};

package/clis/zhihu/comment.js

@@ -0,0 +1,17 @@
+import{CliError as s,CommandExecutionError as u}from"@jackwener/opencli/errors";import{cli as d,Strategy as m}from"@jackwener/opencli/registry";import{assertAllowedKinds as c,parseTarget as l}from"./target.js";import{buildResultRow as p,requireExecute as h,resolveCurrentUserIdentity as w,resolvePayload as y}from"./write-shared.js";d({site:"zhihu",name:"comment",access:"write",description:"Create a top-level comment on a Zhihu answer or article",domain:"zhihu.com",strategy:m.COOKIE,browser:!0,args:[{name:"target",positional:!0,required:!0,help:"Zhihu target URL or typed target"},{name:"text",positional:!0,help:"Comment text"},{name:"file",help:"Comment text file path"},{name:"execute",type:"boolean",help:"Actually perform the write action"}],columns:["status","outcome","message","target_type","target","author_identity","created_url"],func:async(e,r)=>{if(!e)throw new u("Browser session required for zhihu comment");h(r);const o=String(r.target),t=c("comment",l(o)),i=await y(r);await e.goto(t.url);await e.wait(3);const n=await w(e),a=await e.evaluate(`(async () => {
+            var targetKind = ${JSON.stringify(t.kind)};
+            var targetId = ${JSON.stringify(t.id)};
+            var content = ${JSON.stringify(i)};
+            var resourceType = targetKind === 'answer' ? 'answers' : 'articles';
+            var url = 'https://www.zhihu.com/api/v4/' + resourceType + '/' + targetId + '/comments';
+            var resp = await fetch(url, {
+                method: 'POST',
+                credentials: 'include',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ content: content }),
+            });
+            var data = await resp.json();
+            if (!resp.ok) return { ok: false, status: resp.status, message: data.error ? data.error.message : 'unknown error' };
+            if (!data || !data.id) return { ok: false, status: resp.status, message: 'Comment API response did not include a created comment id' };
+            return { ok: true, id: data.id, url: data.url };
+        })()`);if(!a?.ok)throw new s("COMMAND_EXEC",a?.message||"Failed to create comment");return p(`Commented on ${t.kind} ${t.id}`,t.kind,o,"created",{author_identity:n,created_url:a.url||""})}});