web-official/public/release-notes/v0.0.5.zh.md

## ✨ 新增功能

**频道与通信**

- **频道管理系统**：全面的频道自定义管理，支持按类型筛选（全部/内置/自定义）、动态字段编辑器和频道类型标识 ([#615](https://github.com/agentscope-ai/CoPaw/pull/615))
- **消息过滤机制**：按频道配置隐藏工具执行过程和思考内容，仅展示最终结果，让聊天体验更清爽 ([#449](https://github.com/agentscope-ai/CoPaw/pull/449), [#704](https://github.com/agentscope-ai/CoPaw/pull/704))
- **Twilio 语音频道**：接入 Twilio 语音服务，支持通过 Cloudflare 隧道进行安全连接 ([#38](https://github.com/agentscope-ai/CoPaw/pull/38))
- **Telegram CLI 配置**：提供命令行交互式配置工具，支持设置机器人令牌、前缀、代理和打字提示 ([#529](https://github.com/agentscope-ai/CoPaw/pull/529))
- **钉钉功能增强**：
  - 富文本消息支持插入图片 ([#471](https://github.com/agentscope-ai/CoPaw/pull/471))
  - 通过消息 ID 追踪和内容哈希实现去重，避免重复处理钉钉重发的消息 ([#489](https://github.com/agentscope-ai/CoPaw/pull/489))
  - 支持配置 `open` 和 `allow_from` 参数，精细控制私聊和群聊访问权限 ([#661](https://github.com/agentscope-ai/CoPaw/pull/661))
- **iMessage 附件支持**：iMessage 频道支持发送图片、音频和视频文件 ([#386](https://github.com/agentscope-ai/CoPaw/pull/386))

**模型与 AI 功能**

- **DeepSeek 推理模式**：支持 DeepSeek Reasoner 模型，保留推理过程（`reasoning_content`），兼容工具调用场景 ([#707](https://github.com/agentscope-ai/CoPaw/pull/707))
- **模型自动发现**：支持自动检测可用模型，显示提供商状态；内置 Anthropic 提供商 ([#408](https://github.com/agentscope-ai/CoPaw/pull/408))
- **自定义模型请求头**：模型 API 请求支持添加自定义 HTTP 请求头 ([#740](https://github.com/agentscope-ai/CoPaw/pull/740))

**系统与管理**

- **版本更新提醒**：自动检测新版本，在侧边栏显示更新徽章，点击可查看详细更新说明，并快速跳转到文档、FAQ 和更新日志 ([#715](https://github.com/agentscope-ai/CoPaw/pull/715))
- **守护进程模式**：新增 `copaw daemon` 命令管理后台服务，支持查看状态、重启、重载配置、查询版本和查看日志 ([#597](https://github.com/agentscope-ai/CoPaw/pull/597))
- **智能体中断功能**：提供 `interrupt()` 方法主动取消正在执行的回复任务，确保资源正确释放 ([#728](https://github.com/agentscope-ai/CoPaw/pull/728))
- **/message 命令**：通过消息索引快速查看对话历史中的指定消息 ([#638](https://github.com/agentscope-ai/CoPaw/pull/638))
- **MCP 客户端自动恢复**：MCP 会话断开时自动重连并重建，失败时优雅降级，避免覆盖会话状态 ([#431](https://github.com/agentscope-ai/CoPaw/pull/431))

**安装与平台**

- **Windows 一键安装**：提供 `install.bat` 批处理脚本，Windows 用户双击即可安装 ([#742](https://github.com/agentscope-ai/CoPaw/pull/742), [#484](https://github.com/agentscope-ai/CoPaw/pull/484))
- **频道文档快捷入口**：各频道卡片新增"文档"按钮，一键跳转配置指南 ([#556](https://github.com/agentscope-ai/CoPaw/pull/556))

## 🔄 优化改进

**记忆与性能**

- **记忆系统升级**：升级至 reme-ai 0.3.0.3，支持 vLLM 嵌入，简化管理并优化 token 计数 ([#383](https://github.com/agentscope-ai/CoPaw/pull/383), [#566](https://github.com/agentscope-ai/CoPaw/pull/566))
- **记忆压缩优化**：优化自动压缩算法，更精准地估算上下文总大小，提升记忆管理准确度 ([#547](https://github.com/agentscope-ai/CoPaw/pull/547))
- **按需加载频道**：可选频道采用懒加载机制，减少启动时间和内存占用 ([#596](https://github.com/agentscope-ai/CoPaw/pull/596))
- **MLX 模型优化**：下载 ModelScope 完整快照，提升 MLX 模型的加载稳定性 ([#602](https://github.com/agentscope-ai/CoPaw/pull/602))

**控制台与界面**

- **控制台功能增强**：
  - 支持取消进行中的聊天请求 ([#545](https://github.com/agentscope-ai/CoPaw/pull/545))
  - 侧边栏支持折叠展开，展开时所有菜单组自动打开 ([#567](https://github.com/agentscope-ai/CoPaw/pull/567), [#663](https://github.com/agentscope-ai/CoPaw/pull/663))
  - 优化前端构建流程，资源缺失时提供更明确的提示 ([#588](https://github.com/agentscope-ai/CoPaw/pull/588))
- **过滤配置生效**：控制台现在正确应用 `filter_tool_messages` 和 `filter_thinking` 配置 ([#744](https://github.com/agentscope-ai/CoPaw/pull/744))
- **定时任务界面**：重新设计 UI，采用结构化布局、提示文案和帮助文档链接，提升易用性 ([#595](https://github.com/agentscope-ai/CoPaw/pull/595))

**模型与提供商**

- **OpenAI 模型列表**：修正模型 ID，将无效的 `gpt-5-chat` 替换为 `gpt-5`，新增 `gpt-5.2` ([#498](https://github.com/agentscope-ai/CoPaw/pull/498))
- **提供商状态简化**：统一为 `available`/`unavailable` 状态，移除冗余的 `has_api_key` 字段 ([#442](https://github.com/agentscope-ai/CoPaw/pull/442))
- **Ollama 超时配置**：支持为 Ollama 操作设置超时时间，避免请求挂起 ([#427](https://github.com/agentscope-ai/CoPaw/pull/427), [#634](https://github.com/agentscope-ai/CoPaw/pull/634))

**工具与集成**

- **浏览器工具**：支持系统浏览器检测，macOS 上自动回退至 WebKit；优化安装流程并改进错误提示 ([#451](https://github.com/agentscope-ai/CoPaw/pull/451))
- **技能中心**：优化 GitHub API 错误处理，提供更清晰的速率限制提示和更智能的默认分支检测 ([#506](https://github.com/agentscope-ai/CoPaw/pull/506))
- **心跳回复**：更新文档，建议提供有上下文的个性化心跳回复，避免机械式应答 ([#599](https://github.com/agentscope-ai/CoPaw/pull/599))

## 🐛 问题修复

**核心修复**

- **配置持久化**（Docker 用户重点关注）：修复容器重启后配置丢失问题，将 `providers.json` 和 `envs.json` 迁移至持久化目录 `SECRET_DIR`，支持自动迁移和安全加固 ([#346](https://github.com/agentscope-ai/CoPaw/pull/346), [#345](https://github.com/agentscope-ai/CoPaw/pull/345))
- **Ollama 连接配置**：修复 `base_url` 配置不生效的问题，所有 Ollama 操作现在支持指定服务器地址 ([#683](https://github.com/agentscope-ai/CoPaw/pull/683))

**频道修复**

- **钉钉**：修复 webhook 处理逻辑，避免复用过期会话 ([#446](https://github.com/agentscope-ai/CoPaw/pull/446))
- **飞书**：修复定时任务消息投递，正确附加频道元数据和接收者 ID ([#464](https://github.com/agentscope-ai/CoPaw/pull/464))
- **QQ**：过滤消息中的 URL 以避免触发 QQ API 错误 ([#362](https://github.com/agentscope-ai/CoPaw/pull/362))
- **Telegram**：修复智能体处理时打字提示持续显示的问题，添加打字提示超时保护，修复频道关闭时的竞态条件 ([#640](https://github.com/agentscope-ai/CoPaw/pull/640), [#686](https://github.com/agentscope-ai/CoPaw/pull/686))

**模型与提供商修复**

- **OpenAI 兼容提供商**：
  - 修复多轮对话失败，移除消息中不支持的顶层 `name` 字段 ([#452](https://github.com/agentscope-ai/CoPaw/pull/452))
  - 修复流式工具调用数据格式错误导致的崩溃，新增流数据清理器 ([#488](https://github.com/agentscope-ai/CoPaw/pull/488))
- **控制台模型提供商处理**：控制台遇到未知提供商时不再阻塞，模型测试异步执行 ([#655](https://github.com/agentscope-ai/CoPaw/pull/655))

**平台特定修复**

- **Windows**：
  - 修复 Windows 11 + Python 3.13 环境下的子进程兼容性问题 ([#622](https://github.com/agentscope-ai/CoPaw/pull/622))
  - 修复浏览器自动化问题，Windows 重载模式下使用同步 Playwright ([#732](https://github.com/agentscope-ai/CoPaw/pull/732))
- **Shell 命令卡死**：强制执行超时机制，避免子进程占用管道导致命令挂起 ([#672](https://github.com/agentscope-ai/CoPaw/pull/672))
- **本地文件路径**：修复 agentscope 集成中音频/图片/视频本地文件路径处理 ([#627](https://github.com/agentscope-ai/CoPaw/pull/627))

**系统与界面修复**

- **控制台编译错误**：解决 ChannelCard 组件的 TypeScript 类型错误，改用运行时类型检查 ([#687](https://github.com/agentscope-ai/CoPaw/pull/687))
- **MCP 客户端**：
  - 修复长名称溢出显示问题，添加省略号和悬停提示 ([#540](https://github.com/agentscope-ai/CoPaw/pull/540))
  - MCP 客户端初始化失败不再导致应用启动失败，通过优雅降级确保应用正常运行 ([#727](https://github.com/agentscope-ai/CoPaw/pull/727))
- **工具系统**：修复"工具已在工具包中注册"错误，支持自动处理重复注册 ([#438](https://github.com/agentscope-ai/CoPaw/pull/438))
- **AgentScope 版本兼容**：适配 AgentScope 1.0.16 正式版 ([#699](https://github.com/agentscope-ai/CoPaw/pull/699))
- **CLI 命令**：移除 `config key` 命令中多余的提供商验证 ([#457](https://github.com/agentscope-ai/CoPaw/pull/457))

## 📚 文档

**指南与教程**

- **模型配置文档**：提供云服务提供商、本地模型（llama.cpp/MLX）及 Ollama 的完整配置教程（中英文版本） ([#630](https://github.com/agentscope-ai/CoPaw/pull/630))
- **Docker + Ollama 打通指南**：如何让 Docker 容器中的 CoPaw 访问宿主机的 Ollama 服务，提供两种连接方案（中英日三语） ([#696](https://github.com/agentscope-ai/CoPaw/pull/696))
- **定时任务排查手册**：定时任务不生效？手把手教你排查，配截图说明 ([#721](https://github.com/agentscope-ai/CoPaw/pull/721))
- **Telegram 配置指南**：提供 Telegram 频道完整配置文档，包括机器人注册、配置和代理设置 ([#592](https://github.com/agentscope-ai/CoPaw/pull/592))
- **iMessage 使用指南**：iMessage 频道从配置到使用的完整文档 ([#748](https://github.com/agentscope-ai/CoPaw/pull/748))

**国际化与导航**

- **日文文档**：新增日文 README 完整翻译，支持跨语言跳转 ([#354](https://github.com/agentscope-ai/CoPaw/pull/354))
- **FAQ 入口**：所有 README 文件添加常见问题页面链接 ([#601](https://github.com/agentscope-ai/CoPaw/pull/601))
- **项目路线图**：在官网和 README 发布产品路线图和社区贡献指南，提供中英双语版本 ([#428](https://github.com/agentscope-ai/CoPaw/pull/428), [#439](https://github.com/agentscope-ai/CoPaw/pull/439))

**网站与资源**

- **版本发布记录**：网站集成版本更新日志，历史版本一目了然 ([#724](https://github.com/agentscope-ai/CoPaw/pull/724))
- **贡献者墙**：README 展示所有贡献者头像，感谢每一位参与者 ([#650](https://github.com/agentscope-ai/CoPaw/pull/650))
- **Docker 安全加固**：默认端口绑定改为 `127.0.0.1`，仅允许本机访问，钉钉二维码同步更新 ([#681](https://github.com/agentscope-ai/CoPaw/pull/681))

## 🔧 CI/CD

- **首次贡献者标签**：自动为首次贡献者的 PR 打上标签 ([#533](https://github.com/agentscope-ai/CoPaw/pull/533))
- **贡献规范**：PR 模板强制要求通过 pre-commit 检查，优化贡献指南 ([#421](https://github.com/agentscope-ai/CoPaw/pull/421))