publishport-opencli 1.0.0

package/clis/xiaohongshu/saved.js

@@ -0,0 +1 @@
+import{cli as o,Strategy as s}from"@jackwener/opencli/registry";import{COLLECT_API_PATTERN as a,fetchXhsCollectionNotes as n,parseCollectionLimit as l,resolveXhsUserId as m,SAVED_PROFILE_TAB as u}from"./collection-helpers.js";o({site:"xiaohongshu",name:"saved",access:"read",description:"小红书收藏笔记列表",domain:"www.xiaohongshu.com",strategy:s.COOKIE,navigateBefore:!1,browser:!0,args:[{name:"id",type:"string",help:"User id or profile URL (defaults to current logged-in user)"},{name:"limit",type:"int",default:20,help:"Number of notes to return"}],columns:["rank","id","title","author","likes","type","url"],func:async(e,t)=>{const i=l(t.limit),r=await m(e,t.id);return n(e,{userId:r,profileTab:u,apiPattern:a,limit:i,emptyLabel:"saved"})}});

package/clis/xiaohongshu/search.js

@@ -0,0 +1,194 @@
+import{cli as P,Strategy as j}from"@jackwener/opencli/registry";import{ArgumentError as Z,AuthRequiredError as N,CommandExecutionError as $}from"@jackwener/opencli/errors";const U=`
+  new Promise((resolve) => {
+    const findNoteCard = () => document.querySelector(
+      'section.note-item, section:has(a[href*="/search_result/"]), section:has(a[href*="/explore/"])'
+    );
+    const detect = () => {
+      if (findNoteCard()) return 'content';
+      const text = document.body?.innerText || '';
+      if (/登录后查看搜索结果/.test(text)) return 'login_wall';
+      if (
+        /安全限制|Account abnormal|300011/.test(text) ||
+        /\\/website-login\\/error/.test(location.pathname)
+      ) return 'security_block';
+      return null;
+    };
+    const found = detect();
+    if (found) return resolve(found);
+    const observer = new MutationObserver(() => {
+      const result = detect();
+      if (result) { observer.disconnect(); resolve(result); }
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    setTimeout(() => { observer.disconnect(); resolve('timeout'); }, 5000);
+  })
+`,W=`
+  new Promise((resolve) => {
+    const isSearchRoute = () => /\\/search_result(?:_ai)?/.test(location.pathname);
+    const isSecurityBlock = () => {
+      const text = document.body?.innerText || '';
+      return /安全限制|Account abnormal|300011/.test(text) || /\\/website-login\\/error/.test(location.pathname);
+    };
+    const detect = () => {
+      if (isSearchRoute()) return 'search_route';
+      if (isSecurityBlock()) return 'security_block';
+      return null;
+    };
+    const found = detect();
+    if (found) return resolve(found);
+    const timer = setInterval(() => {
+      const result = detect();
+      if (result) {
+        clearInterval(timer);
+        resolve(result);
+      }
+    }, 100);
+    setTimeout(() => {
+      clearInterval(timer);
+      resolve('timeout');
+    }, 8000);
+  })
+`;export function noteIdToDate(z){const B=z.match(/\/(?:search_result|explore|note)\/([0-9a-f]{24})(?=[?#/]|$)/i);if(!B)return"";const G=B[1].substring(0,8),Q=parseInt(G,16);if(!Q||Q<1e9||Q>4000000000)return"";return new Date((Q+28800)*1000).toISOString().slice(0,10)}export function stripXhsAuthorDateSuffix(z){const B=(z||"").replace(/\s+/g," ").trim();return B.replace(/\s*(?:\d{1,2}天前|\d+小时前|\d+分钟前|\d+秒前|刚刚|昨天|前天|\d+周前|\d+个月前|\d{1,2}-\d{1,2}|\d{4}-\d{1,2}-\d{1,2})$/u,"").trim()||B}export function unwrapEvaluateResult(z){if(z&&!Array.isArray(z)&&typeof z==="object"&&"session"in z&&"data"in z)return z.data;return z}function L(z,B){const G=unwrapEvaluateResult(z);if(!Array.isArray(G))throw new $(`Unexpected Xiaohongshu search ${B} payload shape; expected an array of rows.`);return G}function X(z){const B=unwrapEvaluateResult(z);if(B==="search_route")return;if(B==="security_block")throw new $("Xiaohongshu search hit a security restriction page instead of search results.");throw new $("Xiaohongshu search did not reach a search results route after submitting the query.")}async function D(z,B){await z.goto("https://www.xiaohongshu.com/");await z.wait?.(1);await z.click("#search-input-in-feeds");await z.typeText("#search-input-in-feeds",B);await z.pressKey("Enter")}export function parseLimit(z){const B=Number(z??20);if(!Number.isFinite(B)||!Number.isInteger(B))throw new Z(`--limit must be an integer between 1 and 100, got ${JSON.stringify(z)}`);if(B<1||B>100)throw new Z(`--limit must be between 1 and 100, got ${B}`);return B}export function buildScrollUntilJs(z,B=15){if(!Number.isSafeInteger(z)||z<1)throw new Z(`targetCount must be a positive integer, got ${JSON.stringify(z)}`);if(!Number.isSafeInteger(B)||B<1)throw new Z(`maxScrolls must be a positive integer, got ${JSON.stringify(B)}`);return`
+      (async () => {
+        const isVisibleNote = (el) => {
+          if (el.classList.contains('query-note-item')) return false;
+          const rect = el.getBoundingClientRect();
+          if (rect.width <= 0 || rect.height <= 0) return false;
+          const style = getComputedStyle(el);
+          return style.display !== 'none' && style.visibility !== 'hidden';
+        };
+        // Note containers: legacy \`section.note-item\` first, fallback to
+        // any \`<section>\` that wraps a search-result/explore note link
+        // (#1506 reports the class being dropped on some xhs renders).
+        const collectNoteCards = () => {
+          const classMatches = document.querySelectorAll('section.note-item');
+          if (classMatches.length > 0) return classMatches;
+          const sections = new Set();
+          for (const a of document.querySelectorAll('a[href*="/search_result/"], a[href*="/explore/"]')) {
+            const section = a.closest('section');
+            if (section) sections.add(section);
+          }
+          return sections;
+        };
+        const countItems = () => {
+          let count = 0;
+          for (const el of collectNoteCards()) {
+            if (isVisibleNote(el)) count++;
+          }
+          return count;
+        };
+
+        let lastCount = countItems();
+        let plateauRounds = 0;
+        for (let i = 0; i < ${B}; i++) {
+          if (countItems() >= ${z}) break;
+          const lastHeight = document.body.scrollHeight;
+          window.scrollTo(0, lastHeight);
+          await new Promise((resolve) => {
+            let to;
+            const ob = new MutationObserver(() => {
+              if (document.body.scrollHeight > lastHeight) {
+                clearTimeout(to);
+                ob.disconnect();
+                setTimeout(resolve, 200);
+              }
+            });
+            ob.observe(document.body, { childList: true, subtree: true });
+            to = setTimeout(() => { ob.disconnect(); resolve(null); }, 2500);
+          });
+          const newCount = countItems();
+          if (newCount === lastCount) {
+            plateauRounds++;
+            if (plateauRounds >= 2) break;
+          } else {
+            plateauRounds = 0;
+            lastCount = newCount;
+          }
+        }
+        return countItems();
+      })()
+    `}export function buildSearchExtractJs(z){return`
+      (() => {
+        const normalizeUrl = (href) => {
+          if (!href) return '';
+          if (href.startsWith('http://') || href.startsWith('https://')) return href;
+          if (href.startsWith('/')) return 'https://${z}' + href;
+          return '';
+        };
+
+        const cleanText = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+        const stripXhsAuthorDateSuffix = ${stripXhsAuthorDateSuffix.toString()};
+        const isVisibleNote = (el) => {
+          const rect = el.getBoundingClientRect();
+          if (rect.width <= 0 || rect.height <= 0) return false;
+          const style = getComputedStyle(el);
+          return style.display !== 'none' && style.visibility !== 'hidden';
+        };
+
+        const results = [];
+        const seen = new Set();
+
+        // Note containers: legacy \`section.note-item\` first, fallback to any
+        // \`<section>\` wrapping a search-result/explore link (#1506 reports the
+        // class being dropped on some xhs renders).
+        const collectNoteCards = () => {
+          const classMatches = document.querySelectorAll('section.note-item');
+          if (classMatches.length > 0) return classMatches;
+          const sections = new Set();
+          for (const a of document.querySelectorAll('a[href*="/search_result/"], a[href*="/explore/"]')) {
+            const section = a.closest('section');
+            if (section) sections.add(section);
+          }
+          return sections;
+        };
+
+        for (const el of collectNoteCards()) {
+          // Skip "related searches" sections
+          if (el.classList?.contains('query-note-item')) continue;
+          if (!isVisibleNote(el)) continue;
+
+          const titleEl = el.querySelector('.title, .note-title, a.title, .footer .title span');
+          const nameEl = el.querySelector('a.author .name, .author-name, .nick-name, .name');
+          const authorWrapEl = el.querySelector('a.author');
+          let author = cleanText(nameEl?.textContent || '');
+          if (!author && authorWrapEl) {
+            const nameChild = authorWrapEl.querySelector('.name');
+            author = nameChild ? cleanText(nameChild.textContent || '') : stripXhsAuthorDateSuffix(authorWrapEl.textContent || '');
+          }
+          const likesEl = el.querySelector('.count, .like-count, .like-wrapper .count');
+          // Prefer search_result link (preserves xsec_token) over generic /explore/ link
+          const detailLinkEl =
+            el.querySelector('a.cover.mask') ||
+            el.querySelector('a[href*="/search_result/"]') ||
+            el.querySelector('a[href*="/explore/"]') ||
+            el.querySelector('a[href*="/note/"]');
+          const authorLinkEl = el.querySelector('a.author, a[href*="/user/profile/"]');
+
+          const url = normalizeUrl(detailLinkEl?.getAttribute('href') || '');
+          if (!url) continue;
+
+          const key = url;
+          if (seen.has(key)) continue;
+          seen.add(key);
+
+          // Fallback title: the new bare-section render keeps the note caption
+          // inside the search_result anchor's first span, not in a class-named
+          // .title element. Pull from there when the class-based pick is empty.
+          let title = cleanText(titleEl?.textContent || '');
+          if (!title) {
+            const captionSpan = detailLinkEl?.querySelector('span');
+            title = cleanText(captionSpan?.textContent || '');
+          }
+
+          results.push({
+            title,
+            author,
+            likes: cleanText(likesEl?.textContent || '0'),
+            url,
+            author_url: normalizeUrl(authorLinkEl?.getAttribute('href') || ''),
+          });
+        }
+
+        return results;
+      })()
+    `}export const command=P({site:"xiaohongshu",name:"search",access:"read",description:"搜索小红书笔记",domain:"www.xiaohongshu.com",strategy:j.COOKIE,navigateBefore:!1,args:[{name:"query",required:!0,positional:!0,help:"Search keyword"},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["rank","title","author","likes","published_at","url"],func:async(z,B)=>{const G=parseLimit(B.limit);await D(z,B.query);X(await z.evaluate(W));if(unwrapEvaluateResult(await z.evaluate(U))==="login_wall")throw new N("www.xiaohongshu.com","Xiaohongshu search results are blocked behind a login wall");const V=[...L(await z.evaluate(buildSearchExtractJs("www.xiaohongshu.com")),"initial extraction")];if(V.length<G){await z.evaluate(buildScrollUntilJs(G));const M=L(await z.evaluate(buildSearchExtractJs("www.xiaohongshu.com")),"post-scroll extraction"),Y=new Set(V.map((K)=>K.url).filter(Boolean));for(const K of M){if(K?.url&&Y.has(K.url))continue;if(K?.url)Y.add(K.url);V.push(K);if(V.length>=G)break}}return V.filter((M)=>M.title).slice(0,G).map((M,Y)=>({rank:Y+1,...M,published_at:noteIdToDate(M.url)}))}}),__test__={stripXhsAuthorDateSuffix};

package/clis/xiaohongshu/unfollow.js

@@ -0,0 +1,98 @@
+import{cli as L,Strategy as F}from"@jackwener/opencli/registry";import{ArgumentError as Z,AuthRequiredError as M,CliError as U,CommandExecutionError as K}from"@jackwener/opencli/errors";import{normalizeXhsUserId as b}from"./user-helpers.js";const v=2500,H=1500,T=5000,A=/^[a-zA-Z0-9]{8,32}$/;function P(B){const J=String(B||"").toLowerCase();return J==="xiaohongshu.com"||J.endsWith(".xiaohongshu.com")}function z(B){if(B&&typeof B==="object"&&"session"in B&&"data"in B)return B.data;return B}function V(B,J){const G=z(B);if(!G||typeof G!=="object"||Array.isArray(G)||typeof G.ok!=="boolean")throw new K(`xiaohongshu/unfollow: malformed ${J} payload`);return G}function j(B){const J=String(B??"").trim();if(/^https?:\/\//i.test(J)){let N;try{N=new URL(J)}catch{throw new Z("xiaohongshu/unfollow: invalid profile URL")}if(N.protocol!=="https:"||!P(N.hostname))throw new Z("xiaohongshu/unfollow: profile URL must be an exact https://*.xiaohongshu.com URL");const W=N.pathname.match(/^\/user\/profile\/([a-zA-Z0-9]{8,32})\/?$/);if(!W)throw new Z("xiaohongshu/unfollow: profile URL must be /user/profile/<userId>");return W[1]}const G=b(B);if(!G||!A.test(G))throw new Z("xiaohongshu/unfollow: user-id must be a Xiaohongshu user ID (e.g. 5d8f88dc0000000001005d3a) or full profile URL");return G}function q(){return`
+(() => {
+  const FOLLOW_LABELS = ['关注', '+ 关注', '+关注'];
+  const FOLLOWING_LABELS = ['已关注', '已互关', '互相关注'];
+
+  const isVisible = (el) => !!el && el.offsetParent !== null;
+  const textOf = (el) => (el.innerText || el.textContent || '').trim();
+
+  const SCOPE_SELECTORS = [
+    '.user-info', '.profile-info', '.user-detail', '.profile-page',
+    '[class*="user-info"]', '[class*="profile"]',
+  ];
+  const scopes = SCOPE_SELECTORS.flatMap((sel) => Array.from(document.querySelectorAll(sel)));
+  const visibleScopes = scopes.filter(isVisible);
+  const roots = visibleScopes.length > 0 ? visibleScopes : [document];
+
+  const collectButtons = () => {
+    const out = new Set();
+    for (const root of roots) {
+      const els = root.querySelectorAll('button, [role="button"]');
+      for (const el of els) {
+        if (isVisible(el)) out.add(el);
+      }
+    }
+    return Array.from(out);
+  };
+  const findButtonByLabels = (labels) => {
+    for (const btn of collectButtons()) {
+      const t = textOf(btn);
+      if (labels.includes(t)) return btn;
+    }
+    return null;
+  };
+
+  if (findButtonByLabels(FOLLOW_LABELS)) {
+    return { ok: true, state: 'not-following' };
+  }
+  const btn = findButtonByLabels(FOLLOWING_LABELS);
+  if (!btn) {
+    return {
+      ok: false,
+      state: 'failed',
+      reason: 'Follow-state button not found on profile (logged out, blocked, or selectors changed).',
+    };
+  }
+  btn.click();
+  return { ok: true, state: 'unfollow-clicked' };
+})()
+`}function O(){return`
+(() => {
+  const isVisible = (el) => !!el && el.offsetParent !== null;
+  const footer = Array.from(document.querySelectorAll('.d-modal-footer')).find(isVisible);
+  if (!footer) return { ok: false, kind: 'no_modal' };
+  const buttons = Array.from(footer.querySelectorAll('button, [role="button"]')).filter(isVisible);
+  const confirmBtn = buttons.find((b) => {
+    const t = (b.innerText || b.textContent || '').trim();
+    return t === '确定' || t === '不再关注' || t === '取消关注';
+  });
+  if (!confirmBtn) {
+    return { ok: false, kind: 'no_confirm', labels: buttons.map((b) => (b.innerText || '').trim()) };
+  }
+  confirmBtn.click();
+  return { ok: true };
+})()
+`}function X(){return`
+(async () => {
+  const FOLLOW_LABELS = ['关注', '+ 关注', '+关注'];
+  const STATE_FLIP_TIMEOUT_MS = ${T};
+  const STATE_POLL_MS = 250;
+
+  const isVisible = (el) => !!el && el.offsetParent !== null;
+  const textOf = (el) => (el.innerText || el.textContent || '').trim();
+
+  const SCOPE_SELECTORS = [
+    '.user-info', '.profile-info', '.user-detail', '.profile-page',
+    '[class*="user-info"]', '[class*="profile"]',
+  ];
+  const findFollowButton = () => {
+    const scopes = SCOPE_SELECTORS.flatMap((sel) => Array.from(document.querySelectorAll(sel)));
+    const visibleScopes = scopes.filter(isVisible);
+    const roots = visibleScopes.length > 0 ? visibleScopes : [document];
+    for (const root of roots) {
+      for (const btn of root.querySelectorAll('button, [role="button"]')) {
+        if (!isVisible(btn)) continue;
+        if (FOLLOW_LABELS.includes(textOf(btn))) return btn;
+      }
+    }
+    return null;
+  };
+
+  const deadline = Date.now() + STATE_FLIP_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    if (findFollowButton()) return { ok: true };
+    await new Promise((r) => setTimeout(r, STATE_POLL_MS));
+  }
+  return { ok: false, reason: 'Unfollow click did not flip button back to 关注 within ' + (STATE_FLIP_TIMEOUT_MS / 1000) + 's' };
+})()
+`}L({site:"xiaohongshu",name:"unfollow",access:"write",description:"取消关注小红书用户 (profile UI automation)",domain:"www.xiaohongshu.com",strategy:F.COOKIE,navigateBefore:!1,browser:!0,args:[{name:"user-id",required:!0,positional:!0,help:"User ID (e.g. 5d8f88dc0000000001005d3a) or profile URL"}],columns:["status","user_id","url"],func:async(B,J)=>{if(!B)throw new K("Browser session required for xiaohongshu unfollow");try{const G=j(J["user-id"]),N=`https://www.xiaohongshu.com/user/profile/${G}`;await B.goto(N);await B.wait({time:v/1000});const W=z(await B.evaluate("() => location.href"));if(typeof W!=="string")throw new K("xiaohongshu/unfollow: malformed current-url payload");const Q=new URL(W);if(Q.protocol!=="https:"||!P(Q.hostname))throw new K(`xiaohongshu/unfollow: expected Xiaohongshu profile host, got ${Q.hostname}`);if(/\/login(?:[/?#]|$)/i.test(Q.pathname))throw new M("www.xiaohongshu.com");if(Q.pathname.match(/^\/user\/profile\/([a-zA-Z0-9]{8,32})\/?$/)?.[1]!==G)throw new K(`xiaohongshu/unfollow: expected profile ${G}, got ${Q.pathname}`);const $=V(await B.evaluate(q()),"click-unfollow");if(!$.ok)throw new K(`xiaohongshu/unfollow failed: ${$.reason??"unknown reason"}`);if($.state==="not-following")return[{status:"not-following",user_id:G,url:N}];await B.wait({time:H/1000});const D=V(await B.evaluate(O()),"confirm-modal");if(!D.ok)throw new K(`xiaohongshu/unfollow: confirmation modal step failed (${D.kind??"no kind reported"})`);const Y=z(await B.evaluate(X()));if(!Y||typeof Y!=="object"||Y.ok!==!0)throw new K(`xiaohongshu/unfollow: ${Y?.reason??"state verification failed"}`);return[{status:"unfollowed",user_id:G,url:N}]}catch(G){if(G instanceof U)throw G;throw new K(`xiaohongshu/unfollow failed: ${G?.message??String(G)}`)}}});export const __test__={assertUserId:j,buildClickUnfollowScript:q,buildConfirmModalScript:O,buildVerifyFollowFlippedScript:X};

package/clis/xiaohongshu/user-helpers.js

@@ -0,0 +1 @@
+function B(q){return typeof q==="string"?q.trim():q==null?"":String(q).trim()}export function normalizeXhsUserId(q){const z=B(q).replace(/[?#].*$/,""),E=z.match(/\/user\/profile\/([a-zA-Z0-9]+)/);if(E?.[1])return E[1];return z.replace(/\/+$/,"").split("/").pop()??z}export function flattenXhsNoteGroups(q){if(!Array.isArray(q))return[];const D=[];for(const z of q){if(!z)continue;if(Array.isArray(z)){for(const E of z)if(E)D.push(E);continue}D.push(z)}return D}export function buildXhsNoteUrl(q,D,z,E="www.xiaohongshu.com"){const F=B(q),J=B(D);if(!F||!J)return"";const A=new URL(`https://${E}/user/profile/${F}/${J}`),j=B(z);if(j){A.searchParams.set("xsec_token",j);A.searchParams.set("xsec_source","pc_user")}return A.toString()}export function extractXhsUserNotes(q,D,z="www.xiaohongshu.com"){const E=flattenXhsNoteGroups(q.noteGroups),F=[],J=new Set;for(const A of E){const j=A?.noteCard??A?.note_card??A;if(!j||typeof j!=="object")continue;const K=B(j.noteId??j.note_id??A?.noteId??A?.note_id??A?.id);if(!K||J.has(K))continue;J.add(K);const M=B(j.user?.userId??j.user?.user_id??D),O=B(A?.xsecToken??A?.xsec_token??j.xsecToken??j.xsec_token),V=B(j.interactInfo?.likedCount??j.interact_info?.liked_count??0)||"0",W=B(j.cover?.urlDefault??j.cover?.urlPre??j.cover?.url??"");F.push({id:K,title:B(j.displayTitle??j.display_title??j.title),type:B(j.type),likes:V,cover:W,url:buildXhsNoteUrl(M||D,K,O,z)})}return F}

package/clis/xiaohongshu/user.js

@@ -0,0 +1,30 @@
+import{cli as Y,Strategy as b}from"@jackwener/opencli/registry";import{AuthRequiredError as v,CommandExecutionError as $,EmptyResultError as F}from"@jackwener/opencli/errors";import{extractXhsUserNotes as M,normalizeXhsUserId as H}from"./user-helpers.js";export const USER_SNAPSHOT_JS=`
+    (() => {
+      const safeClone = (value) => {
+        try {
+          return JSON.parse(JSON.stringify(value ?? null));
+        } catch {
+          return null;
+        }
+      };
+
+      const userStore = window.__INITIAL_STATE__?.user;
+      const hasUserStore = Boolean(userStore && typeof userStore === 'object');
+      const rawNotes = hasUserStore ? (userStore.notes?._value || userStore.notes) : undefined;
+      const rawPageData = hasUserStore ? (userStore.userPageData?._value || userStore.userPageData) : undefined;
+      // 登录墙检测：小红书 profile 页比 search 更吃登录态，会话失效/被风控降级时访问
+      // /user/profile/<id> 会 302 到 /login（loggedIn=false）。用 indexOf 而非正则——
+      // 本块是嵌在模板字符串里的 JS，正则 \\b 会被模板解析成退格符。
+      const loggedInVal = hasUserStore ? (userStore.loggedIn?._value ?? userStore.loggedIn) : undefined;
+      const pathName = (typeof location !== 'undefined' && location.pathname) ? location.pathname : '';
+      const onLoginPage = pathName.indexOf('/login') === 0;
+      return {
+        noteGroups: safeClone(rawNotes || []),
+        pageData: safeClone(rawPageData || {}),
+        storePresent: hasUserStore,
+        notesPresent: Array.isArray(rawNotes),
+        pageDataPresent: Boolean(rawPageData && typeof rawPageData === 'object' && Object.keys(rawPageData).length > 0),
+        loginWall: Boolean(onLoginPage || loggedInVal === false),
+      };
+    })()
+  `;async function f(B){return await B.evaluate(USER_SNAPSHOT_JS)}export function assertReadableUserSnapshot(B){if(!B||typeof B!=="object"||Array.isArray(B))throw new $("Malformed Xiaohongshu user snapshot");if(B.storePresent!==!0)throw new $("Malformed Xiaohongshu user snapshot: user store was not found");if(B.notesPresent!==!0||!Array.isArray(B.noteGroups))throw new $("Malformed Xiaohongshu user snapshot: notes array was not found")}export function countFlatNotes(B){const Q=B?.noteGroups;if(!Array.isArray(Q))return 0;let K=0;for(const D of Q)K+=Array.isArray(D)?D.length:D?1:0;return K}export function isLoginWallSnapshot(B){return Boolean(B&&typeof B==="object"&&B.loginWall===!0)}function O(){throw new v("xiaohongshu.com","Xiaohongshu profile requires login (page redirected to /login or session expired); re-login to xiaohongshu.com and retry.")}export async function readUserSnapshotHydrated(B,Q=8,K=2){let D=await f(B);for(let G=0;G<Q&&!isLoginWallSnapshot(D)&&countFlatNotes(D)===0;G+=1){await B.wait({time:K});D=await f(B)}return D}export const command=Y({site:"xiaohongshu",name:"user",access:"read",description:"Get public notes from a Xiaohongshu user profile",domain:"www.xiaohongshu.com",strategy:b.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"id",type:"string",required:!0,positional:!0,help:"User id or profile URL"},{name:"limit",type:"int",default:15,help:"Number of notes to return"}],columns:["id","title","type","likes","url"],func:async(B,Q)=>{const K=H(String(Q.id)),D=Math.max(1,Number(Q.limit??15));await B.goto(`https://www.xiaohongshu.com/user/profile/${K}`);let G=await readUserSnapshotHydrated(B);if(isLoginWallSnapshot(G))O();assertReadableUserSnapshot(G);let V=M(G??{},K),z=V.length;for(let J=0;V.length<D&&J<4;J+=1){await B.autoScroll({times:1,delayMs:1500});await B.wait(1);G=await f(B);if(isLoginWallSnapshot(G))O();assertReadableUserSnapshot(G);const Z=M(G??{},K);if(Z.length<=z)break;V=Z;z=Z.length}if(V.length===0)throw new F("xiaohongshu user","该用户没有公开笔记（可能销号 / 私密 / 全部删除）。");return V.slice(0,D)}});

package/clis/xiaoyuzhou/auth.js

@@ -0,0 +1,3 @@
+import*as Q from"node:fs";import*as z from"node:os";import*as W from"node:path";import{CliError as L,CommandExecutionError as M,ConfigError as S,EXIT_CODES as X,getErrorMessage as N}from"@jackwener/opencli/errors";export const XIAOYUZHOU_API_BASE_URL="https://api.xiaoyuzhoufm.com",XIAOYUZHOU_TOKEN_TTL_MS=1200000,XIAOYUZHOU_REFRESH_SKEW_MS=60000,XIAOYUZHOU_DEFAULT_DEVICE_ID="81ADBFD6-6921-482B-9AB9-A29E7CC7BB55",XIAOYUZHOU_DEFAULT_DEVICE_PROPERTIES="",XIAOYUZHOU_DEFAULT_USER_AGENT="Xiaoyuzhou/2.98.0 (build:2908; iOS 26.2.1)";function Y(){return Date.now()}export function getXiaoyuzhouCredentialFile(){return W.join(z.homedir(),".opencli","xiaoyuzhou.json")}function V(j){return new L("AUTH_REQUIRED",j,`Update ${getXiaoyuzhouCredentialFile()} with fresh Xiaoyuzhou credentials before retrying.`,X.NOPERM)}function Z(j){const D=Number(j);return Number.isFinite(D)?D:0}export function normalizeXiaoyuzhouCredentials(j={}){const D=Z(j.last_updated_ts??j.lastUpdatedTs);let F=Z(j.expires_at??j.expiresAt);if(F>0&&F<10000000000)F*=1000;if(!F&&D>0)F=D*1000+XIAOYUZHOU_TOKEN_TTL_MS;return{access_token:String(j.access_token??j.accessToken??"").trim(),refresh_token:String(j.refresh_token??j.refreshToken??"").trim(),expires_at:F,device_id:String(j.device_id??j.deviceId??XIAOYUZHOU_DEFAULT_DEVICE_ID).trim()||XIAOYUZHOU_DEFAULT_DEVICE_ID,device_properties:String(j.device_properties??j.deviceProperties??XIAOYUZHOU_DEFAULT_DEVICE_PROPERTIES)}}export function loadXiaoyuzhouCredentials(){const j=getXiaoyuzhouCredentialFile();if(Q.existsSync(j))try{const D=JSON.parse(Q.readFileSync(j,"utf-8")),F=normalizeXiaoyuzhouCredentials(D);if(!F.access_token||!F.refresh_token)throw new S(`Xiaoyuzhou credential file is missing access_token or refresh_token: ${j}`,"Recreate the file with valid credentials.");return F}catch(D){if(D instanceof S)throw D;throw new S(`Failed to parse Xiaoyuzhou credential file: ${j}`,`Ensure ${j} contains valid JSON. (${N(D)})`)}throw new S(`Missing Xiaoyuzhou credentials. Expected ${j}`,`Create ${j} with access_token and refresh_token.`)}export function saveXiaoyuzhouCredentials(j){const D=getXiaoyuzhouCredentialFile();Q.mkdirSync(W.dirname(D),{recursive:!0});Q.writeFileSync(D,`${JSON.stringify({access_token:j.access_token,refresh_token:j.refresh_token,expires_at:j.expires_at,device_id:j.device_id,device_properties:j.device_properties},null,2)}
+`,"utf-8")}export function shouldRefreshXiaoyuzhouCredentials(j,D=Y()){return Number.isFinite(j.expires_at)&&j.expires_at>0&&D>=j.expires_at-XIAOYUZHOU_REFRESH_SKEW_MS}export function buildXiaoyuzhouHeaders(j,D={}){const{contentType:F="application/json",includeLocalTime:H=!1,includeRefreshToken:G=!1}=D,J={"Content-Type":F,Host:"api.xiaoyuzhoufm.com","User-Agent":XIAOYUZHOU_DEFAULT_USER_AGENT,Market:"AppStore","App-BuildNo":"2908",OS:"ios",Manufacturer:"Apple",BundleID:"app.podcast.cosmos",Connection:"keep-alive","abtest-info":'{"old_user_discovery_feed":"enable"}',"Accept-Language":"en-HK;q=1.0, zh-Hans-HK;q=0.9",Model:"iPhone18,1","app-permissions":"100000",Accept:"*/*","App-Version":"2.98.0",WifiConnected:"true","OS-Version":"26.2.1","x-custom-xiaoyuzhou-app-dev":"","x-jike-device-id":j.device_id||XIAOYUZHOU_DEFAULT_DEVICE_ID,"x-jike-device-properties":j.device_properties??XIAOYUZHOU_DEFAULT_DEVICE_PROPERTIES};if(j.access_token)J["x-jike-access-token"]=j.access_token;if(G&&j.refresh_token)J["x-jike-refresh-token"]=j.refresh_token;if(H){J["Local-Time"]=new Date().toISOString();J.Timezone=Intl.DateTimeFormat().resolvedOptions().timeZone||"UTC"}return J}export async function refreshXiaoyuzhouCredentials(j,D=fetch){if(!j.refresh_token)throw V("Xiaoyuzhou refresh token is missing");let F;try{F=await D(`${XIAOYUZHOU_API_BASE_URL}/app_auth_tokens.refresh`,{method:"POST",headers:buildXiaoyuzhouHeaders(j,{contentType:"application/x-www-form-urlencoded; charset=utf-8",includeLocalTime:!0,includeRefreshToken:!0}),signal:AbortSignal.timeout(20000)})}catch(K){throw new M(`Failed to refresh Xiaoyuzhou credentials: ${N(K)}`)}const H=await F.text();if(!F.ok)throw V(`Xiaoyuzhou token refresh failed with HTTP ${F.status}${H?`: ${H}`:""}`);let G;try{G=JSON.parse(H)}catch(K){throw new M(`Xiaoyuzhou refresh returned invalid JSON: ${N(K)}`)}if(!G?.success)throw V("Xiaoyuzhou refresh API returned success=false");const J=normalizeXiaoyuzhouCredentials({...j,access_token:G["x-jike-access-token"]||"",refresh_token:G["x-jike-refresh-token"]||"",expires_at:Y()+XIAOYUZHOU_TOKEN_TTL_MS});if(!J.access_token||!J.refresh_token)throw V("Xiaoyuzhou refresh API returned empty access_token or refresh_token");saveXiaoyuzhouCredentials(J);return J}function B(j,D){const F=new URL(j,XIAOYUZHOU_API_BASE_URL);if(D){for(const[H,G]of Object.entries(D))if(G!==void 0&&G!==null&&G!=="")F.searchParams.set(H,String(G))}return F.toString()}async function _(j,D,F,H){const{method:G="GET",query:J,body:K}=D;let O;try{O=await H(B(j,J),{method:G,headers:buildXiaoyuzhouHeaders(F,{contentType:"application/json",includeLocalTime:!0}),body:K===void 0?void 0:JSON.stringify(K),signal:AbortSignal.timeout(20000)})}catch($){throw new M(`Failed to reach Xiaoyuzhou API: ${N($)}`)}return O}export async function requestXiaoyuzhouJson(j,D={},F=fetch){let H=D.credentials??loadXiaoyuzhouCredentials();if(shouldRefreshXiaoyuzhouCredentials(H))H=await refreshXiaoyuzhouCredentials(H,F);let G=await _(j,D,H,F);if(G.status===401){H=await refreshXiaoyuzhouCredentials(H,F);G=await _(j,D,H,F)}const J=await G.text();if(!G.ok)throw new M(`Xiaoyuzhou API request failed with HTTP ${G.status}${J?`: ${J}`:""}`);let K;try{K=JSON.parse(J)}catch(O){throw new M(`Xiaoyuzhou API returned invalid JSON: ${N(O)}`)}if(K?.success===!1)throw new M(K?.message||K?.msg||"Xiaoyuzhou API returned success=false");return{credentials:H,raw:K,data:K?.data}}export async function fetchXiaoyuzhouTranscriptBody(j,D=fetch){let F;try{F=await D(j,{method:"GET",headers:{"User-Agent":XIAOYUZHOU_DEFAULT_USER_AGENT,Accept:"*/*",Market:"AppStore"},signal:AbortSignal.timeout(20000)})}catch(G){throw new M(`Failed to fetch Xiaoyuzhou transcript content: ${N(G)}`)}const H=await F.text();if(!F.ok)throw new M(`Xiaoyuzhou transcript download failed with HTTP ${F.status}${H?`: ${H}`:""}`);return H}export function extractTranscriptText(j){let D;try{D=JSON.parse(j)}catch{return{text:"",segmentCount:0}}let F=[];if(Array.isArray(D))F=D;else if(D&&typeof D==="object"){for(const G of["segments","data","transcript","items"])if(Array.isArray(D[G])){F=D[G];break}if(F.length===0){const G=typeof D.text==="string"?D.text.trim():"";if(G)return{text:G,segmentCount:1}}}const H=[];for(const G of F){if(!G||typeof G!=="object"||typeof G.text!=="string")continue;const J=G.text.trim();if(J)H.push(J)}return{text:H.join(`
+`),segmentCount:H.length}}

package/clis/xiaoyuzhou/download.js

@@ -0,0 +1 @@
+import*as T from"node:fs";import*as H from"node:path";import{cli as V,Strategy as W}from"@jackwener/opencli/registry";import{CliError as M}from"@jackwener/opencli/errors";import{httpDownload as Y,sanitizeFilename as Z}from"@jackwener/opencli/download";import{formatBytes as _}from"@jackwener/opencli/download/progress";import{loadXiaoyuzhouCredentials as $,requestXiaoyuzhouJson as k}from"./auth.js";V({site:"xiaoyuzhou",name:"download",access:"read",description:"Download Xiaoyuzhou episode audio",domain:"www.xiaoyuzhoufm.com",strategy:W.LOCAL,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Episode ID (eid from podcast-episodes output)"},{name:"output",default:"./xiaoyuzhou-downloads",help:"Output directory"}],columns:["title","podcast","status","size","file"],func:async(v)=>{const N=$(),A=(await k("/v1/episode/get",{query:{eid:v.id},credentials:N})).data;if(!A)throw new M("NOT_FOUND","Episode not found","Please check the ID");const G=A.media?.source?.url;if(!G)throw new M("PARSE_ERROR","Audio URL not found in episode payload","Episode payload does not expose media.source.url");const O=String(v.output||"./xiaoyuzhou-downloads"),Q=H.extname(new URL(G).pathname)||".mp3",I=String(A.title||"episode"),R=`${v.id}_${Z(I,80)||"episode"}${Q}`,K=H.join(O,String(v.id));T.mkdirSync(K,{recursive:!0});const L=H.join(K,R),b=await Y(G,L,{timeout:60000});return[{title:I,podcast:A.podcast?.title||"",status:b.success?"success":"failed",size:b.success?_(b.size):b.error||"unknown error",file:b.success?L:"-"}]}});

package/clis/xiaoyuzhou/episode.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as i}from"@jackwener/opencli/registry";import{CliError as s}from"@jackwener/opencli/errors";import{loadXiaoyuzhouCredentials as r,requestXiaoyuzhouJson as d}from"./auth.js";import{formatDuration as n,formatDate as u}from"./utils.js";a({site:"xiaoyuzhou",name:"episode",access:"read",description:"View details of a Xiaoyuzhou podcast episode",domain:"www.xiaoyuzhoufm.com",strategy:i.LOCAL,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Episode ID (eid from podcast-episodes output)"}],columns:["title","podcast","duration","plays","comments","likes","date"],func:async(e)=>{const t=r(),o=(await d("/v1/episode/get",{query:{eid:e.id},credentials:t})).data;if(!o)throw new s("NOT_FOUND","Episode not found","Please check the ID");return[{title:o.title,podcast:o.podcast?.title,duration:n(o.duration),plays:o.playCount,comments:o.commentCount,likes:o.clapCount,date:u(o.pubDate)}]}});

package/clis/xiaoyuzhou/podcast-episodes.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as d}from"@jackwener/opencli/registry";import{CliError as a}from"@jackwener/opencli/errors";import{loadXiaoyuzhouCredentials as m,requestXiaoyuzhouJson as n}from"./auth.js";import{formatDuration as u,formatDate as p}from"./utils.js";s({site:"xiaoyuzhou",name:"podcast-episodes",access:"read",description:"List episodes of a Xiaoyuzhou podcast",domain:"www.xiaoyuzhoufm.com",strategy:d.LOCAL,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Podcast ID (from xiaoyuzhoufm.com URL)"},{name:"limit",type:"int",default:20,help:"Max episodes to show"}],columns:["eid","title","duration","plays","date"],func:async(t)=>{const o=Number(t.limit);if(!Number.isInteger(o)||o<1)throw new a("INVALID_ARGUMENT","limit must be a positive integer","Example: --limit 5");const r=m(),i=(await n("/v1/episode/list",{method:"POST",body:{pid:t.id,order:"desc",limit:o},credentials:r})).data??[];if(!Array.isArray(i))throw new a("PARSE_ERROR","Unexpected API response format","Expected an array of episodes");return i.map((e)=>({eid:e.eid,title:e.title,duration:u(e.duration),plays:e.playCount,date:p(e.pubDate)}))}});

package/clis/xiaoyuzhou/podcast.js

@@ -0,0 +1 @@
+import{cli as r,Strategy as s}from"@jackwener/opencli/registry";import{CliError as i}from"@jackwener/opencli/errors";import{loadXiaoyuzhouCredentials as a,requestXiaoyuzhouJson as u}from"./auth.js";import{formatDate as d}from"./utils.js";r({site:"xiaoyuzhou",name:"podcast",access:"read",description:"View a Xiaoyuzhou podcast profile",domain:"www.xiaoyuzhoufm.com",strategy:s.LOCAL,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Podcast ID (from xiaoyuzhoufm.com URL)"}],columns:["title","author","description","subscribers","episodes","updated"],func:async(e)=>{const t=a(),o=(await u("/v1/podcast/get",{query:{pid:e.id},credentials:t})).data;if(!o)throw new i("NOT_FOUND","Podcast not found","Please check the ID");return[{title:o.title,author:o.author,description:o.brief,subscribers:o.subscriptionCount,episodes:o.episodeCount,updated:d(o.latestEpisodePubDate)}]}});

package/clis/xiaoyuzhou/transcript.js

@@ -0,0 +1 @@
+import*as s from"node:fs";import*as n from"node:path";import{cli as y,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as R,CliError as i}from"@jackwener/opencli/errors";import{loadXiaoyuzhouCredentials as j,requestXiaoyuzhouJson as h,fetchXiaoyuzhouTranscriptBody as w,extractTranscriptText as E}from"./auth.js";y({site:"xiaoyuzhou",name:"transcript",access:"read",description:"Download Xiaoyuzhou transcript as JSON and text (requires local credentials)",domain:"www.xiaoyuzhoufm.com",strategy:S.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Episode ID (eid from podcast-episodes output)"},{name:"output",default:"./xiaoyuzhou-transcripts",help:"Output directory"},{name:"json",type:"boolean",default:!0,help:"Save transcript JSON file"},{name:"text",type:"boolean",default:!0,help:"Save extracted transcript text file"}],columns:["title","podcast","status","segments","json_file","text_file"],func:async(t)=>{if(t.json===!1&&t.text===!1)throw new R("At least one of --json or --text must be enabled","Example: opencli xiaoyuzhou transcript 69dd0c98e2c8be31551f6a33 --text true");let o=j();const d=await h("/v1/episode/get",{query:{eid:t.id},credentials:o});o=d.credentials;const e=d.data;if(!e)throw new i("NOT_FOUND","Episode not found","Please check the episode ID");const p=String(e.transcript?.mediaId||e.media?.id||e.transcriptMediaId||"").trim();if(!p)throw new i("PARSE_ERROR","mediaId not found in episode payload","Transcript metadata requires episode.transcript.mediaId, episode.media.id, or episode.transcriptMediaId");const c=(await h("/v1/episode-transcript/get",{method:"POST",body:{eid:t.id,mediaId:p},credentials:o})).data,u=String(c?.transcriptUrl||c?.url||"").trim();if(!u)throw new i("EMPTY_RESULT","Transcript URL not found","This episode may not have transcript data available");const r=await w(u),{text:l,segmentCount:x}=E(r);if(t.text!==!1&&r.trim()&&!l.trim())throw new i("PARSE_ERROR","Failed to extract transcript text","Transcript payload format is unsupported. Re-run with --json true to inspect the raw payload.");const a=n.join(String(t.output||"./xiaoyuzhou-transcripts"),String(t.id));s.mkdirSync(a,{recursive:!0});const f=n.join(a,"transcript.json"),m=n.join(a,"transcript.txt");if(t.json!==!1)s.writeFileSync(f,r,"utf-8");if(t.text!==!1)s.writeFileSync(m,l,"utf-8");return[{title:e.title||"episode",podcast:e.podcast?.title||"",status:"success",segments:t.text===!1?"-":String(x),json_file:t.json===!1?"-":f,text_file:t.text===!1?"-":m}]}});

package/clis/xiaoyuzhou/utils.js

@@ -0,0 +1 @@
+export function formatDuration(b){if(!Number.isFinite(b)||b<0)return"-";b=Math.round(b);const h=Math.floor(b/60),j=b%60;return`${h}:${String(j).padStart(2,"0")}`}export function formatDate(b){if(!b)return"-";return b.slice(0,10)}

package/clis/xueqiu/article.js

@@ -0,0 +1,4 @@
+import{CliError as Y,CommandExecutionError as E}from"@jackwener/opencli/errors";import{cli as b,Strategy as m}from"@jackwener/opencli/registry";import{readFile as R,stat as k}from"node:fs/promises";import{publishArticle as v}from"../_shared/article/publish.js";export const xueqiuProfile={home:"https://mp.xueqiu.com/writeV2",outputFormat:"markdown",image:{spec:{url:"https://mp.xueqiu.com/xq/photo/upload.json",method:"POST",bodyType:"binary-multipart",fileField:"file",fileName:"image.jpg",responsePath:"url"},skip:["xueqiu.com","imedao.com"],uploadFn:async(J,D)=>{const z=await fetch(J,{credentials:"omit"});if(!z.ok)throw Error("图片下载失败: "+J);const U=await z.blob(),K=new FormData;K.append("file",U,"image.jpg");const H=await fetch("https://mp.xueqiu.com/xq/photo/upload.json",{method:"POST",credentials:"include",body:K}),B=await H.text();let Q=null;try{Q=JSON.parse(B)}catch(Z){}if(!H.ok||!Q||!Q.url||!Q.filename)throw Error("图片上传失败: "+B.slice(0,200));return{url:(Q.url.startsWith("//")?"https:"+Q.url:Q.url)+"/"+Q.filename}}},checkAuth:async(J)=>{try{const U=(await(await fetch("https://mp.xueqiu.com/writeV2",{method:"GET",credentials:"include"})).text()).match(/window\.UOM_CURRENTUSER\s*=\s*(\{[\s\S]*?\})\s*<\/script>/);if(!U)return{isAuthenticated:!1};let K=null;try{K=JSON.parse(U[1])}catch(Q){}const H=K&&K.currentUser;if(!H||!H.id)return{isAuthenticated:!1};const B=H.photo_domain&&H.profile_image_url?"https:"+H.photo_domain+(H.profile_image_url.split(",")[0]||""):"";return{isAuthenticated:!0,userId:String(H.id),username:H.screen_name||"",avatar:B}}catch(D){return{isAuthenticated:!1,error:String(D&&D.message||D)}}},publish:async(J,D)=>{const z=J.params||{};let U=J.content;const K=U.split(`
+`),H=[];let B=0;while(B<K.length){const G=K[B];if(G.startsWith("```")){let L="";B++;while(B<K.length&&!K[B].startsWith("```")){L+=(L?`
+`:"")+K[B];B++}H.push("<pre><code>"+L.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")+"</code></pre>");B++;continue}const V=G.match(/^#{1,6}\s+(.*)/);if(V){H.push("<h4>"+V[1]+"</h4>");B++;continue}const X=G.match(/^!\[([^\]]*)\]\(([^)]+)\)/);if(X){H.push('<img src="'+X[2]+'" alt="'+X[1]+'" class="ke_img">');B++;continue}if(/^[-*_]{3,}\s*$/.test(G)){B++;continue}if(!G.trim()){H.push("");B++;continue}let f=G.replace(/\*\*([^*]+)\*\*/g,"<b>$1</b>").replace(/\*([^*]+)\*/g,"<i>$1</i>").replace(/`([^`]+)`/g,"<code>$1</code>");H.push("<p>"+f+"</p>");B++}U=H.filter((G,V,X)=>{return!(G===""&&V>0&&X[V-1]==="")}).join(`
+`).trim();const Q=typeof z.coverPic==="string"?z.coverPic.trim():"";if(Q&&!/(imedao\.com|xueqiu\.com)/.test(Q))return{ok:!1,stage:"cover",message:"封面图必须是雪球图床地址（含 imedao.com / xueqiu.com）；外链需先上传。当前："+Q.slice(0,120)};const $=new URLSearchParams({text:U,title:J.title,cover_pic:Q,flags:"false",original_event:"",status_id:"",legal_user_visible:"false",is_private:"false"}),Z=await fetch("https://mp.xueqiu.com/xq/statuses/draft/save.json",{method:"POST",credentials:"include",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:$}),y=await Z.text();let F=null;try{F=JSON.parse(y)}catch(G){}if(!Z.ok||!F||!F.id)return{ok:!1,stage:"save",status:Z.status,message:F&&F.error_description||y.slice(0,300)};const M=String(F.id);if(J.draftOnly)return{ok:!0,id:M,url:"https://mp.xueqiu.com/write/draft/"+M,draft:!0};let _=typeof z.originalEventId==="string"?z.originalEventId.trim():"",j="",q=!0;if(_)try{const V=await(await fetch("/xq/statuses/original/original_event.json?id="+encodeURIComponent(_),{credentials:"include"})).json(),X=V&&V.originalEvent;if(!X||X.id==null)return{ok:!1,stage:"original_event",message:"原创活动事件不存在："+_+"（用 `xueqiu events` 列举热门事件）"};if(X.disabled)return{ok:!1,stage:"original_event",message:"原创活动事件已停用，不可参与："+_};j=String(X.tag||"")}catch(G){return{ok:!1,stage:"original_event",message:"校验原创活动事件失败："+String(G&&G.message||G)}}else q=!1;let S="";try{const V=await(await fetch("/xq/provider/session/token.json?api_path="+encodeURIComponent("/statuses/update.json"),{credentials:"include"})).json();S=V&&V.session_token?String(V.session_token):""}catch(G){return{ok:!1,stage:"csrf",message:"获取发布 CSRF token 失败："+String(G&&G.message||G)}}if(!S)return{ok:!1,stage:"csrf",message:"未取得发布 CSRF token（session_token 为空）"};const T=z.showCoverPic===!1?"false":"true",h=z.original===!0?"true":"false",x=z.allowReward===!0?"true":"false",P=new URLSearchParams({title:J.title,status:U,draft_id:M,session_token:S,cover_pic:Q,show_cover_pic:T,original:h,industry_category_name:"",original_event_id:q?_:"",original_event_tag:q?j:"",original_event_active:q?"true":"false",legal_user_visible:"false",is_private:"false",legal_user_state:"open",allow_reward:x}),A=await fetch("https://mp.xueqiu.com/xq/statuses/update.json",{method:"POST",credentials:"include",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:P}),C=await A.text();let W=null;try{W=JSON.parse(C)}catch(G){}if(!A.ok||!W||!W.id)return{ok:!1,stage:"publish",status:A.status,message:W&&(W.error_description||W.error_code)||C.slice(0,300)};const N=String(W.id);let O="";if(W.user_id!=null)O=String(W.user_id);else if(W.user&&W.user.id!=null)O=String(W.user.id);if(!O)try{const G=(document.documentElement.outerHTML||"").match(/UOM_CURRENTUSER\s*=\s*(\{[\s\S]*?\})\s*<\/script>/);if(G){const V=JSON.parse(G[1]).currentUser;if(V&&V.id!=null)O=String(V.id)}}catch(G){}const I=O?"https://xueqiu.com/"+O+"/"+N:"https://xueqiu.com/"+N;return{ok:!0,id:N,url:I,draft:!1}}};function w(J){if(!J.execute)throw new Y("INVALID_INPUT","此命令需要 --execute 参数才能实际写入，防止误操作。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}async function c(J){const D=typeof J.text==="string"?J.text:void 0,z=typeof J.file==="string"?J.file:void 0;if(D&&z)throw new Y("INVALID_INPUT","不能同时使用 <text> 和 --file，请选一种");let U=D??"";if(z){let K;try{K=await k(z)}catch{throw new Y("INVALID_INPUT","文件不存在: "+z)}if(!K.isFile())throw new Y("INVALID_INPUT","路径必须是可读文本文件: "+z);let H;try{H=await R(z)}catch{throw new Y("INVALID_INPUT","文件读取失败: "+z)}try{U=new TextDecoder("utf-8",{fatal:!0}).decode(H)}catch{throw new Y("INVALID_INPUT","文件不是合法 UTF-8 文本: "+z)}}if(!U.trim())throw new Y("INVALID_INPUT","正文不能为空");return U}function d(J,D,z,U,K={}){return[{status:"success",outcome:U,message:J,target_type:D,target:z,...K}]}b({site:"xueqiu",name:"article",access:"write",description:"发布雪球文章（长文）。默认正式发布，加 --draft 仅存草稿。正文默认 Markdown，图片自动转存到雪球图床。",domain:"mp.xueqiu.com",strategy:m.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题"},{name:"text",positional:!0,help:"正文（默认 Markdown；传 --html 则视为原始 HTML）"},{name:"file",help:"正文文件路径（UTF-8，默认 Markdown）"},{name:"html",type:"boolean",help:"把正文视为原始 HTML 而非 Markdown"},{name:"cover-image",help:"封面图地址（必须是雪球图床 imedao.com/xueqiu.com 的 url；外链请先上传）。可空=无封面"},{name:"no-cover",type:"boolean",help:"有封面图时不在文章头部展示封面（show_cover_pic=false）"},{name:"original",type:"boolean",help:"声明原创（需账号有原创权限，否则发布会被拒）。默认非原创"},{name:"original-event-id",help:"参与的原创活动/事件 id（精确校验，找不到/已停用报错）；合法值用 `xueqiu events` 列举。可空=不参与"},{name:"allow-reward",type:"boolean",help:"允许打赏。默认不允许"},{name:"draft",type:"boolean",help:"仅保存为草稿，不正式发布"},{name:"execute",type:"boolean",help:"实际执行写入；不加此参数命令拒绝写操作"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(J,D)=>{if(!J)throw new E("雪球文章发布需要浏览器会话（browser session）");w(D);const z=String(D.title??"").trim();if(!z)throw new Y("INVALID_INPUT","文章标题不能为空");const U=await c(D),K=Boolean(D.draft),H={coverPic:typeof D["cover-image"]==="string"?D["cover-image"].trim():"",showCoverPic:!D["no-cover"],original:Boolean(D.original),originalEventId:typeof D["original-event-id"]==="string"?D["original-event-id"].trim():"",allowReward:Boolean(D["allow-reward"])},B=await v(J,{title:z,body:U,format:D.html?"html":"markdown",draftOnly:K,profile:xueqiuProfile,publishParams:H}),Q=B.images.uploaded.length|0,$=B.images.failed.length|0;let Z=B.draft?"已保存雪球文章草稿（需在写作页手动发布）":"已正式发布雪球文章";if(Q||$)Z+=`；图片: ${Q} 张已转存${$?`，${$} 张失败`:""}`;return d(Z,"article","",B.draft?"draft":"created",{created_target:"article:"+B.id,created_url:B.url})}});

package/clis/xueqiu/auth.js

@@ -0,0 +1,27 @@
+import{AuthRequiredError as t,CommandExecutionError as o}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";async function r(i){return(await i.getCookies({url:"https://xueqiu.com"})).some((u)=>u.name==="xq_a_token"&&u.value)}async function n(i){if(!await r(i))throw new t("xueqiu.com","Xueqiu xq_a_token cookie missing — anonymous");await i.goto("https://xueqiu.com/");await i.wait(2);const e=await i.evaluate(`(async () => {
+    try {
+      const res = await fetch(
+        'https://stock.xueqiu.com/v5/stock/portfolio/stock/list.json?size=1&category=1&pid=-1',
+        { credentials: 'include' },
+      );
+      if (res.status === 403) {
+        return { kind: 'http', httpStatus: 403, detail: 'xueqiu stock API 403 — anti-bot / rate limit' };
+      }
+      if (!res.ok) return { kind: 'http', httpStatus: res.status };
+      const d = await res.json();
+      if (d?.error_code === 60201) {
+        return { kind: 'auth', detail: 'xueqiu portfolio API error_code 60201 用户id无效 — anonymous' };
+      }
+      if (d?.error_code) {
+        return { kind: 'xq-error', errorCode: d.error_code, detail: d.error_description || 'xueqiu API error' };
+      }
+      const uCookie = document.cookie.split('; ').find(c => c.startsWith('u='))?.split('=')[1] || '';
+      const cookiesuCookie = document.cookie.split('; ').find(c => c.startsWith('cookiesu='))?.split('=')[1] || '';
+      if (!uCookie || uCookie === cookiesuCookie) {
+        return { kind: 'auth', detail: 'xueqiu u cookie equals cookiesu (device id) — anonymous despite portfolio API 200' };
+      }
+      return { ok: true, user_id: uCookie };
+    } catch (e) {
+      return { kind: 'exception', detail: String(e && e.message || e) };
+    }
+  })()`);if(e?.kind==="auth")throw new t("xueqiu.com",e.detail);if(e?.kind==="http")throw new o(`HTTP ${e.httpStatus} from xueqiu stock API: ${e.detail||""}`);if(e?.kind==="xq-error")throw new o(`xueqiu API error_code ${e.errorCode}: ${e.detail}`);if(e?.kind==="exception")throw new o(`xueqiu whoami failed: ${e.detail}`);if(!e?.ok)throw new o(`Unexpected xueqiu probe: ${JSON.stringify(e)}`);return{user_id:String(e.user_id)}}s({site:"xueqiu",domain:"xueqiu.com",loginUrl:"https://xueqiu.com/",columns:["user_id"],quickCheck:r,verify:n,poll:async(i)=>{if(!await r(i))throw new t("xueqiu.com","Waiting for Xueqiu xq_a_token cookie");return n(i)}});

package/clis/xueqiu/comments.js

@@ -0,0 +1,38 @@
+import{cli as L,Strategy as P}from"@jackwener/opencli/registry";import{ArgumentError as Q,AuthRequiredError as z,CommandExecutionError as M,EmptyResultError as T}from"@jackwener/opencli/errors";import{log as U}from"@jackwener/opencli/logger";import{isRecord as K}from"@jackwener/opencli/utils";const f=/^(?:[A-Z]{2}\d{5,6}|\d{4,6}|[A-Z]{1,5}(?:[.-][A-Z]{1,2})?)$/,x={auth:"auth failure","anti-bot":"anti-bot challenge",argument:"invalid symbol",empty:"no more discussion data",incompatible:"unexpected response shape",unknown:"unknown request failure"};function _(G){if(Array.isArray(G.list))return G.list;if(K(G.data)&&Array.isArray(G.data.list))return G.data.list;return null}function S(G,J){const V=`${J} ${G.textSnippet}`.toLowerCase();return G.contentType.includes("text/html")&&(/captcha|challenge|aliyun_waf|risk/i.test(V)||/_WAF_|_waf_|renderData|aliyun_waf/i.test(G.textSnippet))}function O(G){const J=Number(G??0);return Number.isFinite(J)?J:0}function F(G){if(typeof G==="string")return G.trim();if(typeof G==="number"&&Number.isFinite(G))return String(G);return""}function B(G,J,V,Z){return`xueqiu comments pagination stopped after request ${G}, collected ${J}/${V} items, reason: ${Z}`}function q(G,J){if(G==="auth"||G==="anti-bot")throw new z("xueqiu.com","Stock discussions require login or challenge clearance");if(G==="argument")throw new Q(`xueqiu comments received an invalid symbol: ${J}`);if(G==="empty")throw new T(`xueqiu/comments ${J}`,`No discussion data found for ${J}`);throw new M(`Unexpected response while loading xueqiu comments for ${J}`,"Run the command again with --verbose to inspect the raw site response.")}export function getCommentItems(G){if(!K(G))return[];return(_(G)??[]).filter((V)=>!!V&&typeof V==="object")}export function classifyXueqiuCommentsResponse(G){const J=K(G.json)?G.json:null,V=J?_(J):null,Z=[J?.error,J?.errors,J?.code,J?.message,J?.msg].filter(Boolean).join(" ").toLowerCase(),W=`${Z} ${G.textSnippet}`.toLowerCase();if(S(G,Z))return{kind:"anti-bot"};if(G.status===401||G.status===403)return{kind:"auth"};if(/login required|unauthorized|unauthorised|forbidden|not logged in|need login/.test(W))return{kind:"auth"};if(/invalid symbol|invalid code|bad symbol/.test(Z))return{kind:"argument"};if(/no data|no result|not found|no matching/.test(Z))return{kind:"empty"};if(V&&V.length===0)return{kind:"empty"};if(G.contentType.includes("application/json")&&J&&V===null)return{kind:"incompatible"};return{kind:"unknown"}}export function mergeUniqueCommentRows(G,J){const V=[...G],Z=new Set(G.map((W)=>W.id));for(const W of J){if(Z.has(W.id))continue;Z.add(W.id);V.push(W)}return V}export function normalizeCommentItem(G){const J=String(G.description??"").replace(/<[^>]+>/g," ").replace(/&nbsp;/g," ").replace(/&amp;/g,"&").replace(/&lt;/g,"<").replace(/&gt;/g,">").replace(/\s+/g," ").trim(),V=F(G.id),Z=F(G.user?.id),W=G.created_at?new Date(G.created_at):null,X=W&&!Number.isNaN(W.getTime())?W.toISOString():null;return{id:V,author:String(G.user?.screen_name??""),text:J,likes:O(G.fav_count),replies:O(G.reply_count),retweets:O(G.retweet_count),created_at:X,url:Z&&V?`https://xueqiu.com/${Z}/${V}`:null}}export function toCommentOutputRow(G){const{id:J,...V}=G;return V}export function describeFailureKind(G){return x[G]}export async function fetchCommentsPage(G,J,V,Z){const W=new URL("https://xueqiu.com/query/v1/symbol/search/status");W.searchParams.set("symbol",J);W.searchParams.set("count",String(Z));W.searchParams.set("page",String(V));W.searchParams.set("sort","time");return G.evaluate(`
+    (async () => {
+      try {
+        const response = await fetch(${JSON.stringify(W.toString())}, {
+          credentials: 'include',
+          headers: {
+            'accept': 'application/json, text/plain, */*',
+            'x-requested-with': 'XMLHttpRequest',
+          },
+          referrer: ${JSON.stringify(`https://xueqiu.com/S/${J}`)},
+          referrerPolicy: 'strict-origin-when-cross-origin',
+        });
+        const contentType = response.headers.get('content-type') || '';
+        const text = await response.text();
+        let json = null;
+        if (contentType.includes('application/json')) {
+          try {
+            json = JSON.parse(text);
+          } catch {
+            json = null;
+          }
+        }
+        return {
+          status: response.status,
+          contentType,
+          json,
+          textSnippet: text.slice(0, 2000),
+        };
+      } catch (error) {
+        return {
+          status: 0,
+          contentType: 'text/plain',
+          json: null,
+          textSnippet: error instanceof Error ? error.message : String(error),
+        };
+      }
+    })()
+  `)}export async function collectCommentRows(G){const J=G.warn??U.warn;let V=[];const Z=new Set;for(let W=1;W<=G.maxRequests;W+=1){const X=await G.fetchPage(W,G.pageSize),$=classifyXueqiuCommentsResponse(X);if(W===1&&$.kind!=="unknown")q($.kind,G.symbol);else if($.kind==="empty")break;else if($.kind!=="unknown"){J(B(W,V.length,G.limit,describeFailureKind($.kind)));break}const Y=getCommentItems(X.json),h=Y.map((H)=>normalizeCommentItem(H)).filter((H)=>H.id);if(h.length===0){if(W===1)throw new M(`Unexpected response while loading xueqiu comments for ${G.symbol}`,"Run the command again with --verbose to inspect the raw site response.");if($.kind==="unknown")J(B(W,V.length,G.limit,describeFailureKind($.kind)));break}let D=!1;for(const H of h){if(Z.has(H.id))continue;Z.add(H.id);V.push(H);D=!0}if(V.length>=G.limit)return V.slice(0,G.limit);if(Y.length<G.pageSize)break;if(!D){J(B(W,V.length,G.limit,"pagination did not advance"));break}if(W===G.maxRequests)J(B(W,V.length,G.limit,"reached safety cap"))}return V.slice(0,G.limit)}L({site:"xueqiu",name:"comments",access:"read",description:"获取单只股票的讨论动态",domain:"xueqiu.com",strategy:P.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"symbol",positional:!0,required:!0,help:"Stock symbol, e.g. SH600519, AAPL, or 00700"},{name:"limit",type:"int",default:20,help:"Number of discussion posts to return"}],columns:["author","text","likes","replies","retweets","created_at","url"],func:async(G,J)=>{const V=normalizeSymbolInput(J.symbol),Z=Number(J.limit);if(!Number.isInteger(Z)||Z<=0)throw new Q("xueqiu comments requires --limit to be a positive integer");if(Z>100)throw new Q("xueqiu comments supports --limit up to 100");const W=Math.min(Z,20);await G.goto("https://xueqiu.com");return(await collectCommentRows({symbol:V,limit:Z,pageSize:W,maxRequests:5,fetchPage:($,Y)=>fetchCommentsPage(G,V,$,Y),warn:U.warn})).map(($)=>toCommentOutputRow($))}});export function normalizeSymbolInput(G){const J=String(G??"").trim().toUpperCase();if(!J)throw new Q("xueqiu comments requires a symbol");if(/^HTTPS?:\/\//.test(J))throw new Q("xueqiu comments only accepts a symbol, not a URL");if(!f.test(J))throw new Q(`xueqiu comments received an invalid symbol: ${J}`);return J}

package/clis/xueqiu/danjuan-utils.js

@@ -0,0 +1,84 @@
+export const DANJUAN_DOMAIN="danjuanfunds.com",DANJUAN_ASSET_PAGE=`https://${DANJUAN_DOMAIN}/my-money`;const C=`https://${DANJUAN_DOMAIN}/djapi/fundx/profit/assets/gain?gains=%5B%22private%22%5D`,H=`https://${DANJUAN_DOMAIN}/djapi/fundx/profit/assets/summary?invest_account_id=`;export async function fetchDanjuanAll(z){const k=await z.evaluate(`
+    (async () => {
+      const f = async (u) => {
+        const r = await fetch(u, { credentials: 'include' });
+        if (!r.ok) return { _err: r.status };
+        try { return await r.json(); } catch { return { _err: 'parse' }; }
+      };
+      const n = (v) => { const x = Number(v); return Number.isFinite(x) ? x : null; };
+
+      const gain = await f(${JSON.stringify(C)});
+      if (gain._err) return { _httpError: gain._err };
+
+      const root = gain.data || {};
+      const fundSec = (root.items || []).find(i => i && i.summary_type === 'FUND');
+      const rawAccs = fundSec && Array.isArray(fundSec.invest_account_list)
+        ? fundSec.invest_account_list : [];
+
+      const accounts = rawAccs.map(a => ({
+        accountId:   String(a.invest_account_id || ''),
+        accountName: a.invest_account_name || '',
+        accountType: a.invest_account_type || '',
+        accountCode: a.invest_account_code || '',
+        marketValue: n(a.market_value),
+        dailyGain:   n(a.daily_gain),
+        mainFlag:    !!a.main_flag,
+      }));
+
+      if (!accounts.length) {
+        return { _emptyAccounts: true };
+      }
+
+      const details = await Promise.all(
+        accounts.map(a => f(${JSON.stringify(H)} + encodeURIComponent(a.accountId)))
+      );
+
+      const holdings = [];
+      const detailErrors = [];
+      for (let i = 0; i < accounts.length; i++) {
+        const d = details[i];
+        if (d._err) {
+          detailErrors.push({
+            accountId: accounts[i].accountId,
+            accountName: accounts[i].accountName,
+            error: d._err,
+          });
+          continue;
+        }
+        const data = d.data || {};
+        const funds = Array.isArray(data.items) ? data.items : [];
+        const acc = accounts[i];
+        for (const fd of funds) {
+          holdings.push({
+            accountId:        acc.accountId,
+            accountName:      data.invest_account_name || acc.accountName,
+            accountType:      data.invest_account_type || acc.accountType,
+            fdCode:           fd.fd_code || '',
+            fdName:           fd.fd_name || '',
+            category:         fd.category_text || fd.category || '',
+            marketValue:      n(fd.market_value),
+            volume:           n(fd.volume),
+            usableRemainShare:n(fd.usable_remain_share),
+            dailyGain:        n(fd.daily_gain),
+            holdGain:         n(fd.hold_gain),
+            holdGainRate:     n(fd.hold_gain_rate),
+            totalGain:        n(fd.total_gain),
+            nav:              n(fd.nav),
+            marketPercent:    n(fd.market_percent),
+          });
+        }
+      }
+
+      return {
+        asOf:                root.daily_gain_date || null,
+        totalAssetAmount:    n(root.amount),
+        totalAssetDailyGain: n(root.daily_gain),
+        totalAssetHoldGain:  n(root.hold_gain),
+        totalAssetTotalGain: n(root.total_gain),
+        totalFundMarketValue:n(fundSec && fundSec.amount),
+        accounts,
+        holdings,
+        detailErrors,
+      };
+    })()
+  `);if(k?._httpError)throw Error(`HTTP ${k._httpError} — Hint: not logged in to ${DANJUAN_DOMAIN}?`);if(k?._emptyAccounts)throw Error(`No fund accounts found — Hint: not logged in to ${DANJUAN_DOMAIN}?`);if(Array.isArray(k?.detailErrors)&&k.detailErrors.length>0){const B=k.detailErrors.map((q)=>{return`${q.accountName&&q.accountId?`${q.accountName} (${q.accountId})`:q.accountName||q.accountId||"unknown account"}: ${q.error}`}).join(", ");throw Error(`Failed to fetch Danjuan account details: ${B}`)}return k}

package/clis/xueqiu/earnings-date.js

@@ -0,0 +1 @@
+import{cli as N}from"@jackwener/opencli/registry";import{EmptyResultError as O}from"@jackwener/opencli/errors";import{fetchXueqiuJson as P,formatChinaDate as Q}from"./utils.js";N({site:"xueqiu",name:"earnings-date",access:"read",description:"获取股票预计财报发布日期（公司大事）",domain:"xueqiu.com",browser:!0,args:[{name:"symbol",required:!0,positional:!0,help:"股票代码，如 SH600519、SZ000858、00700"},{name:"next",type:"bool",default:!1,help:"仅返回最近一次未发布的财报日期"},{name:"limit",type:"int",default:10,help:"返回数量，默认 10"}],columns:["date","report","status"],func:async(G,A)=>{await G.goto("https://xueqiu.com");const H=String(A.symbol).toUpperCase(),L=`https://stock.xueqiu.com/v5/stock/screener/event/list.json?symbol=${encodeURIComponent(H)}&page=1&size=100`,I=await P(G,L);if(!I.data?.items)throw new O("xueqiu/earnings-date","请确认股票代码是否正确: "+H);const M=Date.now();let B=I.data.items.filter((x)=>x.subtype===2).map((x)=>{const v=x.timestamp,z=v?Q(v):null,K=v&&v>M;return{date:z,report:x.message,status:K?"⏳ 未发布":"✅ 已发布",_ts:v,_future:K}});if(A.next){const x=B.filter((v)=>v._future).sort((v,z)=>v._ts-z._ts);B=x.length?[x[0]]:[]}return B.slice(0,A.limit).map(({date:x,report:v,status:z})=>({date:x,report:v,status:z}))}});

package/clis/xueqiu/events.js

@@ -0,0 +1,17 @@
+import{cli as F,Strategy as G}from"@jackwener/opencli/registry";import{CliError as H,CommandExecutionError as I}from"@jackwener/opencli/errors";import{gotoWritePage as J}from"../_shared/article/publish.js";import{xueqiuProfile as K}from"./article.js";F({site:"xueqiu",name:"events",access:"read",description:"列举雪球热门原创活动/事件，或用 --id 校验某事件是否可参与。供 `xueqiu article --original-event-id` 取合法值。",domain:"mp.xueqiu.com",strategy:G.COOKIE,browser:!0,args:[{name:"id",help:"校验某个事件 id 是否可用（返回 tag/disabled）；不传则列举热门事件"}],columns:["id","tag","disabled"],func:async(z,A)=>{if(!z)throw new I("雪球事件查询需要浏览器会话");await J(z,K.home);const B=typeof A.id==="string"?A.id.trim():"",D=`(async () => {
+  const id = `+JSON.stringify(B)+`;
+  if (id) {
+    const r = await fetch("/xq/statuses/original/original_event.json?id=" + encodeURIComponent(id), { credentials: "include" });
+    const t = await r.text();
+    let j = null; try { j = JSON.parse(t); } catch (e) {}
+`+`    if (!r.ok || j == null) return { __err: "事件校验失败（HTTP " + r.status + "）：" + t.slice(0, 200) };
+`+`    const ev = j.originalEvent;
+    if (!ev || ev.id == null) return [];
+    return [{ id: String(ev.id), tag: String(ev.tag || ""), disabled: ev.disabled ? "true" : "false" }];
+  }
+  const r = await fetch("/xq/query/v1/hot_event/tag.json?count=5", { credentials: "include" });
+  const t = await r.text();
+  let j = null; try { j = JSON.parse(t); } catch (e) {}
+`+`  if (!r.ok || j == null) return { __err: "热门事件列举失败（HTTP " + r.status + "）：" + t.slice(0, 200) };
+`+`  return ((j && j.data) || []).map(e => ({ id: String(e.id != null ? e.id : ""), tag: String(e.title || ""), disabled: "false" }));
+})()`,v=await z.evaluate(D);if(v&&v.__err)throw new H("FETCH_ERROR",v.__err);return Array.isArray(v)?v:[]}});