Ombre Brain

时间顺序按综合衰减分排列

全选当前页已选 0

加载中… / Loading…

0 / 0 张正式记忆卡排序等待载入

正在读取正式记忆卡…

LEGACY OB · MIGRATION REVIEW

旧 OB 待整理

逐条查看旧 OB 原文、拟更新的正式卡与模型建议。这里暂时只读，不会修改正式记忆，也不会让旧记忆沉底。

VPS-only · 人工确认前零写入

CONSOLIDATED PREVIEW

只看真正会变化的卡

同一目标卡已合并；没有变化的正式卡不会出现。

0 张0 可批量确认0 需要你看

正在生成整合预览…

CODEX · PROVISIONAL TRIAGE

剩余旧记忆的暂定归组

这里只展示 Codex 的第一轮判断；尚未写卡、关联、入库或沉底。

0 组0 条来源

正在读取 Codex 对账结果…

查看原来的逐条旧 OB 审核（82 条）

0 / 0 条旧记忆等待载入

正在读取 VPS 上的审核草稿…

Recall Diagnostics · 记忆浮现观察

看看一句话会唤起哪些记忆

这里只观察真实的 BM25、模糊匹配与 Embedding 融合候选。结果不会送进聊天，也不会改变任何记忆卡。

SHADOW MODE · 零注入

等待一次查询不会注入 Claude 上下文

输入一句话，看看记忆会怎样轻轻浮上来。

真实对话 · 影子决定

Opus 4.6 会判断本来是否需要搜索、选择哪些记忆；目前始终零注入。

影子 Recall Agent 尚未留下记录。

Recall Lab · VPS-only comparison

召回对比实验室

对照生产 ready 选择与机械 Parent/Child 检索。标题直接显示；命中项同时显示具体片段。这里可能包含私密记忆，只通过当前 Dashboard 登录态读取。

READ ONLY · 不改变召回与记忆

等待载入实验报告

正在等待 VPS 上的召回对比报告…

① 输入 Input
query / valence / arousal

→

② 候选池 Candidates
— 桶

→

③ 四维评分 Scoring
topic×4 + emotion×2 + time×2.5 + imp×1

→

④ 阈值过滤 Threshold
≥50 → — 通过

→

⑤ 降序排列 Sort
返回 top N

Query Valence Arousal

输入 query 后点击「模拟」查看评分链路 · Enter a query and click Simulate

[[双链]]

#tag

既是双链也是 tag Both

共现 Co-occurrence

模式 Mode

SYSTEM READY · 等待载入记忆网络… / Waiting for network…

历史对话导入 Import Conversations

支持 Claude JSON、ChatGPT 导出、DeepSeek、Markdown、纯文本格式

拖拽文件到此处，或点击选择 Drop a file or click to choose

保留原文模式 Keep Raw（特殊情境/暗号/仪式性内容不摘要）

导入预检 Preflight

等待文件…

已导入记忆 Imported

高频模式检测 Frequent Patterns

使用须知与常见问题 FAQ & Usage Guide

部署、持久盘、GitHub 备份、MCP/OAuth、API 与向量化常见问题集中整理在 FAQ。遇到连接失败、401、更新后记忆为空或向量化异常时，请先查看这里。

打开 Ombre Brain 使用须知与 FAQ

服务日志 Service Logs

级别行数

点击刷新加载日志…

server.log 末尾最多 500 行。

错误日志 Error Codes

统一收录所有 W 级以上错误（OB-W*/OB-E*/OB-F*）与自动降级提示（OB-I*）。
每条带时间戳 + 一键复制（含错误码 + 描述 + 建议 + 最近 15 条 log）。

最低级别

点击「刷新」加载… / Click Refresh to load…

2.4.0 Debug

Replay

计划 Plans — what I promised, what I'm carrying

完成 Done / 放弃 Dropped / 重新激活 Reopened

点击「刷新」加载… / Click Refresh to load…

加载中… / Loading…

写一封 Write a Letter

身份 From

标题 Title

正文 Body

信件时间线 Letter Timeline

筛选

点击「刷新」加载信件…

暗房 Darkroom

未显影的底片不可读。积满 8 帧后会自动显影，再进入 Developing Room。
Sealed frames stay private until the eighth frame develops the roll.

…

显影室 Developing Room

点击刷新 / Click Refresh

已显影底片 Developed Roll

回信 · REPLY

Anchor — 坐标系

anchor 是「定义我们是谁」的事实。它们不会主动出现在默认 breath 里——只在 query / domain / emotion 命中时浮现。
硬上限 24。满了之后，要 anchor 新的就必须先 release 一条旧的。

当前：…

加载中… / Loading…

常规Basics

高级Advanced

备份与迁移Backup

版本 & 更新 Version & Update

当前版本：…

我 Me

称呼 / 昵称 Name

系统通知 + 记忆里对你的称呼（如你的名字或昵称）。留空 = 默认「人类」。
保存时会把已有记忆里的旧称呼一并换成新名（标题 / 正文 / 备注），新旧不再并存。

称呼

已经改过名、但旧记忆里仍残留旧称呼（如「用户」）？在这里填旧词，一键替换为当前称呼：

账户密码 Password

当前密码

新密码

确认

急救安全问题 Recovery Question

忘记密码时，凭此问题重置密码进入急救模式。

安全问题

答案

Cloudflare Tunnel （从外网访问 Dashboard）

如何获取 Token？点击查看步骤 ▸

打开 Cloudflare Zero Trust → Networks → Tunnels
点击 Create a tunnel → 选 Cloudflared → 给 Tunnel 起个名字
在 "Install connector" 页面，选 Docker，复制命令里 --token 后面那一长串字符（以 eyJ 开头）
把这串 Token 粘贴到下面输入框，点保存 → 启动
回到 Cloudflare，添加 Public Hostname：Domain 填你的域名，Service 填 http://localhost:8000（容器内端口）

未运行

TUNNEL TOKEN

启动时自动连接

退出登录 Log Out

服务 Service

服务状态 Service Status

加载中… / Loading…

系统体检 Diagnostics

快速检查本地配置、数据目录、向量化、GitHub 备份和访问控制，不会主动请求外部 API。

尚未运行

修复钉选计数 Fix Pinned Count

若「永久桶计数」明显大于面板里实际的钉选数（取消钉选后计数不减、钉新桶老报上限），点这里清理残留的孤儿固化桶：把它们降级回动态桶，释放配额、解开权重卡死。安全幂等，可重复点。

宿主机记忆桶目录 (Docker) Host Buckets Dir

docker-compose 将 ${OMBRE_HOST_VAULT_DIR:-./buckets} 挂到容器的 /app/buckets。留空 = compose 文件旁的 ./buckets。容器运行后不能修改宿主机挂载；请编辑 compose 文件旁的 .env，再执行 docker compose up -d --force-recreate。

路径

引擎 Engine

脱水 / 打标 LLM Compression LLM

服务商预设

先选服务商，会自动填好 Base URL 和正确的模型名。

格式

Model

Base URL

API Key

留空不改。Key 保存后立即生效并写入 .env（重启持久）。

Max Tokens

Temperature

向量化 Embedding

服务商预设

先选服务商，会自动填好 Base URL 和正确的模型名（省得填错 model 名报 400）。

怎么选（按服务器所在地区）
· 美国 / 海外服务器：建议用 Gemini 云端，就近低延迟。
· 中国大陆服务器：建议用硅基流动 SiliconFlow，国内域名直连快。
· 最优、最稳：本地 Ollama bge-m3，离线不出网、无跨境延迟、不耗 key 额度。
· 跨区域用（如美国机连国内 API）务必给服务器挂梯子 / 代理，否则易超时或报 400。

当前后端：— · 模型：— · 维度：—

已索引向量：— 条 · 启用状态：—

API Key

格式

Base URL

Key 保存后立即生效并写入 .env（重启持久）。Base URL 留空使用 Gemini 默认。

启用

后端

Model

切换后端不会自动重算已有向量。若要让旧向量与新后端对齐，请显式触发迁移。

只给「文件在、向量缺」的桶补一发（不动已有向量、不重算全库，省额度）。老的 permanent / 钉选桶若搜不到，多半是缺向量，点这个补齐。

本地向量模型 / Ollama · bge-m3（离线、无需 key、不出网）

需约 2–3GB 空闲内存（模型常驻）+ 1.2GB 磁盘；纯 CPU 即可，首条查询约 1–9s（冷启动），之后 <0.5s。低配机器（<2GB 空闲内存）建议继续用云端向量化。

读取中…

运行时镜像

自动完成：安装运行时 → 启动 → 下载 bge-m3 模型 → 切到本地。想分步操作见下方「分步操作 / 高级」。

分步操作 / 高级（逐步：装运行时 → 启动 → 下模型 → 切换）

模型镜像

注：本「保存」按钮同时提交「引擎」与「桶行为」中除采样外的所有字段（同一个 /api/config 接口），并立即写入 config.yaml。

桶行为 Bucket Behavior

呼吸采样 / Breath Sampling

关：breath 永远返回得分最高的那条。
开：按 score^(1/温度) 加权采样，中等分数的桶也有机会浮现（温度越高越随机；候选不足时自动回退）。

启用加权采样

top_k（候选池）

sample_k（每次抽几条）

温度 0.7

默认参数 Defaults（与「引擎」共用「保存」按钮）

合并阈值

0-100，越高越难合并相似桶

breath 默认桶数

1-50。AI 调用 breath() 不指定 max_results 时使用此默认值

breath 默认 token

500-20000。breath 单次返回总 token 上限

feel 历史 token

500-20000。dream / breath(domain=feel) 中新 feel 的全文预算

环境变量 Environment Variables

这里改完保存会立即生效并写入 config.yaml / .env（重启后仍有效）。
API Key 字段显示脱敏值；输入新值才会覆盖，留空 = 不动。

身份显示

AI 名称

用于 OAuth 授权页、信件署名等面向用户的 AI 显示名。

压缩 LLM（脱水 / 打标 / 合并）

API Key

Base URL

Model

格式

Timeout

向量化 Embedding（仅 api 后端用）

API Key

Base URL

Model

Timeout

Webhook

Hook URL

跳过推送

其它只读环境变量（点击展开）

以下是当前进程读到的所有 OMBRE_*。敏感字段只显示是否已配置。修改需重启服务。

系统信息（点击展开）

加载中… / Loading…

MCP 配置 MCP Setup

生成 Claude Desktop / claude.ai 的 MCP 连接配置。18 个工具全在一个端点 /mcp 上，只需连这一条。

不确定 OAuth、端口和持久目录怎么选？打开安全部署向导，只需选择“本机 / 公网安全 / 高级”之一。

连接模式

本地模式公网模式

本地模式使用当前页面域名（）；公网模式可填入自定义域名（Cloudflare Tunnel 等）。

端点地址

            /mcp

18 个工具已合并到单一连接器 /mcp，只需连这一条。

传输模式 · MCP Transport

切换会写入 config.yaml + .env 并自动重启服务（约 10-30 秒）后生效。 Streamable HTTP：Claude.ai 网页版 / Claude Code 远程（推荐默认）。 Legacy SSE：旧版 SSE 客户端兼容。 stdio：⚠️ 仅本地 stdin/stdout MCP，切换后 Dashboard 与所有 HTTP 服务会消失，且无法再从网页切回（需在服务器改 config.yaml / 环境变量恢复）。

MCP 鉴权

连接鉴权

三选一，不会叠加：选 OAuth 就不认 Token，选 Token 就不认 OAuth。改动写入 config.yaml，需重启服务后生效。关闭鉴权后任何能访问 /mcp 的人都能读写记忆；静态 Token 泄露也等同公开访问——无论选哪种模式都请勿把服务直接暴露公网（放内网，或在反代层另加一道鉴权）。

服务端口

对外端口

查看完整 JSON 预览

开发者模式 Developer Mode

⚠ 危险区域：开启后会在「记忆桶」列表的批量操作栏里露出「永久删除测试桶」按钮——只对创建时明确标记 test_data=True 的桶生效，真实记忆不受影响，但删除后不可撤销。不确定就保持关闭。

开启开发者模式 Developer Mode

GitHub 同步 GitHub Sync

把你的记忆备份到自己的 GitHub 仓库，等于一份云端存档——换电脑、服务器挂了都能从这里拉回来。
同步＝把本地记忆上传到 GitHub；导入＝把 GitHub 上的记忆拉回本地。两个方向别搞反。
（只备份记忆本身；用于加速搜索的「向量索引」不上传，导入后会自动重建，不影响记忆内容。）

GitHub Token

Token 会写入 config.yaml 落盘保存。推荐创建 Fine-grained token，只给目标仓库 Contents 读写权限。

仓库

分支

路径前缀

自动同步

⚠️ 导入 = 把 GitHub 上的记忆拉回本地，会覆盖同名记忆（本地独有的保留）。导入前会自动存一份本地 zip 备份；导入后自动重建向量索引。一般用于换机/数据丢失后的恢复或回滚。

数据备份与迁移 Backup & Migration

这里的操作都安全、可逆——定期导出备份是保护记忆最简单的方式，建议养成习惯。

导出备份 / 检查重复 Export / Dedup

导出打包当前所有 bucket markdown + embeddings.db（不包含 config / 密钥），可用于本地备份或跨设备迁移。
重复桶：每次 hold/grow 后系统会标记相似度 > 0.95 的对，下面可逐对处理。

从 zip 包导入 Import from Zip（完整记忆迁移）

上传从另一个 Ombre Brain 实例导出的 .zip 文件。系统会增量合并，遇到 ID 冲突时由你决定如何处理。
若导入包的 embedding 模型与当前不一致，向量数据将被丢弃并在导入后自动重新向量化。

点击或拖入 ombre_export_*.zip

Ombre Brain

旧 OB 待整理

只看真正会变化的卡

剩余旧记忆的暂定归组

看看一句话会唤起哪些记忆

真实对话 · 影子决定

召回对比实验室

历史对话导入 Import Conversations

已导入记忆 Imported

高频模式检测 Frequent Patterns

使用须知与常见问题 FAQ & Usage Guide

服务日志 Service Logs

错误日志 Error Codes

2.4.0 Debug

Replay

计划 Plans — what I promised, what I'm carrying

写一封 Write a Letter

信件时间线 Letter Timeline

暗房 Darkroom

显影室 Developing Room

已显影底片 Developed Roll

Anchor — 坐标系

版本 & 更新 Version & Update

我 Me

服务 Service

引擎 Engine

桶行为 Bucket Behavior

环境变量 Environment Variables

MCP 配置 MCP Setup

开发者模式 Developer Mode

GitHub 同步 GitHub Sync

数据备份与迁移 Backup & Migration

欢迎来到 Ombre Brain

◐ Ombre Brain