FAQ

常见问题

安装与启动

macOS 提示"无法打开"或"移动到废纸篓"

这是系统 Gatekeeper 对未签名应用的拦截，不代表应用损坏。

解决方法：

1. 在 Finder 中按住 Control 点击应用图标 → 选择"打开" → 确认打开
2. 或终端执行：xattr -dr com.apple.quarantine "/Applications/GitHub-Stars-AI-Tools.app"

详见 快速开始#macOS 首次打开提示。

应用启动后白屏

可能是显卡兼容性问题。尝试：

1. 关闭应用
2. 终端执行：defaults write com.xingranya.GitHub-Stars-AI-Tools WebkitPreferences.forceHardwareAcceleration -bool false
3. 重新打开应用

Windows SmartScreen 警告

点击"更多信息" → "仍要运行"即可。正式签名后此警告会消失。

---

GitHub Token

Token 需要哪些权限？

• repo — 访问仓库信息（Stars 同步、README 抓取）
• read:user — 读取用户信息

Token 保存在哪里？

• macOS：Keychain（系统钥匙串）
• Windows：Credential Manager（凭据管理器）

Token 不会写入配置文件、localStorage 或上传到任何服务器。

Token 过期了怎么办？

前往 GitHub Settings → Developer settings → Personal access tokens 生成新 Token，然后在应用设置页更新。

---

Stars 同步

同步很慢怎么办？

• GitHub API 对未认证请求限制为 60 次/小时，认证后为 5000 次/小时
• 首次同步需要遍历所有 Stars，数量多时可能需要几分钟
• 后续增量同步只拉取变更部分，速度会快很多

同步后看不到仓库？

• 检查 Token 是否有效
• 检查网络连接
• 尝试重新同步

---

AI 功能

AI 搜索结果不准确？

• 尝试使用更强大的模型（如 GPT-4o 替代 GPT-4o-mini）
• 确保仓库的 README 已经被抓取并生成了 AI 摘要
• 尝试更具体地描述你的需求

Ollama 连接失败？

1. 确认 Ollama 已启动：ollama serve
2. 确认模型已拉取：ollama list
3. 确认 Base URL 正确：http://localhost:11434/v1
4. 确认防火墙没有阻止本地连接

AI 摘要生成失败？

• 检查 API Key 是否有效
• 检查账户余额是否充足
• 检查模型是否可用
• 查看应用内的错误提示

本地模型推荐

模型	显存需求	推荐场景
qwen2.5:7b	~5 GB	日常摘要和搜索，中英文均衡
llama3.1:8b	~5 GB	英文优先场景
deepseek-r1:7b	~5 GB	需要推理能力的搜索

---

数据管理

数据库文件在哪里？

• macOS：~/Library/Application Support/com.xingranya.GitHub-Stars-AI-Tools/
• Windows：%APPDATA%\com.xingranya.GitHub-Stars-AI-Tools\
• Linux：~/.local/share/com.xingranya.GitHub-Stars-AI-Tools/

如何重置数据？

删除上述目录下的数据库文件，重新启动应用会自动重建。

Gist 同步会覆盖本地数据吗？

不会。导入时采用合并策略，仅合并到本地已存在的仓库记录，不会覆盖现有数据。

---

更多问题

如果这里没有你的问题，请在 GitHub Issues 提交反馈。