first commit

CHANGELOG.md

@@ -0,0 +1,281 @@
+# Changelog
+
+本文件提供连续版本索引，便于快速查看版本演进。
+
+- 详细发布说明见 `release.md`。
+- 若 `release.md` 未单列某个 `vx.y.0`，则按 `history.md` 与 git 历史，按“约每 3 小时补一个 minor 版本”的规则补齐。
+- `x.y.z` 的 patch 空档不额外补齐；历史补齐版本只用于保持序列连续，详细内容以后续正式版本口径为准。
+
+## v3.0.1
+
+日期：`2026-03-20`
+
+- 当前版本主要收口使用手册与主题文案：
+  - 小程序“使用手册”补成图文版，正文前置“为什么需要这个APP？”，并接入 `guide-mobile-*` 配图；
+  - 小程序主题预设补齐到与 Web 一致的 `21` 套，主题名称支持随语言切换，并统一压短为更易读的单词标签。
+- 版本口径统一升级到 `v3.0.1`：
+  - 发布说明、根 README、小程序 README、项目介绍、相关方案文档与品牌模板统一同步到当前版本。
+- 当前版本不引入新的同步协议、终端协议或配置字段，继续沿用 `v3.0.0` 已明确的能力边界。
+
+## v3.0.0
+
+日期：`2026-03-18`
+
+- 小程序终端补上 caret 稳定化：
+  - 高压 `stdout` 输出期间会优先保留最近稳定 caret，减少底部后几行行尾来回跳动；
+  - 最终帧与用户输入相关帧仍会强制提交最新 caret，避免稳定化把真实位置长期冻结。
+- 小程序 shell 输入焦点补上被动 `blur` 保护：
+  - 当软键盘仍保持可见时，页面不会因为临时 `blur` 立即判定失焦；
+  - 豆包输入法长按语音输入过程中，不应再被页面侧主动打断语音录入。
+- 小程序终端 perf 日志默认改为关闭：
+  - 当前仍保留部分性能遗留问题，常态不再持续输出 `perf.summary / perf.snapshot`；
+  - 调试性能问题时，可通过现有开关临时打开日志收集现场。
+- 版本口径统一升级到 `v3.0.0`：
+  - 发布说明、根 README、小程序 README、Web / 小程序关于页、多语言文案、小程序工程描述与当前基线文档统一同步到当前版本。
+
+## v2.9.6
+
+日期：`2026-03-13`
+
+- 当前版本仅做文档与对外口径同步：
+  - 不引入新的功能、协议行为或交互变更；
+  - 继续沿用 `v2.9.5` 已完成的现有终端、同步与时延诊断能力，以及当前语音播报边界口径。
+- 版本口径统一升级到 `v2.9.6`：
+  - 发布说明、根 README、小程序 README、Web/小程序关于页、多语言文案、项目描述、小程序工程描述与当前基线文档统一同步到当前版本。
+
+## v2.9.5
+
+日期：`2026-03-13`
+
+- 当前版本仅做文档与对外口径同步：
+  - 不引入新的功能、协议行为或交互变更；
+  - 继续沿用 `v2.9.4` 已完成的现有终端、同步与时延诊断能力。
+- 新登记一条小程序终端语音播报遗留问题：
+  - 当前播报文本提取与轮次稳定判定仍不够准确，播报内容存在偏差；
+  - 长时间 `Codex` 交互时，语音播报链路还会放大小程序端的响应压力；
+  - 现阶段先不建议默认使用，后续继续优化文本提取、触发时机与性能隔离。
+- 版本口径统一升级到 `v2.9.5`：
+  - 发布说明、根 README、小程序 README、Web/小程序关于页、多语言文案、项目描述、小程序工程描述与当前基线文档统一同步到当前版本。
+
+## v2.9.4
+
+日期：`2026-03-12`
+
+- 当前版本仅做文档与对外口径同步：
+  - 不引入新的功能、协议行为或交互变更；
+  - 继续沿用 `v2.9.3` 已完成的时延诊断面板与主题对比度收口结果。
+- 版本口径统一升级到 `v2.9.4`：
+  - 发布说明、根 README、小程序 README、Web/小程序关于页、多语言文案、项目描述、问题闭环记录与当前基线文档统一同步到当前版本。
+
+## v2.9.3
+
+日期：`2026-03-11`
+
+- 小程序时延诊断面板完成一轮结构收口：
+  - 原先分离的“网关响应 / 网络时延”两张图已合并成一张双轴平滑曲线图；
+  - 左轴保留网关响应量纲，右轴保留网络时延量纲，顶部摘要卡统一收口为两行 `min / max / avg`。
+- 诊断浮窗进一步简化：
+  - 原“诊断信息”文字卡已删除，只保留图表卡；
+  - 同一服务器断开重连后会优先延续已有采样，尽量补足最近 `30` 个点。
+- 小程序终端主题适配继续收口：
+  - 时延面板改为跟随终端主题的反相面板；
+  - 深色终端单独切换一套更深的蓝橙曲线与指标色，避免浅底上文字与曲线发灰看不清。
+- 版本口径统一升级到 `v2.9.3`：
+  - 发布说明、根 README、小程序 README、关于页、当前基线文档与问题闭环记录统一同步到当前版本。
+
+## v2.9.1
+
+日期：`2026-03-11`
+
+- 小程序终端会话续接恢复继续收口：
+  - 首次恢复优先使用保存时的 `lines + bufferCols / bufferRows` 还原当前屏幕；
+  - 被裁剪的 `replayText` 仅保留给后续真实几何变化时重建使用，避免再次出现历史区顶部空白和裸露 `5;2H`。
+- 小程序启动阶段 `bootstrap` 合并配置完成后，首页服务器列表与底栏会立即刷新，不再需要重进页面才看到同步后的配置。
+- 小程序用户隐私政策与 about 隐私页已同步到最新审核口径，补齐录音用途、处理范围与用户权利说明。
+- 版本口径统一升级到 `v2.9.1`：
+  - 发布说明、根 README、小程序 README、关于页、当前基线文档与问题闭环记录统一同步到当前版本。
+
+## v2.9.0
+
+日期：`2026-03-11`
+
+- 小程序终端已修复 `Codex` 交互期间底部提示块缺行与闪动问题：
+  - normal buffer viewport 不再把光标行之后仍真实存在的 footer 误裁掉；
+  - `CSI ? 2026 h/l` 同步刷新窗口已做收口，减少重绘中间态直接暴露到界面；
+  - `Codex` 持续输出时，底部提示块与状态行的可见性和稳定性明显提升。
+- 小程序终端统一高亮背景行改为优先在 line 层绘制：
+  - `> Use /skills to list available skills`、代码块与同类整行高亮区域不再在行与行之间透出底色细线；
+  - 该调整未增加渲染节点，统一背景场景下反而减少了 segment 级背景重复绘制。
+- 新增真实 PTY 抓包回放用例，补齐 footer 保留与同步刷新窗口相关回归测试。
+- 小程序终端会话续接恢复口径已修正：
+  - 首次恢复优先使用保存的 `lines + bufferCols / bufferRows` 还原当前屏幕；
+  - 被裁剪的 `replayText` 仅保留给后续真实几何变化时重建使用，避免再次出现历史区顶部空白和裸露 `5;2H`；
+  - 新增终端快照几何持久化测试，锁住该回归场景。
+- 版本口径统一升级到 `v2.9.0`：
+  - 发布说明、根 README、小程序 README、关于页、当前基线文档与问题闭环记录统一同步到当前版本。
+
+## v2.8.2
+
+日期：`2026-03-10`
+
+- 小程序服务器列表 `connect` 按钮与底栏 `shell` 按钮在存在活动连接时统一改为高饱和实底高亮，不再依赖描边反馈。
+- 连接态 SVG 前景色改为运行时跟随界面前景色，保证高亮底色上的图标对比度。
+- about 首页、详情页与 about-app 改为按界面配置推导配色；Web about 页同步切到同一套主题变量策略。
+- 新登记一条 about 反馈遗留问题：当前“反馈”按钮仍只复制邮箱地址，暂不支持直接拉起系统发送邮件组件。
+- 发布说明、根 README、小程序 README、关于页、项目描述与当前基线文档统一更新到 `v2.8.2`。
+
+## v2.8.1
+
+日期：`2026-03-10`
+
+- 小程序终端语音区视觉继续收口：展开按钮默认全透明，仅保留 SVG 本体；分类胶囊改为贴文字高度，录音中输入框上方新增更显眼的双环脉冲提示。
+- 录音提示文案更新为“正在收音，松开后发送或记录闪念”；松开本身仍只结束本轮输入，不自动发送。
+- 小程序终端 VT 语义继续修正：`OSC 10 / 11 / 12` 返回真实 shell 主题色，`alt screen` 与 `CSI J / K / X` 擦除空白位统一继承当前擦除背景。
+- 此前点击 Codex 连接选项后的首回显迟滞与等待期间按钮阻塞问题已收敛，当前版本不再将其列为遗留问题。
+- 新登记一条低频终端遗留问题：偶发新连接后首屏只显示光标、提示符稍后才出现；后续需继续优化连接就绪判定与 prompt 首屏兜底。
+- 发布说明、根 README、小程序 README、关于页与当前基线文档统一更新到 `v2.8.1`。
+
+## v2.7.1
+
+日期：`2026-03-10`
+
+- 文档与关于页版本口径统一升级到 `v2.7.1`，补齐同步 SQLite 的当前边界说明。
+- 明确 `remoteconn-sync.db-wal` 属于 SQLite 写前日志，文件体积不直接等于当前有效同步数据量；checkpoint 后数据会回写主库。
+- 当前跨设备同步仍仅覆盖 `settings / servers / records`；其中服务器受保护字段继续以加密后的 `secret_blob` 保存，日志、插件运行时日志与终端会话缓冲仍保留本地。
+- 当前小程序终端仍存在明显交互卡顿：点击 Codex 连接选项后约 10 秒才出现回显，等待期间除上下滑动外其余按钮基本阻塞，暂列为当前遗留问题。
+
+## v2.7.0
+
+日期：`2026-03-09`
+
+- 小程序设置、服务器配置与闪念记录接入 `Gateway + SQLite` 双层持久化，支持同一微信账号跨设备恢复数据。
+- 同步链路补齐 `bootstrap` 与 `settings / servers / records` 增量推送；服务器和闪念删除支持 `tombstone` 合并。
+- SSH 密码、私钥、口令与证书等受保护字段改为服务端加密保存；终端会话缓冲仍不纳入第一阶段同步范围。
+
+## v2.6.6
+
+日期：`2026-03-09`
+
+- 文档口径统一更新到 `v2.6.6`。
+- 将“通过 `npm run mini` 生成的 preview 预览包，不作为正式版本地缓存连续性验证依据”记录为当前遗留问题。
+- 小程序仍以本地 storage 持久化业务数据，后续再补更直接的调试与备份能力。
+
+## v2.6.5
+
+日期：`2026-03-08`
+
+- 小程序终端 VT P0 基线收口，补齐双缓冲、备用屏幕切换、`DSR / CPR / DA1 / DA2 / DECSTR` 与基础局部重绘。
+- 修复 normal buffer 的 live tail 与滚动边界问题，并同步更新当前文档基线到 `v2.6.5`。
+
+## v2.6.1
+
+日期：`2026-03-08`
+
+- 将“修改字号后偶发吃字/显示不完整”收口为已知遗留问题，并在设置页增加“修改字号后建议断开重连”提示。
+- 收敛数字输入、字体回退与设置页容错逻辑，移除排查阶段的 `terminal.wrap` 调试输出。
+
+## v2.6.0
+
+日期：`2026-03-07`
+
+- 小程序补齐跳转主机、AI 快速启动、后台续接与连接反馈等主链路能力。
+- 小程序继续补齐终端可用性细节：光标位置计算修复，AI 启动链路正式落地到小程序端。
+- SSH relay / 跳板机链路从“可配置”推进到“可经 A 主机直接转发连接 B 主机”。
+- 文档口径统一升级到 `v2.6.0`，并将历史 `v2.4.0` 说明并入当前对外版本。
+
+## v2.5.0（历史补齐）
+
+日期：`2026-03-07`
+
+- 依据 `v2.3.0 -> v2.6.0` 之间的历史记录，按 3 小时一个 minor 版本的规则补齐。
+- 该阶段主要是 `v2.6.0` 之前的小程序终端链路收口与 AI、跳板机场景串联，详细内容已并入 `v2.6.0`。
+
+## v2.4.0（历史补齐）
+
+日期：`2026-03-07`
+
+- `history.md` 中明确出现 `版本号v2.4.0`，后续在 `v2.6.0` 中并档处理。
+- 该阶段集中于小程序终端光标、列宽与 cell 模型重构，以及相关分析文档沉淀，详细内容已并入 `v2.6.0`。
+
+## v2.3.0
+
+日期：`2026-03-06`
+
+- 小程序完成一轮大范围能力对齐，补齐 `connect / server settings / terminal / logs / records / settings / plugins` 主页面链路。
+- Web 端继续精修交互与稳定性，文档口径统一到 `v2.3.0`。
+
+## v2.2.0
+
+日期：`2026-03-06`
+
+- 闪念增强定稿，补齐分类、编辑、搜索、过滤、快速改分类与上下文快照。
+- 全局配置补齐闪念分类治理、默认分类与拖拽排序。
+
+## v2.1.0（历史补齐）
+
+日期：`2026-03-01`
+
+- 依据 `v2.0.0 -> v2.2.0` 之间的历史记录，按 3 小时一个 minor 版本的规则补齐。
+- 该阶段主要完成小程序连接页、服务器配置页、远程目录选择与基础对齐链路，为 `v2.2.0` 的记录增强和 `v2.3.0` 的大范围对齐打底。
+
+## v2.0.0
+
+日期：`2026-02-27`
+
+- 语音输入交互对齐 Figma，闪念记录闭环上线。
+- 日志与记录分页、资源缓存治理、文档与发布规范同步统一。
+- 语音层与键盘工具层的命中区继续收敛，修复工具栏被误判为外部点击后自动折叠的问题。
+
+## v1.1.0
+
+日期：`2026-02-26`
+
+- 终端语音输入全链路、Gateway ASR 代理与 Web 稳定性增强。
+- 终端输入增强为“原生 textarea + 语音输入面板 + 发送确认”组合，并补入 `TAB` 辅助键。
+- 路由懒加载失败增加自动恢复，缩放防护补齐到 `double-tap / dblclick` 等路径。
+
+## v1.0.9
+
+日期：`2026-02-25`
+
+- 连接体验治理、服务器列表拖拽排序与移动端防误触优化。
+- 连接与服务器管理继续收敛：支持连接重试次数与分组；新增服务器改为先进入配置页，未改动不落库。
+- 导航与配置页体验统一：返回语义按历史栈处理，终端配置页增加预览块，配置页 UI 完成一轮重构。
+- 终端工具与视觉细节补齐：新增 `paste` 辅助按钮，修复字体选择，补齐夜间模式与重连提示样式。
+- 会话恢复体验补强：同连接历史可延续，刷新“我的服务器”页默认不主动断开现有会话。
+
+## v1.0.8
+
+日期：`2026-02-24`
+
+- 配置中心稳定性、深浅色模式与网关 runtime 配置落地。
+- 配置中心结构重组：服务器基础/认证绑定到当前服务器，终端/主题/安全切到全局配置。
+- 配置与工具区交互继续收敛：点击外部区域可折叠右下角键盘工具条，Figma 配置区交互并入当前基线。
+- 终端提示文案与初始化输出治理：连接提示更友好，中文输入初始化命令回显默认不展示。
+
+## v1.0.6
+
+日期：`2026-02-24`
+
+- Console 触摸工具区可点击性与误触防护优化。
+
+## v1.0.5
+
+日期：`2026-02-23`
+
+- iPhone 触摸滚动动量阶段性优化。
+
+## v1.0.3
+
+日期：`2026-02-23`
+
+- iOS 触摸焦点状态机稳定性修复。
+
+## v1.0.1
+
+日期：`2026-02-23`
+
+- 生产架构版稳定性更新，确立 Web、Gateway 与插件运行时的多包工程基线。
+- 补齐多服务器与多认证方式管理，最近连接日志可追溯。
+- Codex 模式主链路可用：连接后自动切目录并启动 `codex`。
+- 主题与界面自定义基础能力上线，含字体、配色与基础配置中心。