飞书电子表格工具

单一工具 feishu_sheets，通过 action 参数实现所有电子表格操作。

Token 提取

从 URL https://xxx.feishu.cn/sheets/shtABC123 → spreadsheet_token = shtABC123

操作

创建电子表格

json
{ action: create, title: 新建电子表格 }

可选文件夹：
json
{ action: create, title: 新建电子表格, folder_token: fldcnXXX }

返回：spreadsheet_token、url、title

写入值

json
{
action: write,
spreadsheet_token: shtABC123,
sheet_id: 0bxxxx,
range: A1:C3,
values: [[姓名, 年龄, 城市], [Alice, 25, 北京], [Bob, 30, 上海]]
}

读取值

json
{
action: read,
spreadsheet_token: shtABC123,
sheet_id: 0bxxxx,
range: A1:C10
}

追加值

json
{
action: append,
spreadsheet_token: shtABC123,
sheet_id: 0bxxxx,
values: [[Charlie, 28, 深圳]]
}

插入行/列

json
{
action: insert_dimension,
spreadsheet_token: shtABC123,
sheet_id: 0bxxxx,
dimension: ROWS,
start_index: 5,
end_index: 7
}

删除行/列

json
{
action: delete_dimension,
spreadsheet_token: shtABC123,
sheet_id: 0bxxxx,
dimension: ROWS,
start_index: 5,
end_index: 7
}

获取电子表格信息

json
{ action: getinfo, spreadsheettoken: shtABC123 }

返回：包含所有 sheet_id 和标题的元数据

添加工作表

json
{
action: add_sheet,
spreadsheet_token: shtABC123,
title: Sheet2
}

删除工作表

json
{
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

Sheet ID

• - 从 URL 获取：https://xxx.feishu.cn/sheets/shtABC123?sheet=0bxxxx
• 从 get_info 操作获取
• 默认第一个工作表通常具有类似 0bxxxx 的简单 ID

数据类型

值可以是：

• - 字符串：Hello
• 数字：123、45.67
• 公式：{type: formula, text: =SUM(A1:A10)}
• 链接：{type: url, text: 点击此处, link: https://...}

配置

yaml
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。