@liguoshuai/pi-web-chat 2.0.0 → 2.2.0

package/docs/CHANGELOG.md

@@ -7,6 +7,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.2.0] - 2026-08-30
+
+### Fixed & Improved
+- **服务端会话路径解析与遍历安全加固 (Session Path Resolution & Security)**：
+  - 修复了 `/api/session`（GET 与 DELETE）在处理会话相对路径时由于错误相对路径基准导致的误拦截（403 Forbidden），增强为相对于 `config.sessionsDir` 的安全解析并保留严格的路径越界校验与符号链接真实路径防穿透防护。
+  - 会话扫描增强为多层级安全目录递归遍历（`listAllSessionFiles`），支持更深的会话目录结构与符号链接解析。
+  - 为服务端 `sessionMetadataCache` 增加 LRU/最大条目上限限制（5000条），防止长期运行内存泄漏。
+- **服务端网关稳健性与跨平台优化 (Gateway Robustness & Cross-Platform)**：
+  - 完善了 WebSocket 握手鉴权响应对请求 `id` 的透传关联，优化了 `PING`/`heartbeat` 的 ID 支持。
+  - 规范了 `PROMPT` 消息中的 `message` 字符串与 `images` 数组格式，防止向 Pi 进程传递 `undefined`。
+  - 改进了 SSE 客户端异常断开时的错误捕获与失效监听器及时清理。
+  - 增强了 `resolvePiBin` 的跨平台检测路径，支持 macOS Homebrew、Linux `~/.local/bin`、`~/.cargo/bin` 等常见环境。
+- **Web 端多端同步与渲染优化 (Web UI & Markdown Rendering)**：
+  - 修复了 `remote_user_prompt` 事件未同步呈现多端上传的 `images` 附件的问题。
+  - 修复了 Markdown 解析器中 URL 包含查询参数时因多次转义造成的双重转义（Double Escaping）问题，并支持 `mailto:` 链接解析。
+- **协议库与 TypeScript 类型定义完善 (`@liguoshuai/pi-chat-protocol`)**：
+  - 新增 `createSetSessionNameMessage`、`createGetEntriesMessage`、`createGetStateMessage`、`createGetAvailableModelsMessage`、`createExtensionUiResponseMessage` 辅助构造方法。
+  - 增强了 `SET_SESSION_NAME` 与 `SET_THINKING_LEVEL` 的数据校验与 TypeScript 类型声明。
+
+---
+
+## [2.1.0] - 2026-08-30
+
+### Fixed & Improved
+- **移动端流式打字与思考过程实时渲染修复 (Mobile Streaming & Thinking Render Fix)**：
+  - 在 `@liguoshuai/pi-chat-protocol`、Android 和 HarmonyOS 原生客户端中完善了 `assistantMessageEvent` 结构解析，修复了移动端在 AI 回复生成期间无法接收 `text_delta` 与 `thinking_delta` 流式打字效果的问题。
+- **移动端历史会话转录加载修复 (Mobile Session History Restore)**：
+  - 在 Android (`ApiService`) 与 HarmonyOS (`HttpService`) 中新增了 `/api/session?file=...` 接口调用，在切换会话时自动还原历史聊天气泡。
+- **Web 端 401 鉴权重连修复 (Web Re-Auth Fix)**：
+  - 修复了 `app.js` 中弹窗输入 Token 后调用未定义 `initWebSocket` 导致 `ReferenceError` 的异常，改为正确调用 `connectWs`。
+- **服务端网关 RPC ID 保持与进程管理增强 (Gateway RPC ID & Lifecycle Improvements)**：
+  - 修复了网关转发指令时丢失客户端 `id` 的问题，确保 RPC 请求响应精确关联。
+  - 增强了 IPv6 Localhost 跨域兼容性支持与死连接自动清理。
+  - 补充了 `@liguoshuai/pi-chat-protocol` 中的 `createSetThinkingLevelMessage` 与 `createCycleThinkingLevelMessage` 辅助方法。
+
+---
+
 ## [2.0.0] - 2026-08-30
 
 ### Major Architecture Refactoring (Monorepo & Multi-Client Ecosystem)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liguoshuai/pi-web-chat",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "A ChatGPT/Gemini-style web UI for the pi coding agent, powered by pi's RPC mode.",
   "type": "module",
   "main": "server.js",
@@ -40,8 +40,8 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@liguoshuai/pi-chat-protocol": "2.0.0",
-    "@liguoshuai/pi-chat-server": "2.0.0",
+    "@liguoshuai/pi-chat-protocol": "2.2.0",
+    "@liguoshuai/pi-chat-server": "2.2.0",
     "express": "^4.21.2",
     "ws": "^8.18.0"
   },

package/public/app.js

@@ -456,7 +456,7 @@ function sanitizeUrl(url) {
   if (!url) return "#";
   const trimmed = url.trim();
   if (/^(https?:\/\/|mailto:)/i.test(trimmed)) {
-    return escapeHtml(trimmed);
+    return trimmed.replace(/"/g, """).replace(/'/g, "'");
   }
   return "#";
 }
@@ -474,7 +474,7 @@ function mdInlineBlock(text) {
   // italic (underscore): only match boundary/space so identifier_names are preserved
   s = s.replace(/(^|[\s(\[<,;:])_([^_\s](?:[^_]*?[^_\s])?)_(?=[\s)\]>,;:!?.]|$)/g, "$1<em>$2</em>");
   // links [txt](url) - strictly sanitize URL
-  s = s.replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g, (match, txt, url) => {
+  s = s.replace(/\[([^\]]+)\]\(((?:https?:\/\/|mailto:)[^\s)]+)\)/g, (match, txt, url) => {
     const safeUrl = sanitizeUrl(url);
     return `<a href="${safeUrl}" target="_blank" rel="noopener">${txt}</a>`;
   });
@@ -1655,7 +1655,7 @@ function connectWs(opts = {}) {
       const entered = prompt("Pi Gateway 开启了访问鉴权，请输入访问 Token：");
       if (entered) {
         localStorage.setItem("pi_auth_token", entered.trim());
-        initWebSocket({ explicitNewSession: false, isReconnect: true });
+        connectWs({ explicitNewSession: false, isReconnect: true });
       }
       return;
     }
@@ -1780,7 +1780,7 @@ function handlePiMessage(obj) {
       }
       break;
     case "remote_user_prompt":
-      appendMessageNode("user", { text: obj.message, isSteer: obj.isSteer });
+      appendMessageNode("user", { text: obj.message, images: obj.images, isSteer: obj.isSteer });
       break;
     case "agent_start":
       state.streaming = true;