## 功能特性 - 活动时间线：把评论、commit、状态变化聚合成统一动态流，支持按时间范围、事件类型、仓库、PR/Issue 类型、关键词、关闭状态和机器人活动过滤。 - Pull Request 管理：跨仓库浏览、搜索、分组和收藏 PR，可在详情页评论、审批、合并、标记 ready、关闭或重新打开。 - Issue 跟踪：沿用 PR 列表的筛选、搜索和详情交互，支持评论、关闭、重新打开和收藏。 - Diff 阅读：内联展示文件差异，带目录树、文件状态、增删统计、语法高亮、空白显示切换、tab 宽度调整和 `j` / `k` 文件导航。 - 看板流转：用 New、Waiting、Awaiting Merge 本地看板管理 PR 状态，不改动 GitHub Labels 或 Projects。 - CI 检查概览：在 PR 详情页查看通过、失败、等待中的 check run 状态，并直接跳转到失败任务。 - 同步引擎：启动后立即同步，默认每 5 分钟刷新一次；打开 PR/Issue 详情会触发单项刷新，当前详情页也会轮询新评论。 - 多代码托管平台：支持 GitHub、GitHub Enterprise、GitLab、Forgejo 与 Gitea，可按仓库配置 `platform`、`platform_host` 和令牌来源。 ### 使用流程 1. 安装应用时填写至少一个代码托管平台令牌。默认必填 `GitHub Token`；如果要同步 `gitlab.com`、`codeberg.org` 或 `gitea.com`，同时填写对应 Token。 2. 首次进入后打开 Settings 页面，添加要维护的仓库，例如 `cita-777/metapi`、`router-for-me/CLIProxyAPI`，或通过仓库导入入口选择 GitLab、Forgejo、Gitea。 3. 等待底部状态栏显示同步进度完成，回到 PR、Issues 或 Activity 页面确认数据已出现。 4. 如果需要写操作，例如评论、审批、合并、关闭 PR/Issue，请确认令牌具有对应仓库写权限；只读令牌只能完成同步和浏览。 ### 各平台 Token 获取方式 1. GitHub：优先使用 fine-grained personal access token。进入 `Settings -> Developer settings -> Personal access tokens -> Fine-grained tokens -> Generate new token`，选择自己的账号或组织作为 `Resource owner`，把 `Repository access` 收敛到需要维护的仓库。只做同步和浏览时，优先给只读仓库权限；只有要评论、审批、关闭、标记 ready 或合并时，再补对应写权限。官方文档：<https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens> 2. GitLab：进入 `Avatar -> Edit profile -> Access -> Personal access tokens`，从 `Generate token` 中创建 `Legacy token`。只做读取时，通常使用最小读权限；若要评论、审批、合并或改动 issue / merge request 状态，再补更高权限。GitLab 新建的个人令牌默认要求过期时间，离开页面后不会再次显示原始 token。官方文档：<https://docs.gitlab.com/user/profile/personal_access_tokens/> 3. Forgejo / Codeberg：`codeberg.org` 使用 Forgejo。进入 `Settings -> Applications -> Manage Access Tokens -> Generate New Token` 创建 token；如果实例支持仓库范围限制，优先选 `Specific repositories` 或最小可见范围，并只开启本次需要的读或写 scope。官方文档：Codeberg <https://docs.codeberg.org/advanced/access-token/>，Forgejo scope 说明 <https://forgejo.org/docs/next/user/token-scope/> 4. Gitea：进入 `User Settings -> Applications -> Manage Access Tokens`，创建 token 后在 `Select permissions` 中只保留需要的权限。只做同步时使用最小读权限，需要评论、关闭、合并等操作时再开启写权限。token 只会在创建当下显示一次。官方文档：<https://docs.gitea.com/development/api-usage> 注意：访问 GitHub、GitLab、Codeberg 或 Gitea API时，需要结合小猪佩奇使用。