GitCode 口袋工具 v1.0.2：详情页面重磅上线！

🎉 版本亮点：新增用户详情页和仓库详情页，让信息浏览更深入、更全面！

一、版本信息

• 版本号：v1.0.2
• 发布日期：2025年
• 主要更新：详情页面功能、API 增强、用户体验优化
• 仓库地址：gitcode_pocket_tool

二、核心新功能

2.1 用户详情页面

在 v1.0.2 版本中，我们新增了用户详情页面，让您可以深入了解每个用户的完整信息。

2.1.1 功能特性

• 📸 用户头像展示：大尺寸头像，清晰展示用户形象
• 👤 基本信息：显示用户名称、登录名（@username）
• 📝 个人简介：展示用户的 bio 信息
• 📊 统计信息卡片：
  • 仓库数量：显示用户拥有的公开仓库数
  • 粉丝数量：显示关注该用户的用户数
  • 关注数量：显示该用户关注的用户数
• 📅 其他信息：
  • 注册时间：显示用户注册日期
  • 主页链接：可点击跳转到用户的 GitCode 主页

2.1.2 使用方式

1. 在搜索页面搜索用户
2. 进入用户列表页面
3. 点击任意用户卡片，即可跳转到用户详情页面
4. 在详情页面可以查看完整的用户信息

2.2 仓库详情页面

全新的仓库详情页面让您可以全面了解每个代码仓库的详细信息。

目前镜像代理的仓库无法正确显示：例如下述

在APP内目前无法访问，但是其他在GitCode本地的可以正常访问：

2.2.1 功能特性

• 🏷️ 仓库标识：
  • 仓库全名（owner/repo）
  • 私有/公开标识（锁图标/文件夹图标）
• 📄 仓库描述：完整展示仓库的描述信息
• 📊 统计信息：
  • ⭐ Star 数量
  • 🍴 Fork 数量
  • 👁️ Watch 数量
  • 🐛 Issues 数量
• 📋 详细信息：
  • 主要编程语言
  • 默认分支
  • 仓库大小（自动转换为 MB）
  • 创建时间
  • 更新时间
  • 最后推送时间
  • 许可证信息
• 👤 所有者信息：
  • 所有者头像和登录名
  • 所有者类型（User/Organization）
  • 可点击跳转到所有者主页
• 🔗 快速操作：
  • "在浏览器中打开"按钮，一键跳转到 GitCode 仓库页面

2.2.2 使用方式

1. 在搜索页面搜索仓库
2. 进入仓库列表页面
3. 点击任意仓库卡片，即可跳转到仓库详情页面
4. 在详情页面可以查看完整的仓库信息

---

三、技术改进

3.1 API 增强

3.1.1 新增 fetchRepository 方法

Future<GitCodeRepositoryDetail> fetchRepository(
  String owner,
  String repo, {
  String? personalToken,
  int? projectId,
})

特性：

• ✅ 支持通过 owner/repo 路径查询
• ✅ 支持通过 projectId 直接查询（更可靠）
• ✅ 智能降级机制：如果 /repos/ 路径失败，自动尝试 /projects/ 路径
• ✅ 完善的错误处理：针对不同 HTTP 状态码提供友好的错误提示

3.1.2 数据模型扩展

新增 GitCodeRepositoryDetail 模型，包含更丰富的仓库信息：

• 仓库大小、默认分支
• Watch、Issues 统计
• 许可证信息
• 所有者详细信息
• 创建、更新、推送时间

3.2 用户体验优化

1. 流畅的页面跳转：使用 Flutter 原生导航，动画流畅自然
2. 加载状态提示：详情页面加载时显示进度指示器
3. 错误处理：网络错误或数据加载失败时，提供友好的错误提示和重试按钮
4. 空状态处理：数据为空时显示清晰的提示信息
5. 外部链接跳转：使用 url_launcher 在系统浏览器中打开链接

---

四、功能演示

4.1 用户详情页面

┌─────────────────────────────┐
│  ← 用户名称                  │
├─────────────────────────────┤
│                             │
│        [用户头像]            │
│        用户名称              │
│        @username            │
│                             │
│  简介                        │
│  这里是用户的个人简介...      │
│                             │
│  统计信息                    │
│  ┌─────┐ ┌─────┐ ┌─────┐   │
│  │ 仓库│ │ 粉丝│ │ 关注│   │
│  │  42 │ │ 128 │ │  56 │   │
│  └─────┘ └─────┘ └─────┘   │
│                             │
│  其他信息                    │
│  📅 注册时间: 2020-01-01    │
│  🔗 主页链接: [可点击]       │
└─────────────────────────────┘

4.2 仓库详情页面

┌─────────────────────────────┐
│  ← 仓库名称                  │
├─────────────────────────────┤
│  📁 owner/repository-name    │
│                             │
│  描述                        │
│  这是一个优秀的开源项目...    │
│                             │
│  统计信息                    │
│  ⭐ Star: 1.2k              │
│  🍴 Fork: 234               │
│  👁️ Watch: 89             │
│  🐛 Issues: 12              │
│                             │
│  详细信息                    │
│  💻 主要语言: Dart          │
│  🌳 默认分支: main          │
│  💾 仓库大小: 15.23 MB     │
│  📅 创建时间: 2023-01-01   │
│  🔄 更新时间: 2024-01-15   │
│  📌 最后推送: 2024-01-14   │
│  ⚖️ 许可证: MIT           │
│                             │
│  所有者                      │
│  [头像] @owner              │
│                             │
│  [在浏览器中打开]            │
└─────────────────────────────┘

---

五、从列表到详情：完整的使用流程

5.1 搜索用户流程

1. 搜索页面 → 输入关键字和 Token → 点击"查询"
2. 搜索结果预览 → 查看前几个结果
3. 用户列表页面 → 点击"查看全部并加载更多"
4. 浏览列表 → 下拉刷新、上拉加载更多
5. 查看详情 → 点击用户卡片 → 用户详情页面 ✨

5.2 搜索仓库流程

1. 搜索页面 → 切换到"仓库"模式 → 输入关键字和 Token → 点击"查询"
2. 搜索结果预览 → 查看前几个结果
3. 仓库列表页面 → 点击"查看全部并加载更多"
4. 浏览列表 → 下拉刷新、上拉加载更多
5. 查看详情 → 点击仓库卡片 → 仓库详情页面 ✨

---

六、版本对比

6.1 v1.0.1 vs v1.0.2

功能	v1.0.1	v1.0.2
用户搜索	✅	✅
仓库搜索	✅	✅
分页加载	✅	✅
用户详情页	❌	✅ 新增
仓库详情页	❌	✅ 新增
API 增强	基础功能	✅ 增强

---

七、使用技巧

7.1 快速查看用户信息

• 在用户列表页面，直接点击用户卡片即可查看详情
• 详情页面支持点击主页链接，在浏览器中打开用户的 GitCode 主页

7.2 深入了解仓库

• 在仓库列表页面，点击仓库卡片查看完整信息
• 使用"在浏览器中打开"按钮，快速跳转到 GitCode 仓库页面
• 查看仓库的统计信息，了解项目的活跃度

7.3 错误处理

• 如果详情页面加载失败，点击"重试"按钮重新加载
• 确保 Token 有效且有相应权限
• 检查网络连接是否正常

---

八、问题修复

• ✅ 修复了某些仓库路径无法正确解析的问题（通过项目 ID 支持）
• ✅ 优化了 API 错误处理，提供更友好的错误提示
• ✅ 改进了网络超时处理机制

---

九、技术栈

• Flutter 3.6.2+
• Dart 3.6.2+
• Material Design 3
• Dio 5.7.0 - HTTP 客户端
• url_launcher 6.3.1 - 外部链接跳转

---

十、下一站

我们正在规划以下功能：

• 支持收藏用户和仓库（本地存储）
• 搜索历史记录
• 暗色模式支持
• 多语言国际化
• 数据缓存机制
• 分享功能

---