常见问题
部署相关
如何修改默认端口？
修改 .env.release 中的端口配置。
如何配置 HTTPS？
建议使用反向代理（Nginx/Ingress）处理 TLS 终止。
数据库如何备份？
使用 PostgreSQL 标准备份工具（pg_dump）。
使用相关
如何重置管理员密码？
如果忘记管理员密码，可通过环境变量重 新设置首登管理员，或直接操作数据库。
技能包上传失败怎么办？
检查：
- 文件大小是否超限
- 文件类型是否在白名单内
- 是否包含必需的 SKILL.md
- SKILL.md frontmatter 格式是否正确
开发相关
如何扩展 OAuth Provider？
参考现有 GitHub 实现，添加新的 OAuth Provider 配置。
如何自定义搜索实现？
实现 SearchIndexService 和 SearchQueryService 接口。
下一步
- 故障排查 - 问题诊断