eogee/a4phone

README 摘要

a4phone DSH（DeepSeek Harness）/ Claude Code / Codex 远程手机交互包。通过 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 web profile，让 DeepSeek Harness 同样具备手机交互 - 远程续聊 ：守护进程监听主话题，手机发文字即可与当前会话交流，形成完整远程对话闭环（DSH / Claude Code / Codex） - DSH 远程续聊 ：手机发文字直接注入 DSH 正在运行的会话（ agent.followup ），手机消息与 AI 回复 实时出现在桌面端会话里 ，无需另起进程、无会话锁冲突 - 后台守护进程 ： a4p listen 无窗口后台运行，日志写入文件 - 自动更新提醒 ：守护进程周期检查 npm 新版本并 推送手机提醒 ；其他命令发现新版本时终端提示 + 手机推送（默认开启，可在配置关闭） - 双模式 ：外出模式（手机优先）/ 终端优先模式，一键切换 - 零第三方依赖 ：仅依赖 ntfy.sh 免费服务，无 Google 服务依赖 安装 使用 安装引导 a4p setup 自动完成： 1. 生成独一无二的话题名称（如 a4p-xxxx ），写入 /.a4phone/config.json 2. 在 /.claude/settings.json 注册三个 Hook（Stop / AskUserQuestion / PermissionRequest），并同时写入 /.codex/config.toml 的 Codex Hook（见下文 Codex 一节） 3. 检测到 DSH 环境时，把内置 dsh-hook 插件挂载到 /.dsh/profiles/web/cordis.patch.yml （见下文 DSH 一节） 4. 默认启动续聊守护进程 （ a4p listen 后台运行） 5. 默认注册开机自启 （Windows 启动文件夹写入隐藏 VBS，登录时自动运行守护进程） 6. 在终端显示二维码 然后用手机 ntfy A…

分类