本文章以流水线式记录 a4phone 从 1.0.0 到当前版本（1.4.2）的完整演进过程：按版本从新到旧逐版本列出新增功能（feat）、问题修复（fix）与行为变化，并标注每个版本引入的能力所对应的功能文档，方便按版本追溯功能来源。

1. 版本演进总览

版本线 主题 时间
1.0.0 远程手机交互初版（Claude Code） 2026-08-06
1.1.x Codex 支持、包名整理 2026-08-06
1.1.5 远程续聊主话题 + 后台守护进程 2026-08-08
1.1.6 DSH 插件挂载 2026-08-14
1.1.7 多选项降级作答 2026-08-15
1.2.0 DSH 会话远程续聊 2026-08-15
1.2.1 续聊积压合并与持久化 2026-08-15
1.3.0 自动更新提醒 2026-08-16
1.4.0 默认守护进程 + 开机自启 2026-08-16
1.4.1 纯数字回复修复 2026-08-16
1.4.2 浏览器链接兜底 + 更新检查修复 2026-08-16

2. 版本明细

1.4.2 — 浏览器链接兜底 + 更新检查修复（2026-08-16）

  • 新增：提问推送附带响应话题浏览器链接兜底——未订阅响应话题的用户也可打开网页版直接回复（自由作答 / 编号回复均支持）
  • 修复：更新检查本地版本升级后忽略限频立即检查——避免旧缓存把升级后的首次检查推迟一整个间隔（缓存新增 version 字段）

对应文档：AI提问交互、自动更新提醒。

1.4.1 — 纯数字回复修复（2026-08-16）

  • 修复：纯数字自由文本（如编号回复「4」）被 JSON.parse 误判为 JSON 对象而丢失——ntfy 消息解析区分 JSON 对象与原始值，纯数字按文本返回

对应文档：AI提问交互。

1.4.0 — 默认守护进程 + 开机自启（2026-08-16）

  • 新增：a4p setup 默认启动续聊守护进程（无需手动 a4p listen）
  • 新增：Windows 开机自启——启动文件夹写入隐藏 VBS，登录时自动运行守护进程；新命令 a4p autostart（--on / --off / 状态），无需管理员权限
  • 新增：更新提醒命令级也推手机——a4p status / a4p resume 等命令发现新版本时终端提示 + 手机推送（与守护进程共用去重缓存）
  • 变更：a4p uninstall 一并移除守护进程与开机自启

对应文档：后台守护进程与开机自启、自动更新提醒。

1.3.0 — 自动更新提醒（2026-08-16）

  • 新增：版本更新检查——守护进程启动时及每 updateIntervalHours 小时（默认 6）查询 npm registry（npmmirror 优先、官方兜底），发现新版本推送手机提醒
  • 新增：限频与去重（同一新版本只提醒一次，缓存 ~/.a4phone/update-cache.json）
  • 新增：checkUpdates / updateIntervalHours 配置项

对应文档：自动更新提醒。

1.2.1 — 续聊积压合并与持久化（2026-08-15）

  • 修复：续聊积压合并——忙时到达的手机消息合并为一个批次一次性续聊（不再逐条排队），任意数量积压最多只多产生一个续聊轮次
  • 新增：积压批次持久化到 ~/.a4phone/pending-batch.json，守护进程重启/崩溃后自动恢复，不丢消息
  • 修复：排空循环修复，批次处理不会停顿

对应文档：远程续聊。

1.2.0 — DSH 会话远程续聊（2026-08-15）

  • 新增：DSH 远程续聊——手机文字经文件队列交给 dsh web 进程内的插件，agent.followup 直接注入桌面正在运行的同一个会话，手机消息与 AI 回复实时出现在桌面会话里，无会话锁冲突
  • 新增：文件队列协议（~/.a4phone/dsh-jobs/）与心跳检测（dsh-heartbeat.json），dsh web 未运行快速失败而非干等超时

对应文档：DSH支持与插件挂载。

1.1.7 — 多选项降级作答（2026-08-15）

  • 修复：提问选项超过 3 个时（ntfy 按钮上限）自动降级为文本编号列表 + 文字作答，回复对应编号即可选中选项

对应文档：AI提问交互。

1.1.6 — DSH 插件挂载（2026-08-14）

  • 新增：a4p setup 检测到 DSH 环境时自动把内置 dsh-hook 插件挂载到 web profile 的 cordis.patch.yml，DeepSeek Harness 获得任务完成通知、提问作答、权限审批手机交互
  • 新增：Codex 续聊 fork——会话被窗口占用时自动 fork 成新线程续聊，无需关闭原窗口
  • 新增：状态文件目录化（统一迁移到 ~/.a4phone/）、卸载清理

对应文档：DSH支持与插件挂载。

1.1.5 — 远程续聊主话题 + 后台守护进程（2026-08-08）

远程续聊能力正式成型：

  • 新增：续聊守护进程从独立 {topic}-cmd 话题改为监听主话题——手机向订阅的通知话题发文字即可续聊，无需额外话题
  • 新增：a4p listen 后台守护进程模式（无窗口、日志写文件）
  • 新增：Claude Code 续聊（claude --resume <会话> --continue -p）与 Codex 续聊（codex exec resume）

对应文档：远程续聊、后台守护进程与开机自启。

1.1.x — Codex 支持与包名整理（2026-08-06）

  • 新增：a4p setup 自动写入 Codex 配置（~/.codex/config.toml），支持 Codex 的 request_user_input 提问与 Hook 触发
  • 新增：a4p setup 报告 Claude Code 与 Codex 双向配置状态
  • 新增：通知标题按触发方动态显示（Claude Code / Codex）
  • 新增：a4p --version 与 a4p help 命令
  • 变更：包名曾尝试改为 @eogee/a4phone 作用域包，最终回退为 a4phone 并发布 1.1.3
  • 修复：AskUserQuestion 触发的 PermissionRequest 直接放行，不再推送冗余原始 JSON

1.0.0 — 远程手机交互初版（2026-08-06）

a4phone 首个版本，基于 Claude Code Hook 实现远程手机交互：

  • 新增：a4p setup 安装引导，生成话题、注册 Claude Code Hook、显示订阅二维码
  • 新增：任务完成通知——Stop 事件触发电脑弹窗 + 手机推送（含 AI 最后输出）
  • 新增：AI 提问交互——AskUserQuestion 推送到手机点选作答
  • 新增：权限请求交互——PermissionRequest 手机 Approve / Deny
  • 新增：a4p out / a4p home 双模式切换

对应文档：任务完成通知、AI提问交互、权限请求交互、双模式切换。

3. 升级说明

  • 升级命令：npm install -g a4phone
  • 升级后建议重启续聊守护进程：a4p listen --stop && a4p listen
  • 若插件代码有更新（DSH），建议重启 dsh web 使新插件代码生效
  • 配置与状态文件向后兼容，升级无需重新配置；新功能（如开机自启、更新提醒）随新版本代码生效