离线 Office 编辑器

问题是什么

把 .xlsx / .docx / .pptx 的生成与编辑塞进没有服务器、没有 CDN、没有网络的环境里，难度不在 UI，而在文件往返：你在浏览器里做的修改，必须能被 Excel、Word、PPT 原样读回去，而不是打开后条件格式没了、批注丢了、公式变成了常量。

很多方案直接交给 SheetJS，但它读写 zip/XML 时会静默丢弃不少特性：条件格式、批注、数据验证、图表、冻结窗格、超链接、部分样式。这个技能要解决的就是这些"能写不能读"或"读回来缺一块"的问题。

它怎么工作

核心是单页 + 零后端编辑器：

• 统一入口：Excel 网格、Word 页面、PPT 舞台共享 index.html，各自有 excel.js、word.js、ppt.js。
• 单文件交付：构建脚本把所有库内联进 office-standalone.html（约 5.7 MB），双击即用。
• 单一数据源：内存中只有纯 JS 结构，不是 OOXML。Excel 数据是 ROWS × COLS 二维数组，样式、批注等按 r + ',' + c 键控；条件格式、数据验证、合并单元格按 {r1,c1,r2,c2} 键控。文件格式只是序列化结果。
• OOXML 后处理层：保存时 SheetJS 产出 baseline，injectXxx 函数重写 worksheet、rels、[Content_Types].xml 补回丢失特性；打开时 readXxx 反向解析恢复。

添加新特性流程：

1. 建模：先定内存结构，如 CF 规则为 {r1,c1,r2,c2,type,...}。
2. 渲染：在 renderCell/renderAll 绘制，.cell-input 用 position:relative; z-index:1，浮层用低 z-index 和 pointer-events:none。
3. 导出：写 injectXxx 重写 OOXML 部件，按 CT_Worksheet 子节点顺序接线。
4. 导入：写 readXxx 解析同一部件，接入 openWorkbook，必须 try/catch。
5. 暴露钩子：挂到 window.__excelDeep。
6. 回归测试：写 _excel__test.js，jsdom 加载真实引擎做 save → reopen 断言。
7. 构建 + 冒烟：node build-standalone.js，跑 _standalone_smoke.js。

适用边界

• 不是完整克隆：解决离线编辑与文件往返，不是桌面级排版或计算能力。
• SheetJS 是 baseline：特性必须经 OOXML 后处理层才能往返存活。
• 字符串必须成对转义：公式或文本含 ,、&、" 时，escapeXml/unescapeXml 必须双向映射。
• Buffer 类型有坑：injectXxx 返回 arraybuffer 而非 Blob，只有最后 buildAndSaveBuffer 才包装。
• 测试陷阱：jsdom 锁 ^24；setTimeout 异步要 await；|| -1 会把合法 0 变成 -1。
• 回归强制：每个特性都要 jsdom 测试覆盖完整往返。