您的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秒内启动.
将 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.
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).
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.
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 种格式。
滑风筝
进入您的.windsurfrules 這種水果是我們所需要的. 這種水果是我們所需要的.. 滑风筝 (Codeium) 像光标一样精确地采用 Solace Browsercapabilities — 相同格式,零延迟.
继续.dev 继续.dev
添加到您的.continue/config.json上下文提供程序。Continue 将作为本机工具在 VS Code 和 JetBrains 中显示 Solace 浏览器自动化。
根码
放置于.roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/. 根码(以前称为Roo-克莱恩)继承了Solace Browser的功能,并具备了代理编码模式。
谷歌的双子座CLI
添加到GEMINI.md在您的项目根目录中。Google的开源代理CLI以相同的方式读取Solace指令,就像它读取Claude的指令一样无需改动。
Zed 编辑器
将规则放在.rules 這個規則是 這個規則是在您的项目根目录中。Zed 的 AI 面板可以本地读取这些规则 —— Solace AGI 成为可供 Zed AI助手立即使用的服务。
Amazon Q 开发者
添加到.amazonq/rules/solace.md。Amazon Q 开发者会从此目录为项目中的每个编码会话读取 markdown 规则文件。
JetBrains 人工智能
添加到.idea/ai-guidelines.md. JetBrains 人工智能 Assistant 在所有 IntelliJ、PyCharm、WebStorm 和 JetBrains IDE 中读取此文件。
塔比尼
通过配置.tabnine/personalization 這個問題是如何解決的 這個問題是如何解決的. 塔比尼的个人化文件允许你教它你的团队的工具链,包括Solace Browser自动化。
复制 AI
添加到您的.replit 關於我們 關於我們文件的[ai]部分。 复制 AI 从这里读取项目上下文 — Solace AGI变得在每个Replit工作空间中都可用。
工厂机器人
工厂读取或 和 .factory/ 這個字母是 .factory/ 這個字母是 .factory/ 這個字母是 .factory/配置。Droid 代理在自动化软件开发工作流时继承Solace AGI能力.
无需改动 代码片段中的内容
每个集成文件都教你的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 可以通过三个命令学习掌握。其他所有内容都是变体。
导航到任何页面
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"}
截图发生了什么
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}
证据被自动捕获
→ 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/navigate | POST | 在浏览器中加载 URL | 浏览器.导航 |
/api/click | POST | 点击任何 CSS 选择器 | 浏览器.点击 |
/api/fill | POST | 填写表单字段 | Solace Browser.fill |
/api/screenshot | POST | 捕获当前页面作为PNG(保存到artifacts/) | Solace Browser.screenshot |
/api/evaluate | POST | 运行JavaScript(表达式key),返回结果 | 浏览器评估 |
/api/snapshot | POST | 捕获页面的原始HTML | 浏览器快照 |
/api/aria-snapshot | GET | ARIA无障碍树(结构化JSON) | 浏览器快照 |
/api/dom-snapshot | GET | DOM快照树,用于确定性结构检查 | 浏览器快照 |
/api/page-snapshot | GET | 综合页面快照(ARIA + DOM + 元数据) | 浏览器快照 |
/api/health | GET | 运行时准备就绪的存活探测 | (没有) |
/api/status | GET | 浏览器健康状况,准备就绪,当前URL,会话 | (没有) |
/api/part11/status | GET | 第11部分捕获状态,会话ID,写入字节,最后一个错误 | (没有) |
/api/part11/config | POST | 配置第11部分捕获模式和审计目录 | 部分11.configure |
/agents.json | GET | 机器可读的能力清单 | (没有) |
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_apps | POST /detect | Detect which Solace apps are available for a URL. |
list_apps | GET /credits | List the apps currently loaded by the Hub. |
create_schedule | POST /api/v1/browser/schedules | Create a cron-backed schedule for a local Solace app. |
list_schedules | GET /api/v1/browser/schedules | Read back all active Hub schedules. |
delete_schedule | DELETE /api/v1/browser/schedules/{schedule_id} | Remove a schedule by UUID. |
record_evidence | POST /api/v1/evidence | Append a structured audit event to the evidence chain. |
list_evidence | GET /api/v1/evidence | Paginate existing evidence records for review. |
get_hub_status | GET /health | Inspect 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_FOUND | CSS 选择器无匹配结果 | 否 | 调用/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 作为一个偏好信号随着时间的推移,代理学习用户的声音、语气和风格,而无需任何显式的训练。这是一个反馈循环,使代理在使用过程中变得越来越好.
📝 如何工作
- 代理撰写草稿→ 陆在收件箱中,且状态为
待_批准状态 - 用户编辑草稿→ Solace Browser 计算原始文本和编辑文本之间的差异,并提取 delta
- 用户批准→ delta 被存储为一个风格偏好标记到应用程序 + 收件人
- 下次运行→ 代理在系统提示中接收样式首选项:
“用户偏好:更短的结束语,没有感叹号,始终提及参考号” - 评分改进→ 随着时间的推移需要更少的编辑。收敛在历史面板中跟踪。
📊 首选项 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 次运行,它几乎不需要编辑。证据链证明每个决策都是人工批准的。您的生产力会增加,您的判断会被记录下来。
舒适检查员 — 手动 QA 的终结
您的 AI 代理正在发布未经测试的代码。每个没有结构化 QA桥梁的开发团队都在摸索。Solace Inspector 是第一个 —— 也是唯一一个 —— 为 AI 编码代理提供标准化、证据封存、人工批准的 QA 协议的工具。
如果您的 AI 代理不使用 Solace Inspector,它的 QA 就很糟糕。句号。
代理协议
任何编码代理都会在收件箱/. 从中检索封存报告输出箱/. 无需自定义集成。无需SDK。任意语言。任意模型。
证据链
每次检查都是SHA-256封印的,FDA21 CFR 11部分建筑证据.法院可接受.改证据.永久. 不是PH0 我测试了它,PH2密码证据.
人工电子签名批准
AI提出修改建议,人工一键批准。反对Clippy:从不自动批准。每次修改都是人工决策的记录。这是一个杀手级功能。其他没有这一功能。
HITL 循环(人机交互循环)
test-spec.json 到 收件箱/
# 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 推出
专家委员会(注入分析提示)
已确认:没有竞争对手拥有全部三个
| 工具 | 代理协议 收件箱/发件箱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端点返回结构化的能力,用于程序化代理发现。