AtomCode v5.2.3 新子系统深度分析 — 全新 TUI 界面、WebUI 增强与 CLI 命令体系

基于 strings + 运行时验证（--tui --demo / --tui --audit / --help）+ 打包资源剖析 2026-10-14 前置报告：06-version-diff-v5.0.9-to-v5.2.3.md 姊妹报告：DEEP_ANALYSIS_53（架构重写）、DEEP_ANALYSIS_56（TUI 交互增强与滚动条）

1. 全新 TUI 界面（默认界面）

1.1 运行时验证：`--tui --demo` 完整界面帧

第 1 行：  ❯ fix the build                              ← 输入框（提示文字）
第 3 行：  ⚑ rate limited; waiting 30s (1/5)            ← 限流状态徽标
第 5 行：  ● scout 汇报回来了  点击展开                  ← 子代理行（可点击展开）
第 7 行：  ● Fixed it. 中文也要能画 🙂                    ← 模型消息（中文+emoji 渲染）
第 9 行：  ✻ Done · 0ms · 1 轮 · 2 工具 · 880 tokens · 本轮缓存 33%   ← 回合结束条
第 13 行： ● 看看那个目录                                ← 用户消息
第 15 行： ● $ cd /Users/我的项目/前端… ← 长命令截断           ← bash 工具调用
第 16 行：   · 这是一条足够长的中文结果/…                 ← 工具结果（截断显示）
第 17 行： ● write_file 我的笔记/notes.md → 允许一次     ← 审批收成一行
第 18 行： ● Allow `bash` to run? → 拒绝                ← 审批
第 19 行： ● Add a [telemetry] section, or leave it off? → 拒绝  ← 引导提问
第 22 行： ❯ 再帮我看看 crates/ 的结构                   ← 输入框
第 24 行： replay │ AtomCodeReverseEngineering │ 1.2K tok │ 缓存 33%   ← 状态栏

1.2 界面元素逐一解析

元素	示例	特征
输入框	`❯ fix the build`	底部常驻，提示文字用前景色
限流徽标	`⚑ rate limited; waiting 30s (1/5)`	倒计时 + 重试次数
子代理行	`● scout 汇报回来了点击展开`	可点击展开详情
回合结束条	`✻ Done · 0ms · 1 轮 · 2 工具 · 880 tokens · 本轮缓存 33%`	端到端汇总
审批收行	`● write_file … → 允许一次`	审批后收成一行，可点击展开
工具调用	`● $ cd ...`	bash 命令展示
状态栏	`会话 │ 项目 │ token │ 缓存%`	底部状态
分隔线	`────────────`	输入区与内容区分隔

1.3 新界面 i18n 键（chat.* 体系，v5.2.3 全量）

chat.activeCheckFailed  chat.artifactOpenFailed  chat.artifacts  chat.cancelFailed
chat.chipExplain  chat.chipReview  chat.chipTest  chat.connError  chat.continueHint
chat.continueSession  chat.detachedActive  chat.detachedStopped  chat.error
chat.greeting  chat.incomplete  chat.inputPlaceholder  chat.jumpToBottom
chat.kbdHint  chat.kbdHintMobile  chat.nothing  chat.queue  chat.queued
chat.rateLimited  chat.recoveryBlocked  chat.removeQueued  chat.searchClose
chat.searchNext  chat.searchNoMatch  chat.searchPlaceholder  chat.searchPrev
chat.send  chat.sessionInUse  chat.skillCollapse  chat.skillExpand
chat.startHint  chat.steer  chat.steerBadge  chat.steerPending  chat.steerRecovered
chat.stop

→ 新增 chat.nothing（搜索无结果）、chat.sessionInUse（会话占用提示，对应 SessionInUse 状态）。

1.4 运行时验证：`--tui --audit`（组件注入检查）

· `tui-brand` is provided but nothing injects it
· `tui-mcp-phase` is provided but nothing injects it
· `tui-rasters` is provided but nothing injects it
· `tui-repaint` is provided but nothing injects it
· `tui-team-roster` is provided but nothing injects it
no defects; 5 note(s) above

→ TUI 组件全部通过注入器注册（brand / mcp-phase / rasters / repaint / team-roster）。

1.5 会话与界面状态枚举

SessionInUse / SessionPreview / SessionChanged / SessionTransient / Rewound /
DoneWithNote / Stopped / Unavailable / ProviderUnavailable / Failed /
InvalidWorkingDirectory / OutOfRange / Undo / requested / available /
RewindPointNotFound / CodeRewindUnavailable / Stale / current

→ 会话状态机大幅细化（SessionInUse = 别处打开；DoneWithNote = 带备注完成）。

2. WebUI 增强

2.1 KaTeX 数学公式渲染（v5.2.3 新功能）

59 个 KaTeX 资产嵌入二进制：

assets/KaTeX_AMS-Regular-BQhdFMY1.woff2    assets/KaTeX_AMS-Regular-DMm9YOAa.woff
assets/KaTeX_AMS-Regular-DRggAlZN.ttf      assets/KaTeX_Caligraphic-Bold-ATXxdsX0.ttf
assets/KaTeX_Caligraphic-Bold-BEiXGLvX.woff assets/KaTeX_Caligraphic-Bold-Dq_IR9rO.woff2
assets/KaTeX_Main-Bold-Cx986IdX.woff2      assets/KaTeX_Main-BoldItalic-DxDJ3AOS.woff2
... （AMS / Caligraphic / Fraktur / Main / Math / SansSerif / Script / Size1-4 / Typewriter 全字族）

渲染配置（从打包 JS 还原）：

katex / KaTeX / throwOnError / displayMode / formula / math rendering

→ 支持行内与块级 TeX 公式；代码和货币文本保持原样；无法渲染的公式保留原始文本。

2.2 `/webui` 参数（v5.2.3 生效）

--port `PORT`   端口（默认 13457，刻意错开 VSCode 守护进程的 13456，避免抢端口导致扩展 401/无响应）
--host `HOST`   绑定地址（默认 127.0.0.1；0.0.0.0 暴露到局域网/外网，仅 token 保护、无 TLS）
--no-open       不自动打开浏览器（脚本/桌面客户端集成场景）
端口被占用时自动顺延探测（Windows 保留范围 10013 也顺延）

2.3 WebUI 新 UI 面（从打包 JS 还原）

chat.kbdHint / chat.kbdHintMobile / chat.skillExpand / chat.skillCollapse
user-message-bubble / is-markdown / msg-time-user
input-hint / stats.counts / stats.duration / stats.cacheHit / stats.tokens

会话侧栏计数一致：项目侧栏计数与展开列表共用可见性规则，闲置空会话不再计数， fork 分支只计一次；添加工作区时复用已打开的会话。

WebUI 新结构体（SessionDetail 侧）：

SessionDetail / TurnStats / Backgrounded / BackgroundSessions / BackgroundQuestion
UsageStats / Entitlement / ModelChoice / UsageWindow / McpServerDetail /
McpServerStatus / RewindPoint / CatalogTool / SessionSummary / TurnStat

3. CLI 命令体系扩展

3.1 新子命令（运行时验证 `--help`）

login / logout / status / resume / upgrade / rollback / review / mcp / daemon /
webui / telemetry / plugin / uninstall / setup / hooks / schedule / completion

子命令	新选项
`review`	`--base` BASE（git range）、`--staged`、`--pr `PR、`--diff-file` FILE``（stdin 支持任何 forge）、`--repo`、`--model`、`--api-key`
`rollback`	回退到上一个版本（与 .bak 交换）
`mcp`	`add-github-oauth`、`login`、`logout`
`telemetry`	`recover`（Recover legacy .partial files）
`schedule`	`add/list/remove/enable/disable/sync`
`daemon`	`--port`（默认 13456）、`--client`、`--idle-timeout`（默认 1800）、`--no-auth`
`webui`	`--port`（13457）、`--host`、`--no-open`

3.2 新 CLI 顶层选项

--tui / --classic / --probe-terminal / --no-mouse / --audit / --demo / --mascot / --theme
--ephemeral（headless only：Run without creating, resuming, or writing session state）
--no-tools（headless only：Expose no tools, MCP servers, skills tools, or child-agent tools）
--output-format text|jsonl（Headless stdout format: assistant text or versioned JSON Lines）
--seed-config `PATH`（FIRST-RUN ONLY: seed the user's config from this file）

3.3 新斜杠命令（v5.2.3 全量）

/audit /background(/bg) /capabilities /cd /changelog /codingplan /compact /config
/context /copy /copy code /cost /datalog /goal /health /issues /live /local /login
/look /loop 5m /mcp /memory /mode /model /notes /onboarding /openrouter /plugin
/provider /proxy /quit /rename /repos /responses /resume /review /rewind /rewind purge
/rustc /save /schedule /setup /signed /skills /status /sync /sys /todo add /todo clear
/token /toolbox /um /upgrade /usr /view /webui --port /worklog /worktree /raw

3.4 命令功能速查

命令	功能
`/cost`	按模型分列 token 账单
`/copy` / `/copy code [N\|all]`	默认复制最后一条回复全文 / 代码块
`/raw`	整段对话输出到终端自己的屏幕（方便跨屏选择）
`/loop 5m`	固定间隔循环执行
`/worktree`	新建独立工作副本并切换
`/changelog`	面板查看各版本更新（概览 + Issues 两页签）
`/worklog`	跨项目每日工作复盘
`/memory`	完整查看全局/项目/本地记忆（可换行、滚动、翻页）
`/todo add`、`/todo clear`	直接修改计划
`/rewind purge`	手动清理回滚存储
`/bg <任务>`	会话放后台继续跑
`/openrouter [key]`	OpenRouter 一键接入

3.5 快捷键体系（v5.2.3）

Ctrl+O   展开/隐藏已收到的实时思考（展开时保持底部跟随）
Ctrl+T   展开档连同已答审批一起展开
Ctrl+B   中断当前轮并让排队输入立刻执行
Ctrl+X   中断当前回合并立即发出排队消息
Ctrl+R   搜索本项目的输入历史
Ctrl+D ×2 删除会话（/resume 中）
F2 / Shift+F2  快速切换模型
Esc      模型未回复时撤回话 / 取消连接流程
Ctrl+Z   挂起回到 shell

4. 界面状态与权限可视化

4.1 审批可视化三态

● write_file 我的笔记/notes.md → 允许一次      （点击展开详情）
● Allow `bash` to run? → 拒绝
● Add a [telemetry] section, or leave it off? → 拒绝

→ 新 TUI 在屏幕内直接完成审批（无需 yolo 模式即可真实使用）。审批答完后默认收成一行。

4.2 allow-all-bash 危险选项

allow_all_bash / struct ApprovalRequest with 5 elements
'总是允许所有 Bash' 审批选项：会话内对前后台 Bash 一致生效

4.3 状态栏

replay │ AtomCodeReverseEngineering │ 1.2K tok │ 缓存 33%

→ 会话名 │ 项目名 │ token 用量 │ 缓存命中率。背景会话在跑时显示数量。

5. 运行时验证记录

命令	结果
`--tui --demo`	渲染完整界面帧（输入框/限流/子代理/回合条/审批/状态栏）
`--tui --audit`	`no defects; 5 note(s) above`（5 个注入器未消费）
`--probe-terminal`	提示需在真实终端运行（不能重定向）
`--help`	完整列出 15 个子命令 + 33 个顶层选项
`daemon --no-auth`	health 端点返回 `{"status":"ok","version":"5.2.3","capabilities":["goal","session_scoped_live"]}`
`webui --help`	`--port 13457 / --host 127.0.0.1 / --no-open`

6. 相关配置项

[ui] screen = "classic"|auto&nbsp;&nbsp;&nbsp;&nbsp; [ui] theme = auto|dark|light
[ui] auto_copy_code_blocks / ai_session_naming / whats_new / terminal_status_glyph
[ui] mode_switch_key / mouse / no_mouse / scrollbar / recap / rewind

AtomCode v5.2.3 新子系统深度分析 — 全新 TUI 界面、WebUI 增强与 CLI 命令体系 ​

1. 全新 TUI 界面（默认界面） ​

1.1 运行时验证：--tui --demo 完整界面帧 ​

1.2 界面元素逐一解析 ​

1.3 新界面 i18n 键（chat.* 体系，v5.2.3 全量） ​

1.4 运行时验证：--tui --audit（组件注入检查） ​

1.5 会话与界面状态枚举 ​

2. WebUI 增强 ​

2.1 KaTeX 数学公式渲染（v5.2.3 新功能） ​

2.2 /webui 参数（v5.2.3 生效） ​

2.3 WebUI 新 UI 面（从打包 JS 还原） ​

3. CLI 命令体系扩展 ​

3.1 新子命令（运行时验证 --help） ​

3.2 新 CLI 顶层选项 ​

3.3 新斜杠命令（v5.2.3 全量） ​

3.4 命令功能速查 ​

3.5 快捷键体系（v5.2.3） ​

4. 界面状态与权限可视化 ​

4.1 审批可视化三态 ​

4.2 allow-all-bash 危险选项 ​

4.3 状态栏 ​

5. 运行时验证记录 ​

6. 相关配置项 ​