DeepSeek Harness 插件

luorenyu/dsh-deepsearch

Star 数 ★ 0 下载量(近 30 天) 494 分类 会话与消息 收录于 2026-11-16 npm @renyuluo/dsh-deepsearch

本地会话全文搜索,支持中文片段匹配、摘要高亮、工作区筛选、本机搜索历史和原生会话打开。

安装

# npm 包(预构建)

dsh plugin --profile web add @renyuluo/dsh-deepsearch

# Release 预构建包

dsh plugin --profile web add "https://github.com/luorenyu/dsh-deepsearch/releases/download/v0.1.17/renyuluo-dsh-deepsearch-0.1.17.tgz"

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:luorenyu/dsh-deepsearch

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

CI

简体中文 | English

为 DeepSeek Harness 制作的本地全文搜索插件。记得一小段内容,就能找回对应会话,而不必记住标题。

  • 中文片段也能搜:不依赖 FTS 分词,支持连续中文子串、英文大小写不敏感和字面符号。
  • 正文搜索:会话标题、用户输入、助手已完成的最终回复;命中摘要直接高亮,展示消息的本地日期与时间。
  • 当前会话优先:先从当前会话最新消息往前搜索,再自动逐批扫描其他会话。
  • 原生会话定位:打开 DSH 原生会话,加载精确消息并尝试滚动、高亮,不替换详情页。
  • 范围与外观:项目 / 工作区过滤、可选归档;毛玻璃、跟随主题、自定义颜色、不透明度与模糊。
  • 可选手动未读:设置开关控制侧栏右键标记,复用原生左侧未读点;再次打开自动已读,标记仅保存在本机。
  • 本机搜索历史:停顿 1 秒记录关键词,最多 30 条;重搜、删除和默认起始 Tab 偏好,不存聊天正文。
  • 项目直达与快捷键:项目结果开启原生新会话并尝试展开侧栏;macOS 可选接管 ⌘K,关闭恢复原绑定。
  • 不上传聊天:复用宿主认证与历史服务,不开额外生产监听端口,不修改消息;仅在你确认“恢复并打开”时取消归档。

功能预览

除特别标注的侧边栏重绘示意外,以下图片使用真实插件组件 + 隔离模拟宿主 + 虚构演示数据生成;均非你的聊天记录或 DSH 原生页面截图。原生消息跳转需在真实宿主中验证,演示页不模拟“定位成功”。

全文搜索、命中摘要与准确时间

正文搜索:中文命中摘要与消息日期时间

项目与工作区范围

按项目与工作区缩小搜索范围

归档会话

可选搜索归档会话

三种面板外观

局部毛玻璃搜索面板

跟随宿主主题

自定义底色、不透明度与模糊

扩展小功能:手动未读

在设置中开启后,通过侧栏右键菜单标记未读 / 已读;再次进入会话自动清除。标记和开关仅保存在本机。设置图来自真实插件组件;右键菜单图使用高还原侧边栏重绘,嵌入统一功能卡片。重绘图不是原生截图或运行验证证据。

设置中开启会话未读标记

右键菜单标记未读与左侧状态点示意

搜索历史与紧凑设置

关键词在本机保存;可选择默认历史、重搜或删除。设置中的 ⌘K 演示使用内存模拟快捷键服务,不代表修改真实宿主配置。

搜索历史与默认起始 Tab

紧凑设置与可选 ⌘K 接管

安装

当前验证宿主为 DSH Desktop 0.2.2-rc.3;其他版本与平台尚未完成真实桌面回归。包的兼容性范围暂时限定该版本。

从 npm 安装(推荐)

公开包名为 @renyuluo/dsh-deepsearch。本次功能版本为 0.1.17。请使用下方命令安装;发布状态以 npm 版本页与 GitHub Release 为准。

dsh plugin --profile desktop add @renyuluo/dsh-deepsearch

公开包名为 @renyuluo/dsh-deepsearch;产品名和 GitHub 仓库名不变。

从 GitHub 安装

dsh plugin --profile desktop add 'https://github.com/luorenyu/dsh-deepsearch.git#v0.1.17'

也可以从 Releases 下载安装包后安装:

dsh plugin --profile desktop add /path/to/renyuluo-dsh-deepsearch-0.1.17.tgz

重要:不要运行 add dsh-deepsearch 来安装 npm 同名包。 无作用域的 npm 同名包属于其他作者,与本仓库无关。请使用 @renyuluo/dsh-deepsearch,或本仓库 GitHub / Release 地址。

从本项目旧版无作用域 GitHub 安装迁移时,请先卸载旧条目,再安装作用域包,避免两份搜索插件同时加载:

dsh plugin --profile desktop remove dsh-deepsearch
dsh plugin --profile desktop add @renyuluo/dsh-deepsearch

这是替换本项目旧安装条目,不是建议卸载其他作者的同名插件。外观存储键保持不变;同一宿主页面来源下已有偏好会继续使用。

组件截图已按 0.1.17 更新;菜单场景仍保留已批准的虚构侧边栏重绘。所有演示使用隔离宿主和虚构数据,不展示私人会话;原生导航、快捷键持久化等须以真实宿主验证为准。

在 DSH 插件市场中发现

已提交 市场收录申请 #15379,目前为草稿,等待仓库创建满 24 小时后转为正式待审及维护者审核。Awesome DSH Plugin 是 dshmarket 使用的第三方社区目录;是否收录以 PR 合并和市场同步为准。GitHub 发布不等于已经在市场上架。

审核通过后,可在相应市场搜索 DeepSearch 或 会话全文搜索。请确认来源是 luorenyu/dsh-deepsearch,不是其他作者的同名插件。DSH 本体也支持自定义索引,各客户端配置的来源可能不同。

使用

操作 快捷键 / 入口
打开或关闭搜索 macOS ⌘⇧K;Windows / Linux Ctrl⇧K(未实机验证)
选择结果 ↑ / ↓
打开结果 Enter;项目结果点击或回车将在该项目下开启原生新会话
关闭浮层 Esc 或点击外部
搜索范围 全部 / 对话 / 项目,工作区下拉,含归档
调整面板与扩展功能 右上角「设置」

默认不占用 DSH 原生 ⌘K,可在设置中选择接管;不占用其他搜索插件常用的 ⌘F。

「含归档」默认勾选,可手动取消。未输入关键词时,最近对话显示所属项目与会话最后更新时间(本机时区,年/月/日 时:分);缺失的项目或时间分别显示「未分配项目」「时间未知」。外观恢复默认使用模糊滑条后的回转箭头图标,悬停可见说明。

未输入关键词时,可切换「最近对话 / 搜索历史」。「默认历史」位于「含归档」左侧,勾选后「搜索历史」排在第一位,取消后「最近对话」排在第一位;切换偏好不跳走当前内容,每次重新打开选中第一项(仅本机保存)。关键词停顿 1 秒后记录,中文输入法组词期间不记录;最多 30 条、同词去重、最近使用优先。点击或回车选择历史会重新搜索,不会直接打开会话;支持单条删除与清空,不保存结果或聊天正文。

输入中文片段或英文关键词后,搜索自动继续,不需要逐页点击。结果随扫描逐步出现;只有扫描完成且没有命中才显示没有找到。读取失败、超时、未完成与 200 条结果上限会单独提示。切换关键词或关闭面板会取消旧任务。

点击正文结果后,插件打开原生会话,使用 sessionId + seq 检查精确消息是否存在,随后尝试定位原生行并高亮。提示区可以返回搜索或清除高亮;切换会话或其他功能页时释放定位资源。标题结果仅打开会话,不冒充消息定位成功。

项目结果会先进入该项目的原生新会话页,再尝试一次性展开左侧目标项目及折叠的父级,并将项目和新会话滚动到可见区域。手动滚动、继续操作或打开其他结果会终止定位;侧栏收起、平铺/筛选视图或宿主结构变化时可跳过,不影响新会话打开。工作区下拉仍只筛选搜索范围。

可选接管原生 ⌘K

在「设置」开启「使用 ⌘K 打开 DeepSearch」后,macOS 桌面端通过 DSH 官方快捷键接口将原生会话搜索让位给 DeepSearch;⌘⇧K 保留。默认关闭,关闭时恢复开启前的原绑定,而不是强制重置你的自定义快捷键。该选项会写入 DSH 快捷键配置,并在本机保存恢复备份;刷新后保留。

卸载插件前请先关闭接管。 直接卸载不会自动恢复宿主配置;可在 DSH 快捷键设置中恢复「会话搜索」,并清除 DeepSearch 的绑定。若写入失败或期间被其他设置修改,插件会尝试安全回滚,保留备份并提示恢复,不覆盖新配置。当前只支持 macOS 桌面端,不是任意快捷键录入器。

打开归档结果

勾选“含归档”后,归档会话的标题与正文结果显示 「已归档」 标签。点击时保留搜索结果并请求确认;只有选择 「恢复并打开」 才调用宿主取消归档,然后进入原生会话并尝试定位。选择「取消」不会改变归档状态。

恢复失败或超时会保留结果并提示原因,不静默跳转,也不自动重新归档。恢复请求发出后不能保证撤回;关闭面板或更换查询只会取消后续自动跳转,宿主仍可能完成已确认的恢复操作。

外观

  • 毛玻璃:优先使用宿主输入框玻璃底色,仅对搜索面板覆盖区域模糊。
  • 跟随 DSH:使用宿主主题的实色底板。
  • 自定义:颜色、不透明度 55–100%、模糊 0–32px,可恢复默认。

不暗化全屏,不模糊整个 DSH 页面。兼容壁纸插件的实色弹窗覆盖规则,修正只作用于 DeepSearch 自己。偏好存于本机 localStorage;禁止存储时仍可在本次使用。系统要求降低透明度或不支持模糊时使用实色回退。

扩展小功能 · 手动未读

在右上角「设置」开启「会话未读标记」(默认关闭)。右键侧栏会话可标记为未读或已读,未读标记复用 DSH 原生 StateDot 未读组件,在会话名称左侧显示,颜色与尺寸跟随宿主。再次进入会话时清除手动标记;在当前会话上标记不会立即清除。

开关与标记保存在当前客户端本机,不跨设备同步,也不修改宿主原生完成提醒。关闭功能隐藏菜单和圆点但保留标记;与原生状态点共用左侧位置,运行中、待交互及原生完成提醒优先显示;归档和空白会话不显示手动圆点。无法保存本机存储时,设置区会提示,本次使用仍有效。

隐私与限制

  • 通过宿主公开历史服务读取,不直接解析私有聊天文件,不上传聊天、不写入原始消息。搜索 API 使用宿主 connection.fetch owner 认证路由。
  • 默认搜索普通会话标题、用户输入及已完成助手最终回复;排除工具输出、推理、子智能体与未完成回复。界面默认勾选「含归档」,可手动关闭;底层 API 仍需显式请求归档。
  • 搜索采用有界内存、短期游标和逐批扫描,不是持久增量索引。超长历史首次查询可能较慢;最多显示 200 条命中,游标闲置两分钟过期后需重搜。
  • 每个会话首次读取的历史切面构成本次范围;扫描期间新追加内容需要重新搜索才会出现。版本变更或历史截断会明确要求重新搜索。
  • 项目来自宿主已登记工作区,不搜索磁盘文件内容,也不提供命令搜索。
  • 消息时间按本机时区显示为 YYYY/MM/DD HH:mm,缺失或非法时间不编造。
  • 精确定位使用当前宿主 DOM 兼容适配,并非公开稳定滚动 API。折叠消息、Markdown 文本变形、非 Chat 视图、宿主升级或滚动策略可能导致无法定位或逐字高亮,插件会区分状态,不阻塞原生会话。

开发与测试

无需构建和生产第三方依赖,Node.js 22+:

git clone https://github.com/luorenyu/dsh-deepsearch.git
cd dsh-deepsearch
npm test
npm run check
npm pack --ignore-scripts

核心测试覆盖字面匹配、中文与 Unicode 范围、历史投影、逆序分页、自动续搜、取消 / 超时 / 游标、原生定位生命周期、摘要渲染、时间和外观。组件截图和模拟服务测试不等于所有宿主版本、主题与平台实机验收。

代码分工:

  • client.js:搜索浮层、快捷键、摘要、外观和原生定位适配。
  • host.js:认证路由和请求限制。
  • search-core.js:会话目录、最终回复投影、字串匹配和分页。
  • tests:无宿主单元 / 合约回归测试。

卸载:

dsh plugin --profile desktop remove @renyuluo/dsh-deepsearch

MIT License · 问题反馈

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。