内容
# AINumbers.co: 金融科技智能套件
[](https://github.com/PostOakLabs/ainumbers/actions/workflows/deploy-to-dreamhost.yml)
[](https://creativecommons.org/licenses/by/4.0/)
金融科技合规性计算通常是手动完成的，使用电子表格或在供应商的黑盒中进行，但无法核实计算结果。AINumbers.co 为支付工程师、运营团队、财务分析师和合规专业人员提供了 500 多种确定性的浏览器工具，以及 ChainGraph：一种开放标准，每次计算都会生成可复现的哈希值，因此任何输出都可以独立重新验证，而不是凭信仰信任。
由 [Post Oak Labs](https://postoaklabs.com) 构建。[实时套件](https://ainumbers.co) · [MCP 服务器](https://ainumbers.co/mcp.html) · [ChainGraph 标准](https://ainumbers.co/chaingraph/openchain-graph-spec.html)
## 尝试使用
- **运行工具：** 直接打开[任意工具页面](https://ainumbers.co)。单个独立的 HTML 文件，无需安装，无需账户。
- **运行链：** [工作台](https://ainumbers.co/chaingraph/workbench/workbench.html)，从目录中选择一个链，运行它，验证生成的哈希值。
- **连接代理：** 将任意 MCP 主机指向 `https://mcp.ainumbers.co/mcp`。文档位于 [ainumbers.co/mcp.html](https://ainumbers.co/mcp.html)。
工具发布时计数可能会漂移。永远不要相信此处或此存储库中的任何硬编码数字。实时数据：`node scripts/counts.mjs`（网站）和 [`mcp-apps-poc/data/counts.json`](https://github.com/PostOakLabs/ainumbers-mcp-apps/blob/master/data/counts.json)（MCP 服务器）。
## 这是什么
一个优先考虑隐私的确定性工具套件，涵盖 32 个金融科技类别：反洗钱/了解客户、跨境支付、分布式账本技术/代币化、财务、嵌入式金融、电子发票、DORA/PSD3/MiCA 合规等。此外，ChainGraph 是一种开放标准，用于可验证的哈希链决策工件。每个 ChainGraph 节点都会生成一个可复现的 `execution_hash`。链引用其所消耗节点的哈希值，因此任何代理都可以独立重新验证多步骤决策。参见 `chaingraph/standard/SPEC.md` 以获取规范性规格。
两种消费方式：
- **浏览器，直接。** 每个工具和 ChainGraph 节点都是一个单独的、自包含的 `.html` 页面，加载后无需网络调用。
- **代理，通过 MCP。** 工具套件也通过单独的 Cloudflare Workers 服务器提供给任何 MCP 主机（Claude、ChatGPT、Cursor 等）。参见下面的[模型上下文协议服务器](#模型上下文协议服务器)。
## 存储库结构
```
ainumbers/
CONTRACT.md 构建合同，所有贡献者的 SSOT，在任何构建前阅读
index.html 首页（工具网格，类别过滤器，搜索）
tools/ 自包含的独立工具页面（内联 CSS/JS，无构建步骤）
guides/ 类别中心页面（*-hub.html）
chaingraph/ ChainGraph：标准/（SPEC.md，JSON 模式），内核/，节点 + 链页面
ledger/ 本地唯一收据账本（IndexedDB 划分，CONTRACT §A7）
manifests/ 每个工具的 MCP 清单（每个工具一个 JSON）
mcp/ MCP 服务器消耗的数据文件（catalog.json，server.json）。
不是服务器本身；实时 MCP 服务器是一个单独的存储库，参见下文。
scripts/ 构建/CI 门控。preflight.mjs 在推送前在本地运行每个硬门控。
.github/workflows/ 部署管道（预飞行等效门控，rsync，烟雾测试）
sitemap.xml / robots.txt / llms.txt
```
## 模型上下文协议服务器
实时 MCP 服务器（`https://mcp.ainumbers.co/mcp`，可流式传输的 HTTP，无身份验证）位于一个单独的存储库中，[PostOakLabs/ainumbers-mcp-apps](https://github.com/PostOakLabs/ainumbers-mcp-apps)，部署到 Cloudflare Workers。该服务器在构建时从此存储库中获取工具 HTML、清单和 ChainGraph 内核（`generate.mjs`，从工作存储库运行），并在 `chaingraph.json` 或清单更改并重新获取时重新注册。
每个工具都附带一个用于 MCP 自动发现的 `manifest.json`。`mcp/catalog.json` 和 `suite-registry.json` 是机器可读的批量索引，供工作存储库的 `generate.mjs` 读取。
## 架构
- **单文件工具和节点。** 每个工具都位于 `tools/` 或 `chaingraph/` 中，具有完全内联的 CSS/JS。无需构建步骤，无依赖项，无 CDN。
- **确定性执行。** 基于规则的数学、模式验证、静态参考表。比特对比特的可复制输出在运行之间。
- **ChainGraph 作为唯一的编排表面。** 多工具工作流是 ChainGraph 链（`chaingraph/chains/`），而不是已弃用的 Composer/Scenario Guide 页面类型。参见 `chaingraph/standard/SPEC.md` §3 以获取四个一致性级别。
- **AINumbers 政策指令导出。** 政策、规则、指令和合规工具导出结构化的政策指令（JSON 和 Markdown），在下载前验证。这是 AINumbers 自己的模式，而不是 Google 的 AP2 支付协议（CONTRACT §3.1）。
- **账本。** `ledger/` 是站点零客户端存储规则的唯一例外（CONTRACT §A7）：本地唯一 IndexedDB 收据存储，导出/导入，零传输，除非用户发起锚调用。
## 部署流程（CI 所有权）
分支，然后是 PR。本地运行 `node scripts/preflight.mjs`：每个硬 CI 门控（JS 语法、哈希完整性、SSOT 一致性、计数漂移、死链接、复制标志等）都像在 CI 中一样运行，因此这里的绿色意味着绿色的 CI。合并到 `main` 会触发 GitHub Actions，它运行相同的门控，将文件同步到 DreamHost 生产主机，然后对实时域运行 HTTP 烟雾测试。永远不会手动 SFTP 或 rsync。
一个提交的 `pre-push` 钩子（`.githooks/pre-push`）会自动运行 `preflight.mjs`。在每个克隆上启用它，只需运行 `node scripts/setup-hooks.mjs` 一次。
## 添加工具
1. 创建 `tools/XX-{kebab-slug}.html`，每个 `CONTRACT.md` 的自包含文件。
2. 根据 `CONTRACT.md` §2.2 添加 `manifests/XX-{kebab-slug}.manifest.json`。
3. 在 `index.html` 中添加一个卡片，带有正确的 `data-cat` 属性和 T 编号。
4. 运行 `node scripts/preflight.mjs` 并修复任何红色问题。
5. 推送。CI 验证并自动部署。
完整工作流程：此目录中的 `CLAUDE.md`，然后是完整的规范 `CONTRACT.md`。
## 贡献
- 在 GitHub 上打开问题或 PR。
- 遵循 `CONTRACT.md` 中的确定性、可审计的逻辑标准。
- 为所有监管和财务声明添加引用脚注。
- 永远不要引入外部依赖、PII 收集或页面加载后的网络调用。
- 在所有新的政策、规则、指令或合规工具上需要政策指令导出。
## 链接
- [实时套件](https://ainumbers.co)
- [MCP 服务器文档](https://ainumbers.co/mcp.html)
- [ChainGraph 标准](https://ainumbers.co/chaingraph/openchain-graph-spec.html)
- [ChainGraph 中心](https://ainumbers.co/chaingraph/chaingraph-hub.html)
- [账本](https://ledger.ainumbers.co)
- [Post Oak Labs](https://postoaklabs.com)
Post Oak Labs. CC BY 4.0.
