147、【Agent】【OpenCode】启动分析（ANSI DEC）
【声明】本博客所有内容均为个人业余时间创作，所述技术案例均来自公开开源项目（如Github，Apache基金会），不涉及任何企业机密或未公开技术，如有侵权请联系删除
标题
147、【Agent】【OpenCode】启动分析（ANSI DEC）
背景
上篇 blog
【Agent】【OpenCode】启动分析（SGR 参数）
分析了 ANSI 序列中\x1b[38;5;214m这里的三个数字位置是严格固定的，由 ISO/IEC 6429（即 ANSI X3.64 / ECMA-48）国际标准定义，是终端模拟器解析 SGR 序列时必须遵守的语法规范，其中 SO/IEC 6429 和 ECMA-48 本质上是同一份标准的不同发布版本，其中 ISO 官方标准是付费文档，而 ECMA-48 是免费公开的，接着分析了\x1b[38;5;214m是一个复合参数序列，三个数字各自占据不可交换的语义槽位，如果位置错乱的话，跳过或调换任何一步，解析就会失败，或产生完全不同的效果，第一个参数决定做什么，而第二个参数（仅当第一个是 38/48/58 时存在）决定用什么颜色空间，这种多层设计是历史演进的结果，下面继续分析
OpenCode
OK，接着看这里的\x1b[?25l和\x1b[?25h
这两个序列属于 ANSI 转义序列中的 DEC 私有模式（DEC Private Mode），专门用于控制终端光标的显示与隐藏，它们不是 SGR 指令（不以m结尾），而是以?开头，以h/l结尾的模式切换指令
首先是\x1b[?25l（隐藏光标）
| 片段 | 含义 | 说明 |
|---|---|---|
\x1b[ | CSI 引导符 | 控制序列起始标志 |
? | DEC 私有模式标识 | 表示接下来的参数是 DEC 私有扩展，而非标准 ECMA-48 参数 |
| 25 | 模式编号 | DEC 内部定义的光标可见性模式 |
l | Reset / Disable | 关闭该模式，小写L，代表 low |
接着是\x1b[?25h（显式光标）
| 片段 | 含义 | 说明 |
|---|---|---|
\x1b[ | CSI 引导符 | 同上 |
? | DEC 私有模式标识 | 同上 |
| 25 | 模式编号 | 同上 |
h | Set / Enable | 开启该模式（代表 high） |
这里h和l的记忆技巧：h = High / Show，l = Low / Hide，这对助记符适用于所有的 DEC 私有米寿
这里进度条之所以要隐藏光标，是因为进度条会通过\r不断原地刷新同一行，如果光标保持可见，会出现两个严重的视觉问题
- 光标闪烁干扰：每次
\r覆盖写入时，光标会在进度条末尾快速跳动闪烁，产生刺眼的视觉噪声 - 残影风险：在某些终端中，光标所在位置的字符可能被终端渲染引擎特殊处理（比如反显），导致进度条某个字符颜色异常
隐藏光标后，整个进度条区域变成纯粹的文本渲染，刷新过程干净流畅，迁移完成后立即恢复光标，确保用户后续交互不受影响
下面是进度条的完整生命周期
\x1b[?25l ← 进入进度条前：隐藏光标 ↓ \r${bar}${pct}%← 循环刷新进度条（无光标干扰） ↓ \n ← 进度完成：换行 ↓ \x1b[?25h ← finally 块中：恢复光标（无论成功还是失败都会执行）这里\x1b[?25h被放在 finally 块中，这是关键的防御性编程，即使 JsonMigration.run 抛出异常，光标也一定会恢复，如果把恢复逻辑写在 try 块内，异常则会导致光标永久消失，用户的终端将处于不可用状态
另外，25 只是众多 DEC 私有模式之一，下面是终端编程中常用的几个 DEC 模式
| 模式号 | h（开启） | l（关闭） | 用途 |
|---|---|---|---|
| 25 | 显示光标 | 隐藏光标 | OpenCode 这里用的 |
| 1049 | 进入备用屏幕缓冲区 | 返回主屏幕 | vim / less 等全屏程序使用 |
| 2004 | 启用粘贴括号模式 | 禁用粘贴括号模式 | 防止粘贴内容被误执行 |
| 1000 | 启用鼠标追踪 | 禁用鼠标追踪 | TUI 应用接收鼠标事件 |
| 7 | 启用自动换行 | 禁用自动换行 | 控制行尾行为 |
关于 SEC 私有模式，目前没有一个统一，现存的官方标准文档，主要是因为 DEC（Digital Equipment Corporation）公司已经在 1998 年被 Compaq 收购，后并入 HP，原始硬件手册早已停止维护，且未整体数字化公开，目前业界公认的的权威文档可参考 XTerm Control Sequences
- 网址：https://invisible-island.net/xterm/ctlseqs/ctlseqs.html
- 说明：由 xterm 维护者 Thomas Dickey 持续更新至今，由于现代终端模拟器几乎都以 xterm 为兼容基准，这份文档实际上取代了 DEC 原始手册的地位
- 查阅方式：比如可以搜索
DEC Private Mode
与 SGR 的核心区别
| 特征 | SGR | DEC |
|---|---|---|
| 控制对象 | 文本样式（颜色，粗体，暗淡） | 终端行为（光标，屏幕，鼠标） |
| 终止符 | m | h / l |
| 参数前缀 | 无 | ? |
| 状态特性 | 属性叠加，可组合 | 开关式，非开即关 |
| 标准来源 | ECMA-48 / ISO 6429 | DEC VT100 硬件文档（事实标准） |
OK，本篇先到这里，如有疑问，欢迎评论区留言讨论，祝各位功力大涨，技术更上一层楼！！！更多内容见下篇 blog
【Agent】【OpenCode】启动分析（stderr）