Skill Template Examples
examples/ 是面向技术人员与 AI 编程工具的核心实现案例目录：提供可运行、可测试、可复制的参考代码，用于指导新技能的 scripts/ 应如何编写。
examples/ 不是完整 skill 仓库。 不要整包照搬 examples/<mode>/ 到新技能根目录。应按各 example README 的 copy map，选择性复制到新技能的 scripts/（及按需的 tests/）。
复制任何案例前先读 ../development/AI_RPA.md：案例只示范授权范围内的正常界面自动化，禁止把它扩展为破解、逆向、私有协议、验证码绕过、Hook / 注入、自动换号或规避平台限制的实现。
根 README.md、SKILL.md、references/、development/ 仍按模板主目录规则编写，不要从 examples/ 复制。
外部交互示例矩阵
adapter 仍是 真实/仿真 × API/RPA 四档；RPA 再按浏览器、Windows 桌面和手机三种界面拆分。原四类目录不可删除、不可移动，桌面和手机目录用于补足界面维度。
| 目录 | 类型 | 状态 | 适用场景 |
|---|---|---|---|
real_browser_rpa |
真实浏览器 RPA | 已有案例 | 真实第三方网站、登录态、人工验证、滚动采集 |
simulator_browser_rpa |
仿真浏览器 RPA | 已有案例 | 自有 sandbox、可控页面、表单 RPA、adapter 分层 |
real_desktop_rpa |
真实 Windows 桌面 RPA | 已有成功来源并已提炼 | UIA 拾取、窗口/控件、probe、dry-run/assisted |
mobile_rpa |
Android/iOS RPA | 仅规格，待成功案例 | 设备、控件树、Native/WebView、example 完成契约 |
real_api |
真实 API | 占位 | 真实系统接口、token、权限、限流（尚未沉淀可复制实现） |
simulator_api |
仿真 API | 占位 | mock/sandbox API、无需浏览器（尚未沉淀可复制实现） |
两类浏览器 RPA 的区别
| real_browser_rpa | simulator_browser_rpa（修正后） | |
|---|---|---|
| 目标 | 真实第三方网页 | 自有仿真页面 / sandbox / jc2009 类 |
| 风控 | 高（验证码、登录态、反爬） | 低（DOM 可控） |
| 账号 | account-manager + profile | account-manager + profile（simulator_rpa 档） |
| 用途 | 生产级真实采集/操作参考 | adapter 分层 + 表单 RPA 教学 |
工程范式对比
| 工程范式 | real_browser_rpa | simulator_browser_rpa（修正后） |
|---|---|---|
| async Playwright | ✅ | ✅ |
薄 adapter + *_playwright.py |
task_rpa.py |
simulator_playwright.py |
| account-manager subprocess | ✅ | ✅（simulator_rpa 档位） |
两者工程范式一致，差异在目标系统（真实站 vs 仿真站/本地 demo）。
如何选择示例
| 你的场景 | 参考目录 |
|---|---|
| 真实网站 + 浏览器 + 登录/验证码/滚动 | real_browser_rpa |
| 仿真页面 + 浏览器 + 表单/批量提交 | simulator_browser_rpa |
| Windows 原生软件 + UIA | real_desktop_rpa |
| Android/iOS App | mobile_rpa（当前仅规格，不可作为成功实现参考） |
| 真实系统 API | real_api（当前占位，不可作为实现参考） |
| mock / sandbox API（无浏览器） | simulator_api（当前占位，不可作为实现参考） |
轻量结构约定
每个 examples/<mode>/ 推荐结构：
examples/<mode>/
README.md
scripts/
service/
util/
tests/
simulator_browser_rpa可额外包含sandbox/real_desktop_rpa可额外包含脱敏的assets/element-map与 selector capture- 仅未来确实需要样例数据时可加
fixtures/ - 不要在
examples/<mode>/下要求或添加：SKILL.md、根市场README.md、references/、development/、assets/、.github/、release workflow 等完整 skill 仓库层文件
scripts/ 与 examples/ 边界
scripts/ |
examples/ |
|
|---|---|---|
| 定位 | 真实技能业务逻辑的标准骨架 | 核心实现案例与复制参考 |
| 内容 | 干净的技能骨架，无教学/demo 代码 | 可运行参考实现，非完整 skill |
| 旧示例 | 不得出现 example_* 目录或文件 |
四类一级目录固定保留 |
复制规则：
- 真实浏览器 RPA → 参考
examples/real_browser_rpa/ - 仿真浏览器 RPA → 参考
examples/simulator_browser_rpa/（adapter 分层权威参考：scripts/service/adapter/） - Windows 桌面 RPA → 参考
examples/real_desktop_rpa/（真实成功来源：add-friend-wecom） - 手机 RPA → 先按
examples/mobile_rpa/定义完成标准；真实成功案例补齐前不得照骨架宣称跑通 real_api/、simulator_api/当前为规划占位，不得作为实现参考
示例提供的是参考架构与边界，不是业务代码原样复制。复制前先读对应 README 的 copy map 与「禁止照抄」章节。