开源多维表格SmartTable 官方文档站正式上线

一个开源、可私有部署、又能当数据库使的智能多维表格系统，把”怎么用、怎么部署、怎么扩展”这扇门彻底打开了。

做管理的朋友大概都有过这种经历：

• Excel 装不下团队的协作——谁改了哪行、谁在看哪一页，全靠口头喊；
• 上 ERP 又太重、太贵、改不动——为了管几百条客户信息，先招半个实施团队；
• 市面上的在线多维表格是好用，但数据捏在别人手里，合规过不了关。

中间那块空地，正是 SmartTable 想填的：一个开源、可私有部署、又能当数据库使的智能多维表格系统。而今天的重点是——它的官方文档站已经正式上线：

🔗 https://https://my-smart-table.github.io/smart-table-docs

一、先认识一下 SmartTable 是谁

SmartTable 是一款基于 Vue 3 + Flask 构建的开源智能多维表格系统，定位类似 Airtable 或飞书多维表格，但它的灵魂在”开源 + 可私有化”：

• 前端：Vue 3 + TypeScript + Vite + Pinia + Element Plus
• 后端：Flask + SQLAlchemy + Alembic
• 数据库：SQLite（默认）/ PostgreSQL（生产推荐）
• 实时通信：WebSocket（http://Socket.IO），可选启用
• 开源协议：MIT——可以放心用在公司里，甚至做商业化改造，没有后顾之忧

它围绕四个维度提供能力：数据管理 + 视图呈现 + 流程自动化 + 团队协作。一个 Base（多维表格） 就是一个独立工作空间，里面可以有多张数据表、仪表盘、文档和工作流，表与表之间还能通过关联字段建立关系。

二、文档站到底有什么？三块结构，中英文双语

很多开源项目的文档，读起来像在读源码注释。SmartTable 这份不一样——它是按”你想用它干什么”来组织的，而不是按”代码怎么写”来堆的。整站分三块，中英双语同步，右上角一键切换。

1. 产品介绍：先搞清楚它是谁

不想看长文，直接翻「核心功能」一页速览即可。

2. 用户指南：从会用到用得好（最厚实的部分）

快速开始 / 表格操作——新人十分钟上手，不用培训。

七种视图，同一份数据换种看法就换种用法：

主从表 & 树表格（层级表）——处理”一对多”“上下级”这类结构数据时，不用再手动拼表。主从表支持子表独立刷新、多关联字段切换；树表格基于自关联的 LINK 字段建立父子关系，最多 4 级嵌套，删父留子、删子级联后代。

站内信通知——系统消息、审批提醒直接进站内信，5 种来源标签、4 种状态，消息必达，不用再守着邮件。

工作流自动化——可视化设计器，触发器支持定时 / 记录创建 / 记录更新；节点覆盖创建记录、更新记录、查找记录、发邮件、Webhook、条件分支、循环，外加自定义 Python 脚本节点。还支持工作流版本快照，可历史回溯。

字段类型——关联、查找、公式三大”关系型”本领单独成章，这是它和纯电子表格拉开差距的地方：

• 关联（Link）
  ：支持一对一 / 一对多 / 多对一 / 多对多，双向关联
• 查找（Lookup）
  ：跨表查询，8 种聚合方式（求和/平均/最大/最小/计数…）
• 公式字段
  ：47 个内置函数，覆盖数学、文本、日期、逻辑、统计

场景实践——直接抄作业： 项目管理、研发缺陷管理、CRM 客户关系、人事招聘、内容日历。

3. 开发者文档：能部署、能改造

架构设计、开发环境、一键 / Docker / 手动部署、配置说明，再到 REST API（认证、数据表、记录、工作流）。想自己搭一套内网版，或做二次开发，这里够用。

三、让人省心的小细节

• 中英双语
  ：海外团队或英文环境也能直接用。
• 本地搜索
  ：文档站内置搜索，不用联网也能查。
• 深色模式
  ：熬夜改表不刺眼。
• 每页可编辑
  ：看到哪写得不对，点「在 GitHub 上编辑此页」就能提 PR——开源项目该有的样子。
• 更新日志 & FAQ
  ：版本变了有什么影响、常见问题怎么解，都摆在那。
• 协作能力透明
  ：文档里明确写了实时协作基于 WebSocket，包含在线状态、视图同步、单元格锁定、冲突检测和离线队列——不是口号，是功能清单。

四、为什么值得现在去看看

1. MIT 许可证
   ——商业闭源部署无合规风险，这是很多同类开源项目（如 AGPL 系）给不了的安心。
2. 甘特图 + 多级分组视图
   ——项目管理场景开箱即用，不用装插件。
3. 协同锁 + 站内信系统
   ——企业协作”消息必达”场景更强，告别”邮件漏看”。
4. 业务字段丰富
   （进度/评分/条码/按钮）——配置成本低，少写代码。
5. 可视化工作流编排
   ——非开发者也能搭自动化，Python 脚本节点给进阶留了口子。
6. 现代前端栈
   （Vue 3）——二次开发体验好，社区接手门槛低。

一句话：SmartTable 在”企业协作闭环（锁 + 站内信 + 工作流）”和”开箱即用视图（甘特 / 分组）”上更贴合国内企业场景，且 MIT 更友好；文档站的上线，等于把这扇门彻底打开了。

五、现在就出发

不管你是想给团队找个轻量的协作工具，还是技术同学想研究一套多维表格的实现，这个站点都值得 bookmark 一下：

🔗 https://https://my-smart-table.github.io/smart-table-docs

从「快速开始」点进去，也许半小时后，你就已经搭好第一张属于自己的多维表格了。

文档站持续更新中，欢迎在 GitHub 上提 Issue 与 PR，一起把它做得更好。