publishport-opencli 1.0.0 → 1.0.2

package/docs/guide/troubleshooting.md

@@ -4,8 +4,8 @@
 
 ### "Extension not connected"
 
-- Ensure the opencli Browser Bridge extension is installed and **enabled** in `chrome://extensions`.
-- Run `opencli doctor` to diagnose connectivity.
+- Ensure the ppcli Browser Bridge extension is installed and **enabled** in `chrome://extensions`.
+- Run `ppcli doctor` to diagnose connectivity.
 
 ### Empty data or 'Unauthorized' error
 
@@ -16,11 +16,11 @@
 
 - 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.
+- Example: `ppcli 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
+OPENCLI_CDP_TARGET=detail.1688.com ppcli 1688 item 841141931191 -f json
 ```
 
 ### Node API errors
@@ -34,15 +34,15 @@ OPENCLI_CDP_TARGET=detail.1688.com opencli 1688 item 841141931191 -f json
 curl localhost:19825/logs
 
 # Stop the daemon
-opencli daemon stop
+ppcli daemon stop
 
 # Full diagnostics
-opencli doctor
+ppcli doctor
 ```
 
-> The daemon is persistent and stays alive until explicitly stopped (`opencli daemon stop`) or the package is uninstalled.
+> The daemon is persistent and stays alive until explicitly stopped (`ppcli daemon stop`) or the package is uninstalled.
 
-> When the CLI detects a stale daemon (version mismatch after `npm install -g @jackwener/opencli@latest`), it first asks the daemon to shut down via `/shutdown`, then falls back to `SIGKILL` if the daemon does not release the port within 3 seconds. Manual `opencli daemon stop` is only needed if SIGKILL itself is rejected (cross-user owner / cross-machine PID file).
+> When the CLI detects a stale daemon (version mismatch after `npm install -g @jackwener/opencli@latest`), it first asks the daemon to shut down via `/shutdown`, then falls back to `SIGKILL` if the daemon does not release the port within 3 seconds. Manual `ppcli daemon stop` is only needed if SIGKILL itself is rejected (cross-user owner / cross-machine PID file).
 
 ### Desktop adapter connection issues
 
@@ -66,4 +66,4 @@ npx tsc --noEmit
 ## Getting Help
 
 - [GitHub Issues](https://github.com/jackwener/opencli/issues) — Bug reports and feature requests
-- Run `opencli doctor` for comprehensive diagnostics
+- Run `ppcli doctor` for comprehensive diagnostics

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "publishport-opencli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "publishConfig": {
     "access": "public",
     "provenance": false
@@ -12,6 +12,7 @@
   "type": "module",
   "main": "dist/src/main.js",
   "bin": {
+    "ppcli": "dist/src/main.js",
     "opencli": "dist/src/main.js"
   },
   "exports": {
@@ -96,8 +97,8 @@
     "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@types/jsdom": "^27.0.0",
     "@types/js-yaml": "^4.0.9",
+    "@types/jsdom": "^27.0.0",
     "@types/node": "^25.5.2",
     "@types/turndown": "^5.0.6",
     "@types/ws": "^8.5.13",

package/scripts/fetch-adapters.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * Sparse adapter sync: keeps ~/.opencli/clis/ clean by removing stale overrides.
+ * Sparse adapter sync: keeps ~/.ppcli/clis/ clean by removing stale overrides.
  *
  * Strategy (hash-based, site-level granularity):
  * - When an official site has upstream changes: DELETE the local override
@@ -10,7 +10,7 @@
  * - User-created custom sites (not in package): always preserved
  * - Skips entirely if already synced at the same version
  *
- * ~/.opencli/clis/ is a sparse override layer, not a full copy.
+ * ~/.ppcli/clis/ is a sparse override layer, not a full copy.
  * Only eject-ed or user-modified sites appear here.
  *
  * Only runs on global install (npm install -g) or explicit OPENCLI_FETCH=1.
@@ -24,7 +24,7 @@ import { createHash } from 'node:crypto';
 import { join, resolve, dirname, relative } from 'node:path';
 import { homedir } from 'node:os';
 
-const OPENCLI_DIR = join(homedir(), '.opencli');
+const OPENCLI_DIR = join(homedir(), '.ppcli');
 const USER_CLIS_DIR = join(OPENCLI_DIR, 'clis');
 const MANIFEST_PATH = join(OPENCLI_DIR, 'adapter-manifest.json');
 const PACKAGE_ROOT = resolve(import.meta.dirname, '..');
@@ -159,7 +159,7 @@ export function fetchAdapters() {
 
   // 2. Sparse cleanup: for changed/removed official sites, delete local overrides.
   //    Do NOT copy new versions — runtime falls back to package baseline.
-  //    Only eject-ed sites live in ~/.opencli/clis/.
+  //    Only eject-ed sites live in ~/.ppcli/clis/.
   let cleared = 0;
   for (const site of changedSites) {
     const siteDir = join(USER_CLIS_DIR, site);
@@ -204,9 +204,9 @@ export function fetchAdapters() {
   }
   if (yamlCleaned > 0) log(`Cleaned up ${yamlCleaned} stale .yaml adapter files`);
 
-  // 4. Clean up legacy compat shim files from ~/.opencli/
+  // 4. Clean up legacy compat shim files from ~/.ppcli/
   // These were created by an older approach that placed re-export shims directly
-  // in ~/.opencli/ (e.g., registry.js, errors.js, browser/). The current approach
+  // in ~/.ppcli/ (e.g., registry.js, errors.js, browser/). The current approach
   // uses a node_modules/@jackwener/opencli symlink instead.
   const LEGACY_SHIM_FILES = [
     'registry.js', 'errors.js', 'utils.js', 'launcher.js', 'logger.js', 'types.js',

package/scripts/postinstall.js

@@ -22,36 +22,36 @@ import { homedir } from 'node:os';
 
 // ── Completion script content ──────────────────────────────────────────────
 
-const BASH_COMPLETION = `# Bash completion for opencli (auto-installed)
+const BASH_COMPLETION = `# Bash completion for ppcli (auto-installed)
 _opencli_completions() {
   local cur words cword
   _get_comp_words_by_ref -n : cur words cword
 
   local completions
-  completions=$(opencli --get-completions --cursor "$cword" "\${words[@]:1}" 2>/dev/null)
+  completions=$(ppcli --get-completions --cursor "$cword" "\${words[@]:1}" 2>/dev/null)
 
   COMPREPLY=( $(compgen -W "$completions" -- "$cur") )
   __ltrim_colon_completions "$cur"
 }
-complete -F _opencli_completions opencli
+complete -F _opencli_completions ppcli
 `;
 
-const ZSH_COMPLETION = `#compdef opencli
-# Zsh completion for opencli (auto-installed)
+const ZSH_COMPLETION = `#compdef ppcli
+# Zsh completion for ppcli (auto-installed)
 _opencli() {
   local -a completions
   local cword=$((CURRENT - 1))
-  completions=(\${(f)"$(opencli --get-completions --cursor "$cword" "\${words[@]:1}" 2>/dev/null)"})
+  completions=(\${(f)"$(ppcli --get-completions --cursor "$cword" "\${words[@]:1}" 2>/dev/null)"})
   compadd -a completions
 }
 _opencli
 `;
 
-const FISH_COMPLETION = `# Fish completion for opencli (auto-installed)
-complete -c opencli -f -a '(
+const FISH_COMPLETION = `# Fish completion for ppcli (auto-installed)
+complete -c ppcli -f -a '(
   set -l tokens (commandline -cop)
   set -l cursor (count (commandline -cop))
-  opencli --get-completions --cursor $cursor $tokens[2..] 2>/dev/null
+  ppcli --get-completions --cursor $cursor $tokens[2..] 2>/dev/null
 )'
 `;
 
@@ -113,7 +113,7 @@ function main() {
       }
       case 'bash': {
         const userCompDir = join(home, '.bash_completion.d');
-        const completionFile = join(userCompDir, 'opencli');
+        const completionFile = join(userCompDir, 'ppcli');
         ensureDir(userCompDir);
         writeFileSync(completionFile, BASH_COMPLETION, 'utf8');
 
@@ -127,7 +127,7 @@ function main() {
       }
       case 'fish': {
         const completionsDir = join(home, '.config', 'fish', 'completions');
-        const completionFile = join(completionsDir, 'opencli.fish');
+        const completionFile = join(completionsDir, 'ppcli.fish');
         ensureDir(completionsDir);
         writeFileSync(completionFile, FISH_COMPLETION, 'utf8');
 
@@ -144,7 +144,7 @@ function main() {
   }
 
   // ── Spotify credentials template ────────────────────────────────────
-  const opencliDir = join(home, '.opencli');
+  const opencliDir = join(home, '.ppcli');
   const spotifyEnvFile = join(opencliDir, 'spotify.env');
   ensureDir(opencliDir);
   if (!existsSync(spotifyEnvFile)) {
@@ -156,7 +156,7 @@ function main() {
       'utf8'
     );
     console.log(`✓ Spotify credentials template created at ${spotifyEnvFile}`);
-    console.log(`  Edit the file and add your Client ID and Secret, then run: opencli spotify auth`);
+    console.log(`  Edit the file and add your Client ID and Secret, then run: ppcli spotify auth`);
   }
 
   // ── Browser Bridge setup hint ───────────────────────────────────────
@@ -166,7 +166,7 @@ function main() {
   console.log('  1. Download: https://github.com/jackwener/opencli/releases');
   console.log('  2. In Chrome or Chromium, open chrome://extensions → enable Developer Mode → Load unpacked');
   console.log('');
-  console.log('  Then run \x1b[36mopencli doctor\x1b[0m to verify.');
+  console.log('  Then run \x1b[36mppcli doctor\x1b[0m to verify.');
   console.log('');
 
 }

package/skills/opencli-adapter-author/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: opencli-adapter-author
-description: Use when writing an OpenCLI adapter for a new site or adding a new command to an existing site. Guides end-to-end from first recon through field decoding, adapter coding, and verify. Replaces opencli-oneshot / opencli-explorer. For ad-hoc browser driving (no adapter), see opencli-browser instead; for a top-level orientation to opencli, see opencli-usage.
-allowed-tools: Bash(opencli:*), Read, Edit, Write, Grep
+description: Use when writing an ppcli adapter for a new site or adding a new command to an existing site. Guides end-to-end from first recon through field decoding, adapter coding, and verify. Replaces opencli-oneshot / opencli-explorer. For ad-hoc browser driving (no adapter), see opencli-browser instead; for a top-level orientation to ppcli, see opencli-usage.
+allowed-tools: Bash(ppcli:*), Read, Edit, Write, Grep
 ---
 
 # opencli-adapter-author
 
-你是要给一个站点写 adapter 的 agent。这份 skill 目标：**从零到通过 `opencli browser verify` 的 30 分钟内闭环**。
+你是要给一个站点写 adapter 的 agent。这份 skill 目标：**从零到通过 `ppcli browser verify` 的 30 分钟内闭环**。
 
-全程用现有工具：`opencli browser *` / `opencli doctor` / `opencli browser init` / `opencli browser verify`。没有新命令。
+全程用现有工具：`ppcli browser *` / `ppcli doctor` / `ppcli browser init` / `ppcli browser verify`。没有新命令。
 
 调试浏览器型 adapter 时，优先直接带上 `--trace on --keep-tab true --window foreground`。`--trace on` 每轮都落 trace artifact，`summary.md` 是失败/成功复盘入口；`--keep-tab true --window foreground` 让 tab lease 保留且浏览器窗口在前台，方便核对最终页面状态。
 
@@ -54,7 +54,7 @@ Strategy classes:
 | `COOKIE_API` | stable | Node-side `fetch` + `page.getCookies()` / header helper 能拿数据 | cookie/CSRF 来源清楚，replay 非空 |
 | `UI_SELECTOR` | visible-ui | publish/upload/click/表单，或页面语义比内部接口更稳 | selector 有语义锚点；错误路径是 typed error |
 | `DOM_STATE` | visible-ui | 数据在 hydration state / bootstrap JSON / SSR HTML 里 | state key / script JSON / HTML 结构明确 |
-| `PAGE_FETCH` | internal-unstable | 只能在页面上下文 `fetch` 才能复用 same-origin/session/runtime | `opencli browser eval fetch(...)` 非空；必须解释为什么避不开内部接口 |
+| `PAGE_FETCH` | internal-unstable | 只能在页面上下文 `fetch` 才能复用 same-origin/session/runtime | `ppcli browser eval fetch(...)` 非空；必须解释为什么避不开内部接口 |
 | `INTERCEPT` | internal-unstable | 请求签名复杂，但页面自己能自然发出请求 | 触发 UI 后能截到目标 response；必须解释为什么 UI/DOM 不够 |
 
 选择规则：优先 `PUBLIC_API` / `COOKIE_API`。如果 UI/DOM 语义稳定，不要强行升级到 `PAGE_FETCH` / `INTERCEPT`。只有公开/官方接口不可用、UI/DOM 无法表达目标数据或操作时，才承担无契约内部接口的维护成本。
@@ -68,14 +68,14 @@ START
   │
   ▼
 ┌──────────────────────────┐
-│ opencli doctor 通？      │── no ──→ 修桥接（doctor 输出里的提示）
+│ ppcli doctor 通？      │── no ──→ 修桥接（doctor 输出里的提示）
 └──────────────────────────┘
   │ yes
   ▼
 ┌────────────────────────────────────────────────────┐
 │ 读站点记忆：                                        │
-│   1. ~/.opencli/sites/<site>/endpoints.json         │
-│   2. ~/.opencli/sites/<site>/notes.md               │
+│   1. ~/.ppcli/sites/<site>/endpoints.json         │
+│   2. ~/.ppcli/sites/<site>/notes.md               │
 │   3. references/site-memory/<site>.md               │
 └────────────────────────────────────────────────────┘
   │ 命中 endpoint + 字段 → 直接跳到【endpoint 验证】（不跳写 adapter！memory 可能过期）
@@ -110,14 +110,14 @@ START
   │
   ▼
 ┌──────────────────────────┐
-│ opencli browser init      │  生成 ~/.opencli/clis/<site>/<name>.js 骨架
+│ ppcli browser init      │  生成 ~/.ppcli/clis/<site>/<name>.js 骨架
 │ 复制最像的邻居 adapter    │
 │ 改 name / URL / 映射三处  │
 └──────────────────────────┘
   │
   ▼
 ┌──────────────────────────┐
-│ opencli browser verify    │── 失败 ──→ autofix skill，用 --trace retain-on-failure 回对应步骤
+│ ppcli browser verify    │── 失败 ──→ autofix skill，用 --trace retain-on-failure 回对应步骤
 └──────────────────────────┘
   │ 成功
   ▼
@@ -127,7 +127,7 @@ START
   │ 对得上
   ▼
 ┌──────────────────────────┐
-│ 回写 ~/.opencli/sites/   │  endpoints / field-map / notes / fixtures
+│ 回写 ~/.ppcli/sites/   │  endpoints / field-map / notes / fixtures
 └──────────────────────────┘
   │
   ▼
@@ -139,14 +139,14 @@ DONE
 ## Runbook（一步一步勾选）
 
 ```
-[ ] 1. opencli doctor 返回 "Everything looks good"
+[ ] 1. ppcli doctor 返回 "Everything looks good"
 [ ] 2. 读站点记忆：
-       [ ] ~/.opencli/sites/<site>/endpoints.json 存在？里面有想要的 endpoint？
+       [ ] ~/.ppcli/sites/<site>/endpoints.json 存在？里面有想要的 endpoint？
        [ ] references/site-memory/<site>.md 存在？看"已知 endpoint"节
        [ ] 命中后：**跳到第 5（endpoint 验证） + 第 7（字段核对）**，不能直接跳第 9 写 adapter
        [ ] memory 写入超过 30 天（看 `verified_at`）→ 当作过期，按冷启动走 Step 3 → 4
 [ ] 3. 侦察（site-recon.md）：
-       [ ] **首选**：`opencli browser analyze <url>` 一步拿 pattern + 反爬 + 最近 adapter + next step
+       [ ] **首选**：`ppcli browser analyze <url>` 一步拿 pattern + 反爬 + 最近 adapter + next step
        [ ] `analyze` 结论模糊时再手跑：`open` → `wait time 2` (或 `wait xhr <regex>`) → `network`
        [ ] 定 Pattern（A / B / C / D / E）
 [ ] 4. API 发现（api-discovery.md）按 Pattern 选 §：
@@ -173,21 +173,21 @@ DONE
        [ ] 类型 / 单位 / 百分比格式清楚
        [ ] 顺序：识别列 → 业务数字 → metadata
 [ ] 9. 写 adapter（adapter-template.md）：
-       [ ] opencli browser init <site>/<name>
+       [ ] ppcli browser init <site>/<name>
        [ ] 找同站点或同类型最像的 adapter，cp 过来
        [ ] 改 name / URL / 字段映射
-[ ] 10. opencli browser verify <site>/<name>
-        [ ] 首轮通过后立刻 `--write-fixture` 生成 `~/.opencli/sites/<site>/verify/<cmd>.json` 种子
+[ ] 10. ppcli browser verify <site>/<name>
+        [ ] 首轮通过后立刻 `--write-fixture` 生成 `~/.ppcli/sites/<site>/verify/<cmd>.json` 种子
         [ ] 手改种子：加 `patterns`（URL / 日期 / ID 格式）+ `notEmpty`（核心字段）+ 收紧 `rowCount`
-        [ ] 再跑一次 `opencli browser verify <site>/<name>`，确认 ✓ matches fixture
+        [ ] 再跑一次 `ppcli browser verify <site>/<name>`，确认 ✓ matches fixture
 [ ] 11. 字段值 vs 网页肉眼比对（别只看 "Adapter works!"）
 [ ] 12. 回写站点记忆（**verify 通过 + 肉眼比对对得上之后**，schema 见 `references/site-memory.md`）：
         [ ] `endpoints.json`：以 endpoint 的短名为 key，value = `{url, method, params.{required,optional}, response, verified_at: YYYY-MM-DD, notes}`
         [ ] `field-map.json`：只追加新代号。key = 字段代号，value = `{meaning, verified_at: YYYY-MM-DD, source}`；**已存在的 key 不要覆盖**，有冲突先和网页肉眼值对齐再写
         [ ] `notes.md`：顶部追加一段 `## YYYY-MM-DD by <agent/user>`，写本次写 adapter 时遇到的新坑 / 新结论
-        [ ] `verify/<cmd>.json`：**必填。** `opencli browser verify` 的期望值（args / rowCount / columns / types / patterns / notEmpty），Step 10 已经让你生成了，这里只是 checklist
+        [ ] `verify/<cmd>.json`：**必填。** `ppcli browser verify` 的期望值（args / rowCount / columns / types / patterns / notEmpty），Step 10 已经让你生成了，这里只是 checklist
         [ ] `fixtures/<cmd>-<YYYYMMDDHHMM>.json`：存一份该 endpoint 的完整响应样本（去掉 cookie / token / 用户私有字段再存），给后续字段对比 / 离线 replay 用
-        [ ] 调试过程中如果在 repo / adapter 目录 dump 过临时文件（`.dbg-*.html` / `raw-*.json` / 等），**在 commit 前清干净**——这些本来就该落在 `~/.opencli/sites/<site>/fixtures/` 或 `/tmp/`
+        [ ] 调试过程中如果在 repo / adapter 目录 dump 过临时文件（`.dbg-*.html` / `raw-*.json` / 等），**在 commit 前清干净**——这些本来就该落在 `~/.ppcli/sites/<site>/fixtures/` 或 `/tmp/`
 ```
 
 ---
@@ -225,7 +225,7 @@ DONE
 | `references/field-decode-playbook.md` | Step 7 字段不在词典时 |
 | `references/output-design.md` | Step 8 命名 / 类型 / 顺序 |
 | `references/adapter-template.md` | Step 9 文件结构 + 活例子 `convertible.js` |
-| `references/site-memory.md` | 总览：in-repo 种子 + 本地 `~/.opencli/sites/` 的两层结构 |
+| `references/site-memory.md` | 总览：in-repo 种子 + 本地 `~/.ppcli/sites/` 的两层结构 |
 | `references/site-memory/<site>.md` | Step 2 读站点公共知识（eastmoney / xueqiu / bilibili / tonghuashun 已铺） |
 | `references/success-rate-pitfalls.md` | Step 7 / 11 踩坑前翻：11 种"verify 能过但数据是错的"静默失败（含 aria-label locale-dependence） |
 | `references/jsdom-fixture-pattern.md` | 当 adapter 走 `page.evaluate` 内 DOM 抽取、且 mocked-evaluate 单测漏 silent bug 时——把 HTML 冻进 `clis/<site>/__fixtures__/` 用 JSDOM 跑（含 fixture 创建 mandatory `awk 'NF>0'` 收紧 + reverse-validate 纪律） |
@@ -240,16 +240,16 @@ DONE
 - **中间解析对象 key 不能跟 `columns` 任一项重叠**（否则 silent-column-drop audit 误判，PR #1329 R1 真踩过；改成专属命名 + push row 时 destructure aliasing）
 - **`browser:` field 决定 func 签名**：`browser:false → (args)`，`browser:true → (page, args)`。搞反时 `args` 实际是 debug flag，所有外部参数 silent fallback 到 default（PR #1329 upstream 之前 8 个 non-browser adapter 全踩过这个）
 - 已知失败按 [`references/typed-errors.md`](./references/typed-errors.md) 5-classification 抛对应 typed error；**不要** silent `return []`，**不要** silent `return [{sentinel}]`，**不要** `Math.max/min` silent clamp 外部参数
-- 写私人 adapter 用 `~/.opencli/clis/<site>/<name>.js`（免 build）；要提 PR 才 copy 到 `clis/<site>/<name>.js`
+- 写私人 adapter 用 `~/.ppcli/clis/<site>/<name>.js`（免 build）；要提 PR 才 copy 到 `clis/<site>/<name>.js`
 - 站点记忆每轮回写：没记忆 → 用 skill → 产生记忆 → 下次变 5 分钟
-- **调试过程中的原始 dump / 抓包 / HTML 样本只能落在 `~/.opencli/sites/<site>/fixtures/` 或 `/tmp/`。严禁在 repo 根目录、`clis/<site>/` 或当前工作目录留 `.dbg-*.html / raw-*.json / sample.*` 这类临时文件**（PR diff 会带上去，别人 review 时很烦）。
+- **调试过程中的原始 dump / 抓包 / HTML 样本只能落在 `~/.ppcli/sites/<site>/fixtures/` 或 `/tmp/`。严禁在 repo 根目录、`clis/<site>/` 或当前工作目录留 `.dbg-*.html / raw-*.json / sample.*` 这类临时文件**（PR diff 会带上去，别人 review 时很烦）。
 - **JSDOM unit-test fixture（`clis/<site>/__fixtures__/<command>.html`）是上面那条的例外**——它是有意 commit 进 repo 的 review artifact，不是临时 dump。但因此 quality bar 要更高：必须按 `references/jsdom-fixture-pattern.md` 的 5 步做完（含 mandatory `awk 'NF>0'` 空白行收紧），并 reverse-validate 一道证明 regression guard 真能挂。
 
 ---
 
 ## 卡住了
 
-- 诊断类：`opencli doctor` → 看 `notes.md` → 搜 autofix skill
+- 诊断类：`ppcli doctor` → 看 `notes.md` → 搜 autofix skill
 - 字段解码类：`field-decode-playbook.md` 全三节走完 → 先输出 raw 迭代
 - endpoint 找不到：api-discovery §5 intercept 兜底
 

package/skills/opencli-adapter-author/references/adapter-template.md

@@ -94,7 +94,7 @@ cli({
 cli({
   site: 'eastmoney',          // 第一级命名空间，目录名一致
   name: 'convertible',        // 第二级，CLI 上的子命令
-  description: '...',         // 一句话，出现在 `opencli list` 和 `opencli <site> -h`
+  description: '...',         // 一句话，出现在 `ppcli list` 和 `ppcli <site> -h`
   domain: 'push2.eastmoney.com',  // 主要请求域名（诊断面板用）
   strategy: Strategy.PUBLIC,  // PUBLIC / COOKIE / INTERCEPT / UI
   browser: false,             // PUBLIC 几乎总是 false；COOKIE/INTERCEPT/UI 一律 true
@@ -327,7 +327,7 @@ const SEND_BUTTON_SELECTORS = [
 5. **失败要 typed fail-fast**：找不到 control 应该 `CommandExecutionError` / send-failed，不要返回空 rows 或假成功
 6. **不要给 framework 加 `--i18n "zh:提交,ja:送信"` 这种 flag** —— 等于把 fallback list 从 adapter 挪到 CLI，多一层 indirection 还要维护翻译字典。这是 over-engineering，已经在评审时被否
 
-为什么不在 daemon 端固定 Chrome locale？因为 opencli **不启动 Chrome**——daemon 是连用户已经在跑的 Chrome（CDP via extension），用户可能就是中文 UI / 中文资料检索需求。强制 en-US 会破坏用户的正当工作流。
+为什么不在 daemon 端固定 Chrome locale？因为 ppcli **不启动 Chrome**——daemon 是连用户已经在跑的 Chrome（CDP via extension），用户可能就是中文 UI / 中文资料检索需求。强制 en-US 会破坏用户的正当工作流。
 
 ### Cookie 域的双查
 
@@ -383,9 +383,9 @@ if (/暂时没有提醒内容/.test(html)) {
 
 ---
 
-## Verify fixture（每个 adapter 配一份 `~/.opencli/sites/<site>/verify/<name>.json`）
+## Verify fixture（每个 adapter 配一份 `~/.ppcli/sites/<site>/verify/<name>.json`）
 
-verify fixture 是"adapter 产出长什么样"的结构锚点。没有它，`opencli browser verify` 只能证"adapter 能跑完不抛"，证不出数据没错位。**必写**。
+verify fixture 是"adapter 产出长什么样"的结构锚点。没有它，`ppcli browser verify` 只能证"adapter 能跑完不抛"，证不出数据没错位。**必写**。
 
 详细 schema 见 `site-memory.md` 的 `verify/<cmd>.json` 节。这里只讲两个容易踩的地方：
 
@@ -428,28 +428,28 @@ named-flag adapter（`hot` / `latest` 类）可以直接让工具生成种子：
 
 ```bash
 # 1. 让 verify 先跑一遍，--write-fixture 生成种子（默认追加 --limit 3）
-opencli browser verify 1point3acres/hot --write-fixture
+ppcli browser verify 1point3acres/hot --write-fixture
 
-# 2. 手改 ~/.opencli/sites/1point3acres/verify/hot.json
+# 2. 手改 ~/.ppcli/sites/1point3acres/verify/hot.json
 #    - patterns: 加 URL / 日期 / ID 正则
 #    - notEmpty: 加核心字段（title / author / url）
 #    - rowCount: 收紧到业务合理区间
 
 # 3. 再跑 verify，fixture 吃得动就 OK
-opencli browser verify 1point3acres/hot
+ppcli browser verify 1point3acres/hot
 ```
 
 positional adapter 目前 `--write-fixture` 没法表达主语，**首份 fixture 要手写**：
 
 ```bash
 # 1. 先直跑 adapter 看输出长啥样
-opencli 1point3acres thread 1173710 --limit 2 --format json | head
+ppcli 1point3acres thread 1173710 --limit 2 --format json | head
 
-# 2. 照着响应手写 ~/.opencli/sites/1point3acres/verify/thread.json
+# 2. 照着响应手写 ~/.ppcli/sites/1point3acres/verify/thread.json
 #    （args 一定用数组: ["1173710", "--limit", "2"]）
 
 # 3. 跑 verify 核对
-opencli browser verify 1point3acres/thread
+ppcli browser verify 1point3acres/thread
 ```
 
 机器生成的种子只有 rowCount.min=1 / columns / types，挡不住字段值错位。**patterns + notEmpty 无论哪种情形都是肉写的**。
@@ -459,13 +459,13 @@ opencli browser verify 1point3acres/thread
 ## 私人 adapter vs repo 贡献
 
 ```
-~/.opencli/clis/<site>/<name>.js    # 私人
+~/.ppcli/clis/<site>/<name>.js    # 私人
 clis/<site>/<name>.js               # repo 贡献
 ```
 
 **两者在 `cli({...})` 层面完全一样**。差别只在运行入口：
 
-- 私人：写完立即可跑（`opencli <site> <name>`）
+- 私人：写完立即可跑（`ppcli <site> <name>`）
 - repo：要 `npm run build` 才被注册
 
-先在 `~/.opencli/clis/` 调通再拷贝到 `clis/`。
+先在 `~/.ppcli/clis/` 调通再拷贝到 `clis/`。

package/skills/opencli-adapter-author/references/api-discovery.md

@@ -12,7 +12,7 @@
 
 ### 0.1 反爬厂商 → 决定 fetch 能不能从 Node 走
 
-`opencli browser analyze <url>` 的 `anti_bot` 字段给答案；手查看 cookies 也行：
+`ppcli browser analyze <url>` 的 `anti_bot` 字段给答案；手查看 cookies 也行：
 
 | cookie / body 信号 | 厂商 | 裸 Node fetch / curl 结果 | 策略 |
 |------------------|------|-----|-----|
@@ -30,7 +30,7 @@
 判断：
 
 ```bash
-opencli browser eval "fetch('https://<target-subdomain>/api/...', {credentials:'include'}).then(r=>r.status).catch(e=>'cors:'+e.message)"
+ppcli browser eval "fetch('https://<target-subdomain>/api/...', {credentials:'include'}).then(r=>r.status).catch(e=>'cors:'+e.message)"
 ```
 
 - 返回 status 数字 → CORS 通，继续
@@ -39,7 +39,7 @@ opencli browser eval "fetch('https://<target-subdomain>/api/...', {credentials:'
 **挡住时**：不要把 `credentials:'include'` 当万能药——这只解决"带 cookie"，不解决"跨 origin"。降级路径：
 
 1. 换同 origin 的 endpoint（同一个 subdomain 下的 API 往往更宽松）
-2. 用 `opencli browser open https://<target-subdomain>/`，让页面在目标 subdomain 本身打开，再 fetch 相对路径
+2. 用 `ppcli browser open https://<target-subdomain>/`，让页面在目标 subdomain 本身打开，再 fetch 相对路径
 3. 真跨域且无替代 → 走 `§5 intercept`，从页面自身发的请求里抓响应
 
 ---
@@ -49,7 +49,7 @@ opencli browser eval "fetch('https://<target-subdomain>/api/...', {credentials:'
 ### 拿候选
 
 ```bash
-opencli browser network
+ppcli browser network
 ```
 
 默认输出是 JSON，每个候选都带：
@@ -59,7 +59,7 @@ opencli browser network
 
 静态资源 / 埋点 / 追踪默认已过滤。默认会保留 JSON / XML / plain text / `text/javascript` 这类 API 响应；如果你确定浏览器 DevTools 里有目标请求但这里缺失，用 `--all` 查一遍是否被 content-type 或 URL 噪音过滤挡掉。
 
-如果是冷启动，先看 `opencli browser analyze <url>` 里的 `api_candidates`：
+如果是冷启动，先看 `ppcli browser analyze <url>` 里的 `api_candidates`：
 
 - `verdict: "likely_data"`：优先 replay 这条，拿 status / content-type / sample shape 填 strategy note
 - `verdict: "maybe_data"`：可以试，但必须人工核对字段是否是目标业务数据
@@ -81,7 +81,7 @@ opencli browser network
 已经知道目标 body 该含哪些字段就直接让 CLI 把列表筛到只剩候选，不用自己 scroll 翻 shape：
 
 ```bash
-opencli browser network --filter author,text,likes
+ppcli browser network --filter author,text,likes
 ```
 
 - 字段以英文逗号分隔；AND 语义，必须每个字段都作为 shape 路径的**任意一段**出现才保留（`$.data.items[0].author` 命中 `author`、`items`、`data` 都算）
@@ -97,10 +97,10 @@ opencli browser network --filter author,text,likes
 候选定了再拉完整 body（by key，不是 index — 数组顺序会随每次 capture 变）：
 
 ```bash
-opencli browser network --detail <key>
+ppcli browser network --detail <key>
 ```
 
-capture 会持久化到 `~/.opencli/cache/browser-network/<session>.json`（默认 TTL 24h），所以 `--detail` 即使跨多条其他命令也还在。
+capture 会持久化到 `~/.ppcli/cache/browser-network/<session>.json`（默认 TTL 24h），所以 `--detail` 即使跨多条其他命令也还在。
 
 ### 关键 request headers
 
@@ -120,14 +120,14 @@ capture 会持久化到 `~/.opencli/cache/browser-network/<session>.json`（默
 
 ```bash
 # 滚到底（虚拟列表）
-opencli browser eval "window.scrollTo(0, document.body.scrollHeight)"
-opencli browser wait time 2
-opencli browser network
+ppcli browser eval "window.scrollTo(0, document.body.scrollHeight)"
+ppcli browser wait time 2
+ppcli browser network
 
 # 点某个按钮
-opencli browser click <N>
-opencli browser wait time 2
-opencli browser network
+ppcli browser click <N>
+ppcli browser wait time 2
+ppcli browser network
 ```
 
 ---
@@ -137,7 +137,7 @@ opencli browser network
 首屏数据常挂在这几个全局变量上：
 
 ```bash
-opencli browser eval "Object.keys(window).filter(k=>k.startsWith('__'))"
+ppcli browser eval "Object.keys(window).filter(k=>k.startsWith('__'))"
 ```
 
 命中的常见名：
@@ -153,7 +153,7 @@ opencli browser eval "Object.keys(window).filter(k=>k.startsWith('__'))"
 取数据：
 
 ```bash
-opencli browser eval "JSON.stringify(window.__NEXT_DATA__).slice(0, 3000)"
+ppcli browser eval "JSON.stringify(window.__NEXT_DATA__).slice(0, 3000)"
 ```
 
 **关键**：inline state 只覆盖首屏的一部分（通常是 SEO 相关字段）。分页 / 评论 / 懒加载还是得回 §1 抓 API。
@@ -167,7 +167,7 @@ opencli browser eval "JSON.stringify(window.__NEXT_DATA__).slice(0, 3000)"
 ### 扫 script src
 
 ```bash
-opencli browser eval "[...document.querySelectorAll('script[src]')].map(s=>s.src).filter(s=>!/\\.(css|png|jpg|svg|woff|mp4)$/.test(s)&&!/googletagmanager|crazyegg|sentry|doubleclick|amazon-adsystem|cloudflare/.test(s))"
+ppcli browser eval "[...document.querySelectorAll('script[src]')].map(s=>s.src).filter(s=>!/\\.(css|png|jpg|svg|woff|mp4)$/.test(s)&&!/googletagmanager|crazyegg|sentry|doubleclick|amazon-adsystem|cloudflare/.test(s))"
 ```
 
 看结果里的 hostname：
@@ -178,7 +178,7 @@ opencli browser eval "[...document.querySelectorAll('script[src]')].map(s=>s.src
 ### 搜 bundle 里的 baseURL
 
 ```bash
-opencli browser eval "(async()=>{const s=[...document.querySelectorAll('script[src]')].map(e=>e.src).find(s=>/main|app|index|bundle|chunk/.test(s));if(!s)return'no bundle';const t=await fetch(s).then(r=>r.text());const patterns=['baseURL','baseUrl','BASE_URL','apiHost','apiBase','API_HOST','API_BASE'];const hits=[];for(const p of patterns){let i=-1;while((i=t.indexOf(p,i+1))>-1&&hits.length<5)hits.push(t.slice(Math.max(0,i-5),i+80));}return hits})()"
+ppcli browser eval "(async()=>{const s=[...document.querySelectorAll('script[src]')].map(e=>e.src).find(s=>/main|app|index|bundle|chunk/.test(s));if(!s)return'no bundle';const t=await fetch(s).then(r=>r.text());const patterns=['baseURL','baseUrl','BASE_URL','apiHost','apiBase','API_HOST','API_BASE'];const hits=[];for(const p of patterns){let i=-1;while((i=t.indexOf(p,i+1))>-1&&hits.length<5)hits.push(t.slice(Math.max(0,i-5),i+80));}return hits})()"
 ```
 
 命中 `baseURL:"https://api.foo.com"` 直接拿 host 拼 endpoint。
@@ -188,7 +188,7 @@ opencli browser eval "(async()=>{const s=[...document.querySelectorAll('script[s
 像 eastmoney 这种经验 endpoint 可以直接喂：
 
 ```bash
-opencli browser eval "fetch('https://push2.eastmoney.com/api/qt/clist/get?fs=m:1+t:2&pn=1&pz=5&fltt=2&fid=f3&po=1&fields=f2,f3,f12,f14').then(r=>r.json())"
+ppcli browser eval "fetch('https://push2.eastmoney.com/api/qt/clist/get?fs=m:1+t:2&pn=1&pz=5&fltt=2&fid=f3&po=1&fields=f2,f3,f12,f14').then(r=>r.json())"
 ```
 
 200 且数据对得上就认。
@@ -202,7 +202,7 @@ opencli browser eval "fetch('https://push2.eastmoney.com/api/qt/clist/get?fs=m:1
 
 ```bash
 # 当前页加 .json 试
-opencli browser eval "fetch(location.pathname.replace(/\\/$/,'')+'.json').then(r=>r.ok?r.json():'no')"
+ppcli browser eval "fetch(location.pathname.replace(/\\/$/,'')+'.json').then(r=>r.ok?r.json():'no')"
 ```
 
 ---
@@ -214,7 +214,7 @@ opencli browser eval "fetch(location.pathname.replace(/\\/$/,'')+'.json').then(r
 ### Cookie 里
 
 ```bash
-opencli browser eval "document.cookie.split('; ').reduce((o,x)=>{const[k,v]=x.split('=');o[k]=v;return o},{})"
+ppcli browser eval "document.cookie.split('; ').reduce((o,x)=>{const[k,v]=x.split('=');o[k]=v;return o},{})"
 ```
 
 常见 token cookie 名：`ct0`（Twitter CSRF）、`xq_a_token`（雪球）、`SESSDATA`（B 站）、`_csrf / csrfToken`（通用）。
@@ -226,7 +226,7 @@ opencli browser eval "document.cookie.split('; ').reduce((o,x)=>{const[k,v]=x.sp
 ### localStorage / sessionStorage 里
 
 ```bash
-opencli browser eval "Object.keys(localStorage).map(k=>k+' => '+localStorage.getItem(k).slice(0,50))"
+ppcli browser eval "Object.keys(localStorage).map(k=>k+' => '+localStorage.getItem(k).slice(0,50))"
 ```
 
 找 `token / auth / jwt / bearer` 关键字。
@@ -236,7 +236,7 @@ opencli browser eval "Object.keys(localStorage).map(k=>k+' => '+localStorage.get
 有些站的 Bearer 是全站一个常量（Twitter 的匿名 Bearer）。在 bundle 里搜：
 
 ```bash
-opencli browser eval "(async()=>{const s=[...document.querySelectorAll('script[src]')].map(e=>e.src).find(s=>/main|app|bundle/.test(s));const t=await fetch(s).then(r=>r.text());const m=t.match(/Bearer\\s+[\\w-]{20,}/g);return m?.slice(0,3)||'not found'})()"
+ppcli browser eval "(async()=>{const s=[...document.querySelectorAll('script[src]')].map(e=>e.src).find(s=>/main|app|bundle/.test(s));const t=await fetch(s).then(r=>r.text());const m=t.match(/Bearer\\s+[\\w-]{20,}/g);return m?.slice(0,3)||'not found'})()"
 ```
 
 ### Store action 绕签名
@@ -245,10 +245,10 @@ Vue + Pinia / Redux / React Context 有时直接调 store method 能绕过签名
 
 ```bash
 # Pinia
-opencli browser eval "typeof __pinia !== 'undefined' ? Object.keys(__pinia.state.value) : 'no pinia'"
+ppcli browser eval "typeof __pinia !== 'undefined' ? Object.keys(__pinia.state.value) : 'no pinia'"
 
 # 直接调 store action（每个站点具体 action 名要查）
-opencli browser eval "window.__pinia.state.value.someStore.someMethod({...})"
+ppcli browser eval "window.__pinia.state.value.someStore.someMethod({...})"
 ```
 
 ---