# 基本运行约定

> [返回文档中心](README.md) · [动作目录](actions/README.md)

本项目是内部系统，不设置额外的安全审批、操作白名单门禁或文档门禁。以下只保留动作正常运行所需的基本约定。

## 1. 操作上下文

- 每个 UI 步骤在执行前核对任务声明的 `packageName`。
- 提供 `activityName` 时同时核对，但它只作为辅助信息。
- 节点来源包与当前前台包不一致时不执行动作。
- 通用动作不使用 shell、root 或脚本注入。

是否增加额外包名范围、URI 范围或系统页面限制，按具体部署需求决定，不作为当前通用协议的前置条件。

## 2. 日志

- 日志记录任务 id、步骤 id、动作、结果码和耗时。
- INPUT 原值、完整控件树和截图内容默认不写入日志。
- message 用于排障，不参与程序分支判断。
- 需要更细的数据处理规则时，在具体服务端和部署方案明确后补充。

## 3. 截图

SCREENSHOT 如果实现，默认保存到应用私有目录，任务结果返回标识而不是任意文件路径。是否遮盖、上传和定期清理按实际使用场景配置。

## 4. 页面稳定判断

PAGE_STABLE 可以比较页面结构、节点数量和稳定属性；不需要保存完整页面文本。首版只用于等待页面不再变化，不作为长期指纹或审计数据。