myagent-ai 1.24.5 → 1.25.0

package/core/agent_storage.py

@@ -393,6 +393,7 @@ class AgentStorage:
     def migrate_from_json(self, agents_dir: Path, force: bool = False) -> dict:
         """
         从文件系统迁移 agent 配置到数据库。
+        迁移完成后删除 config.json 防止重复迁移。
 
         Args:
             agents_dir: agents 数据目录路径（~/.myagent/data/agents/）
@@ -408,6 +409,13 @@ class AgentStorage:
             logger.info(f"Agent 数据目录不存在，跳过迁移: {agents_dir}")
             return result
 
+        # [v1.24.5] 检查迁移标记文件，如果已迁移过则跳过
+        _migrated_flag = agents_dir.parent / ".migrated_to_db"
+        if _migrated_flag.exists() and self.count() > 0 and not force:
+            logger.info(f"数据库已有 {self.count()} 个 agent，且迁移标记存在，跳过迁移")
+            result["skipped"] = self.count()
+            return result
+
         if self.count() > 0 and not force:
             logger.info(f"数据库已有 {self.count()} 个 agent，跳过迁移（使用 force 强制重新迁移）")
             result["skipped"] = self.count()
@@ -457,6 +465,13 @@ class AgentStorage:
         with self._lock:
             conn.commit()
 
+        # [v1.24.5] 迁移完成后写入标记文件，防止卸载重装后重复迁移
+        if result["migrated"] > 0:
+            try:
+                _migrated_flag.write_text(now, encoding="utf-8")
+            except Exception as e:
+                logger.warning(f"写入迁移标记失败: {e}")
+
         logger.info(f"Agent 配置迁移完成: {result['migrated']} 迁移, {result['skipped']} 跳过, {result['errors']} 错误")
         return result
 

package/package.json

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

package/skills/admin-manager/SKILL.md

@@ -0,0 +1,560 @@
+---
+name: admin-manager
+description: |
+  后台管理技能 — 赋能 AI 助手通过 API 完成所有后台管理操作，包括大模型管理、Agent 管理、组织架构管理、部门管理等。
+  适用于配置助手和管理场景，让 AI 可以直接帮用户管理整个 MyAgent 系统。
+metadata:
+  category: admin
+  version: "1.0.0"
+---
+
+# 后台管理技能 (Admin Manager)
+
+你拥有完整的后台管理权限，可以通过调用 MyAgent 的 RESTful API 来管理整个系统。
+以下是你可用的所有管理操作指南。
+
+## 重要规则
+
+- **所有管理操作必须通过 API 完成**，禁止直接修改数据库文件或配置文件。
+- 操作前应先通过 GET 请求了解当前状态，确认操作安全后再执行修改。
+- 对于删除操作，务必先确认用户意图，避免误删。
+- 所有 API 的基础 URL 为 `http://localhost:8767`（即当前服务地址），以下省略前缀。
+- 调用 API 使用 `requests` 库或 `httpx` 库，推荐使用 `requests`。
+
+---
+
+## 一、大模型管理 (Model Management)
+
+模型库管理支持添加、编辑、删除、测试大模型配置。每个模型可以独立配置 provider、API Key、base URL 等参数。
+
+### 1.1 列出所有模型
+
+```
+GET /api/models
+```
+
+返回模型列表，每个模型包含: `id`, `name`, `provider`, `api_type`, `model`, `base_url`, `api_key`, `max_tokens`, `temperature`, `context_window`, `input_modes`, `reasoning`, `enabled`, `is_global_fallback`。
+
+### 1.2 添加模型
+
+```
+POST /api/models
+Content-Type: application/json
+
+{
+  "id": "my-gpt4o",           // 唯一标识符，必填
+  "name": "我的 GPT-4o",      // 显示名称
+  "provider": "openai",       // openai | anthropic | ollama | zhipu | deepseek | moonshot | qwen | modelscope | custom
+  "api_type": "openai-completions",  // openai-completions | openai-chat | anthropic | ollama | custom
+  "model": "gpt-4o",          // API 调用使用的实际模型字符串
+  "base_url": "https://api.openai.com/v1",  // 自定义 API 地址
+  "api_key": "sk-...",        // 专用 API Key（留空则使用全局默认）
+  "max_tokens": 4096,
+  "temperature": 0.1,
+  "context_window": 128000,   // 上下文窗口大小
+  "input_modes": ["text", "image"],  // 支持的输入模式: text, image, video, audio
+  "reasoning": false,         // 是否支持推理（如 o1 系列）
+  "enabled": true,            // 是否启用
+  "is_global_fallback": true  // 是否作为全局兜底模型
+}
+```
+
+### 1.3 更新模型
+
+```
+PUT /api/models/{model_id}
+Content-Type: application/json
+
+{ 同添加模型的字段，只需传要修改的字段 }
+```
+
+### 1.4 删除模型
+
+```
+DELETE /api/models/{model_id}
+```
+
+### 1.5 测试模型连接
+
+```
+POST /api/llm/test
+Content-Type: application/json
+
+{
+  "model": "gpt-4o",
+  "base_url": "https://api.openai.com/v1",
+  "provider": "openai",
+  "temperature": 0.1,
+  "api_key": "sk-...",
+  "input_modes": ["text", "image"]
+}
+```
+
+### 常用 Provider 配置参考
+
+| Provider | base_url | 说明 |
+|----------|----------|------|
+| openai | https://api.openai.com/v1 | OpenAI 官方 |
+| custom (ModelScope) | https://api-inference.modelscope.cn/v1 | 阿里 ModelScope（推荐免费额度大）|
+| custom (DeepSeek) | https://api.deepseek.com/v1 | DeepSeek |
+| custom (Moonshot) | https://api.moonshot.cn/v1 | Kimi/Moonshot |
+| zhipu | https://open.bigmodel.cn/api/paas/v4 | 智谱 GLM |
+| ollama | http://localhost:11434 | 本地 Ollama |
+| anthropic | - | Anthropic Claude |
+
+---
+
+## 二、Agent 管理 (Agent Management)
+
+Agent 是 MyAgent 的核心概念，每个 Agent 拥有独立的人格、知识库、会话历史和权限配置。
+
+### 2.1 列出所有 Agent
+
+```
+GET /api/agents
+```
+
+返回所有 Agent 的扁平列表，包含: `path`, `id`, `name`, `description`, `avatar_color`, `avatar_emoji`, `avatar_image`, `execution_mode`, `enabled`, `system`, `system_prompt`, `model`, `model_id`, `backup_model_ids`, `parent`, `platform`, `department`, `work_dir`, `created_at`, `updated_at`, `session_count`。
+
+### 2.2 获取单个 Agent 详情
+
+```
+GET /api/agents/{agent_path}
+```
+
+除了基本信息外，还返回 `soul`, `identity`, `user` 等人格文件内容。
+
+### 2.3 创建 Agent
+
+```
+POST /api/agents
+Content-Type: application/json
+
+{
+  "name": "翻译助手",           // 名称，必填
+  "description": "专业翻译AI助手",  // 描述
+  "avatar_emoji": "🌐",         // 头像 emoji
+  "avatar_color": "#4f46e5",    // 头像颜色
+  "execution_mode": "sandbox",  // sandbox(沙盒) | local(本机)
+  "model_id": "gpt-4o",         // 绑定的模型 ID（留空用全局默认）
+  "backup_model_ids": ["claude-3.5-sonnet"],  // 备用模型列表
+  "system_prompt": "你是一个专业翻译助手...",  // 系统提示词
+  "work_dir": "",               // 自定义工作目录
+  "department": "技术部"         // 所属部门路径
+}
+```
+
+### 2.4 更新 Agent
+
+```
+PUT /api/agents/{agent_path}
+Content-Type: application/json
+
+{ 只需传要修改的字段，支持: name, description, avatar_emoji, avatar_color, avatar_image,
+  model_id, backup_model_ids, work_dir, system_prompt, execution_mode, enabled, department }
+```
+
+### 2.5 删除 Agent
+
+```
+DELETE /api/agents/{agent_path}
+```
+
+**注意**: 删除会同时清理工作目录、会话历史、记忆数据和所有子 Agent，不可撤销！
+
+### 2.6 创建子 Agent
+
+```
+POST /api/agents/{parent_path}/children
+Content-Type: application/json
+
+{
+  "name": "子助手名称",
+  "description": "子助手描述",
+  "system_prompt": "子助手系统提示词"
+}
+```
+
+### 2.7 管理 Agent 人格
+
+```
+# 获取 soul.md
+GET /api/agents/{agent_path}/soul
+
+# 设置 soul.md
+PUT /api/agents/{agent_path}/soul
+Content-Type: application/json
+{ "soul": "# Agent名称\n\n## 性格\n..." }
+
+# 获取 identity.md
+GET /api/agents/{agent_path}/identity
+
+# 设置 identity.md
+PUT /api/agents/{agent_path}/identity
+Content-Type: application/json
+{ "identity": "# 身份\n..." }
+
+# 获取 user.md
+GET /api/agents/{agent_path}/user
+
+# 设置 user.md
+PUT /api/agents/{agent_path}/user
+Content-Type: application/json
+{ "user": "# 用户信息\n..." }
+```
+
+### 2.8 管理 Agent 知识库
+
+```
+# 列出知识库文件
+GET /api/agents/{agent_path}/knowledge
+
+# 读取知识库文件
+GET /api/agents/{agent_path}/knowledge/file?path=xxx.md
+
+# 上传知识库文件
+POST /api/agents/{agent_path}/knowledge/upload
+Content-Type: multipart/form-data (files 字段)
+
+# 删除知识库文件
+DELETE /api/agents/{agent_path}/knowledge?path=xxx.md
+```
+
+### 2.9 查看 Agent 会话
+
+```
+# 列出 Agent 的所有会话
+GET /api/agents/{agent_path}/sessions
+
+# 查看会话消息
+GET /api/sessions/{session_id}/messages?limit=100
+```
+
+### 2.10 查看 Agent 权限
+
+```
+# 获取 Agent 权限
+GET /api/permissions/{agent_path}
+
+# 设置 Agent 权限
+PUT /api/permissions/{agent_path}
+Content-Type: application/json
+{ "command": true, "web_control": false, ... }
+
+# 重置为默认权限
+DELETE /api/permissions/{agent_path}
+```
+
+---
+
+## 三、组织管理 (Organization Management)
+
+### 3.1 获取/更新组织配置
+
+```
+# 获取组织配置
+GET /api/organization
+
+# 更新组织配置
+PUT /api/organization
+Content-Type: application/json
+{ "enabled": true, "knowledge_admin": "manager" }
+```
+
+### 3.2 获取/更新组织信息
+
+```
+# 获取组织信息
+GET /api/organization/info
+
+# 更新组织信息
+PUT /api/organization/info
+Content-Type: application/json
+{ "name": "我的公司", "description": "...", "contact": "...", "website": "..." }
+```
+
+### 3.3 管理组织知识库
+
+```
+# 列出知识库文件
+GET /api/organization/knowledge
+
+# 读取知识库文件
+GET /api/organization/knowledge/file?path=xxx.md
+
+# 上传知识库文件
+POST /api/organization/knowledge/upload
+Content-Type: multipart/form-data
+
+# 删除知识库文件
+DELETE /api/organization/knowledge?path=xxx.md
+```
+
+---
+
+## 四、部门管理 (Department Management)
+
+部门支持无限层级嵌套，每个部门可以有成员（Agent）、负责人、知识库和自动创建的群聊。
+
+### 4.1 获取部门树
+
+```
+GET /api/departments
+```
+
+返回树形结构，每个部门节点包含: `path`, `name`, `emoji`, `description`, `head`, `agents`, `agent_count`, `chat_group_id`, `children`。
+
+### 4.2 创建部门
+
+```
+POST /api/departments
+Content-Type: application/json
+
+{
+  "name": "技术部",        // 部门名称，必填
+  "emoji": "💻",            // 部门 emoji
+  "description": "负责技术研发",  // 描述
+  "parent": ""              // 父部门路径（空字符串=顶级部门）
+}
+```
+
+### 4.3 获取部门详情
+
+```
+GET /api/departments/{dept_path}
+```
+
+### 4.4 更新部门基本信息
+
+```
+PUT /api/departments/{dept_path}
+Content-Type: application/json
+{ "name": "新名称", "emoji": "🚀" }
+```
+
+### 4.5 更新部门详细信息（描述、负责人等）
+
+```
+PUT /api/departments/{dept_path}/info
+Content-Type: application/json
+{ "description": "新的部门描述", "head_name": "agent_name" }
+```
+
+### 4.6 删除部门
+
+```
+DELETE /api/departments/{dept_path}
+```
+
+**注意**: 会递归删除所有子部门、自动解散关联的群聊，不可撤销！
+
+### 4.7 管理部门成员
+
+```
+# 添加/移除成员
+PUT /api/departments/{dept_path}/agents
+Content-Type: application/json
+{ "agents": ["coder", "translator"], "action": "add" }  // action: add | remove | set
+
+# 设置部门负责人
+PUT /api/departments/{dept_path}/head
+Content-Type: application/json
+{ "head": "agent_name" }
+```
+
+### 4.8 管理部门知识库
+
+```
+# 列出知识库文件
+GET /api/departments/{dept_path}/knowledge
+
+# 读取知识库文件
+GET /api/departments/{dept_path}/knowledge/file?path=xxx.md
+
+# 上传知识库文件
+POST /api/departments/{dept_path}/knowledge/upload
+Content-Type: multipart/form-data
+
+# 删除知识库文件
+DELETE /api/departments/{dept_path}/knowledge?path=xxx.md
+```
+
+---
+
+## 五、群聊管理 (Group Chat Management)
+
+### 5.1 列出所有群聊
+
+```
+GET /api/groups
+```
+
+### 5.2 创建群聊
+
+```
+POST /api/groups
+Content-Type: application/json
+{
+  "name": "群聊名称",
+  "description": "群聊描述",
+  "avatar_emoji": "👥",
+  "owner": "agent_path"
+}
+```
+
+### 5.3 群成员管理
+
+```
+# 添加成员
+POST /api/groups/{group_id}/members
+Content-Type: application/json
+{ "agent_path": "agent_name", "role": "member" }
+
+# 移除成员
+DELETE /api/groups/{group_id}/members/{agent_path}
+
+# 设置成员角色
+PUT /api/groups/{group_id}/members/{agent_path}/role
+Content-Type: application/json
+{ "role": "owner" }  // owner | admin | member
+
+# 设置成员禁言
+PUT /api/groups/{group_id}/members/{agent_path}/mute
+Content-Type: application/json
+{ "muted": true }
+```
+
+---
+
+## 六、全局 LLM 配置 (Global LLM Config)
+
+### 6.1 获取当前 LLM 配置
+
+```
+GET /api/llm
+```
+
+### 6.2 更新全局 LLM 配置
+
+```
+PUT /api/llm
+Content-Type: application/json
+{
+  "provider": "openai",
+  "api_key": "sk-...",
+  "base_url": "https://api.openai.com/v1",
+  "model": "gpt-4o",
+  "temperature": 0.1,
+  "max_tokens": 4096,
+  "context_window": 128000
+}
+```
+
+### 6.3 获取用量统计
+
+```
+GET /api/llm/usage
+```
+
+---
+
+## 七、权限管理 (Permissions)
+
+### 7.1 获取全局权限配置
+
+```
+GET /api/permissions
+```
+
+### 7.2 设置全局默认权限
+
+```
+PUT /api/permissions/defaults
+Content-Type: application/json
+{ "command": true, "web_control": false, ... }
+```
+
+---
+
+## 八、配置导入导出 (Config Import/Export)
+
+### 8.1 导出配置
+
+```
+POST /api/config/export
+Content-Type: application/json
+{ "include_secrets": false }  // 是否包含 API Key 等敏感信息
+```
+
+### 8.2 导入配置
+
+```
+POST /api/config/import
+Content-Type: application/json
+{ ...config_data..., "overwrite": false }  // false=合并, true=完全覆盖
+```
+
+### 8.3 热重载配置
+
+```
+POST /api/config/reload
+```
+
+---
+
+## 九、记忆管理 (Memory)
+
+### 9.1 搜索记忆
+
+```
+GET /api/memory/search?keyword=xxx&limit=20
+```
+
+### 9.2 获取记忆统计
+
+```
+GET /api/memory/stats
+```
+
+### 9.3 清理过期记忆
+
+```
+POST /api/memory/cleanup
+```
+
+---
+
+## 十、典型管理场景
+
+### 场景1: 首次配置 LLM
+
+1. 推荐使用 ModelScope 免费 API:
+   - provider: `custom`
+   - base_url: `https://api-inference.modelscope.cn/v1`
+   - 推荐模型: `stepfun-ai/Step-3.5-Flash`
+2. 添加模型到模型库: `POST /api/models`
+3. 设置为全局默认: `PUT /api/llm`
+4. 测试连接: `POST /api/llm/test`
+
+### 场景2: 创建多 Agent 团队
+
+1. 创建部门: `POST /api/departments` (如 "技术部"、"市场部")
+2. 创建多个 Agent: `POST /api/agents` (如 "代码专家"、"翻译助手")
+3. 分配 Agent 到部门: `PUT /api/departments/{path}/agents`
+4. 设置部门负责人: `PUT /api/departments/{path}/head`
+5. 为每个 Agent 配置独立的人格和知识库
+
+### 场景3: Agent 个性化配置
+
+1. 创建 Agent 并设置 system_prompt
+2. 通过 soul.md 定义 Agent 的性格特征
+3. 通过 identity.md 定义 Agent 的身份背景
+4. 上传专业知识到知识库
+5. 绑定专用模型以获得最佳效果
+
+### 场景4: 模型切换与故障转移
+
+1. 在模型库中添加多个模型
+2. 为关键 Agent 设置 model_id 和 backup_model_ids
+3. 设置 is_global_fallback 标记兜底模型
+4. 当主模型不可用时，系统自动切换到备用模型

package/web/api_server.py

@@ -146,13 +146,72 @@ async def _read_multipart_files(request):
 
 
 
-CONFIG_HELPER_PROMPT = """你是 MyAgent 的智能配置助手，专门帮助用户完成初始配置和日常配置管理。你的名字叫"配置助手"。
+CONFIG_HELPER_PROMPT = """你是 MyAgent 的智能配置助手，拥有完整的后台管理权限。你的名字叫"配置助手"。
 
 ## 你的核心职责
-1. **引导新用户**：首次使用时，友好地介绍 MyAgent 的功能，帮助用户完成初始配置
-2. **配置管理**：帮助用户修改配置（LLM模型、执行引擎、权限等）
-3. **Agent 创建指导**：帮助用户创建和配置新的 Agent
-4. **问题解答**：回答用户关于 MyAgent 使用的问题
+1. **后台管理**：通过 API 直接管理大模型、Agent、组织、部门、群聊等所有系统资源
+2. **引导新用户**：首次使用时，友好地介绍 MyAgent 的功能，帮助用户完成初始配置
+3. **配置管理**：帮助用户修改配置（LLM模型、执行引擎、权限等）
+4. **Agent 管理**：创建、编辑、删除 Agent，配置人格、知识库、权限等
+5. **组织架构**：管理部门体系，分配成员，维护组织知识库
+6. **问题解答**：回答用户关于 MyAgent 使用的问题
+
+## 管理权限
+你拥有完整的后台管理权限，可以直接通过调用本地 API 来管理整个系统。
+所有 API 基础地址: `http://localhost:8767`
+调用方式: 使用 Python `requests` 库发起 HTTP 请求。
+
+## 后台管理 API 速查
+
+### 大模型管理
+- **列出模型**: `GET /api/models`
+- **添加模型**: `POST /api/models` — 参数: `id`(必填), `name`, `provider`(openai/anthropic/ollama/zhipu/deepseek/moonshot/qwen/modelscope/custom), `api_type`, `model`, `base_url`, `api_key`, `max_tokens`, `temperature`, `context_window`, `input_modes`(["text","image","video","audio"]), `reasoning`, `enabled`, `is_global_fallback`
+- **更新模型**: `PUT /api/models/{model_id}` — 同上字段，只需传修改项
+- **删除模型**: `DELETE /api/models/{model_id}`
+- **测试模型**: `POST /api/llm/test` — 参数: `model`, `base_url`, `provider`, `api_key`, `input_modes`
+- **全局LLM配置**: `GET/PUT /api/llm` — 设置全局默认模型
+- **用量统计**: `GET /api/llm/usage`
+
+### Agent 管理
+- **列出Agent**: `GET /api/agents`
+- **创建Agent**: `POST /api/agents` — 参数: `name`(必填), `description`, `avatar_emoji`, `avatar_color`, `execution_mode`(sandbox/local), `model_id`, `backup_model_ids`, `system_prompt`, `work_dir`, `department`
+- **获取Agent**: `GET /api/agents/{path}`
+- **更新Agent**: `PUT /api/agents/{path}` — 支持所有创建字段及 `enabled`
+- **删除Agent**: `DELETE /api/agents/{path}` — 会同时删除子Agent、会话、工作目录，不可撤销！
+- **创建子Agent**: `POST /api/agents/{parent}/children`
+- **Agent人格**: `GET/PUT /api/agents/{path}/soul`, `identity`, `user`
+- **Agent知识库**: `GET /api/agents/{path}/knowledge`, `POST .../knowledge/upload`, `DELETE .../knowledge?path=`
+- **Agent会话**: `GET /api/agents/{path}/sessions`
+- **Agent权限**: `GET/PUT/DELETE /api/permissions/{path}`
+
+### 组织管理
+- **组织配置**: `GET/PUT /api/organization` — `enabled`, `knowledge_admin`
+- **组织信息**: `GET/PUT /api/organization/info` — `name`, `description`, `contact`, `website`
+- **组织知识库**: `GET /api/organization/knowledge`, `POST .../knowledge/upload`, `DELETE .../knowledge?path=`
+
+### 部门管理
+- **部门树**: `GET /api/departments`
+- **创建部门**: `POST /api/departments` — 参数: `name`(必填), `emoji`, `description`, `parent`
+- **部门详情**: `GET /api/departments/{path}`
+- **更新部门**: `PUT /api/departments/{path}` — `name`, `emoji`
+- **更新部门详情**: `PUT /api/departments/{path}/info` — `description`, `head_name`
+- **删除部门**: `DELETE /api/departments/{path}` — 递归删除子部门和群聊，不可撤销！
+- **部门成员**: `PUT /api/departments/{path}/agents` — `agents`(list), `action`(add/remove/set)
+- **部门负责人**: `PUT /api/departments/{path}/head` — `head`(agent_name)
+- **部门知识库**: `GET /api/departments/{path}/knowledge`, `POST .../knowledge/upload`, `DELETE .../knowledge?path=`
+
+### 群聊管理
+- **列出群聊**: `GET /api/groups`
+- **创建群聊**: `POST /api/groups` — `name`, `description`, `avatar_emoji`, `owner`
+- **群成员管理**: `POST/DELETE /api/groups/{gid}/members/{agent_path}`
+- **成员角色**: `PUT /api/groups/{gid}/members/{agent_path}/role`
+- **成员禁言**: `PUT /api/groups/{gid}/members/{agent_path}/mute`
+
+### 系统配置
+- **完整配置**: `GET /api/config`
+- **热重载**: `POST /api/config/reload`
+- **导出配置**: `POST /api/config/export` — `include_secrets`
+- **导入配置**: `POST /api/config/import` — `overwrite`
 
 ## 工作方式
 
@@ -165,31 +224,30 @@ CONFIG_HELPER_PROMPT = """你是 MyAgent 的智能配置助手，专门帮助用
      - provider: custom
      - base_url: https://api-inference.modelscope.cn/v1
      - 推荐模型：stepfun-ai/Step-3.5-Flash
-   - 也支持 OpenAI、Anthropic、Ollama（本地）、智谱GLM 等
+   - 也支持 OpenAI、Anthropic、Ollama（本地）、智谱GLM、DeepSeek、Moonshot 等
 4. 配置完成后，建议用户先从单个 Agent 开始使用
 5. 介绍核心功能：代码执行、文件操作、网络搜索、技能系统
 
-### 日常使用
-- 回答配置相关的问题
-- 帮助修改配置（你只能通过聊天引导用户去修改，或调用配置API）
-- 建议最佳实践
+### 日常管理
+当用户要求管理操作时，你应该：
+1. 先通过 GET 请求了解当前状态
+2. 确认用户意图后，通过 POST/PUT/DELETE 执行操作
+3. 操作完成后，向用户确认结果
+
+### 典型场景
+- **用户说"帮我添加一个模型"**: 调用 `POST /api/models` 添加，然后 `POST /api/llm/test` 测试
+- **用户说"创建一个翻译助手"**: 调用 `POST /api/agents` 创建，配置 system_prompt 和 model_id
+- **用户说"建一个技术部"**: 调用 `POST /api/departments` 创建部门
+- **用户说"把翻译助手加到技术部"**: 调用 `PUT /api/departments/{path}/agents` 分配成员
 
 ## 重要规则
-- **禁止编写代码创建 Agent**：当用户要求创建 Agent 或部门时，必须调用 API 操作，禁止通过编写 `.py` 文件或修改 `__init__.py` 来尝试在源码层级创建。
-- **配置优先原则**：MyAgent 是配置驱动的。创建 Agent 应使用 `POST /api/agents`，创建部门应使用 `POST /api/departments`。
-- 修改配置时，系统会自动备份和校验，确保配置不会被改坏。
-- 如果配置校验失败，修改不会生效，你需要告知用户并帮助修正。
-- 建议用户从单 Agent 开始使用，熟悉后再扩展。
+- **必须通过 API 操作**：所有管理操作必须通过 HTTP API 完成，禁止直接修改数据库文件或配置文件。
+- **禁止编写代码创建 Agent/部门**：禁止通过编写 `.py` 文件或修改 `__init__.py` 来尝试在源码层级创建。
+- **配置优先原则**：MyAgent 是配置驱动的。创建 Agent 用 `POST /api/agents`，创建部门用 `POST /api/departments`。
+- **删除前确认**：删除 Agent 和部门是不可逆操作，执行前务必确认用户意图。
+- **操作前先查询**：修改前先 GET 了解当前状态，避免误操作。
 - 使用中文回复，保持简洁友好。
 
-## 组织与 Agent 管理 API 指南
-当你需要帮助用户管理组织结构时，请优先使用以下 API（通过 `requests` 或 `http` 调用）：
-- **创建 Agent**: `POST /api/agents` (参数: `name`, `description`, `system_prompt`, `model_id`)
-- **创建子 Agent**: `POST /api/agents/{parent}/children` (参数: `name`, `description`, `system_prompt`)
-- **创建部门**: `POST /api/departments` (参数: `name`, `parent`)
-- **配置 Agent 灵魂/身份**: `PUT /api/agents/{name}/soul` 和 `PUT /api/agents/{name}/identity`
-- **分配 Agent 到部门**: `PUT /api/departments/{path}/agents` (参数: `agents`: list of names)
-
 ## 知识库
 你内置了 MyAgent 完整的配置使用说明文档。当用户询问时不确定的功能时，必须先参考知识库。
 """
@@ -484,6 +542,8 @@ class ApiServer:
         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)
         r.add_delete("/api/agent-chat/messages", self.handle_clear_agent_chat_messages)
+        # [v1.24.5] 所有用户-Agent私聊会话查看
+        r.add_get("/api/private-chats/sessions", self.handle_get_private_chat_sessions)
         # ── 部门管理 ──
         r.add_get("/api/departments", self.handle_dept_tree)
         r.add_post("/api/departments", self.handle_create_dept)
@@ -8411,6 +8471,103 @@ window.addEventListener('beforeunload', function() {{
         deleted = mgr.clear_agent_chats(group_id=gid)
         return web.json_response({"ok": True, "deleted": deleted})
 
+    # ── [v1.24.5] 所有用户-Agent 私聊会话 API ──
+
+    async def handle_get_private_chat_sessions(self, request):
+        """GET /api/private-chats/sessions - 获取所有用户与 Agent 的私聊会话列表
+        支持 ?agent=xxx 按指定 agent 筛选
+        """
+        if not self.core.memory:
+            return web.json_response([])
+        agent = request.query.get("agent", "")
+        conn = self.core.memory._get_conn()
+        _hidden = ('llm_output', 'llm_input', 'tool_result_raw', 'conversation_insight')
+
+        if agent:
+            # 按 agent 路径筛选：旧格式 session_id LIKE '{agent}_%' 或新格式 metadata 包含 agent_path
+            metadata_pattern = '%"agent_path":"' + agent + '"%'
+            rows = conn.execute(
+                "SELECT m.session_id, COUNT(*) as msg_count, MAX(m.created_at) as last_active "
+                "FROM memories m "
+                "WHERE m.category = 'session' AND m.role != '' "
+                "AND m.key NOT IN (?,?,?,?) "
+                "AND (m.session_id LIKE ? OR (m.session_id LIKE 'sess_%' AND m.metadata LIKE ?)) "
+                "GROUP BY m.session_id ORDER BY last_active DESC LIMIT 200",
+                (*_hidden, agent + "_%", metadata_pattern)
+            ).fetchall()
+        else:
+            # 所有非群聊会话（session_id 不以 'grp_' 开头）
+            rows = conn.execute(
+                "SELECT m.session_id, COUNT(*) as msg_count, MAX(m.created_at) as last_active "
+                "FROM memories m "
+                "WHERE m.category = 'session' AND m.role != '' "
+                "AND m.key NOT IN (?,?,?,?) "
+                "AND m.session_id NOT LIKE 'grp_%' "
+                "GROUP BY m.session_id ORDER BY last_active DESC LIMIT 200",
+                (*_hidden,)
+            ).fetchall()
+
+        # 获取每个 agent 的名称映射
+        agents_db = self._agent_store.list_all() if hasattr(self, '_agent_store') else []
+        agent_map = {}
+        for ac in agents_db:
+            agent_map[ac.path] = ac.name or ac.path
+
+        sessions = []
+        sids = [r["session_id"] for r in rows]
+        # 批量获取会话名称
+        name_map = self.core.memory.list_session_names(sids) if sids else {}
+
+        for r in rows:
+            sid = r["session_id"]
+            # 推断 agent 路径
+            agent_path = ''
+            agent_name = ''
+            if sid.startswith('grp_'):
+                continue
+            # 从新格式 metadata 中提取 agent_path
+            meta_row = conn.execute(
+                "SELECT metadata FROM memories WHERE session_id = ? AND metadata LIKE '%agent_path%' LIMIT 1",
+                (sid,)
+            ).fetchone()
+            if meta_row and meta_row["metadata"]:
+                try:
+                    meta = json.loads(meta_row["metadata"])
+                    agent_path = meta.get("agent_path", "")
+                except:
+                    pass
+            # 旧格式 fallback: 从 session_id 前缀提取
+            if not agent_path:
+                if '_web_' in sid:
+                    agent_path = sid.split('_web_')[0]
+                elif '_cli_' in sid:
+                    agent_path = sid.split('_cli_')[0]
+                else:
+                    agent_path = sid.split('_')[0] if '_' in sid else 'default'
+
+            agent_name = agent_map.get(agent_path, agent_path)
+            # 获取最后一条用户消息作为预览
+            preview = ''
+            preview_row = conn.execute(
+                "SELECT content FROM memories WHERE session_id = ? AND role = 'user' AND category = 'session' "
+                "ORDER BY created_at DESC LIMIT 1",
+                (sid,)
+            ).fetchone()
+            if preview_row:
+                preview = (preview_row["content"] or "")[:100]
+
+            sessions.append({
+                "id": sid,
+                "agent_path": agent_path,
+                "agent_name": agent_name,
+                "messages": r["msg_count"],
+                "last": r["last_active"],
+                "display_name": name_map.get(sid, ""),
+                "preview": preview,
+            })
+
+        return web.json_response(sessions)
+
     async def start(self, port: int = 8767, host: str = "127.0.0.1"):
         # 加载禁用技能列表
         self._load_disabled_skills()

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

@@ -1,30 +1,36 @@
 /**
- * [v1.23.37] Agent间私聊记录查看模块
- * 路径: /api/agent-chat/pairs, /api/agent-chat/messages
+ * [v1.24.5] 私聊记录查看模块
+ * 支持查看所有用户-Agent私聊会话 + Agent间群聊私聊记录
+ * 路径:
+ *   /api/private-chats/sessions      - 所有用户-Agent私聊（支持 ?agent=xxx 筛选）
+ *   /api/agent-chat/pairs            - Agent间私聊对
+ *   /api/agent-chat/messages         - Agent间私聊详情
  */
 async function renderAgentChat() {
   const content = $('content');
   if (!content) return;
 
-  let currentFilter = { group_id: '', from_agent: '', to_agent: '' };
+  let currentTab = 'user-agent'; // 'user-agent' | 'agent-agent'
+  let currentFilter = { group_id: '', agent: '' };
 
   function esc(s) { return (s || '').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;'); }
 
-  async function loadGroups() {
-    try {
-      const data = await api('/api/groups');
-      return Array.isArray(data) ? data : (data.groups || data.data || []);
-    } catch { return []; }
+  // ── 数据加载 ──
+  async function loadPrivateSessions() {
+    const q = new URLSearchParams();
+    if (currentFilter.agent) q.set('agent', currentFilter.agent);
+    const data = await api('/api/private-chats/sessions?' + q.toString());
+    return Array.isArray(data) ? data : [];
   }
 
-  async function loadPairs() {
+  async function loadAgentPairs() {
     const q = new URLSearchParams();
     if (currentFilter.group_id) q.set('group_id', currentFilter.group_id);
     const data = await api('/api/agent-chat/pairs?' + q.toString());
     return Array.isArray(data) ? data : [];
   }
 
-  async function loadMessages(fromAgent, toAgent) {
+  async function loadAgentMessages(fromAgent, toAgent) {
     const q = new URLSearchParams();
     if (currentFilter.group_id) q.set('group_id', currentFilter.group_id);
     if (fromAgent) q.set('from_agent', fromAgent);
@@ -34,79 +40,187 @@ async function renderAgentChat() {
     return Array.isArray(data) ? data : [];
   }
 
+  async function loadGroups() {
+    try {
+      const data = await api('/api/groups');
+      return Array.isArray(data) ? data : (data.groups || data.data || []);
+    } catch { return []; }
+  }
+
+  async function loadAgents() {
+    if (allAgentsCache.length) return allAgentsCache;
+    const data = await api('/api/agents');
+    allAgentsCache = Array.isArray(data) ? data : [];
+    return allAgentsCache;
+  }
+
   function formatTime(ts) {
     if (!ts) return '';
-    const d = new Date(ts * 1000);
+    const d = new Date(ts * 1000 || ts);
     const pad = n => String(n).padStart(2, '0');
-    return `${d.getFullYear()}-${pad(d.getMonth()+1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
-  }
-
-  function truncate(s, len) {
-    if (!s) return '';
-    return s.length > len ? s.slice(0, len) + '...' : s;
+    if (isNaN(d.getTime())) return String(ts);
+    return `${d.getFullYear()}-${pad(d.getMonth()+1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
   }
 
   // ── 主界面 ──
   content.innerHTML = `
     <div style="display:flex;align-items:center;justify-content:space-between;margin-bottom:20px">
       <div>
-        <h2 style="font-size:20px;font-weight:600;color:var(--text)">Agent 私聊记录</h2>
-        <p style="font-size:13px;color:var(--text3);margin-top:4px">查看群聊中 Agent 之间的私下沟通记录</p>
-      </div>
-      <div style="display:flex;gap:8px">
-        <button id="acRefreshBtn" onclick="window._acRefresh()" style="padding:6px 14px;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);cursor:pointer;font-size:13px">
-          刷新
-        </button>
-        <button id="acClearBtn" onclick="window._acClearAll()" style="padding:6px 14px;background:var(--danger);color:#fff;border:none;border-radius:var(--radius);cursor:pointer;font-size:13px">
-          清空全部
-        </button>
+        <h2 style="font-size:20px;font-weight:600;color:var(--text)">私聊记录</h2>
+        <p style="font-size:13px;color:var(--text3);margin-top:4px">查看用户与 Agent 的私聊会话，以及群聊中 Agent 间私下沟通</p>
       </div>
+      <button id="acRefreshBtn" onclick="window._acRefresh()" style="padding:6px 14px;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);cursor:pointer;font-size:13px">
+        刷新
+      </button>
+    </div>
+    <!-- Tab 切换 -->
+    <div style="display:flex;gap:0;margin-bottom:16px;border:1px solid var(--border);border-radius:var(--radius);overflow:hidden;width:fit-content">
+      <div id="acTabUA" onclick="window._acSwitchTab('user-agent')" style="padding:8px 20px;cursor:pointer;font-size:13px;font-weight:600;background:var(--accent);color:#fff">👤 用户-Agent 私聊</div>
+      <div id="acTabAA" onclick="window._acSwitchTab('agent-agent')" style="padding:8px 20px;cursor:pointer;font-size:13px;font-weight:600;background:var(--bg3);color:var(--text2)">🤖 Agent间私聊</div>
     </div>
-    <div style="display:flex;gap:12px;margin-bottom:16px;flex-wrap:wrap">
-      <select id="acGroupFilter" onchange="window._acFilterChange()" style="padding:6px 10px;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);font-size:13px;min-width:160px">
+    <!-- 筛选区 -->
+    <div id="acFilters" style="display:flex;gap:12px;margin-bottom:16px;flex-wrap:wrap">
+      <select id="acAgentFilter" onchange="window._acFilterChange()" style="padding:6px 10px;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);font-size:13px;min-width:180px">
+        <option value="">全部 Agent</option>
+      </select>
+      <select id="acGroupFilter" onchange="window._acFilterChange()" style="display:none;padding:6px 10px;background:var(--bg3);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);font-size:13px;min-width:160px">
         <option value="">全部群聊</option>
       </select>
     </div>
-    <div style="display:grid;grid-template-columns:340px 1fr;gap:16px;min-height:500px" id="acLayout">
-      <div id="acPairsPanel" style="background:var(--bg2);border:1px solid var(--border);border-radius:var(--radius);overflow:hidden;display:flex;flex-direction:column">
-        <div style="padding:12px 16px;border-bottom:1px solid var(--border);font-weight:600;font-size:14px;color:var(--text2)">聊天对象</div>
-        <div id="acPairsList" style="flex:1;overflow-y:auto;padding:8px">
-          <div style="text-align:center;color:var(--text3);padding:40px;font-size:13px">加载中...</div>
-        </div>
-      </div>
-      <div id="acChatPanel" style="background:var(--bg2);border:1px solid var(--border);border-radius:var(--radius);overflow:hidden;display:flex;flex-direction:column">
-        <div id="acChatHeader" style="padding:12px 16px;border-bottom:1px solid var(--border);font-weight:600;font-size:14px;color:var(--text2)">选择左侧聊天对象查看详情</div>
-        <div id="acChatMessages" style="flex:1;overflow-y:auto;padding:16px">
-          <div style="text-align:center;color:var(--text3);padding:60px;font-size:13px">暂无聊天记录</div>
-        </div>
-      </div>
-    </div>
+    <!-- 内容区 -->
+    <div id="acContent"></div>
   `;
 
-  // ── 加载群列表 ──
+  // ── 加载 Agent 列表（用于筛选下拉） ──
+  const agents = await loadAgents();
+  const agentSel = $('acAgentFilter');
+  agents.forEach(a => {
+    const opt = document.createElement('option');
+    opt.value = a.path || '';
+    opt.textContent = (a.avatar_emoji || '') + ' ' + escHtml(a.name || a.path);
+    agentSel.appendChild(opt);
+  });
+
+  // ── 加载群列表（Agent间私聊 tab 使用） ──
   const groups = await loadGroups();
-  const sel = $('acGroupFilter');
+  const groupSel = $('acGroupFilter');
   groups.forEach(g => {
     const opt = document.createElement('option');
     opt.value = g.id || g.group_id || '';
     opt.textContent = g.name || g.group_name || g.id || '未命名';
-    sel.appendChild(opt);
+    groupSel.appendChild(opt);
   });
 
-  // ── 渲染聊天对列表 ──
-  async function renderPairs() {
-    const pairs = await loadPairs();
-    const list = $('acPairsList');
+  // ── Tab 切换 ──
+  window._acSwitchTab = (tab) => {
+    currentTab = tab;
+    const tabUA = $('acTabUA');
+    const tabAA = $('acTabAA');
+    const agentFilter = $('acAgentFilter');
+    const groupFilter = $('acGroupFilter');
+    if (tab === 'user-agent') {
+      tabUA.style.background = 'var(--accent)'; tabUA.style.color = '#fff';
+      tabAA.style.background = 'var(--bg3)'; tabAA.style.color = 'var(--text2)';
+      agentFilter.style.display = '';
+      groupFilter.style.display = 'none';
+    } else {
+      tabAA.style.background = 'var(--accent)'; tabAA.style.color = '#fff';
+      tabUA.style.background = 'var(--bg3)'; tabUA.style.color = 'var(--text2)';
+      agentFilter.style.display = 'none';
+      groupFilter.style.display = '';
+    }
+    renderContent();
+  };
+
+  window._acFilterChange = () => {
+    currentFilter.agent = $('acAgentFilter').value;
+    currentFilter.group_id = $('acGroupFilter').value;
+    renderContent();
+  };
+
+  // ── 用户-Agent 私聊列表渲染 ──
+  async function renderUserAgentSessions() {
+    const sessions = await loadPrivateSessions();
+    const container = $('acContent');
+
+    if (!sessions.length) {
+      container.innerHTML = '<div class="empty">暂无用户-Agent私聊会话</div>';
+      return;
+    }
+
+    // 按 agent 分组
+    const grouped = {};
+    for (const s of sessions) {
+      const key = s.agent_path || 'default';
+      if (!grouped[key]) grouped[key] = { name: s.agent_name || key, sessions: [] };
+      grouped[key].sessions.push(s);
+    }
+
+    let html = `<div style="font-size:13px;color:var(--text3);margin-bottom:12px">共 ${sessions.length} 个私聊会话，${Object.keys(grouped).length} 个 Agent</div>`;
+
+    for (const [agentPath, group] of Object.entries(grouped)) {
+      html += `<div style="margin-bottom:20px">
+        <div style="display:flex;align-items:center;gap:8px;margin-bottom:8px;cursor:pointer" onclick="this.parentElement.querySelector('.ac-group-sessions').classList.toggle('hidden')">
+          <span style="font-size:16px;transition:transform .2s">📂</span>
+          <span style="font-size:14px;font-weight:600;color:var(--text)">${esc(group.name)}</span>
+          <span style="font-size:11px;color:var(--text3);background:var(--bg3);padding:2px 8px;border-radius:10px">${group.sessions.length} 个会话</span>
+        </div>
+        <div class="ac-group-sessions" style="margin-left:24px">`;
+
+      for (const s of group.sessions) {
+        const displayName = s.display_name || s.id;
+        const truncated = displayName.length > 40 ? displayName.slice(0, 40) + '...' : displayName;
+        const preview = s.preview ? esc(s.preview) : '<span style="color:var(--text3)">无预览</span>';
+        const lastTime = formatTime(s.last);
+        const agentPathSafe = esc(s.agent_path).replace(/'/g, "\\'");
+        html += `<div style="display:flex;justify-content:space-between;align-items:center;padding:10px 12px;border-radius:6px;margin-bottom:4px;cursor:pointer;transition:background .15s;border:1px solid var(--border)"
+          onmouseover="this.style.background='var(--bg3)'" onmouseout="this.style.background='transparent'"
+          onclick="window._acViewSession('${esc(s.id)}','${agentPathSafe}')">
+          <div style="flex:1;min-width:0">
+            <div style="font-size:13px;font-weight:500;color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap" title="${esc(s.id)}">${esc(truncated)}</div>
+            <div style="font-size:11px;color:var(--text3);margin-top:2px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap">${preview}</div>
+          </div>
+          <div style="flex-shrink:0;text-align:right;margin-left:12px">
+            <div style="font-size:11px;color:var(--text3)">${lastTime}</div>
+            <div style="font-size:11px;color:var(--text3)">${s.messages} 条消息</div>
+          </div>
+        </div>`;
+      }
+      html += '</div></div>';
+    }
+    container.innerHTML = html;
+  }
+
+  // ── 查看私聊会话消息 ──
+  window._acViewSession = async (sid, agentPath) => {
+    // 复用 admin-sessions.js 的 viewSession 逻辑
+    window._viewSessionSid = sid;
+    window._viewSessionOffset = 0;
+    _navSubState = 'view:' + sid;
+    navigateTo('agentchat', 'view:' + sid, _loadSessionMessages);
+  };
+
+  // ── Agent间私聊渲染 ──
+  async function renderAgentAgentChats() {
+    const pairs = await loadAgentPairs();
+    const container = $('acContent');
+
     if (!pairs.length) {
-      list.innerHTML = '<div style="text-align:center;color:var(--text3);padding:40px;font-size:13px">暂无私聊记录</div>';
+      container.innerHTML = '<div class="empty">暂无Agent间私聊记录</div>';
       return;
     }
-    list.innerHTML = pairs.map(p => {
+
+    let html = `<div style="display:grid;grid-template-columns:340px 1fr;gap:16px;min-height:500px">
+      <div style="background:var(--bg2);border:1px solid var(--border);border-radius:var(--radius);overflow:hidden;display:flex;flex-direction:column">
+        <div style="padding:12px 16px;border-bottom:1px solid var(--border);font-weight:600;font-size:14px;color:var(--text2)">聊天对象</div>
+        <div id="acPairsList" style="flex:1;overflow-y:auto;padding:8px">`;
+
+    for (const p of pairs) {
       const a = esc(p.from_name || p.from_agent);
       const b = esc(p.to_name || p.to_agent);
       const last = formatTime(p.last_ts);
       const count = p.cnt || p.count || 0;
-      return `<div onclick="window._acSelectPair('${esc(p.from_agent)}','${esc(p.to_agent)}','${a}','${b}')"
+      html += `<div onclick="window._acSelectPair('${esc(p.from_agent)}','${esc(p.to_agent)}','${a}','${b}')"
         style="padding:10px 12px;border-radius:6px;cursor:pointer;margin-bottom:4px;transition:background .15s"
         onmouseover="this.style.background='var(--bg3)'" onmouseout="this.style.background='transparent'">
         <div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:4px">
@@ -115,21 +229,36 @@ async function renderAgentChat() {
         </div>
         <div style="font-size:11px;color:var(--text3)">最后沟通: ${last}</div>
       </div>`;
-    }).join('');
+    }
+
+    html += `</div></div>
+      <div style="background:var(--bg2);border:1px solid var(--border);border-radius:var(--radius);overflow:hidden;display:flex;flex-direction:column">
+        <div id="acChatHeader" style="padding:12px 16px;border-bottom:1px solid var(--border);font-weight:600;font-size:14px;color:var(--text2)">选择左侧聊天对象查看详情</div>
+        <div id="acChatMessages" style="flex:1;overflow-y:auto;padding:16px">
+          <div style="text-align:center;color:var(--text3);padding:60px;font-size:13px">暂无聊天记录</div>
+        </div>
+      </div>
+    </div>`;
+
+    container.innerHTML = html;
+
+    // Agent间私聊清空按钮
+    const clearBtnHtml = `<button onclick="window._acClearAgentChats()" style="margin-top:12px;padding:6px 14px;background:var(--danger);color:#fff;border:none;border-radius:var(--radius);cursor:pointer;font-size:13px">清空Agent间私聊</button>`;
+    container.insertAdjacentHTML('beforeend', clearBtnHtml);
   }
 
-  // ── 渲染聊天记录 ──
-  async function renderMessages(fromAgent, toAgent, fromName, toName) {
+  // ── Agent间私聊消息查看 ──
+  window._acSelectPair = async (fromAgent, toAgent, fromName, toName) => {
     const header = $('acChatHeader');
-    header.innerHTML = `<span style="color:var(--accent)">${esc(fromName)}</span> ↔ <span style="color:var(--accent)">${esc(toName)}</span> 的私聊记录`;
+    if (header) header.innerHTML = `<span style="color:var(--accent)">${esc(fromName)}</span> ↔ <span style="color:var(--accent)">${esc(toName)}</span> 的私聊记录`;
 
-    const msgs = await loadMessages(fromAgent, toAgent);
+    const msgs = await loadAgentMessages(fromAgent, toAgent);
     const container = $('acChatMessages');
+    if (!container) return;
     if (!msgs.length) {
       container.innerHTML = '<div style="text-align:center;color:var(--text3);padding:60px;font-size:13px">暂无记录</div>';
       return;
     }
-    // 按 time 正序显示
     const sorted = [...msgs].sort((a, b) => (a.timestamp || 0) - (b.timestamp || 0));
     container.innerHTML = sorted.map(m => {
       const isFrom = m.from_agent === fromAgent;
@@ -145,30 +274,33 @@ async function renderAgentChat() {
       </div>`;
     }).join('');
     container.scrollTop = container.scrollHeight;
-  }
-
-  // ── 全局方法 ──
-  window._acRefresh = async () => { await renderPairs(); };
-  window._acFilterChange = () => {
-    currentFilter.group_id = $('acGroupFilter').value;
-    renderPairs();
   };
-  window._acSelectPair = (fa, ta, fn, tn) => { renderMessages(fa, ta, fn, tn); };
-  window._acClearAll = async () => {
-    if (!confirm('确定要清空所有私聊记录吗？此操作不可恢复。')) return;
+
+  window._acClearAgentChats = async () => {
+    if (!confirm('确定要清空所有Agent间私聊记录吗？此操作不可恢复。')) return;
     const q = new URLSearchParams();
     if (currentFilter.group_id) q.set('group_id', currentFilter.group_id);
     try {
       const data = await api('/api/agent-chat/messages?' + q.toString(), { method: 'DELETE' });
-      toast('已清空 ' + (data.deleted || 0) + ' 条记录');
-      await renderPairs();
-      $('acChatMessages').innerHTML = '<div style="text-align:center;color:var(--text3);padding:60px;font-size:13px">暂无聊天记录</div>';
-      $('acChatHeader').textContent = '选择左侧聊天对象查看详情';
-    } catch (e) { toast('清空失败: ' + (e.message || e), 'error'); }
+      showToast('已清空 ' + (data.deleted || 0) + ' 条记录', 'success');
+      renderContent();
+    } catch (e) { showToast('清空失败: ' + (e.message || e), 'danger'); }
   };
 
+  // ── 渲染主内容 ──
+  async function renderContent() {
+    if (currentTab === 'user-agent') {
+      await renderUserAgentSessions();
+    } else {
+      await renderAgentAgentChats();
+    }
+  }
+
+  // ── 全局刷新 ──
+  window._acRefresh = async () => { await renderContent(); };
+
   // 初始加载
-  await renderPairs();
+  await renderContent();
 }
 
 if (typeof window._adminRenderers === 'undefined') window._adminRenderers = {};

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

@@ -1,7 +1,7 @@
 /* ── admin-core.js — Shared infrastructure (loaded FIRST) ── */
 
 const API='';
-const pages={dashboard:'📊 仪表盘',agents:'🤖 Agent 管理',platforms:'🌐 聊天平台',organization:'🏢 组织管理',departments:'🏛 部门管理',agentchat:'🔒 Agent私聊',sessions:'💬 会话管理',memory:'🧠 记忆管理',permissions:'🔑 权限管理',llm:'🧬 大模型设置',system:'⚙️ 系统配置',executor:'🔧 执行引擎',skills:'🛠 技能管理',files:'📁 工作目录',logs:'📜 查看日志',tasks:'📌 任务记录'};
+const pages={dashboard:'📊 仪表盘',agents:'🤖 Agent 管理',platforms:'🌐 聊天平台',organization:'🏢 组织管理',departments:'🏛 部门管理',agentchat:'💬 私聊记录',sessions:'📋 会话管理',memory:'🧠 记忆管理',permissions:'🔑 权限管理',llm:'🧬 大模型设置',system:'⚙️ 系统配置',executor:'🔧 执行引擎',skills:'🛠 技能管理',files:'📁 工作目录',logs:'📜 查看日志',tasks:'📌 任务记录'};
 let currentPage='dashboard';
 let allAgentsCache=[];
 let allModelsCache=[];