Hindsight：AI 长期记忆

Hindsight 是面向 AI Agent 的 PostgreSQL-native 长期记忆服务。

Pigsty 提供 app/hindsight 配置模板（conf/app/hindsight.yml），默认使用 Pigsty 托管的 PostgreSQL，而不是 Hindsight 内置的开发数据库。

快速开始

curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty
./bootstrap
./configure -c app/hindsight
vi pigsty.yml                 # 修改域名、数据库密码与 LLM 设置
./deploy.yml
./docker.yml
./app.yml

默认访问地址：

• UI：http://hs.pigsty 或 http://<IP>:9999
• API：http://hs-api.pigsty 或 http://<IP>:8888

关键配置

conf/app/hindsight.yml 会在 apps.hindsight.conf 中覆盖 /opt/hindsight/.env。重点参数：

• HINDSIGHT_API_PUBLISH_PORT：API 对外端口，默认 8888
• HINDSIGHT_UI_PUBLISH_PORT：UI 对外端口，默认 9999
• HINDSIGHT_DB_HOST / HINDSIGHT_DB_PORT / HINDSIGHT_DB_NAME / HINDSIGHT_DB_USER / HINDSIGHT_DB_PASSWORD
• HINDSIGHT_API_VECTOR_EXTENSION：默认 pgvector
• HINDSIGHT_API_TEXT_SEARCH_EXTENSION：默认 native
• HINDSIGHT_API_LLM_PROVIDER：默认 none
• HINDSIGHT_MODEL_CACHE：宿主机模型缓存目录，默认 /data/hindsight

默认 none LLM Provider 可以保留文本并使用本地 embedding/reranker 模型召回；事实抽取、反思与整合能力需要配置 Ollama 或 OpenAI 兼容 API。

模板将宿主机模型缓存目录挂载到 /home/hindsight/.cache，没有 hindsight-cache 命名卷。空目录可能遮住镜像预置模型，因此首次启动应检查模型是否可用，并按需允许下载。

数据库需启用 vector 和位于 public 的 pg_trgm；模板只显式声明 vector，部署前请补齐并检查 pg_trgm 的位置，CREATE EXTENSION IF NOT EXISTS 不会移动已有扩展。

开发模板改用了保留镜像预置模型的命名卷，设置 HF_HUB_OFFLINE=1，并增加 API/UI 联合健康检查与 make health，使用这些功能需要更新配套文件。修改容器内 API 端口后，应同步检查控制面连接地址。

运维命令

cd /opt/hindsight
make up
make log
make info
make down
make pull

可分别请求 API 的 /health/ready 和 UI 代理的 /api/banks?limit=1，确认应用就绪且控制面能够访问 API。

参考

• Hindsight 项目： https://github.com/vectorize-io/hindsight
• Pigsty 模板： https://github.com/pgsty/pigsty/blob/main/conf/app/hindsight.yml