How it works怎么用

Start with a read.先要一份读法。

Someone asks if the tests passed. Any tool answers in the same language: what it asserts, how sure it is, and on what grounds. This page is how to declare a claim. Not how to prove it true.有人问测试过了没有。任何工具用同一种话回答:它主张什么、有多有把握、依据是什么。这页是怎么声明一句。不是怎么证明它为真。

The TrustClaim

Here is the envelope, in JSON.信封长这样,JSON。

01claimThe sentence. What the agent asserts.这句话。agent 主张什么。
02confidenceA grade, and an optional score. A word for how sure.一个等级,可选分数。有多有把握的词。
03evidence[]The grounds. Empty means none — say so.依据。空就是没有——要说出来。
04derived_from[]Upstream claim ids. Directed, never a circle.上游声明 id。有向,不成环。
05coordinatesWho, when, which run — a place you can ask from.谁、何时、哪一次——能从这里追问。
TrustClaim · public envelope
{
  "claim": "pytest collected 6 tests and all reported passed",
  "confidence": { "grade": "fairly_sure", "score": 0.78 },
  "evidence": [ { "type": "tool_result",
               "source": "pytest", "ref": "run/8821" } ],
  "derived_from": [ "claim/auth-build-green" ],
  "coordinates": {
    "actor": "builder",
    "run": "example-not-a-customer",
    "at": "2026-08-17T00:00:00Z"
  }
}

No permitted_action. No third field that turns a grade into what happens next. This is how to speak.没有 permitted_action。没有第三字段把等级变成下一步。这是怎么说话。

What this is这是什么

A vocabulary you can point at.能指认的声明语言。

Open开源 How the claim is stated.这句话怎么声明。 Anyone can read the envelope. Any tool. A vocabulary: identifiers you can point at, not a chain that proves a sentence true.谁都能读这个信封。任何工具。是能指认的标识,不是证明这句话为真的链。
Out of scope不在这里 What anyone may do.谁可以动手。 Not a field on the envelope. Not a map from grade to action. The envelope is not a permission.不是信封上的字段。不是等级对动作的表。信封不是许可。
Why a graph为什么是图

Every claim points to evidence and to earlier claims. Nothing proves itself. Coordinates name a place you can question.每一句都指向证据和更早的声明。没有自证。坐标标出能追问的位置。

Read the philosophy读名字
Directed · traceable可追溯
claim → evidence → upstream id, all the way to the source.声明 → 证据 → 上游 id,一直到源头。
Acyclic · no self-justification不自证
the graph never closes a loop.图不成环。
Graded · honest老实
confidence is a vocabulary, not implied by tone.把握是词汇,不是语气暗示。
Accountable · in the open公开可追
who, when, which run — so a person can ask.谁、何时、哪一次——人能问。
Grade vocabulary把握词汇

A word for how sure.有多有把握,用一个词。

near_certain
fairly_sure
leaning
unsure
no_grounds

This page does not check the grade. The same word does not decide what happens next.这页不检查等级对不对。同一个词不决定下一步。

Emit a claim — the sentence发出声明 — 这句话
Attach evidence — tool results, sources, refs挂上依据 — 工具结果、来源、引用
State a grade — a word, not a mood说出等级 — 一个词,不是心情
Name coordinates — who, when, which run标出坐标 — 谁、何时、哪一次
Link upstream ids — derived_from, acyclic连上上游 id — derived_from,不成环
What this is not这不是什么

Not a framework. Not a verification chain.不是框架。不是验证链。

Adapters are thin: they emit a claim statement, never an action. The public repo is dagora-io/trust-layer. v0.1 SPEC, schemas, and python3 tools/check.py are on main. No SDK promise on this page. The engine is not in that repository.适配层薄:发出声明,从不发出动作。公开仓是 dagora-io/trust-layer。v0.1 SPEC、schema 和 python3 tools/check.py 已在 main。本页不承诺 SDK。引擎不在那个仓里。

The open boundary开源边界

The standard says how to express confidence and evidence.标准只说怎么表达把握和依据。

How that confidence is scored over time is out of scope here. What anyone may do is not this envelope. A later consult, if it exists, still does not press the trigger. That interface is not built.把握以后怎么打分,不在这页。谁可以动手,不是这个信封。后来的咨询如果做成了,仍不替你按下去。那个接口还没建成。

Free to implement.免费实现。