增量分析报告：dsh/dsh-todo-sidebar

• 版本区间：0.2.0 → 0.2.1
• 分支：v0.2.1
• base_sha：7652c25caeece67f41b82bc13774020bb6fa35ee
• head_sha：138f0cdeb0e816e442391019bfbd7ae390ae79fe

---

1. 变更概览（一句话结论）

0.2.1 是一次「零运行时代码变更」的元数据/发版整理：仅在 package.json 补充了新版 DSH 所需的插件清单字段（engines.dsh、dsh.manifestVersion）、更新 README 版本说明，并新增了一个打 tag 触发的 CodeScan 增量分析工作流。lib/、tests/ 等所有运行时代码完全未改动，因此质量面与上一版本一致（修复 0 / 新增 0）。

2. 变更文件清单

3. 关键变更解读

3.1 package.json（唯一实质性变更）

"version": "0.2.1",
"engines": { "dsh": ">=0.1.5-rc.1" },   // 新增
"dsh": {
  "manifestVersion": 1,                  // 新增
  "bundle": { "patch": "./cordis.patch.yml" },
  "client": { "inject": [...], "platform": "web" }
}

• 目的（据 README）：使 dshmarket 的兼容性判定从「未声明」变为「符合宿主要求」。
• 影响面：宿主加载/兼容性判定路径，不涉及插件运行逻辑，无功能行为变化。

3.2 .gitea/workflows/codescan-tag.yaml（新增 CI）

• 触发：push tag v*；用 git tag --sort=-creatordate | grep -A1 取前一 tag，再经 git rev-list -n 1 求 base/head SHA，最后 POST 到 Webhook。
• 与本次分析的基准一致：即本报告的比较范围正是该工作流未来会自动触发的区间。

3.3 README 文档

• 依赖表、版本形态表更新至 0.2.1（并补充实测矩阵：DSH Desktop 2.0.15 / harness 0.1.7-rc.2，以及 2.0.13 / 0.1.5-rc.2）。
• 新增「发版约定」：master 上打 annotated tag vX.Y.Z，与 package.json 版本一致。

4. 修复的问题（base 有、head 无）

无。 依据 codescan.issues_diff 真实数据：修复 0 条 / 新增 0 条（两版本质量无差异）。

原因：本次区间未触碰任何被扫描的源码文件，质量问题集合不变。

5. 新增的问题（head 有、base 无）

无。 同 §4，issues_diff 显示新增 0 条。

6. 存量质量问题（当前 head 快照，54 条，均为遗留、非本次引入）

全部集中在 lib/client.js 与 tests/harness.cjs，属于上一版本继承项。主要类别：

• 复杂度/可维护性（Medium 为主）：lib/client.js 多处圈复杂度过高与嵌套过深——createTodoPane(979, CC=20, 116 行)、TodoSection(852, CC=17)、SubagentDetail(605, CC=15, 102 行)、SessionRow(536, CC=17)、函数过长等。
• 高耦合（Medium）：createTodoPane 直接依赖 30 个函数、SubagentDetail 23 个、StatusHeader 19 个、TodoSection 18 个、CommandSection 14 个、createTodoHeaderButton 12 个；tests/harness.cjs 依赖 21 个函数。
• 扇入扇出异常（Low）：jsx(fan-in 77)、createTodoPane、SubagentDetail 等。
• 命名/重复/行过长/TODO/未使用参数（Low）：多为风格类提示。

结论：0.2.1 未引入任何新缺陷；上述 54 条均为既有技术债，建议纳入后续重构迭代（重点：拆分 createTodoPane / SubagentDetail，降低单函数耦合与圈复杂度）。

7. 风险与建议

1. [低] CI 取「前一 tag」逻辑存在边界风险：PREV_TAG=$(git tag --sort=-creatordate | grep -A1 "$CURRENT_TAG" | tail -1) 在「当前 tag 恰为最新」或「只有一个 tag」时，grep -A1 仅返回当前 tag 本身，tail -1 即等于 CURRENT_TAG，会导致 PREV_TAG == CURRENT_TAG、base 与 head 相同（空区间）。现有 if: steps.tags.outputs.previous != '' 守卫只判空、判不出这种自引用。建议补充 previous != current 的判断或改用 git describe --tags --abbrev=0 <tag>^。
2. [低] 变量引用未加引号：git rev-list -n 1 ${{ steps.tags.outputs.previous }} 未加引号，tag 含特殊字符时有风险；建议 "${{ ... }}"。
3. [低] Gitea/GitHub 上下文混用：工作流同时使用 GITHUB_REF / GITHUB_OUTPUT / github.repository 与 gitea.actor。Gitea Actions 一般兼容 github 别名，但 GITHUB_OUTPUT 等依赖 Gitea 版本；建议统一为一种风格并确认 runner 版本支持。
4. [提示] 发版可追溯性：本次仅凭 tag + 元数据标注版本，若后续要精确回退，需保证 tag 指向的提交与 package.json 版本严格一致（README 已如此约定）。

8. 验证与证据

• 变更面：codescan.git_diff（base..head）——仅上述 3 个文件。
• 问题对比：codescan.issues_diff——修复 0 / 新增 0。
• 存量问题：codescan.quality_list @ head——54 条，均非本次引入。
• 运行时代码未变更已在 diff 中确认（无 lib/、tests/ 相关 hunk）。