Windows环境使用Docker安装hindsight踩坑记录

牧之 2026年07月23日编辑

Hindsight 是一种智能代理记忆系统，旨在打造能够随着时间不断学习的高效代理。大多数代理记忆系统专注于回忆对话历史，而 Hindsight 则着重于培养能够学习的代理，而不仅仅是记忆能力的提升。

安装 Docker 环境

方案一：
在 Windows 系统上安装 Docker Desktop 桌面版程序，然后在 Docker Desktop 的界面中设置使用 WSL2 进行集成。
这里我遇到过一个坑，出现了内存泄漏，导致内存高涨不下，此时未找到较好的解决方案，卸载 Docker Desktop 和 WSL2 之后，重启系统问题暂时解决了。

方案二：
在 Windows 系统上安装 WSL2 的 Ubuntu 环境，直接在 Ubuntu 系统中安装 Docker 环境。（※ 推荐）

安装 hindsight

创建 Compose 工作目录，在 WSL 宿主机执行：

mkdir -p ~/hindsight-compose
cd ~/hindsight-compose

vim .env
DEEPSEEK_API_KEY=sk-你的真实DeepSeek密钥

创建 compose.yaml

name: hindsight

services:
  hindsight:
    image: ghcr.io/vectorize-io/hindsight:latest
    container_name: hindsight

    restart: unless-stopped

    ports:
      - "8888:8888"
      - "9999:9999"

    environment:
      HINDSIGHT_API_LLM_PROVIDER: deepseek
      HINDSIGHT_API_LLM_API_KEY: ${DEEPSEEK_API_KEY}
      HINDSIGHT_API_LLM_MODEL: deepseek-v4-flash
      HINDSIGHT_API_LLM_BASE_URL: https://api.deepseek.com

      HF_ENDPOINT: https://hf-mirror.com

      HINDSIGHT_API_WORKER_ID: hindsight-wsl

    volumes:
      - hindsight-data:/home/hindsight/.pg0

volumes:
  hindsight-data:
    external: true
    name: hindsight-data

Compose 的 up -d 会在后台创建并启动服务；配置或镜像发生变化时，再次运行 up -d 可以重新创建对应容器，同时保留挂载的数据卷。