# Changelog

本文件记录 `@leetoners/dsh-ui-subagent-monitor` 所有值得记录的变更。
格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。

## [0.2.0] - 2026-08-17

### Added

- 面板拖动：标题「运行中的子代理」左侧新增拖动柄（四角箭头图标），按住可自由移动面板；位置写入 localStorage，刷新 / 重启浏览器后恢复；双击复位到默认右上角。
- 面板高度调节：底部新增横向拖动柄（统计栏与底边之间），上下拖动改变面板高度（最小 160px）；高度写入 localStorage，双击复位。
- 布局记忆拆分：面板**位置跨会话保留**（单键 `dsh-smn.panel-position.v1`，所有会话共用），**高度按会话隔离**（`dsh-smn.panel-height.v2.<sessionId>`，无会话时用 `__global__` 桶）——切换会话位置保持一致，面板大小互不影响。
- 运行状态点对齐 DSH 侧栏 tab 原生 `StateDot`（ui-primitives 规格）：运行中为蓝色像素追逐动画（10×10 SVG、3×3 外圈 8 个 2×2 像素格顺时针逐格点亮、阶梯亮度衰减、负延迟相位）；终态为实心点 + 10% 同色光晕（完成绿 / 失败红 / 中断·令牌上限·拒绝琥珀 / 已结束中性灰）。

### Fixed

- 修复面板打开时 `shell.overlay` slot 崩溃（React #310）：`useRef` / `useEffect` 曾被放在 `!open` 提前 return 之后，导致 hook 数量在两次渲染间不一致；已移至提前 return 之前。
- 修复拖动柄在空面板 / 合成指针环境下无效：拖动监听改为 window 级指针监听，不再依赖 `setPointerCapture`（注入的合成指针事件没有活动指针，capture 会抛错导致拖动从未启动）。
- 修复收起面板后仍保持拉高高度（内容收起但面板框不缩）：最小化时不再套用显式高度，面板缩回标题栏，展开后恢复记忆高度。

## [0.1.0] - 2026-08-15

### Added

- 卡片化实时面板：运行中（🔵 蓝色呼吸 + 秒表）、完成、失败、已打断、令牌上限、已拒绝、已结束（历史回填，结局未观测）。
- 侧栏底部「子代理」入口 + 右上角常驻面板；孙代子代理树形缩进。
- 「打开对话」跳转子代理会话 + 「← 主会话」一键返回。
- 刷新 / 服务重启后自动恢复（常驻组合 + 持久目录历史回填）。
- 移动端策略（≤768px 视口默认不弹出，侧栏入口仍可打开）。
- `dsh.bundle` 官方安装通道（`cordis.patch.yml`），支持 `dsh plugin add`。
- `AGENTS.md`：仓库常驻规则（文档与代码同 PR 同步、双语配对、版本对齐、决策状态约定）。
- `README.en.md`：英文 README，与中文版双语配对。
- 文档门禁 `scripts/verify-docs.mjs` + GitHub Actions（版本 / CHANGELOG 一致、双语配对、相对链接检查）。
- PR 模板（`.github/PULL_REQUEST_TEMPLATE.md`）：文档同步 checklist。
- README 面板截图（`docs/screenshot.png`，中英双语）。
- npm 发布流水线（`.github/workflows/publish.yml`）：tag 推送自动发布 + provenance。

### Changed

- npm 发布 scope 由 `@mombrane` 改为 `@leetoners`（发布组织 leetoners）。

### Fixed

- `peerDependencies` 中 DSH 包版本范围放宽至 `>=0.1.0-rc.0`（公共 npm registry 目前仅有 rc 预发布版，原 `>=0.1.0` 无法解析）。
- 重建陈旧 `lib/` 产物：包名迁移至 `@leetoners` 后未重新构建，仓库内 `lib/client.js` 仍含旧 scope；已重构建并对齐（npm tarball 不受影响，发布流水线有 `prepare` 重建）。
- 文档门禁新增 `lib/` 新鲜度检查（产物须包含当前包名）。