publishport-opencli 1.0.1 → 1.0.3

package/README.md

@@ -1,4 +1,4 @@
-# OpenCLI
+# ppcli
 
 > **Convert any website into a CLI & run Browser Use on your logged-in Chrome.**
 > Turn websites, browser sessions, Electron apps, and local tools into deterministic interfaces for humans and AI agents.
@@ -9,19 +9,19 @@
 [![Node.js Version](https://img.shields.io/node/v/@jackwener/opencli?style=flat-square)](https://nodejs.org)
 [![License](https://img.shields.io/npm/l/@jackwener/opencli?style=flat-square)](./LICENSE)
 
-OpenCLI gives you one surface for three different kinds of automation:
+ppcli gives you one surface for three different kinds of automation:
 
 - **Use built-in adapters** for sites like Bilibili, Zhihu, Xiaohongshu, Reddit, HackerNews, Twitter/X, and [many more](#built-in-commands).
-- **Let AI Agents operate any website** — install the `opencli-browser` skill in your AI agent (Claude Code, Cursor, etc.), and it can navigate, click, type/fill, extract, and inspect any page through your logged-in browser via `opencli browser` primitives.
-- **Write new adapters** end-to-end with `opencli browser` + the `opencli-adapter-author` skill, which guides from first recon through field decoding, code, and `opencli browser verify`.
+- **Let AI Agents operate any website** — install the `opencli-browser` skill in your AI agent (Claude Code, Cursor, etc.), and it can navigate, click, type/fill, extract, and inspect any page through your logged-in browser via `ppcli browser` primitives.
+- **Write new adapters** end-to-end with `ppcli browser` + the `opencli-adapter-author` skill, which guides from first recon through field decoding, code, and `ppcli browser verify`.
 
 It also works as a **CLI hub** for local tools such as `gh`, `docker`, `longbridge`, `tg`, `discord`, `wx`, `ntn` (Notion), and other binaries you register yourself, plus **desktop app adapters** for Electron apps like Cursor, Trae CN, Codex, Antigravity, ChatGPT, and Trae SOLO.
 
 ## Quick Start
 
-### 1. Install OpenCLI
+### 1. Install ppcli
 
-For desktop use, start with **OpenCLIApp**. It bundles the OpenCLI runtime,
+For desktop use, start with **OpenCLIApp**. It bundles the ppcli runtime,
 keeps the managed `opencli` command installed, and gives you a system tray UI
 for setup, diagnostics, updates, browser-login keepalive, and Web → Markdown.
 
@@ -31,7 +31,7 @@ open the app once and use the System page to install or repair the `opencli`
 command.
 
 **Option B — npm global install (CLI-only / CI / servers):**
-OpenCLI requires **Node.js >= 20** when installed through npm.
+ppcli requires **Node.js >= 20** when installed through npm.
 
 ```bash
 node --version
@@ -40,10 +40,10 @@ npm install -g @jackwener/opencli
 
 ### 2. Install the Browser Bridge Extension
 
-OpenCLI connects to Chrome/Chromium through a lightweight Browser Bridge extension plus a small local daemon. The daemon auto-starts when needed.
+ppcli connects to Chrome/Chromium through a lightweight Browser Bridge extension plus a small local daemon. The daemon auto-starts when needed.
 
 **Option A — Chrome Web Store (recommended):**
-Install **OpenCLI** from the [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk).
+Install **ppcli** from the [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk).
 
 **Option B — Manual install:**
 1. Download the latest `opencli-extension-v{version}.zip` from the GitHub [Releases page](https://github.com/jackwener/opencli/releases).
@@ -53,54 +53,54 @@ Install **OpenCLI** from the [Chrome Web Store](https://chromewebstore.google.co
 ### 3. Verify the setup
 
 ```bash
-opencli doctor
+ppcli doctor
 ```
 
 ### 4. Optional: name your Chrome profile
 
-Each Chrome profile runs its own OpenCLI extension instance. If you use multiple Chrome profiles, list the connected profiles and assign local aliases:
+Each Chrome profile runs its own ppcli extension instance. If you use multiple Chrome profiles, list the connected profiles and assign local aliases:
 
 ```bash
-opencli profile list
-opencli profile rename <contextId> work
-opencli profile use work
-opencli --profile work browser state
+ppcli profile list
+ppcli profile rename <contextId> work
+ppcli profile use work
+ppcli --profile work browser state
 ```
 
-With only one connected profile, OpenCLI uses it automatically. With multiple connected profiles and no default, OpenCLI asks you to choose instead of guessing.
+With only one connected profile, ppcli uses it automatically. With multiple connected profiles and no default, ppcli asks you to choose instead of guessing.
 
 ### 5. Run your first commands
 
 ```bash
-opencli list
-opencli hackernews top --limit 5
-opencli bilibili hot --limit 5
+ppcli list
+ppcli hackernews top --limit 5
+ppcli bilibili hot --limit 5
 ```
 
 ## For Humans
 
-Use OpenCLI directly when you want a reliable command instead of a live browser session:
+Use ppcli directly when you want a reliable command instead of a live browser session:
 
-- `opencli list` shows every registered command.
-- `opencli <site> <command>` runs a built-in or generated adapter.
-- `opencli external register mycli` exposes a local CLI through the same discovery surface.
-- `opencli doctor` helps diagnose browser connectivity.
+- `ppcli list` shows every registered command.
+- `ppcli <site> <command>` runs a built-in or generated adapter.
+- `ppcli external register mycli` exposes a local CLI through the same discovery surface.
+- `ppcli doctor` helps diagnose browser connectivity.
 
-## Extending OpenCLI
+## Extending ppcli
 
-If you want to add your own commands, start with the [Extending OpenCLI guide](./docs/guide/extending-opencli.md). README keeps this short; the guide covers the directory layout, source-control model, and install commands.
+If you want to add your own commands, start with the [Extending ppcli guide](./docs/guide/extending-opencli.md). README keeps this short; the guide covers the directory layout, source-control model, and install commands.
 
 | Need | Recommended path |
 |------|------------------|
-| Keep personal website commands in your own Git repo | `opencli plugin create` + `opencli plugin install file://...` |
-| Quickly draft a private local adapter | `opencli browser init <site>/<command>` in `~/.opencli/clis/` |
-| Modify an official adapter locally | `opencli adapter eject <site>` + `opencli adapter reset <site>` |
-| Publish or install third-party commands | `opencli plugin install github:user/repo` |
-| Wrap an existing local binary | `opencli external register <name>` |
+| Keep personal website commands in your own Git repo | `ppcli plugin create` + `ppcli plugin install file://...` |
+| Quickly draft a private local adapter | `ppcli browser init <site>/<command>` in `~/.ppcli/clis/` |
+| Modify an official adapter locally | `ppcli adapter eject <site>` + `ppcli adapter reset <site>` |
+| Publish or install third-party commands | `ppcli plugin install github:user/repo` |
+| Wrap an existing local binary | `ppcli external register <name>` |
 
 ## For AI Agents
 
-OpenCLI's browser commands are designed to be used by AI Agents — not run manually. Install skills into your AI agent (Claude Code, Cursor, etc.), and the agent operates websites on your behalf using your logged-in Chrome session.
+ppcli's browser commands are designed to be used by AI Agents — not run manually. Install skills into your AI agent (Claude Code, Cursor, etc.), and the agent operates websites on your behalf using your logged-in Chrome session.
 
 ### Install skills (also refreshes existing installs)
 
@@ -124,11 +124,11 @@ npx skills add jackwener/opencli --skill opencli-usage
 | Skill | When to use | Example prompt to your AI agent |
 |-------|------------|-------------------------------|
 | **opencli-adapter-author** | Write a reusable adapter for a new site or add a command to an existing site | "Write an adapter for douyin trending" / "Make a command that grabs the top posts from this page" |
-| **opencli-autofix** | Repair a broken adapter when a built-in command fails | "`opencli zhihu hot` is returning empty — fix it" |
+| **opencli-autofix** | Repair a broken adapter when a built-in command fails | "`ppcli zhihu hot` is returning empty — fix it" |
 | **opencli-browser** | Drive a real Chrome page ad-hoc — navigate, fill forms, click, extract | "Help me check my Xiaohongshu notifications" / "Help me fill out this form" / "Use browser commands to scrape this page" |
 | **opencli-browser-sitemap** | Consume site sitemap context while driving a browser task | "Use the sitemap to navigate this website without blind clicking" |
 | **opencli-sitemap-author** | Create or update site sitemap knowledge for browser agents | "Record the stable workflow you just discovered for this site" |
-| **opencli-usage** | Quick reference for all OpenCLI commands and sites | "What commands does OpenCLI have for Twitter?" |
+| **opencli-usage** | Quick reference for all ppcli commands and sites | "What commands does ppcli have for Twitter?" |
 
 ### How it works
 
@@ -140,7 +140,7 @@ Once `opencli-browser` is installed, your AI agent can:
 4. **Extract** data from the page or intercept network API responses
 5. **Wait** for elements, text, or page transitions
 
-The agent handles all the `opencli browser` commands internally — you just describe what you want done in natural language.
+The agent handles all the `ppcli browser` commands internally — you just describe what you want done in natural language.
 
 **Skill references:**
 - [`skills/opencli-browser/SKILL.md`](./skills/opencli-browser/SKILL.md) — drive Chrome ad-hoc (navigate, fill forms, click, extract)
@@ -152,7 +152,7 @@ The agent handles all the `opencli browser` commands internally — you just des
 
 Available browser commands include `open`, `state`, `click`, `type`, `fill`, `select`, `keys`, `wait`, `get`, `find`, `extract`, `frames`, `screenshot`, `scroll`, `back`, `eval`, `network`, `tab list`, `tab new`, `tab select`, `tab close`, `init`, `verify`, and `close`.
 
-`opencli browser` commands require a `<session>` positional immediately after `browser`. `opencli browser work open <url>` and `opencli browser work tab new [url]` both return a target ID. Use `opencli browser work tab list` to inspect target IDs, then pass `--tab <targetId>` to route a command to a specific tab. `tab new` creates a new tab without changing the default browser target; only `tab select <targetId>` promotes that tab to the default target for later untargeted commands in the same session.
+`ppcli browser` commands require a `<session>` positional immediately after `browser`. `ppcli browser work open <url>` and `ppcli browser work tab new [url]` both return a target ID. Use `ppcli browser work tab list` to inspect target IDs, then pass `--tab <targetId>` to route a command to a specific tab. `tab new` creates a new tab without changing the default browser target; only `tab select <targetId>` promotes that tab to the default target for later untargeted commands in the same session.
 
 ## Writing a new adapter
 
@@ -162,8 +162,8 @@ When the site you need is not yet covered, use the `opencli-adapter-author` skil
 2. **Discover** the right endpoint — network inspection, initial state, bundle search, token trace, or interceptor fallback.
 3. **Pick auth** — `PUBLIC` / `COOKIE` / `INTERCEPT` / `UI` / `LOCAL`.
 4. **Decode** response fields and design output columns.
-5. `opencli browser recon analyze <url>` → `opencli browser recon init <site>/<name>` → write adapter → `opencli browser recon verify <site>/<name>`.
-6. Site knowledge persists to `~/.opencli/sites/<site>/` so the next adapter for the same site starts from context.
+5. `ppcli browser recon analyze <url>` → `ppcli browser recon init <site>/<name>` → write adapter → `ppcli browser recon verify <site>/<name>`.
+6. Site knowledge persists to `~/.ppcli/sites/<site>/` so the next adapter for the same site starts from context.
 
 ## Configuration
 
@@ -178,7 +178,7 @@ When the site you need is not yet covered, use the `opencli-adapter-author` skil
 | `OPENCLI_VERBOSE` | `false` | Enable verbose logging (`-v` flag also works) |
 | `DEBUG_SNAPSHOT` | — | Set to `1` for DOM snapshot debug output |
 
-`opencli browser *` requires an explicit `<session>` positional, uses a foreground browser window by default, and keeps that session's tab lease until `opencli browser <session> close` or idle cleanup. Browser-backed adapters use a background adapter window and release one-shot tab leases by default. Interactive adapters can declare `siteSession: 'persistent'` to keep a stable site tab for continuity; pass `--site-session ephemeral` for a one-shot tab.
+`ppcli browser *` requires an explicit `<session>` positional, uses a foreground browser window by default, and keeps that session's tab lease until `ppcli browser <session> close` or idle cleanup. Browser-backed adapters use a background adapter window and release one-shot tab leases by default. Interactive adapters can declare `siteSession: 'persistent'` to keep a stable site tab for continuity; pass `--site-session ephemeral` for a one-shot tab.
 
 ## Built-in Commands
 
@@ -204,17 +204,17 @@ Curated highlights — **[→ see all 100+ supported sites & commands](./docs/ad
 
 ## CLI Hub
 
-Unified passthrough for your existing command-line tools. Run `opencli <tool> ...` for any of:
+Unified passthrough for your existing command-line tools. Run `ppcli <tool> ...` for any of:
 
 `gh` · `docker` · `vercel` · `wrangler` · `obsidian` · `longbridge` · `lark-cli` · `ntn(notion)` · `dws(DingTalk Workspace)` · `wecom-cli(企业微信)` · `tg(tg-cli)` · `discord(discord-cli)` · `wx(wx-cli)`
 
-Register your own with `opencli external register <name>`; list everything with `opencli external list`.
+Register your own with `ppcli external register <name>`; list everything with `ppcli external list`.
 
 **Desktop app adapters** (Electron, via CDP): Cursor / Trae CN / Codex / Antigravity / ChatGPT App / ChatWise / Qoder / Discord / Doubao / Trae SOLO — see [`docs/adapters/desktop/`](./docs/adapters/desktop/).
 
 ## Download Support
 
-OpenCLI supports downloading images, videos, and articles from supported platforms.
+ppcli supports downloading images, videos, and articles from supported platforms.
 
 | Platform | Content Types | Notes |
 |----------|---------------|-------|
@@ -232,41 +232,41 @@ OpenCLI supports downloading images, videos, and articles from supported platfor
 For video downloads, install `yt-dlp` first: `brew install yt-dlp`
 
 ```bash
-opencli xiaohongshu download "https://www.xiaohongshu.com/search_result/<id>?xsec_token=..." --output ./xhs
-opencli xiaohongshu download "https://xhslink.com/..." --output ./xhs
-opencli rednote download "https://www.rednote.com/search_result/<id>?xsec_token=..." --output ./rednote
-opencli bilibili download BV1xxx --output ./bilibili
-opencli twitter download elonmusk --limit 20 --output ./twitter
-opencli 1688 download 841141931191 --output ./1688-downloads
-opencli xiaoyuzhou download 69b3b675772ac2295bfc01d0 --output ./xiaoyuzhou
-opencli xiaoyuzhou transcript 69dd0c98e2c8be31551f6a33 --output ./xiaoyuzhou-transcripts
+ppcli xiaohongshu download "https://www.xiaohongshu.com/search_result/<id>?xsec_token=..." --output ./xhs
+ppcli xiaohongshu download "https://xhslink.com/..." --output ./xhs
+ppcli rednote download "https://www.rednote.com/search_result/<id>?xsec_token=..." --output ./rednote
+ppcli bilibili download BV1xxx --output ./bilibili
+ppcli twitter download elonmusk --limit 20 --output ./twitter
+ppcli 1688 download 841141931191 --output ./1688-downloads
+ppcli xiaoyuzhou download 69b3b675772ac2295bfc01d0 --output ./xiaoyuzhou
+ppcli xiaoyuzhou transcript 69dd0c98e2c8be31551f6a33 --output ./xiaoyuzhou-transcripts
 ```
 
-`opencli xiaoyuzhou download` and `transcript` require local Xiaoyuzhou credentials in `~/.opencli/xiaoyuzhou.json`.
+`ppcli xiaoyuzhou download` and `transcript` require local Xiaoyuzhou credentials in `~/.ppcli/xiaoyuzhou.json`.
 
 ## Output Formats
 
 All built-in commands support `--format` / `-f` with `table` (default), `json`, `yaml`, `md`, and `csv`.
 
 ```bash
-opencli bilibili hot -f json    # Pipe to jq or LLMs
-opencli bilibili hot -f csv     # Spreadsheet-friendly
-opencli bilibili hot -v         # Verbose: show pipeline debug steps
+ppcli bilibili hot -f json    # Pipe to jq or LLMs
+ppcli bilibili hot -f csv     # Spreadsheet-friendly
+ppcli bilibili hot -v         # Verbose: show pipeline debug steps
 ```
 
 ## Exit Codes
 
-opencli follows Unix `sysexits.h` so CI / scripts can branch on failure mode: `0` success, `66` empty result, `69` Browser Bridge down, `75` timeout, `77` auth required, `78` config error, `130` Ctrl-C. Full reference: [docs/guide/exit-codes.md](./docs/guide/exit-codes.md).
+ppcli follows Unix `sysexits.h` so CI / scripts can branch on failure mode: `0` success, `66` empty result, `69` Browser Bridge down, `75` timeout, `77` auth required, `78` config error, `130` Ctrl-C. Full reference: [docs/guide/exit-codes.md](./docs/guide/exit-codes.md).
 
 ## Plugins
 
-Extend OpenCLI with community-contributed adapters:
+Extend ppcli with community-contributed adapters:
 
 ```bash
-opencli plugin install github:user/opencli-plugin-my-tool
-opencli plugin list
-opencli plugin update --all
-opencli plugin uninstall my-tool
+ppcli plugin install github:user/opencli-plugin-my-tool
+ppcli plugin list
+ppcli plugin update --all
+ppcli plugin uninstall my-tool
 ```
 
 | Plugin | Type | Description |
@@ -287,7 +287,7 @@ See **[TESTING.md](./TESTING.md)** for how to run and write tests.
 - **"Extension not connected"** — Ensure the Browser Bridge extension is installed from the [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk) and **enabled** in `chrome://extensions`.
 - **"attach failed: Cannot access a chrome-extension:// URL"** — Another extension may be interfering. Try disabling other extensions temporarily.
 - **Empty data or 'Unauthorized' error** — Your Chrome/Chromium login session may have expired. Navigate to the target site and log in again.
-- **Node API errors / missing `fetch` / startup crash on old Node** — OpenCLI requires **Node.js >= 20**. Run `node --version`, upgrade Node if needed, then retry.
+- **Node API errors / missing `fetch` / startup crash on old Node** — ppcli requires **Node.js >= 20**. Run `node --version`, upgrade Node if needed, then retry.
 - **Daemon issues** — Check status: `curl localhost:19825/status` · View logs: `curl localhost:19825/logs`
 
 ## Star History

package/README.zh-CN.md

@@ -1,4 +1,4 @@
-# OpenCLI
+# ppcli
 
 > **把任意网站变成 CLI & 在你的登录态浏览器上跑 Browser Use。**
 > 把网站、浏览器会话、Electron 应用和本地工具，统一变成适合人类与 AI Agent 使用的确定性接口。
@@ -9,20 +9,20 @@
 [![Node.js Version](https://img.shields.io/node/v/@jackwener/opencli?style=flat-square)](https://nodejs.org)
 [![License](https://img.shields.io/npm/l/@jackwener/opencli?style=flat-square)](./LICENSE)
 
-OpenCLI 可以用同一套 CLI 做三类事情：
+ppcli 可以用同一套 CLI 做三类事情：
 
 - **直接使用现成适配器**：B站、知乎、小红书、Twitter/X、Reddit、HackerNews 等 [100+ 站点](#内置命令) 开箱即用。
 - **让 AI Agent 操作任意网站**：在你的 AI Agent（Claude Code、Cursor 等）中安装 `opencli-browser` skill，Agent 就能用你的已登录浏览器导航、点击、输入/填充、提取任意网页内容。
-- **把新网站写成 CLI**：用 `opencli browser` 原语 + `opencli-adapter-author` skill，从站点侦察、API 发现、字段解码到 `opencli browser verify` 一条龙。
+- **把新网站写成 CLI**：用 `ppcli browser` 原语 + `opencli-adapter-author` skill，从站点侦察、API 发现、字段解码到 `ppcli browser verify` 一条龙。
 
-除了网站能力，OpenCLI 还是一个 **CLI 枢纽**：你可以把 `gh`、`docker`、`longbridge`、`tg`、`discord`、`wx`、`ntn`（Notion）等本地工具统一注册到 `opencli` 下，也可以通过桌面端适配器控制 Cursor、Trae CN、Codex、Antigravity、ChatGPT、Trae SOLO 等 Electron 应用。
+除了网站能力，ppcli 还是一个 **CLI 枢纽**：你可以把 `gh`、`docker`、`longbridge`、`tg`、`discord`、`wx`、`ntn`（Notion）等本地工具统一注册到 `opencli` 下，也可以通过桌面端适配器控制 Cursor、Trae CN、Codex、Antigravity、ChatGPT、Trae SOLO 等 Electron 应用。
 
 ## 快速开始
 
-### 1. 安装 OpenCLI
+### 1. 安装 ppcli
 
 如果你是在自己的电脑上使用，优先安装 **OpenCLIApp**。它会内置
-OpenCLI runtime，帮你安装 / 修复受管理的 `opencli` 命令，并提供系统托盘
+ppcli runtime，帮你安装 / 修复受管理的 `opencli` 命令，并提供系统托盘
 UI 来做环境诊断、更新、浏览器登录态保活和网页转 Markdown。
 
 **方式 A — OpenCLIApp（macOS / Windows 推荐）：**
@@ -30,7 +30,7 @@ UI 来做环境诊断、更新、浏览器登录态保活和网页转 Markdown
 System 页面安装或修复 `opencli` 命令。
 
 **方式 B — npm 全局安装（纯 CLI / CI / 服务器）：**
-通过 npm 安装时，OpenCLI 要求 **Node.js >= 20**。
+通过 npm 安装时，ppcli 要求 **Node.js >= 20**。
 
 ```bash
 node --version
@@ -39,10 +39,10 @@ npm install -g @jackwener/opencli
 
 ### 2. 安装 Browser Bridge 扩展
 
-OpenCLI 通过轻量 Browser Bridge 扩展和本地微型 daemon 与 Chrome/Chromium 通信。daemon 会按需自动启动。
+ppcli 通过轻量 Browser Bridge 扩展和本地微型 daemon 与 Chrome/Chromium 通信。daemon 会按需自动启动。
 
 **方式 A — Chrome Web Store（推荐）：**
-在 [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk) 安装 **OpenCLI** 扩展。
+在 [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk) 安装 **ppcli** 扩展。
 
 **方式 B — 手动安装：**
 1. 到 GitHub [Releases 页面](https://github.com/jackwener/opencli/releases) 下载最新的 `opencli-extension-v{version}.zip`。
@@ -52,41 +52,41 @@ OpenCLI 通过轻量 Browser Bridge 扩展和本地微型 daemon 与 Chrome/Chro
 ### 3. 验证环境
 
 ```bash
-opencli doctor
+ppcli doctor
 ```
 
 ### 4. 跑第一个命令
 
 ```bash
-opencli list
-opencli hackernews top --limit 5
-opencli bilibili hot --limit 5
+ppcli list
+ppcli hackernews top --limit 5
+ppcli bilibili hot --limit 5
 ```
 
 ## 给人类用户
 
 如果你只是想稳定地调用网站或桌面应用能力，主路径很简单：
 
-- `opencli list` 查看当前所有命令
-- `opencli <site> <command>` 调用内置或生成好的适配器
-- `opencli external register mycli` 把本地 CLI 接入同一发现入口
-- `opencli doctor` 处理浏览器连通性问题
+- `ppcli list` 查看当前所有命令
+- `ppcli <site> <command>` 调用内置或生成好的适配器
+- `ppcli external register mycli` 把本地 CLI 接入同一发现入口
+- `ppcli doctor` 处理浏览器连通性问题
 
-## 扩展 OpenCLI
+## 扩展 ppcli
 
-如果你想新增自己的命令，先看 [扩展 OpenCLI](./docs/zh/guide/extending-opencli.md)。README 只保留入口；目录结构、源码管理方式和安装命令放在文档里。
+如果你想新增自己的命令，先看 [扩展 ppcli](./docs/zh/guide/extending-opencli.md)。README 只保留入口；目录结构、源码管理方式和安装命令放在文档里。
 
 | 需求 | 推荐路径 |
 |------|----------|
-| 把个人网站命令放在自己的 Git repo | `opencli plugin create` + `opencli plugin install file://...` |
-| 快速写一个本机私人 adapter | `opencli browser init <site>/<command>`，放在 `~/.opencli/clis/` |
-| 本地修改官方 adapter | `opencli adapter eject <site>` + `opencli adapter reset <site>` |
-| 发布或安装第三方命令 | `opencli plugin install github:user/repo` |
-| 包装已有本机 binary | `opencli external register <name>` |
+| 把个人网站命令放在自己的 Git repo | `ppcli plugin create` + `ppcli plugin install file://...` |
+| 快速写一个本机私人 adapter | `ppcli browser init <site>/<command>`，放在 `~/.ppcli/clis/` |
+| 本地修改官方 adapter | `ppcli adapter eject <site>` + `ppcli adapter reset <site>` |
+| 发布或安装第三方命令 | `ppcli plugin install github:user/repo` |
+| 包装已有本机 binary | `ppcli external register <name>` |
 
 ## 给 AI Agent
 
-OpenCLI 的 browser 命令是给 AI Agent 用的——不是手动执行的。把 skill 安装到你的 AI Agent（Claude Code、Cursor 等）中，Agent 就能用你的已登录 Chrome 会话替你操作网站。
+ppcli 的 browser 命令是给 AI Agent 用的——不是手动执行的。把 skill 安装到你的 AI Agent（Claude Code、Cursor 等）中，Agent 就能用你的已登录 Chrome 会话替你操作网站。
 
 ### 安装 skill（同时也用于更新）
 
@@ -110,11 +110,11 @@ npx skills add jackwener/opencli --skill opencli-usage
 | Skill | 适用场景 | 你对 AI Agent 说的话 |
 |-------|---------|-------------------|
 | **opencli-adapter-author** | 为新站点写可复用适配器，或给已有站点添加命令 | "帮我做一个抖音热门的适配器" / "帮我做一个抓取这个页面热帖的命令" |
-| **opencli-autofix** | 内置命令失败时修复已有适配器 | "`opencli zhihu hot` 返回空了，修一下" |
+| **opencli-autofix** | 内置命令失败时修复已有适配器 | "`ppcli zhihu hot` 返回空了，修一下" |
 | **opencli-browser** | 实时驱动 Chrome 页面——导航、填表单、点击、抓取 | "帮我看看小红书的通知" / "帮我填一下这个表单" / "用浏览器命令抓取这个页面" |
 | **opencli-browser-sitemap** | 使用站点 sitemap 上下文来操作浏览器任务 | "用 sitemap 帮我少走弯路地操作这个网站" |
 | **opencli-sitemap-author** | 创建或更新面向浏览器 Agent 的站点 sitemap | "把刚发现的稳定流程记录到这个站点的 sitemap" |
-| **opencli-usage** | 所有命令和站点的快速参考 | "OpenCLI 有哪些 Twitter 相关的命令？" |
+| **opencli-usage** | 所有命令和站点的快速参考 | "ppcli 有哪些 Twitter 相关的命令？" |
 
 ### 工作原理
 
@@ -126,7 +126,7 @@ npx skills add jackwener/opencli --skill opencli-usage
 4. **提取**页面数据或拦截网络 API 响应
 5. **等待**元素、文本或页面跳转
 
-Agent 在内部自动处理所有 `opencli browser` 命令——你只需用自然语言描述想做的事。
+Agent 在内部自动处理所有 `ppcli browser` 命令——你只需用自然语言描述想做的事。
 
 **Skill 参考文档：**
 - [`skills/opencli-browser/SKILL.md`](./skills/opencli-browser/SKILL.md) — 实时驱动 Chrome（导航、填表单、点击、抓取）
@@ -138,7 +138,7 @@ Agent 在内部自动处理所有 `opencli browser` 命令——你只需用自
 
 `browser` 可用命令包括：`open`、`state`、`click`、`type`、`fill`、`select`、`keys`、`wait`、`get`、`find`、`extract`、`frames`、`screenshot`、`scroll`、`back`、`eval`、`network`、`tab list`、`tab new`、`tab select`、`tab close`、`init`、`verify`、`close`。
 
-`opencli browser` 命令必须紧跟一个 `<session>` 位置参数。`opencli browser work open <url>` 和 `opencli browser work tab new [url]` 都会返回 target ID。`opencli browser work tab list` 用来查看当前已存在 tab 的 target ID，再通过 `--tab <targetId>` 把命令明确路由到某个 tab。`tab new` 只会新建 tab，不会改变默认浏览器目标；只有显式执行 `tab select <targetId>`，才会把该 tab 设为同一 session 后续未指定 target 的默认目标。
+`ppcli browser` 命令必须紧跟一个 `<session>` 位置参数。`ppcli browser work open <url>` 和 `ppcli browser work tab new [url]` 都会返回 target ID。`ppcli browser work tab list` 用来查看当前已存在 tab 的 target ID，再通过 `--tab <targetId>` 把命令明确路由到某个 tab。`tab new` 只会新建 tab，不会改变默认浏览器目标；只有显式执行 `tab select <targetId>`，才会把该 tab 设为同一 session 后续未指定 target 的默认目标。
 
 ## 为新站点写适配器
 
@@ -148,8 +148,8 @@ Agent 在内部自动处理所有 `opencli browser` 命令——你只需用自
 2. **发现** endpoint——network 精读、initial state、bundle 搜索、token 溯源，或 interceptor 兜底
 3. **定认证**——`PUBLIC` / `COOKIE` / `INTERCEPT` / `UI` / `LOCAL`
 4. **字段解码** + 设计输出列
-5. `opencli browser recon analyze <url>` → `opencli browser recon init <site>/<name>` → 写适配器 → `opencli browser recon verify <site>/<name>`
-6. 站点知识沉到 `~/.opencli/sites/<site>/`，下次同站点直接吃缓存
+5. `ppcli browser recon analyze <url>` → `ppcli browser recon init <site>/<name>` → 写适配器 → `ppcli browser recon verify <site>/<name>`
+6. 站点知识沉到 `~/.ppcli/sites/<site>/`，下次同站点直接吃缓存
 
 ## 配置
 
@@ -164,11 +164,11 @@ Agent 在内部自动处理所有 `opencli browser` 命令——你只需用自
 | `OPENCLI_VERBOSE` | `false` | 启用详细日志（`-v` 也可以） |
 | `DEBUG_SNAPSHOT` | — | 设为 `1` 输出 DOM 快照调试信息 |
 
-`opencli browser *` 必须紧跟一个 `<session>` 位置参数，默认使用前台窗口，并保留该 session 的 tab lease，直到你手动执行 `opencli browser <session> close` 或等空闲超时。浏览器型 adapter 默认使用后台 adapter 窗口并在命令结束后释放一次性 tab lease；如果需要调试最终页面，可以传 `--window foreground --keep-tab true`。
+`ppcli browser *` 必须紧跟一个 `<session>` 位置参数，默认使用前台窗口，并保留该 session 的 tab lease，直到你手动执行 `ppcli browser <session> close` 或等空闲超时。浏览器型 adapter 默认使用后台 adapter 窗口并在命令结束后释放一次性 tab lease；如果需要调试最终页面，可以传 `--window foreground --keep-tab true`。
 
 ## 内置命令
 
-运行 `opencli list` 查看完整注册表。
+运行 `ppcli list` 查看完整注册表。
 
 | 站点 | 命令 |
 |------|------|
@@ -192,17 +192,17 @@ Agent 在内部自动处理所有 `opencli browser` 命令——你只需用自
 
 ### 外部 CLI 枢纽
 
-把现有命令行工具统一接入 `opencli <tool> ...`：
+把现有命令行工具统一接入 `ppcli <tool> ...`：
 
 `gh` · `docker` · `vercel` · `wrangler` · `obsidian` · `longbridge` · `lark-cli` · `ntn(notion)` · `dws(DingTalk Workspace)` · `wecom-cli(企业微信)` · `tg(tg-cli)` · `discord(discord-cli)` · `wx(wx-cli)`
 
-注册自定义本地 CLI：`opencli external register <name>`；查看所有：`opencli external list`。
+注册自定义本地 CLI：`ppcli external register <name>`；查看所有：`ppcli external list`。
 
 **桌面应用适配器**（Electron，通过 CDP）：Cursor / Trae CN / Codex / Antigravity / ChatGPT App / ChatWise / Qoder / Discord / Doubao / Trae SOLO — 详见 [`docs/adapters/desktop/`](./docs/adapters/desktop/)。
 
 ## 下载支持
 
-OpenCLI 支持从各平台下载图片、视频和文章。
+ppcli 支持从各平台下载图片、视频和文章。
 
 ### 支持的平台
 
@@ -233,43 +233,43 @@ brew install yt-dlp
 
 ```bash
 # 下载小红书笔记中的图片/视频
-opencli xiaohongshu download "https://www.xiaohongshu.com/search_result/<id>?xsec_token=..." --output ./xhs
-opencli xiaohongshu download "https://xhslink.com/..." --output ./xhs
-opencli rednote download "https://www.rednote.com/search_result/<id>?xsec_token=..." --output ./rednote
+ppcli xiaohongshu download "https://www.xiaohongshu.com/search_result/<id>?xsec_token=..." --output ./xhs
+ppcli xiaohongshu download "https://xhslink.com/..." --output ./xhs
+ppcli rednote download "https://www.rednote.com/search_result/<id>?xsec_token=..." --output ./rednote
 
 # 下载B站视频（需要 yt-dlp）
-opencli bilibili download BV1xxx --output ./bilibili
-opencli bilibili download BV1xxx --quality 1080p  # 指定画质
+ppcli bilibili download BV1xxx --output ./bilibili
+ppcli bilibili download BV1xxx --quality 1080p  # 指定画质
 
 # 下载 Twitter 用户的媒体
-opencli twitter download elonmusk --limit 20 --output ./twitter
+ppcli twitter download elonmusk --limit 20 --output ./twitter
 
 # 下载单条推文的媒体
-opencli twitter download --tweet-url "https://x.com/user/status/123" --output ./twitter
+ppcli twitter download --tweet-url "https://x.com/user/status/123" --output ./twitter
 
 # 下载豆瓣电影海报 / 剧照
-opencli douban download 30382501 --output ./douban
+ppcli douban download 30382501 --output ./douban
 
 # 下载 1688 商品页中的图片 / 视频素材
-opencli 1688 download 841141931191 --output ./1688-downloads
+ppcli 1688 download 841141931191 --output ./1688-downloads
 
 # 下载小宇宙单集音频
-opencli xiaoyuzhou download 69b3b675772ac2295bfc01d0 --output ./xiaoyuzhou
+ppcli xiaoyuzhou download 69b3b675772ac2295bfc01d0 --output ./xiaoyuzhou
 
 # 下载小宇宙单集转录
-opencli xiaoyuzhou transcript 69dd0c98e2c8be31551f6a33 --output ./xiaoyuzhou-transcripts
+ppcli xiaoyuzhou transcript 69dd0c98e2c8be31551f6a33 --output ./xiaoyuzhou-transcripts
 
 # 导出知乎文章为 Markdown
-opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
+ppcli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
 
 # 导出并下载图片
-opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --download-images
+ppcli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --download-images
 
 # 导出微信公众号文章为 Markdown
-opencli weixin download --url "https://mp.weixin.qq.com/s/xxx" --output ./weixin
+ppcli weixin download --url "https://mp.weixin.qq.com/s/xxx" --output ./weixin
 ```
 
-`opencli xiaoyuzhou download` 和 `transcript` 需要本地小宇宙凭证：`~/.opencli/xiaoyuzhou.json`。
+`ppcli xiaoyuzhou download` 和 `transcript` 需要本地小宇宙凭证：`~/.ppcli/xiaoyuzhou.json`。
 
 
 
@@ -279,32 +279,32 @@ opencli weixin download --url "https://mp.weixin.qq.com/s/xxx" --output ./weixin
 `list` 命令也支持同样的格式参数，同时继续兼容 `--json`。
 
 ```bash
-opencli list -f yaml            # 用 YAML 列出命令注册表
-opencli bilibili hot -f table   # 默认：富文本表格
-opencli bilibili hot -f json    # JSON（适合传给 jq 或者各类 AI Agent）
-opencli bilibili hot -f yaml    # YAML（更适合人类直接阅读）
-opencli bilibili hot -f md      # Markdown
-opencli bilibili hot -f csv     # CSV
-opencli bilibili hot -v         # 详细模式：展示管线执行步骤调试信息
+ppcli list -f yaml            # 用 YAML 列出命令注册表
+ppcli bilibili hot -f table   # 默认：富文本表格
+ppcli bilibili hot -f json    # JSON（适合传给 jq 或者各类 AI Agent）
+ppcli bilibili hot -f yaml    # YAML（更适合人类直接阅读）
+ppcli bilibili hot -f md      # Markdown
+ppcli bilibili hot -f csv     # CSV
+ppcli bilibili hot -v         # 详细模式：展示管线执行步骤调试信息
 ```
 
 ## 退出码
 
-opencli 遵循 Unix `sysexits.h`，CI / 脚本可按失败模式分支：`0` 成功、`66` 无数据、`69` Browser Bridge 未连接、`75` 超时、`77` 需要认证、`78` 配置错误、`130` Ctrl-C。完整参考：[docs/zh/guide/exit-codes.md](./docs/zh/guide/exit-codes.md)。
+ppcli 遵循 Unix `sysexits.h`，CI / 脚本可按失败模式分支：`0` 成功、`66` 无数据、`69` Browser Bridge 未连接、`75` 超时、`77` 需要认证、`78` 配置错误、`130` Ctrl-C。完整参考：[docs/zh/guide/exit-codes.md](./docs/zh/guide/exit-codes.md)。
 
 ## 插件
 
-通过社区贡献的插件扩展 OpenCLI。插件使用与内置命令相同的 JS 格式，启动时自动发现。
+通过社区贡献的插件扩展 ppcli。插件使用与内置命令相同的 JS 格式，启动时自动发现。
 
 ```bash
-opencli plugin install github:user/opencli-plugin-my-tool  # 安装
-opencli plugin list                                         # 查看已安装
-opencli plugin update my-tool                               # 更新到最新
-opencli plugin update --all                                 # 更新全部已安装插件
-opencli plugin uninstall my-tool                            # 卸载
+ppcli plugin install github:user/opencli-plugin-my-tool  # 安装
+ppcli plugin list                                         # 查看已安装
+ppcli plugin update my-tool                               # 更新到最新
+ppcli plugin update --all                                 # 更新全部已安装插件
+ppcli plugin uninstall my-tool                            # 卸载
 ```
 
-当 plugin 的版本被记录到 `~/.opencli/plugins.lock.json` 后，`opencli plugin list` 也会显示对应的短 commit hash。
+当 plugin 的版本被记录到 `~/.ppcli/plugins.lock.json` 后，`ppcli plugin list` 也会显示对应的短 commit hash。
 
 | 插件 | 类型 | 描述 |
 |------|------|------|
@@ -318,13 +318,13 @@ opencli plugin uninstall my-tool                            # 卸载
 ## 常见问题排查
 
 - **"Extension not connected" 报错**
-  - 确保你已从 [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk) 安装 OpenCLI 扩展，且在 `chrome://extensions` 中**已启用**。
+  - 确保你已从 [Chrome Web Store](https://chromewebstore.google.com/detail/opencli/ildkmabpimmkaediidaifkhjpohdnifk) 安装 ppcli 扩展，且在 `chrome://extensions` 中**已启用**。
 - **"attach failed: Cannot access a chrome-extension:// URL" 报错**
   - 其他 Chrome/Chromium 扩展（如 youmind、New Tab Override 或 AI 助手类扩展）可能产生冲突。请尝试**暂时禁用其他扩展**后重试。
 - **返回空数据，或者报错 "Unauthorized"**
   - Chrome/Chromium 里的登录态可能已经过期。请打开当前页面，在新标签页重新手工登录或刷新该页面。
 - **Node API 错误 / 缺少 `fetch` / 旧 Node 启动即崩**
-  - OpenCLI 要求 **Node.js >= 20**。先执行 `node --version`，如果版本过低先升级，再重试命令。
+  - ppcli 要求 **Node.js >= 20**。先执行 `node --version`，如果版本过低先升级，再重试命令。
 - **Daemon 问题**
   - 检查 daemon 状态：`curl localhost:19825/status`
   - 查看扩展日志：`curl localhost:19825/logs`