juso-search

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #typescript #llm #golang #linux #nodejs #windows #vue #pytorch #ios #mcp

(★ 30)

An open-source browser extension—a gateway with two-sided reach into search, with locally managed credentials—for humans and local AI agents.

juso-search 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 双面搜 / Juso

[![License: MPL-2.0](https://img.shields.io/badge/License-MPL--2.0-blue.svg)](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/LICENSE)
[![Release](https://img.shields.io/github/v/release/aiguozhi123456/juso-search?label=Release)](https://github.com/aiguozhi123456/juso-search/releases/latest)
[![PyPI](https://img.shields.io/pypi/v/juso-search?label=PyPI)](https://pypi.org/project/juso-search/)
[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/illmhdnglkjfcenboepdgopaeejdgoji?label=Chrome%20Web%20Store)](https://chromewebstore.google.com/detail/%E5%8F%8C%E9%9D%A2%E6%90%9C/illmhdnglkjfcenboepdgopaeejdgoji)
[![Website](https://img.shields.io/badge/Website-双面搜-c8372d)](https://aiguozhi123456.github.io/juso-search/)
[![Manifest V3](https://img.shields.io/badge/Manifest-V3-green.svg)](https://developer.chrome.com/docs/extensions/develop/migrate)
[![WXT](https://img.shields.io/badge/Built%20with-WXT-6B46C1.svg)](https://wxt.dev)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/aiguozhi123456/juso-search/pulls)

**简体中文** | [English](README.en.md)

> **一面为人，一面为智能体。**

Juso 是一个开源的双面搜索产品：它让人类用户在同一入口选择、切换传统搜索引擎、站外搜索（Site Engine）、自定义引擎、AI 对话引擎与已配置的 AI 搜索服务；也让本地 AI 智能体通过同一台浏览器调用 AI 搜索 API，或检索传统搜索引擎。密钥由扩展在本地管理，搜索请求直接前往你选择的服务。即使只使用人类这一面，它也是一个功能完整、开箱即用的搜索聚合与切换工具——无需配置任何 AI 服务即可使用 Google、Bing、Baidu、抖音、小红书、哔哩哔哩、Yandex 和 DuckDuckGo，也可在设置中保存面向指定站点的站外搜索、任意带查询参数的自定义引擎，并把 AI 对话站点当作搜索引擎切换。

| 面向谁 | 现在能做什么 |
| --- | --- |
| 人类用户 | 聚合传统搜索引擎、站外搜索、自定义引擎，并在独立搜索页与结果页中快速切换 |
| 人类用户 | 把 AI 搜索 API 变成可直接使用、可与传统引擎快切的搜索体验（支持多实例） |
| 人类用户 | 把 AI 对话站点当作搜索引擎，自动填入查询、可选自动提交 |
| 本地 AI 智能体 | 通过统一入口调用已配置的 AI 搜索 API（含按实例搜索） |
| 本地 AI 智能体 | 借助真实浏览器检索传统搜索引擎 |

## 截图与演示

**AI 搜索：综合答案与结果列表同屏**

![Juso 搜索页，AI 服务返回带引用的综合答案，下方为结果列表](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/docs/assets/screenshot-search.png)

**SERP 切换栏：在搜索引擎结果页内一键切换**

![Bing 结果页顶部的 Juso 切换栏，可切到其他引擎或 AI 搜索](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/docs/assets/screenshot-serp.png)

**多实例：同一 AI 服务的多套参数，快切栏一等切换**

![Juso 设置页的实例管理：为同一 AI 搜索服务保存多套调好参数的实例](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/docs/assets/screens/settings-instances-clean.png)

**本地缓存与历史：成功的 AI 搜索可查看、可重放**

![Juso 搜索页的缓存与历史面板](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/docs/assets/screens/search-cache-panel-clean.png)

**搜索来源管理：五类来源统一管理**

![Juso 设置页的搜索来源管理](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/docs/assets/screens/settings-sources-clean.png)

**Agent Bridge：本地智能体的搜索入口**

![Juso 设置页通用页的 Agent Bridge 开关](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/docs/assets/screens/settings-general-clean.png)

**完整流程演示**

![在 Juso 搜索页与搜索引擎结果页之间切换的演示](https://raw.githubusercontent.com/aiguozhi123456/juso-search/main/docs/assets/demo.gif)

## 当前能力与来源

Juso 将**搜索来源**作为统一的用户选择：它可以是传统**搜索引擎**、用户保存的**站外搜索（Site Engine）**或**自定义引擎（Custom Engine）**、已配置的 AI 搜索服务（可为同一服务创建多个调好参数的**实例**），或预置的 **AI 对话引擎**；五类来源的执行方式不同。

- 传统搜索引擎：Google、Bing、Baidu、抖音、小红书、哔哩哔哩、Yandex、DuckDuckGo。它们不使用 API 密钥；Juso 通过浏览器导航，供人直接使用；八个引擎均支持智能体提取普通搜索结果（哔哩哔哩、小红书、抖音在浏览器已登录状态下提取）。
- 站外搜索（Site Engine）：在扩展设置中保存多个站点；每个条目固定选用 Google、Bing 或 Baidu 之一，用 `site:` 限定到该站点后搜索。目标须为公网域名；底层引擎在创建时选定，之后不再更改。创建后会出现在搜索页与 SERP 切换栏，与其他来源一样可切换。无需 API 密钥。
- 自定义引擎（Custom Engine）：在扩展设置中保存任意带 `%s` 占位符的网址，即可把它当作搜索引擎加入搜索页与 SERP 切换栏。与站外搜索不同，自定义引擎直接导航到用户指定的 URL，不依赖底层引擎。无需 API 密钥。
- AI 搜索服务：Tavily、Exa、Brave、Stepfun 按量 API、Stepfun Step Plan、Jina、Doubao（Custom 与 Global 双端点）。服务经由统一的适配器接口访问，但各自的鉴权与计费由相应服务决定。支持实例的服务（当前为 Exa 与 Doubao Custom）可保存多套调好参数的实例（如不同搜索场景或过滤方向），每个实例是快切栏里的一等可切换目标；实例不持有密钥，密钥仍按服务类型共享。
- AI 对话引擎：Grok、ChatGPT、DeepSeek、豆包、Gemini。把 AI 对话站点当作搜索引擎，切换过去时自动填入查询、可选自动提交。这类来源默认隐藏（需登录），在设置页显示后进入快切栏。不使用 API 密钥。
- 答案能力：Tavily 和 Exa 可返回综合答案及结果列表；Stepfun（含 Step Plan）、Brave、Jina、Doubao 当前仅返回结果列表。AI 对话引擎为对话界面，不在此列。

“聚合”在当前版本中指统一接入、选择与快速切换搜索来源，**不表示**一次查询默认并行请求多个来源，也不表示默认合并、去重或融合结果。

## 人类使用

独立搜索页提供搜索来源选择和切换（含已保存的站外搜索与自定义引擎）；在 Google、Bing、Baidu、抖音、小红书、哔哩哔哩、Yandex、DuckDuckGo 的受支持结果页上，SERP 切换栏可将当前查询直接切到其他搜索来源，或跳转至 Juso 的 AI 搜索页。

成功的 AI 搜索会缓存在当前设备上，并形成可查看、可重放的本地搜索历史。缓存按“服务 + 规范化查询”区分，不在服务之间共享。需要最新结果时，请显式刷新；刷新会绕过缓存，并可能产生所选 AI 服务的费用。

## 快速开始

Juso v1.4.0 已在 GitHub Release 与 Chrome Web Store 发布。

### 安装扩展

**从 Chrome Web Store 安装（推荐）**

1. 访问 [Chrome Web Store 上的双面搜](https://chromewebstore.google.com/detail/%E5%8F%8C%E9%9D%A2%E6%90%9C/illmhdnglkjfcenboepdgopaeejdgoji)。
2. 点击「添加至 Chrome」安装并启用扩展。

Chrome Web Store 安装无开发者模式警告，且可自动更新。

**从 GitHub Release 安装**

1. 从 [GitHub Release 最新版](https://github.com/aiguozhi123456/juso-search/releases/latest) 下载 `juso-search-*-chrome-dev.zip`。
2. 解压 ZIP。
3. 打开 Chromium 的 `chrome://extensions`，开启"开发者模式"，选择"加载已解压的扩展程序"，并选择解压后直接包含 `manifest.json` 的目录。

**从源码安装**

详见[开发文档](docs/DEVELOPMENT.md)，包含开发命令、构建区别与架构说明。

### 人类用户

1. 打开 Juso 搜索页并选择搜索来源。Google、Bing、Baidu、抖音、小红书、哔哩哔哩、Yandex、DuckDuckGo 无需配置（默认隐藏的可在设置页点「显示」启用）；AI 对话引擎同样无需 API 密钥（默认隐藏，需登录）；若要站外搜索，在扩展设置中添加 Site Engine（站点 + 底层引擎）；也可添加自定义引擎（带 `%s` 占位符的网址）；只有使用 AI 搜索服务时，才需要配置对应服务的密钥。

完成后，你可以在一个入口搜索、切换传统引擎、站外搜索、自定义引擎、AI 对话引擎和已配置的 AI 搜索服务。

### 本地 AI 智能体

1. 按上面的步骤在 **装有 Juso 的 Chromium 系浏览器**（Chrome / Edge / Chromium 等）中安装并启用扩展。使用 `engine-search` 检索传统搜索引擎无需配置 AI 搜索服务；只有通过 `search --provider` 调用 AI 搜索 API 时，才需要先配置对应服务。
2. 打开扩展 Options → 通用 → Agent Bridge，开启 Agent Bridge 总开关（默认关闭，需显式开启）。若要用 `engine-search` 检索传统搜索引擎，再单独开启其子开关。

智能体接入有 **CLI Skill** 与 **MCP Server** 两种方式，二选一即可。两者走同一个 Agent Bridge、同样的 5 个 action，密钥同样不离开扩展。

#### 方式一：Agent Skill（CLI）

在扩展 Options 同一页面点「下载配套 Agent Skill」，得到自动按本机扩展 ID 盖章的技能包，解压后拷到 `.agents/skills/` 即可。从技能目录运行：

```bash
python scripts/juso_search.py list-providers
python scripts/juso_search.py search "latest AI research" --provider tavily
python scripts/juso_search.py engine-search "latest AI research" --engine google --max-results 10
# 支持实例的服务（Exa、Doubao）可按实例搜索：
python scripts/juso_search.py list-instances
python scripts/juso_search.py search-instance "latest AI research" --instance-id inst:exa:abc123
```

浏览器路径、profile、扩展 ID、超时等边缘配置见技能包内的参考文档。

#### 方式二：MCP Server

适合 MCP 原生客户端（Claude Desktop / Cursor / Cline / Claude Code）。`pip install juso-search` 后，把 `juso-search` 加进客户端的 `mcp.json`，`env` 里设 `JUSO_EXTENSION_ID`（扩展 ID 见 `chrome://extensions`）：

```json
{
  "mcpServers": {
    "juso": {
      "command": "juso-search",
      "env": { "JUSO_EXTENSION_ID": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" }
    }
  }
}
```

各客户端的差异与全部环境变量（`JUSO_CHROME_PATH`、`JUSO_CHROME_PROFILE`、`JUSO_TIMEOUT`）见 [`mcp-server/README.md`](mcp-server/README.md)。

---

无论哪种方式，本地智能体都可列出已配置的服务、以**显式**服务参数进行 API 搜索、按实例搜索支持实例的服务，或通过浏览器检索受支持的传统搜索引擎（Google、Bing、Baidu、Yandex、DuckDuckGo、哔哩哔哩、小红书、抖音），而不会取得已存储的密钥。

## 安全与数据边界

- AI 搜索服务密钥由扩展本地管理，保存在 `chrome.storage.local`；仅后台 service worker 读取。UI 页面不会读取已存储的密钥，本地 AI 智能体也不会获得这些密钥。
- 需要鉴权时，密钥会发送给你选择的 AI 搜索服务；查询会到达你选择的 AI 搜索服务或传统搜索引擎。
- Juso 当前本地模式不运营请求中转服务，也不发送遥测。但浏览器、网络、传统搜索引擎及 AI 搜索服务可能记录请求；Juso 无法保证匿名或控制这些第三方的记录实践。
- 配置导出由用户主动触发，包含未加密的密钥和偏好设置。导出文件敏感且由你自行保管；Juso 不运营配置备份或凭据同步服务。

## 智能体接口与边界

智能体通过短生命周期、仅回环地址的 Agent Bridge 调用扩展后台的一次受限操作，而不是连接一个常驻本地 API。每次调用使用新的本地端口、令牌与请求标识，完成或超时后即失效。

MCP server（`juso-search`）复用同一 Agent Bridge 接口与边界：同样 5 个 action（`list-providers`、`search`、`list-instances`、`search-instance`、`engine-search`）、同样的默认关闭门控，密钥同样只由 worker 读取、绝不离开扩展。上述接口与边界对 CLI skill 与 MCP server 同样适用。

`search` 必须提供 `--provider`，不会悄悄跟随扩展当前服务。支持实例的服务（Exa、Doubao）可用 `search-instance --instance-id` 按实例搜索，实例 id 从 `list-instances` 取得。`engine-search` 仅提取普通结果链接，不承诺 AI 摘要、知识面板或其他页面内容；取得 URL 后，页面抓取应由智能体宿主自己的 `web_fetch` 等能力完成。启动或桥接失败时，标准输出中的 JSON 会带结构化 `error.kind`（例如 `chrome_not_found`、`chrome_launch_failed`、`extension_did_not_claim`、`extension_did_not_complete`）；请按提示检查浏览器路径、profile、扩展 ID，以及打开的浏览器里是否已启用 Juso，不要通过暴露密钥来重试。`engine-search` 在验证页、同意页、布局不支持或无结果时也会失败。完整 kind 表见 `skills/juso-search/SKILL.md`。

## 开发

详见[开发文档](docs/DEVELOPMENT.md)，包含从源码安装、开发命令、架构说明与测试指南。

## 可能的未来

这不是路线图或承诺。我们可能根据需求、接口可用性与服务稳定性，适配更多 AI 搜索服务和传统搜索引擎；也可能探索可选的多来源并行检索、去重、排序和保留来源的结果融合。任何这类能力都应让用户明确控制成本、范围和等待时间。

## 命名历史

项目最初的中文名为「聚搜」，英文名为「Juso」。自 2026-07-23（v1.0.0 发布后）起，中文名改为「双面搜」，英文名保持 Juso 不变，品牌写作「双面搜 / Juso」。

改名原因：「双面搜」直接对应本产品“双面搜索”的定位——一面为人，一面为智能体——并在中文语境下更具唯一性。英文名 Juso 因简洁好记、且品牌查询（如 “Juso extension”）可被独占而保留。

代码层面的标识符（包名 `juso-search`、环境变量 `JUSO_*`、CSS 变量 `--juso-*`、智能体技能名 `juso-search`）沿用 Juso，不随中文名变更。

## 鸣谢

本扩展在 Google / Bing / Baidu 结果页注入切换栏的部分思路——“作为结果容器首子元素插入以继承宽度、简化对齐”，以及“向宿主页注入 CSS shim 给切换栏腾出空间”——以及哔哩哔哩结果页注入锚点（`.head-contain` / `.search-input`）的选择，参考自 [searchEngineJump 搜索引擎快捷跳转](https://greasyfork.org/zh-CN/scripts/27752-searchenginejump)（作者：NLF、锐经、[qxin i](https://github.com/qxinGitHub/searchEngineJump)，MIT 许可）。本扩展的实现独立编写，与原脚本不共享代码。

AI 对话引擎注入层（DeepSeek / ChatGPT / Gemini / 豆包）的输入框定位、填充与提交方案，参考自多个社区油猴脚本与公开技术文章，主要包括：[给 AI 搜索网站添加 q 查询参数](https://greasyfork.org/zh-CN/scripts/550940)（smilingpoplar，MIT 许可，多站 `?q=` 通用实现）、[DeepSeek Prompt Automation](https://gist.github.com/orca131/7f4dd7f2ec377c09cdb8b0ad5cd10e68)（orca131）、[AI 助手选择器](https://greasyfork.org/zh-CN/scripts/528300)（Gemini / Grok / ChatGPT / DeepSeek 输入框选择器）、[豆包自动发送助手](https://greasyfork.org/zh-CN/scripts/541111)（CathyElla，MIT 许可）与 boommanpro《[豆包 URL 参数调用](https://boommanpro.cn/post/doubao-plugin)》（豆包 `execCommand` 填充结论），以及 ChatGPT `?q=` 预填行为的记录（[OpenAI 帮助中心《ChatGPT Search》](https://help.openai.com/en/articles/9237897-chatgpt-search)（官方）、[Tenable TRA-2025-22](https://www.tenable.com/security/research/tra-2025-22)、[Zenn《どこでもワンステップでAI呼び出し》](https://zenn.dev/finatext/articles/283442255930fe)）。本扩展的注入器实现独立编写，与上述来源不共享代码；所用选择器为各站点 DOM 事实，React 受控组件 native value setter、`execCommand('insertText')`、contenteditable 同步、`PerformanceNavigationTiming` 兜底等均为标准 Web API 技术。

## 商标声明

本扩展中出现的所有第三方产品名、品牌名、服务名、商标与图标（包括但不限于 Google、Bing、Baidu、抖音、小红书、哔哩哔哩、Yandex、DuckDuckGo、Tavily、Exa、Brave、Stepfun、Jina、豆包、DeepSeek、ChatGPT、Gemini、Grok 等）均归各自所有者所有，仅用于指代对应的搜索来源与服务。本扩展与上述品牌所有者不存在关联、赞助或背书关系，亦非其官方产品。图标按各品牌公开规范使用。

## 许可证

Juso 的完整本地搜索闭环——当前扩展、来源集成、智能体访问、本地配置与缓存——以 [MPL-2.0](LICENSE) 开放。该承诺不表示未来可能出现的托管或运营服务必然开源或免费。

juso-search

juso-search 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

juso-search

juso-search 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README