# 科研进度预警报告执行记录：Gitlink/forgeplus（里程碑信号⑥启用 · 主验证仓）

> 本文档是 `gitlink-research-progress` skill 在真实仓库上的**主验证**执行记录。
> 仓库：`Gitlink/forgeplus`（GitLink 平台自身的代码托管引擎"确实开源"，原生非镜像）。
> 执行方式：纯远程只读，所有数据通过 `gitlink-cli` 获取，未 clone 本地。
> **本例的特殊价值**：forgeplus 是 GitLink 上**极少数启用里程碑的仓库**（4 个里程碑），因此本 skill 设计中**被迫设为"可选降级"的里程碑信号⑥在此首次真正启用**。与 `progress-alert-gitlink-cli.md`（无里程碑降级）、`progress-alert-fairmot.md`（归档降级）形成"里程碑启用 vs 降级"的对照。
> 诚实说明：forgeplus 是平台引擎而非纯科研项目。本例验证的是**预警算法在真实协作数据上的有效性**（含里程碑维度），纯科研仓的端到端语义验证待 GitLink 科研生态成熟后补充。

---

## 执行的命令序列

```bash
# ① 仓库元信息
gitlink-cli repo +info --owner Gitlink --repo forgeplus --format json
#   → issues_count=4246, pull_requests_count=355, mirror=false, forked_from_project_id=null（原生）
#   → default_branch=master, size=797.5MB, name=确实开源

# ③ Issue 采集（大数量仓，先落盘再分析）
gitlink-cli issue +list --owner Gitlink --repo forgeplus --state all --format json
#   → ⚠️ 实测只返回最新 20 条（API 单页硬上限），但全量统计字段可用：
#     total_count=4196, opened_count=35, closed_count=4161
#   → 返回的 20 条是最新的（按时间倒序），用于近期趋势信号分析

# ④ 提交活跃度
gitlink-cli commit +list --owner Gitlink --repo forgeplus --limit 50 --format json
#   → 实测返回 15 条（仓库近期提交少）

# ⑤ 里程碑（本例核心 —— 信号⑥的数据来源）
gitlink-cli milestone +list --owner Gitlink --repo forgeplus --format json
#   → total_count=4（GitLink 上极罕见）
#   → 字段：name / effective_date(DDL) / percent(完成度) / issues_count /
#           close_issues_count / opened_issues_count / status
```

### ⚠️ forgeplus 采集的实测坑（补充 SKILL.md）

| 坑 | 说明 | 应对 |
|---|---|---|
| **`issue +list` 单页硬上限 20** | forgeplus 有 4246 Issue，但 `--state all` 实测只返回 20 条最新（`--limit` 无效）| 用 `data.total_count/opened_count/closed_count` **全量统计字段**做宏观判断；近 30 天趋势用返回的 20 条（最新，按时间倒序）作为近期样本 |
| **里程碑 DDL 字段叫 `effective_date`**（非 `due_date`） | GitLink 里程碑用 `effective_date` 表示生效日期，`percent`(0-1) 表示完成度 | 信号⑥判定用 `effective_date` 算逾期、`percent` 算完成度 |
| **Issue 个体不关联里程碑** | 单条 Issue 的 `milestone_id`/`milestone_name` 实测为 null | 里程碑下的 Issue 数从 `milestone +list` 的 `issues_count`/`close_issues_count` 取，不从 Issue 反查 |

## 关键数据摘要（实测，2026-07-01）

| 指标 | 实测值 |
|---|---|
| Issue 全量（统计字段）| total=4196 / opened=35 / closed=4161 |
| Issue 返回样本（单页）| 20 条（12 新增 / 6 关闭 / 2 已解决）|
| 高优先级无人认领 | 0 |
| 未解决且 0 评论（样本）| 11 |
| 最长停滞（样本）| #3880 停留 935 天 |
| >60 天未解决（样本）| 4（#3880=935天、#4687=98天、#4693=75天、#4694=73天）|
| 近 30 天提交 / 前 30 天 | 0 / 0（近 30 天无提交）|
| 最近提交 | 2025-09-12（约 10 个月前）|
| unique 贡献者（近 15 提交）| 8（yystopf/xxq250/otto/maxjhandsome 等）|
| **里程碑** | **4（GitLink 罕见）—— 信号⑥启用** |
| └ 逾期未完成里程碑 | **2**：「平台遗留问题」逾期 913 天、「平台用户体验升级」逾期 914 天 |

---

## 🚨 科研进度预警报告 — Gitlink/forgeplus

```
═══════════════════════════════════════════════════
报告日期: 2026-07-01   仓库: Gitlink/forgeplus（原生非镜像，"确实开源"）
最近提交: 2025-09-12（约 10 个月前，近期无活动）
健康度基线（委托 project-health）: 关闭率 99%（4161/4196） / 活跃度: 近期停滞
分析方式: 纯远程只读（gitlink-cli issue/commit/milestone/repo）
说明: 本报告呈现项目时间线上的风险信号，由读者结合自身对项目的了解
      自行判断；风险等级与评分仅作辅助参考，不构成绝对结论。
注: Issue 单页上限 20，宏观用全量统计字段，趋势用最新 20 条样本。

═══════════════════════════════════════════════════
📊 预警清单（按风险等级 🔴→🟡→🟢 排序）
═══════════════════════════════════════════════════

【🔴 高风险】信号⑥ 里程碑 DDL 逾期（本例首次启用！）
  信号证据:
    • 「平台遗留问题」DDL=2023-12-31，完成度 93%（关51/总55，未关4），
      已逾期 913 天，status 仍 open
    • 「平台用户体验升级」DDL=2023-12-30，完成度 93%（关25/总27，未关2），
      已逾期 914 天，status 仍 open
    • 另有「20260123Gitlink里程碑」完成度 100%（已达成）；「test-milestone」空测试
  科研影响: 里程碑逾期近 2.5 年且完成度卡在 93% 不再推进，是典型的"项目阶段
    目标失控"信号。科研场景里对应"本应在某会议 DDL 前完成的实验阶段长期拖延，
    剩余少量 issue 却无人收尾"。这两个里程碑各有 2-4 个未关闭 Issue 悬置近 3 年。
  建议动作: 逐个评估逾期里程碑里剩余的 2-4 个未关闭 Issue（如「平台遗留问题」
    的 4 个），决定是关闭里程碑（接受现状）还是重新排期。

【🔴 高风险】信号① 长期停滞的未解决 Issue
  信号证据:
    • 样本中 #3880「全站网页字体回退需要清理」停留 935 天（约 2.6 年）
    • 另有 3 个 >60 天：#4687(98天)、#4693(75天)、#4694(73天)
    • 全量：opened=35（统计字段），其中老 Issue 历史欠账多
  科研影响: 长期未解决的 Issue 往往是"问题触及设计瓶颈或无人投入"的信号。
    #3880 悬置 2.6 年，配合下方信号⑤的提交停滞，指向"项目进入低维护期"。
  建议动作: 评估 35 个 open Issue 中哪些属于"遗留可关闭"、哪些仍需处理。

【🔴 高风险】信号⑤ 提交活跃度突变（已停滞）
  信号证据:
    • 近 30 天 0 提交；最近提交 2025-09-12（约 10 个月前）
    • 前 30 天同样 0 提交，但历史上有 8 位贡献者活跃过（yystopf/xxq250 等）
  科研影响: 仓库已进入停滞期。科研上意味着不会修复复现/使用中的新问题。
    与信号①⑥相互印证：提交停滞 + 历史欠账 + 里程碑逾期 = 项目低维护。
  建议动作: 视为"低维护状态"使用，不期待近期更新；关注是否有迁移/重构计划。

【🔴 高风险】信号③ 未解决且零响应
  信号证据:
    • 样本中 11 个未解决 Issue 零评论（占比偏高），含 #4709「从github导入项目
      一直失败」、#4707「issue tag 文字不可见」、#4706「目录侧边栏 UI 卡位」等
  科研影响: 大量问题无任何讨论响应，配合提交停滞，说明社区/维护者响应已沉寂。
  建议动作: 若依赖此项目，关键 Issue 需自行排查或提 PR 贡献。

【🔴 高风险】信号④ 积压趋势（近 30 天，样本）
  信号证据:
    • 最新 20 条样本中，近 30 天新增（未解决）6 条，关闭 1 条，净变化 +5
    • 全量统计：opened=35 持续存在，近 30 天关闭速率明显低于新增
  科研影响: 积压在恶化（净增 +5 > 3 红线）。虽总量(35)相对历史(4196)不大，
    但趋势方向配合提交停滞，属"问题积压且无人消化"。
  建议动作: 关注关闭速率是否回升；若持续净增，积压会扩大。

【🟢 正常】信号② 高优先级问题无人认领
  信号证据: priority_name='高' 且无人认领的未解决 Issue = 0（样本内）
  说明: 无高优先级瓶颈（现有未解决 Issue 多为"正常"优先级）。

═══════════════════════════════════════════════════
📈 总体趋势概览
═══════════════════════════════════════════════════
  • 积压趋势: 恶化（近 30 天净 +5，关闭速率跟不上新增）
  • 提交活跃度: 已停滞（最近提交 10 个月前，近 30 天 0 提交）
  • 关注焦点: ⚠️ 项目呈"低维护/停滞"特征——2 个里程碑逾期近 2.5 年未收尾、
    提交停滞 10 个月、历史欠账(#3880 悬置 935 天)+ 近期积压恶化。
    最该优先处理的是：里程碑⑥的 6 个未关闭 Issue（决定是关闭还是重排）。

═══════════════════════════════════════════════════
参考性风险评分（辅助总结，请以上方证据为准自行判断）
  ① 停滞风险    25/25   ② 资源未就位   0/20
  ③ 响应沉寂    15/15   ④ 积压趋势    20/20
  ⑤ 活跃度突变  20/20   ⑥ 里程碑(启用) +10
  参考风险总分: 80/100 + 10 = 90/100（越高风险越大，0=全维度无风险）
  参考预警等级: 🔴 高（>60）
  (仅供索引，不代表项目绝对成败)
═══════════════════════════════════════════════════
```

---

## 结论（供读者参考，非定论）

基于上述证据，`Gitlink/forgeplus` 呈现**"曾经活跃、现已进入低维护/停滞期"**的高风险画像：

| 维度 | 状态 | 关键证据 |
|---|---|---|
| 里程碑管理 | 🔴 失控 | 2 个里程碑逾期近 2.5 年，完成度卡 93%，6 个 Issue 悬置 |
| 提交活跃度 | 🔴 停滞 | 最近提交 10 个月前，近 30 天 0 提交 |
| 历史欠账 | 🔴 偏重 | #3880 悬置 935 天，35 个 open Issue |
| 积压趋势 | 🔴 恶化 | 近 30 天净 +5 |
| 响应沉寂 | 🔴 普遍 | 11 个零响应 Issue |

**核心判断**：项目历史上协作充分（4246 Issue、355 PR、4 里程碑、8+ 贡献者），但近期（近 10 个月）已停滞，表现为提交归零 + 里程碑逾期未收尾 + 新增问题无人消化。风险总分 90/100 为高风险，性质是"活跃项目转入低维护"而非"从未维护"。这与 `ifzhang/FairMOT`（从未在 GitLink 协作）的"归档停滞"性质不同。

> 本报告为辅助参考，项目实际状态需结合 GitLink 平台运营计划综合判断（forgeplus 作为平台引擎，可能有平台侧的维护节奏，与开源社区可见的提交/Issue 不同步）。

### 与另外两份 example 的对照（三档对比）

| 维度 | forgeplus（本例·主）| gitlink-cli（活跃工具仓）| FairMOT（归档降级）|
|---|---|---|---|
| Issue 量 | 4246 | 19 | 1 |
| 里程碑 | **4（信号⑥启用）** | 0（信号⑥降级）| 0（信号⑥降级）|
| 提交活跃度 | 停滞（10 月前）| 活跃（4 小时前）| 归档（5 年前）|
| 风险总分 | 90 🔴 | 45 🟡 | 50 🟡 |
| 验证价值 | **6 信号全启用，里程碑首次落地** | 5 信号（无⑥），活跃仓验证 | 降级输出，归档仓验证 |

> 三档对照完整展示了 skill 在不同数据丰富度仓库上的行为：里程碑启用(forgeplus) / 无里程碑但活跃(gitlink-cli) / 数据稀疏归档(FairMOT)，均不报错、如实呈现。

---

## 复现说明

本报告可通过 `gitlink-research-progress` skill 对 `Gitlink/forgeplus` 复现。触发方式：对 Agent 说"预警 Gitlink/forgeplus 的进度风险"，Agent 会按 SKILL.md 的 7 步工作流执行。所有命令均为纯远程只读，无需 clone。注意 forgeplus Issue 量大，单页返回 20 条，里程碑维度是本例的核心验证点。
