系统设置
系统设置用于配置模型供应商、API Key、知识库连接、数据库相关偏好和基础运行选项。第一次使用时,系统设置是必须完成的入口。
优先配置什么
建议按这个顺序配置:
- 模型供应商。
- API Key。
- Base URL。
- 默认模型。
- 连接测试。
- 可选知识库设置。
- 可选任务和界面偏好。
先确认模型可用,再进入新手上路。
API Key 和供应商
填写 API Key 时注意:
- 不要多复制空格。
- 确认 Key 对应的供应商和 Base URL。
- 确认账户额度和模型权限。
- 如果供应商兼容 OpenAI 接口,按兼容接口填写。
连接失败时,先用供应商控制台或简单请求确认 Key 是否有效,再回到应用测试。
Base URL 和模型名称
Base URL 需要和供应商文档一致。常见问题包括:
- 多写或少写路径。
- 使用了网页地址而不是 API 地址。
- 模型名称和供应商实际名称不一致。
- 代理或网络限制导致请求无法到达。
模型名称建议从供应商文档复制,不要自行猜测。
Qdrant 设置
Qdrant 用于知识库向量检索。它不是开书和生成第一章的硬性前置条件,但会影响资料召回、拆书沉淀和长期一致性。
配置时确认:
- Qdrant 服务可访问。
- 地址和端口正确。
- 集合或命名策略符合应用配置。
- 索引任务能够完成。
知识库不命中时,不要只改提示词;先确认 Qdrant 连接和索引状态。
SQLite 和本地数据
桌面版会保存本地数据库和配置。请把它当作重要数据处理:
- 不要随意删除数据库文件。
- 重要小说定期导出或备份。
- 迁移、重置或清理前先确认备份。
- 排查问题时保留日志和数据副本。
任何可能删除数据的操作都应先备份。
设置后的验证
完成设置后,建议执行一个最短验证:
- 测试模型连接。
- 创建测试小说。
- 让自动导演生成方向候选。
- 生成第一章。
- 查看任务中心状态。
这条路径能同时验证模型、数据库、任务队列和主链入口。