Nexus/docs/audit/2026-06-02-file-editor-encoding-session.md

审计：文件编辑器修复 + 编码/EOL 深挖（2026-06-02）

审计信息

项	内容
日期	2026-06-02
审计人	Cursor Agent
触发	文件页编辑卡死 + Windows/Ubuntu CRLF 深挖

审计范围

文件	状态
frontend/src/pages/FilesPage.vue	☑
frontend/src/utils/remotePath.ts	☑
frontend/src/components/FileEditorWorkbench.vue	☑
frontend/src/components/files/FilesList.vue	☑
frontend/src/composables/files/useFilesPage.ts	☑
frontend/src/monaco/preloadMonaco.ts	☑
server/utils/text_io.py	☑
server/api/install.py	☑
server/api/sync_v2.py	☑
scripts/sync_mysql_mcp_env.py	☑
scripts/check_text_eol.py	☑
deploy/check_shell_eol.sh	☑
deploy/pre_deploy_check.sh	☑

Step 3 — 规则扫描 H

H	扫描结果
H1 注入	remotePath/posix_paths 路径归一；无用户输入进 shell
H2 认证	业务 API 仍经 JWT；install 仅安装模式
H3 密钥泄露	text_io 不写日志；install 不写明文密码到日志
H4 静默失败	FileEditorWorkbench.openFile try/catch + snackbar
H5 Ref 类型	storeToRefs + coercePathString 防御
H6 EOL	write_utf8_lf 强制 LF；门控扫 Git 索引

Step 4 — Closure

H	判定	依据
H1	PASS	路径工具未拼接 shell
H2	PASS	未改 auth 中间件
H3	PASS	无新增 secret 输出
H4	PASS	编辑器错误可见
H5	FIXED	FilesPage Ref 解包
H6	PASS	check_text_eol.py OK + test_text_io 5 passed

Step 5 — 入口表

入口	类型	说明
FilesPage 编辑按钮	UI	→ openFile
POST /api/sync/v2/read-file	HTTP	detect_text_eol
POST /api/install/*	HTTP	安装模式写 .env/脚本
scripts/sync_mysql_mcp_env.py	CLI	写 .env MCP 块

Step 6 — 输入 → Sink

流	Sink	控制
远程路径字符串	SSH read/write	JWT + server_id 校验（既有）
安装表单	磁盘 .env	write_utf8_lf
Git 跟踪文件	bash 执行	check_shell_eol / check_text_eol

Step 7 — 归类

FilesPage.vue              38行  2H  0FINDING
remotePath.ts              ~80行  1H  0FINDING
FileEditorWorkbench.vue   ~400行  2H  0FINDING
text_io.py                 ~90行  1H  0FINDING
install.py (diff区)        ~30行  1H  0FINDING
────────────────────────────────────────────
总计                       7H   0FINDING

Step 8 — DoD

• pytest tests/test_text_io.py 通过
• python scripts/check_text_eol.py 通过
• bash deploy/check_shell_eol.sh 通过（LF 修复后）
• vite build 成功 → index-DBKIQT7H.js
• 生产 /health ok，/app/ 200
• changelog 已写（编辑器 + 编码深挖）

FINDING

无（0 FINDING）

结论

☑ 审计通过，可部署。生产已上传前端包与 text_io/install/sync 相关后端文件并重启 nexus。