常见问题

本文档收集了ThinkDoc使用过程中的常见问题，帮助您快速解决遇到的问题。

基础功能

Q1：ThinkDoc支持哪些文件格式？
ThinkDoc支持多种常见文档格式：

• 文档类：PDF、Word (.docx)、PowerPoint (.pptx)、Excel (.xlsx)
• 文本类：Markdown (.md)、纯文本 (.txt)、HTML (.html)
• 图片类：PNG、JPG、JPEG、TIFF、BMP
• 数据类：CSV、Excel表格

Q2：文件解析需要多长时间？
解析时间取决于文件页数和复杂度。复杂的PDF文件解析时间较长，通常每1页需要10-20秒。其他文件解析时间较短。

Q3：解析失败怎么办？

• 检查文件格式：确保文件格式在支持列表中
• 检查文件大小：单文件不超过100MB
• 检查文件完整性：确保文件未损坏
• 尝试重新上传：有时网络问题会导致上传失败
• 联系技术支持：如问题持续存在

Q4：如何提高检索准确性？

• 优化知识库内容：上传高质量、结构化的文档
• 调整检索参数：根据需求调整top_k和score_threshold
• 使用深度解析：选择”deep”解析模式获得更好的结构信息
• 定期更新知识库：保持内容的时效性

知识库管理

Q5：如何创建和管理知识库？

1. 创建知识库：点击”创建知识库”，填写名称和描述
2. 上传文件：支持单个或批量上传文件
3. 解析文件：选择解析模式（deep或fast）
4. 管理文件：查看、下载、删除文件
5. 监控状态：实时查看解析进度和状态

Q6：知识库有容量限制吗？

• 体验版：单个知识库最多100个文件
• 企业版：无限制，取决于服务器配置

Q7：如何删除知识库？

• 进入知识库详情页面
• 点击”删除知识库”按钮
• 确认删除操作
• 注意：删除后无法恢复，请谨慎操作

智能问答

Q8：问答功能如何使用？

1. 选择知识库：在问答界面选择要查询的知识库
2. 输入问题：用自然语言描述您的问题
3. 获取答案：系统会基于知识库内容生成答案
4. 查看来源：点击引用链接查看原始文档

Q9：如何提高问答质量？

• 明确问题：使用具体、清晰的语言描述问题
• 选择合适知识库：确保问题相关的文档已上传
• 查看引用来源：验证答案的准确性
• 提供反馈：帮助系统不断改进

Q10：支持哪些AI模型？
支持Xinference或Ollama本地化部署，推荐使用Qwen3系列模型。

Q12：知识检索功能如何使用？

• 语义检索：基于语义相似度进行智能检索
• 关键词检索：支持精确关键词匹配
• 混合检索：结合语义和关键词的混合检索模式
• 检索设置：可调整top_k和score_threshold参数

API与集成

Q13：API调用返回 401 Unauthorized 错误

• 检查Header格式：Authorization: Bearer td-xxxxxx
• 验证API Key是否有效 → 重新生成密钥
• 确认密钥格式是否正确

性能与优化

Q14：如何提升系统性能？

• 硬件配置：增加服务器内存和GPU资源
• 网络优化：使用CDN加速文件传输
• 缓存策略：合理使用缓存减少重复计算
• 并发控制：调整并发处理数量

Q15：支持大规模部署吗？

• 水平扩展：支持多节点集群部署
• 负载均衡：自动分发请求到不同节点
• 高可用：支持故障自动切换
• 监控告警：实时监控系统状态

技术支持

Q16：如何获取技术支持？

• 在线文档：查看详细的使用文档
• 社区论坛：在开发者社区提问
• 技术支持：企业版提供7×24小时技术支持
• 培训服务：提供专业的技术培训

Q17：如何报告Bug？

• 问题描述：详细描述问题现象和复现步骤
• 环境信息：提供系统版本、浏览器版本等信息
• 错误日志：附上相关的错误日志
• 联系方式：留下您的联系方式以便跟进

Q18：功能更新频率如何？

• 常规更新：每月发布功能更新
• 安全补丁：及时发布安全相关补丁
• 重大版本：每季度发布重大版本更新
• 用户反馈：根据用户反馈优先开发新功能

最佳实践

Q19：如何构建高质量知识库？

• 内容质量：上传高质量、结构化的文档
• 分类管理：按主题或部门分类管理知识库
• 定期更新：保持内容的时效性和准确性
• 用户培训：培训用户正确使用系统

💡 更多帮助
如果您的问题未在此文档中找到答案，请通过以下方式联系我们：

• 📧 邮箱：support@bluedigit.ai
• 💬 在线客服：工作日 9:00-18:00