publishport-opencli 1.0.19 → 1.0.21

package/clis/rednote/download.js

@@ -1 +1 @@
-import{cli as V,Strategy as W}from"@jackwener/opencli/registry";import{formatCookieHeader as X}from"@jackwener/opencli/download";import{downloadMedia as Y}from"@jackwener/opencli/download/media-download";import{CommandExecutionError as Z,EmptyResultError as $}from"@jackwener/opencli/errors";import{buildDownloadExtractJs as f}from"../xiaohongshu/download.js";import{buildNoteUrl as G,parseNoteId as J}from"../xiaohongshu/note-helpers.js";const L="Pass a full rednote.com note URL with xsec_token from search results or user/profile context.";V({site:"rednote",name:"download",access:"read",description:"Download images and videos from a rednote note",domain:"www.rednote.com",strategy:W.COOKIE,navigateBefore:!1,args:[{name:"note-id",positional:!0,required:!0,help:"Full rednote note URL with xsec_token"},{name:"output",default:"./rednote-downloads",help:"Output directory"}],columns:["index","type","status","size"],func:async(z,B)=>{const A=String(B["note-id"]),P=B.output,F=J(A);await z.goto(G(A,{commandName:"rednote download",cookieRoot:"rednote.com",signedUrlHint:L}));await z.wait({time:1+Math.random()*2});const q=await z.evaluate(f(F));if(q?.securityBlock)throw new Z("Rednote security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(A)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(!q||!q.media||q.media.length===0)throw new $("rednote/download","No downloadable media found on this rednote note.");const Q=X(await z.getCookies({url:"https://www.rednote.com"})),K=typeof q.noteId==="string"&&q.noteId.trim()?q.noteId.trim():F;return Y(q.media,{output:P,subdir:K,cookies:Q,filenamePrefix:K,timeout:60000})}});
+import{cli as s,Strategy as m}from"@jackwener/opencli/registry";import{formatCookieHeader as l}from"@jackwener/opencli/download";import{downloadMedia as c}from"@jackwener/opencli/download/media-download";import{CommandExecutionError as u,EmptyResultError as f}from"@jackwener/opencli/errors";import{buildDownloadExtractJs as w}from"../xiaohongshu/download.js";import{buildNoteUrl as p,parseNoteId as h}from"../xiaohongshu/note-helpers.js";const y="Pass a full rednote.com note URL with xsec_token from search results or user/profile context.";s({site:"rednote",name:"download",access:"read",description:"Download images and videos from a rednote note",domain:"www.rednote.com",strategy:m.COOKIE,navigateBefore:!1,args:[{name:"note-id",positional:!0,required:!0,help:"Full rednote note URL with xsec_token"},{name:"output",default:"./rednote-downloads",help:"Output directory"}],columns:["index","type","status","size"],func:async(o,r)=>{const t=String(r["note-id"]),i=r.output,n=h(t);await o.goto(p(t,{commandName:"rednote download",cookieRoot:"rednote.com",signedUrlHint:y}));await o.wait({time:1+Math.random()*2});const e=await o.evaluate(w(n));if(e?.securityBlock)throw new u("Rednote security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(t)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(!e||!e.media||e.media.length===0)throw new f("rednote/download","No downloadable media found on this rednote note.");const d=l(await o.getCookies({url:"https://www.rednote.com"})),a=typeof e.noteId==="string"&&e.noteId.trim()?e.noteId.trim():n;return c(e.media,{output:i,subdir:a,cookies:d,filenamePrefix:a,timeout:60000})}});

package/clis/rednote/feed.js

@@ -1 +1 @@
-import{cli as t,Strategy as r}from"@jackwener/opencli/registry";import{runFeed as n}from"../xiaohongshu/feed.js";export const command=t({site:"rednote",name:"feed",access:"read",description:"Rednote home feed (reads hydrated Pinia store)",domain:"www.rednote.com",strategy:r.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"int",default:20,help:"Number of items to return"}],columns:["id","title","author","likes","type","url"],func:async(e,o)=>n(e,o,"www.rednote.com")});
+import{cli as r,Strategy as o}from"@jackwener/opencli/registry";import{runFeed as a}from"../xiaohongshu/feed.js";export const command=r({site:"rednote",name:"feed",access:"read",description:"Rednote home feed (reads hydrated Pinia store)",domain:"www.rednote.com",strategy:o.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"int",default:20,help:"Number of items to return"}],columns:["id","title","author","likes","type","url"],func:async(e,t)=>a(e,t,"www.rednote.com")});

package/clis/rednote/note.js

@@ -1 +1 @@
-import{cli as u,Strategy as m}from"@jackwener/opencli/registry";import{AuthRequiredError as f,CommandExecutionError as h,EmptyResultError as a}from"@jackwener/opencli/errors";import{NOTE_EXTRACT_JS as w}from"../xiaohongshu/note.js";import{buildNoteUrl as g,parseNoteId as p}from"../xiaohongshu/note-helpers.js";const y="Pass a full rednote.com note URL with xsec_token from search results or user/profile context.";u({site:"rednote",name:"note",access:"read",description:"Read note body and engagement counts from a rednote note",domain:"www.rednote.com",strategy:m.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full rednote note URL with xsec_token"}],columns:["field","value"],func:async(o,l)=>{const n=String(l["note-id"]),d=p(n),c=g(n,{commandName:"rednote note",cookieRoot:"rednote.com",signedUrlHint:y});await o.goto(c);await o.wait({time:2+Math.random()*3});const t=await o.evaluate(w);if(!t||typeof t!=="object")throw new a("rednote/note","Unexpected evaluate response");if(t.securityBlock)throw new h("Rednote security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(n)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(t.loginWall)throw new f("www.rednote.com","Note content requires login");if(t.notFound)throw new a("rednote/note",`Note ${d} not found or unavailable — it may have been deleted or restricted`);const e=t,r=(s)=>/^\d+/.test(s)?s:"0";if(!e.title&&!e.author)throw new a("rednote/note","The note page loaded without visible content. The note may be deleted or restricted.");const i=[{field:"title",value:e.title||""},{field:"author",value:e.author||""},{field:"content",value:e.desc||""},{field:"likes",value:r(e.likes||"")},{field:"collects",value:r(e.collects||"")},{field:"comments",value:r(e.comments||"")}];if(e.tags?.length)i.push({field:"tags",value:e.tags.join(", ")});return i}});
+import{cli as u,Strategy as m}from"@jackwener/opencli/registry";import{AuthRequiredError as f,CommandExecutionError as w,EmptyResultError as a}from"@jackwener/opencli/errors";import{NOTE_EXTRACT_JS as h}from"../xiaohongshu/note.js";import{buildNoteUrl as g,parseNoteId as p}from"../xiaohongshu/note-helpers.js";const y="Pass a full rednote.com note URL with xsec_token from search results or user/profile context.";u({site:"rednote",name:"note",access:"read",description:"Read note body and engagement counts from a rednote note",domain:"www.rednote.com",strategy:m.COOKIE,navigateBefore:!1,args:[{name:"note-id",required:!0,positional:!0,help:"Full rednote note URL with xsec_token"}],columns:["field","value"],func:async(o,l)=>{const r=String(l["note-id"]),d=p(r),c=g(r,{commandName:"rednote note",cookieRoot:"rednote.com",signedUrlHint:y});await o.goto(c);await o.wait({time:2+Math.random()*3});const t=await o.evaluate(h);if(!t||typeof t!=="object")throw new a("rednote/note","Unexpected evaluate response");if(t.securityBlock)throw new w("Rednote security block: the note detail page was blocked by risk control.",/^https?:\/\//.test(r)?"The page may be temporarily restricted. Try again later or from a different session.":"Try using a full URL from search results (with xsec_token) instead of a bare note ID.");if(t.loginWall)throw new f("www.rednote.com","Note content requires login");if(t.notFound)throw new a("rednote/note",`Note ${d} not found or unavailable — it may have been deleted or restricted`);const e=t,n=(s)=>/^\d+/.test(s)?s:"0";if(!e.title&&!e.author)throw new a("rednote/note","The note page loaded without visible content. The note may be deleted or restricted.");const i=[{field:"title",value:e.title||""},{field:"author",value:e.author||""},{field:"content",value:e.desc||""},{field:"likes",value:n(e.likes||"")},{field:"collects",value:n(e.collects||"")},{field:"comments",value:n(e.comments||"")}];if(e.tags?.length)i.push({field:"tags",value:e.tags.join(", ")});return i}});

package/clis/rednote/notifications.js

@@ -1,4 +1,4 @@
-import{cli as f,Strategy as l}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as a}from"@jackwener/opencli/errors";const p=new Set(["mentions","likes","connections"]);function u(t){const e=String(t??"mentions");if(!p.has(e))throw new n(`--type must be one of mentions, likes, or connections, got ${JSON.stringify(t)}`);return e}function d(t){const e=Number(t??20);if(!Number.isFinite(e)||!Number.isInteger(e))throw new n(`--limit must be a positive integer, got ${JSON.stringify(t)}`);if(e<1)throw new n(`--limit must be a positive integer, got ${e}`);return e}const g=`
+import{cli as l,Strategy as f}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as a}from"@jackwener/opencli/errors";const p=new Set(["mentions","likes","connections"]);function u(t){const e=String(t??"mentions");if(!p.has(e))throw new n(`--type must be one of mentions, likes, or connections, got ${JSON.stringify(t)}`);return e}function d(t){const e=Number(t??20);if(!Number.isFinite(e)||!Number.isInteger(e))throw new n(`--limit must be a positive integer, got ${JSON.stringify(t)}`);if(e<1)throw new n(`--limit must be a positive integer, got ${e}`);return e}const g=`
   (async (type) => {
     let pinia = null;
     const probe = (el) => el?.__vue_app__?.config?.globalProperties?.$pinia ?? null;
@@ -64,4 +64,4 @@ import{cli as f,Strategy as l}from"@jackwener/opencli/registry";import{ArgumentE
       })),
     };
   })(${JSON.stringify("PLACEHOLDER_TYPE")})
-`;export const command=f({site:"rednote",name:"notifications",access:"read",description:"Rednote notifications (mentions/likes/connections)",domain:"www.rednote.com",strategy:l.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"type",default:"mentions",help:"Notification type: mentions, likes, or connections"},{name:"limit",type:"int",default:20,help:"Number of notifications to return"}],columns:["rank","user","action","content","note","time"],func:async(t,e)=>{const o=u(e.type),s=d(e.limit);await t.goto("https://www.rednote.com/notification");await t.wait({time:2});const r=g.replace(JSON.stringify("PLACEHOLDER_TYPE"),JSON.stringify(o)),i=await t.evaluate(r);if(!i||typeof i!=="object")throw new a("rednote notifications: unexpected evaluate response");if(i.error)throw new a(`rednote notifications: ${i.error}${i.detail?" ("+i.detail+")":""}`,"The rednote SPA may still be hydrating; reload www.rednote.com/notification and retry.");return(i.items||[]).slice(0,s).map((c,m)=>({rank:m+1,...c}))}});
+`;export const command=l({site:"rednote",name:"notifications",access:"read",description:"Rednote notifications (mentions/likes/connections)",domain:"www.rednote.com",strategy:f.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"type",default:"mentions",help:"Notification type: mentions, likes, or connections"},{name:"limit",type:"int",default:20,help:"Number of notifications to return"}],columns:["rank","user","action","content","note","time"],func:async(t,e)=>{const o=u(e.type),r=d(e.limit);await t.goto("https://www.rednote.com/notification");await t.wait({time:2});const s=g.replace(JSON.stringify("PLACEHOLDER_TYPE"),JSON.stringify(o)),i=await t.evaluate(s);if(!i||typeof i!=="object")throw new a("rednote notifications: unexpected evaluate response");if(i.error)throw new a(`rednote notifications: ${i.error}${i.detail?" ("+i.detail+")":""}`,"The rednote SPA may still be hydrating; reload www.rednote.com/notification and retry.");return(i.items||[]).slice(0,r).map((c,m)=>({rank:m+1,...c}))}});

package/clis/rednote/search.js

@@ -1,4 +1,4 @@
-import{cli as V,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentError as K,AuthRequiredError as Y,CommandExecutionError as Z}from"@jackwener/opencli/errors";import{buildScrollUntilJs as $,buildSearchExtractJs as f,noteIdToDate as D,unwrapEvaluateResult as M}from"../xiaohongshu/search.js";function F(B){const z=Number(B);if(!Number.isFinite(z)||!Number.isInteger(z))throw new K(`--limit must be an integer between 1 and 100, got ${JSON.stringify(B)}`);if(z<1||z>100)throw new K(`--limit must be between 1 and 100, got ${z}`);return z}function L(B){const z=M(B);if(!Array.isArray(z))throw new Z("Unexpected Rednote search extraction payload shape; expected an array of rows.");return z}const U=`
+import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{ArgumentError as n,AuthRequiredError as u,CommandExecutionError as d}from"@jackwener/opencli/errors";import{buildScrollUntilJs as m,buildSearchExtractJs as w,noteIdToDate as f,unwrapEvaluateResult as i}from"../xiaohongshu/search.js";function h(t){const e=Number(t);if(!Number.isFinite(e)||!Number.isInteger(e))throw new n(`--limit must be an integer between 1 and 100, got ${JSON.stringify(t)}`);if(e<1||e>100)throw new n(`--limit must be between 1 and 100, got ${e}`);return e}function b(t){const e=i(t);if(!Array.isArray(e))throw new d("Unexpected Rednote search extraction payload shape; expected an array of rows.");return e}const y=`
   new Promise((resolve) => {
     const hasLoginModal = () => {
       const candidates = document.querySelectorAll(
@@ -29,4 +29,4 @@ import{cli as V,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentE
     observer.observe(document.body, { childList: true, subtree: true });
     setTimeout(() => { observer.disconnect(); resolve('timeout'); }, 5000);
   })
-`;V({site:"rednote",name:"search",access:"read",description:"Search rednote notes",domain:"www.rednote.com",strategy:X.COOKIE,navigateBefore:!1,args:[{name:"query",required:!0,positional:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["rank","title","author","likes","published_at","url","author_url"],func:async(B,z)=>{const H=F(z.limit??20),P=encodeURIComponent(z.query);await B.goto(`https://www.rednote.com/search_result?keyword=${P}&source=web_search_result_notes`);if(M(await B.evaluate(U))==="login_wall")throw new Y("www.rednote.com","Rednote search results are blocked behind a login wall");await B.evaluate($(H));return L(await B.evaluate(f("www.rednote.com"))).filter((G)=>G.title).slice(0,H).map((G,Q)=>({rank:Q+1,...G,published_at:D(G.url)}))}});
+`;l({site:"rednote",name:"search",access:"read",description:"Search rednote notes",domain:"www.rednote.com",strategy:c.COOKIE,navigateBefore:!1,args:[{name:"query",required:!0,positional:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["rank","title","author","likes","published_at","url","author_url"],func:async(t,e)=>{const o=h(e.limit??20),s=encodeURIComponent(e.query);await t.goto(`https://www.rednote.com/search_result?keyword=${s}&source=web_search_result_notes`);if(i(await t.evaluate(y))==="login_wall")throw new u("www.rednote.com","Rednote search results are blocked behind a login wall");await t.evaluate(m(o));return b(await t.evaluate(w("www.rednote.com"))).filter((r)=>r.title).slice(0,o).map((r,a)=>({rank:a+1,...r,published_at:f(r.url)}))}});

package/clis/rest-countries/country.js

@@ -1 +1 @@
-import{cli as Q,Strategy as V}from"@jackwener/opencli/registry";import{EmptyResultError as W}from"@jackwener/opencli/errors";import{COUNTRY_FIELDS as X,REST_COUNTRIES_BASE as Z,projectCountry as $,requireBoundedInt as f,requireString as x,restCountriesFetch as A}from"./utils.js";Q({site:"rest-countries",name:"country",access:"read",description:"Look up countries by name (common / official, substring match)",domain:"restcountries.com",strategy:V.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Country name (e.g. "japan", "united kingdom")'},{name:"limit",type:"int",default:25,help:"Max rows (1-250)"}],columns:["rank","commonName","officialName","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","latitude","longitude","timezones","independent","unMember","landlocked","flag","url"],func:async(G)=>{const H=x(G.name,"name"),M=f(G.limit,25,250),P=`${Z}/name/${encodeURIComponent(H)}?fields=${X}`,J=await A(P,"rest-countries country"),K=Array.isArray(J)?J:[];if(!K.length)throw new W("rest-countries country",`No countries matched "${H}".`);return[...K].sort((v,z)=>(z?.population??0)-(v?.population??0)).slice(0,M).map((v,z)=>({rank:z+1,...$(v)}))}});
+import{cli as s,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{COUNTRY_FIELDS as l,REST_COUNTRIES_BASE as p,projectCountry as d,requireBoundedInt as y,requireString as f,restCountriesFetch as g}from"./utils.js";s({site:"rest-countries",name:"country",access:"read",description:"Look up countries by name (common / official, substring match)",domain:"restcountries.com",strategy:u.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Country name (e.g. "japan", "united kingdom")'},{name:"limit",type:"int",default:25,help:"Max rows (1-250)"}],columns:["rank","commonName","officialName","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","latitude","longitude","timezones","independent","unMember","landlocked","flag","url"],func:async(n)=>{const o=f(n.name,"name"),a=y(n.limit,25,250),c=`${p}/name/${encodeURIComponent(o)}?fields=${l}`,r=await g(c,"rest-countries country"),i=Array.isArray(r)?r:[];if(!i.length)throw new m("rest-countries country",`No countries matched "${o}".`);return[...i].sort((e,t)=>(t?.population??0)-(e?.population??0)).slice(0,a).map((e,t)=>({rank:t+1,...d(e)}))}});

package/clis/rest-countries/region.js

@@ -1 +1 @@
-import{cli as c,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{COUNTRY_FIELDS as m,REST_COUNTRIES_BASE as g,projectCountry as p,requireBoundedInt as d,requireRegion as f,restCountriesFetch as y}from"./utils.js";c({site:"rest-countries",name:"region",access:"read",description:"List countries in a region (africa / americas / asia / europe / oceania / antarctic)",domain:"restcountries.com",strategy:u.PUBLIC,browser:!1,args:[{name:"region",positional:!0,required:!0,help:"Region name (case-insensitive)"},{name:"limit",type:"int",default:250,help:"Max rows (1-250)"}],columns:["rank","commonName","officialName","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","latitude","longitude","timezones","independent","unMember","landlocked","flag","url"],func:async(i)=>{const n=f(i.region),a=d(i.limit,250,250),s=`${g}/region/${encodeURIComponent(n)}?fields=${m}`,o=await y(s,"rest-countries region"),t=Array.isArray(o)?o:[];if(!t.length)throw new l("rest-countries region",`No countries returned for region "${n}".`);return[...t].sort((e,r)=>(r?.population??0)-(e?.population??0)).slice(0,a).map((e,r)=>({rank:r+1,...p(e)}))}});
+import{cli as c,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{COUNTRY_FIELDS as m,REST_COUNTRIES_BASE as p,projectCountry as g,requireBoundedInt as d,requireRegion as f,restCountriesFetch as y}from"./utils.js";c({site:"rest-countries",name:"region",access:"read",description:"List countries in a region (africa / americas / asia / europe / oceania / antarctic)",domain:"restcountries.com",strategy:u.PUBLIC,browser:!1,args:[{name:"region",positional:!0,required:!0,help:"Region name (case-insensitive)"},{name:"limit",type:"int",default:250,help:"Max rows (1-250)"}],columns:["rank","commonName","officialName","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","latitude","longitude","timezones","independent","unMember","landlocked","flag","url"],func:async(n)=>{const o=f(n.region),a=d(n.limit,250,250),s=`${p}/region/${encodeURIComponent(o)}?fields=${m}`,i=await y(s,"rest-countries region"),t=Array.isArray(i)?i:[];if(!t.length)throw new l("rest-countries region",`No countries returned for region "${o}".`);return[...t].sort((e,r)=>(r?.population??0)-(e?.population??0)).slice(0,a).map((e,r)=>({rank:r+1,...g(e)}))}});

package/clis/rest-countries/utils.js

@@ -1 +1 @@
-import{ArgumentError as H,CommandExecutionError as K,EmptyResultError as M}from"@jackwener/opencli/errors";export const REST_COUNTRIES_BASE="https://restcountries.com/v3.1";const Q="opencli-rest-countries-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)";export const REST_COUNTRIES_REGIONS=new Set(["africa","americas","asia","europe","oceania","antarctic"]),COUNTRY_FIELDS=["name","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","flag","latlng","timezones","independent","unMember","landlocked"].join(",");export function requireString(q,z){const B=String(q??"").trim();if(!B)throw new H(`rest-countries ${z} cannot be empty`);return B}export function requireBoundedInt(q,z,B,D="limit"){const F=q??z,J=typeof F==="number"?F:Number(F);if(!Number.isInteger(J)||J<=0)throw new H(`rest-countries ${D} must be a positive integer`);if(J>B)throw new H(`rest-countries ${D} must be <= ${B}`);return J}export function requireRegion(q){const z=String(q??"").trim().toLowerCase();if(!z)throw new H('rest-countries region is required (e.g. "europe", "asia")');if(!REST_COUNTRIES_REGIONS.has(z))throw new H(`rest-countries region "${q}" is not recognised`,`Allowed regions: ${[...REST_COUNTRIES_REGIONS].join(", ")}.`);return z}export async function restCountriesFetch(q,z){let B;try{B=await fetch(q,{headers:{"user-agent":Q,accept:"application/json"}})}catch(F){throw new K(`${z} request failed: ${F?.message??F}`,"Check that restcountries.com is reachable from this network.")}if(B.status===404)throw new M(z,`REST Countries returned 404 for ${q}.`);if(B.status===429)throw new K(`${z} returned HTTP 429 (rate limited)`);if(!B.ok)throw new K(`${z} returned HTTP ${B.status}`);let D;try{D=await B.json()}catch(F){throw new K(`${z} returned malformed JSON: ${F?.message??F}`)}return D}export function joinCurrencies(q){if(!q||typeof q!=="object")return"";return Object.entries(q).map(([z,B])=>{const D=B&&typeof B.name==="string"?B.name:"";return D?`${z} (${D})`:z}).join(", ")}export function joinLanguages(q){if(!q||typeof q!=="object")return"";return Object.values(q).filter((z)=>typeof z==="string"&&z.trim()).join(", ")}export function projectCountry(q){const z=q?.name?.common??null,B=q?.name?.official??null,D=typeof q?.cca3==="string"?q.cca3:null;return{commonName:typeof z==="string"?z:null,officialName:typeof B==="string"?B:null,cca2:typeof q?.cca2==="string"?q.cca2:null,cca3:D,ccn3:typeof q?.ccn3==="string"?q.ccn3:null,capital:Array.isArray(q?.capital)?q.capital.join(", "):null,region:typeof q?.region==="string"?q.region:null,subregion:typeof q?.subregion==="string"?q.subregion:null,population:typeof q?.population==="number"?q.population:null,area:typeof q?.area==="number"?q.area:null,languages:joinLanguages(q?.languages),currencies:joinCurrencies(q?.currencies),latitude:Array.isArray(q?.latlng)&&typeof q.latlng[0]==="number"?q.latlng[0]:null,longitude:Array.isArray(q?.latlng)&&typeof q.latlng[1]==="number"?q.latlng[1]:null,timezones:Array.isArray(q?.timezones)?q.timezones.join(", "):null,independent:typeof q?.independent==="boolean"?q.independent:null,unMember:typeof q?.unMember==="boolean"?q.unMember:null,landlocked:typeof q?.landlocked==="boolean"?q.landlocked:null,flag:typeof q?.flag==="string"?q.flag:null,url:D?`https://restcountries.com/v3.1/alpha/${D.toLowerCase()}`:""}}
+import{ArgumentError as i,CommandExecutionError as s,EmptyResultError as u}from"@jackwener/opencli/errors";export const REST_COUNTRIES_BASE="https://restcountries.com/v3.1";const l="opencli-rest-countries-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)";export const REST_COUNTRIES_REGIONS=new Set(["africa","americas","asia","europe","oceania","antarctic"]),COUNTRY_FIELDS=["name","cca2","cca3","ccn3","capital","region","subregion","population","area","languages","currencies","flag","latlng","timezones","independent","unMember","landlocked"].join(",");export function requireString(e,t){const n=String(e??"").trim();if(!n)throw new i(`rest-countries ${t} cannot be empty`);return n}export function requireBoundedInt(e,t,n,r="limit"){const o=e??t,a=typeof o==="number"?o:Number(o);if(!Number.isInteger(a)||a<=0)throw new i(`rest-countries ${r} must be a positive integer`);if(a>n)throw new i(`rest-countries ${r} must be <= ${n}`);return a}export function requireRegion(e){const t=String(e??"").trim().toLowerCase();if(!t)throw new i('rest-countries region is required (e.g. "europe", "asia")');if(!REST_COUNTRIES_REGIONS.has(t))throw new i(`rest-countries region "${e}" is not recognised`,`Allowed regions: ${[...REST_COUNTRIES_REGIONS].join(", ")}.`);return t}export async function restCountriesFetch(e,t){let n;try{n=await fetch(e,{headers:{"user-agent":l,accept:"application/json"}})}catch(o){throw new s(`${t} request failed: ${o?.message??o}`,"Check that restcountries.com is reachable from this network.")}if(n.status===404)throw new u(t,`REST Countries returned 404 for ${e}.`);if(n.status===429)throw new s(`${t} returned HTTP 429 (rate limited)`);if(!n.ok)throw new s(`${t} returned HTTP ${n.status}`);let r;try{r=await n.json()}catch(o){throw new s(`${t} returned malformed JSON: ${o?.message??o}`)}return r}export function joinCurrencies(e){if(!e||typeof e!=="object")return"";return Object.entries(e).map(([t,n])=>{const r=n&&typeof n.name==="string"?n.name:"";return r?`${t} (${r})`:t}).join(", ")}export function joinLanguages(e){if(!e||typeof e!=="object")return"";return Object.values(e).filter((t)=>typeof t==="string"&&t.trim()).join(", ")}export function projectCountry(e){const t=e?.name?.common??null,n=e?.name?.official??null,r=typeof e?.cca3==="string"?e.cca3:null;return{commonName:typeof t==="string"?t:null,officialName:typeof n==="string"?n:null,cca2:typeof e?.cca2==="string"?e.cca2:null,cca3:r,ccn3:typeof e?.ccn3==="string"?e.ccn3:null,capital:Array.isArray(e?.capital)?e.capital.join(", "):null,region:typeof e?.region==="string"?e.region:null,subregion:typeof e?.subregion==="string"?e.subregion:null,population:typeof e?.population==="number"?e.population:null,area:typeof e?.area==="number"?e.area:null,languages:joinLanguages(e?.languages),currencies:joinCurrencies(e?.currencies),latitude:Array.isArray(e?.latlng)&&typeof e.latlng[0]==="number"?e.latlng[0]:null,longitude:Array.isArray(e?.latlng)&&typeof e.latlng[1]==="number"?e.latlng[1]:null,timezones:Array.isArray(e?.timezones)?e.timezones.join(", "):null,independent:typeof e?.independent==="boolean"?e.independent:null,unMember:typeof e?.unMember==="boolean"?e.unMember:null,landlocked:typeof e?.landlocked==="boolean"?e.landlocked:null,flag:typeof e?.flag==="string"?e.flag:null,url:r?`https://restcountries.com/v3.1/alpha/${r.toLowerCase()}`:""}}

package/clis/reuters/article-detail.js

@@ -1 +1 @@
-import{ArgumentError as a,AuthRequiredError as n,CommandExecutionError as o,EmptyResultError as u}from"@jackwener/opencli/errors";import{cli as s,Strategy as c}from"@jackwener/opencli/registry";import{buildArticleDetailScript as d,mapArticleDetail as w}from"./utils.js";const m=/^https?:\/\/(?:www\.)?reuters\.com\//i;s({site:"reuters",name:"article-detail",access:"read",description:"Reuters 路透社文章详情：标题/作者/正文文本",domain:"www.reuters.com",strategy:c.COOKIE,args:[{name:"url",required:!0,positional:!0,help:"Reuters article URL (must be on reuters.com)"}],columns:["title","date","section","section_path","authors","description","word_count","url","body"],func:async(i,l)=>{const t=String(l.url||"").trim();if(!t)throw new a("Article URL cannot be empty");if(!m.test(t))throw new a(`URL must be on reuters.com, got ${t}`);await i.goto(t);await i.wait(2);const e=await i.evaluate(d());if(e?.error)throw new o(`Reuters article-detail failed inside the page: ${e.error}`);if(e?.authRequired)throw new n("www.reuters.com","Reuters article-detail is gated by login, subscription, or human verification");if(!e||e.ok!==!0)throw new o("Reuters article-detail returned no payload","Check that the URL points to a Reuters article and that the page loaded");const r=w(e.body?.article,e.body?.bodyText,t);if(!r||!r.title&&!r.body)throw new u("reuters article-detail","Page rendered no article body — likely paywalled or a non-article URL");return[r]}});
+import{ArgumentError as o,AuthRequiredError as l,CommandExecutionError as a,EmptyResultError as s}from"@jackwener/opencli/errors";import{cli as u,Strategy as c}from"@jackwener/opencli/registry";import{buildArticleDetailScript as d,mapArticleDetail as w}from"./utils.js";const m=/^https?:\/\/(?:www\.)?reuters\.com\//i;u({site:"reuters",name:"article-detail",access:"read",description:"Reuters 路透社文章详情：标题/作者/正文文本",domain:"www.reuters.com",strategy:c.COOKIE,args:[{name:"url",required:!0,positional:!0,help:"Reuters article URL (must be on reuters.com)"}],columns:["title","date","section","section_path","authors","description","word_count","url","body"],func:async(i,n)=>{const t=String(n.url||"").trim();if(!t)throw new o("Article URL cannot be empty");if(!m.test(t))throw new o(`URL must be on reuters.com, got ${t}`);await i.goto(t);await i.wait(2);const e=await i.evaluate(d());if(e?.error)throw new a(`Reuters article-detail failed inside the page: ${e.error}`);if(e?.authRequired)throw new l("www.reuters.com","Reuters article-detail is gated by login, subscription, or human verification");if(!e||e.ok!==!0)throw new a("Reuters article-detail returned no payload","Check that the URL points to a Reuters article and that the page loaded");const r=w(e.body?.article,e.body?.bodyText,t);if(!r||!r.title&&!r.body)throw new s("reuters article-detail","Page rendered no article body — likely paywalled or a non-article URL");return[r]}});

package/clis/reuters/auth.js

@@ -1,4 +1,4 @@
-import{AuthRequiredError as D,CommandExecutionError as F}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as H}from"../_shared/site-auth.js";async function G(B){await B.goto("https://www.reuters.com/");await B.wait(2);const z=await B.evaluate(`
+import{AuthRequiredError as r,CommandExecutionError as i}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as o}from"../_shared/site-auth.js";async function s(t){await t.goto("https://www.reuters.com/");await t.wait(2);const e=await t.evaluate(`
     (() => {
       try {
         const subStateRaw = localStorage.getItem('rcom-subscription-state');
@@ -31,9 +31,9 @@ import{AuthRequiredError as D,CommandExecutionError as F}from"@jackwener/opencli
         return { kind: 'exception', detail: String(e && e.message || e) };
       }
     })()
-  `);if(z?.kind==="auth")throw new D("reuters.com",z.detail);if(z?.kind==="exception")throw new F(`Reuters whoami failed: ${z.detail}`);if(!z?.ok)throw new F(`Unexpected Reuters probe: ${JSON.stringify(z)}`);return{user_id:z.user_id,subscribed:z.subscribed}}H({site:"reuters",domain:"reuters.com",loginUrl:"https://www.reuters.com/account/sign-in/",columns:["user_id","subscribed"],verify:G,poll:async(B)=>{if(!await B.evaluate(`(() => {
+  `);if(e?.kind==="auth")throw new r("reuters.com",e.detail);if(e?.kind==="exception")throw new i(`Reuters whoami failed: ${e.detail}`);if(!e?.ok)throw new i(`Unexpected Reuters probe: ${JSON.stringify(e)}`);return{user_id:e.user_id,subscribed:e.subscribed}}o({site:"reuters",domain:"reuters.com",loginUrl:"https://www.reuters.com/account/sign-in/",columns:["user_id","subscribed"],verify:s,poll:async(t)=>{if(!await t.evaluate(`(() => {
       try {
         const raw = localStorage.getItem('rcom-subscription-state');
         return raw ? JSON.parse(raw).isLoggedIn === true : false;
       } catch { return false; }
-    })()`))throw new D("reuters.com","Waiting for Reuters login");return G(B)}});
+    })()`))throw new r("reuters.com","Waiting for Reuters login");return s(t)}});

package/clis/reuters/search.js

@@ -1 +1 @@
-import{ArgumentError as u,AuthRequiredError as c,CommandExecutionError as r,EmptyResultError as h}from"@jackwener/opencli/errors";import{cli as w,Strategy as m}from"@jackwener/opencli/registry";import{buildSearchScript as l,isAuthStatus as d,looksAuthWallText as p,mapSearchArticles as y,parseLimit as f}from"./utils.js";w({site:"reuters",name:"search",access:"read",description:"Reuters 路透社新闻搜索",domain:"www.reuters.com",strategy:m.COOKIE,args:[{name:"query",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (1-40)"}],columns:["rank","title","date","section","section_path","authors","url"],func:async(t,o)=>{const i=f(o.limit),s=String(o.query||"").trim();if(!s)throw new u("Search query cannot be empty","Provide a non-empty keyword");await t.goto("https://www.reuters.com");await t.wait(2);const e=await t.evaluate(l(s,i));if(e?.error)throw new r(`Reuters search failed inside the page: ${e.error}`);if(!e||typeof e!=="object")throw new r("Reuters search API returned an unreadable response");if(d(e.status)||p(e.textPreview))throw new c("www.reuters.com",`Reuters search requires an accessible Reuters browser session or completed human verification${e.status?` (HTTP ${e.status})`:""}`);if(e.ok!==!0){const a=Number.isFinite(e.status)&&e.status>0?`HTTP ${e.status}${e.statusText?` ${e.statusText}`:""}`:"no upstream response";throw new r(`Reuters search API failed (${a})`)}if(!e.body){const a=e.parseError?`: ${e.parseError}`:"";throw new r(`Reuters search returned a non-JSON body${a}`,"Open www.reuters.com in your browser and clear any challenge before retrying.")}const n=y(e.body,i);if(!n.length)throw new h("reuters search",`No articles matched "${s}". Try broadening the query.`);return n}});
+import{ArgumentError as u,AuthRequiredError as c,CommandExecutionError as r,EmptyResultError as w}from"@jackwener/opencli/errors";import{cli as m,Strategy as h}from"@jackwener/opencli/registry";import{buildSearchScript as l,isAuthStatus as d,looksAuthWallText as p,mapSearchArticles as y,parseLimit as f}from"./utils.js";m({site:"reuters",name:"search",access:"read",description:"Reuters 路透社新闻搜索",domain:"www.reuters.com",strategy:h.COOKIE,args:[{name:"query",required:!0,positional:!0,help:"Search query"},{name:"limit",type:"int",default:10,help:"Number of results (1-40)"}],columns:["rank","title","date","section","section_path","authors","url"],func:async(t,o)=>{const i=f(o.limit),s=String(o.query||"").trim();if(!s)throw new u("Search query cannot be empty","Provide a non-empty keyword");await t.goto("https://www.reuters.com");await t.wait(2);const e=await t.evaluate(l(s,i));if(e?.error)throw new r(`Reuters search failed inside the page: ${e.error}`);if(!e||typeof e!=="object")throw new r("Reuters search API returned an unreadable response");if(d(e.status)||p(e.textPreview))throw new c("www.reuters.com",`Reuters search requires an accessible Reuters browser session or completed human verification${e.status?` (HTTP ${e.status})`:""}`);if(e.ok!==!0){const a=Number.isFinite(e.status)&&e.status>0?`HTTP ${e.status}${e.statusText?` ${e.statusText}`:""}`:"no upstream response";throw new r(`Reuters search API failed (${a})`)}if(!e.body){const a=e.parseError?`: ${e.parseError}`:"";throw new r(`Reuters search returned a non-JSON body${a}`,"Open www.reuters.com in your browser and clear any challenge before retrying.")}const n=y(e.body,i);if(!n.length)throw new w("reuters search",`No articles matched "${s}". Try broadening the query.`);return n}});

package/clis/reuters/utils.js

@@ -1,10 +1,10 @@
-import{ArgumentError as P}from"@jackwener/opencli/errors";const J=1,K=40;export function parseLimit(z,B=10){if(z===void 0||z===null||z==="")return B;const C=Number(z);if(!Number.isFinite(C)||!Number.isInteger(C))throw new P(`--limit must be an integer between ${J} and ${K}, got ${JSON.stringify(z)}`);if(C<J||C>K)throw new P(`--limit must be between ${J} and ${K}, got ${C}`);return C}export function buildSearchScript(z,B){return`
+import{ArgumentError as a}from"@jackwener/opencli/errors";const o=1,s=40;export function parseLimit(t,e=10){if(t===void 0||t===null||t==="")return e;const r=Number(t);if(!Number.isFinite(r)||!Number.isInteger(r))throw new a(`--limit must be an integer between ${o} and ${s}, got ${JSON.stringify(t)}`);if(r<o||r>s)throw new a(`--limit must be between ${o} and ${s}, got ${r}`);return r}export function buildSearchScript(t,e){return`
     (async () => {
       const apiQuery = JSON.stringify({
-        keyword: ${JSON.stringify(z)},
+        keyword: ${JSON.stringify(t)},
         offset: 0,
         orderby: 'display_date:desc',
-        size: ${B},
+        size: ${e},
         website: 'reuters'
       });
       const apiUrl = 'https://www.reuters.com/pf/api/v3/content/fetch/articles-by-search-v2?query=' + encodeURIComponent(apiQuery);
@@ -47,4 +47,4 @@ import{ArgumentError as P}from"@jackwener/opencli/errors";const J=1,K=40;export
         return { ok: false, error: String((e && e.message) || e) };
       }
     })()
-  `}export function isAuthStatus(z){return Number(z)===401||Number(z)===403}export function looksAuthWallText(z){const B=String(z??"").toLowerCase();return/datadome|captcha|verify you are human|human verification|access to this page has been denied|unusual traffic|subscribe to continue|subscription required|sign in to (continue|read|access)|log in to (continue|read|access)/.test(B)}function Q(z){if(!Array.isArray(z))return null;const B=z.map((C)=>typeof C==="string"?C:C?.name||C?.byline||"").map((C)=>String(C).trim()).filter(Boolean);return B.length?B.join(", "):null}function H(z){const B=String(z??"").trim();return B?B:null}function S(z){const B=String(z??"").trim();if(!B)return null;return B.split("T")[0]}function V(z){if(!z)return null;const B=String(z);if(/^https?:\/\//i.test(B))return B;return"https://www.reuters.com"+B}export function mapSearchArticles(z,B){const C=z?.result?.articles||z?.articles||[];if(!Array.isArray(C))return[];return C.filter((G)=>G&&typeof G==="object").slice(0,B).map((G,Y)=>({rank:Y+1,title:H(G.title||G.headlines?.basic),date:S(G.display_date||G.published_time),section:H(G.taxonomy?.section?.name),section_path:H(G.taxonomy?.section?.path),authors:Q(G.authors),url:V(G.canonical_url)})).filter((G)=>G.title&&G.url)}export function mapArticleDetail(z,B,C=null){if(!z&&!B)return null;return{title:H(z?.title||z?.headlines?.basic),date:S(z?.display_date||z?.published_time),section:H(z?.taxonomy?.section?.name),section_path:H(z?.taxonomy?.section?.path),authors:Q(z?.authors),description:H(z?.description?.basic||z?.subheadlines?.basic),word_count:Number.isFinite(z?.word_count)?z.word_count:null,url:V(z?.canonical_url)||H(C),body:H(B)}}export const __test__={MIN_LIMIT:J,MAX_LIMIT:K};
+  `}export function isAuthStatus(t){return Number(t)===401||Number(t)===403}export function looksAuthWallText(t){const e=String(t??"").toLowerCase();return/datadome|captcha|verify you are human|human verification|access to this page has been denied|unusual traffic|subscribe to continue|subscription required|sign in to (continue|read|access)|log in to (continue|read|access)/.test(e)}function u(t){if(!Array.isArray(t))return null;const e=t.map((r)=>typeof r==="string"?r:r?.name||r?.byline||"").map((r)=>String(r).trim()).filter(Boolean);return e.length?e.join(", "):null}function i(t){const e=String(t??"").trim();return e?e:null}function c(t){const e=String(t??"").trim();if(!e)return null;return e.split("T")[0]}function l(t){if(!t)return null;const e=String(t);if(/^https?:\/\//i.test(e))return e;return"https://www.reuters.com"+e}export function mapSearchArticles(t,e){const r=t?.result?.articles||t?.articles||[];if(!Array.isArray(r))return[];return r.filter((n)=>n&&typeof n==="object").slice(0,e).map((n,p)=>({rank:p+1,title:i(n.title||n.headlines?.basic),date:c(n.display_date||n.published_time),section:i(n.taxonomy?.section?.name),section_path:i(n.taxonomy?.section?.path),authors:u(n.authors),url:l(n.canonical_url)})).filter((n)=>n.title&&n.url)}export function mapArticleDetail(t,e,r=null){if(!t&&!e)return null;return{title:i(t?.title||t?.headlines?.basic),date:c(t?.display_date||t?.published_time),section:i(t?.taxonomy?.section?.name),section_path:i(t?.taxonomy?.section?.path),authors:u(t?.authors),description:i(t?.description?.basic||t?.subheadlines?.basic),word_count:Number.isFinite(t?.word_count)?t.word_count:null,url:l(t?.canonical_url)||i(r),body:i(e)}}export const __test__={MIN_LIMIT:o,MAX_LIMIT:s};

package/clis/rfc/rfc.js

@@ -1 +1 @@
-import{cli as u,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{RFC_BASE as a,requireRfcNumber as d,rfcFetch as g,trimDate as p}from"./utils.js";u({site:"rfc",name:"rfc",access:"read",description:"Single IETF RFC metadata (title, abstract, working group, authors, std level)",domain:"datatracker.ietf.org",strategy:l.PUBLIC,browser:!1,args:[{name:"number",positional:!0,type:"int",required:!0,help:"RFC number (e.g. 9000, 791, 2616)"}],columns:["rfc","title","state","stdLevel","group","groupType","pages","published","authors","abstract","rfcEditorUrl","url"],func:async(o)=>{const r=d(o.number),e=`rfc${r}`,t=await g(`${a}/doc/${e}/doc.json`,`rfc ${r}`);if(!t||!t.name)throw new m("rfc rfc",`IETF datatracker returned no metadata for RFC ${r}.`);const s=Array.isArray(t.authors)?t.authors.map((n)=>String(n?.name??"").trim()).filter(Boolean).join(", "):"",i=String(t.group?.name??"").trim(),c=String(t.group?.type??"").trim();return[{rfc:r,title:String(t.title??"").trim(),state:String(t.state??"").trim(),stdLevel:String(t.std_level??"").trim(),group:i,groupType:c,pages:t.pages==null?null:Number(t.pages),published:p(t.time),authors:s,abstract:String(t.abstract??"").trim(),rfcEditorUrl:`https://www.rfc-editor.org/rfc/rfc${r}`,url:`${a}/doc/${e}/`}]}});
+import{cli as m,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{RFC_BASE as a,requireRfcNumber as g,rfcFetch as p,trimDate as f}from"./utils.js";m({site:"rfc",name:"rfc",access:"read",description:"Single IETF RFC metadata (title, abstract, working group, authors, std level)",domain:"datatracker.ietf.org",strategy:u.PUBLIC,browser:!1,args:[{name:"number",positional:!0,type:"int",required:!0,help:"RFC number (e.g. 9000, 791, 2616)"}],columns:["rfc","title","state","stdLevel","group","groupType","pages","published","authors","abstract","rfcEditorUrl","url"],func:async(o)=>{const t=g(o.number),e=`rfc${t}`,r=await p(`${a}/doc/${e}/doc.json`,`rfc ${t}`);if(!r||!r.name)throw new l("rfc rfc",`IETF datatracker returned no metadata for RFC ${t}.`);const i=Array.isArray(r.authors)?r.authors.map((c)=>String(c?.name??"").trim()).filter(Boolean).join(", "):"",s=String(r.group?.name??"").trim(),n=String(r.group?.type??"").trim();return[{rfc:t,title:String(r.title??"").trim(),state:String(r.state??"").trim(),stdLevel:String(r.std_level??"").trim(),group:s,groupType:n,pages:r.pages==null?null:Number(r.pages),published:f(r.time),authors:i,abstract:String(r.abstract??"").trim(),rfcEditorUrl:`https://www.rfc-editor.org/rfc/rfc${t}`,url:`${a}/doc/${e}/`}]}});

package/clis/rfc/utils.js

@@ -1 +1 @@
-import{ArgumentError as I,CommandExecutionError as H,EmptyResultError as J}from"@jackwener/opencli/errors";export const RFC_BASE="https://datatracker.ietf.org";const K="opencli-rfc-adapter (+https://github.com/jackwener/OpenCLI)";export function requireRfcNumber(F){const q=F;if(q==null||String(q).trim()==="")throw new I("rfc number is required (e.g. 9000, 791, 2616)",'Pass the integer RFC number; do not include the "rfc" prefix.');const z=String(q).trim().toLowerCase().replace(/^rfc/,""),B=Number.parseInt(z,10);if(!Number.isInteger(B)||B<=0||String(B)!==z)throw new I(`rfc number "${F}" is not a valid RFC number`,"Pass a positive integer (e.g. 9000, 791, 2616).");if(B>999999)throw new I("rfc number must be <= 999999");return B}export async function rfcFetch(F,q){let z;try{z=await fetch(F,{headers:{"user-agent":K,accept:"application/json"}})}catch(G){throw new H(`${q} request failed: ${G?.message??G}`,"Check that datatracker.ietf.org is reachable from this network.")}if(z.status===404)throw new J(q,`IETF datatracker returned 404 for ${F}.`);if(z.status===429)throw new H(`${q} returned HTTP 429 (rate limited)`);if(!z.ok)throw new H(`${q} returned HTTP ${z.status}`);let B;try{B=await z.json()}catch(G){throw new H(`${q} returned malformed JSON: ${G?.message??G}`)}return B}export function trimDate(F){const q=String(F??"").trim();if(!q)return null;if(/^\d{4}-\d{2}-\d{2}/.test(q))return q.slice(0,10);return null}
+import{ArgumentError as s,CommandExecutionError as o,EmptyResultError as a}from"@jackwener/opencli/errors";export const RFC_BASE="https://datatracker.ietf.org";const c="opencli-rfc-adapter (+https://github.com/jackwener/OpenCLI)";export function requireRfcNumber(n){const r=n;if(r==null||String(r).trim()==="")throw new s("rfc number is required (e.g. 9000, 791, 2616)",'Pass the integer RFC number; do not include the "rfc" prefix.');const t=String(r).trim().toLowerCase().replace(/^rfc/,""),e=Number.parseInt(t,10);if(!Number.isInteger(e)||e<=0||String(e)!==t)throw new s(`rfc number "${n}" is not a valid RFC number`,"Pass a positive integer (e.g. 9000, 791, 2616).");if(e>999999)throw new s("rfc number must be <= 999999");return e}export async function rfcFetch(n,r){let t;try{t=await fetch(n,{headers:{"user-agent":c,accept:"application/json"}})}catch(i){throw new o(`${r} request failed: ${i?.message??i}`,"Check that datatracker.ietf.org is reachable from this network.")}if(t.status===404)throw new a(r,`IETF datatracker returned 404 for ${n}.`);if(t.status===429)throw new o(`${r} returned HTTP 429 (rate limited)`);if(!t.ok)throw new o(`${r} returned HTTP ${t.status}`);let e;try{e=await t.json()}catch(i){throw new o(`${r} returned malformed JSON: ${i?.message??i}`)}return e}export function trimDate(n){const r=String(n??"").trim();if(!r)return null;if(/^\d{4}-\d{2}-\d{2}/.test(r))return r.slice(0,10);return null}

package/clis/rubygems/gem.js

@@ -1 +1 @@
-import{cli as i,Strategy as a}from"@jackwener/opencli/registry";import{GEMS_BASE as m,gemsFetch as u,requireGemName as g,trimDate as l}from"./utils.js";i({site:"rubygems",name:"gem",access:"read",description:"Fetch a RubyGems.org gem's metadata (version, downloads, license, links)",domain:"rubygems.org",strategy:a.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Gem name (e.g. "rails", "sidekiq")'}],columns:["gem","version","releasedAt","downloads","versionDownloads","license","authors","homepage","source","bugs","info","url"],func:async(o)=>{const r=g(o.name),n=`${m}/gems/${encodeURIComponent(r)}.json`,e=await u(n,"rubygems gem"),t=Array.isArray(e?.licenses)?e.licenses.filter(Boolean).join(", "):"",s=e?.metadata??{};return[{gem:String(e?.name??r).trim(),version:String(e?.version??"").trim(),releasedAt:l(e?.version_created_at),downloads:e?.downloads!=null?Number(e.downloads):null,versionDownloads:e?.version_downloads!=null?Number(e.version_downloads):null,license:t,authors:String(e?.authors??"").trim(),homepage:String(e?.homepage_uri??"").trim(),source:String(e?.source_code_uri??s.source_code_uri??"").trim(),bugs:String(e?.bug_tracker_uri??s.bug_tracker_uri??"").trim(),info:String(e?.info??"").trim(),url:String(e?.project_uri??`https://rubygems.org/gems/${r}`).trim()}]}});
+import{cli as t,Strategy as a}from"@jackwener/opencli/registry";import{GEMS_BASE as m,gemsFetch as u,requireGemName as l,trimDate as g}from"./utils.js";t({site:"rubygems",name:"gem",access:"read",description:"Fetch a RubyGems.org gem's metadata (version, downloads, license, links)",domain:"rubygems.org",strategy:a.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Gem name (e.g. "rails", "sidekiq")'}],columns:["gem","version","releasedAt","downloads","versionDownloads","license","authors","homepage","source","bugs","info","url"],func:async(s)=>{const r=l(s.name),n=`${m}/gems/${encodeURIComponent(r)}.json`,e=await u(n,"rubygems gem"),i=Array.isArray(e?.licenses)?e.licenses.filter(Boolean).join(", "):"",o=e?.metadata??{};return[{gem:String(e?.name??r).trim(),version:String(e?.version??"").trim(),releasedAt:g(e?.version_created_at),downloads:e?.downloads!=null?Number(e.downloads):null,versionDownloads:e?.version_downloads!=null?Number(e.version_downloads):null,license:i,authors:String(e?.authors??"").trim(),homepage:String(e?.homepage_uri??"").trim(),source:String(e?.source_code_uri??o.source_code_uri??"").trim(),bugs:String(e?.bug_tracker_uri??o.bug_tracker_uri??"").trim(),info:String(e?.info??"").trim(),url:String(e?.project_uri??`https://rubygems.org/gems/${r}`).trim()}]}});

package/clis/rubygems/search.js

@@ -1 +1 @@
-import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as y}from"@jackwener/opencli/errors";import{GEMS_BASE as g,gemsFetch as d,requireBoundedInt as h,requireString as p}from"./utils.js";l({site:"rubygems",name:"search",access:"read",description:"Search RubyGems.org gems by keyword",domain:"rubygems.org",strategy:c.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "rails", "redis")'},{name:"limit",type:"int",default:30,help:"Max gems (1-100, single RubyGems page)"}],columns:["rank","gem","version","downloads","license","authors","info","url"],func:async(s)=>{const n=p(s.query,"query"),i=h(s.limit,30,100),a=`${g}/search.json?query=${encodeURIComponent(n)}&page=1`,o=await d(a,"rubygems search"),t=Array.isArray(o)?o:[];if(!t.length)throw new y("rubygems search",`No gems matched "${n}".`);return t.slice(0,i).map((e,m)=>{const r=String(e.name??"").trim(),u=Array.isArray(e.licenses)?e.licenses.filter(Boolean).join(", "):"";return{rank:m+1,gem:r,version:String(e.version??"").trim(),downloads:e.downloads!=null?Number(e.downloads):null,license:u,authors:String(e.authors??"").trim(),info:String(e.info??"").trim(),url:r?`https://rubygems.org/gems/${r}`:""}})}});
+import{cli as u,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as y}from"@jackwener/opencli/errors";import{GEMS_BASE as d,gemsFetch as g,requireBoundedInt as h,requireString as p}from"./utils.js";u({site:"rubygems",name:"search",access:"read",description:"Search RubyGems.org gems by keyword",domain:"rubygems.org",strategy:c.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search keyword (e.g. "rails", "redis")'},{name:"limit",type:"int",default:30,help:"Max gems (1-100, single RubyGems page)"}],columns:["rank","gem","version","downloads","license","authors","info","url"],func:async(s)=>{const n=p(s.query,"query"),i=h(s.limit,30,100),a=`${d}/search.json?query=${encodeURIComponent(n)}&page=1`,o=await g(a,"rubygems search"),t=Array.isArray(o)?o:[];if(!t.length)throw new y("rubygems search",`No gems matched "${n}".`);return t.slice(0,i).map((e,m)=>{const r=String(e.name??"").trim(),l=Array.isArray(e.licenses)?e.licenses.filter(Boolean).join(", "):"";return{rank:m+1,gem:r,version:String(e.version??"").trim(),downloads:e.downloads!=null?Number(e.downloads):null,license:l,authors:String(e.authors??"").trim(),info:String(e.info??"").trim(),url:r?`https://rubygems.org/gems/${r}`:""}})}});

package/clis/rubygems/utils.js

@@ -1 +1 @@
-import{ArgumentError as I,CommandExecutionError as K,EmptyResultError as L}from"@jackwener/opencli/errors";export const GEMS_BASE="https://rubygems.org/api/v1";const O="opencli-rubygems-adapter (+https://github.com/jackwener/OpenCLI)",P=/^[A-Za-z0-9][A-Za-z0-9._-]*$/;export function requireString(B,q){const z=String(B??"").trim();if(!z)throw new I(`rubygems ${q} cannot be empty`);return z}export function requireBoundedInt(B,q,z,H="limit"){const D=B??q,J=typeof D==="number"?D:Number(D);if(!Number.isInteger(J)||J<=0)throw new I(`rubygems ${H} must be a positive integer`);if(J>z)throw new I(`rubygems ${H} must be <= ${z}`);return J}export function requireGemName(B){const q=String(B??"").trim();if(!q)throw new I('rubygems gem name is required (e.g. "rails", "sidekiq")');if(q.length>100||!P.test(q))throw new I(`rubygems gem "${B}" is not a valid gem name`,'Use letters / digits / "._-", starting with a letter or digit (max 100 chars).');return q}export async function gemsFetch(B,q){let z;try{z=await fetch(B,{headers:{"user-agent":O,accept:"application/json"}})}catch(D){throw new K(`${q} request failed: ${D?.message??D}`,"Check that rubygems.org is reachable from this network.")}if(z.status===404)throw new L(q,`RubyGems returned 404 for ${B}.`);if(z.status===429)throw new K(`${q} returned HTTP 429 (rate limited)`,"RubyGems throttles bursts; wait a few seconds and retry.");if(!z.ok)throw new K(`${q} returned HTTP ${z.status}`);let H;try{H=await z.json()}catch(D){throw new K(`${q} returned malformed JSON: ${D?.message??D}`)}return H}export function trimDate(B){const q=String(B??"").trim();if(!q)return null;const z=q.replace(/\.\d+/,"");return z.endsWith("Z")?z:`${z}Z`}
+import{ArgumentError as i,CommandExecutionError as u,EmptyResultError as m}from"@jackwener/opencli/errors";export const GEMS_BASE="https://rubygems.org/api/v1";const a="opencli-rubygems-adapter (+https://github.com/jackwener/OpenCLI)",c=/^[A-Za-z0-9][A-Za-z0-9._-]*$/;export function requireString(r,t){const e=String(r??"").trim();if(!e)throw new i(`rubygems ${t} cannot be empty`);return e}export function requireBoundedInt(r,t,e,s="limit"){const n=r??t,o=typeof n==="number"?n:Number(n);if(!Number.isInteger(o)||o<=0)throw new i(`rubygems ${s} must be a positive integer`);if(o>e)throw new i(`rubygems ${s} must be <= ${e}`);return o}export function requireGemName(r){const t=String(r??"").trim();if(!t)throw new i('rubygems gem name is required (e.g. "rails", "sidekiq")');if(t.length>100||!c.test(t))throw new i(`rubygems gem "${r}" is not a valid gem name`,'Use letters / digits / "._-", starting with a letter or digit (max 100 chars).');return t}export async function gemsFetch(r,t){let e;try{e=await fetch(r,{headers:{"user-agent":a,accept:"application/json"}})}catch(n){throw new u(`${t} request failed: ${n?.message??n}`,"Check that rubygems.org is reachable from this network.")}if(e.status===404)throw new m(t,`RubyGems returned 404 for ${r}.`);if(e.status===429)throw new u(`${t} returned HTTP 429 (rate limited)`,"RubyGems throttles bursts; wait a few seconds and retry.");if(!e.ok)throw new u(`${t} returned HTTP ${e.status}`);let s;try{s=await e.json()}catch(n){throw new u(`${t} returned malformed JSON: ${n?.message??n}`)}return s}export function trimDate(r){const t=String(r??"").trim();if(!t)return null;const e=t.replace(/\.\d+/,"");return e.endsWith("Z")?e:`${e}Z`}

package/clis/segmentfault/article.js

@@ -1,3 +1,3 @@
-import{CliError as N,CommandExecutionError as P}from"@jackwener/opencli/errors";import{cli as v,Strategy as p}from"@jackwener/opencli/registry";import{publishArticle as f}from"../_shared/article/publish.js";import{readFile as I,stat as w}from"node:fs/promises";function u(W){if(!W.execute)throw new N("INVALID_INPUT","本命令需要 --execute 才会真正发布，请确认后加上 --execute。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}async function h(W){const H=typeof W.text==="string"?W.text:void 0,V=typeof W.file==="string"?W.file:void 0;if(H&&V)throw new N("INVALID_INPUT","请只传 <text> 或 --file 之一，不能同时使用");let B=H??"";if(V){let A;try{A=await w(V)}catch{throw new N("INVALID_INPUT",`文件不存在：${V}`)}if(!A.isFile())throw new N("INVALID_INPUT",`路径必须是可读文本文件：${V}`);let M;try{M=await I(V)}catch{throw new N("INVALID_INPUT",`无法读取文件：${V}`)}try{B=new TextDecoder("utf-8",{fatal:!0}).decode(M)}catch{throw new N("INVALID_INPUT",`文件编码不是 UTF-8：${V}`)}}if(!B.trim())throw new N("INVALID_INPUT","正文不能为空");return B}function x(W,H,V,B,A={}){return[{status:"success",outcome:B,message:W,target_type:H,target:V,...A}]}export const segmentfaultProfile={home:"https://segmentfault.com/write",outputFormat:"markdown",image:{skip:["image-static.segmentfault.com","avatar-static.segmentfault.com"],allowRelative:!0,uploadFn:async(W,H)=>{const B=await(await fetch("https://segmentfault.com/write",{credentials:"include"})).text();let A=null;const M=B.match(/serverData"\s*:\s*\{\s*"Token"\s*:\s*"([^"]+)"/);if(M)A=M[1];else{const U="window.g_initialProps = ",R=B.indexOf(U);if(R!==-1){const q=B.indexOf(`;
-	</script>`,R);if(q!==-1)try{const L=JSON.parse(B.substring(R+U.length,q));A=L&&L.global&&L.global.sessionInfo&&L.global.sessionInfo.key}catch(L){}}}if(!A)throw Error("获取思否 session token 失败");const O=await fetch(W,{credentials:"omit"});if(!O.ok)throw Error("下载图片失败："+O.status);const b=await O.blob(),E=new FormData;E.append("image",b);const F=await(await fetch("https://segmentfault.com/gateway/image",{method:"POST",credentials:"include",headers:{token:A},body:E})).text();if(F==="Unauthorized"||F.includes("禁言")||F.includes("锁定"))throw Error(F==="Unauthorized"?"未授权，请检查登录态":F);let X;try{X=JSON.parse(F)}catch(U){throw Error("图片上传失败："+F)}let T=null;if(X&&X.url)T=X.url;else if(X&&X.result)T=X.result;else if(Array.isArray(X)){if(X[0]===1)throw Error(X[1]||"图片上传失败");T=X[1]||(X[2]?"https://image-static.segmentfault.com/"+X[2]:null)}if(!T)throw Error("图片上传失败，服务端未返回 URL");return{url:T}}},publish:async(W,H)=>{const V=W.params||{},A=await(await fetch("https://segmentfault.com/write",{credentials:"include"})).text();let M=null;const O=A.match(/serverData"\s*:\s*\{\s*"Token"\s*:\s*"([^"]+)"/);if(O)M=O[1];else{const Q="window.g_initialProps = ",z=A.indexOf(Q);if(z!==-1){const J=A.indexOf(`;
-	</script>`,z);if(J!==-1)try{const K=JSON.parse(A.substring(z+Q.length,J));M=K&&K.global&&K.global.sessionInfo&&K.global.sessionInfo.key}catch(K){}}}if(!M)return{ok:!1,stage:"token",status:0,message:"获取思否 session token 失败：请确认已登录；账号首次发文会被新手确认页（/howtowrite）拦住，需先在网页端进一次写作页点「我已知晓，继续撰写」"};async function b(Q){let z=null;try{const D=(await fetch("/",{method:"HEAD"})).headers.get("date");if(D){const S=new Date(D).getTime();if(!isNaN(S))z=Math.floor(S/1000)}}catch($){}const J=Object.keys(window).find(($)=>$.startsWith("webpackChunk"));if(!J)return{__sfErr:"页面未就绪：未找到 webpack 运行时，无法复用思否请求签名"};let K;try{window[J].push([[Symbol("pp_sf_"+Math.random())],{},($)=>{K=$}])}catch($){return{__sfErr:"注入 webpack 探针失败："+String($)}}if(!K||!K.m)return{__sfErr:"无法取得 webpack require（思否前端结构可能已变）"};let Y=null;for(const $ of Object.keys(K.m)){let D="";try{D=String(K.m[$])}catch(S){continue}if(/function getUrl/.test(D)&&D.indexOf("/gateway")!==-1){Y=$;break}}if(!Y)return{__sfErr:"未定位到思否请求签名模块（getUrl/gateway），站点前端结构可能已变，需更新 adapter"};let j;try{j=K(Y).default}catch($){return{__sfErr:"加载思否请求模块失败："+String($)}}if(typeof j!=="function")return{__sfErr:"思否请求模块导出异常（default 非构造器）"};let Z=null;const C=XMLHttpRequest.prototype.open;XMLHttpRequest.prototype.open=function($,D){try{if(String(D).indexOf(Q)!==-1)Z=this}catch(S){}return C.apply(this,arguments)};try{const $=new j({Token:M,userAgent:navigator.userAgent});if(z)$.setServerTime(z);await $.send(Q,{method:"GET"}).catch(function(){})}catch($){XMLHttpRequest.prototype.open=C;return{__sfErr:"签名请求执行失败："+String($)}}XMLHttpRequest.prototype.open=C;if(!Z)return{__sfErr:"签名请求未发出（Request.send 未触发 XHR）"};return{status:Z.status,raw:String(Z.responseText||"")}}if(W.draftOnly){const Q={title:W.title,tags:[],text:W.content,object_id:"",type:"article"},z=await fetch("https://segmentfault.com/gateway/draft",{method:"POST",credentials:"include",headers:{"Content-Type":"application/json",token:M,accept:"*/*"},body:JSON.stringify(Q)}),J=await z.text();if(J==="Unauthorized"||J.includes("禁言")||J.includes("锁定"))return{ok:!1,stage:"publish",status:z.status,message:J==="Unauthorized"?"未授权":J};let K;try{K=JSON.parse(J)}catch(Y){return{ok:!1,stage:"publish",status:z.status,message:"解析响应失败："+J.slice(0,200)}}if(Array.isArray(K)){if(K[0]===1)return{ok:!1,stage:"publish",status:z.status,message:K[1]||"发布失败"};const Y=K[1];if(Y&&Y.id)return{ok:!0,draft:!0,id:String(Y.id),url:"https://segmentfault.com/write?draftId="+Y.id}}if(!K||!K.id){const Y=K&&(K.message||K.msg||K.error||K.errMsg)||J.slice(0,200);return{ok:!1,stage:"publish",status:z.status,message:Y}}return{ok:!0,draft:!0,id:String(K.id),url:"https://segmentfault.com/write?draftId="+K.id}}const E={"Content-Type":"application/json",token:M,accept:"*/*"},_=Array.isArray(V.tags)?V.tags.map((Q)=>String(Q).trim()).filter(Boolean):[];if(_.length===0)return{ok:!1,stage:"tags",message:"思否发文必须至少指定 1 个标签（--tags），合法标签可用 `segmentfault tags <名称>` 校验"};const F=[];for(const Q of _){const z=await b("/tag/"+encodeURIComponent(Q));if(z&&z.__sfErr)return{ok:!1,stage:"tags",message:"标签「"+Q+"」校验失败："+z.__sfErr};let J;try{J=JSON.parse(z.raw)}catch(Y){return{ok:!1,stage:"tags",status:z.status,message:"解析标签「"+Q+"」响应失败（HTTP "+z.status+"）："+String(z.raw).slice(0,200)}}if(z.status!==200||typeof J==="string")return{ok:!1,stage:"tags",status:z.status,message:"思否标签接口请求被拒（HTTP "+z.status+"）："+(typeof J==="string"?J:String(z.raw).slice(0,120))};const K=J&&J.tag;if(!K||K.id==null)return{ok:!1,stage:"tags",message:"思否上找不到标签「"+Q+"」，请用 `segmentfault tags <名称>` 确认存在再发布"};F.push(K.id)}const X=Array.isArray(V.channels)?V.channels.map((Q)=>String(Q).trim()).filter(Boolean):[],T=[];if(X.length>0){let Q=[];const z=await b("/channels");if(z&&z.__sfErr)return{ok:!1,stage:"channels",message:"获取思否频道列表失败："+z.__sfErr};let J;try{J=JSON.parse(z.raw)}catch(K){return{ok:!1,stage:"channels",status:z.status,message:"解析频道列表失败（HTTP "+z.status+"）："+String(z.raw).slice(0,200)}}if(z.status!==200||typeof J==="string")return{ok:!1,stage:"channels",status:z.status,message:"思否频道接口请求被拒（HTTP "+z.status+"）："+(typeof J==="string"?J:String(z.raw).slice(0,120))};if(Array.isArray(J))Q=J;else if(J&&Array.isArray(J.data))Q=J.data;else if(J&&Array.isArray(J.rows))Q=J.rows;else if(J&&Array.isArray(J.channels))Q=J.channels;else Q=[];for(const K of X){const Y=Q.find((j)=>j&&(String(j.name||j.title||j.text)===K||String(j.slug)===K));if(!Y||!Y.slug){const j=Q.map((Z)=>Z&&(Z.name||Z.title||Z.text)||"").filter(Boolean).join(" / ");return{ok:!1,stage:"channels",message:"思否上找不到频道「"+K+"」，可选："+(j||"（频道列表为空）")}}T.push(Y.slug)}}let U="";if(V.cover){const Q=String(V.cover);if(Q.indexOf("/img/")===0)U=Q;else{let z;try{const Z=await fetch(Q,{credentials:"omit"});if(!Z.ok)return{ok:!1,stage:"cover",status:Z.status,message:"封面图下载失败（HTTP "+Z.status+"）："+Q.slice(0,120)};z=await Z.blob()}catch(Z){return{ok:!1,stage:"cover",message:"封面图下载失败（"+String(Z&&Z.message||Z)+"）。思否封面只收自家图床 /img/ 路径；建议 --cover 直接传本机图片路径，由命令自动转存"}}const J=new FormData;J.append("image",z);const K=await fetch("https://segmentfault.com/gateway/image",{method:"POST",credentials:"include",headers:{token:M},body:J}),Y=await K.text();let j;try{j=JSON.parse(Y)}catch(Z){return{ok:!1,stage:"cover",status:K.status,message:"封面图上传思否图床失败："+Y.slice(0,120)}}U=j&&j.url||"";if(!U)return{ok:!1,stage:"cover",status:K.status,message:"封面图上传后未拿到 /img/ 路径："+Y.slice(0,120)}}}const R={title:W.title,text:W.content,tags:F,blog_id:0,type:1};if(T.length>0)R.channel=T;if(U)R.cover=U;const q=await fetch("https://segmentfault.com/gateway/article",{method:"POST",credentials:"include",headers:E,body:JSON.stringify(R)}),L=await q.text();if(L==="Unauthorized"||L.includes("禁言")||L.includes("锁定"))return{ok:!1,stage:"publish",status:q.status,message:L==="Unauthorized"?"未授权，请检查登录态":L};let G;try{G=JSON.parse(L)}catch(Q){return{ok:!1,stage:"publish",status:q.status,message:"解析发布响应失败："+L.slice(0,200)}}if(G&&(G.isError||G.error||G.errno||G.scene_id)){let Q=G.message||G.msg||G.error||"";if(G.scene_id)Q=(Q?Q+"；":"")+"思否要求人机验证（geetest），无法在自动化环境完成";return{ok:!1,stage:"publish",status:q.status,message:Q||"发布失败："+L.slice(0,200)}}const y=G&&G.data&&G.data.id;if(y==null)return{ok:!1,stage:"publish",status:q.status,message:G&&(G.message||G.msg)||"发布响应缺少文章 id："+L.slice(0,200)};return{ok:!0,draft:!1,id:String(y),url:"https://segmentfault.com/a/"+y}}};v({site:"segmentfault",name:"article",access:"write",description:"发布文章到思否（SegmentFault）。默认正式发布，加 --draft 仅存草稿。正文默认 Markdown；外链图片自动转存到思否图床。正式发布必须指定标签（--tags），合法标签用 `segmentfault tags <名称>` 校验、频道用 `segmentfault channels` 列举。",domain:"segmentfault.com",strategy:p.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题"},{name:"text",positional:!0,help:"文章正文（默认 Markdown；传 --html 则视为 HTML）"},{name:"file",help:"正文文件路径（UTF-8，默认 Markdown）"},{name:"html",type:"boolean",help:"将正文视为原始 HTML 而非 Markdown"},{name:"tags",help:"标签名，逗号分隔（正式发布必填，至少 1 个）。合法标签用 `segmentfault tags <名称>` 校验；草稿可省略。"},{name:"cover",help:"封面图（选填）：本机图片路径或图片 URL，自动转存到思否图床。"},{name:"channels",help:"频道名，逗号分隔（选填）。合法值用 `segmentfault channels` 列举。"},{name:"draft",type:"boolean",help:"仅保存草稿，不正式发布"},{name:"execute",type:"boolean",help:"实际执行发布。不加此参数时命令拒绝写操作。"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(W,H)=>{if(!W)throw new P("思否发布需要浏览器会话");u(H);const V=String(H.title??"").trim();if(!V)throw new N("INVALID_INPUT","文章标题不能为空");const B=await h(H),A=Boolean(H.draft),M=(U)=>typeof U==="string"?U.split(",").map((R)=>R.trim()).filter(Boolean):[],O=M(H.tags),b=M(H.channels),E=typeof H.cover==="string"?H.cover.trim():"";if(!A&&O.length===0)throw new N("INVALID_INPUT","思否正式发布必须指定 --tags（至少 1 个标签）；合法标签用 `segmentfault tags <名称>` 校验，或加 --draft 只存草稿");const _=await f(W,{title:V,body:B,format:H.html?"html":"markdown",draftOnly:A,profile:segmentfaultProfile,publishParams:{tags:O,channels:b,cover:E}}),F=_.images.uploaded.length|0,X=_.images.failed.length|0;let T=_.draft?"已保存到思否草稿箱（需在网页上手动发布）":"已正式发布到思否";if(F||X)T+=`；图片：${F} 张转存成功${X?`，${X} 张失败`:""}`;return x(T,"article","",_.draft?"draft":"created",{created_target:(_.draft?"draft:":"article:")+_.id,created_url:_.url})}});
+import{CliError as x,CommandExecutionError as v}from"@jackwener/opencli/errors";import{cli as U,Strategy as R}from"@jackwener/opencli/registry";import{publishArticle as D}from"../_shared/article/publish.js";import{readFile as L,stat as H}from"node:fs/promises";function M(n){if(!n.execute)throw new x("INVALID_INPUT","本命令需要 --execute 才会真正发布，请确认后加上 --execute。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}async function F(n){const f=typeof n.text==="string"?n.text:void 0,r=typeof n.file==="string"?n.file:void 0;if(f&&r)throw new x("INVALID_INPUT","请只传 <text> 或 --file 之一，不能同时使用");let p=f??"";if(r){let u;try{u=await H(r)}catch{throw new x("INVALID_INPUT",`文件不存在：${r}`)}if(!u.isFile())throw new x("INVALID_INPUT",`路径必须是可读文本文件：${r}`);let g;try{g=await L(r)}catch{throw new x("INVALID_INPUT",`无法读取文件：${r}`)}try{p=new TextDecoder("utf-8",{fatal:!0}).decode(g)}catch{throw new x("INVALID_INPUT",`文件编码不是 UTF-8：${r}`)}}if(!p.trim())throw new x("INVALID_INPUT","正文不能为空");return p}function q(n,f,r,p,u={}){return[{status:"success",outcome:p,message:n,target_type:f,target:r,...u}]}export const segmentfaultProfile={home:"https://segmentfault.com/write",outputFormat:"markdown",image:{skip:["image-static.segmentfault.com","avatar-static.segmentfault.com"],allowRelative:!0,uploadFn:async(n,f)=>{const p=await(await fetch("https://segmentfault.com/write",{credentials:"include"})).text();let u=null;const g=p.match(/serverData"\s*:\s*\{\s*"Token"\s*:\s*"([^"]+)"/);if(g)u=g[1];else{const k="window.g_initialProps = ",S=p.indexOf(k);if(S!==-1){const I=p.indexOf(`;
+	</script>`,S);if(I!==-1)try{const d=JSON.parse(p.substring(S+k.length,I));u=d&&d.global&&d.global.sessionInfo&&d.global.sessionInfo.key}catch(d){}}}if(!u)throw Error("获取思否 session token 失败");const b=await fetch(n,{credentials:"omit"});if(!b.ok)throw Error("下载图片失败："+b.status);const N=await b.blob(),A=new FormData;A.append("image",N);const w=await(await fetch("https://segmentfault.com/gateway/image",{method:"POST",credentials:"include",headers:{token:u},body:A})).text();if(w==="Unauthorized"||w.includes("禁言")||w.includes("锁定"))throw Error(w==="Unauthorized"?"未授权，请检查登录态":w);let i;try{i=JSON.parse(w)}catch(k){throw Error("图片上传失败："+w)}let y=null;if(i&&i.url)y=i.url;else if(i&&i.result)y=i.result;else if(Array.isArray(i)){if(i[0]===1)throw Error(i[1]||"图片上传失败");y=i[1]||(i[2]?"https://image-static.segmentfault.com/"+i[2]:null)}if(!y)throw Error("图片上传失败，服务端未返回 URL");return{url:y}}},publish:async(n,f)=>{const r=n.params||{},u=await(await fetch("https://segmentfault.com/write",{credentials:"include"})).text();let g=null;const b=u.match(/serverData"\s*:\s*\{\s*"Token"\s*:\s*"([^"]+)"/);if(b)g=b[1];else{const a="window.g_initialProps = ",t=u.indexOf(a);if(t!==-1){const e=u.indexOf(`;
+	</script>`,t);if(e!==-1)try{const s=JSON.parse(u.substring(t+a.length,e));g=s&&s.global&&s.global.sessionInfo&&s.global.sessionInfo.key}catch(s){}}}if(!g)return{ok:!1,stage:"token",status:0,message:"获取思否 session token 失败：请确认已登录；账号首次发文会被新手确认页（/howtowrite）拦住，需先在网页端进一次写作页点「我已知晓，继续撰写」"};async function N(a){let t=null;try{const T=(await fetch("/",{method:"HEAD"})).headers.get("date");if(T){const O=new Date(T).getTime();if(!isNaN(O))t=Math.floor(O/1000)}}catch(c){}const e=Object.keys(window).find((c)=>c.startsWith("webpackChunk"));if(!e)return{__sfErr:"页面未就绪：未找到 webpack 运行时，无法复用思否请求签名"};let s;try{window[e].push([[Symbol("pp_sf_"+Math.random())],{},(c)=>{s=c}])}catch(c){return{__sfErr:"注入 webpack 探针失败："+String(c)}}if(!s||!s.m)return{__sfErr:"无法取得 webpack require（思否前端结构可能已变）"};let o=null;for(const c of Object.keys(s.m)){let T="";try{T=String(s.m[c])}catch(O){continue}if(/function getUrl/.test(T)&&T.indexOf("/gateway")!==-1){o=c;break}}if(!o)return{__sfErr:"未定位到思否请求签名模块（getUrl/gateway），站点前端结构可能已变，需更新 adapter"};let h;try{h=s(o).default}catch(c){return{__sfErr:"加载思否请求模块失败："+String(c)}}if(typeof h!=="function")return{__sfErr:"思否请求模块导出异常（default 非构造器）"};let l=null;const E=XMLHttpRequest.prototype.open;XMLHttpRequest.prototype.open=function(c,T){try{if(String(T).indexOf(a)!==-1)l=this}catch(O){}return E.apply(this,arguments)};try{const c=new h({Token:g,userAgent:navigator.userAgent});if(t)c.setServerTime(t);await c.send(a,{method:"GET"}).catch(function(){})}catch(c){XMLHttpRequest.prototype.open=E;return{__sfErr:"签名请求执行失败："+String(c)}}XMLHttpRequest.prototype.open=E;if(!l)return{__sfErr:"签名请求未发出（Request.send 未触发 XHR）"};return{status:l.status,raw:String(l.responseText||"")}}if(n.draftOnly){const a={title:n.title,tags:[],text:n.content,object_id:"",type:"article"},t=await fetch("https://segmentfault.com/gateway/draft",{method:"POST",credentials:"include",headers:{"Content-Type":"application/json",token:g,accept:"*/*"},body:JSON.stringify(a)}),e=await t.text();if(e==="Unauthorized"||e.includes("禁言")||e.includes("锁定"))return{ok:!1,stage:"publish",status:t.status,message:e==="Unauthorized"?"未授权":e};let s;try{s=JSON.parse(e)}catch(o){return{ok:!1,stage:"publish",status:t.status,message:"解析响应失败："+e.slice(0,200)}}if(Array.isArray(s)){if(s[0]===1)return{ok:!1,stage:"publish",status:t.status,message:s[1]||"发布失败"};const o=s[1];if(o&&o.id)return{ok:!0,draft:!0,id:String(o.id),url:"https://segmentfault.com/write?draftId="+o.id}}if(!s||!s.id){const o=s&&(s.message||s.msg||s.error||s.errMsg)||e.slice(0,200);return{ok:!1,stage:"publish",status:t.status,message:o}}return{ok:!0,draft:!0,id:String(s.id),url:"https://segmentfault.com/write?draftId="+s.id}}const A={"Content-Type":"application/json",token:g,accept:"*/*"},_=Array.isArray(r.tags)?r.tags.map((a)=>String(a).trim()).filter(Boolean):[];if(_.length===0)return{ok:!1,stage:"tags",message:"思否发文必须至少指定 1 个标签（--tags），合法标签可用 `segmentfault tags <名称>` 校验"};const w=[];for(const a of _){const t=await N("/tag/"+encodeURIComponent(a));if(t&&t.__sfErr)return{ok:!1,stage:"tags",message:"标签「"+a+"」校验失败："+t.__sfErr};let e;try{e=JSON.parse(t.raw)}catch(o){return{ok:!1,stage:"tags",status:t.status,message:"解析标签「"+a+"」响应失败（HTTP "+t.status+"）："+String(t.raw).slice(0,200)}}if(t.status!==200||typeof e==="string")return{ok:!1,stage:"tags",status:t.status,message:"思否标签接口请求被拒（HTTP "+t.status+"）："+(typeof e==="string"?e:String(t.raw).slice(0,120))};const s=e&&e.tag;if(!s||s.id==null)return{ok:!1,stage:"tags",message:"思否上找不到标签「"+a+"」，请用 `segmentfault tags <名称>` 确认存在再发布"};w.push(s.id)}const i=Array.isArray(r.channels)?r.channels.map((a)=>String(a).trim()).filter(Boolean):[],y=[];if(i.length>0){let a=[];const t=await N("/channels");if(t&&t.__sfErr)return{ok:!1,stage:"channels",message:"获取思否频道列表失败："+t.__sfErr};let e;try{e=JSON.parse(t.raw)}catch(s){return{ok:!1,stage:"channels",status:t.status,message:"解析频道列表失败（HTTP "+t.status+"）："+String(t.raw).slice(0,200)}}if(t.status!==200||typeof e==="string")return{ok:!1,stage:"channels",status:t.status,message:"思否频道接口请求被拒（HTTP "+t.status+"）："+(typeof e==="string"?e:String(t.raw).slice(0,120))};if(Array.isArray(e))a=e;else if(e&&Array.isArray(e.data))a=e.data;else if(e&&Array.isArray(e.rows))a=e.rows;else if(e&&Array.isArray(e.channels))a=e.channels;else a=[];for(const s of i){const o=a.find((h)=>h&&(String(h.name||h.title||h.text)===s||String(h.slug)===s));if(!o||!o.slug){const h=a.map((l)=>l&&(l.name||l.title||l.text)||"").filter(Boolean).join(" / ");return{ok:!1,stage:"channels",message:"思否上找不到频道「"+s+"」，可选："+(h||"（频道列表为空）")}}y.push(o.slug)}}let k="";if(r.cover){const a=String(r.cover);if(a.indexOf("/img/")===0)k=a;else{let t;try{const l=await fetch(a,{credentials:"omit"});if(!l.ok)return{ok:!1,stage:"cover",status:l.status,message:"封面图下载失败（HTTP "+l.status+"）："+a.slice(0,120)};t=await l.blob()}catch(l){return{ok:!1,stage:"cover",message:"封面图下载失败（"+String(l&&l.message||l)+"）。思否封面只收自家图床 /img/ 路径；建议 --cover 直接传本机图片路径，由命令自动转存"}}const e=new FormData;e.append("image",t);const s=await fetch("https://segmentfault.com/gateway/image",{method:"POST",credentials:"include",headers:{token:g},body:e}),o=await s.text();let h;try{h=JSON.parse(o)}catch(l){return{ok:!1,stage:"cover",status:s.status,message:"封面图上传思否图床失败："+o.slice(0,120)}}k=h&&h.url||"";if(!k)return{ok:!1,stage:"cover",status:s.status,message:"封面图上传后未拿到 /img/ 路径："+o.slice(0,120)}}}const S={title:n.title,text:n.content,tags:w,blog_id:0,type:1};if(y.length>0)S.channel=y;if(k)S.cover=k;const I=await fetch("https://segmentfault.com/gateway/article",{method:"POST",credentials:"include",headers:A,body:JSON.stringify(S)}),d=await I.text();if(d==="Unauthorized"||d.includes("禁言")||d.includes("锁定"))return{ok:!1,stage:"publish",status:I.status,message:d==="Unauthorized"?"未授权，请检查登录态":d};let m;try{m=JSON.parse(d)}catch(a){return{ok:!1,stage:"publish",status:I.status,message:"解析发布响应失败："+d.slice(0,200)}}if(m&&(m.isError||m.error||m.errno||m.scene_id)){let a=m.message||m.msg||m.error||"";if(m.scene_id)a=(a?a+"；":"")+"思否要求人机验证（geetest），无法在自动化环境完成";return{ok:!1,stage:"publish",status:I.status,message:a||"发布失败："+d.slice(0,200)}}const P=m&&m.data&&m.data.id;if(P==null)return{ok:!1,stage:"publish",status:I.status,message:m&&(m.message||m.msg)||"发布响应缺少文章 id："+d.slice(0,200)};return{ok:!0,draft:!1,id:String(P),url:"https://segmentfault.com/a/"+P}}};U({site:"segmentfault",name:"article",access:"write",description:"发布文章到思否（SegmentFault）。默认正式发布，加 --draft 仅存草稿。正文默认 Markdown；外链图片自动转存到思否图床。正式发布必须指定标签（--tags），合法标签用 `segmentfault tags <名称>` 校验、频道用 `segmentfault channels` 列举。",domain:"segmentfault.com",strategy:R.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题"},{name:"text",positional:!0,help:"文章正文（默认 Markdown；传 --html 则视为 HTML）"},{name:"file",help:"正文文件路径（UTF-8，默认 Markdown）"},{name:"html",type:"boolean",help:"将正文视为原始 HTML 而非 Markdown"},{name:"tags",help:"标签名，逗号分隔（正式发布必填，至少 1 个）。合法标签用 `segmentfault tags <名称>` 校验；草稿可省略。"},{name:"cover",help:"封面图（选填）：本机图片路径或图片 URL，自动转存到思否图床。"},{name:"channels",help:"频道名，逗号分隔（选填）。合法值用 `segmentfault channels` 列举。"},{name:"draft",type:"boolean",help:"仅保存草稿，不正式发布"},{name:"execute",type:"boolean",help:"实际执行发布。不加此参数时命令拒绝写操作。"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(n,f)=>{if(!n)throw new v("思否发布需要浏览器会话");M(f);const r=String(f.title??"").trim();if(!r)throw new x("INVALID_INPUT","文章标题不能为空");const p=await F(f),u=Boolean(f.draft),g=(k)=>typeof k==="string"?k.split(",").map((S)=>S.trim()).filter(Boolean):[],b=g(f.tags),N=g(f.channels),A=typeof f.cover==="string"?f.cover.trim():"";if(!u&&b.length===0)throw new x("INVALID_INPUT","思否正式发布必须指定 --tags（至少 1 个标签）；合法标签用 `segmentfault tags <名称>` 校验，或加 --draft 只存草稿");const _=await D(n,{title:r,body:p,format:f.html?"html":"markdown",draftOnly:u,profile:segmentfaultProfile,publishParams:{tags:b,channels:N,cover:A}}),w=_.images.uploaded.length|0,i=_.images.failed.length|0;let y=_.draft?"已保存到思否草稿箱（需在网页上手动发布）":"已正式发布到思否";if(w||i)y+=`；图片：${w} 张转存成功${i?`，${i} 张失败`:""}`;return q(y,"article","",_.draft?"draft":"created",{created_target:(_.draft?"draft:":"article:")+_.id,created_url:_.url})}});

package/clis/segmentfault/channels.js

@@ -1 +1 @@
-import{cli as H,Strategy as K}from"@jackwener/opencli/registry";import{CommandExecutionError as A}from"@jackwener/opencli/errors";import{gotoWritePage as L}from"../_shared/article/publish.js";import{segmentfaultProfile as M}from"./article.js";import{SF_SIGNED_GET_JS as O}from"./_signed-request.js";H({site:"segmentfault",name:"channels",access:"read",description:"列出思否文章频道（名称 + slug），供 `segmentfault article --channels` 取合法频道名。",domain:"segmentfault.com",strategy:K.COOKIE,browser:!0,columns:["channel_slug","channel_name"],func:async(z)=>{if(!z)throw new A("思否频道列举需要浏览器会话");await L(z,M.home);const B="(async () => {"+O+'const res = await __sfSignedGet("/channels");if (res && res.__sfErr) return { __error: res.__sfErr };'+'let d; try { d = JSON.parse(res.raw); } catch (e) { return { __error: "解析频道响应失败（HTTP " + res.status + "）：" + String(res.raw).slice(0, 200) }; }'+'if (res.status !== 200 || typeof d === "string") return { __error: "思否频道接口请求被拒（HTTP " + res.status + "）：" + (typeof d === "string" ? d : String(res.raw).slice(0, 120)) };'+'let list = [];if (Array.isArray(d)) list = d;else if (d && Array.isArray(d.rows)) list = d.rows;else if (d && Array.isArray(d.data)) list = d.data;else if (d && Array.isArray(d.channels)) list = d.channels;return list.map((c) => ({ channel_slug: String((c && c.slug) || ""), channel_name: String((c && (c.name || c.title || c.text)) || "") }));})()',v=await z.evaluate(B);if(v&&v.__error)throw new A(v.__error);return Array.isArray(v)?v:[]}});
+import{cli as a,Strategy as n}from"@jackwener/opencli/registry";import{CommandExecutionError as t}from"@jackwener/opencli/errors";import{gotoWritePage as i}from"../_shared/article/publish.js";import{segmentfaultProfile as l}from"./article.js";import{SF_SIGNED_GET_JS as o}from"./_signed-request.js";a({site:"segmentfault",name:"channels",access:"read",description:"列出思否文章频道（名称 + slug），供 `segmentfault article --channels` 取合法频道名。",domain:"segmentfault.com",strategy:n.COOKIE,browser:!0,columns:["channel_slug","channel_name"],func:async(e)=>{if(!e)throw new t("思否频道列举需要浏览器会话");await i(e,l.home);const s="(async () => {"+o+'const res = await __sfSignedGet("/channels");if (res && res.__sfErr) return { __error: res.__sfErr };'+'let d; try { d = JSON.parse(res.raw); } catch (e) { return { __error: "解析频道响应失败（HTTP " + res.status + "）：" + String(res.raw).slice(0, 200) }; }'+'if (res.status !== 200 || typeof d === "string") return { __error: "思否频道接口请求被拒（HTTP " + res.status + "）：" + (typeof d === "string" ? d : String(res.raw).slice(0, 120)) };'+'let list = [];if (Array.isArray(d)) list = d;else if (d && Array.isArray(d.rows)) list = d.rows;else if (d && Array.isArray(d.data)) list = d.data;else if (d && Array.isArray(d.channels)) list = d.channels;return list.map((c) => ({ channel_slug: String((c && c.slug) || ""), channel_name: String((c && (c.name || c.title || c.text)) || "") }));})()',r=await e.evaluate(s);if(r&&r.__error)throw new t(r.__error);return Array.isArray(r)?r:[]}});

package/clis/segmentfault/login.js

@@ -1 +1 @@
-import{registerArticleLogin as k}from"../_shared/article/login.js";import{authProfile as b}from"./whoami.js";k({site:"segmentfault",domain:"segmentfault.com",profile:{home:b.home,checkAuth:b.checkAuth},loginDescription:"打开思否（SegmentFault）登录页并等待浏览器完成登录（供桌面客户端引导登录）。"});
+import{registerArticleLogin as t}from"../_shared/article/login.js";import{authProfile as e}from"./whoami.js";t({site:"segmentfault",domain:"segmentfault.com",profile:{home:e.home,checkAuth:e.checkAuth},loginDescription:"打开思否（SegmentFault）登录页并等待浏览器完成登录（供桌面客户端引导登录）。"});

package/clis/segmentfault/stats.js

@@ -1,10 +1,10 @@
-import{cli as J,Strategy as K}from"@jackwener/opencli/registry";J({site:"segmentfault",name:"stats",access:"read",description:"思否文章数据（每篇阅读/独立访客/得票/评论/收藏/预计阅读时长等全量运营指标）",domain:"segmentfault.com",strategy:K.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"number",default:20,help:"返回条数"},{name:"user",help:"指定思否用户名（/u/<name> 里的 name），默认当前登录账号"}],columns:["id","type","title","url","published_at","views","likes","comments","collects","shares","unique_views","read_time","status","tags","extra"],func:async(D,C)=>{const G=Math.max(1,Number(C.limit)||20),H=typeof C.user==="string"?C.user.trim():"";await D.goto("https://segmentfault.com/");const q=await D.evaluate(`(async () => {
+import{cli as d,Strategy as _}from"@jackwener/opencli/registry";d({site:"segmentfault",name:"stats",access:"read",description:"思否文章数据（每篇阅读/独立访客/得票/评论/收藏/预计阅读时长等全量运营指标）",domain:"segmentfault.com",strategy:_.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"number",default:20,help:"返回条数"},{name:"user",help:"指定思否用户名（/u/<name> 里的 name），默认当前登录账号"}],columns:["id","type","title","url","published_at","views","likes","comments","collects","shares","unique_views","read_time","status","tags","extra"],func:async(n,a)=>{const m=Math.max(1,Number(a.limit)||20),c=typeof a.user==="string"?a.user.trim():"";await n.goto("https://segmentfault.com/");const s=await n.evaluate(`(async () => {
       try {
         if (!location.host.includes('segmentfault.com')) {
           return { error: '当前标签不在思否域名（' + location.host + '），浏览器会话异常，请重试' };
         }
-        const limit = ${JSON.stringify(G)};
-        let user = ${JSON.stringify(H)};
+        const limit = ${JSON.stringify(m)};
+        let user = ${JSON.stringify(c)};
 
         // ── 解析当前登录用户名（与 segmentfault whoami 同源：/user/settings HTML）──
         if (!user) {
@@ -79,4 +79,4 @@ import{cli as J,Strategy as K}from"@jackwener/opencli/registry";J({site:"segment
       } catch (e) {
         return { error: String((e && e.message) || e) };
       }
-    })()`);if(!q||q.error)throw Error(q?.error||"segmentfault stats：evaluate 无返回（浏览器会话异常）");const E=Array.isArray(q.items)?q.items:[];if(E.length===0)throw Error("segmentfault stats：未取到任何文章数据（浏览器会话异常，请重试）");const F=(h)=>{const b=Number(h);if(!Number.isFinite(b)||b<=0)return"";const z=new Date(b*1000+28800000),B=(I)=>String(I).padStart(2,"0");return`${z.getUTCFullYear()}-${B(z.getUTCMonth()+1)}-${B(z.getUTCDate())} ${B(z.getUTCHours())}:${B(z.getUTCMinutes())}`};return E.map((h)=>{const b=h.art;if(!b)return{id:h.id,type:"article",title:"",url:`https://segmentfault.com/a/${h.id}`,published_at:"",views:"",likes:"",comments:"",collects:"",shares:"",unique_views:"",read_time:"",status:"",tags:"",extra:JSON.stringify({detail_error:h.detail_error||"未知错误"})};return{id:h.id,type:"article",title:b.title||"",url:`https://segmentfault.com/a/${h.id}`,published_at:F(b.created),views:b.real_views??0,likes:b.votes??0,comments:b.comments??0,collects:b.bookmarks??0,shares:"",unique_views:b.real_unique_views??0,read_time:b.read_time??"",status:b.status_key||"",tags:(b.tags||[]).join("|"),extra:JSON.stringify({updated_at:F(b.modified),is_sticky:b.is_sticky,is_edited:b.is_edited,ip_address:b.ip_address||"",article_type:b.article_type,origin_url:b.origin_url||""})}})}});
+    })()`);if(!s||s.error)throw Error(s?.error||"segmentfault stats：evaluate 无返回（浏览器会话异常）");const l=Array.isArray(s.items)?s.items:[];if(l.length===0)throw Error("segmentfault stats：未取到任何文章数据（浏览器会话异常，请重试）");const o=(e)=>{const t=Number(e);if(!Number.isFinite(t)||t<=0)return"";const r=new Date(t*1000+28800000),i=(u)=>String(u).padStart(2,"0");return`${r.getUTCFullYear()}-${i(r.getUTCMonth()+1)}-${i(r.getUTCDate())} ${i(r.getUTCHours())}:${i(r.getUTCMinutes())}`};return l.map((e)=>{const t=e.art;if(!t)return{id:e.id,type:"article",title:"",url:`https://segmentfault.com/a/${e.id}`,published_at:"",views:"",likes:"",comments:"",collects:"",shares:"",unique_views:"",read_time:"",status:"",tags:"",extra:JSON.stringify({detail_error:e.detail_error||"未知错误"})};return{id:e.id,type:"article",title:t.title||"",url:`https://segmentfault.com/a/${e.id}`,published_at:o(t.created),views:t.real_views??0,likes:t.votes??0,comments:t.comments??0,collects:t.bookmarks??0,shares:"",unique_views:t.real_unique_views??0,read_time:t.read_time??"",status:t.status_key||"",tags:(t.tags||[]).join("|"),extra:JSON.stringify({updated_at:o(t.modified),is_sticky:t.is_sticky,is_edited:t.is_edited,ip_address:t.ip_address||"",article_type:t.article_type,origin_url:t.origin_url||""})}})}});

package/clis/segmentfault/tags.js

@@ -1 +1 @@
-import{cli as L,Strategy as M}from"@jackwener/opencli/registry";import{CliError as O,CommandExecutionError as B}from"@jackwener/opencli/errors";import{gotoWritePage as Q}from"../_shared/article/publish.js";import{segmentfaultProfile as R}from"./article.js";import{SF_SIGNED_GET_JS as U}from"./_signed-request.js";L({site:"segmentfault",name:"tags",access:"read",description:"按名称校验思否标签是否存在并返回其真实 id，供 `segmentfault article --tags` 取合法标签。思否发文强制选标签，禁止臆造标签名/id。",domain:"segmentfault.com",strategy:M.COOKIE,browser:!0,args:[{name:"name",positional:!0,required:!0,help:"要校验的标签名（精确匹配，如 JavaScript / Vue.js）"}],columns:["exists","tag_id","tag_name"],func:async(z,H)=>{if(!z)throw new B("思否标签校验需要浏览器会话");const A=String(H.name??"").trim();if(!A)throw new O("INVALID_INPUT","标签名不能为空");await Q(z,R.home);const K="(async () => {"+U+"const name = "+JSON.stringify(A)+';const res = await __sfSignedGet("/tag/" + encodeURIComponent(name));if (res && res.__sfErr) return { __error: res.__sfErr };'+'let d; try { d = JSON.parse(res.raw); } catch (e) { return { __error: "解析标签响应失败（HTTP " + res.status + "）：" + String(res.raw).slice(0, 200) }; }'+'if (res.status !== 200 || typeof d === "string") return { __error: "思否标签接口请求被拒（HTTP " + res.status + "）：" + (typeof d === "string" ? d : String(res.raw).slice(0, 120)) };'+'const tag = d && d.tag;if (!tag || tag.id == null) return [{ exists: false, tag_id: "", tag_name: name }];return [{ exists: true, tag_id: String(tag.id), tag_name: String(tag.name || name) }];})()',v=await z.evaluate(K);if(v&&v.__error)throw new B(v.__error);return Array.isArray(v)?v:[]}});
+import{cli as i,Strategy as o}from"@jackwener/opencli/registry";import{CliError as m,CommandExecutionError as a}from"@jackwener/opencli/errors";import{gotoWritePage as g}from"../_shared/article/publish.js";import{segmentfaultProfile as _}from"./article.js";import{SF_SIGNED_GET_JS as f}from"./_signed-request.js";i({site:"segmentfault",name:"tags",access:"read",description:"按名称校验思否标签是否存在并返回其真实 id，供 `segmentfault article --tags` 取合法标签。思否发文强制选标签，禁止臆造标签名/id。",domain:"segmentfault.com",strategy:o.COOKIE,browser:!0,args:[{name:"name",positional:!0,required:!0,help:"要校验的标签名（精确匹配，如 JavaScript / Vue.js）"}],columns:["exists","tag_id","tag_name"],func:async(t,s)=>{if(!t)throw new a("思否标签校验需要浏览器会话");const e=String(s.name??"").trim();if(!e)throw new m("INVALID_INPUT","标签名不能为空");await g(t,_.home);const n="(async () => {"+f+"const name = "+JSON.stringify(e)+';const res = await __sfSignedGet("/tag/" + encodeURIComponent(name));if (res && res.__sfErr) return { __error: res.__sfErr };'+'let d; try { d = JSON.parse(res.raw); } catch (e) { return { __error: "解析标签响应失败（HTTP " + res.status + "）：" + String(res.raw).slice(0, 200) }; }'+'if (res.status !== 200 || typeof d === "string") return { __error: "思否标签接口请求被拒（HTTP " + res.status + "）：" + (typeof d === "string" ? d : String(res.raw).slice(0, 120)) };'+'const tag = d && d.tag;if (!tag || tag.id == null) return [{ exists: false, tag_id: "", tag_name: name }];return [{ exists: true, tag_id: String(tag.id), tag_name: String(tag.name || name) }];})()',r=await t.evaluate(n);if(r&&r.__error)throw new a(r.__error);return Array.isArray(r)?r:[]}});

package/clis/segmentfault/whoami.js

@@ -1 +1 @@
-import{cli as E,Strategy as F}from"@jackwener/opencli/registry";import{checkLogin as G,cookieQuickCheck as H}from"../_shared/article/auth.js";import{segmentfaultProfile as I}from"./article.js";const authProfile={home:I.home,checkAuth:async(q)=>{const x=await(await fetch("https://segmentfault.com/user/settings",{credentials:"include"})).text(),z=x.match(/href="\/u\/([^"]+)"/);if(!z)return{isAuthenticated:!1,error:"未登录或无法解析用户信息"};const A=z[1],B=x.match(/src="(https:\/\/avatar-static\.segmentfault\.com\/[^"]+)"/),D=B?B[1]:"";return{isAuthenticated:!0,userId:A,username:A,avatar:D}}};export{authProfile};E({site:"segmentfault",name:"whoami",access:"read",description:"检查思否（SegmentFault）的登录状态并获取当前账号信息",domain:"segmentfault.com",strategy:F.COOKIE,browser:!0,columns:["logged_in","user_id","username"],authStatus:{quickCheck:H("https://segmentfault.com",["PHPSESSID"])},func:async(q)=>{const b=await G(q,authProfile);return[{logged_in:b.isAuthenticated,user_id:b.userId,username:b.username}]}});
+import{cli as u,Strategy as i}from"@jackwener/opencli/registry";import{checkLogin as o,cookieQuickCheck as m}from"../_shared/article/auth.js";import{segmentfaultProfile as h}from"./article.js";const authProfile={home:h.home,checkAuth:async(e)=>{const a=await(await fetch("https://segmentfault.com/user/settings",{credentials:"include"})).text(),s=a.match(/href="\/u\/([^"]+)"/);if(!s)return{isAuthenticated:!1,error:"未登录或无法解析用户信息"};const r=s[1],c=a.match(/src="(https:\/\/avatar-static\.segmentfault\.com\/[^"]+)"/),n=c?c[1]:"";return{isAuthenticated:!0,userId:r,username:r,avatar:n}}};export{authProfile};u({site:"segmentfault",name:"whoami",access:"read",description:"检查思否（SegmentFault）的登录状态并获取当前账号信息",domain:"segmentfault.com",strategy:i.COOKIE,browser:!0,columns:["logged_in","user_id","username"],authStatus:{quickCheck:m("https://segmentfault.com",["PHPSESSID"])},func:async(e)=>{const t=await o(e,authProfile);return[{logged_in:t.isAuthenticated,user_id:t.userId,username:t.username}]}});

package/clis/semanticscholar/citations.js

@@ -1 +1 @@
-import{cli as m,Strategy as d}from"@jackwener/opencli/registry";import{ArgumentError as s,CommandExecutionError as c,EmptyResultError as h}from"@jackwener/opencli/errors";import{S2_GRAPH_BASE as u,normalizePaperRow as g,requireBoundedInt as w,requirePaperRef as y,s2Fetch as I}from"./utils.js";const S=["paperId","title","year","authors","citationCount","externalIds"].join(",");m({site:"semanticscholar",name:"citations",access:"read",description:"List papers that cite a Semantic Scholar paper (paginated)",domain:"api.semanticscholar.org",strategy:d.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"paperId (40-char hex), DOI, arXiv id, or prefixed id"},{name:"limit",type:"int",default:20,help:"Max citing papers (1-1000, single Semantic Scholar page)"},{name:"offset",type:"int",default:0,help:"Page offset (0-based)"}],columns:["rank","paperId","doi","title","year","firstAuthor","citationCount","url"],func:async(e)=>{const p=y(e.id),n=w(e.limit,20,1000),a=e.offset??0,t=typeof a==="number"?a:Number(a);if(!Number.isInteger(t)||t<0)throw new s("semanticscholar citations offset must be a non-negative integer");if(t>9999)throw new s("semanticscholar citations offset must be <= 9999");const l=`${u}/paper/${encodeURIComponent(p)}/citations?fields=${S}&limit=${n}&offset=${t}`,o=await I(l,"semanticscholar citations"),r=Array.isArray(o?.data)?o.data:null;if(r===null)throw new c("semanticscholar citations returned an unexpected payload shape");if(!r.length)throw new h("semanticscholar citations",`No Semantic Scholar citations for "${e.id}" at offset ${t}.`);return r.slice(0,n).map((i,f)=>{if(!i||typeof i!=="object"||!("citingPaper"in i))throw new c("semanticscholar citations row is missing citingPaper");return g(i.citingPaper,"citations",{rank:t+f+1})})}});
+import{cli as f,Strategy as d}from"@jackwener/opencli/registry";import{ArgumentError as s,CommandExecutionError as c,EmptyResultError as u}from"@jackwener/opencli/errors";import{S2_GRAPH_BASE as h,normalizePaperRow as g,requireBoundedInt as w,requirePaperRef as y,s2Fetch as I}from"./utils.js";const S=["paperId","title","year","authors","citationCount","externalIds"].join(",");f({site:"semanticscholar",name:"citations",access:"read",description:"List papers that cite a Semantic Scholar paper (paginated)",domain:"api.semanticscholar.org",strategy:d.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"paperId (40-char hex), DOI, arXiv id, or prefixed id"},{name:"limit",type:"int",default:20,help:"Max citing papers (1-1000, single Semantic Scholar page)"},{name:"offset",type:"int",default:0,help:"Page offset (0-based)"}],columns:["rank","paperId","doi","title","year","firstAuthor","citationCount","url"],func:async(e)=>{const p=y(e.id),o=w(e.limit,20,1000),a=e.offset??0,t=typeof a==="number"?a:Number(a);if(!Number.isInteger(t)||t<0)throw new s("semanticscholar citations offset must be a non-negative integer");if(t>9999)throw new s("semanticscholar citations offset must be <= 9999");const l=`${h}/paper/${encodeURIComponent(p)}/citations?fields=${S}&limit=${o}&offset=${t}`,n=await I(l,"semanticscholar citations"),r=Array.isArray(n?.data)?n.data:null;if(r===null)throw new c("semanticscholar citations returned an unexpected payload shape");if(!r.length)throw new u("semanticscholar citations",`No Semantic Scholar citations for "${e.id}" at offset ${t}.`);return r.slice(0,o).map((i,m)=>{if(!i||typeof i!=="object"||!("citingPaper"in i))throw new c("semanticscholar citations row is missing citingPaper");return g(i.citingPaper,"citations",{rank:t+m+1})})}});

package/clis/semanticscholar/paper.js

@@ -1 +1 @@
-import{cli as n,Strategy as o}from"@jackwener/opencli/registry";import{CommandExecutionError as p}from"@jackwener/opencli/errors";import{S2_GRAPH_BASE as l,normalizePaperRow as c,optionalNumber as t,requirePaperRef as s,s2Fetch as u,tldrText as d}from"./utils.js";const f=["paperId","title","year","authors","citationCount","influentialCitationCount","referenceCount","tldr","externalIds","url"].join(",");n({site:"semanticscholar",name:"paper",access:"read",description:"Semantic Scholar paper detail (citation graph + AI tldr) by paperId, DOI, or arXiv id",domain:"api.semanticscholar.org",strategy:o.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'paperId (40-char hex), DOI, arXiv id, or prefixed id (e.g. "ARXIV:1706.03762", "PMID:12345")'}],columns:["paperId","doi","title","year","firstAuthor","citationCount","influentialCitationCount","referenceCount","tldr","url"],func:async(r)=>{const a=s(r.id),i=`${l}/paper/${encodeURIComponent(a)}?fields=${f}`,e=await u(i,"semanticscholar paper");if(!e||typeof e!=="object")throw new p("semanticscholar paper returned an unexpected payload shape");return[{...c(e,"paper"),influentialCitationCount:t(e.influentialCitationCount,"paper influentialCitationCount"),referenceCount:t(e.referenceCount,"paper referenceCount"),tldr:d(e.tldr)}]}});
+import{cli as o,Strategy as i}from"@jackwener/opencli/registry";import{CommandExecutionError as p}from"@jackwener/opencli/errors";import{S2_GRAPH_BASE as l,normalizePaperRow as c,optionalNumber as r,requirePaperRef as u,s2Fetch as d,tldrText as s}from"./utils.js";const f=["paperId","title","year","authors","citationCount","influentialCitationCount","referenceCount","tldr","externalIds","url"].join(",");o({site:"semanticscholar",name:"paper",access:"read",description:"Semantic Scholar paper detail (citation graph + AI tldr) by paperId, DOI, or arXiv id",domain:"api.semanticscholar.org",strategy:i.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:'paperId (40-char hex), DOI, arXiv id, or prefixed id (e.g. "ARXIV:1706.03762", "PMID:12345")'}],columns:["paperId","doi","title","year","firstAuthor","citationCount","influentialCitationCount","referenceCount","tldr","url"],func:async(t)=>{const a=u(t.id),n=`${l}/paper/${encodeURIComponent(a)}?fields=${f}`,e=await d(n,"semanticscholar paper");if(!e||typeof e!=="object")throw new p("semanticscholar paper returned an unexpected payload shape");return[{...c(e,"paper"),influentialCitationCount:r(e.influentialCitationCount,"paper influentialCitationCount"),referenceCount:r(e.referenceCount,"paper referenceCount"),tldr:s(e.tldr)}]}});

package/clis/semanticscholar/recommendations.js

@@ -1 +1 @@
-import{cli as c,Strategy as m}from"@jackwener/opencli/registry";import{CommandExecutionError as d,EmptyResultError as p}from"@jackwener/opencli/errors";import{S2_REC_BASE as l,normalizePaperRow as h,requireBoundedInt as u,requirePaperRef as f,s2Fetch as I}from"./utils.js";const S=["paperId","title","year","authors","citationCount","externalIds"].join(",");c({site:"semanticscholar",name:"recommendations",access:"read",description:"Semantic Scholar AI-curated related papers for a paperId, DOI, or arXiv id",domain:"api.semanticscholar.org",strategy:m.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"paperId (40-char hex), DOI, arXiv id, or prefixed id"},{name:"limit",type:"int",default:10,help:"Max recommendations (1-500)"}],columns:["rank","paperId","doi","title","year","firstAuthor","citationCount","url"],func:async(e)=>{const o=f(e.id),a=u(e.limit,10,500),i=`${l}/papers/forpaper/${encodeURIComponent(o)}?fields=${S}&limit=${a}`,t=await I(i,"semanticscholar recommendations"),r=Array.isArray(t?.recommendedPapers)?t.recommendedPapers:null;if(r===null)throw new d("semanticscholar recommendations returned an unexpected payload shape");if(!r.length)throw new p("semanticscholar recommendations",`No Semantic Scholar recommendations for "${e.id}".`);return r.slice(0,a).map((n,s)=>h(n,"recommendations",{rank:s+1}))}});
+import{cli as c,Strategy as s}from"@jackwener/opencli/registry";import{CommandExecutionError as d,EmptyResultError as l}from"@jackwener/opencli/errors";import{S2_REC_BASE as p,normalizePaperRow as u,requireBoundedInt as h,requirePaperRef as f,s2Fetch as I}from"./utils.js";const y=["paperId","title","year","authors","citationCount","externalIds"].join(",");c({site:"semanticscholar",name:"recommendations",access:"read",description:"Semantic Scholar AI-curated related papers for a paperId, DOI, or arXiv id",domain:"api.semanticscholar.org",strategy:s.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"paperId (40-char hex), DOI, arXiv id, or prefixed id"},{name:"limit",type:"int",default:10,help:"Max recommendations (1-500)"}],columns:["rank","paperId","doi","title","year","firstAuthor","citationCount","url"],func:async(e)=>{const t=f(e.id),o=h(e.limit,10,500),n=`${p}/papers/forpaper/${encodeURIComponent(t)}?fields=${y}&limit=${o}`,a=await I(n,"semanticscholar recommendations"),r=Array.isArray(a?.recommendedPapers)?a.recommendedPapers:null;if(r===null)throw new d("semanticscholar recommendations returned an unexpected payload shape");if(!r.length)throw new l("semanticscholar recommendations",`No Semantic Scholar recommendations for "${e.id}".`);return r.slice(0,o).map((i,m)=>u(i,"recommendations",{rank:m+1}))}});

package/clis/semanticscholar/search.js

@@ -1 +1 @@
-import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{CommandExecutionError as p,EmptyResultError as h}from"@jackwener/opencli/errors";import{S2_GRAPH_BASE as u,normalizePaperRow as m,requireBoundedInt as d,requireString as y,s2Fetch as f}from"./utils.js";const S=["paperId","title","year","authors","citationCount","externalIds"].join(",");c({site:"semanticscholar",name:"search",access:"read",description:"Search Semantic Scholar papers by free text",domain:"api.semanticscholar.org",strategy:l.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search text (e.g. "attention is all you need", "diffusion model")'},{name:"limit",type:"int",default:20,help:"Max papers (1-100, single Semantic Scholar page)"}],columns:["rank","paperId","doi","title","year","firstAuthor","citationCount","url"],func:async(r)=>{const t=y(r.query,"query"),a=d(r.limit,20,100),n=`${u}/paper/search?query=${encodeURIComponent(t)}&limit=${a}&fields=${S}`,i=await f(n,"semanticscholar search"),e=Array.isArray(i?.data)?i.data:null;if(e===null)throw new p("semanticscholar search returned an unexpected payload shape");if(!e.length)throw new h("semanticscholar search",`No Semantic Scholar papers matched "${t}".`);return e.slice(0,a).map((o,s)=>m(o,"search",{rank:s+1}))}});
+import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{CommandExecutionError as m,EmptyResultError as p}from"@jackwener/opencli/errors";import{S2_GRAPH_BASE as u,normalizePaperRow as h,requireBoundedInt as d,requireString as y,s2Fetch as f}from"./utils.js";const S=["paperId","title","year","authors","citationCount","externalIds"].join(",");c({site:"semanticscholar",name:"search",access:"read",description:"Search Semantic Scholar papers by free text",domain:"api.semanticscholar.org",strategy:l.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:'Search text (e.g. "attention is all you need", "diffusion model")'},{name:"limit",type:"int",default:20,help:"Max papers (1-100, single Semantic Scholar page)"}],columns:["rank","paperId","doi","title","year","firstAuthor","citationCount","url"],func:async(r)=>{const a=y(r.query,"query"),t=d(r.limit,20,100),i=`${u}/paper/search?query=${encodeURIComponent(a)}&limit=${t}&fields=${S}`,n=await f(i,"semanticscholar search"),e=Array.isArray(n?.data)?n.data:null;if(e===null)throw new m("semanticscholar search returned an unexpected payload shape");if(!e.length)throw new p("semanticscholar search",`No Semantic Scholar papers matched "${a}".`);return e.slice(0,t).map((o,s)=>h(o,"search",{rank:s+1}))}});

package/clis/semanticscholar/utils.js

@@ -1 +1 @@
-import{ArgumentError as j,CommandExecutionError as T,EmptyResultError as G}from"@jackwener/opencli/errors";export const S2_GRAPH_BASE="https://api.semanticscholar.org/graph/v1",S2_REC_BASE="https://api.semanticscholar.org/recommendations/v1";const L="opencli-semanticscholar-adapter (+https://github.com/jackwener/OpenCLI)",M=/^[0-9a-f]{40}$/i,F=/^10\.\S+$/,Y=/^\d{4}\.\d{4,5}(?:v\d+)?$/,S=/^[a-z-]+\/\d{7}(?:v\d+)?$/i,B=/^(ARXIV|MAG|ACL|PMID|PMCID|URL|CorpusId|DBLP):/i;export function requireString(q,z){const H=String(q??"").trim();if(!H)throw new j(`semanticscholar ${z} cannot be empty`);return H}export function requireBoundedInt(q,z,H,Q="limit"){const J=q??z,W=typeof J==="number"?J:Number(J);if(!Number.isInteger(W)||W<=0)throw new j(`semanticscholar ${Q} must be a positive integer`);if(W>H)throw new j(`semanticscholar ${Q} must be <= ${H}`);return W}export function requirePaperRef(q){const z=String(q??"").trim();if(!z)throw new j("semanticscholar paper id cannot be empty","Example: ppcli semanticscholar paper 10.18653/v1/N19-1423");const H=z.match(/^https?:\/\/(?:www\.)?semanticscholar\.org\/paper\/(?:[^/]+\/)?([0-9a-f]{40})/i);if(H)return H[1].toLowerCase();if(M.test(z))return z.toLowerCase();if(B.test(z))return z;if(/^doi:/i.test(z)){const J=z.replace(/^doi:/i,"").trim();if(F.test(J))return`DOI:${J}`}const Q=z.match(/^https?:\/\/(?:dx\.)?doi\.org\/(.+)$/i);if(Q&&F.test(Q[1]))return`DOI:${Q[1]}`;if(F.test(z))return`DOI:${z}`;if(Y.test(z)||S.test(z))return`ARXIV:${z}`;throw new j(`semanticscholar paper id "${q}" is not recognised`,'Use a Semantic Scholar paperId, a DOI, an arXiv id, or a prefixed id (e.g. "ARXIV:1706.03762", "PMID:12345").')}export async function s2Fetch(q,z){const H={"user-agent":L,accept:"application/json"},Q=process.env.SEMANTIC_SCHOLAR_API_KEY;if(Q)H["x-api-key"]=Q;let J,W=0;while(!0){try{J=await fetch(q,{headers:H})}catch(Z){throw new T(`${z} request failed: ${Z?.message??Z}`,"Check that api.semanticscholar.org is reachable from this network.")}if(J.status===429&&W===0&&!Q){W+=1;await new Promise((Z)=>setTimeout(Z,1500));continue}break}if(J.status===404)throw new G(z,`Semantic Scholar returned 404 for ${q}.`);if(J.status===429)throw new T(`${z} returned HTTP 429 (rate limited)`,"Semantic Scholar throttles anonymous traffic; set SEMANTIC_SCHOLAR_API_KEY (free at https://www.semanticscholar.org/product/api) or wait a minute and retry.");if(!J.ok)throw new T(`${z} returned HTTP ${J.status}`);let $;try{$=await J.json()}catch(Z){throw new T(`${z} returned malformed JSON: ${Z?.message??Z}`)}if($&&typeof $==="object"&&$.error)throw new T(`${z} returned an error: ${$.error}`);return $}export function tldrText(q){if(q&&typeof q==="object"&&typeof q.text==="string")return q.text.trim();return""}export function firstAuthorName(q){if(!Array.isArray(q)||!q.length)return"";const z=q[0];if(z&&typeof z==="object"&&typeof z.name==="string")return z.name.trim();return""}export function optionalNumber(q,z){if(q==null)return null;if(typeof q!=="number"||!Number.isFinite(q))throw new T(`semanticscholar ${z} must be a number when present`);return q}export function normalizePaperRow(q,z,{rank:H}={}){if(!q||typeof q!=="object")throw new T(`semanticscholar ${z} row is not an object`);if(typeof q.paperId!=="string"||!q.paperId.trim())throw new T(`semanticscholar ${z} row is missing paperId`);if(typeof q.title!=="string"||!q.title.trim())throw new T(`semanticscholar ${z} row is missing title`);if(q.authors!=null&&!Array.isArray(q.authors))throw new T(`semanticscholar ${z} row has malformed authors`);const Q={paperId:q.paperId.trim(),doi:pickDoi(q.externalIds),title:q.title.trim(),year:optionalNumber(q.year,`${z} year`),firstAuthor:firstAuthorName(q.authors),citationCount:optionalNumber(q.citationCount,`${z} citationCount`),url:typeof q.url==="string"&&q.url.trim()?q.url.trim():`https://www.semanticscholar.org/paper/${q.paperId.trim()}`};if(H!=null)return{rank:H,...Q};return Q}export function pickDoi(q){if(q&&typeof q==="object"&&typeof q.DOI==="string")return q.DOI;return""}
+import{ArgumentError as m,CommandExecutionError as n,EmptyResultError as f}from"@jackwener/opencli/errors";export const S2_GRAPH_BASE="https://api.semanticscholar.org/graph/v1",S2_REC_BASE="https://api.semanticscholar.org/recommendations/v1";const h="opencli-semanticscholar-adapter (+https://github.com/jackwener/OpenCLI)",w=/^[0-9a-f]{40}$/i,u=/^10\.\S+$/,p=/^\d{4}\.\d{4,5}(?:v\d+)?$/,d=/^[a-z-]+\/\d{7}(?:v\d+)?$/i,y=/^(ARXIV|MAG|ACL|PMID|PMCID|URL|CorpusId|DBLP):/i;export function requireString(t,r){const e=String(t??"").trim();if(!e)throw new m(`semanticscholar ${r} cannot be empty`);return e}export function requireBoundedInt(t,r,e,i="limit"){const o=t??r,s=typeof o==="number"?o:Number(o);if(!Number.isInteger(s)||s<=0)throw new m(`semanticscholar ${i} must be a positive integer`);if(s>e)throw new m(`semanticscholar ${i} must be <= ${e}`);return s}export function requirePaperRef(t){const r=String(t??"").trim();if(!r)throw new m("semanticscholar paper id cannot be empty","Example: ppcli semanticscholar paper 10.18653/v1/N19-1423");const e=r.match(/^https?:\/\/(?:www\.)?semanticscholar\.org\/paper\/(?:[^/]+\/)?([0-9a-f]{40})/i);if(e)return e[1].toLowerCase();if(w.test(r))return r.toLowerCase();if(y.test(r))return r;if(/^doi:/i.test(r)){const o=r.replace(/^doi:/i,"").trim();if(u.test(o))return`DOI:${o}`}const i=r.match(/^https?:\/\/(?:dx\.)?doi\.org\/(.+)$/i);if(i&&u.test(i[1]))return`DOI:${i[1]}`;if(u.test(r))return`DOI:${r}`;if(p.test(r)||d.test(r))return`ARXIV:${r}`;throw new m(`semanticscholar paper id "${t}" is not recognised`,'Use a Semantic Scholar paperId, a DOI, an arXiv id, or a prefixed id (e.g. "ARXIV:1706.03762", "PMID:12345").')}export async function s2Fetch(t,r){const e={"user-agent":h,accept:"application/json"},i=process.env.SEMANTIC_SCHOLAR_API_KEY;if(i)e["x-api-key"]=i;let o,s=0;while(!0){try{o=await fetch(t,{headers:e})}catch(c){throw new n(`${r} request failed: ${c?.message??c}`,"Check that api.semanticscholar.org is reachable from this network.")}if(o.status===429&&s===0&&!i){s+=1;await new Promise((c)=>setTimeout(c,1500));continue}break}if(o.status===404)throw new f(r,`Semantic Scholar returned 404 for ${t}.`);if(o.status===429)throw new n(`${r} returned HTTP 429 (rate limited)`,"Semantic Scholar throttles anonymous traffic; set SEMANTIC_SCHOLAR_API_KEY (free at https://www.semanticscholar.org/product/api) or wait a minute and retry.");if(!o.ok)throw new n(`${r} returned HTTP ${o.status}`);let a;try{a=await o.json()}catch(c){throw new n(`${r} returned malformed JSON: ${c?.message??c}`)}if(a&&typeof a==="object"&&a.error)throw new n(`${r} returned an error: ${a.error}`);return a}export function tldrText(t){if(t&&typeof t==="object"&&typeof t.text==="string")return t.text.trim();return""}export function firstAuthorName(t){if(!Array.isArray(t)||!t.length)return"";const r=t[0];if(r&&typeof r==="object"&&typeof r.name==="string")return r.name.trim();return""}export function optionalNumber(t,r){if(t==null)return null;if(typeof t!=="number"||!Number.isFinite(t))throw new n(`semanticscholar ${r} must be a number when present`);return t}export function normalizePaperRow(t,r,{rank:e}={}){if(!t||typeof t!=="object")throw new n(`semanticscholar ${r} row is not an object`);if(typeof t.paperId!=="string"||!t.paperId.trim())throw new n(`semanticscholar ${r} row is missing paperId`);if(typeof t.title!=="string"||!t.title.trim())throw new n(`semanticscholar ${r} row is missing title`);if(t.authors!=null&&!Array.isArray(t.authors))throw new n(`semanticscholar ${r} row has malformed authors`);const i={paperId:t.paperId.trim(),doi:pickDoi(t.externalIds),title:t.title.trim(),year:optionalNumber(t.year,`${r} year`),firstAuthor:firstAuthorName(t.authors),citationCount:optionalNumber(t.citationCount,`${r} citationCount`),url:typeof t.url==="string"&&t.url.trim()?t.url.trim():`https://www.semanticscholar.org/paper/${t.paperId.trim()}`};if(e!=null)return{rank:e,...i};return i}export function pickDoi(t){if(t&&typeof t==="object"&&typeof t.DOI==="string")return t.DOI;return""}

package/clis/sinafinance/news.js

@@ -1 +1 @@
-import{cli as F,Strategy as G}from"@jackwener/opencli/registry";import{CliError as v}from"@jackwener/opencli/errors";const J=[0,10,1,3,4,5,102,6,6,8];function K(b){return b.replace(/<[^>]+>/g,"").trim()}F({site:"sinafinance",name:"news",access:"read",description:"新浪财经 7x24 小时实时快讯",domain:"app.cj.sina.com.cn",strategy:G.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Max results (max 50)"},{name:"type",type:"int",default:0,help:"News type: 0=全部 1=A股 2=宏观 3=公司 4=数据 5=市场 6=国际 7=观点 8=央行 9=其它"}],columns:["id","time","content","views"],func:async(b)=>{const x=Math.max(1,Math.min(Number(b.limit),50)),z=J[b.type]??0,B=new URLSearchParams({page:"1",size:String(x),tag:String(z)}),q=await fetch(`https://app.cj.sina.com.cn/api/news/pc?${B}`);if(!q.ok)throw new v("FETCH_ERROR",`Sina Finance API HTTP ${q.status}`,"Check your network connection");const u=(await q.json())?.result?.data?.feed?.list??[];if(!u.length)throw new v("NOT_FOUND","No news found","Try a different type or increase limit");return u.map((d)=>({id:d.id??"",time:d.create_time??"",content:K(d.rich_text??""),views:d.view_num??0}))}});
+import{cli as o,Strategy as m}from"@jackwener/opencli/registry";import{CliError as a}from"@jackwener/opencli/errors";const p=[0,10,1,3,4,5,102,6,6,8];function l(t){return t.replace(/<[^>]+>/g,"").trim()}o({site:"sinafinance",name:"news",access:"read",description:"新浪财经 7x24 小时实时快讯",domain:"app.cj.sina.com.cn",strategy:m.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Max results (max 50)"},{name:"type",type:"int",default:0,help:"News type: 0=全部 1=A股 2=宏观 3=公司 4=数据 5=市场 6=国际 7=观点 8=央行 9=其它"}],columns:["id","time","content","views"],func:async(t)=>{const s=Math.max(1,Math.min(Number(t.limit),50)),r=p[t.type]??0,c=new URLSearchParams({page:"1",size:String(s),tag:String(r)}),n=await fetch(`https://app.cj.sina.com.cn/api/news/pc?${c}`);if(!n.ok)throw new a("FETCH_ERROR",`Sina Finance API HTTP ${n.status}`,"Check your network connection");const i=(await n.json())?.result?.data?.feed?.list??[];if(!i.length)throw new a("NOT_FOUND","No news found","Try a different type or increase limit");return i.map((e)=>({id:e.id??"",time:e.create_time??"",content:l(e.rich_text??""),views:e.view_num??0}))}});