myagent-ai 1.15.91 → 1.15.93

package/Dockerfile

@@ -0,0 +1,30 @@
+# MyAgent - 本地桌面端执行型 AI 助手
+# Docker 构建文件 (主要用于服务器部署)
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# 安装系统依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    python3-pip \
+    && rm -rf /var/lib/apt/lists/*
+
+# 安装 Python 依赖
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 复制代码
+COPY . .
+
+# 创建数据目录
+RUN mkdir -p data logs
+
+# 环境变量
+ENV MYAGENT_APP_DATA_DIR=data
+ENV MYAGENT_APP_LOG_FILE=logs/myagent.log
+
+# HTTP API 模式
+EXPOSE 8080
+
+# 启动
+CMD ["python", "main.py", "--server", "--host", "0.0.0.0", "--port", "8080"]

package/core/update_manager.py

@@ -638,7 +638,10 @@ class UpdateManager:
         self._save_record(record)
         logger.info(f"全量更新完成 v{record.from_version} → v{new_version}，准备优雅重启...")
 
-        # Step 4: 优雅重启
+        # Step 4: 清除旧的 .pyc 缓存（防止更新后仍加载旧字节码）
+        self._clear_pycache()
+
+        # Step 5: 优雅重启
         self._status = UpdateStatus.RESTARTING
         await asyncio.sleep(0.5)  # 给日志一点时间写入
 
@@ -911,6 +914,34 @@ class UpdateManager:
                 importlib.reload(sys.modules["config"])
             logger.info("config 模块已重载")
 
+    def _clear_pycache(self):
+        """[v1.15.93] 清除项目目录和 npm 全局目录中的 __pycache__，
+        防止更新后 Python 仍加载旧的 .pyc 字节码文件。"""
+        import shutil
+        dirs_to_clean = [PROJECT_ROOT]
+        # 也清除 npm 全局目录的缓存
+        try:
+            result = subprocess.run(
+                ["npm", "root", "-g"],
+                capture_output=True, text=True, timeout=5,
+            )
+            npm_root = result.stdout.strip()
+            if npm_root:
+                npm_pkg_dir = Path(npm_root) / "myagent-ai"
+                if npm_pkg_dir.exists() and npm_pkg_dir not in dirs_to_clean:
+                    dirs_to_clean.append(npm_pkg_dir)
+        except Exception:
+            pass
+
+        for base_dir in dirs_to_clean:
+            for pycache_dir in base_dir.rglob("__pycache__"):
+                try:
+                    shutil.rmtree(pycache_dir, ignore_errors=True)
+                    logger.debug(f"已清除缓存: {pycache_dir}")
+                except Exception:
+                    pass
+        logger.info(f"__pycache__ 清理完成 (检查了 {len(dirs_to_clean)} 个目录)")
+
     # ── 模块热重载 ──
 
     async def _reload_modules(self):

package/install.ps1

@@ -0,0 +1,69 @@
+# MyAgent 一键部署脚本 (Windows)
+# ==========================================
+
+$VENV_DIR = ".venv"
+
+# 设置 UTF-8 输出
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+Write-Host "`n--- MyAgent 一键部署 ---" -ForegroundColor Cyan
+
+# 1. 检查 Python
+# 尝试使用 python 或 python3
+$PYTHON_EXE = "python"
+if (-not (Get-Command $PYTHON_EXE -ErrorAction SilentlyContinue)) {
+    $PYTHON_EXE = "python3"
+    if (-not (Get-Command $PYTHON_EXE -ErrorAction SilentlyContinue)) {
+        Write-Host "[!] 未找到 Python 环境。请从 python.org 安装 Python 3.10+。" -ForegroundColor Red
+        exit 1
+    }
+}
+
+try {
+    # 更加稳健的版本获取方式
+    $py_ver_str = & $PYTHON_EXE -c "import sys; print('%d.%d' % sys.version_info[:2])"
+    Write-Host "[i] 找到 Python: $py_ver_str"
+    
+    if ([string]::IsNullOrWhiteSpace($py_ver_str)) {
+        Write-Host "[!] 无法获取 Python 版本号。" -ForegroundColor Red
+        exit 1
+    }
+
+    $py_ver = [double]$py_ver_str
+    if ($py_ver -lt 3.10) {
+        Write-Host "[!] 需要 Python 3.10 或更高版本，当前版本为 $py_ver_str，请升级。" -ForegroundColor Red
+        exit 1
+    }
+} catch {
+    Write-Host "[!] 检查 Python 版本时出错: $_" -ForegroundColor Red
+    exit 1
+}
+
+# 2. 创建虚拟环境
+if (-not (Test-Path $VENV_DIR)) {
+    Write-Host "[*] 正在创建虚拟环境 ($VENV_DIR)..." -ForegroundColor Cyan
+    & $PYTHON_EXE -m venv $VENV_DIR
+    if ($LASTEXITCODE -ne 0) {
+        Write-Host "[✗] 创建虚拟环境失败。" -ForegroundColor Red
+        exit 1
+    }
+    Write-Host "[✓] 虚拟环境已创建。" -ForegroundColor Green
+}
+
+# 3. 安装依赖
+Write-Host "[*] 正在安装/升级依赖..." -ForegroundColor Cyan
+& "$VENV_DIR\Scripts\python.exe" -m pip install --upgrade pip --quiet
+& "$VENV_DIR\Scripts\python.exe" -m pip install -r requirements.txt
+
+if ($LASTEXITCODE -eq 0) {
+    Write-Host "`n[✓] 部署成功！" -ForegroundColor Green
+    Write-Host "提示: 现在可以运行 ./start.ps1 启动 MyAgent。" -ForegroundColor Yellow
+} else {
+    Write-Host "`n[✗] 依赖安装过程中出现错误。" -ForegroundColor Red
+}
+
+Write-Host "`n按回车退出..."
+# 仅在非交互模式下禁用 Read-Host
+if ($Host.Name -ne "ServerRemoteHost") {
+    Read-Host
+}

package/myagent_start.ps1

@@ -0,0 +1,26 @@
+# MyAgent 一键启动脚本 (Windows)
+# ==========================================
+
+$VENV_DIR = ".venv"
+$PYTHON = "$VENV_DIR\Scripts\python.exe"
+
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+
+Write-Host "`n--- MyAgent 启动器 ---" -ForegroundColor Cyan
+
+if (-not (Test-Path $PYTHON)) {
+    Write-Host "[!] 未找到本地虚拟环境，尝试使用系统环境..." -ForegroundColor Yellow
+    if (Get-Command python -ErrorAction SilentlyContinue) {
+        $PYTHON = "python"
+    } else {
+        Write-Host "[✗] 未找到 Python 环境。" -ForegroundColor Red
+        exit 1
+    }
+}
+
+Write-Host "[*] 启动服务 (Web + Tray)..." -ForegroundColor Cyan
+& $PYTHON main.py --tray --web 8767
+
+if ($LASTEXITCODE -ne 0) {
+    Write-Host "`n[!] 程序退出 (代码: $LASTEXITCODE)。" -ForegroundColor Yellow
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.15.91",
+  "version": "1.15.93",
   "description": "本地桌面端执行型AI助手 - Open Interpreter 风格 | Local Desktop Execution-Oriented AI Assistant",
   "main": "main.py",
   "bin": {
@@ -42,27 +42,5 @@
   "engines": {
     "python": ">=3.10",
     "node": ">=18"
-  },
-  "files": [
-    "main.py",
-    "config.py",
-    "setup.py",
-    "requirements.txt",
-    "start.js",
-    "start.sh",
-    "install/",
-    "docs/",
-    "core/",
-    "memory/",
-    "executor/",
-    "agents/",
-    "chatbot/",
-    "skills/",
-    "knowledge/",
-    "communication/",
-    "organization/",
-    "groups/",
-    "departments/",
-    "web/"
-  ]
+  }
 }

package/scripts/setup_helper.py

@@ -0,0 +1,33 @@
+
+import sys
+from pathlib import Path
+
+# Add project root to sys.path
+root = Path(__file__).resolve().parent.parent
+sys.path.append(str(root))
+
+from web.api_server import ApiServer
+from config import get_config
+
+class MockCore:
+    def __init__(self):
+        self.config_mgr = get_config()
+        self.llm = None
+        self.executor = None
+
+def main():
+    print("[*] 正在手动创建/更新系统配置助手...")
+    core = MockCore()
+    # ApiServer needs core, and it calls _setup_routes which we don't really need but it's fine
+    server = ApiServer(core)
+    
+    # Manually call the ensure methods
+    server._ensure_default_agent()
+    server._ensure_config_helper()
+    
+    print("[+] 配置助手创建/更新完成！")
+    print(f"[i] 数据目录: {core.config_mgr.data_dir}")
+    print(f"[i] Agent 目录: {core.config_mgr.data_dir / 'agents'}")
+
+if __name__ == "__main__":
+    main()

package/skills/search_skill.py

@@ -331,18 +331,18 @@ class WebReadSkill(Skill):
                     tag.decompose()
                 # 移除所有 class 含特定关键词的元素
                 # 注意: decompose() 会连带销毁子元素，子元素的 attrs 变为 None，
-                # 因此必须检查 tag.parent 是否为 None 来跳过已被销毁的标签
-                for tag in soup.find_all(True, class_=True):
-                    if tag.parent is None:
-                        continue
-                    try:
+                # 必须同时检查 attrs 和 parent 来跳过已被销毁的标签
+                try:
+                    for tag in list(soup.find_all(True, class_=True)):
+                        if not getattr(tag, 'attrs', None):
+                            continue
                         cls_str = " ".join(tag.get("class", []))
-                    except (AttributeError, TypeError):
-                        continue
-                    if any(kw in cls_str.lower() for kw in
-                           ["sidebar", "footer", "nav", "header", "advertisement",
-                            "cookie", "popup", "modal", "banner", "social", "share"]):
-                        tag.decompose()
+                        if any(kw in cls_str.lower() for kw in
+                               ["sidebar", "footer", "nav", "header", "advertisement",
+                                "cookie", "popup", "modal", "banner", "social", "share"]):
+                            tag.decompose()
+                except Exception:
+                    pass  # 解析异常时跳过清理，不影响主要内容提取
 
                 text = soup.get_text(separator="\n", strip=True)
                 text = "\n".join(line for line in text.split("\n") if line.strip())

package/start.js

@@ -414,6 +414,9 @@ function cmdUpdate(pkgDir) {
   let newVer = "";
   try { newVer = JSON.parse(fs.readFileSync(path.join(newPkgDir, "package.json"), "utf8")).version || ""; } catch (_) {}
 
+  // 2.5 清除 __pycache__（防止旧的 .pyc 字节码覆盖新的 .py 源码）
+  cleanPycache(newPkgDir);
+
   // 3. 如果版本变了，用新的 start.js 重新执行自身，确保运行最新代码
   if (curVer && newVer && curVer !== newVer) {
     const newStartJs = path.join(newPkgDir, "start.js");
@@ -446,6 +449,33 @@ function cmdUpdate(pkgDir) {
 
 
 
+// ── 清除 __pycache__ ──────────────────────────────────────
+
+function cleanPycache(pkgDir) {
+  /**
+   * 递归清除 pkgDir 下所有 __pycache__ 目录。
+   * npm 更新后旧的 .pyc 可能残留，Python 优先加载 .pyc 导致新代码不生效。
+   */
+  try {
+    function walk(dir) {
+      if (!fs.existsSync(dir)) return;
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          if (entry.name === "__pycache__") {
+            fs.rmSync(full, { recursive: true, force: true });
+          } else {
+            walk(full);
+          }
+        }
+      }
+    }
+    walk(pkgDir);
+    console.log("  ✓ 已清除 Python 字节码缓存");
+  } catch (_) {}
+}
+
 function cmdUninstall() {
   const venvDir = getVenvDir();
   const dataDir = getDataDir();

package/worklog.md

@@ -0,0 +1,306 @@
+---
+Task ID: 1
+Agent: Main Agent
+Task: 移动端多项UI修复
+
+Work Log:
+- 分析了 chat_main.js, chat.css, right_agents.html, left_sessions.html, index.html, groupchat.js 等文件
+- 定位并修复了 newChat() 不关闭移动端侧边栏的问题
+- 定位并修复了 quickChatAgent() 和 selectGroup() 不关闭移动端右侧栏的问题
+- 定位了右侧agent面板在collapsed状态下，mobile CSS的 display:flex!important 缺少 flex-direction:column 导致内容横向排列的bug
+- 修复了移动端collapsed状态下版本号/更新信息被 display:none 隐藏的问题
+- 对admin后台(index.html)的sidebar-footer-text在移动端collapsed+mobile-open状态下也做了显示修复
+- 版本号bump: CSS v3→v4, JS v2→v3
+
+Stage Summary:
+- 修改文件: web/ui/chat/chat.css, web/ui/chat/chat_main.js, web/ui/chat/groupchat.js, web/ui/index.html, web/ui/chat/chat_container.html
+- 已 commit & push (4ec4726)
+
+---
+Task ID: 2
+Agent: Main Agent
+Task: 修复聊天消息排版混乱和脚本注入漏洞
+
+Work Log:
+- 分析了 renderMarkdown() 函数，发现所有 markdown 转换（行内代码、粗体、斜体、列表、引用块）均未对内容进行 HTML 转义
+- 发现漏洞：agent 回复中的 HTML 标签可以执行 JavaScript（XSS），也可以破坏页面布局（如注入未闭合的 div）
+- 实现了 3 层防护：
+  1. renderMarkdown() 重写：先提取代码块为占位符 → escapeHtml() 转义所有 HTML → 应用 markdown 转换 → 还原代码块
+  2. CSS 容器隔离：message-bubble / group-msg-bubble / thought-content / msg-timeline 添加 overflow:hidden 防溢出
+  3. 代码块 pre 添加 max-width:100% + white-space:pre-wrap 防止代码块撑破容器
+- 确认了 flow_engine.js 中的 renderInlineExecEvent()、showExecResultModal()、showToolResultModal() 均已正确使用 escapeHtml()
+- 版本号 bump: 1.8.5 → 1.8.6, CSS v4→v5, JS v3→v4
+
+Stage Summary:
+- 修改文件: web/ui/chat/chat_main.js, web/ui/chat/chat.css, package.json, web/ui/chat/chat_container.html, web/ui/chat/chat.js
+- 修复了 XSS 漏洞和排版破坏问题
+
+---
+Task ID: 1
+Agent: main
+Task: 部门Agent管理 + 工具调用保存 + 会话分页加载 (v1.9.0)
+
+Work Log:
+- 拉取最新代码 (git pull --rebase)
+- 修改 web/ui/index.html: 部门详情页 showDeptDetail() 新增Agent成员管理面板（添加/移除）
+- 修改 web/ui/index.html: renderDeptTree() 显示成员数量标签
+- 修改 web/ui/index.html: openCreateAgentModal() 新增部门选择下拉框
+- 修改 web/ui/index.html: openEditAgentModal() 部门选择支持子部门路径
+- 修改 web/ui/index.html: 新增 _flattenDepts() 辅助函数
+- 修改 web/ui/index.html: viewSession() 改为分页加载 + 工具调用折叠显示
+- 修改 web/api_server.py: handle_create_agent 支持 department 字段
+- 修改 web/api_server.py: handle_update_agent allowed_fields 添加 department
+- 修改 web/api_server.py: handle_get_messages/handle_get_messages_query 支持 limit/offset 分页
+- 修改 agents/main_agent.py: 处理完成后保存执行事件为 role=tool 短期记忆
+- 修改 memory/manager.py: get_conversation 默认 limit 从50提升到500
+- 修改 web/ui/chat/chat_main.js: selectSession 不再过滤 tool 角色
+- 修改 web/ui/chat/chat_main.js: _renderMessagesInner 新增 tool 角色折叠显示
+- 版本号升级到 1.9.0
+- git commit + git push 成功
+- npm publish 失败（登录凭证过期）
+
+Stage Summary:
+- 部门管理现在可以添加/移除Agent成员
+- 创建和编辑Agent时可以指定所属部门（支持子部门）
+- 工具调用过程现在会保存为role=tool的短期记忆
+- 会话消息API支持分页（limit/offset参数）
+- 聊天页面和管理后台都能查看工具调用过程
+
+---
+Task ID: 1
+Agent: Main Agent
+Task: 修复 V2 finish回调逻辑 + 轻量测试服务验证
+
+Work Log:
+- 分析 _process_v2_inner 中的 V2 循环逻辑，发现 finish 检查位置错误
+- 原逻辑: Step 10 先检查 finish=true 直接 break（工具不执行），Step 11 工具执行后只看 need_callback
+- 修复后: Step 10 先执行工具 → Step 12 工具执行完检查 finish（优先级最高）→ 再检查 need_callback
+- 提交 58be408 并推送到远程仓库
+- 搭建轻量 HTTP 测试服务器 (server.py)，使用 ModelScope API 直接验证 V2 全链路
+- 运行 3 个测试场景全部通过:
+  1. 搜索场景: finish=false, callback=false → no_callback（正确）
+  2. 问候场景: finish=true, 有工具 → finish_after_tools（修复验证）
+  3. 机票场景: finish=true, askuser非空 → ask_user（正确）
+
+Stage Summary:
+- 关键修复: finish 标志是最终决策者，优先级高于工具级 callback
+  - finish=true → 即使工具 callback=true 也不回调 LLM
+  - finish=false → 根据工具 callback 标志决定是否回调
+- 测试服务器文件: /home/z/my-project/download/v2-test-server/server.py
+- 所有更改已推送至 ctz168/myagent main 分支
+
+---
+Task ID: stream-test
+Agent: main
+Task: 使用轻量测试环境对前后端流式输出进行全面测试
+
+Work Log:
+- 分析项目架构：LLM客户端(chat_stream)、前端(flow_engine.js SSE)、API服务(handle_chat_stream)
+- 发现 test/server.py 仅有非流式 /api/chat 端点，前端使用标准 fetch JSON 响应
+- 升级 test/server.py：新增 /api/chat/stream SSE 流式端点，支持 7 种事件类型
+- 升级 test/index.html：新增流式 Agent 循环标签页，实时渲染 text_delta/v2_tool/v2_parse 等事件
+- 发现并修复 core/llm.py _stream_openai 的 AsyncOpenAI 流式迭代 bug (coroutine is not iterable)
+- 验证单轮迭代：1+1 简短回答，25 chunks，TTFT=13.5s，parse_success=true
+- 验证多轮迭代：天气查询→工具执行→回调→二次处理，2 轮迭代，123 SSE 事件，finish 正确
+- 运行单元测试：output_parser(get_knowledge)、context_builder(knowledge) 全部通过
+
+Stage Summary:
+- SSE 流式端点 /api/chat/stream 完整实现，支持 7 种事件类型
+- 前端流式渲染面板，含 TTFT 统计、自动滚动、停止按钮
+- 修复 core/llm.py AsyncOpenAI 流式调用关键 bug
+- 代码已推送到 origin/main (commit ce63c16)
+
+---
+Task ID: 1
+Agent: main
+Task: 测试前端输入"你好"后无回复的问题，验证前后端流式通信
+
+Work Log:
+- 启动 test/server.py 测试服务器，验证 /api/health 正常
+- 用 curl 直接测试 /api/chat/stream SSE 端点，确认后端流式输出正常
+- 用 Python 直接调用 event_generator 确认 SSE 事件完整（session/iteration_start/text_delta/v2_parse/v2_task_plan/v2_ask/iteration_end/done）
+- 发现 uvicorn 后台进程容易被 shell 退出时杀死，影响测试稳定性
+- 编写 test_e2e_runner.py 自包含 E2E 测试脚本（自动启停服务器+Playwright）
+- 运行 Playwright 流式测试：PASS（7个事件渲染，0错误，43个SSE事件，8.6s完成）
+- 运行 Playwright 非流式测试：PASS（1次迭代成功）
+- 用 VLM 视觉分析截图确认前端 UI 渲染正确
+- 更新 test_automated.py 新增流式SSE浏览器测试用例
+- 更新测试说明.md 增加流式API和E2E测试文档
+- 推送代码到 GitHub: 2ce96cc
+
+Stage Summary:
+- 前后端流式通信完全正常，用户遇到的"无回复"很可能是服务器未启动或提前崩溃
+- SSE 流式输出验证通过：43个chunk，完整的 8 种事件类型
+- E2E 测试工具链已就绪：test_e2e_runner.py 一键运行
+- 截图保存在 /home/z/my-project/download/stream_test_result.png
+
+---
+Task ID: 1
+Agent: Main Agent
+Task: 修复前端V2模式下"无回复"和刷新后排版断裂问题
+
+Work Log:
+- 分析 flow_engine.js sendMessage() 的 SSE 事件处理流程
+- 发现根因：V2模式下 text_delta 事件包含原始XML（<output><usersays_correct>...），被当作用户可见内容
+- 发现根因：最终 content 仅从 msgParts.filter(p.type==='text') 组装，但 V2 的用户文本来自 v2_reasoning/v2_ask_user 事件
+- 发现根因：flushCurrentText() 在 V2 模式下将原始 XML 推入 msgParts，导致 content 是原始标签而非中文文本
+- 新增 _isV2Mode 标志位（通过 v2_context 事件激活）
+- 新增 _v2RawXml 分离存储（V2模式下 text_delta 不再混入 msgParts）
+- 新增 _assembleV2Content() 函数，按优先级组装最终内容：v2_reasoning > _askUser > V1 text parts > server content > '(无回复)'
+- 修复 flushCurrentText() 在 V2 模式下不将 raw XML 推入 msgParts
+- 修复 text_delta handler：V2模式下显示 v2_reasoning 文本而非原始XML
+- 修复 v2_reasoning handler：多事件间添加 \n\n 分隔符，同时更新 content 和 _streamingText
+- 修复 done/finalization handler：使用 _assembleV2Content() 替代旧的 filter+join 逻辑
+- 修复 queue_start/clear_text handler：同样使用 _assembleV2Content()
+- 所有旧式 "msgParts.filter(p=>p.type==='text').join('\\n\\n') || '(无回复)'" 已替换为 _assembleV2Content()
+
+Stage Summary:
+- 修改文件: web/ui/chat/flow_engine.js
+- 核心修复：V2模式用户可见内容现在来自 v2_reasoning/v2_ask_user 事件，不再显示原始XML
+- 后向兼容：V1模式行为不变（text_delta 仍然是用户可见内容）
+
+---
+Task ID: 3
+Agent: Main Agent
+Task: 修复聊天页面三个渲染Bug + web_search结果传递给LLM的问题
+
+Work Log:
+- **web_search结果传递问题**: 定位到 _extract_tool_output() 函数优先返回 message 摘要("找到16条结果")而忽略 data 字段中的URL。修复: 新增 _format_data_for_llm() 智能格式化函数，优先处理 data 字段；增大搜索类工具输出截断限制到6000字符
+- **推理框闪烁**: 推理块(thought-block)每次 throttledStreamUpdate(~12fps)都用 outerHTML 完全重建，包括 renderMarkdown() 重渲染全部内容。修复: 改为增量更新——只更新字数统计/badge，用 insertAdjacentHTML 追加新增文本
+- **消息位置错乱**: updateStreamingMessage() 通过计算 .assistant 行找目标消息，但 msgIdx 是全局索引(含user/tool行)，导致匹配错位。修复: 改为计算所有 .message-row 行来匹配 msgIdx
+- **聊天历史显示XML**: 后端存储了 LLM 原始 XML 输出(key=llm_output)到数据库，刷新后前端加载显示裸XML。修复: 
+  - 后端 api_server.py: handle_get_messages/query 过滤掉 _HIDDEN_KEYS = {llm_output, tool_call, tool_result}
+  - 前端 chat_main.js: selectSession/loadMoreMessages 加载时对 XML 内容执行 _stripXmlTags 清理
+
+Stage Summary:
+- 修改文件: agents/main_agent.py, web/ui/chat/flow_engine.js, web/ui/chat/chat_main.js, web/api_server.py
+- agents/main_agent.py: _extract_tool_output() 重写 + _format_data_for_llm() + 截断限制增大
+- flow_engine.js: 推理框增量更新、消息索引修正
+- chat_main.js: 消息加载时XML清理
+- api_server.py: 聊天历史API过滤内部键
+
+---
+Task ID: 2
+Agent: Main Agent
+Task: v1.15.3 - 修复 LLM 调用 400 错误 (缺少 user role 消息)
+
+Work Log:
+- 定位根因: main_agent.py 的 _process_v2_inner() 在构建 LLM 消息时，首次迭代（无工具输出）只发送了 system 消息，缺少 role=user 的消息
+- OpenAI 兼容 API 要求消息列表中至少包含一条 role=user 的消息，否则返回 400 错误
+- 修复: 在 else 分支中，当 all_tool_outputs 为空时，追加一条 role=user 的消息，内容为 context.user_message 或默认文本 "请处理上述上下文。"
+- 额外改进: LLM 调用失败时将错误信息保存到会话记忆，刷新后仍可见
+
+Stage Summary:
+- 修改文件: agents/main_agent.py, package.json
+- version: 1.15.2 → 1.15.3
+- 核心修复: 确保每次 LLM 调用的 messages 数组始终包含 role=user 消息
+
+---
+Task ID: 3
+Agent: Main Agent
+Task: v1.15.4 - 四项前端修复 (流式MD渲染/工具详情/推理持久化/滚动持久化)
+
+Work Log:
+- 修复流式输出时未闭合代码块显示裸MD: 改写 renderMarkdown() 的 Step 1.5，检测最后一个未闭合的 ``` 开头，将其内容渲染为带 streaming-code-block 样式的代码块（左边框脉动动画）
+- 修复工具执行详情按钮点击无效: 所有 showToolResultModal/showExecResultModal 的 onclick 中 eventId 未加引号，字符串ID无法作为JS标识符传递。统一添加引号，匹配逻辑改为 String(e.id) === String(eventId)
+- 修复刷新后推理过程丢失: 
+  - LLMResponse 新增 reasoning 字段，_call_llm_stream 返回 full_reasoning
+  - main_agent.py 将推理文本以 key=reasoning 保存到会话记忆
+  - 前端 groupHistoryMessages 识别 key=reasoning 消息，合并到分组消息的 reasoning 字段
+- 修复滚动位置不持久化: 
+  - 新增 saveScrollPosition()/restoreScrollPosition() 函数
+  - 滚动事件触发防抖保存
+  - saveUIState() 中立即保存（beforeunload 时）
+  - selectSession() 渲染后恢复滚动位置
+
+Stage Summary:
+- 修改文件: package.json, core/llm.py, agents/base.py, agents/main_agent.py, web/ui/chat/chat_main.js, web/ui/chat/flow_engine.js, web/ui/chat/chat.css
+- version: 1.15.3 → 1.15.4
+- 核心修复: 流式Markdown渲染、工具详情弹窗、推理过程持久化、滚动位置持久化
+
+---
+Task ID: 4
+Agent: Main Agent
+Task: v1.15.5 - 推理框宽度/finish_reason显示/TTS播报/STT自动安装
+
+Work Log:
+- 修复推理过程框文本宽度: thought-content 添加 box-sizing:border-box，子元素 p/pre 添加 width:100%;max-width:100%;box-sizing:border-box，message-content 内联样式补全 width:100%
+- 实现 finish_reason 展示: v2_output_parsed 事件中 finish=true 时，将 finish_reason 存到 msg._v2FinishReason；渲染时在 taskPlan 之后显示绿色左边框标签；流式更新时动态插入 DOM
+- 实现 finish_reason TTS/通知逻辑: 
+  - TTS 未在播报且已开启 → 调用 ttsManager.speakText() 直接播报
+  - TTS 正在播报 → 弹出带双音提示音的通知窗口（5秒自动关闭）
+  - TTS 未开启 → 仅在消息中显示文字
+- 新增 ttsManager.speakText() 方法: 支持直接传入文本进行 TTS 播报（不依赖消息索引）
+- 新增 _showFinishNotification() 函数: 双音提示 + 弹窗通知
+- 修复 STT 安装问题: 
+  - deps_checker.py 添加 faster-whisper 依赖项（category=stt）
+  - deps_checker.py category_map 添加 stt 映射
+  - start.js CORE_PACKAGES 添加 faster-whisper
+  - api_server.py handle_voice_stt 的 ImportError 处理中添加自动安装逻辑（ensure_skill_deps）
+  - 前端错误提示改为友好信息
+
+Stage Summary:
+- 修改文件: package.json, core/deps_checker.py, web/api_server.py, web/ui/chat/chat_main.js, web/ui/chat/flow_engine.js, web/ui/chat/chat.css, start.js
+- version: 1.15.4 → 1.15.5
+- 核心修复: 推理框宽度、finish_reason展示+TTS播报、STT自动安装
+
+---
+Task ID: 5
+Agent: Main Agent
+Task: v1.15.5 后续修复 — 弹出窗口链接、部门侧栏、成员数、后台部门详情
+
+Work Log:
+- 修复弹出窗口(popout)链接错误: new URL('.', ...).href + 'chat/...' 导致双路径问题，改为 window.location.origin + '/ui/chat/chat_container.html'
+- 修复右侧边栏部门点击不展开: renderRpDeptNode 的 .rp-dept-item div 添加 onclick="toggleRpDept()"，点击部门名称即可展开/折叠显示 agent 列表
+- 部门名称后始终显示成员数: 之前仅在 agentCount > 0 时显示，改为始终显示 "(N成员)" 标签（chat_main.js 右侧面板、renderDeptItem、admin renderDeptTree）
+- 修复后台部门成员数不准: departments/manager.py get_dept() 方法返回结果补充 agent_count 字段（动态计算 len(meta.agents)）
+- 重构后台部门详情弹窗(index.html showDeptDetail):
+  - 保存/关闭按钮移至页面最底部（justify-content:flex-end）
+  - 成员列表改为行列表样式（每行带背景、emoji、名称、部长标签、删除按钮）
+  - 删除按钮从 × 改为明显的"删除"文字按钮(btn-danger 样式)
+  - 暂无成员时显示带虚线边框的空状态提示
+
+Stage Summary:
+- 修改文件: web/ui/chat/chat_main.js, web/ui/index.html, departments/manager.py
+- version: 1.15.5 (unchanged, cumulative fixes)
+- 核心修复: popout链接、部门点击展开、成员数显示、后台部门详情弹窗布局
+
+---
+Task ID: 6
+Agent: Main Agent
+Task: context_window 从配置动态读取，不再硬编码 128000
+
+Work Log:
+- 发现 context_builder.py:738 硬编码 window=128000，完全忽略了模型配置的 context_window
+- LLMClient.__init__ 新增 context_window 参数（默认 128000）
+- main.py 创建 LLMClient 时传入 context_window=llm_cfg.context_window
+- ContextBuilder.__init__ 新增 context_window 参数，_enforce_token_budget() 改用 self.context_window
+- init_context_builder() 自动从 self.llm.context_window 读取并传给 ContextBuilder
+- _hot_reload_llm() 新增 context_window 同步到所有 agent 的 context_builder
+- _build_model_chain() 在模型链字典中加入 context_window 字段
+- _try_model_chain_inner/_stream_inner 切换模型时同步 context_window 到 context_builder
+- _try_model_chain_inner/_stream_inner 的 finally 恢复原始 context_window
+- get_llm_client() 工厂函数传入 context_window
+
+Stage Summary:
+- 修改文件: core/llm.py, core/context_builder.py, main.py, agents/main_agent.py, web/api_server.py
+- version: 1.15.5 → 1.15.6
+- 核心修复: context 截断现在根据模型配置中的 context_window 动态调整，不再硬编码 128000
+- 影响范围: 启动初始化、热重载、模型链切换（含 fallback）都会正确同步 context_window
+
+---
+Task ID: 7
+Agent: Main Agent
+Task: knowledge写入隔离 + 注释聊天历史注入
+
+Work Log:
+- 发现 _save_knowledge_to_base() 总是写入 organization/knowledge/auto_knowledge/，导致所有 agent 知识混在一起
+- 修改 _save_knowledge_to_base() 优先写入 agent_knowledge_dir（agent 专属目录），无 agent KB 时才回退 knowledge_base_dir（组织 KB）
+- 注释掉 build_context() 中的 _build_recent_dialog() 调用，不再注入 <resentdialog> 聊天历史
+- 现在上下文仅包含：datetime + whoami + automemory + recall_memory + knowledge + user_input + task_plan + tools
+- 用户最新消息通过 messages[role=user] 直接传入 LLM，工具执行结果通过 all_tool_outputs 传入
+
+Stage Summary:
+- 修改文件: agents/main_agent.py, core/context_builder.py
+- version: 1.15.6 (cumulative)
+- 核心修复: knowledge 写入隔离到 agent 目录；取消聊天历史注入，依赖系统记忆