Skip to content

v2.3.0 智行合一 · 忆往长存

Latest
Latest

Choose a tag to compare

View all tags
@KroMiose KroMiose released this 18 Apr 09:38
· 37 commits to main since this release
v2.3.0
f9537aa

NekroAgent 更新日志 (v2.2.0 → v2.3.0)

✨ 重点更新一：CC 工作区（Claude Code 协作沙盒）

本次更新为 NekroAgent 引入了全新的 Claude Code 工作区，让 Agent 具备了调度独立 AI 执行器完成复杂任务的能力。

QQ_1776503027995

  • 它能做什么: 你可以为任意聊天频道绑定一个 CC 工作区，主 Agent 可以将任务委托给独立的 Claude Code 执行器在后台运行。CC 执行器拥有完整的工具链，结合不同的技能（Skill）搭配，可以完成包括但不限于：

    • 编程与文件处理：写代码、跑脚本、生成报告、修改文档
    • 联网调研：配合内置 agent-browser 技能实现网页搜索、信息抓取与分析
    • GitHub 协作：配合内置 gh 技能实现自动提 Issue、PR、代码审查、仓库管理
    • 自定义扩展：CC 可在工作中自主创建新技能（动态 Skill），持续积累专属能力
    • 以及更多：任何需要"复杂强大的执行能力"而不只是"回答或基础工具调用能力"的场景

  • 对您的影响:

    • 为 NA 赋予了强大的极具扩展性的 Claude Code 双 Agent 协同工作能力，极大扩展了 NA 的能力边界，并且可直接复用 Claude Code 庞大的社区资源！
    • CC 的工作目录通过沙盒隔离和持久化保留，产出的资源、文档通过共享目录交付，安全可控
    • 支持随时观测任务交互、取消任务、重置会话等，满满的可观测安全感，告别黑盒 Agent！
    • 可通过 Skill、MCP、自定义资源 等方式灵活扩展 CC 的能力，从管理服务器到维护 Git 仓库、网络调研，不再被插件能力约束！

工作区配套管理体系

CC 工作区不只是另一个沙盒容器，WebUI「工作区」模块提供了一整套围绕 CC 能力的管理界面：

  • 技能库（Skills）：在工作区的「扩展」页中为 CC 选配技能。技能决定了 CC 能做什么——内置技能（浏览器操作、GitHub 协作等）开箱即用，你也可以上传自定义技能包或通过 Git 仓库引入。CC 在完成任务过程中还能自主创建"动态技能"，积累下来的成熟技能可以晋升后在其它工作区复用

  • MCP 服务管理：在工作区的「扩展」页中配置 CC 可连接的 MCP 服务。MCP 是一种标准化的工具接入协议，接入后 CC 可以直接调用这些外部能力，进一步扩展其行动范围

  • 资源中心：在工作区的「资源中心」页中管理 CC 执行任务时需要用到的外部凭证（API 密钥、服务器密钥、环境变量等）。支持按模板创建结构化凭证条目并绑定到指定工作区，CC 在执行任务时自动获取，无需在对话中手动传递。例如：配置好远程服务器的 SSH 密钥和地址后，CC 就能直接连接接管并完成服务部署、自动运维等操作

  • 提示词编排：在工作区的「提示词」页中可以直接编辑 CC 的工作规范和角色定义，包括 CC 执行规则、当前工作区协作状态备注、NA 专属规则等多个层级，细粒度控制 CC 的行为

  • CC 模型预设：为不同工作区单独配置 CC 所使用的模型（支持 Anthropic 官方 API 或任意兼容接口），随时切换

  • 定时任务：原 定时器插件 正式升级为 定时任务插件 ，支持自然语言表达配置 CRON 长期任务、工作日/节假日 特殊定时任务，更可搭配 CC 沙盒实现定期采集信息、长期自动化复杂任务等需求

✨ 重点更新二：记忆系统

本次更新引入了全新的 长期记忆系统（Memory System），让 Agent 具备跨对话的长期记忆能力，并提供了高度可视化记忆图谱界面功能。

QQ_1776503220209

  • 它能做什么: Agent 会在对话后自动将重要信息沉淀为长期记忆，包括用户偏好、重要约定、历史事件、人物关系等。下次对话时，系统自动召回相关记忆并注入上下文，让 Agent 不再是"失忆的助手"。

  • 对您的影响:

    • Agent 记得住你告诉过它的事，记得住之前发生过什么，不用每次都重新解释
    • 记忆按实体、关系、段落等多个维度结构化存储，检索更精准
    • 记忆支持同工作区中跨频道共享，以此来打破频道之前硬隔离的传统界限，让 Agent 能够更好地协同多个频道下的沉淀知识
    • WebUI 可视化管理：工作区「记忆图谱」面板可查看当前积累的全部记忆内容（实体、关系图谱、关键段落等），支持手动编辑、删除单条记忆等

NekroAI 云社区全面重构

NekroAI 云社区（cloud.nekro.ai）完成了框架级全栈重构，本次随 v2.3.0 同步上线的社区新功能包括：

  • 插件版本兼容声明：插件作者现可在发布时声明插件所适配的 NA 版本范围（minNaVersion / maxNaVersion），插件市场将据此过滤不兼容版本，用户看到的插件均与当前运行版本匹配
  • 资源收藏：支持收藏插件与人设，收藏内容统一在个人主页查看与管理
  • 社区公告系统：新增公告管理能力，支持发布、编辑、置顶与删除公告，公告内容将在客户端显著位置展示

功能增强

插件激活策略（动态唤醒机制）

  • 变更详情: 新增插件级别的激活策略，借鉴 Claude Code 的 Skill 按需加载理念——插件提示词不再全量常驻于每轮对话上下文，而是由调度器根据当前对话内容动态决定哪些插件"保持活跃"、哪些"进入休眠"。休眠中的插件只向 Agent 暴露一句简短摘要，有需要时由 Agent 自主唤醒。

    这意味着，即使你安装了大量插件，每轮 token 消耗也不会线性膨胀。

    可在插件管理页面为每个插件单独选择策略（需要插件支持休眠）：

    • 自动（Auto）：遵循插件自身的默认声明
    • 允许休眠（Allow Sleep）：纳入动态调度，按需唤醒
    • 禁止休眠（Forbid Sleep）：始终展开全量提示词，适合核心常驻插件

命令系统重构

  • 变更详情: 命令系统全面重构，新增独立的「命令中心」管理页面，可查看所有命令的来源（内置 / 插件）、直接在前端修改各命令的权限配置。命令执行结果支持富媒体输出，图片、表情包等。
    感谢 @liugu2023 贡献了命令系统重构、权限管理与富媒体输出的完整实现

企业微信适配器

  • 变更详情: 新增两套完整的企业微信接入方案——官方 AI Bot（适合公共群聊、团队问答场景）和自建应用（适合内部业务助手、服务通知场景）。两套方案均支持文字、图片、文件收发。
    感谢 @liugu2023 贡献了企业微信适配器的完整实现

飞书适配器

  • 变更详情: 新增飞书（Feishu）平台适配器，通过 WebSocket 长连接接入飞书开放平台，无需公网回调地址。支持群聊与私聊，可收发文字、图片、文件，支持 @提及，并会在处理消息时给出即时表情回应反馈。适合将 NA 带进飞书工作区，承担团队问答、协作辅助、日常通知等高频场景。
    感谢 @yang208115 贡献了飞书适配器的完整实现，感谢 @liugu2023 完善了适配器配置体验与各适配器内置文档

Minecraft 鹊桥 v2 适配器升级

  • 变更详情: Minecraft 适配器升级支持鹊桥 v2 协议，扩大了对不同 Minecraft 服务端的兼容范围。
    感谢 @johntime2005 和 @Zaxpris 贡献了此协议支持

数据内容查看工具（v2.2.1）

  • 变更详情: 新增内置沙盒工具 view_str_content，让 Agent 能在运行时"看到"数据的具体内容。Agent 读取 Excel、CSV 或其他文本文件后，可通过该工具分页浏览实际内容，再据此进行分析和决策，而不必依赖盲猜或全量导入。支持按行范围截取、显示行号、最大字符限制等参数，可在系统设置中独立开关。

会话管理升级

  • 频道配额: 支持为不同频道配置每小时回复配额，防止高频场景下的资源滥用，并支持临时额度提升
  • 频道旁观模式: 可将频道设置为静默旁观状态，Agent 读取消息但不主动回应，适合信息采集、单向注入等场景
  • 邮箱适配器增强: 邮件适配器新增 WebUI 收件箱管理页面，可在面板中查看和管理收到的邮件
  • 停止回复: 新增随时中止当前正在进行中的 AI 回复的能力，在上游卡死时不再需要等待漫长的响应超时结束
    感谢 @liugu2023 贡献了上述功能的实现

WebUI 聊天消息重构

  • 变更详情: 会话详情页消息历史改为 QQ 风格气泡布局（含头像、昵称、时间分隔线），支持图片内联渲染与点击预览、文件卡片展示，并新增了直接通过 WebUI 向频道发送消息（文字 + 文件上传）的能力。
    感谢 @liugu2023 贡献了此次重构的完整实现

Agent 实时状态可视化推送

  • 变更详情: 构建了全局实时状态广播系统，Agent 运行状态、工作区活动等信息动态实时推送到 WebUI 界面，大幅提高 NA 的工作状态可观测性。

模型管理界面统一

  • 变更详情: 将基础模型组与 CC 专用模型预设整合为统一的「模型管理」页面，并新增模型连通性测试功能，可实时验证模型 API 的连通状态与响应速度。

系统配置分类管理

  • 变更详情: 系统配置页面改为按标签分组展示，大量配置项可按分类实现快速定位和搜索，不再大海捞针。
    感谢 @yang208115 贡献了此功能的实现

节日祝福插件化与增强

  • 变更详情: 节日祝福功能从内置逻辑拆分为独立的标准插件（festival_greeting），新增全局总开关，可按需启停，不再与核心系统耦合。
    感谢 @liugu2023 贡献了插件化拆分实现，感谢 @XG2020 贡献了黑白名单机制优化

云社区增强

  • 用户个人中心: 新增云社区个人主页，展示已发布的插件与人设，支持收藏社区资源。个人主页 UI 经过全面重构，插件卡片与人设卡片改为更清晰的信息卡布局，收藏列表展示也同步升级
  • 社区用户头像: 插件市场、用户管理等相关界面现已支持展示 NekroAI 云社区头像
    感谢 @yang208115 贡献了个人中心、收藏功能与社区头像的实现

仪表盘实时统计优化

  • 变更详情: 仪表盘实时统计图表进行了大幅性能优化分桶缓存与并发控制机制，对已完成时间桶的统计结果进行内存缓存，并发请求同一桶时共享查询结果，避免重复查询数据库；——后端引入所有统计查询改为数据库侧聚合（COUNT DISTINCT、AVG），不再将大量数据传回应用层处理。前端图表在数据加载期间新增 loading 状态提示，体验更流畅。

性能优化与问题修复

核心 Agent

  • 优化流式响应处理逻辑和 LLM 请求超时配置，增加首 Token 超时独立配置，减少因 LLM 上游故障引发的无效等待
  • 统一系统代理配置，确保代理设置在所有出站请求中生效一致
  • 修复聊天频道 API 消息解析边界问题
  • 修复多种 @提及 解析器的问题，提高解析成功率
  • 提示词系统重构与优化，大幅提高上下文缓存命中率

适配器

  • 修复 Telegram 适配器中 caption 字段丢失、方法重复定义及 build_chat_key 缺少 else 分支的问题
    感谢 @1A7432 贡献了此修复
  • 修复升级后旧版命令 API 插件实例兼容问题
    感谢 @liugu2023 贡献了此修复
  • 修复未启用插件的命令仍会暴露给 Agent 的问题；插件启停后现在自动同步命令清单，确保 Agent 只能调用当前有效的命令
    感谢 @liugu2023 贡献了此修复（#250）

工作区与容器

  • 修复沙盒容器网络自动检测中的并发安全问题与 Docker 网络 ID 校验问题
  • 修复 na_info 命令中 CC 沙盒状态显示不正确的问题
    感谢 @liugu2023 贡献了此修复
  • 修复记忆系统重建脚本中日志格式错误导致的日志输出异常

前端

  • 修复大量交互按钮、页面文案等显示原始键值（未本地化）的问题
  • 减少初始化阶段的重复请求，优化页面首次加载性能

基础设施

  • 固定 Qdrant 向量数据库镜像版本，避免自动拉取新版镜像引发兼容性问题

部署与运维

NA-Tools

本次同步首发面向 macOS / Linux 的命令行自动化部署与运维工具（NekroAI/na-tools v1.3.2），提供一键安装体验与完整的生命周期管理：

  • 一键部署：na-tools install 自动完成 Docker 检测、配置引导与服务部署；支持 --with-cc-sandbox 选项同步拉取 CC 沙盒镜像
  • 多实例管理：同一台机器可安装并管理多个 Nekro Agent 实例，通过 na-tools list 查看、na-tools use 切换激活实例
  • Preview 预览版切换支持：na-tools update --preview 切换至预览版（自动备份），na-tools update --rollback 一键回退，切换全程可控
  • 备份与恢复：支持命名备份、查看备份列表与交互式恢复；备份内容涵盖数据目录、.env、docker-compose.yml 及 Docker 存储卷（PostgreSQL、Qdrant）
  • NapCat 引导：na-tools napcat 引导完成 NapCat 登录并自动配置 OneBot 连接
  • 镜像源配置：na-tools config 快速切换 Docker 镜像源，适应不同网络环境

Nekro Agent for Windows

本次同步首发基于 PyQt6 构建的 Windows 图形化部署工具（NekroAI/nekro-agent-for-windows v1.2.0），覆盖从环境准备到服务上线的完整流程，无需命令行即可完成 Nekro Agent 的安装与日常运维：

  • 首次运行向导：自动检测 WSL2 与 Docker 环境，完成发行版导入、镜像拉取与服务部署
  • 两种部署模式：支持精简版与 NapCat 完整版，按需选择
  • 服务总览控制台：集中展示运行状态、部署模式、数据目录与最近活动日志
  • 镜像管理：支持界面化查看 Nekro Agent 相关镜像并按需更新
  • 内置浏览器：直接访问 Nekro Agent / NapCat 管理界面，支持多标签页、凭据自动填充与跨重启登录态保持
  • 预览版切换：支持切换至 Preview 镜像并从备份恢复正式版，切换前可选备份当前数据
  • 日志中心：分类展示应用日志、Nekro Agent 日志、NapCat 日志与更新过程输出
  • 设置页：支持端口配置、端口冲突检测、一键打开数据目录与部署目录

更多

  • 数据库迁移自动化: 应用启动时自动执行数据库迁移，升级版本后无需手动操作
  • WRTInstall 脚本增强: 更新 OpenWrt 一键安装脚本，新增 Docker 镜像源配置支持，修复若干已知问题，添加中英文双语提示 - 感谢 @tooplick 贡献了此脚本更新

New Contributors

Full Changelog: v2.2.0...v2.3.0

Contributors

johntime2005, XG2020, and 5 other contributors
Assets 2
Loading