| name | feishu-article-upload |
| version | 1.5.0 |
| description | 飞书文档管理 skill。将文章、Excel 表格同步到本地后上传到飞书个人文档库，创建文档和表格。当用户提供文件路径或 URL 并说"上传到飞书"、"保存到飞书"、"转飞书文档"、"上传表格到飞书"、"把 Excel 传到飞书"、"创建飞书表格"时自动触发。 |
| allowed-tools | Bash(lark-cli *), Read, Glob |
飞书文档上传
使用 lark-cli 管理飞书个人文档库中的文档和表格。
核心功能
- 文档管理：创建文档、更新文档、获取文档
- 表格管理：同步本地文件后，读取 Excel/CSV，创建飞书表格
工作流程
重要：先同步到本地
上传文件前，必须先将文件同步到本地，确保文件存在且可读。
同步来源：
- 用户直接提供文件路径（如
@Token计费测试用例.xlsx）
- 用户提供 URL（如网盘链接、GitHub 地址等）
同步方式：
- 本地文件：使用
Read 或 Glob 工具读取
- URL 文件：使用
Bash + curl 下载
文档操作
创建文档
在个人文档库根目录创建：
lark-cli docs +create --title "标题" --markdown "内容" --wiki-space my_library
更新文档
lark-cli docs +update --doc <URL或token> --markdown "新内容" --mode overwrite
获取文档内容
lark-cli docs +fetch --doc <URL或token>
表格操作
Excel/CSV 文件上传流程
步骤：
-
同步文件到本地
- 本地文件：直接读取
- URL 文件：用 curl 下载
-
读取文件内容
- 使用 Python pandas 读取 Excel/CSV
-
创建 Sheets 电子表格
-
写入数据
具体命令
下载远程文件（如网盘、GitHub）：
curl -L -o 本地文件名.xlsx "文件URL"
curl -L -o data.xlsx "https://github.com/user/repo/releases/download/v1.0/data.xlsx"
读取 Excel/CSV 文件：
python3 -c "
import pandas as pd
import json
df = pd.read_excel('本地文件路径.xlsx')
# 转为 2D 数组
data = [df.columns.tolist()] + df.values.tolist()
print(json.dumps(data, ensure_ascii=False))
"
创建表格并写入：
lark-cli sheets +create --title "表格标题"
lark-cli sheets +info --spreadsheet-token <token>
lark-cli sheets +write \
--spreadsheet-token <token> \
--sheet-id <sheet_id> \
--values '[["列1", "列2"], ["值1", "值2"]]'
工作流程详解
场景 1: 上传本地文件
- 用户提供本地文件路径（如
@Token计费测试用例.xlsx）
- 使用
Read 确认文件存在
- 使用 Python 读取内容
- 创建 Sheets 并写入
- 返回链接
场景 2: 上传远程 URL 文件
- 用户提供 URL（如网盘链接、GitHub 地址）
- 使用 curl 下载到本地临时目录
- 使用 Python 读取内容
- 创建 Sheets 并写入
- 清理临时文件
- 返回链接
场景 3: 更新文档
- 用户提供文档 URL 要求更新
- 从用户提供提取新内容
- 执行:
lark-cli docs +update --doc <URL> --markdown "新内容" --mode overwrite
- 返回更新结果
常用命令速查
| 操作 | 命令 |
|---|
| 检查认证 | lark-cli doctor |
| 创建文档 | lark-cli docs +create --title "标题" --markdown "内容" --wiki-space my_library |
| 更新文档 | lark-cli docs +update --doc <URL> --markdown "内容" --mode overwrite |
| 获取文档 | lark-cli docs +fetch --doc <URL> |
| 创建 Sheets | lark-cli sheets +create --title "标题" |
| 获取 sheet-id | lark-cli sheets +info --spreadsheet-token <token> |
| 写入 Sheets 数据 | lark-cli sheets +write --spreadsheet-token <token> --sheet-id <id> --values '[[...]]' |
| 下载文件 | curl -L -o 本地文件名.xlsx "文件URL" |
参数说明
docs +create 参数
--title: 文档标题--markdown: Markdown 格式的文档内容--wiki-space my_library: 创建到个人文档库
docs +update 参数
--doc <URL或token>: 文档 URL 或 token--markdown <内容>: 新的 Markdown 内容--mode: 更新模式 (overwrite/append/insert_before/insert_after)
sheets +create 参数
--title <string>: 电子表格标题（必需）
sheets +write 参数
--spreadsheet-token <token>: 电子表格 token（必需）--sheet-id <id>: 工作表 ID（必需）--values <json>: 2D 数组 JSON
注意事项
1. 先同步到本地
重要：上传前必须确保文件在本地存在。远程 URL 必须先下载。
2. Sheets 创建位置
lark-cli sheets +create 只能在根目录创建，返回链接后用户可手动拖动到目标位置。
3. 认证要求
部分操作需要特定 scope：
docs:doc - 文档操作sheets:spreadsheet - Sheets 操作
如果提示权限不足，重新授权：
lark-cli auth login --scope "docs:doc,sheets:spreadsheet"
4. 临时文件处理
下载的远程文件使用完毕后可删除：
rm 本地文件名.xlsx
参考文档
详细命令参考见 lark_cli_reference.md
