a4phone命令参考

本文章是 a4phone 命令行工具 a4p 的完整命令速查表，按功能分组介绍每条命令的用途、参数与典型输出，供日常使用与排障时快速查阅。安装后可用 a4p help 查看内置帮助。

1. 命令总览

命令	用途	分类
`a4p setup`	安装引导（生成话题、注册 Claude Code / Codex / ZCode Hook、为全部 DSH profile 挂载插件、启动守护进程、注册开机自启、显示二维码）	安装配置
`a4p out`	切换为外出模式（手机优先）	模式管理
`a4p home`	切换为终端优先模式（默认）	模式管理
`a4p status`	查看当前模式	模式管理
`a4p listen`	后台运行续聊守护进程	守护进程
`a4p listen --stop`	停止守护进程	守护进程
`a4p listen --status`	查看守护进程状态	守护进程
`a4p autostart`	查看开机自启状态（`--on` / `--off`）	开机自启
`a4p resume`	手动续聊最近会话：`a4p resume 要追加的内容`	远程续聊
`a4p last`	查看最近会话记录	远程续聊
`a4p test`	发送测试通知	测试
`a4p uninstall`	移除 Hook、配置、守护进程与开机自启	卸载
`a4p --version`	查看版本号	信息
`a4p help`	显示帮助	信息

2. 安装配置

2.1 setup 安装引导

a4p setup

自动完成：生成话题写入 ~/.a4phone/config.json、注册 Claude Code / Codex / ZCode Hook、为 ~/.dsh/profiles/ 下全部 profile 挂载 DSH 插件、写入 ZCode 默认模型配置、默认启动守护进程、注册开机自启、显示订阅二维码。重复执行幂等，已存在配置自动跳过。

输出示例：

a4phone 安装完成

话题名称: a4p-3f2a9c1b7d4e5f60
订阅地址: https://ntfy.sh/a4p-3f2a9c1b7d4e5f60

在 ntfy App 中扫码订阅：
...
Claude Code 配置：已自动写入 ~/.claude/settings.json
Codex 配置：已自动写入 ~/.codex/config.toml
ZCode 配置：已自动写入 ~/.zcode/cli/config.json
ZCode 续聊模型：已写入默认模型配置（续聊时按会话实际模型自动同步）
DSH 配置：已自动写入 cordis.patch.yml：web（共 1 个 profile：web）
开机自启：已注册（登录时自动运行续聊守护进程，可用 a4p autostart --off 关闭）

2.2 uninstall 卸载

a4p uninstall

依次执行：停止守护进程、关闭开机自启、移除 Claude Code Hook、移除 Codex 配置、移除 ZCode Hook 与模型配置、移除全部 DSH profile 的插件挂载、清理 ~/.a4phone/ 目录与旧版家目录散点文件。

3. 模式管理

a4p out      # 外出模式：提问/权限请求优先推送手机，超时终端兜底
a4p home     # 终端优先模式（默认）：直接走终端，手机不参与
a4p status   # 当前模式：外出（手机优先）或 终端优先（默认）

切换即时生效，无需重启 AI 会话。详见双模式切换。

4. 守护进程

a4p listen              # 后台运行续聊守护进程（无窗口）
a4p listen --status     # 查看守护进程状态（PID、启动时间、日志路径）
a4p listen --stop       # 停止守护进程

日志写入 ~/.a4phone/daemon.log。详见后台守护进程与开机自启。

5. 开机自启

a4p autostart          # 查看开机自启状态
a4p autostart --on     # 开启开机自启（登录时自动运行续聊守护进程）
a4p autostart --off    # 关闭开机自启

仅 Windows 支持自动注册，非 Windows 平台返回提示（可用 tmux / systemd 手动常驻）。

6. 远程续聊

a4p resume 帮我总结一下刚才的改动   # 手动续聊最近会话
a4p last                            # 查看最近会话记录

a4p resume：把参数文本作为下一条用户消息续聊最近会话，完成后回复推回手机
a4p last：显示最近会话的会话 ID、目录、来源 Agent 与时间

详见远程续聊。

7. 测试与信息

a4p test         # 发送测试通知到手机
a4p --version    # 查看版本号（也可用 -v / version）
a4p help         # 显示帮助（也可用 --help / -h）

a4p test 未配置话题时会提示先运行 a4p setup。

8. 内部命令

以下命令由 a4phone 内部调用，一般无需手动执行：

命令	用途
`a4p hook [claude\\|codex\\|zcode]`	处理 AI 事件 Hook（Claude Code / Codex / ZCode 配置引用，stdin 读取事件 JSON，默认按 claude 处理）
`a4p listen --daemon-child`	守护进程后台子进程入口（`a4p listen` 内部 spawn）

a4p hook 是 AI 每次事件都会调用的热路径，不参与版本更新检查，避免延迟。

9. 版本更新检查行为

除 hook、--version、help、listen --daemon-child 外，其余命令执行时会顺带检查 npm 新版本：发现新版本时终端提示 + 手机推送（默认开启，见自动更新提醒）。