{"id":27621872,"url":"https://github.com/hellokaton/china-ranking","last_synced_at":"2025-04-23T08:07:35.504Z","repository":{"id":282007544,"uuid":"946993144","full_name":"hellokaton/china-ranking","owner":"hellokaton","description":"💻 中国区 Github 开发者排行榜","archived":false,"fork":false,"pushed_at":"2025-04-22T19:21:45.000Z","size":914,"stargazers_count":28,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-23T08:07:29.435Z","etag":null,"topics":["china-ranking","github-ranking"],"latest_commit_sha":null,"homepage":"https://china-ranking.32k.site","language":"Astro","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hellokaton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-12T01:48:10.000Z","updated_at":"2025-04-22T19:21:49.000Z","dependencies_parsed_at":"2025-03-27T20:24:12.876Z","dependency_job_id":"98a52fb6-8814-4319-86bc-8829d29e9de1","html_url":"https://github.com/hellokaton/china-ranking","commit_stats":null,"previous_names":["hellokaton/china-ranking"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fchina-ranking","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fchina-ranking/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fchina-ranking/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fchina-ranking/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hellokaton","download_url":"https://codeload.github.com/hellokaton/china-ranking/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250395282,"owners_count":21423400,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["china-ranking","github-ranking"],"created_at":"2025-04-23T08:07:34.923Z","updated_at":"2025-04-23T08:07:35.496Z","avatar_url":"https://github.com/hellokaton.png","language":"Astro","readme":"# 中国区 GitHub 开发者排行榜\n\n本项目收集了中国开发者在 GitHub 上关注者数据，并区分开发者和 Markdown 工程师进行排名。\n\n## 🔍 项目说明\n\n- **数据来源**: 从GitHub官方API获取公开数据\n- **自动更新**: 每天自动更新数据，保持排行榜的时效性\n- **快速加载**: 网站加载速度快，访问体验好\n- **手机友好**: 手机、平板、电脑都能正常访问浏览\n\n## 💻 技术实现\n\n### 前端架构\n\n- **[Astro](https://astro.build/)**: 高性能静态站点生成框架\n- **[Tailwind CSS](https://tailwindcss.com/)**: 原子化 CSS 框架\n- **TypeScript**: 类型安全的开发体验\n\n### 数据处理\n\n- **[GitHub REST API v3](https://docs.github.com/en/rest)**: 公开数据获取\n- **Node.js**: 数据处理服务\n- **[GitHub Actions](https://github.com/features/actions)**: 自动化工作流\n\n### 构建工具\n\n- **pnpm**: 高性能包管理器\n- **Vite**: 现代前端构建工具\n\n## 🛠️ 本地开发\n\n### 前置条件\n\n- Node.js \u003e= 18.x\n- pnpm \u003e= 8.x\n- GitHub API Token (用于数据获取)\n\n### 安装步骤\n\n1. 克隆仓库:\n\n```bash\ngit clone https://github.com/hellokaton/china-ranking.git\ncd china-ranking\n```\n\n2. 安装依赖:\n\n```bash\npnpm install\n```\n\n3. 配置环境变量:\n\n```bash\ncp .env.example .env.local\n# 编辑 .env.local 添加你的 GitHub Token\n```\n\n4. 启动开发服务器:\n\n```bash\npnpm dev\n```\n\n5. 构建生产版本:\n\n```bash\npnpm build\n```\n\n6. 预览生产构建:\n\n```bash\npnpm preview\n```\n\n## 📊 数据处理方法\n\n项目数据处理遵循以下流程:\n\n1. **数据采集**: 通过 GitHub API 获取公开用户信息\n2. **地区识别**: 根据公开资料识别中国区用户\n3. **账号过滤**: 过滤组织账号，仅保留个人开发者账号\n4. **开发者分类**: 基于贡献类型将开发者分为不同类别，包括区分 Markdown 工程师和代码开发者\n5. **贡献分析**: 基于仓库类型、提交类型等多维度分析\n6. **数据存储**: 生成结构化数据文件\n7. **定期更新**: 通过自动化工作流定期更新数据\n\n### 手动触发数据更新\n\n```bash\n# 设置 GitHub Token 环境变量\nexport GITHUB_TOKEN=your_github_token\n\n# 执行数据获取脚本\npnpm fetch-data\n```\n\n## 🧩 项目结构\n\n```\n├── public/                # 静态资源\n├── src/\n│   ├── components/        # 通用组件\n│   ├── layouts/           # 页面布局模板\n│   ├── pages/             # 页面路由\n│   ├── utils/             # 工具函数\n│   └── types/             # TypeScript 类型定义\n├── scripts/               # 数据处理脚本\n│   └── fetch-github-users.js  # GitHub 用户数据获取\n├── astro.config.mjs       # Astro 配置\n└── tailwind.config.cjs    # Tailwind 配置\n```\n\n## 🤝 参与贡献\n\n我们欢迎各种形式的贡献，包括但不限于:\n\n- 功能改进与 Bug 修复\n- 性能优化\n- 文档完善\n- 数据处理方法优化\n- UI/UX 改进\n\n### 贡献流程\n\n1. Fork 本仓库\n2. 创建功能分支 (`git checkout -b feature/amazing-feature`)\n3. 提交变更 (`git commit -m 'feat: add amazing feature'`)\n4. 推送到远程分支 (`git push origin feature/amazing-feature`)\n5. 创建 Pull Request\n\n请确保遵循我们的代码规范和提交规范。\n\n## 📜 许可证\n\n本项目采用 [MIT 许可证](LICENSE)。\n\n---\n\n**声明**: 这个排行榜只是为了技术交流学习，所有数据都来自GitHub公开API，不是什么官方排名。数据仅供参考，请勿用于商业用途。\n","funding_links":[],"categories":["Astro"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellokaton%2Fchina-ranking","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhellokaton%2Fchina-ranking","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellokaton%2Fchina-ranking/lists"}