grid-table 是一个用于 Emacs 的通用网格表格组件，支持富文本与图片渲染、公式计算、交互编辑、排序、持久化与插件扩展。可在 Org/Markdown 中以“静态预览 + 激活编辑”的方式嵌入。
特性
- 富文本与图片：单元格内支持简单的 Org 风格标记与图片内联（Unicode 边框预览）。
- 公式引擎：=B2*C2、=SUM(D2:D4)、=IF(A1>0, “Yes”, “No”) 等；支持单元格/区域引用。
- 交互编辑：导航、编辑、插入/删除行列、列宽自适应、列排序。
- 持久化：.grid 纯文本格式（含公式）；CSV 插件读写。
- 插件系统：CSV 数据源、Org/Markdown 静态预览，易扩展。
安装
- 将项目与 plugins 目录加入 load-path (add-to-list 'load-path “/path/to/grid-table”) (add-to-list 'load-path “/path/to/grid-table/plugins”)
- 加载核心与插件系统 (require 'grid-table) (require 'grid-table-plugins) ;; 或按需加载： ;; (require 'grid-table-csv) ;; (require 'grid-table-org) ;; (require 'grid-table-markdown)
快速开始
- 新建：M-x grid-table-create
- 打开 .grid：M-x grid-table-find-file
- 保存为 .grid：在表格 buffer 中 C-c C-w 或 M-x grid-table-write-file
- 打开 CSV：M-x grid-table-find-file-csv
常用快捷键（grid-table-mode）
- 导航：n/p 上下，TAB/S-TAB 左右，g 刷新
- 编辑：e 编辑单元格，C-c t 编辑标题
- 行列：C-c r a / C-c r d 插入/删除行；C-c c a / C-c c d 插入/删除列
- 排序：C-c s 按当前列升/降序
- 文件：C-c C-w 保存为 .grid，C-c C-f 打开 .grid
说明：插入列在“当前列右侧”；grid-table-insert-column-left 支持左侧插入。删除第 0 行（用户自定义表头）被保护；删除末行后光标保持在表内。
公式
- 以 = 开头：=B2*C2、=SUM(D2:D4)、=IF(A1>0, “Yes”, “No”)
- 引用：单元格 A1，区域 A1:B5
- 内置：SUM/AVERAGE/COUNT/MAX/MIN/IF
排序
在任意数据列上执行 C-c s，选择 ascending 或 descending 即可（用户自定义表头保持首行）。
Org 集成（special block）
- 插入块：M-x grid-table-org-insert-block（仅需 :file）
- 刷新预览：M-x grid-table-org-refresh-block
- 打开编辑：M-x grid-table-org-open-block 说明：静态预览为只读；实际修改请在专用表格窗口内进行。
Markdown 集成（fenced block）
- 插入块：M-x grid-table-markdown-insert-block
- 刷新预览：M-x grid-table-markdown-refresh-block
- 打开编辑：M-x grid-table-markdown-open-block 说明：静态预览为只读；实际修改请在专用表格窗口内进行。
持久化
.grid 使用 Lisp S 表达式保存：标题、用户自定义表头以及所有原始值（含公式）。
数据源 API（概览）
数据源（哈希表）常用键：
- 读写：:get-row-count、:get-column-count、:get-raw-value-at、:get-computed-value-at、:set-raw-value-at
- 结构：:add-row、:delete-row、:add-column、:delete-column
- 其它：:get-header-value、:set-header-value-at、:sort-by-column 可参考 plugins/grid-table-csv.el 实现自定义数据源并注册。
路线图
- Provider 适配器（更稳定的 Provider 契约，兼容现接口）
- 依赖图与增量重算、更多公式函数（如 Lookup 系列）
- Org/Markdown 高级参数（如 :range、:width 等，可选）
许可与贡献
欢迎反馈与贡献插件/功能。若你在数据源或渲染方面有需求，欢迎提交 PR/Issue。
