FAQ.md

FinPilot FAQ

常见问题解答。部署 / 使用 / 排障。

部署与运行

1. 运行 FinPilot 需要什么？

• Python 3.10–3.13，前端 Node 18+。
• 一个 OpenAI 兼容的 LLM Provider（DeepSeek / 通义 / 智谱 / 本地 Ollama 等）。
• 无需 Redis：Redis 不可达时自动降级到内置 SQLite 会话存储（生产建议启用 Redis 提升多实例会话共享）。

2. 如何快速启动？

git clone <仓库> && cd FinPilot
python3 -m venv venv && source venv/bin/activate
pip install -e .
cp .env.example .env            # 配置 LLM API Key / 管理员密码
uvicorn finpilot_equity.web_app.main:app --host 0.0.0.0 --port 8001
# 前端
cd frontend && npm install && npm run dev

打开 http://localhost:5174，用 .env 里 FINPILOT_ADMIN_EMAIL / FINPILOT_ADMIN_PASSWORD 登录。

3. 如何配置 LLM？

进入 Admin → LLM 供应商，添加 OpenAI 兼容端点（base_url + api_key + 模型），设为默认。任何 OpenAI 兼容服务均可（DeepSeek / Aliyun Bailian / 智谱 / Ollama）。

使用

4. 对话里能做什么？

斜杠命令 / 打开命令面板。常用：

• /dashboard 个人看板、/queries history 查询历史
• /reports generate <代码> 生成研报
• /chart line 标题 标签,.. 数值,.. 生成图表
• /prompts list、/skills create <名>、/agents create <名> <模式>（管理员）
• /models list、/models test 管理 LLM

5. 对话可以画图 / 导出文档吗？

• 画图：/chart 命令直接生成折线/柱状/饼图/散点/面积图。
• 导出：报告可导出 PDF / Word(docx) / Excel / PPT / Markdown / JSON；对话可一键导出为 Markdown 文件。

6. 能解析哪些文档格式？

PDF、Word(docx)、Excel(xlsx/xls/csv)，上传后在对话里提问即可（RAG 文档问答）。

安全

7. 数据安全如何保障？

• 默认 SQLite 本地存储；生产可切 PostgreSQL。
• 支持 RBAC 角色权限、TOTP 两步验证、PII 脱敏、SQL 注入防护、提示注入防护、登录审计、统一错误码。
• 代码沙箱：模块白名单 + 禁文件IO/网络，安全执行 Python（数据处理/计算）。

排障

8. 对话返回"模型不可用"？

到 Admin → LLM 供应商 → 点"测试连通"。确认 base_url/api_key/模型正确、网络可达、额度充足。

9. 管理页面 500？

通常与 Redis 有关。确认 .env 的 REDIS_URL 可达，或不配置 Redis（自动降级 SQLite）。重启后端后重试。

10. 忘记管理员密码？

.env 未设置 FINPILOT_ADMIN_PASSWORD 时不会创建默认管理员。删除数据库重建，或手动在数据库 users 表插入管理员（需 bcrypt 哈希密码）。

商业化 / 部署

11. 能否生产部署？

可以。提供 docker-compose.yml（Redis + PostgreSQL + 后端 + 前端）一键部署；文档见 docs/DEPLOYMENT.md。可私有化部署。

12. 是否支持多语言？

界面支持中文 / English 切换（右上角语言切换器）。文档提供中 / 英 / 日三语 README。

---

更多细节见 docs/DEPLOYMENT.md、docs/ARCHITECTURE.md、docs/API.md。遇到问题可提交 Issue。