常用配方

这些配方覆盖最常见的使用路径。命令保持英文，因为它们就是实际 CLI 合同。

找一个命令并运行

unicli search "github trending"
unicli github-trending daily --limit 10

脚本里用 JSON：

unicli github-trending daily --limit 10 -f json

给智能体一个短合同

把这段放进项目的 agent 指令：

Use `unicli search "intent"` before choosing a command. Run commands as
`unicli SITE COMMAND [args]`. Prefer `-f json` for scripts and structured
Markdown for human-readable output.

设置认证

unicli auth setup SITE
unicli auth check SITE

Cookie 文件：

~/.unicli/cookies/SITE.json

修复命令

unicli SITE COMMAND
unicli repair SITE COMMAND

修复时看错误信封：

• error.adapter_path
• error.step
• error.suggestion
• error.alternatives

浏览器操作

unicli operate goto "https://example.com"
unicli operate snapshot
unicli operate click --ref 42
unicli operate type --ref 7 --text "hello"

适合临时探索页面，或者为 browser adapter 找 selector。

MCP 服务

npx @zenalexa/unicli mcp serve
npx @zenalexa/unicli mcp serve --transport streamable --port 19826

ACP 网关

unicli acp

ACP 只是一条兼容路径。能直接跑 shell 时，优先用 unicli 命令。

列出能力

unicli list
unicli list --site macos
unicli list --category desktop
unicli search "office insert image"

检查项目健康

npm run verify
npm run docs:build

改 adapter 后至少跑：

npm run lint:adapters
npm run lint:schema-v2
npm run test:adapter