1.3 KiB
1.3 KiB
Webterm 配置与受控部署
- 唯一配置来源:
config/platform-infra/webterm.yaml是端口、自动标签、启动模式、浏览器历史和输出聚合策略的 owning YAML;build/docker-compose.<port>.yaml是受控 CLI 渲染产物,禁止手工维护或在部署后恢复旧内容。
- 受控入口:
- 预览使用
bun scripts/cli.ts platform-infra webterm plan --target <target>; - 部署使用
bun scripts/cli.ts platform-infra webterm apply --target <target> --confirm; - 收口使用同一入口的
status与validate。
- 预览使用
- 浏览器历史策略:
browserTerminalHistory.desktopScrollbackLines控制桌面端 xterm 历史行数;browserTerminalHistory.mobileScrollbackLines控制移动端 xterm 历史行数;browserTerminalHistory.mobileMaxWidthPx与粗指针特征共同决定移动端策略;- 视口类型变化后,已有终端必须同步新上限并截断超出上限的旧行。
- 输出聚合策略:
browserOutputPolicy.maxFramesPerSecond是每个浏览器连接、每个终端的最大输出消息频率;browserOutputPolicy.maxFrameBytes是单条聚合输出消息的字节上限;- 后端必须按终端独立排队,小数据在频率窗口内合并,积压数据按窗口顺序发送,禁止用字节阈值绕过频率上限。