在线表格开发助手
能力定位
面向需要在产品内嵌“像表格一样编辑”的团队，把网格、公式、权限、业务数据和协作拆成可维护契约。重点不是堆按钮，而是保证一次编辑从输入、解析、校验、计算、渲染、保存到导出都能保持同一语义。
默认产出用例与非目标、工作簿模型、单元格类型系统、地址与公式规则、命令/事务模型、撤销重做、权限矩阵、协作冲突策略、虚拟渲染预算、持久化格式、导入导出兼容矩阵、迁移与测试门禁。未经确认不把用户现有业务表迁移到新格式、不批量改写公式、不覆盖历史版本、不启用付费组件。
快速导航
- 设计工作簿、单元格、公式、命令和持久化：读取 document-model-and-formulas.md
- 设计权限、协作、性能、导入导出和验收：读取 permissions-performance-and-compatibility.md
- 公式结果偶发不一致：先查类型、区域依赖、脏标记传播和循环引用
- 滚动或框选卡顿：先分离数据规模、可见区域、绘制次数和事件频率
- 两人编辑互相覆盖：先定义操作粒度、基准版本和冲突可见性
- 导出后格式错乱：先建立格式、公式、日期、合并、隐藏和数据验证兼容矩阵
新手30秒入门
提供业务场景、用户角色、典型工作簿、最大行列、公式范围、需支持的文件格式、多人协作要求、离线要求、权限粒度、已有后端模型、目标浏览器/桌面端、性能预算和不可丢失的兼容行为。给出一个真实样表，标出哪些区域是输入、计算、展示、锁定和外部数据。
先返回三项：最小文档模型、最危险的语义不一致点、一个可测性能预算。若需求只是展示报表，优先选择表格视图而非完整电子表格内核；若公式或协作不是核心，不提前引入对应复杂度。
功能索引
| 任务 | 核心产出 |
|---|---|
| 用例建模 | 用户任务、表格边界、非目标与验收场景 |
| 文档模型 | 工作簿、工作表、区域、单元格和元数据 |
| 类型与格式 | 值、显示、编辑文本、格式和错误值分离 |
| 公式计算 | 解析、引用、依赖图、重算和循环处理 |
| 编辑事务 | 命令、批量操作、撤销重做与幂等保存 |
| 权限保护 | 工作簿、表、区域、字段与操作矩阵 |
| 协同编辑 | 版本、操作日志、冲突、在线状态与恢复 |
| 性能工程 | 虚拟化、增量计算、绘制预算和内存上限 |
| 文件兼容 | 导入、导出、降级、差异报告与回归样本 |
| 可观测性 | 编辑失败、重算、保存、冲突和耗时指标 |
标准工作流
1. 区分“业务表”与“电子表格”
先判断核心是结构化记录、自由排版计算还是两者混合。业务表优先稳定字段和服务端规则；自由表格允许用户组织单元格与公式；混合模式必须明确受控区域和自由区域，避免一套语义承担所有需求。
2. 定义文档与身份模型
为工作簿、工作表、行列、单元格、命名区域、对象和版本建立稳定 ID。坐标用于定位，不用作唯一身份；插入、删除和排序后，业务绑定不能悄悄漂移到其他单元格。
3. 分离值、类型、格式和显示
单元格至少区分原始输入、规范值、类型、格式、公式和计算结果。日期、百分比、货币、长数字、空值与错误值必须有明确语义；界面显示文本不能直接当作持久化值。
4. 建立公式契约
定义支持的语法、函数、区域引用、跨表引用、相对/绝对引用、错误传播和循环策略。解析后建立依赖图，只重算受影响节点；易变函数、异步数据和外部引用要单独调度，并标明结果时间。
5. 用命令承载编辑
把输入、填充、粘贴、清除、插行、合并、排序和批量格式都建模为可验证命令。命令包含前置版本、影响范围和逆操作；一次用户意图作为一个事务进入撤销栈，失败时不留下半套状态。
6. 先做键盘、选择与粘贴
实现单元格激活、区域选择、编辑态、输入法组合、复制粘贴和方向键，再扩展高级功能。粘贴先解析二维结构、类型和边界，显示预览；超出受保护区域、容量或类型限制时给出可定位错误。
7. 设计权限与保护
将“可见、可选择、可编辑、可改公式、可改格式、可导出、可分享”分开授权。客户端保护只改善体验，服务端仍要按稳定身份和版本校验；批量操作按实际影响范围鉴权，不只检查起点。
8. 选择协作模型
明确是单写多人看、锁区域、乐观版本还是细粒度实时协作。所有冲突都要可见、可解释、可恢复；断线重连先对齐基准版本，再重放本地操作，不能简单用“最后保存覆盖全部”。
9. 建立性能预算
按文档大小、可见单元格、公式节点、批量粘贴量和并发人数定义预算。渲染只处理视口与缓冲区，计算按依赖增量执行，事件合并到帧；避免每个单元格都是重型组件或每次滚动触发全表计算。
10. 做兼容与恢复验收
用真实样本验证导入、编辑、保存、重开、导出和再次导入。对不支持的公式、格式、对象或宏生成差异报告；保存中断、版本冲突、浏览器崩溃和迁移失败都要能从已确认版本恢复。
输出规范
默认输出：
- 核心用户任务、表格类型、规模上限和非目标
- 文档实体、稳定身份、坐标规则和版本模型
- 单元格值/类型/格式/公式/错误的字段契约
- 公式语法、依赖、重算、循环和外部数据策略
- 命令、事务、撤销重做、保存与恢复流程
- 角色—区域—操作权限矩阵和服务端校验点
- 协作、断线、冲突和历史版本策略
- 性能预算、兼容矩阵、测试样本和上线门禁
接口和状态统一给示例，但不绑定具体表格品牌。任何容量结论都注明设备、浏览器、文档结构和测试动作；任何“兼容”都说明公式、格式、对象和往返损失范围。
能力边界
- 不把像素相同等同于数据语义相同
- 不承诺完整兼容所有桌面表格函数、宏和对象模型
- 不用显示文本代替日期、金额、长数字等规范值
- 不让客户端锁定区域承担服务端权限职责
- 不在未知兼容损失下静默覆盖用户原文件
- 不让任意公式直接访问网络、文件或敏感上下文
- 不把实时协作默认视为必需；它会显著增加状态复杂度
- 财务、薪酬、医疗等关键表必须有业务规则与人工复核
稳定性保障
- 文档实体有稳定 ID，坐标变动不改变业务身份
- 所有编辑走命令与事务，批量失败可整体回滚
- 公式依赖图可重建，计算结果可由输入与版本复现
- 保存携带前置版本，重复请求不创建重复版本
- 撤销只撤销本用户意图，不误删远端已确认操作
- 权限在服务端按真实影响范围重新校验
- 导入原件、规范内部格式和导出文件分开保存
- 崩溃恢复从已确认快照与操作日志重放
深度定制
财务预算增加科目、期间、精度、审计痕迹和关账；报价单增加商品快照、税率、币种和审批；项目排期增加日期轴、依赖和资源冲突；低代码业务表增加字段模式、校验和流程触发；BI 结果表增加只读大数据、列式加载和服务端聚合；教学表格增加公式步骤、错误提示和版本回看；AI 表格增加建议预览、影响范围、引用证据和逐项接受，不允许模型直接覆盖整表。
FAQ
为什么不能直接用二维数组保存所有内容？
二维数组能表示位置，但很难稳定承载插删后的身份、类型、公式依赖、权限、对象和版本。小型展示可用；需要编辑与演进时应建立文档实体和命令模型。
公式结果应保存在服务端吗？
关键结果可以缓存，但必须绑定输入、公式引擎版本和计算时间，并能重算验证。服务端与客户端若都计算，要定义权威结果和差异处理。
合并单元格为什么容易出问题？
它同时影响选择、粘贴、排序、虚拟渲染和导入导出。把合并建模为覆盖区域及主单元格关系，操作前检查是否切割合并区，不要只改样式。
多人协作一定要用细粒度合并算法吗？
不一定。很多业务表用区域锁或乐观版本更简单可靠。只有高并发同表编辑且确有价值时，才承担细粒度协作的成本，并先定义冲突语义。
反模式与修正
| 反模式 | 直接后果 | 修正 |
|---|---|---|
| 坐标就是唯一身份 | 插行后业务绑定漂移 | 稳定 ID 与坐标映射 |
| 显示字符串直接保存 | 日期金额类型丢失 | 值、类型、格式分离 |
| 每次编辑全表重算 | 大表输入卡顿 | 依赖图与增量重算 |
| 每格一个重型组件 | 滚动和内存失控 | 视口虚拟化与批量绘制 |
| 粘贴逐格提交 | 慢且留下半成品 | 二维事务、预检与整体回滚 |
| 只在前端禁用按钮 | 可绕过权限 | 服务端影响范围校验 |
| 最后保存覆盖全部 | 并发修改丢失 | 前置版本、冲突与重放 |
| 宣称无损兼容 | 隐性丢公式或格式 | 兼容矩阵与差异报告 |
按需 references
- 设计实体、类型、公式、命令、事务和持久化时，读取 document-model-and-formulas.md
- 设计权限、协作、性能、导入导出和验收时，读取 permissions-performance-and-compatibility.md
