publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/weread-official/notes.js

@@ -1,171 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    callGateway,
-    emptyResult,
-    formatDate,
-    makeDeepLink,
-    parseRange,
-    requireBookId,
-    requirePositiveInt,
-    truncate,
-} from './utils.js';
-
-/**
- * Two modes share a single command (matches the ninehills reference shape):
- *
- *   - No bookId → `/user/notebooks` overview. One row per book that has notes.
- *                 Total-note column follows SKILL.md statistical contract:
- *                 `total = reviewCount + noteCount + bookmarkCount`. The
- *                 individual fields stay separate so downstream consumers do
- *                 not have to re-derive them.
- *
- *   - With bookId → merge `/book/bookmarklist` (highlights) +
- *                    `/review/list/mine` (thoughts/reviews) into one feed.
- *                    Bookmarks (type=0) are filtered server-side already.
- *
- * Pagination of `/user/notebooks` is cursor-based via `lastSort`; this command
- * surfaces `--last-sort` rather than offset/limit to keep the SKILL.md contract
- * visible at the CLI surface.
- */
-cli({
-    site: 'weread-official',
-    name: 'notes',
-    access: 'read',
-    description: 'List notebooks overview or merged highlights+thoughts for a book',
-    domain: 'weread.qq.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'bookId', positional: true, 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 (args) => {
-        const rawBookId = args.bookId !== undefined && args.bookId !== null && String(args.bookId).trim() !== ''
-            ? requireBookId(args.bookId)
-            : null;
-
-        if (!rawBookId) {
-            return listNotebooks(args);
-        }
-        return listBookNotes(rawBookId);
-    },
-});
-
-async function listNotebooks(args) {
-    const count = requirePositiveInt(args.count, 'count', { defaultValue: 20, max: 100 });
-    const params = { count };
-    if (args['last-sort'] !== undefined && args['last-sort'] !== null && args['last-sort'] !== '') {
-        params.lastSort = requirePositiveInt(args['last-sort'], 'last-sort');
-    }
-    const payload = await callGateway('/user/notebooks', params);
-    const books = Array.isArray(payload?.books) ? payload.books : [];
-    if (books.length === 0) {
-        emptyResult('notes', 'No notebooks found.');
-    }
-    return books.map((entry) => {
-        const book = entry?.book ?? {};
-        const bookId = String(entry?.bookId ?? book?.bookId ?? '').trim();
-        const reviewCount = Number(entry?.reviewCount ?? 0);
-        const noteCount = Number(entry?.noteCount ?? 0);
-        const bookmarkCount = Number(entry?.bookmarkCount ?? 0);
-        return {
-            kind: 'notebook',
-            bookId,
-            title: String(book?.title ?? ''),
-            author: String(book?.author ?? ''),
-            chapter: '',
-            reviewCount,
-            noteCount,
-            bookmarkCount,
-            totalNotes: reviewCount + noteCount + bookmarkCount,
-            progress: String(entry?.readingProgress ?? ''),
-            finished: Number(entry?.markedStatus ?? 0) === 1,
-            sort: Number(entry?.sort ?? 0),
-            range: '',
-            text: '',
-            thought: '',
-            star: '',
-            createTime: '',
-            link: bookId ? makeDeepLink({ bookId }) : '',
-        };
-    });
-}
-
-async function listBookNotes(bookId) {
-    const [bookmarksResp, reviewsResp] = await Promise.all([
-        callGateway('/book/bookmarklist', { bookId }),
-        callGateway('/review/list/mine', { bookid: bookId }),
-    ]);
-
-    const chapterIndex = new Map();
-    const chapterList = Array.isArray(bookmarksResp?.chapters) ? bookmarksResp.chapters : [];
-    for (const ch of chapterList) {
-        const uid = String(ch?.chapterUid ?? '').trim();
-        if (!uid) continue;
-        chapterIndex.set(uid, String(ch?.title ?? ''));
-    }
-
-    const rows = [];
-
-    const bookmarks = Array.isArray(bookmarksResp?.updated) ? bookmarksResp.updated : [];
-    for (const bm of bookmarks) {
-        const chapterUid = String(bm?.chapterUid ?? '').trim();
-        const { rangeStart, rangeEnd } = parseRange(bm?.range);
-        rows.push({
-            kind: 'highlight',
-            bookId,
-            title: '',
-            author: '',
-            chapter: chapterIndex.get(chapterUid) ?? '',
-            reviewCount: 0,
-            noteCount: 0,
-            bookmarkCount: 0,
-            totalNotes: 0,
-            progress: '',
-            finished: false,
-            sort: 0,
-            range: String(bm?.range ?? ''),
-            text: truncate(bm?.markText, 400),
-            thought: '',
-            star: '',
-            createTime: formatDate(bm?.createTime),
-            link: rangeStart && rangeEnd && chapterUid
-                ? makeDeepLink({ bookId, chapterUid, rangeStart, rangeEnd })
-                : (chapterUid ? makeDeepLink({ bookId, chapterUid }) : makeDeepLink({ bookId })),
-        });
-    }
-
-    const reviews = Array.isArray(reviewsResp?.reviews) ? reviewsResp.reviews : [];
-    for (const wrapper of reviews) {
-        const rv = wrapper?.review ?? {};
-        const chapterUid = String(rv?.chapterUid ?? '').trim();
-        const star = Number(rv?.star ?? -1);
-        rows.push({
-            kind: 'thought',
-            bookId,
-            title: '',
-            author: '',
-            chapter: String(rv?.chapterName ?? '') || (chapterIndex.get(chapterUid) ?? ''),
-            reviewCount: 0,
-            noteCount: 0,
-            bookmarkCount: 0,
-            totalNotes: 0,
-            progress: '',
-            finished: Number(rv?.isFinish ?? 0) === 1,
-            sort: 0,
-            range: String(rv?.range ?? ''),
-            text: '',
-            thought: truncate(rv?.content, 400),
-            star: star >= 0 ? String(star) : '',
-            createTime: formatDate(rv?.createTime),
-            link: chapterUid ? makeDeepLink({ bookId, chapterUid }) : makeDeepLink({ bookId }),
-        });
-    }
-
-    if (rows.length === 0) {
-        emptyResult('notes', `No highlights or thoughts saved for bookId=${bookId}.`);
-    }
-    return rows;
-}
+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}

package/clis/weread-official/readdata.js

@@ -1,158 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    callGateway,
-    emptyResult,
-    formatDate,
-    formatDuration,
-    requireChoice,
-    requirePositiveInt,
-} from './utils.js';
-
-/**
- * `/readdata/detail` — reading statistics summary.
- * Per SKILL.md every duration field is in SECONDS — `totalReadTime`,
- * `dayAverageReadTime`, `readLongest[].readTime`, `preferTime`, etc.
- * `preferAuthor[].readTime` is the one exception (already formatted by server
- * as "X小时Y分钟"); we surface it verbatim.
- *
- * Output uses a `section` column so callers can filter:
- *   - summary       — single overview row
- *   - longest       — books / albums sorted by read time
- *   - readStat      — counts (读过 / 读完 / 阅读 / 笔记)
- *   - preferCategory / preferAuthor / preferPublisher
- *   - preferTime    — 24h time distribution (starts at 6am per SKILL.md)
- */
-const MODE_CHOICES = ['weekly', 'monthly', 'annually', 'overall'];
-
-cli({
-    site: 'weread-official',
-    name: 'readdata',
-    access: 'read',
-    description: 'Reading statistics: time, streak, preferences, top books',
-    domain: 'weread.qq.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    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 (args) => {
-        const mode = requireChoice(args.mode, MODE_CHOICES, 'mode', 'monthly');
-        const params = { mode };
-        if (args['base-time'] !== undefined && args['base-time'] !== null && args['base-time'] !== '') {
-            params.baseTime = requirePositiveInt(args['base-time'], 'base-time');
-        }
-        const payload = await callGateway('/readdata/detail', params);
-
-        const rows = [];
-        const totalReadTime = Number(payload?.totalReadTime ?? 0);
-        const dayAverage = Number(payload?.dayAverageReadTime ?? 0);
-        const readDays = Number(payload?.readDays ?? 0);
-        const compareRaw = payload?.compare;
-        const compare = Number.isFinite(Number(compareRaw)) ? Number(compareRaw) : null;
-
-        const summary = [
-            ['mode', mode, ''],
-            ['baseTime', formatDate(payload?.baseTime), String(payload?.baseTime ?? '')],
-            ['readDays', String(readDays), ''],
-            ['totalReadTime', formatDuration(totalReadTime), `${totalReadTime}s`],
-            ['dayAverageReadTime', formatDuration(dayAverage), `${dayAverage}s`],
-            ['compareToPrev', compare === null ? '' : `${(compare * 100).toFixed(1)}%`, ''],
-            ['readRate', payload?.readRate !== undefined ? `${Number(payload.readRate).toFixed(1)}%` : '', ''],
-            ['preferTimeWord', String(payload?.preferTimeWord ?? ''), ''],
-            ['preferCategoryWord', String(payload?.preferCategoryWord ?? ''), ''],
-        ];
-        for (let i = 0; i < summary.length; i += 1) {
-            const [key, value, detail] = summary[i];
-            rows.push({ section: 'summary', idx: i + 1, key, value, detail });
-        }
-
-        const longest = Array.isArray(payload?.readLongest) ? payload.readLongest : [];
-        longest.forEach((entry, i) => {
-            const book = entry?.book ?? {};
-            const albumInfo = entry?.albumInfo ?? null;
-            const title = albumInfo ? String(albumInfo?.name ?? '') : String(book?.title ?? '');
-            const author = albumInfo ? String(albumInfo?.authorName ?? '') : String(book?.author ?? '');
-            const tags = Array.isArray(entry?.tags) ? entry.tags.join(',') : '';
-            const readTime = Number(entry?.readTime ?? 0);
-            rows.push({
-                section: 'longest',
-                idx: i + 1,
-                key: title,
-                value: formatDuration(readTime),
-                detail: `${author}${tags ? `  [${tags}]` : ''}`,
-            });
-        });
-
-        const readStat = Array.isArray(payload?.readStat) ? payload.readStat : [];
-        readStat.forEach((entry, i) => {
-            rows.push({
-                section: 'readStat',
-                idx: i + 1,
-                key: String(entry?.stat ?? ''),
-                value: String(entry?.counts ?? ''),
-                detail: '',
-            });
-        });
-
-        const preferCategory = Array.isArray(payload?.preferCategory) ? payload.preferCategory : [];
-        preferCategory.forEach((entry, i) => {
-            const seconds = Number(entry?.readingTime ?? 0);
-            rows.push({
-                section: 'preferCategory',
-                idx: i + 1,
-                key: String(entry?.categoryTitle ?? ''),
-                value: formatDuration(seconds),
-                detail: `${Number(entry?.readingCount ?? 0)}本`,
-            });
-        });
-
-        const preferAuthor = Array.isArray(payload?.preferAuthor) ? payload.preferAuthor : [];
-        preferAuthor.forEach((entry, i) => {
-            rows.push({
-                section: 'preferAuthor',
-                idx: i + 1,
-                key: String(entry?.name ?? ''),
-                // preferAuthor[].readTime is server-formatted ("5小时30分钟"), not seconds.
-                value: String(entry?.readTime ?? ''),
-                detail: `${Number(entry?.count ?? 0)}本`,
-            });
-        });
-
-        const preferPublisher = Array.isArray(payload?.preferPublisher) ? payload.preferPublisher : [];
-        preferPublisher.forEach((entry, i) => {
-            rows.push({
-                section: 'preferPublisher',
-                idx: i + 1,
-                key: String(entry?.name ?? ''),
-                value: `${Number(entry?.count ?? 0)}本`,
-                detail: '',
-            });
-        });
-
-        const preferTime = Array.isArray(payload?.preferTime) ? payload.preferTime : [];
-        if (preferTime.length === 24) {
-            // SKILL.md: order starts at 06:00 and wraps to 05:00. Translate to a flat
-            // (hour-of-day → duration) view so consumers do not need to know the offset.
-            for (let i = 0; i < 24; i += 1) {
-                const hour = (6 + i) % 24;
-                const seconds = Number(preferTime[i] ?? 0);
-                rows.push({
-                    section: 'preferTime',
-                    idx: i + 1,
-                    key: `${String(hour).padStart(2, '0')}:00`,
-                    value: formatDuration(seconds),
-                    detail: `${seconds}s`,
-                });
-            }
-        }
-
-        if (rows.length === 0) {
-            emptyResult('readdata', `No reading data for mode=${mode}.`);
-        }
-        return rows;
-    },
-});
-
-export { MODE_CHOICES };
+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};

package/clis/weread-official/review.js

@@ -1,93 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError } from '@jackwener/opencli/errors';
-import {
-    callGateway,
-    emptyResult,
-    formatDate,
-    formatStar,
-    makeDeepLink,
-    requireBookId,
-    requirePositiveInt,
-    truncate,
-} from './utils.js';
-
-/**
- * `/review/list` (public book reviews). Per SKILL.md the `reviewListType`
- * enum is:
- *   0=all  1=recommend  2=不行(thumbs-down)  3=newest  4=一般(neutral)
- *
- * Pagination is `idx`-based (use `idx` from last row of previous page as the
- * next `maxIdx`), with an optional `synckey` carried forward. Surface these
- * to the user instead of synthesizing an offset scheme so the SKILL contract
- * stays visible.
- */
-const TYPE_ALIASES = Object.freeze({
-    all: 0,
-    recommend: 1,
-    'thumbs-down': 2,
-    newest: 3,
-    neutral: 4,
-});
-
-cli({
-    site: 'weread-official',
-    name: 'review',
-    access: 'read',
-    description: 'Browse public reviews of a WeRead book',
-    domain: 'weread.qq.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'bookId', positional: true, required: true, 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 (args) => {
-        const bookId = requireBookId(args.bookId);
-        const typeKey = String(args.type ?? 'all').trim();
-        if (!Object.prototype.hasOwnProperty.call(TYPE_ALIASES, typeKey)) {
-            throw new ArgumentError(
-                `weread-official: type must be one of: ${Object.keys(TYPE_ALIASES).join(', ')}`,
-            );
-        }
-        const reviewListType = TYPE_ALIASES[typeKey];
-        const count = requirePositiveInt(args.count, 'count', { defaultValue: 20, max: 100 });
-        const params = { bookId, reviewListType, count, maxIdx: Number(args['max-idx'] ?? 0) };
-        if (args.synckey !== undefined && args.synckey !== null && args.synckey !== '') {
-            params.synckey = requirePositiveInt(args.synckey, 'synckey');
-        }
-
-        const payload = await callGateway('/review/list', params);
-        const reviews = Array.isArray(payload?.reviews) ? payload.reviews : [];
-        if (reviews.length === 0) {
-            emptyResult('review', `No public reviews for bookId=${bookId} (type=${typeKey}).`);
-        }
-
-        return reviews.map((wrapper, i) => {
-            const reviewOuter = wrapper?.review ?? {};
-            // `/review/list` nests the actual review under reviewOuter.review
-            const rv = reviewOuter?.review ?? {};
-            const author = rv?.author ?? {};
-            const chapter = String(rv?.chapterName ?? '').trim();
-            const reviewId = String(reviewOuter?.reviewId ?? rv?.reviewId ?? '').trim();
-            return {
-                rank: i + 1,
-                idx: Number(wrapper?.idx ?? 0),
-                reviewId,
-                star: Number(rv?.star ?? 0),
-                starLabel: formatStar(rv?.star),
-                author: String(author?.name ?? ''),
-                isFinish: Number(rv?.isFinish ?? 0) === 1,
-                chapter,
-                content: truncate(rv?.content, 300),
-                createTime: formatDate(rv?.createTime),
-                link: makeDeepLink({ bookId }),
-            };
-        });
-    },
-});
-
-export { TYPE_ALIASES };
+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};

package/clis/weread-official/search.js

@@ -1,106 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError } from '@jackwener/opencli/errors';
-import {
-    callGateway,
-    emptyResult,
-    formatRating,
-    makeDeepLink,
-    requirePositiveInt,
-    requireText,
-    truncate,
-} from './utils.js';
-
-/**
- * Search scope mapping — mirrors the official SKILL.md "scope 对应关系" table.
- * Keys are user-facing aliases; values are the int the gateway expects.
- */
-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 SCOPE_LABEL = Object.freeze({
-    0: '全部',
-    10: '电子书',
-    16: '网文小说',
-    14: '微信听书',
-    6: '作者',
-    12: '全文',
-    13: '书单',
-    2: '公众号',
-    4: '文章',
-});
-
-cli({
-    site: 'weread-official',
-    name: 'search',
-    access: 'read',
-    description: 'Search WeRead store via the official agent gateway',
-    domain: 'weread.qq.com',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'keyword', positional: true, required: true, 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 (args) => {
-        const keyword = requireText(args.keyword, 'keyword');
-        const scopeKey = String(args.scope ?? 'ebook').trim();
-        if (!Object.prototype.hasOwnProperty.call(SEARCH_SCOPES, scopeKey)) {
-            throw new ArgumentError(
-                `weread-official: scope must be one of: ${Object.keys(SEARCH_SCOPES).join(', ')}`,
-            );
-        }
-        const scope = SEARCH_SCOPES[scopeKey];
-        const params = { keyword, scope, maxIdx: args['max-idx'] ?? 0 };
-        if (args.count !== undefined && args.count !== null && args.count !== '') {
-            params.count = requirePositiveInt(args.count, 'count', { max: 100 });
-        }
-
-        const payload = await callGateway('/store/search', params);
-        const groups = Array.isArray(payload?.results) ? payload.results : [];
-        if (groups.length === 0) {
-            emptyResult('search', `No results for "${keyword}" (scope=${scopeKey}).`);
-        }
-
-        const rows = [];
-        let rank = 0;
-        for (const group of groups) {
-            const groupScope = SCOPE_LABEL[Number(group?.scope)] ?? '';
-            const books = Array.isArray(group?.books) ? group.books : [];
-            for (const entry of books) {
-                rank += 1;
-                const info = entry?.bookInfo ?? {};
-                const bookId = String(info.bookId ?? '').trim();
-                rows.push({
-                    rank,
-                    scope: groupScope,
-                    bookId,
-                    title: String(info.title ?? ''),
-                    author: String(info.author ?? ''),
-                    rating: formatRating(entry?.newRating),
-                    readingCount: Number(entry?.readingCount ?? 0),
-                    category: String(info.category ?? ''),
-                    searchIdx: Number(entry?.searchIdx ?? 0),
-                    cover: String(info.cover ?? ''),
-                    intro: truncate(info.intro, 120),
-                    link: bookId ? makeDeepLink({ bookId }) : '',
-                });
-            }
-        }
-        if (rows.length === 0) {
-            emptyResult('search', `No books found in results for "${keyword}" (scope=${scopeKey}).`);
-        }
-        return rows;
-    },
-});
+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}});

package/clis/weread-official/shelf.js

@@ -1,97 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { callGateway, emptyResult, formatDate, makeDeepLink } from './utils.js';
-
-/**
- * `/shelf/sync` returns three independent entry kinds:
- *   - `books[]`   — ebooks / imported / mp-style book entries
- *   - `albums[]`  — audiobooks / podcasts (官方 SKILL.md 强调专辑 = 有声书)
- *   - `mp`        — opaque "文章收藏" (article bookmarks) entry; non-empty
- *                   = 1 shelf entry but its content is NOT exposed here.
- *
- * Per official skill: shelf count = books.length + albums.length +
- *                     (mp non-empty ? 1 : 0). This adapter surfaces all three
- *                     row kinds in a `kind` column so callers can filter.
- */
-cli({
-    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: Strategy.PUBLIC,
-    browser: false,
-    args: [],
-    columns: ['kind', 'id', 'title', 'author', 'category', 'secret', 'isTop', 'finished', 'updateTime', 'cover', 'link'],
-    func: async () => {
-        const payload = await callGateway('/shelf/sync', {});
-        const books = Array.isArray(payload?.books) ? payload.books : [];
-        const albums = Array.isArray(payload?.albums) ? payload.albums : [];
-        // `mp` is an object (or array) marking the "文章收藏" entry. Non-empty = 1 shelf entry.
-        const mp = payload?.mp;
-        const hasMp = Boolean(
-            mp && typeof mp === 'object'
-                && (Array.isArray(mp) ? mp.length > 0 : Object.keys(mp).length > 0),
-        );
-
-        const rows = [];
-
-        for (const b of books) {
-            const bookId = String(b?.bookId ?? '').trim();
-            rows.push({
-                kind: 'book',
-                id: bookId,
-                title: String(b?.title ?? ''),
-                author: String(b?.author ?? ''),
-                category: String(b?.category ?? ''),
-                secret: Number(b?.secret ?? 0) === 1,
-                isTop: Number(b?.isTop ?? 0) === 1,
-                finished: Number(b?.finishReading ?? 0) === 1,
-                updateTime: formatDate(b?.readUpdateTime ?? b?.updateTime),
-                cover: String(b?.cover ?? ''),
-                link: bookId ? makeDeepLink({ bookId }) : '',
-            });
-        }
-
-        for (const a of albums) {
-            const info = a?.albumInfo ?? {};
-            const extra = a?.albumInfoExtra ?? {};
-            const albumId = String(info?.albumId ?? '').trim();
-            rows.push({
-                kind: 'album',
-                id: albumId,
-                title: String(info?.name ?? ''),
-                author: String(info?.authorName ?? ''),
-                category: '',
-                secret: Number(extra?.secret ?? 0) === 1,
-                isTop: Number(extra?.isTop ?? 0) === 1,
-                finished: Number(info?.finish ?? 0) === 1,
-                updateTime: formatDate(extra?.lectureReadUpdateTime ?? info?.updateTime),
-                cover: String(info?.cover ?? ''),
-                link: '',
-            });
-        }
-
-        if (hasMp) {
-            // The mp entry is an opaque directory; only the count is meaningful here.
-            // Per SKILL.md it's always private, so secret=true matches the official rule.
-            rows.push({
-                kind: 'mp',
-                id: '',
-                title: '文章收藏',
-                author: '',
-                category: '',
-                secret: true,
-                isTop: false,
-                finished: false,
-                updateTime: '',
-                cover: '',
-                link: '',
-            });
-        }
-
-        if (rows.length === 0) {
-            emptyResult('shelf', 'Your WeRead shelf is empty.');
-        }
-        return rows;
-    },
-});
+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}});