@liguoshuai/pi-web-chat 2.4.0 → 2.5.1

package/docs/CHANGELOG.md

@@ -7,7 +7,48 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
-## [2.3.0] - 2026-08-31
+## [2.5.1] - 2026-09-01
+
+### Added
+- **AI Coding Agent 工作指南与工程规范 (`AGENTS.md` & `CLAUDE.md`)**：
+  - 确立三大强制铁律：工作前必拉取远端主干（`git pull origin main`）、任何修改必递增 SemVer 语义化版本号并在 Web 与各客户端正确呈现、任务完成必通过全量测试并提交推送至远端。
+  - 制定 Monorepo 全仓版本同步清单（Lockstep）与多端版本呈现规范。
+- **客户端版本号呈现强化**：
+  - Android 原生端：启用 `buildConfig = true`，在侧边栏抽屉底部及后端配置对话框中通过 `BuildConfig.VERSION_NAME` 实时展示客户端版本号（`v2.5.1`）。
+  - HarmonyOS 鸿蒙原生端：在侧边栏底部展示应用版本号（`v2.5.1`）。
+  - Web 端：通过网关 `/api/config` 动态获取并在侧边栏底部 `#appVersion` 区域正确展示当前版本号（`v2.5.1`）。
+
+### Changed
+- 全端版本号统一升级至 2.5.1（Root / Protocol / Server / Web / Android / HarmonyOS）。
+
+---
+
+## [2.5.0] - 2026-09-01
+
+### Added
+- Android 端聊天消息、思考过程与工具执行块均显示时间戳（当天 `HH:mm`，跨天 `MM-dd HH:mm`）。
+- Android 端新增工具执行渲染（`tool_execution_start/update/end`）：展示工具名、参数、结果与执行状态（执行中/完成/错误）。
+- 用户消息头部显示 `user`，助手消息头部显示 `pi`。
+
+### Changed
+- Android 端会话列表在新建会话、`agent_start`/`agent_settled`、切换会话及服务端返回 `sessionFile` 时即时刷新，新会话更快出现在侧边栏。
+- 全端版本号统一升级至 2.5.0。
+
+## [2.4.1] - 2026-09-01
+
+### Fixed
+- **彻底解决新建对话中断已有后台任务的问题**：
+  - 修复了 `startNewSession` 在已有活动 WebSocket 连接上直接发送 `new_session` RPC 指令导致原有会话子进程被重置与中断的问题。新建会话时安全断开当前连接（原会话保持后台运行），并为新会话连接独立的无状态 Agent。
+  - 服务端网关 `NEW_SESSION` 与 `SWITCH_SESSION` 消息处理器增加安全解绑（detach）逻辑，避免跨会话指令误触或覆盖已有活跃 Agent 进程。
+- **精准修复老会话误判为“运行中”的状态异常**：
+  - 严格区分进程资源防回收判定（`isBusy`，包含 pending 异步请求）与真实 AI 流式生成状态（`isStreaming`，严格对应 `state === 'streaming'`）。
+  - 服务端 `/api/sessions` 接口与 `backfill_end` 状态同步均修正为读取 `isStreaming`，彻底杜绝老会话连接时因 `get_state`/`get_available_models` 临时 pending 导致误判为“运行中”的问题。
+  - 优化了事件环形缓存机制：会话生成结束收敛（`agent_settled`）后彻底清空缓冲区，且仅在流式生成期间缓存事件，避免非流式 RPC 响应污染回放缓冲区导致前端误进入流式状态。
+  - 前端 `updateState` 及侧边栏会话路径比对增加统一路径规范化匹配（`sameSession`），避免路径形式差异导致草稿会话残留或状态错乱。
+
+---
+
+## [2.4.0] - 2026-08-31
 
 ### Fixed & Improved
 - **后台异步长任务稳定性与持久化机制全面强化 (Background Async Persistence & Lifetime Fix)**：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liguoshuai/pi-web-chat",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "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.4.0",
-    "@liguoshuai/pi-chat-server": "2.4.0",
+    "@liguoshuai/pi-chat-protocol": "2.5.1",
+    "@liguoshuai/pi-chat-server": "2.5.1",
     "express": "^4.21.2",
     "ws": "^8.18.0"
   },

package/public/app.js

@@ -547,6 +547,12 @@ function formatMessageTime(ts) {
   return `${year}-${month}-${date} ${timeStr}`;
 }
 
+function sameSession(a, b) {
+  if (!a || !b) return false;
+  if (a === b) return true;
+  return a.replace(/^[.~]\//, "") === b.replace(/^[.~]\//, "");
+}
+
 // ---- Sidebar / sessions ----
 async function refreshSessions() {
   const cwd = state.cwd || "";
@@ -565,7 +571,7 @@ function renderSidebar(sessions) {
   if (!list) return;
   list.innerHTML = "";
 
-  const hasCurrentInSessions = Boolean(state.currentSessionFile && sessions.some(s => s.file === state.currentSessionFile));
+  const hasCurrentInSessions = Boolean(state.currentSessionFile && sessions.some(s => sameSession(s.file, state.currentSessionFile)));
 
   // If current session is a new/draft session not yet in the session list from REST API:
   if (!hasCurrentInSessions && (!state.currentSessionFile || $("#emptyState")?.style.display !== "none" || state.streaming)) {
@@ -603,7 +609,7 @@ function renderSidebar(sessions) {
   }
 
   sessions.forEach((s) => {
-    if (s.file === state.currentSessionFile && !hasCurrentInSessions) return;
+    if (sameSession(s.file, state.currentSessionFile) && !hasCurrentInSessions) return;
     const title = s.sessionName || s.firstUser || "新对话";
     const when = s.timestamp ? new Date(s.timestamp).toLocaleString("zh-CN", { month: "numeric", day: "numeric", hour: "2-digit", minute: "2-digit" }) : "";
     
@@ -617,7 +623,7 @@ function renderSidebar(sessions) {
       },
     });
 
-    const isRunning = Boolean(s.isStreaming || (s.file === state.currentSessionFile && state.streaming));
+    const isRunning = Boolean(s.isStreaming || (sameSession(s.file, state.currentSessionFile) && state.streaming));
     const runningBadge = isRunning ? el("span", { class: "session-running-badge", title: "任务正在后台生成中…" }, [
       el("span", { class: "spinner-dot" }),
       el("span", { text: "运行中" }),
@@ -629,7 +635,7 @@ function renderSidebar(sessions) {
     ]);
 
     const item = el("div", {
-      class: "session-item" + (s.file === state.currentSessionFile ? " active" : ""),
+      class: "session-item" + (sameSession(s.file, state.currentSessionFile) ? " active" : ""),
       dataset: { file: s.file },
       title: s.file,                       // hover tooltip = raw jsonl path
       onclick: () => loadSession(s.file),
@@ -690,13 +696,7 @@ function startNewSession() {
   // Mobile: close sidebar on new session
   if (window.innerWidth <= 768) closeSidebar();
 
-  // If WebSocket is already live, request new session directly without reconnect overhead
-  if (state.ws && state.ws.readyState === 1) {
-    sendWs({ type: "new_session" });
-    sendWs({ type: "get_state" });
-  } else {
-    connectWs({ explicitNewSession: true }); // no session -> pi creates a new one
-  }
+  connectWs({ explicitNewSession: true }); // no session -> pi creates a new one
   // Instantly render optimistic new session at the top of left sidebar
   renderSidebar([]);
   refreshSessions();
@@ -797,7 +797,7 @@ async function syncSessionHistory(file, force = false) {
 }
 
 async function loadSession(file) {
-  if (file === state.currentSessionFile) return;
+  if (sameSession(file, state.currentSessionFile)) return;
   const wasStreaming = state.streaming;
   state.currentSessionFile = file;
   state.streaming = false;
@@ -1804,7 +1804,7 @@ function sendWs(obj) {
 function handlePiMessage(obj) {
   // Automatically bind to the session file as soon as pi allocates it on disk
   const sessionFile = obj.data?.sessionFile || obj.sessionFile || obj.data?.sessionPath || obj.sessionPath;
-  if (sessionFile && sessionFile !== state.currentSessionFile) {
+  if (sessionFile && !sameSession(sessionFile, state.currentSessionFile)) {
     state.currentSessionFile = sessionFile;
     try {
       const newUrl = window.location.pathname + "?session=" + encodeURIComponent(sessionFile);
@@ -1820,8 +1820,6 @@ function handlePiMessage(obj) {
   // that happened in the background while no browser was attached.
   if (obj.type === "backfill_start") {
     state.isBackfilling = true;
-    state.streaming = true;
-    setComposerAborting(true);
     state.streamingItems = [];
     state.streamingMsg = null;
     state.activeToolCalls.clear();
@@ -1838,11 +1836,15 @@ function handlePiMessage(obj) {
     } else {
       finalizeStreamingMsg();
       state.streaming = false;
+      state.aborting = false;
       setComposerAborting(false);
-      refreshSessions();
+      if (state.currentSessionFile) {
+        syncSessionHistory(state.currentSessionFile, true);
+      }
     }
     // jump to the latest content once the replay is done
     requestAnimationFrame(scrollBottom);
+    refreshSessions();
     return;
   }
   // Responses to commands we issued (get_state etc.) come back with success+data.
@@ -2149,16 +2151,12 @@ function updateState(d) {
         setComposerAborting(true);
         ensureStreamingMsg();
       }
-    } else if (state.streaming) {
+    } else if (state.streaming && !state.isBackfilling) {
       finalizeStreamingMsg();
       state.streaming = false;
       state.aborting = false;
       setComposerAborting(false);
-      if (state.currentSessionFile) {
-        syncSessionHistory(state.currentSessionFile, true);
-      } else {
-        refreshSessions();
-      }
+      refreshSessions();
     }
   }
 }