myagent-ai 1.23.80 → 1.23.81

package/groups/manager.py

@@ -258,6 +258,14 @@ class GroupManager:
         db_path = self._data_dir / "groups" / "messages.db"
         self._db_conn = sqlite3.connect(str(db_path), check_same_thread=False)
         self._db_conn.row_factory = sqlite3.Row
+        # [v1.23.81] 群聊 session 映射表（每个群一个纯数字 session ID）
+        self._db_conn.execute("""
+            CREATE TABLE IF NOT EXISTS group_sessions (
+                group_id TEXT PRIMARY KEY,
+                session_id TEXT NOT NULL UNIQUE,
+                created_at REAL NOT NULL
+            )
+        """)
         self._db_conn.execute("""
             CREATE TABLE IF NOT EXISTS group_messages (
                 id TEXT PRIMARY KEY,
@@ -638,6 +646,64 @@ class GroupManager:
 
         return group
 
+    # ==================================================================
+    # [v1.23.81] 群聊 Session 管理（纯数字 ID，嵌入 URL 用于导航恢复）
+    # ==================================================================
+
+    def get_or_create_group_session(self, group_id: str) -> str:
+        """
+        获取或创建群聊的 session ID。
+        每个群有且仅有一个 session ID（纯数字，以 9 开头，递增）。
+        此 session ID 用于前端 URL 参数，确保从后台管理返回时能正确恢复群聊视图。
+        """
+        if not self._db_conn:
+            return ""
+        # 查找已有 session
+        row = self._db_conn.execute(
+            "SELECT session_id FROM group_sessions WHERE group_id = ?", (group_id,)
+        ).fetchone()
+        if row:
+            return row["session_id"]
+        # 生成新的纯数字 session ID（9 开头，13 位数字，时间戳后 8 位 + 随机 4 位）
+        import random
+        ts_part = str(int(time.time()))[-8:]
+        rand_part = str(random.randint(1000, 9999))
+        new_sid = "9" + ts_part + rand_part  # 共 13 位纯数字
+        # 确保唯一性
+        for _ in range(10):
+            existing = self._db_conn.execute(
+                "SELECT 1 FROM group_sessions WHERE session_id = ?", (new_sid,)
+            ).fetchone()
+            if not existing:
+                break
+            rand_part = str(random.randint(1000, 9999))
+            new_sid = "9" + ts_part + rand_part
+        self._db_conn.execute(
+            "INSERT INTO group_sessions (group_id, session_id, created_at) VALUES (?, ?, ?)",
+            (group_id, new_sid, time.time()),
+        )
+        self._db_conn.commit()
+        logger.info(f"群聊 session 创建: group={group_id}, session={new_sid}")
+        return new_sid
+
+    def get_group_id_by_session(self, session_id: str) -> Optional[str]:
+        """通过 session ID 查找 group_id（用于前端 URL 恢复）"""
+        if not self._db_conn:
+            return None
+        row = self._db_conn.execute(
+            "SELECT group_id FROM group_sessions WHERE session_id = ?", (session_id,)
+        ).fetchone()
+        return row["group_id"] if row else None
+
+    def get_session_by_group(self, group_id: str) -> Optional[str]:
+        """通过 group_id 查找 session_id"""
+        if not self._db_conn:
+            return None
+        row = self._db_conn.execute(
+            "SELECT session_id FROM group_sessions WHERE group_id = ?", (group_id,)
+        ).fetchone()
+        return row["session_id"] if row else None
+
     # ==================================================================
     # 消息管理
     # ==================================================================

package/myagent/groups/manager.py

@@ -258,6 +258,14 @@ class GroupManager:
         db_path = self._data_dir / "groups" / "messages.db"
         self._db_conn = sqlite3.connect(str(db_path), check_same_thread=False)
         self._db_conn.row_factory = sqlite3.Row
+        # [v1.23.81] 群聊 session 映射表（每个群一个纯数字 session ID）
+        self._db_conn.execute("""
+            CREATE TABLE IF NOT EXISTS group_sessions (
+                group_id TEXT PRIMARY KEY,
+                session_id TEXT NOT NULL UNIQUE,
+                created_at REAL NOT NULL
+            )
+        """)
         self._db_conn.execute("""
             CREATE TABLE IF NOT EXISTS group_messages (
                 id TEXT PRIMARY KEY,
@@ -638,6 +646,64 @@ class GroupManager:
 
         return group
 
+    # ==================================================================
+    # [v1.23.81] 群聊 Session 管理（纯数字 ID，嵌入 URL 用于导航恢复）
+    # ==================================================================
+
+    def get_or_create_group_session(self, group_id: str) -> str:
+        """
+        获取或创建群聊的 session ID。
+        每个群有且仅有一个 session ID（纯数字，以 9 开头，递增）。
+        此 session ID 用于前端 URL 参数，确保从后台管理返回时能正确恢复群聊视图。
+        """
+        if not self._db_conn:
+            return ""
+        # 查找已有 session
+        row = self._db_conn.execute(
+            "SELECT session_id FROM group_sessions WHERE group_id = ?", (group_id,)
+        ).fetchone()
+        if row:
+            return row["session_id"]
+        # 生成新的纯数字 session ID（9 开头，13 位数字，时间戳后 8 位 + 随机 4 位）
+        import random
+        ts_part = str(int(time.time()))[-8:]
+        rand_part = str(random.randint(1000, 9999))
+        new_sid = "9" + ts_part + rand_part  # 共 13 位纯数字
+        # 确保唯一性
+        for _ in range(10):
+            existing = self._db_conn.execute(
+                "SELECT 1 FROM group_sessions WHERE session_id = ?", (new_sid,)
+            ).fetchone()
+            if not existing:
+                break
+            rand_part = str(random.randint(1000, 9999))
+            new_sid = "9" + ts_part + rand_part
+        self._db_conn.execute(
+            "INSERT INTO group_sessions (group_id, session_id, created_at) VALUES (?, ?, ?)",
+            (group_id, new_sid, time.time()),
+        )
+        self._db_conn.commit()
+        logger.info(f"群聊 session 创建: group={group_id}, session={new_sid}")
+        return new_sid
+
+    def get_group_id_by_session(self, session_id: str) -> Optional[str]:
+        """通过 session ID 查找 group_id（用于前端 URL 恢复）"""
+        if not self._db_conn:
+            return None
+        row = self._db_conn.execute(
+            "SELECT group_id FROM group_sessions WHERE session_id = ?", (session_id,)
+        ).fetchone()
+        return row["group_id"] if row else None
+
+    def get_session_by_group(self, group_id: str) -> Optional[str]:
+        """通过 group_id 查找 session_id"""
+        if not self._db_conn:
+            return None
+        row = self._db_conn.execute(
+            "SELECT session_id FROM group_sessions WHERE group_id = ?", (group_id,)
+        ).fetchone()
+        return row["session_id"] if row else None
+
     # ==================================================================
     # 消息管理
     # ==================================================================

package/myagent/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.23.80",
+  "version": "1.23.81",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {

package/myagent/web/ui/admin/admin-core.js

@@ -122,7 +122,7 @@ document.getElementById('adminSidebar')?.addEventListener('click',function(e){
 loadVersion();
 setTimeout(()=>checkUpdate(false),30000);
 
-// [v1.23.57] 返回聊天：支持群聊上下文恢复
+// [v1.23.81] 返回聊天：通过纯数字 session ID 恢复群聊（不再传递 group_id）
 (function(){
   function _buildReturnUrl(){
     var params=new URLSearchParams(window.location.search);
@@ -130,13 +130,21 @@ setTimeout(()=>checkUpdate(false),30000);
     // 从 URL 参数中恢复聊天状态
     var agent=params.get('from_agent');
     var session=params.get('from_session');
-    var group=params.get('from_group');
+    // [v1.23.81] 群聊纯数字 session ID（优先级最高，覆盖 ?s= 个人会话参数）
+    var groupSession=params.get('from_group_session');
     var mode=params.get('from_mode');
     var parts=[];
-    if(agent)parts.push('a='+encodeURIComponent(agent));
-    if(mode)parts.push('mode='+encodeURIComponent(mode));
-    if(session)parts.push('s='+encodeURIComponent(session));
-    if(group)parts.push('group='+encodeURIComponent(group));
+    // 如果有群聊 session，用 ?g= 参数（纯数字 ID）
+    if(groupSession && /^[0-9]+$/.test(groupSession)){
+      parts.push('g='+groupSession);
+      if(agent)parts.push('a='+encodeURIComponent(agent));
+      if(mode)parts.push('mode='+encodeURIComponent(mode));
+    } else {
+      // 个人聊天模式
+      if(agent)parts.push('a='+encodeURIComponent(agent));
+      if(mode)parts.push('mode='+encodeURIComponent(mode));
+      if(session)parts.push('s='+encodeURIComponent(session));
+    }
     if(parts.length>0)base+='?'+parts.join('&');
     return base;
   }

package/myagent/web/ui/chat/chat.js

@@ -3,7 +3,7 @@
 
 (function() {
   var base = new URL('.', window.location.href).href;
-  var v = '?v=12';
+  var v = '?v=14';
   var scripts = [
     'groupchat.js',   // 群聊模块（状态 + API + 渲染 + 发送）
     'flow_engine.js', // 文本处理流引擎（SSE 流式 + 大文本 + 执行事件）

package/myagent/web/ui/chat/chat_main.js

@@ -86,16 +86,19 @@ function closeMobileAgentPanel() {
   if (overlay) overlay.classList.remove('active');
 }
 
-// [v1.23.57] 跳转后台管理：携带当前聊天上下文（agent、session、群聊），以便"返回聊天"正确恢复
+// [v1.23.81] 跳转后台管理：携带当前聊天上下文（agent、session、群聊session ID），以便"返回聊天"正确恢复
 function goToAdmin() {
   var params = new URLSearchParams();
   var page = 'dashboard';
   // 传递当前聊天状态，供"返回聊天"恢复
   if (state.activeAgent) params.set('from_agent', state.activeAgent);
   if (state.chatMode) params.set('from_mode', state.chatMode);
-  if (state.activeSessionId) params.set('from_session', state.activeSessionId);
-  if (typeof currentView !== 'undefined' && currentView === 'group' && typeof currentGroupId !== 'undefined' && currentGroupId) {
-    params.set('from_group', currentGroupId);
+  if (state.activeSessionId && currentView !== 'group') params.set('from_session', state.activeSessionId);
+  // [v1.23.81] 传递群聊纯数字 session ID（从 URL 读取），而非 JS 变量
+  if (typeof currentView !== 'undefined' && currentView === 'group') {
+    var urlP = new URLSearchParams(window.location.search);
+    var gSession = urlP.get('g');
+    if (gSession) params.set('from_group_session', gSession);
   }
   // 保留原始 ?page= 参数
   var origParams = new URLSearchParams(window.location.search);
@@ -346,14 +349,10 @@ const StatePersistence = {
     if (savedSessionId) {
       state._pendingSessionRestore = savedSessionId;
     }
-    // [v1.23.34] 恢复群聊状态
-    var savedView = StatePersistence.load('currentView', 'chat');
-    var savedGroupId = StatePersistence.load('currentGroupId', null);
-    if (savedView === 'group' && savedGroupId) {
-      currentView = 'group';
-      currentGroupId = savedGroupId;
-      state._pendingGroupRestore = savedGroupId;
-    }
+    // [v1.23.81] 不再从 localStorage 恢复群聊状态（统一由 URL ?g= 参数恢复）
+    // 仅保留兼容处理：如果旧版遗留了 localStorage 群聊状态，清除它
+    StatePersistence.remove('currentView');
+    StatePersistence.remove('currentGroupId');
   },
   /** 标记 setup 已完成（避免每次刷新弹出向导） */
   markSetupDone() { StatePersistence.save('setupDone', true); },
@@ -369,14 +368,17 @@ async function initChat() {
   // [v1.16.12] 初始化附件上传 UI
   initAttachmentUI();
 
-  // URL 参数处理: ?a=xxx&mode=exec&s=xxx&popout=1（agent/session 使用 UrlCodec 编码）
+  // URL 参数处理: ?a=xxx&mode=exec&s=xxx&g=xxx&popout=1（agent/session 使用 UrlCodec 编码）
   const urlParams = new URLSearchParams(window.location.search);
   const urlAgent = UrlCodec.decode(urlParams.get('a') || '') || UrlCodec.decode(urlParams.get('agent') || '');
   const urlMode = urlParams.get('mode');
   const urlSession = UrlCodec.decode(urlParams.get('s') || '') || UrlCodec.decode(urlParams.get('session') || '');
   const isPopout = urlParams.get('popout') === '1';
-  // [v1.23.57] 支持从后台管理"返回聊天"时恢复群聊状态
-  const urlGroup = urlParams.get('group');
+  // [v1.23.81] 群聊纯数字 session ID（?g= 参数，优先级最高）
+  const urlGroupSession = urlParams.get('g') || '';
+  // 兼容旧版 ?group= 参数（从后台管理返回时的旧格式）
+  const urlGroupSessionLegacy = urlParams.get('from_group_session') || '';
+  const _effectiveGroupSession = urlGroupSession || urlGroupSessionLegacy;
   if (urlMode === 'chat' || urlMode === 'exec') {
     state.chatMode = urlMode;
   }
@@ -462,27 +464,37 @@ async function initChat() {
     document.title = (agentObj ? agentObj.name : urlAgent || 'MyAgent') + ' - MyAgent';
   }
 
-  // [v1.23.80] 群聊恢复逻辑（URL 参数优先于 localStorage）
-  var _pendingGroupId = urlGroup || state._pendingGroupRestore || null;
-  state._pendingGroupRestore = null;
+  // [v1.23.81] 群聊恢复逻辑：从 URL 的 ?g= 纯数字 session ID 恢复（优先级最高）
+  // 不再依赖 JS 状态传递（from_group），完全通过 URL session ID 恢复
+  state._pendingGroupRestore = null;  // 不再使用 localStorage 中的群聊状态
 
-  function _restoreGroupChat(gid) {
-    if (typeof groups !== 'undefined' && groups.length > 0) {
-      selectGroup(gid);
-    } else {
-      setTimeout(function() { _restoreGroupChat(gid); }, 200);
+  async function _restoreGroupBySession(sessionId) {
+    // 通过 API 将纯数字 session ID 解析为 group_id
+    try {
+      var resolveData = await api('/api/group-session/' + encodeURIComponent(sessionId));
+      if (resolveData && resolveData.group_id) {
+        if (typeof groups !== 'undefined' && groups.length > 0) {
+          selectGroup(resolveData.group_id);
+        } else {
+          // groups 尚未加载，等待后重试
+          setTimeout(function() { _restoreGroupBySession(sessionId); }, 200);
+        }
+      } else {
+        console.warn('群聊 session 解析失败:', sessionId);
+      }
+    } catch (e) {
+      console.warn('解析群聊 session 失败:', e);
     }
   }
 
-  // [v1.23.80] 如果即将恢复群聊，跳过 selectAgent 避免竞态（selectAgent 会清除 currentView=group 状态）
-  if (_pendingGroupId) {
-    // 群聊模式：不需要 selectAgent，直接恢复群聊视图
-    // 但如果有 from_agent 参数，更新 state.activeAgent 以便后续群聊私聊时使用
+  // 如果 URL 中有 ?g= 纯数字 session ID，优先恢复群聊
+  if (_effectiveGroupSession && /^[0-9]+$/.test(_effectiveGroupSession)) {
+    // 群聊模式：如果有 from_agent 参数，更新 state.activeAgent 以便后续群聊私聊时使用
     if (urlAgent && urlAgent !== state.activeAgent) {
       state.activeAgent = urlAgent;
       StatePersistence.save('activeAgent', urlAgent);
     }
-    _restoreGroupChat(_pendingGroupId);
+    _restoreGroupBySession(_effectiveGroupSession);
   } else if (urlAgent) {
     // URL 指定了 agent，校验后切换
     var resolved = urlAgent;

package/myagent/web/ui/chat/groupchat.js

@@ -167,10 +167,21 @@ async function selectGroup(gid) {
   }
   currentView = 'group';
   currentGroupId = gid;
-  // [v1.23.34] 持久化群聊状态，刷新页面后恢复
-  if (typeof StatePersistence !== 'undefined') {
-    StatePersistence.save('currentView', 'group');
-    StatePersistence.save('currentGroupId', gid);
+
+  // [v1.23.81] 获取群聊 session ID 并写入 URL（纯数字，用于导航恢复）
+  try {
+    var sessionData = await api('/api/groups/' + encodeURIComponent(gid) + '/session');
+    if (sessionData && sessionData.session_id) {
+      var sessionId = sessionData.session_id;
+      // 用群聊专用 ?g= 参数更新 URL（不刷新页面），纯数字 session ID
+      var newUrl = '/ui/chat/chat_container.html?g=' + sessionId;
+      if (typeof state !== 'undefined' && state.activeAgent) {
+        newUrl += '&a=' + encodeURIComponent(state.activeAgent);
+      }
+      window.history.replaceState({groupSession: sessionId, groupId: gid}, '', newUrl);
+    }
+  } catch (e) {
+    console.warn('获取群聊 session 失败:', e);
   }
 
   // [v1.23.51] 群聊模式：隐藏"新对话"按钮，搜索框改为搜索群聊
@@ -238,11 +249,19 @@ function exitGroupChat() {
   currentView = 'chat';
   currentGroupId = null;
   groupMessages = [];
-  // [v1.23.34] 清除持久化的群聊状态
-  if (typeof StatePersistence !== 'undefined') {
-    StatePersistence.save('currentView', 'chat');
-    StatePersistence.remove('currentGroupId');
+  // [v1.23.81] 清除群聊 ?g= session URL，恢复普通聊天 URL
+  var cleanUrl = '/ui/chat/chat_container.html';
+  if (typeof state !== 'undefined' && state.activeAgent && state.activeAgent !== 'default') {
+    cleanUrl += '?a=' + encodeURIComponent(state.activeAgent);
+  }
+  if (typeof state !== 'undefined' && state.activeSessionId && state.activeSessionId !== '__new__') {
+    cleanUrl += (cleanUrl.indexOf('?') >= 0 ? '&' : '?') + 's=' + encodeURIComponent(state.activeSessionId);
   }
+  window.history.replaceState({}, '', cleanUrl);
+  // 清除群聊 localStorage 持久化状态
+  StatePersistence.remove('currentView');
+  StatePersistence.remove('currentGroupId');
+
   // 清空残留的聊天状态，避免切回个人聊天时显示群聊消息
   state.messages = [];
   state.activeSessionId = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.23.80",
+  "version": "1.23.81",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {

package/web/api_server.py

@@ -474,6 +474,9 @@ class ApiServer:
         r.add_get("/api/groups/{gid}/messages", self.handle_get_group_messages)
         r.add_post("/api/groups/{gid}/messages", self.handle_send_group_message)
         r.add_delete("/api/groups/{gid}/messages", self.handle_clear_group_messages)
+        # [v1.23.81] 群聊 session 管理（纯数字 ID，用于 URL 导航恢复）
+        r.add_get("/api/groups/{gid}/session", self.handle_get_group_session)
+        r.add_get("/api/group-session/{sid}", self.handle_resolve_group_session)
         # [v1.23.37] Agent间私聊记录查询
         r.add_get("/api/agent-chat/pairs", self.handle_get_agent_chat_pairs)
         r.add_get("/api/agent-chat/messages", self.handle_get_agent_chat_messages)
@@ -7979,6 +7982,30 @@ window.addEventListener('beforeunload', function() {{
         ok = mgr.clear_messages(gid)
         return web.json_response({"ok": ok})
 
+    # ── [v1.23.81] 群聊 Session API ──
+
+    async def handle_get_group_session(self, request):
+        """GET /api/groups/{gid}/session - 获取或创建群聊的 session ID（纯数字）"""
+        gid = request.match_info["gid"]
+        mgr = self._get_group_manager()
+        group = mgr.get_group(gid)
+        if not group:
+            return web.json_response({"error": "群不存在"}, status=404)
+        session_id = mgr.get_or_create_group_session(gid)
+        return web.json_response({"session_id": session_id, "group_id": gid})
+
+    async def handle_resolve_group_session(self, request):
+        """GET /api/group-session/{sid} - 通过 session ID 查找 group_id（用于 URL 恢复）"""
+        sid = request.match_info["sid"]
+        mgr = self._get_group_manager()
+        group_id = mgr.get_group_id_by_session(sid)
+        if not group_id:
+            return web.json_response({"error": "session 不存在"}, status=404)
+        group = mgr.get_group(group_id)
+        if not group:
+            return web.json_response({"error": "群已不存在"}, status=404)
+        return web.json_response({"session_id": sid, "group_id": group_id, "group": self._enrich_group_dict(group.to_dict())})
+
     # ── [v1.23.37] Agent间私聊记录 API ──
 
     async def handle_get_agent_chat_pairs(self, request):

package/web/ui/admin/admin-core.js

@@ -122,7 +122,7 @@ document.getElementById('adminSidebar')?.addEventListener('click',function(e){
 loadVersion();
 setTimeout(()=>checkUpdate(false),30000);
 
-// [v1.23.57] 返回聊天：支持群聊上下文恢复
+// [v1.23.81] 返回聊天：通过纯数字 session ID 恢复群聊（不再传递 group_id）
 (function(){
   function _buildReturnUrl(){
     var params=new URLSearchParams(window.location.search);
@@ -130,13 +130,21 @@ setTimeout(()=>checkUpdate(false),30000);
     // 从 URL 参数中恢复聊天状态
     var agent=params.get('from_agent');
     var session=params.get('from_session');
-    var group=params.get('from_group');
+    // [v1.23.81] 群聊纯数字 session ID（优先级最高，覆盖 ?s= 个人会话参数）
+    var groupSession=params.get('from_group_session');
     var mode=params.get('from_mode');
     var parts=[];
-    if(agent)parts.push('a='+encodeURIComponent(agent));
-    if(mode)parts.push('mode='+encodeURIComponent(mode));
-    if(session)parts.push('s='+encodeURIComponent(session));
-    if(group)parts.push('group='+encodeURIComponent(group));
+    // 如果有群聊 session，用 ?g= 参数（纯数字 ID）
+    if(groupSession && /^[0-9]+$/.test(groupSession)){
+      parts.push('g='+groupSession);
+      if(agent)parts.push('a='+encodeURIComponent(agent));
+      if(mode)parts.push('mode='+encodeURIComponent(mode));
+    } else {
+      // 个人聊天模式
+      if(agent)parts.push('a='+encodeURIComponent(agent));
+      if(mode)parts.push('mode='+encodeURIComponent(mode));
+      if(session)parts.push('s='+encodeURIComponent(session));
+    }
     if(parts.length>0)base+='?'+parts.join('&');
     return base;
   }

package/web/ui/chat/chat.js

@@ -3,7 +3,7 @@
 
 (function() {
   var base = new URL('.', window.location.href).href;
-  var v = '?v=12';
+  var v = '?v=14';
   var scripts = [
     'groupchat.js',   // 群聊模块（状态 + API + 渲染 + 发送）
     'flow_engine.js', // 文本处理流引擎（SSE 流式 + 大文本 + 执行事件）

package/web/ui/chat/chat_main.js

@@ -86,16 +86,19 @@ function closeMobileAgentPanel() {
   if (overlay) overlay.classList.remove('active');
 }
 
-// [v1.23.57] 跳转后台管理：携带当前聊天上下文（agent、session、群聊），以便"返回聊天"正确恢复
+// [v1.23.81] 跳转后台管理：携带当前聊天上下文（agent、session、群聊session ID），以便"返回聊天"正确恢复
 function goToAdmin() {
   var params = new URLSearchParams();
   var page = 'dashboard';
   // 传递当前聊天状态，供"返回聊天"恢复
   if (state.activeAgent) params.set('from_agent', state.activeAgent);
   if (state.chatMode) params.set('from_mode', state.chatMode);
-  if (state.activeSessionId) params.set('from_session', state.activeSessionId);
-  if (typeof currentView !== 'undefined' && currentView === 'group' && typeof currentGroupId !== 'undefined' && currentGroupId) {
-    params.set('from_group', currentGroupId);
+  if (state.activeSessionId && currentView !== 'group') params.set('from_session', state.activeSessionId);
+  // [v1.23.81] 传递群聊纯数字 session ID（从 URL 读取），而非 JS 变量
+  if (typeof currentView !== 'undefined' && currentView === 'group') {
+    var urlP = new URLSearchParams(window.location.search);
+    var gSession = urlP.get('g');
+    if (gSession) params.set('from_group_session', gSession);
   }
   // 保留原始 ?page= 参数
   var origParams = new URLSearchParams(window.location.search);
@@ -346,14 +349,10 @@ const StatePersistence = {
     if (savedSessionId) {
       state._pendingSessionRestore = savedSessionId;
     }
-    // [v1.23.34] 恢复群聊状态
-    var savedView = StatePersistence.load('currentView', 'chat');
-    var savedGroupId = StatePersistence.load('currentGroupId', null);
-    if (savedView === 'group' && savedGroupId) {
-      currentView = 'group';
-      currentGroupId = savedGroupId;
-      state._pendingGroupRestore = savedGroupId;
-    }
+    // [v1.23.81] 不再从 localStorage 恢复群聊状态（统一由 URL ?g= 参数恢复）
+    // 仅保留兼容处理：如果旧版遗留了 localStorage 群聊状态，清除它
+    StatePersistence.remove('currentView');
+    StatePersistence.remove('currentGroupId');
   },
   /** 标记 setup 已完成（避免每次刷新弹出向导） */
   markSetupDone() { StatePersistence.save('setupDone', true); },
@@ -369,14 +368,17 @@ async function initChat() {
   // [v1.16.12] 初始化附件上传 UI
   initAttachmentUI();
 
-  // URL 参数处理: ?a=xxx&mode=exec&s=xxx&popout=1（agent/session 使用 UrlCodec 编码）
+  // URL 参数处理: ?a=xxx&mode=exec&s=xxx&g=xxx&popout=1（agent/session 使用 UrlCodec 编码）
   const urlParams = new URLSearchParams(window.location.search);
   const urlAgent = UrlCodec.decode(urlParams.get('a') || '') || UrlCodec.decode(urlParams.get('agent') || '');
   const urlMode = urlParams.get('mode');
   const urlSession = UrlCodec.decode(urlParams.get('s') || '') || UrlCodec.decode(urlParams.get('session') || '');
   const isPopout = urlParams.get('popout') === '1';
-  // [v1.23.57] 支持从后台管理"返回聊天"时恢复群聊状态
-  const urlGroup = urlParams.get('group');
+  // [v1.23.81] 群聊纯数字 session ID（?g= 参数，优先级最高）
+  const urlGroupSession = urlParams.get('g') || '';
+  // 兼容旧版 ?group= 参数（从后台管理返回时的旧格式）
+  const urlGroupSessionLegacy = urlParams.get('from_group_session') || '';
+  const _effectiveGroupSession = urlGroupSession || urlGroupSessionLegacy;
   if (urlMode === 'chat' || urlMode === 'exec') {
     state.chatMode = urlMode;
   }
@@ -462,27 +464,37 @@ async function initChat() {
     document.title = (agentObj ? agentObj.name : urlAgent || 'MyAgent') + ' - MyAgent';
   }
 
-  // [v1.23.80] 群聊恢复逻辑（URL 参数优先于 localStorage）
-  var _pendingGroupId = urlGroup || state._pendingGroupRestore || null;
-  state._pendingGroupRestore = null;
+  // [v1.23.81] 群聊恢复逻辑：从 URL 的 ?g= 纯数字 session ID 恢复（优先级最高）
+  // 不再依赖 JS 状态传递（from_group），完全通过 URL session ID 恢复
+  state._pendingGroupRestore = null;  // 不再使用 localStorage 中的群聊状态
 
-  function _restoreGroupChat(gid) {
-    if (typeof groups !== 'undefined' && groups.length > 0) {
-      selectGroup(gid);
-    } else {
-      setTimeout(function() { _restoreGroupChat(gid); }, 200);
+  async function _restoreGroupBySession(sessionId) {
+    // 通过 API 将纯数字 session ID 解析为 group_id
+    try {
+      var resolveData = await api('/api/group-session/' + encodeURIComponent(sessionId));
+      if (resolveData && resolveData.group_id) {
+        if (typeof groups !== 'undefined' && groups.length > 0) {
+          selectGroup(resolveData.group_id);
+        } else {
+          // groups 尚未加载，等待后重试
+          setTimeout(function() { _restoreGroupBySession(sessionId); }, 200);
+        }
+      } else {
+        console.warn('群聊 session 解析失败:', sessionId);
+      }
+    } catch (e) {
+      console.warn('解析群聊 session 失败:', e);
     }
   }
 
-  // [v1.23.80] 如果即将恢复群聊，跳过 selectAgent 避免竞态（selectAgent 会清除 currentView=group 状态）
-  if (_pendingGroupId) {
-    // 群聊模式：不需要 selectAgent，直接恢复群聊视图
-    // 但如果有 from_agent 参数，更新 state.activeAgent 以便后续群聊私聊时使用
+  // 如果 URL 中有 ?g= 纯数字 session ID，优先恢复群聊
+  if (_effectiveGroupSession && /^[0-9]+$/.test(_effectiveGroupSession)) {
+    // 群聊模式：如果有 from_agent 参数，更新 state.activeAgent 以便后续群聊私聊时使用
     if (urlAgent && urlAgent !== state.activeAgent) {
       state.activeAgent = urlAgent;
       StatePersistence.save('activeAgent', urlAgent);
     }
-    _restoreGroupChat(_pendingGroupId);
+    _restoreGroupBySession(_effectiveGroupSession);
   } else if (urlAgent) {
     // URL 指定了 agent，校验后切换
     var resolved = urlAgent;

package/web/ui/chat/groupchat.js

@@ -167,10 +167,21 @@ async function selectGroup(gid) {
   }
   currentView = 'group';
   currentGroupId = gid;
-  // [v1.23.34] 持久化群聊状态，刷新页面后恢复
-  if (typeof StatePersistence !== 'undefined') {
-    StatePersistence.save('currentView', 'group');
-    StatePersistence.save('currentGroupId', gid);
+
+  // [v1.23.81] 获取群聊 session ID 并写入 URL（纯数字，用于导航恢复）
+  try {
+    var sessionData = await api('/api/groups/' + encodeURIComponent(gid) + '/session');
+    if (sessionData && sessionData.session_id) {
+      var sessionId = sessionData.session_id;
+      // 用群聊专用 ?g= 参数更新 URL（不刷新页面），纯数字 session ID
+      var newUrl = '/ui/chat/chat_container.html?g=' + sessionId;
+      if (typeof state !== 'undefined' && state.activeAgent) {
+        newUrl += '&a=' + encodeURIComponent(state.activeAgent);
+      }
+      window.history.replaceState({groupSession: sessionId, groupId: gid}, '', newUrl);
+    }
+  } catch (e) {
+    console.warn('获取群聊 session 失败:', e);
   }
 
   // [v1.23.51] 群聊模式：隐藏"新对话"按钮，搜索框改为搜索群聊
@@ -238,11 +249,19 @@ function exitGroupChat() {
   currentView = 'chat';
   currentGroupId = null;
   groupMessages = [];
-  // [v1.23.34] 清除持久化的群聊状态
-  if (typeof StatePersistence !== 'undefined') {
-    StatePersistence.save('currentView', 'chat');
-    StatePersistence.remove('currentGroupId');
+  // [v1.23.81] 清除群聊 ?g= session URL，恢复普通聊天 URL
+  var cleanUrl = '/ui/chat/chat_container.html';
+  if (typeof state !== 'undefined' && state.activeAgent && state.activeAgent !== 'default') {
+    cleanUrl += '?a=' + encodeURIComponent(state.activeAgent);
+  }
+  if (typeof state !== 'undefined' && state.activeSessionId && state.activeSessionId !== '__new__') {
+    cleanUrl += (cleanUrl.indexOf('?') >= 0 ? '&' : '?') + 's=' + encodeURIComponent(state.activeSessionId);
   }
+  window.history.replaceState({}, '', cleanUrl);
+  // 清除群聊 localStorage 持久化状态
+  StatePersistence.remove('currentView');
+  StatePersistence.remove('currentGroupId');
+
   // 清空残留的聊天状态，避免切回个人聊天时显示群聊消息
   state.messages = [];
   state.activeSessionId = null;

package/worklog.md

@@ -19,3 +19,21 @@ Work Log:
 Stage Summary:
 - 修复文件：admin-platforms.js, admin-core.js, index.html, chat_main.js, chat_container.html, api_server.py
 - 版本：v1.23.57 已发布到 npm
+---
+Task ID: 1
+Agent: main
+Task: 修复从后台管理返回群聊时导航状态错误 + 群聊气泡宽度不一致
+
+Work Log:
+- 分析了从后台管理返回群聊时导航错误的根因：initChat()中selectAgent()未被await，与selectGroup()产生竞态，导致群聊UI被覆盖
+- 发现goToAdmin()中使用了state.currentAgent（不存在），应该是state.activeAgent
+- 重构了initChat()的agent/session/group恢复逻辑：当有pendingGroupRestore或urlGroup时，跳过selectAgent()避免竞态
+- 修复了群聊气泡宽度不一致问题：为.message-row和.group-msg-row添加align-items:flex-start和flex:1规则
+- 更新CSS版本缓存chat.css?v=11，JS版本?v=12
+- 版本号升级到1.23.80
+- 推送到GitHub，发布npm
+
+Stage Summary:
+- 修复了3个bug：goToAdmin()的state.currentAgent错误、selectAgent/selectGroup竞态条件、气泡宽度不一致
+- 已推送GitHub (commit 379098e)
+- 已发布npm myagent-ai@1.23.80