@zenalexa/unicli 0.215.0 → 0.216.0

package/README.zh-CN.md

@@ -1,340 +1,310 @@
-<!-- AGENT: npm install -g @zenalexa/unicli && unicli search "你的意图" — 220 个站点，1283 条命令，自修复 YAML 适配器，BM25 中英双语搜索，比 MCP 少 95–99% token。默认 Markdown envelope；JSON 用 -f json。实时统计见 AGENTS.md。 -->
-
-<div align="center">
+<p align="center">
+  <img src="assets/mascot-otter.png" alt="Uni-CLI 水獭 mascot" width="180">
+</p>
 
-<img src="assets/icon.svg" width="180" alt="Uni-CLI">
+<h1 align="center">Uni-CLI</h1>
 
-# Uni-CLI
+<p align="center">
+  <strong>给 Agent 用的一层统一 CLI：网站、桌面 App、本地工具、外部 CLI，都变成可搜索、可执行、可修复的命令。</strong>
+</p>
 
-> 给你的 Agent 一双手。
+<p align="center">
+  <a href="https://olo-dot-io.github.io/Uni-CLI/">文档站</a>
+  ·
+  <a href="https://olo-dot-io.github.io/Uni-CLI/reference/sites">站点目录</a>
+  ·
+  <a href="https://olo-dot-io.github.io/Uni-CLI/llms.txt">llms.txt</a>
+</p>
 
-<!-- STATS:site_count -->220<!-- /STATS --> 个站点 &nbsp;·&nbsp; <!-- STATS:command_count -->1283<!-- /STATS --> 条命令 &nbsp;·&nbsp; 自修复 YAML &nbsp;·&nbsp; 比 MCP 少 95–99% token
+<p align="center">
+  先按意图搜索，再执行真实命令，最后拿结构化结果。网站变了也不会假装成功，错误会告诉你哪个 adapter、哪一步、怎么修。
+</p>
 
-<br>
+<p align="center">
+  <a href="https://www.npmjs.com/package/@zenalexa/unicli"><img alt="npm" src="https://img.shields.io/npm/v/@zenalexa/unicli?style=flat-square"></a>
+  <a href="./LICENSE"><img alt="license" src="https://img.shields.io/badge/license-Apache--2.0-blue?style=flat-square"></a>
+  <img alt="Node 20+" src="https://img.shields.io/badge/node-20%2B-339933?style=flat-square&logo=node.js&logoColor=white">
+  <img alt="MCP" src="https://img.shields.io/badge/MCP-2025--11--25-6f42c1?style=flat-square">
+</p>
 
-<a href="https://www.npmjs.com/package/@zenalexa/unicli"><img src="https://img.shields.io/npm/v/@zenalexa/unicli?style=flat-square&color=cb3837" alt="npm"></a>
-<a href="https://github.com/olo-dot-io/Uni-CLI/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/olo-dot-io/Uni-CLI/ci.yml?style=flat-square&label=CI" alt="CI"></a>
-<a href="https://github.com/olo-dot-io/Uni-CLI/stargazers"><img src="https://img.shields.io/github/stars/olo-dot-io/Uni-CLI?style=flat-square" alt="stars"></a>
-<a href="./LICENSE"><img src="https://img.shields.io/github/license/olo-dot-io/Uni-CLI?style=flat-square" alt="license"></a>
-<img src="https://img.shields.io/badge/tests-<!-- STATS:test_count -->7145<!-- /STATS -->-44cc11?style=flat-square" alt="tests">
-<img src="https://img.shields.io/badge/agent--reach-ally-6a5acd?style=flat-square" alt="agent-reach ally">
+<p align="center">
+  <sub><!-- STATS:site_count -->235<!-- /STATS --> 个站点 · <!-- STATS:command_count -->1448<!-- /STATS --> 条命令 · <!-- STATS:pipeline_step_count -->59<!-- /STATS --> 个 pipeline step · <!-- STATS:test_count -->7394<!-- /STATS --> 个测试</sub>
+</p>
 
-<br>
+<p align="center">
+  <strong>Web / Social / Knowledge</strong><br>
+  <img src="https://img.shields.io/badge/X-000000?style=flat-square&logo=x&logoColor=white" alt="X">
+  <img src="https://img.shields.io/badge/Reddit-FF4500?style=flat-square&logo=reddit&logoColor=white" alt="Reddit">
+  <img src="https://img.shields.io/badge/Instagram-E4405F?style=flat-square&logo=instagram&logoColor=white" alt="Instagram">
+  <img src="https://img.shields.io/badge/TikTok-000000?style=flat-square&logo=tiktok&logoColor=white" alt="TikTok">
+  <img src="https://img.shields.io/badge/YouTube-FF0000?style=flat-square&logo=youtube&logoColor=white" alt="YouTube">
+  <img src="https://img.shields.io/badge/Bilibili-00A1D6?style=flat-square&logo=bilibili&logoColor=white" alt="Bilibili">
+  <img src="https://img.shields.io/badge/Zhihu-0084FF?style=flat-square&logo=zhihu&logoColor=white" alt="Zhihu">
+  <img src="https://img.shields.io/badge/Weibo-E6162D?style=flat-square&logo=sinaweibo&logoColor=white" alt="Weibo">
+  <img src="https://img.shields.io/badge/Xiaohongshu-FF2442?style=flat-square&logoColor=white" alt="Xiaohongshu">
+  <img src="https://img.shields.io/badge/Douyin-000000?style=flat-square&logo=tiktok&logoColor=white" alt="Douyin">
+  <img src="https://img.shields.io/badge/Hacker%20News-FF6600?style=flat-square&logo=ycombinator&logoColor=white" alt="Hacker News">
+  <img src="https://img.shields.io/badge/GitHub-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub">
+  <img src="https://img.shields.io/badge/Stack%20Overflow-F58025?style=flat-square&logo=stackoverflow&logoColor=white" alt="Stack Overflow">
+  <img src="https://img.shields.io/badge/Product%20Hunt-DA552F?style=flat-square&logo=producthunt&logoColor=white" alt="Product Hunt">
+  <img src="https://img.shields.io/badge/npm-CB3837?style=flat-square&logo=npm&logoColor=white" alt="npm">
+  <img src="https://img.shields.io/badge/PyPI-3775A9?style=flat-square&logo=pypi&logoColor=white" alt="PyPI">
+  <img src="https://img.shields.io/badge/Wikipedia-000000?style=flat-square&logo=wikipedia&logoColor=white" alt="Wikipedia">
+  <img src="https://img.shields.io/badge/Spotify-1DB954?style=flat-square&logo=spotify&logoColor=white" alt="Spotify">
+  <img src="https://img.shields.io/badge/IMDb-F5C518?style=flat-square&logo=imdb&logoColor=black" alt="IMDb">
+  <img src="https://img.shields.io/badge/Bloomberg-000000?style=flat-square&logoColor=white" alt="Bloomberg">
+  <img src="https://img.shields.io/badge/Reuters-FF8000?style=flat-square&logo=reuters&logoColor=white" alt="Reuters">
+  <img src="https://img.shields.io/badge/BBC-B80000?style=flat-square&logo=bbc&logoColor=white" alt="BBC">
+  <img src="https://img.shields.io/badge/Binance-F0B90B?style=flat-square&logo=binance&logoColor=black" alt="Binance">
+  <img src="https://img.shields.io/badge/Coinbase-0052FF?style=flat-square&logo=coinbase&logoColor=white" alt="Coinbase">
+  <img src="https://img.shields.io/badge/Yahoo%20Finance-6001D2?style=flat-square&logo=yahoo&logoColor=white" alt="Yahoo Finance">
+</p>
 
-[English](README.md)
+<p align="center">
+  <strong>Agent / IDE / Coding Surfaces</strong><br>
+  <img src="https://img.shields.io/badge/Claude%20Code-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude Code">
+  <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
+  <img src="https://img.shields.io/badge/OpenCode-101010?style=flat-square&logoColor=white" alt="OpenCode">
+  <img src="https://img.shields.io/badge/Cursor-000000?style=flat-square&logoColor=white" alt="Cursor">
+  <img src="https://img.shields.io/badge/Kiro-FF9900?style=flat-square&logo=amazon&logoColor=black" alt="Kiro">
+  <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
+  <img src="https://img.shields.io/badge/Qwen-1E88E5?style=flat-square&logoColor=white" alt="Qwen">
+  <img src="https://img.shields.io/badge/Kimi-6C5CE7?style=flat-square&logoColor=white" alt="Kimi">
+  <img src="https://img.shields.io/badge/MiniMax-00A6FB?style=flat-square&logoColor=white" alt="MiniMax">
+  <img src="https://img.shields.io/badge/Cline-6E56CF?style=flat-square&logoColor=white" alt="Cline">
+  <img src="https://img.shields.io/badge/Roo%20Code-2E7D32?style=flat-square&logoColor=white" alt="Roo Code">
+  <img src="https://img.shields.io/badge/Windsurf-00C2FF?style=flat-square&logoColor=white" alt="Windsurf">
+  <img src="https://img.shields.io/badge/Aider-6F42C1?style=flat-square&logo=python&logoColor=white" alt="Aider">
+  <img src="https://img.shields.io/badge/Goose-111827?style=flat-square&logoColor=white" alt="Goose">
+  <img src="https://img.shields.io/badge/OpenHands-FF6B00?style=flat-square&logoColor=white" alt="OpenHands">
+  <img src="https://img.shields.io/badge/SWE--agent-0F172A?style=flat-square&logoColor=white" alt="SWE-agent">
+  <img src="https://img.shields.io/badge/GitHub%20Copilot-181717?style=flat-square&logo=githubcopilot&logoColor=white" alt="GitHub Copilot">
+  <img src="https://img.shields.io/badge/AgentAPI-334155?style=flat-square&logoColor=white" alt="AgentAPI">
+  <img src="https://img.shields.io/badge/acpx-475569?style=flat-square&logoColor=white" alt="acpx">
+</p>
 
-<br>
+<p align="center">
+  <strong>Desktop / Media / DevOps / Cloud</strong><br>
+  <img src="https://img.shields.io/badge/macOS-000000?style=flat-square&logo=apple&logoColor=white" alt="macOS">
+  <img src="https://img.shields.io/badge/Chrome-4285F4?style=flat-square&logo=googlechrome&logoColor=white" alt="Chrome">
+  <img src="https://img.shields.io/badge/Blender-F5792A?style=flat-square&logo=blender&logoColor=white" alt="Blender">
+  <img src="https://img.shields.io/badge/FFmpeg-007808?style=flat-square&logo=ffmpeg&logoColor=white" alt="FFmpeg">
+  <img src="https://img.shields.io/badge/ImageMagick-0074C1?style=flat-square&logoColor=white" alt="ImageMagick">
+  <img src="https://img.shields.io/badge/GIMP-5C5543?style=flat-square&logo=gimp&logoColor=white" alt="GIMP">
+  <img src="https://img.shields.io/badge/FreeCAD-729FCF?style=flat-square&logo=freecad&logoColor=white" alt="FreeCAD">
+  <img src="https://img.shields.io/badge/Audacity-0000CC?style=flat-square&logo=audacity&logoColor=white" alt="Audacity">
+  <img src="https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white" alt="Docker">
+  <img src="https://img.shields.io/badge/GitHub%20CLI-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub CLI">
+  <img src="https://img.shields.io/badge/jq-C7254E?style=flat-square&logo=json&logoColor=white" alt="jq">
+  <img src="https://img.shields.io/badge/yt--dlp-4A5568?style=flat-square&logo=youtube&logoColor=white" alt="yt-dlp">
+  <img src="https://img.shields.io/badge/AWS-232F3E?style=flat-square&logo=amazonaws&logoColor=white" alt="AWS">
+  <img src="https://img.shields.io/badge/Vercel-000000?style=flat-square&logo=vercel&logoColor=white" alt="Vercel">
+  <img src="https://img.shields.io/badge/Supabase-3ECF8E?style=flat-square&logo=supabase&logoColor=black" alt="Supabase">
+  <img src="https://img.shields.io/badge/Cloudflare-F38020?style=flat-square&logo=cloudflare&logoColor=white" alt="Cloudflare">
+  <img src="https://img.shields.io/badge/Stripe-635BFF?style=flat-square&logo=stripe&logoColor=white" alt="Stripe">
+  <img src="https://img.shields.io/badge/Firebase-FFCA28?style=flat-square&logo=firebase&logoColor=black" alt="Firebase">
+  <img src="https://img.shields.io/badge/Netlify-00C7B7?style=flat-square&logo=netlify&logoColor=white" alt="Netlify">
+  <img src="https://img.shields.io/badge/Railway-0B0D0E?style=flat-square&logo=railway&logoColor=white" alt="Railway">
+  <img src="https://img.shields.io/badge/Azure-0078D4?style=flat-square&logo=microsoftazure&logoColor=white" alt="Azure">
+  <img src="https://img.shields.io/badge/Google%20Cloud-4285F4?style=flat-square&logo=googlecloud&logoColor=white" alt="Google Cloud">
+  <img src="https://img.shields.io/badge/Slack-4A154B?style=flat-square&logo=slack&logoColor=white" alt="Slack">
+  <img src="https://img.shields.io/badge/Notion-000000?style=flat-square&logo=notion&logoColor=white" alt="Notion">
+  <img src="https://img.shields.io/badge/Linear-5E6AD2?style=flat-square&logo=linear&logoColor=white" alt="Linear">
+  <img src="https://img.shields.io/badge/Figma-F24E1E?style=flat-square&logo=figma&logoColor=white" alt="Figma">
+</p>
 
-```sh
+```bash
 npm install -g @zenalexa/unicli
+unicli search "微博热搜"
+unicli hackernews top -f json
 ```
 
-<br>
+<!-- IF YOU ARE AN AI AGENT: Start here.
+Install: npm install -g @zenalexa/unicli
+Discover: unicli search "your intent"
+Run: unicli <site> <command> [args] [-f json|md|yaml|csv|compact]
+Repair: read the error envelope, edit the adapter_path, run unicli repair <site> <command>
+Prefer native CLI / JSON stream / MCP for agent runtimes. Use ACP as an editor compatibility gateway.
+-->
 
-<img src="docs/demo/demo.svg" alt="Uni-CLI 30 秒演示" width="720">
+## 它解决什么
 
-</div>
+Uni-CLI 把软件表面封装成 Agent 能发现、能执行、能修的命令。
 
----
+| 表面         | 能力                                                                            |
+| ------------ | ------------------------------------------------------------------------------- |
+| 网站和 API   | public、cookie、header、browser-intercept 等 adapter                            |
+| 浏览器自动化 | CDP 的 navigate、click、type、intercept、snapshot、extract、wait 等步骤         |
+| 桌面和 macOS | 系统命令、App adapter、截图、剪贴板、日历、亮度、本地工具                       |
+| 外部 CLI     | 58 个已登记的 passthrough bridge，支持安装和状态发现                            |
+| Agent 后端   | native CLI、JSON stream、MCP、ACP、HTTP API、OpenAI-compatible、bridge 路由矩阵 |
+| 输出         | v2 `AgentEnvelope`，支持 Markdown、JSON、YAML、CSV、compact                     |
+| 修复         | 错误里带 `adapter_path`、失败 `step`、是否可重试、修复建议和替代命令            |
 
-## 🤖 让 Agent 帮你配置
+## 给 Agent 的入口
 
-把下面这段扔给你的 agent，然后去倒杯水：
+先搜索，再执行最小可用命令。
 
+```bash
+unicli search "推特热门" --limit 5
+unicli twitter search "coding agents" -f json
+unicli repair twitter search
 ```
-帮我配置 unicli——它能给 AI Agent 提供 220 个站点的 CLI 访问权限，支持自修复适配器：
-  1. npm install -g @zenalexa/unicli
-  2. 添加 MCP：claude mcp add unicli -- npx @zenalexa/unicli mcp serve
-  3. 验证：unicli hackernews top -f json
-```
-
-Agent 自己会搞定。回来的时候，220 个站点都在 CLI 里等着你了。
 
-**各平台一行配置：**
+非 TTY 和 Agent 环境默认输出结构化 Markdown。需要机器格式时显式指定：
 
-| 平台                         | 配置方式                                                                                             |
-| ---------------------------- | ---------------------------------------------------------------------------------------------------- |
-| **Claude Code**              | `claude mcp add unicli -- npx @zenalexa/unicli mcp serve`                                            |
-| **Codex CLI**                | 在 `~/.codex/config.toml` 添加 `[mcp_servers.unicli]` · `command = "npx @zenalexa/unicli mcp serve"` |
-| **Cursor / Windsurf**        | MCP 设置 → 添加服务器 → `npx @zenalexa/unicli mcp serve`                                             |
-| **avante.nvim / Zed**        | `unicli acp` — JSON-RPC 2.0（ACP 协议）                                                              |
-| **OpenCode**                 | 在 `opencode.jsonc` 中添加 `"command": "unicli mcp serve"`                                           |
-| **任何有 Bash 权限的 Agent** | 直接运行 `unicli <站点> <命令>` — 零配置                                                             |
-
----
-
-## 是什么
+```bash
+UNICLI_OUTPUT=json unicli reddit hot --limit 10
+unicli hackernews top --limit 5 -f yaml
+```
 
-Uni-CLI 是专为 AI Agent 设计的通用命令行界面——单个二进制文件，将 Agent 意图编译为可确定性执行的程序，覆盖 <!-- STATS:site_count -->220<!-- /STATS --> 个站点、30+ 桌面应用、35 个 CLI 桥接和本地操作系统（共 <!-- STATS:command_count -->1283<!-- /STATS --> 条命令）。每个适配器约 20 行 YAML：Agent 可读、可编辑、零构建步骤。站点修改 API 时，Agent 编辑 YAML，保存到 `~/.unicli/adapters/`，重试即可。修复永久生效，`npm update` 也不会覆盖。全程无需人工介入。
+协议入口：
 
-覆盖范围贯穿各个层面：HTTP Web API、CDP 浏览器自动化、桌面子进程（ffmpeg、Blender、LibreOffice）、macOS 系统调用（截屏、日历、剪贴板）、macOS AX，以及可插拔 CUA 合同。Windows UIA、Linux AT-SPI 和第三方 CUA provider 当前是显式声明的能力边界/接口桩，不按已完成实执行能力宣传；全部通过统一的 `unicli <站点> <命令>` 接口访问。
+```bash
+npx @zenalexa/unicli mcp serve
+npx @zenalexa/unicli mcp serve --transport streamable --port 19826
+unicli acp
+unicli agents recommend codex
+unicli agents matrix
+```
 
-## 为什么 CLI 比 MCP 强
+ACP 作为编辑器和桥接兼容层保留。真正跑任务时，优先 native CLI、JSON stream 或 MCP。
 
-一个 93 工具的 MCP 服务器在 Agent 能行动之前要加载约 55,000 个 token。Firecrawl、Scalekit、Apideck 的独立基准测试均报告，Agent 通过 CLI 层按需拉取命令比加载完整 MCP 目录减少 95–99% 的上下文开销。2025–2026 年的学术研究（Semantic Tool Discovery、ITR Dynamic Tool Exposure、JSPLIT）得出了相同结论。
+## 覆盖范围
 
-| 接口                          | 冷启动开销     | 单次命令成本                                | 自修复 |
-| ----------------------------- | -------------- | ------------------------------------------- | ------ |
-| 典型 MCP 服务器（93 工具）    | ~55,000 token  | ~500–2,000 token                            | 否     |
-| **Uni-CLI MCP**（4 个元工具） | **~200 token** | 见 [`docs/BENCHMARK.md`](docs/BENCHMARK.md) | **是** |
-| **Uni-CLI via Bash**          | **0 token**    | 见 [`docs/BENCHMARK.md`](docs/BENCHMARK.md) | **是** |
+数量不是重点，重点是每条命令都能搜索、可声明、可验证、可修。
 
-Uni-CLI 的 MCP 服务器只暴露四个元工具（`unicli_run`、`unicli_list`、`unicli_search`、`unicli_explore`），Agent 通过 BM25 中英双语搜索在 50KB 索引中按需拉取精确命令。诚实的单次调用数据（p50/p95，实测非估算）：[`docs/BENCHMARK.md`](docs/BENCHMARK.md)。
+| 领域          | 例子                                                                                                        |
+| ------------- | ----------------------------------------------------------------------------------------------------------- |
+| 中文平台      | xiaohongshu、zhihu、bilibili、douyin、douban、v2ex、jike、linux-do                                          |
+| 国际平台      | twitter、reddit、instagram、tiktok、discord、slack、hackernews、lesswrong                                   |
+| AI 和开发工具 | Claude、ChatGPT、Gemini、Codex、Cursor、VS Code、Docker Desktop、Postman                                    |
+| 财经和新闻    | xueqiu、eastmoney、yahoo-finance、bloomberg、reuters、bbc、36kr                                             |
+| 桌面 App      | Blender、FreeCAD、GIMP、Audacity、Figma、Docker、ImageMagick、ffmpeg                                        |
+| Agent CLI     | Claude Code、Codex、OpenCode、Gemini CLI、Qwen Code、Aider、Goose、Cursor Agent、Kiro、OpenHands、SWE-agent |
 
-## 快速开始
+看实时目录：
 
 ```bash
-# 安装
-npm install -g @zenalexa/unicli
-
-# 发现命令（中英双语）
-unicli list                          # 所有站点 + 命令
-unicli search "微博热搜"              # → weibo trending
-unicli search "B站热门"              # → bilibili popular
-unicli search "download video"       # → bilibili download, yt-dlp
-
-# 运行
-unicli weibo trending --limit 10     # 微博热搜，零配置
-unicli zhihu hot -f json             # 知乎热榜，JSON envelope
-unicli bilibili popular --limit 5    # B 站热门视频
-unicli hackernews top -f json | jq '.data[].title'  # 管道 + 变换
-
-# 接入 Agent
-claude mcp add unicli -- npx @zenalexa/unicli mcp serve   # Claude Code
-unicli mcp serve --transport streamable --port 19826      # 任意 MCP 客户端
-unicli acp                                                # avante.nvim / Zed
+unicli list
+unicli list --site macos
+unicli ext list
+unicli ext list --tag agent
 ```
 
-完整指南（含 5 个实例）：[`docs/QUICKSTART.md`](docs/QUICKSTART.md)。
+同一份生成目录也发布在文档站：
+<https://olo-dot-io.github.io/Uni-CLI/reference/sites>
 
-## 自修复
+## 输出契约
 
-自修复是 Uni-CLI 作为基础设施而非普通工具的核心能力。当站点修改 API：
+普通命令都返回 v2 envelope。`mcp serve` 和 `acp` 是协议服务器，保留各自原始 stdio 协议。
 
-```
-unicli <站点> <命令> 失败
-  → stderr: { "adapter_path": "~/.unicli/adapters/weibo/trending.yaml",
-               "step": "fetch", "action": "GET /api/v4/search/top",
-               "suggestion": "endpoint 可能已版本化为 /api/v4/search/trending" }
-  → Agent 打开 adapter_path 处的 ~20 行 YAML
-  → Agent 修改选择器 / 端点 / 认证头
-  → unicli <站点> <命令> 成功
-  → 修复保存到 ~/.unicli/adapters/ — 永久生效，npm update 不覆盖
+```yaml
+ok: true
+schema_version: "2"
+command: "twitter.search"
+meta:
+  duration_ms: 412
+  count: 20
+  surface: web
+data:
+  - { id: "...", text: "...", author: "..." }
+error: null
 ```
 
-这是 Banach 收敛设计：每条错误消息都提供方向性反馈（`adapter_path` + `step` + `suggestion`），使连续修复迭代收敛到可用状态。Agent 积累的修复不会被重置。
+错误也要可执行：
 
-```bash
-unicli repair weibo trending    # 诊断 + 建议修复方案
-unicli test weibo               # 验证站点所有适配器
-unicli repair --loop            # 自主修复循环（Agent 驱动）
+```yaml
+ok: false
+schema_version: "2"
+command: "twitter.search"
+meta:
+  duration_ms: 91
+data: null
+error:
+  code: auth_required
+  message: "401 Unauthorized"
+  adapter_path: "src/adapters/twitter/search.yaml"
+  step: 1
+  suggestion: "Run: unicli auth setup twitter"
+  retryable: false
+  alternatives: ["twitter.timeline", "twitter.profile"]
 ```
 
-退出码遵循 `sysexits.h`：`0` 成功 · `66` 空结果 · `69` 不可用 · `75` 临时错误 · `77` 认证 · `78` 配置。
-
-## 架构
-
-七个传输层，一个适配器接口，一个输出格式化器。
-
-| 传输层             | 覆盖范围                                                          |
-| ------------------ | ----------------------------------------------------------------- |
-| **HTTP**           | Web API — REST、RSS、JSON、GraphQL                                |
-| **CDP 浏览器**     | 通过真实 Chrome 会话访问任意站点（13 层反检测隐身，复用登录状态） |
-| **子进程**         | ffmpeg、yt-dlp、gh、aws、docker、stripe 等 30+ 工具               |
-| **Desktop-AX**     | macOS — AppleScript、Accessibility API、快捷指令、日历、邮件      |
-| **Desktop-UIA**    | Windows — 声明式接口桩，尚不按实执行能力宣传                      |
-| **Desktop-AT-SPI** | Linux — 声明式接口桩，尚不按实执行能力宣传                        |
-| **CUA**            | screenshot/action 合同、mock 后端、provider 接口桩                |
-
-适配器默认使用声明式 YAML（Rice 可判定性——无图灵完备逻辑，可证明终止）。流水线有 <!-- STATS:pipeline_step_count -->59<!-- /STATS -->+ 个步骤：`fetch`、`navigate`、`exec`、`extract`、`each`、`if`、`parallel`、`rate_limit`、`retry` 等。完整文档：[`docs/ADAPTER-FORMAT.md`](docs/ADAPTER-FORMAT.md)。
-
-## 功能矩阵
-
-| 能力               | 详情                                                                                   |
-| ------------------ | -------------------------------------------------------------------------------------- |
-| **CUA 合同**       | 稳定 screenshot/action 接口、mock 后端和显式 provider 桩；尚不按真实 computer-use 宣传 |
-| **MCP 传输**       | stdio · Streamable HTTP（规范 2025-11-25）· SSE · OAuth 2.1 PKCE                       |
-| **ACP**            | `unicli acp` — JSON-RPC 2.0，支持 avante.nvim、Zed、Gemini CLI                         |
-| **跨厂商 Skills**  | Claude Code · OpenCode · Codex CLI · Cursor · Windsurf · Cline                         |
-| **自修复**         | 每条 stderr 错误携带 `adapter_path` + `step` + `suggestion`（Banach 收敛）             |
-| **中英双语搜索**   | BM25 + TF-IDF · 50KB 索引 · <10ms · 200 条 ZH↔EN 别名表                                |
-| **浏览器守护进程** | 持久化 Chrome（CDP）· 复用登录状态 · 13 层反检测隐身                                   |
-| **输出格式**       | 终端表格 · JSON（管道自动切换）· YAML · CSV · Markdown                                 |
-| **认证策略**       | public · cookie · CSRF header · browser intercept · UI 自动化 — 自动级联探测           |
-
-## 平台覆盖
-
-<!-- STATS:site_count -->220<!-- /STATS --> 个站点 · <!-- STATS:command_count -->1283<!-- /STATS --> 条命令 — 完整实时列表见 [`AGENTS.md`](AGENTS.md)：
-
-| 领域                | 代表站点                                                             |
-| ------------------- | -------------------------------------------------------------------- |
-| **社交媒体 (25)**   | 微博 · 知乎 · 哔哩哔哩 · 小红书 · 推特 · Reddit · Instagram · TikTok |
-| **科技社区 (19)**   | Hacker News · Stack Overflow · GitHub Trending · npm · PyPI          |
-| **资讯新闻 (11)**   | BBC · Reuters · Bloomberg · 36kr · 纽约时报 · TechCrunch             |
-| **金融财经 (8)**    | 雪球 · 东方财富 · Yahoo Finance · 币安 · Coinbase                    |
-| **AI / ML (14)**    | HuggingFace · 魔搭 · Ollama · Replicate · DeepSeek · 豆包            |
-| **桌面软件 (30+)**  | Blender · ffmpeg · ImageMagick · GIMP · FreeCAD · LibreOffice        |
-| **macOS 系统 (58)** | 截屏 · 剪贴板 · 日历 · 邮件 · 提醒事项 · 快捷指令 · Safari           |
-| **CLI 桥接 (35)**   | gh · yt-dlp · jq · aws · vercel · supabase · wrangler · stripe       |
-
-<p align="center">
-<img src="https://img.shields.io/badge/微博-E6162D?style=flat-square&logo=sinaweibo&logoColor=white" alt="微博">
-<img src="https://img.shields.io/badge/知乎-0084FF?style=flat-square&logo=zhihu&logoColor=white" alt="知乎">
-<img src="https://img.shields.io/badge/Bilibili-00A1D6?style=flat-square&logo=bilibili&logoColor=white" alt="哔哩哔哩">
-<img src="https://img.shields.io/badge/Twitter%2FX-000000?style=flat-square&logo=x&logoColor=white" alt="Twitter/X">
-<img src="https://img.shields.io/badge/Reddit-FF4500?style=flat-square&logo=reddit&logoColor=white" alt="Reddit">
-<img src="https://img.shields.io/badge/HackerNews-FF6600?style=flat-square&logo=ycombinator&logoColor=white" alt="HackerNews">
-<img src="https://img.shields.io/badge/GitHub-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub">
-<img src="https://img.shields.io/badge/npm-CB3837?style=flat-square&logo=npm&logoColor=white" alt="npm">
-<img src="https://img.shields.io/badge/Binance-F0B90B?style=flat-square&logo=binance&logoColor=black" alt="Binance">
-<img src="https://img.shields.io/badge/HuggingFace-FFD21F?style=flat-square&logo=huggingface&logoColor=black" alt="HuggingFace">
-<img src="https://img.shields.io/badge/Blender-F5792A?style=flat-square&logo=blender&logoColor=white" alt="Blender">
-<img src="https://img.shields.io/badge/ffmpeg-007808?style=flat-square&logo=ffmpeg&logoColor=white" alt="ffmpeg">
-<img src="https://img.shields.io/badge/AWS-232F3E?style=flat-square&logo=amazonaws&logoColor=white" alt="AWS">
-<img src="https://img.shields.io/badge/Vercel-000000?style=flat-square&logo=vercel&logoColor=white" alt="Vercel">
-<img src="https://img.shields.io/badge/Stripe-635BFF?style=flat-square&logo=stripe&logoColor=white" alt="Stripe">
-</p>
-
-`unicli list` 查看完整列表 · `unicli list --category=<领域>` 按类别筛选。
+退出码：`0` 成功，`66` 空结果，`69` 服务不可用，`75` 临时失败，`77` 需要认证，`78` 配置错误。
 
-## 认证
-
-五种策略，自动级联探测（`public → cookie → header → intercept → ui`）：
+## 自修复
 
-| 策略        | 方式                                       |
-| ----------- | ------------------------------------------ |
-| `public`    | 直接 HTTP，无需凭证                        |
-| `cookie`    | `~/.unicli/cookies/<站点>.json` 注入请求头 |
-| `header`    | Cookie + 自动提取 CSRF（ct0、bili_jct 等） |
-| `intercept` | Chrome 导航，Uni-CLI 捕获 XHR/fetch 响应   |
-| `ui`        | 通过 CDP 直接操作 DOM（点击、输入、提交）  |
+adapter 默认是很小的 YAML。命令失败时，Agent 不需要猜，可以直接按错误定位到文件和步骤。
 
-```bash
-unicli auth setup weibo     # 打印所需 cookie 和保存路径
-unicli auth check weibo     # 验证 cookie 文件
-unicli auth list            # 所有已配置站点
+```text
+1. 执行命令。
+2. 读取错误 envelope。
+3. 打开 error.adapter_path。
+4. 修改失败 step。
+5. 保存到 ~/.unicli/adapters/<site>/<command>.yaml。
+6. 用 unicli repair <site> <command> 验证。
 ```
 
-浏览器守护进程（`unicli browser start`）通过 CDP 复用已登录的 Chrome 会话——无需导出 cookie，无需安装扩展。4 小时无操作后自动退出。
-
-## 写一个适配器
+本地修复会在 npm 更新后继续保留。
 
-约 20 行 YAML，零 TypeScript，零构建步骤，Agent 可直接读写：
+## 写一个 adapter
 
 ```yaml
-site: hackernews
-name: top
-type: web-api
+site: example
+name: search
+description: "Search example.com"
+transport: http
 strategy: public
+capabilities: [fetch, select, map, limit]
+minimum_capability: http.fetch
+trust: public
+confidentiality: public
+quarantine: false
 pipeline:
   - fetch:
-      url: "https://hacker-news.firebaseio.com/v0/topstories.json"
-  - limit: { count: "${{ args.limit | default(30) }}" }
-  - each:
-      do:
-        - fetch:
-            url: "https://hacker-news.firebaseio.com/v0/item/${{ item }}.json"
+      url: "https://api.example.com/search?q=${{ args.query }}"
+  - select: data.results
   - map:
       title: "${{ item.title }}"
-      score: "${{ item.score }}"
       url: "${{ item.url }}"
-columns: [title, score, url]
-```
-
-五种适配器类型：`web-api` · `desktop` · `browser` · `bridge` · `service`。29 个模板过滤器在沙箱 VM 中运行。
-
-```bash
-unicli init <站点> <命令>    # 生成脚手架
-unicli dev <路径>            # 热重载开发
-unicli test <站点>           # 验证适配器
-unicli record <URL>          # 从网络流量自动生成适配器
-```
-
-完整文档：[`docs/ADAPTER-FORMAT.md`](docs/ADAPTER-FORMAT.md)。
-
-## 搜索
-
-按意图发现命令，中英双语：
-
-```bash
-unicli search "微博热搜"              # → weibo trending
-unicli search "B站热门"              # → bilibili popular
-unicli search "推特热门"              # → twitter trending
-unicli search "股票行情"              # → binance ticker, xueqiu quote
-unicli search "download video"       # 英文查询 → 多平台下载命令
-unicli search --category finance     # 按类别浏览
+  - limit: "${{ args.limit }}"
+args:
+  - { name: query, type: string, required: true, positional: true }
+  - { name: limit, type: int, default: 20 }
+columns: [title, url]
 ```
 
-BM25 + TF-IDF · 200 条 ZH↔EN 别名表 · 50KB 索引 · <10ms 查询。
-
-## 理论基础
+文档入口：
 
-五条设计原则，每条对应 [`docs/refs.bib`](docs/refs.bib) 中的引用文献：
+- [独立文档站](https://olo-dot-io.github.io/Uni-CLI/)
+- [快速开始](docs/guide/getting-started.md)
+- [Agent 集成](docs/guide/integrations.md)
+- [Adapter 格式](docs/ADAPTER-FORMAT.md)
+- [Pipeline 参考](docs/reference/pipeline.md)
+- [Exit codes](docs/reference/exit-codes.md)
 
-1. **Rice 限制** — 可判定的适配器语义（YAML 流水线，无图灵完备逻辑，可证明终止）
-2. **Lehman 命令** — 自修复是一等公民；没有永久有效的适配器；每个站点终将改变
-3. **Shannon 压缩** — `unicli` 调用是底层 API 调用的近最优压缩（约 80 token）
-4. **Agent 工具三难困境**（原创贡献）— 覆盖率 × 准确率 × 性能，三选二。我们优化准确率 × 性能
-5. **Banach 收敛** — 结构化错误消息（`adapter_path` + `step` + `suggestion`）保证修复迭代收敛
+## 边界和诚实说明
 
-42 条引用的完整论述：[`docs/THEORY.md`](docs/THEORY.md)。可复现的 token 基准测试：[`docs/BENCHMARK.md`](docs/BENCHMARK.md)。
+- 需要登录的网站使用本地 cookie 文件：`~/.unicli/cookies/<site>.json`。
+- Browser adapter 需要可连接的 Chrome/CDP。
+- CUA 路由必须配置真实 backend。声明了但不可用的 provider 会失败关闭，并返回结构化错误。
+- 用户 adapter 和修复放在 `~/.unicli/adapters/`；包内 adapter 是基线。
+- 如果网站阻止自动化或私有 API 变了，正确行为是清楚失败，不是伪装成功。
 
 ## 开发
 
 ```bash
-git clone https://github.com/olo-dot-io/Uni-CLI.git && cd Uni-CLI
-npm install
-npm run verify    # 类型检查 + lint + 测试 + 构建（7 个关卡，发布前必须全通过）
+pnpm install
+pnpm typecheck
+pnpm lint
+npm run verify
 ```
 
-| 命令                   | 用途                                                        |
-| ---------------------- | ----------------------------------------------------------- |
-| `npm run dev`          | 从源码运行（tsx）                                           |
-| `npm run build`        | 生产构建                                                    |
-| `npm run typecheck`    | TypeScript 严格模式                                         |
-| `npm run lint`         | Oxlint                                                      |
-| `npm run test`         | 单元测试（<!-- STATS:test_count -->7145<!-- /STATS --> 个） |
-| `npm run test:adapter` | 验证所有适配器                                              |
-| `npm run verify`       | 完整流水线 — 发布前必须通过                                 |
-
-十一个生产依赖：`ajv` · `ajv-formats` · `chalk` · `cli-table3` · `commander` · `js-yaml` · `jsonpath-plus` · `turndown` · `undici` · `ws` · `zod`。
-
-## 发布节奏
-
-补丁版本每周 **周五 09:00 HKT** 发布——前提是自上次打 tag 以来有实质性提交。平静的一周会被记录并跳过——沉默不是失败，而是成功。Dependabot 升级每周一合成一个 PR，在周五的版本里搭车一起上，避免污染提交历史。
-
-<a href="https://github.com/olo-dot-io/Uni-CLI/commits/main"><img src="https://img.shields.io/github/last-commit/olo-dot-io/Uni-CLI?style=flat-square&label=last-commit" alt="最近提交"></a>
-
-完整策略——手动覆写、取消流程、升级规则：[`docs/RELEASE-CADENCE.md`](docs/RELEASE-CADENCE.md)。
-
-## 贡献
-
-最快合并的方式：为你每天使用的站点写一个 20 行 YAML 适配器。评审门槛很低——只要能跑、符合 schema，就能合并。
-
-| 领域       | 指南                                                     |
-| ---------- | -------------------------------------------------------- |
-| 新适配器   | [`contributing/adapter.md`](contributing/adapter.md)     |
-| 新传输层   | [`contributing/transport.md`](contributing/transport.md) |
-| CUA 后端   | [`contributing/cua.md`](contributing/cua.md)             |
-| MCP 服务器 | [`contributing/mcp.md`](contributing/mcp.md)             |
-| ACP 集成   | [`contributing/acp.md`](contributing/acp.md)             |
-| 发布流程   | [`contributing/release.md`](contributing/release.md)     |
-
-## 许可证
+## License
 
 [Apache-2.0](./LICENSE)
 
-仓库：<https://github.com/olo-dot-io/Uni-CLI> · npm：[`@zenalexa/unicli`](https://www.npmjs.com/package/@zenalexa/unicli) · 欢迎提 Issue。
-
----
-
-<p align="center">
-  <a href="https://github.com/olo-dot-io/Uni-CLI/graphs/contributors">
-    <img src="https://contrib.rocks/image?repo=olo-dot-io/Uni-CLI" alt="贡献者">
-  </a>
-</p>
-
 <p align="center">
-  <sub>v0.215.0 — Closed Adapter Loop</sub><br>
-  <sub><!-- STATS:site_count -->220<!-- /STATS --> 个站点 · <!-- STATS:command_count -->1283<!-- /STATS --> 条命令 · <!-- STATS:pipeline_step_count -->59<!-- /STATS --> 个流水线步骤 · BM25+TF-IDF 中英双语搜索 · MCP 2025-11-25 · <!-- STATS:test_count -->7145<!-- /STATS --> 个测试</sub>
+  <sub>0.216.0 — OpenCLI Parity Harness</sub>
 </p>

package/dist/adapters/1688/assets.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assets.d.ts.map

package/dist/adapters/1688/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/adapters/1688/assets.ts"],"names":[],"mappings":""}