Metadata-Version: 2.4
Name: rpa-skill-runtime
Version: 0.1.17
Summary: 面向独立 RPA Skill 的轻量 CloakBrowser 运行时
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: cloakbrowser[geoip]<0.5,>=0.4.10
Requires-Dist: playwright>=1.61.0

# rpa-skill-runtime

独立 RPA Skill 共用的轻量 CloakBrowser 运行时，使用 Playwright API 提供任务进程、隐身
浏览器会话、JSON 动作协议和 DOM UI 工具。登录和业务动作仍由各系统 Skill 自己实现，
不安装或启动 Playwright stock Chromium。

## 安装

Python 最低版本为 3.10：

```bash
python3.12 -m pip install "rpa-skill-runtime>=0.1.17"
python3.12 -m cloakbrowser install
```

安装后，系统 Skill 直接导入 `rpa_skill_runtime`，不需要携带构建器源码。

任务启动时可用布尔参数 `humanize` 选择 CloakBrowser 拟人交互；通用默认关闭，系统 Skill
可在自己的 `manage.py` 声明特殊默认值。该设置在任务生命周期内固定，浏览器模式重启时
继续沿用，不影响 stealth、GeoIP 或指纹策略。

任务启动时还可用布尔参数 `headless` 选择是否显示窗口；通用默认显示，系统 Skill 可在
自己的 `manage.py` 声明默认无头。

账号登录成功后立即保存 Playwright `storage_state`。已有登录态的任务会在成功业务动作后
自动刷新：首次变化立即写入，后续按 300 秒节流，并在正常关闭或空闲超时前落盘最后一份
待保存状态。刷新失败不改变业务动作输出，同账号并发任务采用最后写入覆盖。

## 发布

```bash
./publish.sh --dry-run
./publish.sh
./publish.sh --skip-tests
./publish.sh --repository internal
./publish.sh --install-current
TWINE_REPOSITORY_URL=https://pypi.example.com/legacy/ ./publish.sh
```

发布脚本位于 `rpa-skill-builder/` 根目录。默认发布到公开 PyPI；认证信息只从
`~/.pypirc` 或 Twine 标准环境变量读取。正式发布后会把精确版本安装到开发
Python 和构建器 `.venv`，并从源码目录外验证导入。
`--skip-tests` 只用于调用方已按变更范围完成定向验证且明确要求不运行完整测试的发布；它不
跳过构建、制品检查、上传后的精确版本安装和安装环境验证。
