publishport-opencli 1.0.20 → 1.0.21

package/clis/tiktok/comment.js

@@ -1,4 +1,4 @@
-import{cli as c,Strategy as m}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as l,BUTTON_WALKER_HELPERS as u,RETRYABLE_HINTS as d,parseTikTokVideoUrl as p,requireCommentText as T,throwButtonWalkerError as h}from"./utils.js";function a(e){return`
+import{cli as s,Strategy as m}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as l,BUTTON_WALKER_HELPERS as u,RETRYABLE_HINTS as d,parseTikTokVideoUrl as p,requireCommentText as T,throwButtonWalkerError as w}from"./utils.js";function a(e){return`
 (async () => {
   const commentText = ${JSON.stringify(e)};
 
@@ -66,4 +66,4 @@ import{cli as c,Strategy as m}from"@jackwener/opencli/registry";import{BROWSER_H
     result: 'posted',
   }];
 })()
-`}async function w(e,r){const{url:o}=p(r.url),s=T(r.text),i=(n)=>h(n,{authMessage:"TikTok requires login to post comments",failureMessage:`Failed to post comment on ${o}`,retryableHint:d.commentFailure});let t;try{await e.goto(o,{waitUntil:"load",settleMs:6000});t=await e.evaluate(a(s))}catch(n){i(n)}if(!Array.isArray(t)||t.length===0)i(Error(`STATE_VERIFY_FAIL: comment returned no row for ${o}`));return t}export const commentCommand=c({site:"tiktok",name:"comment",access:"write",description:"Post a comment on a TikTok video",domain:"www.tiktok.com",strategy:m.COOKIE,browser:!0,args:[{name:"url",required:!0,positional:!0,help:"TikTok video URL (https://www.tiktok.com/@user/video/<id>)"},{name:"text",fromFile:!0,required:!0,positional:!0,help:"Comment text (≤150 chars)"}],columns:["url","text","result"],func:w}),__test__={buildCommentScript:a};
+`}async function h(e,r){const{url:o}=p(r.url),c=T(r.text),i=(n)=>w(n,{authMessage:"TikTok requires login to post comments",failureMessage:`Failed to post comment on ${o}`,retryableHint:d.commentFailure});let t;try{await e.goto(o,{waitUntil:"load",settleMs:6000});t=await e.evaluate(a(c))}catch(n){i(n)}if(!Array.isArray(t)||t.length===0)i(Error(`STATE_VERIFY_FAIL: comment returned no row for ${o}`));return t}export const commentCommand=s({site:"tiktok",name:"comment",access:"write",description:"Post a comment on a TikTok video",domain:"www.tiktok.com",strategy:m.COOKIE,browser:!0,args:[{name:"url",required:!0,positional:!0,help:"TikTok video URL (https://www.tiktok.com/@user/video/<id>)"},{name:"text",fromFile:!0,required:!0,positional:!0,help:"Comment text (≤150 chars)"}],columns:["url","text","result"],func:h}),__test__={buildCommentScript:a};

package/clis/tiktok/creator-videos.js

@@ -1,6 +1,6 @@
-import{cli as V,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentError as j,AuthRequiredError as G,CommandExecutionError as $,EmptyResultError as T,getErrorMessage as _}from"@jackwener/opencli/errors";const F="https://www.tiktok.com/tiktokstudio/content",A="/tiktok/creator/manage/item_list/v1/",y=20,N=250,P=50;function U(B,J,W,Q){const Z=Number(B??W);if(!Number.isInteger(Z)||Z<=0)throw new j(`${J} must be a positive integer`,`Example: ppcli tiktok creator-videos --${J} ${W}`);if(Z>Q)throw new j(`${J} must be <= ${Q}`,`Example: ppcli tiktok creator-videos --${J} ${Q}`);return Z}function O(B){const W=String(B??"0").trim();if(!/^\d+$/.test(W))throw new j("cursor must be a non-negative integer string","Example: ppcli tiktok creator-videos --cursor 0");const Q=Number(W);if(!Number.isSafeInteger(Q))throw new j("cursor must be a safe integer","Example: ppcli tiktok creator-videos --cursor 0");return Q}function h(B,J){return{cursor:B,size:J,query:{conditions:[],sort_orders:[{field_name:"create_time",order:2}]}}}function q(B){const J={url:`${A}?aid=1988`,body:B};return`
+import{cli as N,Strategy as A}from"@jackwener/opencli/registry";import{ArgumentError as c,AuthRequiredError as d,CommandExecutionError as n,EmptyResultError as q,getErrorMessage as C}from"@jackwener/opencli/errors";const p="https://www.tiktok.com/tiktokstudio/content",M="/tiktok/creator/manage/item_list/v1/",h=20,_=250,g=50;function T(t,e,o,r){const s=Number(t??o);if(!Number.isInteger(s)||s<=0)throw new c(`${e} must be a positive integer`,`Example: ppcli tiktok creator-videos --${e} ${o}`);if(s>r)throw new c(`${e} must be <= ${r}`,`Example: ppcli tiktok creator-videos --${e} ${r}`);return s}function l(t){const o=String(t??"0").trim();if(!/^\d+$/.test(o))throw new c("cursor must be a non-negative integer string","Example: ppcli tiktok creator-videos --cursor 0");const r=Number(o);if(!Number.isSafeInteger(r))throw new c("cursor must be a safe integer","Example: ppcli tiktok creator-videos --cursor 0");return r}function S(t,e){return{cursor:t,size:e,query:{conditions:[],sort_orders:[{field_name:"create_time",order:2}]}}}function y(t){const e={url:`${M}?aid=1988`,body:t};return`
 (async () => {
-  const request = ${JSON.stringify(J)};
+  const request = ${JSON.stringify(e)};
   try {
     const res = await fetch(request.url, {
       method: 'POST',
@@ -42,4 +42,4 @@ import{cli as V,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentE
     };
   }
 })()
-`}function S(B){return/\b(auth|login|log in|permission|unauthori[sz]ed|forbidden)\b/i.test(B)}function M(B){if(!B||typeof B!=="object")throw new $("TikTok Studio item_list returned an empty response");return B.data&&typeof B.data==="object"?B.data:B}function b(B){const J=B.status_code??B.statusCode,W=String(B.status_msg??B.statusMsg??"").trim();if(J!==void 0&&Number(J)!==0){if(S(W))throw new G("www.tiktok.com",`TikTok Studio item_list requires login: ${W||J}`);throw new $(`TikTok Studio item_list failed: ${W||J}`)}if(W&&!/^(success|ok)$/i.test(W)){if(S(W))throw new G("www.tiktok.com",`TikTok Studio item_list requires login: ${W}`);throw new $(`TikTok Studio item_list failed: ${W}`)}}function H(B){const J=Number(B);return Number.isFinite(J)?J:0}function C(B){const J=Number(B);if(!Number.isFinite(J)||J<=0)return"";return new Date(J*1000).toLocaleString("zh-CN",{timeZone:"Asia/Shanghai",hour12:!1})}function v(B){const J=B.author?.unique_id??B.author?.uniqueId??B.author_unique_id??B.authorUniqueId??B.user_name??B.username;if(J)return String(J);const W=[...Array.isArray(B.play_addr)?B.play_addr:[],...B.download_info&&Array.isArray(B.download_info.download_urls)?B.download_info.download_urls:[]];for(const Q of W)try{const Y=String(Q).match(/[?&]user_text=([^&]+)/);if(Y)return decodeURIComponent(Y[1])}catch{}return""}function z(B){if(!B||typeof B!=="object")return null;const J=String(B.item_id??B.id??"").trim();if(!J)return null;const W=v(B),Q=W?`https://www.tiktok.com/@${encodeURIComponent(W)}/video/${encodeURIComponent(J)}`:"";return{video_id:J,title:String(B.desc??B.title??"").replace(/\s+/g," ").trim(),date:C(B.post_time??B.create_time??B.schedule_time),views:H(B.play_count),likes:H(B.like_count),comments:H(B.comment_count),saves:H(B.favorite_count),shares:H(B.share_count),url:Q}}async function x(B,J,W){const Q=await B.evaluate(q(h(J,W))).catch((Z)=>{throw new $(`Failed to fetch TikTok Studio item_list: ${_(Z)}`)});if(!Q||typeof Q!=="object")throw new $("TikTok Studio item_list returned an unreadable response");if(Q.networkError)throw new $(`TikTok Studio item_list network failure: ${Q.networkError}`);if(Q.status===401||Q.status===403)throw new G("www.tiktok.com",`TikTok Studio item_list requires login (HTTP ${Q.status})`);if(!Q.ok){const Z=Q.parseError?`invalid JSON (${Q.parseError})`:`HTTP ${Q.status||0}${Q.statusText?` ${Q.statusText}`:""}`;throw new $(`TikTok Studio item_list failed: ${Z}`,Q.text?`Response preview: ${Q.text}`:void 0)}const Y=M(Q.data);b(Y);return Y}async function I(B,J){const W=U(J.limit,"limit",y,N);let Q=O(J.cursor);const Y=[];let Z=0;const X=W>P?P:W,w=Math.ceil(W/X);await B.goto(F,{waitUntil:"load",settleMs:6000});for(let D=0;D<w&&Y.length<W;D+=1){const K=await x(B,Q,X),f=Array.isArray(K.item_list)?K.item_list:[];for(const L of f){const k=z(L);if(!k){Z+=1;continue}Y.push(k);if(Y.length>=W)break}if(!K.has_more||f.length===0)break;Q=O(K.cursor);await B.wait(250)}if(Y.length===0&&Z>0)throw new $("TikTok Studio item_list returned videos without stable video_id");if(Y.length===0)throw new T("tiktok creator-videos","No creator videos were returned. Confirm the current Chrome profile is logged in to TikTok Studio and has published content.");return Y.slice(0,W)}export const creatorVideosCommand=V({site:"tiktok",name:"creator-videos",access:"read",description:"TikTok Studio creator content list (views/likes/comments/saves/shares)",domain:"www.tiktok.com",strategy:R.COOKIE,browser:!0,navigateBefore:F,args:[{name:"limit",type:"int",default:y,help:`Number of creator videos to return (max ${N})`},{name:"cursor",type:"string",default:"0",help:"Non-negative TikTok Studio pagination cursor"}],columns:["video_id","title","date","views","likes","comments","saves","shares","url"],func:I}),__test__={buildFetchItemListScript:q,buildItemListRequest:h,extractUsername:v,normalizeRow:z,requireCursor:O,requirePositiveInt:U};
+`}function b(t){return/\b(auth|login|log in|permission|unauthori[sz]ed|forbidden)\b/i.test(t)}function R(t){if(!t||typeof t!=="object")throw new n("TikTok Studio item_list returned an empty response");return t.data&&typeof t.data==="object"?t.data:t}function P(t){const e=t.status_code??t.statusCode,o=String(t.status_msg??t.statusMsg??"").trim();if(e!==void 0&&Number(e)!==0){if(b(o))throw new d("www.tiktok.com",`TikTok Studio item_list requires login: ${o||e}`);throw new n(`TikTok Studio item_list failed: ${o||e}`)}if(o&&!/^(success|ok)$/i.test(o)){if(b(o))throw new d("www.tiktok.com",`TikTok Studio item_list requires login: ${o}`);throw new n(`TikTok Studio item_list failed: ${o}`)}}function a(t){const e=Number(t);return Number.isFinite(e)?e:0}function O(t){const e=Number(t);if(!Number.isFinite(e)||e<=0)return"";return new Date(e*1000).toLocaleString("zh-CN",{timeZone:"Asia/Shanghai",hour12:!1})}function v(t){const e=t.author?.unique_id??t.author?.uniqueId??t.author_unique_id??t.authorUniqueId??t.user_name??t.username;if(e)return String(e);const o=[...Array.isArray(t.play_addr)?t.play_addr:[],...t.download_info&&Array.isArray(t.download_info.download_urls)?t.download_info.download_urls:[]];for(const r of o)try{const i=String(r).match(/[?&]user_text=([^&]+)/);if(i)return decodeURIComponent(i[1])}catch{}return""}function x(t){if(!t||typeof t!=="object")return null;const e=String(t.item_id??t.id??"").trim();if(!e)return null;const o=v(t),r=o?`https://www.tiktok.com/@${encodeURIComponent(o)}/video/${encodeURIComponent(e)}`:"";return{video_id:e,title:String(t.desc??t.title??"").replace(/\s+/g," ").trim(),date:O(t.post_time??t.create_time??t.schedule_time),views:a(t.play_count),likes:a(t.like_count),comments:a(t.comment_count),saves:a(t.favorite_count),shares:a(t.share_count),url:r}}async function U(t,e,o){const r=await t.evaluate(y(S(e,o))).catch((s)=>{throw new n(`Failed to fetch TikTok Studio item_list: ${C(s)}`)});if(!r||typeof r!=="object")throw new n("TikTok Studio item_list returned an unreadable response");if(r.networkError)throw new n(`TikTok Studio item_list network failure: ${r.networkError}`);if(r.status===401||r.status===403)throw new d("www.tiktok.com",`TikTok Studio item_list requires login (HTTP ${r.status})`);if(!r.ok){const s=r.parseError?`invalid JSON (${r.parseError})`:`HTTP ${r.status||0}${r.statusText?` ${r.statusText}`:""}`;throw new n(`TikTok Studio item_list failed: ${s}`,r.text?`Response preview: ${r.text}`:void 0)}const i=R(r.data);P(i);return i}async function L(t,e){const o=T(e.limit,"limit",h,_);let r=l(e.cursor);const i=[];let s=0;const w=o>g?g:o,E=Math.ceil(o/w);await t.goto(p,{waitUntil:"load",settleMs:6000});for(let m=0;m<E&&i.length<o;m+=1){const u=await U(t,r,w),f=Array.isArray(u.item_list)?u.item_list:[];for(const I of f){const k=x(I);if(!k){s+=1;continue}i.push(k);if(i.length>=o)break}if(!u.has_more||f.length===0)break;r=l(u.cursor);await t.wait(250)}if(i.length===0&&s>0)throw new n("TikTok Studio item_list returned videos without stable video_id");if(i.length===0)throw new q("tiktok creator-videos","No creator videos were returned. Confirm the current Chrome profile is logged in to TikTok Studio and has published content.");return i.slice(0,o)}export const creatorVideosCommand=N({site:"tiktok",name:"creator-videos",access:"read",description:"TikTok Studio creator content list (views/likes/comments/saves/shares)",domain:"www.tiktok.com",strategy:A.COOKIE,browser:!0,navigateBefore:p,args:[{name:"limit",type:"int",default:h,help:`Number of creator videos to return (max ${_})`},{name:"cursor",type:"string",default:"0",help:"Non-negative TikTok Studio pagination cursor"}],columns:["video_id","title","date","views","likes","comments","saves","shares","url"],func:L}),__test__={buildFetchItemListScript:y,buildItemListRequest:S,extractUsername:v,normalizeRow:x,requireCursor:l,requirePositiveInt:T};

package/clis/tiktok/explore.js

@@ -1,4 +1,4 @@
-import{cli as m,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as c,MAX_PAGES as u,SERVER_PAGE_MAX as p,TIKTOK_AID as f,requireLimit as w,throwTikTokPageContextError as k,VIDEO_ITEM_NORMALIZER as g}from"./utils.js";const r=20,o=120;function i(e){return`
+import{cli as m,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as c}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as l,MAX_PAGES as u,SERVER_PAGE_MAX as p,TIKTOK_AID as f,requireLimit as w,throwTikTokPageContextError as k,VIDEO_ITEM_NORMALIZER as g}from"./utils.js";const r=20,o=120;function i(e){return`
 (async () => {
   const limit = ${Number(e)};
   const maxPages = ${u};
@@ -8,7 +8,7 @@ import{cli as m,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResu
   const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
   const aid = ${JSON.stringify(f)};
 
-  ${c}
+  ${l}
   ${g}
 
   function collectFromState(root) {
@@ -73,4 +73,4 @@ import{cli as m,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResu
   }
   return rows;
 })()
-`}async function A(e,s){const a=w(s.limit,{fallback:r,max:o});await e.goto("https://www.tiktok.com/explore",{waitUntil:"load",settleMs:5000});let t;try{t=await e.evaluate(i(a))}catch(n){k(n,{authMessage:"TikTok requires browser access to load the explore feed",emptyPattern:/No videos found/,emptyTarget:"tiktok explore",failureMessage:"Failed to load TikTok explore feed"})}if(!Array.isArray(t)||t.length===0)throw new d("tiktok explore","TikTok returned an empty recommend feed");return t}export const exploreCommand=m({site:"tiktok",name:"explore",access:"read",description:"Get trending TikTok videos from the recommend feed via page-context APIs",domain:"www.tiktok.com",strategy:l.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:r,help:`Number of videos to return (max ${o})`}],columns:["index","id","author","url","cover","title","desc","plays","likes","comments","shares","createTime"],func:A}),__test__={buildExploreScript:i,DEFAULT_LIMIT:r,MAX_LIMIT:o};
+`}async function A(e,s){const a=w(s.limit,{fallback:r,max:o});await e.goto("https://www.tiktok.com/explore",{waitUntil:"load",settleMs:5000});let t;try{t=await e.evaluate(i(a))}catch(n){k(n,{authMessage:"TikTok requires browser access to load the explore feed",emptyPattern:/No videos found/,emptyTarget:"tiktok explore",failureMessage:"Failed to load TikTok explore feed"})}if(!Array.isArray(t)||t.length===0)throw new c("tiktok explore","TikTok returned an empty recommend feed");return t}export const exploreCommand=m({site:"tiktok",name:"explore",access:"read",description:"Get trending TikTok videos from the recommend feed via page-context APIs",domain:"www.tiktok.com",strategy:d.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:r,help:`Number of videos to return (max ${o})`}],columns:["index","id","author","url","cover","title","desc","plays","likes","comments","shares","createTime"],func:A}),__test__={buildExploreScript:i,DEFAULT_LIMIT:r,MAX_LIMIT:o};

package/clis/tiktok/follow.js

@@ -1,9 +1,9 @@
-import{cli as V,Strategy as X}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as Z,BUTTON_WALKER_HELPERS as $,RETRYABLE_HINTS as v,TIKTOK_HOST as D,normalizeUsername as z,throwButtonWalkerError as Y}from"./utils.js";function M(q){return`
+import{cli as a,Strategy as u}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as c,BUTTON_WALKER_HELPERS as w,RETRYABLE_HINTS as f,TIKTOK_HOST as r,normalizeUsername as L,throwButtonWalkerError as m}from"./utils.js";function i(t){return`
 (async () => {
-  const username = ${JSON.stringify(q)};
+  const username = ${JSON.stringify(t)};
 
-  ${Z}
-  ${$}
+  ${c}
+  ${w}
 
   ensureLoggedInOrThrow();
   ensureNoRateLimitOrThrow();
@@ -15,10 +15,10 @@ import{cli as V,Strategy as X}from"@jackwener/opencli/registry";import{BROWSER_H
 
   // Idempotent fast path: already in target state.
   if (buttonExists(FRIENDS_LABELS)) {
-    return [{ username, url: ${JSON.stringify(D)} + '/@' + encodeURIComponent(username), result: 'already-friends' }];
+    return [{ username, url: ${JSON.stringify(r)} + '/@' + encodeURIComponent(username), result: 'already-friends' }];
   }
   if (buttonExists(FOLLOWING_LABELS)) {
-    return [{ username, url: ${JSON.stringify(D)} + '/@' + encodeURIComponent(username), result: 'already-following' }];
+    return [{ username, url: ${JSON.stringify(r)} + '/@' + encodeURIComponent(username), result: 'already-following' }];
   }
 
   const followBtn = findButtonByText(FOLLOW_LABELS);
@@ -42,8 +42,8 @@ import{cli as V,Strategy as X}from"@jackwener/opencli/registry";import{BROWSER_H
 
   return [{
     username,
-    url: ${JSON.stringify(D)} + '/@' + encodeURIComponent(username),
+    url: ${JSON.stringify(r)} + '/@' + encodeURIComponent(username),
     result: 'followed',
   }];
 })()
-`}async function b(q,Q){const x=z(Q.username),J=(G)=>Y(G,{authMessage:"TikTok requires login to follow users",failureMessage:`Failed to follow @${x}`,retryableHint:v.relationFailure});let C;try{await q.goto(`${D}/@${encodeURIComponent(x)}`,{waitUntil:"load",settleMs:5000});C=await q.evaluate(M(x))}catch(G){J(G)}if(!Array.isArray(C)||C.length===0)J(Error(`STATE_VERIFY_FAIL: follow returned no row for @${x}`));return C}export const followCommand=V({site:"tiktok",name:"follow",access:"write",description:"Follow a TikTok user by username",domain:"www.tiktok.com",strategy:X.COOKIE,browser:!0,args:[{name:"username",required:!0,positional:!0,help:"TikTok username (without @)"}],columns:["username","url","result"],func:b}),__test__={buildFollowScript:M};
+`}async function E(t,s){const e=L(s.username),l=(n)=>m(n,{authMessage:"TikTok requires login to follow users",failureMessage:`Failed to follow @${e}`,retryableHint:f.relationFailure});let o;try{await t.goto(`${r}/@${encodeURIComponent(e)}`,{waitUntil:"load",settleMs:5000});o=await t.evaluate(i(e))}catch(n){l(n)}if(!Array.isArray(o)||o.length===0)l(Error(`STATE_VERIFY_FAIL: follow returned no row for @${e}`));return o}export const followCommand=a({site:"tiktok",name:"follow",access:"write",description:"Follow a TikTok user by username",domain:"www.tiktok.com",strategy:u.COOKIE,browser:!0,args:[{name:"username",required:!0,positional:!0,help:"TikTok username (without @)"}],columns:["username","url","result"],func:E}),__test__={buildFollowScript:i};

package/clis/tiktok/following.js

@@ -1,10 +1,10 @@
-import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as u,MAX_PAGES as f,SERVER_PAGE_MAX as w,TIKTOK_AID as m,USER_ITEM_NORMALIZER as p,requireLimit as g,throwTikTokPageContextError as _}from"./utils.js";const i=20,t=200;function o(e){return`
+import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as u,MAX_PAGES as f,SERVER_PAGE_MAX as m,TIKTOK_AID as w,USER_ITEM_NORMALIZER as p,requireLimit as g,throwTikTokPageContextError as U}from"./utils.js";const i=20,t=200;function o(e){return`
 (async () => {
   const limit = ${Number(e)};
   const maxPages = ${f*2};
-  const SERVER_PAGE_MAX = ${w};
+  const SERVER_PAGE_MAX = ${m};
   const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
-  const aid = ${JSON.stringify(m)};
+  const aid = ${JSON.stringify(w)};
 
   ${u}
   ${p}
@@ -100,4 +100,4 @@ import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResu
   }
   return rows;
 })()
-`}async function U(e,s){const n=g(s.limit,{fallback:i,max:t});await e.goto("https://www.tiktok.com/following",{waitUntil:"load",settleMs:5000});let r;try{r=await e.evaluate(o(n))}catch(a){_(a,{authMessage:"TikTok requires login to read your following list",emptyPattern:/No following entries/,emptyTarget:"tiktok following",failureMessage:"Failed to load TikTok following list"})}if(!Array.isArray(r)||r.length===0)throw new l("tiktok following","TikTok returned no following entries");return r}export const followingCommand=c({site:"tiktok",name:"following",access:"read",description:"List accounts the logged-in user follows on TikTok via page-context APIs",domain:"www.tiktok.com",strategy:d.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"limit",type:"int",default:i,help:`Number of accounts (max ${t})`}],columns:["index","username","name","secUid","verified","followers","following","url"],func:U}),__test__={buildFollowingScript:o,DEFAULT_LIMIT:i,MAX_LIMIT:t};
+`}async function _(e,s){const n=g(s.limit,{fallback:i,max:t});await e.goto("https://www.tiktok.com/following",{waitUntil:"load",settleMs:5000});let r;try{r=await e.evaluate(o(n))}catch(a){U(a,{authMessage:"TikTok requires login to read your following list",emptyPattern:/No following entries/,emptyTarget:"tiktok following",failureMessage:"Failed to load TikTok following list"})}if(!Array.isArray(r)||r.length===0)throw new l("tiktok following","TikTok returned no following entries");return r}export const followingCommand=c({site:"tiktok",name:"following",access:"read",description:"List accounts the logged-in user follows on TikTok via page-context APIs",domain:"www.tiktok.com",strategy:d.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"limit",type:"int",default:i,help:`Number of accounts (max ${t})`}],columns:["index","username","name","secUid","verified","followers","following","url"],func:_}),__test__={buildFollowingScript:o,DEFAULT_LIMIT:i,MAX_LIMIT:t};

package/clis/tiktok/friends.js

@@ -1,13 +1,13 @@
-import{cli as u,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as c}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as d,MAX_PAGES as f,SERVER_PAGE_MAX as m,TIKTOK_AID as g,USER_ITEM_NORMALIZER as p,requireLimit as w,throwTikTokPageContextError as k}from"./utils.js";const t=20,s=100;function o(e){return`
+import{cli as u,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as c}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as l,MAX_PAGES as m,SERVER_PAGE_MAX as f,TIKTOK_AID as g,USER_ITEM_NORMALIZER as w,requireLimit as p,throwTikTokPageContextError as k}from"./utils.js";const t=20,s=100;function o(r){return`
 (async () => {
-  const limit = ${Number(e)};
-  const maxPages = ${f};
-  const SERVER_PAGE_MAX = ${m};
+  const limit = ${Number(r)};
+  const maxPages = ${m};
+  const SERVER_PAGE_MAX = ${f};
   const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
   const aid = ${JSON.stringify(g)};
 
-  ${d}
-  ${p}
+  ${l}
+  ${w}
 
   function collectUsersFromState(root) {
     if (!root) return [];
@@ -76,4 +76,4 @@ import{cli as u,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResu
   }
   return rows;
 })()
-`}async function y(e,i){const a=w(i.limit,{fallback:t,max:s});await e.goto("https://www.tiktok.com/friends",{waitUntil:"load",settleMs:5000});let r;try{r=await e.evaluate(o(a))}catch(n){k(n,{authMessage:"TikTok requires browser access to load friend suggestions",emptyPattern:/No friend suggestions/,emptyTarget:"tiktok friends",failureMessage:"Failed to load TikTok friend suggestions"})}if(!Array.isArray(r)||r.length===0)throw new c("tiktok friends","TikTok returned no friend suggestions");return r}export const friendsCommand=u({site:"tiktok",name:"friends",access:"read",description:"Get TikTok friend / who-to-follow suggestions via page-context APIs",domain:"www.tiktok.com",strategy:l.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:t,help:`Number of suggestions (max ${s})`}],columns:["index","username","name","secUid","verified","followers","following","url"],func:y}),__test__={buildFriendsScript:o,DEFAULT_LIMIT:t,MAX_LIMIT:s};
+`}async function y(r,i){const n=p(i.limit,{fallback:t,max:s});await r.goto("https://www.tiktok.com/friends",{waitUntil:"load",settleMs:5000});let e;try{e=await r.evaluate(o(n))}catch(a){k(a,{authMessage:"TikTok requires browser access to load friend suggestions",emptyPattern:/No friend suggestions/,emptyTarget:"tiktok friends",failureMessage:"Failed to load TikTok friend suggestions"})}if(!Array.isArray(e)||e.length===0)throw new c("tiktok friends","TikTok returned no friend suggestions");return e}export const friendsCommand=u({site:"tiktok",name:"friends",access:"read",description:"Get TikTok friend / who-to-follow suggestions via page-context APIs",domain:"www.tiktok.com",strategy:d.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:t,help:`Number of suggestions (max ${s})`}],columns:["index","username","name","secUid","verified","followers","following","url"],func:y}),__test__={buildFriendsScript:o,DEFAULT_LIMIT:t,MAX_LIMIT:s};

package/clis/tiktok/live.js

@@ -1,9 +1,9 @@
-import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as m,LIVE_ITEM_NORMALIZER as u,SERVER_PAGE_MAX as f,TIKTOK_AID as v,requireLimit as p,throwTikTokPageContextError as y}from"./utils.js";const r=10,i=60;function o(e){return`
+import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as m,LIVE_ITEM_NORMALIZER as u,SERVER_PAGE_MAX as f,TIKTOK_AID as y,requireLimit as k,throwTikTokPageContextError as p}from"./utils.js";const t=10,i=60;function o(e){return`
 (async () => {
   const limit = ${Number(e)};
   const SERVER_PAGE_MAX = ${f};
   const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
-  const aid = ${JSON.stringify(v)};
+  const aid = ${JSON.stringify(y)};
 
   ${m}
   ${u}
@@ -76,4 +76,4 @@ import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResu
   }
   return rows;
 })()
-`}async function k(e,s){const a=p(s.limit,{fallback:r,max:i});await e.goto("https://www.tiktok.com/live",{waitUntil:"load",settleMs:5000});let t;try{t=await e.evaluate(o(a))}catch(n){y(n,{authMessage:"TikTok requires browser access to load live streams",emptyPattern:/No live streams returned/,emptyTarget:"tiktok live",failureMessage:"Failed to load TikTok live streams"})}if(!Array.isArray(t)||t.length===0)throw new d("tiktok live","TikTok returned no live streams");return t}export const liveCommand=l({site:"tiktok",name:"live",access:"read",description:"Browse TikTok live streams via page-context APIs",domain:"www.tiktok.com",strategy:c.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:r,help:`Number of streams (max ${i})`}],columns:["index","streamer","name","title","viewers","likes","secUid","url"],func:k}),__test__={buildLiveScript:o,DEFAULT_LIMIT:r,MAX_LIMIT:i};
+`}async function v(e,s){const a=k(s.limit,{fallback:t,max:i});await e.goto("https://www.tiktok.com/live",{waitUntil:"load",settleMs:5000});let r;try{r=await e.evaluate(o(a))}catch(n){p(n,{authMessage:"TikTok requires browser access to load live streams",emptyPattern:/No live streams returned/,emptyTarget:"tiktok live",failureMessage:"Failed to load TikTok live streams"})}if(!Array.isArray(r)||r.length===0)throw new d("tiktok live","TikTok returned no live streams");return r}export const liveCommand=l({site:"tiktok",name:"live",access:"read",description:"Browse TikTok live streams via page-context APIs",domain:"www.tiktok.com",strategy:c.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:t,help:`Number of streams (max ${i})`}],columns:["index","streamer","name","title","viewers","likes","secUid","url"],func:v}),__test__={buildLiveScript:o,DEFAULT_LIMIT:t,MAX_LIMIT:i};

package/clis/tiktok/notifications.js

@@ -1,12 +1,12 @@
-import{cli as m,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as f}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as u,MAX_PAGES as p,NOTIFICATION_NORMALIZER as y,NOTIFICATION_TYPES as n,SERVER_PAGE_MAX as k,TIKTOK_AID as T,requireLimit as w,requireNotificationType as A,throwTikTokPageContextError as g}from"./utils.js";const r=15,a=100;function s(t,e){const i=n[e];return`
+import{cli as m,Strategy as f}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as u,MAX_PAGES as p,NOTIFICATION_NORMALIZER as y,NOTIFICATION_TYPES as n,SERVER_PAGE_MAX as T,TIKTOK_AID as w,requireLimit as k,requireNotificationType as A,throwTikTokPageContextError as _}from"./utils.js";const r=15,a=100;function s(t,i){const e=n[i];return`
 (async () => {
   const limit = ${Number(t)};
   const maxPages = ${p};
-  const SERVER_PAGE_MAX = ${k};
+  const SERVER_PAGE_MAX = ${T};
   const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
-  const noticeType = ${Number(i.code)};
-  const noticeLabel = ${JSON.stringify(i.label)};
-  const aid = ${JSON.stringify(T)};
+  const noticeType = ${Number(e.code)};
+  const noticeLabel = ${JSON.stringify(e.label)};
+  const aid = ${JSON.stringify(w)};
 
   ${u}
   ${y}
@@ -74,4 +74,4 @@ import{cli as m,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResu
   }
   return rows;
 })()
-`}async function _(t,e){const i=w(e.limit,{fallback:r,max:a}),c=A(e.type);await t.goto("https://www.tiktok.com/foryou",{waitUntil:"load",settleMs:5000});let o;try{o=await t.evaluate(s(i,c))}catch(l){g(l,{authMessage:"TikTok requires login to read notifications",emptyPattern:/No notifications returned/,emptyTarget:"tiktok notifications",failureMessage:"Failed to load TikTok notifications"})}if(!Array.isArray(o)||o.length===0)throw new f("tiktok notifications","TikTok returned no notifications");return o}export const notificationsCommand=m({site:"tiktok",name:"notifications",access:"read",description:"Read TikTok inbox notifications (likes, comments, mentions, followers) via page-context APIs",domain:"www.tiktok.com",strategy:d.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:r,help:`Number of notifications (max ${a})`},{name:"type",default:"all",help:"Notification type",choices:Object.keys(n)}],columns:["index","id","from","text","createTime"],func:_}),__test__={buildNotificationsScript:s,DEFAULT_LIMIT:r,MAX_LIMIT:a};
+`}async function g(t,i){const e=k(i.limit,{fallback:r,max:a}),c=A(i.type);await t.goto("https://www.tiktok.com/foryou",{waitUntil:"load",settleMs:5000});let o;try{o=await t.evaluate(s(e,c))}catch(l){_(l,{authMessage:"TikTok requires login to read notifications",emptyPattern:/No notifications returned/,emptyTarget:"tiktok notifications",failureMessage:"Failed to load TikTok notifications"})}if(!Array.isArray(o)||o.length===0)throw new d("tiktok notifications","TikTok returned no notifications");return o}export const notificationsCommand=m({site:"tiktok",name:"notifications",access:"read",description:"Read TikTok inbox notifications (likes, comments, mentions, followers) via page-context APIs",domain:"www.tiktok.com",strategy:f.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:r,help:`Number of notifications (max ${a})`},{name:"type",default:"all",help:"Notification type",choices:Object.keys(n)}],columns:["index","id","from","text","createTime"],func:g}),__test__={buildNotificationsScript:s,DEFAULT_LIMIT:r,MAX_LIMIT:a};

package/clis/tiktok/publish.js

@@ -1,10 +1,10 @@
-import{cli as V,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentError as v,CommandExecutionError as Q}from"@jackwener/opencli/errors";import{resolveVideoFile as F,setVideoInput as j,unwrap as Z,parseScheduleDate as I,waitForUrlIncludes as x,waitForSelector as G,videoTimeoutArg as D}from"../_shared/video-publish.js";const P="https://www.tiktok.com/creator-center/upload",B=['input[type="file"][accept*="video"]','input[type="file"]'],M="div.public-DraftEditor-content",b="div.btn-post",y="#\\:r9\\:";async function f(q,z){return Boolean(Z(await q.evaluate(`((s) => !!document.querySelector(s))(${JSON.stringify(z)})`)))}async function U(q,z,H){await q.click(M);await q.pressKey("End");await q.pressKey("Control+a");await q.pressKey("Delete");await q.pressKey("End");await q.wait({time:1});await q.insertText(z);await q.wait({time:1});await q.pressKey("End");await q.pressKey("Enter");for(const J of H){await q.pressKey("End");await q.wait({time:1});await q.insertText(`#${J} `);await q.pressKey("Space");await q.wait({time:1});await q.pressKey("Backspace");await q.pressKey("End")}}async function L(q,z){const H=Date.now()+1800000;while(Date.now()<H){if(Z(await q.evaluate(`
+import{cli as b,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as T,CommandExecutionError as o}from"@jackwener/opencli/errors";import{resolveVideoFile as v,setVideoInput as m,unwrap as l,parseScheduleDate as x,waitForUrlIncludes as E,waitForSelector as w,videoTimeoutArg as q}from"../_shared/video-publish.js";const O="https://www.tiktok.com/creator-center/upload",h=['input[type="file"][accept*="video"]','input[type="file"]'],k="div.public-DraftEditor-content",f="div.btn-post",S="#\\:r9\\:";async function u(t,e){return Boolean(l(await t.evaluate(`((s) => !!document.querySelector(s))(${JSON.stringify(e)})`)))}async function D(t,e,i){await t.click(k);await t.pressKey("End");await t.pressKey("Control+a");await t.pressKey("Delete");await t.pressKey("End");await t.wait({time:1});await t.insertText(e);await t.wait({time:1});await t.pressKey("End");await t.pressKey("Enter");for(const r of i){await t.pressKey("End");await t.wait({time:1});await t.insertText(`#${r} `);await t.pressKey("Space");await t.wait({time:1});await t.pressKey("Backspace");await t.pressKey("End")}}async function _(t,e){const i=Date.now()+1800000;while(Date.now()<i){if(l(await t.evaluate(`
       (() => {
-        const btn = document.querySelector('${b} > button');
+        const btn = document.querySelector('${f} > button');
         if (!btn) return null;
         return btn.getAttribute('disabled') === null;
       })()
-    `))===!0)return;if(await f(q,'button[aria-label="Select file"]'))await j(q,['button[aria-label="Select file"] ~ input[type="file"]',...B],[z]);await q.wait({time:2})}throw new Q("TikTok 视频上传超时")}async function k(q,z){if(!Boolean(Z(await q.evaluate(`
+    `))===!0)return;if(await u(t,'button[aria-label="Select file"]'))await m(t,['button[aria-label="Select file"] ~ input[type="file"]',...h],[e]);await t.wait({time:2})}throw new o("TikTok 视频上传超时")}async function A(t,e){if(!Boolean(l(await t.evaluate(`
     (() => {
       const norm = (v) => (v || '').replace(/\\s+/g, ' ').trim();
       // get_by_label('Schedule')
@@ -18,7 +18,7 @@ import{cli as V,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentE
       el.click();
       return true;
     })()
-  `))))throw new Q("找不到 TikTok 定时发布开关 (Schedule)");await q.wait({time:1});const J=(Y)=>String(Y).padStart(2,"0"),$=z.getDate(),K=z.getMonth()+1,W=J(z.getHours()),A=J(Math.floor(z.getMinutes()/5)),X=Z(await q.evaluate(`
+  `))))throw new o("找不到 TikTok 定时发布开关 (Schedule)");await t.wait({time:1});const r=(d)=>String(d).padStart(2,"0"),c=e.getDate(),a=e.getMonth()+1,s=r(e.getHours()),y=r(Math.floor(e.getMinutes()/5)),n=l(await t.evaluate(`
     ((targetDay, targetMonth) => {
       const picker = document.querySelector('div.scheduled-picker');
       if (!picker) return { ok: false, reason: 'no scheduled-picker' };
@@ -29,54 +29,54 @@ import{cli as V,Strategy as N}from"@jackwener/opencli/registry";import{ArgumentE
       const MONTHS = ['January','February','March','April','May','June','July','August','September','October','November','December'];
       let curMonth = monthTitle ? (MONTHS.indexOf((monthTitle.innerText || '').trim()) + 1) : 0;
       return { ok: true, curMonth };
-    })(${$}, ${K})
-  `));if(!X?.ok)throw new Q(`TikTok 定时选择器异常: ${X?.reason||"unknown"}`);if(X.curMonth&&X.curMonth!==K){const Y=X.curMonth<K?"last":"first";await q.evaluate(`
+    })(${c}, ${a})
+  `));if(!n?.ok)throw new o(`TikTok 定时选择器异常: ${n?.reason||"unknown"}`);if(n.curMonth&&n.curMonth!==a){const d=n.curMonth<a?"last":"first";await t.evaluate(`
       (() => {
         const arrows = document.querySelectorAll('div.calendar-wrapper span.arrow');
         if (!arrows.length) return false;
-        const a = ${Y==="last"?"arrows[arrows.length - 1]":"arrows[0]"};
+        const a = ${d==="last"?"arrows[arrows.length - 1]":"arrows[0]"};
         a.click();
         return true;
       })()
-    `);await q.wait({time:0.5})}await q.evaluate(`
+    `);await t.wait({time:0.5})}await t.evaluate(`
     ((wantDay) => {
       const days = document.querySelectorAll('div.calendar-wrapper span.day.valid');
       for (const d of days) {
         if ((d.innerText || '').trim() === String(wantDay)) { d.click(); return true; }
       }
       return false;
-    })(${$})
-  `);await q.evaluate(`
+    })(${c})
+  `);await t.evaluate(`
     (() => {
       const picker = document.querySelector('div.scheduled-picker');
       const boxes = picker ? picker.querySelectorAll('div.TUXInputBox') : [];
       if (boxes[0]) boxes[0].click();
     })()
-  `);await q.evaluate(`
+  `);await t.evaluate(`
     ((hourStr) => {
       for (const el of document.querySelectorAll('span.tiktok-timepicker-left')) {
         if ((el.innerText || '').includes(hourStr)) { el.click(); return true; }
       }
       return false;
-    })(${JSON.stringify(W)})
-  `);await q.wait({time:1});await q.evaluate(`
+    })(${JSON.stringify(s)})
+  `);await t.wait({time:1});await t.evaluate(`
     (() => {
       const picker = document.querySelector('div.scheduled-picker');
       const boxes = picker ? picker.querySelectorAll('div.TUXInputBox') : [];
       if (boxes[0]) boxes[0].click();
     })()
-  `);await q.evaluate(`
+  `);await t.evaluate(`
     ((minuteStr) => {
       for (const el of document.querySelectorAll('span.tiktok-timepicker-right')) {
         if ((el.innerText || '').includes(minuteStr)) { el.click(); return true; }
       }
       return false;
-    })(${JSON.stringify(A)})
-  `);await q.evaluate(`
+    })(${JSON.stringify(y)})
+  `);await t.evaluate(`
     (() => {
       for (const h of document.querySelectorAll('h1')) {
         if ((h.innerText || '').includes('Upload video')) { h.click(); return true; }
       }
       return false;
     })()
-  `)}async function R(q){const z=Date.now()+300000;while(Date.now()<z){if(await f(q,b))await q.evaluate(`(() => { const b = document.querySelector('${b}'); if (b) b.click(); })()`);await q.wait({time:1});if(await f(q,y))return;await q.wait({time:0.5})}if(await f(q,y))return;throw new Q("TikTok 发布未确认成功（未出现成功标识）")}V({site:"tiktok",name:"publish",access:"write",description:"Publish a video to TikTok (one command: upload + caption + publish; optional schedule)",domain:"www.tiktok.com",strategy:N.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"video",required:!0,positional:!0,help:"Video file path"},{name:"title",required:!0,help:"Caption / title text"},{name:"tags",default:"",help:"Comma-separated hashtags (without #)"},{name:"schedule",default:"",help:"Scheduled publish time (ISO8601 or Unix seconds); omit to post now"},D()],columns:["status","title","url"],func:async(q,z)=>{const H=String(z.title??"").trim();if(!H)throw new v("--title is required");const J=F(z.video),$=z.tags?String(z.tags).split(",").map((W)=>W.trim()).filter(Boolean):[],K=I(z.schedule);await q.goto(P);if(!await x(q,"tiktokstudio/upload",30000))throw new Q("未能进入 TikTok Studio 上传页（登录态可能失效，请先 ppcli tiktok login）");await G(q,'iframe[data-tt="Upload_index_iframe"], div.upload-container',1e4);await G(q,'input[type="file"]',15000);await j(q,B,[J]);if(!await G(q,M,60000))throw new Q("TikTok 文案编辑器未出现");await U(q,H,$);await L(q,J);if(K)await k(q,K);await R(q);return[{status:K?"✅ Scheduled":"✅ Published",title:H,url:await q.evaluate("() => location.href").then(Z)}]}});
+  `)}async function C(t){const e=Date.now()+300000;while(Date.now()<e){if(await u(t,f))await t.evaluate(`(() => { const b = document.querySelector('${f}'); if (b) b.click(); })()`);await t.wait({time:1});if(await u(t,S))return;await t.wait({time:0.5})}if(await u(t,S))return;throw new o("TikTok 发布未确认成功（未出现成功标识）")}b({site:"tiktok",name:"publish",access:"write",description:"Publish a video to TikTok (one command: upload + caption + publish; optional schedule)",domain:"www.tiktok.com",strategy:p.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"video",required:!0,positional:!0,help:"Video file path"},{name:"title",required:!0,help:"Caption / title text"},{name:"tags",default:"",help:"Comma-separated hashtags (without #)"},{name:"schedule",default:"",help:"Scheduled publish time (ISO8601 or Unix seconds); omit to post now"},q()],columns:["status","title","url"],func:async(t,e)=>{const i=String(e.title??"").trim();if(!i)throw new T("--title is required");const r=v(e.video),c=e.tags?String(e.tags).split(",").map((s)=>s.trim()).filter(Boolean):[],a=x(e.schedule);await t.goto(O);if(!await E(t,"tiktokstudio/upload",30000))throw new o("未能进入 TikTok Studio 上传页（登录态可能失效，请先 ppcli tiktok login）");await w(t,'iframe[data-tt="Upload_index_iframe"], div.upload-container',1e4);await w(t,'input[type="file"]',15000);await m(t,h,[r]);if(!await w(t,k,60000))throw new o("TikTok 文案编辑器未出现");await D(t,i,c);await _(t,r);if(a)await A(t,a);await C(t);return[{status:a?"✅ Scheduled":"✅ Published",title:i,url:await t.evaluate("() => location.href").then(l)}]}});

package/clis/tiktok/unfollow.js

@@ -1,4 +1,4 @@
-import{cli as a,Strategy as u}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as c,BUTTON_WALKER_HELPERS as w,RETRYABLE_HINTS as f,TIKTOK_HOST as n,normalizeUsername as d,throwButtonWalkerError as m}from"./utils.js";function l(o){return`
+import{cli as a,Strategy as u}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as c,BUTTON_WALKER_HELPERS as w,RETRYABLE_HINTS as L,TIKTOK_HOST as r,normalizeUsername as f,throwButtonWalkerError as E}from"./utils.js";function l(o){return`
 (async () => {
   const username = ${JSON.stringify(o)};
 
@@ -16,7 +16,7 @@ import{cli as a,Strategy as u}from"@jackwener/opencli/registry";import{BROWSER_H
 
   // Idempotent fast path: not currently following.
   if (!buttonExists(RELATION_LABELS) && buttonExists(FOLLOW_LABELS)) {
-    return [{ username, url: ${JSON.stringify(n)} + '/@' + encodeURIComponent(username), result: 'already-not-following' }];
+    return [{ username, url: ${JSON.stringify(r)} + '/@' + encodeURIComponent(username), result: 'already-not-following' }];
   }
 
   const relationBtn = findButtonByText(RELATION_LABELS);
@@ -52,8 +52,8 @@ import{cli as a,Strategy as u}from"@jackwener/opencli/registry";import{BROWSER_H
 
   return [{
     username,
-    url: ${JSON.stringify(n)} + '/@' + encodeURIComponent(username),
+    url: ${JSON.stringify(r)} + '/@' + encodeURIComponent(username),
     result: 'unfollowed',
   }];
 })()
-`}async function L(o,s){const e=d(s.username),i=(r)=>m(r,{authMessage:"TikTok requires login to unfollow users",failureMessage:`Failed to unfollow @${e}`,retryableHint:f.relationFailure});let t;try{await o.goto(`${n}/@${encodeURIComponent(e)}`,{waitUntil:"load",settleMs:5000});t=await o.evaluate(l(e))}catch(r){i(r)}if(!Array.isArray(t)||t.length===0)i(Error(`STATE_VERIFY_FAIL: unfollow returned no row for @${e}`));return t}export const unfollowCommand=a({site:"tiktok",name:"unfollow",access:"write",description:"Unfollow a TikTok user by username",domain:"www.tiktok.com",strategy:u.COOKIE,browser:!0,args:[{name:"username",required:!0,positional:!0,help:"TikTok username (without @)"}],columns:["username","url","result"],func:L}),__test__={buildUnfollowScript:l};
+`}async function d(o,s){const t=f(s.username),i=(n)=>E(n,{authMessage:"TikTok requires login to unfollow users",failureMessage:`Failed to unfollow @${t}`,retryableHint:L.relationFailure});let e;try{await o.goto(`${r}/@${encodeURIComponent(t)}`,{waitUntil:"load",settleMs:5000});e=await o.evaluate(l(t))}catch(n){i(n)}if(!Array.isArray(e)||e.length===0)i(Error(`STATE_VERIFY_FAIL: unfollow returned no row for @${t}`));return e}export const unfollowCommand=a({site:"tiktok",name:"unfollow",access:"write",description:"Unfollow a TikTok user by username",domain:"www.tiktok.com",strategy:u.COOKIE,browser:!0,args:[{name:"username",required:!0,positional:!0,help:"TikTok username (without @)"}],columns:["username","url","result"],func:d}),__test__={buildUnfollowScript:l};

package/clis/tiktok/user.js

@@ -1,4 +1,4 @@
-import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as l,MAX_PAGES as f,SERVER_PAGE_MAX as p,TIKTOK_AID as h,VIDEO_ITEM_NORMALIZER as k,normalizeUsername as w,requireLimit as g,throwTikTokPageContextError as y}from"./utils.js";const i=20,s=120;function a(e,r){return`
+import{cli as d,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as m}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as l,MAX_PAGES as f,SERVER_PAGE_MAX as p,TIKTOK_AID as h,VIDEO_ITEM_NORMALIZER as k,normalizeUsername as w,requireLimit as g,throwTikTokPageContextError as y}from"./utils.js";const i=20,s=120;function a(e,r){return`
 (async () => {
   const username = ${JSON.stringify(e)};
   const usernameLower = username.toLowerCase();
@@ -140,4 +140,4 @@ import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResu
   }
   return rows;
 })()
-`}async function T(e,r){const o=w(r.username),n=g(r.limit,{fallback:i,max:s});await e.goto(`https://www.tiktok.com/@${encodeURIComponent(o)}`,{waitUntil:"load",settleMs:6000});let t;try{t=await e.evaluate(a(o,n))}catch(u){y(u,{authMessage:"TikTok requires browser access to load user videos",emptyPattern:/No videos found/,emptyTarget:"tiktok user",failureMessage:"Failed to fetch TikTok user videos"})}if(!Array.isArray(t)||t.length===0)throw new m("tiktok user",`No videos found for @${o}`);return t}export const userCommand=c({site:"tiktok",name:"user",access:"read",description:"Get recent videos from a TikTok user via page-context APIs",domain:"www.tiktok.com",strategy:d.COOKIE,browser:!0,args:[{name:"username",required:!0,positional:!0,help:"TikTok username (without @)"},{name:"limit",type:"int",default:i,help:`Number of videos to return (max ${s})`}],columns:["index","id","source","author","url","cover","title","desc","plays","likes","comments","shares","createTime"],func:T}),__test__={buildUserScript:a,DEFAULT_LIMIT:i,MAX_LIMIT:s};
+`}async function S(e,r){const o=w(r.username),n=g(r.limit,{fallback:i,max:s});await e.goto(`https://www.tiktok.com/@${encodeURIComponent(o)}`,{waitUntil:"load",settleMs:6000});let t;try{t=await e.evaluate(a(o,n))}catch(u){y(u,{authMessage:"TikTok requires browser access to load user videos",emptyPattern:/No videos found/,emptyTarget:"tiktok user",failureMessage:"Failed to fetch TikTok user videos"})}if(!Array.isArray(t)||t.length===0)throw new m("tiktok user",`No videos found for @${o}`);return t}export const userCommand=d({site:"tiktok",name:"user",access:"read",description:"Get recent videos from a TikTok user via page-context APIs",domain:"www.tiktok.com",strategy:c.COOKIE,browser:!0,args:[{name:"username",required:!0,positional:!0,help:"TikTok username (without @)"},{name:"limit",type:"int",default:i,help:`Number of videos to return (max ${s})`}],columns:["index","id","source","author","url","cover","title","desc","plays","likes","comments","shares","createTime"],func:S}),__test__={buildUserScript:a,DEFAULT_LIMIT:i,MAX_LIMIT:s};

package/clis/tiktok/utils.js

@@ -1,4 +1,4 @@
-import{ArgumentError as L,AuthRequiredError as W,CommandExecutionError as V,EmptyResultError as $,getErrorMessage as Z}from"@jackwener/opencli/errors";export const TIKTOK_AID="1988",TIKTOK_HOST="https://www.tiktok.com",SERVER_PAGE_MAX=30,MAX_PAGES=4;export function requireLimit(B,{fallback:z,max:D,name:G="limit"}){const J=Number(B??z);if(!Number.isInteger(J)||J<=0)throw new L(`${G} must be a positive integer`,`Example: --${G} ${z}`);if(J>D)throw new L(`${G} must be <= ${D}`,`Example: --${G} ${D}`);return J}export function normalizeUsername(B){const z=String(B??"").trim().replace(/^@+/,"");if(!z)throw new L("username is required","Example: ppcli tiktok following <username>");if(!/^[A-Za-z0-9._-]+$/.test(z))throw new L("username contains unsupported characters","Pass the TikTok handle without @, for example: dictogo");return z}export const NOTIFICATION_TYPES={all:{code:0,label:"all"},likes:{code:3,label:"likes"},comments:{code:7,label:"comments"},mentions:{code:6,label:"mentions"},followers:{code:4,label:"followers"}};export function requireNotificationType(B){const z=String(B??"all").trim().toLowerCase();if(!Object.prototype.hasOwnProperty.call(NOTIFICATION_TYPES,z))throw new L(`unsupported notification type: ${B}`,`Allowed: ${Object.keys(NOTIFICATION_TYPES).join(", ")}`);return z}export const COMMENT_TEXT_MAX=150;export function requireCommentText(B){const z=String(B??"").trim();if(!z)throw new L("comment text is required",'Example: ppcli tiktok comment <url> "great video"');if(z.length>COMMENT_TEXT_MAX)throw new L(`comment text must be <= ${COMMENT_TEXT_MAX} characters (got ${z.length})`,"TikTok rejects long comments at submit time; trim before retrying");return z}export function parseTikTokVideoUrl(B){const z=String(B??"").trim();if(!z)throw new L("video URL is required",'Example: ppcli tiktok comment https://www.tiktok.com/@user/video/1234567890 "..."');let D;try{D=new URL(z)}catch{throw new L(`invalid video URL: ${z}`,"Example: https://www.tiktok.com/@user/video/1234567890")}if(!/(^|\.)tiktok\.com$/i.test(D.hostname))throw new L(`URL must be on tiktok.com (got ${D.hostname})`,"Example: https://www.tiktok.com/@user/video/1234567890");const G=D.pathname.match(/^\/@([A-Za-z0-9._-]+)\/video\/(\d+)\/?$/);if(!G)throw new L("URL must follow /@<username>/video/<id> format","Example: https://www.tiktok.com/@user/video/1234567890");return{url:D.toString(),username:G[1],videoId:G[2]}}export function looksTikTokAuthFailure(B){return/\bAUTH_REQUIRED\b|\b(auth|captcha|login|log in|permission|unauthori[sz]ed|forbidden)\b|HTTP\s+(401|403)\b/i.test(String(B||""))}export function looksTikTokUpstreamFailure(B){return/\b(API failed|HTTP\s+\d+|invalid JSON|Failed to fetch|network|fetch)\b/i.test(String(B||""))}export function throwTikTokPageContextError(B,{authMessage:z,emptyPattern:D,emptyTarget:G,failureMessage:Q}){const J=Z(B);if(looksTikTokAuthFailure(J))throw new W("tiktok.com",z);if(looksTikTokUpstreamFailure(J))throw new V(`${Q}: ${J}`);if(D.test(J))throw new $(G,J);throw new V(`${Q}: ${J}`)}export const BUTTON_WALKER_SENTINELS={AUTH_REQUIRED:"AUTH_REQUIRED",BUTTON_NOT_FOUND:"BUTTON_NOT_FOUND",STATE_VERIFY_FAIL:"STATE_VERIFY_FAIL",RATE_LIMITED:"RATE_LIMITED"},RETRYABLE_HINTS={commentFailure:"retryable=false reason=server-fan-out — TikTok may have accepted the comment but state verification timed out; do NOT auto-retry",relationFailure:"retryable=true reason=idempotent — TikTok dedupes follow/unfollow on retry; safe to re-run"};export function throwButtonWalkerError(B,{authMessage:z,failureMessage:D,retryableHint:G}){const Q=Z(B);if(/\bRATE_LIMITED\b|\b(captcha|too many requests|rate limit|try again later|slow down)\b/i.test(Q))throw new V(`${D}: ${Q}`,G);if(looksTikTokAuthFailure(Q))throw new W("tiktok.com",z);throw new V(`${D}: ${Q}`,G)}export const BROWSER_HELPERS=`
+import{ArgumentError as i,AuthRequiredError as u,CommandExecutionError as a,EmptyResultError as m,getErrorMessage as c}from"@jackwener/opencli/errors";export const TIKTOK_AID="1988",TIKTOK_HOST="https://www.tiktok.com",SERVER_PAGE_MAX=30,MAX_PAGES=4;export function requireLimit(t,{fallback:e,max:r,name:o="limit"}){const n=Number(t??e);if(!Number.isInteger(n)||n<=0)throw new i(`${o} must be a positive integer`,`Example: --${o} ${e}`);if(n>r)throw new i(`${o} must be <= ${r}`,`Example: --${o} ${r}`);return n}export function normalizeUsername(t){const e=String(t??"").trim().replace(/^@+/,"");if(!e)throw new i("username is required","Example: ppcli tiktok following <username>");if(!/^[A-Za-z0-9._-]+$/.test(e))throw new i("username contains unsupported characters","Pass the TikTok handle without @, for example: dictogo");return e}export const NOTIFICATION_TYPES={all:{code:0,label:"all"},likes:{code:3,label:"likes"},comments:{code:7,label:"comments"},mentions:{code:6,label:"mentions"},followers:{code:4,label:"followers"}};export function requireNotificationType(t){const e=String(t??"all").trim().toLowerCase();if(!Object.prototype.hasOwnProperty.call(NOTIFICATION_TYPES,e))throw new i(`unsupported notification type: ${t}`,`Allowed: ${Object.keys(NOTIFICATION_TYPES).join(", ")}`);return e}export const COMMENT_TEXT_MAX=150;export function requireCommentText(t){const e=String(t??"").trim();if(!e)throw new i("comment text is required",'Example: ppcli tiktok comment <url> "great video"');if(e.length>COMMENT_TEXT_MAX)throw new i(`comment text must be <= ${COMMENT_TEXT_MAX} characters (got ${e.length})`,"TikTok rejects long comments at submit time; trim before retrying");return e}export function parseTikTokVideoUrl(t){const e=String(t??"").trim();if(!e)throw new i("video URL is required",'Example: ppcli tiktok comment https://www.tiktok.com/@user/video/1234567890 "..."');let r;try{r=new URL(e)}catch{throw new i(`invalid video URL: ${e}`,"Example: https://www.tiktok.com/@user/video/1234567890")}if(!/(^|\.)tiktok\.com$/i.test(r.hostname))throw new i(`URL must be on tiktok.com (got ${r.hostname})`,"Example: https://www.tiktok.com/@user/video/1234567890");const o=r.pathname.match(/^\/@([A-Za-z0-9._-]+)\/video\/(\d+)\/?$/);if(!o)throw new i("URL must follow /@<username>/video/<id> format","Example: https://www.tiktok.com/@user/video/1234567890");return{url:r.toString(),username:o[1],videoId:o[2]}}export function looksTikTokAuthFailure(t){return/\bAUTH_REQUIRED\b|\b(auth|captcha|login|log in|permission|unauthori[sz]ed|forbidden)\b|HTTP\s+(401|403)\b/i.test(String(t||""))}export function looksTikTokUpstreamFailure(t){return/\b(API failed|HTTP\s+\d+|invalid JSON|Failed to fetch|network|fetch)\b/i.test(String(t||""))}export function throwTikTokPageContextError(t,{authMessage:e,emptyPattern:r,emptyTarget:o,failureMessage:s}){const n=c(t);if(looksTikTokAuthFailure(n))throw new u("tiktok.com",e);if(looksTikTokUpstreamFailure(n))throw new a(`${s}: ${n}`);if(r.test(n))throw new m(o,n);throw new a(`${s}: ${n}`)}export const BUTTON_WALKER_SENTINELS={AUTH_REQUIRED:"AUTH_REQUIRED",BUTTON_NOT_FOUND:"BUTTON_NOT_FOUND",STATE_VERIFY_FAIL:"STATE_VERIFY_FAIL",RATE_LIMITED:"RATE_LIMITED"},RETRYABLE_HINTS={commentFailure:"retryable=false reason=server-fan-out — TikTok may have accepted the comment but state verification timed out; do NOT auto-retry",relationFailure:"retryable=true reason=idempotent — TikTok dedupes follow/unfollow on retry; safe to re-run"};export function throwButtonWalkerError(t,{authMessage:e,failureMessage:r,retryableHint:o}){const s=c(t);if(/\bRATE_LIMITED\b|\b(captcha|too many requests|rate limit|try again later|slow down)\b/i.test(s))throw new a(`${r}: ${s}`,o);if(looksTikTokAuthFailure(s))throw new u("tiktok.com",e);throw new a(`${r}: ${s}`,o)}export const BROWSER_HELPERS=`
 function asNumber(value) {
   if (value === null || value === undefined || value === '') return null;
   const n = Number(value);

package/clis/toutiao/article.js

@@ -1 +1 @@
-import{CliError as W,CommandExecutionError as v}from"@jackwener/opencli/errors";import{cli as j,Strategy as k}from"@jackwener/opencli/registry";import{publishArticle as w}from"../_shared/article/publish.js";import{readFile as n,stat as f}from"node:fs/promises";function p(L){if(!L.execute)throw new W("INVALID_INPUT","此头条号写操作需要 --execute 参数才能真正发布。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}async function m(L){const J=typeof L.text==="string"?L.text:void 0,B=typeof L.file==="string"?L.file:void 0;if(J&&B)throw new W("INVALID_INPUT","正文和 --file 只能选一个");let D=J??"";if(B){let V;try{V=await f(B)}catch{throw new W("INVALID_INPUT",`找不到文件: ${B}`)}if(!V.isFile())throw new W("INVALID_INPUT",`--file 必须是可读文本文件: ${B}`);let Y;try{Y=await n(B)}catch{throw new W("INVALID_INPUT",`文件无法读取: ${B}`)}try{D=new TextDecoder("utf-8",{fatal:!0}).decode(Y)}catch{throw new W("INVALID_INPUT",`文件必须是 UTF-8 编码: ${B}`)}}if(!D.trim())throw new W("INVALID_INPUT","正文不能为空");return D}function u(L,J,B,D,V={}){return[{status:"success",outcome:D,message:L,target_type:J,target:B,...V}]}export const toutiaoProfile={home:"https://mp.toutiao.com/profile_v3/graphic/publish",outputFormat:"html",preprocessConfig:{},publish:async(L,J)=>{const B=L.params||{},D=[],V=[];async function Y(z,O){const M="/spice/image?upload_source="+O+"&need_enhance=true&aid=1231&device_platform=web",G=new FormData;let H;if(/^https?:/i.test(z)){G.append("imageUrl",z);H=await fetch(M+"&scene=paste",{method:"POST",credentials:"include",body:G})}else{const F=await fetch(z,{credentials:"omit"});if(!F.ok)throw Error("图片下载失败 HTTP "+F.status+"："+z.slice(0,80));const x=await F.blob(),I=((x.type||"").split("/")[1]||"jpg").split("+")[0].split(";")[0]||"jpg";G.append("image",x,"image."+I);H=await fetch(M,{method:"POST",credentials:"include",body:G})}const Q=await H.json(),A=Q&&Q.data;if(!Q||Q.code!==0||!A||!A.image_uri)throw Error((Q&&Q.message||"图片上传失败")+(Q&&Q.code!=null?"（接口 code "+Q.code+"）":""));return{uri:A.image_uri,url:A.image_url,width:A.image_width,height:A.image_height}}async function R(z){const O=new FormData;O.append("imageUrl",z);const G=await(await fetch("/spice/image?upload_source=20020003&aid=1231&device_platform=web&need_cover_url=1",{method:"POST",credentials:"include",body:O})).json(),H=G&&G.data;if(!G||G.code!==0||!H||!H.image_uri)throw Error((G&&G.message||"封面图生成失败")+(G&&G.code!=null?"（接口 code "+G.code+"）":""));return{uri:H.image_uri,url:H.image_url,width:H.image_width,height:H.image_height}}const Z=document.createElement("div");Z.innerHTML=L.content;const q=Array.prototype.slice.call(Z.querySelectorAll("img"));let X=null;for(const z of q){const O=z.getAttribute("src")||"";if(!O){z.remove();continue}let M;try{M=await Y(O,20020002)}catch(F){V.push({src:O.slice(0,120),error:String(F&&F.message||F)});z.remove();continue}D.push({src:O.slice(0,120),url:M.url});if(!X)X=M;const G=document.createElement("div");G.className="pgc-img";const H=document.createElement("img");H.setAttribute("src",M.url);H.setAttribute("class","");H.setAttribute("image_type","");H.setAttribute("mime_type","");H.setAttribute("web_uri",M.uri);H.setAttribute("img_width",String(M.width));H.setAttribute("img_height",String(M.height));const Q=document.createElement("p");Q.className="pgc-img-caption";G.appendChild(H);G.appendChild(Q);(z.parentElement||Z).replaceChild(G,z)}const y=Z.innerHTML,U=[];let $=null,T="";if(B.cover&&String(B.cover).trim())try{$=await Y(String(B.cover),20020002)}catch(z){return{ok:!1,stage:"cover",message:"封面图转存失败："+String(z&&z.message||z),uploaded:D,failed:V}}else if(X){$=X;T=X.uri}if($){let z;try{z=await R($.url)}catch(M){return{ok:!1,stage:"cover",message:"封面图生成失败："+String(M&&M.message||M),uploaded:D,failed:V}}const O={url:z.url,uri:z.uri,width:z.width,height:z.height,thumb_width:z.width,thumb_height:z.height,natural_width:$.width,natural_height:$.height,back_up_url:$.url,need_check:!1,paste:!1,auto_upload:!1,show_optimize_icon:!1,ic:!1,id:0,pos:0};if(T)O.extra={from_content:"1",from_content_uri:T};U.push(O)}await fetch("https://mp.toutiao.com/profile_v4/graphic/publish",{credentials:"include"});function b(){const z=document.cookie.match(/passport_csrf_token=([^;]+)/);return z?z[1]:""}const _=b(),S=new URLSearchParams({title:L.title,article_ad_type:"2",article_type:"0",from_diagnosis:"0",origin_debut_check_pgc_normal:"0",tree_plan_article:"0",save:"1",pgc_id:"0",content:y,pgc_feed_covers:JSON.stringify(U)}),h={"Content-Type":"application/x-www-form-urlencoded"};if(_)h["X-CSRFToken"]=_;const P=await fetch("https://mp.toutiao.com/mp/agw/article/publish?source=mp&type=article&aid=1231",{method:"POST",credentials:"include",headers:h,body:S});let K=null;try{K=await P.json()}catch(z){}const E=K&&(K.code===0||K.err_no===0),N=K&&K.data&&K.data.pgc_id;if(!E||!N||String(N)==="0"){let z=K&&(K.message||K.reason)||"头条号发布失败";if(K&&(K.code===7112||K.err_no===7112))z+="（code 7112「图片URI异常」：正文图或封面图不是头条编辑器图床里的资源。"+"若本次有图片转存失败（见 failed 列表），先解决那张图再发）";if(K&&(K.code===7050||K.err_no===7050))z+="（code 7050「保存失败」：内容可能被风控拦截或账号被平台限制发文，"+"请登录 mp.toutiao.com 查看站内通知）";return{ok:!1,stage:"publish",status:P.status,message:z,detail:K,uploaded:D,failed:V}}const C="https://www.toutiao.com/article/"+String(N)+"/";return{ok:!0,id:String(N),url:C,editUrl:"https://mp.toutiao.com/profile_v4/graphic/publish?pgc_id="+String(N),draft:!1,uploaded:D,failed:V}},checkAuth:async(L)=>{try{const B=await(await fetch("https://mp.toutiao.com/mp/agw/media/get_media_info",{credentials:"include"})).json(),D=B&&B.data&&B.data.user;if(B&&B.code===0&&D&&D.id)return{isAuthenticated:!0,userId:String(D.id),username:D.screen_name||D.name||"",avatar:D.https_avatar_url||D.avatar_url||""};return{isAuthenticated:!1}}catch(J){return{isAuthenticated:!1,error:String(J&&J.message||J)}}}};j({site:"toutiao",name:"article",access:"write",description:"正式发布头条号图文文章（会立即公开，头条无可靠的存草稿接口，故不支持草稿）。正文默认 Markdown，图片自动转存到头条图床。标题需 2~30 字；封面可选（--cover，不传则头条自动从正文图选封面）。",domain:"mp.toutiao.com",strategy:k.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题（2~30 字）"},{name:"text",positional:!0,help:"文章正文（默认 Markdown；传 --html 则视为原始 HTML）"},{name:"file",help:"正文文件路径（UTF-8，默认 Markdown）"},{name:"html",type:"boolean",help:"将正文视为原始 HTML 而非 Markdown"},{name:"cover",help:"封面图 URL 或本机路径（可选；会先转存到头条图床）"},{name:"execute",type:"boolean",help:"真正执行写操作。不加此参数时命令拒绝写入。"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(L,J)=>{if(!L)throw new v("头条号文章发布需要浏览器会话");p(J);const B=String(J.title??"").trim();if(!B)throw new W("INVALID_INPUT","文章标题不能为空");if(B.length<2||B.length>30)throw new W("INVALID_INPUT",`头条号标题需 2~30 字，当前 ${B.length} 字`);const D=await m(J),Y={cover:typeof J.cover==="string"?J.cover.trim():""},R=await w(L,{title:B,body:D,format:J.html?"html":"markdown",profile:toutiaoProfile,publishParams:Y}),Z=R.images.uploaded.length|0,q=R.images.failed.length|0;let X="已正式发布头条号文章";if(Z||q)X+=`（图片：${Z} 张已转存${q?`，${q} 张失败`:""}）`;return u(X,"article","","created",{created_target:"article:"+R.id,created_url:R.url})}});
+import{CliError as m,CommandExecutionError as D}from"@jackwener/opencli/errors";import{cli as j,Strategy as V}from"@jackwener/opencli/registry";import{publishArticle as F}from"../_shared/article/publish.js";import{readFile as M,stat as O}from"node:fs/promises";function R(c){if(!c.execute)throw new m("INVALID_INPUT","此头条号写操作需要 --execute 参数才能真正发布。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}async function H(c){const a=typeof c.text==="string"?c.text:void 0,t=typeof c.file==="string"?c.file:void 0;if(a&&t)throw new m("INVALID_INPUT","正文和 --file 只能选一个");let i=a??"";if(t){let d;try{d=await O(t)}catch{throw new m("INVALID_INPUT",`找不到文件: ${t}`)}if(!d.isFile())throw new m("INVALID_INPUT",`--file 必须是可读文本文件: ${t}`);let p;try{p=await M(t)}catch{throw new m("INVALID_INPUT",`文件无法读取: ${t}`)}try{i=new TextDecoder("utf-8",{fatal:!0}).decode(p)}catch{throw new m("INVALID_INPUT",`文件必须是 UTF-8 编码: ${t}`)}}if(!i.trim())throw new m("INVALID_INPUT","正文不能为空");return i}function q(c,a,t,i,d={}){return[{status:"success",outcome:i,message:c,target_type:a,target:t,...d}]}export const toutiaoProfile={home:"https://mp.toutiao.com/profile_v3/graphic/publish",outputFormat:"html",preprocessConfig:{},publish:async(c,a)=>{const t=c.params||{},i=[],d=[];async function p(e,l){const s="/spice/image?upload_source="+l+"&need_enhance=true&aid=1231&device_platform=web",r=new FormData;let o;if(/^https?:/i.test(e)){r.append("imageUrl",e);o=await fetch(s+"&scene=paste",{method:"POST",credentials:"include",body:r})}else{const w=await fetch(e,{credentials:"omit"});if(!w.ok)throw Error("图片下载失败 HTTP "+w.status+"："+e.slice(0,80));const P=await w.blob(),k=((P.type||"").split("/")[1]||"jpg").split("+")[0].split(";")[0]||"jpg";r.append("image",P,"image."+k);o=await fetch(s,{method:"POST",credentials:"include",body:r})}const u=await o.json(),_=u&&u.data;if(!u||u.code!==0||!_||!_.image_uri)throw Error((u&&u.message||"图片上传失败")+(u&&u.code!=null?"（接口 code "+u.code+"）":""));return{uri:_.image_uri,url:_.image_url,width:_.image_width,height:_.image_height}}async function y(e){const l=new FormData;l.append("imageUrl",e);const r=await(await fetch("/spice/image?upload_source=20020003&aid=1231&device_platform=web&need_cover_url=1",{method:"POST",credentials:"include",body:l})).json(),o=r&&r.data;if(!r||r.code!==0||!o||!o.image_uri)throw Error((r&&r.message||"封面图生成失败")+(r&&r.code!=null?"（接口 code "+r.code+"）":""));return{uri:o.image_uri,url:o.image_url,width:o.image_width,height:o.image_height}}const g=document.createElement("div");g.innerHTML=c.content;const b=Array.prototype.slice.call(g.querySelectorAll("img"));let h=null;for(const e of b){const l=e.getAttribute("src")||"";if(!l){e.remove();continue}let s;try{s=await p(l,20020002)}catch(w){d.push({src:l.slice(0,120),error:String(w&&w.message||w)});e.remove();continue}i.push({src:l.slice(0,120),url:s.url});if(!h)h=s;const r=document.createElement("div");r.className="pgc-img";const o=document.createElement("img");o.setAttribute("src",s.url);o.setAttribute("class","");o.setAttribute("image_type","");o.setAttribute("mime_type","");o.setAttribute("web_uri",s.uri);o.setAttribute("img_width",String(s.width));o.setAttribute("img_height",String(s.height));const u=document.createElement("p");u.className="pgc-img-caption";r.appendChild(o);r.appendChild(u);(e.parentElement||g).replaceChild(r,e)}const U=g.innerHTML,T=[];let f=null,I="";if(t.cover&&String(t.cover).trim())try{f=await p(String(t.cover),20020002)}catch(e){return{ok:!1,stage:"cover",message:"封面图转存失败："+String(e&&e.message||e),uploaded:i,failed:d}}else if(h){f=h;I=h.uri}if(f){let e;try{e=await y(f.url)}catch(s){return{ok:!1,stage:"cover",message:"封面图生成失败："+String(s&&s.message||s),uploaded:i,failed:d}}const l={url:e.url,uri:e.uri,width:e.width,height:e.height,thumb_width:e.width,thumb_height:e.height,natural_width:f.width,natural_height:f.height,back_up_url:f.url,need_check:!1,paste:!1,auto_upload:!1,show_optimize_icon:!1,ic:!1,id:0,pos:0};if(I)l.extra={from_content:"1",from_content_uri:I};T.push(l)}await fetch("https://mp.toutiao.com/profile_v4/graphic/publish",{credentials:"include"});function x(){const e=document.cookie.match(/passport_csrf_token=([^;]+)/);return e?e[1]:""}const S=x(),L=new URLSearchParams({title:c.title,article_ad_type:"2",article_type:"0",from_diagnosis:"0",origin_debut_check_pgc_normal:"0",tree_plan_article:"0",save:"1",pgc_id:"0",content:U,pgc_feed_covers:JSON.stringify(T)}),A={"Content-Type":"application/x-www-form-urlencoded"};if(S)A["X-CSRFToken"]=S;const N=await fetch("https://mp.toutiao.com/mp/agw/article/publish?source=mp&type=article&aid=1231",{method:"POST",credentials:"include",headers:A,body:L});let n=null;try{n=await N.json()}catch(e){}const C=n&&(n.code===0||n.err_no===0),v=n&&n.data&&n.data.pgc_id;if(!C||!v||String(v)==="0"){let e=n&&(n.message||n.reason)||"头条号发布失败";if(n&&(n.code===7112||n.err_no===7112))e+="（code 7112「图片URI异常」：正文图或封面图不是头条编辑器图床里的资源。"+"若本次有图片转存失败（见 failed 列表），先解决那张图再发）";if(n&&(n.code===7050||n.err_no===7050))e+="（code 7050「保存失败」：内容可能被风控拦截或账号被平台限制发文，"+"请登录 mp.toutiao.com 查看站内通知）";return{ok:!1,stage:"publish",status:N.status,message:e,detail:n,uploaded:i,failed:d}}const E="https://www.toutiao.com/article/"+String(v)+"/";return{ok:!0,id:String(v),url:E,editUrl:"https://mp.toutiao.com/profile_v4/graphic/publish?pgc_id="+String(v),draft:!1,uploaded:i,failed:d}},checkAuth:async(c)=>{try{const t=await(await fetch("https://mp.toutiao.com/mp/agw/media/get_media_info",{credentials:"include"})).json(),i=t&&t.data&&t.data.user;if(t&&t.code===0&&i&&i.id)return{isAuthenticated:!0,userId:String(i.id),username:i.screen_name||i.name||"",avatar:i.https_avatar_url||i.avatar_url||""};return{isAuthenticated:!1}}catch(a){return{isAuthenticated:!1,error:String(a&&a.message||a)}}}};j({site:"toutiao",name:"article",access:"write",description:"正式发布头条号图文文章（会立即公开，头条无可靠的存草稿接口，故不支持草稿）。正文默认 Markdown，图片自动转存到头条图床。标题需 2~30 字；封面可选（--cover，不传则头条自动从正文图选封面）。",domain:"mp.toutiao.com",strategy:V.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题（2~30 字）"},{name:"text",positional:!0,help:"文章正文（默认 Markdown；传 --html 则视为原始 HTML）"},{name:"file",help:"正文文件路径（UTF-8，默认 Markdown）"},{name:"html",type:"boolean",help:"将正文视为原始 HTML 而非 Markdown"},{name:"cover",help:"封面图 URL 或本机路径（可选；会先转存到头条图床）"},{name:"execute",type:"boolean",help:"真正执行写操作。不加此参数时命令拒绝写入。"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(c,a)=>{if(!c)throw new D("头条号文章发布需要浏览器会话");R(a);const t=String(a.title??"").trim();if(!t)throw new m("INVALID_INPUT","文章标题不能为空");if(t.length<2||t.length>30)throw new m("INVALID_INPUT",`头条号标题需 2~30 字，当前 ${t.length} 字`);const i=await H(a),p={cover:typeof a.cover==="string"?a.cover.trim():""},y=await F(c,{title:t,body:i,format:a.html?"html":"markdown",profile:toutiaoProfile,publishParams:p}),g=y.images.uploaded.length|0,b=y.images.failed.length|0;let h="已正式发布头条号文章";if(g||b)h+=`（图片：${g} 张已转存${b?`，${b} 张失败`:""}）`;return q(h,"article","","created",{created_target:"article:"+y.id,created_url:y.url})}});

package/clis/toutiao/articles.js

@@ -1,4 +1,4 @@
-import{cli as L,Strategy as M}from"@jackwener/opencli/registry";import{AuthRequiredError as N,CommandExecutionError as O,EmptyResultError as Q}from"@jackwener/opencli/errors";import{looksToutiaoAuthWallUrl as V,parseArticlesPage as H,parseToutiaoArticlesText}from"./utils.js";L({site:"toutiao",name:"articles",access:"read",description:"获取头条号创作者后台文章列表及数据",domain:"mp.toutiao.com",strategy:M.COOKIE,browser:!0,args:[{name:"page",type:"int",default:1,help:"页码 (1-4)"}],columns:["title","date","status","展现","阅读","点赞","评论"],func:async(z,I)=>{const B=H(I.page,1);let v;try{await z.goto(`https://mp.toutiao.com/profile_v4/manage/content/all?page=${B}`);await z.wait("networkidle");await z.wait(3);v=await z.evaluate(`
+import{cli as l,Strategy as m}from"@jackwener/opencli/registry";import{AuthRequiredError as d,CommandExecutionError as p,EmptyResultError as h}from"@jackwener/opencli/errors";import{looksToutiaoAuthWallUrl as f,parseArticlesPage as s,parseToutiaoArticlesText}from"./utils.js";l({site:"toutiao",name:"articles",access:"read",description:"获取头条号创作者后台文章列表及数据",domain:"mp.toutiao.com",strategy:m.COOKIE,browser:!0,args:[{name:"page",type:"int",default:1,help:"页码 (1-4)"}],columns:["title","date","status","展现","阅读","点赞","评论"],func:async(e,n)=>{const a=s(n.page,1);let t;try{await e.goto(`https://mp.toutiao.com/profile_v4/manage/content/all?page=${a}`);await e.wait("networkidle");await e.wait(3);t=await e.evaluate(`
 (async () => {
     await new Promise(r => setTimeout(r, 2000));
     var href = ''; try { href = location.href; } catch (e) {}
@@ -12,4 +12,4 @@ import{cli as L,Strategy as M}from"@jackwener/opencli/registry";import{AuthRequi
     } catch (e) {}
     return { href: href, text: document.body.innerText || '', authed: authed };
 })()
-`)}catch(G){throw new O(`toutiao articles render failed: ${G?.message||G}`)}const J=typeof v==="string"?v:v?.text||"",K=typeof v==="string"?"":v?.href||"",D=typeof v==="string"?null:v?.authed??null;if(V(K)||D===!1)throw new N("mp.toutiao.com","Toutiao creator articles require a logged-in mp.toutiao.com browser session");const F=parseToutiaoArticlesText(J);if(F.length===0)throw new Q("toutiao articles",D===!0?`账号登录态已通过接口确认有效，但未抓取到创作者后台文章 (page=${B})：该页可能确实没有文章，或页面尚未渲染完成。这不是登录问题，不要据此判断会话失效。`:`未抓取到创作者后台文章 (page=${B})。可能页面尚未完成渲染或无文章。`);return F}});export{parseToutiaoArticlesText};export const __test__={parseToutiaoArticlesText,parseArticlesPage:H};
+`)}catch(i){throw new p(`toutiao articles render failed: ${i?.message||i}`)}const u=typeof t==="string"?t:t?.text||"",c=typeof t==="string"?"":t?.href||"",o=typeof t==="string"?null:t?.authed??null;if(f(c)||o===!1)throw new d("mp.toutiao.com","Toutiao creator articles require a logged-in mp.toutiao.com browser session");const r=parseToutiaoArticlesText(u);if(r.length===0)throw new h("toutiao articles",o===!0?`账号登录态已通过接口确认有效，但未抓取到创作者后台文章 (page=${a})：该页可能确实没有文章，或页面尚未渲染完成。这不是登录问题，不要据此判断会话失效。`:`未抓取到创作者后台文章 (page=${a})。可能页面尚未完成渲染或无文章。`);return r}});export{parseToutiaoArticlesText};export const __test__={parseToutiaoArticlesText,parseArticlesPage:s};

package/clis/toutiao/auth.js

@@ -1,4 +1,4 @@
-import{AuthRequiredError as D,CommandExecutionError as J}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as K}from"../_shared/site-auth.js";async function F(z){return(await z.getCookies({url:"https://mp.toutiao.com"})).some((G)=>G.name==="sessionid"&&G.value)}async function H(z){if(!await F(z))throw new D("toutiao.com","Toutiao sessionid cookie missing");await z.goto("https://mp.toutiao.com/");await z.wait(2);const B=await z.evaluate(`
+import{AuthRequiredError as t,CommandExecutionError as a}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as u}from"../_shared/site-auth.js";async function i(e){return(await e.getCookies({url:"https://mp.toutiao.com"})).some((n)=>n.name==="sessionid"&&n.value)}async function s(e){if(!await i(e))throw new t("toutiao.com","Toutiao sessionid cookie missing");await e.goto("https://mp.toutiao.com/");await e.wait(2);const o=await e.evaluate(`
     (async () => {
       if (/\\/auth\\/page\\/login/.test(location.href)) {
         return { kind: 'auth', detail: 'mp.toutiao.com redirected to /auth/page/login — anonymous' };
@@ -47,4 +47,4 @@ import{AuthRequiredError as D,CommandExecutionError as J}from"@jackwener/opencli
       }
       return { ok: true, user_id: userId, nickname };
     })()
-  `);if(B?.kind==="auth"||B?.kind==="maybe-auth")throw new D("toutiao.com",B.detail);if(!B?.ok)throw new J(`Unexpected Toutiao probe: ${JSON.stringify(B)}`);return{user_id:B.user_id,nickname:B.nickname}}K({site:"toutiao",domain:"toutiao.com",loginUrl:"https://mp.toutiao.com/auth/page/login",columns:["user_id","nickname"],quickCheck:F,verify:H,poll:async(z)=>{if(!await F(z))throw new D("toutiao.com","Waiting for Toutiao sessionid cookie");return H(z)}});
+  `);if(o?.kind==="auth"||o?.kind==="maybe-auth")throw new t("toutiao.com",o.detail);if(!o?.ok)throw new a(`Unexpected Toutiao probe: ${JSON.stringify(o)}`);return{user_id:o.user_id,nickname:o.nickname}}u({site:"toutiao",domain:"toutiao.com",loginUrl:"https://mp.toutiao.com/auth/page/login",columns:["user_id","nickname"],quickCheck:i,verify:s,poll:async(e)=>{if(!await i(e))throw new t("toutiao.com","Waiting for Toutiao sessionid cookie");return s(e)}});

package/clis/toutiao/hot.js

@@ -1 +1 @@
-import{cli as M,Strategy as P}from"@jackwener/opencli/registry";import{CommandExecutionError as z,EmptyResultError as Q}from"@jackwener/opencli/errors";import{HOT_BOARD_URL as V,mapHotRow as W,parseHotLimit as X}from"./utils.js";M({site:"toutiao",name:"hot",access:"read",description:"今日头条首页热榜（公开 API，无需登录）",domain:"www.toutiao.com",strategy:P.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:30,help:"返回条数 (1-50)"}],columns:["rank","group_id","title","query","hot_value","label","url","image_url"],func:async(I)=>{const J=X(I?.limit,30);let F;try{F=await fetch(V,{headers:{"User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",Accept:"application/json",Referer:"https://www.toutiao.com/"}})}catch(q){throw new z(`toutiao hot-board request failed: ${q?.message||q}`)}if(!F.ok)throw new z(`toutiao hot-board failed: HTTP ${F.status}`);let b;try{b=await F.json()}catch(q){throw new z(`toutiao hot-board returned malformed JSON: ${q?.message||q}`)}if(b?.status&&b.status!=="success")throw new z(`toutiao hot-board returned status=${b.status}`);if(b?.error||b?.message)throw new z(`toutiao hot-board returned error: ${b.error||b.message}`);const G=(Array.isArray(b?.data)?b.data:[]).map(W).filter(Boolean).slice(0,J);if(G.length===0)throw new Q("toutiao hot","上游 hot-board 返回空列表。");return G.map((q,K)=>({...q,rank:K+1}))}});
+import{cli as n,Strategy as m}from"@jackwener/opencli/registry";import{CommandExecutionError as r,EmptyResultError as u}from"@jackwener/opencli/errors";import{HOT_BOARD_URL as c,mapHotRow as h,parseHotLimit as w}from"./utils.js";n({site:"toutiao",name:"hot",access:"read",description:"今日头条首页热榜（公开 API，无需登录）",domain:"www.toutiao.com",strategy:m.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:30,help:"返回条数 (1-50)"}],columns:["rank","group_id","title","query","hot_value","label","url","image_url"],func:async(i)=>{const s=w(i?.limit,30);let e;try{e=await fetch(c,{headers:{"User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",Accept:"application/json",Referer:"https://www.toutiao.com/"}})}catch(o){throw new r(`toutiao hot-board request failed: ${o?.message||o}`)}if(!e.ok)throw new r(`toutiao hot-board failed: HTTP ${e.status}`);let t;try{t=await e.json()}catch(o){throw new r(`toutiao hot-board returned malformed JSON: ${o?.message||o}`)}if(t?.status&&t.status!=="success")throw new r(`toutiao hot-board returned status=${t.status}`);if(t?.error||t?.message)throw new r(`toutiao hot-board returned error: ${t.error||t.message}`);const a=(Array.isArray(t?.data)?t.data:[]).map(h).filter(Boolean).slice(0,s);if(a.length===0)throw new u("toutiao hot","上游 hot-board 返回空列表。");return a.map((o,l)=>({...o,rank:l+1}))}});

package/clis/toutiao/recommend.js

@@ -1 +1 @@
-import{cli as V,Strategy as W}from"@jackwener/opencli/registry";import{CommandExecutionError as z,EmptyResultError as X}from"@jackwener/opencli/errors";import{RECOMMEND_CATEGORIES as Y,RECOMMEND_URL as Z,mapRecommendRow as $,parseRecommendCategory as h,parseRecommendLimit as v}from"./utils.js";V({site:"toutiao",name:"recommend",access:"read",description:"今日头条频道推荐流（公开 API，无需登录）",domain:"www.toutiao.com",strategy:W.PUBLIC,browser:!1,args:[{name:"category",type:"string",default:"__all__",help:`频道 (${Y.join(", ")})`},{name:"limit",type:"int",default:20,help:"返回条数 (1-50)"}],columns:["rank","group_id","title","abstract","source","tag","comments","published_at","url","image_url"],func:async(F)=>{const H=h(F?.category,"__all__"),K=v(F?.limit,20),P=`${Z}?category=${encodeURIComponent(H)}`;let B;try{B=await fetch(P,{headers:{"User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",Accept:"application/json",Referer:"https://www.toutiao.com/"}})}catch(b){throw new z(`toutiao recommend request failed: ${b?.message||b}`)}if(!B.ok)throw new z(`toutiao recommend failed: HTTP ${B.status}`);let q;try{q=await B.json()}catch(b){throw new z(`toutiao recommend returned malformed JSON: ${b?.message||b}`)}if(q?.message&&q.message!=="success")throw new z(`toutiao recommend returned message=${q.message}`);if(!Array.isArray(q?.data))throw new z("toutiao recommend returned a non-array data field");const J=q.data.map($).filter(Boolean).slice(0,K);if(J.length===0)throw new X("toutiao recommend",`频道 ${H} 返回空列表。`);return J.map((b,Q)=>({...b,rank:Q+1}))}});
+import{cli as l,Strategy as d}from"@jackwener/opencli/registry";import{CommandExecutionError as o,EmptyResultError as u}from"@jackwener/opencli/errors";import{RECOMMEND_CATEGORIES as p,RECOMMEND_URL as w,mapRecommendRow as f,parseRecommendCategory as g,parseRecommendLimit as h}from"./utils.js";l({site:"toutiao",name:"recommend",access:"read",description:"今日头条频道推荐流（公开 API，无需登录）",domain:"www.toutiao.com",strategy:d.PUBLIC,browser:!1,args:[{name:"category",type:"string",default:"__all__",help:`频道 (${p.join(", ")})`},{name:"limit",type:"int",default:20,help:"返回条数 (1-50)"}],columns:["rank","group_id","title","abstract","source","tag","comments","published_at","url","image_url"],func:async(a)=>{const m=g(a?.category,"__all__"),i=h(a?.limit,20),s=`${w}?category=${encodeURIComponent(m)}`;let r;try{r=await fetch(s,{headers:{"User-Agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",Accept:"application/json",Referer:"https://www.toutiao.com/"}})}catch(e){throw new o(`toutiao recommend request failed: ${e?.message||e}`)}if(!r.ok)throw new o(`toutiao recommend failed: HTTP ${r.status}`);let t;try{t=await r.json()}catch(e){throw new o(`toutiao recommend returned malformed JSON: ${e?.message||e}`)}if(t?.message&&t.message!=="success")throw new o(`toutiao recommend returned message=${t.message}`);if(!Array.isArray(t?.data))throw new o("toutiao recommend returned a non-array data field");const n=t.data.map(f).filter(Boolean).slice(0,i);if(n.length===0)throw new u("toutiao recommend",`频道 ${m} 返回空列表。`);return n.map((e,c)=>({...e,rank:c+1}))}});