@jackwener/opencli 1.6.1 → 1.6.3

package/docs/adapters/browser/bluesky.md

@@ -1,53 +0,0 @@
-# Bluesky
-
-**Mode**: 🌐 Public · **Domain**: `bsky.app`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli bluesky profile` | User profile info |
-| `opencli bluesky user` | Recent posts from a user |
-| `opencli bluesky trending` | Trending topics |
-| `opencli bluesky search` | Search users |
-| `opencli bluesky feeds` | Popular feed generators |
-| `opencli bluesky followers` | User's followers |
-| `opencli bluesky following` | Accounts a user follows |
-| `opencli bluesky thread` | Post thread with replies |
-| `opencli bluesky starter-packs` | User's starter packs |
-
-## Usage Examples
-
-```bash
-# User profile
-opencli bluesky profile --handle bsky.app
-
-# Recent posts
-opencli bluesky user --handle bsky.app --limit 10
-
-# Trending topics
-opencli bluesky trending --limit 10
-
-# Search users
-opencli bluesky search --query "AI" --limit 10
-
-# Popular feeds
-opencli bluesky feeds --limit 10
-
-# Followers / following
-opencli bluesky followers --handle bsky.app --limit 10
-opencli bluesky following --handle bsky.app
-
-# Post thread with replies
-opencli bluesky thread --uri "at://did:.../app.bsky.feed.post/..."
-
-# Starter packs
-opencli bluesky starter-packs --handle bsky.app
-
-# JSON output
-opencli bluesky profile --handle bsky.app -f json
-```
-
-## Prerequisites
-
-None — all commands use the public Bluesky AT Protocol API, no browser or login required.

package/docs/adapters/browser/boss.md

@@ -1,28 +0,0 @@
-# BOSS Zhipin
-
-**Mode**: 🔐 Browser · **Domain**: `zhipin.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli boss search` | |
-| `opencli boss detail` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli boss search --limit 5
-
-# JSON output
-opencli boss search -f json
-
-# Verbose mode
-opencli boss search -v
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** zhipin.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/chaoxing.md

@@ -1,39 +0,0 @@
-# 超星学习通 (Chaoxing)
-
-**Mode**: 🔐 Browser · **Domain**: `mooc2-ans.chaoxing.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli chaoxing assignments` | 学习通作业列表 |
-| `opencli chaoxing exams` | 学习通考试列表 |
-
-## Usage Examples
-
-```bash
-# List all assignments
-opencli chaoxing assignments --limit 20
-
-# Filter exams by course name
-opencli chaoxing exams --course "高等数学"
-
-# Filter exams by status
-opencli chaoxing exams --status ongoing
-
-# JSON output
-opencli chaoxing assignments -f json
-```
-
-### Options
-
-| Option | Description |
-|--------|-------------|
-| `--course` | Filter by course name (fuzzy match) |
-| `--status` | Filter by status: `all`, `upcoming`, `ongoing`, `finished` |
-| `--limit` | Max number of results (default: 20) |
-
-## Prerequisites
-
-- Chrome running and **logged into** mooc2-ans.chaoxing.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/coupang.md

@@ -1,28 +0,0 @@
-# Coupang
-
-**Mode**: 🔐 Browser · **Domain**: `coupang.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli coupang search` | |
-| `opencli coupang add-to-cart` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli coupang search --limit 5
-
-# JSON output
-opencli coupang search -f json
-
-# Verbose mode
-opencli coupang search -v
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** coupang.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/ctrip.md

@@ -1,27 +0,0 @@
-# Ctrip (携程)
-
-**Mode**: 🔐 Browser · **Domain**: `ctrip.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli ctrip search` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli ctrip search --limit 5
-
-# JSON output
-opencli ctrip search -f json
-
-# Verbose mode
-opencli ctrip search -v
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** ctrip.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/devto.md

@@ -1,35 +0,0 @@
-# Dev.to
-
-**Mode**: 🌐 Public · **Domain**: `dev.to`
-
-Fetch the latest and greatest developer articles from the DEV community without needing an API key.
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli devto top` | Top DEV.to articles of the day |
-| `opencli devto tag` | Latest articles for a specific tag |
-| `opencli devto user` | Recent articles from a specific user |
-
-## Usage Examples
-
-```bash
-# Top articles today
-opencli devto top --limit 5
-
-# Articles by tag (positional argument)
-opencli devto tag javascript
-opencli devto tag python --limit 20
-
-# Articles by a specific author
-opencli devto user ben
-opencli devto user thepracticaldev --limit 5
-
-# JSON output
-opencli devto top -f json
-```
-
-## Prerequisites
-
-- No browser required — uses the public DEV.to API

package/docs/adapters/browser/dictionary.md

@@ -1,27 +0,0 @@
-# Dictionary
-
-**Mode**: 🌐 Public · **Domain**: `api.dictionaryapi.dev`
-
-Search the open dictionary to quickly fetch native definitions, part of speech contexts, and phonetic pronunciations directly in your IDE terminal.
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli dictionary search` | Fetch the exact definition of a word |
-| `opencli dictionary synonyms` | Find related synonyms for a word |
-| `opencli dictionary examples` | Read real-world sentence usage examples |
-
-## Usage Examples
-
-```bash
-# Look up a complex term
-opencli dictionary search serendipity
-
-# Discover phonetics
-opencli dictionary search ephemeral
-```
-
-## Prerequisites
-
-- No browser required — utilizes the fast, open JSON definitions API.

package/docs/adapters/browser/douban.md

@@ -1,62 +0,0 @@
-# 豆瓣 (Douban)
-
-**Mode**: 🔐 Browser (Cookie) · **Domain**: `douban.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli douban search` | 搜索豆瓣电影、图书或音乐 |
-| `opencli douban top250` | 豆瓣电影 Top 250 |
-| `opencli douban subject` | 条目详情 |
-| `opencli douban photos` | 获取电影海报/剧照图片列表 |
-| `opencli douban download` | 下载电影海报/剧照图片 |
-| `opencli douban marks` | 我的标记 |
-| `opencli douban reviews` | 我的短评 |
-| `opencli douban movie-hot` | 豆瓣电影热门榜单 |
-| `opencli douban book-hot` | 豆瓣图书热门榜单 |
-
-## Usage Examples
-
-```bash
-# 搜索电影
-opencli douban search "流浪地球"
-
-# 搜索图书
-opencli douban search --type book "三体"
-
-# 搜索音乐
-opencli douban search --type music "周杰伦"
-
-# 电影 Top 250
-opencli douban top250 --limit 10
-
-# 条目详情
-opencli douban subject 1292052
-
-# 获取海报直链（默认 type=Rb）
-opencli douban photos 30382501 --limit 20
-
-# 下载海报到本地目录
-opencli douban download 30382501 --output ./douban
-
-# 只下载指定 photo_id 的一张图
-opencli douban download 30382501 --photo-id 2913621075 --output ./douban
-
-# 返回 JSON，便于上层界面直接渲染图片并右键取图
-opencli douban photos 30382501 -f json
-
-# 电影热门
-opencli douban movie-hot --limit 10
-
-# 图书热门
-opencli douban book-hot --limit 10
-
-# JSON output
-opencli douban top250 -f json
-```
-
-## Prerequisites
-
-- Chrome logged into `douban.com`
-- Browser Bridge extension installed

package/docs/adapters/browser/doubao.md

@@ -1,35 +0,0 @@
-# doubao
-
-Browser adapter for [Doubao Chat](https://www.doubao.com/chat).
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli doubao status` | Check whether the page is reachable and whether Doubao appears logged in |
-| `opencli doubao new` | Start a new Doubao conversation |
-| `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 |
-
-## Prerequisites
-
-- Chrome is running
-- You are already logged into [doubao.com](https://www.doubao.com/)
-- Playwright MCP Bridge / browser bridge is configured for OpenCLI
-
-## Examples
-
-```bash
-opencli doubao status
-opencli doubao new
-opencli doubao send "帮我总结这段文档"
-opencli doubao read
-opencli doubao ask "请写一个 Python 快速排序示例" --timeout 90
-```
-
-## Notes
-
-- The adapter targets the web chat page at `https://www.doubao.com/chat`
-- `new` first tries the visible "New Chat / 新对话" button, then falls back to the new-thread route
-- `ask` uses DOM polling, so very long generations may need a larger `--timeout`

package/docs/adapters/browser/douyin.md

@@ -1,75 +0,0 @@
-# Douyin (抖音创作者中心)
-
-**Mode**: 🔐 Browser · **Domain**: `creator.douyin.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli douyin profile` | 获取账号信息 |
-| `opencli douyin videos` | 获取作品列表 |
-| `opencli douyin drafts` | 获取草稿列表 |
-| `opencli douyin draft` | 上传视频并保存为草稿 |
-| `opencli douyin publish` | 定时发布视频到抖音 |
-| `opencli douyin update` | 更新视频信息 |
-| `opencli douyin delete` | 删除作品 |
-| `opencli douyin stats` | 查询作品数据分析 |
-| `opencli douyin collections` | 获取合集列表 |
-| `opencli douyin activities` | 获取官方活动列表 |
-| `opencli douyin location` | 搜索发布可用的地理位置 |
-| `opencli douyin hashtag search` | 按关键词搜索话题 |
-| `opencli douyin hashtag suggest` | 基于封面 URI 推荐话题 |
-| `opencli douyin hashtag hot` | 获取热点词 |
-
-## Usage Examples
-
-```bash
-# 账号与作品
-opencli douyin profile
-opencli douyin videos --limit 10
-opencli douyin videos --status scheduled
-opencli douyin drafts
-
-# 发布前辅助信息
-opencli douyin collections
-opencli douyin activities
-opencli douyin location "东京塔"
-opencli douyin hashtag search "春游"
-opencli douyin hashtag hot --limit 10
-
-# 保存草稿
-opencli douyin draft ./video.mp4 \
-  --title "春游 vlog" \
-  --caption "#春游 先存草稿"
-
-# 定时发布
-opencli douyin publish ./video.mp4 \
-  --title "春游 vlog" \
-  --caption "#春游 今天去看樱花" \
-  --schedule "2026-04-08T12:00:00+09:00"
-
-# 也支持 Unix 秒字符串
-opencli douyin publish ./video.mp4 \
-  --title "春游 vlog" \
-  --schedule 1775617200
-
-# 更新与删除
-opencli douyin update 1234567890 --caption "更新后的文案"
-opencli douyin update 1234567890 --reschedule "2026-04-09T20:00:00+09:00"
-opencli douyin delete 1234567890
-
-# JSON 输出
-opencli douyin profile -f json
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** `creator.douyin.com`
-- The logged-in account must have access to Douyin Creator Center publishing features
-- [Browser Bridge extension](/guide/browser-bridge) installed
-
-## Notes
-
-- `publish` requires `--schedule` to be at least 2 hours later and no more than 14 days later
-- `draft` and `publish` upload the video through Douyin/ByteDance browser-authenticated APIs, so cookies in the active browser session must be valid
-- `hashtag suggest` expects a valid `cover`/`cover_uri` value produced during the publish pipeline; for normal manual use, `hashtag search` and `hashtag hot` are usually more convenient

package/docs/adapters/browser/facebook.md

@@ -1,36 +0,0 @@
-# Facebook
-
-**Mode**: 🔐 Browser · **Domain**: `facebook.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli facebook profile` | Get user/page profile info |
-| `opencli facebook notifications` | Get recent notifications |
-| `opencli facebook feed` | Get news feed posts |
-| `opencli facebook search` | Search people, pages, posts |
-
-## Usage Examples
-
-```bash
-# View a profile
-opencli facebook profile zuck
-
-# Get notifications
-opencli facebook notifications --limit 10
-
-# News feed
-opencli facebook feed --limit 5
-
-# Search
-opencli facebook search "OpenAI" --limit 5
-
-# JSON output
-opencli facebook profile zuck -f json
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** facebook.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/gemini.md

@@ -1,72 +0,0 @@
-# Gemini
-
-**Mode**: 🔐 Browser · **Domain**: `gemini.google.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli gemini new` | Start a new Gemini web chat |
-| `opencli gemini ask <prompt>` | Send a prompt and return only the assistant reply |
-| `opencli gemini image <prompt>` | Generate images in Gemini and optionally save them locally |
-
-## Usage Examples
-
-```bash
-# Start a fresh chat
-opencli gemini new
-
-# Ask Gemini and return minimal plain-text output
-opencli gemini ask "Reply with exactly: HELLO"
-
-# Ask in a new chat and wait longer
-opencli gemini ask "Summarize this design in 3 bullets" --new true --timeout 90
-
-# Generate an icon image with short flags
-opencli gemini image "Generate a tiny cyan moon icon" --rt 1:1 --st icon
-
-# Only generate in Gemini and print the page link without downloading files
-opencli gemini image "A watercolor sunset over a lake" --sd true
-
-# Save generated images to a custom directory
-opencli gemini image "A flat illustration of a robot" --op ~/tmp/gemini-images
-```
-
-## Options
-
-### `ask`
-
-| Option | Description |
-|--------|-------------|
-| `prompt` | Prompt to send (required positional argument) |
-| `--timeout` | Max seconds to wait for a reply (default: `60`) |
-| `--new` | Start a new chat before sending (default: `false`) |
-
-### `image`
-
-| Option | Description |
-|--------|-------------|
-| `prompt` | Image prompt to send (required positional argument) |
-| `--rt` | Aspect ratio shorthand: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3` |
-| `--st` | Optional style shorthand, e.g. `icon`, `anime`, `watercolor` |
-| `--op` | Output directory for downloaded images (default: `~/tmp/gemini-images`) |
-| `--sd` | Skip download and only print the Gemini page link |
-
-## Behavior
-
-- `ask` uses plain minimal output and returns only the assistant response text prefixed with `💬`.
-- `image` also uses plain output and prints `status / file / link` instead of a table.
-- `image` always starts from a fresh Gemini chat before sending the prompt.
-- When `--sd` is enabled, `image` keeps the generation in Gemini and only prints the conversation link.
-
-## Prerequisites
-
-- Chrome is running
-- You are already logged into `gemini.google.com`
-- [Browser Bridge extension](/guide/browser-bridge) is installed
-
-## Caveats
-
-- This adapter drives the Gemini consumer web UI, not a public API.
-- It depends on the current browser session and may fail if Gemini shows login, consent, challenge, quota, or other gating UI.
-- DOM or product changes on Gemini can break composer detection, new-chat handling, or image export behavior.

package/docs/adapters/browser/google.md

@@ -1,62 +0,0 @@
-# Google
-
-**Mode**: 🌐 / 🔐 Mixed · **Domains**: `google.com`, `suggestqueries.google.com`, `news.google.com`, `trends.google.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli google search <keyword>` | Search Google and extract results from the page |
-| `opencli google suggest <keyword>` | Get Google search suggestions |
-| `opencli google news [keyword]` | Get Google News headlines (top stories or search) |
-| `opencli google trends` | Get Google Trends daily trending searches |
-
-## What works today
-
-- Public API commands work without a browser:
-  - `suggest` — JSON API, no auth needed
-  - `news` — RSS feed, supports top stories and keyword search
-  - `trends` — RSS feed, supports different regions
-- `google search` uses browser mode to extract results from google.com.
-
-## Current limitations
-
-- `google search` may trigger CAPTCHA in Standalone browser mode. Extension mode (with an established Chrome session) is more reliable.
-- Google frequently changes its DOM structure. If `search` stops returning results, selectors may need updating.
-- Snippet extraction may return empty for some results depending on Google's layout.
-
-## Usage Examples
-
-```bash
-# Search Google
-opencli google search "typescript tutorial" --limit 10
-
-# Get search suggestions
-opencli google suggest python
-
-# Get top news headlines
-opencli google news --limit 5
-
-# Search news for a topic
-opencli google news "artificial intelligence" --limit 10 --lang en --region US
-
-# Get trending searches in Japan
-opencli google trends --region JP --limit 10
-
-# Output as JSON
-opencli google search "machine learning" -f json
-```
-
-## Prerequisites
-
-- `suggest`, `news`, `trends` do not require Chrome.
-- `search` requires:
-  - Chrome running (or Standalone mode will auto-launch)
-  - For best results, use the [Browser Bridge extension](/guide/browser-bridge) with an established Google session
-
-## Notes
-
-- `suggest` defaults to `--lang zh-CN`; other commands default to `--lang en`.
-- `news` supports `--lang` and `--region` parameters for localized results.
-- `trends` traffic values are raw strings (e.g. "500K+", "1,000,000+"), not numeric.
-- `search` output includes three result types: `result` (standard), `snippet` (featured answer box), and `paa` (People Also Ask).

package/docs/adapters/browser/grok.md

@@ -1,53 +0,0 @@
-# Grok
-
-**Mode**: Default Grok adapter + optional explicit consumer web path · **Domain**: `grok.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli grok ask` | Keep the default Grok ask behavior |
-| `opencli grok ask --web` | Use the explicit grok.com consumer web UI flow |
-
-## Usage Examples
-
-```bash
-# Default / compatibility path
-opencli grok ask --prompt "Explain quantum computing in simple terms"
-
-# Explicit consumer web path
-opencli grok ask --prompt "Explain quantum computing in simple terms" --web
-
-# Best-effort fresh chat on the consumer web path
-opencli grok ask --prompt "Hello" --web --new
-
-# Set custom timeout (default: 120s)
-opencli grok ask --prompt "Write a long essay" --web --timeout 180
-```
-
-### Options
-
-| Option | Description |
-|--------|-------------|
-| `--prompt` | The message to send (required) |
-| `--timeout` | Wait timeout in seconds (default: 120) |
-| `--new` | Start a new chat before sending (default: false) |
-| `--web` | Opt into the explicit grok.com consumer web flow (default: false) |
-
-## Behavior
-
-- `opencli grok ask` keeps the upstream/default behavior intact.
-- `opencli grok ask --web` switches to the newer hardened consumer-web implementation.
-- The `--web` path adds stricter composer detection, clearer blocked/session-gated hints, and waits for a stabilized assistant bubble before returning.
-
-## Prerequisites
-
-- The Grok adapter still depends on browser-backed access to `grok.com`
-- For `--web`, Chrome should already be running with an authenticated Grok consumer session
-- [Browser Bridge extension](/guide/browser-bridge) installed
-
-## Caveats
-
-- `--web` drives the Grok consumer web UI in the browser, not an API.
-- It depends on an already-authenticated session and can fail if Grok shows login, challenge, rate-limit, or other session-gating UI.
-- It may break when the Grok composer DOM, submit button behavior, or message bubble structure changes.

package/docs/adapters/browser/hackernews.md

@@ -1,42 +0,0 @@
-# HackerNews
-
-**Mode**: 🌐 Public · **Domain**: `news.ycombinator.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli hackernews top` | Hacker News top stories |
-| `opencli hackernews new` | Hacker News newest stories |
-| `opencli hackernews best` | Hacker News best stories |
-| `opencli hackernews ask` | Hacker News Ask HN posts |
-| `opencli hackernews show` | Hacker News Show HN posts |
-| `opencli hackernews jobs` | Hacker News job postings |
-| `opencli hackernews search <query>` | Search Hacker News stories |
-| `opencli hackernews user <username>` | Hacker News user profile |
-
-## Usage Examples
-
-```bash
-# Top stories
-opencli hackernews top --limit 5
-
-# Newest stories
-opencli hackernews new --limit 10
-
-# Search stories
-opencli hackernews search "machine learning" --limit 5
-
-# User profile
-opencli hackernews user pg
-
-# JSON output
-opencli hackernews top -f json
-
-# Sort search by date
-opencli hackernews search "rust" --sort date
-```
-
-## Prerequisites
-
-- No browser required — uses public API