@jackwener/opencli 1.6.1 → 1.6.2

package/docs/.vitepress/config.mts

@@ -54,6 +54,7 @@ export default defineConfig({
                 { text: 'Bilibili', link: '/adapters/browser/bilibili' },
                 { text: 'Zhihu', link: '/adapters/browser/zhihu' },
                 { text: 'Xiaohongshu', link: '/adapters/browser/xiaohongshu' },
+                { text: 'Xiaoe', link: '/adapters/browser/xiaoe' },
                 { text: 'Weibo', link: '/adapters/browser/weibo' },
                 { text: 'YouTube', link: '/adapters/browser/youtube' },
                 { text: 'Xueqiu', link: '/adapters/browser/xueqiu' },
@@ -73,7 +74,9 @@ export default defineConfig({
                 { text: 'Chaoxing', link: '/adapters/browser/chaoxing' },
                 { text: 'Grok', link: '/adapters/browser/grok' },
                 { text: 'Amazon', link: '/adapters/browser/amazon' },
+                { text: '1688', link: '/adapters/browser/1688' },
                 { text: 'Gemini', link: '/adapters/browser/gemini' },
+                { text: 'Yuanbao', link: '/adapters/browser/yuanbao' },
                 { text: 'NotebookLM', link: '/adapters/browser/notebooklm' },
                 { text: 'WeRead', link: '/adapters/browser/weread' },
                 { text: 'Douban', link: '/adapters/browser/douban' },
@@ -91,6 +94,7 @@ export default defineConfig({
                 { text: 'TikTok', link: '/adapters/browser/tiktok' },
                 { text: 'Web (Generic)', link: '/adapters/browser/web' },
                 { text: 'Weixin', link: '/adapters/browser/weixin' },
+                { text: 'Xianyu', link: '/adapters/browser/xianyu' },
               ],
             },
             {

package/docs/adapters/browser/1688.md

@@ -0,0 +1,52 @@
+# 1688
+
+**Mode**: 🔐 Browser · **Domain**: `1688.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli 1688 search "<query>" --limit <n>` | Search public product candidates with price, MOQ, seller link, and visible badges |
+| `opencli 1688 item <url-or-offer-id>` | Read a public product detail page with price tiers, MOQ, delivery text, and seller basics |
+| `opencli 1688 store <url-or-member-id>` | Read a public supplier/store page with company info, years on platform, categories, and visible service signals |
+
+## Usage Examples
+
+```bash
+# Search products
+opencli 1688 search "桌面置物架 宿舍 收纳" --limit 10
+
+# JSON output
+opencli 1688 search "桌面置物架 宿舍 收纳" --limit 10 -f json
+
+# Read an item by offer id
+opencli 1688 item 841141931191 -f json
+
+# Read an item by URL
+opencli 1688 item https://detail.1688.com/offer/841141931191.html -f json
+
+# Read a supplier store
+opencli 1688 store https://shop52908bfw19166.1688.com/ -f json
+
+# Read a supplier by member id
+opencli 1688 store b2b-22154705262941f196 -f json
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** `1688.com`
+- [Browser Bridge extension](/guide/browser-bridge) installed
+
+## Notes
+
+- This adapter only returns fields visible on public pages. It does not send inquiries, place orders, or access seller back office data.
+- Prefer stable identifiers such as `offer_id`, `member_id`, and `shop_id` for follow-up workflows.
+- `search --limit` defaults to `20` and is capped at `100`.
+- `search` deduplicates with key priority: `offer_id` first, then canonical `item_url`.
+- `item` can be more sensitive to the active browser target than `search` or `store`.
+
+## Troubleshooting
+
+- If `opencli 1688 item` reports `did not expose product context`, first make sure the open page is a real `detail.1688.com` item page.
+- If the browser target is too broad, retry with `OPENCLI_CDP_TARGET=detail.1688.com`.
+- If you hit a slider or verification page, refresh the real page in Chrome and retry.

package/docs/adapters/browser/36kr.md

@@ -44,4 +44,5 @@ opencli 36kr hot -f json
 
 ## Prerequisites
 
-- No browser required — uses public API
+- `news`: No browser required — uses public RSS feed
+- `hot`, `search`, `article`: Chrome running with [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/doubao.md

@@ -11,12 +11,16 @@ Browser adapter for [Doubao Chat](https://www.doubao.com/chat).
 | `opencli doubao send "..."` | Send a message to the current Doubao chat |
 | `opencli doubao read` | Read the visible Doubao conversation |
 | `opencli doubao ask "..."` | Send a prompt and wait for a reply |
+| `opencli doubao detail <id>` | 对话详情 |
+| `opencli doubao history` | 历史对话列表 |
+| `opencli doubao meeting-summary <id>` | 会议总结 |
+| `opencli doubao meeting-transcript <id>` | 会议记录 |
 
 ## Prerequisites
 
 - Chrome is running
 - You are already logged into [doubao.com](https://www.doubao.com/)
-- Playwright MCP Bridge / browser bridge is configured for OpenCLI
+- Browser Bridge extension is installed and enabled for OpenCLI
 
 ## Examples
 

package/docs/adapters/browser/hupu.md

@@ -0,0 +1,53 @@
+# Hupu (虎扑)
+
+**Mode**: 🌐 Public / 🔐 Browser · **Domain**: `bbs.hupu.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli hupu hot` | Read Hupu hot threads |
+| `opencli hupu search <keyword>` | Search Hupu threads by keyword |
+| `opencli hupu detail <tid>` | Read one thread and optional hot replies |
+| `opencli hupu reply <tid> <text>` | Reply to a thread or quote one reply |
+| `opencli hupu like <tid> <pid>` | Like one reply |
+| `opencli hupu unlike <tid> <pid>` | Cancel like on one reply |
+
+## Usage Examples
+
+```bash
+# Hot threads
+opencli hupu hot --limit 5
+
+# Search threads
+opencli hupu search 湖人 --limit 10
+
+# Read one thread and include hot replies
+opencli hupu detail 638234927 --replies true
+
+# Reply to the thread
+opencli hupu reply 638234927 "hello from opencli" --topic_id 502
+
+# Quote one hot reply by pid
+opencli hupu reply 638234927 "replying to this comment" --topic_id 502 --quote_id 174908
+
+# Like / unlike one reply
+opencli hupu like 638234927 174908 --fid 4860
+opencli hupu unlike 638234927 174908 --fid 4860
+
+# JSON output
+opencli hupu detail 638234927 -f json
+```
+
+## Notes
+
+- `reply --topic_id` maps to Hupu's API `topicId`, for example `502` for Basketball News
+- `reply --quote_id` is the quoted reply `pid`
+- `like` / `unlike --fid` uses the forum ID from thread metadata
+- `detail --replies true` appends top hot replies to the content field
+
+## Prerequisites
+
+- Chrome running and able to open `bbs.hupu.com`
+- [Browser Bridge extension](/guide/browser-bridge) installed
+- For `reply`, `like`, and `unlike`, a valid Hupu login session in Chrome is required

package/docs/adapters/browser/sinafinance.md

@@ -9,6 +9,7 @@
 | `opencli sinafinance news` | 新浪财经 7×24 小时实时快讯 | 🌐 Public |
 | `opencli sinafinance rolling-news` | 新浪财经滚动新闻 | 🔐 Browser |
 | `opencli sinafinance stock` | 新浪财经行情（A股/港股/美股） | 🌐 Public |
+| `opencli sinafinance stock-rank` | 新浪财经热搜榜 | 🔐 Browser |
 
 ## Usage Examples
 
@@ -56,6 +57,28 @@ opencli sinafinance stock 招商证券
 opencli sinafinance stock 贵州茅台 -f json
 ```
 
+### stock-rank - 热搜榜
+
+```bash
+# Default A股热搜榜
+opencli sinafinance stock-rank
+
+# 港股热搜榜
+opencli sinafinance stock-rank --market hk
+
+# 美股热搜榜
+opencli sinafinance stock-rank --market us
+
+# 外汇热搜榜
+opencli sinafinance stock-rank --market ft
+
+# 期货热搜榜
+opencli sinafinance stock-rank --market wh
+
+# JSON output
+opencli sinafinance stock-rank -f json
+```
+
 ## Options
 
 ### news
@@ -71,11 +94,17 @@ opencli sinafinance stock 贵州茅台 -f json
 |--------|-------------|
 | `--market` | Market: `cn`, `hk`, `us`, `auto` (default: auto). When `auto`, searches in cn, hk, us order |
 
+### stock-rank
+
+| Option | Description |
+|--------|-------------|
+| `--market` | Market: `cn` (A股, 默认), `ft` (期货), `us` (美股), `wh` (外汇), `hk` (港股) |
+
 ## Prerequisites
 
 - `news` & `stock`: No browser required — uses public API
-- `rolling-news`: Chrome running and **logged into** `finance.sina.com.cn`
-- For `rolling-news`: [Browser Bridge extension](/guide/browser-bridge) installed
+- `rolling-news` & `stock-rank`: Chrome running and **logged into** `finance.sina.com.cn`
+- For `rolling-news` & `stock-rank`: [Browser Bridge extension](/guide/browser-bridge) installed
 
 ## Notes
 
@@ -83,3 +112,4 @@ opencli sinafinance stock 贵州茅台 -f json
 - `stock` supports Chinese names, Chinese codes, and ticker symbols; auto-detects market
 - Market priority for auto-detection: cn (A股) → hk (港股) → us (美股)
 - US stock `High`/`Low` columns show 52-week range; A股/港股 show today's range
+- `stock-rank` scrapes the hot search list from the Sina Finance homepage; requires browser login

package/docs/adapters/browser/weibo.md

@@ -6,8 +6,13 @@
 
 | Command | Description |
 |---------|-------------|
-| `opencli weibo hot` | |
+| `opencli weibo hot` | 微博热搜 |
 | `opencli weibo search` | Search Weibo posts by keyword |
+| `opencli weibo feed` | 首页时间线 |
+| `opencli weibo user` | 用户信息 |
+| `opencli weibo me` | 我的信息 |
+| `opencli weibo post` | 发微博 |
+| `opencli weibo comments` | 微博评论 |
 
 ## Usage Examples
 

package/docs/adapters/browser/wikipedia.md

@@ -8,6 +8,8 @@
 |---------|-------------|
 | `opencli wikipedia search` | Search Wikipedia articles |
 | `opencli wikipedia summary` | Get Wikipedia article summary |
+| `opencli wikipedia random` | Random Wikipedia article |
+| `opencli wikipedia trending` | Trending Wikipedia articles |
 
 ## Usage Examples
 

package/docs/adapters/browser/xianyu.md

@@ -0,0 +1,42 @@
+# Xianyu (闲鱼)
+
+**Mode**: 🔐 Browser · **Domain**: `goofish.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli xianyu search <query>` | Search Xianyu items by keyword and return item cards with `item_id` |
+| `opencli xianyu item <item_id>` | Fetch item details including title, price, condition, brand, seller, and image URLs |
+| `opencli xianyu chat <item_id> <user_id>` | Open a Xianyu chat session for the item/user pair and optionally send a message with `--text` |
+
+## Usage Examples
+
+```bash
+# Search items
+opencli xianyu search "macbook" --limit 5
+
+# Read a single item's details
+opencli xianyu item 1040754408976
+
+# Open a chat session
+opencli xianyu chat 1038951278192 3650092411
+
+# Send a message in chat
+opencli xianyu chat 1038951278192 3650092411 --text "你好，这个还在吗？"
+
+# JSON output
+opencli xianyu search "笔记本电脑" -f json
+opencli xianyu item 1040754408976 -f json
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** `goofish.com`
+- [Browser Bridge extension](/guide/browser-bridge) installed
+
+## Notes
+
+- `search` returns `item_id`, which can be passed directly into `opencli xianyu item`
+- `chat` requires both the item ID and the target user's `user_id` / `peerUserId`
+- Browser-authenticated commands depend on the active Chrome login session remaining valid

package/docs/adapters/browser/xiaoe.md

@@ -0,0 +1,44 @@
+# Xiaoe (小鹅通)
+
+**Mode**: 🔐 Browser · **Domain**: `study.xiaoe-tech.com` / `*.h5.xet.citv.cn`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli xiaoe courses` | List purchased courses with course URLs and shop names |
+| `opencli xiaoe detail <url>` | Read course metadata such as title, price, student count, and shop |
+| `opencli xiaoe catalog <url>` | Read the full course outline for normal courses, columns, and big columns |
+| `opencli xiaoe play-url <url>` | Resolve the M3U8 playback URL for video lessons or live replays |
+| `opencli xiaoe content <url>` | Extract rich-text lesson or page content as plain text |
+
+## Usage Examples
+
+```bash
+# List purchased courses
+opencli xiaoe courses --limit 10
+
+# Read course metadata
+opencli xiaoe detail "https://appxxxx.h5.xet.citv.cn/p/course/ecourse/v_xxxxx"
+
+# Read the course outline
+opencli xiaoe catalog "https://appxxxx.h5.xet.citv.cn/p/course/ecourse/v_xxxxx"
+
+# Resolve a lesson M3U8 URL
+opencli xiaoe play-url "https://appxxxx.h5.xet.citv.cn/v1/course/video/v_xxxxx?product_id=p_xxxxx" -f json
+
+# Extract page content
+opencli xiaoe content "https://appxxxx.h5.xet.citv.cn/v1/course/text/t_xxxxx"
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** the target Xiaoe shop
+- [Browser Bridge extension](/guide/browser-bridge) installed
+
+## Notes
+
+- `courses` starts from `study.xiaoe-tech.com` and matches purchased course cards back to Vue data to recover shop names and course URLs
+- `catalog` supports normal courses, columns, and big columns by reading Vuex / Vue component state after the course page loads
+- `play-url` uses a direct API path for video lessons and falls back to runtime resource inspection for live replays
+- Cross-shop course URLs are preserved, so you can take a URL from `courses` and pass it directly into `detail`, `catalog`, `play-url`, or `content`

package/docs/adapters/browser/yuanbao.md

@@ -0,0 +1,64 @@
+# Yuanbao
+
+**Mode**: 🔐 Browser · **Domain**: `yuanbao.tencent.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli yuanbao new` | Start a new Yuanbao conversation |
+| `opencli yuanbao ask <prompt>` | Send a prompt to Yuanbao web chat and wait for the reply |
+
+## Usage Examples
+
+```bash
+# Start a fresh chat
+opencli yuanbao new
+
+# Basic ask (internet search on by default, deep thinking off by default)
+opencli yuanbao ask "你好"
+
+# Wait longer for a longer answer
+opencli yuanbao ask "帮我总结这篇文章" --timeout 90
+
+# Disable internet search explicitly
+opencli yuanbao ask "你好" --search false
+
+# Enable deep thinking explicitly
+opencli yuanbao ask "你好" --think true
+```
+
+## Options
+
+### `new`
+
+- No options
+
+### `ask`
+
+| Option | Description |
+|--------|-------------|
+| `prompt` | Prompt to send (required positional argument) |
+| `--timeout` | Max seconds to wait for a reply (default: `60`) |
+| `--search` | Enable internet search before sending (default: `true`) |
+| `--think` | Enable deep thinking before sending (default: `false`) |
+
+## Behavior
+
+- The adapter targets the Yuanbao consumer web UI and sends the prompt through the visible Quill composer.
+- `new` clicks the left-side Yuanbao new-chat trigger and falls back to reloading the Yuanbao homepage if needed.
+- Before sending, it aligns the `联网搜索` and `深度思考` buttons to the requested `--search` / `--think` state.
+- It waits for transcript changes to stabilize before returning the assistant reply.
+- If Yuanbao opens a login gate instead of answering, the command returns a `[BLOCKED]` system message with a session hint.
+
+## Prerequisites
+
+- Chrome is running
+- You are already logged into `yuanbao.tencent.com`
+- [Browser Bridge extension](/guide/browser-bridge) is installed
+
+## Caveats
+
+- This adapter drives the Yuanbao web UI, not a public API.
+- It depends on the current browser session and may fail if Yuanbao shows login, consent, challenge, or other gating UI.
+- DOM or product changes on Yuanbao can break composer detection, submit behavior, or transcript extraction.

package/docs/adapters/index.md

@@ -6,17 +6,19 @@ Run `opencli list` for the live registry.
 
 | Site | Commands | Mode |
 |------|----------|------|
-| **[twitter](./browser/twitter)** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` `block` `unblock` `hide-reply` | 🔐 Browser |
+| **[twitter](./browser/twitter)** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `likes` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` `block` `unblock` `hide-reply` | 🔐 Browser |
 | **[reddit](./browser/reddit)** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 Browser |
 | **[tieba](./browser/tieba)** | `hot` `posts` `search` `read` | 🔐 Browser |
+| **[hupu](./browser/hupu)** | `hot` `search` `detail` `reply` `like` `unlike` | 🌐 / 🔐 |
 | **[bilibili](./browser/bilibili)** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 Browser |
 | **[zhihu](./browser/zhihu)** | `hot` `search` `question` `download` | 🔐 Browser |
-| **[xiaohongshu](./browser/xiaohongshu)** | `search` `notifications` `feed` `user` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 🔐 Browser |
+| **[xiaohongshu](./browser/xiaohongshu)** | `search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 🔐 Browser |
+| **[xiaoe](./browser/xiaoe)** | `courses` `detail` `catalog` `play-url` `content` | 🔐 Browser |
 | **[xueqiu](./browser/xueqiu)** | `feed` `hot-stock` `hot` `search` `stock` `comments` `watchlist` `earnings-date` `fund-holdings` `fund-snapshot` | 🔐 Browser |
 | **[youtube](./browser/youtube)** | `search` `video` `transcript` | 🔐 Browser |
 | **[v2ex](./browser/v2ex)** | `hot` `latest` `topic` `node` `user` `member` `replies` `nodes` `daily` `me` `notifications` | 🌐 / 🔐 |
 | **[bloomberg](./browser/bloomberg)** | `main` `markets` `economics` `industries` `tech` `politics` `businessweek` `opinions` `feeds` `news` | 🌐 / 🔐 |
-| **[weibo](./browser/weibo)** | `hot` `search` | 🔐 Browser |
+| **[weibo](./browser/weibo)** | `hot` `search` `feed` `user` `me` `post` `comments` | 🔐 Browser |
 | **[linkedin](./browser/linkedin)** | `search` `timeline` | 🔐 Browser |
 | **[coupang](./browser/coupang)** | `search` `add-to-cart` | 🔐 Browser |
 | **[boss](./browser/boss)** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` | 🔐 Browser |
@@ -26,10 +28,11 @@ Run `opencli list` for the live registry.
 | **[jike](./browser/jike)** | `feed` `search` `post` `topic` `user` `create` `comment` `like` `repost` `notifications` | 🔐 Browser |
 | **[jimeng](./browser/jimeng)** | `generate` `history` | 🔐 Browser |
 | **[yollomi](./browser/yollomi)** | `generate` `video` `edit` `upload` `models` `remove-bg` `upscale` `face-swap` `restore` `try-on` `background` `object-remover` | 🔐 Browser |
-| **[linux-do](./browser/linux-do)** | `feed` `categories` `tags` `search` `topic` `user-topics` `user-posts` | 🔐 Browser |
+| **[linux-do](./browser/linux-do)** | `hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `user-posts` `user-topics` | 🔐 Browser |
 | **[chaoxing](./browser/chaoxing)** | `assignments` `exams` | 🔐 Browser |
 | **[grok](./browser/grok)** | `ask` | 🔐 Browser |
 | **[gemini](./browser/gemini)** | `new` `ask` `image` | 🔐 Browser |
+| **[yuanbao](./browser/yuanbao)** | `new` `ask` | 🔐 Browser |
 | **[notebooklm](./browser/notebooklm)** | `status` `list` `open` `select` `current` `get` `metadata` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` | 🔐 Browser |
 | **[doubao](./browser/doubao)** | `status` `new` `send` `read` `ask` `history` `detail` `meeting-summary` `meeting-transcript` | 🔐 Browser |
 | **[weread](./browser/weread)** | `shelf` `search` `book` `ranking` `notebooks` `highlights` `notes` | 🔐 Browser |
@@ -45,11 +48,17 @@ Run `opencli list` for the live registry.
 | **[google](./browser/google)** | `news` `search` `suggest` `trends` | 🌐 / 🔐 |
 | **[jd](./browser/jd)** | `item` | 🔐 Browser |
 | **[amazon](./browser/amazon)** | `bestsellers` `search` `product` `offer` `discussion` | 🔐 Browser |
+| **[1688](./browser/1688)** | `search` `item` `store` | 🔐 Browser |
 | **[web](./browser/web)** | `read` | 🔐 Browser |
 | **[weixin](./browser/weixin)** | `download` | 🔐 Browser |
 | **[36kr](./browser/36kr)** | `news` `hot` `search` `article` | 🌐 / 🔐 |
 | **[producthunt](./browser/producthunt)** | `posts` `today` `hot` `browse` | 🌐 / 🔐 |
 | **[ones](./browser/ones)** | `login` `me` `token-info` `tasks` `my-tasks` `task` `worklog` `logout` | 🔐 Browser Bridge + `ONES_BASE_URL` |
+| **[band](./browser/band)** | `bands` `posts` `post` `mentions` | 🔐 Browser |
+| **[zsxq](./browser/zsxq)** | `groups` `dynamics` `topics` `topic` `search` | 🔐 Browser |
+| **[bluesky](./browser/bluesky)** | `search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs` | 🌐 Public |
+| **[douyin](./browser/douyin)** | `profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update` | 🔐 Browser |
+| **[xianyu](./browser/xianyu)** | `search` `item` `chat` | 🔐 Browser |
 
 ## Public API Adapters
 
@@ -80,7 +89,7 @@ Run `opencli list` for the live registry.
 | **[Cursor](./desktop/cursor)** | Control Cursor IDE | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |
 | **[Codex](./desktop/codex)** | Drive OpenAI Codex CLI agent | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` |
 | **[Antigravity](./desktop/antigravity)** | Control Antigravity Ultra | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` |
-| **[ChatGPT](./desktop/chatgpt)** | Automate ChatGPT macOS app | `status` `new` `send` `read` `ask` |
+| **[ChatGPT](./desktop/chatgpt)** | Automate ChatGPT macOS app | `status` `new` `send` `read` `ask` `model` |
 | **[ChatWise](./desktop/chatwise)** | Multi-LLM client | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` |
 | **[Notion](./desktop/notion)** | Search, read, write pages | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` |
 | **[Discord](./desktop/discord)** | Desktop messages & channels | `status` `send` `read` `channels` `servers` `search` `members` |

package/docs/comparison.md

@@ -87,7 +87,7 @@ OpenCLI occupies a specific niche in the browser automation ecosystem. This guid
 - **Zero LLM cost** — No tokens consumed at runtime. Run 10,000 times for free.
 - **Deterministic output** — Same command always returns the same schema. Pipeable, scriptable, CI-friendly.
 - **Speed** — Adapter commands return in seconds, not minutes.
-- **Broad platform coverage** — 50+ sites spanning global platforms (Reddit, HackerNews, Twitter, YouTube) and Chinese platforms (Bilibili, Zhihu, Xiaohongshu, Douban, Weibo) with adapters that understand local anti-bot patterns.
+- **Broad platform coverage** — 73+ sites spanning global platforms (Reddit, HackerNews, Twitter, YouTube) and Chinese platforms (Bilibili, Zhihu, Xiaohongshu, Douban, Weibo) with adapters that understand local anti-bot patterns.
 - **Desktop app control** — CDP adapters for Cursor, Codex, Notion, ChatGPT, Discord, and more.
 - **Easy to extend** — Drop a `.yaml` or `.ts` adapter into the `clis/` folder for auto-registration. Contributing a new site adapter is straightforward.
 

package/docs/developer/ai-workflow.md

@@ -12,7 +12,7 @@ opencli generate https://example.com --goal "trending"
 
 This runs: explore → synthesize → register in one shot.
 
-For the complete one-shot workflow details, see [CLI-ONESHOT.md](https://github.com/jackwener/opencli/blob/main/CLI-ONESHOT.md).
+For the complete one-shot workflow details, see [opencli-oneshot skill](https://github.com/jackwener/opencli/blob/main/skills/opencli-oneshot/SKILL.md).
 
 ## Full Mode (Explorer Workflow)
 
@@ -63,4 +63,4 @@ The explorer uses a decision tree to determine the best authentication approach:
 4. **BROWSER** — Full browser automation
 5. **CDP** — Chrome DevTools Protocol for Electron apps
 
-For the complete browser exploration workflow and debugging guide, see [CLI-EXPLORER.md](https://github.com/jackwener/opencli/blob/main/CLI-EXPLORER.md).
+For the complete browser exploration workflow and debugging guide, see [opencli-explorer skill](https://github.com/jackwener/opencli/blob/main/skills/opencli-explorer/SKILL.md).

package/docs/developer/contributing.md

@@ -86,7 +86,7 @@ cli({
   domain: 'www.mysite.com',
   strategy: Strategy.COOKIE,
   args: [
-    { name: 'query', required: true, help: 'Search query' },
+    { name: 'query', positional: true, required: true, help: 'Search query' },
     { name: 'limit', type: 'int', default: 10, help: 'Max results' },
   ],
   columns: ['title', 'url', 'date'],

package/docs/developer/testing.md

@@ -131,6 +131,8 @@ npx vitest src/
 - `browser-public.test.ts` 使用 `tryBrowserCommand()`，站点反爬或地域限制导致空数据时会 warn + pass
 - `browser-auth.test.ts` 验证 **graceful failure**，重点是不 crash、不 hang、错误信息可控
 - 如需测试完整登录态，保持 Chrome 登录态并安装 Browser Bridge 扩展，再手动运行对应测试
+- 对依赖具体 host 页面上下文的 browser adapter，除了单测外，还应手动验证真实命令，并把必要的 target host 约束写进 adapter docs / troubleshooting
+- 对会主动导航页面的 browser commands，手动验证时优先串行执行；多个 CLI 进程同时连到同一个 CDP target 可能互相覆盖导航，制造假的 adapter 故障
 
 ---
 

package/docs/guide/plugins.md

@@ -243,6 +243,7 @@ On startup, if both `my-command.ts` and `my-command.js` exist, the `.js` version
 | [opencli-plugin-github-trending](https://github.com/ByteYue/opencli-plugin-github-trending) | YAML | GitHub Trending repositories |
 | [opencli-plugin-hot-digest](https://github.com/ByteYue/opencli-plugin-hot-digest) | TS | Multi-platform trending aggregator (zhihu, weibo, bilibili, v2ex, stackoverflow, reddit, linux-do) |
 | [opencli-plugin-juejin](https://github.com/Astro-Han/opencli-plugin-juejin) | YAML | 稀土掘金 (Juejin) hot articles, categories, and article feed |
+| [opencli-plugin-rubysec](https://github.com/nullptrKey/opencli-plugin-rubysec) | TS | RubySec advisory archive and advisory article reader |
 
 ## Troubleshooting
 

package/docs/guide/troubleshooting.md

@@ -12,6 +12,17 @@
 - Your login session in Chrome might have expired. Open a normal Chrome tab, navigate to the target site, and log in or refresh the page.
 - Some sites have geographic restrictions (e.g., Bilibili, Zhihu from outside China).
 
+### Browser command opens the page but still cannot read context
+
+- A healthy Browser Bridge connection does not guarantee that the current page target exposes the data your adapter expects.
+- Some browser adapters are sensitive to the active host or page context.
+- Example: `opencli 1688 item` may fail with `did not expose product context` if the target is too broad.
+- Retry on a real item page, refresh the page in Chrome, and if needed narrow the target, for example:
+
+```bash
+OPENCLI_CDP_TARGET=detail.1688.com opencli 1688 item 841141931191 -f json
+```
+
 ### Node API errors
 
 - Make sure you are using **Node.js >= 20**. Some dependencies require modern Node APIs.

package/docs/superpowers/specs/2026-04-03-v2ex-autoresearch-design.md

@@ -0,0 +1,41 @@
+# V2EX AutoResearch Test Suite Design
+
+## Goal
+
+Build a comprehensive test suite using V2EX (https://v2ex.com/) as the single target website to iteratively improve OpenCLI Operate's reliability and Claude Code skill effectiveness. Run 10 rounds of AutoResearch iteration (5 code-level + 5 SKILL.md-level).
+
+## Test Suite Structure — 5 Layers, 40 Tasks
+
+### Layer 1: Atomic (10 tasks)
+Single operate commands testing command-level reliability.
+
+### Layer 2: Single Page (10 tasks)
+Meaningful extraction/interaction within one page.
+
+### Layer 3: Multi-Step (10 tasks)
+Cross-page navigation + extraction combos.
+
+### Layer 4: Write Operations (5 tasks)
+Login-required write operations (reply, favorite, thank).
+
+### Layer 5: Complex Chain (5 tasks)
+Long chains: cross-post reference, multi-node comparison, full workflows.
+
+## Test Infrastructure
+
+- **v2ex-tasks.json** — Layer 1 deterministic tasks (browse commands + judge criteria)
+- **eval-v2ex.ts** — Runner for V2EX tasks (reuses eval-browse.ts pattern)
+- **v2ex-skill-tasks** — Layer 2 LLM E2E tasks embedded in eval runner
+- **presets/v2ex-reliability.ts** — AutoResearch preset for code optimization
+- **presets/v2ex-skill.ts** — AutoResearch preset for SKILL.md optimization
+
+## AutoResearch Iteration Plan
+
+- Rounds 1-5: Layer 1 preset → optimize src/browser/*.ts code
+- Rounds 6-10: Layer 2 preset → optimize skills/opencli-operate/SKILL.md
+- Alternating: fix code issues first, then improve LLM guidance
+
+## Success Criteria
+
+- Layer 1 baseline → target 100% pass rate after 5 code iterations
+- Layer 2 baseline → target 100% pass rate after 5 SKILL.md iterations

package/docs/zh/guide/plugins.md

@@ -167,6 +167,7 @@ cli({
 - `opencli-plugin-github-trending`：GitHub Trending 仓库
 - `opencli-plugin-hot-digest`：多平台热点聚合（zhihu、weibo、bilibili、v2ex、stackoverflow、reddit、linux-do）
 - `opencli-plugin-juejin`：稀土掘金热榜、分类和文章流
+- `opencli-plugin-rubysec`：RubySec 漏洞归档与单篇漏洞文章读取
 
 ## 排查问题