Merge desktop fork updates into upstream main

agentmain.py

@@ -241,16 +241,16 @@ def run(self):
         histfile = histfile or os.path.join(d, '_history.json')
     elif args.func:
         infile = args.func; outfile = os.path.splitext(args.func)[0] + '.out.txt'
-    
+
     if histfile and os.path.isfile(histfile): agent.llmclient.backend.history = json.loads(open(histfile, encoding='utf-8').read())
 
     if args.func or args.task:
         agent.peer_hint = False
         with open(infile, encoding='utf-8') as f: raw = f.read()
         while True:
             dq = agent.put_task(raw, source='func' if args.func else 'task')
-            while 'done' not in (item := dq.get(timeout=2200)): 
-                if 'next' in item: 
+            while 'done' not in (item := dq.get(timeout=2200)):
+                if 'next' in item:
                     with open(outfile, 'w', encoding='utf-8') as f: f.write(item.get('next', ''))
             with open(outfile, 'w', encoding='utf-8') as f: f.write(item['done'] + '\n\n[ROUND END]\n')
             if not args.task: break

docs/installation.md

@@ -160,6 +160,12 @@ type ga
 
 If it resolves to something unexpected, do not rely on the shortcut. Run GA from the install directory with `python launch.pyw` or `python frontends/tuiapp_v2.py`.
 
+#### Windows Defender blocks local loopback
+
+The desktop app talks to its local bridge over `127.0.0.1` / `localhost`. On some Windows machines, Windows Defender Firewall may block this loopback connection, making the desktop app look like it cannot start or cannot connect to the service.
+
+If this happens, allow `GenericAgent.exe` and the bundled `python.exe` through Windows Defender Firewall, then restart the desktop app.
+
 #### Windows TUI rendering issues
 
 TUI rendering on Windows depends on terminal, font, and `textual` version.

docs/installation_zh.md

@@ -160,6 +160,12 @@ type ga
 
 如果解析到意料之外的位置，就不要依赖这个快捷命令。请进入安装目录运行 `python launch.pyw` 或 `python frontends/tuiapp_v2.py`。
 
+#### Windows Defender 拦截本机回环网络
+
+桌面端会通过 `127.0.0.1` / `localhost` 连接本机 bridge 服务。部分 Windows 机器上，Windows Defender 防火墙可能会拦截这个本机回环连接，导致桌面端看起来无法启动，或一直连不上服务。
+
+如果遇到这种情况，请在 Windows Defender 防火墙中允许 `GenericAgent.exe` 和随包的 `python.exe` 通过，然后重启桌面端。
+
 #### Windows 上 TUI 显示异常
 
 TUI 在 Windows 上依赖终端、字体和 `textual` 版本。

frontends/conductor.py

@@ -1,14 +1,24 @@
 import os, sys, re, time, json, uuid, queue, asyncio, threading
 from dataclasses import dataclass, field
 from typing import Dict, Any, Optional, List
-from contextlib import asynccontextmanager
+from contextlib import asynccontextmanager, suppress
 
 from fastapi import FastAPI, WebSocket, WebSocketDisconnect
 from fastapi.responses import FileResponse, PlainTextResponse, JSONResponse
 from fastapi.middleware.cors import CORSMiddleware
 from pydantic import BaseModel
 
-ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+def _resolve_ga_root() -> str:
+    """External core dir when launched as the bundle's conductor (design 三).
+    Prefer GA_ROOT env (set by the desktop bridge), else derive from own location."""
+    val = (os.environ.get("GA_ROOT", "") or "").strip()
+    if val:
+        root = os.path.abspath(os.path.expanduser(val))
+        if os.path.exists(os.path.join(root, "agentmain.py")):
+            return root
+    return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+ROOT = _resolve_ga_root()
 if ROOT not in sys.path: sys.path.insert(0, ROOT)
 
 from agentmain import GenericAgent
@@ -18,28 +28,60 @@
 HTML_PATH = os.path.join(os.path.dirname(os.path.abspath(__file__)), "conductor.html")
 
 
-def _desktop_llm_no() -> Optional[int]:
-    """Read the model index the user picked in the desktop UI.
-    Persisted by the bridge at ~/.ga_desktop_settings.json under ui.llmNo.
-    Returns None when unavailable, so callers keep the agent's default model."""
+def _settings_doc() -> dict:
     try:
         from pathlib import Path
         doc = json.loads((Path.home() / ".ga_desktop_settings.json").read_text(encoding="utf-8"))
-        no = (doc.get("ui") or {}).get("llmNo")
-        return int(no) if no is not None else None
+        return doc if isinstance(doc, dict) else {}
     except Exception:
-        return None
+        return {}
 
 
-def _apply_desktop_model(agent: "GenericAgent") -> None:
-    """Switch a freshly built agent to the desktop-selected model (if any)."""
-    no = _desktop_llm_no()
-    if no is None:
+def _conductor_llm_no() -> Optional[int]:
+    """Read the model index bound to the conductor session.
+    Falls back to the legacy desktop default ui.llmNo for existing installs."""
+    doc = _settings_doc()
+    for section in (doc.get("conductor"), doc.get("ui")):
+        if isinstance(section, dict) and section.get("llmNo") is not None:
+            try:
+                return int(section.get("llmNo"))
+            except (TypeError, ValueError):
+                pass
+    return None
+
+
+def _client_usable(agent: "GenericAgent") -> bool:
+    return hasattr(getattr(agent, "llmclient", None), "backend")
+
+
+def _fallback_usable_model(agent: "GenericAgent") -> None:
+    for i, client in enumerate(getattr(agent, "llmclients", []) or []):
+        if not hasattr(client, "backend"):
+            continue
+        agent.llm_no = i
+        agent.llmclient = client
+        with suppress(Exception):
+            agent.llmclient.last_tools = ''
         return
-    try:
-        agent.next_llm(int(no))
-    except Exception as e:
-        print(f"[conductor] failed to apply desktop model #{no}: {e}", file=sys.stderr)
+
+
+def _apply_desktop_model(agent: "GenericAgent") -> None:
+    """Make the conductor's session reflect the current desktop config before a task:
+    switch to its bound model if one is set, otherwise still refresh sessions from
+    mykey so live key/model edits (e.g. importing keys) take effect without a restart.
+    next_llm() already reloads internally; the no-bound-model branch must reload too,
+    or a conductor started on an empty/stale mykey would never pick up imported keys."""
+    no = _conductor_llm_no()
+    if no is not None:
+        try:
+            agent.next_llm(int(no))
+        except Exception as e:
+            print(f"[conductor] failed to apply conductor model #{no}: {e}", file=sys.stderr)
+    else:
+        agent.load_llm_sessions()  # mtime-guarded; rebuilds only when mykey changed
+    if not _client_usable(agent):
+        print("[conductor] selected model is unavailable; falling back to first usable model", file=sys.stderr)
+        _fallback_usable_model(agent)
 
 
 def _select_llm(agent: "GenericAgent", llm: Any) -> bool:
@@ -396,15 +438,27 @@ def _run(self):
                 _apply_desktop_model(self.agent)
                 dq = self.agent.put_task(prompt, source="conductor")
                 self._drain(dq, events)
-            except Exception as e: print(f"Conductor error: {e}")
+            except Exception as e:
+                print(f"Conductor error: {e}")
+                add_chat(f"⚠ 回复失败：{e}", role="error")
 
     def start(self): threading.Thread(target=self._run, name="conductor-loop", daemon=True).start()
 
 
 conductor = Conductor()
 
 # ---- IM poller: 探测conductor_im_plugins/下各插件,信号变化→唤醒总管 ----
-IM_DIR, IM_COOLDOWN = os.path.join(os.path.dirname(__file__), "conductor_im_plugins"), 300
+def _resolve_im_dir() -> str:
+    # 方案三: conductor.py itself is bundle-owned, but IM plugins are user/environment
+    # integrations. Prefer the external core's plugins when GA_ROOT points at one; fall back
+    # to the bundle templates/examples when the external core has no plugin directory.
+    external = os.path.join(ROOT, "frontends", "conductor_im_plugins")
+    if os.path.isdir(external):
+        return external
+    return os.path.join(os.path.dirname(os.path.abspath(__file__)), "conductor_im_plugins")
+
+
+IM_DIR, IM_COOLDOWN = _resolve_im_dir(), 300
 IM_PROMPTS: Dict[str, str] = {}   # source -> 采集prompt（派采集subagent时按需取）
 
 def im_poll_loop():

frontends/desktop/packaging/CHECKLIST.md

@@ -0,0 +1,48 @@
+# GenericAgent Desktop 测试 CHECKLIST
+
+---
+
+## 一、聊天页面
+
+- [ ] 发消息能正常收到回复,顶栏状态在「运行中」「就绪」之间切换,中文输入法 Enter 不会误发,超长粘贴会被截断
+- [ ] 上传文件、拖拽图片到输入框,能发送且 agent 能识别,流式回复中可中断,悬停消息能复制全文
+- [ ] 代码块/数学公式/多轮折叠都正常,长回复(2000 字以上)末尾不丢字
+- [ ] 起始页预设卡片可跳转(指挥家)或触发对应模式(Plan / Goal 等),自定义预设可增删且刷新后仍在
+- [ ] 切换模型后用量页能记录新模型,设置页调字号后聊天字体实时变,ask_user 弹问题卡能正常答复
+- [ ] 切换到一个 300 轮对话以上的 session，确保页面不卡顿
+
+---
+
+## 二、会话列表
+
+- [ ] 新对话能创建,空态文案正常显示,搜索框能按标题过滤
+- [ ] 置顶/取消置顶/重命名/删除(激活和非激活分别测),都即时生效且刷新后持久
+- [ ] 右栏可拖窄拖宽和整体折叠,跑任务的会话有运行中视觉标识
+
+---
+
+## 三、指挥家
+
+- [ ] 派一个多步骤目标,顶栏状态进入运行中,右侧分工进度出现子任务卡片,任务跑完主区有简报回复
+
+---
+
+## 四、后台服务
+
+- [ ] 确保修改的配置能保存到本地，除此之外都是原有功能，不需要测试
+
+---
+
+## 五、用量
+
+- [ ] 在聊天和指挥家页面发送消息并收到回复,确保聊天和指挥家都能被统计用量,且模型无误
+- [ ] 表格列宽固定不跳动,会话名过长用省略号显示且悬停有 tooltip,点击会话行可展开按时间倒序的明细
+- [ ] 趋势图折叠展开后不变形,日期范围筛选 + 重置生效,已删除的会话标「此会话已删除」
+
+---
+
+## 六、设置页面(外观 / 字号 / 语言 / 模型管理)
+
+- [ ] 外观浅色/深色切换,浅色下「素色」开关可用,聊天字号 10-20 可调,关弹窗再开后所有设置仍生效
+- [ ] 中英文切换后整个 UI 文案跟着变,无中英混杂
+- [ ] 模型可添加/编辑/删除,添加弹窗里的 DeepSeek / 通义千问 快速接入会预填地址+协议+模型,用户只需粘贴 API key 就能保存使用

frontends/desktop/packaging/README.md

@@ -0,0 +1,35 @@
+# packaging
+
+桌面端发布相关材料。本目录的内容**不会**整体打进发布包——CI
+（`.github/workflows/desktop-release-package.yml`）只从这里挑选 `scripts/` 下的
+安装/卸载脚本拷进各平台的发布产物，其余文件对构建打包过程是只读参考。
+
+## 目录结构
+
+```
+frontends/desktop/packaging/
+├── README.md            # 本说明
+├── CHECKLIST.md         # 发布前功能测试清单（测试协调用，不参与打包）
+├── TODO.md              # 各平台测试分工与计划（测试协调用，不参与打包）
+└── scripts/             # ← 唯一被 CI 消费的内容
+    ├── windows/
+    │   ├── install_windows.ps1     # 环境准备脚本
+    │   ├── uninstall.bat           # 卸载入口（向用户确认后调用 ps1）
+    │   └── uninstall_windows.ps1
+    ├── linux/
+    │   ├── install_linux.sh
+    │   └── uninstall.sh
+    └── macos/
+        ├── install_macos.sh
+        └── uninstall.command
+```
+
+## CI 如何使用这些脚本
+
+`desktop-release-package.yml` 在打各平台 portable 包时，把对应平台的脚本
+`cp` 进发布目录（例如 Windows 包里放 `install_windows.ps1` /
+`uninstall.bat` / `uninstall_windows.ps1`）。**修改安装/卸载行为只需改
+`scripts/` 下的文件，不需要动 workflow。**
+
+> 说明：实际的桌面壳二进制（`GenericAgent.exe` / `.AppImage` / `.app`）由 CI
+> 构建生成并发布到 GitHub Release，不在本仓库内提交，也不在本目录占位。

frontends/desktop/packaging/TODO.md

@@ -0,0 +1,85 @@
+# GenericAgent Desktop 测试 TODO
+
+## 目标
+
+目前打算采用 git action 构建发布版，本轮测试主要关注三个结果：
+
+1. 测试者优先验证已有 Release 产物是否能在目标系统运行。
+2. 若 Release 产物不可用，再记录失败原因，并考虑本地构建或调整 GitHub Action 构建方法。
+3. Release 产物能启动后，再做核心功能兼容性测试。
+
+---
+
+## 系统覆盖
+
+重点测试 Windows 和 Linux；
+
+| 优先级 | 系统 | 架构/版本 | 测试员 | 状态 | 备注 |
+|---|---|---|---|---|---|
+| P0 | Windows 11 | x64 | 无 | 开发过程中已测试 | 当前最优先 Windows 环境 |
+| P0 | Windows 10 | x64 | 杨航 | TODO | 常见 Windows 环境 |
+| P0 | Ubuntu 24.04 LTS | x64 | 张景铭 | TODO | 当前常见 Linux LTS |
+| P0 | Ubuntu 22.04 LTS | x64 | 张景铭 | TODO | 仍然常见的 Linux LTS |
+| P1 | Debian 12 | x64 | 曹兮 | TODO | 可选，覆盖 Debian 系 |
+| Owner | macOS | Apple Silicon 或 Intel | 杨航 | TODO |  |
+
+
+---
+
+## 每个系统需要完成的任务
+
+### 任务 1：下载并验证已有 Release 产物
+
+测试员优先使用已有 Release，不要求先在本机生成程序壳。
+
+当前测试 Release：
+
+```text
+https://github.com/dd3xp/GenericAgent_Desktop/releases/tag/desktop-windows-test-3-1
+```
+
+当前资产命名：
+
+```text
+GenericAgent-Desktop-Windows.exe
+GenericAgent-Desktop-Linux.AppImage
+SHA256SUMS.txt
+```
+
+测试步骤：
+
+1. 下载对应系统的 Release 产物和 `SHA256SUMS.txt`；
+2. 启动环境配置脚本
+3. 运行程序壳；
+4. 记录是否能打开主界面、是否能连上本地 bridge/后端；
+
+环境配置脚本 Windows 可参考：
+
+```powershell
+# 在仓库根目录执行
+.\frontends\desktop\packaging\scripts\windows\install_windows.ps1
+```
+
+环境配置脚本 Linux 可参考：
+
+```bash
+chmod +x frontends/desktop/packaging/scripts/linux/install_linux.sh
+./frontends/desktop/packaging/scripts/linux/install_linux.sh --mode PrepareOnly
+chmod +x GenericAgent-Desktop-Linux.AppImage
+./GenericAgent-Desktop-Linux.AppImage
+```
+
+说明：Linux 脚本 `frontends/desktop/packaging/scripts/linux/install_linux.sh` 目前作为参考实现使用，已在 Ubuntu 24.04.4 LTS x64 上做过初步试用，但仍需按清单做完整验证。脚本核心做法是准备运行环境，并写入用户级桌面配置（如 `~/.ga_desktop_settings.json`），让程序壳能找到 `project_dir`、`python_path` 和 bridge 脚本。
+
+### 任务 2：Release 不可用时的升级路径
+
+如果 Release 产物在目标系统不可用：
+1. 如果只是目标机缺少运行环境，优先修正环境配置脚本；
+2. 如果 Release 产物本身不兼容，尝试在目标系统本地构建；
+3. 如果本地构建可行，再考虑修改 GitHub Action 的 Linux/Windows 构建方法，让 CI 产物与本地成功产物保持一致。
+
+### 任务 3：核心功能兼容性测试
+
+Release 产物可以启动并连上后端后，再根据 `frontends/desktop/packaging/CHECKLIST.md` 测试不同平台下的界面和核心功能兼容性。
+
+---