Files

skill-dev 3db196e49d feat: 工资查询助手首版 v1.0.105

基于 skill-template 脚手架开发，包含：
- payroll_config（费率配置，可编辑）+ payslip_snapshots（解析历史，只读）2 张业务表
- 全国默认 + 北上广 4 套费率（社保/公积金/个税起征点/7 级税率表）
- 5 个业务 Action：calculate-payslip-simple / calculate-payslip-full / explain-term / view-config / edit-config
- 个税累计预扣法计算，支持多月历史累加
- 20 个薪资名词库（社保/公积金/个税/全勤/加班费等）
- 完整市场文档（README/TUTORIAL/DEMO/CHANGELOG）
- 296 测试全部通过

2026-09-07 17:02:05 +08:00

3.0 KiB

Raw Blame History

Mobile RPA Example Specification

本目录定义 Android/iOS example 必须具备的结构和验收契约。当前没有团队真实成功案例，因此本目录不是可复制实现，也不得宣称已跑通。

先读：

为什么现在不放伪代码实现

移动端 selector、driver、Activity/context、权限弹窗和设备兼容性必须在真实授权设备上验证。没有成功案例时放一套看似完整的代码，会诱导开发者和 AI 猜 resource-id、默认取第一个设备或用坐标硬点，违背模板目标。

未来成功 example 的固定结构

mobile_rpa/
  README.md
  android/
    README.md
    assets/element-map.yaml
    scripts/service/device_session.py
    scripts/service/mobile_locator.py
    scripts/service/example_flow.py
    tests/test_locator_contract.py
    tests/integration/test_real_device.py.sample
  ios/
    README.md
    assets/element-map.yaml
    scripts/service/device_session.py
    scripts/service/mobile_locator.py
    scripts/service/example_flow.py
    tests/test_locator_contract.py
    tests/integration/test_real_device.py.sample

只有对应端出现真实成功案例后才创建代码文件。

Android example 完成标准

唯一设备 serial 和设备互斥
doctor：ADB授权、包名、Activity、屏幕状态、driver
Appium Inspector/UIAutoDev 拾取步骤和原始 XML
element map：resource-id/content-desc/text/class/父容器
Native/WebView context 选择
点击、输入、滑动和真实后置状态
权限弹窗、系统弹窗和人工验证
screenshot + page source 失败留证
虚拟列表滚动后重新定位
至少一台授权真机完整跑通

iOS example 完成标准

Mac、WebDriverAgent签名和设备 UDID 准备
doctor：WDA、bundle id、系统版本、屏幕状态
Appium Inspector 拾取和原始 page source
accessibility id/name、predicate/class chain 定位
Native/WebView context 选择
系统 alert 和人工验证
screenshot + page source 失败留证
至少一台授权真机完整跑通

element map 最小字段

logical_name: login_button
surface: android
screen: 登录页
scope:
  package: com.example.app
  activity: .LoginActivity
primary_locator:
  strategy: resource_id
  value: com.example.app:id/login
expected_count: 1
ready_condition:
  visible: true
  enabled: true
postcondition:
  description: 首页业务标记出现
verified_device: 待填写
verified_app_version: 待填写

状态升级规则

满足以下全部条件后，才可把本目录状态改为“已有成功案例”：

提供用户确认的成功项目来源。
在真实授权设备上跑通完整业务闭环。
保存脱敏 element map 和失败证据样例。
有默认离线单测和显式真实集成测试。
经过设备重连、App重启和页面变化验证。
用户人工验收通过。

3.0 KiB Raw Blame History Unescape Escape