🔍 dsh-ventus-search

🧩 一键整合安装：dsh-ventus-plugins —— 本插件已并入整合包，也可按本仓库方式单独安装。

Ventus 搜索 · DeepSeek Harness 多引擎搜索与正文抓取插件 —— 注册进 ctx.web 的搜索 / 抓取双 provider：Bing、360、Bilibili 三引擎并发搜索，命中评分、URL 去重、跳转链接解码、整体超时兜底、LRU 缓存；正文抓取带广告域名黑名单、类 Readability 抽取与镜像回退。附 Ventus 系列设置卡：总开关、每引擎开关、健康状态与一键测试搜索。

✨ 特性

🚀 安装

Git 安装

dsh plugin --profile web add github:mmzm0808/dsh-ventus-search

本地开发安装

dsh plugin --profile web add "<本仓库本地绝对路径>"

• 仓库已提交完整 lib/ 构建产物，安装无需执行构建脚本（pnpm ≥10 的 allowBuilds 门禁不影响本插件）
• 安装后重启 dsh（新 bundle 层在启动时加载）
• DSH 插件开发使用 pnpm；GitHub 分发不要求发布 npm

安装后 profile 的 cordis.patch.yml 会插入一行：

- insert:
    - id: dsh-ventus-search
      name: dsh-ventus-search

📖 使用

1. 设置卡：设置 → Ventus 插件 → Ventus 搜索
2. 总开关：关闭后搜索与抓取 provider 立即不可用（available() 返回 false）
3. 引擎开关：可单独启用/禁用 Bing / 360 / Bilibili（无需改配置）
4. 测试搜索：在输入框输入关键词（默认 "DeepSeek Harness 最新动态"），点「测试搜索」→ 展示耗时、来源数与结果列表（标题可点击、摘要、URL）
5. 健康状态：每引擎显示状态圆点（绿=正常 / 红=失败 / 灰=未测）+ 最近成功时间 / 失败原因

⚙️ 配置（schemastery，全部有默认值）

引擎实际启用 = 配置 engines.<id>（硬默认）AND 状态文件 engines.<id>.enabled（运行时覆盖）。

🗂️ 数据与安全

• 状态文件：~/.dsh/plugins/ventus-search/state.json（原子写入 + fsync）；引擎状态含 enabled / health / lastOkAt / lastError，旧版扁平字符串格式自动迁移
• API（loopback-only，仅本机可访问，Cache-Control: no-store）：
  • GET /api/ventus-search/state — 当前状态
  • PATCH /api/ventus-search/state — body { "enabled"?: boolean, "engines"?: { "bing"?: boolean, "so360"?: boolean, "bilibili"?: boolean } }
  • POST /api/ventus-search/test — body { "query": string }（≤200 字符）→ 真实搜索并返回 { ok, durationMs, sources, engines }

🛠️ 开发

pnpm typecheck    # tsc --noEmit（需要先按 scripts/build.sh 建 node_modules junction）
pnpm build        # scripts/build.sh：link junction + tsc 编译 host
pnpm build:client # tsdown 产出 lib/client.js（不清理 host lib）

• host 路由与 provider 注册全部挂在 ctx.effect 下，卸载即清理
• client 设置卡的轮询/测试请求随 fiber dispose 清理（AbortController）

🐋 Ventus 系列插件

📄 许可证

MIT License · Copyright (c) 2026 Ventus