Visible-Agent-Loop-Protocol

VALP 中文注解

本页是中文注解，不是协议规范原文。若本页与 SPEC.md、schemas/ 或 valp audit 行为冲突，以英文规范和机器可验证规则为准。

VALP 是什么

VALP（Visible Agent Loop Protocol）是一个面向多 Agent 工作流的可见证据协议。

它解决的不是“怎么让模型更聪明”，而是一个更朴素的问题：

Agent 或 Runtime 说 done，用户凭什么相信？

VALP 要求任务过程留下可审计的证据：

谁被分配了任务；
dispatch 有没有真的提交；
预期证据是什么；
证据文件是否存在；
验证、审查、审批是否通过；
最终结论引用了哪些证据。

所以 VALP 更像一个 acceptance system，而不是聊天提示词集合。

它不是什么

VALP 不是：

一个托管平台；
一个模型集成方法；
一个固定绑定 HERDR 的私有工作流；
一个能自动证明所有 Agent 可靠的魔法层；
一个替代测试、代码审查、审批流程的工具。

HERDR 只是当前参考 Runtime。其他 Runtime 只要能导出同等的 receipts、 evidence、state mapping 和 audit 数据，也可以实现 VALP。

最小体验路径

如果你只是想理解协议，不需要先安装 Runtime：

git clone https://github.com/wcqxgjy6d8-pixel/Visible-Agent-Loop-Protocol.git
cd Visible-Agent-Loop-Protocol
python -m pip install -r requirements-dev.txt
bin/valp audit examples/minimal-task

通过时你会看到：

VALP audit: PASS
Summary: pass=13 warn=0 fail=0 skip=6

再看这个演示：

Minimal audit demo

它会让你看到：删掉 expected evidence 后，即使 receipt 说结果已提交， valp audit 也会失败。

核心概念

英文术语	中文注解
Runtime	实际执行和记录任务的运行层，例如 pane controller、queue、hosted platform 或人工手动流程
Dispatch	发给某个 Agent 的可见任务分配
Receipt	机器可读的状态收据，例如 `dispatch_submitted`、`dispatch_completed`
Evidence	能证明工作发生过的文件、日志、截图、命令输出、审查记录
Expected evidence	这个任务完成前必须出现的证据路径
Audit	用 `valp audit` 检查任务证据是否满足 Done Criteria
Correction cycle	退件、重试、blocked、invalid、superseded 后的修复闭环记录
Final synthesis	最终总结，必须指出结果、决策、分歧和证据缺口

完整术语表见 glossary.md。

面向中文用户的理解方式

可以把 VALP 想成“多 Agent 工作流的验收单”：

不要只听 Agent 说 done
要看 dispatch、receipt、evidence、review、approval、final synthesis
最后跑 audit

这对中文社区尤其重要，因为很多 Agent 演示容易停留在“看起来完成了”。 VALP 关心的是：这个完成状态能不能被另一个人、另一个 Agent、或者 CI 重新检查。