DUAL-FACE SEARCH

双面搜Juso

让本地智能体，借同一台浏览器搜索。Let local agents search through the same browser.

在装有双面搜的 Chromium 浏览器里，本地 AI 智能体可调用你已配置的 AI 搜索 API，或借真实浏览器检索传统搜索引擎——密钥始终留在扩展内，智能体不会取得它们。

juso-search bash

# 列出已配置的服务
$ python scripts/juso_search.py list-providers

# 显式指定 provider 搜索
$ python scripts/juso_search.py search "latest AI research" --provider tavily

CLI命令行接口

智能体能力

四项能力，覆盖 AI 搜索 API 调用与传统引擎检索。

调用已配置的 AI 搜索 API

通过 search --provider 显式指定服务，调用你已配置的 AI 搜索 API。--provider 必填，不会悄悄跟随扩展当前服务。支持实例的服务可按实例搜索。

search --provider

借真实浏览器检索传统引擎

engine-search 在真实浏览器中检索 8 个传统引擎（Google、Bing、百度等），提取普通结果链接，不承诺 AI 摘要或知识面板。

engine-search

列出已配置的服务

list-providers 返回已配置的 AI 搜索服务，智能体据此选择 provider，而不接触任何密钥。

list-providers

按实例搜索

对支持实例的服务（Exa、豆包）用 list-instances 取得实例 id，再用 search-instance --instance-id 按实例搜索。实例是同一服务的多套调好参数的变体，共享同一密钥。

list-instances / search-instance

命令行接口

真实命令，取自配套 Agent Skill。密钥从不离开扩展，智能体只收到结构化结果。

列出已配置的服务 bash

$ python scripts/juso_search.py list-providers

列出已配置的服务 — 返回已配置的 AI 搜索服务，智能体据此选择 provider。

调用 AI 搜索 API bash

$ python scripts/juso_search.py search "latest AI research" --provider tavily

调用 AI 搜索 API — 显式指定 provider 进行搜索，不跟随扩展当前服务。

检索传统引擎 bash

$ python scripts/juso_search.py engine-search "latest AI research" --engine google --max-results 10

检索传统引擎 — 借真实浏览器检索传统引擎，仅提取普通结果链接。

列出实例 bash

$ python scripts/juso_search.py list-instances

列出实例 — 对支持实例的服务（Exa、豆包）取得实例 id。

按实例搜索 bash

$ python scripts/juso_search.py search-instance "latest AI research" --instance-id inst:exa:abc123

按实例搜索 — 用实例 id 搜索支持实例的服务；实例是同一服务的多套调好参数的变体，共享同一密钥。

安全模型

密钥零接触、仅回环地址、双层 opt-in 默认关闭。

密钥零接触

智能体通过 Agent Bridge 调用扩展后台的受限操作，绝不会获得已存储的密钥。

仅回环地址

Agent Bridge 是短生命周期、仅回环地址的能力通道，每次调用使用新的本地端口、令牌与请求标识，完成或超时后即失效。

双层 opt-in，默认关闭

总开关默认关闭；engine-search 子开关单独控制浏览器检索传统引擎的能力，需显式开启。

显式 provider，不跟随状态

search 必须提供 --provider，不会悄悄跟随扩展当前服务；engine-search 仅提取普通结果链接，不承诺 AI 摘要或知识面板。

如何接入

四步：安装扩展 → 开启 Agent Bridge → 下载配套技能 → 运行命令。

安装扩展

在将运行 Agent 调用的 Chromium 系浏览器（Chrome、Edge、Chromium 等）中安装并启用双面搜。engine-search 无需配置 AI 搜索服务；调用 AI 搜索 API 时才需配置对应服务。

开启 Agent Bridge

打开扩展选项页 → 通用 → Agent Bridge，开启总开关（默认关闭）。要用 engine-search 检索传统引擎，再单独开启其子开关。

下载配套技能

在同一页面点「下载配套 Agent Skill」，技能包自动按本机扩展 ID 盖章；解压后拷到 .agents/skills/。

运行命令

从技能目录运行命令：list-providers、search --provider、engine-search，或对支持实例的服务（Exa、豆包）用 list-instances / search-instance。

让本地智能体开始搜索

安装扩展，开启 Agent Bridge，下载配套技能——智能体即可调用已配置的 AI 搜索或检索传统引擎，密钥始终留在扩展内。

安装扩展在 GitHub 查看