# 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. 保存、切换标签、自动换行正常。

## 回滚方式

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