Sheet Agent

一句话定位

将自然语言转化为电子表格理解、异常检测、业务洞察及安全重写建议。

适用场景

当用户提及以下情况时，启用该能力：

• 让 AI 读取或检查电子表格中的问题
• 从 CSV/Excel 文件中查询数据
• 生成日报、周报或运营摘要
• 修改电子表格中的某条记录（先预览，再确认）
• 检查电子表格中是否存在空值、重复项或异常数据

使用方式

/sheet "电子表格路径" "自然语言指令"

示例：

/sheet "~/Desktop/orders.csv" "哪些订单超过 3 天未跟进？"
/sheet "~/Documents/inventory.xlsx" "检查是否存在负库存数量"
/sheet "~/Desktop/orders.csv" "生成上周的周报"
/sheet "~/Desktop/customers.csv" "将第 8 行的客户等级更改为 VIP"

核心功能

1. 电子表格读取与理解

• 支持 CSV 和 Excel（.xlsx）文件
• 自动识别列名与数据类型
• 推断业务类型（如：订单/库存/线索/日报）

2. 业务查询（自然语言 → 结构化结果）

• “超过 X 天未跟进的订单”
• “金额大于 Y 的订单”
• “查找所有 VIP 客户”
• “按销售代表汇总数量”

3. 异常检测

• 空值（缺失数据）
• 负数（出现在库存/数量类字段）
• 重复 ID
• 日期异常（未来日期、格式不一致）
• 数值异常（超出合理范围）

4. 日报 / 周报 / 运营摘要

• 自动识别时间范围
• 生成结构化摘要：
  • 概览视图（总数、总和、平均值）
  • 分布统计（分类占比、TOP 项目）
  • 异常记录列表
  • 趋势描述

5. 修改预览（关键安全机制）

所有修改操作均先展示预览 —— 仅在用户确认后执行写入。

用户说：“将第 5 行的金额更改为 15000”： -> Agent 展示修改预览，暂不写入 -> 若用户回复 “confirm”，则执行写入 -> 若用户回复 “cancel”，则不执行任何操作

输出示例

查询结果

📊 查询结果：12 条线索已超过 3 天未跟进

| # | 姓名 | 电话 | 录入日期 | 已过天数 |
|---|------|------|----------|----------|
| 3 | Alex Wang | 138... | 2026-03-25 | 6 天 |
| 7 | Leo Zhao | 139... | 2026-03-27 | 4 天 |

异常检测

⚠️ 发现 4 处异常：

1. 第 15 行 [蓝牙耳机]：库存 = -5（为负数）
2. 第 28 行 [手机壳]：单价为空
3. 第 42 行 [数据线]：库存 = 9999（数值异常偏大）
4. 第 55 行：产品名称重复

周报

📈 运营摘要 —— 2026 年 3 月第 4 周

[概览视图]
- 订单总数：156 单
- 销售总额：¥128,500
- 客单价：¥823

[销量 TOP 5 商品]
1. 蓝牙耳机 — 45 件
2. 手机壳 — 32 件
...

[异常订单]
- 退款订单：2 单

修改预览

📝 拟执行修改预览：

文件：customers.csv  
行号：8  
字段：Customer Tier  
原值：Regular  
新值：VIP  

⚠️ 是否确认执行？请回复 “confirm” 或 “cancel”

安全原则

1. 默认只读：所有操作默认不修改文件
2. 仅确认后写入：写入操作必须获得用户明确确认
3. 写入前自动备份：原始文件将自动备份至 backup/ 目录
4. 不确定时主动询问：若列含义不明确，主动向用户确认，不自行假设

限制条件

• 单次操作建议最多处理 100,000 行
• 支持 CSV 和 .xlsx 格式
• v1 版本暂不支持跨电子表格关联（cross-spreadsheet joins）