DDG Agent Services

mcp-name: com.daedalusdevelopmentgroup/ddg-agent-services-mcp

DDG Agent 付费服务上线套件

此目录包含机器可读的上线材料和本地脚手架，可将 Hermes/DDG 打造成面向其他 AI Agent 的付费服务入口。

当前上线切入点

1. 一分钱交易冒烟测试（/v1/tx-smoke-test）——仅返回收据的付费请求，价格为 $0.01，供其他 AI Agent 验证能否完成 DDG 付费 HTTP 交易。
2. 网站审计（/v1/site-audit）——只读；上线结算测试价格为 $0.75。
3. 模型路由器／基础对话（/v1/model/chat-completions、/v1/model/agent-run）——付费使用 DDG 运营的模型路由，采用明确的模型别名；支持基础聊天、分析、代码／帮助提示词，以及范围受限的 Agent 任务。
4. 经运营人员审核的 OAuth／模型工件任务（通过 /v1/order-intake 使用 service_id=provider_model_artifact_order）——仅在条款允许的情况下，提供由 DDG 运营、由账户／提供商支持的模型服务；不转售原始令牌／账户／席位。
5. 潜在客户数据包（/v1/lead-pack）——付费的本地商业情报；上线价格为 $5。
6. 浏览器证明（/v1/browser-proof）——付费截图／QA 证明；上线价格为 $2。
7. 外联简报（/v1/outreach-brief）——仅提供付费草稿；未经人工批准不会发送；上线价格为 $1.50。
8. Ethereum 私有 RPC 查询（/v1/ethereum/rpc）——已实现只读、按方法白名单限制的 Reth 代理，带有同步门控、公平使用租约计时器、按 Agent 设置的请求上限、最大批处理大小以及上游并发上限；公共自助服务需等待执行层同步／健康检查通过。
9. 本地模型免费席位池（/v1/micro-model-swarm-preview、/v1/model/agent-run、/v1/ollama-models）——提供实时、尽力而为的 Ollama 本地路由；每个健康且已配置的本地运行时后端提供一个并发生成席位；对于已配置的 8GB 显存后端，默认上限为两个。默认值：每个 Agent 的租约为 24 小时、每个租约 100 个请求、swarm 生成超时为 60 秒、本地 Agent 运行超时为 120 秒。命名付费租约路径仍在规划中。
10. Agent 工件／收据控制台（/v1/orders/{order_id}、/v1/orders/{order_id}/artifact）——提供实时、限定 Agent 范围的状态／工件 URL，由 /v1/order-intake 返回；公开经过脱敏的收据／证明哈希和预期交付物，绝不公开原始支付材料。
11. 结账一致性配置文件／探测工具（/.well-known/ddg-agent-checkout-conformance.json、scripts/agent_checkout_conformance_probe.py）——让买方 Agent 或合作服务验证身份门控、402 挑战、失败关闭的虚假支付、幂等性、已接受订单链接和工件访问控制。
12. MPP 激活指南（/.well-known/ddg-mpp-activation-guide.md）——面向运营人员／买方，介绍账户创建、Stripe/Tempo/mppx 测试设置、必需的 DDG 密钥、实时门控、公开文案切换清单和回滚步骤。

一分钱交易冒烟测试

POST /v1/tx-smoke-test 是一个小额付费请求端点，供其他 AI Agent 的 CI／冒烟测试使用：获取常规 402 挑战，通过 x402 或直接加密货币支付一分钱；仅当实时提供商／货币配置就绪后才会显示 MPP。随后重试即可收到仅包含收据的 JSON 响应。除支付验证／结算本身外，该端点不会执行任何不可逆的外部操作。

Ethereum/Reth 隐私节点策略

/v1/ethereum/rpc 路由用于无需账户的买方侧 Ethereum 读取：DDG 运行 Reth 节点/代理，买方 Agent 无需 Infura/Alchemy/供应商账户，边缘层仍要求 AI Agent 身份。代理为只读/方法白名单；默认阻止 admin、miner、personal、不受限制的 debug/trace 和 eth_sendRawTransaction。免费 Beta 封装现在包括：

• 同步就绪门控：DDG_ETH_RPC_REQUIRE_SYNCED=1 会在 eth_syncing=false 且最新区块非零/为当前区块之前返回 503 reth_rpc_syncing；
• 公平使用计时器：默认值为 DDG_ETH_RPC_FREE_MAX_CONCURRENT_USERS=4、DDG_ETH_RPC_FREE_LEASE_SECONDS=600、DDG_ETH_RPC_FREE_MAX_REQUESTS_PER_LEASE=30；
• 节点过载防护：DDG_ETH_RPC_MAX_CONCURRENT=2、DDG_ETH_RPC_MAX_BATCH=10，并限制超时时间/响应字节数。

面向公众的自助服务应等待 Reth 执行同步、共识状态为非乐观状态，并确认 DDG_RETH_RPC_URL 可通过支付边缘层正常运行。

协议策略

• x402：面向原生使用稳定币的 Agent 和 Bazaar 风格发现机制的实时 HTTP 402 支付流程。规范的 PAYMENT-REQUIRED accepts[] 会公布 Base、Polygon、Arbitrum One、World Chain 和 Solana 主网 USDC；为兼容 x402scan/CDP，Base 主网 USDC 仍排在首位。
• 直接加密货币支付：实时收款地址通道，可自动验证验证器支持的资产，其余公开清单中的资产则采用人工/运营人员确认的回退方式。公开支持的类别包括 EVM/稳定币、BTC、BCH、LTC、DOGE、SOL、TRX、XRP、XLM、ALGO、DOT、ZEC 和 XMR。在 DDG 控制的地址以及验证/人工确认策略就绪之前，暂不公布 ADA/Cardano。
• MPP：代码和签名密钥均已就绪，但在配置真实 MPP/Tempo 货币或 Stripe SPT 配置文件/环境变量之前，不会公开宣称已上线；还必须通过 ready:true 检查、成功结算一笔小额支付、通过幂等重放检查、确保伪造令牌被拒绝，并且泄漏扫描结果保持干净。

仅面向 AI 的销售策略

• 公开自助服务和付费路由仅面向 AI Agent。
• 没有稳定 Agent 身份标头（X-Agent-Id / X-DDG-Agent-Id / X-DDG-User）的人类流量会被拒绝，并返回 403 agent_only。
• 我们销售的是 DDG 封装的推理和受限产物，而非原始模型订阅/账户。

模型路由器模型别名

公布的别名：auto、mini、ministal、x、y、z、 agent-small、agent-standard、agent-pro、agent-max、 budget、starter，以及 DDG 核心别名 glm-4.5-air、glm-4.5、glm-4.6、glm-4.7、glm-5、 glm-5-turbo、glm-5.1、glm-5.2、gpt-5.3-codex-spark、gpt-5.3-codex、 gpt-5.4、gpt-5.5、claude-haiku-4.5、claude-sonnet-4.6、 claude-opus-4.8。

非高级调用方也支持使用 x_router.agent_profile 提示： low/budget/standard/pro/premium。

研究更正：

• Z.AI 文档列出 GLM-4.5-Air；我没有找到官方的 GLM-4.6-Air 页面/定价条目。
• Anthropic 文档列出 Claude Opus 4.8、Sonnet 4.6 和 Haiku 4.5；我没有在当前文档中找到官方的 Sonnet 4.7。
• 不应向买方开放 Claude Pro/Max 订阅访问权限。Claude 别名仅用于由 API 支持的 DDG 应用输出。
• 大范围销售之前，必须核实 GPT-5.3 Codex Spark/Codex 的命名和公开 API 可用性；OpenAI Codex 文档说明，Spark 在发布时仅面向 Pro 用户提供研究预览版。

模型路由器合规策略

不得销售原始 API 密钥、认证令牌或账户席位。不得将此服务宣传为可无限制转售 OpenAI/GLM/Claude 账户。更安全的产品封装方式是：

Agent 购买由 DDG 运营的推理/Agent 任务输出，并配有预算、收据、滥用控制和模型层级路由。

本地推理／免费席位状态 — 2026-06-14

配置的本地运行时后端运行正常时，实时实现最多可提供 两个 免费本地模型席位：

• 生产目标：两个由健康状态决定的 8GB 显存本地运行时席位，且仅通过支付边缘层提供。
• OLLAMA_API_URLS 仅应在部署环境中列出私有生成端点；不要公开原始后端 URL。
• /v1/ollama-models 会报告 local_free_seats.configured_free_seat_cap、healthy_local_seat_count 和租用上限，但不会公开原始局域网 URL。
• 默认值经过刻意设置，便于使用且有明确限制：每个 Agent 的租用时长为 24 小时（86400 秒），每次租用最多处理 100 个请求，Swarm 生成超时为 60 秒，本地 /v1/model/agent-run 超时为 120 秒。24 小时租期到期后，相同的稳定 Agent 身份可以重新使用免费席位。
• /v1/micro-model-swarm-preview 和 /v1/model/agent-run 下的本地 Ollama 路由使用非阻塞的后端席位锁，因此一个繁忙的后端不会阻塞另一个运行正常且已配置的后端。
• 如果只有一个后端在线，目录和租用池会缩减为一个席位；如果没有后端运行正常，生成将返回受控的不可用／繁忙响应。
• 原始本地运行时会保留在支付边缘层之后的私有网络中。公共请求永远不会触发模型拉取或任意模型下载。

主机／IP／GPU 运行清单仅应记录在私有运维笔记中，不应写入 Agent 使用的启动文档。

文件

• pricing.json — 规范的草案价格目录。
• agent-catalog.json — .well-known AI Agent 目录，汇总发现 URL、在线路由、人工审核服务、必需标头和安全态势。
• quickstart.md — 简明的 Agent 客户端接入与检查清单，涵盖 403/402/幂等性/支付行为，包括推荐的首批订单受理套餐和示例。
• sales-launch-pack-2026-06-08.md — 面向客户的 Beta 发布套餐说明，包含首批待售服务、文案、示例和当前注意事项。
• reth-ethereum-agent-rpc-analysis-2026-06-08.md — 关于规划中的 Reth/Ethereum 节点访问的决策说明，将其作为面向 Agent 的区块链情报/RPC 产品。
• openapi.agent-services.json — 包含 MPP 风格支付元数据的 OpenAPI 3.1 服务发现文档。
• agent-checkout-conformance-profile.json — 机器可读的 403/402/订单控制台/幂等性一致性配置文件，通过 /.well-known/ddg-agent-checkout-conformance.json 提供。
• mpp-tempo-stripe-account-activation-guide-2026-06.md — 分步介绍 MPP/Tempo/Stripe 账户、环境、冒烟测试、上线和回滚的指南，通过 /.well-known/ddg-mpp-activation-guide.md 提供。
• llms.txt — 面向 Agent 的服务目录。
• edge/payment_edge_scaffold.py — 支付边缘层，支持可插拔的验证适配器。生产环境使用由提供方支持的验证；模拟令牌仅用于开发环境，在 systemd 生产环境变量中必须保持禁用状态。
• scripts/operator_queue_digest.py — 用于排队中的付费 Agent 订单的安全运维摘要生成器；生成可用于 Telegram 的 Markdown，但不会自动发送或履行任何内容。
• scripts/agent_checkout_conformance_probe.py — 默认不会产生支出的结账探测工具；使用开发模拟/真实支付凭据时，可验证已接受的订单链接、资源/状态访问控制以及幂等性行为。
• edge/agent_runners.py — 面向环境变量控制的 Kimi/Claude 运营型资源路由的沙箱感知子进程封装器。
• mcp/README.md 和 mcp/ddg-agent-swarm-mcp-design.md — 面向需要服务发现、报价、付费模型运行、订单受理、安全服务目录访问和一美分交易冒烟测试的 AI Agent 集群的 MCP 快速入门/设计文档。
• edge/mpp_verifier_sidecar.mjs — 使用 mppx/server 的卖方侧 MPP 验证边车；真实结算需要收款方、货币以及 Tempo 服务器签名账户。
• edge/x402_verifier_sidecar.py — x402 验证/结算适配器，将 Python 边缘层的通用支付负载转换为调用 facilitator 的 paymentPayload / paymentRequirements。
• edge/direct_crypto_verifier_sidecar.py — 公链直接加密货币验证边车，支持 BTC/LTC/DOGE/BCH/ZEC、EVM 原生转账，以及 Ethereum/Base/Polygon 上的 USDC；不支持的链会安全地回退到人工确认。
• payment-provider-and-waf-runbook-2026-06-05.md — MPP/x402 验证 URL、直接加密货币/人工回退方案以及免费 Cloudflare 1010 替代方案的设置演练指南。
• deploy/two-host-local-ai-production-runbook.md — 两个免费的本地 AI 席位、租用策略、运行时状态和同步后验证的私有部署检查清单。
• direct_crypto_addresses.public.json / direct_crypto_addresses.env — 面向 EVM/稳定币、BTC、BCH、LTC、DOGE、SOL、TRX、XRP、XLM、ALGO、DOT、ZEC 和 XMR 的公开直接加密货币收款清单。
• audit/preservation_snapshot.md — 发布编辑前拍摄的分支/状态快照。

本地脚手架冒烟测试

python3 sales_artifacts/agent_payments/edge/payment_edge_scaffold.py --port <local-edge-port>

curl -i http://LOCAL_EDGE/llms.txt
curl -i -X POST http://LOCAL_EDGE/v1/model/chat-completions \
  -H 'content-type: application/json' \
  -H 'X-Agent-Id: demo-agent-id' \
  -d '{"model":"glm-5-turbo","messages":[{"role":"user","content":"hello"}]}'

curl -i -X POST http://LOCAL_EDGE/v1/model/chat-completions \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: demo-1' \
  -H 'Authorization: Payment mock-valid' \
  -H 'X-Agent-Id: demo-agent-id' \
  -d '{"model":"glm-4.5-air","messages":[{"role":"user","content":"hello"}],"x_router":{"policy":"cheap","max_charge_usd":0.25}}'

支付验证模式

脚手架现在支持自动支付验证，以及手动加密货币备用方式：

• mock（开发环境）：仅在启用模拟令牌模式时接受模拟请求头。
• provider（可用于生产环境）：将支付凭证验证委托给外部验证器端点。

通过以下设置：DDG_PAYMENT_VERIFICATION_MODE={mock|provider|disabled}。 若未设置，当 PAYMENT_EDGE_ALLOW_MOCK_TOKENS=1 时，模式默认为 mock；否则默认为 provider。

验证器端点：

• DDG_PAYMENT_MPP_VERIFY_URL（或 MPP_VERIFY_URL）
• DDG_PAYMENT_X402_VERIFY_URL（或 X402_VERIFY_URL）
• DDG_PAYMENT_X402_SETTLE_URL（可选，在验证后调用 x402 结算）
• DDG_PAYMENT_DIRECT_CRYPTO_VERIFY_URL（可选的直接加密货币自动凭证验证器；未配置时，直接加密货币仍处于手动确认 Beta 阶段）

Sidecar 冒烟测试栈：

# direct crypto
python sales_artifacts/agent_payments/edge/direct_crypto_verifier_sidecar.py --host <local-host> --port <direct-crypto-port>

# x402 public/testnet adapter
set -a; . sales_artifacts/agent_payments/direct_crypto_addresses.env; set +a
X402_PAY_TO="$DDG_CRYPTO_EVM_ADDRESS" \
X402_NETWORK=base-sepolia \
X402_ASSET=USDC \
python sales_artifacts/agent_payments/edge/x402_verifier_sidecar.py --host <local-host> --port <x402-port>

# MPP; real settlement additionally needs MPP_TEMPO_PRIVATE_KEY and MPP_SECRET_KEY
cd sales_artifacts/agent_payments
MPP_RECIPIENT_ADDRESS="$DDG_CRYPTO_EVM_ADDRESS" \
MPP_CURRENCY=0x20c0000000000000000000000000000000000000 \
MPP_CHARGE_AMOUNT=0.01 \
node edge/mpp_verifier_sidecar.mjs

使用以下配置运行边缘服务，测试全部三种方式：

DDG_PAYMENT_VERIFICATION_MODE=provider \
DDG_PAYMENT_DIRECT_CRYPTO_VERIFY_URL=http://LOCAL_DIRECT_CRYPTO/verify \
DDG_PAYMENT_X402_VERIFY_URL=http://LOCAL_X402/verify \
DDG_PAYMENT_X402_SETTLE_URL=http://LOCAL_X402/settle \
DDG_PAYMENT_MPP_VERIFY_URL=http://LOCAL_MPP/verify \
DDG_REQUIRE_AGENT_ID=1 \
python sales_artifacts/agent_payments/edge/payment_edge_scaffold.py --port <local-edge-port>

已验证受控失败行为：健康检查返回 200，缺少 Agent 身份时返回 403 agent_only，未支付、伪造的 MPP、伪造的 x402 和伪造的直接加密货币请求会在应用层返回 402 payment_required，而不是 503 payment_verification_unavailable。

可选认证请求头：

• DDG_PAYMENT_MPP_VERIFY_TOKEN / DDG_PAYMENT_X402_VERIFY_TOKEN

验证器响应 JSON 中的预期字段：

• valid: true（或 ok: true）
• 可选的 receipt、payer、amount_usd

如果启用了生产模式但未配置验证器 URL，付费路由会返回 503 payment_verification_unavailable。

直接加密货币自动凭证验证 + 手动备用方式

Coinbase/CDP x402 暂不支持。初始 Beta 可以在 402 响应正文中发布已配置的直接支付地址：

DDG_CRYPTO_EVM_ADDRESS=0x...
DDG_CRYPTO_BTC_ADDRESS=bc1...
DDG_CRYPTO_BCH_ADDRESS=bitcoincash:...
DDG_CRYPTO_LTC_ADDRESS=ltc1...
DDG_CRYPTO_DOGE_ADDRESS=D...
DDG_CRYPTO_SOL_ADDRESS=...
DDG_CRYPTO_TRX_ADDRESS=T...
DDG_CRYPTO_XRP_ADDRESS=r...
DDG_CRYPTO_XLM_ADDRESS=G...
DDG_CRYPTO_ALGO_ADDRESS=...
DDG_CRYPTO_DOT_ADDRESS=1...
DDG_CRYPTO_XMR_ADDRESS=...
DDG_CRYPTO_ZEC_ADDRESS=...

EVM 支持兼容 ETH 的资产，以及受支持的 EVM 网络上的主要 EVM 稳定币（USDC、USDT、DAI、PYUSD、FRAX、FDUSD、GUSD、LUSD、USDP、TUSD、EURC）。SOL/TRX/XLM/ALGO 条目则覆盖已配置地址的链专属稳定币变体。

配置 DDG_PAYMENT_DIRECT_CRYPTO_VERIFY_URL 后，Agent 可以使用自动凭证请求头重试付费请求：

X-Direct-Crypto-Proof: {"asset":"BCH","network":"bitcoin-cash","txid":"...","amount":"0.05"}

如果未配置直接加密货币验证器 URL，Agent 可在 /v1/order-intake 上提交 payment_proof，供运营人员确认。

生成的公开地址现在位于：