yuanflow-cli 0.1.5 → 0.1.7

package/README.md

@@ -31,6 +31,13 @@ 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 knowledge docs --format agent-json
+yuanflow-cli knowledge entry --task-intent generate_script --content-goal "写一个创业者短视频选题" --format agent-json
+yuanflow-cli oss signed-url --key path/to/file.png --ttl-seconds 1800 --format agent-json
 yuanflow-cli list douyin
 ```
 
@@ -63,6 +70,51 @@ 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。
+
+### 自媒体知识库
+
+知识库能力独立于社媒 `/social` 接口，走 Yuan API 的 `/api/knowledge-base/docs` 和 `/atomic/agent-rules/navigate`：
+
+```bash
+yuanflow-cli knowledge docs --format agent-json
+yuanflow-cli knowledge entry --task-intent generate_script --output-format short_video_script --domain 自媒体运营 --content-goal "写一个创业者短视频选题" --format agent-json
+yuanflow-cli knowledge rules --pack-code topic_pain_point_pack --task-intent generate_script --content-goal "写一个创业者短视频选题" --format agent-json
+yuanflow-cli knowledge rule-detail --rule-code some_rule_code --task-intent generate_script --content-goal "写一个创业者短视频选题" --format agent-json
+```
+
+Agent 应先查看 `knowledge docs`，再把用户需求整理成 `task_frame`，按接口返回的 `next_actions` 渐进查询。
+
+### OSS 原子能力
+
+OSS 能力独立封装为 `oss` 命令，用于临时上传、签名链接和对象复制：
+
+```bash
+yuanflow-cli oss temp-upload --file ./cover.png --content-type image/png --format agent-json
+yuanflow-cli oss signed-url --key path/to/file.png --ttl-seconds 1800 --method GET --format agent-json
+yuanflow-cli oss copy --source-key temp/cover.png --target-key final/cover.png --format agent-json
+```
+
+上传本地文件前必须确认用户授权，不能上传密钥、cookie、账号凭据或隐私文件。
+
 ## Skill 安装器
 
 ```bash

package/package.json

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

package/skills/yuanflow-skill/OSS/346/226/207/344/273/266/344/270/255/350/275/254/345/267/245/345/205/267/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: OSS文件中转工具
+description: 当用户需要把本地文件上传到 YuanFlow 临时 OSS、生成对象签名访问链接、复制 OSS 对象，或为自媒体工作流准备图片、音频、视频、文档中转链接时使用。
+---
+
+# OSS 文件中转工具
+
+这个 Skill 负责使用 YuanFlow 的 OSS 原子能力。它只处理文件中转、签名链接和对象复制，不负责社媒数据采集。
+
+## 环境判断
+
+1. 在 YuanFlow 主程序内，优先调用内置工具 `yuanflow_cli_call`。
+2. 在外部 Agent 中，如果本地有 `yuanflow-cli`，直接执行 CLI。
+3. 如果外部环境没有 CLI，再提示用户安装 `npm install -g yuanflow-cli`。
+
+不要要求用户手动填写 token。YuanFlow 主程序会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+
+## 能做什么
+
+- 上传本地图片、音频、视频、文档到临时 OSS。
+- 为已有 OSS 对象生成临时签名 URL。
+- 把一个 OSS 对象复制到另一个 key。
+- 为后续自媒体创作、发布、转写、封面处理等流程提供临时文件链接。
+
+## 命令
+
+### 临时上传
+
+```bash
+yuanflow-cli oss temp-upload \
+  --file ./cover.png \
+  --content-type image/png \
+  --format agent-json
+```
+
+可选参数：
+
+- `--filename`：指定上传文件名。
+- `--key`：指定 OSS 对象 key。
+- `--content-type`：MIME 类型，默认 `application/octet-stream`。
+
+### 生成签名链接
+
+```bash
+yuanflow-cli oss signed-url \
+  --key path/to/file.png \
+  --ttl-seconds 1800 \
+  --method GET \
+  --format agent-json
+```
+
+可选参数：
+
+- `--bucket`：指定 bucket。
+- `--ttl-seconds`：有效期，最大值由后端限制。
+- `--method`：`GET`、`PUT`、`HEAD`。
+
+### 复制对象
+
+```bash
+yuanflow-cli oss copy \
+  --source-key temp/cover.png \
+  --target-key final/cover.png \
+  --format agent-json
+```
+
+可选参数：
+
+- `--source-bucket`：源 bucket。
+- `--target-bucket`：目标 bucket。
+
+## YuanFlow 内置工具调用示例
+
+在 YuanFlow 主程序内，调用 `yuanflow_cli_call`，参数数组不要包含 token：
+
+```json
+{
+  "args": [
+    "oss",
+    "signed-url",
+    "--key",
+    "path/to/file.png",
+    "--ttl-seconds",
+    "1800",
+    "--format",
+    "agent-json"
+  ]
+}
+```
+
+## 安全边界
+
+- 上传本地文件前，先确认用户明确授权该文件路径。
+- 不上传密钥、cookie、账号凭据、配置文件、隐私文件。
+- 不把签名 URL 写入公开文档或长期日志。
+- 返回结果中优先说明 `bucket`、`key`、`expires_at`，只有用户确实需要访问链接时才展示 `signed_url`。
+- 在 YuanFlow 主程序中，如果工具策略限制本地文件上传，不要绕过限制，改为让用户通过受控上传入口完成。

package/skills/yuanflow-skill/SKILL.md

@@ -14,6 +14,12 @@ description: Use when the user asks about social-media API workflows, platform d
 - 根目录这一份 `SKILL.md`
 - `yuanflow-cli/`
 - `作品评论采集/`
+- `作品详情获取工具/`
+- `作品下载综合工具/`
+- `综合搜索工具/`
+- `综合用户搜索工具/`
+- `自媒体知识库/`
+- `OSS文件中转工具/`
 
 ## 环境判断
 
@@ -61,6 +67,78 @@ 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 名称：
+
+- `综合用户搜索工具`
+
+### 7. 走 `自媒体知识库`
+
+遇到下面这些需求，优先进入这个子 Skill：
+
+- 自媒体选题、开头钩子、脚本、文案、标题、改写、评分、剪辑建议、发布策略。
+- 用户明确要求查询 YuanFlow 自媒体知识库、方法包、规则方向。
+- 需要按照知识库 `next_actions` 渐进式查询方法论摘要。
+
+子 Skill 名称：
+
+- `自媒体知识库`
+
+### 8. 走 `OSS文件中转工具`
+
+遇到下面这些需求，优先进入这个子 Skill：
+
+- 上传图片、音频、视频、文档到临时 OSS。
+- 为已有 OSS 对象生成签名访问链接。
+- 复制 OSS 对象，或为其它自媒体流程准备文件中转链接。
+
+子 Skill 名称：
+
+- `OSS文件中转工具`
+
 ## 多需求时怎么处理
 
 如果用户一次提了多段流程，不要强行塞进一个子 Skill，按阶段拆开：
@@ -72,7 +150,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 或敏感账号信息。