From 8c452104e5d7011ce9e7829776f872f026034f62 Mon Sep 17 00:00:00 2001 From: HuanLinOTO Date: Wed, 9 Sep 2026 13:47:05 +0800 Subject: [PATCH] =?UTF-8?q?docs(plans):=20=E7=BB=88=E7=AB=AF=E7=AD=89?= =?UTF-8?q?=E5=BE=85=20banner=20=E5=AE=9E=E6=96=BD=E5=81=8F=E5=B7=AE?= =?UTF-8?q?=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2026-09-09-terminal-wait-banner-design.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/plans/2026-09-09-terminal-wait-banner-design.md b/docs/plans/2026-09-09-terminal-wait-banner-design.md index dd4bfd7..d218705 100644 --- a/docs/plans/2026-09-09-terminal-wait-banner-design.md +++ b/docs/plans/2026-09-09-terminal-wait-banner-design.md @@ -118,3 +118,27 @@ needle 出现 / 超时 / 终端退出。等待期间用户在侧边栏看不到 - 不新增独立 waits WebSocket(方案 B 否决); - 不改 `ctx.betterSidebar` 服务面(`external-plugin-guide.md` 无需同步); - 不做乐观 UI(banner 消失以服务端推送为准)。 + +## 实施偏差记录 + +- **⏳ tab 徽章不走 `TabDescriptor.badge`**:实现时核实该 API 是 type-keyed + (`badge(ctx, scope, state)`,无 tab 参数、external 插件共享),无法定位单个 + tab。改为 Sidebar 壳层 `tabBadgeOf` 的 sidebar-internal 特例(agent: 前缀判断 + + `state.agentWaits` 查表),`service.ts` 与 external-plugin-guide.md 零改动。 +- **banner 抽为独立组件 `TerminalWaitBanner.tsx`**:设计原文写在 TerminalView + 内;抽出后无 xterm 依赖,jsdom 单测可直接渲染(TerminalView 仍负责订阅 store + 并把 onSkip 接到 `api.agentSkipWait`)。 +- **词典同步扩到全部 21 个语言文件**:设计只写了 zh/en/ja,但 + `tests/locales.spec.ts` 断言每个第三方词典与 zh 键集相等——只同步三语会让该 + 守护测试挂掉。按仓库惯例(全语言同步,如 e8761ee)补齐其余 18 语言同两键。 +- **banner 配色**:仓库 CSS 无 state-info 令牌,沿用 `.terminalBanner` 的 warn + 对(`--dsw-alias-state-warn-label/-tertiary`),符合皮肤契约。 +- **设计文档与计划随 feat 分支进 PR**:main 受分支保护,纯文档直推被 hook 拒绝 + (`4a6a77a` / `2448068` 随本分支合并)。 +- **测试断言以文本计数取代 CSS 类名**:CSS module 类名在测试变换下不稳定, + ⏳ 数量断言改从 `textContent` 计数;长 needle 截断断言改为计量 needle 自身 + 贡献字符数(本地化句子包裹 needle,整体长度断言与语言相关,原计划内部矛盾)。 +- **新测试的 localStorage 兜底**:Node 26 + jsdom 29 组合下测试环境可能无全局 + `localStorage`(上游 `bottom-auto-terminal.spec.tsx` 在同环境即失败,属已知 + win32/环境非回归类);新 spec 的 afterEach 加 `typeof localStorage` 守卫, + 上游测试一律未动。