feat(ai): WPS 前后端契约命名双轨迁移（doc_*/editor_command 与 wps_* 并行）

[zeweihan]

概要

Phase 3 遗留项：把 WPS 时代的前后端契约命名迁到新名，双轨并行一个发布周期后再摘旧名（本 PR 只落双轨，不摘旧名）。登记于 docs/AI_ARCHITECTURE.md §编辑器前后端契约。

迁移映射

契约	新名（主）	旧名（双轨保留）
SSE 流式写入事件	doc_stream_data	wps_stream_data
client_action 命令载荷	tool: "editor_command"	tool: "wps_command"
client_action 打开/刷新	doc_open_file / doc_reload_file	wps_open_file / wps_reload_file
同步打开命令	doc_open_file_sync	wps_open_file_sync
结果回调路由	POST /api/ai/agent/editor-result	/wps-result（路由别名）

双轨机制（顺序即契约）

后端对每条指令按新名在前、旧名在后各发一份（SSE 单连接有序）；前端凭"先见新名"置闩锁判定新后端，此后丢弃所有旧名事件。新旧后端 × 新旧前端四种搭配下，每条指令都恰好执行一次。

一并清理的前端零散遗留

• VariablePanel.getWps prop → getEditor
• ChatInterface.vue wps-tip-* / wps-link-text CSS 类 → doc-tip-* / doc-link-text

明确不动（存量数据契约，另立迁移方案）

ProjectFile.wpsFileId（含 DB 列与 API JSON 字段）、存储前缀 wps-files/、write_docx 返回键 wps_file_id、FeatureNotConfiguredException 的 "wps" 标识。

验收（AI_ARCHITECTURE.md 门槛全过）

• ✅ backend mvn test 全绿（JDK 21）
• ✅ frontend npm run check:emits 过
• ✅ Electron 桌面端真机三链路实测（dev Electron + CDP）：
  • AI 打开文档：后端日志 Sent doc_open_file + 编辑器随即拉取文件内容
  • 查找替换修订：editor_command/wps_command 双发各 1 次 → 去重后仅执行 1 次 → 新路由 /editor-result 200 → Completed editor action: success=true
  • 流式写入新文档：doc_open_file_sync 同步打开往返成功，流式产物中验收标记恰好出现一次（若去重失效每个 token 会写两遍）
• ✅ 双 e2e：test:lowa-e2e 33/33，test:app-e2e 29 步全过、0 异常信号

实测中发现的存量问题（与本迁移无关，已建独立任务）

• <tool_code> 文本工具调用的位置参数不映射 → doc_find_replace 收到 null 参数 NPE
• 自动保存疑似在文档未加载完成时用空文档覆盖存量文件

🤖 Generated with Claude Code