已集成懒猫OIDC登录。 ## 功能特性 - GitHub 项目搜索：输入关键词即可检索公开仓库，快速挑选要学习的项目。 - 核心代码导读：自动抓取项目核心文件，并生成中文解释、结构化理解路径和前置知识。 - 代码问答与判题：支持围绕当前文件进行多轮追问，也支持代码题自动判题与反馈。 - AI 课堂与文章模式：可将项目内容整理成教学幻灯片、技术文章与图解式学习材料。 - 浏览器实验室：内置注意力、扩散、CNN、决策边界等 TensorFlow.js 互动实验，帮助把抽象概念和真实源码对应起来。 - 学习数据沉淀：学习历史、收藏、错题本和排行榜都保存在服务端 `data/` 目录，重启后仍可保留。 ### 必要配置 1. AI API 是必填项；如果不配置，GitStudy 仍可打开页面，但 AI 解读、问答、判题、幻灯片等核心能力无法工作。 2. `GITHUB_TOKEN` 是可选项；如果高频搜索或读取大仓库时遇到 GitHub rate limit，可在“AI 设置”里补充 token。 3. `GITHUB_GIST_TOKEN` 也是可选项；只有当你要使用“在 Colab 中打开”功能时才需要，它会用于创建或更新一个私有 Gist。 ### GitHub Token 获取方式 推荐优先使用 GitHub 官方的 Fine-grained personal access token，权限更容易收紧。 1. 登录 GitHub，点击右上角头像，进入 `Settings`。 2. 在左侧进入 `Developer settings`。 3. 打开 `Personal access tokens` -> `Fine-grained tokens`。 4. 点击 `Generate new token`，名称可填写为 `GitStudy GitHub API`。 5. `Resource owner` 选择你自己的 GitHub 账号。 6. `Repository access` 按需选择： - 如果你主要学习公开仓库，按 GitHub 官方说明，fine-grained token 默认就包含对所有公开仓库的只读访问。 - 如果你还想让 GitStudy 读取你自己的私有仓库，再把对应仓库加入 `Selected repositories`。 7. 如果要读取你自己的私有仓库内容，建议额外授予 `Repository permissions` -> `Contents: Read-only`。 8. 生成后复制 token，填写到 GitStudy 的“AI 设置”里的 `GitHub Token` 字段；如果你习惯用环境变量，也可以写到 `GITHUB_TOKEN`。 9. 注意：Fine-grained token 通常以 `github_pat_` 开头；输入框里的 `ghp_...` 只是占位示例，不影响保存和使用。 这个 token 的作用主要是提升 GitHub API 限额，减少搜索项目、读取 README 和代码文件时遇到 `API rate limit exceeded` 的概率。 ### GitHub Gist Token 获取方式 “在 Colab 中打开”功能会调用 GitHub Gist API，为当前项目创建或更新一个私有 `.ipynb` 文件；因此需要一个带 Gist 写权限的 token。 1. 登录 GitHub，点击右上角头像，进入 `Settings`。 2. 在左侧进入 `Developer settings`。 3. 打开 `Personal access tokens` -> `Fine-grained tokens`。 4. 点击 `Generate new token`，名称可填写为 `GitStudy Colab Gist`。 5. `Resource owner` 选择你自己的 GitHub 账号。 6. 在 `Permissions` 里找到 `Account permissions`，把 `Gists` 设置为 `Write`。 7. 生成后复制 token，填写到 GitStudy 的“AI 设置”里的 `GitHub Gist Token` 字段；如果你想用环境变量，也可以写到 `GITHUB_GIST_TOKEN`。 8. 注意：Fine-grained token 通常以 `github_pat_` 开头；只要权限正确，GitStudy 可以正常使用。