myagent-ai 1.24.6 → 1.25.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myagent-ai",
-  "version": "1.24.6",
+  "version": "1.25.1",
   "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/skills/system_skill.py

@@ -209,8 +209,12 @@ class EnvironmentGetSkill(Skill):
             if key:
                 value = os.environ.get(key)
                 if value is None:
-                    return SkillResult(success=False, error=f"环境变量不存在: {key}")
-                return SkillResult(success=True, data={"key": key, "value": value})
+                    return SkillResult(
+                        success=True,
+                        data={"key": key, "value": None, "exists": False},
+                        message=f"环境变量 {key} 不存在（当前进程未设置）",
+                    )
+                return SkillResult(success=True, data={"key": key, "value": value, "exists": True})
             else:
                 # 返回所有(过滤敏感信息)
                 sensitive = {"PASSWORD", "SECRET", "TOKEN", "KEY", "CREDENTIAL", "API_KEY"}

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 完整的配置使用说明文档。当用户询问时不确定的功能时，必须先参考知识库。
 """
@@ -4190,7 +4248,8 @@ window.addEventListener('beforeunload', function() {{
             # [v1.24.1] 兼容两种会话 ID 格式：
             #   旧格式: {agent}_web_{timestamp} → session_id LIKE 'default_%'
             #   新格式: sess_{uuid} → 通过用户消息 metadata 中的 agent_path 关联
-            metadata_agent_pattern = '%"agent_path":"' + agent + '"%'
+            # [v1.24.6] 修复: json.dumps 默认在冒号后加空格 (": ")，LIKE 模式需匹配
+            metadata_agent_pattern = '%"agent_path": "' + agent + '"%'
             # 先找出属于该 agent 的所有 session_id（子查询），再统计消息数
             rows = conn.execute(
                 "SELECT m.session_id, COUNT(*) as cnt, MAX(m.created_at) as last FROM memories m "
@@ -4240,7 +4299,7 @@ window.addEventListener('beforeunload', function() {{
         if not self.core.memory:
             return web.json_response({"agent": name, "sessions": []})
         prefix = f"{name}_"
-        metadata_agent_pattern = '%"agent_path":"' + name + '"%'
+        metadata_agent_pattern = '%"agent_path": "' + name + '"%'
         conn = self.core.memory._get_conn()
         # [v1.24.1] 兼容旧格式 (agent_xxx) 和新格式 (sess_xxx)
         rows = conn.execute(
@@ -8427,7 +8486,7 @@ window.addEventListener('beforeunload', function() {{
 
         if agent:
             # 按 agent 路径筛选：旧格式 session_id LIKE '{agent}_%' 或新格式 metadata 包含 agent_path
-            metadata_pattern = '%"agent_path":"' + agent + '"%'
+            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 "