publishport-opencli 1.0.0

package/clis/hashnode/auth.js

@@ -0,0 +1,11 @@
+import{AuthRequiredError as z}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as G}from"../_shared/site-auth.js";const B="https://hashnode.com",J="https://hashnode.com/api/auth/session";function K(v){return v==="hashnode-session"||/(authjs|next-auth)\.session-token$/.test(v)}async function D(v){return(await v.getCookies({url:B})).some((y)=>K(y.name)&&y.value)}async function F(v){await v.goto(B);const x=await v.evaluate(`(async () => {
+    try {
+      var r = await fetch(${JSON.stringify(J)}, { credentials: 'include', headers: { Accept: 'application/json' } });
+      if (r.status === 401 || r.status === 403) return { ok: false, reason: 'HTTP ' + r.status };
+      var text = await r.text();
+      var j = null; try { j = JSON.parse(text); } catch (e) { return { ok: false, reason: 'non-JSON session' }; }
+      var u = j && j.user;
+      if (!u || !u.username) return { ok: false, reason: 'anonymous' };
+      return { ok: true, id: String(u.id || ''), username: String(u.username || ''), name: String(u.name || ''), email: String(u.email || '') };
+    } catch (e) { return { ok: false, reason: String(e && e.message || e) }; }
+  })()`);if(!x||!x.ok)throw new z("hashnode.com",`Not logged in (${x?x.reason:"no probe"})`);return{user_id:x.id,username:x.username,name:x.name}}G({site:"hashnode",domain:"hashnode.com",loginUrl:"https://hashnode.com/onboard",columns:["user_id","username","name"],loginDescription:"打开 Hashnode 登录页并等待浏览器完成登录（供桌面客户端引导登录）。",quickCheck:D,verify:F,poll:async(v)=>{if(!await D(v))throw new z("hashnode.com","Waiting for hashnode.com session cookie");return F(v)}});

package/clis/hashnode/publish.js

@@ -0,0 +1,92 @@
+import*as M from"node:fs";import{cli as I,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as _,AuthRequiredError as b,CommandExecutionError as V}from"@jackwener/opencli/errors";import{assertLiteralContent as O}from"../_shared/content-guard.js";const j="https://hashnode.com";export function resolveBody(z){if(z["body-file"]){const D=String(z["body-file"]);if(!M.statSync(D,{throwIfNoEntry:!1})?.isFile())throw new _(`--body-file not found: ${D}`);return M.readFileSync(D,"utf8")}if(z.body!==void 0&&z.body!==null){O(String(z.body),{fileFlag:"--body-file"});return String(z.body)}return}export function resolveTags(z){if(z===void 0||z===null||z==="")return[];return[...new Set(String(z).split(",").map((D)=>D.trim()).filter(Boolean))]}const h=`(async () => {
+  if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
+  try {
+    var r = await fetch('/api/auth/session', { credentials: 'include', headers: { Accept: 'application/json' } });
+    var j = await r.json().catch(function(){ return null; });
+    var u = j && j.user;
+    return u && u.username ? { ok: true, username: String(u.username) } : { ok: false };
+  } catch (e) { return { drift: true, err: String(e && e.message || e) }; }
+})()`;async function W(z,D,{tries:Y=8,label:Z="eval",anchor:$=j}={}){let q;for(let B=0;B<Y;B+=1){let F;try{F=await z.evaluate(D)}catch(G){F={drift:!0,err:String(G&&G.message||G)}}q=F;if(F&&F.drift){await z.goto($);await z.wait(2);continue}return F}throw new V(`Hashnode ${Z}: browser tab kept drifting (last: ${JSON.stringify(q)})`)}I({site:"hashnode",name:"publish",access:"write",description:"Publish a Hashnode post via the web editor (or save a draft with --draft). Markdown body + tags/cover/canonical.",domain:"hashnode.com",strategy:S.COOKIE,browser:!0,defaultWindowMode:"foreground",siteSession:"persistent",args:[{name:"title",type:"string",required:!0,help:"Post title"},{name:"body",type:"string",required:!1,help:"Post body in Markdown (or use --body-file)"},{name:"body-file",type:"string",required:!1,help:"Path to a Markdown file for the body"},{name:"tags",type:"string",required:!1,help:"Comma-separated tag names"},{name:"cover-image",type:"string",required:!1,help:"Cover image URL"},{name:"canonical-url",type:"string",required:!1,help:"Canonical / original article URL"},{name:"draft",type:"boolean",required:!1,default:!1,help:"Save as draft instead of publishing"}],columns:["status","draft_id","url"],func:async(z,D)=>{if(!z)throw new V("Browser session required for hashnode publish");const Y=String(D.title??"").trim();if(!Y)throw new _("hashnode publish: --title is required");const Z=resolveBody(D);if(Z===void 0)throw new _("--body or --body-file is required");const $=resolveTags(D.tags),q=D["canonical-url"]?String(D["canonical-url"]):"",B=D["cover-image"]?String(D["cover-image"]):"";await z.goto(j);const F=await W(z,h,{label:"auth"});if(!F||!F.ok)throw new b("hashnode.com","Not logged in. Run `opencli hashnode login`.");const G=await W(z,`(async () => {
+      if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
+      const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+      const w = [...document.querySelectorAll('a,button')].find((e) => (e.innerText || '').trim() === 'Write');
+      if (!w) return { ok: false, reason: 'no Write button (need a publication first?)' };
+      w.click();
+      let t = 0;
+      while (t < 18000) { await sleep(500); t += 500; if (location.href.indexOf('/draft/') >= 0) break; }
+      const m = location.href.match(/\\/draft\\/([a-z0-9]+)/i);
+      return m ? { ok: true, draftId: m[1], href: location.href } : { ok: false, reason: 'editor did not open (no /draft/ url) — does the account have a publication?' };
+    })()`,{label:"new-draft"});if(!G||!G.ok)throw new V(`Hashnode could not open the editor: ${G?G.reason:"unknown"}`);const L=G.draftId,Q=`${j}/draft/${L}`;await z.goto(Q);const J=await W(z,`(async () => {
+      if (location.href.indexOf('/draft/') < 0) return { drift: true };
+      const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+      let t = 0, title, body;
+      while (t < 16000) { await sleep(500); t += 500;
+        title = document.querySelector('textarea[placeholder="Article Title..."]');
+        body = document.querySelector('div[contenteditable="true"]');
+        if (title && body) break; }
+      if (!title || !body) return { ok: false, reason: 'editor fields not found' };
+      const setter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set;
+      title.focus();
+      setter.call(title, ${JSON.stringify(Y)});
+      title.dispatchEvent(new Event('input', { bubbles: true }));
+      title.dispatchEvent(new Event('change', { bubbles: true }));
+      await sleep(500);
+      body.focus();
+      document.execCommand('selectAll', false, null);
+      document.execCommand('insertText', false, ${JSON.stringify(Z)});
+      await sleep(1500);
+      return { ok: true, titleVal: title.value, bodyLen: (body.innerText || '').length };
+    })()`,{label:"fill",anchor:Q});if(!J||!J.ok)throw new V(`Hashnode fill failed: ${J?J.reason:"unknown"}`);if(D.draft)return[{status:"draft",draft_id:L,url:Q}];const A=JSON.stringify($),H=q;await z.goto(Q);const N=await W(z,`(async () => {
+      if (location.href.indexOf('/draft/') < 0) return { drift: true };
+      const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+      let t = 0, tops;
+      while (t < 16000) { await sleep(500); t += 500;
+        tops = [...document.querySelectorAll('button')].filter((b) => (b.innerText || '').trim() === 'Publish' && !b.closest('[role="dialog"]'));
+        if (tops.length) break; }
+      if (!tops || !tops.length) return { ok: false, reason: 'no top-bar Publish button (no publication?)' };
+      tops.forEach((b) => b.removeAttribute('data-pp'));
+      tops[0].setAttribute('data-pp', 'top-publish');
+      return { ok: true };
+    })()`,{label:"publish-ready",anchor:Q});if(!N||!N.ok)throw new V(`Hashnode publish not ready: ${N?N.reason:"unknown"}`);await z.click('[data-pp="top-publish"]');await z.wait(3);const X=await W(z,`(async () => {
+      if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
+      const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+      let d = 0, dlg;
+      while (d < 8000) { await sleep(500); d += 500;
+        dlg = document.querySelector('[role="dialog"][data-state="open"]') || document.querySelector('[role="dialog"]');
+        if (dlg && [...dlg.querySelectorAll('button')].some((b) => (b.innerText || '').trim() === 'Publish')) break; }
+      if (!dlg) return { ok: false, reason: 'publish dialog did not open' };
+      // 给 Discovery tab 与 弹窗 Publish 打标记，供原生点击
+      var disc = [...dlg.querySelectorAll('[role="tab"],button')].find((e) => /discovery/i.test(e.innerText || ''));
+      if (disc) disc.setAttribute('data-pp', 'discovery-tab');
+      var pub = [...dlg.querySelectorAll('button')].find((b) => (b.innerText || '').trim() === 'Publish');
+      if (pub) pub.setAttribute('data-pp', 'dlg-publish');
+      return { ok: !!pub, hasDiscovery: !!disc };
+    })()`,{label:"dialog-ready",anchor:Q});if(!X||!X.ok)throw new V(`Hashnode publish dialog failed: ${X?X.reason:"unknown"}`);if($.length&&X.hasDiscovery)try{await z.click('[data-pp="discovery-tab"]');await z.wait(2);await W(z,`(async () => {
+          if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
+          const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+          var ti = document.querySelector('input#editor-tags');
+          if (!ti) return { ok: false };
+          var setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
+          var tags = ${A};
+          for (var i = 0; i < tags.length; i++) {
+            ti.focus(); setter.call(ti, tags[i]); ti.dispatchEvent(new Event('input', { bubbles: true }));
+            await sleep(500);
+            ['keydown','keypress','keyup'].forEach((ty) => ti.dispatchEvent(new KeyboardEvent(ty, { key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true })));
+            await sleep(500);
+          }
+          return { ok: true };
+        })()`,{label:"tags",anchor:Q})}catch(T){}if(H)try{await W(z,`(async () => {
+          if (location.href.indexOf('hashnode.com') < 0) return { drift: true };
+          const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+          var toggle = [...document.querySelectorAll('label,button')].find((e) => /add a canonical url/i.test(e.innerText || ''));
+          if (toggle && !document.querySelector('input[placeholder="https://example.com/original-article"]')) { toggle.setAttribute('data-pp','canon-toggle'); }
+          return { ok: true };
+        })()`,{label:"canon-prep",anchor:Q});await z.click('[data-pp="canon-toggle"]').catch(()=>{});await z.wait(1);await z.evaluate(`(() => {
+          var ci = document.querySelector('input[placeholder="https://example.com/original-article"]');
+          if (ci) { var s = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype,'value').set; ci.focus(); s.call(ci, ${JSON.stringify(H)}); ci.dispatchEvent(new Event('input',{bubbles:true})); ci.dispatchEvent(new Event('blur',{bubbles:true})); }
+          return true;
+        })()`)}catch(T){}await z.evaluate(`(() => {
+      var dlg = document.querySelector('[role="dialog"][data-state="open"]') || document.querySelector('[role="dialog"]');
+      if (dlg) { var pub = [...dlg.querySelectorAll('button')].find((b) => (b.innerText||'').trim()==='Publish'); if (pub) pub.setAttribute('data-pp','dlg-publish'); }
+      return true;
+    })()`);await z.click('[data-pp="dlg-publish"]');let P="";for(let T=0;T<30;T+=1){await z.wait(1);const K=await z.evaluate("(() => location.href)()").catch(()=>"");if(typeof K==="string"&&K.indexOf("/draft/")<0&&K.indexOf("hashnode.com")<0){P=K;break}if(typeof K==="string"&&K.indexOf("/draft/")<0&&K.indexOf("/edit/")<0&&K.indexOf("hashnode.com")>=0){P=K;break}}if(!P)throw new V("Hashnode publish did not navigate to a live article URL (still on /draft or /edit). The post may have been saved but not published.");return[{status:"published",draft_id:L,url:P}]}});

package/clis/hf/auth.js

@@ -0,0 +1,12 @@
+import{AuthRequiredError as G,CommandExecutionError as F}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as K}from"../_shared/site-auth.js";const J=`(async () => {
+  try {
+    const r = await fetch('/api/whoami-v2', { credentials: 'include', headers: { Accept: 'application/json' } });
+    if (r.status === 401 || r.status === 403) return { kind: 'auth', detail: 'HF /api/whoami-v2 HTTP ' + r.status };
+    if (!r.ok) return { kind: 'http', httpStatus: r.status };
+    const d = await r.json();
+    if (!d || !d.name || d.type === undefined) return { kind: 'auth', detail: 'HF /api/whoami-v2 has no name — anonymous' };
+    return { ok: true, username: String(d.name), fullname: String(d.fullname || ''), type: String(d.type || '') };
+  } catch (e) {
+    return { kind: 'exception', detail: String(e && e.message || e) };
+  }
+})()`;async function L(D){await D.goto("https://huggingface.co/");await D.wait(1);const z=await D.evaluate(J);if(z?.kind==="auth")throw new G("huggingface.co",z.detail);if(z?.kind==="http")throw new F(`HTTP ${z.httpStatus} from HF /api/whoami-v2`);if(z?.kind==="exception")throw new F(`HF whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected HF probe: ${JSON.stringify(z)}`);return{username:z.username,fullname:z.fullname,type:z.type}}K({site:"hf",domain:"huggingface.co",loginUrl:"https://huggingface.co/login",columns:["username","fullname","type"],verify:L,poll:async(D)=>{const z=await D.evaluate(J);if(!z?.ok)throw new G("huggingface.co","Waiting for Hugging Face login");return{username:z.username,fullname:z.fullname,type:z.type}}});

package/clis/hf/datasets.js

@@ -0,0 +1 @@
+import{cli as y,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as d,EmptyResultError as k}from"@jackwener/opencli/errors";const c=["downloads","likes","trending","created_at","last_modified"],A={lastmodified:"last_modified",createdat:"created_at"};y({site:"hf",name:"datasets",access:"read",description:"Top Hugging Face datasets (downloads / likes / trending / freshness).",domain:"huggingface.co",strategy:S.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"downloads",help:`Sort key: ${c.join(", ")}`},{name:"search",type:"string",required:!1,help:"Optional name/owner substring filter."},{name:"limit",type:"int",default:20,help:"Max datasets (max 100; one API page)."}],columns:["rank","id","author","downloads","likes","tags","lastModified","url"],func:async(r)=>{const l=String(r.sort??"downloads").toLowerCase(),h=A[l]??l;if(!c.includes(h))throw new n(`hf datasets sort must be one of ${c.join(", ")}`);const s=Number(r.limit??20);if(!Number.isInteger(s)||s<=0)throw new n("hf datasets limit must be a positive integer");if(s>100)throw new n("hf datasets limit must be <= 100");const e=new URL("https://huggingface.co/api/datasets");e.searchParams.set("sort",h);e.searchParams.set("direction","-1");e.searchParams.set("limit",String(s));e.searchParams.set("full","true");if(r.search)e.searchParams.set("search",String(r.search));let i;try{i=await fetch(e,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(t){throw new d(`hf datasets request failed: ${t?.message||t}`)}if(!i.ok)throw new d(`hf datasets failed: HTTP ${i.status}`);let o;try{o=await i.json()}catch(t){throw new d(`hf datasets returned malformed JSON: ${t?.message||t}`)}const f=Array.isArray(o)?o:[];if(f.length===0)throw new k("hf datasets","No matching datasets on huggingface.co.");return f.slice(0,s).map((t,g)=>{const a=t.id||"",m=a.indexOf("/"),u=m>0?a.slice(0,m):"",w=Array.isArray(t.tags)?t.tags.filter((p)=>!p.startsWith("license:")).slice(0,10).join(", "):"";return{rank:g+1,id:a,author:u,downloads:t.downloads??0,likes:t.likes??0,tags:w,lastModified:t.lastModified?String(t.lastModified).slice(0,10):"",url:a?`https://huggingface.co/datasets/${a}`:""}})}});

package/clis/hf/models.js

@@ -0,0 +1 @@
+import{cli as y,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as l,EmptyResultError as k}from"@jackwener/opencli/errors";const d=["downloads","likes","trending","created_at","last_modified"],b={lastmodified:"last_modified",createdat:"created_at"};y({site:"hf",name:"models",access:"read",description:"Top Hugging Face models (downloads / likes / trending / freshness).",domain:"huggingface.co",strategy:S.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"downloads",help:`Sort key: ${d.join(", ")}`},{name:"search",type:"string",required:!1,help:'Optional name/owner substring filter (e.g. "llama", "mistralai/")'},{name:"pipeline",type:"string",required:!1,help:"Filter by pipeline tag (e.g. text-generation, image-classification)"},{name:"limit",type:"int",default:20,help:"Max models (max 100; one API page)."}],columns:["rank","id","author","pipelineTag","downloads","likes","tags","lastModified","url"],func:async(i)=>{const c=String(i.sort??"downloads").toLowerCase(),m=b[c]??c;if(!d.includes(m))throw new n(`hf models sort must be one of ${d.join(", ")}`);const s=Number(i.limit??20);if(!Number.isInteger(s)||s<=0)throw new n("hf models limit must be a positive integer");if(s>100)throw new n("hf models limit must be <= 100");const t=new URL("https://huggingface.co/api/models");t.searchParams.set("sort",m);t.searchParams.set("direction","-1");t.searchParams.set("limit",String(s));t.searchParams.set("full","true");if(i.search)t.searchParams.set("search",String(i.search));if(i.pipeline)t.searchParams.set("pipeline_tag",String(i.pipeline));let r;try{r=await fetch(t,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(e){throw new l(`hf models request failed: ${e?.message||e}`)}if(!r.ok)throw new l(`hf models failed: HTTP ${r.status}`);let o;try{o=await r.json()}catch(e){throw new l(`hf models returned malformed JSON: ${e?.message||e}`)}const g=Array.isArray(o)?o:[];if(g.length===0)throw new k("hf models","No matching models on huggingface.co.");return g.slice(0,s).map((e,f)=>{const a=e.id||e.modelId||"",h=a.indexOf("/"),p=h>0?a.slice(0,h):"",u=Array.isArray(e.tags)?e.tags.filter((w)=>!w.startsWith("license:")).slice(0,10).join(", "):"";return{rank:f+1,id:a,author:p,pipelineTag:e.pipeline_tag||e.pipelineTag||"",downloads:e.downloads??0,likes:e.likes??0,tags:u,lastModified:e.lastModified?String(e.lastModified).slice(0,10):"",url:a?`https://huggingface.co/${a}`:""}})}});

package/clis/hf/paper.js

@@ -0,0 +1 @@
+import{cli as c,Strategy as h}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as i,EmptyResultError as p}from"@jackwener/opencli/errors";const m=/^\d{4}\.\d{4,5}(?:v\d+)?$/;c({site:"hf",name:"paper",access:"read",description:"Hugging Face paper detail by arXiv id (full title / summary / authors / AI keywords)",domain:"huggingface.co",strategy:h.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'arXiv id (e.g. "1706.03762") — same value HF uses to mirror the paper'}],columns:["id","title","authors","publishedAt","upvotes","aiKeywords","summary","aiSummary","url"],func:async(o)=>{const a=String(o.id??"").trim();if(!a)throw new n("hf paper id cannot be empty","Example: opencli hf paper 1706.03762");if(!m.test(a))throw new n(`hf paper id "${o.id}" is not a valid arXiv id`,"Expected the modern arXiv form `YYMM.NNNNN` (optionally with a version suffix like `v3`).");const s=process.env.HF_ENDPOINT?.replace(/\/+$/,"")||"https://huggingface.co",u=`${s}/api/papers/${encodeURIComponent(a)}`;let t;try{t=await fetch(u,{headers:{accept:"application/json"}})}catch(r){throw new i(`hf paper request failed: ${r?.message??r}`)}if(t.status===404)throw new p("hf paper",`Hugging Face has no paper page for "${a}".`);if(t.status===429)throw new i("hf paper returned HTTP 429 (rate limited)","Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.");if(!t.ok)throw new i(`hf paper returned HTTP ${t.status}`);let e;try{e=await t.json()}catch(r){throw new i(`hf paper returned malformed JSON: ${r?.message??r}`)}if(!e||typeof e!=="object"||!e.id)throw new p("hf paper",`Hugging Face returned no paper data for "${a}".`);const d=Array.isArray(e.authors)?e.authors.map((r)=>typeof r==="object"&&r?r.name||r.fullname||"":String(r)).filter(Boolean):[],l=Array.isArray(e.ai_keywords)?e.ai_keywords.join(", "):"";return[{id:String(e.id),title:String(e.title??""),authors:d.join(", "),publishedAt:String(e.publishedAt??"").slice(0,10),upvotes:e.upvotes!=null?Number(e.upvotes):null,aiKeywords:l,summary:String(e.summary??""),aiSummary:String(e.ai_summary??""),url:`${s}/papers/${e.id}`}]}});

package/clis/hf/spaces.js

@@ -0,0 +1 @@
+import{cli as S,Strategy as y}from"@jackwener/opencli/registry";import{ArgumentError as o,CommandExecutionError as n,EmptyResultError as b}from"@jackwener/opencli/errors";const d=["likes","created_at","last_modified"],P={lastmodified:"last_modified",createdat:"created_at"};S({site:"hf",name:"spaces",access:"read",description:"Top Hugging Face Spaces (likes / created_at / last_modified).",domain:"huggingface.co",strategy:y.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"likes",help:`Sort key: ${d.join(", ")}`},{name:"search",type:"string",required:!1,help:'Optional name/owner substring filter (e.g. "stability", "openai/")'},{name:"sdk",type:"string",required:!1,help:"Filter by Space SDK: gradio / streamlit / docker / static"},{name:"limit",type:"int",default:20,help:"Max spaces (max 100; one API page)."}],columns:["rank","id","author","sdk","likes","tags","lastModified","url"],func:async(s)=>{const h=String(s.sort??"likes").toLowerCase(),f=P[h]??h;if(!d.includes(f))throw new o(`hf spaces sort must be one of ${d.join(", ")}`);const a=Number(s.limit??20);if(!Number.isInteger(a)||a<=0)throw new o("hf spaces limit must be a positive integer");if(a>100)throw new o("hf spaces limit must be <= 100");const c=s.sdk==null?"":String(s.sdk).trim().toLowerCase();if(!new Set(["","gradio","streamlit","docker","static"]).has(c))throw new o("hf spaces sdk must be one of gradio / streamlit / docker / static");const t=new URL("https://huggingface.co/api/spaces");t.searchParams.set("sort",f);t.searchParams.set("direction","-1");t.searchParams.set("limit",String(a));t.searchParams.set("full","true");if(s.search)t.searchParams.set("search",String(s.search));if(c)t.searchParams.set("sdk",c);let r;try{r=await fetch(t,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(e){throw new n(`hf spaces request failed: ${e?.message??e}`)}if(r.status===429)throw new n("hf spaces returned HTTP 429 (rate limited)","Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.");if(!r.ok)throw new n(`hf spaces failed: HTTP ${r.status}`);let l;try{l=await r.json()}catch(e){throw new n(`hf spaces returned malformed JSON: ${e?.message??e}`)}const m=Array.isArray(l)?l:[];if(!m.length)throw new b("hf spaces","No matching spaces on huggingface.co.");return m.slice(0,a).map((e,p)=>{const i=String(e.id??e._id??""),g=i.indexOf("/"),u=String(e.author??(g>0?i.slice(0,g):"")),w=Array.isArray(e.tags)?e.tags.filter((k)=>!String(k).startsWith("license:")).slice(0,10).join(", "):"";return{rank:p+1,id:i,author:u,sdk:String(e.sdk??""),likes:e.likes!=null?Number(e.likes):null,tags:w,lastModified:String(e.lastModified??"").slice(0,10),url:i?`https://huggingface.co/spaces/${i}`:""}})}});

package/clis/hf/top.js

@@ -0,0 +1 @@
+import{cli as A,Strategy as _}from"@jackwener/opencli/registry";import{CliError as l}from"@jackwener/opencli/errors";function R(t,e=60){return t.length>e?t.slice(0,e-3)+"...":t}function w(t,e=3){const a=t.map((n)=>n.name);if(a.length<=e)return a.join(", ");return a.slice(0,e).join(", ")+" et al."}const c=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];function F(){const t=new Date;return`${c[t.getUTCMonth()]} ${t.getUTCFullYear()}`}function I(){const t=new Date,e=t.getUTCDay(),a=e===6?0:6-e,n=new Date(t);n.setUTCDate(t.getUTCDate()+a);const d=new Date(n);d.setUTCDate(n.getUTCDate()-6);const r=c[d.getUTCMonth()],u=c[n.getUTCMonth()],m=d.getUTCDate(),h=n.getUTCDate();return r===u?`${r} ${m}-${h}`:`${r} ${m}-${u} ${h}`}A({site:"hf",name:"top",access:"read",description:"Top upvoted Hugging Face papers",domain:"huggingface.co",strategy:_.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of papers"},{name:"all",type:"bool",default:!1,help:"Return all papers (ignore limit)"},{name:"date",type:"str",required:!1,help:"Date (YYYY-MM-DD), defaults to most recent"},{name:"period",type:"str",default:"daily",choices:["daily","weekly","monthly"],help:"Time period: daily, weekly, or monthly"}],columns:["rank","id","title","upvotes","authors"],footerExtra:(t)=>{if(t._footerDate)return t._footerDate;if(t.period==="monthly")return F();if(t.period==="weekly")return I();return t.date??new Date().toISOString().slice(0,10)},func:async(t)=>{const e=String(t.period??"daily"),a=Boolean(t.all),n=process.env.HF_ENDPOINT?.replace(/\/+$/,"")||"https://huggingface.co";if(e==="weekly"||e==="monthly"){if(t.date)throw new l("INVALID_ARG",`--date is not supported for ${e} period`,`Omit --date when using --period ${e}`);const s=`${n}/api/papers?period=${e}`,i=await fetch(s);if(!i.ok)throw new l("FETCH_ERROR",`HF API error: ${i.status} ${i.statusText}`,"Check HF_ENDPOINT or try again later");const D=await i.json();if(!Array.isArray(D))throw new l("FETCH_ERROR","Unexpected HF API response","Check endpoint");const $=D,f=$.map((o)=>o.publishedAt).filter(Boolean).sort();if(f.length>0)if(e==="monthly"){const o=new Date(f[0]);t._footerDate=`${c[o.getUTCMonth()]} ${o.getUTCFullYear()}`}else{const o=new Date(f[0]),p=new Date(f[f.length-1]),y=c[o.getUTCMonth()],g=c[p.getUTCMonth()],C=o.getUTCDate(),U=p.getUTCDate();t._footerDate=y===g?`${y} ${C}-${U}`:`${y} ${C}-${g} ${U}`}const T=[...$].sort((o,p)=>(p.upvotes??0)-(o.upvotes??0));return(a?T:T.slice(0,Number(t.limit))).map((o,p)=>({rank:p+1,id:o.id??"",title:R(o.title??""),upvotes:o.upvotes??0,authors:w(o.authors??[])}))}if(t.date&&!/^\d{4}-\d{2}-\d{2}$/.test(String(t.date)))throw new l("INVALID_ARG",`Invalid date format: ${t.date}`,"Use YYYY-MM-DD");const d=t.date?`${n}/api/daily_papers?date=${t.date}`:`${n}/api/daily_papers`,r=await fetch(d);if(!r.ok)throw new l("FETCH_ERROR",`HF API error: ${r.status} ${r.statusText}`,"Check HF_ENDPOINT or try again later");const u=await r.json();if(!Array.isArray(u))throw new l("FETCH_ERROR","Unexpected HF API response","Check date format or endpoint");const h=[...u].sort((s,i)=>(i.paper?.upvotes??0)-(s.paper?.upvotes??0));return(a?h:h.slice(0,Number(t.limit))).map((s,i)=>({rank:i+1,id:s.paper?.id??"",title:R(s.title??""),upvotes:s.paper?.upvotes??0,authors:w(s.paper?.authors??[])}))}});

package/clis/homebrew/cask.js

@@ -0,0 +1 @@
+import{cli as n,Strategy as s}from"@jackwener/opencli/registry";import{BREW_BASE as i,brewFetch as d,requireToken as m}from"./utils.js";n({site:"homebrew",name:"cask",access:"read",description:"Fetch a Homebrew cask's metadata (version, homepage, deprecation, download URL)",domain:"formulae.brew.sh",strategy:s.PUBLIC,browser:!1,args:[{name:"token",positional:!0,required:!0,help:'Cask token (e.g. "firefox", "visual-studio-code", "google-chrome")'}],columns:["cask","tap","name","version","description","homepage","deprecated","disabled","download","url"],func:async(a)=>{const o=m(a.token,"token"),r=`${i}/cask/${encodeURIComponent(o)}.json`,e=await d(r,"homebrew cask"),t=Array.isArray(e?.name)?e.name.filter(Boolean).join(", "):String(e?.name??"").trim();return[{cask:String(e?.token??o).trim(),tap:String(e?.tap??"").trim(),name:t,version:String(e?.version??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),download:String(e?.url??"").trim(),url:`https://formulae.brew.sh/cask/${encodeURIComponent(o)}`}]}});

package/clis/homebrew/formula.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as i}from"@jackwener/opencli/registry";import{BREW_BASE as m,brewFetch as l,requireToken as c}from"./utils.js";s({site:"homebrew",name:"formula",access:"read",description:"Fetch a Homebrew formula's metadata (version, license, deps, deprecation, source)",domain:"formulae.brew.sh",strategy:i.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Formula name (e.g. "wget", "gcc@13", "imagemagick")'}],columns:["formula","tap","version","license","description","homepage","dependencies","deprecated","disabled","source","url"],func:async(a)=>{const r=c(a.name,"formula"),o=`${m}/formula/${encodeURIComponent(r)}.json`,e=await l(o,"homebrew formula"),n=Array.isArray(e?.dependencies)?e.dependencies.filter(Boolean):[],t=String(e?.urls?.stable?.url??"").trim();return[{formula:String(e?.name??r).trim(),tap:String(e?.tap??"").trim(),version:String(e?.versions?.stable??"").trim(),license:String(e?.license??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),dependencies:n.join(", "),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),source:t,url:`https://formulae.brew.sh/formula/${encodeURIComponent(r)}`}]}});

package/clis/homebrew/popular.js

@@ -0,0 +1 @@
+import{cli as w,Strategy as h}from"@jackwener/opencli/registry";import{EmptyResultError as b}from"@jackwener/opencli/errors";import{BREW_BASE as y,brewFetch as f,parseInstallCount as k,requireBoundedInt as g,requireOneOf as l}from"./utils.js";const i=["formula","cask"],m=["30d","90d","365d"];w({site:"homebrew",name:"popular",access:"read",description:"List most-installed Homebrew formulae or casks (Homebrew's analytics ranking)",domain:"formulae.brew.sh",strategy:h.PUBLIC,browser:!1,args:[{name:"type",default:"formula",help:`Package type (${i.join(" / ")})`},{name:"window",default:"30d",help:`Time window (${m.join(" / ")})`},{name:"limit",type:"int",default:30,help:"Max rows (1-500)"}],columns:["rank","token","type","installs","percent","window","url"],func:async(n)=>{const t=l(n.type,i,"type"),s=l(n.window,m,"window"),c=g(n.limit,30,500),u=`${y}/analytics/${t==="cask"?"cask-install":"install"}/${s}.json`,o=await f(u,"homebrew popular"),r=Array.isArray(o?.items)?o.items:[];if(!r.length)throw new b("homebrew popular",`Homebrew analytics returned no items for ${t}/${s}.`);return r.slice(0,c).map((e,p)=>{const a=String(t==="cask"?e.cask:e.formula??"").trim(),d=t==="cask"?"cask":"formula";return{rank:e.number!=null?Number(e.number):p+1,token:a,type:t,installs:k(e.count),percent:e.percent!=null?Number(e.percent):null,window:s,url:a?`https://formulae.brew.sh/${d}/${encodeURIComponent(a)}`:""}})}});

package/clis/homebrew/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as G,CommandExecutionError as J,EmptyResultError as L}from"@jackwener/opencli/errors";export const BREW_BASE="https://formulae.brew.sh/api";const M="opencli-homebrew-adapter (+https://github.com/jackwener/opencli)",P=/^[A-Za-z0-9][A-Za-z0-9._+@-]*$/;export function requireString(B,z){const q=String(B??"").trim();if(!q)throw new G(`homebrew ${z} cannot be empty`);return q}export function requireBoundedInt(B,z,q,D="limit"){const F=B??z,I=typeof F==="number"?F:Number(F);if(!Number.isInteger(I)||I<=0)throw new G(`homebrew ${D} must be a positive integer`);if(I>q)throw new G(`homebrew ${D} must be <= ${q}`);return I}export function requireToken(B,z){const q=String(B??"").trim();if(!q)throw new G(`homebrew ${z} is required (e.g. "wget", "gcc@13", "firefox")`);if(q.length>100||!P.test(q))throw new G(`homebrew ${z} "${B}" is not a valid token`,'Use letters / digits / "_-.+@", starting with a letter or digit (max 100 chars).');return q}export function requireOneOf(B,z,q){const D=String(B??"").trim().toLowerCase();if(!D)throw new G(`homebrew ${q} is required`);if(!z.includes(D))throw new G(`homebrew ${q} "${B}" is not supported`,`Allowed: ${z.join(", ")}.`);return D}export async function brewFetch(B,z){let q;try{q=await fetch(B,{headers:{"user-agent":M,accept:"application/json"}})}catch(F){throw new J(`${z} request failed: ${F?.message??F}`,"Check that formulae.brew.sh is reachable from this network.")}if(q.status===404)throw new L(z,`Homebrew API returned 404 for ${B}.`);if(q.status===429)throw new J(`${z} returned HTTP 429 (rate limited)`,"Homebrew throttles bursts; wait a few seconds and retry.");if(!q.ok)throw new J(`${z} returned HTTP ${q.status}`);let D;try{D=await q.json()}catch(F){throw new J(`${z} returned malformed JSON: ${F?.message??F}`)}return D}export function parseInstallCount(B){if(B==null)return null;const z=String(B).replace(/,/g,"").trim();if(!z)return null;const q=Number(z);return Number.isFinite(q)?q:null}

package/clis/huodongxing/events.js

@@ -0,0 +1 @@
+import{cli as Y,Strategy as v}from"@jackwener/opencli/registry";import{ArgumentError as _,CommandExecutionError as L,EmptyResultError as f}from"@jackwener/opencli/errors";const h="https://www.huodongxing.com/events",b=50;export const EVENTS_COLUMNS=["rank","id","title","time","eventType","city","location","organizer","url"];function X(K){return String(K??"").replace(/\s+/g," ").trim()}export function requireLimit(K){const G=K??20,J=typeof G==="number"?G:Number(String(G).trim());if(!Number.isInteger(J)||J<=0)throw new _("huodongxing limit must be a positive integer");if(J>b)throw new _(`huodongxing limit must be <= ${b}`);return J}function P(K,G,J){const W=X(J);if(W)K.set(G,W)}function M(K,G,J){return Math.floor(Date.UTC(K,G-1,J)/86400000)}function C(K){const G=X(K).match(/^(\d{4})-(\d{2})-(\d{2})$/);if(!G)return null;const J=Number(G[1]),W=Number(G[2]),F=Number(G[3]),$=new Date(Date.UTC(J,W-1,F));if($.getUTCFullYear()!==J||$.getUTCMonth()!==W-1||$.getUTCDate()!==F)return null;return M(J,W,F)}function D(K,G){const J=X(K);if(!J)return"";if(C(J)==null)throw new _(`huodongxing ${G} must be a valid YYYY-MM-DD date`);return J}function A(K={}){const G=D(K.date,"date"),J=D(K.dateTo,"dateTo");if(G&&J&&C(G)>C(J))throw new _("huodongxing date must be <= dateTo");return{date:G,dateTo:J}}function w(K){if(K&&!Array.isArray(K)&&typeof K==="object"&&"session"in K&&"data"in K)return K.data;return K}function T(K){return M(K.getFullYear(),K.getMonth()+1,K.getDate())}function q(K,G){const J=X(K).match(/(\d{1,2})\/(\d{1,2})/);if(!J)return null;return{month:Number(J[1]),day:Number(J[2]),ordinal:M(G,Number(J[1]),Number(J[2]))}}function E(K,G={}){const J=X(K);if(!J)return null;const W=C(G.date),F=C(G.dateTo)??W,$=G.referenceDate instanceof Date?G.referenceDate:new Date,B=T($);if(/今天/.test(J))return{start:B,end:B};if(/明天/.test(J))return{start:B+1,end:B+1};if(/后天/.test(J))return{start:B+2,end:B+2};const z=G.year??(X(G.date).match(/^(\d{4})-/)?.[1]?Number(X(G.date).slice(0,4)):$.getFullYear()),Z=Array.from(J.matchAll(/(\d{1,2}\/\d{1,2})/g)).map((Q)=>Q[1]);if(Z.length===0)return null;const V=q(Z[0],z);if(!V)return null;if(Z.length===1)return{start:V.ordinal,end:V.ordinal};const N=q(Z[1],z)?.month<V.month?z+1:z,U=q(Z[1],N);if(!U)return{start:V.ordinal,end:V.ordinal};if(W!=null&&U.ordinal<W&&V.month>=10){const Q=q(Z[0],z+1),j=q(Z[1],z+1)?.month<Q.month?z+2:z+1,H=q(Z[1],j);if(Q&&H)return{start:Q.ordinal,end:H.ordinal}}return{start:V.ordinal,end:U.ordinal}}export function filterRowsByDateRange(K,G={}){A(G);const J=C(G.date),W=C(G.dateTo)??J;if(J==null&&W==null)return K;const F=J??W,$=W??J;return K.filter((z)=>{const Z=E(z.time,G);if(!Z)return!0;return Z.start<=$&&Z.end>=F}).map((z,Z)=>({...z,rank:Z+1}))}export function buildEventsUrl(K={}){const G=A(K),J=new URLSearchParams;J.set("orderby","o");J.set("d","ts");P(J,"date",G.date);P(J,"dateTo",G.dateTo);P(J,"tag",K.tag);P(J,"city",K.city);const W=X(K.eventType);if(W){if(W!=="1"&&W!=="2")throw new _("huodongxing eventType must be 1 (offline) or 2 (online)");J.set("eventType",W)}P(J,"qs",K.qs);return`${h}?${J.toString()}`}export function extractEventRowsPayload(K=20){const G=50,J=K??20,W=typeof J==="number"?J:Number(String(J).trim());if(!Number.isInteger(W)||W<=0||W>G)return{ok:!1,code:"INVALID_LIMIT",message:`huodongxing limit must be a positive integer <= ${G}`};const F=(Q)=>String(Q??"").replace(/\s+/g," ").trim(),$=(Q,j)=>F(Q.querySelector(j)?.textContent??""),B=(Q)=>{const j=String(Q??"").match(/\/event\/(\d+)/);return j?j[1]:""},z=(Q)=>`https://www.huodongxing.com/event/${Q}`,Z=(Q,j)=>{if(Q.querySelector(".item-live-icon"))return"online";if(Q.querySelector(".item-dress-icon"))return"offline";if(/线上|在线|直播/.test(j))return"online";return""},V=Array.from(document.querySelectorAll(".search-tab-content-item-mesh")),N=[],U=new Set;for(const Q of V){if(N.length>=W)break;const j=Q.querySelector('a.item-title[href*="/event/"], a[href*="/event/"]'),H=B(j?.getAttribute("href")??"");if(!H||U.has(H))continue;const O=F($(Q,"a.item-title span")||$(Q,"a.item-title")||Q.querySelector("img.item-logo")?.getAttribute("alt")||"");if(!O)continue;const S=$(Q,".item-dress p"),I=$(Q,".item-dress-pp"),k=F($(Q,".item-bottom-left .user-name")||Q.querySelector(".item-bottom-left img[title]")?.getAttribute("title")||Q.querySelector(".item-bottom-left img[alt]")?.getAttribute("alt")||"");U.add(H);N.push({rank:N.length+1,id:H,title:O,time:S,eventType:Z(Q,I),city:I,location:I,organizer:k,url:z(H)})}if(N.length===0){const Q=F(document.body?.textContent??"");if(/操作过于频繁|too\s+frequent|rate\s*limit/i.test(Q))return{ok:!1,code:"RATE_LIMIT",message:"huodongxing events was rate limited by www.huodongxing.com",hint:"Wait a few minutes and retry from a real browser session."};if(V.length>0)return{ok:!1,code:"MALFORMED_RESULT",message:"huodongxing events cards were found but no stable event rows could be extracted",hint:"Huodongxing card markup changed: expected event links with /event/<id> and non-empty titles."};return{ok:!1,code:"EMPTY_RESULT",message:"huodongxing events returned no data",hint:"No Huodongxing event cards were found. The page may be empty or the DOM structure may have changed."}}return{ok:!0,rows:N}}function R(K){const G=w(K);if(G?.ok===!0&&Array.isArray(G.rows))return G.rows;if(G?.ok===!0)throw new L("huodongxing events returned malformed extraction rows","Expected browser extraction payload rows to be an array.");if(G?.code==="RATE_LIMIT")throw new L(G.message||"huodongxing events was rate limited by www.huodongxing.com",G.hint||"Wait a few minutes and retry from a real browser session.");if(G?.code==="INVALID_LIMIT")throw new _(G.message||"huodongxing limit must be a positive integer <= 50");if(G?.code==="EMPTY_RESULT")throw new f("huodongxing events",G.hint||"No Huodongxing event cards were found. The page may be empty.");throw new L(G?.message||"huodongxing events returned malformed extraction data",G?.hint||"Huodongxing extraction did not return the expected structured payload.")}export function extractEventRows(K=20){return R(extractEventRowsPayload(K))}Y({site:"huodongxing",name:"events",access:"read",description:"活动行活动搜索（按标签、城市、日期、线上/线下、名称过滤）",domain:"www.huodongxing.com",strategy:v.PUBLIC,browser:!0,args:[{name:"tag",type:"string",default:"",help:"活动标签，例如 AI"},{name:"city",type:"string",default:"全部",help:"城市名，例如 北京 / 上海 / 全部"},{name:"date",type:"string",default:"",help:"开始日期，格式 YYYY-MM-DD"},{name:"dateTo",type:"string",default:"",help:"结束日期，格式 YYYY-MM-DD"},{name:"eventType",type:"int",default:void 0,help:"活动类型：1 线下，2 线上"},{name:"qs",type:"string",default:"",help:"按活动名称关键词过滤"},{name:"limit",type:"int",default:20,help:"返回条数（1-50）"}],columns:EVENTS_COLUMNS,func:async(K,G)=>{const J=requireLimit(G.limit),W=buildEventsUrl(G);await K.goto(W);await K.wait(2);const F=await K.evaluate(`(${extractEventRowsPayload.toString()})(${J})`);return filterRowsByDateRange(R(F),G)}});

package/clis/hupu/__fixtures__/hot-home.html

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html lang="zh-CN"><head><title>虎扑社区</title></head><body>
+<div id="container"><div class="bbs-index-web">
+<nav>
+<a href="/639999999.html"><span class="t-title">导航里的 thread-shaped phantom 链接</span></a>
+</nav>
+<div class="text-list-model">
+<div class="list-item-wrap"><div class="list-title">步行街</div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639088523.html" target="_blank" class=" hot"><span class="t-title">网友曝三亚4只皮皮虾收费1035，官方凌晨通报</span></a>
+<span class="t-lights">50亮</span>
+<span class="t-replies">359回复</span>
+</div>
+<div class="t-label"><a href="/forum">步行街主干道</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639095236.html" target="_blank" class=" false"><span class="t-title">[流言板]市监局称4只皮皮虾1035元价格合规</span></a>
+<span class="t-lights">48亮</span>
+<span class="t-replies">128回复</span>
+</div>
+<div class="t-label"><a href="/forum">步行街主干道</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639094866.html" target="_blank" class=" false"><span class="t-title">印度顶层婆罗门家庭的微奢晚餐，大家觉得怎么样？</span></a>
+<span class="t-lights">1.2万亮</span>
+<span class="t-replies">5.8万回复</span>
+</div>
+<div class="t-label"><a href="/forum">步行街主干道</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639100001.html" target="_blank" class=" hot"><span class="t-title">湖人战胜勇士拿下连胜</span></a>
+<span class="t-lights">0亮</span>
+<span class="t-replies">0回复</span>
+</div>
+<div class="t-label"><a href="/forum">NBA湿乎乎的话题</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639100002.html" target="_blank" class=" false"><span class="t-title">无 lights 的标题（少见但要兼容）</span></a>
+
+<span class="t-replies">20回复</span>
+</div>
+<div class="t-label"><a href="/forum">电竞</a></div>
+</div></div></div>
+
+<div class="list-item-wrap"><div class="list-wrap"><div class="list-item">
+<div class="t-info">
+<a href="/639100003.html" target="_blank" class=" hot"><span class="t-title">另一个 hot 帖子</span></a>
+<span class="t-lights">100亮</span>
+<span class="t-replies">200回复</span>
+</div>
+<div class="t-label"><a href="/forum">国际足球</a></div>
+</div></div></div>
+</div>
+</div></div></body></html>

package/clis/hupu/auth.js

@@ -0,0 +1,14 @@
+import{AuthRequiredError as o,CommandExecutionError as n}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";async function t(e){return(await e.getCookies({url:"https://my.hupu.com"})).some((i)=>i.name==="u"&&i.value)}async function r(e){if(!await t(e))throw new o("hupu.com","Hupu u cookie missing — anonymous");await e.goto("https://my.hupu.com/");await e.wait(2);const u=await e.evaluate(`
+    (() => {
+      if (/passport\\.hupu\\.com\\/.*login/.test(location.href)) {
+        return { kind: 'auth', detail: 'Hupu my page redirected to passport login' };
+      }
+      const uCookie = (document.cookie.split('; ').find(c => c.startsWith('u=')) || '').split('=')[1] || '';
+      const el = document.querySelector('.user-name, .username, .nick, [class*="userName"]');
+      const username = (el?.innerText || '').trim();
+      if (!uCookie) {
+        return { kind: 'auth', detail: 'Hupu my page rendered but u cookie absent — stale session' };
+      }
+      return { ok: true, user_id: uCookie, username };
+    })()
+  `);if(u?.kind==="auth")throw new o("hupu.com",u.detail);if(!u?.ok)throw new n(`Unexpected Hupu probe: ${JSON.stringify(u)}`);return{user_id:u.user_id,username:u.username}}s({site:"hupu",domain:"hupu.com",loginUrl:"https://passport.hupu.com/pc/login",columns:["user_id","username"],quickCheck:t,verify:r,poll:async(e)=>{if(!await t(e))throw new o("hupu.com","Waiting for Hupu u cookie");return r(e)}});

package/clis/hupu/detail.js

@@ -0,0 +1,7 @@
+import{cli as D,Strategy as L}from"@jackwener/opencli/registry";import{getHupuThreadUrl as S,readHupuNextData as U,stripHtml as M}from"./utils.js";D({site:"hupu",name:"detail",access:"read",description:"获取虎扑帖子详情 (使用Next.js JSON数据)",domain:"bbs.hupu.com",strategy:L.PUBLIC,browser:!0,args:[{name:"tid",required:!0,positional:!0,help:"帖子ID（9位数字）"},{name:"replies",type:"boolean",default:!1,help:"是否包含热门回复"}],columns:["title","author","content","replies","lights","url"],func:async(O,Q)=>{const{tid:A,replies:V=!1}=Q,W=S(A).replace(/-1\.html$/,".html"),B=await U(O,W,"Read Hupu thread detail",{expectedTid:String(A)}),q=B.props.pageProps.detail_error_info;if(q&&q.code!==200)throw Error(`帖子访问失败: ${q.message} (code: ${q.code})`);const b=B.props.pageProps.detail?.thread;if(!b)throw Error("帖子不存在或已被删除");const X=b.author?.puname||"未知作者",E=M(b.content),F=E.length>300?E.substring(0,300)+"...":E,G={title:b.title,author:X,content:F,replies:b.replies||0,lights:b.lights||0,url:`https://bbs.hupu.com/${A}.html`};if(V){const J=(B.props.pageProps.detail?.lights||[]).slice(0,3);if(J.length>0){let K=`
+
+【热门回复】
+`;J.forEach((z,Y)=>{const Z=z.author?.puname||"未知用户",_=M(z.content).substring(0,100),$=z.allLightCount||0,C=z.created_at_format||"未知时间";K+=`${Y+1}. ${Z} (亮${$} ${C}):
+   ${_}
+
+`});G.content=F+K}}return[G]}});

package/clis/hupu/hot.js

@@ -0,0 +1,14 @@
+import{cli as P,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentError as x,CommandExecutionError as b,EmptyResultError as A}from"@jackwener/opencli/errors";export const HUPU_HOST="https://bbs.hupu.com",HOT_LIMIT_DEFAULT=20,HOT_LIMIT_MAX=100;export function normalizeHotLimit(q){if(q===void 0||q===null||q==="")return HOT_LIMIT_DEFAULT;const B=typeof q==="number"?q:Number(q);if(!Number.isFinite(B)||!Number.isInteger(B)||B<1||B>HOT_LIMIT_MAX)throw new x(`--limit must be a positive integer in [1, ${HOT_LIMIT_MAX}], got ${JSON.stringify(q)}`);return B}export function parseHupuCount(q){if(q===void 0||q===null)return null;const B=String(q).trim();if(!B)return null;const G=B.match(/^([0-9]+(?:\.[0-9]+)?)\s*(万)?/);if(!G)return null;const v=parseFloat(G[1]);if(!Number.isFinite(v))return null;return Math.round(G[2]==="万"?v*1e4:v)}export function extractHupuHotRowsFromDoc(q,B,G){const v=[],J=q.querySelectorAll(".t-info");for(let K=0;K<J.length&&v.length<B;K+=1){const N=J[K],Q=N.querySelector("a[href]");if(!Q)continue;const V=(Q.getAttribute("href")||"").match(/^\/(\d{9})\.html$/);if(!V)continue;const W=V[1],Y=Q.querySelector(".t-title"),Z=Y?(Y.textContent||"").trim():"";if(!Z)continue;const R=(Q.getAttribute("class")||"").split(/\s+/).filter(Boolean).includes("hot"),$=N.querySelector(".t-lights"),z=N.querySelector(".t-replies"),y=G($?$.textContent:null),D=G(z?z.textContent:null),j=N.parentElement,k=j?j.querySelector(".t-label a"):null,F=k?(k.textContent||"").trim():"";v.push({rank:v.length+1,tid:W,title:Z,lights:y,replies:D,forum:F,is_hot:R,url:`${HUPU_HOST}/${W}.html`})}return v}export function buildHotScript(q){return`
+(async () => {
+  const HUPU_HOST = ${JSON.stringify(HUPU_HOST)};
+  ${parseHupuCount.toString()}
+  ${extractHupuHotRowsFromDoc.toString()}
+  // Wait briefly for .t-info rows to render in case the page is still
+  // hydrating; bbs.hupu.com is mostly SSR so this returns fast.
+  const start = Date.now();
+  while (document.querySelectorAll('.t-info').length === 0 && Date.now() - start < 5000) {
+    await new Promise(r => setTimeout(r, 100));
+  }
+  return extractHupuHotRowsFromDoc(document, ${JSON.stringify(q)}, parseHupuCount);
+})()
+`}async function C(q,B){const G=normalizeHotLimit(B.limit);await q.goto(`${HUPU_HOST}/`,{waitUntil:"load",settleMs:1000});let v;try{v=await q.evaluate(buildHotScript(G))}catch(J){const K=J instanceof Error?J.message:String(J);throw new b(`Failed to read hupu hot threads: ${K}`,"bbs.hupu.com may be unreachable or its markup may have changed")}if(!Array.isArray(v)||v.length===0)throw new A("hupu/hot","No threads found on bbs.hupu.com — page structure may have changed");return v}export const hotCommand=P({site:"hupu",name:"hot",access:"read",description:"虎扑首页热门帖子（含 lights / replies / forum / is_hot 列）",domain:"bbs.hupu.com",strategy:X.PUBLIC,browser:!0,args:[{name:"limit",type:"int",default:HOT_LIMIT_DEFAULT,help:`Number of threads (1-${HOT_LIMIT_MAX})`}],columns:["rank","tid","title","lights","replies","forum","is_hot","url"],func:C}),__test__={buildHotScript};

package/clis/hupu/like.js

@@ -0,0 +1 @@
+import{CliError as m}from"@jackwener/opencli/errors";import{cli as c,Strategy as p}from"@jackwener/opencli/registry";import{postHupuJson as d}from"./utils.js";c({site:"hupu",name:"like",access:"write",description:"点赞虎扑回复 (需要登录)",domain:"bbs.hupu.com",strategy:p.COOKIE,navigateBefore:!1,args:[{name:"tid",required:!0,positional:!0,help:"帖子ID（9位数字）"},{name:"pid",required:!0,positional:!0,help:"回复ID"},{name:"fid",required:!0,help:"板块ID（如278汽车区）"}],columns:["status","message"],func:async(r,t)=>{const{tid:s,pid:i,fid:o}=t,a="https://bbs.hupu.com/pcmapi/pc/bbs/v1/reply/light",u={tid:s,pid:i,puid:"",fid:o,shumei_id:"",deviceid:""};try{const e=await d(r,s,a,u,"Like Hupu reply");if(e.code===1)return[{status:"✅ 点赞成功",message:""}];else if(e.code===0&&e.msg==="你已经点亮过这个回帖了")return[{status:"⚠️ 已经点赞过了",message:e.msg||""}];else if(e.code===0)return[{status:"⚠️ 操作未执行",message:e.msg||e.message||""}];else throw Error(`接口错误 code=${e.code}: ${e.msg||e.message}`)}catch(e){if(e instanceof m)throw e;const n=e instanceof Error?e.message:String(e);throw Error(`点赞失败: ${n}`)}}});

package/clis/hupu/mentions.js

@@ -0,0 +1,91 @@
+import{AuthRequiredError as l,CommandExecutionError as i}from"@jackwener/opencli/errors";import{cli as d,Strategy as h}from"@jackwener/opencli/registry";import{stripHtml as p}from"./utils.js";d({site:"hupu",name:"mentions",access:"read",aliases:["mention"],description:"查看虎扑提到我的回复 (需要登录)",domain:"my.hupu.com",strategy:h.COOKIE,navigateBefore:!1,args:[{name:"limit",type:"int",default:20,help:"最多返回多少条消息"},{name:"max_pages",type:"int",default:3,help:"最多抓取多少页"},{name:"page_str",help:"分页游标；不传时从第一页开始"}],columns:["time","username","thread_title","tid","pid","post_content","quote_content","url","reply_url"],func:async(n,s)=>{const o="1",u=Math.max(1,Math.min(Number(s.limit)||20,100)),m=Math.max(1,Math.min(Number(s.max_pages)||3,10)),c=s.page_str?String(s.page_str):"",g=`https://my.hupu.com/message?tabKey=${o}`;await n.goto(g);const e=await n.evaluate(`
+      (async () => {
+        const plate = ${JSON.stringify(o)};
+        const limit = ${JSON.stringify(u)};
+        const maxPages = ${JSON.stringify(m)};
+        let pageStr = ${JSON.stringify(c)};
+        const apiBase = 'https://my.hupu.com/pcmapi/pc/space/v1/getMentionedRemindList';
+        const items = [];
+        let hasNextPage = false;
+        let nextPageStr = pageStr || '';
+
+        const parseJson = async (response) => {
+          const text = await response.text();
+          try {
+            return text ? JSON.parse(text) : {};
+          } catch {
+            return {
+              message: text || 'invalid json response'
+            };
+          }
+        };
+
+        try {
+          for (let pageIndex = 0; pageIndex < maxPages && items.length < limit; pageIndex++) {
+            const url = new URL(apiBase);
+            url.searchParams.set('plate', plate);
+            if (pageStr) {
+              url.searchParams.set('pageStr', pageStr);
+            }
+
+            const response = await fetch(url.toString(), {
+              method: 'GET',
+              credentials: 'include'
+            });
+
+            const api = await parseJson(response);
+
+            if (response.status === 401 || response.status === 403) {
+              return {
+                ok: false,
+                status: response.status,
+                error: 'please log in to Hupu first'
+              };
+            }
+
+            if (!response.ok) {
+              return {
+                ok: false,
+                status: response.status,
+                error: api?.msg || api?.message || ('HTTP ' + response.status)
+              };
+            }
+
+            if ((api?.code ?? 0) > 1) {
+              return {
+                ok: false,
+                status: response.status,
+                error: api?.msg || api?.message || ('API error code=' + api?.code)
+              };
+            }
+
+            const data = api?.data || {};
+            const currentItems = Array.isArray(data.hisList) ? data.hisList : [];
+            items.push(...currentItems);
+
+            hasNextPage = Boolean(data.hasNextPage);
+            nextPageStr = typeof data.pageStr === 'string' ? data.pageStr : '';
+
+            if (!hasNextPage || !nextPageStr || nextPageStr === pageStr) {
+              break;
+            }
+
+            pageStr = nextPageStr;
+          }
+
+          return {
+            ok: true,
+            data: {
+              items: items.slice(0, limit),
+              hasNextPage,
+              pageStr: nextPageStr
+            }
+          };
+        } catch (error) {
+          return {
+            ok: false,
+            error: error instanceof Error ? error.message : String(error)
+          };
+        }
+      })()
+    `);if(!e||typeof e!=="object")throw new i("Read Hupu mentions failed: invalid browser response");if(e.status===401||e.status===403)throw new l("my.hupu.com","Read Hupu mentions failed: please log in to Hupu first");if(!e.ok)throw new i(`Read Hupu mentions failed: ${e.error||"unknown error"}`);return(e.data?.items||[]).map((t)=>{const a=t.tid?String(t.tid):"",r=t.pid?String(t.pid):"";return{time:t.publishTime||"",username:t.username||"",thread_title:t.threadTitle||"",post_content:p(t.postContent||""),quote_content:p(t.quoteContent||""),url:a?`https://bbs.hupu.com/${a}.html`:"",reply_url:a&&r?`https://bbs.hupu.com/${a}.html?pid=${r}`:"",tid:a,pid:r,topic_id:t.topicId?String(t.topicId):"",msg_type:t.msgType??"",has_next_page:e.data?.hasNextPage??!1,next_page_str:e.data?.pageStr||""}})}});

package/clis/hupu/reply.js

@@ -0,0 +1 @@
+import{CliError as N}from"@jackwener/opencli/errors";import{cli as O,Strategy as P}from"@jackwener/opencli/registry";import{postHupuJson as Q}from"./utils.js";O({site:"hupu",name:"reply",access:"write",description:"回复虎扑帖子 (需要登录)",domain:"bbs.hupu.com",strategy:P.COOKIE,navigateBefore:!1,args:[{name:"tid",required:!0,positional:!0,help:"帖子ID（9位数字）"},{name:"topic_id",required:!0,help:"板块ID，即接口中的 topicId（如 502 篮球资讯）"},{name:"text",required:!0,positional:!0,help:"回复内容"},{name:"quote_id",help:"被引用回复的 pid；填写后会以“回复某条热门回复”的方式发言"}],columns:["status","message"],func:async(z,A)=>{const{tid:h,topic_id:B,text:F,quote_id:m}=A,G="https://bbs.hupu.com/pcmapi/pc/bbs/v1/createReply",K=`<p>${F}</p>`,v={topicId:B,content:K,shumeiId:"",deviceid:"",tid:h};if(m)v.quoteId=m;try{const f=await Q(z,h,G,v,"Reply to Hupu thread","reply");if(f.code===1)return[{status:"✅ 回复成功",message:f.msg||f.message||""}];else throw Error(`接口错误 code=${f.code}: ${f.msg||f.message}`)}catch(f){if(f instanceof N)throw f;const L=f instanceof Error?f.message:String(f);throw Error(`回复失败: ${L}`)}}});

package/clis/hupu/search.js

@@ -0,0 +1 @@
+import{cli as K,Strategy as O}from"@jackwener/opencli/registry";import{decodeHtmlEntities as P,getHupuSearchUrl as Q,readHupuSearchData as R,stripHtml as V}from"./utils.js";K({site:"hupu",name:"search",access:"read",description:"搜索虎扑帖子 (使用官方API)",domain:"bbs.hupu.com",strategy:O.PUBLIC,browser:!0,args:[{name:"query",required:!0,positional:!0,help:"搜索关键词"},{name:"page",type:"int",default:1,help:"结果页码"},{name:"limit",type:"int",default:20,help:"返回结果数量"},{name:"forum",help:"板块ID过滤 (可选)"},{name:"sort",default:"general",help:"排序方式: general/createtime/replytime/light/reply"}],columns:["rank","tid","title","author","replies","lights","forum","url"],func:async(v,z)=>{const{query:A,page:B=1,limit:C=20,forum:F,sort:G="general"}=z,I=Q(A,B,F,G);return((await R(v,I,"Search Hupu threads")).searchRes?.data||[]).slice(0,Number(C)).map((b,J)=>({rank:J+1,tid:String(b.id||""),title:P(V(b.title)),author:b.username||"未知用户",replies:b.replies||"0",lights:b.lights||"0",forum:b.forum_name||"未知板块",url:`https://bbs.hupu.com/${b.id}.html`}))}});

package/clis/hupu/unlike.js

@@ -0,0 +1 @@
+import{CliError as F}from"@jackwener/opencli/errors";import{cli as G,Strategy as I}from"@jackwener/opencli/registry";import{postHupuJson as K}from"./utils.js";G({site:"hupu",name:"unlike",access:"write",description:"取消点赞虎扑回复 (需要登录)",domain:"bbs.hupu.com",strategy:I.COOKIE,navigateBefore:!1,args:[{name:"tid",required:!0,positional:!0,help:"帖子ID（9位数字）"},{name:"pid",required:!0,positional:!0,help:"回复ID"},{name:"fid",required:!0,help:"板块ID（如278汽车区）"}],columns:["status","message"],func:async(q,v)=>{const{tid:m,pid:x,fid:z}=v,A="https://bbs.hupu.com/pcmapi/pc/bbs/v1/reply/cancelLight",B={tid:m,pid:x,puid:"",fid:z,shumei_id:"",deviceid:""};try{const h=await K(q,m,A,B,"Unlike Hupu reply");if(h.code===1)return[{status:"✅ 取消点赞成功",message:""}];else if(h.code===0&&h.msg==="你还没有点亮过这个回帖")return[{status:"⚠️ 你还没点赞过",message:h.msg||""}];else if(h.code===0)return[{status:"⚠️ 操作未执行",message:h.msg||h.message||""}];else throw Error(`接口错误 code=${h.code}: ${h.msg||h.message}`)}catch(h){if(h instanceof F)throw h;const D=h instanceof Error?h.message:String(h);throw Error(`取消点赞失败: ${D}`)}}});