常见问题

Name: Riverse
Author: JK

PostgreSQL 连接失败

确认 PostgreSQL 正在运行：

pg_isready -h localhost

如果用户名不是默认的 postgres，需要修改 settings.yaml 中的 database.user。如果 PostgreSQL 需要密码，请添加 database.password。

ollama list
ollama pull <your-model>    # 例如 qwen2.5:14b, llama3, mistral
ollama pull bge-m3          # 嵌入模型（可选）

将 llm_provider 改为 "openai"，填入 API Key，将 embedding.enabled 设为 false。

在 settings.yaml 中使用 IANA 格式设置 timezone：

timezone: "Asia/Shanghai"    # 或 America/New_York, Asia/Tokyo 等

这会影响静默时段和主动消息的时间安排。

tts:
    enabled: true
    voices:
        zh: "zh-CN-XiaoxiaoNeural"
        en: "en-US-AriaNeural"
    max_chars: 500

需要安装 Edge TTS 库（pip install edge-tts）。

安装 pgvector 扩展并运行迁移脚本：

# 安装 pgvector (macOS)
brew install pgvector

# 运行迁移
psql -h localhost -U YOUR_USERNAME -d Riverse -f migrations/001_pgvector.sql

应用会自动检测 pgvector 并在可用时使用。

在 settings.yaml 中调整 session_memory：

session_memory:
    char_budget: 3000        # 增大以获取更长上下文
    keep_recent: 5           # 更多近期轮次 = 更多即时上下文
    recall_max: 3            # 从对话早期召回更多轮次

curl http://localhost:8400/health
# {"status": "ok", "db": true, "llm": true}

仅一个服务可达时返回 "degraded"，两个都不可达时返回 "error"。