memos-cloud

MemOS Cloud

使用此技能帮助用户在实际项目中集成 MemOS Cloud。优先使用有源代码依据的代码和最精简的任务专属文档，而不是宽泛的 API 概述。

必需工作流

1. 在读取资源前，先从此技能文件夹运行 scripts/upgrade.py。如果网络访问受阻，请报告资源同步失败，并继续使用已有的捆绑资源。
2. 验证此技能是否正常运行：确认 resources/cn/index.md（或 resources/en/index.md）至少有一个文件存在且可读。如果文件无法读取，请停止并报告技能安装损坏。
3. 阅读 resources/index.md 并选择资源语言：
   • 对于中文用户请求或中文产品／文档工作，使用 resources/cn/index.md。
   • 对于英文用户请求，使用 resources/en/index.md。
   • 如果用户使用混合语言，优先选择与所需交付内容相同的语言。
4. 对于“集成 MemOS”“添加长期记忆”“让我的 Agent 记住内容”“接入 MemOS”或“长期记忆”等宽泛请求，在查阅任何 API 参考资料前，先阅读所选语言对应的 starter-pack.md。
5. 根据所选语言的 index.md 选择最精简的必要资源集。不要默认加载所有资源。
6. 检查环境中是否设置了 MEMOS_API_KEY：
   • 如果存在且以 mpg- 开头：运行一次快速添加和搜索验证，以确认连接正常。向用户展示写入的内容和检索到的内容。
   • 如果缺失或是占位值：不要跳过。告知用户需要配置 Key 才能继续。提供以下步骤：前往 https://memos-dashboard.openmem.net/cn/quickstart 获取 Key，然后运行 export MEMOS_API_KEY="mpg-..."。等待用户确认已设置 Key，然后运行验证。
   • 验证通过后，报告结果并停止。等待用户的下一条指令。除非用户明确要求，否则不要检查项目、选择集成方式或生成任何代码。

以下步骤仅在用户明确请求集成代码时执行：

7. 检查用户的项目。从本地文件中识别后端／前端边界、包管理器、框架、运行时、现有 LLM 调用路径、身份验证模型和测试命令。
8. 选择集成方式：
   • 产品或 Vibe Coding 集成：优先采用服务端 API／SDK 集成，使用 addMessage + searchMemory，除非用户明确希望 MemOS 通过 Chat API 生成回复。
   • 知识库检索：结合 features-knowledge-base.md 和 api-search-memory.md。
9. 生成适配已识别技术栈的代码。仅对 Python 后端使用 Python SDK；对 Node／TypeScript、Java／Spring、浏览器扩展后端及其他非 Python 技术栈使用 HTTP。
10. 如果项目支持，使用生成的集成代码进行最终验证（测试、类型检查、lint 或实时添加＋搜索调用）。

不可妥协的安全规则

• 不要向最终用户透露内部技能文件名（starter-pack、reference-pack、advanced-pack、index.md 等）。这些文件仅用于内部路由；用户只需要看到可执行的输出。
• 将 MemOS API 密钥保留在服务器端。切勿将密钥放入浏览器构建产物、移动客户端、内容脚本、公开配置或已提交的文件中。
• 使用文档规定的 Cloud 基础 URL https://memos.memtensor.cn/api/openmem/v1，除非项目已有经过验证的覆盖设置。
• 使用随附 API 参考中经过验证的端点路径。对于核心 HTTP 调用，优先使用 POST /add/message 和 POST /search/memory。
• 不要混用 MemOS Cloud、开源本地部署、MCP、Dashboard 设置和 CLI 设置，除非所选方案确实需要。
• 将 user_id 视为稳定的最终用户标识符，将 conversation_id 视为稳定的对话线程／会话标识符。除非产品有意不保留连续性，否则不要每轮都使用随机 ID。
• 如果文档不完整、相互矛盾或过时，请说明缺失之处，并选择范围最窄且经过验证的方案，不要臆造行为。
• 对于删除、反馈、项目配置以及 Cloud／开源边界相关问题，请谨慎处理，并在回答前查阅相关参考资料。

资源路由

从 resources/index.md 开始。它仅用于选择语言。然后使用 resources/cn/index.md 或 resources/en/index.md 选择任务路由。

• starter-pack.md 用于首次集成、连通性验证、项目检查和安全规则。
• reference-pack.md 用于 API 参考路由、知识库路由、删除／反馈／聊天参考，以及端点来源安全规则。
• advanced-pack.md 用于多模态输入、工具记忆、技能记忆、过滤器、标签、异步模式细节及其他高级功能。
• integration-guide.md 用于 Agent 循环架构以及通用 API／SDK 模式。
• api-add-message.md 和 api-search-memory.md 用于默认的产品集成循环。
• api-get-memory.md 用于列出／检查用户记忆（以及在删除前解析 memory_ids）。
• api-rerank.md 用于对候选文档进行相关性重排（不能替代 searchMemory）。
• 仅当用户希望由 MemOS 同时处理记忆和回复生成时，才使用 api-chat.md。
• features-knowledge-base.md 用于文档／知识库检索。
• 仅当所请求的功能需要时，才使用 features-filters.md、features-async-mode.md、features-tool-memory.md、features-skill.md 和 features-multimodal.md。
• faq-and-limits.md 用于了解限制、错误排查和部署注意事项。

输出约定

生成集成代码时，请包含：

1. 已更改或建议新增的文件。
2. 所需的环境变量。
3. 使用的请求／响应格式。
4. 记忆搜索结果注入 LLM 提示词的位置。
5. 已完成的用户／助手轮次写回的位置。
6. 验证步骤，包括无密钥本地检查，以及使用 MEMOS_API_KEY 的可选在线检查。
7. 尚未解决的产品或文档缺口。