# 🔍 SearchSieve — 搜索结果覆盖度「筛子」

> 搜索完了，结果到底够不够？SearchSieve 帮你把搜索结果**筛**一遍：答得全不全、留得准不准、重复多不多，一张卡片全看清。

[![dsh compatibility](https://img.shields.io/badge/dsh-0.1.1--rc.2-purple)](https://www.npmjs.com/package/@deepseek-ai/dsh-tools) [![npm release](https://img.shields.io/npm/v/search-sieve)](https://www.npmjs.com/package/search-sieve) [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![stars](https://img.shields.io/github/stars/rangrongg/SearchSieve)](https://github.com/rangrongg/SearchSieve)

**English** · [更新日志](CHANGELOG.md)

---

## 安装

```sh
dsh plugin add search-sieve
```

装完重启 dsh web，下一次网络搜索后覆盖度卡片就会自动出现。需要 dsh web 0.1.0-rc.x 或更新版本。

## 功能一览

- **三个指标一次说清** —— 选中占比（留了几条）、回答完整度（答全没有）、代表性与冗余（留得值不值、重不重），外加未覆盖要点和补搜建议，一张卡片全给你。
- **搜索完卡片自动来** —— 每次 `web_search` 结束，SearchSieve 自动接上评估，不用手动拼参数，覆盖度随手可见。
- **三套皮肤随意换** —— 粉白、蓝白、纯白三种卡片风格，展开卡片右上角一点就换，选择自动记住。
- **零模型开销** —— 纯规则算法，不调模型、不要 API key、确定性输出，快且透明。
- **中文原生态** —— 中文无需分词词典，按语义要点逐点核对，`expectedPoints` 传得越准，评估越到位。
- **边界全兜住** —— 空结果、零选中、提不出关键词，都有明确提示和建议，绝不崩溃。

## 用法介绍

### 1. 怎么看

随便发起一次网络搜索，结果里就会出现 SearchSieve 的覆盖度卡片——点一下折叠行展开详情：

| 粉白（默认） | 蓝白 | 白色 |
|:---:|:---:|:---:|
| ![粉白卡片](pink.png) | ![蓝白卡片](blue.png) | ![白色卡片](white.png) |

顶部大号百分比是**回答完整度**，旁边是覆盖等级徽标（覆盖良好 / 部分覆盖 / 覆盖不足）；下面三根进度条分别对应回答完整度、对全集代表性、信息冗余度；再往下是选中占比、结果数、评估要点，以及**未覆盖的信息点**和**建议**。

### 2. 怎么换风格

展开卡片后，右上角有个调色板按钮，点击在粉白 / 蓝白 / 白色之间循环切换，选完自动记住，下次还是它。

### 3. 想评估得更准

工具接受 `expectedPoints`（期望的回答要点）。你把"答到什么程度算好"说清楚，SearchSieve 就逐点核对给你看；不传也行，它会自动从问题里提取关键词。

```jsonc
{
  "query": "村上春树一共写了几本书",
  "expectedPoints": ["作品数量", "最新作品", "诺贝尔奖经历", "代表作书名"],
  "searchResults": [
    "村上春树共出版 14 部长篇小说，最新作品《城市及其不确定的墙》 https://example.com/a",
    "村上春树多次入围诺贝尔文学奖但未获奖 https://example.com/b"
  ],
  "selectedResults": [
    "村上春树共出版 14 部长篇小说，最新作品《城市及其不确定的墙》 https://example.com/a"
  ]
}
```

返回示例（卡片渲染的就是它）：

```jsonc
{
  "selectionRatio": "50%",        // 留用 1/2 条
  "answerCompleteness": "50%",    // 4 个要点：命中 1、部分命中 2
  "representativeness": "62%",    // 留用页覆盖全集信息权重的 62%
  "redundancy": "0%",             // 单页无重复
  "gaps": ["代表作书名（未找到相关结果）", "作品数量（仅部分提及）", "诺贝尔奖经历（仅部分提及）"],
  "suggestion": "已覆盖期望要点：最新作品；建议补充搜索：“代表作书名”……"
}
```

## 本地开发

```sh
git clone https://github.com/rangrongg/SearchSieve.git
cd SearchSieve
pnpm install        # 或 npm install
npm run build       # tsc 编译服务端 + esbuild 打包客户端

# 在仓库【父目录】把插件装进 profile
cd ..
dsh plugin --profile web add ./SearchSieve

# 回仓库启动
cd SearchSieve
npm run web         # = npm run build && dsh web
```

浏览器打开 **http://127.0.0.1:3080**，启动日志出现 `[search-sieve] registered "search_sieve" — listed=true` 即注册成功。

> Windows PowerShell 报"禁止运行脚本"时，用 `dsh.cmd` / `npm.cmd` 代替。

## 许可证

MIT © rangrongg。