这个项目能做什么

DevDNA是一款Web应用,可将你的公开GitHub活动转化为分析报告和开发者档案徽章。它仅通过GitHub OAuth运行,这意味着只有你能分析自己的账号——没有匿名查询或对其他开发者的排名功能。 ## DevDNA提供的功能 - **开发者分类**:基于提交模式、使用的仓库和协作行为,划分出10种不同的档案类型 - **证据徽章**:在`devdna-production-1d53.up.railway.app/api/badge/{username}.svg`生成的SVG图片,可用于嵌入GitHub README或个人主页 - **可分享的报告卡**:独立页面`https://devdna.catchmeif404.com/dev/{username}`,包含对你编码习惯、技术栈偏好和开发者类型的确定性总结 - **语言支持**:界面和分享文本提供英语和韩语版本 - **隐私设计**:原始仓库和提交数据不会被持久化存储,仅保存最终分析结果 ## 如何添加徽章 将以下Markdown粘贴到任意GitHub README中: ```markdown [![DevDNA](https://devdna-production-1d53.up.railway.app/api/badge/YOUR_USERNAME.svg)](https://devdna.catchmeif404.com/dev/YOUR_USERNAME) ``` 如果后端尚未对该账号运行过分析,该接口会返回占位`AWAITING EVIDENCE`徽章,而非破损图片。 ## 技术栈 | 领域 | 技术 | |---|---| | 前端 | Next.js、TypeScript、Tailwind CSS、Cloudflare Workers | | 后端 | Spring Boot(Java 21)、Flyway数据库迁移、Railway部署 | | 数据库 | PostgreSQL | | 认证 | GitHub OAuth | ## 本地运行 ```bash cp .env.example .env docker compose up -d ``` - 前端:http://localhost:3010 - 后端API:http://localhost:8090 需要创建GitHub OAuth应用,并设置`GITHUB_CLIENT_ID`和`GITHUB_CLIENT_SECRET`。本地回调URL需配置为`http://localhost:8090/api/auth/github/callback`。 ## 已知限制 - 总结由基于规则的模板生成,而非概率模型;提交类型分类在配置后可选择调用Claude API - 仅持久化最终分析结果——原始GitHub数据会被流式传输后丢弃 - 若后端重启,正在进行的分析不会自动恢复 - GitHub用户名变更后,结果归属可能无法完全正常化