Skip to main content

您的 AI 代理現在可以控制任何網站。
帶有一個完整的審計蹤跡。

將一行代碼放入CLAUDE.md, AGENTS.md, 或 .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 >> CLAUDE.md

將 Solace browser 自動化指令添加到您的 克勞德代碼 項目中。立即生效 — 無需註冊,無需 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.

1

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 種格式。

克勞德代碼

跳到你的CLAUDE.md。克勞德代碼將自動使用 Solace Browser 進行任何網路自動化任務。

下載 CLAUDE.md 程式碼片段
💬

OpenAI 編碼器

跳到你的AGENTS.md。OpenAI 編碼器和 ChatGPT 智能代理人會讀取此檔案,以了解可用的工具和能力。

下載 AGENTS.md 程式碼片段

游標

跳到你的.cursorrules. 當您要求它與網站進行交互時,游標將會接觸Solace AGI。

下載.cursorrules
🏄

滑風

跳到你的.windsurfrules 這種水果是我們所需要的. 這種水果是我們所需要的.. 滑風 (Codeium) 可以像游標一樣接觸Solace Browser的功能 —相同的格式,零阻力。

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

這樣的 這樣的 GitHub Copilot

下降到.github/copilot-instructions.md. Copilot 将为浏览器任务建议 Solace API 调用.

下载 copilot 指令

助手

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

下载助手系统提示

繼續閱讀.dev 繼續閱讀

新增至你的.continue/config.jsoncontext providers. Continue 会将 Solace Browser 自动化作为原生工具在 VS Code 和 JetBrains 中呈现.

下载 Continue 配置
📞

克林

跳到你的.clinerules/ 這個字母是 這個字母是目录。克林 会在会话开始时读取项目规则 — Solace 能力将自动为每次对话加载.

下載 .clinerules 段落
🦕

羅代碼

放在.roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/ 這個代碼是 .roocode/rules/. 羅代碼(原Roo-克林)繼承了Solace Browser的功能,以及其代理編碼模式。

下載羅代碼規則
🔭

谷歌的 Gemini CLI

添加到GEMINI.md在您的项目根目录中。Google 的开源代理 CLI 以与读取 Claude 的相同方式获取 Solace 指令CLAUDE.md.

下载 GEMINI.md 代码片段
🚀

Google 朱尔斯

朱尔斯阅读AGENTS.md在处理 GitHub 问题之前。Solace 指令在 Jules 处理您的存储库中任何与 web 相关的任务时自动出现

为 Jules 下载 AGENTS.md

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 context
📄

塔布尼尼 的使用

透過以下配置.tabnine/personalization 這個問題是如何解決的 這個問題是如何解決的. 塔布尼尼 的使用的個人化檔案讓您教導它您的團隊的工具鏈 — 包括Solace Browser自動化。

下載 塔布尼尼 的使用 配置
🆕

複製 AI

新增至你的.replit 關於我們 關於我們檔案的[ai]區段。 複製 AI 從這裡讀取項目內容 — Solace AGI 出現在每個 Replit 工作區。

下載 .replit 關於我們程式碼片段
🤖

德文

放在.devin/playbooks/ 這是一本好玩的遊戲. 這是一本好玩的遊戲.. 德文 在開始長期任務之前會讀取項目手冊 — Solace Browser 工具可用於任何網頁工作流程。

下載 德文 手冊
🏭

工廠機器人

工廠讀取AGENTS.md.factory/ 這個字母是 .factory/ 這個字母是 .factory/ 這個字母是 .factory/配置。工廠代理在自動化軟件開發工作流程時繼承Solace AGI的能力,例如Solace Browser、OAuth3、Software 5.0等,同時符合Phuc Labs、FDA Part 11、ALCOA+、SOC2的相關標準,使用AES-256-GCM進行加密,為Together.ai和OpenRouter提供安全的數據存儲和傳輸。

下載工廠配置
🔰

千行代碼

添加到基洛代码/规则/ .kilocode/. 千行代碼遵循與克林相同的項目規則模式 — 每次代理編碼會話都會載入Solace AGI的相關指令。

下載 千行代碼 規則

llms.txt

Jeremy Howard 標準的 LLM 可讀站點描述。將其放入您的項目根目錄,以便任何 LLM 都能理解 Solace.

下載 llms.txt

CLAUDE.md 代碼片段中的內容

每個整合文件都教您的 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 跑_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 跑_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

完整文件:下載 CLAUDE.md 節錄您的位置: 首页 > 首页 > 首页 > 首页 > 首页 > 首页 > 首页 > 首页 > 首页 > 首页 > 首页查看 agents.json(機器可讀)

3 個 API 呼叫的 哈洛世界

完整的 Solace API 可以在三個命令中學習。其他內容都是變化。

1

導航到任何頁面

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填寫表單欄位瀏覽器填充
/api/screenshotPOST捕獲當前頁面為 PNG (儲存至 artifacts/)瀏覽器截圖
/api/evaluatePOST執行 JavaScript (表達式鍵), 返回結果瀏覽器評估
/api/snapshotPOST擷取頁面原始 HTML瀏覽器快照
/api/aria-snapshotGETARIA 無障礙存取樹 (結構化 JSON)瀏覽器快照
/api/dom-snapshotGETDOM 快照樹以進行確定性結構檢查瀏覽器快照
/api/page-snapshotGET合並頁面快照 (ARIA + DOM + 中繼資料)瀏覽器快照
/api/healthGETLiveness 探測運行時準備就緒(沒有)
/api/statusGET瀏覽器健康狀態、準備就緒、當前 URL、會話(沒有)
/api/part11/statusGET第 11 部分捕獲狀態、會話 ID、寫入字節、最後錯誤(沒有)
/api/part11/configPOST配置第 11 部分捕獲模式和審核目錄請選擇部分11.configure
/agents.jsonGET機器可讀的能力清單(沒有)

MCP 伺服器 — 現已上線

模型內容協定 (Model Context Protocol) 可讓 克勞德代碼 及其他 MCP 相容工具以原生工具的方式連接到 Solace,無需使用 curl 命令。目前有七種工具可用:navigate、click、fill、screenshot、snapshot、evaluate、aria_snapshot。

✅ 本地 MCP — 現已可用

# 步驟 1:啟動 MCP 伺服器 (stdio JSON-RPC 2.0) python3 ~/projects/solace-browser/yinyang_mcp_server.py # 步驟 2:新增到 克勞德代碼 .claude/settings.json:{ "mcpServers": { "solace": { "command": "python3", "args": ["/path/to/solace-browser/yinyang_mcp_server.py"] } } }

配置完成後,克勞德代碼 會呼叫 detect_apps, create_schedule, 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做什麼

超越導航和點擊 — Solace为您的代理人提供了一个完整的感官和記憶系统,用于網路.

📷 查看頁面

以全解析度截取任何頁面的截圖。捕捉 DOM 快照和 ARIA 無障礙樹。您的代理人獲得結構化的視覺 + 語義數據 —— 不僅僅是原始 HTML。

📄 提取結構化數據

運行 /api/evaluate執行 JavaScript 並返回結構化 JSON。提取表格、價格、表單值或頁面上的任何數據直接到您的代理人上下文中。

🔒 範圍許可

請求您所需的內容。OAuth3 標籤範圍 (瀏覽器導航, 瀏覽器點擊, 瀏覽器填充), 時間限定和可撤銷。設計上的失效封閉。

📋 自動證據

每個代理人動作都自動記錄、雜湊鏈和加密。您的代理人生成審計追蹤而無需寫一行記錄代碼。

♾ 食譜記憶

Solace AGI 記住成功的工作流程作為食譜。在回顧時,您的代理人跳過 LLM Entirely 並運行快取路徑,費用為 $0.001 — 比重新發現cheap 99%。

💸 預算執法

設定每次會話的花費限制。通行"預算_usd":0.05在您的令牌請求中,並在預算耗盡時 Solace 強制代理人停止 — 沒有失控的成本。

🔎 證據搜索

使用/api/evidence/search查詢過去的運行。代理人可以查找之前會話中發生的情況 — 對於增量任務如「篩選從上次運行後未查看的郵件」很有用。

🌎 會話持續性

瀏覽器工作階段可以在代理呼叫之間存活。登入一次,重複使用工作階段。沒有重新驗證的負擔。cookies、本地儲存和驗證令牌在工作任務中持續存在。

⚡ 平行標籤

同時打開多個瀏覽器內容。您的代理可以平行刮取10個頁面,比較結果,合並發現 —— 都有獨立的證據痕跡。

🤖 多代理群

產生多個獨立的Solace Browser實例。偵查代理探索;編碼代理執行;懷疑代理驗證。每個實例都有其自己的工作階段、預算和證據鏈。從任何排程器(cron、Cloud Run、GitHub Actions)協調。

🛈 電子簽名 & FDA Part 11

每一個批核動作都可以電子簽署:用戶記錄「我(Phuc)於[時間戳]審核並批核此動作」。簽署被SHA-256封入雜湊鏈中。符合FDA 21 CFR Part 11 §11.100電子簽署。

代理最佳實踐

讓您的代理可靠、可稽核和低成本運行的模式。

✅ 点擊前截圖

總是呼叫/api/screenshot在點擊動作之前。這創建了代理人在執行前看到的內容的證據記錄 —— 對審計跟蹤和調試失敗運行至關重要。

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

🔎 結構快照,視覺截圖

使用 /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 範圍。唯讀研究任務不應該有瀏覽器填充範圍。狹窄的範圍可以防止意外的副作用並滿足合規性審核.

POST /oauth3/token {
  "user_id": "local-agent",
  "scopes": ["瀏覽器導航",
             "瀏覽器截圖"],
  "ttl_seconds": 300
}

♾ 先檢查現有的Recipes

在運行具有LLM令牌的工作流程之前,請調用/api/recipes/match。如果有一個配方適用於任務,在 $0.001 的情況下重播它。將LLM呼叫儲存為新工作流程.

POST /api/recipes/match { "task": "gmail 收件夾整理" } # → {"hit": true, "recipe_id": "gmail-v3"}

💸 為每個會話設置預算

永遠不要讓代理運行沒有預算上限。傳遞預算_usd在您的token請求中。Solace AGI會在達到限制時停止會話,而不是默默地超支。Solace Browser會在達到限制時停止會話,而不是默默地超支。

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_...

🌎重複使用已驗證站點的會話

登入一次並儲存會話token。透過"session_id" 這個字幕是"session_id"在隨後的API呼叫中重複使用cookie和驗證狀態。消除了每次代理程式運行的登入流程。

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

輕量代理為何重要

AEO: 代理引擎優化

就像SEO针对搜索爬虫进行优化一样,AEO针对AI代理进行优化。Solace是第一个将代理视为一等公民的平台,而不是附带的东西。

伪造不了的证据

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

让代理更聪明的配方

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

Solace的比较

选择浏览器自动化工具的开发者会提出四个问题:它能否持久会话?它能否创建审计跟踪?我能否委托AI而不产生过高的成本?它能否在合规审计中幸存?下面是每个选项的诚实答案。

功能 您的位置:首页 > 首页 > 首页 > 浏览器 Playwright直接 瀏覽器使用 / OpenClaw 芭迪恩 / 扎皮爾
會話持續性 ✅ Cookies 在不同執行之間存活 ❌ 默認為暫時的 ❌ 沒有會話記憶 ✅ Chrome 擴充功能狀態
SHA-256 審核蹤跡 ✅ 每個動作,雜湊鏈結 ❌ 無內建 ❌ 沒有 ❌ 僅登錄(不防篡改)
FDA Part 11 電子簽名 ✅ 內建(/api/v1/esign) ❌ 不可用 ❌ 不可用 ❌ 不可用
預算/成本上限 ✅ 每Token預算閘門 ❌ 不限(無閘門) ❌ 沒有預算控制 ✅ 僅限計畫限制
recipe 回放價格為 $0.001 ✅ 首次成功運行後 ❌ 總是 LLM 成本 ❌ 總是 LLM 成本 ✅ Zap 回放(無 LLM)
代理原生檔案格式 ✅ 21 種格式(CLAUDE.md, AGENTS.md…) ❌ 沒有 ❌ 沒有 ❌ 沒有
OAuth3 範圍委派 ✅ 時間限定、可撤銷 token ❌ 全面訪問或無訪問 ❌ 全面訪問或無訪問 ❌ 僅限應用程式級別的權限
本地優先(無需雲端) ✅ 可完全離線運行 ✅ 是 ✅ 大部分 ❌ 雲端依賴
MCP 伺服器 ✅ 7 工具,JSON-RPC 2.0(实時) ❌ 不可用 ❌ 不可用 ❌ 不可用

💬 Solace 不是 Playwright 的包裝器。它是基於 Playwright 的 OAuth3 委派層 —— 添加了會話記憶、證據鏈、預算閘門和代理原生格式,原始 Playwright 沒有這些功能。 Solace Browser 由 Solace AGI 和 Phuc Labs 團隊開發,遵守 Software 5.0、FDA Part 11、ALCOA+、SOC2 等國際標準,採用 AES-256-GCM 等先進加密技術,並與 Together.ai 和 OpenRouter 等第三方服务 совместим。

如果您是一個讀取此訊息的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."}

👥 人類升級協議

如果遇到 CAPTCHA,2FA,批准歧义,或法律/合规风险,请立即停止行动调用。返回一个结构化的{"escalate": true}消息到您的主管协调器(不要盲目循环重试)。

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

💸 安全执行循环

使用一个确定性的循环:健康检查,导航,检查,行动,验证,检查点。包括請獲得 /api/page-snapshot在高风险行动之前,以确保运行可审计并避免Cascade错误。

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的記錄:誰批准、批准了什麼,以及何時 — 密封在哈希鏈中。適用於受監管的工作流程。

# 使用者單擊 批准 按鈕後:POST /api/v1/esign/token { "user_id": "phuc@example.com", "跑_id 跑_id": "run-abc123", "meaning": "reviewed_and_approved", "action_description": "發送電子郵件回复給 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 跑_id;在封存時合併證據鏈。

# Scout: read-only token
POST /oauth3/token {"user_id":"scout","scopes":["瀏覽器導航","瀏覽器截圖"],"ttl_seconds":60}
# Solver: action token
POST /oauth3/token {"user_id":"solver","scopes":["瀏覽器導航","瀏覽器點擊","瀏覽器填充"],"ttl_seconds":60}
# Skeptic: verify token
POST /oauth3/token {"user_id":"skeptic","scopes":["瀏覽器快照","evidence.read"],"ttl_seconds":60}

# All share: {"跑_id 跑_id": "run-abc123"}

代理錯誤參考

每個Solace錯誤都有類型。可重試的錯誤可以通過退避恢復。不可重試的錯誤需要人工介入或任務重新設計。

程式碼 意義 可重試 代理動作
SELECTOR_NOT_FOUNDCSS 選擇器無匹配結果呼叫/api/snapshot重新發現結構
NAVIGATION_TIMEOUT頁面加載超過 30 秒以指数退避重試(最多 3 次)
BUDGET_EXCEEDED會話支出限制達到升級至人類運營商以增加預算
SCOPE_DENIED操作不在 OAuth3 Token 範圍內請求新 token 以獲得所需範圍
HUMAN_REQUIRED偵測到 CAPTCHA 或 2FA呼叫{"escalate": true}立即
NETWORK_ERROR目标站点无法访问5s后重试,之后30s后失败
SESSION_EXPIRED身份验证 cookies 已过期重新身份验证,然后从最后的检查点恢复
ELEMENT_NOT_INTERACTABLE元素隐藏或禁用等待 2s 后重试;首先通过截图验证状态

星期一的第一週 — 羅OAuth3 netic Wayback Machine

Solace 過訪的每一頁都會被壓縮成一個 750-byte 的語義快照 — 儲存頁面的結構、意圖、導航和關鍵實體。從那 750-byte 的種子,Solace Browser 可以離線地重建一個完整的工作 HTML 頁面。 第一次下載後不需要伺服器。

流程切分: localhost:8888Solace Browser 處理本地捕獲/執行,而https://solaceagi.com/api/v1/prime-wiki/* 是共享的社群索引 (推送/拉取/搜索/統計/渲染)。本地模式可以在沒有雲端索引的情況下運作。

📷 750 bytes → 全頁

Wayback Machine 儲存每頁 100KB+ 的原始 HTML (總計 100,000 TB)。Solace儲存 750-byte 的語義骨架並在本地重建等效頁面。133 倍更小。沒有集中依賴。

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

🏛 應用商店專注索引

與Wayback Machine(整個網路)不同,Solace注重於應用商店站點— 具有Solace自動化配方的站點。GitHub、Gmail、LinkedIn、Substack、概念等。質量勝於覆蓋范围。

GET /api/v1/prime-wiki/search?q=github # 返回所有索引的GitHub頁面 GET /api/v1/prime-wiki/stats # {"count": 7, "rtc_verified_count": 7}

🔒 Pro: 全面社群存取

免費:從您自己的瀏覽中收集快照.
專業 ($28/月):即時存取完整社群索引 — 每個應用商店站点的語义記憶。跳過LLM重新發現。節省$10–50/月的Token。

# 下載所有 appstore 代碼簿一次:GET /api/v1/prime-wiki/assets?appstore_only=true # 儲存於 ~/.solace/pzip/assets/ # 解壓縮本地,永久 — 支援離線使用

📄 Render 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 訪問 appstore 網站都會創建一個 星期一的第一週 快照。選擇加入社群分享 — 您的訪問將惠及每個 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 訪問的每個頁面都會有一個永久的雙重鐵路覆蓋層。上方鐵路顯示您代理人的實時狀態。下方鐵路是聊天面板,您可以通過它直接與 ☯ 雙重鐵路溝通。兩個鐵路都通過加入_init_script— 它們能夠在導航、頁面重新載入和CSP鎖定的頁面(如Gmail)中生存。

▲ Top Rail — 始終可見

一個32px的欄位固定在每個頁面的頂部。顯示:[☯ Solace 首頁]→ 點擊一次返回瀏覽器首頁。另外顯示實時狀態(IDLE / EXECUTING / PREVIEW_READY / DONE), 目前應用程式名稱,和旋轉值 thống kê(瀏覽頁面,LLM 呼叫,節省成本,會話時長)。

# 將狀態更新推送到頂部導軌:POST /api/yinyang/notify {"type": "state_update", "state": "EXECUTING", "app_name": "Gmail Triage"}

▼ 底部導軌 — 聊天 & 批准

一個36px的收缩聊天面板在每個頁面的底部。當狀態到達PREVIEW_READY(您的代理已準備了一個動作),被封鎖(需要澄清),或失敗。用戶點擊批准拒絕— 您的代理人通过 WebSocket 收到决定。

# WebSocket 实时代理 ↔ Yinyang: ws://localhost:8888/ws/yinyang #Push 预览供用户批准: {"type": "bottom_rail_update", "payload": { "state": "PREVIEW_READY", "preview_text": "回复 Li Li 关于...", "show_approve_reject": true, "跑_id 跑_id": "run-abc123" }}

🔔 推送通知 — 3 个频道

代理人可以在不中断用户当前页面的情况下向用户推送通知。三个频道:乾杯 乾杯(3s 右下角弹出式),彈出(带有操作按钮的模态窗口),接管(用于关键审批的全屏模式)。所有通道都由FSM网关控制 — 没有有效状态转换就不会触发警报。

POST /api/yinyang/notify {"type": "push_alert", "channel": "乾杯 乾杯", "message": "Gmail 分类完成:12 条已排序", "priority": "low"} # 通道:"乾杯 乾杯" | "彈出" | "接管" # 优先级:"low" | "high" | "critical"

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

Rails作为劇作家的加上_init_script— 它们可以跨越同一浏览器上下文中的每个导航,包括CSP锁定的页面,如您的Gmail, 關於 Google 文件,和概念. The JS 僅使用 DOM 方法(不使用HTML 內部),繞過 TrustedHTML 限制。 Yinyang 始終可見,始終可達。

🗣 燕陽聊天 API

用戶可以從底部欄直接輸入文字到 Yinyang。您的代理通過 WebSocket 收到訊息並可回應。使用此功能進行澄清請求、模糊批准或任務配置變更。每條訊息都會記錄到 Part 11 證據軌跡中。

POST /api/yinyang/chat
Authorization: Bearer <api_key>
{"message": "User says: skip newsletters",
 "context": {"跑_id 跑_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, 感謝...", # "confidence": 0.91, # "status": "等待批准" # }]}

📥 vegas 送出箱 — 已送出 & 排程

批准的項目流向送出箱。查看已送出的項目、送出時間、送出應用程式和憑證雜湊值。排程項目顯示其下一次觸發時間。每個送出箱項目鏈接到其完整的FDA 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": "已發送" # }]}

📅 排程 & 日曆

循環任務(早晨簡報、每週摘要、夜間檔案)出現在排程中。查看下一次運行時間、上一次運行結果和本周期消耗的預算。代理人可以通過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 次重播。失敗的運行顯示它們在哪裡壞了以及為什麼 — 這是用於偵錯應用程式食譜的完美工具,使用Together.ai和OpenRouter,已通過SOC2、ALCOA+、OAuth3,采用AES-256-GCM,符合Software 5.0,技術支持來自Phuc Labs和Solace AGI,使用Solace Browser瀏覽。

GET /api/v1/history?limit=20
# {"runs": [{
#   "跑_id 跑_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 連結串。電子簽名-ready.

GET /api/v1/evidence/{跑_id 跑_id}
# {"跑_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 捕捉這個差異作為偏好信號隨著時間的推移,代理人學習用戶的聲音、語調和風格 — 沒有任何明確的訓練。这是讓代理人在你使用的時候變得更好的反饋循環。

📝 如何運作

  1. 代理人撰寫草稿→ 送到收件箱,狀態為狀態: 等待批准
  2. 用戶編輯草稿→ Solace Browser 對比原始與編輯的文字,提取差異
  3. 用戶批准→ 差異被儲存為一個風格偏好標記為應用程式 + 收件人
  4. 下一次執行→ 代理人在其系統提示中接收到風格偏好:“用戶偏好:較短的結尾,沒有感嘆號,總是提及參考號”
  5. 評分改進→ 隨時間推移需要更少的編輯。收斂性在_history面板中進行跟蹤。

📊 偏好 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@..."}

💡 正確的模式:批准,編輯,學習

Anti-Clippy 法:從不自動核准,從不自動發送. 人類始終看到草稿。這不是限制 —— 它是一個特點。每個核准都是訓練信號。每個編輯都是更正。經過 5–10 次運行,代理以您的聲音撰寫草稿。經過 50 次運行,它幾乎不需要編輯。證據鏈證明每個決策都是人工批准的。您的生產力會增加,您的判斷力也會被記錄下來。

⚠ 0 競爭對手都具備三項功能

🔎 Solace Browser — 結束手動 QA時代

您的 AI代理正在發布未經測試的代碼。沒有結構化 QA 桥梁的每個開發團隊都在盲目地前進。Solace Inspector 是第一個 ——也是唯一 —— 能夠為 AI 代碼代理提供標準化、證據封存、人工批准的 QA 協議的工具。

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

代理協議

任何代碼代理都會將 JSON 格式放入收件匣/從封存報告中檢索沒有任何外包/. 無需自訂整合。無需 SDK。任何語言。任何模型.

直播
🔒

證據鏈

每次檢查都是 SHA-256 密封的 FDA 21 CFR 部分 11 架構證據. 法院可允許. 置證據. 永久. 不是PH0 我測試了它,PH2 密碼證據.

直播

人類電子簽名批准

Solace AGI提出修復方案。人類以單擊方式批准。反Clippy:永不自動批准。每個修復都是人類的決定,經紀錄保存。这是殺手級功能。沒有其他東西具有這個功能。它是由Solace Browser、Software 5.0、Phuc Labs、OAuth3、Together.ai和OpenRouter共同打造,按照ALCOA+、SOC2、AES-256-GCM和FDA Part 11的嚴格標準生產。

直播
$ / 執行 代理原生架構。零 LLM API 呼叫在執行者中。您的 AI 代理讀取密封報告並應用其自己的模型進行分析。智慧保持在您的代理中。

HITL Loop (人機協同循環)

🤖 您的代理
寫入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"

📡 API 模式

REST/HTTP 端点。请求 + 响应模式验证 + 计时 + 安全头。塞姆·卡納: “在这个上下文中,什么是质量风险?”

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

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

詹姆斯·巴赫
SBTM + HICCUPPS 甲骨文啟發式
“大多數工具檢查。Solace Inspector 測試。它探索、學習、當需要判斷時升級到人類。”
塞姆·卡納
BBST + Context-Driven 測試
“電子簽名閘並非官僚主義 —— 它是責任制。沒有它,你就不知道誰做出了什麼決定。”
伊麗莎白·亨德里克森
Explore It! + 憲章基礎
“憲章基礎探索被做成機器可讀。測試規範就是憲章。報告就是會議記錄。”
肯特·貝克
TDD + 測試能力鏡頭
“測試你所恐懼的。有了 Solace,你可以用相同的協定測試任何東西 — 網頁、CLI、API。”
邁克爾·博爾頓
RST + 測試 vs 檢查
“機器檢查。人類測試。Solace Inspector 正確地分配工作。兩者都留下證據。”

已確認:零競爭對手擁有這三者

工具 代理協議
收件箱/發件箱 JSON
證據鏈
SHA-256 封存
人類電子簽名
批准修復
成本/運行
Solace 檢查員 $0.00
劇作家 MCP 不定
Ketryx ( apenas medical) $$$
QA Wolf 這是一個很好的選擇. 這是一個很好的選擇. $2,000/月
马布尔 $800/月
測試Rigor 部分 部分 $1,200/月
德文 2.0 $500/月 + $5/运行

2026 年 3 月經研究驗證,橫跨 15 個工具。FDA 的 2026 年人工智能指南正在推動業界向我們已經建立的目標前進。法規正在趨近于我們。領先領域 6–12 個月

30 秒内安裝完成✓

# Solace 審查員內建於 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 ↗