The banner returns, borderless
横幅回归，无边框
An intermediate no-banner design removed the boxed startup banner: it deleted `HeaderComponent` and its sweep, moved the model into the footer, dropped the session id, and rendered `welcome` as the transcript's first line. The user's verdict reversed that: bring the banner back — "just remove the border". The four-row box frame was the objectionable chrome, not the identifying facts it carried (model, session id) nor
English
Problem
An intermediate no-banner design removed the boxed startup banner: it deleted HeaderComponent and its sweep, moved the model into the footer, dropped the session id, and rendered welcome as the transcript's first line. The user's verdict reversed that: bring the banner back — "just remove the border". The four-row box frame was the objectionable chrome, not the identifying facts it carried (model, session id) nor the sweep-in motion.
Decision
HeaderComponentand its left-to-right sweep return, but render borderless: no╭─╮/╰─╯corners and no│side bars. Each line is a single leading space plustruncateToWidth-clipped content, so the sweep's width clip can never tear an escape sequence and no fixed frame is drawn. The reveal advances through about 24 frames at 15 ms each.- The header carries the title (
DEEPSEEK HARNESS), a<model> • <session-id>detail line, and — whenwelcomeis set — a muted subtitle. Withwelcomeunset the header is title + detail only: there is no fixed or random slogan. - The model also stays in the footer's left segment, so the driving model remains glanceable after the transient banner scrolls out of view.
welcomereverts to a banner subtitle; the transcript-first-line notice is removed fromrebuildTranscript.- The sweep animates only when
welcomeis unset. A configuredwelcomerenders the whole banner immediately, keeping fixtures and snapshots frame-deterministic. The sweep starts afterui.start()succeeds and is cleared through the samedetachListenerspath viastopBannerReveal, which also resets the clip so a header disposed mid-sweep re-renders whole.
This note owns the current result of the discarded startup variants: random slogans with a per-character typewriter, a boxed whole-banner sweep, and no banner. The example composition does not set welcome; deployments and deterministic fixtures may still provide one. The model's persistent footer home from the no-banner variant remains.
Alternatives considered
Keep the box but thin it or use lighter glyphs. Rejected: the instruction was "just remove the border"; any surrounding glyph is the frame chrome the user objected to.
Keep a random or fixed slogan when welcome is unset. Rejected because repeated flavor copy becomes wallpaper and the per-character reveal was slow while animating only one line. An unset welcome therefore produces no subtitle, and the whole banner supplies the startup motion.
Remove the banner entirely. Rejected because the persistent footer is a good home for the model but not for the full identifying detail, while putting welcome in the transcript makes presentation configuration behave like conversation content.
Reveal the banner top-down. Rejected because four row-sized steps read as a flicker. The horizontal width clip uses the terminal span for smooth motion and reuses the ANSI-aware truncation path.
Drop the model from the footer now that the banner shows it again. Rejected: the banner is transient and scrolls away with the transcript, while the footer keeps the model visible for the whole session; that persistent location is deliberately preserved.
Leave the session id out of the banner. Rejected: with the box gone the detail line costs one row, and the user asked for the banner "as before", which carried model • session-id.
Consequences
- Boot output with
welcomeunset is animation-dependent again (the sweep); configured welcomes stay frame-deterministic, so every snapshot and scripted fixture keeps a fixed subtitle. - The demo no longer supplies instructional welcome filler; an unset
welcomemeans a subtitle-free banner, while the config remains the deterministic escape hatch for deployments and fixtures. - The model now appears twice at boot — banner detail and footer — intended redundancy: the banner is transient, the footer persistent.
/clearempties the transcript but not the header, so the banner and its configured subtitle survive/clear, unlike a transcript-based welcome line.- All pi-tui terminal snapshots and the examples/tui-agent replay snapshots re-recorded (
test:snapshot:refresh): banner rows return with no box glyphs; footer rows keep the model prefix. - Anything that anchored on banner absence re-anchors on its presence: the PTY smoke boots on the detail line's
main-session-id (revealed late in the sweep) and assertsDEEPSEEK/HARNESSpresent with no box corners.
Testing
packages/ui/tui/tests/tui.spec.ts pins: the borderless banner sweeps to natural completion — no box corners, title and main-session detail present — with at least one clipped mid-sweep frame; a configured welcome renders the whole banner with no clipped frame; the unset-welcome banner has no subtitle; and dispose clears the sweep interval mid-sweep. Independent color-scheme cases cover reported light/dark transitions, a same-scheme no-op, and a terminal that throws on the DSR query write; applyColorScheme relies on setStatus to rederive the editor border instead of repeating the dead assignment that had broken per-file coverage. The tui-agent and dsh-CLI PTY smokes boot on the main-session- detail marker and assert no box corners. Snapshots verify the full frames.
中文
Problem
一个中间的无横幅设计删掉了带框的启动横幅：它删除了 HeaderComponent 及其扫入动画，把模型移入页脚，丢弃了会话 id，并把 welcome 渲染为 transcript 的第一行。用户的裁决把这一切反转：把横幅拿回来——"just remove the border"。令人反感的装饰是那四行盒子边框，而不是它承载的识别信息（模型、会话 id），也不是扫入动效。
Decision
HeaderComponent及其从左到右的扫入动画回归，但以无边框方式渲染：没有╭─╮/╰─╯边角，也没有│侧边。每一行都是一个前导空格加上经truncateToWidth裁剪的内容，因此扫入的宽度裁剪永远不会撕裂转义序列，也不绘制任何固定边框。扫入大约经过 24 帧完成，每帧间隔 15 ms。- 头部承载标题（
DEEPSEEK HARNESS）、一条<model> • <session-id>详情行，以及——当设置了welcome时——一条弱化的副标题。welcome未设置时头部只有标题加详情：不含固定或随机标语。 - 模型同时保留在页脚的左段，因此在短暂的横幅滚出视野后，会话使用的模型仍可一瞥可见。
welcome恢复为横幅副标题；transcript 第一行的通知从rebuildTranscript中移除。- 仅当
welcome未设置时才播放扫入动画。配置了welcome会立即渲染整个横幅，使 fixture 和快照保持帧确定性。扫入在ui.start()成功后启动，并经与之前相同的detachListeners路径通过stopBannerReveal清理；后者还会重置裁剪，使扫入中途被销毁的头部重新完整渲染。
本 Agent Note 统一记录几种已弃用启动方案的当前结论：带逐字打字机效果的随机标语、带边框的整幅横幅扫入动画，以及完全移除横幅。示例组装不设置 welcome；部署和确定性 fixture 仍可提供该值。无横幅方案为模型设置的常驻页脚位置继续保留。
Alternatives considered
保留盒子但做细或改用更轻的字符。 否决：指令是 "just remove the border"；任何环绕的字符都是用户所反对的边框装饰。
在未设置 welcome 时保留随机或固定标语。 否决：反复出现的氛围文案很快失去信息价值，而逐字揭示仅为一行制作动画，速度又慢。因此，未设置 welcome 时不显示副标题，由整个横幅提供启动动效。
完全移除横幅。 否决：常驻页脚很适合显示模型，却无法承载完整识别详情；把 welcome 放入 transcript 还会使展示配置表现成对话内容。
自上而下揭示横幅。 否决：按四行分成四步看起来像闪烁。横向宽度裁剪利用终端横向空间实现平滑动效，并复用 ANSI 感知的截断路径。
既然横幅重新显示模型，就把模型从页脚移除。 否决：横幅是短暂的，会随 transcript 滚走，而页脚在整个会话中保持模型可见；这个常驻位置被刻意保留。
将会话 id 留在横幅之外。 否决：盒子去掉后详情行只占一行，且用户要求横幅"和以前一样"，而以前它承载 model • session-id。
Consequences
welcome未设置时的启动输出再次依赖动画（扫入）；配置了欢迎语则保持帧确定性，因此每个快照和脚本 fixture 都保留一个固定副标题。- demo 不再提供教学性质的欢迎填充文案；
welcome未设置就表示横幅没有副标题，而该配置仍是部署和 fixture 获得确定性输出的配置手段。 - 模型现在在启动时出现两次——横幅详情与页脚——这是有意的冗余：横幅短暂，页脚常驻。
/clear清空 transcript 但不清头部，因此横幅及其配置的副标题在/clear后存活，不同于基于 transcript 的欢迎行。- 全部 pi-tui 终端快照与 examples/tui-agent 回放快照重新录制（
test:snapshot:refresh）：横幅行以无盒子字符方式回归；页脚行保留模型前缀。 - 一切锚定横幅缺失的内容改为锚定其存在：PTY 冒烟测试以详情行的
main-session-id 为启动标记（它在扫入后段才被揭示），并断言DEEPSEEK/HARNESS出现且无盒子角。
Testing
packages/ui/tui/tests/tui.spec.ts 固定：无边框横幅扫入至自然完成——无盒子角、标题与 main-session 详情出现——且至少有一帧扫入中途被裁剪；配置的 welcome 完整渲染横幅且无裁剪帧；未设置 welcome 的横幅无副标题；销毁会在扫入中途清掉扫入定时器。独立的配色方案用例覆盖终端报告的浅色/深色转换、相同方案下的空操作，以及写入 DSR 查询时抛出异常的终端；applyColorScheme 依靠 setStatus 重新推导编辑器边框，而不再重复那个导致逐文件覆盖率未达标的无效赋值。tui-agent 与 dsh CLI 的 PTY 冒烟测试以 main-session- 详情标记为启动标记并断言无盒子角。快照验证完整帧。