检查
检查工作簿
在进行大范围编辑之前，获取工作簿的真实结构：工作表索引、已用区域、预览和公式分组。
为Agent而生的电子表格
Agent 可直接操作公式、数据范围、透视表与图表。每一次变更都是 Git 式提交，可审查、对比、合并与回滚。
多 Agent 与人类协同工作，所有结果，最终由你定义。
面向人类
npm install -g agent-sheet@latest面向 AI 智能体
Read https://github.com/dream-num/skills and follow the setup instructions为以下场景构建
任意智能体与技术栈
工作原理
智能体与人类在电子表格上协作的简单三步工作流。
1
智能体创建或更新工作簿。
包括公式、格式、图表、条件格式和透视表。
2
像审阅拉取请求一样审阅每一次变更。
每一次电子表格操作都成为一个结构化变更，使差异清晰且可审阅。
3
批准、拒绝、合并或回滚变更。
保持控制，不会丢失工作成果或破坏工作簿。
核心能力
默认完全本地
在您的机器上运行核心工作簿工作流，无需网络、无需登录、不依赖云端。
由 Univer 驱动
基于 GitHub 12.6k+ Stars 的先进电子表格引擎构建，无需 Excel、LibreOffice 或任何云端表格服务。
原生 Shell 设计
与 awk、grep、sed、jq、Python 无缝协作，直接在终端中编排电子表格工作流。
增量更新
通过只更新变更内容而非重写整个文件，处理大型数据集和复杂电子表格。
电子表格能力
500+ 公式与真实公式执行、条件格式、数据验证、权限、图表、透视表、富单元格格式、批注、超链接和图片。
人类审阅智能体变更
智能体创建和更新工作簿。每一次变更都是结构化且可审阅的，就像拉取请求一样。人类可以评论、批准、拒绝、合并或安全回滚。
实际应用
真实的 CLI 工作流：检查、读取、转换、写入和脚本，全部通过工作簿原生界面完成。
检查
检查工作簿
在进行大范围编辑之前，获取工作簿的真实结构：工作表索引、已用区域、预览和公式分组。
命令
$ agent-sheet inspect workbook \
--entry-id ei_3gu5q9e3输出
Spreadsheet Overview
Total [1] Sheets: 'Renewals'
| # | Sheet | Used Range | Tables | Groups |
|---|---------|------------|--------|--------|
| 1 | Renewals | A1:H6 | 1 | 2 |
G2:G6 <- G2 (5): =ROUND((F2*15)+(D2/2),0)
H2:H6 <- H2 (5): =IF(G2>55,"renew_now","monitor")读取
读取区域
当下一步属于管道、文件或下游脚本时，将精确的工作簿值拉取到标准输出。
命令
$ agent-sheet read range \
--entry-id ei_3gu5q9e3 \
--range 'Renewals!A1:F6' \
--type rawValue \
--format csv \
--to-stdout输出
account_id,segment,csm,days_to_renewal,arr,open_tickets
ACC-0001,MidMarket,Bianca,13,8137,4
ACC-0002,Enterprise,Carter,41,18274,1
ACC-0003,SMB,Diego,8,2411,6
ACC-0004,SMB,Avery,32,6680,2
ACC-0005,Enterprise,Nora,5,22100,7管道
读取 + awk + 写入
将电子表格区域通过标准输出管道传输到 Unix 工具，并将结果写回同一工作簿或另一个工作簿。
命令 1
$ agent-sheet read range \
--range 'Renewals!A1:F6' \
--format csv --to-stdout \
| awk -F, 'NR==1{print "id,csm,days"; next}
($4+0)<=15 {print $1","$3","$4}'输出 1
id,csm,days_to_renewal
ACC-0001,Bianca,13
ACC-0003,Diego,8
ACC-0005,Nora,5命令 2
$ agent-sheet write table \
--sheet Review --data-stdin输出 2
{
"status": "success",
"updated": 1,
"ranges": ["Review!A1:C4"]
}写入
写入表格 / 写入单元格
将结构化数据（表格、数组或标量）写入指定工作表和区域，并保留公式引用和格式。
命令 1
$ agent-sheet write table \
--entry-id ei_3gu5q9e3 \
./review-new.csv --sheet Review输出 1
{
"status": "success",
"updated": 1,
"ranges": ["Review!A1:C4"]
}命令 2
$ agent-sheet read range \
--range 'Review!A1:C4' \
--format csv --to-stdout输出 2
owner,status,note
Lena,approved,carry forward
Mark,review,watch risk drift
Nora,renew_now,escalate this week回退
脚本 JS
当声明式命令不够用时，运行 JavaScript 以直接访问工作簿模型并执行任意转换。
命令 1
$ agent-sheet script js \
--entry-id ei_3gu5q9e3 \
--file ./bounded-edit.js \
--json输出 1
{
"method": "script.js",
"success": true,
"changed": "Review!D1:D4"
}命令 2
$ agent-sheet read range \
--entry-id ei_3gu5q9e3 \
--range 'Review!A1:D4' \
--type rawValue \
--format csv \
--to-stdout输出 2
owner,status,note,next_step
Lena,approved,carry forward,send quote
Mark,review,watch risk drift,double check
Nora,renew_now,escalate this week,call today实际应用
真实的 CLI 工作流：检查、读取、转换、写入和脚本，全部通过工作簿原生界面完成。
命令
$ agent-sheet inspect workbook \
--entry-id ei_3gu5q9e3输出
Spreadsheet Overview
Total [1] Sheets: 'Renewals'
| # | Sheet | Used Range | Tables | Groups |
|---|---------|------------|--------|--------|
| 1 | Renewals | A1:H6 | 1 | 2 |
G2:G6 <- G2 (5): =ROUND((F2*15)+(D2/2),0)
H2:H6 <- H2 (5): =IF(G2>55,"renew_now","monitor")基准测试与可靠性
基于真实世界电子表格基准测试进行验证，并在多种职业任务中持续评估。
#1 排行榜 · 2025年12月
SpreadsheetBench
真实世界电子表格任务准确率
0.00%
准确率 (%) · pass@1
Human
71.3%
Univer
68.86%
Bluebox
62.9%
Shortcut.ai
59.25%
Excel 中的 Copilot（智能体模式）
57.2%
4.1倍 比最接近的 AI 竞争对手高出
GDPval
0
真实世界任务
覆盖 44 种职业
0
开放任务
包含 75 个电子表格相关案例
用于持续内部评估