Skip to content

RFC(TUI):TUI定稿修改(描述问题,调整方案) #469

@creatang

Description

@creatang

背景

在最近的里程碑演示中,TUI 暴露出若干影响用户体验的问题。为了在最后一个里程碑顺利发布,确保交互稳定流畅,现集中梳理所有已知缺陷、复现场景及解决方案,作为 5 月 1 日前版本冻结的依据。请相关同学认领并协同解决。


问题与解决方案

1. 启动页动态布局失效

问题
规定最小窗口尺寸为 73×36,但在不同操作系统与缩放状态下显示不一致。根本原因是 neocode 图标高度写死,无法随窗口变化自适应。

解决方案
根据窗口实际尺寸动态切换布局:

  • 窗口 ≥ 73×36:完整显示所有界面元素与功能;
  • 窗口 < 73×36:逐步弱化——首先覆盖提示区域,若仍不足,则覆盖(去除)neocode 图标。

2. 补全提示质量较低

问题

  • @ 指令补全列表中混杂无关文件(如 .build 目录内容),且首个选项容易误导用户;
  • / 指令补全未对当前选中的指令进行高亮,视觉反馈不明显。

解决方案

  • @ 补全:移除首个容易混淆的选项,改用模糊匹配文件名,并过滤无关路径(如 .build 等构建目录);
  • / 补全:为当前选中指令添加高亮样式,强化视觉引导。

3. 侧边滑块视觉干扰与渲染缺陷

问题

  • 滑块颜色与主色调一致,厚度过大,喧宾夺主;
  • 渲染过程中偶现断裂,显示为不连续的块状。

解决方案

  • 滑块颜色改为中性灰色,减小视觉厚度;
  • 排查滑块渲染实现,修复断裂问题。

4. 界面设计未收敛与待沟通项

问题
整体界面布局尚未完全达成一致,部分功能设计不够友好。

当前采用的纵向布局(自上而下):

  1. Header(顶部提示区):neocode 图标、模型名称、runtime 传入的工作状态、工作区信息;
  2. 输出区:展示 neocode 与用户的完整交互过程;
  3. 输入区:用户输入区域,以及 neo 权限索要的交互部分;
  4. 状态栏:显示报错信息、工具调用状态等;
  5. 提示栏:展示快捷键及相关操作提示。

需要协同确认的设计点(请在评论中回复):

  • Header 状态内容@pionxe 请明确 runtime 将提供哪些状态字段,用于 Header 展示;
  • 工具调用状态展示@Cai-Tang-www 请确认是仅展示工具调用的最终结果,还是也展示中间调用过程;
  • 提示栏内容:大家认为需要哪些提示?要求尽可能精炼,同时覆盖常用操作。

5. 后台任务缺乏用户介入能力

问题
neo 执行后台调用时,用户无法主动终止任务或插入新命令,完全失去控制。

解决方案
增加用户介入机制,允许在后台任务执行期间主动终止或发送打断命令。


6. Help 快捷键显示异常

问题
当前 help 快捷键触发的界面出现错误(见下图)。

help 快捷键异常截图

解决方案
修复快捷键绑定,直接进入 /help 界面即可,无需额外跳转逻辑。


7. 粘贴处理体验差

问题

  • 部分环境下无法粘贴图片;
  • 粘贴超长文本时,输入框渲染卡顿,严重影响性能。

解决方案

  • 排查并修复图片粘贴功能;
  • 长文本粘贴时不再立即渲染完整内容,改为显示 [paste X line] 占位符,避免性能问题。

8. 渲染

问题

  • 选区复制部分渲染有误;
  • markdown异常渲染。

解决方案

  • 重新对选取复制渲染进行修改;
  • markdown渲染只保留灰色背景,其余无关渲染取消。

预计4月28日完成本issue

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions