## ✨ 新增功能

**桌面应用**

- **原生桌面安装包**：提供 Windows 一键安装程序和 macOS 独立 `.app` 应用包，使用 conda-pack 打包便携式 Python 环境，配备自动化 GitHub Actions 发布流程 ([#843](https://github.com/agentscope-ai/CoPaw/pull/843))
- **桌面启动命令**：新增 `copaw desktop` 命令，在原生 webview 窗口中启动 CoPaw，自动管理服务器和端口 ([#843](https://github.com/agentscope-ai/CoPaw/pull/843))

**国际化**

- **俄语支持**：全面翻译覆盖控制台界面、智能体配置文件，初始化命令支持俄语选项 ([#829](https://github.com/agentscope-ai/CoPaw/pull/829), [#854](https://github.com/agentscope-ai/CoPaw/pull/854), [#948](https://github.com/agentscope-ai/CoPaw/pull/948))
- **日语支持**：控制台界面完整日语翻译，集成语言切换器 ([#912](https://github.com/agentscope-ai/CoPaw/pull/912))

**频道与通信**

- **Telegram 访问控制**：支持私聊/群组访问策略、用户白名单和自定义拒绝消息；支持 Markdown 转 HTML，不支持时降级为纯文本 ([#911](https://github.com/agentscope-ai/CoPaw/pull/911))
- **QQ Markdown 支持**：发送富文本 Markdown 消息，验证失败时降级为纯文本，防止重复发送 ([#790](https://github.com/agentscope-ai/CoPaw/pull/790))
- **QQ 富媒体处理**：支持附件下载和解析，包括图片、视频、音频和文件，带 MIME 类型检测和可配置媒体目录 ([#996](https://github.com/agentscope-ai/CoPaw/pull/996))
- **统一白名单机制**：将私聊/群组访问策略统一到 BaseChannel 基类，扩展到 Discord 和飞书，提供隐私保护的拒绝消息 ([#943](https://github.com/agentscope-ai/CoPaw/pull/943))
- **媒体过滤优化**：启用工具消息过滤时正确返回媒体文件，修复所有频道的内容丢失问题 ([#778](https://github.com/agentscope-ai/CoPaw/pull/778))
- **钉钉媒体扩展**：扩展音频/视频格式支持，不支持的格式自动降级为文件上传 ([#824](https://github.com/agentscope-ai/CoPaw/pull/824))
- **飞书表格渲染**：Markdown 表格自动转换为原生交互式消息卡片，正确显示表格内容 ([#1009](https://github.com/agentscope-ai/CoPaw/pull/1009))
- **飞书富文本消息**：支持接收飞书 post 类型的富文本消息 ([#980](https://github.com/agentscope-ai/CoPaw/pull/980))
- **Discord 媒体支持**：实现媒体发送功能，支持本地/远程文件处理和 HTTP URL 临时下载 ([#840](https://github.com/agentscope-ai/CoPaw/pull/840))
- **Docker 频道启用**：Docker 镜像中默认启用 Telegram 和 Discord 频道 ([#915](https://github.com/agentscope-ai/CoPaw/pull/915))
- **MQTT 频道**：新增 MQTT 频道支持，用于物联网和消息队列集成 ([#548](https://github.com/agentscope-ai/CoPaw/pull/548))

**模型与 AI 功能**

- **Gemini 思考模型**：通过 `extra_content` 字段保留推理内容，支持 Gemini 思考模型的工具调用 ([#789](https://github.com/agentscope-ai/CoPaw/pull/789))
- **MLX 后端优化**：消息规范化处理空内容和工具调用，兼容 MLX tokenizer 聊天模板 ([#1014](https://github.com/agentscope-ai/CoPaw/pull/1014))
- **本地/云端模型路由**：基于策略钩子的智能模型选择，实现本地和云端 LLM 的灵活路由 ([#849](https://github.com/agentscope-ai/CoPaw/pull/849))

**控制台与界面**

- **环境变量安全增强**：敏感环境变量值采用密码遮罩显示，支持显示/隐藏切换，防止意外泄露 ([#984](https://github.com/agentscope-ai/CoPaw/pull/984))
- **环境变量删除**：支持单个和批量删除环境变量，已保存的变量自动触发 API 持久化删除 ([#954](https://github.com/agentscope-ai/CoPaw/pull/954))
- **内置工具管理**：新增工具管理页面，通过开关切换启用/禁用内置工具，动态更新智能体能力 ([#1043](https://github.com/agentscope-ai/CoPaw/pull/1043))
- **自定义系统提示词**：从工作区选择并排序 Markdown 文件组合自定义系统提示词，替代默认的智能体人格文件 ([#1048](https://github.com/agentscope-ai/CoPaw/pull/1048))

**记忆与配置**

- **ReMeLight 迁移**：内存系统从 ReMeCopaw 重构为 ReMeLight，通过环境变量驱动嵌入和存储配置 ([#867](https://github.com/agentscope-ai/CoPaw/pull/867))
- **可配置记忆压缩**：新的紧凑分割策略，支持可调参数实现智能上下文管理 ([#867](https://github.com/agentscope-ai/CoPaw/pull/867))
- **智能工具输出截断**：文件读取和 Shell 命令自动基于行数/字节进行截断，附带清晰的截断提示，防止上下文溢出 ([#867](https://github.com/agentscope-ai/CoPaw/pull/867))

## 🔄 优化改进

**控制台与界面**

- **版本检测优化**：修复版本排序逻辑，使用 PyPI 上传时间，防止 beta/dev 版本误显示为最新版 ([#766](https://github.com/agentscope-ai/CoPaw/pull/766))
- **样式重构**：将内联样式迁移到集中式 LESS 模块，提高代码可维护性 ([#810](https://github.com/agentscope-ai/CoPaw/pull/810))
- **时区统一处理**：前后端统一标准化为 UTC 时间，防止时间戳不一致 ([#771](https://github.com/agentscope-ai/CoPaw/pull/771))
- **会话表格修复**：修复会话页面中复选框列重叠问题 ([#936](https://github.com/agentscope-ai/CoPaw/pull/936))
- **聊天竞态修复**：解决流式响应期间用户消息消失的竞态条件问题 ([#1033](https://github.com/agentscope-ai/CoPaw/pull/1033))

**提供商架构**

- **Provider 架构重构**：模块化 provider 系统，包含基类、生命周期管理器和统一配置处理 ([#734](https://github.com/agentscope-ai/CoPaw/pull/734))

## 🐛 问题修复

**平台兼容性**

- **Windows 文件路径**：正确处理媒体文件的 `file://` URL 和 Windows 绝对路径格式 ([#832](https://github.com/agentscope-ai/CoPaw/pull/832))
- **Shell 编码问题**：Windows 上 shell 命令输出智能 UTF-8 解码，失败时自动回退到系统编码 ([#979](https://github.com/agentscope-ai/CoPaw/pull/979))

**频道与文件处理**

- **钉钉 Office 文件**：从 payload 提取文件名提示，防止 Office 文件被错误保存为 ZIP ([#1025](https://github.com/agentscope-ai/CoPaw/pull/1025))
- **文件传递优化**：移除 `send_file_to_user` 中不可达代码分支，统一文件传递行为 ([#917](https://github.com/agentscope-ai/CoPaw/pull/917))
- **技能导入优化**：技能文件优雅处理 UTF-8 解码错误 ([#783](https://github.com/agentscope-ai/CoPaw/pull/783))

**控制台与界面**

- **URL 验证**：自定义验证器，支持放宽主机名要求的 HTTP(S) URL，适配 Docker 网络环境 ([#1007](https://github.com/agentscope-ai/CoPaw/pull/1007))
- **版本徽章**：修正侧边栏版本显示的样式和定位 ([#787](https://github.com/agentscope-ai/CoPaw/pull/787))
- **文件通知**：基于智能体配置的语言感知文件下载消息 ([#808](https://github.com/agentscope-ai/CoPaw/pull/808))

## 📚 文档

- **品牌标识更新**：新 logo 设计和社交媒体集成（X、小红书），覆盖网站和 README 文件 ([#781](https://github.com/agentscope-ai/CoPaw/pull/781), [#761](https://github.com/agentscope-ai/CoPaw/pull/761))
- **README 更新**：更新品牌、安装指南、模型配置和源码安装说明 ([#815](https://github.com/agentscope-ai/CoPaw/pull/815), [#821](https://github.com/agentscope-ai/CoPaw/pull/821))
- **桌面应用指南**：提供 Windows/macOS 桌面应用的完整安装、故障排除和安全指南 ([#997](https://github.com/agentscope-ai/CoPaw/pull/997))
- **路线图更新**：v0.0.5 后路线图更新，反映已完成功能和未来优先级 ([#826](https://github.com/agentscope-ai/CoPaw/pull/826))
- **记忆与命令文档**：增强记忆压缩文档，新增 `/message` 命令文档并改进布局 ([#1008](https://github.com/agentscope-ai/CoPaw/pull/1008))
- **文档修复**：修正 MCP 文档链接，添加 cron 任务创建说明 ([#1015](https://github.com/agentscope-ai/CoPaw/pull/1015), [#1025](https://github.com/agentscope-ai/CoPaw/pull/1025))
- **网站优化**：优化首页组件排序、动画和视觉呈现 ([#1053](https://github.com/agentscope-ai/CoPaw/pull/1053))

## 🔧 CI/CD

- **首次贡献者欢迎**：合并新贡献者 PR 时自动发送欢迎消息并收集社交媒体账号 ([#762](https://github.com/agentscope-ai/CoPaw/pull/762))
- **Issue 模板清理**：移除过时的 bug 报告和问题模板 ([#834](https://github.com/agentscope-ai/CoPaw/pull/834))
