LiquiLens Evidence Carrier

LiquiLens Evidence Carrier

LiquiLens Evidence Carrier 是一种与传输方式无关的契约，可在文件、数据仓库、事件总线、可观测性系统、数据目录、FDC3 桌面、笔记本、引用和 AI Agent 之间传递金融证据，同时保留其来源、权利、新鲜度和权限边界。

该载体是用于检查和复现的基础设施。它不是订单、建议、信用评级、市场数据使用权，也不代表 Bloomberg、LSEG、FactSet、FINOS 或任何其他平台的背书。

当前签名的核心版本为 v0.20.1。其离线路由资源使用 Palimpsest 发布的目录 API，额外的 MCP 工具则仍在等待批准。全部 22 项构件校验均已通过；下载的 wheel 和 MCP bundle 均已验证来源，确认对应确切的签名源代码，官方 MCP Registry 也已公布新的 bundle。发布回执请参阅 docs/RELEASE-0.20.1.md。 0.20.0 回执仍然可用。独立使用渠道保留各自记录的版本。

以下历史核心发布回执介绍 v0.19.0。 已发布的版本 v0.19.0 提供了留存的 历史 wheel 和 Registry 记录。 带注释的标签 对象 c3239bfc7c4d3c4b7fc5ce26e0f602962e7d4337 指向列入允许列表的 SSH 签名发布提交 8f5738c9e77cc95b9a68543d478b9521f5595d61，其树为 acca6fa7aab75ebc91bf044e153c6468cd6f9c0c；验证回执时，远程 main 解析为同一提交。确切的提交通过了 预检运行 33630656569， 并且发布运行 33630790150 于 2026-09-02T12:36:19Z 发布了 23 项资产。下载的 SHA256SUMS 中全部 22 项均已通过校验；其 SHA-256 为 c6d52cbf8794db6e478e3b2ea9e1ed8eee7757137650892a6a96fcbb839bb6bc。 证明 44695012 将 22 个非清单构件与带标签的源代码关联起来。该版本对应的官方 MCP Registry 记录已验证为启用状态，且最新版本为 0.19.0；固定的 MCPB SHA-256 为 11db11aefafcc6c4ba558877d1f9892fc708150b3afbaa28a741e74435b9a91a。 Release v0.19.0 保留了 Trade Safety v1 的每个 schema 字节，并新增了确定性对抗语料库、无需依赖且兼容 TypeScript 的 Node 原始 UTF-8 验证器与经过身份验证的仅限模拟交易订单保护机制、OpenBB 0.2.0 仅哈希验证，以及 MCP 语料库发现功能。Gateway 0.1.2 固定使用 core 0.19.0，仍是只读、仅哈希的沙箱，不提供经纪商路由。 Container run 33630789998 已发布并完成冒烟测试，生成了 core 多平台索引 sha256:bdbfed2afa87f25e8ef88dffeb4ba7ab198854705528c0de5abe31552a170b9a； attestation 44695462 将该摘要与带标签的源代码绑定。另有， gateway run 33630790011 已发布并完成冒烟测试，生成了 gateway 索引 sha256:b5c43013da1fdddd9e6e56cab0e4f0f562e39ab25cc640869c5008e3457218e3； attestation 44695195 将其与同一提交绑定。这些是软件包和注册表制品，并非托管网关、实时订单激活或金融授权。

之后另行独立发布了仅限 gateway 的版本，使用已签名的附注标签 trade-safety-gateway-v0.1.3、标签对象 757c18928c8036910ab50c80ec073679d7434abf，指向已签名提交 fa8e25ae8e0e992611706b8d66e951342d594243 和树 7680694bf3397a0844f2388fb29067ff402f066d。 Gateway run 33651560380 已发布并完成冒烟测试，生成了 amd64/arm64 索引 sha256:9b8f704547ecf6c43039b34149d6cca842de5d66cba13c040199cf5f3f216d61； attestation 44751184 将该摘要与带标签的源代码绑定。此次运行记录了语义别名、源提交别名和已签名标签对象别名，未移动 latest 或任何 core-* 别名。没有对应的 GitHub Release 对象，也不声称存在托管部署或付费路由激活。请参阅完整的 gateway 0.1.3 publication receipt。

完整的 Release、Registry、制品和 OCI 收据请参阅 docs/RELEASE-0.19.0.md。GitHub 将 Release 记录本身报告为 immutable: false；版本标签规则集 21288366 禁止更新和删除 v* 标签，且无绕过机制。目前的制品带有校验和及透明度证明，但并未声称它们是由平台强制设为不可变的制品。完整的 v0.18.0 历史收据仍见 docs/RELEASE-0.18.0.md。

不可变的附注标签 v0.17.0 对象 cb85e527c2b74abf476fd9a01b73b2235ce976b7 指向受保护主分支的合并提交 edde9b92ad9851d2974b91326a8c3877f4386d3a，但其 release run 33585764285 在提交签名门禁处失败，未构建、证明或发布任何制品。没有 v0.17.0 的 GitHub Release 或官方 MCP Registry 记录。请参阅 docs/RELEASE-0.17.1.md 中未更改的恢复收据，以及 docs/RELEASE-0.17.0.md 中未更改的失败尝试记录。

它的适用范围

一个经过验证的 JSON 对象可以嵌入：

• FDC3 上下文和应用目录工作流；
• CloudEvents 和 OpenTelemetry 日志；
• OpenLineage 自定义 facet 和数据目录；
• Arrow 或 Parquet 架构元数据；
• dbt 数据仓库测试、CSV、SQL 和电子表格；
• CSL-JSON 引文和 PROV-O 知识图谱；以及
• MCP 或其他 Agent 的响应。

每个完整载体都会保留 event_time <= knowledge_time <= as_of、来源哈希、明确的再分发权、基于内容生成的身份，以及全为 false 的执行／建议／信用评级边界。权利受限或未知时会拒绝放行；证据不完整或已过期时，会将其编辑为具有独立标识的引用，而不是悄然提升其状态。

安装和验证

想先查看一个经过解释的副驾驶决策？离线副驾驶演示仅需 Python，即可从此源代码检出目录运行。它使用明确标记为合成的数据输入，展示候选方案和 HOLD 场景，并且在没有网络、凭据或经纪商配置的情况下保持执行受阻。它与下方的已签名核心包相互独立。

安装指南介绍了常规的 conda-forge 0.15.0、列出的 Dev Container Feature（Carrier 0.14.0）以及 SchemaStore 编辑器配置。这些渠道各自使用不同的版本；如需当前核心版本、连接式研究资源和 Trade Safety 验证，请使用下方已签名的 0.20.0 wheel。

# Source checkout (main may contain post-release documentation)
uv sync --locked
uv run liquilens-evidence --help

# Signed v0.20.0 wheel; checksum verified against the release manifest
python -m pip install 'https://github.com/beepboop2025/liquilens-evidence-carrier/releases/download/v0.20.0/liquilens_evidence-0.20.0-py3-none-any.whl#sha256=d864af722153f66a5cad5855ce00fb70809a4a078d7d972a75ce714ebbdf57cc'
liquilens-evidence issue examples/descriptor.json > carrier.json
liquilens-evidence verify carrier.json --as-of 2026-08-24T12:00:00Z
liquilens-evidence convert carrier.json --format fdc3

已发布的版本 v0.20.0 提供 wheel 和校验和清单。Python 运行时没有第三方依赖。此外，还包含 Node.js 验证器，用于跨语言进行 liquilens-hash-tree-v1 身份检查：

node protocol/verify_hash_tree_v1.mjs --artifact evidence-carrier carrier.json
node protocol/verify_hash_tree_v1.mjs --artifact fleet-brief fleet-brief.json
node protocol/verify_hash_tree_v1.mjs --artifact trade-safety-receipt receipt.json

规范合约身份

合约	规范身份	此源代码检查点的可用性
完整载体	https://liquilens.in/protocol/liquilens-evidence-carrier-v1.schema.json	已发布并托管
脱敏引用	https://liquilens.in/protocol/liquilens-evidence-carrier-reference-v1.schema.json	已发布并托管
四产品舰队简报	https://liquilens.in/protocol/liquilens-fleet-brief-v1.schema.json	已发布并托管
Trade Safety 请求	https://liquilens.in/protocol/liquilens-trade-safety-request-v1.schema.json	已作为 v0.19.0 发布资产发布，并按规范托管
Trade Safety 策略	https://liquilens.in/protocol/liquilens-trade-safety-policy-v1.schema.json	已作为 v0.19.0 发布资产发布，并按规范托管
Broker 预览引用	https://liquilens.in/protocol/liquilens-broker-preview-reference-v1.schema.json	已作为 v0.19.0 发布资产发布，并按规范托管
Trade Safety 回执	https://liquilens.in/protocol/liquilens-trade-safety-receipt-v1.schema.json	已作为 v0.19.0 发布资产发布，并按规范托管
FDC3 Trade Safety 回执	https://liquilens.in/protocol/fdc3/com.liquilens.trade-safety-receipt.schema.json	已作为 v0.19.0 发布资产发布，并按规范托管
FDC3 上下文	https://liquilens.in/protocol/fdc3/com.liquilens.evidence.schema.json	已发布并托管
OpenLineage facet	https://liquilens.in/protocol/openlineage/liquilens-evidence-facet.schema.json	已发布并托管

上述五个 Trade Safety 身份是稳定的架构 $id 值。LiquiLens Pages run 33592149926 已于 2026-09-02T04:49:12Z 成功运行，所用站点修订版本为 3ec660175c81c5b282715ee400eea2f771dc2610；其部署后门禁通过 HTTPS 获取了全部 五个 URL，并确认其字节内容与 protocol/catalog.json 中的哈希完全一致。这是架构托管证明， 并非托管的 Trade Safety 网关，也不是实时订单激活回执。

当前合约为 v1。v0.17.1 版本在不改变此前已发布的 Carrier 或 Fleet Brief 语义的前提下加入了 Trade Safety。 v0.19.0 版本保留 v1 架构字节并扩展跨语言验证； 它不会创建新的协议身份。已签名的发布工作流是 run 33630790150， wheel 的 SHA-256 为 1adccb72376f50456fd16a979e372f802ae73ba35b766633bc3d8bd4ab5abcc8，MCPB 的 SHA-256 为 11db11aefafcc6c4ba558877d1f9892fc708150b3afbaa28a741e74435b9a91a。 生产集成可以固定到 v0.19.0；单独发布的容器、技能、插件、浏览器和包管理器渠道仍各自保留经过验证的版本。现在可通过规范 URL 公开发现架构。

绑定订单的交易安全回执

liquilens.trade-safety-receipt.v1 将独立的 Seiche 资金／系统上下文、按仓位规模计算的 Undertow 退出上下文、可选的 LiquiLens 机构上下文、由操作员编写的策略，以及经纪商预览引用组合为一份短期有效、绑定到一笔确切拟议订单的回执。输入缺失、过期、受限、不匹配或日期为未来时，都会安全失败。

liquilens-evidence issue-trade-safety \
  --request examples/trade-safety/request.paper.json \
  --evidence examples/trade-safety/evidence.paper.json \
  --policy examples/trade-safety/policy.paper.json \
  --broker-preview examples/trade-safety/broker-preview.paper.json \
  --issuer examples/trade-safety/issuer.paper.json \
  --as-of 2026-09-02T12:00:00Z > receipt.json

liquilens-evidence verify-trade-safety receipt.json \
  --as-of 2026-09-02T12:00:30Z

仅含哈希的回执支持观察和模拟一致性检查。实时 pass 需要租户本地的经认证完整性、符合实盘要求的必要证据、可执行的 Undertow 报价，以及绑定到同一请求和账户且尚未过期的经纪商预览。当前公开适配器均不满足任何一项实时门槛。pass 不是建议、经纪商批准或执行指令；不可变的权限对象会将执行、推荐、资产配置、信用评级和可执行报价权限均保持为 false。请参阅 docs/TRADE-SAFETY-RECEIPT-V1.md 和 只读沙盒网关。

网关 0.2.0 源码候选版本新增了由服务器管理的策略底线，以及面向 AI Agent 的可选 x402 v2/Bazaar 访问路由。付款仅用于获取特定回执的访问权限；绝不会放宽策略、改变结果、延长证据有效期，也不会成为执行权限。未完成操作员配置时，x402 会保持禁用状态；此处不声称已启用托管版 0.2.0 或提供付费使用。请参阅x402 运行契约和采用情况衡量契约。

Python 经纪商和 Agent 运行时可以在其唯一的提交调用函数周围使用安全失败、仅限模拟的 before_order 防护。面向 Agent 的网关要求回执带有租户认证的 HMAC，因此，缺失、过期、不匹配、跨账户或非 pass 的回执绝不会进入经纪商代码。已配置的声明存储会阻止回执重放；在本地模拟／演示运行之外，请使用由操作员管理的持久化存储。在经纪商的幂等性和不确定结果协调门槛完成之前，实时提交仍会被暂停。

TypeScript 和 Node 用户可以使用零运行时依赖的 @liquilens/trade-safety package。其权威 API 使用原始 UTF-8 字节，因此 1000 和 1000.0 会保留不同的协议身份；在执行模拟提交回调之前，它会拒绝格式错误的 UTF-8、重复键、篡改、跨上下文使用、过期、重放，以及所有实时请求。已提交的测试语料库和威胁模型见 TRADE-SAFETY-CONFORMANCE.md。

四产品舰队简报

liquilens.fleet-brief.v1 将已签发的原生载体打包在一起，不会将 LiquiLens、Seiche、Undertow 和 Palimpsest 简化为单一评分。每份简报都包含每种产品恰好一个兼顾权利的分区，并明确保留 full、metadata_only、unavailable、rejected 或 missing 状态。

liquilens-evidence issue-brief \
  --liquilens ./liquilens.carrier.json \
  --seiche ./seiche.carrier.json \
  --undertow ./undertow.carrier.json \
  --palimpsest ./palimpsest.carrier.json \
  --as-of 2026-08-25T00:00:00Z > fleet-brief.json

liquilens-evidence verify-brief fleet-brief.json \
  --as-of 2026-08-25T00:00:00Z

签发过程不会执行发现或网络获取。产品不匹配、重复、未知字段或载体遭篡改时，都会安全失败。权利遭拒时，绝不会披露来源元数据或载荷。完整契约见 docs/FLEET-BRIEF-V1.md。

离线 MCP 服务

该软件包包含一个零第三方依赖的 stdio 服务，供需要检查本地 carrier JSON 的 Agent 使用。它实现了当前的无状态 MCP 2026-07-28（包括 server/discover），以及最新的基于初始化的修订版 2025-11-25，以支持现有客户端。

{
  "mcpServers": {
    "liquilens-evidence-carrier": {
      "command": "liquilens-evidence-mcp",
      "args": ["--root", "/absolute/path/to/evidence"]
    }
  }
}

已发布的 v0.20.0 版本提供四个只读工具和十一个离线资源：

• verify_carrier 用于验证配置根目录下指定 JSON 路径的内容标识、时钟、权利和导出处理方式。
• project_carrier 应用现有的权利感知投影（fdc3、cloudevent、otel、openlineage、jsonld、csl、flat 或 arrow）。
• verify_fleet_brief 在其精确记录的评估时钟下验证一份本地四产品简报，不返回嵌入的证据正文。
• verify_trade_safety_receipt 验证一份本地仅含哈希且绑定订单的回执。它不接受任何密钥；HMAC / 实时回执会默认拒绝，必须在租户边界内验证。

它绝不会获取网络数据、扩大受限权利、提供建议、评定信用，或执行金融操作。已发布的 v0.20.0 GitHub 版本包含校验和固定的 liquilens-evidence-carrier-mcp-0.20.0.mcpb 软件包，供兼容的桌面客户端使用。注册表标识： io.github.beepboop2025/liquilens-evidence-carrier。

集成工具包

• docs/EVIDENCE-CARRIER-V1.md 定义了契约、权利路由、传输方式和故障模式。
• docs/FLEET-BRIEF-V1.md 定义了确定性、权利感知的四产品简报及其五种明确的章节状态。
• docs/TRADE-SAFETY-RECEIPT-V1.md 定义了严格的订单、策略、证据、经纪商预览、回执和验证语义；配套的采用计划将发现与强制执行分开。
• docs/TRADE-SAFETY-X402.md 定义了可选的付费访问、Bazaar 发现、持久化重放 / 对账和启用门槛；docs/TRADE-SAFETY-TRACTION.md 将触达、启用、结算、发布、受保护订单、付款方和收入保留为独立的证据层。
• CHANGELOG.md、v0.19.0 发布回执、保留的 v0.18.0 回执 以及未更改的 v0.17.1 恢复回执，将当前版本事实与不可变历史和独立版本化的渠道区分开来。
• integrations/fdc3 包含自定义金融桌面上下文架构。
• integrations/openlineage 包含自定义数据血缘 facet 架构。
• dbt_project.yml 和 macros 使该仓库可直接作为 dbt 软件包安装。镜像目录 integrations/dbt 仍供集成包使用者使用。
• protocol/verify_hash_tree_v1.mjs 无需信任 Python 的数字格式化即可验证内容标识。

在现有工作流中继承验证能力

将可复用操作固定到精确的版本标签：

- uses: beepboop2025/[email protected]
  with:
    path: evidence/close.evidence.json

对于本地提交门禁，将此仓库添加到 .pre-commit-config.yaml。已发布的钩子会验证以 .evidence.json 或 .carrier.json 结尾的文件，并将所有匹配文件传递给 liquilens-evidence verify-files。

在其他产品中使用

1. 在已知证据及其权利的边界处签发 carrier。
2. 每次披露或转换前都进行验证。
3. 在物化边界保留原始 carrier 以及 carrier_id 和 record_hash。
4. 将缺失 carrier 元数据视为失败，而不是使用裸数字的许可。
5. 添加产品专用适配器和黄金向量；不要分叉核心时间或权限语义。

来源信息与许可证

协议工件的 SHA-256 值记录在 protocol/catalog.json 中。原始 carrier、reference、FDC3 和 OpenLineage 合约保留其既定标识； Fleet Brief 和 Trade Safety v1 架构为新增内容。此公开仓库是 carrier kit 的 再分发边界；不包含私有研究代码和数据集。

此仓库中的代码、架构、文档和集成资源根据 Apache‑2.0 许可。证据对象中承载的提供方数据仍受其自身权利和许可证约束；此仓库的许可证不授予第三方数据或产品商标的使用权。

关联研究

Seiche 的 research_network 工具和 /api/v2/research-network 端点将 Palimpsest 的完整来源目录与单独完成的资金背景及明确的研究步骤相连，供 LiquiLens、Undertow 和 NarcoScope 使用。 使用 topic、offset 和 limit；通过 next_offset 获取剩余数据集。 人工服务台位于 https://seiche.info/#RESEARCH。Telegram 用户可以使用 /research china、/research regions 或 /research liquidity。

目录行是引用，不代表有权再分发来源值或更改评分。来源时钟、权利和缺失情况均会保留。检索到的目录哈希是字节标识，不是生产方证明。