OpenAPPA

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Rust 运行环境（项目由 Rust 实现，README 未给出版本要求）
• Agent 与其工具之间的调用链路，用于插入校验点
• 可写的审计/事件日志，引擎决策完全依赖它
• 按官网 Policy reference 自行编写的 TOML 策略文件

安装与启动步骤

1. 1确认部署形态

   README 说明 OpenAPPA 位于 Agent 与工具之间，可进程内运行，也可作为 sidecar 进程在每次工具调用前检查，先选定形态。

2. 2准备 Rust 环境

   项目使用 Rust 实现，README 未提供安装或构建命令，请以官网 openappa.com 与仓库最新文档为准。

3. 3编写 TOML 策略

   策略为声明式 TOML，语法见官网 Policy reference，需明确每类数据允许流向哪些工具目标。

4. 4接入调用前校验

   在每次工具调用真正执行之前向 OpenAPPA 发起校验，判断这份数据是否允许发往该目标。

5. 5接入事件日志

   引擎只依据事件日志做判定，需把 Agent 读取与调用的行为完整写入日志，决策才能复现。

6. 6用基准验证

   在 Bench-Corp 基准上对比结果，确认既不放过未授权数据流，也没有拒绝合法的正常任务。

如何确认成功

在 Bench-Corp 基准上复核：未授权数据流被拦截、合法任务通过，且同一日志重复运行给出相同决策。

常见问题

注意事项

• 本教程严格依据 README 节选整理，README 未给出安装命令，因此步骤中没有可执行命令。
• 策略文件需自行按官网 Policy reference 编写，配置项名称请以后续官方文档为准。
• 确定性来自“只依据事件日志决策”，集成时不要引入外部可变状态，否则会破坏可复现性。
• 上线前建议先在 Bench-Corp 基准上同时评估“放行未授权流”和“误拒正常任务”两个方向。