npm - yuanflow-cli - Versions diffs - 0.1.4 → 0.1.6 - Mend

yuanflow-cli 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/README.md CHANGED Viewed

@@ -29,6 +29,12 @@ yuanflow-cli douyin video-detail "https://v.douyin.com/xxx/" --format agent-json
 yuanflow-cli shortcuts douyin
 yuanflow-cli commands list
 yuanflow-cli schema douyin.video-detail
+yuanflow-cli schema comments.douyin.comments
+yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx/" --region CN --format agent-json
+yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --format agent-json
+yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json
 yuanflow-cli list douyin
 ```
@@ -40,6 +46,47 @@ YUANCHUANG_API_TOKEN=<你的令牌>
 token 优先级：`--token` > `YUANCHUANG_API_TOKEN` > 本地 `config.token`。独立 CLI 用户可以使用环境变量或 `config set-token`；在 YuanFlow 主程序内使用时，token 由主程序认证系统注入，不需要手动配置。
+### 作品评论采集
+评论采集统一走 `comments collect`，用于把 Agent 的自然语言需求稳定映射到平台评论接口：
+```bash
+yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+yuanflow-cli comments collect --platform xiaohongshu --target note_id --action replies --comment-id root_comment_id --format agent-json
+yuanflow-cli comments collect --platform youtube --target video_id --action comments --dry-run --format agent-json
+```
+常用参数：
+- `--platform`：平台标识，如 `douyin`、`xiaohongshu`、`bilibili`、`wechat_mp`、`tiktok`、`instagram`、`kuaishou`、`reddit`、`twitter`、`weibo`、`youtube`、`zhihu`。
+- `--action`：评论类型，默认 `comments`，可选 `replies`、`post_comments`、`post_replies`。
+- `--target`：作品、文章、帖子、视频或回答 ID，也可以传支持的平台链接。
+- `--comment-id`：采集二级评论或评论回复时使用。
+- `--prefer fallback`：使用备用接口。
+- `--dry-run`：只预览请求映射，不发起真实接口请求，也不要求 token。
+Agent 可以先用 `yuanflow-cli commands list` 查看全部命令，再用 `yuanflow-cli schema comments.douyin.comments` 查看某个评论采集命令的参数、接口路径和返回说明。
+### 综合作品工具
+四类综合工具统一走受控命令，适合 Agent 通过自然语言稳定调用：
+```bash
+yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+yuanflow-cli works download --platform youtube --target "dQw4w9WgXcQ" --format agent-json
+yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --format agent-json
+yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json
+```
+命令 key：
+- `works.<platform>.detail`：单作品详情。
+- `works.<platform>.download`：播放/下载地址候选或视频流信息。
+- `search.<platform>.content`：内容、作品、笔记、文章、帖子搜索。
+- `search.<platform>.users`：账号、用户、作者、频道搜索。
+Agent 不确定参数时先执行 `commands list`，再用 `schema works.douyin.detail` 或 `schema search.xiaohongshu.content` 查看参数。`--dry-run` 可预览请求映射，不发起真实接口请求，也不要求 token。
 ## Skill 安装器
 ```bash

package/lib/skill-installer/repo-source.cjs CHANGED Viewed

@@ -104,6 +104,14 @@ function resolveLocalSkillRoot(packageRoot) {
 }
 async function prepareSkillSource({ packageRoot }) {
+  const localRoot = resolveLocalSkillRoot(packageRoot);
+  if (localRoot) {
+    return {
+      sourceRoot: localRoot,
+      cleanup() {},
+    };
+  }
   const repoConfig = readRepositoryConfig(packageRoot);
   const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'yuanflow-skill-'));
   const archiveFile = path.join(tempRoot, `${repoConfig.repo}-${repoConfig.ref}.tar.gz`);
@@ -131,15 +139,6 @@ async function prepareSkillSource({ packageRoot }) {
       cloneRepository({ repoConfig, targetDir: cloneDir });
       sourceRoot = resolveRepositoryRoot(cloneDir);
     } catch (gitError) {
-      const localRoot = resolveLocalSkillRoot(packageRoot);
-      if (localRoot) {
-        fs.rmSync(tempRoot, { recursive: true, force: true });
-        return {
-          sourceRoot: localRoot,
-          cleanup() {},
-        };
-      }
       const archiveMessage = archiveError instanceof Error ? archiveError.message : String(archiveError);
       const gitMessage = gitError instanceof Error ? gitError.message : String(gitError);
       throw new Error(`下载 skill 仓库失败。archive: ${archiveMessage}; git: ${gitMessage}`);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill/SKILL.md CHANGED Viewed

@@ -9,10 +9,15 @@ description: Use when the user asks about social-media API workflows, platform d
 ## 当前发布范围
-当前 skill 目录只包含：
+当前 skill 目录包含：
 - 根目录这一份 `SKILL.md`
 - `yuanflow-cli/`
+- `作品评论采集/`
+- `作品详情获取工具/`
+- `作品下载综合工具/`
+- `综合搜索工具/`
+- `综合用户搜索工具/`
 ## 环境判断
@@ -48,6 +53,66 @@ description: Use when the user asks about social-media API workflows, platform d
 - `yuanflow-cli`
+### 2. 走 `作品评论采集`
+遇到下面这些需求，优先进入这个子 Skill：
+- 采集、抓取、导出或分析作品评论。
+- 获取评论回复、二级评论、楼中楼、子评论。
+- 用户给出抖音、小红书、B站、微信公众号、微信视频号、TikTok、Instagram、快手、Reddit、Twitter/X、微博、YouTube、知乎链接或 ID，并明确要评论数据。
+子 Skill 名称：
+- `作品评论采集`
+### 3. 走 `作品详情获取工具`
+遇到下面这些需求，优先进入这个子 Skill：
+- 查询单个作品、视频、笔记、文章、帖子、推文、微博、知乎文章的详情。
+- 解析作品链接，获取标题、正文、作者、发布时间、互动统计、媒体信息。
+- 用户给出单个作品 URL、BV 号、视频 ID、帖子 ID 或文章 ID。
+子 Skill 名称：
+- `作品详情获取工具`
+### 4. 走 `作品下载综合工具`
+遇到下面这些需求，优先进入这个子 Skill：
+- 获取作品播放链接、下载地址候选、视频流信息。
+- 用户要求下载、保存、获取媒体地址。
+- 平台包括抖音、B站、YouTube、西瓜视频。
+子 Skill 名称：
+- `作品下载综合工具`
+### 5. 走 `综合搜索工具`
+遇到下面这些需求，优先进入这个子 Skill：
+- 按关键词搜索内容、作品、笔记、文章、视频、帖子。
+- 做选题、竞品素材、热点素材、内容检索。
+- 平台包括抖音、小红书、B站、微信视频号、TikTok、Instagram、快手、Reddit、Twitter/X、微博、YouTube、知乎、西瓜视频。
+子 Skill 名称：
+- `综合搜索工具`
+### 6. 走 `综合用户搜索工具`
+遇到下面这些需求，优先进入这个子 Skill：
+- 搜索账号、作者、达人、用户、频道。
+- 做账号调研、达人筛选、用户线索查找。
+- 平台包括抖音、小红书、微信视频号、TikTok、Instagram、快手、微博、YouTube、知乎。
+子 Skill 名称：
+- `综合用户搜索工具`
 ## 多需求时怎么处理
 如果用户一次提了多段流程，不要强行塞进一个子 Skill，按阶段拆开：
@@ -59,7 +124,7 @@ description: Use when the user asks about social-media API workflows, platform d
 例如：
 - “查抖音作品详情、评论、热榜”：
-  走 `yuanflow-cli`
+  作品详情走 `作品详情获取工具`，评论走 `作品评论采集`，热榜或其它原子接口走 `yuanflow-cli`
 ## 维护规则

package/skills/yuanflow-skill/yuanflow-cli/SKILL.md CHANGED Viewed

@@ -5,7 +5,7 @@ description: Use when the user needs atomic API calls for social-media platforms
 # YuanFlow CLI
-这个 Skill 用于调用 `yuanflow-cli` 这个 npm 包。它适合做原子级 API 调用：查作品详情、下载地址、作者主页、评论、搜索结果、热榜、公众号文章、视频号内容等。
+这个 Skill 用于调用 `yuanflow-cli` 这个 npm 包。它适合做原子级 API 调用：查作品详情、下载地址、作者主页、评论、搜索结果、热榜、公众号文章、视频号内容等。常见需求优先使用综合命令：`comments collect`、`works detail`、`works download`、`search content`、`search users`。
 ## 先判断是否要用
@@ -132,9 +132,14 @@ yuanflow-cli schema douyin.video-detail
 yuanflow-cli shortcuts
 yuanflow-cli shortcuts douyin
 yuanflow-cli list douyin
-yuanflow-cli commands list
-yuanflow-cli commands describe xiaohongshu.search-notes
-yuanflow-cli schema xiaohongshu.search-notes
+  yuanflow-cli commands list
+  yuanflow-cli commands describe xiaohongshu.search-notes
+  yuanflow-cli schema xiaohongshu.search-notes
+  yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+  yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+  yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx/" --region CN --format agent-json
+  yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --format agent-json
+  yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json
 ```
 当前 registry 覆盖的平台包括：
@@ -174,6 +179,65 @@ yuanflow-cli bilibili video-detail "https://www.bilibili.com/video/BVxxx" -o bil
 | 作品评论 | `yuanflow-cli douyin comments <aweme_id> --count 20 --cursor 0 --format agent-json` |
 | 抖音热榜 | `yuanflow-cli douyin hot-search --format agent-json` |
+### 作品评论采集统一入口
+评论采集优先使用统一入口：
+```powershell
+yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+```
+常用参数：
+- `--platform`：平台，如 `douyin`、`xiaohongshu`、`bilibili`、`wechat_mp`、`wechat_channels`、`tiktok`、`instagram`、`kuaishou`、`reddit`、`twitter`、`weibo`、`youtube`、`zhihu`。
+- `--action`：`comments` 一级评论，`replies` 评论回复；YouTube 社区帖子使用 `post_comments` 或 `post_replies`。
+- `--target`：作品链接、文章链接、视频 ID、笔记 ID、BV 号等。
+- `--comment-id`：采集回复时的父评论 ID。
+- `--cursor`：翻页游标。
+- `--count`：返回数量。
+- `--page`：B站页码。
+- `--prefer fallback`：主接口失败时切换备用接口。
+- `--extra`：JSON 字符串，用于公众号 `content_id` 等补充参数。
+在 YuanFlow 主程序内，用 `yuanflow_cli_call` 调用时传参数数组：
+```json
+{
+  "args": [
+    "comments",
+    "collect",
+    "--platform",
+    "douyin",
+    "--target",
+    "https://v.douyin.com/xxx/",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+### 综合作品与搜索入口
+新增综合入口优先给 Agent 使用：
+| 需求 | 命令 |
+| --- | --- |
+| 单作品详情 | `yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json` |
+| 播放/下载地址候选 | `yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx/" --region CN --format agent-json` |
+| 内容综合搜索 | `yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --format agent-json` |
+| 用户/账号搜索 | `yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json` |
+对应 schema：
+```powershell
+yuanflow-cli schema works.douyin.detail
+yuanflow-cli schema works.youtube.download
+yuanflow-cli schema search.xiaohongshu.content
+yuanflow-cli schema search.instagram.users
+```
+YuanFlow 主程序内使用时仍通过 `yuanflow_cli_call` 传参数数组，token 由主程序注入。
 ### 小红书
 | 需求 | 命令 |

package/skills/yuanflow-skill//344/275/234/345/223/201/344/270/213/350/275/275/347/273/274/345/220/210/345/267/245/345/205/267/SKILL.md ADDED Viewed

@@ -0,0 +1,118 @@
+---
+name: 作品下载综合工具
+description: Use when the user wants to get playable media streams, download URL candidates, or save-ready media metadata for Douyin, Bilibili, YouTube, or Xigua works through yuanflow-cli.
+builtin_skill_version: 1.0.0
+tags:
+  - 自媒体
+  - 作品下载
+  - 播放链接
+  - 抖音
+  - B站
+  - YouTube
+  - 西瓜视频
+emoji: ⬇️
+---
+# 作品下载综合工具
+本技能把用户的“下载作品、获取播放地址、获取视频流信息”需求稳定映射到 `yuanflow-cli works download`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+## 什么时候使用
+用户出现以下意图时使用：
+- 下载、保存、获取播放链接、获取视频流、获取媒体地址。
+- 用户给出抖音、B站、YouTube、西瓜视频链接或作品 ID。
+- 用户只想先确认作品是否有可用播放/下载地址。
+不要用于批量抓取、绕过平台限制、破解权限、去除平台风控、下载私密或未授权内容。该工具只返回上游接口提供的播放/下载地址候选或视频流信息；真正保存到本地文件如需后续执行，必须先确认用户授权和保存路径。
+## 调用优先级
+1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `works download` 开始。
+2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli works download ...`。
+3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
+YuanFlow 内置调用示例：
+```json
+{
+  "args": [
+    "works",
+    "download",
+    "--platform",
+    "douyin",
+    "--target",
+    "https://v.douyin.com/xxx/",
+    "--region",
+    "CN",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+外部 CLI 示例：
+```powershell
+yuanflow-cli works download --platform douyin --target "https://v.douyin.com/xxx/" --region CN --format agent-json
+```
+## 先查命令和 schema
+不确定参数时先查，不要猜：
+```json
+{"args":["commands","list"]}
+{"args":["schema","works.douyin.download"]}
+{"args":["schema","works.youtube.download"]}
+```
+命令 key 格式是：
+```text
+works.<platform>.download
+```
+## 平台识别
+| 平台参数 | 用户常见说法 | 链接或 ID 标识 | 说明 |
+|---|---|---|---|
+| `douyin` | 抖音、Douyin | `douyin.com`、`iesdouyin.com`、`v.douyin.com`、`aweme_id` | 支持分享链接或 aweme_id，可传 `--region CN` |
+| `bilibili` | B站、哔哩哔哩 | `bilibili.com`、`b23.tv`、`BV` 号 | URL 走播放信息；BV + `--cid` 可取 playurl |
+| `youtube` | YouTube、油管 | `youtube.com/watch?v=`、`youtu.be/`、视频 ID | 默认获取 streams；签名流 URL 需要 `--prefer signed --itag` |
+| `xigua` | 西瓜视频 | 西瓜视频链接、`item_id` | 使用 `item_id` 获取播放链接 |
+如果短链文本无法判断平台，先按域名判断；仍无法判断就追问平台。
+## 参数规则
+通用参数：
+- `--platform`：平台标识。
+- `--target`：作品链接、分享链接或作品 ID。
+- `--prefer`：默认 `primary`；YouTube 需要签名流时用 `signed`；有备用接口时可用 `fallback`。
+- `--region`：抖音可选，国内用户通常传 `CN`。
+- `--cid`：B站按 BV 号取 playurl 时必填。
+- `--itag`：YouTube 获取签名流 URL 时必填，来自 `get_video_streams` 的返回。
+- `--extra`：JSON 字符串补充参数。
+- `--format agent-json`：Agent 调用时必须加，便于稳定解析。
+## 接口映射
+| 平台 | 首选能力 | 主要参数 | 备用或特殊能力 |
+|---|---|---|---|
+| 抖音 | 最高画质播放/下载地址查询 | `share_url` 或 `aweme_id`、`region` | 支持 web 备用接口 |
+| B站 | 视频播放信息 | `url` | `bv_id` + `cid` 获取视频流地址 |
+| YouTube | 视频流信息 | `video_id` 或 `video_url` | `--prefer signed --itag` 获取签名流 URL |
+| 西瓜视频 | 视频播放链接 | `item_id` | 暂无备用 |
+## 输出要求
+成功后用中文简短说明：
+- 调用了哪个平台和下载/播放能力。
+- 返回的是播放信息、下载地址候选还是视频流信息。
+- 如果响应里有多清晰度、itag、签名 URL、下一步保存所需字段，要提示用户。
+失败时按 `agent-json` 的 `error.code` 和 `error.message` 解释。不要展示完整 Authorization 请求头、token、cookie 或敏感账号信息。

package/skills/yuanflow-skill//344/275/234/345/223/201/350/257/204/350/256/272/351/207/207/351/233/206/SKILL.md ADDED Viewed

@@ -0,0 +1,169 @@
+---
+name: 作品评论采集
+description: Use when the user needs to collect, export, inspect, or continue comment and reply data for Douyin, Xiaohongshu, Bilibili, WeChat MP, WeChat Channels, TikTok, Instagram, Kuaishou, Reddit, Twitter/X, Weibo, YouTube, or Zhihu posts.
+builtin_skill_version: 1.0.0
+tags:
+  - 自媒体
+  - 评论采集
+  - 抖音
+  - 小红书
+  - B站
+  - 微信公众号
+  - 微信视频号
+  - TikTok
+  - Instagram
+  - 快手
+  - Reddit
+  - Twitter
+  - 微博
+  - YouTube
+  - 知乎
+emoji: 💬
+---
+# 作品评论采集
+本技能把用户的评论采集需求稳定映射到 `yuanflow-cli comments collect`。在 YuanFlow 主程序内，优先使用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+## 什么时候使用
+用户出现以下意图时使用：
+- 采集、抓取、获取、导出某个作品、文章、帖子、回答的评论。
+- 获取某条评论下的回复、二级评论、楼中楼、子评论。
+- 用户给出抖音、小红书、B站、微信公众号文章、微信视频号、TikTok、Instagram、快手、Reddit、Twitter/X、微博、YouTube、知乎链接或 ID，并要求看评论数据。
+不要用于发评论、回复评论、点赞评论、绕过平台限制、批量抓取或未授权数据访问。作品详情、作品下载、用户主页、综合搜索应交给 `yuanflow-cli` 其它命令。
+## 调用优先级
+1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `comments collect` 开始。
+2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli comments collect ...`。
+3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
+YuanFlow 内置调用示例：
+```json
+{
+  "args": [
+    "comments",
+    "collect",
+    "--platform",
+    "douyin",
+    "--target",
+    "https://v.douyin.com/xxx/",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+外部 CLI 示例：
+```powershell
+yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+```
+## 先查命令和 schema
+不确定参数时先查，不要猜：
+```json
+{"args":["commands","list"]}
+{"args":["schema","comments.douyin.comments"]}
+```
+命令 key 格式是：
+```text
+comments.<platform>.<action>
+```
+例如 `comments.douyin.comments`、`comments.xiaohongshu.replies`、`comments.youtube.post_comments`。
+## 参数规则
+通用参数：
+- `--platform`：平台标识。
+- `--action`：`comments` 一级评论；`replies` 评论回复；YouTube 社区帖子用 `post_comments` 或 `post_replies`。默认 `comments`。
+- `--target`：作品、文章、帖子或回答 ID，也可以传支持的平台链接。
+- `--comment-id`：多数平台采集回复时必填。
+- `--cursor`：翻页游标，必须来自上一次响应，不要编造。
+- `--count`：返回数量，仅平台支持时传。
+- `--page`：B站页码。
+- `--prefer fallback`：主接口失败或用户要求备用接口时使用。
+- `--extra`：JSON 字符串补充参数，例如微信公众号回复需要 `content_id`。
+- `--format agent-json`：Agent 调用时必须加，便于稳定解析。
+## 平台识别
+| 平台参数 | 用户常见说法 | 链接或 ID 标识 |
+|---|---|---|
+| `douyin` | 抖音、Douyin | `douyin.com`、`iesdouyin.com`、`v.douyin.com`、`aweme_id` |
+| `xiaohongshu` | 小红书、XHS | `xiaohongshu.com`、`xhslink.com`、`note_id` |
+| `bilibili` | B站、哔哩哔哩 | `bilibili.com`、`b23.tv`、`BV` 号 |
+| `wechat_mp` | 微信公众号、公众号文章 | `mp.weixin.qq.com/s/` |
+| `wechat_channels` | 微信视频号、视频号 | 视频号视频 ID、视频号详情里的 `id` |
+| `tiktok` | TikTok | `tiktok.com`、`vm.tiktok.com`、`aweme_id` |
+| `instagram` | Instagram、ins | `instagram.com/p/`、`instagram.com/reel/`、shortcode、media_id |
+| `kuaishou` | 快手 | `kuaishou.com/short-video/`、`photo_id` |
+| `reddit` | Reddit | `reddit.com/r/.../comments/`、`t3_` 帖子 ID |
+| `twitter` | Twitter、X | `twitter.com`、`x.com`、推文数字 ID |
+| `weibo` | 微博 | `weibo.com`、微博 `id`、`mid` |
+| `youtube` | YouTube、油管 | `youtube.com/watch?v=`、`youtu.be/`、视频 ID、社区帖子 ID |
+| `zhihu` | 知乎 | 知乎回答 ID、评论 ID |
+如果短链文本无法判断平台，先按域名判断；仍无法判断就追问平台。
+## 接口映射
+Agent 不需要直接拼接口地址，只需要选对 `platform`、`action` 和参数。
+| 平台 | action | 首选能力 | 主要参数 | 备用能力 |
+|---|---|---|---|---|
+| 抖音 | `comments` | 抖音作品一级评论 | `aweme_id`、`cursor`、`count` | 支持 |
+| 抖音 | `replies` | 抖音评论回复 | `item_id`、`comment_id`、`cursor`、`count` | 支持 |
+| 小红书 | `comments` | 小红书笔记一级评论 | `note_id`、`cursor` | 支持 |
+| 小红书 | `replies` | 小红书笔记二级评论 | `note_id`、`comment_id`、`cursor`、`count` | 支持 |
+| B站 | `comments` | B站视频一级评论 | `bv_id`、`page` | 支持 |
+| B站 | `replies` | B站评论回复 | `bv_id`、`comment_id`、`page` | 暂无 |
+| 微信公众号 | `comments` | 公众号文章一级评论 | `url`、`comment_id`、`cursor` | 暂无 |
+| 微信公众号 | `replies` | 公众号文章评论回复 | `url`、`comment_id`、`extra.content_id`、`cursor` | 暂无 |
+| 微信视频号 | `comments` | 视频号一级评论 | `id`、`cursor` | 暂无 |
+| 微信视频号 | `replies` | 视频号评论回复 | `id`、`comment_id`、`cursor` | 暂无 |
+| TikTok | `comments` | TikTok 作品一级评论 | `aweme_id`、`cursor`、`count` | 支持 |
+| TikTok | `replies` | TikTok 评论回复 | `item_id`、`comment_id`、`cursor`、`count` | 支持 |
+| Instagram | `comments` | Instagram 帖子一级评论 | `code_or_url`、`cursor` | 支持 |
+| Instagram | `replies` | Instagram 评论回复 | `code_or_url`、`comment_id`、`cursor` | 支持 |
+| 快手 | `comments` | 快手作品一级评论 | `photo_id`、`cursor` | 支持 |
+| 快手 | `replies` | 快手作品二级评论 | `photo_id`、`comment_id`、`cursor` | 暂无 |
+| Reddit | `comments` | Reddit 帖子一级评论 | `post_id`、`cursor` | 暂无 |
+| Reddit | `replies` | Reddit 评论回复 | `post_id`、`cursor` | 暂无 |
+| Twitter/X | `comments` | 推文评论 | `tweet_id`、`cursor` | 支持 |
+| 微博 | `comments` | 微博一级评论 | `id`、`count`、`cursor` | 支持 |
+| 微博 | `replies` | 微博子评论 | `id`、`count`、`cursor` | 暂无 |
+| YouTube | `comments` | 视频一级评论 | `video_id`、`cursor` | 支持 |
+| YouTube | `replies` | 视频二级评论 | `continuation_token` | 支持 |
+| YouTube | `post_comments` | 社区帖子一级评论 | `post_id`、`cursor` | 暂无 |
+| YouTube | `post_replies` | 社区帖子评论回复 | `continuation_token` | 暂无 |
+| 知乎 | `comments` | 回答评论区 | `answer_id`、`count`、`cursor` | 暂无 |
+| 知乎 | `replies` | 子评论区 | `comment_id`、`count`、`cursor` | 暂无 |
+## 输出要求
+成功后用中文简短说明：
+- 调用了哪个平台和评论类型。
+- 使用首选能力还是备用能力。
+- 如果响应里有评论数量、下一页游标或 continuation token，要提示用户。
+- 用户要求导出时，再整理为表格、JSON 或文件。
+失败时按 `agent-json` 的 `error.code` 和 `error.message` 解释。常见处理：
+- `TOKEN_MISSING`：提示先完成 YuanFlow KEY 认证或外部 CLI 环境变量配置。
+- `BAD_ARGUMENT`：检查平台、action、target、comment-id、cursor。
+- `AUTH_INVALID`：认证无效或权限不足。
+- `UPSTREAM_ERROR`、`NETWORK_ERROR`：说明上游或网络失败，可稍后重试，或在有备用能力的平台加 `--prefer fallback`。
+不要展示完整 Authorization 请求头、token、cookie 或敏感账号信息。