evolved

<div align="center"> <img src="assets/hero.png" alt="Evolved - 适用于代理经济的完整公司解决方案，在极光背景下" width="100%"> ### 大多数人工智能都在谈论商业。Evolved 则在运行一个。 一个代理可以将服务业务从一张照片转化为付费的链上发票 - 已在阿尔伯塔省一家爆破公司验证，适用于任何行业，只需一通电话。**83 种工具，作为 MCP 服务实时运行，在 OKX X Layer 测试网上以 OKB 结算。** **▶ [立即试用 - 浏览器游乐场](https://www.evolvedmcp.cloud/)** - 无需安装，无需密钥：运行语音命令，通过照片报价 driveway，驱动自主生命周期完成两个人工资金门，观看 x402 402 → 证明 → 收据流程，全部针对真实的端点。 **🎬 90 秒短片** - 每个数字均从端点实时捕获 ([备注 + 许可证](submission/DEMO-VIDEO.md)): https://github.com/user-attachments/assets/ca858ecb-cf70-40d5-a1ac-54efef74f971 _{▶ 在此处内联播放 · 同时在 [www.evolvedmcp.cloud/demo.mp4](https://www.evolvedmcp.cloud/demo.mp4) 流媒体播放 · [高质量文件](submission/evolved-demo.mp4)} [](https://modelcontextprotocol.io) [](https://www.okx.ai) [](https://web3.okx.com/xlayer) [](https://www.evolvedmcp.cloud/health) [](docs/TOOLS.md) [](#every-claim-is-tested) [](LICENSE) [裁判之旅](#the-60-second-judge-tour) · [为什么这会赢](#why-this-wins) · [生命周期](#watch-one-agent-run-the-whole-engagement) · [链上](#paid-on-chain-okx-x-layer) · [前沿](#the-frontier-set) · [83 种工具](#the-tool-surface--83-tools-16-domains) · [文档](docs/) </div> --- ## 60 秒裁判之旅 服务是实时的。你可以在阅读更多内容之前，从终端验证每一个标题声明。 ```bash # 1 · 它存在，并且是一个 MCP 服务（10 秒） curl https://www.evolvedmcp.cloud/health # 2 · 它作为 ASP 货币化 - x402 按次付费（402 挑战，方案“exact”，eip155:1952） curl -i -X POST https://www.evolvedmcp.cloud/mcp-paid \ -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"judge","version":"1"}}}' # 3 · 支付挑战，获取服务（X-PAYMENT-RESPONSE 头中的结算收据） # （头是 base64 的 {"simulated":true} - 在每个 shell 上都安全引用，包括 PowerShell） curl -i -X POST https://www.evolvedmcp.cloud/mcp-paid \ -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -H 'X-PAYMENT: eyJzaW11bGF0ZWQiOnRydWV9' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"judge","version":"1"}}}' # 4 · 收入记分板（付费调用 + 结算，生存演示重置） curl https://www.evolvedmcp.cloud/stats ``` 然后在本地运行整个公司 - 无需密钥，无需帐户，无需资金： ```bash git clone https://github.com/kr8tiv-ai/evolved.git && cd evolved npm install && npm run build npm test # 41 个测试 - 包括一个实时 X Layer 测试网探针 npm run demo # 商业循环，在终端中解说 ``` ## 为什么这会赢 **每个“AI for business”演示都是一个穿着西装的聊天机器人。Evolved 是一个完整的公司操作系统，任何服务业务都可以在一通电话中启动 - 它是基于一个真实的公司构建的。** `franchise_spinup { tradePack: "pressure-washing" }` 将整个机器交给另一个行业，几秒钟内；可信度来自 Evolve Eco Blasting，这是一家阿尔伯塔省的工作爆破公司，其费率、GST 和存款政策、安全实践和球体下降规则在此演示 - 重新实现、扩展和测试。 - **现实世界的 ASP，OKX 双轨。** 客户发票在 X Layer 上使用 EIP-681 请求以 OKB 结算，由只读 RPC 验证，而 Evolved 本身通过 x402 按次付费。 一个 SMB 在链上赚钱 * 和一个代理服务在链上计费，提交一次。 - **自主与判断。** 一个代理运行引流 → 电子签名 → 天气门控预订 → FLHA 安全 → 预订 → 发票 → 链上结算 → 审查 - 并且仅在两个与金钱相关的部分中暂停，即两个人工门。 - **它学习 - 并且永不停息。** 获胜的工作教导费率引擎（车道汇聚到约 9 美元/平方英尺来自结果历史），并且每个记录的结果现在都会提高一个实时的 **信心** 分数，并收紧建议的报价范围 - 更多数据，更准确的报价，无论是真实还是合成历史。 - **它是强化的，而不是凭感觉的。** 文档化的对抗性审查通过产生了 29 个确认的发现 - 包括链上重放保护和电子签名拒绝终结性 - 每个都已修复并进行了回归测试，位于 [`f6acd80`](https://github.com/kr8tiv-ai/evolved/commit/f6acd80)。 41 个测试通过，其中一个是针对 X Layer 测试网的实时测试。 ## 观看一个代理运行整个流程 <div align="center"> <img src="assets/lifecycle-demo.svg" alt="动画终端：lifecycle_start 至链上结算" width="100%"> </div> ```mermaid %%{init: {"theme": "dark", "themeVariables": {"primaryColor": "#101010", "primaryBorderColor": "#4ade80", "primaryTextColor": "#f3f4f6", "lineColor": "#4ade80", "fontFamily": "Segoe UI"}}}%% flowchart LR A[引流<br><i>输入，语音，<br>或照片</i>] --> B[价格报价<br><i>学习费率 +<br>盈利能力检查</i>] B --> G1{{"🔒 人工门<br>批准报价"}} G1 --> C[电子签名<br><i>HMAC 令牌 · 拒绝<br>是最终的</i>] C --> D[在第一个<br>良好爆破日预订<br><i>天气门控</i>] D --> E[FLHA 起草<br><i>危险 + 缓解措施<br>来自范围</i>] E --> F[工作完成<br><i>实际，库存<br>消耗，收据</i>] F --> H[发票<br><i>应用存款</i>] H --> I[链上支付<br><i>X Layer 测试网 · 防重放保护</i>] I --> G2{{"🔒 人工门<br>确认结算"}} G2 --> J[请求审查 +<br>费率引擎教学] J -.->|更聪明的定价| B ``` 每个步骤都记录在审计日志中。可以通过任何 MCP 客户端尝试：`lifecycle_start`，然后 `lifecycle_advance { approveQuote: true, esignSigner: "..." }`，然后 `lifecycle_advance { simulatePayment: true }` - 或给予它一个真实的 X Layer 测试网 `txHash` 并观看只读 RPC 验证确认。 ## 链上支付（OKX X Layer） ### 为什么在这里链上支付很重要 - 而不是作为附加功能 爆破队在第一颗石子击中车道之前购买媒体和燃料。贸易业务的现金流和最终性决定了其成败，而这正是链上结算解决的问题： - **即时。** 存款在几秒钟内清算 - 不是 3 天的电子转账或 30 天的净发票。磨料和燃料今天就资助了，因此代理可以立即预订团队。 - **最终。** 没有拒付。卡可以在数周后撤销，当时媒体已经喷到某人的混凝土上，成本已经沉没。在链上，支付即为支付。 - **可编程。** 25% 的存款在代码中强制执行，并编码到 EIP-681 请求中（`invoice_payment_request { split: "deposit" }`）- 不是人类必须记住的数字。 - **自我验证。** 代理通过只读 RPC 在提交团队之前确认资金到账 - 不需要等待人员检查银行。 对于一个资金紧张的行业来说，这不是一个功能。这是一个决定成败的差异。 **仅限测试网 - 而 Evolved 从不持有密钥，从不签名，从不广播。** 它发出支付请求并通过只读 RPC 验证结算；资金只能从付款人的钱包中转移，并且重放保护保证一个交易只结算一个项目。 | 轨道 | 发生了什么 | |---|---| | **SMB 发票链上结算** | `invoice_payment_request` 将到期余额转换为 EIP-681 URI，在测试 OKB 上链 ID **1952**（Terigon）。`invoice_payment_check` 验证交易是否在链上 - 存在，成功，正确的收款人，足够的价值，从未使用过 - 然后将发票和工作转换为已付。`xlayer_status` 证明轨道是实时 RPC，而不是模拟。 | | **Evolved 通过 x402 按次计费** | `POST /mcp-paid` 回答 `402 Payment Required`，并附带一个格式化的 `accepts` 信封（方案 `exact`，网络 `eip155:1952`，`PAYMENT-REQUIRED` 头中的 base64 副本），直到证明到达 `X-PAYMENT` 头；结算的调用带有 `X-PAYMENT-RESPONSE` 收据。免费的 A2MCP 层级在 `POST /mcp` 保持免费。 | 模拟模式是默认的，因此裁判可以离线运行所有操作，每个模拟结算都会说明；`EVOLVED_X402_MODE=live` 关闭并要求真实的测试网交易。完整的协议细节：[docs/ONCHAIN.md](docs/ONCHAIN.md)。 ## 前沿 | | | |---|---| | **📸 照片转报价** | 客户发送照片；`quote_from_photo` 估计表面、面积、状况和爆破深度（Claude 视觉识别 + 密钥，或确定性离线估计器解析真实 JPEG/PNG 头），然后返回一个经验丰富的估计器会提供的东西 - **带有置信度的价格范围**（不是盲目数字），**已经在账簿中的可比工作**，市场基准和可能影响它的确切现场因素 - 在预订带有测量确认条款的品牌草稿之前。荒谬的尺寸被限制，而不是通过。几秒钟，而不是现场访问。 | | **🎙️ 语音现场命令** | “在 Kowalczyk 工作中使用了四袋破碎玻璃”会减少该工作的库存和损益。“打开 FLHA”会起草当天的危险评估。“下一个站点？”读取调度板。无法匹配的工作提示会拒绝而不是猜测，未识别的语音会被捕获到收件箱 - 任何内容都不会丢失，任何内容都不会被归档。 | | **📈 代理 CFO** | `cfo_forecast` 回答增加卡车（资本支出，利用率坡道，盈亏平衡月），费率变化（具有价格弹性的价格），和需求冲击，具有 12 个月的现金表，基于账簿，天气门控季节性，和每个假设的说明。`cfo_health` 是所有者实际需要的单页。 | | **📦 特许经营启动** | `franchise_spinup` 为新公司在不同行业重新启动整个操作系统 - 名称，费率卡，地区 - 空账簿，全机械：报价，收据，FLHA，摘要，学习循环，链上发票。 一个公司的操作系统成为任何人的。 | ## 使其成为你的 - 适应性工具包，而不是一次性工具 公司是可互换的。`franchise_spinup { tradePack: "pressure-washing", confirm: true }` 为另一个行业重新启动整个操作系统 - 它自己的报价引擎中的费率卡，**它自己的危险在每个 FLHA 系统起草的危险**，空账簿，全机械。三个软件包今天发货（`pressure-washing`，`line-painting`，`mobile-detailing`）；添加你自己的只是一个 [`src/trades.ts`](src/trades.ts) 中的一个条目。 服务器讲整个 MCP 规范，不只是工具：**资源**（`evolved://rate-table`，`evolved://hazard-library`，`evolved://trade-packs`）和**提示**（`morning-briefing`，`quote-a-job`，`run-the-lifecycle`）内置，所以任何 MCP 客户端都有一行入口点。 10 分钟适应指南：[docs/ADAPT.md](docs/ADAPT.md)。安全性和威胁模型：[SECURITY.md](SECURITY.md)。 ## 与生产系统完全等价 现场应用和运营工作簿所做的一切，作为一流的工具：**库存控制**（库存水平，重订建议，价格来自真实的 COD 收据，每个工作的损耗，供应商价格冲击监视），**联系人/CRM**（具有余额的客户，具有价格簿的供应商，具有认证的团队），**运营表格引擎**（数据脊柱渲染为运营工作簿 - 具有确定性归档引擎的现场应用收件箱），**会计深度**（分层 OCR 收据，具有供应商规范化和重复保护，差异报告，催收提醒，损益与可回收 GST），**工作簿脊柱**（从数据库创建和同步的真实 Google Sheets 工作簿，或带有零凭证的 20 个标签作为 CSV），**现场运营**（前后照片相册，具有间隙检测，语音和文本现场笔记，永远不会丢失，团队时钟，馈送真实劳动成本到工作损益），和**增长**（审查请求，具有跟踪响应率，声誉账本和推荐银行，工作损益记分卡，胜率和整体利润率，实时调度板）。 ## 工具表面 - 83 种工具，16 个领域 | 领域 | 工具 | |---|---| | **报价智能** | `quote_price` · `quote_create` · `quote_render` · `quote_update_status` · `quote_list` · `pricing_rates` · `pricing_record_outcome` · `market_benchmark` · `pricing_learning_status` | | **资金** | `receipt_ingest` · `expense_report` · `invoice_create` · `invoice_render` · `pnl_report` | | **渠道** | `lead_capture` · `lead_update` · `pipeline_view` · `job_schedule` · `job_complete` · `customer_list` | | **安全（FLHA）** | `flha_open` · `flha_signoff` · `safety_log` | | **自主运营** | `morning_digest` · `action_items_scan` · `action_item_resolve` · `weather_check` · `business_snapshot` · `demo_reset` | | **库存控制** | `inventory_status` · `inventory_receive` · `inventory_consume` · `inventory_reorder_suggestions` · `price_watch` | | **联系人/CRM** | `contact_search` · `supplier_add` · `supplier_pricebook` · `crew_add` · `crew_roster` | | **运营表格引擎** | `sheet_tabs` · `sheet_read` · `sheet_append_todo` · `inbox_submit` · `inbox_list` · `inbox_file` | | **会计深度** | `vendor_rollup` · `receipt_report` · `invoice_remind` | | **链上（X Layer 测试网）** | `invoice_payment_request` · `invoice_payment_check` · `xlayer_status` · `x402_info` | | **自主生命周期** | `lifecycle_start` · `lifecycle_advance` · `lifecycle_status` · `quote_esign_sign` · `review_record` | | **前沿** | `quote_from_photo` · `voice_command` · `cfo_forecast` · `cfo_health` | | **商业即盒** | `insights_generate` · `insight_feedback` · `activity_feed` · `backup_create` · `backup_list` · `franchise_spinup` | | **工作簿脊柱** | `workbook_create` · `workbook_sync` · `workbook_link` · `workbook_export` · `workbook_status` | | **现场运营** | `field_photo_log` · `field_note` · `crew_checkin` · `crew_checkout` · `flha_field_capture` | | **增长** | `review_request` · `reputation_report` · `job_pnl_report` · `dispatch_board` · `brand_configure` · `franchise_preview` | 参数级别的引用，由实时服务器生成，因此不会漂移：[docs/TOOLS.md](docs/TOOLS.md)。 ## 搭建 三层，依赖关系指向一个方向：工具验证和委托，引擎计算，存储持久化。交换贸易包，每个层都遵循。 ```text src/ ├── index.ts 标准输入 - 插入 Claude Desktop / 任意 MCP 客户端 ├── http.ts · app.ts 流式 HTTP：/mcp（免费）· /mcp-paid（x402）· /health · /stats ├── server.ts 组合所有 83 种工具 + 3 种 MCP 资源 + 3 种提示 ├── playground.ts 零安装浏览器游乐场（Judge 模式在此） ├── tools/ 16 个领域 - 薄、zod 验证的处理程序（报价、资金、渠道、 │ 安全、库存、联系人、表格、会计、支付、生命周期、 │ 视觉、语音、首席财务官、运营、运营增强、工作簿、现场、增长） ├── engine/ 纯商业逻辑 - 定价 + 学习循环、OCR、安全/FLHA、 │ 天气门控、摘要、操作（球体下降规则）、首席财务官、NLU（语音）、 │ 视觉、x402/X Layer 支付、品牌渲染和 Google │ Sheets 工作簿脊柱（服务帐户 JWT 通过 node:crypto，无需 SDK） ├── trades.ts 贸易包 - 适应 Evolved 到您所在行业的一个文件 ├── seed.ts · store.ts 合成的工作簿形数据脊柱（JSON，在运行时 git-ignored） └── test/ 41 个测试 - 引擎、端到端生命周期、x402 通过 HTTP、实时测试网探针 ``` ## 接入您的代理 ```json { "mcpServers": { "evolved": { "command": "node", "args": ["<path-to>/evolved/dist/index.js"] } } } ``` 与 Claude Desktop、Claude Code、OpenClaw、Hermes、Codex 等任何支持 MCP 的系统兼容。HTTP 模式（`npm run start:http`）在 `POST /mcp` 提供免费层，在 `POST /mcp-paid` 提供 x402 层，`GET /health` 提供健康检查。可选的实时升级：`ANTHROPIC_API_KEY`（真实视觉和 OCR 升级），`EVOLVED_LIVE_WEATHER=1`（真实天气预报），`EVOLVED_X402_MODE=live`（需要真实测试网络交易），`EVOLVED_PAYTO=0x…`（您的测试网络接收地址）。 然后询问它一些企业主可能会问的问题： > "运行晨间摘要。我即将推出什么？" > "一位物业经理希望对一个 2,100 平方英尺的停车场进行评估，通道狭窄 —— 请估价，如果利润健康，创建报价并渲染文档。" > "我应该在今年秋天购买第二辆卡车吗？" ## 每个声明都经过测试 ```bash npm test # ✔ 定价：学习循环将车道中位数的价格拉向约 9 美元/平方英尺，但不会低于基准价格 # ✔ ocr：逗号千位分隔符回归（生产 P0 错误） # ✔ 自主生命周期：线索 → 电子签名 → 天气预订 → FLHA → 发票 → 链上结算 → 审查 → 学习 # ✔ x402 在真实 HTTP 上：402 挑战，然后模拟证明解锁 MCP 表面 # ✔ X Layer 测试网络 RPC：实时只读探测（已断言 chainId 1952） # ✔ 审查修复：重放保护，拒绝电子签名是最终的，自定义价格盈亏平衡点标志 # ✔ 特许经营启动重新播种操作系统以进行新交易 # ✔ 定价：置信度随着数据增加而上升，报价范围收紧，市场基准标志低于/高于 # ✔ 工作簿：20 个选项卡涵盖整个操作系统；CSV 导出写入真实文件；无凭证创建回退 # ✔ 现场操作：照片相册间隙，笔记路由到收件箱，时间时钟馈送作业 P&L 劳动力 # ✔ 安全：JHA 在现场编写 — 现场捕获创建或升级当天的 FLHA # ✔ 增长：审查循环，声誉分类账，调度板标志，品牌配置，包装预览 # … 41 个通过 ``` 战斗的伤疤是真实的，并且有据可查：生产接收解析器曾经将 1,250 美元的媒体发票读取为 1.25 美元 — 该逗号错误已在此处修复，并通过回归测试固定，以及在 [`f6acd80`](https://github.com/kr8tiv-ai/evolved/commit/f6acd80) 中发布的 28 个其他对抗性审查发现（重放保护，拒绝最终性，盈亏平衡点标记等）。架构，数据模型和生产血统：[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). ## 谁构建了它 **[Matt Haynes](https://www.linkedin.com/in/matthaynes88)** — [Evolve Eco Blasting](https://www.evolveecoblasting.com) 的运营与市场经理，**KR8TIV AI**（埃德蒙顿，艾伯塔省）的创始人。不是实验室研究人员 — 一名现实世界的运营商，他管理一家移动磨料喷射队的后台办公室 *并且* 构建运行它的 AI。Evolved 是该系统的便携式、开源形式：在现场应用程序 ([kr8tiv-ai/evolve-field-app](https://github.com/kr8tiv-ai/evolve-field-app))，运营工作簿和全新的品牌重塑后，重新构想为任何贸易都可以安装的 MCP 服务。 > *"你给予才能获得。你解决了问题，就为下一个人敞开了大门。* 这种信念使 Evolved 成为 MIT 并免费开放。路线图上：更强大的后台系统，机器人使最艰难的工地工作更安全，制造业超越现状。 **与 Todd** — [Evolve Eco Blasting](https://www.evolveecoblasting.com) 的所有者-运营商 — 其真实的公司，真实的费率，真实的安全实践和真实的球体掉落规则是整个演示运行的生产真相。Evolved 不是假设的；它是工作团队使用的软件，使其便携且适用于所有人。 _{[github.com/Matt-Aurora-Ventures](https://github.com/Matt-Aurora-Ventures) · [linkedin.com/in/matthaynes88](https://www.linkedin.com/in/matthaynes88) · [kr8tiv.io](https://www.kr8tiv.io) · 埃德蒙顿，艾伯塔省 🇨🇦} ## 提交 由 [Matt Haynes](https://github.com/Matt-Aurora-Ventures)（KR8TIV AI）为 **OKX AI Genesis 黑客马拉松** 构建，来自 [Evolve Eco Blasting](https://www.evolveecoblasting.com) 的实时运营系统，2026 年 7 月。 | | | |---|---| | **实时试用** | [www.evolvedmcp.cloud](https://www.evolvedmcp.cloud/) — 浏览器游乐场，零安装 | | 实时端点 | `/mcp`（免费 A2MCP）· `/mcp-paid`（x402）· `/health` · `/stats`（收入排行榜） | | 列表 | A2MCP ASP 已实施 x402 付费层 — [docs/OKX-LISTING.md](docs/OKX-LISTING.md) | | 演示脚本 | 两幕 90 秒剪辑 — [docs/DEMO.md](docs/DEMO.md) | | **演示视频** | [submission/evolved-demo.mp4](submission/evolved-demo.mp4) — 90 秒，1080p，品牌化，字幕，免版税 funk 配乐 ([notes](submission/DEMO-VIDEO.md)) — 从 [/demo.mp4](https://www.evolvedmcp.cloud/demo.mp4) 流媒体播放 | | 类别 | 最佳产品 · 收入火箭 · 软件实用程序 · 财务副驾驶 | MIT 许可。仅合成数据；仅测试网络；此存储库中没有秘密。Evolved 永远不会持有密钥，无法移动资金 — 通过构造。 <div align="center"> <br> <code>OKX AI GENESIS · MCP AGENTIC SERVICE PROVIDER · X LAYER TESTNET 1952 · BUILT ON A REAL JOBSITE</code> <br><br> </div>