What's New

npm install -g phonebase-cli # first install
pb update && pb --version # upgrade

1. pb skills install — Now supports installing skills from .zip files. Example: pb skills install ./my-skill.zip.
2. pb skills install — After installation, the skill's full help is displayed (description + usage + commands), no need to run again to check.
3. pb pull — Files are now saved locally to .phonebase/pull/{device}/{filename} instead of returning raw base64 data.
4. pb push — Large file uploads no longer load the entire file into memory, reducing memory usage for big files.
5. pb <skill> — Skill help now shows DisplayName (skill-name) as title, with colored output (commands in green, args in dim, labels in yellow).
6. pb SDK — Package renamed from phonebase-js-sdk to phonebase-cli-sdk. Old require path @phonebase-cloud/pb still works for backward compatibility.
7. pb --version — Now returns JSON format in non-TTY / PHONEBASE_OUTPUT=json mode, including version and build_id fields.
8. pb daemon status / pb daemon ensure — JSON response now includes build_id field.
9. pb skills list — JSON response now includes icon_path (relative) and absolute_icon_path (absolute) fields for each skill.
10. pb screencap — Now supports [output] path, --format jpg|webp|png, --quality N, --width N, --height N, --base64 options. Screenshot logic moved to capability layer — SDK pb.call('screencap') now also saves files. Example: pb screencap /tmp/shot.webp --quality 50.

更新内容

npm install -g phonebase-cli # 首次安装
pb update && pb --version # 升级

1. pb skills install — 支持从 .zip 文件安装 skill。示例:pb skills install ./my-skill.zip。
2. pb skills install — 安装完成后直接显示 skill 的完整帮助(描述 + 用法 + 命令列表),无需再次运行查看。
3. pb pull — 文件保存到本地 .phonebase/pull/{设备}/{文件名},不再返回 base64 原始数据。
4. pb push — 大文件上传不再一次性读入内存,降低内存占用。
5. pb <skill> — Skill 帮助信息标题显示 显示名 (skill-name),带颜色输出(命令绿色、参数灰色、标签黄色)。
6. pb SDK — npm 包名从 phonebase-js-sdk 改为 phonebase-cli-sdk。旧的 require('@phonebase-cloud/pb') 仍可使用。
7. pb --version — 非 TTY / PHONEBASE_OUTPUT=json 模式下返回 JSON 格式,包含 version 和 build_id 字段。
8. pb daemon status / pb daemon ensure — JSON 响应新增 build_id 字段。
9. pb skills list — JSON 响应新增 icon_path(相对路径)和 absolute_icon_path(绝对路径)字段。
10. pb screencap — 支持 [output] 输出路径、--format jpg|webp|png、--quality N、--width N、--height N、--base64 参数。截图逻辑下沉到 capability 层,SDK pb.call('screencap') 也能保存文件。示例:pb screencap /tmp/shot.webp --quality 50。

What's New

npm install -g phonebase-cli # first install
pb update && pb --version # upgrade

1. pb connect — Accepts IP address or device code directly. Example: pb connect 192.168.180.24.
2. pb SDK — pb.call('connect', { target: '192.168.180.24' }) now works the same as CLI. Also works with pb.call('proxy'), pb.call('devices', 'list'), etc.
3. pb — Error messages now follow the client's language setting, regardless of the server's system language.
4. pb node — Error messages are now localized (Chinese/English) for missing selectors, conflicting options, and missing values.
5. pb text — --submit replaced with --ime_action <int>, allowing any IME action (e.g. --ime_action 3 for search, --ime_action 6 for done). Example: pb text "hello" --clear --ime_action 6.
6. pb node — Now accepts both short names (--id, --desc) and full names (--resource_id, --content_desc, --wait_timeout, --wait_interval).
7. pb screencap / pb inspect — Output paths are now absolute, usable directly by AI agents without knowing the working directory.
8. pb package icon — Icons now saved to ~/.phonebase/icons/ (global) instead of .phonebase/icons/ (project-local).
9. pb inspect — Fixed "Multiple devices connected" error when using -s to specify a device.
10. pb SDK — waitForNode / waitForNodeAction now use flat params matching CLI convention. Example: waitForNode({ id: 'btn_login' }).
11. pb SDK — Skill scripts receive SKILL_RUNTIME_* and SKILL_META_* environment variables. SKILL_META_* are dynamically injected from SKILL.md frontmatter fields.

更新内容

npm install -g phonebase-cli # 首次安装
pb update && pb --version # 升级

1. pb connect — 支持 IP 地址或设备编号直接连接。示例:pb connect 192.168.180.24。
2. pb SDK — pb.call('connect', { target: '192.168.180.24' }) 和 CLI 完全一致。pb.call('proxy')、pb.call('devices', 'list') 等也已对齐。
3. pb — 错误消息语言跟随客户端设置,不再受服务端系统语言影响。
4. pb node — 错误提示已国际化(中英文),包括缺少选择器、选项冲突、缺少参数值等。
5. pb text — --submit 替换为 --ime_action <int>,支持发送任意 IME action(如 --ime_action 3 搜索,--ime_action 6 完成)。示例:pb text "hello" --clear --ime_action 6。
6. pb node — 同时支持短名(--id、--desc)和全名(--resource_id、--content_desc、--wait_timeout、--wait_interval)。
7. pb screencap / pb inspect — 输出路径改为绝对路径,AI agent 可直接使用。
8. pb package icon — 图标保存到全局目录 ~/.phonebase/icons/,不再依赖项目目录。
9. pb inspect — 修复多设备连接时使用 -s 指定设备仍报错的问题。
10. pb SDK — waitForNode / waitForNodeAction 改为扁平参数,与 CLI 一致。示例:waitForNode({ id: 'btn_login' })。
11. pb SDK — Skill 脚本可通过 SKILL_RUNTIME_* 和 SKILL_META_* 环境变量获取运行时信息和 SKILL.md 元数据。

What's New

npm install -g phonebase-cli # first install
pb update && pb --version # upgrade

1. pb package info <package> / pb package icon <package> — New two-part subcommands for querying app details and extracting launcher icons. Replaces the old pb icon alias.
2. pb package info — Returns 404 with a clear error when the package doesn't exist on the device.
3. pb text — New --clear and --submit flags. --clear clears the input field before typing, --submit presses Enter after. Example: pb text "hello world" --clear --submit.
4. pb text — Now correctly handles numeric input. Previously, entering a long number like a phone number would garble it into scientific notation.
5. pb dump / pb dumpc — Now supports format=json parameter to get structured JSON instead of XML/text. Example: pb -j '{"format":"json"}' dump.
6. pb — JSON output format unified to {code, data, msg, cost} across all commands. Simpler and consistent.
7. pb — Human-readable output improved: boolean results show localized success/failure marks, data-rich responses show formatted tables, message-only responses show the message with a checkmark.
8. pb SDK — New convenience methods: pb.dump() / pb.dumpJson() / pb.dumpText() for full UI hierarchy, pb.dumpc() / pb.dumpcJson() / pb.dumpcText() for compact hierarchy, pb.close() for connection management.
9. pb SDK — New utility functions: findNode / findAll for searching JSON dump trees (supports attribute match, regex, and function predicates), waitForNode / waitForNodeAction for device-side node waiting with auto id→resource_id mapping, randomPointInBounds for natural-looking taps.
10. pb SDK — success() / failure() now handle uncaught exceptions automatically when utils is imported.

更新内容

npm install -g phonebase-cli # 首次安装
pb update && pb --version # 升级

1. pb package info <包名> / pb package icon <包名> — 新增两段式子命令,查询应用详情和提取启动图标。替代旧的 pb icon 别名。
2. pb package info — 设备上不存在的包名返回 404 和明确的错误消息。
3. pb text — 新增 --clear 和 --submit 参数。--clear 输入前清空输入框,--submit 输入后自动回车。示例:pb text "hello world" --clear --submit。
4. pb text — 修复数字输入问题。之前输入长数字(如手机号)会被转成科学计数法。
5. pb dump / pb dumpc — 支持 format=json 参数,返回结构化 JSON。示例:pb -j '{"format":"json"}' dump。
6. pb — JSON 输出格式统一为 {code, data, msg, cost},所有命令格式一致。
7. pb — 改善人类格式输出:布尔结果显示本地化的成功/失败标记,有数据的命令显示格式化表格,纯消息命令显示带 ✓ 的消息。
8. pb SDK — 新增便捷方法:pb.dump() / pb.dumpJson() / pb.dumpText() 获取完整 UI 层级,pb.dumpc() / pb.dumpcJson() / pb.dumpcText() 获取精简层级,pb.close() 主动关闭连接。
9. pb SDK — 新增工具函数:findNode / findAll 搜索 JSON dump 树(支持属性匹配、正则、函数断言),waitForNode / waitForNodeAction 设备端等待 UI 元素(自动 id→resource_id 映射),randomPointInBounds 自然点击坐标。
10. pb SDK — 导入 utils 后自动捕获未处理异常,通过 success() / failure() 标准化输出。

What's New

npm install -g phonebase-cli # first install
pb update && pb --version # upgrade

1. pb — Windows is now fully supported.
2. pb launch — Launching an app now auto-grants all runtime permissions, so the app lands ready to use without extra permission dialogs.
3. pb node — New alias to find a UI element by text / content description / resource ID and optionally act on it in one call. Examples: pb node --text 设置, pb node --id com.app:id/login --click, pb node --id com.app:id/edit --input "hello". Waits up to 3s for the element to appear by default.
4. pb clear <package> — New alias to wipe an app's cached data and preferences, putting it back in a fresh-install state.
5. pb proxy — Query, enable, or disable device proxy. pb proxy --url socks5://ip:port to enable, pb proxy --disable to disable, pb proxy to check status. SDK: pb.call('proxy', {enabled: true, nodes: [{proxy_url: '...'}]}).
6. pb browse <url> — Fixed: the command used to fail outright on every URL. It now reliably opens the link in the device's browser.
7. pb browse <url> — First-launch friction is gone: no taps required on fresh installs, the target page loads directly.
8. pb skills new --path <DIR> — New flag to scaffold a skill into any directory you choose (e.g. a project repo) instead of the default ~/.phonebase/skills/. The skill is not auto-registered; run pb skills install <DIR>/<name> when you're ready to enable it.
9. pb skills new --template <DIR_OR_URL> — New flag to scaffold from your own template instead of the default one. Accepts a local directory or a git URL (https / ssh / git / file). Examples: pb skills new my-skill --template ./my-template, pb skills new my-skill --template git@192.168.0.1:team/skill-template.git.
10. pb — The SDK now offers a single pb.call(command, [subcommand], [args]) method that can reach every capability, including platform management (pb.call('devices', 'list')), authentication (pb.call('login')), and configuration (pb.call('config', 'show')).
11. Device errors — The numeric error code from the device now reaches you as-is (e.g. 404 when a UI node isn't there). The redundant device error: prefix is also gone.

更新内容

npm install -g phonebase-cli # 首次安装
pb update && pb --version # 升级

1. Windows — 全功能支持,安装方式不变(npm install -g phonebase-cli)。
2. pb launch — 启动 App 时自动授权所有权限,App 打开即可直接使用,免去手动点授权弹窗。
3. pb node — 新别名:按 文本 / 内容描述 / 资源 ID 查找 UI 节点,可选顺带点击或输入文本。示例:pb node --text 设置、pb node --id com.app:id/login --click、pb node --id com.app:id/edit --input "你好"。默认等待节点出现最多 3 秒。
4. pb clear <包名> — 新别名:一键清除应用的缓存数据与偏好设置,把 App 恢复到刚安装好的状态。
5. pb proxy — 查询、启用、禁用设备代理。pb proxy --url socks5://ip:port 启用,pb proxy --disable 禁用,pb proxy 查询状态。SDK:pb.call('proxy', {enabled: true, nodes: [{proxy_url: '...'}]})。
6. pb browse <url> — 修复:之前对任何 URL 都直接失败打不开。现在能可靠打开链接。
7. pb browse <url> — 首次打开不再卡任何对话框,目标网址直接加载。
8. pb skills new --path <目录> — 新参数:把脚手架生成到任意目录(比如你自己的项目仓库),不再被限死在 ~/.phonebase/skills/。生成的 skill 不会自动注册,准备好后用 pb skills install <目录>/<名字> 启用即可。
9. pb skills new --template <目录或地址> — 新参数:用你自己的脚手架代替默认模板。支持本地目录或 git 地址(https / ssh / git / file)。示例:pb skills new my-skill --template ./my-template、pb skills new my-skill --template git@192.168.0.1:team/skill-template.git。
10. SDK — 简化为 pb.call(命令, [子命令], [参数]) 单方法,可调用所有能力:平台管理(pb.call('devices', 'list'))、认证(pb.call('login'))、配置(pb.call('config', 'show'))等。
11. 设备错误 — 设备端返回的错误码现在原样展示(比如找不到 UI 节点会直接看到 404)。错误消息里多余的 device error: 前缀也去掉了。

What's New

If you have pb installed, run the following to upgrade and verify:

pb update && pb --version

1. pb info — Redesigned human-mode output: path, title, markdown body, and arguments are shown in clearly separated sections; markdown is now rendered in-terminal (lists, tables, and code blocks all formatted).
2. pb list -s <device> / pb screencap -s <device> — Fixed: -s was silently ignored when multiple devices were connected, causing a "multiple devices connected" error.
3. Output rendering — Nested objects in command responses (e.g. launcher_activity inside pb package/list) are now expanded line-by-line with indentation instead of squashed into a single-line JSON.
4. Output rendering — Object arrays are listed vertically as separate blocks instead of being forced into a wide table, making long fields readable.

更新内容

安装好 pb 后,运行下面一行升级并确认:

pb update && pb --version

1. pb info — 人类模式输出重做:路径、标题、Markdown 正文、参数表分段展示,Markdown 直接在终端渲染(列表、表格、代码块都有格式)。
2. pb list -s <设备> / pb screencap -s <设备> — 修复多设备连接时 -s 被忽略、导致报"已连接多台设备"的问题。
3. 通用输出 — 命令响应里的嵌套对象(如 pb package/list 的 launcher_activity)现在按层缩进展开,不再压成一行 JSON。
4. 通用输出 — 对象数组改成纵向逐个展示,不再硬塞进宽表格,长字段终于看得清。

What's New

If you have pb installed, run the following to upgrade and verify:

pb update && pb --version

1. pb connect accepts a WebSocket URL directly. Example: pb connect wss://10.0.0.1:8080/ws.
2. pb devices --connected new flag — list only currently connected devices.
3. pb devices now shows directly-connected devices in the same table, labeled direct in the CONNECTED column.
4. pb devices adds a LATENCY column — measures round-trip time for each connected device.
5. pb devices adds a CONTROL API column — shows the on-device Control API version (e.g. 1.1.1).
6. pb devices JSON output includes type (phonebase / direct), latency_ms, and control_api_version_name fields on every device.
7. pb devices table auto-adjusts the CODE column width to fit long identifiers like IP addresses.
8. pb --help now surfaces optional arguments in its command list: connect <device_code|ws_url>, disconnect [device_code], and devices [--connected].
9. Commands returning data with nested object arrays (e.g. pb package/list) now render the array as a sub-table instead of inline JSON.

更新内容

安装好 pb 后,运行下面一行升级并确认:

pb update && pb --version

1. pb connect 支持直接传 WebSocket 地址,例如 pb connect wss://10.0.0.1:8080/ws。
2. pb devices --connected 新参数——只列出当前已连接的设备。
3. pb devices 把直连设备也显示在同一个表格里,CONNECTED 列标 direct。
4. pb devices 新增 LATENCY 列——显示每个已连接设备的网络往返延迟。
5. pb devices 新增 CONTROL API 列——显示设备端 Control API 版本号(如 1.1.1)。
6. pb devices JSON 输出给每个设备加了 type(phonebase / direct)、latency_ms、control_api_version_name 字段。
7. pb devices 表格的 CODE 列宽度自动撑开,长 IP 不再错位。
8. pb --help 的命令列表现在显示了可选参数:connect <device_code|ws_url>、disconnect [device_code]、devices [--connected]。
9. 返回嵌套对象数组的命令(如 pb package/list)现在会把数组用子表格展示,不再塞一行压缩 JSON。

What's New

If you have pb installed, run the following to upgrade and verify:

pb update && pb --version

New Commands

• Added pb skills list --remote to browse hub skills without installing. Supports --page, --size, --category, --refresh.
• Added pb skills search <query>. Searches locally by default; --remote searches a hub.
• Added pb skills categories — lists every category with counts.
• Added pb skills show <name> — previews commands, arguments, and metadata before install.
• Added pb skills remote — lists all configured hubs.
• Added pb skills remote add <name> <url>. Supports --index and --branch.
• Added pb skills remote remove <name>.
• Added pb skills remote default [<name>] — shows or switches the default hub.
• Added --remote=NAME to pb skills install — install from any configured hub.

Connection

• Added multi-source support for skill hubs. Register official / private / personal hubs side-by-side.
• PHONEBASE_SKILL_HUB_REPO env var still overrides the default hub URL.

UI

• Remote listings now match the two-line layout of the local list (icon + status + DisplayName (id) vX · category + description).
• [installed] / [available] tags on remote list.
• Pagination footer: Page A/B · N skills · remote=<name>.
• Offline cache fallback with "using offline cache" warning when the hub is unreachable.

Error Handling

• Skill hub errors are now translated: invalid URL, duplicate name, removing default, unknown remote, missing index file, etc.
• "Unknown remote" lists every configured name.

Installation

• Available on npm: npm install -g phonebase-cli. Native pb binary, no Node wrapper. Upgrade with npm update -g phonebase-cli.

更新内容

安装好 pb 后,运行下面一行升级并确认:

pb update && pb --version

新增命令

• 新增 pb skills list --remote:不装就能浏览 hub。支持 --page、--size、--category、--refresh。
• 新增 pb skills search <关键词>:默认搜本地已装,--remote 搜远程。
• 新增 pb skills categories:列出所有分类和每类数量。
• 新增 pb skills show <名字>:装前预览命令、参数、元信息。
• 新增 pb skills remote:列出所有已配置的 hub。
• 新增 pb skills remote add <名字> <URL>:支持 --index 和 --branch。
• 新增 pb skills remote remove <名字>。
• 新增 pb skills remote default [<名字>]:显示或切换默认 hub。
• pb skills install 新增 --remote=名字,从任意已配置 hub 安装。

连接管理

• 支持 skill 多源。官方 / 团队私有 / 个人 hub 可并列配置。
• PHONEBASE_SKILL_HUB_REPO 环境变量仍然覆盖默认 hub URL。

界面

• 远程列表改用和本地列表一致的两行布局(图标 + 状态 + DisplayName (id) vX · 分类 + 描述)。
• 远程列表标注 [installed] / [available]。
• 分页 footer:第 A/B 页 · 共 N 条 · remote=<名字>。
• hub 拉不到时回落本地缓存,显示"使用离线缓存"。

错误提示

• skill hub 错误消息全部翻译:URL 非法、名字重复、删默认源、未知 remote、索引文件缺失等。
• "未知 remote" 会列出所有已配置的名字。

安装

• 支持 npm:npm install -g phonebase-cli。原生 pb 二进制,无 Node 中间层。升级用 npm update -g phonebase-cli。

What's New

Install or upgrade with the one-liner:

curl -fsSL https://get.phonebase.cloud | sh

Verify afterwards:

pb --version
pb skills install

Device Control

1. pb install supports local files, URLs, and XAPK — Install apps from a local APK/XAPK file, an HTTP URL, or a device path. Large files show a real-time progress bar with speed and ETA. Example: pb install ~/Downloads/app.xapk
2. pb push uploads files to the device — Push local files with --dest for custom paths, or pass a URL to let the device download directly. Example: pb push photo.jpg --dest /sdcard/Pictures/
3. Smart error recovery — Missing arguments, invalid paths, and interrupted transfers give clear suggestions. Partial uploads are cleaned up automatically

New Commands

4. pb daemon status/stop/restart/logs — Full daemon lifecycle management. Check connection status, restart after issues, or tail the log file for debugging
5. pb skills new <name> — Scaffold a new skill interactively: pick the target app from a live device list, auto-extract the app icon, pre-fill package name and category
6. pb icon <package> — Show any installed app's launcher icon in the terminal

Skills

7. pb skills install <name> from the skill hub — Install skills by name with automatic dependency resolution. Example: pb skills install googleplay pulls GooglePlay + its dependency GoogleServices in one command
8. pb skills list shows icons, versions, and status — Visual skill overview at a glance: app icon, enabled/disabled state, version, and description
9. Streaming install progress — Watch installs happen in real time: ↓ downloaded, → found dependency, ✓ installed
10. Remote skill templates — pb skills new pulls the latest templates automatically — no CLI update needed to get template improvements

UI

11. App icons everywhere — pb packages and pb skills list now display launcher icons inline (iTerm2 / Kitty) with colored letter fallback in other terminals
12. Cleaner pb list output — Commands already available as aliases are hidden, giving you a focused view of what's actually useful
13. Reorganized pb --help — Commands grouped into Device Management, Device Control, Skills, and Connection sections
14. Seamless upgrades — pb update automatically restarts the daemon so the new version takes effect immediately

Connection

15. Idle timeout — Auto-disconnects after 10 minutes of inactivity to save resources. Configure with pb config set idle_timeout <seconds>
16. Faster sequential commands — Reduced overhead when running multiple pb commands in a row (e.g., AI agent workflows)
17. More reliable connections — Rearchitected CLI-to-device communication for better stability under load

Config

18. Underscore-style config keys — network_timeout, idle_timeout (old dash-style keys removed)

更新内容

一键安装或升级:

curl -fsSL https://get.phonebase.cloud | sh

验证安装:

pb --version
pb skills install

设备控制

1. pb install 支持本地文件、URL 和 XAPK — 本地 APK/XAPK、HTTP 链接、设备路径三种方式安装应用,大文件实时显示进度条和预估时间。示例:pb install ~/Downloads/app.xapk
2. pb push 上传文件到设备 — 本地文件用 --dest 指定目标路径,也可传 URL 让设备直接下载。示例:pb push photo.jpg --dest /sdcard/Pictures/
3. 智能错误恢复 — 缺参数、路径不存在、传输中断都给出清晰的操作建议,失败时自动清理残留文件

新增命令

4. pb daemon status/stop/restart/logs — 完整的守护进程管理:查看连接状态、重启、查看日志
5. pb skills new <name> — 交互式创建 skill:从已连接设备的应用列表中选择目标应用,自动提取图标,预填包名和分类
6. pb icon <package> — 在终端显示任意已安装应用的图标

Skills

7. pb skills install <name> 从 skill hub 安装 — 按名字安装 skill,自动解析依赖。示例:pb skills install googleplay 一条命令拉取 GooglePlay 及其依赖 GoogleServices
8. pb skills list 展示图标、版本和状态 — 一览:应用图标、启用/禁用状态、版本号、描述
9. 流式安装进度 — 实时看到安装过程:↓ 下载、→ 发现依赖、✓ 安装
10. 远程 skill 模板 — pb skills new 自动拉取最新模板,不需要更新 CLI 就能获得模板改进

界面

11. 应用图标随处可见 — pb packages 和 pb skills list 都内联显示应用图标(iTerm2 / Kitty),其他终端用彩色首字母代替
12. 更干净的 pb list 输出 — 已被别名覆盖的命令自动隐藏,只显示真正需要关注的接口
13. pb --help 分类重组 — 按设备管理、设备操作、Skills、连接分组,快速找到需要的命令
14. 无缝升级 — pb update 自动重启守护进程,新版本立即生效

连接

15. 空闲超时 — 10 分钟无操作自动断连以节省资源,可配置:pb config set idle_timeout <秒数>
16. 连续命令更快 — 连续执行多条 pb 命令时开销更低(AI agent 工作流受益明显)
17. 连接更稳定 — 重新设计了 CLI 到设备的通信架构,高负载下更可靠

配置

18. Config key 统一下划线风格 — network_timeout、idle_timeout(不再支持横杠风格)

What's New

This release introduces the new skills system. Install or upgrade with the one-liner so both the pb binary and the global skills get installed together:

curl -fsSL https://get.phonebase.cloud | sh

Verify afterwards:

pb --version
pb skills list

Skills

1. pb skills — New subcommand family for managing skill guides: list, install, uninstall, enable, disable. Skills are Claude-standard markdown guides AI agents read for multi-step phone operations
2. pb skills install — Single command installs both bundled builtins (install-app, web-search) to ~/.phonebase/skills/ AND the global phonebase skill to ~/.agents/skills/phonebase/ via npx skills add phonebase-cloud/phonebase-skills -g -y
3. Non-interactive by design — -g -y flags ensure the install never hangs on prompts, safe for AI / CI / curl | sh contexts
4. Installer auto-runs skills install — Both curl -fsSL https://get.phonebase.cloud | sh and pb update now trigger skills installation so AI agents have guides ready immediately
5. Skills layout — Builtin skills moved from flat .md files to Claude-standard <name>/SKILL.md directory layout

AI Context

6. AI context moved to skills — The "For AI Agents" block previously injected at the bottom of pb --help is removed. All AI guidance now lives in the phonebase skill from phonebase-cloud/phonebase-skills, so pb --help is cleaner for humans and AI guidance can evolve independently of pb releases

Device Control

7. pb inspect rewrite — Now generates a Layout Inspector-style HTML with two panels: Wireframe (reproduces UI layout from bounds coordinates, showing text / buttons / inputs / skeletons) and Screenshot (hover to highlight any element, click to copy its full XML attributes)
8. pb inspect via daemon — Routed through the persistent daemon (dump + screencap) instead of a standalone HTTP endpoint, much faster and reuses the connected session

Output

9. pb devices JSON adds connected — Each device in JSON output now includes connected: true/false. AI agents previously only saw device list + online status; now they can pick the already-connected device instead of asking the user which one to use

UI

10. pb skills --help — Custom template centralizes all subcommand usage lines inline. No global -s/-j/-f noise, no duplicate help subcommand entry, no per-subcommand --help. Everything is in one place
11. install.sh shows download URL — Prints the full GitHub release URL before downloading, so users know what's being fetched

更新内容

本次版本引入全新的 skills 系统。请使用一条命令安装或升级,这样会自动同时安装 pb 和全局 skills:

curl -fsSL https://get.phonebase.cloud | sh

安装完成后验证:

pb --version
pb skills list

Skills

1. pb skills — 新增 skills 子命令系列:list、install、uninstall、enable、disable。skills 是 Claude 标准的 markdown 指南,AI agent 读它们来执行多步手机操作
2. pb skills install — 一条命令同时安装内置 skills(install-app、web-search → ~/.phonebase/skills/)和全局 phonebase skill(→ ~/.agents/skills/phonebase/,通过 npx skills add phonebase-cloud/phonebase-skills -g -y)
3. 非交互设计 — -g -y 参数确保安装过程绝不卡在交互提示上,AI / CI / curl | sh 场景全部可用
4. 安装器自动装 skills — curl -fsSL https://get.phonebase.cloud | sh 和 pb update 都会触发 skills 安装,AI agent 开箱即用
5. Skills 目录结构 — 内置 skill 从 flat .md 文件迁移到 Claude 标准的 <name>/SKILL.md 目录结构

AI 上下文

6. AI 上下文迁移到 skills — 之前注入在 pb --help 底部的「For AI Agents」段落已移除。所有 AI 指南迁移到 phonebase-cloud/phonebase-skills 的 phonebase skill,pb --help 对人类更干净,AI 指南可以独立于 pb 版本单独迭代

设备控制

7. pb inspect 重写 — 生成 Layout Inspector 风格的 HTML,双面板:Wireframe(按 bounds 坐标复刻 UI 布局,显示文字 / 按钮 / 输入框 / 骨架屏)+ Screenshot(hover 高亮任意控件,点击复制完整 XML 属性)
8. pb inspect 改走 daemon — 通过长连接的 daemon 接口(dump + screencap)而非独立 HTTP 端点,更快,复用已连接会话

输出

9. pb devices JSON 补 connected 字段 — 每个 device 的 JSON 输出新增 connected: true/false。之前 AI agent 只能看到设备列表和 online 状态,现在能直接识别已连接的设备,不用再问用户选哪台

UI

10. pb skills --help — 定制模板把所有子命令的完整用法集中在一处。没有全局 -s/-j/-f 噪声,没有重复的 help 子命令条目,子命令也不再有自己的 --help。所有信息集中在父命令
11. install.sh 显示下载地址 — 下载前打印完整的 GitHub release URL,用户能确认将要下载什么

What's New

If you have pb installed, run the following to upgrade and verify:

pb update && pb --version

Output

1. Smart output — Humans see colored text, tables, and ✓/✗ status. AI agents get structured JSON. Automatic, no config needed
2. PHONEBASE_OUTPUT — Set to json or text to force output format (case-insensitive)
3. Human-friendly tables — pb devices and pb devices list show a clean table in terminal, JSON when piped
4. Key-value display — pb status, pb display, pb top-activity etc. show aligned key-value pairs instead of raw JSON
5. Boolean results — Commands like pb start show ✓ Success / ✗ Failed instead of true / false
6. Config dual-mode — pb config show, pb config list, pb config get, pb apikey now output JSON when piped

New Commands

7. pb browse <url> — Open URL in browser, auto-picks best available (Via → Via GP → Chrome → system default)
8. pb uninstall <package> — Uninstall app from device
9. pb install --uri <url> — Install APK from URL (in addition to pb install <file>)
10. pb list — Now an alias command, shows API name + description. Hides aliased and internal APIs
11. pb info <name> — Now an alias command, shows API details

Screenshot

12. JPG format — Quality 80, much smaller than PNG
13. Terminal preview — Screenshot displayed directly in terminal (iTerm2/Kitty)
14. Organized storage — Saved to .phonebase/screencap/{YYYYMMDD}/{device_code}-{timestamp}.jpg
15. Project data directory — .phonebase/ in working directory for screencap, inspect, and future data

Device Control

16. pb dump formatting — XML output is now nicely indented instead of a single long line
17. pb swipe upgrade — Now uses bezier curve scrolling (input/scroll_bezier) for smoother swipes
18. Alias Handler system — Each alias can have custom logic. clipboard auto-picks get/set, install auto-picks file/uri

Connection

19. Auto-disconnect — Idle connections close after 10 minutes to save costs (configurable: pb config set network.idle_timeout 600)
20. Removed user aliases — ~/.phonebase/aliases.toml no longer supported. All aliases are built-in

Error Handling

21. No URL leaks — HTTP errors no longer expose internal API URLs
22. Friendly prefixes — ✗ Not found: ..., ✗ Unauthorized: ..., ✗ Rate limited: ... instead of raw error codes

UI

23. Device Code — All user-facing text uses "Device Code" (e.g. IDY291LX6WW6RCW) instead of "Device ID"
24. devices create — Now shows device_code and status after creation
25. ui command hidden — Removed from help output (still works)
26. screencap subcommand removed — Now runs as alias command, same usage

更新内容

运行以下命令升级并验证:

pb update && pb --version

输出

1. 智能输出 — 人类看到彩色文字、表格和 ✓/✗ 状态,AI 拿到结构化 JSON。自动切换,无需配置
2. PHONEBASE_OUTPUT — 设为 json 或 text 强制指定输出格式(不区分大小写)
3. 表格显示 — pb devices 和 pb devices list 终端显示表格,管道输出 JSON
4. Key-value 显示 — pb status、pb display、pb top-activity 等显示对齐的键值对,不再是原始 JSON
5. 布尔值友好 — pb start 等命令显示 ✓ 成功 / ✗ 失败 而不是 true / false
6. 配置双模 — pb config show、pb config list、pb config get、pb apikey 管道输出 JSON

新增命令

7. pb browse <url> — 用浏览器打开链接,自动选择最佳浏览器(Via → Via GP → Chrome → 系统默认)
8. pb uninstall <包名> — 卸载应用
9. pb install --uri <链接> — 从 URL 安装 APK(原有 pb install <文件> 保留)
10. pb list — 改为别名命令,显示接口名+描述,隐藏已有别名和内部接口
11. pb info <名称> — 改为别名命令,显示接口详情

截图

12. JPG 格式 — 质量 80,体积远小于 PNG
13. 终端内预览 — 截图直接在终端中显示(支持 iTerm2/Kitty)
14. 有序归档 — 保存到 .phonebase/screencap/{YYYYMMDD}/{设备编号}-{时间戳}.jpg
15. 项目数据目录 — 工作目录下 .phonebase/ 统一存放截图、inspect 等数据

设备控制

16. pb dump 格式化 — XML 输出自动缩进,不再是一行到底
17. pb swipe 升级 — 改用贝塞尔曲线滑动(input/scroll_bezier),滑动更顺滑
18. 别名 Handler — 每个别名可以有自定义逻辑。clipboard 自动选 get/set,install 自动选 file/uri

连接

19. 自动断开 — 空闲 10 分钟自动断开,避免浪费(可配置:pb config set network.idle_timeout 600)
20. 移除用户自定义别名 — 不再支持 ~/.phonebase/aliases.toml,所有别名内置

错误处理

21. 不泄露地址 — HTTP 错误不再暴露内部 API 地址
22. 友好前缀 — ✗ 资源不存在: ...、✗ 认证失败: ...、✗ 请求过于频繁: ... 替代原始错误码

界面

23. 设备编号 — 所有可见文案统一使用「设备编号」(如 IDY291LX6WW6RCW)替代「设备 ID」
24. devices create — 创建后显示 device_code 和 status
25. ui 命令隐藏 — 从帮助中移除(命令仍可用)
26. screencap 子命令移除 — 改为别名命令运行,用法不变