@jackwener/opencli 1.6.0 → 1.6.2

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 漏洞归档与单篇漏洞文章读取
 
 ## 排查问题