## ✨ 新增功能

**多 Agent 系统**

- **后台任务支持**：支持通过 CLI `--background` 标志在后台执行 Agent 间通信任务，提供任务追踪、状态轮询和取消功能 ([#2345](https://github.com/agentscope-ai/CoPaw/pull/2345))
- **Agent 启用/禁用开关**：可以通过控制台界面和 API 启用或禁用 Agent ([#2249](https://github.com/agentscope-ai/CoPaw/pull/2249))
- **统一优先级队列系统和 `/stop` 命令**：按通道、会话和优先级分层的队列系统，支持通过 `/stop` 命令取消运行中的任务并清空排队消息 ([#2411](https://github.com/agentscope-ai/CoPaw/pull/2411))

**模型供应商**

- **CoPaw 本地模型**：内置 llama.cpp 本地模型供应商，支持自动下载、配置和自定义模型仓库 ([#2419](https://github.com/agentscope-ai/CoPaw/pull/2419), [#2476](https://github.com/agentscope-ai/CoPaw/pull/2476))
- **分层模型选择**：支持在设置中全局设定活跃模型，也可在聊天页面为单个 Agent 单独设定 ([#2278](https://github.com/agentscope-ai/CoPaw/pull/2278))
- **全局 LLM 流控器**：QPM（每分钟请求数）滑动窗口限流、信号量并发控制，以及收到 429 响应时的全局暂停协调机制（带随机抖动避免雷鸣重试） ([#2282](https://github.com/agentscope-ai/CoPaw/pull/2282))

**安全**

- **系统重启与服务控制保护**：新增工具守卫规则，阻止系统重启、关机、服务控制、大范围进程终止和权限提升等危险命令 ([#2333](https://github.com/agentscope-ai/CoPaw/pull/2333))
- **中文提示词注入检测**：技能安全扫描器新增中文正则表达式规则，用于检测提示词注入和越狱尝试 ([#2381](https://github.com/agentscope-ai/CoPaw/pull/2381))

**控制台与界面**

- **下载页面**：新增下载页面，提供桌面安装包及镜像站点 ([#2555](https://github.com/agentscope-ai/CoPaw/pull/2555))
- **多模态预览**：聊天历史记录和流式输出中的图片、音频、视频和文件附件现在都能正确显示预览 ([#2297](https://github.com/agentscope-ai/CoPaw/pull/2297), [#2332](https://github.com/agentscope-ai/CoPaw/pull/2332))
- **聊天会话标签**：聊天会话列表中显示通道标签和图标，方便识别消息来源 ([#2483](https://github.com/agentscope-ai/CoPaw/pull/2483))
- **命令建议**：聊天输入框支持斜杠命令建议（`/clear`、`/compact`、`/approve`、`/deny`） ([#2415](https://github.com/agentscope-ai/CoPaw/pull/2415))

**通道（Channels）**

- **微信 iLink Bot**：新增微信个人号通道，使用 iLink Bot API 接入 ([#2260](https://github.com/agentscope-ai/CoPaw/pull/2260))
- **自定义通道 HTTP 路由**：自定义通道现在可以注册 FastAPI 路由，用于 Webhook 和自定义端点 ([#2140](https://github.com/agentscope-ai/CoPaw/pull/2140))
- **Discord 机器人消息过滤**：新增配置选项，可控制是否处理来自其他机器人的消息 ([#2122](https://github.com/agentscope-ai/CoPaw/pull/2122))
- **钉钉宽屏卡片**：支持钉钉宽屏 AI 卡片布局 ([#2238](https://github.com/agentscope-ai/CoPaw/pull/2238))
- **企业微信媒体上传**：通过 WebSocket 长连接上传媒体文件，相比 HTTP 下载方式更可靠 ([#2401](https://github.com/agentscope-ai/CoPaw/pull/2401))

**工具与技能**

- **异步工具执行**：支持按工具设置异步执行标志，自动注册后台任务辅助工具（`view_task`、`wait_task`、`cancel_task`） ([#2391](https://github.com/agentscope-ai/CoPaw/pull/2391))
- **技能池架构**：双层技能系统，包含共享技能池和 Agent 独立工作区技能 ([#2173](https://github.com/agentscope-ai/CoPaw/pull/2173), [#2436](https://github.com/agentscope-ai/CoPaw/pull/2436), [#2440](https://github.com/agentscope-ai/CoPaw/pull/2440), [#2477](https://github.com/agentscope-ai/CoPaw/pull/2477), [#2480](https://github.com/agentscope-ai/CoPaw/pull/2480))
- **浏览器 CDP 支持**：集成 Chrome DevTools Protocol（CDP），支持连接运行中的 Chrome 实例、端口扫描、缓存清理和远程浏览器附加 ([#2294](https://github.com/agentscope-ai/CoPaw/pull/2294))
- **多工作区 Cookie 管理**：浏览器自动化现在为每个工作区使用独立的持久化用户数据目录，实现 Cookie 隔离和重启后的持久化 ([#2131](https://github.com/agentscope-ai/CoPaw/pull/2131))

**国际化**

- **服务端语言偏好持久化**：界面语言偏好现在持久化到服务端设置 ([#2408](https://github.com/agentscope-ai/CoPaw/pull/2408))
- **扩展多语言支持**：更多控制台界面组件支持多语言显示 ([#2478](https://github.com/agentscope-ai/CoPaw/pull/2478), [#2508](https://github.com/agentscope-ai/CoPaw/pull/2508))

## 🔄 变更

**上下文与记忆**

- **上下文管理 v2.0**：大幅重构上下文和记忆管理系统，包含嵌套配置模型、新增压缩钩子、工具结果压缩、重写的摘要提示词，以及主动记忆搜索功能 ([#2300](https://github.com/agentscope-ai/CoPaw/pull/2300), [#2410](https://github.com/agentscope-ai/CoPaw/pull/2410), [#2519](https://github.com/agentscope-ai/CoPaw/pull/2519), [#2525](https://github.com/agentscope-ai/CoPaw/pull/2525))
- **优化截断逻辑**：增强文件截断机制，对 Markdown 提供最多 50KB 的保护，为 LLM 提供更清晰的截断提示，并优化了最近窗口长度逻辑 ([#2449](https://github.com/agentscope-ai/CoPaw/pull/2449))

**工具与技能**

- **流式 Grep 搜索**：Grep 搜索改为逐行读取文件并使用滑动窗口保存上下文，大幅降低大文件搜索时的内存占用 ([#2344](https://github.com/agentscope-ai/CoPaw/pull/2344))
- **MCP 空配置处理**：Agent MCP 配置为空时新增空值检查，避免崩溃 ([#2471](https://github.com/agentscope-ai/CoPaw/pull/2471))
- **Himalaya 版本建议**：更新 Himalaya 技能文档，建议使用 CLI 1.2.0 及以上版本 ([#2334](https://github.com/agentscope-ai/CoPaw/pull/2334))

**控制台与界面**

- **控制台视觉焕新**：控制台整体样式大更新，包含布局优化和主题调整 ([#2228](https://github.com/agentscope-ai/CoPaw/pull/2228), [#2271](https://github.com/agentscope-ai/CoPaw/pull/2271), [#2352](https://github.com/agentscope-ai/CoPaw/pull/2352), [#2404](https://github.com/agentscope-ai/CoPaw/pull/2404), [#2470](https://github.com/agentscope-ai/CoPaw/pull/2470), [#2479](https://github.com/agentscope-ai/CoPaw/pull/2479), [#2511](https://github.com/agentscope-ai/CoPaw/pull/2511), [#2522](https://github.com/agentscope-ai/CoPaw/pull/2522), [#2528](https://github.com/agentscope-ai/CoPaw/pull/2528), [#2540](https://github.com/agentscope-ai/CoPaw/pull/2540), [#2552](https://github.com/agentscope-ai/CoPaw/pull/2552))
- **网站 UI 重构**：网站 UI 大规模重构，改进国际化支持和现代化样式 ([#2558](https://github.com/agentscope-ai/CoPaw/pull/2558), [#2575](https://github.com/agentscope-ai/CoPaw/pull/2575), [#2582](https://github.com/agentscope-ai/CoPaw/pull/2582))

## 🐛 修复

**通道（Channels）**

- **企业微信心跳重连**：心跳失败时 WebSocket 自动重连，避免永久断连 ([#2515](https://github.com/agentscope-ai/CoPaw/pull/2515))
- **飞书 WebSocket 重连**：支持自动重连（带指数退避）、静默断连检测的健康监控，以及过滤重发消息的能力 ([#2311](https://github.com/agentscope-ai/CoPaw/pull/2311), [#2376](https://github.com/agentscope-ai/CoPaw/pull/2376))
- **飞书多实例消息路由**：通过串行化 WebSocket 启动和 app_id 校验，避免多实例部署时消息误路由到错误的工作区 ([#2244](https://github.com/agentscope-ai/CoPaw/pull/2244))
- **Discord 重复消息**：使用有界缓存记录已处理的消息 ID，避免 WebSocket 重连后重复处理消息 ([#2253](https://github.com/agentscope-ai/CoPaw/pull/2253))
- **Telegram 超时**：提高长轮询的读取和连接超时时间，避免空闲时误触发超时 ([#2280](https://github.com/agentscope-ai/CoPaw/pull/2280))
- **QQ 语音消息转换**：AMR/AMR-WB 音频文件使用更大的 ffmpeg 探测参数，确保正确识别编解码器 ([#2248](https://github.com/agentscope-ai/CoPaw/pull/2248))
- **钉钉定时任务提醒**：修复 sessionWebhook 路由和 Webhook 持久化存储，确保定时任务提醒正常发送 ([#2392](https://github.com/agentscope-ai/CoPaw/pull/2392))

**控制台与界面**

- **会话选中状态**：修复默认选中会话，使其正确匹配 URL 中的聊天 ID ([#2543](https://github.com/agentscope-ai/CoPaw/pull/2543))
- **技能开关图标**：修正技能启用/禁用开关图标，正确反映状态 ([#2516](https://github.com/agentscope-ai/CoPaw/pull/2516))
- **控制台文件上传**：修复控制台聊天文件上传的类型处理问题 ([#2266](https://github.com/agentscope-ai/CoPaw/pull/2266))
- **多 Agent 模型配置**：模型 API 通过 `X-Agent-Id` 请求头支持按 Agent 选择模型；多标签页通过 sessionStorage 实现隔离，替代之前的 localStorage ([#2283](https://github.com/agentscope-ai/CoPaw/pull/2283))

**CLI 与部署**

- **本地回环地址**：当服务器绑定到 `0.0.0.0` 时，CLI 持久化的地址改为 `127.0.0.1`，便于其他 CLI 命令正确连接 ([#2241](https://github.com/agentscope-ai/CoPaw/pull/2241))
- **PowerShell 安装脚本**：修正 PowerShell 安装脚本中的命令名称，修复 Windows 自动添加 PATH 的问题 ([#2489](https://github.com/agentscope-ai/CoPaw/pull/2489))
- **跨平台文件编码**：文件读写统一使用 `utf-8-sig` 编码，增强 Windows 兼容性 ([#2403](https://github.com/agentscope-ai/CoPaw/pull/2403))

## 📚 文档

- **多 Agent 文档**：详尽的多 Agent 文档，涵盖协作模式、触发器、使用场景、Agent 描述和最佳实践 ([#2290](https://github.com/agentscope-ai/CoPaw/pull/2290), [#2450](https://github.com/agentscope-ai/CoPaw/pull/2450), [#2517](https://github.com/agentscope-ai/CoPaw/pull/2517))
- **安装与 CLI 文档**：更新安装指南（重新排序选项）、CLI 文档改进和日志路径修正 ([#2310](https://github.com/agentscope-ai/CoPaw/pull/2310), [#2496](https://github.com/agentscope-ai/CoPaw/pull/2496), [#2538](https://github.com/agentscope-ai/CoPaw/pull/2538), [#2562](https://github.com/agentscope-ai/CoPaw/pull/2562))
- **模型供应商文档**：增强供应商贡献指南和本地模型设置说明 ([#2541](https://github.com/agentscope-ai/CoPaw/pull/2541))
- **项目结构指南**：新增 AGENTS.md，说明项目结构和格式规范 ([#2532](https://github.com/agentscope-ai/CoPaw/pull/2532))
- **上下文管理文档**：更新上下文管理文档，说明 v2.0 架构和依赖信息 ([#2460](https://github.com/agentscope-ai/CoPaw/pull/2460))
- **安全文档**：全面更新安全文档，扩充保护覆盖范围说明 ([#2437](https://github.com/agentscope-ai/CoPaw/pull/2437))
- **MCP 与工具文档**：扩展 MCP 和工具文档，提供详细的集成指南 ([#2444](https://github.com/agentscope-ai/CoPaw/pull/2444))
- **技能文档**：更新技能文档，说明技能池架构和界面改进 ([#2480](https://github.com/agentscope-ai/CoPaw/pull/2480))
- **魔法命令文档**：更新魔法命令文档，提供完整的命令参考 ([#2486](https://github.com/agentscope-ai/CoPaw/pull/2486))
- **网站文档整体更新**：网站文档的整体改进 ([#2413](https://github.com/agentscope-ai/CoPaw/pull/2413), [#2461](https://github.com/agentscope-ai/CoPaw/pull/2461), [#2545](https://github.com/agentscope-ai/CoPaw/pull/2545), [#2546](https://github.com/agentscope-ai/CoPaw/pull/2546), [#2561](https://github.com/agentscope-ai/CoPaw/pull/2561), [#2564](https://github.com/agentscope-ai/CoPaw/pull/2564))
