publishport-opencli 1.0.19 → 1.0.21

package/clis/weread/book-search.js

@@ -1,2 +1,2 @@
-import{cli as O,Strategy as B}from"@jackwener/opencli/registry";import{ArgumentError as m,CommandExecutionError as u,EmptyResultError as y}from"@jackwener/opencli/errors";import{WEREAD_UA as x,WEREAD_WEB_ORIGIN as w}from"./utils.js";const C=100,j=500,$=50;function S(e){return String(e||"").replace(/<[^>]+>/g,"").replace(/&#x([0-9a-fA-F]+);/gi,(r,t)=>String.fromCharCode(parseInt(t,16))).replace(/&#(\d+);/g,(r,t)=>String.fromCharCode(Number(t))).replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&quot;/g,'"').trim()}function c(e){return String(e||"").replace(/\s+/g," ").trim()}function k(e,r,t,n){const o=Number(e??r);if(!Number.isInteger(o)||o<=0)throw new m(`${t} must be a positive integer`);if(n!=null&&o>n)throw new m(`${t} must be <= ${n}`);return o}function f(e){if(e==null||e==="")return null;const r=Number(e);return Number.isFinite(r)?r:null}function z(e){if(e===!0||e===1||e==="1")return!0;if(e===!1||e===0||e==="0")return!1;return null}function R(e,r){const t=c(e);if(!t)throw new m(`${r} is required`);return t}function U(e){let r;try{r=new URL(String(e||""),w)}catch{return""}const t=r.pathname.split("/").filter(Boolean);if(r.protocol!=="https:"||r.hostname!=="weread.qq.com"||t[0]!=="web"||t[1]!=="reader"||!t[2])return"";if(t.length!==3)return"";return r.toString()}async function A(e,r){let t;try{t=await fetch(e.toString(),{headers:{"User-Agent":x}})}catch(n){throw new u(`${r} request failed: ${n instanceof Error?n.message:String(n)}`)}if(!t.ok)throw new u(`${r} request failed: HTTP ${t.status}`);try{return await t.json()}catch{throw new u(`${r} returned invalid JSON`)}}async function E(e,r){let t;try{t=await fetch(e.toString(),{headers:{"User-Agent":x}})}catch(n){throw new u(`${r} request failed: ${n instanceof Error?n.message:String(n)}`)}if(!t.ok)throw new u(`${r} request failed: HTTP ${t.status}`);return t.text()}function F(e){const r=c(e);return r?`${w}/web/reader/${r}`:""}function W(e){const r="window.__INITIAL_STATE__=",t=e.indexOf(r);if(t<0)return null;const n=t+r.length,a=e.indexOf(";(function(){var s;",n),o=e.indexOf("</script>",n),s=a>=0?a:o;if(s<0)return null;try{return JSON.parse(e.slice(n,s))}catch{return null}}function H(e){const r=e.match(/<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/i);if(!r)return{};try{const t=JSON.parse(r[1]),n={};n.bookId=c(t?.["@Id"]);n.title=c(t?.name);n.author=c(t?.author?.name);n.readerUrl=c(t?.url);return n}catch{return{}}}function q(e,r){const n=W(e)?.reader??{},a=n.bookInfo??{},o=H(e),s=Array.isArray(n.chapterInfos)?n.chapterInfos:[],h=c(n.infoId)||c(a.encodeId),i={};i.bookId=c(a.bookId)||c(n.bookId)||o.bookId;i.title=c(a.title)||o.title;i.author=c(a.author)||o.author;i.readerUrl=c(r)||F(h)||o.readerUrl;i.chapters=s;return i}async function L(e){if(!e)return null;const r=await E(e,"WeRead reader page"),t=q(r,e);return t.bookId?t:null}function M(e){return Array.from(e.matchAll(/<li[^>]*class="wr_bookList_item"[^>]*>([\s\S]*?)<\/li>/g)).map((t)=>{const n=t[1],a=n.match(/<a[^>]*href="([^"]+)"[^>]*class="wr_bookList_item_link"[^>]*>|<a[^>]*class="wr_bookList_item_link"[^>]*href="([^"]+)"[^>]*>/),o=n.match(/<p[^>]*class="wr_bookList_item_title"[^>]*>([\s\S]*?)<\/p>/),s=n.match(/<p[^>]*class="wr_bookList_item_author"[^>]*>([\s\S]*?)<\/p>/),h=a?.[1]||a?.[2]||"",i={};i.title=S(o?.[1]||"");i.author=S(s?.[1]||"");i.readerUrl=h?U(h):"";return i}).filter((t)=>t.title&&t.readerUrl)}async function J(e){const r=new URL("/web/search/books",w);r.searchParams.set("keyword",e);return M(await E(r,"WeRead search page"))}function T(e,r){const t=c(e.title),n=c(e.author);if(!t)return"";if(n){const o=r.filter((s)=>c(s.title)===t&&c(s.author)===n);if(o.length===1)return o[0].readerUrl}const a=r.filter((o)=>c(o.title)===t);return a.length===1?a[0].readerUrl:""}async function G(e,r){const t=new URL("/web/search/global",`${w}/web`);t.searchParams.set("keyword",e);const n=await A(t,"WeRead book search");if(!Array.isArray(n?.books))throw new u("WeRead book search returned malformed books");const a=n.books;if(a.length===0)throw new y("weread book-search",`No WeRead books found for "${e}"`);if(r>a.length)throw new m(`book-rank must be <= ${a.length}`,`Only ${a.length} book search result(s) were returned for "${e}"`);const o=a[r-1]?.bookInfo??{},s={bookId:c(o.bookId),title:c(o.title),author:c(o.author),readerUrl:"",chapters:[]};if(!s.bookId)throw new u(`WeRead book search result ${r} is missing bookId`);const h=await J(e);s.readerUrl=T(s,h);const i=await L(s.readerUrl);return{...s,...Object.fromEntries(Object.entries(i??{}).filter(([,d])=>d!=null&&d!==""&&!(Array.isArray(d)&&d.length===0)))}}async function D(e,r){if(/^https?:\/\//i.test(e)){const t=U(e);if(!t)throw new m("book URL must be a https://weread.qq.com/web/reader/<id> URL");const n=await L(t);if(!n?.bookId)throw new u("Could not parse a bookId from the reader URL");return n}if(/^\d+$/.test(e)){const t={};t.bookId=e;t.title="";t.author="";t.readerUrl="";t.chapters=[];return t}return G(e,r)}async function X(e,r,t,n){const a=[];let o=0;while(a.length<t){const s=t-a.length,h=s<$?s:$,i=new URL("/web/book/search",w);i.searchParams.set("bookId",e);i.searchParams.set("keyword",r);i.searchParams.set("maxIdx",String(o));i.searchParams.set("count",String(h));i.searchParams.set("fragmentSize",String(n));i.searchParams.set("onlyCount","0");const d=await A(i,"WeRead in-book search");if(!Array.isArray(d?.result))throw new u("WeRead in-book search returned malformed result");const p=d.result.map((l)=>{if(!l||typeof l!=="object")throw new u("WeRead in-book search returned malformed match");const _=c(l.abstract),b=f(l.searchIdx);if(!_||b==null||b<=0)throw new u("WeRead in-book search returned malformed match");return{...l,abstract:_,chapterIdx:f(l.chapterIdx),chapterUid:f(l.chapterUid),searchIdx:b}});if(p.length===0)break;a.push(...p);const g=p[p.length-1].searchIdx;if(g<=o)throw new u("WeRead in-book search returned non-advancing searchIdx");o=g;if(a.length>=t)break;const I=z(d?.hasMore);if(I==null){if(p.length<h)break;throw new u("WeRead in-book search returned malformed pagination state")}if(!I)break}if(a.length===0)throw new y("weread book-search",`No matches for "${r}" in book ${e}`);return a.slice(0,t)}function Z(e){const r=new Map;for(const t of e){const n=f(t?.chapterUid);if(n==null)continue;r.set(n,{chapterIdx:f(t?.chapterIdx),chapterTitle:c(t?.title)})}return r}function N(e,r){const t=Z(e.chapters??[]);return r.map((n,a)=>{const o=f(n?.chapterUid),s=t.get(o)??{},h=s.chapterIdx??f(n?.chapterIdx);return{rank:a+1,book_title:e.title||null,author:e.author||null,chapter_idx:h,chapter_title:s.chapterTitle||null,snippet:c(n?.abstract),search_idx:n.searchIdx,chapter_uid:o,book_id:e.bookId,url:e.readerUrl||null}})}function P(e,r,t){const a=[`# ${e.title||`WeRead book ${e.bookId}`}`];if(e.author)a.push(`- author: ${e.author}`);a.push(`- book_id: \`${e.bookId}\``);a.push(`- query: \`${r}\``);a.push(`- matches: ${t.length}`);if(e.readerUrl)a.push(`- url: ${e.readerUrl}`);a.push("");for(const o of t){const s=o.chapter_title||`chapter ${o.chapter_uid??""}`.trim();a.push(`## ${o.rank}. ${s}`);const h=[];if(o.chapter_idx!==null)h.push(`chapter_idx: ${o.chapter_idx}`);if(o.chapter_uid!==null)h.push(`chapter_uid: ${o.chapter_uid}`);h.push(`search_idx: ${o.search_idx}`);a.push("");a.push(`> ${o.snippet}`);a.push("");for(const i of h)a.push(`- ${i}`);if(o.rank<t.length)a.push("")}return a.join(`
-`)}O({site:"weread",name:"book-search",access:"read",description:"Search within a WeRead book after resolving it by title",domain:"weread.qq.com",strategy:B.PUBLIC,browser:!1,defaultFormat:"md",args:[{name:"book",positional:!0,required:!0,help:"Book title keyword, numeric bookId, or reader URL"},{name:"query",positional:!0,required:!0,help:"Keyword to search inside the selected book"},{name:"book-rank",type:"int",default:1,help:"Which book search result to use when book is a title keyword"},{name:"limit",type:"int",default:20,help:"Max in-book matches to return (1-100)"},{name:"fragment-size",type:"int",default:150,help:"Snippet length around each match (1-500)"},{name:"raw",type:"boolean",default:!1,help:"Output structured rows instead of markdown text"}],func:async(e)=>{const r=R(e.book,"book"),t=R(e.query,"query"),n=k(e["book-rank"],1,"book-rank"),a=k(e.limit,20,"limit",C),o=k(e["fragment-size"],150,"fragment-size",j),s=await D(r,n),h=await X(s.bookId,t,a,o),i=N(s,h);if(Boolean(e.raw))return i;return[{markdown:P(s,t,i)}]}});export const __test__={buildRows:N,extractReaderInitialState:W,formatMarkdownResults:P,parseReaderMetadata:q,parseSearchHtmlEntries:M,resolveReaderUrlForBook:T};
+import{cli as B,Strategy as C}from"@jackwener/opencli/registry";import{ArgumentError as m,CommandExecutionError as u,EmptyResultError as y}from"@jackwener/opencli/errors";import{WEREAD_UA as x,WEREAD_WEB_ORIGIN as w}from"./utils.js";const j=100,z=500,S=50;function R(e){return String(e||"").replace(/<[^>]+>/g,"").replace(/&#x([0-9a-fA-F]+);/gi,(r,t)=>String.fromCharCode(parseInt(t,16))).replace(/&#(\d+);/g,(r,t)=>String.fromCharCode(Number(t))).replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&quot;/g,'"').trim()}function c(e){return String(e||"").replace(/\s+/g," ").trim()}function k(e,r,t,n){const o=Number(e??r);if(!Number.isInteger(o)||o<=0)throw new m(`${t} must be a positive integer`);if(n!=null&&o>n)throw new m(`${t} must be <= ${n}`);return o}function f(e){if(e==null||e==="")return null;const r=Number(e);return Number.isFinite(r)?r:null}function F(e){if(e===!0||e===1||e==="1")return!0;if(e===!1||e===0||e==="0")return!1;return null}function U(e,r){const t=c(e);if(!t)throw new m(`${r} is required`);return t}function A(e){let r;try{r=new URL(String(e||""),w)}catch{return""}const t=r.pathname.split("/").filter(Boolean);if(r.protocol!=="https:"||r.hostname!=="weread.qq.com"||t[0]!=="web"||t[1]!=="reader"||!t[2])return"";if(t.length!==3)return"";return r.toString()}async function E(e,r){let t;try{t=await fetch(e.toString(),{headers:{"User-Agent":x}})}catch(n){throw new u(`${r} request failed: ${n instanceof Error?n.message:String(n)}`)}if(!t.ok)throw new u(`${r} request failed: HTTP ${t.status}`);try{return await t.json()}catch{throw new u(`${r} returned invalid JSON`)}}async function W(e,r){let t;try{t=await fetch(e.toString(),{headers:{"User-Agent":x}})}catch(n){throw new u(`${r} request failed: ${n instanceof Error?n.message:String(n)}`)}if(!t.ok)throw new u(`${r} request failed: HTTP ${t.status}`);return t.text()}function H(e){const r=c(e);return r?`${w}/web/reader/${r}`:""}function q(e){const r="window.__INITIAL_STATE__=",t=e.indexOf(r);if(t<0)return null;const n=t+r.length,a=e.indexOf(";(function(){var s;",n),o=e.indexOf("</script>",n),s=a>=0?a:o;if(s<0)return null;try{return JSON.parse(e.slice(n,s))}catch{return null}}function J(e){const r=e.match(/<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/i);if(!r)return{};try{const t=JSON.parse(r[1]),n={};n.bookId=c(t?.["@Id"]);n.title=c(t?.name);n.author=c(t?.author?.name);n.readerUrl=c(t?.url);return n}catch{return{}}}function L(e,r){const n=q(e)?.reader??{},a=n.bookInfo??{},o=J(e),s=Array.isArray(n.chapterInfos)?n.chapterInfos:[],h=c(n.infoId)||c(a.encodeId),i={};i.bookId=c(a.bookId)||c(n.bookId)||o.bookId;i.title=c(a.title)||o.title;i.author=c(a.author)||o.author;i.readerUrl=c(r)||H(h)||o.readerUrl;i.chapters=s;return i}async function M(e){if(!e)return null;const r=await W(e,"WeRead reader page"),t=L(r,e);return t.bookId?t:null}function T(e){return Array.from(e.matchAll(/<li[^>]*class="wr_bookList_item"[^>]*>([\s\S]*?)<\/li>/g)).map((t)=>{const n=t[1],a=n.match(/<a[^>]*href="([^"]+)"[^>]*class="wr_bookList_item_link"[^>]*>|<a[^>]*class="wr_bookList_item_link"[^>]*href="([^"]+)"[^>]*>/),o=n.match(/<p[^>]*class="wr_bookList_item_title"[^>]*>([\s\S]*?)<\/p>/),s=n.match(/<p[^>]*class="wr_bookList_item_author"[^>]*>([\s\S]*?)<\/p>/),h=a?.[1]||a?.[2]||"",i={};i.title=R(o?.[1]||"");i.author=R(s?.[1]||"");i.readerUrl=h?A(h):"";return i}).filter((t)=>t.title&&t.readerUrl)}async function G(e){const r=new URL("/web/search/books",w);r.searchParams.set("keyword",e);return T(await W(r,"WeRead search page"))}function N(e,r){const t=c(e.title),n=c(e.author);if(!t)return"";if(n){const o=r.filter((s)=>c(s.title)===t&&c(s.author)===n);if(o.length===1)return o[0].readerUrl}const a=r.filter((o)=>c(o.title)===t);return a.length===1?a[0].readerUrl:""}async function D(e,r){const t=new URL("/web/search/global",`${w}/web`);t.searchParams.set("keyword",e);const n=await E(t,"WeRead book search");if(!Array.isArray(n?.books))throw new u("WeRead book search returned malformed books");const a=n.books;if(a.length===0)throw new y("weread book-search",`No WeRead books found for "${e}"`);if(r>a.length)throw new m(`book-rank must be <= ${a.length}`,`Only ${a.length} book search result(s) were returned for "${e}"`);const o=a[r-1]?.bookInfo??{},s={bookId:c(o.bookId),title:c(o.title),author:c(o.author),readerUrl:"",chapters:[]};if(!s.bookId)throw new u(`WeRead book search result ${r} is missing bookId`);const h=await G(e);s.readerUrl=N(s,h);const i=await M(s.readerUrl);return{...s,...Object.fromEntries(Object.entries(i??{}).filter(([,d])=>d!=null&&d!==""&&!(Array.isArray(d)&&d.length===0)))}}async function X(e,r){if(/^https?:\/\//i.test(e)){const t=A(e);if(!t)throw new m("book URL must be a https://weread.qq.com/web/reader/<id> URL");const n=await M(t);if(!n?.bookId)throw new u("Could not parse a bookId from the reader URL");return n}if(/^\d+$/.test(e)){const t={};t.bookId=e;t.title="";t.author="";t.readerUrl="";t.chapters=[];return t}return D(e,r)}async function Z(e,r,t,n){const a=[];let o=0;while(a.length<t){const s=t-a.length,h=s<S?s:S,i=new URL("/web/book/search",w);i.searchParams.set("bookId",e);i.searchParams.set("keyword",r);i.searchParams.set("maxIdx",String(o));i.searchParams.set("count",String(h));i.searchParams.set("fragmentSize",String(n));i.searchParams.set("onlyCount","0");const d=await E(i,"WeRead in-book search");if(!Array.isArray(d?.result))throw new u("WeRead in-book search returned malformed result");const p=d.result.map((l)=>{if(!l||typeof l!=="object")throw new u("WeRead in-book search returned malformed match");const _=c(l.abstract),b=f(l.searchIdx);if(!_||b==null||b<=0)throw new u("WeRead in-book search returned malformed match");return{...l,abstract:_,chapterIdx:f(l.chapterIdx),chapterUid:f(l.chapterUid),searchIdx:b}});if(p.length===0)break;a.push(...p);const g=p[p.length-1].searchIdx;if(g<=o)throw new u("WeRead in-book search returned non-advancing searchIdx");o=g;if(a.length>=t)break;const I=F(d?.hasMore);if(I==null){if(p.length<h)break;throw new u("WeRead in-book search returned malformed pagination state")}if(!I)break}if(a.length===0)throw new y("weread book-search",`No matches for "${r}" in book ${e}`);return a.slice(0,t)}function K(e){const r=new Map;for(const t of e){const n=f(t?.chapterUid);if(n==null)continue;r.set(n,{chapterIdx:f(t?.chapterIdx),chapterTitle:c(t?.title)})}return r}function P(e,r){const t=K(e.chapters??[]);return r.map((n,a)=>{const o=f(n?.chapterUid),s=t.get(o)??{},h=s.chapterIdx??f(n?.chapterIdx);return{rank:a+1,book_title:e.title||null,author:e.author||null,chapter_idx:h,chapter_title:s.chapterTitle||null,snippet:c(n?.abstract),search_idx:n.searchIdx,chapter_uid:o,book_id:e.bookId,url:e.readerUrl||null}})}function O(e,r,t){const a=[`# ${e.title||`WeRead book ${e.bookId}`}`];if(e.author)a.push(`- author: ${e.author}`);a.push(`- book_id: \`${e.bookId}\``);a.push(`- query: \`${r}\``);a.push(`- matches: ${t.length}`);if(e.readerUrl)a.push(`- url: ${e.readerUrl}`);a.push("");for(const o of t){const s=o.chapter_title||`chapter ${o.chapter_uid??""}`.trim();a.push(`## ${o.rank}. ${s}`);const h=[];if(o.chapter_idx!==null)h.push(`chapter_idx: ${o.chapter_idx}`);if(o.chapter_uid!==null)h.push(`chapter_uid: ${o.chapter_uid}`);h.push(`search_idx: ${o.search_idx}`);a.push("");a.push(`> ${o.snippet}`);a.push("");for(const i of h)a.push(`- ${i}`);if(o.rank<t.length)a.push("")}return a.join(`
+`)}B({site:"weread",name:"book-search",access:"read",description:"Search within a WeRead book after resolving it by title",domain:"weread.qq.com",strategy:C.PUBLIC,browser:!1,defaultFormat:"md",args:[{name:"book",positional:!0,required:!0,help:"Book title keyword, numeric bookId, or reader URL"},{name:"query",positional:!0,required:!0,help:"Keyword to search inside the selected book"},{name:"book-rank",type:"int",default:1,help:"Which book search result to use when book is a title keyword"},{name:"limit",type:"int",default:20,help:"Max in-book matches to return (1-100)"},{name:"fragment-size",type:"int",default:150,help:"Snippet length around each match (1-500)"},{name:"raw",type:"boolean",default:!1,help:"Output structured rows instead of markdown text"}],func:async(e)=>{const r=U(e.book,"book"),t=U(e.query,"query"),n=k(e["book-rank"],1,"book-rank"),a=k(e.limit,20,"limit",j),o=k(e["fragment-size"],150,"fragment-size",z),s=await X(r,n),h=await Z(s.bookId,t,a,o),i=P(s,h);if(Boolean(e.raw))return i;return[{markdown:O(s,t,i)}]}});export const __test__={buildRows:P,extractReaderInitialState:q,formatMarkdownResults:O,parseReaderMetadata:L,parseSearchHtmlEntries:T,resolveReaderUrlForBook:N};

package/clis/weread/book.js

@@ -1,3 +1,3 @@
-import{cli as I,Strategy as f}from"@jackwener/opencli/registry";import{CliError as b}from"@jackwener/opencli/errors";import{fetchPrivateApi as S,fetchWebApi as E,resolveShelfReader as k,WEREAD_UA as g,WEREAD_WEB_ORIGIN as _}from"./utils.js";function W(J){return J.replace(/<[^>]+>/g,"").replace(/&#x([0-9a-fA-F]+);/gi,(L,j)=>String.fromCharCode(parseInt(j,16))).replace(/&#(\d+);/g,(L,j)=>String.fromCharCode(Number(j))).replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&quot;/g,'"').trim()}function Y(J){return J.replace(/\s+/g," ").trim()}function B(J,L){return`${Y(J)}\x00${Y(L)}`}function A(J){const L=new Map;for(const j of J){const q=Y(j.title);if(!q)continue;L.set(q,(L.get(q)||0)+1)}return L}function R(J){const L=new Map;for(const j of J){const q=B(j.title,j.author);if(!Y(j.title)||!Y(j.author))continue;L.set(q,(L.get(q)||0)+1)}return L}export function strictTitleFromWereadDocumentTitle(J){const L=" - 微信读书",j=String(J||"").trim();if(!j.endsWith(L))return"";const q=j.slice(0,-L.length).trim();return q.includes(" - ")?"":q}export function extractReaderFallbackMetadata(J){const L=(V)=>V?.textContent?.trim()||"",j=(...V)=>{for(const G of V){const Q=L(J.querySelector(G));if(Q)return Q}return""},q=J.body?.innerText?.replace(/\s+/g," ").trim()||"",P=()=>{const V=q.match(/微信读书推荐值\s*([0-9.]+%)/);return V?V[1]:""},Z=()=>{const V=L(J.querySelector(".introDialog_content_pub_line"));return V.startsWith("出版社")?V.replace(/^出版社\s*/,"").trim():""},$=()=>{const V=[".horizontalReaderCoverPage_content_bookInfo_intro",".wr_flyleaf_page_bookIntro_content",".introDialog_content_intro_para"];for(const G of V){const Q=L(J.querySelector(G));if(Q)return Q}return""},F=(Array.from(J.scripts||[]).map((V)=>V.textContent||"").find((V)=>V.includes('"category"'))||"").match(/"category"\s*:\s*"([^"]+)"/),w=j(".horizontalReaderCoverPage_content_bookTitle",".wr_flyleaf_page_bookInfo_bookTitle",".outline_book_detail_header_title",".readerTopBar_title_link")||strictTitleFromWereadDocumentTitle(J.title||""),O=j(".horizontalReaderCoverPage_content_author",".wr_flyleaf_page_bookInfo_author",".outline_book_detail_header_author");return{title:w,author:O,publisher:Z(),intro:$(),category:F?F[1].trim():"",rating:P(),metadataReady:Boolean(w||O)}}async function p(J,L){const j=Y(J),q=Y(L);if(!j)return"";try{const[P,Z]=await Promise.all([E("/search/global",{keyword:j}),(async()=>{const Q=new URL("/web/search/books",_);Q.searchParams.set("keyword",j);const N=await fetch(Q.toString(),{headers:{"User-Agent":g}});if(!N.ok)return[];const U=await N.text();return Array.from(U.matchAll(/<li[^>]*class="wr_bookList_item"[^>]*>([\s\S]*?)<\/li>/g)).map((H)=>{const K=H[1],C=K.match(/<a[^>]*href="([^"]+)"[^>]*class="wr_bookList_item_link"[^>]*>|<a[^>]*class="wr_bookList_item_link"[^>]*href="([^"]+)"[^>]*>/),v=K.match(/<p[^>]*class="wr_bookList_item_title"[^>]*>([\s\S]*?)<\/p>/),M=K.match(/<p[^>]*class="wr_bookList_item_author"[^>]*>([\s\S]*?)<\/p>/),D=C?.[1]||C?.[2]||"";return{title:W(v?.[1]||""),author:W(M?.[1]||""),url:D?new URL(D,_).toString():""}}).filter((H)=>H.title&&H.url)})()]),$=Array.isArray(P?.books)?P.books:[],X=R($.map((Q)=>({title:Q.bookInfo?.title??"",author:Q.bookInfo?.author??""}))),F=R(Z.filter((Q)=>Q.author)),w=B(j,q);if(q&&(X.get(w)||0)===1&&(F.get(w)||0)===1){const Q=Z.find((N)=>B(N.title,N.author)===w);if(Q?.url)return Q.url}const O=Z.filter((Q)=>Y(Q.title)===j);if(q&&O.some((Q)=>Y(Q.author)))return"";const V=A($.map((Q)=>({title:Q.bookInfo?.title??""}))),G=A(Z);if((V.get(j)||0)!==1||(G.get(j)||0)!==1)return"";return Z.find((Q)=>Y(Q.title)===j)?.url||""}catch{return""}}async function z(J,L){await J.goto(L);await J.wait({selector:".horizontalReaderCoverPage_content_bookTitle, .wr_flyleaf_page_bookInfo_bookTitle, .readerTopBar_title_link",timeout:10});const j=await J.evaluate(`
+import{cli as A,Strategy as v}from"@jackwener/opencli/registry";import{CliError as E}from"@jackwener/opencli/errors";import{fetchPrivateApi as U,fetchWebApi as z,resolveShelfReader as M,WEREAD_UA as P,WEREAD_WEB_ORIGIN as w}from"./utils.js";function S(r){return r.replace(/<[^>]+>/g,"").replace(/&#x([0-9a-fA-F]+);/gi,(o,t)=>String.fromCharCode(parseInt(t,16))).replace(/&#(\d+);/g,(o,t)=>String.fromCharCode(Number(t))).replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&quot;/g,'"').trim()}function c(r){return r.replace(/\s+/g," ").trim()}function p(r,o){return`${c(r)}\x00${c(o)}`}function R(r){const o=new Map;for(const t of r){const e=c(t.title);if(!e)continue;o.set(e,(o.get(e)||0)+1)}return o}function I(r){const o=new Map;for(const t of r){const e=p(t.title,t.author);if(!c(t.title)||!c(t.author))continue;o.set(e,(o.get(e)||0)+1)}return o}export function strictTitleFromWereadDocumentTitle(r){const o=" - 微信读书",t=String(r||"").trim();if(!t.endsWith(o))return"";const e=t.slice(0,-o.length).trim();return e.includes(" - ")?"":e}export function extractReaderFallbackMetadata(r){const o=(a)=>a?.textContent?.trim()||"",t=(...a)=>{for(const m of a){const n=o(r.querySelector(m));if(n)return n}return""},e=r.body?.innerText?.replace(/\s+/g," ").trim()||"",u=()=>{const a=e.match(/微信读书推荐值\s*([0-9.]+%)/);return a?a[1]:""},s=()=>{const a=o(r.querySelector(".introDialog_content_pub_line"));return a.startsWith("出版社")?a.replace(/^出版社\s*/,"").trim():""},l=()=>{const a=[".horizontalReaderCoverPage_content_bookInfo_intro",".wr_flyleaf_page_bookIntro_content",".introDialog_content_intro_para"];for(const m of a){const n=o(r.querySelector(m));if(n)return n}return""},f=(Array.from(r.scripts||[]).map((a)=>a.textContent||"").find((a)=>a.includes('"category"'))||"").match(/"category"\s*:\s*"([^"]+)"/),h=t(".horizontalReaderCoverPage_content_bookTitle",".wr_flyleaf_page_bookInfo_bookTitle",".outline_book_detail_header_title",".readerTopBar_title_link")||strictTitleFromWereadDocumentTitle(r.title||""),g=t(".horizontalReaderCoverPage_content_author",".wr_flyleaf_page_bookInfo_author",".outline_book_detail_header_author");return{title:h,author:g,publisher:s(),intro:l(),category:f?f[1].trim():"",rating:u(),metadataReady:Boolean(h||g)}}async function W(r,o){const t=c(r),e=c(o);if(!t)return"";try{const[u,s]=await Promise.all([z("/search/global",{keyword:t}),(async()=>{const n=new URL("/web/search/books",w);n.searchParams.set("keyword",t);const d=await fetch(n.toString(),{headers:{"User-Agent":P}});if(!d.ok)return[];const x=await d.text();return Array.from(x.matchAll(/<li[^>]*class="wr_bookList_item"[^>]*>([\s\S]*?)<\/li>/g)).map((_)=>{const b=_[1],y=b.match(/<a[^>]*href="([^"]+)"[^>]*class="wr_bookList_item_link"[^>]*>|<a[^>]*class="wr_bookList_item_link"[^>]*href="([^"]+)"[^>]*>/),T=b.match(/<p[^>]*class="wr_bookList_item_title"[^>]*>([\s\S]*?)<\/p>/),C=b.match(/<p[^>]*class="wr_bookList_item_author"[^>]*>([\s\S]*?)<\/p>/),k=y?.[1]||y?.[2]||"";return{title:S(T?.[1]||""),author:S(C?.[1]||""),url:k?new URL(k,w).toString():""}}).filter((_)=>_.title&&_.url)})()]),l=Array.isArray(u?.books)?u.books:[],i=I(l.map((n)=>({title:n.bookInfo?.title??"",author:n.bookInfo?.author??""}))),f=I(s.filter((n)=>n.author)),h=p(t,e);if(e&&(i.get(h)||0)===1&&(f.get(h)||0)===1){const n=s.find((d)=>p(d.title,d.author)===h);if(n?.url)return n.url}const g=s.filter((n)=>c(n.title)===t);if(e&&g.some((n)=>c(n.author)))return"";const a=R(l.map((n)=>({title:n.bookInfo?.title??""}))),m=R(s);if((a.get(t)||0)!==1||(m.get(t)||0)!==1)return"";return s.find((n)=>c(n.title)===t)?.url||""}catch{return""}}async function q(r,o){await r.goto(o);await r.wait({selector:".horizontalReaderCoverPage_content_bookTitle, .wr_flyleaf_page_bookInfo_bookTitle, .readerTopBar_title_link",timeout:10});const t=await r.evaluate(`
     (${extractReaderFallbackMetadata.toString()})(document)
-  `);return{title:String(j?.title||"").trim(),author:String(j?.author||"").trim(),publisher:String(j?.publisher||"").trim(),intro:String(j?.intro||"").trim(),category:String(j?.category||"").trim(),rating:String(j?.rating||"").trim(),metadataReady:j?.metadataReady===!0}}I({site:"weread",name:"book",access:"read",description:"View book details on WeRead",domain:"weread.qq.com",strategy:f.COOKIE,args:[{name:"book-id",positional:!0,required:!0,help:"Book ID from search or shelf results"}],columns:["title","author","publisher","intro","category","rating"],func:async(J,L)=>{const j=String(L["book-id"]||"").trim();try{const q=await S(J,"/book/info",{bookId:j}),P=q.newRating?`${(q.newRating/10).toFixed(1)}%`:"-";return[{title:q.title??"",author:q.author??"",publisher:q.publisher??"",intro:q.intro??"",category:q.category??"",rating:P}]}catch(q){if(!(q instanceof b)||q.code!=="AUTH_REQUIRED")throw q;const{readerUrl:P,snapshot:Z}=await k(J,j);let $=P;if(!$){const F=Z.rawBooks.find((w)=>String(w?.bookId||"").trim()===j);$=await p(String(F?.title||""),String(F?.author||""))}if(!$)throw q;const X=await z(J,$);if(!X.metadataReady||!X.title)throw q;return[{title:X.title,author:X.author,publisher:X.publisher,intro:X.intro,category:X.category,rating:X.rating}]}}});
+  `);return{title:String(t?.title||"").trim(),author:String(t?.author||"").trim(),publisher:String(t?.publisher||"").trim(),intro:String(t?.intro||"").trim(),category:String(t?.category||"").trim(),rating:String(t?.rating||"").trim(),metadataReady:t?.metadataReady===!0}}A({site:"weread",name:"book",access:"read",description:"View book details on WeRead",domain:"weread.qq.com",strategy:v.COOKIE,args:[{name:"book-id",positional:!0,required:!0,help:"Book ID from search or shelf results"}],columns:["title","author","publisher","intro","category","rating"],func:async(r,o)=>{const t=String(o["book-id"]||"").trim();try{const e=await U(r,"/book/info",{bookId:t}),u=e.newRating?`${(e.newRating/10).toFixed(1)}%`:"-";return[{title:e.title??"",author:e.author??"",publisher:e.publisher??"",intro:e.intro??"",category:e.category??"",rating:u}]}catch(e){if(!(e instanceof E)||e.code!=="AUTH_REQUIRED")throw e;const{readerUrl:u,snapshot:s}=await M(r,t);let l=u;if(!l){const f=s.rawBooks.find((h)=>String(h?.bookId||"").trim()===t);l=await W(String(f?.title||""),String(f?.author||""))}if(!l)throw e;const i=await q(r,l);if(!i.metadataReady||!i.title)throw e;return[{title:i.title,author:i.author,publisher:i.publisher,intro:i.intro,category:i.category,rating:i.rating}]}}});

package/clis/weread/notebooks.js

@@ -1 +1 @@
-import{cli as z,Strategy as B}from"@jackwener/opencli/registry";import{fetchPrivateApi as E}from"./utils.js";z({site:"weread",name:"notebooks",access:"read",description:"List books that have highlights or notes",domain:"weread.qq.com",strategy:B.COOKIE,columns:["title","author","noteCount","bookId"],func:async(x,F)=>{return((await E(x,"/user/notebooks"))?.books??[]).map((q)=>({title:q.book?.title??"",author:q.book?.author??"",noteCount:(q.bookmarkCount??0)+(q.reviewCount??0),bookId:q.bookId??""}))}});
+import{cli as a,Strategy as e}from"@jackwener/opencli/registry";import{fetchPrivateApi as r}from"./utils.js";a({site:"weread",name:"notebooks",access:"read",description:"List books that have highlights or notes",domain:"weread.qq.com",strategy:e.COOKIE,columns:["title","author","noteCount","bookId"],func:async(t,s)=>{return((await r(t,"/user/notebooks"))?.books??[]).map((o)=>({title:o.book?.title??"",author:o.book?.author??"",noteCount:(o.bookmarkCount??0)+(o.reviewCount??0),bookId:o.bookId??""}))}});

package/clis/weread/search.js

@@ -1 +1 @@
-import{cli as O,Strategy as R}from"@jackwener/opencli/registry";import{CommandExecutionError as _,EmptyResultError as Q}from"@jackwener/opencli/errors";import{fetchWebApi as K,WEREAD_UA as U,WEREAD_WEB_ORIGIN as A}from"./utils.js";function M(Y,V){const F=parseInt(Y,V);if(!Number.isInteger(F)||F<0||F>1114111)return null;try{return String.fromCodePoint(F)}catch{return null}}function W(Y){return Y.replace(/<[^>]+>/g,"").replace(/&#x([0-9a-fA-F]+);/gi,(V,F)=>M(F,16)??V).replace(/&#(\d+);/g,(V,F)=>M(F,10)??V).replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&quot;/g,'"').replace(/&apos;/g,"'").replace(/&lt;/g,"<").replace(/&gt;/g,">").trim()}function j(Y){return Y.replace(/\s+/g," ").trim()}function f(Y,V){return`${j(Y)}\x00${j(V)}`}function w(Y){const V=new Map;for(const F of Y){const X=j(F.title);if(!X)continue;V.set(X,(V.get(X)||0)+1)}return V}function z(Y){const V=new Map;for(const F of Y){const X=f(F.title,F.author);if(!j(F.title)||!j(F.author))continue;V.set(X,(V.get(X)||0)+1)}return V}function N(Y,V){return(Y.get(V)||0)<=1}function q(Y){const V=new Map,F=new Map;for(const X of Y){const B=j(X.title);if(!B||!X.url)continue;const $=X.author?V:F,J=X.author?f(X.title,X.author):B,L=$.get(J);if(L){L.push(X.url);continue}$.set(J,[X.url])}return{exactQueues:V,titleOnlyQueues:F}}function g(Y){const{exactQueues:V,titleOnlyQueues:F,apiIdentityCounts:X,htmlIdentityCounts:B,apiTitleCounts:$,htmlTitleCounts:J,title:L,author:H}=Y,G=f(L,H);if(N(X,G)&&N(B,G)){const D=V.get(G)?.shift();if(D)return D}const Z=j(L);if(!N($,Z)||!N(J,Z))return"";return F.get(Z)?.shift()??""}async function x(Y){const V=new URL("/web/search/books",A);V.searchParams.set("keyword",Y);let F;try{F=await fetch(V.toString(),{headers:{"User-Agent":U}})}catch($){throw new _(`Failed to fetch WeRead search page: ${$ instanceof Error?$.message:String($)}`)}if(!F.ok)throw new _(`WeRead search page request failed: HTTP ${F.status}`);const X=await F.text();return Array.from(X.matchAll(/<li[^>]*class="wr_bookList_item"[^>]*>([\s\S]*?)<\/li>/g)).map(($)=>{const J=$[1],L=J.match(/<a[^>]*href="([^"]+)"[^>]*class="wr_bookList_item_link"[^>]*>|<a[^>]*class="wr_bookList_item_link"[^>]*href="([^"]+)"[^>]*>/),H=J.match(/<p[^>]*class="wr_bookList_item_title"[^>]*>([\s\S]*?)<\/p>/),G=J.match(/<p[^>]*class="wr_bookList_item_author"[^>]*>([\s\S]*?)<\/p>/),Z=L?.[1]||L?.[2]||"",D=W(H?.[1]||"");return{author:W(G?.[1]||""),url:Z?new URL(Z,A).toString():"",title:D}}).filter(($)=>$.url&&$.title)}O({site:"weread",name:"search",access:"read",description:"Search books on WeRead",domain:"weread.qq.com",strategy:R.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword"},{name:"limit",type:"int",default:10,help:"Max results"}],columns:["rank","title","author","bookId","url"],func:async(Y)=>{const[V,F]=await Promise.all([K("/search/global",{keyword:Y.query}),x(String(Y.query??""))]),X=V?.books??[];if(!Array.isArray(X))throw new _("WeRead search API returned an unreadable books payload");if(X.length===0)throw new Q("weread search",`No books were returned for query ${Y.query}.`);const{exactQueues:B,titleOnlyQueues:$}=q(F),J=z(X.map((Z)=>({title:Z.bookInfo?.title??"",author:Z.bookInfo?.author??""}))),L=z(F.filter((Z)=>Z.author)),H=w(X.map((Z)=>({title:Z.bookInfo?.title??""}))),G=w(F);return X.slice(0,Number(Y.limit)).map((Z,D)=>{const P=Z.bookInfo?.title??"",v=Z.bookInfo?.author??"";return{rank:D+1,title:P,author:v,bookId:Z.bookInfo?.bookId??"",url:g({exactQueues:B,titleOnlyQueues:$,apiIdentityCounts:J,htmlIdentityCounts:L,apiTitleCounts:H,htmlTitleCounts:G,title:P,author:v})}})}});
+import{cli as _,Strategy as q}from"@jackwener/opencli/registry";import{CommandExecutionError as d,EmptyResultError as E}from"@jackwener/opencli/errors";import{fetchWebApi as C,WEREAD_UA as A,WEREAD_WEB_ORIGIN as w}from"./utils.js";function b(o,e){const t=parseInt(o,e);if(!Number.isInteger(t)||t<0||t>1114111)return null;try{return String.fromCodePoint(t)}catch{return null}}function g(o){return o.replace(/<[^>]+>/g,"").replace(/&#x([0-9a-fA-F]+);/gi,(e,t)=>b(t,16)??e).replace(/&#(\d+);/g,(e,t)=>b(t,10)??e).replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&quot;/g,'"').replace(/&apos;/g,"'").replace(/&lt;/g,"<").replace(/&gt;/g,">").trim()}function l(o){return o.replace(/\s+/g," ").trim()}function y(o,e){return`${l(o)}\x00${l(e)}`}function I(o){const e=new Map;for(const t of o){const r=l(t.title);if(!r)continue;e.set(r,(e.get(r)||0)+1)}return e}function S(o){const e=new Map;for(const t of o){const r=y(t.title,t.author);if(!l(t.title)||!l(t.author))continue;e.set(r,(e.get(r)||0)+1)}return e}function m(o,e){return(o.get(e)||0)<=1}function R(o){const e=new Map,t=new Map;for(const r of o){const c=l(r.title);if(!c||!r.url)continue;const a=r.author?e:t,s=r.author?y(r.title,r.author):c,i=a.get(s);if(i){i.push(r.url);continue}a.set(s,[r.url])}return{exactQueues:e,titleOnlyQueues:t}}function x(o){const{exactQueues:e,titleOnlyQueues:t,apiIdentityCounts:r,htmlIdentityCounts:c,apiTitleCounts:a,htmlTitleCounts:s,title:i,author:f}=o,u=y(i,f);if(m(r,u)&&m(c,u)){const h=e.get(u)?.shift();if(h)return h}const n=l(i);if(!m(a,n)||!m(s,n))return"";return t.get(n)?.shift()??""}async function M(o){const e=new URL("/web/search/books",w);e.searchParams.set("keyword",o);let t;try{t=await fetch(e.toString(),{headers:{"User-Agent":A}})}catch(a){throw new d(`Failed to fetch WeRead search page: ${a instanceof Error?a.message:String(a)}`)}if(!t.ok)throw new d(`WeRead search page request failed: HTTP ${t.status}`);const r=await t.text();return Array.from(r.matchAll(/<li[^>]*class="wr_bookList_item"[^>]*>([\s\S]*?)<\/li>/g)).map((a)=>{const s=a[1],i=s.match(/<a[^>]*href="([^"]+)"[^>]*class="wr_bookList_item_link"[^>]*>|<a[^>]*class="wr_bookList_item_link"[^>]*href="([^"]+)"[^>]*>/),f=s.match(/<p[^>]*class="wr_bookList_item_title"[^>]*>([\s\S]*?)<\/p>/),u=s.match(/<p[^>]*class="wr_bookList_item_author"[^>]*>([\s\S]*?)<\/p>/),n=i?.[1]||i?.[2]||"",h=g(f?.[1]||"");return{author:g(u?.[1]||""),url:n?new URL(n,w).toString():"",title:h}}).filter((a)=>a.url&&a.title)}_({site:"weread",name:"search",access:"read",description:"Search books on WeRead",domain:"weread.qq.com",strategy:q.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword"},{name:"limit",type:"int",default:10,help:"Max results"}],columns:["rank","title","author","bookId","url"],func:async(o)=>{const[e,t]=await Promise.all([C("/search/global",{keyword:o.query}),M(String(o.query??""))]),r=e?.books??[];if(!Array.isArray(r))throw new d("WeRead search API returned an unreadable books payload");if(r.length===0)throw new E("weread search",`No books were returned for query ${o.query}.`);const{exactQueues:c,titleOnlyQueues:a}=R(t),s=S(r.map((n)=>({title:n.bookInfo?.title??"",author:n.bookInfo?.author??""}))),i=S(t.filter((n)=>n.author)),f=I(r.map((n)=>({title:n.bookInfo?.title??""}))),u=I(t);return r.slice(0,Number(o.limit)).map((n,h)=>{const p=n.bookInfo?.title??"",k=n.bookInfo?.author??"";return{rank:h+1,title:p,author:k,bookId:n.bookInfo?.bookId??"",url:x({exactQueues:c,titleOnlyQueues:a,apiIdentityCounts:s,htmlIdentityCounts:i,apiTitleCounts:f,htmlTitleCounts:u,title:p,author:k})}})}});

package/clis/weread/shelf.js

@@ -1 +1 @@
-import{cli as G,Strategy as H}from"@jackwener/opencli/registry";import{CliError as J}from"@jackwener/opencli/errors";import{log as K}from"@jackwener/opencli/logger";import{buildWebShelfEntries as M,fetchPrivateApi as N,loadWebShelfSnapshot as O}from"./utils.js";function Q(B){if(!Number.isFinite(B))return 0;return Math.max(0,Math.trunc(B))}function T(B,D){return(B?.books??[]).slice(0,D).map((q)=>({title:q.bookInfo?.title??q.title??"",author:q.bookInfo?.author??q.author??"",progress:q.readingProgress!=null?`${q.readingProgress}%`:"-",bookId:q.bookId??q.bookInfo?.bookId??""}))}function U(B,D){if(D<=0)return[];return M(B).map((x)=>({title:x.title,author:x.author,progress:"-",bookId:x.bookId})).filter((x)=>Boolean(x.title||x.bookId)).slice(0,D)}G({site:"weread",name:"shelf",access:"read",description:"List books on your WeRead bookshelf",domain:"weread.qq.com",strategy:H.COOKIE,args:[{name:"limit",type:"int",default:20,help:"Max results"}],columns:["title","author","progress","bookId"],func:async(B,D)=>{const x=Q(Number(D.limit));if(x<=0)return[];try{const q=await N(B,"/shelf/sync",{synckey:"0",lectureSynckey:"0"});return T(q,x)}catch(q){if(!(q instanceof J)||q.code!=="AUTH_REQUIRED")throw q;const F=await O(B);if(!F.cacheFound)throw q;K.warn("WeRead private API auth expired; showing cached shelf data from localStorage. Results may be stale, and detail commands may still require re-login.");return U(F,x)}}});
+import{cli as n,Strategy as s}from"@jackwener/opencli/registry";import{CliError as i}from"@jackwener/opencli/errors";import{log as l}from"@jackwener/opencli/logger";import{buildWebShelfEntries as c,fetchPrivateApi as u,loadWebShelfSnapshot as f}from"./utils.js";function d(e){if(!Number.isFinite(e))return 0;return Math.max(0,Math.trunc(e))}function h(e,t){return(e?.books??[]).slice(0,t).map((o)=>({title:o.bookInfo?.title??o.title??"",author:o.bookInfo?.author??o.author??"",progress:o.readingProgress!=null?`${o.readingProgress}%`:"-",bookId:o.bookId??o.bookInfo?.bookId??""}))}function b(e,t){if(t<=0)return[];return c(e).map((r)=>({title:r.title,author:r.author,progress:"-",bookId:r.bookId})).filter((r)=>Boolean(r.title||r.bookId)).slice(0,t)}n({site:"weread",name:"shelf",access:"read",description:"List books on your WeRead bookshelf",domain:"weread.qq.com",strategy:s.COOKIE,args:[{name:"limit",type:"int",default:20,help:"Max results"}],columns:["title","author","progress","bookId"],func:async(e,t)=>{const r=d(Number(t.limit));if(r<=0)return[];try{const o=await u(e,"/shelf/sync",{synckey:"0",lectureSynckey:"0"});return h(o,r)}catch(o){if(!(o instanceof i)||o.code!=="AUTH_REQUIRED")throw o;const a=await f(e);if(!a.cacheFound)throw o;l.warn("WeRead private API auth expired; showing cached shelf data from localStorage. Results may be stale, and detail commands may still require re-login.");return b(a,r)}}});

package/clis/weread/utils.js

@@ -1,9 +1,9 @@
-import{CliError as P}from"@jackwener/opencli/errors";export const WEREAD_DOMAIN="weread.qq.com",WEREAD_WEB_ORIGIN=`https://${WEREAD_DOMAIN}`,WEREAD_SHELF_URL=`${WEREAD_WEB_ORIGIN}/web/shelf`;const v=`${WEREAD_WEB_ORIGIN}/web`,C=`https://i.${WEREAD_DOMAIN}`;export const WEREAD_UA="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";const D=new Set([-2010,-2012]);function V(J){return J.map((Q)=>`${Q.name}=${Q.value}`).join("; ")}function _(J,Q){return J.status===401||D.has(Number(Q?.errcode))}function w(J){return String(J.find((Q)=>Q.name==="wr_vid")?.value||"").trim()}function N(J){return{rawBooksKey:`shelf:rawBooks:${J}`,shelfIndexesKey:`shelf:shelfIndexes:${J}`}}function O(J){return{cacheFound:J?.cacheFound===!0,rawBooks:Array.isArray(J?.rawBooks)?J.rawBooks:[],shelfIndexes:Array.isArray(J?.shelfIndexes)?J.shelfIndexes:[]}}function T(J,Q){return`
+import{CliError as f}from"@jackwener/opencli/errors";export const WEREAD_DOMAIN="weread.qq.com",WEREAD_WEB_ORIGIN=`https://${WEREAD_DOMAIN}`,WEREAD_SHELF_URL=`${WEREAD_WEB_ORIGIN}/web/shelf`;const g=`${WEREAD_WEB_ORIGIN}/web`,A=`https://i.${WEREAD_DOMAIN}`;export const WEREAD_UA="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";const R=new Set([-2010,-2012]);function x(e){return e.map((r)=>`${r.name}=${r.value}`).join("; ")}function B(e,r){return e.status===401||R.has(Number(r?.errcode))}function b(e){return String(e.find((r)=>r.name==="wr_vid")?.value||"").trim()}function m(e){return{rawBooksKey:`shelf:rawBooks:${e}`,shelfIndexesKey:`shelf:shelfIndexes:${e}`}}function k(e){return{cacheFound:e?.cacheFound===!0,rawBooks:Array.isArray(e?.rawBooks)?e.rawBooks:[],shelfIndexes:Array.isArray(e?.shelfIndexes)?e.shelfIndexes:[]}}function y(e,r){return`
     (() => new Promise((resolve) => {
       const deadline = Date.now() + 5000;
-      const rawBooksKey = ${JSON.stringify(J.rawBooksKey)};
-      const shelfIndexesKey = ${JSON.stringify(J.shelfIndexesKey)};
-      const requireTrustedIndexes = ${JSON.stringify(Q)};
+      const rawBooksKey = ${JSON.stringify(e.rawBooksKey)};
+      const shelfIndexesKey = ${JSON.stringify(e.shelfIndexesKey)};
+      const requireTrustedIndexes = ${JSON.stringify(r)};
 
       const readJson = (raw) => {
         if (typeof raw !== 'string') return null;
@@ -57,11 +57,11 @@ import{CliError as P}from"@jackwener/opencli/errors";export const WEREAD_DOMAIN=
 
       poll();
     }))
-  `}export async function fetchWebApi(J,Q){const Y=new URL(`${v}${J}`);if(Q)for(const[X,z]of Object.entries(Q))Y.searchParams.set(X,z);const Z=await fetch(Y.toString(),{headers:{"User-Agent":WEREAD_UA}});if(!Z.ok)throw new P("FETCH_ERROR",`HTTP ${Z.status} for ${J}`,"WeRead API may be temporarily unavailable");try{return await Z.json()}catch{throw new P("PARSE_ERROR",`Invalid JSON response for ${J}`,"WeRead may have returned an HTML error page")}}export async function fetchPrivateApi(J,Q,Y){const Z=new URL(`${C}${Q}`);if(Y)for(const[$,q]of Object.entries(Y))Z.searchParams.set($,q);const X=Z.toString(),[z,G]=await Promise.all([J.getCookies({url:X}),J.getCookies({domain:WEREAD_DOMAIN})]),L=new Map;for(const $ of G)L.set($.name,$);for(const $ of z)L.set($.name,$);const j=V(Array.from(L.values()));let M;try{M=await fetch(X,{headers:{"User-Agent":WEREAD_UA,Origin:"https://weread.qq.com",Referer:"https://weread.qq.com/",...j?{Cookie:j}:{}}})}catch($){throw new P("FETCH_ERROR",`Failed to fetch ${Q}: ${$ instanceof Error?$.message:String($)}`,"WeRead API may be temporarily unavailable")}let F;try{F=await M.json()}catch{throw new P("PARSE_ERROR",`Invalid JSON response for ${Q}`,"WeRead may have returned an HTML error page")}if(_(M,F))throw new P("AUTH_REQUIRED","Not logged in to WeRead","Please log in to weread.qq.com in Chrome first");if(!M.ok)throw new P("FETCH_ERROR",`HTTP ${M.status} for ${Q}`,"WeRead API may be temporarily unavailable");if(F?.errcode!=null&&F.errcode!==0)throw new P("API_ERROR",F.errmsg??`WeRead API error ${F.errcode}`);return F}function H(J){return Array.from(new Set(J.rawBooks.map((Q)=>String(Q?.bookId||"").trim()).filter(Boolean)))}function K(J){const Q=H(J);if(Q.length===0)return[];const Y=new Set(Q),Z=Array.from(new Set(J.shelfIndexes.filter((X)=>Number.isFinite(X?.idx)).sort((X,z)=>Number(X?.idx??Number.MAX_SAFE_INTEGER)-Number(z?.idx??Number.MAX_SAFE_INTEGER)).map((X)=>String(X?.bookId||"").trim()).filter((X)=>Y.has(X))));return Z.length===Q.length?Z:[]}export function buildWebShelfEntries(J,Q=[]){const Y=H(J),Z=K(J),X=Z.length>0?Z:Y,z=new Map;for(const G of J.rawBooks){const L=String(G?.bookId||"").trim();if(!L||z.has(L))continue;z.set(L,G)}return X.map((G,L)=>{const j=z.get(G);return{bookId:G,title:String(j?.title||"").trim(),author:String(j?.author||"").trim(),readerUrl:String(Q[L]||"").trim()}})}async function U(J){await J.goto(WEREAD_SHELF_URL);const Q=await J.getCookies({domain:WEREAD_DOMAIN}),Y=w(Q);if(!Y)return{snapshot:{cacheFound:!1,rawBooks:[],shelfIndexes:[]},currentVid:""};const Z=await J.evaluate(T(N(Y),!1));return{snapshot:O(Z),currentVid:Y}}export async function loadWebShelfSnapshot(J){const{snapshot:Q}=await U(J);return Q}async function x(J,Q,Y){if(!Q.cacheFound)return Q;if(K(Q).length>0)return Q;if(!Y)return Q;const Z=await J.evaluate(T(N(Y),!0));return O(Z)}export async function resolveShelfReaderUrl(J,Q){return(await resolveShelfReader(J,Q)).readerUrl}export async function resolveShelfReader(J,Q){const{snapshot:Y,currentVid:Z}=await U(J),X=await x(J,Y,Z);if(!X.cacheFound)return{snapshot:X,readerUrl:null};const z=H(X),G=K(X),L=G.length===0&&z.length>0&&X.shelfIndexes.length===0;if(G.length===0&&!L)return{snapshot:X,readerUrl:null};const j=await J.evaluate(`
+  `}export async function fetchWebApi(e,r){const o=new URL(`${g}${e}`);if(r)for(const[t,a]of Object.entries(r))o.searchParams.set(t,a);const n=await fetch(o.toString(),{headers:{"User-Agent":WEREAD_UA}});if(!n.ok)throw new f("FETCH_ERROR",`HTTP ${n.status} for ${e}`,"WeRead API may be temporarily unavailable");try{return await n.json()}catch{throw new f("PARSE_ERROR",`Invalid JSON response for ${e}`,"WeRead may have returned an HTML error page")}}export async function fetchPrivateApi(e,r,o){const n=new URL(`${A}${r}`);if(o)for(const[s,h]of Object.entries(o))n.searchParams.set(s,h);const t=n.toString(),[a,i]=await Promise.all([e.getCookies({url:t}),e.getCookies({domain:WEREAD_DOMAIN})]),d=new Map;for(const s of i)d.set(s.name,s);for(const s of a)d.set(s.name,s);const l=x(Array.from(d.values()));let u;try{u=await fetch(t,{headers:{"User-Agent":WEREAD_UA,Origin:"https://weread.qq.com",Referer:"https://weread.qq.com/",...l?{Cookie:l}:{}}})}catch(s){throw new f("FETCH_ERROR",`Failed to fetch ${r}: ${s instanceof Error?s.message:String(s)}`,"WeRead API may be temporarily unavailable")}let c;try{c=await u.json()}catch{throw new f("PARSE_ERROR",`Invalid JSON response for ${r}`,"WeRead may have returned an HTML error page")}if(B(u,c))throw new f("AUTH_REQUIRED","Not logged in to WeRead","Please log in to weread.qq.com in Chrome first");if(!u.ok)throw new f("FETCH_ERROR",`HTTP ${u.status} for ${r}`,"WeRead API may be temporarily unavailable");if(c?.errcode!=null&&c.errcode!==0)throw new f("API_ERROR",c.errmsg??`WeRead API error ${c.errcode}`);return c}function w(e){return Array.from(new Set(e.rawBooks.map((r)=>String(r?.bookId||"").trim()).filter(Boolean)))}function I(e){const r=w(e);if(r.length===0)return[];const o=new Set(r),n=Array.from(new Set(e.shelfIndexes.filter((t)=>Number.isFinite(t?.idx)).sort((t,a)=>Number(t?.idx??Number.MAX_SAFE_INTEGER)-Number(a?.idx??Number.MAX_SAFE_INTEGER)).map((t)=>String(t?.bookId||"").trim()).filter((t)=>o.has(t))));return n.length===r.length?n:[]}export function buildWebShelfEntries(e,r=[]){const o=w(e),n=I(e),t=n.length>0?n:o,a=new Map;for(const i of e.rawBooks){const d=String(i?.bookId||"").trim();if(!d||a.has(d))continue;a.set(d,i)}return t.map((i,d)=>{const l=a.get(i);return{bookId:i,title:String(l?.title||"").trim(),author:String(l?.author||"").trim(),readerUrl:String(r[d]||"").trim()}})}async function S(e){await e.goto(WEREAD_SHELF_URL);const r=await e.getCookies({domain:WEREAD_DOMAIN}),o=b(r);if(!o)return{snapshot:{cacheFound:!1,rawBooks:[],shelfIndexes:[]},currentVid:""};const n=await e.evaluate(y(m(o),!1));return{snapshot:k(n),currentVid:o}}export async function loadWebShelfSnapshot(e){const{snapshot:r}=await S(e);return r}async function E(e,r,o){if(!r.cacheFound)return r;if(I(r).length>0)return r;if(!o)return r;const n=await e.evaluate(y(m(o),!0));return k(n)}export async function resolveShelfReaderUrl(e,r){return(await resolveShelfReader(e,r)).readerUrl}export async function resolveShelfReader(e,r){const{snapshot:o,currentVid:n}=await S(e),t=await E(e,o,n);if(!t.cacheFound)return{snapshot:t,readerUrl:null};const a=w(t),i=I(t),d=i.length===0&&a.length>0&&t.shelfIndexes.length===0;if(i.length===0&&!d)return{snapshot:t,readerUrl:null};const l=await e.evaluate(`
     (() => Array.from(document.querySelectorAll('a.shelfBook[href]'))
       .map((anchor) => {
         const href = anchor.getAttribute('href') || '';
         return href ? new URL(href, location.origin).toString() : '';
       })
       .filter(Boolean))
-  `),M=G.length>0?G.length:z.length;if(j.length!==M)return{snapshot:X,readerUrl:null};const $=buildWebShelfEntries(X,j).find((q)=>q.bookId===Q);return{snapshot:X,readerUrl:$?.readerUrl||null}}export function formatDate(J){if(!Number.isFinite(J)||J<=0)return"-";return new Date(J*1000+28800000).toISOString().slice(0,10)}
+  `),u=i.length>0?i.length:a.length;if(l.length!==u)return{snapshot:t,readerUrl:null};const s=buildWebShelfEntries(t,l).find((h)=>h.bookId===r);return{snapshot:t,readerUrl:s?.readerUrl||null}}export function formatDate(e){if(!Number.isFinite(e)||e<=0)return"-";return new Date(e*1000+28800000).toISOString().slice(0,10)}

package/clis/weread-official/book.js

@@ -1 +1 @@
-import{cli as S,Strategy as T}from"@jackwener/opencli/registry";import{callGateway as q,emptyResult as G,formatDate as L,formatDuration as U,formatRating as v,makeDeepLink as R,requireBookId as D,truncate as P}from"./utils.js";S({site:"weread-official",name:"book",access:"read",description:"Show WeRead book metadata, chapters, and reading progress",domain:"weread.qq.com",strategy:T.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,required:!0,help:"WeRead bookId (from `weread-official search`)"},{name:"no-chapters",type:"boolean",default:!1,help:"Skip /book/chapterinfo call"},{name:"no-progress",type:"boolean",default:!1,help:"Skip /book/getprogress call"}],columns:["section","idx","key","value","link"],func:async(Q)=>{const E=D(Q.bookId),V=[q("/book/info",{bookId:E})],M={chapters:!Q["no-chapters"],progress:!Q["no-progress"]};if(M.chapters)V.push(q("/book/chapterinfo",{bookId:E}));if(M.progress)V.push(q("/book/getprogress",{bookId:E}));const W=await Promise.all(V);let X=0;const x=W[X++],Y=M.chapters?W[X++]:null,B=M.progress?W[X++]:null,F=[],Z=[["bookId",String(x?.bookId??E)],["title",String(x?.title??"")],["author",String(x?.author??"")],["translator",String(x?.translator??"")],["category",String(x?.category??"")],["publisher",String(x?.publisher??"")],["publishTime",String(x?.publishTime??"")],["isbn",String(x?.isbn??"")],["wordCount",String(x?.wordCount??"")],["rating",v(x?.newRating)],["ratingCount",String(x?.newRatingCount??"")],["intro",P(x?.intro,400)],["cover",String(x?.cover??"")]];for(let z=0;z<Z.length;z+=1){const[A,J]=Z[z];F.push({section:"info",idx:z+1,key:A,value:J,link:""})}F.push({section:"info",idx:Z.length+1,key:"link",value:"",link:R({bookId:E})});if(Y)(Array.isArray(Y?.chapters)?Y.chapters:[]).forEach((A,J)=>{const K=String(A?.chapterUid??"").trim(),_=Number(A?.level??1),N=`${"  ".repeat(Math.max(0,_-1))}${String(A?.title??"")}`,H=Number(A?.wordCount??0),$=Number(A?.paid??0)===1,O=Number(A?.price??0),j=[`${H}字`];if(O>0)j.push($?"已购买":`${O}元`);F.push({section:"chapter",idx:Number(A?.chapterIdx??J+1),key:K,value:`${N}  (${j.join(" · ")})`,link:K?R({bookId:E,chapterUid:K}):""})});if(B){const z=B?.book??{},A=Number(z?.progress??0),J=L(z?.updateTime),K=A===100?L(z?.finishTime):"",_=U(z?.recordReadingTime),C=Number(z?.isStartReading??0)===1,N=[["progress",`${A}%`],["cumulative",_],["lastReadAt",J],["finishedAt",K],["isStartReading",C?"true":"false"],["currentChapterUid",String(z?.chapterUid??"")]];for(let H=0;H<N.length;H+=1){const[$,O]=N[H];F.push({section:"progress",idx:H+1,key:$,value:O,link:""})}}if(F.length===0)G("book",`No data returned for bookId=${E}`);return F}});
+import{cli as C,Strategy as N}from"@jackwener/opencli/registry";import{callGateway as S,emptyResult as x,formatDate as I,formatDuration as T,formatRating as U,makeDeepLink as R,requireBookId as q,truncate as A}from"./utils.js";C({site:"weread-official",name:"book",access:"read",description:"Show WeRead book metadata, chapters, and reading progress",domain:"weread.qq.com",strategy:N.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,required:!0,help:"WeRead bookId (from `weread-official search`)"},{name:"no-chapters",type:"boolean",default:!1,help:"Skip /book/chapterinfo call"},{name:"no-progress",type:"boolean",default:!1,help:"Skip /book/getprogress call"}],columns:["section","idx","key","value","link"],func:async(u)=>{const r=q(u.bookId),d=[S("/book/info",{bookId:r})],c={chapters:!u["no-chapters"],progress:!u["no-progress"]};if(c.chapters)d.push(S("/book/chapterinfo",{bookId:r}));if(c.progress)d.push(S("/book/getprogress",{bookId:r}));const g=await Promise.all(d);let h=0;const e=g[h++],m=c.chapters?g[h++]:null,y=c.progress?g[h++]:null,i=[],f=[["bookId",String(e?.bookId??r)],["title",String(e?.title??"")],["author",String(e?.author??"")],["translator",String(e?.translator??"")],["category",String(e?.category??"")],["publisher",String(e?.publisher??"")],["publishTime",String(e?.publishTime??"")],["isbn",String(e?.isbn??"")],["wordCount",String(e?.wordCount??"")],["rating",U(e?.newRating)],["ratingCount",String(e?.newRatingCount??"")],["intro",A(e?.intro,400)],["cover",String(e?.cover??"")]];for(let t=0;t<f.length;t+=1){const[o,s]=f[t];i.push({section:"info",idx:t+1,key:o,value:s,link:""})}i.push({section:"info",idx:f.length+1,key:"link",value:"",link:R({bookId:r})});if(m)(Array.isArray(m?.chapters)?m.chapters:[]).forEach((o,s)=>{const a=String(o?.chapterUid??"").trim(),k=Number(o?.level??1),l=`${"  ".repeat(Math.max(0,k-1))}${String(o?.title??"")}`,n=Number(o?.wordCount??0),b=Number(o?.paid??0)===1,p=Number(o?.price??0),v=[`${n}字`];if(p>0)v.push(b?"已购买":`${p}元`);i.push({section:"chapter",idx:Number(o?.chapterIdx??s+1),key:a,value:`${l}  (${v.join(" · ")})`,link:a?R({bookId:r,chapterUid:a}):""})});if(y){const t=y?.book??{},o=Number(t?.progress??0),s=I(t?.updateTime),a=o===100?I(t?.finishTime):"",k=T(t?.recordReadingTime),w=Number(t?.isStartReading??0)===1,l=[["progress",`${o}%`],["cumulative",k],["lastReadAt",s],["finishedAt",a],["isStartReading",w?"true":"false"],["currentChapterUid",String(t?.chapterUid??"")]];for(let n=0;n<l.length;n+=1){const[b,p]=l[n];i.push({section:"progress",idx:n+1,key:b,value:p,link:""})}}if(i.length===0)x("book",`No data returned for bookId=${r}`);return i}});

package/clis/weread-official/discover.js

@@ -1 +1 @@
-import{cli as Y,Strategy as Z}from"@jackwener/opencli/registry";import{callGateway as Q,emptyResult as T,formatRating as U,makeDeepLink as V,requireBookId as _,requirePositiveInt as $,truncate as W}from"./utils.js";Y({site:"weread-official",name:"discover",access:"read",description:"Personalized or similar-book recommendations from WeRead",domain:"weread.qq.com",strategy:Z.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,help:"Anchor bookId for similar-book mode; omit for personalized recommendations"},{name:"count",type:"int",default:12,help:"Page size (default 12)"},{name:"max-idx",type:"int",default:0,help:"Pagination cursor (recommend: previous searchIdx; similar: previous idx)"},{name:"session-id",help:"Carry-forward sessionId for /book/similar paging"}],columns:["rank","mode","bookId","title","author","rating","readingCount","category","idx","reason","cover","intro","link"],func:async(z)=>{const F=$(z.count,"count",{defaultValue:12,max:50}),C=Number(z["max-idx"]??0),E=z.bookId!==void 0&&z.bookId!==null&&String(z.bookId).trim()!==""?_(z.bookId):null;if(!E)return v({count:F,maxIdx:C});return P({bookId:E,count:F,maxIdx:C,sessionId:z["session-id"]})}});async function v({count:z,maxIdx:F}){const C=await Q("/book/recommend",{count:z,maxIdx:F}),E=Array.isArray(C?.books)?C.books:[];if(E.length===0)T("discover","No personalized recommendations available.");return E.map((h,J)=>{const H=String(h?.bookId??"").trim();return{rank:J+1,mode:"recommend",bookId:H,title:String(h?.title??""),author:String(h?.author??""),rating:U(h?.newRating),readingCount:Number(h?.readingCount??0),category:String(h?.category??""),idx:Number(h?.searchIdx??0),reason:String(h?.reason??""),cover:String(h?.cover??""),intro:W(h?.intro,200),link:H?V({bookId:H}):""}})}async function P({bookId:z,count:F,maxIdx:C,sessionId:E}){const h={bookId:z,count:F,maxIdx:C},J=String(E??"").trim();if(J)h.sessionId=J;const H=await Q("/book/similar",h),N=H?.booksimilar??H,O=Array.isArray(N?.books)?N.books:[];if(O.length===0)T("discover",`No similar books for bookId=${z}.`);return O.map((K,X)=>{const A=K?.book?.bookInfo??K?.bookInfo??{},M=String(A?.bookId??"").trim();return{rank:X+1,mode:"similar",bookId:M,title:String(A?.title??""),author:String(A?.author??""),rating:U(A?.newRating),readingCount:Number(A?.readingCount??0),category:String(A?.category??""),idx:Number(K?.idx??0),reason:"",cover:String(A?.cover??""),intro:W(A?.intro,200),link:M?V({bookId:M}):""}})}
+import{cli as p,Strategy as S}from"@jackwener/opencli/registry";import{callGateway as u,emptyResult as k,formatRating as b,makeDeepLink as g,requireBookId as h,requirePositiveInt as x,truncate as f}from"./utils.js";p({site:"weread-official",name:"discover",access:"read",description:"Personalized or similar-book recommendations from WeRead",domain:"weread.qq.com",strategy:S.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,help:"Anchor bookId for similar-book mode; omit for personalized recommendations"},{name:"count",type:"int",default:12,help:"Page size (default 12)"},{name:"max-idx",type:"int",default:0,help:"Pagination cursor (recommend: previous searchIdx; similar: previous idx)"},{name:"session-id",help:"Carry-forward sessionId for /book/similar paging"}],columns:["rank","mode","bookId","title","author","rating","readingCount","category","idx","reason","cover","intro","link"],func:async(i)=>{const t=x(i.count,"count",{defaultValue:12,max:50}),n=Number(i["max-idx"]??0),e=i.bookId!==void 0&&i.bookId!==null&&String(i.bookId).trim()!==""?h(i.bookId):null;if(!e)return v({count:t,maxIdx:n});return y({bookId:e,count:t,maxIdx:n,sessionId:i["session-id"]})}});async function v({count:i,maxIdx:t}){const n=await u("/book/recommend",{count:i,maxIdx:t}),e=Array.isArray(n?.books)?n.books:[];if(e.length===0)k("discover","No personalized recommendations available.");return e.map((o,s)=>{const a=String(o?.bookId??"").trim();return{rank:s+1,mode:"recommend",bookId:a,title:String(o?.title??""),author:String(o?.author??""),rating:b(o?.newRating),readingCount:Number(o?.readingCount??0),category:String(o?.category??""),idx:Number(o?.searchIdx??0),reason:String(o?.reason??""),cover:String(o?.cover??""),intro:f(o?.intro,200),link:a?g({bookId:a}):""}})}async function y({bookId:i,count:t,maxIdx:n,sessionId:e}){const o={bookId:i,count:t,maxIdx:n},s=String(e??"").trim();if(s)o.sessionId=s;const a=await u("/book/similar",o),c=a?.booksimilar??a,l=Array.isArray(c?.books)?c.books:[];if(l.length===0)k("discover",`No similar books for bookId=${i}.`);return l.map((d,I)=>{const r=d?.book?.bookInfo??d?.bookInfo??{},m=String(r?.bookId??"").trim();return{rank:I+1,mode:"similar",bookId:m,title:String(r?.title??""),author:String(r?.author??""),rating:b(r?.newRating),readingCount:Number(r?.readingCount??0),category:String(r?.category??""),idx:Number(d?.idx??0),reason:"",cover:String(r?.cover??""),intro:f(r?.intro,200),link:m?g({bookId:m}):""}})}

package/clis/weread-official/list-apis.js

@@ -1 +1 @@
-import{cli as Y,Strategy as Z}from"@jackwener/opencli/registry";import{callGateway as $,emptyResult as A,SKILL_VERSION as G}from"./utils.js";Y({site:"weread-official",name:"list-apis",access:"read",description:"List every api_name supported by the WeRead agent gateway",domain:"weread.qq.com",strategy:Z.PUBLIC,browser:!1,args:[],columns:["rank","apiName","description","required","optional","extras"],func:async()=>{const B=await $("/_list",{}),D=J(B);if(D.length===0)A("list-apis","Gateway returned no api inventory.");const F=D.map((C,H)=>{const M=Q(C?.required??C?.requiredParams??C?.params?.required),U=Q(C?.optional??C?.optionalParams??C?.params?.optional),W=String(C?.description??C?.help??C?.summary??""),X=T(C,["api_name","apiName","name","description","help","summary","required","optional","requiredParams","optionalParams","params"]);return{rank:H+1,apiName:String(C?.api_name??C?.apiName??C?.name??""),description:W,required:M,optional:U,extras:X}});F.push({rank:F.length+1,apiName:"(client)",description:"Local skill version reported with every gateway request",required:"",optional:"",extras:`SKILL_VERSION=${G}`});return F}});function J(B){if(!B||typeof B!=="object")return[];const D=[B?.apis,B?.list,B?.data,B?.items,B?.endpoints];for(const F of D)if(Array.isArray(F)&&F.length>0)return F;if(Array.isArray(B))return B;return[]}function Q(B){if(!B)return"";if(Array.isArray(B))return B.map((D)=>typeof D==="string"?D:D?.name??D?.param??"").filter(Boolean).join(", ");if(typeof B==="object")return Object.keys(B).filter(Boolean).join(", ");return String(B)}function T(B,D){if(!B||typeof B!=="object")return"";const F=new Set(D),C={};for(const[H,M]of Object.entries(B)){if(F.has(H))continue;C[H]=M}if(Object.keys(C).length===0)return"";try{return JSON.stringify(C)}catch{return""}}
+import{cli as m,Strategy as u}from"@jackwener/opencli/registry";import{callGateway as f,emptyResult as l,SKILL_VERSION as d}from"./utils.js";m({site:"weread-official",name:"list-apis",access:"read",description:"List every api_name supported by the WeRead agent gateway",domain:"weread.qq.com",strategy:u.PUBLIC,browser:!1,args:[],columns:["rank","apiName","description","required","optional","extras"],func:async()=>{const r=await f("/_list",{}),i=g(r);if(i.length===0)l("list-apis","Gateway returned no api inventory.");const t=i.map((e,a)=>{const n=s(e?.required??e?.requiredParams??e?.params?.required),o=s(e?.optional??e?.optionalParams??e?.params?.optional),c=String(e?.description??e?.help??e?.summary??""),p=w(e,["api_name","apiName","name","description","help","summary","required","optional","requiredParams","optionalParams","params"]);return{rank:a+1,apiName:String(e?.api_name??e?.apiName??e?.name??""),description:c,required:n,optional:o,extras:p}});t.push({rank:t.length+1,apiName:"(client)",description:"Local skill version reported with every gateway request",required:"",optional:"",extras:`SKILL_VERSION=${d}`});return t}});function g(r){if(!r||typeof r!=="object")return[];const i=[r?.apis,r?.list,r?.data,r?.items,r?.endpoints];for(const t of i)if(Array.isArray(t)&&t.length>0)return t;if(Array.isArray(r))return r;return[]}function s(r){if(!r)return"";if(Array.isArray(r))return r.map((i)=>typeof i==="string"?i:i?.name??i?.param??"").filter(Boolean).join(", ");if(typeof r==="object")return Object.keys(r).filter(Boolean).join(", ");return String(r)}function w(r,i){if(!r||typeof r!=="object")return"";const t=new Set(i),e={};for(const[a,n]of Object.entries(r)){if(t.has(a))continue;e[a]=n}if(Object.keys(e).length===0)return"";try{return JSON.stringify(e)}catch{return""}}

package/clis/weread-official/notes.js

@@ -1 +1 @@
-import{cli as q,Strategy as x}from"@jackwener/opencli/registry";import{callGateway as O,emptyResult as W,formatDate as j,makeDeepLink as V,parseRange as G,requireBookId as N,requirePositiveInt as E,truncate as K}from"./utils.js";q({site:"weread-official",name:"notes",access:"read",description:"List notebooks overview or merged highlights+thoughts for a book",domain:"weread.qq.com",strategy:x.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,help:"Limit to one book; omit for full notebook overview"},{name:"count",type:"int",default:20,help:"Page size for the notebooks overview (1-100)"},{name:"last-sort",type:"int",help:"Cursor: pass previous page sort value to fetch the next page (/user/notebooks)"}],columns:["kind","bookId","title","author","chapter","reviewCount","noteCount","bookmarkCount","totalNotes","progress","finished","sort","range","text","thought","star","createTime","link"],func:async(z)=>{const M=z.bookId!==void 0&&z.bookId!==null&&String(z.bookId).trim()!==""?N(z.bookId):null;if(!M)return P(z);return T(M)}});async function P(z){const X={count:E(z.count,"count",{defaultValue:20,max:100})};if(z["last-sort"]!==void 0&&z["last-sort"]!==null&&z["last-sort"]!=="")X.lastSort=E(z["last-sort"],"last-sort");const Q=await O("/user/notebooks",X),$=Array.isArray(Q?.books)?Q.books:[];if($.length===0)W("notes","No notebooks found.");return $.map((F)=>{const Y=F?.book??{},Z=String(F?.bookId??Y?.bookId??"").trim(),H=Number(F?.reviewCount??0),A=Number(F?.noteCount??0),J=Number(F?.bookmarkCount??0);return{kind:"notebook",bookId:Z,title:String(Y?.title??""),author:String(Y?.author??""),chapter:"",reviewCount:H,noteCount:A,bookmarkCount:J,totalNotes:H+A+J,progress:String(F?.readingProgress??""),finished:Number(F?.markedStatus??0)===1,sort:Number(F?.sort??0),range:"",text:"",thought:"",star:"",createTime:"",link:Z?V({bookId:Z}):""}})}async function T(z){const[M,X]=await Promise.all([O("/book/bookmarklist",{bookId:z}),O("/review/list/mine",{bookid:z})]),Q=new Map,$=Array.isArray(M?.chapters)?M.chapters:[];for(const H of $){const A=String(H?.chapterUid??"").trim();if(!A)continue;Q.set(A,String(H?.title??""))}const F=[],Y=Array.isArray(M?.updated)?M.updated:[];for(const H of Y){const A=String(H?.chapterUid??"").trim(),{rangeStart:J,rangeEnd:_}=G(H?.range);F.push({kind:"highlight",bookId:z,title:"",author:"",chapter:Q.get(A)??"",reviewCount:0,noteCount:0,bookmarkCount:0,totalNotes:0,progress:"",finished:!1,sort:0,range:String(H?.range??""),text:K(H?.markText,400),thought:"",star:"",createTime:j(H?.createTime),link:J&&_&&A?V({bookId:z,chapterUid:A,rangeStart:J,rangeEnd:_}):A?V({bookId:z,chapterUid:A}):V({bookId:z})})}const Z=Array.isArray(X?.reviews)?X.reviews:[];for(const H of Z){const A=H?.review??{},J=String(A?.chapterUid??"").trim(),_=Number(A?.star??-1);F.push({kind:"thought",bookId:z,title:"",author:"",chapter:String(A?.chapterName??"")||(Q.get(J)??""),reviewCount:0,noteCount:0,bookmarkCount:0,totalNotes:0,progress:"",finished:Number(A?.isFinish??0)===1,sort:0,range:String(A?.range??""),text:"",thought:K(A?.content,400),star:_>=0?String(_):"",createTime:j(A?.createTime),link:J?V({bookId:z,chapterUid:J}):V({bookId:z})})}if(F.length===0)W("notes",`No highlights or thoughts saved for bookId=${z}.`);return F}
+import{cli as b,Strategy as w}from"@jackwener/opencli/registry";import{callGateway as k,emptyResult as p,formatDate as g,makeDeepLink as a,parseRange as v,requireBookId as C,requirePositiveInt as d,truncate as f}from"./utils.js";b({site:"weread-official",name:"notes",access:"read",description:"List notebooks overview or merged highlights+thoughts for a book",domain:"weread.qq.com",strategy:w.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,help:"Limit to one book; omit for full notebook overview"},{name:"count",type:"int",default:20,help:"Page size for the notebooks overview (1-100)"},{name:"last-sort",type:"int",help:"Cursor: pass previous page sort value to fetch the next page (/user/notebooks)"}],columns:["kind","bookId","title","author","chapter","reviewCount","noteCount","bookmarkCount","totalNotes","progress","finished","sort","range","text","thought","star","createTime","link"],func:async(t)=>{const s=t.bookId!==void 0&&t.bookId!==null&&String(t.bookId).trim()!==""?C(t.bookId):null;if(!s)return S(t);return N(s)}});async function S(t){const u={count:d(t.count,"count",{defaultValue:20,max:100})};if(t["last-sort"]!==void 0&&t["last-sort"]!==null&&t["last-sort"]!=="")u.lastSort=d(t["last-sort"],"last-sort");const i=await k("/user/notebooks",u),m=Array.isArray(i?.books)?i.books:[];if(m.length===0)p("notes","No notebooks found.");return m.map((e)=>{const c=e?.book??{},h=String(e?.bookId??c?.bookId??"").trim(),r=Number(e?.reviewCount??0),o=Number(e?.noteCount??0),n=Number(e?.bookmarkCount??0);return{kind:"notebook",bookId:h,title:String(c?.title??""),author:String(c?.author??""),chapter:"",reviewCount:r,noteCount:o,bookmarkCount:n,totalNotes:r+o+n,progress:String(e?.readingProgress??""),finished:Number(e?.markedStatus??0)===1,sort:Number(e?.sort??0),range:"",text:"",thought:"",star:"",createTime:"",link:h?a({bookId:h}):""}})}async function N(t){const[s,u]=await Promise.all([k("/book/bookmarklist",{bookId:t}),k("/review/list/mine",{bookid:t})]),i=new Map,m=Array.isArray(s?.chapters)?s.chapters:[];for(const r of m){const o=String(r?.chapterUid??"").trim();if(!o)continue;i.set(o,String(r?.title??""))}const e=[],c=Array.isArray(s?.updated)?s.updated:[];for(const r of c){const o=String(r?.chapterUid??"").trim(),{rangeStart:n,rangeEnd:l}=v(r?.range);e.push({kind:"highlight",bookId:t,title:"",author:"",chapter:i.get(o)??"",reviewCount:0,noteCount:0,bookmarkCount:0,totalNotes:0,progress:"",finished:!1,sort:0,range:String(r?.range??""),text:f(r?.markText,400),thought:"",star:"",createTime:g(r?.createTime),link:n&&l&&o?a({bookId:t,chapterUid:o,rangeStart:n,rangeEnd:l}):o?a({bookId:t,chapterUid:o}):a({bookId:t})})}const h=Array.isArray(u?.reviews)?u.reviews:[];for(const r of h){const o=r?.review??{},n=String(o?.chapterUid??"").trim(),l=Number(o?.star??-1);e.push({kind:"thought",bookId:t,title:"",author:"",chapter:String(o?.chapterName??"")||(i.get(n)??""),reviewCount:0,noteCount:0,bookmarkCount:0,totalNotes:0,progress:"",finished:Number(o?.isFinish??0)===1,sort:0,range:String(o?.range??""),text:"",thought:f(o?.content,400),star:l>=0?String(l):"",createTime:g(o?.createTime),link:n?a({bookId:t,chapterUid:n}):a({bookId:t})})}if(e.length===0)p("notes",`No highlights or thoughts saved for bookId=${t}.`);return e}

package/clis/weread-official/readdata.js

@@ -1 +1 @@
-import{cli as H,Strategy as M}from"@jackwener/opencli/registry";import{callGateway as _,emptyResult as S,formatDate as h,formatDuration as N,requireChoice as k,requirePositiveInt as v}from"./utils.js";const MODE_CHOICES=["weekly","monthly","annually","overall"];H({site:"weread-official",name:"readdata",access:"read",description:"Reading statistics: time, streak, preferences, top books",domain:"weread.qq.com",strategy:M.PUBLIC,browser:!1,args:[{name:"mode",default:"monthly",choices:MODE_CHOICES,help:"Stat window: weekly / monthly / annually / overall"},{name:"base-time",type:"int",help:"Optional Unix timestamp inside the target period; default is current period"}],columns:["section","idx","key","value","detail"],func:async(L)=>{const Q=k(L.mode,MODE_CHOICES,"mode","monthly"),U={mode:Q};if(L["base-time"]!==void 0&&L["base-time"]!==null&&L["base-time"]!=="")U.baseTime=v(L["base-time"],"base-time");const z=await _("/readdata/detail",U),F=[],V=Number(z?.totalReadTime??0),W=Number(z?.dayAverageReadTime??0),P=Number(z?.readDays??0),X=z?.compare,Y=Number.isFinite(Number(X))?Number(X):null,Z=[["mode",Q,""],["baseTime",h(z?.baseTime),String(z?.baseTime??"")],["readDays",String(P),""],["totalReadTime",N(V),`${V}s`],["dayAverageReadTime",N(W),`${W}s`],["compareToPrev",Y===null?"":`${(Y*100).toFixed(1)}%`,""],["readRate",z?.readRate!==void 0?`${Number(z.readRate).toFixed(1)}%`:"",""],["preferTimeWord",String(z?.preferTimeWord??""),""],["preferCategoryWord",String(z?.preferCategoryWord??""),""]];for(let x=0;x<Z.length;x+=1){const[B,J,K]=Z[x];F.push({section:"summary",idx:x+1,key:B,value:J,detail:K})}(Array.isArray(z?.readLongest)?z.readLongest:[]).forEach((x,B)=>{const J=x?.book??{},K=x?.albumInfo??null,j=K?String(K?.name??""):String(J?.title??""),q=K?String(K?.authorName??""):String(J?.author??""),G=Array.isArray(x?.tags)?x.tags.join(","):"",A=Number(x?.readTime??0);F.push({section:"longest",idx:B+1,key:j,value:N(A),detail:`${q}${G?`  [${G}]`:""}`})});(Array.isArray(z?.readStat)?z.readStat:[]).forEach((x,B)=>{F.push({section:"readStat",idx:B+1,key:String(x?.stat??""),value:String(x?.counts??""),detail:""})});(Array.isArray(z?.preferCategory)?z.preferCategory:[]).forEach((x,B)=>{const J=Number(x?.readingTime??0);F.push({section:"preferCategory",idx:B+1,key:String(x?.categoryTitle??""),value:N(J),detail:`${Number(x?.readingCount??0)}本`})});(Array.isArray(z?.preferAuthor)?z.preferAuthor:[]).forEach((x,B)=>{F.push({section:"preferAuthor",idx:B+1,key:String(x?.name??""),value:String(x?.readTime??""),detail:`${Number(x?.count??0)}本`})});(Array.isArray(z?.preferPublisher)?z.preferPublisher:[]).forEach((x,B)=>{F.push({section:"preferPublisher",idx:B+1,key:String(x?.name??""),value:`${Number(x?.count??0)}本`,detail:""})});const $=Array.isArray(z?.preferTime)?z.preferTime:[];if($.length===24)for(let x=0;x<24;x+=1){const B=(6+x)%24,J=Number($[x]??0);F.push({section:"preferTime",idx:x+1,key:`${String(B).padStart(2,"0")}:00`,value:N(J),detail:`${J}s`})}if(F.length===0)S("readdata",`No reading data for mode=${Q}.`);return F}});export{MODE_CHOICES};
+import{cli as T,Strategy as v}from"@jackwener/opencli/registry";import{callGateway as N,emptyResult as k,formatDate as x,formatDuration as n,requireChoice as C,requirePositiveInt as w}from"./utils.js";const MODE_CHOICES=["weekly","monthly","annually","overall"];T({site:"weread-official",name:"readdata",access:"read",description:"Reading statistics: time, streak, preferences, top books",domain:"weread.qq.com",strategy:v.PUBLIC,browser:!1,args:[{name:"mode",default:"monthly",choices:MODE_CHOICES,help:"Stat window: weekly / monthly / annually / overall"},{name:"base-time",type:"int",help:"Optional Unix timestamp inside the target period; default is current period"}],columns:["section","idx","key","value","detail"],func:async(s)=>{const d=C(s.mode,MODE_CHOICES,"mode","monthly"),m={mode:d};if(s["base-time"]!==void 0&&s["base-time"]!==null&&s["base-time"]!=="")m.baseTime=w(s["base-time"],"base-time");const r=await N("/readdata/detail",m),t=[],l=Number(r?.totalReadTime??0),u=Number(r?.dayAverageReadTime??0),h=Number(r?.readDays??0),c=r?.compare,p=Number.isFinite(Number(c))?Number(c):null,f=[["mode",d,""],["baseTime",x(r?.baseTime),String(r?.baseTime??"")],["readDays",String(h),""],["totalReadTime",n(l),`${l}s`],["dayAverageReadTime",n(u),`${u}s`],["compareToPrev",p===null?"":`${(p*100).toFixed(1)}%`,""],["readRate",r?.readRate!==void 0?`${Number(r.readRate).toFixed(1)}%`:"",""],["preferTimeWord",String(r?.preferTimeWord??""),""],["preferCategoryWord",String(r?.preferCategoryWord??""),""]];for(let e=0;e<f.length;e+=1){const[a,o,i]=f[e];t.push({section:"summary",idx:e+1,key:a,value:o,detail:i})}(Array.isArray(r?.readLongest)?r.readLongest:[]).forEach((e,a)=>{const o=e?.book??{},i=e?.albumInfo??null,b=i?String(i?.name??""):String(o?.title??""),S=i?String(i?.authorName??""):String(o?.author??""),g=Array.isArray(e?.tags)?e.tags.join(","):"",A=Number(e?.readTime??0);t.push({section:"longest",idx:a+1,key:b,value:n(A),detail:`${S}${g?`  [${g}]`:""}`})});(Array.isArray(r?.readStat)?r.readStat:[]).forEach((e,a)=>{t.push({section:"readStat",idx:a+1,key:String(e?.stat??""),value:String(e?.counts??""),detail:""})});(Array.isArray(r?.preferCategory)?r.preferCategory:[]).forEach((e,a)=>{const o=Number(e?.readingTime??0);t.push({section:"preferCategory",idx:a+1,key:String(e?.categoryTitle??""),value:n(o),detail:`${Number(e?.readingCount??0)}本`})});(Array.isArray(r?.preferAuthor)?r.preferAuthor:[]).forEach((e,a)=>{t.push({section:"preferAuthor",idx:a+1,key:String(e?.name??""),value:String(e?.readTime??""),detail:`${Number(e?.count??0)}本`})});(Array.isArray(r?.preferPublisher)?r.preferPublisher:[]).forEach((e,a)=>{t.push({section:"preferPublisher",idx:a+1,key:String(e?.name??""),value:`${Number(e?.count??0)}本`,detail:""})});const y=Array.isArray(r?.preferTime)?r.preferTime:[];if(y.length===24)for(let e=0;e<24;e+=1){const a=(6+e)%24,o=Number(y[e]??0);t.push({section:"preferTime",idx:e+1,key:`${String(a).padStart(2,"0")}:00`,value:n(o),detail:`${o}s`})}if(t.length===0)k("readdata",`No reading data for mode=${d}.`);return t}});export{MODE_CHOICES};

package/clis/weread-official/review.js

@@ -1 +1 @@
-import{cli as G,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentError as f}from"@jackwener/opencli/errors";import{callGateway as D,emptyResult as b,formatDate as h,formatStar as j,makeDeepLink as q,requireBookId as K,requirePositiveInt as U,truncate as O}from"./utils.js";const TYPE_ALIASES=Object.freeze({all:0,recommend:1,"thumbs-down":2,newest:3,neutral:4});G({site:"weread-official",name:"review",access:"read",description:"Browse public reviews of a WeRead book",domain:"weread.qq.com",strategy:R.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,required:!0,help:"WeRead bookId (from `weread-official search`)"},{name:"type",default:"all",choices:Object.keys(TYPE_ALIASES),help:"Review filter (all/recommend/thumbs-down/newest/neutral)"},{name:"count",type:"int",default:20,help:"Page size (1-100, default 20)"},{name:"max-idx",type:"int",default:0,help:"Pagination cursor — pass idx from last row of previous page"},{name:"synckey",type:"int",help:"Sync cursor returned by previous response"}],columns:["rank","idx","reviewId","star","starLabel","author","isFinish","chapter","content","createTime","link"],func:async(x)=>{const C=K(x.bookId),F=String(x.type??"all").trim();if(!Object.prototype.hasOwnProperty.call(TYPE_ALIASES,F))throw new f(`weread-official: type must be one of: ${Object.keys(TYPE_ALIASES).join(", ")}`);const V=TYPE_ALIASES[F],W=U(x.count,"count",{defaultValue:20,max:100}),H={bookId:C,reviewListType:V,count:W,maxIdx:Number(x["max-idx"]??0)};if(x.synckey!==void 0&&x.synckey!==null&&x.synckey!=="")H.synckey=U(x.synckey,"synckey");const J=await D("/review/list",H),M=Array.isArray(J?.reviews)?J.reviews:[];if(M.length===0)b("review",`No public reviews for bookId=${C} (type=${F}).`);return M.map((N,X)=>{const Q=N?.review??{},z=Q?.review??{},Z=z?.author??{},$=String(z?.chapterName??"").trim(),B=String(Q?.reviewId??z?.reviewId??"").trim();return{rank:X+1,idx:Number(N?.idx??0),reviewId:B,star:Number(z?.star??0),starLabel:j(z?.star),author:String(Z?.name??""),isFinish:Number(z?.isFinish??0)===1,chapter:$,content:O(z?.content,300),createTime:h(z?.createTime),link:q({bookId:C})}})}});export{TYPE_ALIASES};
+import{cli as f,Strategy as b}from"@jackwener/opencli/registry";import{ArgumentError as h}from"@jackwener/opencli/errors";import{callGateway as k,emptyResult as v,formatDate as I,formatStar as x,makeDeepLink as S,requireBookId as L,requirePositiveInt as m,truncate as N}from"./utils.js";const TYPE_ALIASES=Object.freeze({all:0,recommend:1,"thumbs-down":2,newest:3,neutral:4});f({site:"weread-official",name:"review",access:"read",description:"Browse public reviews of a WeRead book",domain:"weread.qq.com",strategy:b.PUBLIC,browser:!1,args:[{name:"bookId",positional:!0,required:!0,help:"WeRead bookId (from `weread-official search`)"},{name:"type",default:"all",choices:Object.keys(TYPE_ALIASES),help:"Review filter (all/recommend/thumbs-down/newest/neutral)"},{name:"count",type:"int",default:20,help:"Page size (1-100, default 20)"},{name:"max-idx",type:"int",default:0,help:"Pagination cursor — pass idx from last row of previous page"},{name:"synckey",type:"int",help:"Sync cursor returned by previous response"}],columns:["rank","idx","reviewId","star","starLabel","author","isFinish","chapter","content","createTime","link"],func:async(e)=>{const r=L(e.bookId),i=String(e.type??"all").trim();if(!Object.prototype.hasOwnProperty.call(TYPE_ALIASES,i))throw new h(`weread-official: type must be one of: ${Object.keys(TYPE_ALIASES).join(", ")}`);const l=TYPE_ALIASES[i],u=m(e.count,"count",{defaultValue:20,max:100}),o={bookId:r,reviewListType:l,count:u,maxIdx:Number(e["max-idx"]??0)};if(e.synckey!==void 0&&e.synckey!==null&&e.synckey!=="")o.synckey=m(e.synckey,"synckey");const n=await k("/review/list",o),a=Array.isArray(n?.reviews)?n.reviews:[];if(a.length===0)v("review",`No public reviews for bookId=${r} (type=${i}).`);return a.map((s,d)=>{const c=s?.review??{},t=c?.review??{},y=t?.author??{},p=String(t?.chapterName??"").trim(),w=String(c?.reviewId??t?.reviewId??"").trim();return{rank:d+1,idx:Number(s?.idx??0),reviewId:w,star:Number(t?.star??0),starLabel:x(t?.star),author:String(y?.name??""),isFinish:Number(t?.isFinish??0)===1,chapter:p,content:N(t?.content,300),createTime:I(t?.createTime),link:S({bookId:r})}})}});export{TYPE_ALIASES};

package/clis/weread-official/search.js

@@ -1 +1 @@
-import{cli as T,Strategy as q}from"@jackwener/opencli/registry";import{ArgumentError as v}from"@jackwener/opencli/errors";import{callGateway as x,emptyResult as $,formatRating as j,makeDeepLink as h,requirePositiveInt as H,requireText as b,truncate as I}from"./utils.js";export const SEARCH_SCOPES=Object.freeze({all:0,ebook:10,webnovel:16,audio:14,author:6,fulltext:12,booklist:13,mp:2,article:4});const L=Object.freeze({0:"全部",10:"电子书",16:"网文小说",14:"微信听书",6:"作者",12:"全文",13:"书单",2:"公众号",4:"文章"});T({site:"weread-official",name:"search",access:"read",description:"Search WeRead store via the official agent gateway",domain:"weread.qq.com",strategy:q.PUBLIC,browser:!1,args:[{name:"keyword",positional:!0,required:!0,help:"Search keyword"},{name:"scope",default:"ebook",choices:Object.keys(SEARCH_SCOPES),help:"Search type (all/ebook/webnovel/audio/author/fulltext/booklist/mp/article)"},{name:"count",type:"int",help:"Page size (gateway default 15 when omitted)"},{name:"max-idx",type:"int",default:0,help:"Pagination offset, use searchIdx of last item from previous page"}],columns:["rank","scope","bookId","title","author","rating","readingCount","category","searchIdx","cover","intro","link"],func:async(z)=>{const N=b(z.keyword,"keyword"),J=String(z.scope??"ebook").trim();if(!Object.prototype.hasOwnProperty.call(SEARCH_SCOPES,J))throw new v(`weread-official: scope must be one of: ${Object.keys(SEARCH_SCOPES).join(", ")}`);const B=SEARCH_SCOPES[J],W={keyword:N,scope:B,maxIdx:z["max-idx"]??0};if(z.count!==void 0&&z.count!==null&&z.count!=="")W.count=H(z.count,"count",{max:100});const X=await x("/store/search",W),Y=Array.isArray(X?.results)?X.results:[];if(Y.length===0)$("search",`No results for "${N}" (scope=${J}).`);const Q=[];let Z=0;for(const U of Y){const D=L[Number(U?.scope)]??"",G=Array.isArray(U?.books)?U.books:[];for(const M of G){Z+=1;const F=M?.bookInfo??{},V=String(F.bookId??"").trim();Q.push({rank:Z,scope:D,bookId:V,title:String(F.title??""),author:String(F.author??""),rating:j(M?.newRating),readingCount:Number(M?.readingCount??0),category:String(F.category??""),searchIdx:Number(M?.searchIdx??0),cover:String(F.cover??""),intro:I(F.intro,120),link:V?h({bookId:V}):""})}}if(Q.length===0)$("search",`No books found in results for "${N}" (scope=${J}).`);return Q}});
+import{cli as h,Strategy as k}from"@jackwener/opencli/registry";import{ArgumentError as b}from"@jackwener/opencli/errors";import{callGateway as g,emptyResult as f,formatRating as w,makeDeepLink as x,requirePositiveInt as S,requireText as I,truncate as v}from"./utils.js";export const SEARCH_SCOPES=Object.freeze({all:0,ebook:10,webnovel:16,audio:14,author:6,fulltext:12,booklist:13,mp:2,article:4});const O=Object.freeze({0:"全部",10:"电子书",16:"网文小说",14:"微信听书",6:"作者",12:"全文",13:"书单",2:"公众号",4:"文章"});h({site:"weread-official",name:"search",access:"read",description:"Search WeRead store via the official agent gateway",domain:"weread.qq.com",strategy:k.PUBLIC,browser:!1,args:[{name:"keyword",positional:!0,required:!0,help:"Search keyword"},{name:"scope",default:"ebook",choices:Object.keys(SEARCH_SCOPES),help:"Search type (all/ebook/webnovel/audio/author/fulltext/booklist/mp/article)"},{name:"count",type:"int",help:"Page size (gateway default 15 when omitted)"},{name:"max-idx",type:"int",default:0,help:"Pagination offset, use searchIdx of last item from previous page"}],columns:["rank","scope","bookId","title","author","rating","readingCount","category","searchIdx","cover","intro","link"],func:async(e)=>{const a=I(e.keyword,"keyword"),t=String(e.scope??"ebook").trim();if(!Object.prototype.hasOwnProperty.call(SEARCH_SCOPES,t))throw new b(`weread-official: scope must be one of: ${Object.keys(SEARCH_SCOPES).join(", ")}`);const d=SEARCH_SCOPES[t],s={keyword:a,scope:d,maxIdx:e["max-idx"]??0};if(e.count!==void 0&&e.count!==null&&e.count!=="")s.count=S(e.count,"count",{max:100});const u=await g("/store/search",s),l=Array.isArray(u?.results)?u.results:[];if(l.length===0)f("search",`No results for "${a}" (scope=${t}).`);const n=[];let p=0;for(const i of l){const m=O[Number(i?.scope)]??"",y=Array.isArray(i?.books)?i.books:[];for(const r of y){p+=1;const o=r?.bookInfo??{},c=String(o.bookId??"").trim();n.push({rank:p,scope:m,bookId:c,title:String(o.title??""),author:String(o.author??""),rating:w(r?.newRating),readingCount:Number(r?.readingCount??0),category:String(o.category??""),searchIdx:Number(r?.searchIdx??0),cover:String(o.cover??""),intro:v(o.intro,120),link:c?x({bookId:c}):""})}}if(n.length===0)f("search",`No books found in results for "${a}" (scope=${t}).`);return n}});

package/clis/weread-official/shelf.js

@@ -1 +1 @@
-import{cli as Q,Strategy as T}from"@jackwener/opencli/registry";import{callGateway as U,emptyResult as V,formatDate as F,makeDeepLink as W}from"./utils.js";Q({site:"weread-official",name:"shelf",access:"read",description:"Sync your WeRead shelf (books + albums + article bookmark entry) via the official gateway",domain:"weread.qq.com",strategy:T.PUBLIC,browser:!1,args:[],columns:["kind","id","title","author","category","secret","isTop","finished","updateTime","cover","link"],func:async()=>{const A=await U("/shelf/sync",{}),H=Array.isArray(A?.books)?A.books:[],J=Array.isArray(A?.albums)?A.albums:[],B=A?.mp,N=Boolean(B&&typeof B==="object"&&(Array.isArray(B)?B.length>0:Object.keys(B).length>0)),C=[];for(const q of H){const z=String(q?.bookId??"").trim();C.push({kind:"book",id:z,title:String(q?.title??""),author:String(q?.author??""),category:String(q?.category??""),secret:Number(q?.secret??0)===1,isTop:Number(q?.isTop??0)===1,finished:Number(q?.finishReading??0)===1,updateTime:F(q?.readUpdateTime??q?.updateTime),cover:String(q?.cover??""),link:z?W({bookId:z}):""})}for(const q of J){const z=q?.albumInfo??{},E=q?.albumInfoExtra??{},O=String(z?.albumId??"").trim();C.push({kind:"album",id:O,title:String(z?.name??""),author:String(z?.authorName??""),category:"",secret:Number(E?.secret??0)===1,isTop:Number(E?.isTop??0)===1,finished:Number(z?.finish??0)===1,updateTime:F(E?.lectureReadUpdateTime??z?.updateTime),cover:String(z?.cover??""),link:""})}if(N)C.push({kind:"mp",id:"",title:"文章收藏",author:"",category:"",secret:!0,isTop:!1,finished:!1,updateTime:"",cover:"",link:""});if(C.length===0)V("shelf","Your WeRead shelf is empty.");return C}});
+import{cli as u,Strategy as d}from"@jackwener/opencli/registry";import{callGateway as f,emptyResult as p,formatDate as s,makeDeepLink as b}from"./utils.js";u({site:"weread-official",name:"shelf",access:"read",description:"Sync your WeRead shelf (books + albums + article bookmark entry) via the official gateway",domain:"weread.qq.com",strategy:d.PUBLIC,browser:!1,args:[],columns:["kind","id","title","author","category","secret","isTop","finished","updateTime","cover","link"],func:async()=>{const r=await f("/shelf/sync",{}),n=Array.isArray(r?.books)?r.books:[],c=Array.isArray(r?.albums)?r.albums:[],o=r?.mp,m=Boolean(o&&typeof o==="object"&&(Array.isArray(o)?o.length>0:Object.keys(o).length>0)),i=[];for(const e of n){const t=String(e?.bookId??"").trim();i.push({kind:"book",id:t,title:String(e?.title??""),author:String(e?.author??""),category:String(e?.category??""),secret:Number(e?.secret??0)===1,isTop:Number(e?.isTop??0)===1,finished:Number(e?.finishReading??0)===1,updateTime:s(e?.readUpdateTime??e?.updateTime),cover:String(e?.cover??""),link:t?b({bookId:t}):""})}for(const e of c){const t=e?.albumInfo??{},a=e?.albumInfoExtra??{},l=String(t?.albumId??"").trim();i.push({kind:"album",id:l,title:String(t?.name??""),author:String(t?.authorName??""),category:"",secret:Number(a?.secret??0)===1,isTop:Number(a?.isTop??0)===1,finished:Number(t?.finish??0)===1,updateTime:s(a?.lectureReadUpdateTime??t?.updateTime),cover:String(t?.cover??""),link:""})}if(m)i.push({kind:"mp",id:"",title:"文章收藏",author:"",category:"",secret:!0,isTop:!1,finished:!1,updateTime:"",cover:"",link:""});if(i.length===0)p("shelf","Your WeRead shelf is empty.");return i}});

package/clis/weread-official/utils.js

@@ -1 +1 @@
-import{ArgumentError as B,AuthRequiredError as q,CommandExecutionError as K,EmptyResultError as W,TimeoutError as C}from"@jackwener/opencli/errors";export const WEREAD_GATEWAY_URL="https://i.weread.qq.com/api/agent/gateway",WEREAD_DOMAIN="weread.qq.com",SKILL_VERSION="1.0.3";const O=30000,U=new Set([-2010,-2012]);export function getApiKey(){const J=String(process.env.WEREAD_API_KEY??"").trim();if(!J)throw new q(WEREAD_DOMAIN,"WEREAD_API_KEY is not set. Export it with `export WEREAD_API_KEY=<wrk-...>`.");return J}export function buildGatewayBody(J,P={}){if(!J||typeof J!=="string")throw new B("weread-official: api_name is required");const z={api_name:J,skill_version:SKILL_VERSION};for(const[Z,Q]of Object.entries(P??{})){if(Q===void 0||Q===null||Q==="")continue;z[Z]=Q}return z}export async function callGateway(J,P={},{timeoutMs:z=O}={}){const Z=getApiKey(),Q=buildGatewayBody(J,P),$=new AbortController,Y=setTimeout(()=>$.abort(),z);let F;try{F=await fetch(WEREAD_GATEWAY_URL,{method:"POST",headers:{Authorization:`Bearer ${Z}`,"Content-Type":"application/json"},body:JSON.stringify(Q),signal:$.signal})}catch(X){if(X?.name==="AbortError")throw new C(`weread-official ${J}`,Math.round(z/1000));const G=X instanceof Error?X.message:String(X);throw new K(`weread-official ${J} request failed`,G)}finally{clearTimeout(Y)}if(!F.ok)throw new K(`weread-official ${J} HTTP ${F.status}`,"Check WeRead gateway availability and that WEREAD_API_KEY is still valid.");let j;try{j=await F.json()}catch(X){const G=X instanceof Error?X.message:String(X);throw new K(`weread-official ${J} returned invalid JSON`,G)}if(j&&typeof j==="object"&&j.upgrade_info){const X=j.upgrade_info,G=X?.required_version??X?.version??"unknown",w=X?.message??"WeRead skill version is outdated";throw new K(`WeRead skill 需升级: ${w}. Required skill_version=${G}, current=${SKILL_VERSION}`,"Pull the latest weread-skills.zip and bump SKILL_VERSION in clis/weread-official/utils.js.")}const H=Number(j?.errcode??0);if(H!==0){const X=String(j?.errmsg??"unknown error");if(U.has(H))throw new q(WEREAD_DOMAIN,`WEREAD_API_KEY rejected (errcode=${H}, ${X}). Regenerate the key and re-export it.`);throw new K(`weread-official ${J} returned errcode=${H}`,X)}return j}export function formatDate(J){const P=Number(J);if(!Number.isFinite(P)||P<=0)return"";const z=new Date(P*1000);if(Number.isNaN(z.getTime()))return"";const Z=z.getUTCFullYear(),Q=String(z.getUTCMonth()+1).padStart(2,"0"),$=String(z.getUTCDate()).padStart(2,"0");return`${Z}-${Q}-${$}`}export function formatDuration(J){if(J===null||J===void 0||J==="")return"";const P=Number(J);if(!Number.isFinite(P)||P<0)return"";const z=Math.floor(P),Z=Math.floor(z/3600),Q=Math.floor(z%3600/60);if(Z>0)return`${Z}小时${Q}分钟`;return`${Q}分钟`}export function formatStar(J){const P=Number(J);if(!Number.isFinite(P)||P<=0)return"无评分";const z=Math.min(5,Math.floor(P/20));if(z<=0)return"无评分";return"⭐".repeat(z)}export function formatRating(J){const P=Number(J);if(!Number.isFinite(P)||P<=0)return"暂无";const z=P/10;if(z>=90)return`神作 ${Math.round(z)}%`;if(z>=80)return`力荐 ${Math.round(z)}%`;if(z>=70)return`好评 ${Math.round(z)}%`;return`${z.toFixed(1)}分`}export function truncate(J,P=200){const z=String(J??"");if(!z)return"";if(z.length<=P)return z;return`${z.slice(0,P)}…`}export function makeDeepLink({bookId:J,chapterUid:P="",rangeStart:z="",rangeEnd:Z="",userVid:Q=""}={}){const $=String(J??"").trim();if(!$)return"";const Y=String(P??"").trim(),F=String(z??"").trim(),j=String(Z??"").trim();if(Y&&F&&j){const H=new URLSearchParams({bookId:$,chapterUid:Y,rangeStart:F,rangeEnd:j}),X=String(Q??"").trim();if(X)H.set("userVid",X);return`weread://bestbookmark?${H.toString()}`}if(Y)return`weread://reading?bId=${$}&chapterUid=${Y}`;return`weread://reading?bId=${$}`}export function parseRange(J){const z=String(J??"").trim().match(/^(\d+)-(\d+)$/);if(!z)return{rangeStart:"",rangeEnd:""};return{rangeStart:z[1],rangeEnd:z[2]}}export function requireText(J,P){const z=String(J??"").trim();if(!z)throw new B(`weread-official: ${P} cannot be empty`);return z}export function requireBookId(J,P="bookId"){const z=requireText(J,P);if(!/^[A-Za-z0-9_-]+$/.test(z))throw new B(`weread-official: ${P} contains invalid characters`,"Pass a bookId from `weread-official search`.");return z}export function requirePositiveInt(J,P,{defaultValue:z,max:Z}={}){if(J===void 0||J===null||J===""){if(z===void 0)throw new B(`weread-official: ${P} is required`);return z}const Q=String(J).trim();if(!/^\d+$/.test(Q))throw new B(`weread-official: ${P} must be a positive integer`);const $=Number(Q);if(!Number.isSafeInteger($)||$<1)throw new B(`weread-official: ${P} must be a positive integer`);if(Z!==void 0&&$>Z)throw new B(`weread-official: ${P} must be <= ${Z}`);return $}export function requireChoice(J,P,z,Z){const Q=String(J??Z??"").trim();if(!P.includes(Q))throw new B(`weread-official: ${z} must be one of: ${P.join(", ")}`);return Q}export function emptyResult(J,P){throw new W(`weread-official ${J}`,P)}
+import{ArgumentError as c,AuthRequiredError as m,CommandExecutionError as l,EmptyResultError as h,TimeoutError as p}from"@jackwener/opencli/errors";export const WEREAD_GATEWAY_URL="https://i.weread.qq.com/api/agent/gateway",WEREAD_DOMAIN="weread.qq.com",SKILL_VERSION="1.0.3";const E=30000,S=new Set([-2010,-2012]);export function getApiKey(){const t=String(process.env.WEREAD_API_KEY??"").trim();if(!t)throw new m(WEREAD_DOMAIN,"WEREAD_API_KEY is not set. Export it with `export WEREAD_API_KEY=<wrk-...>`.");return t}export function buildGatewayBody(t,r={}){if(!t||typeof t!=="string")throw new c("weread-official: api_name is required");const e={api_name:t,skill_version:SKILL_VERSION};for(const[i,n]of Object.entries(r??{})){if(n===void 0||n===null||n==="")continue;e[i]=n}return e}export async function callGateway(t,r={},{timeoutMs:e=E}={}){const i=getApiKey(),n=buildGatewayBody(t,r),a=new AbortController,d=setTimeout(()=>a.abort(),e);let u;try{u=await fetch(WEREAD_GATEWAY_URL,{method:"POST",headers:{Authorization:`Bearer ${i}`,"Content-Type":"application/json"},body:JSON.stringify(n),signal:a.signal})}catch(o){if(o?.name==="AbortError")throw new p(`weread-official ${t}`,Math.round(e/1000));const w=o instanceof Error?o.message:String(o);throw new l(`weread-official ${t} request failed`,w)}finally{clearTimeout(d)}if(!u.ok)throw new l(`weread-official ${t} HTTP ${u.status}`,"Check WeRead gateway availability and that WEREAD_API_KEY is still valid.");let s;try{s=await u.json()}catch(o){const w=o instanceof Error?o.message:String(o);throw new l(`weread-official ${t} returned invalid JSON`,w)}if(s&&typeof s==="object"&&s.upgrade_info){const o=s.upgrade_info,w=o?.required_version??o?.version??"unknown",g=o?.message??"WeRead skill version is outdated";throw new l(`WeRead skill 需升级: ${g}. Required skill_version=${w}, current=${SKILL_VERSION}`,"Pull the latest weread-skills.zip and bump SKILL_VERSION in clis/weread-official/utils.js.")}const f=Number(s?.errcode??0);if(f!==0){const o=String(s?.errmsg??"unknown error");if(S.has(f))throw new m(WEREAD_DOMAIN,`WEREAD_API_KEY rejected (errcode=${f}, ${o}). Regenerate the key and re-export it.`);throw new l(`weread-official ${t} returned errcode=${f}`,o)}return s}export function formatDate(t){const r=Number(t);if(!Number.isFinite(r)||r<=0)return"";const e=new Date(r*1000);if(Number.isNaN(e.getTime()))return"";const i=e.getUTCFullYear(),n=String(e.getUTCMonth()+1).padStart(2,"0"),a=String(e.getUTCDate()).padStart(2,"0");return`${i}-${n}-${a}`}export function formatDuration(t){if(t===null||t===void 0||t==="")return"";const r=Number(t);if(!Number.isFinite(r)||r<0)return"";const e=Math.floor(r),i=Math.floor(e/3600),n=Math.floor(e%3600/60);if(i>0)return`${i}小时${n}分钟`;return`${n}分钟`}export function formatStar(t){const r=Number(t);if(!Number.isFinite(r)||r<=0)return"无评分";const e=Math.min(5,Math.floor(r/20));if(e<=0)return"无评分";return"⭐".repeat(e)}export function formatRating(t){const r=Number(t);if(!Number.isFinite(r)||r<=0)return"暂无";const e=r/10;if(e>=90)return`神作 ${Math.round(e)}%`;if(e>=80)return`力荐 ${Math.round(e)}%`;if(e>=70)return`好评 ${Math.round(e)}%`;return`${e.toFixed(1)}分`}export function truncate(t,r=200){const e=String(t??"");if(!e)return"";if(e.length<=r)return e;return`${e.slice(0,r)}…`}export function makeDeepLink({bookId:t,chapterUid:r="",rangeStart:e="",rangeEnd:i="",userVid:n=""}={}){const a=String(t??"").trim();if(!a)return"";const d=String(r??"").trim(),u=String(e??"").trim(),s=String(i??"").trim();if(d&&u&&s){const f=new URLSearchParams({bookId:a,chapterUid:d,rangeStart:u,rangeEnd:s}),o=String(n??"").trim();if(o)f.set("userVid",o);return`weread://bestbookmark?${f.toString()}`}if(d)return`weread://reading?bId=${a}&chapterUid=${d}`;return`weread://reading?bId=${a}`}export function parseRange(t){const e=String(t??"").trim().match(/^(\d+)-(\d+)$/);if(!e)return{rangeStart:"",rangeEnd:""};return{rangeStart:e[1],rangeEnd:e[2]}}export function requireText(t,r){const e=String(t??"").trim();if(!e)throw new c(`weread-official: ${r} cannot be empty`);return e}export function requireBookId(t,r="bookId"){const e=requireText(t,r);if(!/^[A-Za-z0-9_-]+$/.test(e))throw new c(`weread-official: ${r} contains invalid characters`,"Pass a bookId from `weread-official search`.");return e}export function requirePositiveInt(t,r,{defaultValue:e,max:i}={}){if(t===void 0||t===null||t===""){if(e===void 0)throw new c(`weread-official: ${r} is required`);return e}const n=String(t).trim();if(!/^\d+$/.test(n))throw new c(`weread-official: ${r} must be a positive integer`);const a=Number(n);if(!Number.isSafeInteger(a)||a<1)throw new c(`weread-official: ${r} must be a positive integer`);if(i!==void 0&&a>i)throw new c(`weread-official: ${r} must be <= ${i}`);return a}export function requireChoice(t,r,e,i){const n=String(t??i??"").trim();if(!r.includes(n))throw new c(`weread-official: ${e} must be one of: ${r.join(", ")}`);return n}export function emptyResult(t,r){throw new h(`weread-official ${t}`,r)}

package/clis/wikidata/entity.js

@@ -1 +1 @@
-import{cli as d,Strategy as p}from"@jackwener/opencli/registry";import{EmptyResultError as y}from"@jackwener/opencli/errors";import{WIKIDATA_BASE as l,joinAliases as u,pickLocalised as o,requireEntityId as m,requireLanguage as g,wikidataFetch as k}from"./utils.js";d({site:"wikidata",name:"entity",access:"read",description:"Fetch a Wikidata entity by Q/P/L id (label, description, aliases, claim summary)",domain:"www.wikidata.org",strategy:p.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Entity id (e.g. Q937 = Albert Einstein, P31 = instance of)"},{name:"language",default:"en",help:"Display language (ISO 639, falls back to English when missing)"}],columns:["qid","type","label","description","aliases","claimPropertyCount","sitelinkCount","enwikiTitle","modified","url"],func:async(a)=>{const e=m(a.id),t=g(a.language),r=`${l}/wiki/Special:EntityData/${encodeURIComponent(e)}.json`,i=(await k(r,"wikidata entity"))?.entities?.[e];if(!i)throw new y("wikidata entity",`Wikidata entity ${e} returned no payload.`);const c=i.claims&&typeof i.claims==="object"?i.claims:{},s=i.sitelinks&&typeof i.sitelinks==="object"?i.sitelinks:{},n=s?.enwiki?.title;return[{qid:e,type:typeof i.type==="string"?i.type:null,label:o(i.labels,t),description:o(i.descriptions,t),aliases:u(i.aliases,t),claimPropertyCount:Object.keys(c).length,sitelinkCount:Object.keys(s).length,enwikiTitle:typeof n==="string"&&n.trim()?n:null,modified:typeof i.modified==="string"?i.modified:null,url:`${l}/wiki/${e}`}]}});
+import{cli as d,Strategy as y}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{WIKIDATA_BASE as l,joinAliases as p,pickLocalised as o,requireEntityId as u,requireLanguage as k,wikidataFetch as g}from"./utils.js";d({site:"wikidata",name:"entity",access:"read",description:"Fetch a Wikidata entity by Q/P/L id (label, description, aliases, claim summary)",domain:"www.wikidata.org",strategy:y.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Entity id (e.g. Q937 = Albert Einstein, P31 = instance of)"},{name:"language",default:"en",help:"Display language (ISO 639, falls back to English when missing)"}],columns:["qid","type","label","description","aliases","claimPropertyCount","sitelinkCount","enwikiTitle","modified","url"],func:async(a)=>{const e=u(a.id),t=k(a.language),r=`${l}/wiki/Special:EntityData/${encodeURIComponent(e)}.json`,i=(await g(r,"wikidata entity"))?.entities?.[e];if(!i)throw new m("wikidata entity",`Wikidata entity ${e} returned no payload.`);const c=i.claims&&typeof i.claims==="object"?i.claims:{},s=i.sitelinks&&typeof i.sitelinks==="object"?i.sitelinks:{},n=s?.enwiki?.title;return[{qid:e,type:typeof i.type==="string"?i.type:null,label:o(i.labels,t),description:o(i.descriptions,t),aliases:p(i.aliases,t),claimPropertyCount:Object.keys(c).length,sitelinkCount:Object.keys(s).length,enwikiTitle:typeof n==="string"&&n.trim()?n:null,modified:typeof i.modified==="string"?i.modified:null,url:`${l}/wiki/${e}`}]}});

package/clis/wikidata/search.js

@@ -1 +1 @@
-import{cli as u,Strategy as p}from"@jackwener/opencli/registry";import{EmptyResultError as h}from"@jackwener/opencli/errors";import{WIKIDATA_BASE as l,requireBoundedInt as m,requireLanguage as y,requireString as g,wikidataFetch as w}from"./utils.js";u({site:"wikidata",name:"search",access:"read",description:"Search Wikidata items by keyword (returns Q-IDs)",domain:"www.wikidata.org",strategy:p.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword (label / alias)"},{name:"language",default:"en",help:"Search & display language (ISO 639, e.g. en, fr, zh)"},{name:"limit",type:"int",default:20,help:"Max items (1-50)"}],columns:["rank","qid","label","description","matchType","matchText","url"],func:async(t)=>{const r=g(t.query,"query"),a=y(t.language),n=m(t.limit,20,50),c=`${l}/w/api.php?action=wbsearchentities&search=${encodeURIComponent(r)}&language=${encodeURIComponent(a)}&uselang=${encodeURIComponent(a)}&type=item&format=json&limit=${n}&origin=*`,o=await w(c,"wikidata search"),s=Array.isArray(o?.search)?o.search:[];if(!s.length)throw new h("wikidata search",`No Wikidata items matched "${r}" in language "${a}".`);return s.slice(0,n).map((e,d)=>{const i=String(e?.id??"").trim();return{rank:d+1,qid:i,label:typeof e?.label==="string"?e.label:null,description:typeof e?.description==="string"?e.description:null,matchType:typeof e?.match?.type==="string"?e.match.type:null,matchText:typeof e?.match?.text==="string"?e.match.text:null,url:i?`${l}/wiki/${i}`:""}})}});
+import{cli as p,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{WIKIDATA_BASE as s,requireBoundedInt as h,requireLanguage as g,requireString as y,wikidataFetch as w}from"./utils.js";p({site:"wikidata",name:"search",access:"read",description:"Search Wikidata items by keyword (returns Q-IDs)",domain:"www.wikidata.org",strategy:d.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword (label / alias)"},{name:"language",default:"en",help:"Search & display language (ISO 639, e.g. en, fr, zh)"},{name:"limit",type:"int",default:20,help:"Max items (1-50)"}],columns:["rank","qid","label","description","matchType","matchText","url"],func:async(t)=>{const i=y(t.query,"query"),a=g(t.language),n=h(t.limit,20,50),c=`${s}/w/api.php?action=wbsearchentities&search=${encodeURIComponent(i)}&language=${encodeURIComponent(a)}&uselang=${encodeURIComponent(a)}&type=item&format=json&limit=${n}&origin=*`,o=await w(c,"wikidata search"),l=Array.isArray(o?.search)?o.search:[];if(!l.length)throw new m("wikidata search",`No Wikidata items matched "${i}" in language "${a}".`);return l.slice(0,n).map((e,u)=>{const r=String(e?.id??"").trim();return{rank:u+1,qid:r,label:typeof e?.label==="string"?e.label:null,description:typeof e?.description==="string"?e.description:null,matchType:typeof e?.match?.type==="string"?e.match.type:null,matchText:typeof e?.match?.text==="string"?e.match.text:null,url:r?`${s}/wiki/${r}`:""}})}});

package/clis/wikidata/utils.js

@@ -1 +1 @@
-import{ArgumentError as K,CommandExecutionError as L,EmptyResultError as O}from"@jackwener/opencli/errors";export const WIKIDATA_BASE="https://www.wikidata.org";const Q="opencli-wikidata-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)",S=/^[QPL]\d+$/;export function requireString(z,F){const B=String(z??"").trim();if(!B)throw new K(`wikidata ${F} cannot be empty`);return B}export function requireBoundedInt(z,F,B,H="limit"){const G=z??F,J=typeof G==="number"?G:Number(G);if(!Number.isInteger(J)||J<=0)throw new K(`wikidata ${H} must be a positive integer`);if(J>B)throw new K(`wikidata ${H} must be <= ${B}`);return J}export function requireEntityId(z){const F=String(z??"").trim().toUpperCase();if(!F)throw new K('wikidata entity id is required (e.g. "Q937")');const B=F.replace(/^HTTPS?:\/\/[^/]+\/WIKI\//i,"");if(!S.test(B))throw new K(`wikidata entity id "${z}" is not a valid Q/P/L identifier`,'Expected format: "Q<digits>" (item), "P<digits>" (property), or "L<digits>" (lexeme).');return B}export function requireLanguage(z,F="en"){const B=String(z??F).trim().toLowerCase();if(!/^[a-z]{2,3}(-[a-z]{2,8})?$/.test(B))throw new K(`wikidata language "${z}" is not a valid language code`,'Expected an ISO 639 language code such as "en", "fr", "zh", "zh-hans".');return B}export async function wikidataFetch(z,F){let B;try{B=await fetch(z,{headers:{"user-agent":Q,accept:"application/json"}})}catch(G){throw new L(`${F} request failed: ${G?.message??G}`,"Check that www.wikidata.org is reachable from this network.")}if(B.status===404)throw new O(F,`Wikidata returned 404 for ${z}.`);if(B.status===429)throw new L(`${F} returned HTTP 429 (rate limited)`,"Wikidata throttles anonymous traffic; back off and retry.");if(!B.ok)throw new L(`${F} returned HTTP ${B.status}`);let H;try{H=await B.json()}catch(G){throw new L(`${F} returned malformed JSON: ${G?.message??G}`)}return H}export function pickLocalised(z,F){if(!z||typeof z!=="object")return null;const B=z[F];if(B&&typeof B.value==="string"&&B.value.trim())return B.value;if(F!=="en"&&z.en&&typeof z.en.value==="string"&&z.en.value.trim())return z.en.value;return null}export function joinAliases(z,F,B=5){if(!z||typeof z!=="object")return"";let H=Array.isArray(z[F])?z[F]:[];if(H.length===0&&F!=="en"&&Array.isArray(z.en))H=z.en;const G=H.map((J)=>J&&typeof J.value==="string"?J.value:"").filter(Boolean);if(G.length===0)return"";if(G.length>B)return[...G.slice(0,B),`(+${G.length-B})`].join(", ");return G.join(", ")}
+import{ArgumentError as a,CommandExecutionError as s,EmptyResultError as u}from"@jackwener/opencli/errors";export const WIKIDATA_BASE="https://www.wikidata.org";const c="opencli-wikidata-adapter/1.0 (+https://github.com/jackwener/OpenCLI; mailto:ppcli@example.com)",w=/^[QPL]\d+$/;export function requireString(t,r){const e=String(t??"").trim();if(!e)throw new a(`wikidata ${r} cannot be empty`);return e}export function requireBoundedInt(t,r,e,n="limit"){const i=t??r,o=typeof i==="number"?i:Number(i);if(!Number.isInteger(o)||o<=0)throw new a(`wikidata ${n} must be a positive integer`);if(o>e)throw new a(`wikidata ${n} must be <= ${e}`);return o}export function requireEntityId(t){const r=String(t??"").trim().toUpperCase();if(!r)throw new a('wikidata entity id is required (e.g. "Q937")');const e=r.replace(/^HTTPS?:\/\/[^/]+\/WIKI\//i,"");if(!w.test(e))throw new a(`wikidata entity id "${t}" is not a valid Q/P/L identifier`,'Expected format: "Q<digits>" (item), "P<digits>" (property), or "L<digits>" (lexeme).');return e}export function requireLanguage(t,r="en"){const e=String(t??r).trim().toLowerCase();if(!/^[a-z]{2,3}(-[a-z]{2,8})?$/.test(e))throw new a(`wikidata language "${t}" is not a valid language code`,'Expected an ISO 639 language code such as "en", "fr", "zh", "zh-hans".');return e}export async function wikidataFetch(t,r){let e;try{e=await fetch(t,{headers:{"user-agent":c,accept:"application/json"}})}catch(i){throw new s(`${r} request failed: ${i?.message??i}`,"Check that www.wikidata.org is reachable from this network.")}if(e.status===404)throw new u(r,`Wikidata returned 404 for ${t}.`);if(e.status===429)throw new s(`${r} returned HTTP 429 (rate limited)`,"Wikidata throttles anonymous traffic; back off and retry.");if(!e.ok)throw new s(`${r} returned HTTP ${e.status}`);let n;try{n=await e.json()}catch(i){throw new s(`${r} returned malformed JSON: ${i?.message??i}`)}return n}export function pickLocalised(t,r){if(!t||typeof t!=="object")return null;const e=t[r];if(e&&typeof e.value==="string"&&e.value.trim())return e.value;if(r!=="en"&&t.en&&typeof t.en.value==="string"&&t.en.value.trim())return t.en.value;return null}export function joinAliases(t,r,e=5){if(!t||typeof t!=="object")return"";let n=Array.isArray(t[r])?t[r]:[];if(n.length===0&&r!=="en"&&Array.isArray(t.en))n=t.en;const i=n.map((o)=>o&&typeof o.value==="string"?o.value:"").filter(Boolean);if(i.length===0)return"";if(i.length>e)return[...i.slice(0,e),`(+${i.length-e})`].join(", ");return i.join(", ")}

package/clis/wikipedia/page.js

@@ -1,3 +1,3 @@
-import{cli as u,Strategy as w}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as o,EmptyResultError as m}from"@jackwener/opencli/errors";u({site:"wikipedia",name:"page",access:"read",description:"Full plain-text extract of a Wikipedia article (optional paragraph cap).",domain:"wikipedia.org",strategy:w.PUBLIC,browser:!1,args:[{name:"title",positional:!0,required:!0,type:"string",help:'Article title (e.g. "Transformer (machine learning model)")'},{name:"lang",type:"string",default:"en",help:"Language code (en, zh, ja, de, ...)."},{name:"paragraphs",type:"int",default:0,help:"Cap to first N paragraphs (0 = full article)."}],columns:["title","description","pageId","paragraphs","extract","url"],func:async(i)=>{const l=String(i.title??"").trim();if(!l)throw new c("wikipedia page title cannot be empty");const s=String(i.lang??"en").trim().toLowerCase();if(!/^[a-z]{2,3}(?:-[a-z0-9]+)?$/.test(s))throw new c(`wikipedia lang must be a language code like en, zh, ja (got "${i.lang}")`);const n=Number(i.paragraphs??0);if(!Number.isInteger(n)||n<0)throw new c("paragraphs must be a non-negative integer (0 = full article)");const e=new URL(`https://${s}.wikipedia.org/w/api.php`);e.searchParams.set("action","query");e.searchParams.set("format","json");e.searchParams.set("formatversion","2");e.searchParams.set("prop","extracts|info|description");e.searchParams.set("inprop","url");e.searchParams.set("explaintext","1");e.searchParams.set("redirects","1");e.searchParams.set("titles",l);let p;try{p=await fetch(e,{headers:{"User-Agent":"ppcli/1.0 (+https://github.com/jackwener/OpenCLI)",Accept:"application/json"}})}catch(t){throw new o(`wikipedia page request failed: ${t?.message||t}`)}if(!p.ok)throw new o(`wikipedia page failed: HTTP ${p.status}`);let r;try{r=await p.json()}catch(t){throw new o(`wikipedia returned malformed JSON: ${t?.message||t}`)}if(r?.error)throw new o(`wikipedia API error: ${r.error.info||r.error.code}`);const a=(Array.isArray(r?.query?.pages)?r.query.pages:[])[0];if(!a||a.missing)throw new m("wikipedia page",`No article "${l}" on ${s}.wikipedia.org. Try \`ppcli wikipedia search\` first.`);const g=String(a.extract??"");if(!g.trim())throw new m("wikipedia page",`Article "${a.title}" exists but has no plain-text extract (likely a disambiguation/redirect page).`);const h=g.split(/\n{2,}/).map((t)=>t.trim()).filter(Boolean),d=n>0?h.slice(0,n):h;return[{title:a.title,description:a.description||"",pageId:a.pageid??null,paragraphs:d.length,extract:d.join(`
+import{cli as w,Strategy as u}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as o,EmptyResultError as h}from"@jackwener/opencli/errors";w({site:"wikipedia",name:"page",access:"read",description:"Full plain-text extract of a Wikipedia article (optional paragraph cap).",domain:"wikipedia.org",strategy:u.PUBLIC,browser:!1,args:[{name:"title",positional:!0,required:!0,type:"string",help:'Article title (e.g. "Transformer (machine learning model)")'},{name:"lang",type:"string",default:"en",help:"Language code (en, zh, ja, de, ...)."},{name:"paragraphs",type:"int",default:0,help:"Cap to first N paragraphs (0 = full article)."}],columns:["title","description","pageId","paragraphs","extract","url"],func:async(i)=>{const l=String(i.title??"").trim();if(!l)throw new c("wikipedia page title cannot be empty");const s=String(i.lang??"en").trim().toLowerCase();if(!/^[a-z]{2,3}(?:-[a-z0-9]+)?$/.test(s))throw new c(`wikipedia lang must be a language code like en, zh, ja (got "${i.lang}")`);const n=Number(i.paragraphs??0);if(!Number.isInteger(n)||n<0)throw new c("paragraphs must be a non-negative integer (0 = full article)");const e=new URL(`https://${s}.wikipedia.org/w/api.php`);e.searchParams.set("action","query");e.searchParams.set("format","json");e.searchParams.set("formatversion","2");e.searchParams.set("prop","extracts|info|description");e.searchParams.set("inprop","url");e.searchParams.set("explaintext","1");e.searchParams.set("redirects","1");e.searchParams.set("titles",l);let p;try{p=await fetch(e,{headers:{"User-Agent":"ppcli/1.0 (+https://github.com/jackwener/OpenCLI)",Accept:"application/json"}})}catch(r){throw new o(`wikipedia page request failed: ${r?.message||r}`)}if(!p.ok)throw new o(`wikipedia page failed: HTTP ${p.status}`);let t;try{t=await p.json()}catch(r){throw new o(`wikipedia returned malformed JSON: ${r?.message||r}`)}if(t?.error)throw new o(`wikipedia API error: ${t.error.info||t.error.code}`);const a=(Array.isArray(t?.query?.pages)?t.query.pages:[])[0];if(!a||a.missing)throw new h("wikipedia page",`No article "${l}" on ${s}.wikipedia.org. Try \`ppcli wikipedia search\` first.`);const g=String(a.extract??"");if(!g.trim())throw new h("wikipedia page",`Article "${a.title}" exists but has no plain-text extract (likely a disambiguation/redirect page).`);const m=g.split(/\n{2,}/).map((r)=>r.trim()).filter(Boolean),d=n>0?m.slice(0,n):m;return[{title:a.title,description:a.description||"",pageId:a.pageid??null,paragraphs:d.length,extract:d.join(`
 
 `),url:a.fullurl||`https://${s}.wikipedia.org/wiki/${encodeURIComponent(a.title.replace(/ /g,"_"))}`}]}});

package/clis/wikipedia/trending.js

@@ -1 +1 @@
-import{CliError as G}from"@jackwener/opencli/errors";import{cli as Q,Strategy as R}from"@jackwener/opencli/registry";import{DESC_MAX_LEN as T,wikiFetch as U}from"./utils.js";Q({site:"wikipedia",name:"trending",access:"read",description:"Most-read Wikipedia articles (yesterday)",strategy:R.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Max results"},{name:"lang",default:"en",help:"Language code (e.g. en, zh, ja)"}],columns:["rank","title","description","views"],func:async(x)=>{const H=x.lang||"en",I=Math.max(1,Math.min(Number(x.limit),50)),q=new Date(Date.now()-86400000),J=q.getUTCFullYear(),K=String(q.getUTCMonth()+1).padStart(2,"0"),O=String(q.getUTCDate()).padStart(2,"0"),z=(await U(H,`/api/rest_v1/feed/featured/${J}/${K}/${O}`))?.mostread?.articles;if(!z?.length)throw new G("NOT_FOUND","No trending articles available","Try a different language with --lang");const B=z.slice(0,I);if(B.some((f)=>!String(f?.title||"").trim()))throw new G("PARSE_ERROR","Wikipedia trending returned an article without title","Trending rows require a title so they can be opened with wikipedia page.");return B.map((f,P)=>({rank:P+1,title:f.title,description:(f.description??"").slice(0,T),views:f.views??0}))}});
+import{CliError as r}from"@jackwener/opencli/errors";import{cli as m,Strategy as p}from"@jackwener/opencli/registry";import{DESC_MAX_LEN as w,wikiFetch as h}from"./utils.js";m({site:"wikipedia",name:"trending",access:"read",description:"Most-read Wikipedia articles (yesterday)",strategy:p.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:10,help:"Max results"},{name:"lang",default:"en",help:"Language code (e.g. en, zh, ja)"}],columns:["rank","title","description","views"],func:async(i)=>{const s=i.lang||"en",l=Math.max(1,Math.min(Number(i.limit),50)),t=new Date(Date.now()-86400000),o=t.getUTCFullYear(),d=String(t.getUTCMonth()+1).padStart(2,"0"),c=String(t.getUTCDate()).padStart(2,"0"),a=(await h(s,`/api/rest_v1/feed/featured/${o}/${d}/${c}`))?.mostread?.articles;if(!a?.length)throw new r("NOT_FOUND","No trending articles available","Try a different language with --lang");const n=a.slice(0,l);if(n.some((e)=>!String(e?.title||"").trim()))throw new r("PARSE_ERROR","Wikipedia trending returned an article without title","Trending rows require a title so they can be opened with wikipedia page.");return n.map((e,g)=>({rank:g+1,title:e.title,description:(e.description??"").slice(0,w),views:e.views??0}))}});

package/clis/wikipedia/utils.js

@@ -1 +1 @@
-import{CliError as x}from"@jackwener/opencli/errors";export const EXTRACT_MAX_LEN=300,DESC_MAX_LEN=80;export async function wikiFetch(b,f){const v=`https://${b}.wikipedia.org${f}`,q=await fetch(v,{headers:{"User-Agent":"ppcli/1.0 (https://github.com/jackwener/OpenCLI)"}});if(!q.ok)throw new x("FETCH_ERROR",`Wikipedia API HTTP ${q.status}`,"Check your title or search term");return q.json()}export function formatSummaryRow(b,f){return{title:b.title,description:b.description??"-",extract:(b.extract??"").slice(0,EXTRACT_MAX_LEN),url:b.content_urls?.desktop?.page??`https://${f}.wikipedia.org`}}
+import{CliError as o}from"@jackwener/opencli/errors";export const EXTRACT_MAX_LEN=300,DESC_MAX_LEN=80;export async function wikiFetch(t,e){const i=`https://${t}.wikipedia.org${e}`,r=await fetch(i,{headers:{"User-Agent":"ppcli/1.0 (https://github.com/jackwener/OpenCLI)"}});if(!r.ok)throw new o("FETCH_ERROR",`Wikipedia API HTTP ${r.status}`,"Check your title or search term");return r.json()}export function formatSummaryRow(t,e){return{title:t.title,description:t.description??"-",extract:(t.extract??"").slice(0,EXTRACT_MAX_LEN),url:t.content_urls?.desktop?.page??`https://${e}.wikipedia.org`}}

package/clis/wordpress/login.js

@@ -1 +1 @@
-import{cli as Y,Strategy as Z}from"@jackwener/opencli/registry";import{TimeoutError as $}from"@jackwener/opencli/errors";import{resolveBaseUrl as h,readCookieLogin as x,gotoWpAdmin as v,WP_ADMIN as B,WP_LOGIN as G}from"./shared.js";const Q=300,R=3000;async function z(f){if(typeof f?.closeWindow==="function")try{await f.closeWindow()}catch{}}Y({site:"wordpress",name:"login",access:"write",description:"打开自建 WordPress 站点的登录页并等待浏览器会话完成登录（加站模式：站点网址取自连接里的 WORDPRESS_BASE_URL，或用 --base-url）。",domain:"wordpress.org",strategy:Z.COOKIE,browser:!0,navigateBefore:!1,defaultWindowMode:"foreground",siteSession:"persistent",args:[{name:"site",help:"连接名称或站点网址；省略时使用默认站点"},{name:"base-url",help:"站点根网址（默认读连接里的 WORDPRESS_BASE_URL）"},{name:"timeout",type:"int",default:Q,help:"等待用户完成登录的最长秒数"}],columns:["status","logged_in","site"],func:async(f,H)=>{const q=h(H);if(await x(f,q)){await z(f);return[{status:"already_logged_in",logged_in:!0,site:q}]}if(!(await v(f,q,B)).onLogin&&await x(f,q)){await z(f);return[{status:"already_logged_in",logged_in:!0,site:q}]}await f.goto(q+G);const J=Number(H.timeout??Q),K=Date.now()+J*1000;while(Date.now()<K){const X=K-Date.now();await f.wait({time:Math.min(R/1000,Math.max(0.2,X/1000))});if(await x(f,q)){await z(f);return[{status:"login_complete",logged_in:!0,site:q}]}}throw new $("wordpress login",J,`请在打开的窗口里完成 ${q} 的登录后重试。`)}});
+import{cli as d,Strategy as w}from"@jackwener/opencli/registry";import{TimeoutError as u}from"@jackwener/opencli/errors";import{resolveBaseUrl as c,readCookieLogin as o,gotoWpAdmin as m,WP_ADMIN as _,WP_LOGIN as f}from"./shared.js";const a=300,g=3000;async function i(t){if(typeof t?.closeWindow==="function")try{await t.closeWindow()}catch{}}d({site:"wordpress",name:"login",access:"write",description:"打开自建 WordPress 站点的登录页并等待浏览器会话完成登录（加站模式：站点网址取自连接里的 WORDPRESS_BASE_URL，或用 --base-url）。",domain:"wordpress.org",strategy:w.COOKIE,browser:!0,navigateBefore:!1,defaultWindowMode:"foreground",siteSession:"persistent",args:[{name:"site",help:"连接名称或站点网址；省略时使用默认站点"},{name:"base-url",help:"站点根网址（默认读连接里的 WORDPRESS_BASE_URL）"},{name:"timeout",type:"int",default:a,help:"等待用户完成登录的最长秒数"}],columns:["status","logged_in","site"],func:async(t,n)=>{const e=c(n);if(await o(t,e)){await i(t);return[{status:"already_logged_in",logged_in:!0,site:e}]}if(!(await m(t,e,_)).onLogin&&await o(t,e)){await i(t);return[{status:"already_logged_in",logged_in:!0,site:e}]}await t.goto(e+f);const s=Number(n.timeout??a),r=Date.now()+s*1000;while(Date.now()<r){const l=r-Date.now();await t.wait({time:Math.min(g/1000,Math.max(0.2,l/1000))});if(await o(t,e)){await i(t);return[{status:"login_complete",logged_in:!0,site:e}]}}throw new u("wordpress login",s,`请在打开的窗口里完成 ${e} 的登录后重试。`)}});