# 科研项目洞察工作流 — 端到端示例

**场景**：科研工作者希望分析 GitLink 上的一个开源研究项目，了解其成熟度、文档质量、贡献模式和社区健康度。

## 前置条件

- `gitlink-cli` 已安装并登录

## 工作流步骤

### Step 1：采集仓库数据

```bash
# 1.1 获取仓库基本信息
gitlink-cli repo +info --owner z2_cc --repo gitlink-cli --format json
gitlink-cli repo +topics --owner z2_cc --repo gitlink-cli --format json
gitlink-cli repo +languages --owner z2_cc --repo gitlink-cli --format json
gitlink-cli repo +contributors --owner z2_cc --repo gitlink-cli --format json
```

**输出示例：**
```json
{
  "ok": true,
  "data": {
    "name": "gitlink-cli",
    "description": "GitLink 官方命令行工具，支持仓库管理、Issue/PR/Release 操作",
    "star_count": 12,
    "fork_count": 5,
    "created_at": "2026-01-15",
    "updated_at": "2026-06-29"
  }
}
```

```bash
# 1.2 获取提交历史
gitlink-cli commit +list --owner z2_cc --repo gitlink-cli --limit 100
```

### Step 2：分析贡献模式

```bash
# 2.1 获取 Issue 统计
gitlink-cli issue +list --owner z2_cc --repo gitlink-cli --state all --format json

# 2.2 获取 PR 统计
gitlink-cli pr +list --owner z2_cc --repo gitlink-cli --state all --format json

# 2.3 获取协作者列表
gitlink-cli collaborator +list --owner z2_cc --repo gitlink-cli
```

**AI 分析逻辑：**

```
贡献者分析：
- 近 100 次提交的 unique author 数量
- 提交时间分布（判断活跃频率）
- 新贡献者比例

Issue 健康度：
- 关闭率 = closed / total
- 平均响应时间 = avg(closed_at - created_at)

PR 健康度：
- 合并率 = merged / total
- 平均合并时间 = avg(merged_at - created_at)
```

### Step 3：生成洞察报告

```markdown
# 🔬 科研项目洞察报告 — z2_cc/gitlink-cli

**分析日期：** 2026-06-29
**综合评分：** 7.5/10 🟢

## 一、项目画像
| 维度 | 数据 |
|------|------|
| 项目名称 | gitlink-cli |
| 描述 | GitLink 官方命令行工具 |
| 创建时间 | 2026-01-15 (5 个月) |
| Star/Fork | 12 / 5 |
| 主要语言 | Go |
| 研究主题 | CLI, DevOps, Git |

## 二、成熟度分析（7/10）
- 项目较新（5个月），但已发布正式版本
- 社区影响力处于成长期
- 更新频率高，维护活跃

## 三、文档质量（8/10）
- ✅ 完整的 README（中英文）
- ✅ 设计文档（doc/design.md）
- ✅ API 参考文档
- ✅ 贡献指南
- ⚠️ 建议补充更多使用示例

## 四、贡献模式（7/10）
- 3 位核心贡献者
- 提交频率：每周 3-4 次 🟡
- 新增贡献者：暂无
- ⚠️ 建议标记 good-first-issue 吸引新人

## 五、社区健康度（8/10）
- Issue 关闭率：87.5% 🟢
- PR 合并率：80% 🟢
- 响应及时，协作效率高

## 六、改进建议
1. 标记 good-first-issue 吸引新贡献者
2. 补充更多实战案例文档
3. 考虑添加社区交流渠道
```

## 完整命令速览

```bash
# 数据采集
gitlink-cli repo +info --owner <owner> --repo <repo> --format json
gitlink-cli repo +topics --owner <owner> --repo <repo> --format json
gitlink-cli repo +languages --owner <owner> --repo <repo> --format json
gitlink-cli commit +list --owner <owner> --repo <repo> --limit 100
gitlink-cli issue +list --owner <owner> --repo <repo> --state all --format json
gitlink-cli pr +list --owner <owner> --repo <repo> --state all --format json
gitlink-cli collaborator +list --owner <owner> --repo <repo>
```

## 注意事项

- 对于大型项目（⭐ > 1000），建议使用 `--limit` 限制数据量
- 分析结果基于公开数据，部分推断可能不准确
- 可复现性评估需要使用方自行验证
