常见问题

这里收集了用户在使用识文君过程中遇到的常见问题和解决方案。

🚀 安装和启动

Q: 软件启动时提示缺少依赖怎么办？

A: 这通常是 libvips 依赖缺失导致的：

macOS用户:

brew install vips

Windows用户: 从 GitHub 下载libvips预编译包并配置

Linux用户:

# Ubuntu/Debian
sudo apt-get install libvips-dev

# CentOS/RHEL  
sudo yum install vips-devel

# Fedora
sudo dnf install vips-devel

安装完成后重新启动应用。

Q: macOS提示"软件已损坏"怎么办？

A: 这是macOS的安全机制，解决方法：

sudo xattr -rd com.apple.quarantine /Applications/识文君.app

或者：

1. 右键点击应用选择"打开"
2. 在系统偏好设置 → 安全性与隐私 → 点击"仍要打开"

Q: Windows Defender提示病毒怎么办？

A: 这是误报，解决方法：

1. 点击"更多信息"
2. 选择"仍要运行"
3. 或将应用添加到Windows Defender白名单

🤖 AI配置

Q: API调用失败怎么办？

A: 请按以下步骤排查：

1. 检查API密钥

   • 确认密钥是否正确复制
   • 验证密钥是否在有效期内
   • 检查账户余额是否充足

2. 检查网络连接

   • 确认网络连接正常
   • 检查防火墙设置
   • 尝试使用VPN或代理

3. 检查服务状态

   • 访问AI服务官网确认服务状态
   • 尝试切换到其他AI服务

Q: 哪个AI服务最好用？

A: 根据不同需求推荐：

Q: 如何降低AI服务成本？

A: 成本优化建议：

1. 选择合适模型: 日常使用选择GPT-3.5而非GPT-4
2. 使用免费服务: Pollinations适合测试和轻度使用
3. 批量处理: 减少API调用次数
4. 本地部署: 大量使用可考虑本地模型

📄 文档处理

Q: 识别准确率不高怎么办？

A: 提高识别准确率的方法：

1. 文档质量

   • 确保PDF清晰，分辨率足够
   • 避免扫描质量差的文档
   • 检查文档是否有密码保护

2. AI模型选择

   • 尝试不同的AI服务
   • 对于复杂文档使用GPT-4
   • 调整模型参数

3. 处理策略

   • 分页处理复杂文档
   • 使用AI文本处理功能优化结果
   • 手动编辑重要内容

Q: PDF页面无法正常显示怎么办？

A: 排查步骤：

1. 检查依赖: 确保libvips已正确安装
2. 文档检查: 验证PDF文件是否损坏
3. 重启应用: 尝试重新启动识文君
4. 格式支持: 确认PDF版本是否支持

Q: 支持哪些文档格式？

A: 当前支持情况：

• ✅ PDF文档: 完全支持，包括多页PDF
• 🚧 图片格式: 开发中，敬请期待
• ❌ Word文档: 暂不支持
• ❌ 扫描件: 需先转换为PDF

📤 导出功能

Q: 导出的文档格式不正确怎么办？

A: 检查以下方面：

1. 选择正确格式: 确认选择了合适的导出格式
2. 内容选择: 检查是否选择了正确的文本类型
3. 编码问题: 某些格式可能有编码限制
4. 软件兼容: 确认目标软件支持该格式

Q: 批量导出如何操作？

A: 批量导出步骤：

1. 点击"历史记录"按钮
2. 查看所有处理过的文档
3. 选择导出格式（TXT、Markdown、Word、HTML、RTF）
4. 点击"导出"按文档批量导出

Q: 导出的Word文档格式混乱怎么办？

A: Word导出优化：

1. 使用AI处理: 先用AI优化文本格式
2. 手动编辑: 导出前手动调整格式
3. 选择Markdown: 先导出Markdown再转换
4. 分段处理: 复杂文档分段导出

🔧 性能优化

Q: 如何提高处理速度？

A: 性能优化建议：

1. 文档优化

   • 使用较小的PDF文件
   • 避免超高分辨率文档
   • 分页处理大文档

2. AI服务选择

   • 选择响应速度快的服务
   • 避免同时处理多个页面
   • 使用本地缓存

3. 系统优化

   • 确保足够的内存
   • 关闭不必要的程序
   • 使用SSD存储

Q: 内存占用过高怎么办？

A: 内存优化方法：

1. 分批处理: 避免同时处理大量页面
2. 重启应用: 定期重启释放内存
3. 系统检查: 确认系统内存充足
4. 关闭其他程序: 释放系统资源

💾 数据和隐私

Q: 我的文档数据安全吗？

A: 数据安全保障：

1. 本地处理: 文档在本地处理，不上传服务器
2. API调用: 仅图像数据发送给AI服务进行识别
3. 无存储: AI服务商不会永久存储您的数据
4. 加密传输: 所有API调用都使用HTTPS加密

Q: 如何清理应用数据？

A: 数据清理方法：

1. 历史记录: 在历史记录页面删除不需要的记录
2. 缓存清理: 重启应用会自动清理临时缓存
3. 配置重置: 在设置中可以重置AI配置
4. 完全卸载: 卸载应用会清除所有本地数据

📞 获取更多帮助

如果以上解答没有解决您的问题：

• 📧 邮件支持: hzruo@outlook.com
• 🐛 问题报告: GitHub Issues
• 📖 详细文档: 查看其他文档页面
• 💬 社区讨论: 加入用户交流群