源码系统概览
文章正文
SearchOS 是一个面向开放域信息检索的多智能体协作系统源码，它的设计口号是：像操作系统调度进程一样调度搜索智能体。
与传统搜索引擎只返回链接不同，SearchOS 把零散事实自动补全为带引用的关系型 schema，既能处理单点事实查找，也能完成全域调研级别的资料收集。
系统同时提供终端 TUI 与 Web 前端两种交互形态，并内置一套可扩展的技能体系，适合研究者与开发者二次定制。
源码简介
SearchOS 由 antins-labs 开源，后端基于 Python 3.11+，核心位于 searchos 目录，包含编排器、子智能体、SOCM 中间件与技能系统四大板块。
Web 前端采用 React 19 与 Next.js 16 构建，提供表格、证据、修复与导出等可视化界面，入口为 web/frontend。
配置体系分层清晰：密钥集中在 .env，其余可调项写入 web_settings.json 这一 overlay，Web 与 CLI/TUI 共享同一份配置且优先级最高。
技能库 searchos/skills 收录了大量站点级访问技能，例如汽车、数码、评测类站点的结构化抓取与解析，便于横向扩展数据源。
仓库还附带 GISA 与 WideSearch 两套评测数据集，可用于衡量智能体在广域信息检索上的完整性与忠实度。
适用场景
行业研究：金融分析师可让 SearchOS 汇总某行业全部公司的关键指标，自动产出带出处的数据表。
招聘与情报：从分散渠道收集满足条件的职位或信息，并将结果结构化为可核对清单。
内容生产：撰稿前快速完成全域资料调研，输出带引用的关系型草稿，降低遗漏风险。
工程二次开发：借助技能体系与配置 overlay，把 SearchOS 接入自有搜索与浏览后端。
功能亮点
操作系统式调度：以编排器统一调度多个子智能体，按预算与并发上限并行检索，像调度进程一样高效。
引用可溯源：结果以关系型 schema 呈现，每条事实都保留证据来源，便于人工核验。
双前端体验：终端 TUI 适合极客，Web 前端适合协作与展示，二者共用同一后端 API。
可扩展技能：站点级访问技能可插拔，社区能持续补充新的数据源与解析器。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：React 19 + Next.js 16 + TypeScript（Web 前端，localhost:3000） | 依具体方案选型，需自行搭建与维护 |
| 部署方式 | 推荐执行仓库根目录的一键安装脚本 install.sh，它会创建隔离 .venv、安装依赖并下载 Playwright | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 操作系统式调度：以编排器统一调度多个子智能体，按预算与并发上限并行检索，像调度进程一样高效。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：React 19 + Next.js 16 + TypeScript（Web 前端，localhost:3000）。
后端：Python 3.11+（编排器、子智能体、SOCM 中间件、技能系统）。
数据库：无（评测用 SQLite；配置以 web_settings.json 与 .env 管理）。
运行环境：macOS / Linux，Node.js 20.9+，Python 3.11+。
其他依赖：LangChain、Playwright Chromium、各类搜索与浏览后端。
安装与部署提示
推荐执行仓库根目录的一键安装脚本 install.sh，它会创建隔离 .venv、安装依赖并下载 Playwright Chromium。
启动后端可执行 searchos 或直接运行 web/start.sh；首次启动会通过向导选择模型提供商并写入 .env。
Web 前端需 Node.js 20.9+，进入 web/frontend 执行 npm ci 与 npm run dev，默认访问 http://localhost:3000。
仅需要 CLI/TUI 时可加 –core 参数跳过前端依赖；配置详细说明见 docs/configuration.md 与中文文档。
截图与演示说明
官方提供了系统总览图，直观展示多智能体协作、中间件、SOCM 与技能系统之间的关系。
终端演示动图展示了从命令行发起真实查询，多个子智能体并行填表，再切换到 Web 前端查看综合答案的过程。（该演示以 GIF 形式存放在源仓库 assets 目录，可在 GitHub 原仓库查看。）
产品走查图覆盖初始化、实时覆盖、证据、修复与导出等核心环节，便于理解完整工作流。
Web 演示图呈现前端合成答案与证据面板的实际布局。
其余示例图展示了不同调研任务下的表格填充、证据高亮与导出效果。
常见问题
问：SearchOS 和普通搜索引擎有什么区别？
答：普通搜索返回链接列表，SearchOS 把分散事实补全为带引用的结构化结果，更贴近调研与资料汇总需求。
问：需要联网与 API Key 吗？
答：需要。搜索与浏览后端依赖 Serper、Tavily 等密钥，模型调用也需对应厂商 API Key，均在首次向导或 .env 中配置。
问：可以只装命令行版本吗？
答：可以。安装脚本提供 –core、–no-web、–no-browser 等参数，按需裁剪前端与浏览器依赖。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本仓库采用 MIT 许可证，可自由使用与修改，但接入的第三方搜索后端须自行遵守其服务条款。
GitHub项目开源地址：https://github.com/antins-labs/SearchOS