Nexus/docs/changelog/2026-06-02-file-editor-usability-fix.md

2026-06-02 文件编辑器可用性加固

变更摘要

修复生产环境编辑器仍卡顿/空白/树不可用：Monaco 挂载时序、shallowRef 标签页、输入防抖同步、同步加载 Workbench、等待 ref 就绪。

动机

用户反馈 /#/files?server_id=8&path=... 下编辑器仍无法正常使用。排查：按键时全量 getValue()、Teleport 首帧 0 高、defineAsyncComponent 导致 openFile 时 ref 未就绪、Monaco 可能遮挡侧栏。

涉及文件

• frontend/src/components/FileEditorWorkbench.vue
• frontend/src/pages/FilesPage.vue
• frontend/src/composables/files/useFilesEditor.ts
• frontend/src/components/FileDirectoryTree.vue

是否需迁移/重启

• 仅前端部署；部署后 Ctrl+F5。

验证方式

1. 打开文件管理 → 双击编辑 → 编辑器有内容、可输入、不冻结。
2. 左侧目录树可展开/点击导航。
3. 保存、切换标签、自动换行正常。

回滚方式

还原上述文件至上一版构建。