A4phone — AI skill for Claude Code


a4phone

DSH（DeepSeek Harness）/ Claude Code / Codex / ZCode 远程手机交互包。通过 [ntfy.sh](https://ntfy.sh) 在手机上接收任务完成通知（含 AI 最后输出），对 AI 提问与权限请求进行远程点选或文字作答，并可从手机直接继续对话。

功能

• 任务完成通知：Stop 事件（DSH 为 turn/end）→ 电脑弹窗 + 手机推送，包含 AI 最后输出的一段话
• AI 提问交互：AskUserQuestion（Codex 为 request_user_input，DSH 为 ask_user_question）→ 手机显示选项按钮点选，也可直接发送文字自由作答
• 权限请求交互：PermissionRequest → 手机 Approve/Deny/Always Approve
• DSH 一键挂载：a4p setup 自动把内置 dsh-hook 插件挂到 DSH 全部已装 profile（web / tui / dsh-tui 等），守护进程周期扫描、新装 profile 自动补挂，让 DeepSeek Harness 同样具备手机交互
• 远程续聊：守护进程监听主话题，手机发文字即可与当前会话交流，形成完整远程对话闭环（DSH / Claude Code / Codex / ZCode）
• DSH 远程续聊：手机发文字直接注入 DSH 正在运行的会话（agent.followup），手机消息与 AI 回复实时出现在桌面端会话里，无需另起进程、无会话锁冲突
• 后台守护进程：a4p listen 无窗口后台运行，日志写入文件
• 桌面弹窗守护进程代发：提问 / 权限请求 / 任务完成的电脑弹窗统一由常驻守护进程弹出（hook 进程——尤其 ZCode——退出时会被执行端口杀掉整棵进程树，hook 内直接弹来不及显示；守护进程在进程树之外，稳定可靠且不增加 hook 延迟）
• 自动更新提醒：守护进程周期检查 npm 新版本并推送手机提醒；其他命令发现新版本时终端提示 + 手机推送（默认开启，可在配置关闭）
• 双模式：外出模式（手机优先）/ 终端优先模式，一键切换
• 零第三方依赖：仅依赖 ntfy.sh 免费服务，无 Google 服务依赖

安装

npm install -g a4phone

使用

a4p setup        # 安装引导：生成话题、注册 Hook、启动守护进程、注册开机自启、显示二维码
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         # 显示帮助

安装引导

`a4p setup` 自动完成：

1. 生成独一无二的话题名称（如 a4p-xxxx），写入 ~/.a4phone/config.json
2. 在 ~/.claude/settings.json 注册三个 Hook（Stop / AskUserQuestion / PermissionRequest），同时写入 ~/.codex/config.toml 的 Codex Hook（见下文 Codex 一节）与 ~/.zcode/cli/config.json 的 ZCode Hook（见下文 ZCode 一节）
3. 检测到 DSH 环境时，把内置 dsh-hook 插件挂载到 ~/.dsh/profiles/ 下**所