## 功能特性 - 跨会话长期记忆：把 AI 的记忆持久化到 SQLite 数据库，重启或换会话后仍可继续使用。 - MCP 双协议接入：同时提供 `Streamable HTTP` 与 `SSE` 两种 MCP 端点，兼容不同客户端。 - 可视化审计后台：通过 Dashboard 浏览记忆树、查看差异、回滚 AI 写入、维护领域与启动记忆。 - 多命名空间隔离：同一个实例里可以为不同 Agent 或不同人格维护独立记忆空间。 - 记忆结构化组织：支持 URI 路由、别名、触发词、系统索引、最近变更和诊断视图。 - 私有部署友好：适配为单容器 onebox 交付，应用后台和 MCP 服务共用同一实例，数据默认持久化保存。 ### 首次使用流程 1. 打开应用后，在配置向导中填写或保存系统生成的 `API Token`。这个 Token 后续既用于 Dashboard 首次登录，也用于外部 MCP 客户端连接；长度必须至少 32 个字符。 2. 首次进入时会看到登录界面 `Nocturne Admin（记忆管理面板）`，在 `请输入 API Token` 输入框中填入安装时设置的值。 3. 点击 `连接` 进入 Dashboard。当前中文界面的顶部导航实际显示为： - `审查与审计` - `记忆浏览器` - `大脑清理` - 右上角 `设置` 4. 首次安装时数据库是空的，不会自动导入 `demo.db` 示例数据；新实例默认也不会预填任何 `Boot URIs`。建议登录后先进入 `记忆浏览器` 创建第一条记忆，再到 `设置 > 启动 URI` 配置真实可加载的启动记忆。 6. 如果你准备给某个 AI 客户端接入该实例，可使用： - `https://nocturne-memory.你的盒子名.heiyu.space/mcp` 作为 Streamable HTTP 端点 - `https://nocturne-memory.你的盒子名.heiyu.space/sse` 作为 SSE 端点 - 请求头 `Authorization: Bearer <安装时设置的 API Token>` 7. 右上角的命名空间选择器只会在 `记忆浏览器` 和 `大脑清理` 页面显示；`审查与审计` 页面不会显示该控件，这是当前界面的正常行为。 ### 日常使用方式 1. 在 `审查与审计（Review）` 页面查看 AI 新增、修改或删除的记忆变更，按需执行回滚。 2. 在 `记忆浏览器（Memory）` 页面按 URI 树浏览记忆，创建节点、编辑内容、维护别名和关键词触发器。 3. 在 `记忆浏览器` 或 `大脑清理` 页面右上角，通过 `(default)` / `+ enter custom…` 切换不同 Agent 的独立命名空间。 4. 在 `设置 > 启动 URI` 中维护 `system://boot` 的加载列表，建议只填真实存在的 URI。 5. 通过外部 MCP 客户端调用 `read_memory`、`create_memory`、`update_memory`、`search_memory` 等工具，让 AI 在真实工作流中持续写入和检索记忆。