Witness Evidence

面向智能体系统的开放证据层

你的智能体可以行动。Witness 保留了什么被决定、附带了哪些证据、以及下一个智能体可以继承什么。

AI 智能体可以行动。Witness 让它们的工作可被问责。

智能体正在成为一支软件劳动力。它们被接受的事实仍然太常被困在聊天日志中：规划者选择方向，构建者报告"完成"，验证者稍后到达，下一个模型不得不重建为什么有人信任这个结果。

Witness Evidence 面向智能体平台和 AI 基础设施工程师，他们的智能体、模型和追踪的增长速度超过了他们保留已接受项目状态的能力。它通过 MCP 记录身份绑定的决策、附带的证据、结果、生命周期变更和有界的项目上下文。

委派执行，但不委派真相。

运行 v0.1.0 核心的真实本地演示 · 查看今天可运行的内容 · 探索能力路线图 · 检查证明状态

Related MCP server: Clockchain Developer Tools MCP Server

Witness 的定位

MCP connects agents to tools.
A2A connects agents to agents.
Traces show what ran.
Durable runtimes keep workflows alive.
Witness preserves what was decided, which evidence was attached, which status transitions followed, and what the next agent may inherit.

Witness 不取代智能体运行时、追踪、编排、Git 或可观测性。它位于执行细节之上，作为一个持久的证据边界：团队在此记录其采取行动的决策、产生的结果、证据引用、执行每次状态转换的身份，以及后续智能体被允许恢复的上下文。

失败模式

没有共享的证据层，多智能体系统就会变成一堆自信的转录文本：

Planner:   “Build the release.”
Builder:   “Done.”
Validator: “Which bytes? Which requirements? Why this design?”
Next run:  “I have no context from the previous chat.”
Owner:     reconstructs everything by hand.

持久化的对象不应该是对话。它应该是被见证的项目状态。

今天可运行的内容

版本 0.1.0 执行一个本地、开源的证据核心：

• 10 个 MCP 工具，用于项目、决策、洞察、结果、记录、生命周期、有界上下文和 FTS5 搜索；

• 签名智能体身份信封，绑定到确切的工具、请求负载、租户、配置文件、运行时代次和 nonce；

• 基于角色的默认拒绝访问和幂等变更；

• 持久化前的隐私脱敏；

• 带事务性追加式操作审计的 SQLite 持久化；

• 一个具有独立构建者和验证者身份的真实本地流程；

• 可复现的 Apache-2.0 发布工件和分阶段的全新安装诊断。

在附带的演示中，一个独立的合成验证者身份将结果移动到 verified。该转换记录了该执行者及其原因。版本 0.1.0 不强制构建者/验证者分离，不通过公共读取投影暴露结果的 based_on 证据引用，不获取引用的工件，也不自动判断正确性。这不是自动证据验证。

观看系统运转

sequenceDiagram
    actor Owner
    participant Planner
    participant Builder
    participant Validator
    participant Witness
    participant NextAgent as Next agent / model

    Owner->>Planner: Ship a validated release
    Planner->>Witness: Record decision + acceptance rule
    Planner->>Builder: Build exact candidate
    Builder->>Witness: Record outcome + evidence reference
    Validator->>Witness: Read decision and outcome
    Validator->>Witness: Accept or dispute the result
    NextAgent->>Witness: Restore bounded project context
    Witness-->>NextAgent: Decision + outcome + acceptance state

该仓库包含一个真实的本地 MCP 流程。它创建一个临时数据库，使用独立的签名合成构建者和验证者身份，写入一个决策和结果，将结果从 recorded 移动到 verified，并恢复项目上下文。

[1/3] Decision recorded: require independent validation
[2/3] Outcome verified by a distinct validator identity
[3/3] Project context restored from the database
WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

证据类别：真实本地产品流程。 该演示使用合成凭据执行公共 MCP 服务器和持久化层。它不是云截图、模拟响应或外部集成的证明。

运行真实演示

git clone https://github.com/MaximilianoColoma/witness.git
cd witness
uv sync --locked
uv run python examples/coordinated_autonomy_demo.py

预期的最后一行：

WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

这带来了什么

可问责的构建者

构建者可以产出工作，不同的身份可以执行后续的审查转换，如演示所示。在 Witness 添加该不变量之前，团队必须在自己的策略中强制执行任何所需的构建者/验证者分离。

与模型无关的连续性

更换模型、重启进程或下周再继续。后续智能体可以检索有界的项目对象，而不是逆向工程旧的转录文本。

证据感知的门控

决策、结果、收据和状态转换成为 CI、发布治理、事件审查和人工审批的可查询输入。

有边界的记忆

Witness 不是转录文本转储或通用 RAG 存储。它持久化声明的项目对象，在持久化前脱敏受支持的 PII，限制读取，并拒绝未声明的权限。

普通产品调用无法随意重写的审计

公共核心变更和审计事件要么一起提交，要么完全不提交。规范触发器保护操作历史免受正常应用程序路径的更新和删除。

下一步构建

跨模型项目连续性

下一个开发者能力是可移植的连续性契约：Claude、Codex、GPT、本地模型和专业智能体应该能够使用相同的受约束 Witness 项目状态，并在无法访问原始聊天的情况下继续工作。

这是计划中的，尚未经过外部验证。证明需要不同的智能体团队重建当前决策、附带的证据和验收状态；必须测量重建时间和失败案例。参见 EVIDENCE.md。

v0.1.0 不附带 Claude、Codex、OpenAI Agents SDK、LangGraph 或 Temporal 的第一方适配器。今天，这些系统只能通过集成者构建的自定义 MCP/客户端接线来访问 Witness。文档化的参考适配器是路线图工作，不是当前功能。

北极星

Witness 旨在成为开放的证据和学习基础设施，智能体组织通过它跨智能体、模型、运行和系统保留其决定、证明和学习的内容。

这个北极星包括可移植验证和经过验证的学习回报：被接受的结果可以告知后续工作，而不允许未经验证的文本悄然成为策略。在 v0.1.0 中，它不是自动跨模型学习。

双产品架构

Mission 是一个独立产品。Spindle 是 Witness 内部计划中的学习功能。

Mission 协调智能体工作。Witness 保留证据，并设计为累积经过验证的学习。

flowchart LR
    H["Human<br/>goal and direction"] --> M["Mission<br/>coordinates"]
    M --> G["Specialist agents<br/>work"]
    G --> E

    subgraph W["Witness"]
        E["Decision · Outcome · Evidence"] --> S["Spindle<br/>planned learning function"]
        S --> L["Patterns · Rules · Guards"]
    end

    L -. "future governed return" .-> M

证据核心今天可运行。完整的 Spindle 学习循环是计划中的。 它未来在 Witness 内部的工作是，将 Witness 的 verified 生命周期状态中的结果，在额外的资格和审查门控之后，转化为受治理的学习候选、可复用模式、规则和后续 Mission 运行的防护。该状态记录了一次验收转换；它本身并不证明 Witness 获取或独立验证了底层证据。版本 0.1.0 不会生成这些工件或自动反馈它们。

愿景功能

这些是已启用的模式，而非捆绑的编排：

• 无需转录文本访问的跨模型连续性；

• 可移植的证明，外部验证者可以在不信任构建者叙述的情况下检查；

• 通过 Spindle（Witness 内部计划中的学习功能）实现经过验证的学习回报；

• 拥有者可读的自主性，带有持久的决策链；

• 事件记忆，将已接受的根因和预防措施带入后续任务。

每个 token 都应该让系统比之前更有价值。 这是产品方向，不是当前的效率或经济性声明。

Mission 和 Witness 是两个主要产品。Mission 协调工作；Witness 拥有证据边界和计划中的 Spindle 学习功能。v0.1.0 不提供自动的 Witness 到 Mission 学习回报。

现已构建 — 以及尚未构建

该服务未由此仓库部署。发布和绿色 CI 不能证明生产运营、规模、节省或用户影响。

公共 MCP 表面

规范契约位于 spec/ 下。FTS5 是本地文本搜索，不是语义或向量搜索。

安装和验证

需要 Python 3.11+ 和 uv。

./install.sh --manifest --json
./install.sh --target "$HOME/.local/share/witness" --non-interactive --json
uv sync --locked
uv run python -m pytest -q -p no:cacheprovider tests repair-tests
uv build

分阶段安装程序会清除继承的 Python 环境变量，执行锁定安装，写入有界的本地配置和存储，并运行真实的 MCP 首次运行诊断。

命名和技术身份

Witness Evidence 是面向公众的限定词；技术标识符保持不变。 仓库 MaximilianoColoma/witness、包 witness-public、Python 模块 witness_public、MCP 工具名称、契约和已发布的 v0.1.0 工件保持其现有的技术标识符。简而言之：故事更清晰了；线上协议保持不变。

一个不相关的既有项目也使用 Witness 这个名称。参见 TRADEMARKS.md 了解防混淆声明。

项目中心

• 能力路线图：ROADMAP.md

• 证据和证明状态：EVIDENCE.md

• 治理和发布权限：GOVERNANCE.md

• 贡献和 DCO：CONTRIBUTING.md

• 安全报告：SECURITY.md

• 支持边界：SUPPORT.md

• 命名和防混淆：TRADEMARKS.md

许可证

根据 Apache License 2.0 许可。参见 NOTICE。Apache-2.0 允许使用、修改、再分发和商业使用；它不授予暗示官方项目状态或商标认可的权利。