name	yingdao-rpa
description	影刀RPA平台的Python自动化开发技能。触发：用户提到影刀/xbot/自动化模块/excel网页/OCR，或要求开发新的影刀应用模块、开发xbot自动化脚本。必须激活此skill来处理影刀相关的代码开发任务。
version	1.1.0
metadata	{"hermes":{"tags":["rpa","automation","yingdao","xbot","python"],"related_skills":[]}}

影刀XBot RPA 开发技能

概述

影刀XBot是企业级RPA平台，提供Python API用于开发自动化脚本。

何时使用此技能：

开发影刀xbot自动化流程脚本
使用xbot API进行网页自动化（xbot.web）
Windows桌面应用自动化（xbot.win32）
Excel/Word文档操作（xbot.excel、xbot.word）
数据库操作（xbot.ado）、FTP、PDF等
AI能力集成（OCR）、飞书多维表格操作

所有API指令索引：references/_index.md（含完整指令列表和说明）

RPA开发SOP工作流

开发影刀RPA必须遵循"需求沟通 → 流程设计 → 程序开发"三步SOP。每步必须等用户确认后才能进入下一步。

第一步：需求沟通

主动提问：触发条件、分支逻辑、数据来源与去向、异常处理、权限与环境、业务规则确认
输出需求文档，明确请求用户确认

第二步：流程设计

提供Mermaid格式流程图 + 缩进式文本流程图
标注开始/结束、主流程、判断节点、异常处理、回滚节点
等用户确认后再开发

第三步：程序开发

严格使用xbot指令集，不用伪代码
日志精简，只记录关键步骤
异常处理用捕获异常块+重试
配置参数外置
输出代码 + 用户操作说明（含常见问题表）

参考文档：references/sop.md

常用API（高频指令）

完整指令清单见 references/_index.md，详细用法见对应reference文件。

package - 元素与资源管理

# 获取元素选择器
selector = package.selector('元素名称')

# 读取资源文件
text = package.resources.get_text('data.txt', encoding='utf-8')
package.resources.copy_to('template.xlsx', 'D:\\output.xlsx')

xbot.web - 网页自动化

browser = xbot.web.create('https://example.com', mode='cef')
browser = xbot.web.get(title='标题', url='baidu.com')

element = browser.find(package.selector('登录按钮'))
element.click()
element.input('内容', simulative=True)

browser.navigate('https://newurl.com')

xbot.excel - Excel操作

workbook = xbot.excel.open('D:\\data.xlsx', kind='office', visible=True)
sheet = workbook.get_sheet_by_name('Sheet1')

value = sheet.get_cell(1, 'A')
sheet.set_cell(1, 'A', '值')
sheet.set_range(1, 'A', [[1, 2], [3, 4]])  # 二维数组

workbook.save()
workbook.close()

xbot.win32 - Windows桌面自动化

window = xbot.win32.get(title='记事本', class_name='Notepad')
window.activate()
window.set_state('maximize')

element = window.find(package.selector('按钮'))
element.click()

xbot.win32.send_keys('Ctrl+C')

xbot.word - Word操作

doc = xbot.word.open('D:\\doc.docx', kind='office', visible=True)
selection = doc.get_selection()
selection.write_text('内容', newline=True)
doc.save()
doc.close()

xbot.app.dialog - 对话框

xbot.app.dialog.show_alert('完成', title='提示')
result = xbot.app.dialog.show_confirm('确定？', title='确认')
xbot.app.dialog.show_notifycation('任务完成', level='info')

元素定位原则

必须定位到用户可见的元素。

# 混合定位（推荐）
try:
    browser.find_by_xpath("//button[@id='submit']").click()
except:
    browser.find(package.selector('提交按钮')).click()

常用xpath：

场景	xpath
按id	`//input[@id='kw']`
按name	`//input[@name='wd']`
按value	`//input[@value='搜索']`
组合	`//input[@id='kw' and @name='wd']`

新建影刀模块

1. 创建 .py 模块文件

# 使用提醒:
# 1. xbot包提供软件自动化、数据表格、Excel、日志、AI等功能
# 2. package包提供访问当前应用数据的功能，如获取元素、访问全局变量、获取资源文件等功能
# 3. 当此模块作为流程独立运行时执行main函数
# 4. 可视化流程中可以通过"调用模块"的指令使用此模块

import xbot
from xbot import print, sleep
from . import package
from .package import variables as glv

def my_function():
    print("执行任务")
    # 业务逻辑
    pass

def main(args):
    my_function()

2. 更新 .dev/main.flow.json（追加到 blocks 数组）

{
  "id": "新UUID",
  "name": "process.invoke_module",
  "isEnabled": true,
  "inputs": {
    "module": { "value": "10:my_module", "display": "my_module" },
    "function": { "value": "10:my_function" },
    "params": { "value": "16:[]" },
    "returnType": { "value": "10:any" }
  },
  "outputs": {
    "invoke_result": { "name": "invoke_result", "type": "any", "isEnable": true }
  }
}

3. 更新 package.json（追加到 flows 数组）

{
  "name": "my_module",
  "filename": "my_module",
  "kind": "Code",
  "opened": false,
  "groupName": null,
  "enableCopilot": false
}

代码中调用模块

import xbot_visual

invoke_result = xbot_visual.process.invoke_module(
    module="my_module",
    package=__name__,
    function="my_function",
    params={},
    _block=("main", 1, "步骤名称")
)

飞书多维表格

完整指令文档：references/feishu_bitable.md

调用方式：

通过 xbot_visual.process.run(process="xbot_extensions.activity_feishu_bitable.指令名", ...) 调用
package=__name__，outputs 返回元组按声明顺序解构

通用功能

from xbot import print, sleep

print('日志输出')
sleep(3)  # 延迟3秒

from .package import variables as glv
glv.set('key', 'value')
val = glv.get('key')

实战问题速查

#	问题	关键解决方案
1	Excel对象断开连接	资源只打开一次，try-finally关闭
2	Excel API方法不存在	用`get_sheet_by_name()`而非`select_sheet_by_name()`
3	模块入口设计不合理	main用于测试，业务逻辑封装为独立函数
4	飞书扩展指令未加载	在可视化编辑器拖入飞书指令再删除
5	飞书默认视图名称错误	视图名用"表格"而非"默认视图"
6	飞书表名匹配失败	三重匹配策略：精确→去空格→去全角空格
7	批量删除效率低	批量删除每次500条，不用逐条

详细解决方案：references/troubleshooting.md

注意事项

入口函数：必须使用def main(args):，不能用if __name__ == "__main__":
必须导入：xbot、print、sleep、package
元素选择：用package.selector()，不要硬编码
资源释放：用完记得workbook.close()、browser.quit()
查指令：完整清单在references/_index.md，详细用法在对应reference文件

name	yingdao-rpa
description	影刀RPA平台的Python自动化开发技能。触发：用户提到影刀/xbot/自动化模块/excel网页/OCR，或要求开发新的影刀应用模块、开发xbot自动化脚本。必须激活此skill来处理影刀相关的代码开发任务。
version	1.1.0
metadata	{"hermes":{"tags":["rpa","automation","yingdao","xbot","python"],"related_skills":[]}}