Merge feature/conv-middleware into main for v0.3.3

Author: kylefu8

DEVLOG.md

@@ -244,3 +244,28 @@ New feature: conversation recording with a built-in conversation viewer. Records
 
 - GUI release: `v0.3.2`
 - Embedded proxy: upstream `main` @ `b162b63` (post-`v0.3.1`)
+
+## 2026-03-17 — v0.3.3 middleware refactor
+
+### Summary
+
+Refactored conversation recording from handler-level hooks to a single Hono middleware. This eliminates upstream merge conflicts when handler code changes, reducing fork maintenance from 4 modified files to 2 (1 new file + 2 lines in server.ts).
+
+### Architecture change
+
+- Replaced `conversation-log.ts` + 3 handler hooks with `conversation-middleware.ts`
+- Middleware intercepts requests/responses at the Hono layer, before/after handlers
+- Non-streaming: clones response and reads JSON
+- Streaming: uses `ReadableStream.tee()` to observe SSE chunks without affecting client delivery
+- Only `server.ts` modified (+2 lines: import + use), zero handler changes
+
+### Why
+
+- v0.3.2 handler hooks conflicted with upstream updates to the same files
+- Middleware approach means upstream can freely change handlers without affecting our conversation recording
+- Evaluated and rejected log-parsing approach (upstream logs truncate payloads to 400 chars, no full content)
+
+### Reference release
+
+- GUI release: `v0.3.3`
+- Embedded proxy: fork `conv-middleware` branch based on upstream `b162b63`

RELEASE_NOTES_TEMP.md

@@ -1,33 +1,37 @@
 # What's New / 新功能
 
-## 💬 Conversation Recording / 对话记录
+## Conversation Recording / 对话记录
 
-• Record full request/response content to local JSON files (streaming auto-assembled) / 完整记录请求与 AI 回复到本地 JSON 文件（流式自动拼接）
-• Built-in conversation viewer with session sidebar and message panel / 内置对话浏览器，左栏会话列表 + 右栏消息面板
-• Auto-detect client type: Claude Code, Cursor, Continue, Cline, etc. / 自动识别客户端来源：Claude Code、Cursor、Continue、Cline 等
-• Session grouping by client + model with 15-min idle timeout / 按客户端+模型分组会话，15 分钟空闲自动断开
-• Sessions organized by date (Today / Yesterday / older dates) / 会话按日期归类（今天 / 昨天 / 更早日期）
-• Full-text search with matching text highlight / 全文搜索，匹配文本高亮显示
-• Multi-select sessions + batch delete / 多选会话 + 批量删除
-• Real-time: new entries appear instantly in open viewer / 实时推送：新对话即时出现在已打开的浏览器中
-• Theme and language sync with main window / 配色与语言跟随主窗口实时切换
-• Toggle in Settings > Service Config (off by default, requires service restart) / 在 设置 > 服务参数 中开关控制（默认关闭，需重启服务生效）
+Refactored to middleware-based architecture for better upstream compatibility.
+重构为中间件架构，更好地兼容上游更新。
 
-## 🚀 UX / 体验优化
+- Record full request/response content to local JSON files (streaming auto-assembled) / 完整记录请求与 AI 回复到本地 JSON 文件（流式自动拼接）
+- Built-in conversation viewer with session sidebar and message panel / 内置对话浏览器，左栏会话列表 + 右栏消息面板
+- Auto-detect client type: Claude Code, Cursor, Continue, Cline, etc. / 自动识别客户端来源
+- Session grouping by client + model with 15-min idle timeout / 按客户端+模型分组会话，15 分钟空闲自动断开
+- Sessions organized by date (Today / Yesterday / older dates) / 会话按日期归类
+- Full-text search with matching text highlight / 全文搜索，匹配文本高亮显示
+- Multi-select sessions + batch delete / 多选会话 + 批量删除
+- Real-time: new entries appear instantly in open viewer / 实时推送：新对话即时出现在已打开的浏览器中
+- Theme and language sync with main window / 配色与语言跟随主窗口实时切换
+- Toggle in Settings > Service Config (off by default, requires service restart) / 在设置 > 服务参数中开关控制（默认关闭，需重启服务生效）
 
-• Reorder header buttons: Theme → Language → Conversations → Logs → Settings → About / 顶栏按钮重新排序：配色 → 语言 → 对话 → 日志 → 设置 → 关于
-• Fix settings checkbox alignment / 修复设置页面复选框对齐
+## Architecture Improvement / 架构改进
 
-## ⬇️ Download / 下载
+- Replaced handler-level hooks with a single Hono middleware / 将分散在各 handler 中的 hook 替换为统一的 Hono 中间件
+- Only 2 lines added to upstream `server.ts` (import + use) / 上游 server.ts 仅增加 2 行
+- Zero handler modifications = zero conflict risk with upstream updates / handler 零修改 = 与上游更新零冲突风险
+
+## Download / 下载
 
 | Platform | File | Note |
 | -------- | ---- | ---- |
-| Windows (Installer) | Copilot.Proxy.GUI-0.3.2-setup.exe | **Recommended** / 推荐，supports lightweight update / 支持轻量更新 |
-| Windows (Portable) | Copilot.Proxy.GUI-0.3.2-portable.exe | No installation needed / 无需安装，双击即用 |
-| macOS (Apple Silicon) | Copilot.Proxy.GUI-0.3.2-arm64.dmg | M1/M2/M3/M4 Mac |
-| macOS (Intel) | Copilot.Proxy.GUI-0.3.2-x64.dmg | Intel Mac |
+| Windows (Installer) | Copilot.Proxy.GUI-0.3.3-setup.exe | **Recommended** / 推荐，supports lightweight update / 支持轻量更新 |
+| Windows (Portable) | Copilot.Proxy.GUI-0.3.3-portable.exe | No installation needed / 无需安装，双击即用 |
+| macOS (Apple Silicon) | Copilot.Proxy.GUI-0.3.3-arm64.dmg | M1/M2/M3/M4 Mac |
+| macOS (Intel) | Copilot.Proxy.GUI-0.3.3-x64.dmg | Intel Mac |
 
-> macOS first launch / macOS 首次启动: Right-click the app → Open → click "Open" in the dialog. If blocked, go to System Settings → Privacy & Security → click "Open Anyway".
-> 右键点击应用 → 打开 → 在弹窗中点击"打开"。如被阻止，前往系统设置 → 隐私与安全性 → 点击"仍要打开"。
+> macOS first launch / macOS 首次启动: Right-click the app > Open > click "Open" in the dialog. If blocked, go to System Settings > Privacy & Security > click "Open Anyway".
+> 右键点击应用 > 打开 > 在弹窗中点击"打开"。如被阻止，前往系统设置 > 隐私与安全性 > 点击"仍要打开"。
 
-Full Changelog: [v0.3.1...v0.3.2](https://github.com/kylefu8/copilot-proxy-gui/compare/v0.3.1...v0.3.2)
+Full Changelog: [v0.3.2...v0.3.3](https://github.com/kylefu8/copilot-proxy-gui/compare/v0.3.2...v0.3.3)

copilot-proxy

@@ -1,7 +1,7 @@
 {
   "name": "copilot-proxy-gui",
   "private": true,
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Desktop GUI for copilot-proxy — Electron + React + Vite",
   "type": "module",
   "main": "electron/main.cjs",