Getting Started

快速开始

系统要求

平台	最低版本
macOS	10.15+
Windows	10+
Linux	主流发行版

安装包用户无需安装 Node.js、pnpm 或 Rust。

第一步：安装应用

前往 GitHub Releases 页面，下载适合你系统的安装包：

平台	安装包格式
macOS (Apple Silicon)	.dmg 或 .app.tar.gz
macOS (Intel)	.dmg 或 .app.tar.gz
Windows	.msi 或 .exe
Linux	.deb、.AppImage 或 .rpm

macOS 首次打开提示

当前 macOS 安装包暂未使用 Apple Developer ID 签名，首次打开时可能提示"移动到废纸篓"或"无法打开"。

方法一：Finder 放行（推荐）

将应用安装到"应用程序"后，在 Finder 中按住 Control 点击 GitHub-Stars-AI-Tools.app，选择"打开"，再在系统确认弹窗中继续打开。

方法二：终端移除隔离属性

xattr -dr com.apple.quarantine "/Applications/GitHub-Stars-AI-Tools.app"

如果提示权限不足，使用 sudo 重新执行同一命令。

第二步：连接 GitHub

1. 打开应用，进入欢迎页或设置页。
2. 点击"连接 GitHub"。
3. 输入 GitHub Personal Access Token（需要 repo 和 read:user 权限）。

Token 会保存到系统凭据管理器（macOS Keychain / Windows Credential Manager），不会写入本地文件或上传到任何服务器。

第三步：同步 Stars

1. 在首页或仓库列表页，点击"同步 Stars"。
2. 等待同步完成，你的 GitHub Stars 会写入本机 SQLite 数据库。
3. 同步后可以看到仓库名称、描述、语言、Stars 数、Topics 等元数据。

第四步：抓取 README

1. 点击"抓取 README"，缓存仓库的 README 文件。
2. README 会保存在本地，后续离线也能查看。

第五步（可选）：配置 AI 服务

1. 前往 设置 → AI 配置。
2. 选择 AI 服务商预设（OpenAI、Anthropic、DeepSeek、Ollama 等），或手动填写自定义接口。
3. 配置完成后可以使用：
   • AI 中文摘要生成
   • 聊天式自然语言搜索
   • AI 标签网络
   • 相似项目推荐

详见 AI 配置指南。

下一步

• 功能详解 — 了解所有功能的详细用法
• AI 配置指南 — 配置 AI 服务
• 常见问题 — 遇到问题看看这里