飞书电子表格工具
统一使用 feishu_sheets 工具，通过 action 参数区分不同的表格操作。
Token 提取
从 URL https://xxx.feishu.cn/sheets/shtABC123 → spreadsheet_token = shtABC123
操作列表
创建电子表格
{ "action": "create", "title": "新建表格" }可选指定文件夹：
{ "action": "create", "title": "新建表格", "folder_token": "fldcnXXX" }返回：spreadsheet_token、url、title
写入数据
{
"action": "write",
"spreadsheet_token": "shtABC123",
"sheet_id": "0bxxxx",
"range": "A1:C3",
"values": [["姓名", "年龄", "城市"], ["Alice", 25, "北京"], ["Bob", 30, "上海"]]
}读取数据
{
"action": "read",
"spreadsheet_token": "shtABC123",
"sheet_id": "0bxxxx",
"range": "A1:C10"
}追加数据
{
"action": "append",
"spreadsheet_token": "shtABC123",
"sheet_id": "0bxxxx",
"values": [["Charlie", 28, "深圳"]]
}插入行/列
{
"action": "insert_dimension",
"spreadsheet_token": "shtABC123",
"sheet_id": "0bxxxx",
"dimension": "ROWS",
"start_index": 5,
"end_index": 7
}删除行/列
{
"action": "delete_dimension",
"spreadsheet_token": "shtABC123",
"sheet_id": "0bxxxx",
"dimension": "ROWS",
"start_index": 5,
"end_index": 7
}获取表格信息
{ "action": "get_info", "spreadsheet_token": "shtABC123" }返回：表格元数据，包含所有工作表的 sheet_id 和标题
新增工作表
{
"action": "add_sheet",
"spreadsheet_token": "shtABC123",
"title": "Sheet2"
}删除工作表
{
"action": "delete_sheet",
"spreadsheet_token": "shtABC123",
"sheet_id": "0bxxxx"
}范围格式
- 单个单元格：
A1、B5 - 范围：
A1:C10、B2:D5 - 整列：
A:A、B:D - 整行：
1:1、3:5 - 带 sheet_id：
0bxxxx!A1:C10
工作表 ID
- 从 URL 获取：
https://xxx.feishu.cn/sheets/shtABC123?sheet=0bxxxx - 通过 get_info 操作获取
- 默认第一个工作表的 ID 通常类似
0bxxxx
数据类型
支持的值类型：
- 字符串：
"你好" - 数字：
123、45.67 - 公式：
{"type": "formula", "text": "=SUM(A1:A10)"} - 链接：
{"type": "url", "text": "点击这里", "link": "https://..."}
配置
channels:
feishu:
tools:
sheets: true # 默认：true所需权限
sheets:spreadsheet- 创建和管理电子表格sheets:spreadsheet:readonly- 读取电子表格数据drive:drive- 访问云空间
API 参考
基础 URL：https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/
详细 API 文档请参阅 references/api-reference.md。