MCP 2.0 Compatibility & Long-Form Improvements

Nocturne Memory 2.5.6 现已发布。

中文

• 兼容 MCP 2.0 的 Python SDK，同时继续支持旧版本。
• 记忆诊断新增过长记忆检测，帮助发现需要拆分或清理的内容。
• 前端右上角的设置里可以调整过长记忆的检测阈值。
• AI读取大型记忆时会向AI显示内容体积。
• update_memory tool 支持用 ... 定位和替换长段落。

English

• Added compatibility with the MCP 2.0 Python SDK while retaining support for older versions.
• Added oversized-memory detection to diagnostics, making it easier to find memories that should be split or cleaned up.
• Added a setting for adjusting the oversized-memory detection threshold.
• Content size is now displayed when AI reading large memories.
• update_memory tool now supports using ... to locate and replace long text blocks.

完整变更记录 / Full Changelog:
2.5.5...2.5.6

2.5.4 — Boot 预设切换 & 孤儿恢复

✨ 启动预设：可以同时存多套配置了 / Boot URI Presets
你现在可以同时保存好几套Boot记忆的预设了（比如一套日常用，一套工作用，一套酒馆用），在面板里点一下就能一秒来回切。你以前的旧配置，系统已经自动帮你存成预设了。 You can now hold multiple boot memory presets and toggle between them instantly. Your legacy configs are safely auto-migrated.

🧹 大脑清理与孤立记忆捞回 / Maintenance & Orphan Recovery
优化了大脑清理页面的操作体验，支持按记忆分组一键清空。 最重要的是，本版本全新加入了“捞回记忆”功能——你现在可以安全地把被删除的记忆（孤儿记忆）重新挂载回图谱。 Access log clearing is now global. More importantly, we introduced the Restore Orphan feature—you can now safely recover detached memories.

🌐 Domain 管理整合进浏览器 / Consolidated Domain UI
Domains 配置从设置页砍掉了。现在你直接在 Memory Browser（记忆浏览器）里就能顺手添加和删除 Domain，不用再跳来跳去。 The standalone Domains section is gone. Manage your domains directly within the Memory Browser.

Full Changelog: 2.5.3...2.5.4

2.5.2 — 重大Bug修复 & 中文支持

🐛 修复：升级后页面没变化 / Fix: UI not updating after upgrade

之前版本升级后，打开面板可能还是旧界面。现在升级后刷新页面就能看到最新版本。

Previously, the dashboard could still show the old UI after upgrading. Now refreshing the page will always load the latest version.

🌐 面板支持中文了 / Chinese locale support

Settings 里新增语言切换，选中文即刻生效，不用重启。

New language switcher in Settings. Select Chinese and it takes effect instantly — no restart needed.

其他改进 / Other improvements

• 空的 Domain 现在可以直接在面板里创建第一条记忆了 / Empty domains can now create their first memory directly from the dashboard
• 所有弹窗替换为界面内组件，不再弹系统对话框 / All native dialogs (alert/confirm/prompt) replaced with in-app components
• 后端错误信息也支持中文显示 / Backend error messages now support Chinese

Full Changelog: 2.5.1...2.5.2

2.5.1 — Memory Editor

✨ Memory Browser → Memory Editor

Dashboard 从只读浏览器升级为完整编辑器。不用再让 AI 帮你改记忆了。

The Dashboard is no longer read-only. Edit your memory graph directly from the browser.

Dashboard 新增功能

• 创建记忆：节点详情页一键创建子节点
• 别名管理：直接添加/删除 alias，级联路径选择器辅助定位
• 路径重命名：编辑模式下改名，子路径自动跟随，Boot URI 自动重写，失败自动回滚
• Namespace 切换修复：切换后自动跳转到新 namespace 根节点，不再 404
• URL Token 认证：?token=xxx 直接登录

New Contributors

• @WhiteGiverMa made their first contribution in #47

Full Changelog: 2.5.0...2.5.1

2.5.0 — Settings Dashboard / 设置面板

✨ 新增 Settings 面板

不用再手动编辑 .env 了。Dashboard 顶栏新增 Settings 按钮，所有配置项都能在浏览器里直接改：

• Database：查看连接状态、测试连接、创建新 SQLite 数据库、打开数据库文件夹
• Boot URIs：选择 AI 启动时自动加载哪些记忆，支持按 Namespace 独立配置
• Domains：管理可用的记忆域（core, writer, game…）
• Server：Host、Port、CORS、API Token 等

No more hand-editing .env. A new Settings button in the Dashboard navbar — all configuration is now editable from the browser:

• Database: View connection status, test connections, create new SQLite databases, open DB folder
• Boot URIs: Choose which memories auto-load on system://boot, configurable per namespace
• Domains: Manage available memory domains
• Server: Host, Port, CORS, API Token, etc.

🔍 Memory Browser 增强

• 搜索：顶栏新增搜索框，输入关键词实时查找记忆节点

• Boot 快捷标记：节点卡片上的 ⚡ 按钮，一键添加/移除启动记忆

• 删除：节点详情页可直接删除记忆（带确认）

• Boot 节点高亮：启动记忆的卡片有琥珀色边框，一眼可辨

• Search: Search bar in the top bar for live memory lookup

• Boot Quick Toggle: ⚡ on node cards to add/remove from boot memories

• Delete: Delete memories directly from the detail view (with confirmation)

• Boot Highlight: Boot memory cards get an amber border

🔧 Bug 修复

• 删除记忆节点时，关联的 Glossary Keywords 现在会一起清理（之前会残留）
• Fixed: deleting a memory node now properly cleans up its Glossary Keywords

⚠️ Docker 用户升级步骤

Docker 部署从 3 容器简化为 2 容器，需要重新生成配置：

git pull
python scripts/setup_docker.py    # 自动读取旧凭证，生成新配置
docker compose up -d --build

Docker deployment simplified from 3 containers to 2. Run the setup script to migrate.

本地（stdio）用户

直接更新，首次启动自动迁移，无需手动操作。

Just update and start. Migration is automatic.

Full Changelog: 2.4.2...2.5.0

2.4.1 Security: require API_TOKEN for HTTP/SSE transport

⚠️ Breaking Change / 不兼容变更

HTTP/SSE transport now requires API_TOKEN to start.
Previously, leaving API_TOKEN empty silently disabled authentication,
exposing the memory API to anyone on the same network.

以前 API_TOKEN 留空会静默关闭认证，导致同局域网内任何人都能访问记忆 API。
现在 HTTP/SSE 模式启动时必须设置 API_TOKEN。

Migration / 迁移步骤

1. Generate a token / 生成令牌：
   python -c "import secrets; print(secrets.token_urlsafe(32))"
2. Add to .env / 写入 .env：
   API_TOKEN=
3. Update MCP client config / 更新客户端配置：

{
  "headers": {
    "Authorization": "Bearer <your-token>"
  }
}

stdio mode (local MCP) is not affected.
本地 stdio 模式不受影响。

Full Changelog: https://github.com/Dataojitori/nocturne_memory/compare/2.4.0...2.4.1

2.4.0 新增记忆维护指导

Full Changelog: 2.3.0...2.4.0

新增了记忆维护功能和它的指导。见readme的🧹 记忆维护：让 AI 学会反思与成长章节。

2.3.0 前端自动启动

Full Changelog: 2.2.0...2.3.0
简化了启动步骤，现在在docker之外的mcp在启动时会自动启动人类用的后端并弹出前端了

2.2.0 规范了ai行为

Full Changelog: 2.1.1...2.2.0
新增了对ai的read行为追踪，方便供后续维护记忆时提供指导
清晰化了mcp的函数指令

2.1.1优化了提示词

Full Changelog: 2.0.1...2.1.1