yuanflow-cli 0.1.4 → 0.1.6

package/skills/yuanflow-skill//344/275/234/345/223/201/350/257/246/346/203/205/350/216/267/345/217/226/345/267/245/345/205/267/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: 作品详情获取工具
+description: Use when the user wants to fetch details, metadata, author info, text, stats, or media info for a single post, note, video, article, tweet, Weibo, YouTube post, Zhihu article, or social-media work through yuanflow-cli.
+builtin_skill_version: 1.0.0
+tags:
+  - 自媒体
+  - 作品详情
+  - 单作品解析
+  - 数据查询
+emoji: 📄
+---
+
+# 作品详情获取工具
+
+本技能把用户的“查询单个作品详情、解析作品链接、获取作品元数据”需求稳定映射到 `yuanflow-cli works detail`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+
+## 什么时候使用
+
+用户出现以下意图时使用：
+
+- 查询单个作品、视频、笔记、文章、帖子、推文、微博、知乎文章的详情。
+- 用户给出作品链接、分享链接、BV 号、视频 ID、帖子 ID、文章 ID。
+- 用户要标题、正文、作者、发布时间、互动统计、封面、媒体信息等字段。
+
+不要用于评论采集、批量搜索、账号搜索或下载保存；评论用 `作品评论采集`，内容搜索用 `综合搜索工具`，用户搜索用 `综合用户搜索工具`，播放/下载地址用 `作品下载综合工具`。
+
+## 调用优先级
+
+1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `works detail` 开始。
+2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli works detail ...`。
+3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
+
+YuanFlow 内置调用示例：
+
+```json
+{
+  "args": [
+    "works",
+    "detail",
+    "--platform",
+    "douyin",
+    "--target",
+    "https://v.douyin.com/xxx/",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+外部 CLI 示例：
+
+```powershell
+yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --format agent-json
+```
+
+## 先查命令和 schema
+
+不确定参数时先查，不要猜：
+
+```json
+{"args":["commands","list"]}
+{"args":["schema","works.douyin.detail"]}
+{"args":["schema","works.xiaohongshu.detail"]}
+```
+
+命令 key 格式是：
+
+```text
+works.<platform>.detail
+```
+
+## 平台识别
+
+| 平台参数 | 用户常见说法 | 链接或 ID 标识 | 说明 |
+|---|---|---|---|
+| `douyin` | 抖音、Douyin | `douyin.com`、`iesdouyin.com`、`v.douyin.com`、`aweme_id` | 分享链接优先 |
+| `xiaohongshu` | 小红书、XHS | `xiaohongshu.com`、`xhslink.com`、`note_id` | 可传 `--xsec-token` |
+| `bilibili` | B站、哔哩哔哩 | `bilibili.com`、`b23.tv`、`BV` 号 | URL 优先 |
+| `wechat_channels` | 微信视频号、视频号 | 视频号视频 ID、`exportId` | 可传 `--export-id` |
+| `wechat_mp` | 微信公众号、公众号文章 | `mp.weixin.qq.com/s/` | 文章 URL |
+| `tiktok` | TikTok | `tiktok.com`、`vm.tiktok.com`、`itemId` | 分享链接优先 |
+| `instagram` | Instagram、ins | `instagram.com/p/`、`instagram.com/reel/`、shortcode、media_id | URL、code、media_id 均可 |
+| `kuaishou` | 快手 | `kuaishou.com/short-video/`、`photo_id` | URL 优先 |
+| `reddit` | Reddit | `reddit.com/r/.../comments/`、`t3_` 帖子 ID | 帖子详情 |
+| `twitter` | Twitter、X | `twitter.com`、`x.com`、推文数字 ID | 推文详情 |
+| `weibo` | 微博 | `weibo.com`、微博 `id`、`mid` | 可传 `--long-text true` |
+| `youtube` | YouTube、油管 | `youtube.com/watch?v=`、`youtu.be/`、视频 ID、社区帖子 ID | 默认视频详情，帖子用 `--kind post` |
+| `zhihu` | 知乎 | 专栏文章 ID、问题 ID | 文章用 `--kind article`，问题回答入口用 `--kind question` |
+| `xigua` | 西瓜视频 | 西瓜视频链接、`item_id` | 作品详情 |
+
+如果短链文本无法判断平台，先按域名判断；仍无法判断就追问平台。
+
+## 参数规则
+
+通用参数：
+
+- `--platform`：平台标识。
+- `--target`：作品链接、分享链接或作品 ID。
+- `--prefer fallback`：主接口失败或用户要求备用接口时使用。
+- `--kind`：区分同平台不同对象，例如 YouTube 的 `video` / `post`，知乎的 `article` / `question`。
+- `--target-kind`：区分 ID 类型，例如 Instagram 的 `code` / `media_id`。
+- `--extra`：JSON 字符串补充参数。
+- `--format agent-json`：Agent 调用时必须加，便于稳定解析。
+
+## 接口映射
+
+Agent 不需要直接拼接口地址，只需要选对 `platform`、`target` 和必要参数。
+
+| 平台 | 首选能力 | 主要参数 | 备用或特殊能力 |
+|---|---|---|---|
+| 抖音 | 分享链接取作品详情 | `share_url` | aweme_id / app v3 备用 |
+| 小红书 | 笔记详情 | `note_id`、`xsec_token` | 暂无 |
+| B站 | 视频 URL 取详情 | `url` | BV 号详情 |
+| 微信视频号 | 视频详情 | `id`、`exportId` | 暂无 |
+| 微信公众号 | 文章详情 JSON | `url` | 暂无 |
+| TikTok | 分享链接取作品详情 | `share_url` | itemId 详情 |
+| Instagram | URL 取帖子详情 | `post_url` | shortcode / media_id |
+| 快手 | URL 取作品详情 | `url` | photo_id 详情 |
+| Reddit | 帖子详情 | `post_id` | 可传 comment_id |
+| Twitter/X | 推文详情 | `tweet_id` | 暂无 |
+| 微博 | 微博详情 | `id` | post_id 备用 |
+| YouTube | 视频详情 | `video_id` | 帖子详情 `--kind post` |
+| 知乎 | 专栏文章详情 | `article_id` | 问题回答入口 `--kind question` |
+| 西瓜视频 | 作品详情 | `item_id` | 暂无 |
+
+## 输出要求
+
+成功后用中文简短说明：
+
+- 调用了哪个平台和详情能力。
+- 提炼标题、作者、发布时间、正文/描述、互动统计、媒体信息等用户需要的字段。
+- 如果响应字段过多，先摘要，再询问是否需要导出完整 JSON。
+
+失败时按 `agent-json` 的 `error.code` 和 `error.message` 解释。不要展示完整 Authorization 请求头、token、cookie 或敏感账号信息。

package/skills/yuanflow-skill//347/273/274/345/220/210/346/220/234/347/264/242/345/267/245/345/205/267/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: 综合搜索工具
+description: Use when the user wants to search public content, posts, notes, videos, articles, or social-media results across Douyin, Xiaohongshu, Bilibili, WeChat Channels, TikTok, Instagram, Kuaishou, Reddit, Twitter/X, Weibo, YouTube, Zhihu, or Xigua.
+builtin_skill_version: 1.0.0
+tags:
+  - 自媒体
+  - 综合搜索
+  - 内容搜索
+  - 关键词搜索
+emoji: 🔎
+---
+
+# 综合搜索工具
+
+本技能把用户的“按关键词搜索内容、视频、笔记、文章、帖子”需求稳定映射到 `yuanflow-cli search content`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+
+## 什么时候使用
+
+用户出现以下意图时使用：
+
+- 搜索某个平台上的内容、作品、笔记、帖子、文章、视频。
+- 用户给出关键词，并指定抖音、小红书、B站、微信视频号、TikTok、Instagram、快手、Reddit、Twitter/X、微博、YouTube、知乎或西瓜视频。
+- 用户要做选题、竞品素材、热点素材、内容检索。
+
+不要用于用户搜索；用户、作者、账号、频道搜索应使用 `综合用户搜索工具`。不要用于批量抓取、绕过平台限制或未授权数据访问。
+
+## 调用优先级
+
+1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `search content` 开始。
+2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli search content ...`。
+3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
+
+YuanFlow 内置调用示例：
+
+```json
+{
+  "args": [
+    "search",
+    "content",
+    "--platform",
+    "xiaohongshu",
+    "--keyword",
+    "美妆",
+    "--page",
+    "1",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+外部 CLI 示例：
+
+```powershell
+yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --page 1 --format agent-json
+```
+
+## 先查命令和 schema
+
+不确定参数时先查，不要猜：
+
+```json
+{"args":["commands","list"]}
+{"args":["schema","search.xiaohongshu.content"]}
+{"args":["schema","search.douyin.content"]}
+```
+
+命令 key 格式是：
+
+```text
+search.<platform>.content
+```
+
+## 平台识别
+
+| 平台参数 | 用户常见说法 | 主要搜索对象 | 常用补充参数 |
+|---|---|---|---|
+| `douyin` | 抖音、Douyin | 综合内容、视频、图文、文章 | `--cursor`、`--sort-type`、`--publish-time`、`--content-type` |
+| `xiaohongshu` | 小红书、XHS | 笔记 | `--page`、`--sort`、`--note-type` |
+| `bilibili` | B站、哔哩哔哩 | 综合结果、视频 | `--page`、`--page-size`、`--order` |
+| `wechat_channels` | 微信视频号、视频号 | 视频号综合搜索 | 关键词 |
+| `tiktok` | TikTok | 综合结果 | `--offset`、`--count`、`--sort-type` |
+| `instagram` | Instagram、ins | 综合结果 | `--next-max-id`、`--rank-token` |
+| `kuaishou` | 快手 | 综合结果 | `--pcursor`、`--sort-type` |
+| `reddit` | Reddit | 帖子、社区、评论、媒体 | `--search-type`、`--sort`、`--after` |
+| `twitter` | Twitter、X | 推文搜索时间线 | `--search-type`、`--cursor` |
+| `weibo` | 微博 | 微博高级搜索 | `--page`、`--search-type` |
+| `youtube` | YouTube、油管 | 综合结果 | `--continuation-token`、`--type`、`--sort-by` |
+| `zhihu` | 知乎 | 文章搜索 | `--offset`、`--limit`、`--sort` |
+| `xigua` | 西瓜视频 | 视频搜索 | `--offset`、`--order-type` |
+
+## 参数规则
+
+通用参数：
+
+- `--platform`：平台标识。
+- `--keyword`：搜索关键词。
+- `--cursor`、`--offset`、`--page`、`--continuation-token`：翻页参数，必须来自上一次响应，不要编造。
+- `--count`、`--limit`、`--page-size`：数量参数，仅平台支持时传。
+- `--sort`、`--sort-type`、`--publish-time`、`--content-type`：筛选参数，按 schema 和平台说明传。
+- `--extra`：JSON 字符串补充参数。
+- `--format agent-json`：Agent 调用时必须加，便于稳定解析。
+
+## 输出要求
+
+成功后用中文简短说明：
+
+- 搜索的平台、关键词和筛选条件。
+- 如果响应里有结果数量、下一页游标、continuation token，要提示用户。
+- 用户要求整理时，再转成表格、摘要或文件。
+
+失败时按 `agent-json` 的 `error.code` 和 `error.message` 解释。不要展示完整 Authorization 请求头、token、cookie 或敏感账号信息。

package/skills/yuanflow-skill//347/273/274/345/220/210/347/224/250/346/210/267/346/220/234/347/264/242/345/267/245/345/205/267/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: 综合用户搜索工具
+description: Use when the user wants to search creators, accounts, users, channels, authors, or profiles across Douyin, Xiaohongshu, WeChat Channels, TikTok, Instagram, Kuaishou, Weibo, YouTube, or Zhihu.
+builtin_skill_version: 1.0.0
+tags:
+  - 自媒体
+  - 用户搜索
+  - 作者搜索
+  - 账号搜索
+emoji: 👤
+---
+
+# 综合用户搜索工具
+
+本技能把用户的“搜索账号、作者、用户、频道、达人”需求稳定映射到 `yuanflow-cli search users`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+
+## 什么时候使用
+
+用户出现以下意图时使用：
+
+- 按关键词搜索某个平台上的账号、作者、达人、用户、频道。
+- 查找某个品牌、昵称、抖音号、小红书号、YouTube 频道等候选账号。
+- 做账号调研、达人筛选、用户线索查找。
+
+不要用于搜索作品、笔记、文章、帖子或视频；内容搜索应使用 `综合搜索工具`。不要用于批量抓取、绕过平台限制或未授权数据访问。
+
+## 调用优先级
+
+1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `search users` 开始。
+2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli search users ...`。
+3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
+
+YuanFlow 内置调用示例：
+
+```json
+{
+  "args": [
+    "search",
+    "users",
+    "--platform",
+    "instagram",
+    "--keyword",
+    "nasa",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+外部 CLI 示例：
+
+```powershell
+yuanflow-cli search users --platform instagram --keyword "nasa" --format agent-json
+```
+
+## 先查命令和 schema
+
+不确定参数时先查，不要猜：
+
+```json
+{"args":["commands","list"]}
+{"args":["schema","search.instagram.users"]}
+{"args":["schema","search.douyin.users"]}
+```
+
+命令 key 格式是：
+
+```text
+search.<platform>.users
+```
+
+## 平台识别
+
+| 平台参数 | 用户常见说法 | 搜索对象 | 常用补充参数 |
+|---|---|---|---|
+| `douyin` | 抖音、Douyin | 用户、达人、账号 | `--cursor` |
+| `xiaohongshu` | 小红书、XHS | 用户 | `--page` |
+| `wechat_channels` | 微信视频号、视频号 | 视频号用户 | `--page` |
+| `tiktok` | TikTok | 用户 | `--offset`、`--count` |
+| `instagram` | Instagram、ins | 用户 | `--rank-token` |
+| `kuaishou` | 快手 | 用户 | `--page` |
+| `weibo` | 微博 | 用户 | `--page`、`--region`、`--auth`、`--gender` |
+| `youtube` | YouTube、油管 | 频道 | `--continuation-token` |
+| `zhihu` | 知乎 | 用户 | `--offset`、`--limit` |
+
+B站、Reddit、Twitter/X 当前没有单独接入稳定用户搜索综合命令；如果用户指定这些平台，先说明当前工具不支持单独用户搜索，再建议使用 `综合搜索工具` 做内容/综合搜索，或用 `yuanflow-cli commands list` 查找可用原子接口。
+
+## 参数规则
+
+通用参数：
+
+- `--platform`：平台标识。
+- `--keyword`：用户、账号、频道或达人关键词。
+- `--cursor`、`--offset`、`--page`、`--continuation-token`：翻页参数，必须来自上一次响应，不要编造。
+- `--count`、`--limit`：数量参数，仅平台支持时传。
+- `--extra`：JSON 字符串补充参数。
+- `--format agent-json`：Agent 调用时必须加，便于稳定解析。
+
+## 输出要求
+
+成功后用中文简短说明：
+
+- 搜索的平台和关键词。
+- 返回结果中的昵称、账号 ID、主页标识、粉丝数等常用字段要按用户需求整理。
+- 如果响应里有下一页游标或 continuation token，要提示用户。
+
+失败时按 `agent-json` 的 `error.code` 和 `error.message` 解释。不要展示完整 Authorization 请求头、token、cookie 或敏感账号信息。

package/src/agent-protocol.js

@@ -1,5 +1,7 @@
 import { listEndpoints } from './registry.js';
 import { listShortcuts } from './shortcuts.js';
+import { listCommentCommands } from './comment-collector.js';
+import { listSearchCommands, listWorkCommands } from './work-tools.js';
 
 const ERROR_MAP = [
   {
@@ -81,7 +83,10 @@ export function getCommandName(platform, command) {
 export function buildCommandRegistry() {
   const shortcuts = listShortcuts().map((shortcut) => shortcutToCommand(shortcut));
   const endpoints = listEndpoints().map((endpoint) => endpointToCommand(endpoint));
-  return [...shortcuts, ...endpoints].sort((left, right) =>
+  const commentCommands = listCommentCommands();
+  const workCommands = listWorkCommands();
+  const searchCommands = listSearchCommands();
+  return [...shortcuts, ...endpoints, ...commentCommands, ...workCommands, ...searchCommands].sort((left, right) =>
     left.key.localeCompare(right.key),
   );
 }

package/src/cli.js

@@ -16,6 +16,13 @@ import {
   isAgentJsonFormat,
 } from './agent-protocol.js';
 import { findShortcut, listShortcuts } from './shortcuts.js';
+import { collectComments } from './comment-collector.js';
+import {
+  getWorkDetail,
+  getWorkDownload,
+  searchContent,
+  searchUsers,
+} from './work-tools.js';
 
 export async function main(argv) {
   const args = argv.slice(2);
@@ -46,6 +53,21 @@ export async function main(argv) {
     return;
   }
 
+  if (command === 'comments') {
+    await handleComments(rest);
+    return;
+  }
+
+  if (command === 'works') {
+    await handleWorks(rest);
+    return;
+  }
+
+  if (command === 'search') {
+    await handleSearch(rest);
+    return;
+  }
+
   if (command === 'schema') {
     await handleSchema(rest);
     return;
@@ -210,6 +232,99 @@ async function handleCall(args) {
   });
 }
 
+async function handleComments(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'collect'] = positionals;
+  if (action !== 'collect') {
+    throw new Error('未知 comments 命令。用法：yuanflow-cli comments collect --platform douyin --target <作品链接或ID>');
+  }
+  const platform = options.named?.platform;
+  const target = options.named?.target || positionals[1];
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、xiaohongshu、bilibili。');
+  }
+  if (!target) {
+    throw new Error('缺少 --target 或目标位置参数。');
+  }
+  const result = await collectComments({
+    platform,
+    action: options.named?.action || 'comments',
+    target,
+    prefer: options.named?.prefer || 'primary',
+    options,
+  });
+  await outputResult(result, options, {
+    command: 'comments collect',
+    meta: { endpoint: result.endpoint.path, kind: 'comment-collector' },
+  });
+}
+
+async function handleWorks(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'detail'] = positionals;
+  const platform = options.named?.platform;
+  const target = options.named?.target || positionals[1];
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、youtube、bilibili。');
+  }
+  if (!target) {
+    throw new Error('缺少 --target 或目标位置参数。');
+  }
+
+  let result;
+  if (action === 'detail') {
+    result = await getWorkDetail({
+      platform,
+      target,
+      prefer: options.named?.prefer || 'primary',
+      kind: options.named?.kind,
+      targetKind: options.named?.['target-kind'],
+      options,
+    });
+  } else if (action === 'download') {
+    result = await getWorkDownload({
+      platform,
+      target,
+      prefer: options.named?.prefer || 'primary',
+      kind: options.named?.kind,
+      targetKind: options.named?.['target-kind'],
+      options,
+    });
+  } else {
+    throw new Error('未知 works 命令。用法：yuanflow-cli works detail|download --platform douyin --target <作品链接或ID>');
+  }
+  await outputResult(result, options, {
+    command: `works ${action}`,
+    meta: { endpoint: result.endpoint.path, kind: result.endpoint.kind || `work-${action}` },
+  });
+}
+
+async function handleSearch(args) {
+  const { positionals, options } = parseOptions(args);
+  const [action = 'content'] = positionals;
+  const platform = options.named?.platform;
+  const keyword = options.named?.keyword || positionals[1];
+  if (!platform) {
+    throw new Error('缺少 --platform，例如 douyin、xiaohongshu、instagram。');
+  }
+  if (!keyword) {
+    throw new Error('缺少 --keyword 或关键词位置参数。');
+  }
+
+  let result;
+  if (action === 'content') {
+    result = await searchContent({ platform, keyword, options });
+  } else if (action === 'users' || action === 'user') {
+    result = await searchUsers({ platform, keyword, options });
+  } else {
+    throw new Error('未知 search 命令。用法：yuanflow-cli search content|users --platform douyin --keyword <关键词>');
+  }
+  await outputResult(result, options, {
+    command: `search ${action}`,
+    meta: { endpoint: result.endpoint.path, kind: result.endpoint.kind || `${action}-search` },
+  });
+}
+
 async function handleGeneratedCommand(platform, args) {
   if (!getPlatforms().includes(platform)) {
     throw new Error(`未知平台：${platform}。可用平台：${getPlatforms().join(', ')}`);
@@ -363,6 +478,11 @@ function printHelp() {
   yuanflow-cli shortcuts douyin
   yuanflow-cli commands list
   yuanflow-cli schema douyin.video-detail
+  yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/xxx/" --dry-run
+  yuanflow-cli works detail --platform douyin --target "https://v.douyin.com/xxx/" --dry-run
+  yuanflow-cli works download --platform youtube --target "dQw4w9WgXcQ" --dry-run
+  yuanflow-cli search content --platform xiaohongshu --keyword "美妆" --dry-run
+  yuanflow-cli search users --platform instagram --keyword "nasa" --dry-run
   yuanflow-cli list douyin
 
 说明：