SpreadJS AI Agent
为业务系统中的表格赋予对话智能
50+ 内置工具·支持任意主流大模型·闭环执行·可直接嵌入业务系统
三大能力演示区
智能构建专业报表
极速生成复杂表格，一键应用行业样式
智能构建复杂估值模型并自动匹配金融行业标准排版，大幅提升报表编制效率
图像表格精准还原
提取图片数据，精准复刻表格排版结构
解析图片表格数据，精准还原边框与合并单元格等复杂结构，实现无缝数字化转换
智能公式诊断修复
定位公式异常，修正逻辑并生成审查日志
检测并修复工作表中的公式与计算逻辑错误，同步输出审计日志，保障数据准确性
四大功能模块
01SPREADSHEET CONTROL（表格基础控制）
02FILE & EXTERNAL DATA（文件与外部数据）
03AGENT ORCHESTRATION（智能体编排）
04SYSTEM ENGINEERING（系统工程）
兼容大模型展示区
DeepSeek
DeepSeek-V4 / V3 / R1
Qwen / 通义千问
阿里云
Qwen-Max / Qwen-Plus
MiniMax
M2.5 / MiniMax-Text-01
智谱 AI
GLM-4 系列
Kimi
Moonshot AI
GPT
OpenAI
GPT-4o / GPT-4.1
Claude
Anthropic
系统六层架构设计
L1表现层 Presentation
用户交互界面
对话面板、消息气泡、进度反馈、可嵌入任意前端框架（React / Vue 均支持）
L2状态层 State
会话与上下文管理
维护对话历史、SpreadJS 表格快照（自动保存，支持回滚）、用户偏好设置
L3业务逻辑层 Business Logic
任务规划与拆解
将用户自然语言意图拆解为多步子任务，协调工具调用顺序，处理依赖与并发
L4服务/AI 层 Service
大模型调用与路由
统一封装各模型 API 差异，支持模型热切换；内置 Token 用量监控与风控限制（最大 25 步防死循环）
L5工具层 Tool（ModuleTracker）
工具动态管理与分发
核心创新：渐进式 API 披露机制，默认仅暴露约 30 个通用工具，按需动态解锁模块专属工具集，防止 LLM 认知过载
L6数据层 Data
数据读写与格式转换
SpreadJS 单元格/公式/图表数据的统一读写接口，支持 xlsx / csv / sjs / pdf / json 多格式互转
ModuleTracker 核心设计：渐进式 API 披露机制
传统方案的困境
SpreadJS 共有 91 个工具函数，一次性全部注入上下文，大模型面临三大问题：
- ① 上下文超出 Token 限制
- ② 工具选择错误率飙升
- ③ 响应速度明显变慢
ModuleTracker 的解法
基于有限状态机（FSM）的动态工具路由：
- ① 默认仅激活约 30 个通用基础工具
- ② 用户意图涉及特定模块（如图表）时，Gateway 工具自动触发，解锁该模块的专属工具集
- ③ 任务完成后自动回收，保持上下文精简
效果对比：与传统方式对比，ModuleTracker 可将单次请求 Token 消耗降低 60%，工具调用准确率提升至 95%+，复杂任务平均完成步骤减少 30%。
快速开始 · 3步部署AI Agent
1克隆仓库
拉取项目源码并安装依赖
git clone https://gitee.com/GrapeCity
/spreadjs-ai-agent
pnpm install
2配置环境变量
复制环境变量模版
cp .env.example .env.local
3启动表格智能体
推荐使用生产方式启动
pnpm build
pnpm start
运行环境：Node.js 18+，React 17+，SpreadJS 19+
行业场景与 AI 应用方案
财务数字化
典型场景：智能财务报表系统
AI 自动校验资产负债表公式，识别数据异常，一键生成多维可视化报告；自然语言描述分析需求，自动生成图表与摘要。
企业 BI 平台
典型场景：自然语言数据探索
用户用自然语言描述需求，AI 自动完成数据查询、透视分析、图表生成；支持追问、条件调整，无需学习复杂操作路径。
ERP / 业务系统
典型场景：对话式数据录入与导出
在现有 ERP 系统中嵌入 AI 对话面板，通过自然语言完成数据录入、格式调整、报表导出等操作，大幅降低使用门槛。
数字政务
典型场景：政务数据治理与上报
AI 辅助完成多部门数据汇总、格式标准化、合规性检验，自动生成上报所需表单格式，减少人工核对工作量。
医疗 / 科研
典型场景：临床数据整理与分析
研究人员通过对话驱动对实验数据进行清洗、统计计算、可视化呈现，支持批量处理多份数据集，输出专业分析图表。
教育 / 培训
典型场景：学情数据智能分析
教师描述分析需求，AI 自动汇总学生成绩、生成趋势图表、对比班级/学科表现，一键导出可用于汇报的专业报表。
方案选型对比
| SpreadJS AI Agent | 通用 AI 编程助手（如 Cursor） | 自行基于 LLM 开发 | |
|---|---|---|---|
| 适用对象 | 面向业务系统开发者 | 面向代码编写者 | 任意（高度定制） |
| SpreadJS 专有能力覆盖 | ✅ 50+ 内置工具，全面覆盖 | ⚠️ 依赖文档质量，易幻觉 | ❌ 需自行开发全部工具 |
| 嵌入现有业务系统 | ✅ 组件化，三步接入 | ❌ 不适用 | ⚠️ 完全可定制，但周期长 |
| 开箱即用程度 | ✅ Apache 2.0，Fork 即用 | ✅ 订阅即用 | ❌ 需要从零搭建 |
| Token 效率 | ✅ ModuleTracker，节省约 60% | ⚠️ 无专项优化 | ⚠️ 取决于开发者实现 |
| 最佳选择场景 | 在业务系统中集成对话式表格 AI 能力 | AI 辅助编写 SpreadJS 集成代码 | 有充足研发资源、需深度定制 |
⭐ 完整源码开放 · Apache 2.0 · 商业项目可直接使用 · 一键 Fork 开箱即用