元搜索聚合 leolee9086/SAC_search

SAC_search

SAC = Stand Alone Complex（攻壳机动队术语）：没有原型的独立复合体。 命名梗一脉相承自 SiyuanAssistantCollection（表面读作 “Siyuan Assistant Collection”，SAC 实为 Stand Alone Complex 的标准缩写）——本仓库延续同一梗：官方没有给第三方插件预留注册面（没有原型），社区插件自发聚合出同类能力（独立复合体）。本仓库不是任何官方项目的子集，而是一个独立成型的复合体——约 200 个免 API key 搜索引擎自发聚合，在 DeepSeek Harness 上作为自包含插件运行。

本仓库曾经把三个插件放在子目录里一起发布。它们现在各有自己的仓库，本地工作副本也各自独立；本仓库只保留这段记录与共用的资源（如赞赏码）。

| 插件 | 仓库 | 做什么 |
| dsh-tool-websearch | leolee9086/dsh-tool-websearch | 互联网元搜索：免 API key 直接调用 DuckDuckGo / Bing / Google / 百度 / 搜狗 等约 200 个搜索引擎，并发执行、结果去重聚合、按引擎权重与时效性评分。搜索实现移植自 s-code，构建期打包为自包含 ESM bundle，运行时零依赖。 |
| dsh-tool-everything | leolee9086/dsh-tool-everything | 本机文件索引检索：查询 Everything 自带的 HTTP 接口，毫秒级按文件名、路径、扩展名、大小、修改时间检索整机文件；path 参数可把范围限定在某个目录（自动补尾分隔符，不会连带同前缀的兄弟目录）。索引含整机文件名，所以审批跟着会话文件权限走：完全权限直接调用，工作区/只读权限每次调用都过 DSH 审批，审批理由里带本次查询的关键词。零运行时依赖。 |
| dsh-better-session-query | leolee9086/dsh-better-session-query | 会话历史与记忆：给会话历史再挂一套块级并行索引（一条消息拆成 text / reasoning / tool-call / tool-result 等块，可按块检索与读取），另有记忆（q / a / tag / expires）、被动召回与属性表。不替换官方 session-query，不改任何 DSH 源码。 |

它们都通过 Cordis 服务契约接入 DSH。

为什么要拆：子目录里的代码被两个仓库同时跟踪时，一次改动可能提到错误的那个仓库，而两边的历史会各自往前走 —— 拆成“一个插件一个仓库、各自一个工作副本”之后，这类分叉就不会再发生。

安装

需要 Node.js 22.19.0 或更高版本、pnpm，以及兼容的 DeepSeek Harness Web 环境。

插件从各自的仓库安装 —— 每个仓库根就是插件包本身，所以 pnpm add 'github:leolee9086/dsh-tool-websearch' 这类 git 依赖形式能用（本仓库不再发布插件包）。

在 DSH Web profile 目录（默认 ~/.dsh/profiles/web，Windows 通常为 %USERPROFILE%\.dsh\profiles\web）执行：

pnpm add 'github:leolee9086/dsh-tool-websearch'

然后在该 profile 的 cordis.patch.yml 中加入下列配置；已有 insert 列表时只需向列表追加这一项，不要重复注册：

- insert:
- id: dsh-tool-websearch
name: dsh-tool-websearch

包内已带 cordis.patch.yml，因此也可以直接作为 bundle 挂载：

- name: dsh-tool-websearch

重载插件或重启 DSH 后刷新浏览器页面。开发时也可以把插件目录整个放进 $DSH_HOME/plugins/ 后重启 dsh。

两个插件各有自己的前置条件：

- dsh-tool-websearch 开箱即用，免 API key。
- dsh-tool-everything 需要本机装好 Everything 并打开它的 HTTP 服务（默认是关的），只绑回环、关掉文件下载：

; %APPDATA%\Everything\Everything.ini（改前请先退出 Everything）
http_server_enabled=1
http_server_bindings=127.0.0.1
http_server_port=8080
http_server_allow_file_download=0

端口要和插件 config.port 一致。细节见 dsh-tool-everything 的 README。

用法

模型侧的工具：

web_search_meta(query="rust async runtime 对比", engines=["duckduckgo","bing","baidu"])
web_search_status() # 可用引擎、权重、超时、速率限制、缓存与健康状态
web_search_proxy() # 查看/切换本地代理（探测 127.0.0.1:7890 等本地代理）

搜索结果在浏览器里以结果卡展示，运行中的逐引擎进度也显示在该卡片上。

运行进度当前实现的进度只保存在插件实例内存里，按 sessionId + callId 隔离，每次保留最多五条结果预览；搜索完成、失败、取消或插件卸载时清理，迟到回调不会恢复已清理状态。插件不注册进度投影，也不调用 Session.append 写入自定义事件——最终搜索文本仍通过正常工具返回值保存，历史结果卡继续读取该结果。细节见 dsh-tool-websearch 的 README。

两个历史分支

main 之前，本仓库用两个分支对比过“自定义会话事件”的两种用法。它们保留下来作为那段对比的记录：

| 分支 | 进度通道 | 会话历史安全 | 运行中逐引擎进度 |
| standard | 纯官方 API，不写任何自定义事件 | ✅ 永远安全 | ❌ 仅静态卡片「正在搜索: q」 |
| progress-events | 自定义事件 tool/websearch-progress + ignorable 标记 | ⚠️ 依赖官方 Session.append 的 ignorable 表面（见下） | ✅ 实时：引擎 x/y、当前引擎、已得条数、最新结果预览 |

两个分支的搜索引擎代码、工具 schema、结果渲染完全一致，唯一差异是进度通道。

为什么当初要有这两个分支

DeepSeek Harness 的会话日志持久化有一个已知事件类型白名单 KNOWN_SESSION_EVENT_TYPES（由 gen-persistence-catalog.ts 从 repo 内 SessionEventMap 声明生成）。读取端遇到白名单外的事件时：

- 未标记 ignorable: true → 整份会话日志拒绝加载（SessionFormatUnsupportedError，历史“损坏”且无法修复）；
- 标记 ignorable: true → 跳过该事件，正常恢复。

官方架构笔记 2026-08-10-session-log-version-mechanism 明确说明：

“writers do not yet set ignorable (no producer needs it), so Session.append gains that surface with its first user.”

即：官方设计预期 Session.append 会在第一个用户出现时获得 ignorable 表面。progress-events 分支曾在官方实现该表面之前以最小补丁提前使用它，standard 分支则证明插件在纯官方 API 下也能完整工作。

main 最终选了第三条路：进度只留在插件实例的内存里，既不写自定义事件、也不依赖官方补丁，因此既没有日志风险也不需要等待官方实现。

许可证

MIT

交流

想聊工具软件折腾、或者有问题要问，欢迎加个人讨论群【工具软件爱好者折腾群-综合讨论】：点击加入（群号 1017854502）。

赞赏

如果这个项目帮到了你，可以请我喝杯咖啡：

赞赏码

也欢迎通过 爱发电 支持。