ChekhovsGun v0.2.0

ChekhovsGun v0.2.0

首个打包发布版本。ChekhovsGun 在你阅读相关内容时，从自己的收藏中找出有用的段落；也支持从扩展工具栏主动搜索。

下载哪个文件？

文件	用途
chekhovsgun-0.2.0-lite.zip	大多数用户从这里开始。 Chrome / Edge 扩展，无需 Python、后端或 API key。
ChekhovsGun-windows.zip	Windows x64 可选本地后端。
ChekhovsGun-macos.zip	macOS Apple Silicon (arm64) 可选本地后端；Intel Mac 请使用 Python 源码安装。
ChekhovsGun-linux.zip	Linux x86_64 可选本地后端，在 GitHub Ubuntu runner 构建，旧发行版可能存在兼容性限制。
SHA256SUMS.txt	下载文件的 SHA-256 校验值。

GitHub 自动附带的 Source code 是源码，安装扩展请下载上表中的 lite 包。

安装扩展

1. 下载并解压 chekhovsgun-0.2.0-lite.zip，保留解压目录。
2. Chrome 打开 chrome://extensions，Edge 打开 edge://extensions，开启开发者模式。
3. 点击「加载已解压的扩展」，选择包含 manifest.json 的目录。
4. 打开要保存的页面，通过扩展工具栏保存，或在支持的站点使用原生收藏按钮。
5. 点击扩展图标即可搜索。自动提醒在收藏达到 15 条后启用，并受相关性阈值控制。

需要 Chrome 116 或更新版本；这是开发者模式安装包，尚非浏览器商店分发。

这个版本包含什么

• 浏览器内 IndexedDB 存储、BM25 与哈希向量混合检索，无需后台服务。
• 工具栏主动搜索、相关段落摘要、原文定位及视频时间点链接。
• 收藏夹扫描、站点规则、已学完与静音状态。
• 修复页面身份与缓存隔离、重复链接覆盖正文、后端批量转发和结果去重。
• 修复可选语义模型运行库加载、编码签名与模型关闭期间的并发问题。
• 修复发布包包含测试文件和残留旧文件的问题。

可选后端与模型

后端与扩展分别安装。解压对应平台的后端后，可运行 ChekhovsGun（Windows 为 ChekhovsGun.exe）；不带参数启动托盘服务，有参数时作为 CLI 使用。在扩展设置中主动开启后端连接。macOS / Linux 如缺少执行权限，先运行 chmod +x ChekhovsGun。

后端提供平台 API 同步、字幕与评论采集及扫描链接的正文抓取。平台同步需要自行配置凭据。
本次后端二进制不包含 Whisper 或 sentence-transformers 等可选依赖。 需要这些能力请按 README 使用 Python 安装对应 extras；Whisper 还需要 ffmpeg。

lite 扩展未内置神经语义模型，使用 BM25 与哈希编码器。需要本地 multilingual-e5-small，可从源码按 README 准备模型后加载扩展。纯跨语言检索仍可能受到置信度门槛限制。

验证与边界

• 136 个 JavaScript 测试、258 个 Python 测试及 Ruff 检查通过。
• CI 覆盖 Python 3.10–3.12；发布流程执行三平台构建及打包后 CLI 冒烟检查。
• 已在本地 Chromium 验证扩展搜索、可选模型 384 维推理与模型关闭后的词面检索回退。
• 未使用个人凭据验证线上 YouTube / Bilibili 同步；收藏夹分页和虚拟列表可能造成扫描不完整。
• 后端产物未签名或公证，操作系统可能提示。三平台 CLI 检查不等同于三平台桌面托盘交互验证。

使用说明（中文） · English README · 反馈问题