mcpField
C
create-feishu-doc

create-feishu-doc

github.com/fradser文档处理596100 次安装5 周前更新
代码仓库

关于 create-feishu-doc

create-feishu-doc 是通过浏览器自动化在 Feishu 工作区创建文档的技能，适用于需要按指定标题和内容新建文档的流程。它涵盖登录状态检查、创建空白文档、填写内容及截图验证。

主要功能

  1. 01使用 agent-browser 操作 Feishu
  2. 02检查工作区登录状态
  3. 03创建空白文档并填写标题
  4. 04输入多段文档内容
  5. 05通过截图检查创建结果

适用场景

  1. 01在 Feishu 工作区创建新文档
  2. 02登录后批量复用浏览器会话创建文档

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fradser/dotclaude --skill create-feishu-doc

安装后在 Claude Code 中输入/create-feishu-doc确认已加载。

详细介绍

创建飞书文档自动化

用途

通过浏览器自动化浏览界面、完成身份验证，并创建指定标题和内容的文档，从而自动完成在飞书（Lark）工作区中新建文档的流程。

前提条件

  • 有权访问飞书工作区（https://leiniao-ibg.feishu.cn）
  • 拥有该工作区的有效身份验证凭据
  • 具备通过 agent-browser 使用浏览器自动化的能力

工作流

第 1 步：加载浏览器自动化技能

使用 Skill 工具加载 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
# Locate "新建" button ref (e.g., @e1)
agent-browser click @e1

等待下拉菜单出现：

agent-browser wait 1000

再次截取快照，定位“文档”选项：

agent-browser snapshot -i
# Locate "文档" button ref (e.g., @e2)
agent-browser click @e2
第 5 步：选择新建文档类型

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

agent-browser wait 1000
agent-browser snapshot -i
# Locate "新建空白文档" button ref (e.g., @e3)
agent-browser click @e3
第 6 步：等待新标签页打开

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

agent-browser wait --load networkidle

检查标签页，确认新文档页面已打开：

agent-browser tab

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

agent-browser tab 2  # Adjust index based on tab list
第 7 步：输入文档标题

页面应自动聚焦标题输入框。如果标题输入框默认已聚焦，请直接输入标题：

agent-browser type @e1 "Document Title Here"

如果未自动聚焦，请截取快照以定位标题输入框：

agent-browser snapshot -i
# Locate title input ref (e.g., @e1)
agent-browser fill @e1 "Document Title Here"
第 8 步：输入文档内容

按 Tab 键或点击，移至内容区域：

agent-browser press Tab

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

agent-browser snapshot -i
# Locate content editor ref (e.g., @e2)
agent-browser click @e2

输入文档内容：

agent-browser type @e2 "Document content goes here..."

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

agent-browser type @e2 "First paragraph

Second paragraph

Third paragraph"
第 9 步：验证并保存

截取最终屏幕截图，确认文档已成功创建：

agent-browser screenshot

飞书文档会自动保存，因此无需显式执行保存操作。文档现已准备就绪，可以使用。

第 10 步：关闭浏览器（可选）

完成后关闭浏览器会话：

agent-browser close

错误处理

身份验证问题

如果身份验证失败或需要登录：

  1. 暂停工作流
  2. 告知用户需要手动登录
  3. 等待用户确认后再继续
  4. 身份验证完成后恢复工作流
未找到元素

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

  1. 不带 -i 标志截取完整快照以进行调试
  2. 检查界面是否已更改，或语言设置是否不同
  3. 使用语义定位器作为备用方案： 
    agent-browser find text "新建" click  # Find "新建" (New) button
agent-browser find text "文档" click  # Find "文档" (Doc) button
agent-browser find text "新建空白文档" click  # Find "新建空白文档" (New Doc) button
超时问题

如果页面加载时间过长：

  1. 增加等待超时时间：agent-browser wait --load networkidle --timeout 10000
  2. 检查网络连接
  3. 确认飞书服务是否可用

自定义

不同的工作区

若要用于其他飞书工作区，请替换第 2 步中的 URL：

agent-browser open https://your-workspace.feishu.cn/drive/home/
文档模板

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

  1. 点击“Doc”后，导航至模板库
  2. 定位并点击所需模板
  3. 继续输入标题和内容

最佳实践

  1. 复用会话：创建多份文档时，保持浏览器会话开启，并复用身份验证状态
  2. 错误截图：在每个关键步骤截取屏幕截图，以便调试
  3. 等待界面：导航后始终等待网络空闲，确保界面元素已加载
  4. 显式等待：点击下拉菜单后使用显式等待（例如 agent-browser wait 1000）

其他资源

浏览器自动化参考

如需详细了解浏览器自动化命令和模式：

  • 加载 office:agent-browser 技能，查看完整的命令参考
  • 请参阅 agent-browser 文档中的快照和交互模式
使用示例
# Complete workflow example
agent-browser open https://leiniao-ibg.feishu.cn/drive/home/
agent-browser wait --load networkidle
agent-browser snapshot -i
agent-browser click @e1  # 新建 button
agent-browser wait 1000
agent-browser snapshot -i
agent-browser click @e2  # 文档 button
agent-browser wait 1000
agent-browser snapshot -i
agent-browser click @e3  # 新建空白文档 button
agent-browser wait --load networkidle
agent-browser tab
agent-browser tab 2  # Switch to new tab
agent-browser type @e1 "My Document Title"
agent-browser press Tab
agent-browser type @e2 "My document content..."
agent-browser screenshot

评论

支持 Markdown