publishport-opencli 1.0.29 → 1.0.30

package/cli-manifest.json

@@ -14340,6 +14340,190 @@
     "sourceFile": "douyin/collections.js",
     "navigateBefore": "https://creator.douyin.com"
   },
+  {
+    "site": "douyin",
+    "name": "comment",
+    "description": "发表评论或回复主评论/楼中楼；默认只读预检，--execute 才提交一次并回查",
+    "access": "write",
+    "domain": "www.douyin.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "aweme_id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "作品 ID 或完整链接"
+      },
+      {
+        "name": "text",
+        "type": "str",
+        "required": false,
+        "positional": true,
+        "help": "字面评论内容，最多 500 个 UTF-16 字符；支持 --file",
+        "fromFile": true,
+        "requiredUnlessFile": true
+      },
+      {
+        "name": "parent",
+        "type": "string",
+        "required": false,
+        "help": "回复主评论时传其 cid"
+      },
+      {
+        "name": "reply-to",
+        "type": "string",
+        "required": false,
+        "help": "回复楼中楼的 cid，必须同时传 --parent"
+      },
+      {
+        "name": "cursor",
+        "type": "string",
+        "default": "0",
+        "required": false,
+        "help": "被回复的楼中楼所在页 cursor（来自 replies 输出）"
+      },
+      {
+        "name": "execute",
+        "type": "boolean",
+        "required": false,
+        "help": "实际提交一次；默认仅验证账号、目标和原生提交入口"
+      },
+      {
+        "name": "file",
+        "type": "str",
+        "required": false,
+        "help": "从本机文件读取text（UTF-8），与 <text> 二选一。长正文建议走文件：命令行上只剩短参数，不受 shell 引号 / 换行 / 编码影响",
+        "generatedFileFor": "text"
+      }
+    ],
+    "columns": [
+      "aweme_id",
+      "cid",
+      "text",
+      "parent_id",
+      "reply_to_id",
+      "status"
+    ],
+    "type": "js",
+    "modulePath": "douyin/comment.js",
+    "sourceFile": "douyin/comment.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "douyin",
+    "name": "comment-like",
+    "description": "点赞/取消点赞主评论或楼中楼；默认只读预检，--execute 才提交并回查",
+    "access": "write",
+    "domain": "www.douyin.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "aweme_id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "作品 ID 或完整链接"
+      },
+      {
+        "name": "cid",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "目标评论 ID"
+      },
+      {
+        "name": "parent",
+        "type": "string",
+        "required": false,
+        "help": "目标为楼中楼时，传主评论 ID"
+      },
+      {
+        "name": "cursor",
+        "type": "string",
+        "default": "0",
+        "required": false,
+        "help": "楼中楼所在页的 cursor（来自 replies 输出）"
+      },
+      {
+        "name": "undo",
+        "type": "boolean",
+        "required": false,
+        "help": "取消点赞"
+      },
+      {
+        "name": "execute",
+        "type": "boolean",
+        "required": false,
+        "help": "实际提交一次，随后回查点赞状态"
+      }
+    ],
+    "columns": [
+      "aweme_id",
+      "cid",
+      "parent_id",
+      "liked",
+      "status"
+    ],
+    "type": "js",
+    "modulePath": "douyin/comment-like.js",
+    "sourceFile": "douyin/comment-like.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "douyin",
+    "name": "comments",
+    "description": "查看作品评论、点赞状态及回复数；使用 next_cursor 翻页",
+    "access": "read",
+    "domain": "www.douyin.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "aweme_id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "作品 ID 或抖音作品完整链接"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "每页数量，1–20"
+      },
+      {
+        "name": "cursor",
+        "type": "string",
+        "default": "0",
+        "required": false,
+        "help": "上一页 next_cursor，首次为 0"
+      }
+    ],
+    "columns": [
+      "cid",
+      "aweme_id",
+      "text",
+      "nickname",
+      "uid",
+      "digg_count",
+      "liked",
+      "reply_count",
+      "parent_id",
+      "reply_to_id",
+      "create_time",
+      "cursor",
+      "next_cursor",
+      "has_more"
+    ],
+    "type": "js",
+    "modulePath": "douyin/comments.js",
+    "sourceFile": "douyin/comments.js",
+    "navigateBefore": false
+  },
   {
     "site": "douyin",
     "name": "delete",
@@ -15157,6 +15341,65 @@
     "navigateBefore": false,
     "defaultWindowMode": "foreground"
   },
+  {
+    "site": "douyin",
+    "name": "replies",
+    "description": "查看主评论下的楼中楼，含回复目标 ID；使用 next_cursor 翻页",
+    "access": "read",
+    "domain": "www.douyin.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "aweme_id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "作品 ID 或抖音作品完整链接"
+      },
+      {
+        "name": "cid",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "主评论 ID（comments 输出的 cid）"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "每页数量，1–20"
+      },
+      {
+        "name": "cursor",
+        "type": "string",
+        "default": "0",
+        "required": false,
+        "help": "上一页 next_cursor，首次为 0"
+      }
+    ],
+    "columns": [
+      "cid",
+      "aweme_id",
+      "text",
+      "nickname",
+      "uid",
+      "digg_count",
+      "liked",
+      "reply_count",
+      "parent_id",
+      "reply_to_id",
+      "create_time",
+      "cursor",
+      "next_cursor",
+      "has_more"
+    ],
+    "type": "js",
+    "modulePath": "douyin/comments.js",
+    "sourceFile": "douyin/comments.js",
+    "navigateBefore": false
+  },
   {
     "site": "douyin",
     "name": "search",
@@ -51255,6 +51498,120 @@
     "sourceFile": "xiaohongshu/collections.js",
     "navigateBefore": false
   },
+  {
+    "site": "xiaohongshu",
+    "name": "comment",
+    "description": "发布小红书评论或定向回复；默认验证草稿，--execute 才发送",
+    "access": "write",
+    "domain": "www.xiaohongshu.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "note-id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Full signed note URL with xsec_token"
+      },
+      {
+        "name": "text",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Exact plain-text comment"
+      },
+      {
+        "name": "reply-to",
+        "type": "str",
+        "required": false,
+        "help": "Exact comment ID to reply to, including a nested reply"
+      },
+      {
+        "name": "root-id",
+        "type": "str",
+        "required": false,
+        "help": "Top-level root_id from comments; use when targeting a nested reply"
+      },
+      {
+        "name": "execute",
+        "type": "boolean",
+        "default": false,
+        "required": false,
+        "help": "Submit after verification (default: dry-run only)"
+      }
+    ],
+    "columns": [
+      "status",
+      "note_id",
+      "id",
+      "root_id",
+      "parent_id",
+      "text",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "xiaohongshu/comment.js",
+    "sourceFile": "xiaohongshu/comment.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "xiaohongshu",
+    "name": "comment-like",
+    "description": "点赞/取消点赞小红书评论（含楼中楼）；默认 dry-run，--execute 才操作",
+    "access": "write",
+    "domain": "www.xiaohongshu.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "note-id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Full signed note URL with xsec_token"
+      },
+      {
+        "name": "comment-id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Exact comment ID from comments/replies"
+      },
+      {
+        "name": "undo",
+        "type": "boolean",
+        "default": false,
+        "required": false,
+        "help": "Ensure the comment is not liked"
+      },
+      {
+        "name": "root-id",
+        "type": "str",
+        "required": false,
+        "help": "Top-level root_id from comments; use when targeting a nested reply"
+      },
+      {
+        "name": "execute",
+        "type": "boolean",
+        "default": false,
+        "required": false,
+        "help": "Submit after verification (default: dry-run only)"
+      }
+    ],
+    "columns": [
+      "status",
+      "note_id",
+      "id",
+      "root_id",
+      "liked",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "xiaohongshu/comment-like.js",
+    "sourceFile": "xiaohongshu/comment-like.js",
+    "navigateBefore": false
+  },
   {
     "site": "xiaohongshu",
     "name": "comments",
@@ -51288,14 +51645,20 @@
     ],
     "columns": [
       "rank",
+      "id",
+      "root_id",
+      "parent_id",
       "author",
       "userId",
       "profileUrl",
       "text",
       "likes",
+      "liked",
       "time",
       "is_reply",
       "reply_to",
+      "reply_count",
+      "replies_complete",
       "images"
     ],
     "type": "js",
@@ -52307,6 +52670,107 @@
     "sourceFile": "xiaohongshu/publish-video.js",
     "navigateBefore": false
   },
+  {
+    "site": "xiaohongshu",
+    "name": "replies",
+    "description": "读取指定主评论下的楼中楼，返回精确回复关系与加载完整性",
+    "access": "read",
+    "domain": "www.xiaohongshu.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "note-id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Full signed note URL with xsec_token"
+      },
+      {
+        "name": "root-id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Top-level comment ID from comments"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 50,
+        "required": false,
+        "help": "Maximum nested replies to return (1-200)"
+      }
+    ],
+    "columns": [
+      "id",
+      "reply_count",
+      "returned",
+      "complete",
+      "replies"
+    ],
+    "type": "js",
+    "modulePath": "xiaohongshu/replies.js",
+    "sourceFile": "xiaohongshu/replies.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "xiaohongshu",
+    "name": "reply",
+    "description": "回复指定小红书评论（含楼中楼）；默认 dry-run，--execute 才发送",
+    "access": "write",
+    "domain": "www.xiaohongshu.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "note-id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Full signed note URL with xsec_token"
+      },
+      {
+        "name": "comment-id",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Exact comment ID from comments/replies"
+      },
+      {
+        "name": "text",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Exact plain-text reply"
+      },
+      {
+        "name": "root-id",
+        "type": "str",
+        "required": false,
+        "help": "Top-level root_id from comments; use when targeting a nested reply"
+      },
+      {
+        "name": "execute",
+        "type": "boolean",
+        "default": false,
+        "required": false,
+        "help": "Submit after verification (default: dry-run only)"
+      }
+    ],
+    "columns": [
+      "status",
+      "note_id",
+      "id",
+      "root_id",
+      "parent_id",
+      "text",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "xiaohongshu/reply.js",
+    "sourceFile": "xiaohongshu/reply.js",
+    "navigateBefore": false
+  },
   {
     "site": "xiaohongshu",
     "name": "saved",

package/clis/douyin/_shared/browser-fetch.js

@@ -1,28 +1,46 @@
-import{AuthRequiredError as u,CommandExecutionError as i}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as y}from"./evaluate-result.js";function f(n,t){const e=String(t??"");return n===401||n===403||/login|cookie|auth|captcha|verify|forbidden|permission|登录|登陆|权限|验证|验证码/i.test(e)}export async function browserFetch(n,t,e,s={}){const c=`
+import{AuthRequiredError as l,CommandExecutionError as n}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as u}from"./evaluate-result.js";function m(o,t){const r=String(t??"");return o===401||o===403||/login|cookie|auth|captcha|verify|forbidden|permission|登录|登陆|权限|验证|验证码/i.test(r)}export async function browserFetch(o,t,r,a={}){const c=`
     (async () => {
       const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(), ${Number(s.timeoutMs??30000)});
+      const timer = setTimeout(() => controller.abort(), ${Number(a.timeoutMs??30000)});
+      let challengeTimer;
       try {
-        const res = await fetch(${JSON.stringify(e)}, {
+        ${a.detectCaptcha?`
+        const captchaVisible = () => Array.from(document.querySelectorAll('iframe[src*="/verifycenter/captcha/"]')).some(frame => {
+          const rect = frame.getBoundingClientRect();
+          return rect.width > 0 && rect.height > 0 && getComputedStyle(frame).visibility !== 'hidden';
+        });
+        const challengeResult = { status_code: 403, status_msg: '抖音出现验证码；用 ppcli browser site:douyin captcha --adapter 截图，按图使用 captcha-click --adapter 点选并确认后再查询；不会自动重试。' };
+        if (captchaVisible()) return challengeResult;
+        const guard = new Promise(resolve => {
+          challengeTimer = setInterval(() => {
+            if (captchaVisible()) { resolve(challengeResult); controller.abort(); }
+            else if (controller.signal.aborted) resolve({ status_code: -1, status_msg: 'Douyin read request timed out' });
+          }, 200);
+        });`:""}
+        const request = (async () => {
+          const res = await fetch(${JSON.stringify(r)}, {
           method: ${JSON.stringify(t)},
-          credentials: ${JSON.stringify(s.credentials??"include")},
+          credentials: ${JSON.stringify(a.credentials??"include")},
           signal: controller.signal,
           headers: {
             'Content-Type': 'application/json',
-            ...${JSON.stringify(s.headers??{})}
+            ...${JSON.stringify(a.headers??{})}
           },
-          ${s.body?`body: JSON.stringify(${JSON.stringify(s.body)}),`:""}
+          ${a.body?`body: JSON.stringify(${JSON.stringify(a.body)}),`:""}
         });
-        const text = await res.text();
-        try {
-          return JSON.parse(text);
-        } catch (error) {
-          return { status_code: res.ok ? -2 : res.status, status_msg: \`JSON parse failed: \${text.slice(0, 500) || String(error && error.message || error)}\` };
-        }
+          const text = await res.text();
+          try {
+            return JSON.parse(text);
+          } catch (error) {
+            return { status_code: res.ok ? -2 : res.status, status_msg: \`JSON parse failed: \${text.slice(0, 500) || String(error && error.message || error)}\` };
+          }
+        })();
+        return await ${a.detectCaptcha?"Promise.race([request, guard])":"request"};
       } catch (error) {
         return { status_code: -1, status_msg: String(error && error.message || error) };
       } finally {
         clearTimeout(timer);
+        clearInterval(challengeTimer);
       }
     })()
-  `;let r;try{r=y(await n.evaluate(c))}catch(o){throw new i(`Douyin API request failed (${t} ${e}): ${o instanceof Error?o.message:String(o)}`)}if(r==null)throw new i(`Empty response from Douyin API (${t} ${e})`);if(Array.isArray(r)||typeof r!=="object")throw new i(`Malformed response from Douyin API (${t} ${e})`);if(r&&typeof r==="object"&&"status_code"in r){const o=r.status_code;if(o!==0){const a=r.status_msg??r.message??"unknown error";if(f(o,a))throw new u("creator.douyin.com",`Douyin API auth/permission error ${o} at ${t} ${e}: ${a}`);throw new i(`Douyin API error ${o} at ${t} ${e}: ${a}`)}}return r}
+  `;let e;try{e=u(await o.evaluate(c))}catch(s){throw new n(`Douyin API request failed (${t} ${r}): ${s instanceof Error?s.message:String(s)}`)}if(e==null)throw new n(`Empty response from Douyin API (${t} ${r})`);if(Array.isArray(e)||typeof e!=="object")throw new n(`Malformed response from Douyin API (${t} ${r})`);if(e&&typeof e==="object"&&"status_code"in e){const s=e.status_code;if(s!==0){const i=e.status_msg??e.message??"unknown error";if(m(s,i))throw new l(new URL(r).hostname,`Douyin API auth/permission error ${s} at ${t} ${r}: ${i}`);throw new n(`Douyin API error ${s} at ${t} ${r}: ${i}`)}}return e}

package/clis/douyin/_shared/comments.js

@@ -0,0 +1 @@
+import{ArgumentError as w,AuthRequiredError as g,CommandExecutionError as l,EmptyResultError as p}from"@jackwener/opencli/errors";import{browserFetch as y}from"./browser-fetch.js";import{requireObjectEvaluateResult as h}from"./evaluate-result.js";export function commentId(n,r="评论 ID"){if(typeof n!=="string"||!/^[1-9]\d*$/.test(n))throw new w(`${r} 必须是十进制 ID 字符串，不能经过 Number 转换`);return n}export function videoId(n){if(typeof n==="string"&&/^[1-9]\d*$/.test(n))return n;try{const r=new URL(n),o=r.pathname.match(/^\/(?:video|note)\/([1-9]\d*)\/?$/);if(r.protocol==="https:"&&["www.douyin.com","douyin.com"].includes(r.hostname)&&o)return o[1]}catch{}throw new w("作品必须是抖音作品 ID 或 https://www.douyin.com/video/<ID> 链接")}export function commentCursor(n="0"){const r=String(n);if(!/^\d+$/.test(r)||!Number.isSafeInteger(Number(r)))throw new w("--cursor 必须是非负安全整数");return r}export function commentLimit(n=20){const r=Number(n);if(!Number.isInteger(r)||r<1||r>20)throw new w("--limit 必须在 1–20 之间");return r}export async function openComments(n,r){const o=`https://www.douyin.com/video/${r}`;if(await n.evaluate("location.origin + location.pathname")!==o)await n.goto(o)}export async function readCommentPage(n,r,{parent:o,cursor:u="0",limit:s=20,insertId:d}={}){const e=new URLSearchParams({aid:"6383",cursor:u,count:String(s)});if(o){e.set("item_id",r);e.set("comment_id",o);e.set("item_type","0");e.set("cut_version","1")}else{e.set("aweme_id",r);if(d)e.set("insert_ids",d)}const i=await y(n,"GET",`https://www.douyin.com/aweme/v1/web/comment/list/${o?"reply/":""}?${e}`,{detectCaptcha:!0});if(i.status_code!==0||!Array.isArray(i.comments)||![0,1,!1,!0].includes(i.has_more)||!Number.isSafeInteger(i.cursor)||i.cursor<0)throw new l("抖音评论接口返回了不完整的数据或分页信息");const c=i.comments.map((t)=>{if(typeof t.cid!=="string"||!/^[1-9]\d*$/.test(t.cid)||t.aweme_id!==r||typeof t.text!=="string"||typeof t.reply_id!=="string"||!/^\d+$/.test(t.reply_id)||(o?t.reply_id!==o:t.reply_id!=="0")||![0,1].includes(t.user_digged)||!Number.isSafeInteger(t.digg_count)||t.digg_count<0||typeof t.user?.uid!=="string"||typeof t.user?.nickname!=="string")throw new l("抖音评论字段或所属作品/楼层发生变化，已停止处理");const a=t.reply_to_reply_id??"0";if(typeof a!=="string"||!/^\d+$/.test(a))throw new l("抖音回复目标 ID 格式异常");return{cid:t.cid,aweme_id:r,text:t.text,nickname:t.user.nickname,uid:t.user.uid,digg_count:t.digg_count,liked:t.user_digged===1,reply_count:t.reply_comment_total??null,parent_id:t.reply_id==="0"?null:t.reply_id,reply_to_id:a==="0"?null:a,create_time:t.create_time??null,cursor:u,next_cursor:String(i.cursor),has_more:Boolean(i.has_more)}});if(i.has_more&&i.cursor<=Number(u))throw new l("抖音评论分页游标未前进，已停止翻页");return{rows:c,nextCursor:String(i.cursor),hasMore:Boolean(i.has_more)}}export const COMMENT_COLUMNS=["cid","aweme_id","text","nickname","uid","digg_count","liked","reply_count","parent_id","reply_to_id","create_time","cursor","next_cursor","has_more"];export async function readTargetComment(n,r,o,{parent:u,cursor:s="0"}={}){const e=(await readCommentPage(n,r,{parent:u,cursor:s,insertId:u?void 0:o})).rows.find((i)=>i.cid===o);if(!e)throw new p("douyin comment",`当前作品/评论页没有评论 ${o}；楼中楼请传 --parent 和 replies 输出的 --cursor，不会替换为其他评论`);return e}export async function commentRuntime(n,r,o,u,s){const d=Date.now()+1e4;let e;while(Date.now()<d){if(Array.from(document.querySelectorAll('iframe[src*="/verifycenter/captcha/"]')).some((m)=>{const f=m.getBoundingClientRect();return f.width>0&&f.height>0&&getComputedStyle(m).visibility!=="hidden"}))return{error:"auth",message:"抖音出现验证码；用 ppcli browser site:douyin captcha --adapter 截图并点选确认，尚未提交"};const t=document.querySelector('[data-e2e="comment-list"]');let a=t?.[Object.keys(t).find((m)=>m.startsWith("__reactFiber"))];for(let m=0;a&&m<30;m++,a=a.return){const f=a.memoizedProps;if(f?.awemeInfo?.awemeId===n&&typeof f.puhlishCommentItem==="function"&&typeof f.diggCommentItem==="function"){e=f;break}}if(e)break;await new Promise((m)=>setTimeout(m,200))}if(!e)return{error:"runtime",message:"找不到当前作品的原生评论组件"};if(e.userInfo?.isLogin!==!0||!e.userInfo?.info?.uid)return{error:"auth",message:"抖音评论操作需要登录"};if(r==="publish"&&e.awemeInfo.awemeControl?.canComment!==!0)return{error:"runtime",message:"当前作品不允许评论或权限状态未知"};const i=String(e.userInfo.info.uid);if(s&&i!==s)return{error:"auth",message:"抖音账号在预检后已切换，已停止提交"};if(!u)return{ready:!0,uid:i};try{const c=r==="publish"?await e.puhlishCommentItem(o):await e.diggCommentItem(o),t=c?.comment;return{uid:i,status_code:c?.statusCode,status_msg:c?.statusMsg,comment:t?{cid:t.cid,text:t.text,reply_id:t.replyId,user_id:t.user?.uid}:null}}catch(c){return{error:"uncertain",message:String(c?.message??c)}}}export async function callCommentRuntime(n,r,o,u,s=!1,d){let e;try{e=h(await n.evaluate(`(${commentRuntime.toString()})(${JSON.stringify(r)},${JSON.stringify(o)},${JSON.stringify(u)},${s===!0},${JSON.stringify(d)})`),"抖音评论组件")}catch(i){throw new l(`抖音评论组件调用失败：${i.message}`,s?"提交结果未知；请先回查，不要直接重试。":"尚未提交。")}if(e.error==="auth")throw new g("www.douyin.com",e.message);if(e.error)throw new l(e.message,s?"可能已提交；请先回查，不要直接重试。":"尚未提交；页面组件需要重新适配。");if(s?e.status_code!==0:e.ready!==!0)throw new l(`抖音评论操作未成功确认：${e.status_code??"missing status"} ${e.status_msg??""}`,s?"请先回查，不要直接重试。":"尚未提交。");return e}

package/clis/douyin/comment-like.js

@@ -0,0 +1 @@
+import{cli as h,Strategy as _}from"@jackwener/opencli/registry";import{CommandExecutionError as s}from"@jackwener/opencli/errors";import{callCommentRuntime as p,commentCursor as C,commentId as w,openComments as I,readTargetComment as k,videoId as b}from"./_shared/comments.js";h({site:"douyin",name:"comment-like",access:"write",description:"点赞/取消点赞主评论或楼中楼；默认只读预检，--execute 才提交并回查",domain:"www.douyin.com",strategy:_.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"aweme_id",required:!0,positional:!0,help:"作品 ID 或完整链接"},{name:"cid",required:!0,positional:!0,help:"目标评论 ID"},{name:"parent",type:"string",help:"目标为楼中楼时，传主评论 ID"},{name:"cursor",type:"string",default:"0",help:"楼中楼所在页的 cursor（来自 replies 输出）"},{name:"undo",type:"boolean",help:"取消点赞"},{name:"execute",type:"boolean",help:"实际提交一次，随后回查点赞状态"}],columns:["aweme_id","cid","parent_id","liked","status"],func:async(i,e)=>{const t=b(e.aweme_id),r=w(e.cid),o=e.parent==null?void 0:w(e.parent,"--parent"),u=C(e.cursor),n=e.undo!==!0;await I(i,t);const d=await k(i,t,r,{parent:o,cursor:u}),c={cid:r,diggType:n?1:2,level:o?3:1},f=await p(i,t,"like",c),a=(m,y)=>[{aweme_id:t,cid:r,parent_id:o??null,liked:m,status:y}];if(d.liked===n)return a(d.liked,"unchanged");if(e.execute!==!0)return a(d.liked,n?"would_like":"would_unlike");await p(i,t,"like",c,!0,f.uid);let l;try{l=await k(i,t,r,{parent:o,cursor:u})}catch(m){throw new s(`已提交点赞操作，但回查失败：${m.message}`,"先查看 comments/replies 的 liked，不要盲目重试。")}if(l.liked!==n)throw new s("已提交点赞操作，但回查状态不一致","先查看 comments/replies 的 liked，不要盲目重试。");return a(l.liked,n?"liked":"unliked")}});

package/clis/douyin/comment.js

@@ -0,0 +1 @@
+import{cli as b,Strategy as E}from"@jackwener/opencli/registry";import{ArgumentError as y,CommandExecutionError as h}from"@jackwener/opencli/errors";import{assertLiteralContent as T}from"../_shared/content-guard.js";import{callCommentRuntime as x,commentCursor as F,commentId as _,openComments as D,readCommentPage as g,readTargetComment as m,videoId as q}from"./_shared/comments.js";b({site:"douyin",name:"comment",access:"write",description:"发表评论或回复主评论/楼中楼；默认只读预检，--execute 才提交一次并回查",domain:"www.douyin.com",strategy:E.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"aweme_id",required:!0,positional:!0,help:"作品 ID 或完整链接"},{name:"text",required:!0,positional:!0,fromFile:!0,help:"字面评论内容，最多 500 个 UTF-16 字符；支持 --file"},{name:"parent",type:"string",help:"回复主评论时传其 cid"},{name:"reply-to",type:"string",help:"回复楼中楼的 cid，必须同时传 --parent"},{name:"cursor",type:"string",default:"0",help:"被回复的楼中楼所在页 cursor（来自 replies 输出）"},{name:"execute",type:"boolean",help:"实际提交一次；默认仅验证账号、目标和原生提交入口"}],columns:["aweme_id","cid","text","parent_id","reply_to_id","status"],func:async(o,r)=>{const i=q(r.aweme_id),a=T(r.text,{label:"评论内容",fileFlag:"--file"});if(!a||a.length>500)throw new y("评论内容不能为空且不能超过 500 个 UTF-16 字符");const t=r.parent==null?void 0:_(r.parent,"--parent"),l=r["reply-to"]==null?void 0:_(r["reply-to"],"--reply-to");if(l&&!t)throw new y("--reply-to 必须同时指定 --parent 主评论 ID");const C=F(r.cursor);await D(o,i);if(t)await m(o,i,t);if(l)await m(o,i,l,{parent:t,cursor:C});const p={text:a,textExtra:[],...t?{replyId:t}:{},...l?{replyToReplyId:l}:{}},c=await x(o,i,"publish",p),s=(e,d)=>[{aweme_id:i,cid:e,text:a,parent_id:t??null,reply_to_id:l??null,status:d}];if(r.execute!==!0)return s(null,"prepared");const w=await x(o,i,"publish",p,!0,c.uid),n=w.comment;if(typeof n?.cid!=="string"||!/^[1-9]\d*$/.test(n.cid)||n.text!==a||n.reply_id!==(t??"0")||w.uid!==c.uid)throw new h("抖音提交已返回，但新评论 ID、内容或楼层无法确认","请先回查 comments/replies，不要直接重发。");try{let e;if(!t)e=await m(o,i,n.cid);else{let d="0";for(let f=0;f<5;f++){const u=await g(o,i,{parent:t,cursor:d});e=u.rows.find((I)=>I.cid===n.cid);if(e||!u.hasMore)break;d=u.nextCursor}}if(!e||e.text!==a||e.uid!==c.uid||e.parent_id!==(t??null)||e.reply_to_id!==(l??null))throw Error("未在回查范围（楼中楼前 5 页）读到匹配的新评论，或作者/内容/回复关系不一致")}catch(e){throw new h(`已提交评论 cid=${n.cid}，但回查未通过：${e.message}`,"请按该 cid 核对，禁止直接重发。")}return s(n.cid,"posted")}});

package/clis/douyin/comments.js

@@ -0,0 +1 @@
+import{cli as c,Strategy as u}from"@jackwener/opencli/registry";import{EmptyResultError as a}from"@jackwener/opencli/errors";import{COMMENT_COLUMNS as d,commentCursor as l,commentId as p,commentLimit as f,openComments as w,readCommentPage as y,videoId as h}from"./_shared/comments.js";for(const e of[!1,!0])c({site:"douyin",name:e?"replies":"comments",access:"read",description:e?"查看主评论下的楼中楼，含回复目标 ID；使用 next_cursor 翻页":"查看作品评论、点赞状态及回复数；使用 next_cursor 翻页",domain:"www.douyin.com",strategy:u.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"aweme_id",required:!0,positional:!0,help:"作品 ID 或抖音作品完整链接"},...e?[{name:"cid",required:!0,positional:!0,help:"主评论 ID（comments 输出的 cid）"}]:[],{name:"limit",type:"int",default:20,help:"每页数量，1–20"},{name:"cursor",type:"string",default:"0",help:"上一页 next_cursor，首次为 0"}],columns:d,func:async(r,t)=>{const o=h(t.aweme_id),n=e?p(t.cid):void 0,m=f(t.limit),s=l(t.cursor);await w(r,o);const i=await y(r,o,{parent:n,limit:m,cursor:s});if(!i.rows.length)throw new a(`douyin ${e?"replies":"comments"}`,"当前页没有评论；这不表示接口失败。");return i.rows}});

package/clis/xiaohongshu/_shared/comment-actions.js

@@ -0,0 +1,9 @@
+import{ArgumentError as v,CommandExecutionError as c}from"@jackwener/opencli/errors";import{commentId as p,commentNote as C,commentSnapshot as h,locateComment as _,openCommentPage as I,readCommentPage as T,reloadCommentPage as E}from"./comment-state.js";const g="#content-textarea",q=".engage-bar.active button.submit",R=".engage-bar.active button.cancel",S="The action may already have succeeded. Read comments/replies to verify before retrying; this command did not resubmit.";async function b(t,r,a){if(await t.evaluate(`(() => {
+        const state = (${T.toString()})(${JSON.stringify(r)});
+        if (state.error) return false;
+        const controls = document.querySelectorAll(${JSON.stringify(a)});
+        if (controls.length !== 1 || controls[0].disabled || !controls[0].getClientRects().length) return false;
+        controls[0].click();
+        return true;
+    })()`)!==!0)throw new c("Exact comment control is unavailable, disabled, or the note changed")}function s(t){return String(t).replace(/\r\n/g,`
+`).replace(/\u00a0/g," ").trim()}function N(t,r,a){const e=t.editor;if(!e?.active||!e.canSend||s(e.text)!==s(a))throw new c("Comment draft did not retain the exact text or the send button is disabled");if(r?e.replyAuthor!==`回复 ${r.author}`||s(e.replyText)!==s(r.text):e.replyAuthor!==""||e.replyText!=="")throw new c("Reply target in the composer does not match the requested comment")}export const writeArgs=[{name:"root-id",help:"Top-level root_id from comments; use when targeting a nested reply"},{name:"execute",type:"boolean",default:!1,help:"Submit after verification (default: dry-run only)"}],writeColumns=["status","note_id","id","root_id","parent_id","text","url"];export async function runComment(t,r){const{url:a,noteId:e}=C(r["note-id"]),n=r.text;if(typeof n!=="string"||!n.trim())throw new v("Comment text must not be empty");const u=r["reply-to"]==null?null:p(r["reply-to"],"reply-to"),m=r["root-id"]==null?null:p(r["root-id"],"root-id");if(m&&!u)throw new v("--root-id requires --reply-to (or the reply command)");let i=await I(t,a,e);if(i.editor?.text?.trim())throw new c("Existing comment draft is not empty; refusing to overwrite it");let d=null;if(u)({state:i,target:d}=await _(t,e,u,m));if(!i.selfId)throw new c("Cannot identify the current account for comment verification");const y=i.rows.filter((o)=>o.userId===i.selfId&&o.parent_id===u&&s(o.text)===s(n));if(y.length){const o=y[0];return[{status:"already-present",note_id:e,id:o.id,root_id:o.root_id,parent_id:o.parent_id,text:o.text,url:a}]}const k=new Set(i.rows.map((o)=>o.id));if(d)await b(t,e,`#comment-${d.id} .reply`);else if(!i.editor?.active)await t.click(".engage-bar:has(#content-textarea) .not-active");let x=!1;for(let o=0;o<10;o++){await t.wait({time:0.2});if((await h(t,e)).editor?.active){x=!0;break}}if(!x)throw new c("Comment composer did not open");await t.typeText(g,n);await t.wait({time:0.2});i=await h(t,e);N(i,d,n);if(!r.execute){await b(t,e,R);let o=!1;for(let l=0;l<10;l++){await t.wait({time:0.3});const w=await h(t,e);if(w.editor?.text===""&&!w.editor.active){o=!0;break}}if(!o)throw new c("Dry-run draft was verified but could not be cleared");return[{status:"dry-run",note_id:e,id:null,root_id:d?.root_id??null,parent_id:u,text:n,url:a}]}N(await h(t,e),d,n);try{await b(t,e,q);let o;for(let w=0;w<15;w++){await t.wait({time:0.5});o=(await h(t,e)).rows.find((f)=>!k.has(f.id)&&f.userId===i.selfId&&f.parent_id===u&&(!d||f.root_id===d.root_id)&&s(f.text)===s(n));if(o)break}if(!o)throw Error("No new matching comment appeared");await E(t,e);const{target:l}=await _(t,e,o.id,d?.root_id??null);if(l.userId!==i.selfId||l.parent_id!==u||s(l.text)!==s(n))throw Error("Persisted comment does not match the requested author, text and reply target");return[{status:"posted",note_id:e,id:l.id,root_id:l.root_id,parent_id:l.parent_id,text:l.text,url:a}]}catch(o){throw new c(`Comment submission could not be confirmed: ${o.message}`,S)}}export async function runCommentLike(t,r){const{url:a,noteId:e}=C(r["note-id"]),n=p(r["comment-id"]),u=r["root-id"]==null?null:p(r["root-id"],"root-id"),m=!r.undo;await I(t,a,e);const{target:i}=await _(t,e,n,u),d=(o)=>[{status:o,note_id:e,id:n,root_id:i.root_id,liked:m,url:a}];if(i.liked===m)return d(m?"already-liked":"already-unliked");const y=`#comment-${n} .like-wrapper`;if(await t.evaluate(`document.querySelectorAll(${JSON.stringify(y)}).length`)!==1)throw new c("Exact comment like control is unavailable or ambiguous");if(!r.execute)return[{status:"dry-run",note_id:e,id:n,root_id:i.root_id,liked:i.liked,url:a}];const x=(await h(t,e)).rows.find((o)=>o.id===n);if(!x||x.liked!==i.liked)throw new c("Comment like state changed before the click; stopped");try{await b(t,e,y);let o=!1;for(let w=0;w<10;w++){await t.wait({time:0.5});if((await h(t,e)).rows.find((f)=>f.id===n)?.liked===m){o=!0;break}}if(!o)throw Error("Like state did not change");await E(t,e);const{target:l}=await _(t,e,n,i.root_id);if(l.liked!==m)throw Error("Like state did not persist after reload");return d(m?"liked":"unliked")}catch(o){throw new c(`Comment like could not be confirmed: ${o.message}`,S)}}

package/clis/xiaohongshu/_shared/comment-state.js

@@ -0,0 +1 @@
+import{ArgumentError as h,AuthRequiredError as b,CommandExecutionError as f,EmptyResultError as g}from"@jackwener/opencli/errors";import{buildNoteUrl as _,parseNoteId as C}from"../note-helpers.js";export function commentId(e,o="comment-id"){if(typeof e!=="string"||!/^[a-f0-9]{24}$/i.test(e))throw new h(`${o} must be a 24-character comment ID from comments/replies`);return e.toLowerCase()}export function commentNote(e){const o=_(String(e??""),{commandName:"xiaohongshu comment operations"}),t=new URL(o);if(t.protocol!=="https:"||t.hostname!=="www.xiaohongshu.com"||t.port||t.username||t.password)throw new h("Comment operations require an https://www.xiaohongshu.com signed note URL");return{url:o,noteId:commentId(C(o),"note-id")}}export function readCommentPage(e){const o=document.querySelector("#app")?.__vue_app__?.config?.globalProperties?.$pinia,t=o?._s?.get("note"),n=o?._s?.get("user"),d=location.pathname.match(/\/(?:explore|note|search_result|discovery\/item)\/([a-f0-9]+)\/?$/i)?.[1]||location.pathname.match(/\/user\/profile\/[^/]+\/([a-f0-9]+)\/?$/i)?.[1];if(location.hostname!=="www.xiaohongshu.com"||location.protocol!=="https:")return{error:"wrong_host"};if(/website-login\/error|error_code=300017|error_code=300031/.test(location.href))return{error:"security_block"};if(n?.loggedIn===!1||/\/login(?:\/|$)/.test(location.pathname))return{error:"login"};if(d!==e||t?.currentNoteId!==e)return{error:"wrong_note"};const s=t.noteDetailMap?.[e]?.comments;if(!Array.isArray(s?.list)||typeof s.hasMore!=="boolean")return{error:"comments_unavailable"};const l=[],p=(r,m)=>{const a=document.getElementById("comment-"+r.id),w=m?.id||r.id,u=m?null:Number(r.subCommentCount);l.push({id:r.id,root_id:w,parent_id:m?r.targetComment?.id??null:null,author:r.userInfo?.nickname??"",userId:r.userInfo?.userId??"",profileUrl:r.userInfo?.userId?"https://www.xiaohongshu.com/user/profile/"+r.userInfo.userId:"",text:r.content,likes:Number(r.likeCount),liked:r.liked,time:a?.querySelector(".date, .time")?.textContent?.trim()??"",is_reply:Boolean(m),reply_to:m?r.targetComment?.userInfo?.nickname??"":"",reply_count:u,replies_complete:m?null:Number.isInteger(u)&&new Set((r.subComments||[]).map((x)=>x.id)).size>=u,rendered:Boolean(a)})};for(const r of s.list){p(r,null);for(const m of r.subComments||[])p(m,r)}const i=document.querySelector("#content-textarea"),c=i?.closest(".engage-bar"),y=Array.from(document.querySelectorAll('a[href*="/user/profile/"]')).find((r)=>r.textContent.trim()==="我");return{noteId:e,rows:l,hasMore:s.hasMore,loading:s.loading===!0,selfId:y?.getAttribute("href")?.match(/^\/user\/profile\/([a-f0-9]{24})(?:[/?]|$)/i)?.[1]??null,editor:i?{text:i.innerText??i.textContent,replyAuthor:c?.querySelector(".reply-content .reply")?.textContent?.trim()??"",replyText:c?.querySelector(".reply-content .content")?.textContent??"",active:c?.classList.contains("active")===!0,canSend:c?.querySelector("button.submit")?.disabled===!1}:null}}export function snapshotScript(e){return`(${readCommentPage.toString()})(${JSON.stringify(e)})`}export async function commentSnapshot(e,o){const t=await e.evaluate(snapshotScript(o));if(t?.error==="login")throw new b("www.xiaohongshu.com");if(!t||t.error||t.noteId!==o||!Array.isArray(t.rows)||typeof t.hasMore!=="boolean")throw new f(`Cannot inspect the requested comment page: ${t?.error||"malformed state"}`);for(const n of t.rows)if(!/^[a-f0-9]{24}$/i.test(n.id)||!/^[a-f0-9]{24}$/i.test(n.root_id)||n.is_reply&&!/^[a-f0-9]{24}$/i.test(n.parent_id)||typeof n.text!=="string"||typeof n.liked!=="boolean"||!Number.isInteger(n.likes)||n.likes<0)throw new f("Malformed comment identity/content/state; refusing to operate");return t}export async function openCommentPage(e,o,t){await e.goto(o);await e.wait({time:3});return commentSnapshot(e,t)}export async function reloadCommentPage(e,o){await e.cdp("Page.reload",{});await e.wait({time:3});return commentSnapshot(e,o)}export async function expandCommentThread(e,o,t,n=50,d=null){for(let s=0;s<50;s++){const l=await commentSnapshot(e,o),p=l.rows.find((a)=>a.id===t&&!a.is_reply);if(!p)throw new g("xiaohongshu replies","Root comment is not loaded");const i=l.rows.filter((a)=>a.is_reply&&a.root_id===t);if(d?i.some((a)=>a.id===d&&a.rendered):i.length>=n)return l;if(p.replies_complete)return l;const c=`.parent-comment:has(#comment-${t}) .show-more`;if(!await e.evaluate(`(() => { const e = document.querySelector(${JSON.stringify(c)}); return !!e && e.getClientRects().length > 0; })()`))throw new f("Reply list is incomplete but its expand control is unavailable");if(await e.evaluate(`(() => { const es = document.querySelectorAll(${JSON.stringify(c)}); if (es.length !== 1) return false; es[0].click(); return true; })()`)!==!0)throw new f("Reply expand control became ambiguous or disappeared");let m=!1;for(let a=0;a<10;a++){await e.wait({time:0.3});const w=await commentSnapshot(e,o);if(w.rows.filter((u)=>u.is_reply&&u.root_id===t).length>i.length||w.rows.find((u)=>u.id===t)?.replies_complete){m=!0;break}}if(!m)throw new f("Expanding replies produced no progress; stopped without repeating the click")}throw new f("Reply loading exceeded its bounded limit")}export async function locateComment(e,o,t,n=null){for(let d=0;d<50;d++){let s=await commentSnapshot(e,o);const l=s.rows.find((i)=>i.id===t&&i.rendered);if(l){if(n&&l.root_id!==n)throw new h("comment-id does not belong to root-id");return{state:s,target:l}}if(n&&s.rows.some((i)=>i.id===n&&!i.is_reply)){s=await expandCommentThread(e,o,n,50,t);const i=s.rows.find((c)=>c.id===t&&c.root_id===n&&c.rendered);if(i)return{state:s,target:i};break}if(!s.hasMore&&!s.loading)break;if(s.rows.filter((i)=>!i.is_reply).length>=50)break;await e.evaluate("(() => { const es = document.querySelectorAll('.parent-comment'); es[es.length - 1]?.scrollIntoView({block:'end'}); })()");await e.wait({time:1})}throw new g("xiaohongshu comment","Exact comment not found within 50 top-level comments. For a nested reply, supply its root_id via --root-id.")}

package/clis/xiaohongshu/comment-like.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";import{runCommentLike as o,writeArgs as i}from"./_shared/comment-actions.js";e({site:"xiaohongshu",name:"comment-like",access:"write",description:"点赞/取消点赞小红书评论（含楼中楼）；默认 dry-run，--execute 才操作",domain:"www.xiaohongshu.com",strategy:t.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"note-id",positional:!0,required:!0,help:"Full signed note URL with xsec_token"},{name:"comment-id",positional:!0,required:!0,help:"Exact comment ID from comments/replies"},{name:"undo",type:"boolean",default:!1,help:"Ensure the comment is not liked"},...i],columns:["status","note_id","id","root_id","liked","url"],func:o});

package/clis/xiaohongshu/comment.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";import{runComment as o,writeArgs as r,writeColumns as n}from"./_shared/comment-actions.js";e({site:"xiaohongshu",name:"comment",access:"write",description:"发布小红书评论或定向回复；默认验证草稿，--execute 才发送",domain:"www.xiaohongshu.com",strategy:t.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"note-id",positional:!0,required:!0,help:"Full signed note URL with xsec_token"},{name:"text",positional:!0,required:!0,help:"Exact plain-text comment"},{name:"reply-to",help:"Exact comment ID to reply to, including a nested reply"},...r],columns:n,func:o});