常见问题
部署
首次启动后访问不到页面
检查容器状态、端口映射和 app 日志：
bash
docker compose ps
docker compose logs -f app如果容器反复重启，优先检查数据库连接、Redis 连接和环境变量格式。
修改配置后没有生效
部分配置写入环境文件后需要重启应用容器：
bash
docker compose restart app重启后查看启动日志，确认配置没有被旧值覆盖。
登录和初始化
忘记管理员密码怎么办
当前文档不建议直接修改数据库恢复密码。更稳妥的方式是在测试环境验证恢复流程后，通过受控脚本或管理能力重置。生产环境应提前保存管理员凭据和恢复预案。
更换 APP_SECRET_KEY 后密钥不可用
APP_SECRET_KEY 用于解密已保存的业务密钥。更换后旧密钥无法解密，需要恢复原值或重新录入所有外部服务密钥。
AI
模型同步失败
检查：
- API key 是否正确。
- Base URL 是否是 OpenAI 兼容接口。
- 代理是否可用。
- 提供商是否支持模型列表接口。
- 当前账号是否有权限访问目标模型。
会议输出格式异常
先降低变量：用稳定模型、简单主题、默认角色和少量上下文重新运行。若仍失败，查看会议事件和 AI 客户端日志。
消息订阅
RSS/Atom 订阅失败
确认 feed 是公开 http 或 https URL，不包含内嵌账号密码。v1 不支持 feed 认证。
Telegram 私有频道无法读取
确认登录账号拥有频道访问权限。私有频道还依赖 Telegram 是否能为该账号解析 peer 和 access hash。
消息采集成功但没有过滤
检查 Redis、worker、AI 提供商、订阅团队绑定和过滤器配置。摄取消息会先入库，再异步进入过滤队列。
会议
会议一直排队
检查 worker 是否运行、Redis 是否可连接、会议分发模式是否为可用队列模式。
会议运行失败
检查 AI 认证、模型名、代理、上下文长度、工具调用日志和会议事件。修复后可以重启会议。
行情和模拟交易
行情为空
检查标的代码、行情提供方、网络出口、速率限制和缓存。先对单个标的做最小查询。
模拟订单被拒绝
常见原因包括账户未启用、未绑定风险配置、风险检查失败、标的不支持、行情缺失或订单状态不允许执行。