已集成懒猫 oidc 登录。 ## 核心功能 Lists 分类管理 - 创建自定义 Lists，将仓库按项目、技术栈或用途分类，支持 24 种预设颜色 AI 智能分类 - 接入 OpenAI 兼容 API，一键自动分类所有未整理的仓库 双向同步 - 与 GitHub 实时同步，取消 Star 也会同步到你的账号 README 预览 - 无需跳转即可查看仓库的 README 文档 ## GitHub 相关配置在哪里配 GitHub OAuth 的 `Client ID` 和 `Client Secret` 不在 `lzc-manifest.yml` 里配置，也不需要在安装参数里配置。 它们在应用页面里配置： ```text Starflow -> 设置 -> GitHub 账户 -> GitHub OAuth 配置 ``` 这个配置是应用全局配置。管理员配置一次后，用户就可以在同一个「GitHub 账户」区域点击「绑定 GitHub」绑定自己的账号。 ## 创建 GitHub OAuth App 首次绑定 GitHub 前，需要先在 GitHub 创建 OAuth App。 ### 1. 先复制 Starflow 回调地址 在 Starflow 里打开： ```text 设置 -> GitHub 账户 -> Authorization callback URL ``` 复制输入框里的完整地址，格式通常类似： ```text https://starflow.<你的微服域名>/api/github/oauth/callback ``` 实际填写时请使用页面里显示的地址，不要手动猜。 ### 2. 到 GitHub 创建 OAuth App 在 GitHub 网页中依次点击： ```text 右上角头像 -> Settings -> Developer settings -> OAuth Apps -> New OAuth App ``` 填写： | GitHub 字段 | 填什么 | | --- | --- | | Application name | `Starflow` | | Homepage URL | Starflow 应用首页地址，例如 `https://starflow.<你的微服域名>` | | Authorization callback URL | 粘贴 Starflow 设置页显示的回调地址 | 创建完成后，GitHub 会显示 `Client ID`。 然后点击： ```text Generate a new client secret ``` 复制生成的 `Client Secret`。这个值只显示一次。 ### 3. 回到 Starflow 保存配置 回到 Starflow： ```text 设置 -> GitHub 账户 -> GitHub OAuth 配置 ``` 填写： | Starflow 字段 | 填什么 | | --- | --- | | Client ID | GitHub OAuth App 页面显示的 Client ID | | Client Secret | GitHub 生成的 Client Secret | 点击「保存配置」。 保存成功后，`Client Secret` 不会明文显示；输入框显示「已配置，留空则不修改」属于正常现象。 ### 4. 绑定 GitHub 账号 仍在 Starflow 的「设置」页面： ```text GitHub 账户 -> 绑定 GitHub ``` 浏览器会跳到 GitHub 授权页。确认授权后会自动回到 Starflow，页面上会显示已绑定的 GitHub 用户名。 ## 同步 GitHub Stars ## AI 分类 AI 分类需要你自己提供 OpenAI 兼容接口。 入口： ```text 设置 -> AI 分类 ``` 使用步骤： 1. 打开「启用 AI 分类」。 2. 填写 API Key、接口地址和模型名称。 3. 点击「测试连接」。 4. 测试成功后回到 Stars 页面。 5. 单个仓库点「AI 分类」，或在「未分类」页面使用「一键整理」。 AI 会根据仓库名称、描述、README 摘要和已有 Lists 给出分类建议。建议确认后再应用。