Nexus/docs/reports/2026-06-13-terminal-quick-cmd-enter-verification.md

终端快捷命令回车修复 — 验证报告

日期: 2026-06-13
变更: formatQuickCmdForSend + execQuickCmd 发送时追加 \r

验证结果

项	命令/方式	结果
前端构建	cd frontend && npm run build	PASS（5.37s，含 TerminalPage-*.js）
本地门控	bash scripts/local_verify.sh	PASS（26/26 API smoke + ruff）
发送逻辑单测	Node/Python 镜像 formatQuickCmdForSend	PASS（含 trim() 剥 \r 后仍能补回）
API 集成	pytest tests/test_terminal_quick_commands.py	PASS
浏览器 E2E（WebSSH 点击执行）	未执行	SKIP — 需已登录 + 可 SSH 子机

根因复现（已确认）

'ls\r'.trim()  // => 'ls'  （\r 被当作空白剥掉）

修复后：formatQuickCmdForSend('ls') => 'ls\r'，与命令栏 sendCmd 行为一致。

手动终验（部署后）

1. 设置 → 终端快捷命令 → 添加 echo hello，保存。
2. 终端页连接子机 → 点击该快捷命令。
3. 预期：输出 hello 并回到新提示符（非悬停在输入行）。

备注

• 内置命令 DB 中可能仍带 \r；formatQuickCmdForSend 先去尾再追加，幂等安全。
• 仅前端变更；部署 web/app/ 即可，无需重启后端。