Skip to main content

您的AI代理现在可以控制任何网站.
具有完整的审计跟踪.

无需改动Free gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. , 或 .cursorrules— 中添加一行 — 您的AI即可获得真正的浏览器自动化:Gmail, Slack, LinkedIn, GitHub, 以及任何网站. 每个点击都经过签署、封印和验证. MCP服务器启动. 在30秒内启动.

✅ MCP启动 美国食品和药物管理局 (FDA) 第11部分建筑 ⚡ 21 个代理格式 💰 $0.001 / 任务重播 🔎 $0.00 / QA 运行

将 Solace 添加到任何项目中的一条命令

curl -fsSL https://solaceagi.com/agents/claude.md >> 无需改动

将 Solace 浏览器自动化指令添加到您的 克劳德代码 项目中。立即生效 — 无需注册,无需 SDK.

Step 0: Download & Install Solace Browser

Solace Browser is a desktop app that runs on your machine. Download it first, then your AI agent can control it via localhost:8888.

25

Download Solace Browser

Visit solaceagi.com/download and download the version for your operating system.

# Linux (one-line install):
curl -sf https://storage.googleapis.com/solace-downloads/install.sh | bash

# macOS / Windows: download the installer from
# https://www.solaceagi.com/download

The download includes Solace Hub (desktop app) + Solace Runtime (local API on port 8888) + Solace Browser (Chromium fork with Yinyang sidebar).

2

Launch Solace Hub

# Start the Hub — it launches everything automatically
~/.solace/bin/solace-hub

The Hub sits in your system tray. It starts the local API server on port 8888 and opens the browser when ready.

3

Verify it's running

curl http://localhost:8888/api/v1/system/status
→ {"app_count": 22, "cloud_connected": false, "evidence_count": 0, "uptime_seconds": 5}

If you see JSON, your agent is ready to use Solace. No account needed. Free forever for local use.

每个主要 AI 编码代理都受支持

下载适合您 AI 助手的正确格式。每个文件都会告知 AI如何使用 Solace — 导航、点击、填充、截图和捕获证据。支持 21 种格式。

克劳德代码

进入您的无需改动. 克劳德代码将使用Solace Browser进行任何自动化网络任务。

下载无需改动代码片段
💬

开放AI编码器

进入您的. OpenAI编码器和ChatGPT代理读取此文件以了解可用工具和功能。

下载代理.md代码片段

光标

进入您的.cursorrules. 光标将在您要求它与网站交互时访问 Solace AGI.

下载 .cursorrules
🏄

滑风筝

进入您的.windsurfrules 這種水果是我們所需要的. 這種水果是我們所需要的.. 滑风筝 (Codeium) 像光标一样精确地采用 Solace Browsercapabilities — 相同格式,零延迟.

下载 .windsurfrules 這種水果是我們所需要的.

基塔赫布复试机

跳转到.github/copilot-instructions.md. Copilot 会建议用于浏览器任务的 Solace API 调用.

下载 copilot 指令

助手

作为系统提示传递给--system-prompt solace-aider.md. 助手会自动将所有 web 交互路由通过 Solace Browser.

下载助手系统提示

继续.dev 继续.dev

添加到您的.continue/config.json上下文提供程序。Continue 将作为本机工具在 VS Code 和 JetBrains 中显示 Solace 浏览器自动化。

下载 Continue 配置
📞

克莱恩

进入您的.clinerules/ 這個字母是 這個字母是目录。克莱恩 会话启动时读取项目规则 - Solace 能力会自动为每个对话加载。

下载 .clinerules 代码片段
🦕

根码

放置于.roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/. 根码(以前称为Roo-克莱恩)继承了Solace Browser的功能,并具备了代理编码模式。

下载根码规则
🔭

谷歌的双子座CLI

添加到GEMINI.md在您的项目根目录中。Google的开源代理CLI以相同的方式读取Solace指令,就像它读取Claude的指令一样无需改动

下载GEMINI.md代码片段
🚀

朱尔斯 谷歌

Jules读取在处理GitHub问题之前。Solace指令会在Jules在您的仓库中处理任何Web相关任务时自动出现

为Jules下载或

Zed 编辑器

将规则放在.rules 這個規則是 這個規則是在您的项目根目录中。Zed 的 AI 面板可以本地读取这些规则 —— Solace AGI 成为可供 Zed AI助手立即使用的服务。

下载 Zed .rules 這個規則是 代码段
🔹

Amazon Q 开发者

添加到.amazonq/rules/solace.md。Amazon Q 开发者会从此目录为项目中的每个编码会话读取 markdown 规则文件。

下载 Amazon Q 规则
🎯

JetBrains 人工智能

添加到.idea/ai-guidelines.md. JetBrains 人工智能 Assistant 在所有 IntelliJ、PyCharm、WebStorm 和 JetBrains IDE 中读取此文件。

下载 JetBrains 指南
🔎

源图库:科迪

将上下文放入.cody/context/solace.md. Cody 将此文件纳入其检索上下文中 —— Solace 指令出现在每次 Cody 对话中。

下载Cody上下文
📄

塔比尼

通过配置.tabnine/personalization 這個問題是如何解決的 這個問題是如何解決的. 塔比尼的个人化文件允许你教它你的团队的工具链,包括Solace Browser自动化。

下载塔比尼配置
🆕

复制 AI

添加到您的.replit 關於我們 關於我們文件的[ai]部分。 复制 AI 从这里读取项目上下文 — Solace AGI变得在每个Replit工作空间中都可用。

下载 .replit 關於我們 代码片段
🤖

德文

放置于.devin/流程书/. 德文 在开始长期任务之前读取项目流程书 — Solace Browser工具可用于任何Web工作流程。

下载德文流程书
🏭

工厂机器人

工厂读取.factory/ 這個字母是 .factory/ 這個字母是 .factory/ 這個字母是 .factory/配置。Droid 代理在自动化软件开发工作流时继承Solace AGI能力.

下载Factory配置
🔰

千行代码

添加到基洛码/规则/ .kilocode/. 千行代码遵循与克莱恩相同的项目规则模式 —— 每个代理编码会话都加载Solace AGI指令.

下载 千行代码 规则

llms.txt

Jeremy Howard针对LLM的网站描述标准。将其放入项目根目录,Solace即可被任何LLM理解。

下载 llms.txt

无需改动 代码片段中的内容

每个集成文件都教你的AI代理如何使用Solace。这里是Claude代码片段——将其放入你的项目中,你的代理将立即了解所有14个Solace API、MCP服务器、电子签名和最佳实践。

# Solace Browser Integration # Source: solaceagi.com/agents/claude.md ## What Solace Is Chromium fork with a native Yinyang sidebar. Solace Hub starts first and exposes Yinyang Server on port 8888. Sessions persist. Evidence is hash-chained. MCP: 8 tools live now. ## Quick Start curl http://localhost:8888/api/status # → {"running": true, "status": "ready"} ## Core API (all POST, JSON body) navigate {"url": "...", "wait_for": "networkidle"} click {"selector": "..."} fill {"selector": "...", "value": "..."} screenshot {"full_page": true} → {"filepath": "artifacts/..."} evaluate {"表达式": "document.title"} aria-snapshot GET → accessibility tree JSON ## 阴阳 Notify (alert user, non-blocking) POST /api/yinyang/notify {"type":"success","message":"...","priority":"low"} ## E-Sign (FDA Part 11 §11.100) POST /api/v1/esign/token {"user_id":"...","运行_id":"...","meaning":"reviewed_and_approved"} ## MCP (add to .claude/settings.json) {"mcpServers":{"solace":{"command":"python3","args":["yinyang_mcp_server.py"]}}} ## Best Practices 1. Screenshot before click (evidence of what agent saw) 2. ARIA snapshot for structure, screenshot for visual 3. Minimal OAuth3 scopes + 预算_usd on every token 4. Notify user via 阴阳 (never console.log spam) 5. E-sign every user-approved action
# Solace Browser Integration
# Source: solaceagi.com/agents/claude.md

## What Solace Is
Chromium fork with a native Yinyang sidebar. Solace Hub starts first and exposes Yinyang Server on port 8888.
Sessions persist. Evidence is hash-chained. MCP: 8 tools live now.

## Quick Start
curl http://localhost:8888/api/status
# → {"running": true, "status": "ready"}

## Core API (all POST, JSON body)
navigate    {"url": "...", "wait_for": "networkidle"}
click       {"selector": "..."}
fill        {"selector": "...", "value": "..."}
screenshot  {"full_page": true}  → {"filepath": "artifacts/..."}
evaluate    {"表达式": "document.title"}
aria-snapshot GET  → accessibility tree JSON

## 阴阳 Notify (alert user, non-blocking)
POST /api/yinyang/notify {"type":"success","message":"...","priority":"low"}

## E-Sign (FDA Part 11 §11.100)
POST /api/v1/esign/token {"user_id":"...","运行_id":"...","meaning":"reviewed_and_approved"}

## MCP (add to .claude/settings.json)
{"mcpServers":{"solace":{"command":"python3","args":["yinyang_mcp_server.py"]}}}

## Best Practices
1. Screenshot before click (evidence of what agent saw)
2. ARIA snapshot for structure, screenshot for visual
3. Minimal OAuth3 scopes + 预算_usd on every token
4. Notify user via 阴阳 (never console.log spam)
5. E-sign every user-approved action

完整文件:下载 无需改动 代码片段Paper 41: One App Database — Firestore + Code-Served Catalog查看 agents.json(机器可读)

通过 3 个 API 调用实现 你好,世界

完整的 Solace API 可以通过三个命令学习掌握。其他所有内容都是变体。

25

导航到任何页面

curl -X POST http://localhost:8888/api/navigate -H "Content-Type: application/json" -d '{"url": "https://example.com"}'
→ {"success": true, "status": 200, "url": "https://example.com"}
2

截图发生了什么

curl -X POST http://localhost:8888/api/screenshot -H "Content-Type: application/json" -d '{"full_page": true}'
→ {"success": true, "filename": "screenshot-20260302-120000.png", "filepath": "artifacts/screenshot-20260302-120000.png", "size": 17115}
3

证据被自动捕获

→ plan.json env_snapshot.json run_log.txt behavior_hash.txt — سلسلة التشفير SHA-256 محكمة. كل إجراء يصعب تغييره.
→ plan.json env_snapshot.json run_log.txt behavior_hash.txt — SHA-256 哈希链已封存。每个操作都有防篡改证据。

完整 API 参考

All local browser-control endpoints run on http://localhost:8888. Treat /agents.json as the canonical machine-readable contract for your agent runtime.

端点 方法 作用 OAuth3 范围
/api/navigatePOST在浏览器中加载 URL浏览器.导航
/api/clickPOST点击任何 CSS 选择器浏览器.点击
/api/fillPOST填写表单字段Solace Browser.fill
/api/screenshotPOST捕获当前页面作为PNG(保存到artifacts/)Solace Browser.screenshot
/api/evaluatePOST运行JavaScript(表达式key),返回结果浏览器评估
/api/snapshotPOST捕获页面的原始HTML浏览器快照
/api/aria-snapshotGETARIA无障碍树(结构化JSON)浏览器快照
/api/dom-snapshotGETDOM快照树,用于确定性结构检查浏览器快照
/api/page-snapshotGET综合页面快照(ARIA + DOM + 元数据)浏览器快照
/api/healthGET运行时准备就绪的存活探测(没有)
/api/statusGET浏览器健康状况,准备就绪,当前URL,会话(没有)
/api/part11/statusGET第11部分捕获状态,会话ID,写入字节,最后一个错误(没有)
/api/part11/configPOST配置第11部分捕获模式和审计目录部分11.configure
/agents.jsonGET机器可读的能力清单(没有)

MCP 服务器 — 现在直播

模型背景协议允许 克劳德代码 和其他 MCP 兼容工具作为本地工具连接到 Solace AGI — 无需 curl 命令。今天有七种工具可用:navigate, click, fill, screenshot, snapshot, evaluate, aria_snapshot.

✅ 本地 MCP — 现在可用

# Step 1: start the MCP 服务器 (stdio JSON-RPC 2.0) python3 ~/projects/Solace Browser/yinyang_mcp_server.py # Step 2: add to 克劳德代码 .claude/settings.json: { "mcpServers": { "Solace AGI": { "command": "python3", "args": ["/path/to/Solace Browser/yinyang_mcp_server.py"] } } }

一旦配置,克劳德代码 调用 detect_appsFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. create_scheduleFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. record_evidence, 和 5 more Hub-native MCP tools on localhost:8888。每个调用都是OAuth3范围内的,并且用SHA-256进行了鉴定.

☁ 远程MCP —— 云端(即将推出)

# Remote MCP is still coming soon:
{
  "mcpServers": {
    "solace": {
      "url": "mcp.solaceagi.com",
      "apiKey": "sol_..."
    }
  }
}

# Paid users can already launch a cloud twin today:
POST https://solaceagi.com/api/v1/browser/twin/launch
Authorization: Bearer sw_sk_...
{
  "scope": "twin:browser",
  "ttl_minutes": 15,
  "app_id": "solace-yinyang",
  "url": "https://solaceagi.com/dashboard"
}

从任何机器连接。浏览器工作器在云端运行。OAuth3管理每个工具调用。每个操作都经过哈希链和证据捕获到您的金库。需要Dragon Warrior级别.

8 MCP工具s Available Today

MCP工具映射到API作用
detect_appsPOST /detectDetect which Solace apps are available for a URL.
list_appsGET /creditsList the apps currently loaded by the Hub.
create_schedulePOST /api/v1/browser/schedulesCreate a cron-backed schedule for a local Solace app.
list_schedulesGET /api/v1/browser/schedulesRead back all active Hub schedules.
delete_scheduleDELETE /api/v1/browser/schedules/{schedule_id}Remove a schedule by UUID.
record_evidencePOST /api/v1/evidenceAppend a structured audit event to the evidence chain.
list_evidenceGET /api/v1/evidencePaginate existing evidence records for review.
get_hub_statusGET /healthInspect Hub health, readiness, 和 runtime state.

您的代理可以使用Solace AGI做什么

超越导航和点击 — Solace Browser为您的代理提供了完整的感官和记忆系统,用于web.

📷 查看页面

以满分度截屏任何页面。捕获DOM快照和ARIA无障碍树。您的代理获得结构化的视觉+语义数据 —— 不仅仅是原始的HTML。

📄 提取结构化数据

运行 /api/evaluate以执行JavaScript并返回结构化JSON。提取表格,价格,表单值,或任何页面数据直接到您的代理上下文中。

🔒 定域权限

仅请求您需要的内容。OAuth3令牌是定域(浏览器.导航Free gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. 浏览器.点击Free gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. Solace Browser.fill), 时间限制和可撤销的。内置失败安全设计。

📋 自动证据

每个代理操作都自动记录,哈希链接,并封存。您的代理生成审计跟踪,而无需编写一行记录代码。

♾ 记忆配方

Solace 记住成功的工作流程作为配方。在重放时,代理将跳过 LLM 并运行缓存路径仅为 $0.001 —— 与重新发现相比,成本降低了 99%。

💸 预算执行

设置每次会话的支出限制。传递"预算_usd":0.05在您的令牌请求中,并且 Solace 在预算耗尽时强制停止代理 —— 没有过度的成本。

🔎 证据搜索

使用/api/evidence/search查询过去的运行结果。代理可以查找之前会话中发生了什么 —— 对于诸如 "处理自上次运行以来未见的电子邮件" 之类的增量任务很有用。

🌎 会话持久性

浏览器会话在agent调用之间共存。只需登录一次,就可以重用会话。不需要重新进行身份验证。Cookies、本地存储和身份验证令牌在任务之间持续存在。

⚡ 并行标签页

同时打开多个浏览器上下文。您的agent可以并行爬取10个页面,比较结果,并合并发现 —— 所有这些都具有独立的证据跟踪。

🤖 多agent群

spawn多个独立的Solace Browser实例。侦察agent探索;编码agent执行;怀疑agent验证。每个实例都有自己的会话、预算和证据链。可以从任何调度程序(cron、Cloud Run、GitHub Actions)编排。

🛈 电子签名 & FDA Part 11

每个批准的操作都可以电子签名:用户记录“我(Phuc)在[时间戳]审查并批准此操作”。签名使用SHA-256密封到哈希链中。符合FDA 21 CFR Part 11 §11.100电子签名。

agent最佳实践

使您的agent可靠、可审计和廉价运行的模式。

✅ 点击前截图

始终调用/api/screenshot在点击操作之前。这创建了代理人在执行之前看到的内容的证据记录,对审计跟踪和调试失败的运行至关重要。

POST /api/screenshot {"full_page": false}
POST /api/click {"selector": "#submit-btn"}

🔎 结构Snapshot,视觉Screenshot

使用 /api/aria-snapshot(ARIA无障碍树,JSON) 当您的代理人需要了解页面结构时。使用/api/snapshot用于原始HTML。使用/api/screenshot用于视觉布局和图像。

GET /api/aria-snapshot # 返回ARIA JSON树 POST /api/snapshot # 返回原始HTML POST /api/screenshot # 返回PNG文件路径

🔒 请求最小作用域

仅请求您的任务所需的OAuth3范围。一个只读研究任务永远不应具有Solace Browser.fill范围。狭窄的范围可以防止意外的副作用并满足合规性审计。

POST /oauth3/token {
  "user_id": "local-agent",
  "scopes": ["浏览器.导航",
             "Solace Browser.screenshot"],
  "ttl_seconds": 300
}

♾ 先检查现有的Recipes

在运行工作流使用LLM令牌之前,调用/api/recipes/match。如果任务已经有一个Recipe,則在$0.001的费用下重放它。将LLM调用保存给真正新的工作流。

POST /api/recipes/match {
  "task": "gmail inbox triage"
}
# → {"hit": true, "recipe_id": "gmail-v3"}

💸 为每个会话设置预算

永远不要让代理运行时没有预算上限。传递预算_usd在你的令牌请求中。Solace AGI 当达到限制时将_hard-stop_ 会话,而不是默默地超支。

POST https://solaceagi.com/api/v1/oauth3/token {
  "api_key": "sw_sk_..."
}
# → {"access_token":"..."}

POST https://solaceagi.com/api/v1/oauth3/tokens
Authorization: Bearer sw_sk_...
{
  "scopes": ["files.read", "files.write"]
}
# → {"token":"o3_..."}
# Use header: X-OAuth3-Token: o3_...

🌎 重用已验证站点的会话

登录一次并存储会话令牌。传递"session_id" 這個字幕是"session_id"在随后的 API 调用中重用 cookies 和 auth 状态。消除了每次运行代理的登录流程。

POST /api/navigate {
  "url": "https://app.example.com/inbox",
  "session_id" 這個字幕是"session_id": "sess_abc123"
}

为什么代理本地化很重要

AEO: 代理引擎优化

就像SEO针对搜索爬虫进行优化一样,AEO优化了AI代理。Solace AGI是第一个以代理为主要用户而构建的平台——不是事后补充的。

您的代理无法伪造的证据

每个代理操作都会产生一个SHA-256哈希链式收据。您的CISO可以审计AI的操作记录。您的董事会可以查看证据。没有黑盒子。

让代理变得更聪明的配方

当代理完成任务时,它就变成了一个配方。下次:$0.001重播——不消耗LLM令牌。使用Solace的代理随着时间的推移变得更快、更便宜。

Solace的比较

选择浏览器自动化工具的开发人员会问四个问题:它是否保持会话?它是否创建审计跟踪记录?我是否可以将任务委托给AI而不产生高昂的成本?它是否能在合规审计中幸存?这里是每个选项的诚实答案。

功能 浏览器 Playwright 直接 浏览器使用 / OpenClaw 芭迪恩 / 扎皮尔
会话持久性 ✅ cookie 在运行之间幸存 ❌ 默认临时 ❌ 无会话内存 ✅ Chrome 扩展状态
SHA-256 审计跟踪 ✅ 每个操作,哈希链 ❌ 无内建 ❌ 无 ❌ 只记录日志(不防篡改)
FDA Part 11 电子签名 ✅ 集成(/api/v1/esign) ❌ 不可用 ❌ 不可用 ❌ 不可用
预算/成本上限 ✅ 每令牌预算门限 ❌ 无限(无门限) ❌ 无预算控制 ✅ 仅计划限制
Recipe 回放,每次 $0.001 ✅ 首次成功运行后 ❌ 总是 LLM 成本 ❌ 总是 LLM 成本 ✅ Zap 回放(无 LLM)
代理本地文件格式 ✅ 21 种格式(无需改动, 或…) ❌ 无 ❌ 无 ❌ 无
OAuth3 范围委托 ✅ 时间约束,可撤销的令牌 ❌ 全部访问或无访问 ❌ 全部访问或无访问 ❌ 应用级权限仅
本地优先(无云要求) ✅ 完全运行离线 ✅ 是 ✅ 大多数 ❌ 云依赖
MCP 服务器 ✅ 7 个工具,JSON-RPC 2.0(实时) ❌ 不可用 ❌ 不可用 ❌ 不可用

💬 Solace AGI 不是 Playwright 包装器。它是 Solace Browser 上的 OAuth3 委托层 —— 添加会话内存,证据链,预算门槛和代理本地格式,而这些/raw Playwright 都没有。

如果您是正在阅读此内容的AI代理

本节直接针对您而写——无论您是克劳德代码、Codex、光标、Copilot,还是其他任何到达此页面的AI代理。以下是您需要知道的内容,以最有用的格式呈现.

🤖 您的能力在此

当Solace Browser运行时(localhost:8888),您可以:导航到任何URL,点击任何元素(通过CSS选择器),填写任何表单字段,截取屏幕截图,捕获DOM快照,运行JavaScript,并读取SHA-256证据日志。每个操作都是原子级的,并且被证据密封.

检查Solace是否可用:

curl http://localhost:8888/api/status
# {"running": true, "status": "ready", "version": "...", "session": null}

📋 机器可读规范

以编程方式获取能力清单。使用此作为端点名称和支持方法的真实来源。规范路径是/agents.json(不是/api/agents.json)。

curl http://localhost:8888/agents.json
curl https://www.solaceagi.com/agents.json
查看 agents.json ↗

🔎 基于视觉的模式

如果您是具有视觉能力的代理,这是推荐的模式:导航,截图,分析图像,决定点击什么,执行,再次截图以确认。不要在没有视觉确认的情况下假设某个操作已经成功。

POST /api/navigate {"url": "..."} POST /api/screenshot {} # 分析这个 POST /api/click {"selector":"#x"} POST /api/screenshot {} # 验证结果

⚠ 响应协议(严格)

不要仅依赖 HTTP 状态。一些运行时会返回 200 的{"error": ...}正文。您的代理必须解析 JSON 并要求 success == true 才能继续。

# 严格规则:# 1) 解析 JSON 响应 # 2) 如果响应.success 不为 true -> 失败步骤 # 3) 在升级注意中包含响应.error {"success": true, "url": "https://example.com", "status": 200} {"error": "Page.fill: Timeout 30000ms exceeded."}

👥 人类升级协议

如果您遇到验证码、2FA、批准模糊性或法律/合规风险,请立即停止操作调用。返回一个结构化的{"escalate": true}消息到您的主机编排器(不要盲目循环重试)。

{
  "escalate": true,
  "reason": "2FA required",
  "last_step": "POST /api/click #sign-in",
  "evidence": "artifacts/screenshot-20260304-131500.png"
}

💸 安全执行循环

使用确定性循环:健康检查、导航、检查、操作、验证、检查点。包含获取 /api/page-snapshot在高风险操作之前运行,以保持审计和避免级联错误。

GET  /api/health
POST /api/navigate   {"url":"..."}
GET  /api/page-snapshot
POST /api/click|fill {"selector":"..."}
POST /api/screenshot {"full_page":true}
GET  /api/status

🛈 创建电子签名记录的方法

当用户批准您准备的操作时,记录他们的电子签名。这创建了一个符合FDA 21 CFR Part 11 §11.100的记录:谁批准、批准的内容以及何时——封入哈希链中。用于受监管的工作流所需的。

# After user clicks 批准 in the bottom rail:
POST /api/v1/esign/token
{
  "user_id": "phuc@example.com",
  "运行_id": "run-abc123",
  "meaning": "reviewed_and_approved",
  "action_description": "Sent email reply to Li Li re: Solace",
  "timestamp": "2026-03-03T15:00:00Z"
}
# → {
#   "esign_hash": "sha256:abc...",
#   "sealed_at": "2026-03-03T15:00:01Z",
#   "chain_entry_id": 42,
#   "verifiable": true
# }

⚡ 多代理模式

创建三个代理实现强大的自动化:Scout(导航 + 截图,仅读取,L1模型)→ Solver(点击 + 填充 + 评估,L3模型)→ Skeptic(验证输出与证据,L1模型)。所有三个共享一个运行_id;他们的证据链在封印时合并。

# Scout: read-only token
POST /oauth3/token {"user_id":"scout","scopes":["浏览器.导航","Solace Browser.screenshot"],"ttl_seconds":60}
# Solver: action token
POST /oauth3/token {"user_id":"solver","scopes":["浏览器.导航","浏览器.点击","Solace Browser.fill"],"ttl_seconds":60}
# Skeptic: verify token
POST /oauth3/token {"user_id":"skeptic","scopes":["浏览器快照","evidence.read"],"ttl_seconds":60}

# All share: {"运行_id": "run-abc123"}

代理错误参考

每个Solace错误都有类型。可以重试的错误会在退避后恢复。无法重试的错误需要人工干预或任务重新设计。

代码 含义 可重试 代理操作
SELECTOR_NOT_FOUNDCSS 选择器无匹配结果调用/api/snapshot以重新发现结构
NAVIGATION_TIMEOUT页面加载超过 30s以指数退避重试(最多 3 次)
BUDGET_EXCEEDED会话消费限制达到升级到人工操作员以增加预算
SCOPE_DENIED操作不在 OAuth3 令牌范围内请求具有所需范围的新令牌
HUMAN_REQUIRED检测到 CAPTCHA 或 2FA调用{"escalate": true}立即
NETWORK_ERROR目标站点无法访问5s后重试,然后30s后失败
SESSION_EXPIRED身份验证Cookie已过期重新身份验证,然后从最后的证据检查点resume
ELEMENT_NOT_INTERACTABLE元素隐藏或禁用等待2s并重试;先验证状态截图

星期一 总理 — 语义方式回收机

Solace 访问的每个页面都被压缩成一个 750 字节的语义快照 —— 存储页面的结构、意图、导航和关键实体。从这个 750 字节的种子中,Solace 可以完全离线地重新构建一个完整的工作 HTML 页面。 第一次下载后无需服务器。

流分裂: localhost:8888在 Solace Browser 中处理本地捕获/执行,而https://solaceagi.com/api/v1/prime-wiki/* 是共享社区索引(推送/拉取/搜索/统计/渲染)。本地仅模式可以在没有云索引的情况下工作。

📷 750 bytes → 全页

Wayback Machine 存储每个页面的 100KB+ 原始 HTML(总计 100,000 TB)。Solace 存储一个 750 字节的语义骨架并在本地重新构建一个等效页面。 133 倍较小。零集中依赖。

# 在本地重新构建任何已索引页面: python3 prime_wiki_render.py \ --url https://github.com # → prime-wiki-renders/github-com.html

🏛 应用商店焦点索引

与Wayback Machine(整个网络)不同,Solace AGI 专注于应用商店网站— 拥有Solace自动化配方的网站。GitHub,Gmail,LinkedIn,Substack,概念等。质量优于覆盖范围!

GET /api/v1/prime-wiki/search?q=github
# Returns all indexed GitHub pages

GET /api/v1/prime-wiki/stats
# {"count": 7, "rtc_verified_count": 7}

🔒 专业版:完整社区访问

免费:从您自己的浏览中收集快照.
专业版($28/月):即刻访问完整的社区索引 — 每个应用商店网站的语义内存。跳过LLM重新发现。每月节省$10–50的代币。

# 下载所有应用商店代码书一次:GET /api/v1/prime-wiki/assets?appstore_only=true # 存储在 ~/.solace/pzip/assets/ # 解压缩本地,永久 —— 离线功能

📄 渲染 API — 服务器端重构

直接从 API 重构任何已索引页面。返回带有嵌入式 Prime Mermaid FSM 状态图的完整 HTML。用于预览、截图和 recipe 调试。

# Render by URL (server decompresses + reconstructs):
GET /api/v1/prime-wiki/render?url=https://github.com

# Render by hash:
GET /api/v1/prime-wiki/render?url_hash=<sha256>
# ← Returns full HTML + Prime Mermaid diagram

🌎 贡献页面资产

每次 Solace Browser 访问应用商店站点都会创建一个 星期一 总理 快照。选择加入社区共享 —— 您的访问将使每个 Pro 会员受益。上传域代码书以加速解压缩。

# Push a snapshot (community contribution):
POST /api/v1/prime-wiki/push
{"url_hash": "<sha256(normalized_url)>",
 "url_display": "https://github.com",
 "snapshot_b64": "<base64(gzip(json_snapshot))>",
 "original_size": 12345,
 "compressed_size": 912,
 "schema_version": "prime-wiki-v1",
 "page_type": "landing",
 "rtc_verified": true,
 "sha256_original": "<sha256(raw_json_bytes)>",
 "sha256_compressed": "<sha256(gzip_bytes)>"}

# Upload domain codebook (Pro):
POST /api/v1/prime-wiki/assets
{"domain": "github.com", "asset_b64": "..."}

☯ 阴阳:您的代理页面伴侣

Solace Browser 访问的每个页面都会获得一个永久的双轨覆盖层。顶部轨道显示您的代理状态实时。底部轨道是一个聊天面板,您可以在其中直接与 Yinyang 交谈。两个轨道都是通过添加_init_script— 它们可以在导航、页面重新加载和CSP锁定的页面(如Gmail)中生存。

▲ 顶部导航栏 — 始终可见

一个32px的条形固定在每个页面的顶部。显示:[PH0]] [PH1]]家[PH1]→ 点击一次返回浏览器主页。另外显示实时状态(空闲 / 执行中 / 预览就绪 / 完成), 当前应用名称,以及旋转值统计(访问页面数,LLM 调用数,节省成本,会话持续时间).

# Push a state update to the top rail:
POST /api/yinyang/notify
{"type": "state_update",
 "state": "执行中",
 "app_name": "Gmail Triage"}

▼ 底部导航栏 — 聊天 & 批准

一个 36px 高的聊天面板,折叠在每个页面底部。当状态达到预览就绪(您的代理已准备好一个操作),被阻塞(需要澄清),或失败。用户点击批准拒绝— 你的代理通过 WebSocket 接收到决定。

# WebSocket for real-time agent ↔ Yinyang:
ws://localhost:8888/ws/yinyang

# Push preview for user approval:
{"type": "bottom_rail_update",
 "payload": {
   "state": "预览就绪",
   "preview_text": "Reply to Li Li about...",
   "show_approve_reject": true,
   "运行_id": "run-abc123"
 }}

🔔 推送通知 — 3 个频道

代理可以在不中断当前页面的情况下向用户推送通知。三个频道:烤肉(3 秒底右弹出),弹出(带有操作按钮的模态窗口),接管(批准时全屏). 所有通道均受FSM控制 — 无法在没有有效状态转换的情况下触发警报.

POST /api/yinyang/notify
{"type": "push_alert",
 "channel": "烤肉",
 "message": "Gmail triage complete: 12 sorted",
 "priority": "low"}

# channel: "烤肉" | "弹出" | "接管"
# priority: "low" | "high" | "critical"

🌏 适用于所有页面 — 包括Gmail

Rails被注入为剧作家添加_init_script— 它们在同一浏览器上下文中跨越每个导航,包括CSP锁定的页面,如简单的GmailFree gives teams a serious local-first on-ramp. If your workflow belongs on your own machine, you can keep it there. 谷歌文件, 和概念. JS 仅使用 DOM 方法(无HTML内部),绕过 TrustedHTML 限制。 Yinyang 始终可见,始终可达。

🗣 Yinyang 聊天 API

用户可以直接从底部栏输入到 Yinyang。您的代理通过 WebSocket 接收消息并可以响应。可用于请求澄清、模糊批准或任务中配置更改。每个消息都会记录到 FDA Part 11 证据跟踪中。

POST /api/yinyang/chat
Authorization: Bearer <api_key>
{"message": "User says: skip newsletters",
 "context": {"运行_id": "run-abc123"}}
# → {"reply": "Got it. Skipping newsletters..."}

📦 代理结果:您的收件箱、发件箱和证据

每个任务您的代理运行都会产生结果,这些结果可以从 Solace Browser 首页访问。由 Jony Ive 原则设计:始终呈现,永不侵入,确切需要。代理工作;您审查、签署并发布。

📤 收件箱 — 等待审查的草稿

每个您的代理人准备的草稿(电子邮件回复、Substack帖子、LinkedIn评论)都会在发送之前出现在这里。收件箱显示:发送者上下文、代理人编写的草稿、置信度评分、预计发送时间。您可以通过单击审阅和批准 - 或在批准之前编辑。

GET /api/v1/inbox # {"items": [{ # "id": "draft-abc", # "app": "gmail-inbox-triage", # "type": "email_reply", # "to": "li.li@...", # "subject": "Re: Solace用户案例", # "preview": "Hi Li Li, thanks for...", # "confidence": 0.91, # "status": "awaiting_approval" # }]}

📥 发送箱 — 已发送和已安排

批准的项目流到发送箱中。您可以查看已发送的内容、发送时间、发送应用程序以及证据哈希。已安排的项目显示其下一次触发时间。每个发送箱条目都链接到其完整的Part 11证据包。

GET /api/v1/outbox
# {"items": [{
#   "id": "sent-xyz",
#   "app": "gmail-inbox-triage",
#   "sent_at": "2026-03-03T14:30:00Z",
#   "to": "li.li@...",
#   "evidence_hash": "sha256:abc...",
#   "status": "sent"
# }]}

📅 安排与日历

重复任务(晨报、每周摘要、夜间存档)出现在安排中。您可以查看下一次运行时间、上一次运行结果以及本期间消耗的预算。代理人可以通过API将任务添加到安排中;用户可以从主页暂停、跳过或重新安排。

GET /api/v1/schedule
# {"items": [{
#   "app": "morning-brief",
#   "cron": "0 7 * * *",
#   "next_run": "2026-03-04T07:00:00Z",
#   "last_status": "DONE",
#   "budget_used_7d": "$0.12"
# }]}

📚 历史记录 — 食谱运行日志

每次食谱运行都会被记录:应用程序名称、运行时间、使用的令牌、成本、结果。成功的运行构建了用于未来$0.001次重放的食谱缓存。失败的运行显示了它们在哪里和为什么被打破 —— 这对于调试应用程序食谱非常完美。

GET /api/v1/history?limit=20
# {"runs": [{
#   "运行_id": "run-abc",
#   "app": "gmail-inbox-triage",
#   "started": "2026-03-03T14:00:00Z",
#   "duration_s": 18,
#   "tokens": 1247,
#   "cost_usd": 0.00073,
#   "outcome": "DONE",
#   "recipe_replayed": false
# }]}

📷 FDA Part 11 证据

每个已批准的动作都会生成一个防篡改的截图序列。可以从历史面板中访问:查看在您的代理进行操作之前浏览器显示的内容、代理提出的内容以及实际执行的内容。SHA-256 哈希链。电子签名准备就绪。

GET /api/v1/evidence/{运行_id}
# {"运行_id": "run-abc",
#  "screenshots": [
#    {"step": 1, "url": "...", "sha256": "..."},
#    {"step": 2, "url": "...", "sha256": "..."}
#  ],
#  "seal": {"hash": "sha256:...",
#           "signed_at": "..."}}

📄 星期一 总理 快照

当您的代理访问一个新网站时,它会创建一个 星期一 总理 快照:一个交互元素的索引映射(DOM 选择器、ARIA 角色、操作路径)。这些快照支持未来食谱重放,费用为 $0.001。可以从主页访问 — 浏览、搜索或以 Prime Mermaid FSM 图表形式导出。

GET /api/v1/prime-wiki/list
# {"snapshots": [{
#   "domain": "mail.google.com",
#   "captured_at": "2026-03-03",
#   "selectors": 847,
#   "recipes": 3,
#   "mermaid_url": "/prime-wiki/gmail.md"
# }]}

🌟 从人类编辑中学习

当用户在批准之前编辑代理编写的草稿时,Solace Browser 捕获 delta 作为一个偏好信号随着时间的推移,代理学习用户的声音、语气和风格,而无需任何显式的训练。这是一个反馈循环,使代理在使用过程中变得越来越好.

📝 如何工作

  1. 代理撰写草稿→ 陆在收件箱中,且状态为待_批准状态
  2. 用户编辑草稿→ Solace Browser 计算原始文本和编辑文本之间的差异,并提取 delta
  3. 用户批准→ delta 被存储为一个风格偏好标记到应用程序 + 收件人
  4. 下次运行→ 代理在系统提示中接收样式首选项:“用户偏好:更短的结束语,没有感叹号,始终提及参考号”
  5. 评分改进→ 随着时间的推移需要更少的编辑。收敛在历史面板中跟踪。

📊 首选项 API

代理可以在生成草稿之前读取样式首选项。首选项存储于每个应用程序、每个收件人和全局。可以自动捕获用户编辑 - 或通过 API 手动教会。

# 在草稿之前读取首选项:GET /api/v1/preferences?app=gmail-inbox-triage # {"global": ["简洁,3 句话最大"], # "recipient:li.li@...": [ # "提及参考号", # "没有感叹号" # ]} # 用户编辑自动捕获:POST /api/v1/preferences/signal {"app": "gmail-inbox-triage", "original": "Hi Li Li! Thanks for...", "edited": "Hi Li Li, thanks for...", "recipient": "li.li@..."}

💡 正确的模式:审批,编辑,学习

反čních-Clippy 法令:永远不要自动批准,永远不要自动发送. 人类总是先看到草稿。这不仅是一种限制 —— 它是一种功能。每次批准都是一个训练信号。每次编辑都是一个修正。经过 5-10 次运行,代理以您的语音撰写草稿。经过 50 次运行,它几乎不需要编辑。证据链证明每个决策都是人工批准的。您的生产力会增加,您的判断会被记录下来。

⚠ 0 个竞争对手拥有所有三个

舒适检查员 — 手动 QA 的终结

您的 AI 代理正在发布未经测试的代码。每个没有结构化 QA桥梁的开发团队都在摸索。Solace Inspector 是第一个 —— 也是唯一一个 —— 为 AI 编码代理提供标准化、证据封存、人工批准的 QA 协议的工具。

如果您的 AI 代理不使用 Solace Inspector,它的 QA 就很糟糕。句号。

代理协议

任何编码代理都会在收件箱/. 从中检索封存报告输出箱/. 无需自定义集成。无需SDK。任意语言。任意模型。

实时
🔒

证据链

每次检查都是SHA-256封印的,FDA21 CFR 11部分建筑证据.法院可接受.改证据.永久. 不是PH0 我测试了它,PH2密码证据.

实时

人工电子签名批准

AI提出修改建议,人工一键批准。反对Clippy:从不自动批准。每次修改都是人工决策的记录。这是一个杀手级功能。其他没有这一功能。

实时
$0.00 / 运行 代理原生架构。运行器中零LLM API调用。您的AI代理读取密封报告并应用其自己的模型进行分析。智能保持在您的代理中。

HITL 循环(人机交互循环)

🤖 您的代理
编写test-spec.json收件箱/
🔎 检查器
导航 + ARIA + DOM + 启发法 + 屏幕截图 → 封装报告
🤖 您的代理
读取报告,以自己的模型分析,并提出修复方案
👤 人类
审查 3 个修复方案,30 秒内点击 批准。完成。
🔒 保管库
SHA-256 封装。公开证据。符合 FDA规定。永久保存。
# Step 1: Agent writes test spec to 收件箱/ (any format, any language)
cat > 收件箱/test-spec-001.json << EOF
{
  "spec_id": "my-app-home-001",
  "mode": "web",
  "target_url": "http://localhost:3000/",
  "page_name": "My App Home",
  "persona": "james_bach",
  "checks": {"aria": true, "heuristics": true, "screenshot": true}
}
EOF

# Step 2: Run the inspector (agent-native, $0.00 LLM cost)
python3 scripts/run_solace_inspector.py --inbox

# Step 3: Agent reads sealed report from 输出箱/
cat 输出箱/report-my-app-home-001-*.json
# {
#   "qa_score": 74,
#   "belt": "Yellow",
#   "heuristic_issues": [{"type": "accessibility", "msg": "3 images missing alt", "heuristic": "ARIA-1"}],
#   "agent_analysis_request": { "system_prompt": "You are 詹姆斯·巴赫...", "evidence_summary": {...} },
#   "agent_analysis_response": null,  ← YOU fill this in with your model
#   "fix_proposals": [],              ← YOU add proposals here
#   "evidence_hash": "sha256:a4f3...",  ← cryptographic seal
#   "human_approved": false
# }

🌐 网页模式

任何浏览器应用。导航 + ARIA 树 + DOM 快照 + HICCUPPS 启发法 + 全页屏幕截图。支持 localhost、预发布、生产或公共 URL。

模式: "web"

⚙ 命令行界面模式

任何命令行工具. 副进程执行+退出代码声明+stdout/stderr捕获. 肯特·贝克: 测试你害怕的东西. 任何语言的任何CLI上都能运行.

模式: "cli"

📡 API 模式

要求+响应方案验证+时间安排+安全头条. 克梅·卡纳:在这个背景下,质量风险是什么?

模式:"api" 即将在 Sprint 3 推出

专家委员会(注入分析提示)

詹姆斯·巴赫
SBTM + HICCUPPS 医疗预测
“大多数工具检查。Solace Inspector 测试。它探索,学习,当需要判断时升级到人类。”
塞姆·卡纳(塞姆·卡纳(Cem Kaner))
BBST + 上下文驱动测试
“电子签名门不是官僚主义 —— 它是责任感。如果没有它,你不知道谁做出了什么决定。”
埃莉莎白·亨德里克森(埃莉莎白·亨德里克森(Elisabeth Hendrickson))
Explore It! + 基于特许的
“基于特许的探索可机器阅读。测试规格 IS 特许。报告 IS 会议笔记。”
肯特·贝克(肯特·贝克(Kent Beck))
TDD + 可测试性透镜
“测试你所恐惧的。有了Solace AGI,你可以使用相同的协议测试任何东西——网页,CLI,Solace Browser API——”
迈克尔·博尔顿
RST + 测试与检查
“机器检查。人类测试。Solace Inspector正确地划分劳动。两者都留下证据。”

已确认:没有竞争对手拥有全部三个

工具 代理协议
收件箱/发件箱JSON
证据链
SHA-256密封
人类电子签名
批准修复
成本/运行
舒适检查员 $0.00
剧作家MCP 各不相同
Ketryx (仅医疗) $$$
卡沃尔夫 $2,000/月
马布尔 $800/月
测试Rigor 部分 部分 $1,200/月
德文2.0 $500/月 + $5/运行

研究验证于2026年3月,涵盖15种工具。FDA的2026年人工智能指南正在推动该行业向我们已经建立的目标前进。监管正在赶上我们。领先领域6–12个月

30秒内安装

# Solace Inspector 集成在 Solace Browser 中。 # 它是默认应用程序 — 始终存在,无法卸载。 # 如果你已经安装 Solace Browser: python3 scripts/run_solace_inspector.py --self-diagnostic # 第一次?安装 Solace Browser: git clone https://github.com/solaceagi/solace-browser cd solace-browser python3 -m pip install -r requirements.txt python3 web/server.py # http://localhost:8791 # 然后将任何测试规格放入 收件箱/ 目录,并运行: python3 scripts/run_solace_inspector.py --inbox

机器可读的能力

/agents.json端点返回结构化的能力,用于程序化代理发现。

查看 agents.json ↗