Metadata-Version: 2.4
Name: rpa-skill-runtime
Version: 0.1.14
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.14"
python3.12 -m cloakbrowser install
```

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

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

## 发布

```bash
./publish.sh --dry-run
./publish.sh
./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`，并从源码目录外验证导入。
