用途:log-update 用于在终端中覆盖上一次输出,实现原地更新的日志渲染,常用于进度条、动画等需要连续刷新的界面。当前版本 7.2.0。
主要能力:核心 logUpdate() 原地更新输出;v7.0.0 新增 persist(...text) 方法,将内容写入终端滚动历史(类似 console.log),不会被后续更新覆盖;v7.1.0+ 提供局部/同步渲染,更新大量输出时减少闪烁;正确处理含 ANSI 转义序列的彩色文本(如 chalk/yoctocolors)的换行宽度;提供 logUpdateStderr 用于错误与警告,分离 stdout 与 stderr。
版本与 API 变更:v7.0.0 将 Node.js 最低要求从 18 提升到 20;新增 persist(...text)、defaultWidth(默认 80)、defaultHeight(默认 24)选项;v7.0.1–v7.0.2 修复尾部换行处理。依赖包括 ansi-escapes@^7.3.0、cli-cursor@^5.0.0、slice-ansi@^8.0.0、strip-ansi@^7.2.0、wrap-ansi@^10.0.0。
使用方式与最佳实践:开始新日志会话前先调用 .done(),避免滚动历史被污染;CLI 接收输入或显示提示时应设置 showCursor: true;输出被管道、重定向或运行于非 TTY 环境时设置 defaultWidth 与 defaultHeight,否则默认按 80x24 处理导致换行与擦除错误;通过 createLogUpdate(stream) 为每个独立更新上下文创建单独实例,避免相互覆盖;可使用 skilld search "query" -p log-update 检索,运行 skilld search --guide -p log-update 查看语法、过滤与操作符。
限制:只能擦除和重写当前终端视口内可见的行,已进入滚动历史的内容无法操作,极长输出会溢出;连续多个尾部空行在渲染优化时可能合并为单个空行,不应依赖空行的精确保留。其它平台、收费与价格信息暂未提供。