phone-lens 1.1.2 → 1.1.4

package/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+版本号三处联动：host `package.json` ↔ App `pubspec.yaml`（三段 = tag，build number 只增不减）↓ Release tag。App 版本号必须与 Gitee release tag 同步 bump，否则手机端会反复弹"发现新版本"。
+
+## 1.1.4（2026-11-03）
+
+- **新增：推流画质四档可调（App 端）**。设置 → 拍摄与上传 → 推流画质：极低（320P 8fps）/ 低（480P 10fps）/ 中（默认，640P 10fps，与升级前取景画质一致，跟随电脑端下发参数）/ 高（720P 10fps）。仅影响电脑端实时取景，不影响拍摄照片画质（照片仍由"上传画质"决定）；切换下一帧即生效，无需重启预览或重连；帧协议不变（裸 JPEG 二进制），host 与 Web UI 零改动，新老版本双向兼容，无需版本门槛。推流画质存独立档位键，不被电脑端下发的预览参数在重连时覆盖（"中"档则严格采用下发值）。
+- **修复：会话追踪数据面与宿主真实状态脱节（热重载补漏）**。`agent/created` 只在 agent 创建瞬间派发一次（无回放，cordis 事件无 retain），插件（重）加载晚于会话创建时内部存活表/活跃目标为空。现在声明 `agents` 服务依赖，服务就绪后枚举 `ctx.agents.list()` 回填：运行中的会话立即成为投递目标（与 `agent/status`→running 同语义），空闲会话进入存活表（pinned 目标模式可解析）；无 agents 服务的环境（standalone/dev）自动跳过，任何回填异常都不影响接收服务。
+- devDependencies 对齐宿主实际运行版本并钉死精确版本（cordis 4.0.5、dsh-llm 0.2.1-rc.4、dsh-tools 0.2.1-rc.4、schemastery 3.18.5），类型参考与 0.2.1 一致；peerDependencies 范围不变。
+- 文档勘误（docs/dsh-caps.md、docs/architecture.md）：移除对 0.1.7 已删除 `agent/session-start` 事件的引用；补记 live ctx 事件（`dsh-agent-loop` 派发）与持久会话日志事件（`agent/inbox/spliced`）的两层模型，防止按单包检索误判事件死活。
+
+## 1.1.3（2026-10-16）
+
+- **新增：前后置镜头切换（双端）**。手机端取景器右上角新增镜头切换按钮（单摄设备自动隐藏，切换中转圈）；电脑端新增模型工具 `phone_camera_lens`——`lens` 传 "front"/"back" 切换镜头，不带参数查询当前镜头与设备可用镜头（工具对相机关闭的手机同样可用：仅记录偏好，下次开启生效）。需手机端 ≥ 1.1.3，沿用三档失败判定。
+- **精简：`phone_camera_zoom_info` 并入 `phone_camera_zoom`**——不带参数调用 zoom 即查询当前倍数与支持范围（手机端早已支持，纯工具层冗余）；工具总数 7→6。`phone_camera_pause`/`resume` 审查后保留独立（反义动作直命名对模型更清晰）。
+- **修复：悬浮面板弹出方向左右反了**——球靠左时面板向左弹出被屏幕裁掉（水平侧判定与锚点类语义相反），现已按"空间大的一侧展开"正确选择。
+
+- **悬浮球可拖拽、可调大小**：按住悬浮球可拖到屏幕任意位置（自动限制在视口内，窗口缩放后自动收回）；设置页新增"悬浮球"分组——三档大小、四角停靠（左上/右上/左下/右下）、锁定位置防误拖、一键恢复默认。取景面板/重命名/下载码弹层会根据悬浮球位置与面板实际高度智能选择弹出方向（上下左右四向），弹出动效随之适配。
+- **保存文件夹改为浏览选择**：拍照模式选"注入并保存/仅保存"后，目录输入旁新增"浏览…"按钮，弹出资源管理器式文件夹选择框（上级/主目录/盘符切换、逐级进入、选完即存）。手输/粘贴路径仍然可用。浏览器网页拿不到系统目录选择对话框的绝对路径，故由接收端（loopback 专属接口）遍历目录树提供。
+- **设置页重构**：官方设置页（设置 → PhoneLens）整理为三张卡片——"模型相机工具"（启用/免确认开关 + 工具清单说明）、"悬浮球"、"连接"。接收端口从悬浮窗 ⚙ 面板移入设置页（保存即时生效，无需刷新）；悬浮窗 ⚙ 只保留高频的拍照模式与保存目录。
+- **修复：变焦/暂停工具间歇误报"手机 App 版本过旧"**。手机 WS 重连后 host 端把相机元数据重置，而 App 版本只随预览流启动的 hello 上报——预览关闭或重连后的秒级窗口内，版本门槛读到空值，把正当版本的手机误判为过旧。现在失败原因分三档（没有已连接的手机 / 刚重连握手尚未完成 / 真版本不足），门槛检查前短暂等待（≤1 秒），App 端连接建立即上报版本（新 `app_info` 消息，不再绑定预览流启动）。
+- **安全：HTTP 与 WebSocket 全面校验 Host 头（DNS rebinding 防护）**。合法客户端一律以 IP 字面量或 localhost 访问，域名形式或缺失的 Host 头一律 403 拒绝。
+- 补齐 CHANGELOG（0.3.6 起此前全部缺失）。
+
+## 1.1.2（2026-10-12）
+
+- 模型变焦双工具：`phone_camera_zoom`（设定/步进）与 `phone_camera_zoom_info`（查询倍率与范围），直接驱动手机原生变焦。
+- 修复：扫码配对成功后 socket 未即时重建（ValueKey 恒定导致不重连），现随 host/port/deviceId/token 变化自动 rebind。
+- 三路并行审查后约 31 项修复，含上传队列体积膨胀三路径（孤儿文件、切模式清存量、failed 队列上限 20）。
+
+## 1.1.1（2026-10-08）
+
+- 幽灵回调守卫：被替换连接的迟到消息不再污染新连接的心跳、指令与状态。
+- wifi 掉线渲染为"连接丢失"（offline）而非"预览关闭"：帧停 + 应用层保活同停才判离线，双条件防误判。
+- Gitee APK 附件双后缀（`.apk.apk`）宽容匹配。
+
+## 1.1.0（2026-10-05）
+
+- 模型相机工具：`phone_take_photo`（拍照直达模型上下文，不落用户所选拍摄模式）、`phone_camera_pause` / `phone_camera_resume`（收起/唤醒手机相机）。
+- 取景器双指缩放与闪光灯开关；裁剪笔画与马赛克涂鸦。
+- 上传队列与画质档位（低/中/高）；远程拍照手机端震动提醒。
+
+## 1.0.3（2026-10-04）
+
+- 互唤醒心跳治半开 TCP（wifi 切换/宿主休眠后连接假死）：应用层 ping/pong 自举协商，兼容不带心跳的老版本宿主。
+- 设置页返回卡顿修复（tab 感知的相机重开时机）。
+- APK 精简为 arm64-only（约 25MB）；默认画质改为"中"；移除颜色校正。
+
+## 1.0.2（2026-09-30）
+
+- APK 下载链接改由 Gitee latest-release API 动态解析，宿主端不再需要逐版本改常量。
+
+## 1.0.1（2026-09-30）
+
+- 修复：二维码中的 APK 链接仍指向 Gitee v0.3.11 资产。
+
+## 1.0.0（2026-09-30）
+
+- APK 从 70MB 瘦身至 44MB；设置收纳为统一设置页；空闲自动关闭相机；启动时检查更新角标；历史照片自动清理。
+
+## 0.3.11（2026-09-30）
+
+- 手机端上传队列（断网排队、恢复后串行补传）；画质档位；`/upload` 幂等（uploadId 重试不重复入库）。
+- 重连稳定性修复；应用内更新检查（Gitee latest + 24h 节流）。
+
+## 0.3.10（2026-09-30）
+
+- 适配 dsh 0.2.0 官方桌面端：peer 依赖版本范围放宽，`dsh-app://` 来源加入 CORS 白名单。
+
+## 0.3.9（2026-09-29）
+
+- APK 下载二维码指向 Gitee v0.3.8 资产。
+
+## 0.3.8（2026-09-29，仅 App）
+
+- 手机端全面审计修复：上传链路、状态机与提示文案。
+
+## 0.3.7（2026-09-29）
+
+- 拍摄模式（composer / folder / both）；预览关闭状态识别；手动触发二维码轮换修复。
+
+## 0.3.6（2026-09-28）
+
+- 取景画面旋转跟随手机物理握持方向，照片按所见即所得烘焙旋转。
+- 适配 dsh 0.1.7-rc.2：`agent/created` 事件与基于 paste 事件的 composer 注入。
+
+## 0.3.5（2026-09-20）
+
+- 回退 0.3.3/0.3.4 的实验性投递模式，自 0.3.2 稳定线继续。