name: create-feishu-doc description: 此技能应在用户要求“创建飞书文档”、“在飞书中新建文档”、“打开飞书并创建文档”、“在莱尼奥-IBG中创建文档”或提及在飞书/莱尼奥工作空间创建文档时使用。 user-invocable: true version: 0.1.0

创建飞书文档自动化

目的

通过使用浏览器自动化导航用户界面、认证以及创建具有指定标题和内容的文档，自动化在飞书（莱尼奥）工作空间中创建新文档的过程。

何时使用此技能

在以下情况下使用此技能：

用户要求创建新的飞书文档
用户希望自动化在其飞书工作空间中的文档创建
用户需要快速创建文档，无需手动用户界面交互

先决条件

访问飞书工作空间（https://leiniao-ibg.feishu.cn）
工作空间的有效认证凭证
通过 agent-browser 的浏览器自动化能力

工作流程

步骤 1: 加载浏览器自动化技能

使用技能工具加载 office:agent-browser 技能以访问浏览器自动化命令。

步骤 2: 导航到飞书驱动

打开飞书驱动主页：

agent-browser open https://leiniao-ibg.feishu.cn/drive/home/

等待页面加载：

agent-browser wait --load networkidle

步骤 3: 验证认证

拍摄快照以检查是否已登录：

agent-browser snapshot -i

如果需要登录，等待用户手动完成认证或根据页面状态处理认证流程。

步骤 4: 创建新文档

点击“新建”按钮（使用快照定位元素引用）：

agent-browser snapshot -i
# 定位“新建”按钮引用（例如，@e1）
agent-browser click @e1

等待下拉菜单出现：

agent-browser wait 1000

拍摄另一个快照以定位“文档”选项：

agent-browser snapshot -i
# 定位“文档”按钮引用（例如，@e2）
agent-browser click @e2

步骤 5: 选择新文档类型

从子菜单中点击“新建空白文档”选项：

agent-browser wait 1000
agent-browser snapshot -i
# 定位“新建空白文档”按钮引用（例如，@e3）
agent-browser click @e3

步骤 6: 等待新标签页

等待新文档在新标签页中打开：

agent-browser wait --load networkidle

检查标签页以确保新文档页面已打开：

agent-browser tab

如果存在多个标签页，切换到最新标签页（通常是最后一个）：

agent-browser tab 2  # 根据标签页列表调整索引

步骤 7: 输入文档标题

页面应自动聚焦到标题输入字段。如果标题字段默认聚焦，直接输入标题：

agent-browser type @e1 “文档标题在此”

如果未自动聚焦，拍摄快照以定位标题输入：

agent-browser snapshot -i
# 定位标题输入引用（例如，@e1）
agent-browser fill @e1 “文档标题在此”

步骤 8: 输入文档内容

按 Tab 键或点击移动到内容区域：

agent-browser press Tab

或定位并点击内容编辑器：

agent-browser snapshot -i
# 定位内容编辑器引用（例如，@e2）
agent-browser click @e2

输入文档内容：

agent-browser type @e2 “文档内容在此...”

对于多行内容，在输入中使用换行：

agent-browser type @e2 “第一段

第二段

第三段”

步骤 9: 验证和保存

拍摄最终屏幕截图以验证文档创建成功：

agent-browser screenshot

飞书文档自动保存，因此无需显式保存操作。文档现在已准备好使用。

步骤 10: 关闭浏览器（可选）

完成后关闭浏览器会话：

agent-browser close

错误处理

认证问题

如果认证失败或需要登录：

暂停工作流程
通知用户需要手动登录
等待确认后再继续
认证后恢复工作流程

元素未找到

如果快照无法定位预期的用户界面元素（按钮引用）：

拍摄不带 -i 标志的完整快照以进行调试
检查用户界面是否已更改或语言设置不同

使用语义定位器作为后备：

agent-browser find text “新建” click  # 查找“新建”按钮
agent-browser find text “文档” click  # 查找“文档”按钮
agent-browser find text “新建空白文档” click  # 查找“新建空白文档”按钮

超时问题

如果页面加载时间过长：

增加等待超时：agent-browser wait --load networkidle --timeout 10000
检查网络连接
验证飞书服务可用性

自定义

不同工作空间

要与不同的飞书工作空间使用，替换步骤 2 中的 URL：

agent-browser open https://your-workspace.feishu.cn/drive/home/

文档模板

要使用特定文档模板而非空白文档：

点击“文档”后导航到模板库
定位并点击所需模板
继续进行标题和内容输入

最佳实践

会话重用：对于多次文档创建，保持浏览器会话打开并重用认证状态
错误屏幕截图：在每个关键步骤拍摄屏幕截图以进行调试
等待用户界面：导航后始终等待网络空闲以确保用户界面元素已加载
显式等待：点击下拉菜单后使用显式等待（例如，agent-browser wait 1000）

附加资源

浏览器自动化参考

详细浏览器自动化命令和模式：

加载 office:agent-browser 技能以获取完整命令参考
在 agent-browser 文档中查看快照和交互模式

示例用法

# 完整工作流程示例
agent-browser open https://leiniao-ibg.feishu.cn/drive/home/
agent-browser wait --load networkidle
agent-browser snapshot -i
agent-browser click @e1  # 新建按钮
agent-browser wait 1000
agent-browser snapshot -i
agent-browser click @e2  # 文档按钮
agent-browser wait 1000
agent-browser snapshot -i
agent-browser click @e3  # 新建空白文档按钮
agent-browser wait --load networkidle
agent-browser tab
agent-browser tab 2  # 切换到新标签页
agent-browser type @e1 “我的文档标题”
agent-browser press Tab
agent-browser type @e2 “我的文档内容...”
agent-browser screenshot