yuanflow-cli 0.1.5 → 0.1.6

package/README.md

@@ -31,6 +31,10 @@ 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
 ```
 
@@ -63,6 +67,26 @@ yuanflow-cli comments collect --platform youtube --target video_id --action comm
 
 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.5",
+  "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

@@ -14,6 +14,10 @@ description: Use when the user asks about social-media API workflows, platform d
 - 根目录这一份 `SKILL.md`
 - `yuanflow-cli/`
 - `作品评论采集/`
+- `作品详情获取工具/`
+- `作品下载综合工具/`
+- `综合搜索工具/`
+- `综合用户搜索工具/`
 
 ## 环境判断
 
@@ -61,6 +65,54 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `作品评论采集`
 
+### 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，按阶段拆开：
@@ -72,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

@@ -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`。
 
 ## 先判断是否要用
 
@@ -136,6 +136,10 @@ yuanflow-cli list douyin
   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 覆盖的平台包括：
@@ -212,6 +216,28 @@ yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/x
 }
 ```
 
+### 综合作品与搜索入口
+
+新增综合入口优先给 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

@@ -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/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,6 +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 = [
   {
@@ -83,7 +84,9 @@ export function buildCommandRegistry() {
   const shortcuts = listShortcuts().map((shortcut) => shortcutToCommand(shortcut));
   const endpoints = listEndpoints().map((endpoint) => endpointToCommand(endpoint));
   const commentCommands = listCommentCommands();
-  return [...shortcuts, ...endpoints, ...commentCommands].sort((left, right) =>
+  const workCommands = listWorkCommands();
+  const searchCommands = listSearchCommands();
+  return [...shortcuts, ...endpoints, ...commentCommands, ...workCommands, ...searchCommands].sort((left, right) =>
     left.key.localeCompare(right.key),
   );
 }