---
Spec-Type: work
Initiative: 20260414-B2-check-update-diff
Status: completed
Owner-Session: ys-team
Write-Scope:
  - scripts/ys-team.mjs
  - README.md
  - docs/specs/completed/20260414-B2-check-update-diff/
Depends-On:
  - 20260414-B1-baseline-changelog
Verification: "本地 helper 模拟落后版本输出；本地已最新输出保持简洁"
---

# Work：check-update 升级 diff

## Background

当前 `check-update` 只有版本对比，没有迁移信息。B1 已提供结构化 changelog，可作为升级摘要来源。

## Goals

- 让 `check-update` 在版本落后时展示 changelog 摘要
- 保持本地已最新时输出简洁
- 在网络或提取失败时降级到 changelog 链接，而不是直接报错

## Deliverables

- `scripts/ys-team.mjs` 中增强后的 `check-update`
- `README.md` 中的说明更新

## Acceptance Criteria

- 输出包含落后版本列表、主要变化、关键文件和迁移建议
- `latest == local` 时输出不膨胀
- 提取失败时仍保留可操作的更新提示

## Verification

- `node scripts/ys-team.mjs check-update`
- `npm pack --pack-destination /tmp`
- `node --input-type=module -e "...导入 helper 并模拟落后版本输出..."`

## Acceptance Evidence

- `docs/specs/completed/20260414-B2-check-update-diff/qa-report.md`
- `docs/specs/completed/20260414-B2-check-update-diff/evidence/20260415-closeout.md`

## Documentation Updates

- `scripts/ys-team.mjs`
- `README.md`

## Risks

- tarball 提取逻辑如果过于脆弱，会让摘要输出不稳定

## Rollback Plan

- 回退到仅输出版本对比和升级命令的实现