infra-docker-configs/servers/hindsight/hindsight

Hindsight 独立 VM

本项目部署到 PVE VM hindsight（192.168.50.47）的 Arcane Environment。 它是已迁移生产数据的独立实例，不直接挂载 unRaid 上的旧数据库。

组件

• Hindsight 0.10.3-slim；
• PostgreSQL 18 + pgvector；
• unRaid GPU0 上的本地 TEI BAAI/bge-m3 embedding；OpenRouter 同模型保留为手动回滚；
• 本地 TEI 用于生产 rerank，保留原有 OpenRouter cohere/rerank-4-fast 与 RRF 回退；Google 仅用于合成测试；
• Codex OAuth GPT-6 Luna 用于 Retain；
• xAI OAuth Grok 4.7 用于 Consolidation；
• Codex OAuth GPT-6 Sol 用于 Reflect 与知识页刷新；原有 ZenMux 回退保持不变。

本次升级验证

升级前已生成 /srv/hindsight/backups/pre-google-0.10.3-20261010.dump，并通过 pg_restore --list 校验。应用和数据库均健康，数据库容器没有重建。 embedding 仍为本地 bge-m3，未重新生成向量。

六组合成排序样本在 Google default、fast 与本地 TEI 上均通过，不代表已证明 Google 质量优于 TEI。Google 单次请求约 1 秒，本地 TEI 为毫秒级。 用户选择暂不向 Google 发送私人记忆，因此生产排序已恢复本地 TEI， Google 不在生产排序链中。embedding 迁移另行安排。

运行数据固定在 /srv/hindsight/postgres。Compose 和非敏感模板进入 Git，真实 数据库密码、ZenMux key 和 OpenRouter key 仅保存在该 Arcane Environment 的 .env 中。

发布顺序

1. 用 .env.example 在 Arcane 中建立 Environment 专属 .env；
2. 对三种 LLM、embedding 和 reranker 运行合成内容探针；
3. 启动空白实例，验证 /health、UI、Retain、Recall、Consolidation 和 Reflect；
4. 保持 unRaid 旧实例在线，另行制定 bank export/import 迁移与回滚窗口；
5. 迁移完成前不修改现有 Agent 的 Hindsight URL。

升级策略

不长期冻结在历史生产版本，也不直接使用浮动的 latest。跟踪 Hindsight release， 先在空白或影子实例验证数据库迁移、provider 配置和核心工作流，再更新固定版本与 镜像 digest，由 Arcane 滚动部署。