yinjianm
d74e84c87b
preserve xterm viewport intent when switching terminal tabs so bottom-pinned sessions stay pinned and manually scrolled sessions keep their history position unify viewport restoration across activation, fit, and resize paths to avoid losing scroll state after terminal reflow
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 任务清单: terminal-tab-scroll-restore
|
|
|
|
```yaml
|
|
@feature: terminal-tab-scroll-restore
|
|
@created: 2026-03-25
|
|
@status: completed
|
|
@mode: R2
|
|
```
|
|
|
|
## 进度概览
|
|
|
|
| 完成 | 失败 | 跳过 | 总数 |
|
|
|------|------|------|------|
|
|
| 5 | 0 | 0 | 5 |
|
|
|
|
---
|
|
|
|
## 任务列表
|
|
|
|
### 1. 方案与范围确认
|
|
|
|
- [√] 1.1 创建终端切换滚动恢复方案包并锁定前端终端组件范围 | depends_on: []
|
|
|
|
### 2. 终端滚动恢复修复
|
|
|
|
- [√] 2.1 盘点终端切换、fit 与 xterm 视口状态的现有实现 | depends_on: [1.1]
|
|
- [√] 2.2 在 `Terminal.vue` 中实现“贴底优先、上翻保留”的视口恢复逻辑 | depends_on: [2.1]
|
|
|
|
### 3. 验证与同步
|
|
|
|
- [√] 3.1 运行前端最小验证并记录结果 | depends_on: [2.2]
|
|
- [√] 3.2 更新 `.helloagents` 文档与变更记录 | depends_on: [3.1]
|
|
|
|
---
|
|
|
|
## 执行日志
|
|
|
|
| 时间 | 任务 | 状态 | 备注 |
|
|
|------|------|------|------|
|
|
| 2026-03-25 05:47 | 1.1 | 完成 | 创建 implementation 方案包，范围锁定为终端标签切换后的 xterm 视口恢复 |
|
|
| 2026-03-25 05:49 | 2.1 / 2.2 | 完成 | 在 Terminal.vue 中加入视口快照、贴底判断与重激活恢复逻辑，并将 fit/ResizeObserver 路径统一纳入恢复流程 |
|
|
| 2026-03-25 05:51 | 3.1 | 完成 | `npm run build --workspace @nexus-terminal/frontend` 通过 |
|
|
| 2026-03-25 05:52 | 3.2 | 完成 | 更新 frontend 模块文档并准备归档 |
|
|
|
|
---
|
|
|
|
## 执行备注
|
|
|
|
- 本次修复目标是恢复滚动意图，不是简单强制滚到底部。
|
|
- 当前最可能的落点是 `Terminal.vue` 的激活与 `fit()` 逻辑，而非 `TerminalTabBar.vue` 本身。
|
|
- 运行态真实验收仍依赖本地可用的多 SSH 会话现场；本轮以构建验证和代码路径审查为主。
|