Lore

设置项参考

召回、模型、生命周期文本、写入策略、Dream 和备份的运行时设置及默认值。

查阅 Lore 保存的每一项运行时设置,包括键名、默认值和作用。这些设置保存在数据库中,应在控制台或通过 API 修改,而不是在 .env 中修改。部署环境变量列在服务器配置中。

如何修改设置

  • 自托管: 在 Web 控制台中打开 /settings,或发送带有 patch 对象的 PUT /api/settings 请求。每个值都要使用对应的 JSON 类型:数字和布尔值不加引号,字符串加引号。

    curl -fsS -X PUT http://127.0.0.1:18901/api/settings \
      -H 'content-type: application/json' \
      -H 'authorization: Bearer lm_your_token' \
      --data '{"patch": {"recall.display.min_display_score": 0.6, "dream.cron": "0 2 * * *"}}'
  • Loremem 云服务: 打开项目的设置页面。标签页包括偏好、生命周期、策略、Dream、模型和备份。在模型标签页中,你可以选择 embedding 配置和运行时 LLM 配置。云服务不需要你填写 API key。

  • 密钥: embedding.api_key、view_llm.api_key 和 backup.webdav.password 只写不读。Lore 不会再次显示已保存的值,只会显示是否已设置。如需替换,请发送新的值。

召回

显示与保护

键默认值作用
recall.display.min_display_score0.60得分低于该值的候选不会注入提示词。取值范围 0 到 1。
recall.display.max_display_items3每次召回最多注入的记忆条数。取值范围 1 到 20。
recall.safety.max_query_chars200对于很长的提示,召回只使用前 N 个字符,并注明已截断。取值范围 50 到 2000。
recall.safety.timeout_ms2000超过这个毫秒数,召回会跳过并附带提示。在 Loremem 云服务中作用于提问召回;在自托管服务器上作用于召回 API,Agent 钩子使用各自的超时。取值范围 500 到 30000。

权重

键默认值作用
recall.weights.w_exact0.30路径、术语和查询词精确匹配的权重。
recall.weights.w_glossary_semantic0.25查询与术语之间语义相似度的权重。
recall.weights.w_dense0.30稠密 embedding 相似度的权重。
recall.weights.w_lexical0.03全文(词法)匹配的权重。

加分

键默认值作用
recall.bonus.priority_base0.05优先级 0 的加分。优先级每增加 1,加分减少 priority_step。
recall.bonus.priority_step0.01优先级每增加 1,减少的加分。
recall.bonus.multi_view_step0.015每匹配一种额外的视图类型(gist 或 question)所增加的加分。
recall.bonus.multi_view_cap0.05多视图加分的上限。

新近度

键默认值作用
recall.recency.enabledtrue给最近更新的记忆加分,给较早的记忆减少加分。设为 false 则使用早期版本的评分方式。
recall.recency.half_life_days180新近度加分降至最大值一半所需的天数。取值范围 7 到 3650。
recall.recency.max_bonus0.04刚刚更新的记忆可获得的最大新近度加分。取值范围 0 到 0.3。
recall.recency.priority_exempt1优先级不高于该值的记忆永不衰减。设为 -1 则所有记忆都会衰减。

视图

键默认值作用
views.weight.gist1.0稠密与词法排序中 gist 视图匹配的乘数。
views.weight.question0.96稠密与词法排序中 question 视图匹配的乘数。
views.prior.gist0.03gist 视图匹配时增加的加分。
views.prior.question0.02question 视图匹配时增加的加分。

模型

键默认值作用
embedding.provideropenai_compatibleEmbedding API 协议。目前仅支持兼容 OpenAI 的 /embeddings 协议。
embedding.base_url空Embedding 服务的 base URL,例如 https://api.openai.com/v1。
embedding.api_key空(只写)Embedding 服务的 API key。
embedding.modeltext-embedding-3-smallEmbedding 模型名称。
view_llm.provideropenai_compatible视图和 Dream 使用的聊天协议:openai_compatible、openai_responses 或 anthropic。
view_llm.base_url空聊天端点的 base URL。留空时,视图精修和 Dream 运行都会关闭。
view_llm.api_key空(只写)聊天端点的 API key。
view_llm.modeldeepseek-v4-flash用于生成 gist 视图和 question 视图的模型。
view_llm.temperature0.2采样温度。0 最确定。取值范围 0 到 2。
view_llm.max_docs_per_run4一次索引构建中,LLM 最多精修的文档数。取值范围 0 到 100。
view_llm.timeout_ms1800000每次视图和 Dream 的 LLM 调用超时,默认为 30 分钟。取值范围 1000 到 1800000。
view_llm.api_version空可选的 API 版本请求头。原生 Anthropic 端点通常需要它。

生命周期

键默认值作用
lifecycle.guidance.enabledtrue会话启动时注入 Lore 的全局使用规则。
lifecycle.guidance.global内置文本会话启动时为每个运行时注入的使用规则。
lifecycle.boot.preamble内置文本显示在启动记忆节点列表之前的文字。Agent 仍然通过 lore_boot 读取节点内容。
lifecycle.startup_recall.preamble内置文本显示在启动召回 <recall> 块之前的文字。
lifecycle.prompt_recall.preamble空显示在每条提示词的 <recall> 块之前的文字。为空时,只注入该块。

生命周期文本的内置默认值是中文。

策略

键默认值作用
policy.priority_budget_enabledtrue在创建和更新时执行全库容量上限:优先级 0 最多 5 条,优先级 1 最多 15 条。
policy.disclosure_warning_enabledtrue新建记忆没有触发条件,或触发条件用“或”“或者”“以及”连接多个情境时发出提醒。

Dream

键默认值作用
dream.enabledtrue按计划运行 Dream。需要配置 View LLM。
dream.cron0 3 * * *五段式 cron 表达式(分、时、日、月、星期),按服务器时区计算。
dream.auto_approve_changesfalse自动将 Dream 的变更标记为已批准。关闭时,变更会等待审核。
dream.exclude_session_patterns[]正则表达式列表。召回查询文本命中任一正则的会话,不会进入 Dream 审阅的召回元数据。

备份

键默认值作用
backup.enabledtrue按计划运行备份。
backup.cron0 4 * * *备份的五段式 cron 表达式。0 * * * * 表示每小时运行一次。
backup.retention_count7保留最新的本地备份数量,更早的备份会被删除。取值范围 1 到 100。
backup.local.enabledtrue把备份文件保存在 SNAPSHOT_DATA_DIR 下。
backup.webdav.enabledfalse把备份上传到 WebDAV 服务器。
backup.webdav.url空WebDAV 地址,例如 https://dav.example.com/backups/。
backup.webdav.username空WebDAV 用户名。
backup.webdav.password空(只写)WebDAV 密码。
backup.include_recall_eventsfalse备份中是否包含召回事件。它们可能会让备份变得很大。

缓存

键默认值作用
cache.enabledtrue是否使用缓存。设为 false 时,跳过所有缓存读写。设置了 REDIS_URL 时使用 Redis。

提示词

提示词的键是很长的模板。下面每一组只占一行,而不是逐个列出每个键。

分组键数量用途
prompts.view_generation.system1生成 gist 视图和 question 视图的系统提示词
prompts.boot_draft.*13起草启动记忆:一个系统提示词,外加共享节点、每个 client_<runtime> 节点的说明,以及额外约束
prompts.dream.*7Dream 的系统提示词、日记改写提示词,以及每个阶段的提示词:诊断、规划、预检、应用和审计

提示词中包含占位符,例如 {{instructions}}、{{client_type}}、{{guidance}}、{{plan_json}} 和 {{apply}}。请保留每个提示词所需的占位符。只有当你清楚每个阶段如何使用其输出时,才应修改 Dream 的提示词。