agent_admin/docs/agent/security.md

基本运行约定

返回文档中心 · 动作目录

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

1. 操作上下文

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

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

2. 日志

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

3. 截图

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

4. 页面稳定判断

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