novel-memory

name	novel-memory
description	三维记忆系统操作指南 - 教 agent 如何使用 memory/openmemory/milvus 进行知识管理
mcp	{"memory":{"command":"npx","args":["-y","dotenv-cli","--","dotenv","-e",".env","--","npx","-y","@modelcontextprotocol/server-memory"]},"openmemory":{"type":"remote","url":"http://localhost:8765/mcp/cursor/sse/worker"},"milvus":{"command":"uv","args":["run","--with","mcp-server-milvus","mcp-server-milvus","--milvus-uri","http://localhost:19530"]}}

三维记忆系统操作指南

你已被注入 novel-memory 技能。通过 skill_mcp 工具访问以下三个 MCP 服务。

---

1. memory — 静态知识图谱

定位：存储长期稳定的结构化知识（实体、关系、规则、世界观设定）。

核心操作

操作	工具	用途
create_entities	skill_mcp → memory	定义新实体（人物、组织、地点、物品）
add_observations	skill_mcp → memory	为已有实体添加属性/观察
create_relations	skill_mcp → memory	建立实体间关系
search_nodes	skill_mcp → memory	按关键词检索实体
open_nodes	skill_mcp → memory	读取指定实体的完整信息

使用时机

• 写作前：查询角色设定、世界规则，确保不偏离
• 写作中：核对人物背景、关系网络
• 写作后：新角色/新设定/关系变化时，立即写入

存储内容

• 人物：姓名、年龄、外貌、性格、背景、动机
• 世界观：魔法体系、科技水平、政治制度、地理环境
• 规则：魔法限制、科技原理、社会禁忌
• 组织：阵营、势力、层级结构

原则

• 初始化时记录：定义新实体/规则时立即存入
• 更新时同步：设定演变时及时更新
• 避免冗余：只记录核心的、长期有效的信息
• 防遗忘：防止第 100 章时忘记第 1 章的设定

---

2. openmemory — 时间线日志

定位：记录按时间顺序发生的事件、状态变化和进展日志。

核心操作

通过 skill_mcp → openmemory 访问：

• 写入日志条目（章节摘要、角色状态、伏笔记录）
• 读取最新日志（获取前文状态）
• 搜索特定条目（查找伏笔、事件）

使用时机

• 每章开始前（必读）：读取上一章摘要、角色状态、未回收伏笔、时间线
• 每章完成后（必写）：存储本章摘要、角色状态变化、新伏笔、时间线进度
• 新书启动时（清空）：清空旧记录，避免串台

存储内容

• 章节摘要：精简的情节进展（3-5 要点）
• 角色当前状态：位置、情绪、关系变化、持有物品
• 伏笔清单：已埋设但未回收的伏笔（标注埋设章节和预计回收章节）
• 时间线：故事内时间进度

读写策略

• 写：章节完成后立即归档，不拖延
• 读：新章节开始前必读，确保连贯
• 清：新书启动时清空

---

3. milvus — 向量化知识检索

定位：通过语义向量检索相关文本片段，用于灵感获取和风格参考。

核心操作

操作	工具	用途
milvus_get_collection_info	skill_mcp → milvus	查看集合结构，确认向量字段名
milvus_text_similarity_search	skill_mcp → milvus	语义相似度检索文本片段

关键约束（必读）

• anns_field 参数必须填写向量字段名（如 vector 或 embedding）
• 绝对不能填写文本字段名（如 content 或 text）
• 填错会导致搜索失败

标准使用流程

1. 调用 milvus_get_collection_info → 查看 Schema，确认 FLOAT_VECTOR 类型字段名
2. 调用 milvus_text_similarity_search：
   - anns_field = 上一步确认的向量字段名
   - query_text = 自然语言描述检索需求
   - 获取 3-5 个相关文本片段
3. 分析结果：提取韵味、节奏、手法，参考而非抄袭

使用时机

• 自主创作模式启动时（确定主题和风格）
• 卡文需要灵感时
• 参考特定场景描写方式时
• 学习叙事风格时

---

工具组合策略

写作循环（标准流程）

开始新章 → openmemory(读) + memory(查) → 写作 → openmemory(写) + memory(更新)

自主创作启动

milvus(检索灵感) → memory(建立设定) → openmemory(记录进度)

一致性验证

memory(核对设定) + openmemory(检查时间线) → 发现冲突 → 修正

---

注意事项

1. 工具职责分明：memory 存静态设定，openmemory 存动态日志，milvus 做检索
2. 跨工具一致性：更新 memory 中的设定时，检查 openmemory 中是否有相关日志需要同步
3. milvus 必须验证：每次使用前必须先 get_collection_info 确认字段
4. 定期维护：清理过时信息，保持记忆系统有效性