@jackwener/opencli 1.6.1 → 1.6.2

package/skills/opencli-usage/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: opencli-usage
-description: "Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv). Covers installation, command reference, and output formats for 60+ adapters."
-version: 1.6.0
+description: "Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv). Covers installation, command reference, and output formats for 73+ adapters."
+version: 1.6.1
 author: jackwener
 tags: [opencli, cli, browser, web, chrome-extension, cdp, bilibili, twitter, reddit, xiaohongshu, github, youtube, AI, agent, automation]
 ---
@@ -44,8 +44,8 @@ Public API commands (`hackernews`, `v2ex`) need no browser.
 | **hot/trending** | Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban | browser.md / public-api.md |
 | **feed/timeline** | Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium | browser.md |
 | **user/profile** | Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv | browser.md |
-| **post/create** | Twitter, Jike | browser.md |
-| **AI chat** | Grok, Doubao, Kimi, DeepSeek, Qwen, ChatGPT, Cursor, Codex | browser.md / desktop.md |
+| **post/create** | Twitter, Jike, Douyin, Weibo | browser.md |
+| **AI chat** | Grok, Doubao, ChatGPT, Gemini, Cursor, Codex, NotebookLM | browser.md / desktop.md |
 | **finance/stock** | Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg | browser.md / public-api.md |
 | **web scraping** | `opencli web read --url <url>` — any URL to Markdown | browser.md |
 
@@ -59,9 +59,9 @@ Usage: `opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]`
 |------|----------|
 | **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `user-videos` `subtitle` `dynamic` `ranking` `following` |
 | **zhihu** | `hot` `search` `question` |
-| **xiaohongshu** | `search` `notifications` `feed` `user` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` |
-| **xueqiu** | `hot-stock` `stock` `watchlist` `feed` `hot` `search` `earnings-date` `fund-holdings` `fund-snapshot` |
-| **twitter** | `trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `post` `like` `reply` `delete` `block` `unblock` `followers` `following` `notifications` `hide-reply` `download` `accept` `reply-dm` |
+| **xiaohongshu** | `search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` |
+| **xueqiu** | `hot-stock` `stock` `watchlist` `feed` `hot` `search` `comments` `earnings-date` `fund-holdings` `fund-snapshot` |
+| **twitter** | `trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `post` `like` `likes` `reply` `delete` `block` `unblock` `followers` `following` `notifications` `hide-reply` `download` `accept` `reply-dm` |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` |
 | **youtube** | `search` `video` `transcript` |
 | **facebook** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` |
@@ -71,33 +71,40 @@ Usage: `opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]`
 | **medium** | `feed` `search` `user` |
 | **substack** | `feed` `search` `publication` |
 | **sinablog** | `hot` `search` `article` `user` |
-| **weibo** | `hot` |
+| **weibo** | `hot` `search` `feed` `user` `me` `post` `comments` |
+| **douyin** | `profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update` |
+| **bluesky** | `search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs` |
 | **boss** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` |
-| **douban** | `search` `top250` `subject` `photos` `download` `marks` `reviews` |
+| **douban** | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` |
 | **pixiv** | `ranking` `search` `user` `illusts` `detail` `download` |
-| **jike** | `feed` `search` `create` `like` `comment` `repost` `notifications` |
+| **jike** | `feed` `search` `create` `like` `comment` `repost` `notifications` `post` `topic` `user` |
+| **band** | `bands` `posts` `post` `mentions` |
+| **zsxq** | `groups` `dynamics` `topics` `topic` `search` |
+| **tieba** | `hot` `search` `posts` `read` |
 | **yahoo-finance** | `quote` |
 | **barchart** | `quote` `options` `greeks` `flow` |
 | **sinafinance** | `news` |
 | **reuters** | `search` |
+| **amazon** | `bestsellers` `search` `product` `offer` `discussion` |
 | **coupang** | `search` `add-to-cart` |
 | **jd** | `item` |
 | **smzdm** | `search` |
 | **ctrip** | `search` |
-| **weread** | `shelf` `search` `book` `highlights` `notes` `ranking` |
+| **36kr** | `hot` `news` `search` `article` |
+| **weread** | `shelf` `search` `book` `highlights` `notes` `notebooks` `ranking` |
 | **chaoxing** | `assignments` `exams` |
 | **jimeng** | `generate` `history` |
 | **yollomi** | `models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale` |
+| **ones** | `login` `logout` `me` `tasks` `task` `my-tasks` `worklog` `token-info` |
 | **web** | `read` — any URL to Markdown |
 | **weixin** | `download` — 公众号 article to Markdown |
 | **v2ex** (browser) | `daily` `me` `notifications` |
-| **linux-do** (browser) | `categories` `category` |
+| **linux-do** (browser) | `hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `user-posts` `user-topics` |
 | **bloomberg** (browser) | `news` — full article reader |
 | **grok** | `ask` |
-| **doubao** | `status` `new` `send` `read` `ask` |
-| **kimi** | `status` `new` `ask` |
-| **deepseek** | `status` `new` `ask` |
-| **qwen** | `status` `new` `ask` |
+| **doubao** | `status` `new` `send` `read` `ask` `detail` `history` `meeting-summary` `meeting-transcript` |
+| **gemini** | `ask` `new` `image` |
+| **notebooklm** | `status` `list` `open` `get` `current` `history` `summary` `note-list` `notes-get` `source-list` `source-get` `source-fulltext` `source-guide` |
 
 ### Desktop (CDP/Electron)
 
@@ -106,7 +113,7 @@ Usage: `opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]`
 | **gh** | `repo` `pr` `issue` — passthrough to gh CLI |
 | **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |
 | **codex** | `status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export` |
-| **chatgpt** | `status` `new` `send` `read` `ask` |
+| **chatgpt** | `status` `new` `send` `read` `ask` `model` |
 | **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` |
 | **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` |
 | **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` |
@@ -129,10 +136,13 @@ Usage: `opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]`
 | **bloomberg** (RSS) | `main` `markets` `tech` `politics` `economics` `opinions` `industries` `businessweek` `feeds` |
 | **dictionary** | `search` `synonyms` `examples` |
 | **hf** | `top` |
-| **stackoverflow** | `hot` `search` `bounties` |
+| **stackoverflow** | `hot` `search` `bounties` `unanswered` |
 | **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` |
-| **wikipedia** | `search` `summary` |
-| **producthunt** | `today` `week` `month` `search` |
+| **wikipedia** | `search` `summary` `random` `trending` |
+| **producthunt** | `today` `hot` `browse` `posts` |
+| **imdb** | `top` `trending` `search` `title` `person` `reviews` |
+| **spotify** | `auth` `status` `play` |
+| **paperreview** | `submit` `review` `feedback` |
 
 ### Management
 
@@ -148,5 +158,6 @@ All commands support: `--format` / `-f` with `table` `json` `yaml` `md` `csv`
 
 ## Related Skills
 
+- **opencli-operate** — Browser automation for AI agents (navigate, click, type, extract via Chrome)
 - **opencli-explorer** — Full guide for creating new adapters (API discovery, auth strategy, YAML/TS writing)
 - **opencli-oneshot** — Quick 4-step template for adding a single command from a URL

package/skills/opencli-usage/browser.md

@@ -29,10 +29,14 @@ opencli zhihu question 34816524            # 问题详情和回答 (id positiona
 ## Xiaohongshu (小红书)
 
 ```bash
-opencli xiaohongshu search "美食"           # 搜索笔记 (query positional)
-opencli xiaohongshu notifications             # 通知（mentions/likes/connections）
-opencli xiaohongshu feed --limit 10           # 推荐 Feed
-opencli xiaohongshu user xxx               # 用户主页 (id positional)
+opencli xiaohongshu search "美食"              # 搜索笔记 (query positional)
+opencli xiaohongshu note <note-id-or-url>      # 读取笔记正文和互动数据
+opencli xiaohongshu comments <note-id>         # 笔记评论
+opencli xiaohongshu notifications              # 通知（mentions/likes/connections）
+opencli xiaohongshu feed --limit 10            # 推荐 Feed
+opencli xiaohongshu user xxx                   # 用户主页 (id positional)
+opencli xiaohongshu download <note-id>         # 下载笔记图片/视频
+opencli xiaohongshu publish                    # 发布笔记
 opencli xiaohongshu creator-notes --limit 10   # 创作者笔记列表
 opencli xiaohongshu creator-note-detail --note-id xxx  # 笔记详情
 opencli xiaohongshu creator-notes-summary      # 笔记数据概览
@@ -116,6 +120,12 @@ opencli v2ex notifications --limit 10    # 通知
 
 ```bash
 opencli weibo hot --limit 10            # 微博热搜
+opencli weibo search "关键词"            # 搜索微博
+opencli weibo feed --limit 20           # 首页时间线
+opencli weibo user <uid>                # 用户信息
+opencli weibo me                        # 我的信息
+opencli weibo post "内容"               # 发微博
+opencli weibo comments <mid>            # 微博评论
 ```
 
 ## BOSS直聘
@@ -353,6 +363,10 @@ opencli doubao new                        # 新建对话
 opencli doubao send "你好"                # 发送消息 (text positional)
 opencli doubao read                       # 读取对话记录
 opencli doubao ask "问题"                 # 一键提问并等回复 (text positional)
+opencli doubao detail <id>                # 对话详情
+opencli doubao history                    # 历史对话列表
+opencli doubao meeting-summary <id>       # 会议总结
+opencli doubao meeting-transcript <id>    # 会议记录
 ```
 
 ## Grok
@@ -404,26 +418,110 @@ opencli linkedin timeline --limit 20     # 首页动态流
 opencli bloomberg news "https://..."      # 阅读 Bloomberg 文章全文 (link positional, browser)
 ```
 
-## Kimi
+## Gemini
 
 ```bash
-opencli kimi status                       # 检查 Kimi 页面状态
-opencli kimi new                          # 新建对话
-opencli kimi ask "问题"                   # 提问 (prompt positional)
+opencli gemini ask "问题"                 # 提问 (prompt positional)
+opencli gemini new                        # 新建对话
+opencli gemini image "描述"               # 生成图片
 ```
 
-## DeepSeek
+## NotebookLM
 
 ```bash
-opencli deepseek status                   # 检查 DeepSeek 页面状态
-opencli deepseek new                      # 新建对话
-opencli deepseek ask "问题"               # 提问 (prompt positional)
+opencli notebooklm status                 # 检查页面状态
+opencli notebooklm list                   # 列出所有笔记本
+opencli notebooklm open <notebook>        # 打开笔记本
+opencli notebooklm current                # 当前笔记本信息
+opencli notebooklm get                    # 获取笔记本详情
+opencli notebooklm history                # 对话历史
+opencli notebooklm summary                # 笔记本摘要
+opencli notebooklm source-list            # 列出来源
+opencli notebooklm source-get <source>    # 获取来源详情
+opencli notebooklm source-fulltext <src>  # 来源全文
+opencli notebooklm source-guide <src>     # 来源指南
+opencli notebooklm note-list              # 笔记列表
+opencli notebooklm notes-get <note>       # 获取笔记内容
 ```
 
-## Qwen (通义千问)
+## Bluesky
 
 ```bash
-opencli qwen status                       # 检查 Qwen 页面状态
-opencli qwen new                          # 新建对话
-opencli qwen ask "问题"                   # 提问 (prompt positional)
+opencli bluesky search "关键词"           # 搜索帖子 (query positional)
+opencli bluesky profile <handle>          # 用户资料
+opencli bluesky user <handle>             # 用户详情
+opencli bluesky feeds <handle>            # 用户 feeds
+opencli bluesky followers <handle>        # 粉丝列表
+opencli bluesky following <handle>        # 关注列表
+opencli bluesky thread <uri>              # 帖子线程
+opencli bluesky trending                  # 热门话题
+opencli bluesky starter-packs             # Starter packs
+```
+
+## Douyin (抖音)
+
+```bash
+opencli douyin profile                    # 创作者资料
+opencli douyin videos --limit 10          # 浏览视频
+opencli douyin user-videos                # 我的作品列表
+opencli douyin activities                 # 动态
+opencli douyin collections                # 收藏夹
+opencli douyin hashtag <tag>              # 话题页
+opencli douyin location <poi>             # 地点页
+opencli douyin stats                      # 数据统计
+opencli douyin publish                    # 发布视频
+opencli douyin draft                      # 编辑草稿
+opencli douyin drafts                     # 草稿列表
+opencli douyin delete <id>                # 删除作品
+opencli douyin update <id>                # 更新作品信息
+```
+
+## Band
+
+```bash
+opencli band bands                        # 列出已加入的 bands
+opencli band posts <band-id>              # Band 帖子列表
+opencli band post <post-key>              # 帖子详情
+opencli band mentions                     # 提到我的消息
+```
+
+## ZSXQ (知识星球)
+
+```bash
+opencli zsxq groups                       # 我加入的星球
+opencli zsxq dynamics <group-id>          # 星球动态
+opencli zsxq topics <group-id>            # 主题列表
+opencli zsxq topic <topic-id>             # 主题详情
+opencli zsxq search "关键词"              # 搜索
+```
+
+## Tieba (百度贴吧)
+
+```bash
+opencli tieba hot                         # 热门贴吧
+opencli tieba search "关键词"             # 搜索
+opencli tieba posts <forum>               # 帖子列表
+opencli tieba read <thread-id>            # 阅读帖子
+```
+
+## 36kr
+
+```bash
+opencli 36kr hot                          # 热门文章
+opencli 36kr news                         # 最新资讯
+opencli 36kr search "关键词"              # 搜索文章
+opencli 36kr article <id>                 # 文章全文
+```
+
+## ONES
+
+```bash
+opencli ones login                        # 登录
+opencli ones me                           # 我的信息
+opencli ones tasks --team <id>            # 项目任务列表
+opencli ones my-tasks                     # 我的任务
+opencli ones task <id>                    # 任务详情
+opencli ones worklog --task <id>          # 工时日志
+opencli ones token-info                   # Token 信息
+opencli ones logout                       # 登出
 ```

package/skills/opencli-usage/public-api.md

@@ -109,6 +109,8 @@ opencli xiaoyuzhou episode 12345          # 单集详情 (id positional)
 ```bash
 opencli wikipedia search "AI"             # 搜索 (query positional)
 opencli wikipedia summary "Python"        # 摘要 (title positional)
+opencli wikipedia random                  # 随机条目
+opencli wikipedia trending               # 热门条目
 ```
 
 ## Bloomberg (RSS)
@@ -143,7 +145,34 @@ opencli hf top --limit 10                # 热门模型
 
 ```bash
 opencli producthunt today --limit 10      # 今日产品
-opencli producthunt week --limit 10       # 本周产品
-opencli producthunt month --limit 10      # 本月产品
-opencli producthunt search "AI"           # 搜索产品 (query positional)
+opencli producthunt hot --limit 10        # 热门产品
+opencli producthunt browse --limit 10     # 浏览产品
+opencli producthunt posts --limit 10      # 最新产品
+```
+
+## IMDB
+
+```bash
+opencli imdb top --limit 10              # Top 250
+opencli imdb trending --limit 10         # 热门影视
+opencli imdb search "关键词"             # 搜索 (query positional)
+opencli imdb title <id>                  # 影视详情
+opencli imdb person <id>                 # 演员详情
+opencli imdb reviews <id>               # 评论
+```
+
+## Spotify
+
+```bash
+opencli spotify auth                     # OAuth 授权
+opencli spotify status                   # 播放状态
+opencli spotify play "歌曲"              # 播放 (query positional)
+```
+
+## Paper Review
+
+```bash
+opencli paperreview submit               # 提交论文
+opencli paperreview review               # 审阅
+opencli paperreview feedback             # 反馈
 ```

package/skills/smart-search/SKILL.md

@@ -0,0 +1,156 @@
+---
+name: smart-search
+description: 基于 opencli 命令的智能搜索路由器。当用户想要搜索、查询、查找或研究信息时，尤其是涉及指定网站、社交媒体、技术资料、新闻、购物、旅游、求职、金融或中文内容时，务必使用此 skill
+---
+
+# 智能搜索路由器
+
+根据话题和场景，将查询路由到最佳的 opencli 搜索源。此 skill 的核心目标不是记忆命令，而是先定位数据源，再让 Agent 通过 `opencli` 自己读取实时帮助，避免文档漂移。
+
+## 强制预检
+
+每次使用前，必须先做下面两步：
+
+- 运行 `opencli list -f yaml`
+- 用 live registry 确认候选站点是否存在，并检查 `strategy`、`browser`、`domain`
+
+选定站点后，必须再做下面两步：
+
+- 运行 `opencli <site> -h` 查看该站点有哪些子命令
+- 若已锁定某个子命令，再运行 `opencli <site> <command> -h` 查看参数、输出列、策略
+
+不要在 skill 文档里硬编码参数或假设命令签名；以 `opencli ... -h` 的实时输出为准。
+
+## 主路由规则
+
+只使用这一条规则，不再维护多套优先级：
+
+1. 当用户明确指定网站、平台或数据源时，直接使用对应网站。
+2. 当用户没有指定网站时，优先只选择一个 AI 源：`grok`、`doubao`、`gemini` 三选一。
+3. 当 AI 返回内容不足、缺少原始数据、需要权威佐证或需要垂直结果时，再补充 1-2 个专用源。
+
+## 单题预算与频率限制
+
+把“单个用户问题”理解为同一意图链路下的一次问题求解；同一轮追问、澄清、补充条件，若核心问题未变，仍算同一题。
+
+先建立一份站点调用台账。每次真正执行搜索命令后，立刻更新：
+
+- `site`
+- `query`
+- `count`
+- `status`
+
+计数规则：
+
+- `opencli list -f yaml`、`opencli <site> -h`、`opencli <site> <command> -h` 属于预检与帮助，不计入搜索次数
+- 一次真正的 `opencli <site> ...` 搜索/查询执行，计为该站点 1 次调用
+- 同站点因为报错、超时、验证码、反爬、登录态异常而失败，也算 1 次调用，不要无限重试
+
+频率上限：
+
+- AI 站点硬限制：同一题内，每个 AI 站点最多调用 1 次
+- 默认策略仍然是只选 1 个 AI 站点，不要把多个 AI 站点串成常规流程
+- 只有当用户明确要求比较多个 AI 站点时，才可以额外调用其他 AI 站点；但每个被点名的 AI 站点仍然最多 1 次
+- 非 AI 站点默认最多调用 2 次
+- 非 AI 站点第 2 次调用必须有明确理由，例如第一次结果过宽，需要加时间、地区、类别、排序或关键词限定
+- 非 AI 站点不要进行第 3 次调用；若信息仍不足，停止扩搜并明确说明缺口
+
+触发限频后的处理：
+
+- 记录：「已跳过：<site> 达到频率上限」
+- 优先改用其他同类站点
+- 若没有合适替代源，则直接基于已收集信息回答，并说明覆盖范围与缺口
+
+## 查询结束汇报
+
+每次查询结束后，回答末尾必须追加一段简短的“搜索摘要”，至少包含下面三项：
+
+- 使用了什么网站搜索
+- 每个网站搜了什么词
+- 每个网站搜了几次
+
+如果有被限频跳过的站点，也要明确写出。
+
+建议使用下面的固定格式：
+
+```md
+搜索摘要
+- 网站：<site1> | 查询词：<term1> | 次数：<n>
+- 网站：<site2> | 查询词：<term2>；<term3> | 次数：<n>
+- 已跳过：<site3>，原因：达到频率上限
+```
+
+## AI 源选择
+
+- `grok`
+  适合实时讨论、英文互联网舆论、Twitter/X 语境、热点追踪。
+- `doubao`
+  适合中文语境、字节抖音生态、生活方式内容、中文热点与泛中文问答。
+- `gemini`
+  适合全球网页、英文资料、通用信息检索、背景综述。
+
+如果用户没有指定网站，默认先判断语言和语境，再从这三个里只选一个。
+
+一旦某个 AI 站点已经执行过一次真实查询，就不要在同一题里改写关键词后再次调用该 AI 站点。若答案不足，优先补专用源，不要反复追打同一个 AI 站点。
+
+## AI 查询词建议
+
+当使用 AI 源时，不要只丢一个过短关键词。优先构造成“主题 + 目标 + 限定条件”的查询。
+
+- 主题
+  用户真正要查的对象、事件、产品、人物、公司、技术名词。
+- 目标
+  想要什么结果，例如总结、对比、原因、趋势、推荐、原始线索。
+- 限定条件
+  语言、地区、时间范围、平台范围、受众、价格带、岗位地点、是否要引用原始来源。
+
+优先使用下面这种表达方式：
+
+- `<主题> + <你要回答的问题>`
+- `<主题> + <时间范围/地区/语言>`
+- `<主题> + <平台或来源范围>`
+- `<主题> + <输出要求>`
+
+避免只输入：
+
+- 单个名词
+- 没有时间范围的热点问题
+- 没有地区限制的购物、求职、旅游问题
+- 没有平台限制的社交媒体问题
+
+## 专用源补充时机
+
+当出现以下任一情况时，再补充专用源：
+
+- AI 给出的是摘要，但你需要原始帖子、原始视频、原始商品或原始职位结果
+- AI 覆盖面不足，漏掉垂直站点信息
+- 需要更高权威性或更强领域相关性
+- 用户明确要求“从某个平台找”
+
+单次查询通常控制在 1 个 AI 源 + 1 到 2 个专用源，避免结果过载。
+
+## 处理不可用的源
+
+当站点不可用时：
+
+- 不要因为单个源失败而中止整个搜索
+- 记录：「已跳过：<site> 不可用」
+- 回退到同类其他站点，或回退到一个 AI 源
+- 始终以 `opencli list -f yaml` 与 `opencli <site> -h` 的实际结果为准
+
+不要假设任何站点“绝对可用”。即使是公开站点，也以当前环境中的 live help 和执行结果为准。
+
+## 参考文件
+
+根据需要读取对应文件：
+
+- **`references/sources-ai.md`** — AI 默认源
+- **`references/sources-tech.md`** — 技术 / 学术
+- **`references/sources-social.md`** — 社交媒体
+- **`references/sources-media.md`** — 媒体 / 娱乐
+- **`references/sources-info.md`** — 资讯 / 知识
+- **`references/sources-shopping.md`** — 购物
+- **`references/sources-travel.md`** — 旅游
+- **`references/sources-other.md`** — 其他垂直源
+
+只读与当前查询相关的文件，无需全部加载。

package/skills/smart-search/references/sources-ai.md

@@ -0,0 +1,74 @@
+# AI 默认源
+
+当用户没有明确指定网站时，先在 `grok`、`doubao`、`gemini` 中选择一个，不要一开始并行跑多个 AI 源。
+
+## 使用规则
+
+1. 先运行 `opencli list -f yaml`
+2. 确认 `grok`、`doubao`、`gemini` 哪些在当前 registry 中可用
+3. 运行 `opencli <site> -h`
+4. 锁定具体子命令后，再运行 `opencli <site> <command> -h`
+
+## 路由建议
+
+### grok
+
+- 适用：实时热点、Twitter/X 语境、英文互联网讨论、舆论与趋势
+- 补充源常见去向：`twitter`、`reddit`、`reuters`、`google`
+- 搜索词建议：
+  - 加上时间范围，例如“today / this week”
+  - 加上平台范围，例如“on X”, “from social posts”
+  - 加上目标，例如“latest reactions”, “main viewpoints”, “key claims”
+  - 示例：
+    - `OpenAI latest reactions on X this week`
+    - `TSLA earnings main viewpoints on social media April 2026`
+    - `Nintendo Switch 2 rumors latest discussion on X`
+
+### doubao
+
+- 适用：中文语境、国内热点、生活方式、字节生态、中文泛问答
+- 补充源常见去向：`xiaohongshu`、`weibo`、`zhihu`、`bilibili`、`36kr`
+- 搜索词建议：
+  - 加上中文场景限定，例如“中文讨论”“国内用户”“小红书/微博语境”
+  - 加上需求目标，例如“帮我总结”“给我对比”“提取推荐理由”
+  - 加上人群或用途，例如“适合新手”“预算 500 元内”“上海求职”
+  - 示例：
+    - `2026年MacBook Air值得买吗 中文讨论里主要观点是什么`
+    - `上海 AI 产品经理招聘趋势 近一个月中文信息总结`
+    - `敏感肌防晒推荐 中文用户常提到的优缺点`
+
+### gemini
+
+- 适用：全球网页、英文资料、背景综述、通用检索
+- 补充源常见去向：`google`、`wikipedia`、`arxiv`、`stackoverflow`
+- 搜索词建议：
+  - 加上主题类型，例如“overview”, “comparison”, “background”, “best sources”
+  - 加上范围限定，例如地区、时间、语言、行业
+  - 加上结果形式，例如“with sources”, “compare pros and cons”, “official guidance”
+  - 示例：
+    - `MCP overview and official guidance with sources`
+    - `best budget travel destinations in Japan April 2026 compare pros and cons`
+    - `TypeScript decorators current status official sources`
+
+## 补充原则
+
+- 先用一个 AI 源拿到初步答案
+- 若答案缺少原始数据、垂直结果或权威来源，再补 1-2 个专用源
+- 不要把 AI 默认源当成命令签名的事实来源；命令细节始终以 `opencli ... -h` 为准
+
+## 通用写法模板
+
+可直接按下面模板构造 AI 查询：
+
+- 热点/新闻：
+  `<事件> + 最新进展 + <时间范围> + <地区/平台>`
+- 对比/推荐：
+  `<对象A> vs <对象B> + <关注维度> + <人群/预算/用途>`
+- 中文社区：
+  `<主题> + 中文讨论里主要观点 + <时间范围>`
+- 全球资料：
+  `<主题> + overview/background + with sources`
+- 求职：
+  `<岗位> + <城市/国家> + market trends/hiring + <时间范围>`
+- 购物：
+  `<商品> + reviews/price/value + <地区/预算>`

package/skills/smart-search/references/sources-info.md

@@ -0,0 +1,43 @@
+# 资讯 / 知识
+
+用于新闻、百科、通用知识、中文科技资讯。
+
+## 站点
+
+### google
+
+- 适用：通用网页搜索、跨站点兜底
+- 使用前先运行：`opencli google -h`
+
+### wikipedia
+
+- 适用：名词解释、背景知识、历史事实
+- 使用前先运行：`opencli wikipedia -h`
+
+### reuters
+
+- 适用：国际新闻、事实性报道
+- 使用前先运行：`opencli reuters -h`
+
+### weibo
+
+- 适用：微博热点、话题、中文舆论
+- 使用前先运行：`opencli weibo -h`
+
+### 36kr
+
+- 适用：中文科技、创业、融资资讯
+- 使用前先运行：`opencli 36kr -h`
+
+### substack
+
+- 适用：newsletter、作者订阅内容、长文
+- 使用前先运行：`opencli substack -h`
+
+## 路由提示
+
+- 背景知识与定义，优先 `wikipedia`
+- 通用网页与跨站信息，优先 `google`
+- 国际新闻优先 `reuters`
+- 中文科技资讯优先 `36kr`
+- 当 AI 回答过于泛化时，用这些源补充事实和链接

package/skills/smart-search/references/sources-media.md

@@ -0,0 +1,50 @@
+# 媒体 / 娱乐
+
+用于视频、电影、剧集、音乐、播客、内容平台搜索。
+
+## 站点
+
+### bilibili
+
+- 适用：中文视频、教程、评测、UP 主内容
+- 使用前先运行：`opencli bilibili -h`
+
+### youtube
+
+- 适用：英文视频、教程、评测、访谈
+- 使用前先运行：`opencli youtube -h`
+
+### tiktok
+
+- 适用：短视频、热点、娱乐内容
+- 使用前先运行：`opencli tiktok -h`
+
+### imdb
+
+- 适用：电影、剧集、演员、评分
+- 使用前先运行：`opencli imdb -h`
+
+### douban
+
+- 适用：中文电影、书籍、音乐口碑与评分
+- 使用前先运行：`opencli douban -h`
+
+### spotify
+
+- 适用：歌曲、歌手、专辑
+- 使用前先运行：`opencli spotify -h`
+
+### apple-podcasts
+
+- 适用：播客节目、播客搜索
+- 使用前先运行：`opencli apple-podcasts -h`
+
+### medium
+
+- 适用：长文、技术博客、设计与产品文章
+- 使用前先运行：`opencli medium -h`
+
+## 路由提示
+
+- 用户只说“找视频/影评/播客/文章”，先按内容形态选站点
+- 用户没有指定站点时，可先用 `doubao`、`grok` 或 `gemini` 做一轮粗检索，再补媒体站点拿原始结果