Tip
项目内置完整设计规范（Design System）、架构文档、Copilot 指令与开发技能（Skills），AI 编码助手可快速理解与上手迭代。
| 首页 | 代码页 | 个人主页 | 文件浏览 | 仓库设置 | 系统偏好 |
|---|---|---|---|---|---|
 |
 |
 |
 |
 |
 |
| 领域 | 能力 |
|---|---|
| 浏览 | 首页 Dashboard（动态 Feed + 今日/本周/本月热点）、搜索（仓库/用户/issue）、仓库详情（README 渲染 / 文件树 / 代码高亮 / 语言统计 / About）、用户与组织主页、Releases |
| 协作 | issue（列表 / 详情 / 创建）、PR（列表 / 详情 / 创建）、star / unstar / fork、文件在线编辑 / 新增 / 删除（直接 commit 到分支） |
| 管理 | 个人资料 / 凭据管理 / 邮箱 / 组织 / 仓库管理 / 外观（主题 + 中英双语）、仓库设置（基本信息 / 危险区改名 / 归档 / 迁移 / 删除）、组织设置、GPG / SSH keys 管理、通知已读 |
| 身份 | GitHub OAuth2 登录（只读 / 完全控制 两档权限 + 真实授予 scope 可视化）、会话恢复 |
| CLI | git 镜像端点自动代理：git clone / pull / push 经 Worker 转发，解决 github.com 直连不稳定 |
- 页面干净整洁：统一布局系统（Design System）、组件优先 shadcn/ui、信息密度适中——简约仅限前端呈现，不限功能范围
- 技术化简：Octokit SDK 统一封装 + GraphQL 唯一主通道（GraphQL 失败自动熔断降级 REST，页面不感知协议）
- 通过 Worker 对 GitHub 部分核心端点进行镜像代理，解决网络不稳定问题（git clone / pull / push、wiki、raw、release）
| 层 | 技术 |
|---|---|
| 前端 | React 19 · Vite · TypeScript · Tailwind CSS 4 · shadcn/ui · react-i18next · CodeMirror 6 代码高亮 |
| 数据源 | GitHub GraphQL + REST（Octokit SDK 统一封装，登录 GraphQL 唯一主通道、匿名 REST），请求直连官方 API |
| 后端 | Cloudflare Pages Worker（OAuth2 令牌管理 + KV 会话 + 关键端点代理 wiki/raw/release + CLI git 镜像代理） |
| 开发 | pnpm workspace · vitest · oxlint · oxfmt |
- 打开 https://github.com/settings/developers → New OAuth App
- 填写示例：
- Application name：
PureGit - Homepage URL：
http://localhost:5173 - Authorization callback URL：
http://localhost:5173/$auth/callback
- Application name：
- 复制生成的 Client ID 与 Client Secret
Note
OAuth 回调地址必须与 worker/.dev.vars 中的 GITHUB_OAUTH_CALLBACK 精确一致，如拥有自定义域名请改为 https://<你的域名>/$auth/callback，并同步修改 worker/.dev.vars 与 worker/wrangler.jsonc 中的 GITHUB_OAUTH_CALLBACK。
pnpm install# 从模板复制（worker/.dev.vars 已被 .gitignore 忽略，勿提交）
cp worker/.dev.vars.example worker/.dev.varsworker/.dev.vars 需要 4 个主要变量（本地值，与 vite dev 端口 127.0.0.1:5173 严格同步）：
GITHUB_CLIENT_ID=<你的 Client ID>
GITHUB_CLIENT_SECRET=<你的 Client Secret>
GITHUB_OAUTH_CALLBACK=http://127.0.0.1:5173/$auth/callback
FRONTEND_URL=http://127.0.0.1:5173
# 另外可配置：
RAW_PROXY_ENABLE=off|login|on
RELEASE_PROXY_ENABLE=off|login|onpnpm dev打开 http://localhost:5173，点击右上角「登录」即可。
一行配置，让本机 git 将 GitHub 流量自动代理到 Worker 镜像端点：
git config --global url.https://<你的worker域名>/.insteadOf https://github.com/之后 git clone / git pull / git push 全部自动走镜像；push 使用 PAT 作 git 凭据即可（Worker 原样透传，不存储）。
详细说明见 docs/cli-setup.md
提供一键脚本（自动检测环境 → 登录 → 创建 KV → 部署）与手动步骤两种方式：
# Linux / macOS
./scripts/deploy.sh # 首次部署
./scripts/deploy.sh --update # pull 到最新后重部署
# Windows（PowerShell）
.\scripts\deploy.ps1 # 首次部署
.\scripts\deploy.ps1 --update # pull 到最新后重部署完整部署方案（配置项说明 / 手动步骤 / 自定义域名 / 更新部署）见 docs/deploy.md
| 文档 | 内容 |
|---|---|
| docs/vision.md | 中心思想与产品定位 |
| docs/design.md | UI/UX 设计规范（Design System） |
| docs/architecture.md | 架构设计 |
| docs/cli-setup.md | CLI 镜像接入指南 |
| docs/deploy.md | 部署指南（Cloudflare Workers） |
完整文档体系（公开/内部划分、每个文档的用意/用法/场景）见 docs/index.md
本项目在仓库内固化了一整套「Agent 协作设施」，让 AI 编码助手（Copilot / Cursor / Claude Code 等）直接可上手：
.github/copilot-instructions.md—— 全局指令（顶层框架：架构红线 / 开发规范 / 规则层级 / 构建命令），会话自动加载.github/skills/—— 领域技能（官方页面改造 / API 策略 / UI 布局与 shadcn 组件 / Worker 鉴权 / git 镜像代理）docs/index.md—— 文档体系总导航（每个文档的真实用意 / 使用方式 / 适用场景）docs/design.md—— 完整 UI/UX Design System（框架层级 / 组件定义 / 响应式 / 验收清单）
想参与开发？直接对 Agent 提出需求即可，它会自动加载全局指令 → 读文档导航 → 按规范动手，并保持代码与文档同步。
MIT
- 用户浏览器前端直接与 GitHub API 产生数据交换，因此请 遵循官方 GitHub Terms of Service 准则，勿产生任何违反官方条款的行为
- 推荐部署在 Cloudflare Workers（免费额度供个人使用足矣），Worker 端仅做 OAuth2 令牌管理 + KV 会话管理，远端 不存储任何用户数据
- 边缘业务因无 API 支持，本项目仅设计做镜像转发，自行部署使用时可通过 ENV 关闭 Worker 转发代理
- 本项目仅供学习与研究使用，与 GitHub 官方无任何隶属关系