6682d74 
yang208115
运阳
NekroAgent 更新日志 (v2.3.0 → v2.4.0)
✨ 重点更新一：构建专业级内置知识库系统
本次更新为 NekroAgent 引入了完整的内置知识库系统。这标志着 Agent 从单纯依赖“对话上下文”演进为具备“行业深度专业知识”的智能体。用户可以轻松维护海量文档资料，让 Agent 在对话中实时检索、引用并组织成体系的知识。
- 体系化资料管理：
- 支持创建多个独立的知识库，允许用户按照业务主题、项目细节或学习笔记进行目录级分类管理。
- 多格式深度兼容：系统已实现对文本、PDF、Office 系列文档（Word/Excel/PPT）以及结构化表格的自动解析与向量化。
- Zip 压缩包高效导入：支持直接上传 Zip 压缩包，系统会根据压缩包内的原始目录结构自动完成文档归类，极大提升了存量资料的入库效率。
- 智能化检索与可视化：
- 知识关联图谱：系统可自动识别文档间的引用关系，并通过直观的图谱界面展示资料间的知识脉络，让知识库不再是“黑盒”。
- 精准检索插件：Agent 可通过专用插件实时检索关联资料，并在任务执行或对话回复中引用确切证据。
- 高性能索引构建：支持大批量文件的异步后台处理，并允许根据部署环境的硬件资源灵活配置索引并发数，确保构建过程平稳高效。
- 平滑切换机制：优化了索引更新流程，确保在知识重建或模型切换期间，现有的检索服务始终保持在线，并具备完善的失败回滚保障。
感谢 @liugu2023 贡献了内置知识库核心框架、管理 WebUI、知识图谱及独立 Embedding 配置等完整实现。和进一步强化了知识库与全局资产索引的原子切换与高可用保障。
感谢 @wess09 贡献了知识库批量上传异步化、Zip 压缩包安全导入及索引并发配置能力。
✨ 重点更新二：多平台适配器生态的深度互联
本次更新继续扩展了多平台接入版图，重点提升了社交软件与邮件系统的集成深度，助力实现真正意义上的“万端互联”。
1. 微信生态的增强接入
- OpenILink 适配器：提供极简的 WebUI 二维码登录方案，完美支持文本、图片、文件等全媒体消息收发，并具备精准的入站媒体解析能力。
- iLink 多实例底座：创新性地引入了通用适配器多实例架构。现在，一个 NA 实例可以同时运行多个微信 Bot，各实例具备独立的生命周期管理、状态续期与事件记录能力。
感谢 @yang208115 贡献了微信 OpenILink 适配器及其可视化登录管理。
感谢 @1A7432 贡献了通用适配器多实例底座及微信 iLink 多实例适配方案。
2. 邮件管理（Email）
- 全协议支持：支持 Gmail、Outlook 的 OAuth2 认证，以及标准的 IMAP/SMTP 和 Microsoft Graph 接入。
- 账户化管理流程：支持在 WebUI 中集中管理多个邮箱账户，提供邮件详情查阅、附件直接读取、收件诊断及安全展示等功能，满足专业办公场景需求。
感谢 @liugu2023 贡献了 Email 适配器账户化工作流、收件箱管理及安全防护。
3. QQ 与 企业微信的深度适配
- QQBot OpenClaw：新增适配器支持，完整覆盖私聊、群聊、引用消息及媒体消息流，并具备极强的连接自愈能力。
- OneBot V11 持续增强：支持语音消息自动转文字，并大幅优化了私聊文件收发流程与群文件消息的去重逻辑。
- 企业微信官方 Bot：强化了用户名解析与资料同步能力，支持图片、文件等附件的自动化下载、解密与标准化存储。
感谢 @XG2020 贡献了 OneBot V11 语音转写与插件优化。
感谢 @tooplick 贡献了 OneBot V11 文件收发流程优化。
感谢 @wess09 贡献了群文件去重、文件名解析及消息归一化增强。
感谢 @liugu2023 贡献了企业微信官方 Bot 的深度功能补强。
✨ 重点更新三：WebUI 部署管理控制面板
我们为管理员打造了全新的「部署管理」页面，将复杂的更新与维护工作转化为直观的网页端点击操作。
- 版本一键控制：支持在 WebUI 中直接升级至 Stable 正式版或切换至 Preview 预览版，操作简便安全。
- 实时任务监控：提供实时执行日志流，即使用户在任务期间刷新浏览器，也能重新连接并续接任务状态，随时掌握更新进度。
- 安全保障体系：升级前可一键创建完整备份，并支持快速回退。系统内置敏感信息清理机制，确保运维过程中的隐私安全。
- 使用前提：部署管理依赖 na-tools 接管当前 Nekro Agent 实例。若您此前不是通过 na-tools 安装或管理 NA，请先参考 使用 na-tools 接管已有 NA 实例 完成接管后再使用该功能。
感谢 @yang208115 贡献了部署管理后端代理、可视化控制面板及任务日志续接等完整实现。
✨ 重点更新四：原生网页聊天 (Web Chat) 与 MCP 闭环调试
本次新增官方内置的 WebUI 网页聊天适配器，极大地方便了管理员直接对 Agent 的各项能力进行端到端测试。
- 沉浸式测试环境：管理员可以在后台直接创建测试会话，发送包含图片或文件的消息，并实时观测 Agent 的插件调用结果与回复效果。
- 媒体上下文保留：网页上传的媒体文件会完美转化为 Agent 可理解的上下文，历史记录与命令回显更加精准。
- MCP (Model Context Protocol) 深度集成：支持通过 MCP 接口自动执行聊天测试，非常适合进行端到端的自动化回复链路验证。
感谢 @yang208115 贡献了网页聊天适配器、媒体上下文处理及内置 Web Chat MCP 能力。
✨ 重点更新五：重构命令权限与频道作用域体系
为了兼顾管理的灵活性与系统的安全性，我们对命令执行权限与频道作用范围进行了深度重构。
- 多层级权限模型：统一了
普通用户(USER) / 频道管理员(ADVANCED) / 超级管理员(SUPER_USER)三档权限。群主及管理员现可自动获得所在频道的频道管理员权限，自主管理频道开关与状态。 - 精准的作用域限制：频道管理员仅能操作当前频道的配置，涉及跨频道调度、宿主机脚本（sh/exec）或 Docker 环境的操作依然严格锁定在超级用户级别。
- 动态权限映射：系统会根据平台角色变化实时动态调整权限，并在用户管理页面清晰展示每一位用户的实际生效权限，方便快速排查。
感谢 @yang208115 贡献了命令权限模型重构、频道范围限制及用户管理可视化增强。
⚡ 性能优化与体验升级
插件与模型服务
- 插件专属 WebUI：插件现在可以拥有独立的管理或展示页面，支持挂载本地 HTML 或插件内路由。
- MCP 服务库管理：升级为“全局库+工作区按需启用”模式，支持实时验证 SSE/stdio 服务状态。
- GPT-Image 原生 API：绘图插件新增对 OpenAI 原生图片接口的兼容，支持多参考图绘制，创作更自由。
- 用量透明化：OpenAI 流式响应现可返回精准的 Token 消耗统计，助力精准掌控成本。
感谢 @liugu2023 贡献了 MCP 服务库重构与工作区启用体系。
感谢 @yang208115 贡献了插件 WebUI 路径挂载与安全校验能力。
感谢 @XG2020 贡献了插件调用优先级配置及 GPT-Image 原生接口支持。
感谢 @wess09 贡献了 OpenAI 流式用量统计及模型配置体验优化。
交互与频道管理
- 频道自定义展示：支持为频道设置显示名，并可配置成员进群欢迎语或退出通知。
- 笔记插件分层策略：优化了长效笔记的上下文占用，优先保留近期笔记全文，远期笔记仅保留标题索引。
- 移动端深度优化：全面重构了终端、日志、定时任务等页面在移动端的布局，窄屏体验更佳。
- 配置保护机制：切换页面时若存在未保存的修改，系统会主动发出提醒，确保配置不丢失。
感谢 @liugu2023 贡献了频道自定义名称与成员通知功能。
感谢 @Akiyo-dayo 贡献了笔记分层注入、定时任务校验及 OpenAI 兼容修复。
感谢 @wess09 贡献了 WebUI 上手引导、多轮移动端适配及配置保护逻辑。
🛠 稳定性修复与加固
- 沙盒环境优化：规范化了 Docker 容器命名规则，显著提升了跨平台兼容性，并优化了构建缓存的利用率。
- 核心 Agent 加固：增强了定时任务的时间戳校验与异常任务清理能力，确保系统启动阶段的绝对稳定性。
- 安全防护补强：在邮件展示中加入 XSS 防护，在 Zip 导入中加入路径穿越校验，全方位保障后台安全。
感谢 @liugu2023、@Akiyo-dayo、@NekroMeow 在系统稳定性与安全性方面提供的持续优化。
🆙 升级提示
- 本版本包含多项数据库迁移，升级前请务必利用新版「部署管理」功能创建完整备份。
- 升级完成后，请前往「系统设置 → 知识库」检查并核对 Embedding 模型组与向量维度配置。
- GPT-Image 原生模式需确保服务端点支持 OpenAI
images/generations接口。 - 使用部署管理页面前，请确保宿主机已正确部署并启用了新版 NA-Tools daemon。
Full Changelog: v2.3.0...v2.4.0
