📦 luci-memory — luci 内存

luci-memory 安装需要 MEMORIES_AI_KEY。在第一次使用时，如果没有找到密钥，脚本将报错并要求提供一个。当用户提供密钥时，将其保存到 {baseDir}/.env：MEMORIES_AI_KEY=sk-密钥。之后，一切都可以正常工作 —— 密钥将从 .env 文件自动加载。

时区 Luci-memory 中的所有时间戳都以 UTC 存储和返回。技能输出标签为“UTC”，因此这是明确的。用户的本地时区在 USER.md 中（例如 Asia/Shanghai）。您负责双向转换：

• 读取结果：在向用户呈现捕获时间时，从 UTC 转换为用户的本地时区。永远不要向用户显示原始 UTC 标签。
• 编写过滤器：--after 和 --before 被解释为 UTC。如果用户输入相对日期，如“昨天”或“今天早上”，请将他们的本地时间意图转换为 UTC 范围，然后传递日期。

示例（用户在 Asia/Shanghai，UTC+8，询问“昨天我做了什么”于 2026-04-08）：

• 本地意图：2026-04-07 00:00 → 2026-04-08 00:00（Asia/Shanghai）
• 传递的 UTC 范围：--after 2026-04-06T16:00:00 --before 2026-04-07T16:00:00

如果 USER.md 中没有时区并且用户使用相对日期，请先询问他们。

统一搜索 在 Luci-memory API 中对个人媒体和肖像数据进行统一搜索。用户的视频经过两个处理管道，生成不同的数据：

• 媒体内容（个人）：视频摘要、音频转录、视觉转录、关键帧、图像
• 人物和知识（肖像）：特征、事件参与者、关系、归因于发言者的演讲

何时使用

• 用户要求查找或搜索视频、图像或照片
• 用户要求知道视频中说了什么或显示了什么
• 用户要求列出最近的视频或图像
• 用户要求关于特定位置或时间的媒体
• 用户要求关于特征、个性、爱好、兴趣
• 用户要求关于发生的事件或涉及特定人员的事件
• 用户要求关于人员之间的关系
• 用户要求关于某人说了什么
• 用户提到“luci memory”或希望使用他们的视频记忆

选择正确的类型

• 关于内容（发生了什么、说了什么/显示了什么、查找媒体）→ 使用媒体类型（search_video、query_audio 等）
• 关于人员（谁、特征、关系、命名个体）→ 使用肖像类型（特征、事件、演讲等）
• 模糊的问题，如“上周 Alice 发生了什么？”→ 使用两者：肖像类型来识别人员和事件，媒体类型来获取详细的视频内容和转录。

人员名称回退：

• 只有在至少 5 个视频中出现并被用户在应用程序中命名的人才具有肖像数据。如果按人员名称进行肖像查询没有返回结果，请回退到媒体类型 —— 搜索视频摘要、音频转录或视觉转录以查找该名称的提及。

相关性指南 没有重新排名的过程 —— 检索的结果可能包含与用户实际意图不相关的项目。始终验证相关性：在接收结果后，检查每个项目以查看是否与用户的原始查询匹配。只呈现相关的结果。丢弃任何不匹配的项目。

• 精化和重试：如果结果看起来不正确或太广泛，请使用更具体的查询、更窄的日期范围或附加过滤器重试。不要简单地将低质量的结果转储给用户。
• 询问用户：如果查询模糊或太模糊以产生良好的结果，请在搜索之前询问用户更具体的条件。澄清比返回噪音更好。最多这样做一次。
• 没有幻想 —— 将每个声明都建立在检索的数据上
• 永远不要编造用户所做、所说或所经历的事情。答案中的每个细节都必须来自实际的搜索结果。
• 多步检索：对于诸如“XXX 时我做了什么和说了什么”之类的问题，请不要从单个广泛的搜索中回答。遵循以下模式：

- 定位：广泛搜索（search_video、search_events）以找到相关的 video_ids 或 event_ids。 - 检索：一旦您拥有 ID，请使用 --video-ids 首选 query_audio/query_visual 以获取完整的转录。您也可以使用 search_audio/search_visual 来查找特定时刻 —— 根据需要灵活使用两者。

• 不要将关键词塞入搜索查询中。每个语义搜索查询都应是一个简短、连贯的自然语言查询，而不是堆叠多个可能的单词。虽然您可以尝试不同的查询并多次查询。
• 如果数据丢失，请说明。不要用听起来合理的猜测填补空白。“我找不到该视频的转录数据”总比编造东西要好。

如何调用 注意：--after/--before 是 UTC。首先从用户的本地时区转换（见上面的时区部分）。 向用户返回图像/关键帧 图像和关键帧结果包括 bucket 和 blob 字段。要在聊天中发送图像，请从 Luci-memory 图像代理端点获取字节，然后通过 OpenClaw 转发：

• 从代理端点下载图像字节：curl -sL -o /path/to/workspace/ima...