dsh-search-chat

DeepSeek Harness（DSH）右侧栏的会话搜索插件：跨全部工作区、对聊天记录做字面匹配，结果按时间排列；点击任意一条即可打开对应会话并跳到那条消息附近。

v0.1.0 只做字符匹配（整段短语 / 全部词 / 任一词），不引入语料库、不下载模型、不调用外部 API。

仓库：https://github.com/QwQ2333333-QaQ/dsh-search-chat

功能

🔍 跨工作区搜索：数据来自 DSH 官方的 sessionQuery 会话索引，覆盖所有工作区的历史会话。
🧩 三种字面匹配：整段短语、全部词包含、任一词包含；中文、英文、代码片段都可以。
✅ 结果可信：先走索引找候选，再对每条命中回读原文做字面校验；索引漏检时自动退化为逐会话字面扫描。
🕒 按时间排序：支持时间正序/倒序，结果按天分组。
🎯 点击跳转：打开会话 → 加载到目标 seq → 滚动到匹配消息并高亮 2.4 秒；失败会明确提示（不会静默）。
🗓️ 日期附近检索：选择某一天 + 前后 N 天（0/1/3/7，默认 3），只在该时间窗口内查找；创建时间晚于窗口的会话直接跳过。
🎛️ 搜索范围可调：每会话最多命中、最多扫描会话数、每页结果数都可选并持久化。
🎨 可自定义外观：关键词高亮底色/文字色/加粗、整个搜索面板背景色与不透明度、面板文字色，带预设与恢复默认；设置持久化保存。
🌗 主题中立：默认透明背景继承宿主主题，高亮采用高对比亮黄 + 深色文字，深/浅色皮肤与壁纸下都清晰。
🌐 中英文文案。

环境要求

DSH 0.2.2-rc.1 及以上（需要右侧栏扩展点与 sessionQuery 服务）。
桌面端与 dsh web 均可；本插件不改动任何宿主文件或其它插件。

安装

本机开发安装（推荐给开发者）

在本目录（package.json 所在目录）用 DSH 的插件管理器安装绝对路径：

plugin_manager install_bundle  target = D:\Deepseek Workpalcae\dsh-search-chat

安装完成后如果右侧栏没有立即出现，重启 DSH 客户端（宿主路由与客户端模块在启动时装载）。

作为普通 bundle 发布后安装

发布到 npm 后，用插件管理器按包名安装：

plugin_manager install_bundle  target = dsh-search-chat

卸载

plugin_manager remove_bundle  target = dsh-search-chat

使用

右侧栏点击「会话搜索」（或右侧栏指南页里的同名入口）。
输入要查找的文字；默认「整段匹配」，也可以切「全部词 / 任一词」。
需要时切换「当前工作区」范围与时间顺序。
点击结果：会自动打开该会话、加载历史并滚动到匹配消息附近，同时闪烁高亮。

状态栏会显示命中总数、耗时、以及这次是用「索引」还是「扫描」得到的。

外观与高亮设置

点击标题右侧的 ⚙ 展开「外观设置」：

设置	默认	说明
高亮底色	`#ffd54f`（亮黄）	命中关键词的背景色，附 1px 深色描边，避免与皮肤背景混在一起
高亮文字	自动	默认按底色亮度自动取黑/白，保证对比度；也可以手动指定
关键词加粗	开	关闭后只靠底色区分
面板背景	透明	想更好读可以选一个颜色，并用滑条调整不透明度
面板文字	继承	选深色面板背景后建议改为浅色文字
预设	默认 / 高对比 / 柔和	一键切换整套高亮方案
恢复默认	—	回到透明背景 + 亮黄高亮

改动立即生效，约 0.5 秒后自动保存到 $DSH_HOME/.dsh-search-chat.json（刷新页面、重启客户端、重装插件都会保留）。保存失败时界面会提示「仅本次生效」，不影响搜索。

搜索范围与日期过滤

设置面板（⚙）的「搜索范围」小节：

选项	可选值	默认	作用
每会话命中	1 / 3 / 5 / 8 / 12 / 20	8	同一个会话最多返回多少条命中，避免一个长会话刷屏
扫描会话数	30 / 80 / 150 / 300	80	一次查询最多读取多少个会话；超出时状态栏提示「仅扫描前 N 个」
每页条数	20 / 40 / 80	40	首屏与「加载更多」每页条数

主控件区的「指定日期」：

选择日期后，按本地时区取 当天 00:00 至次日 00:00，再向两边扩展到「附近 N 天」（0=当天、1、3、7；默认 3）。
过滤条件会下推到本地会话索引与逐会话扫描：只返回落在窗口内的事件；创建时间晚于窗口结束的会话不会被扫描。
「全部时间」恢复无日期限制；清空日期或切回全部时间即可。
结果时间戳与过滤窗口一致；未来日期会得到空结果。
全部在本机完成，不调用任何外部 API、不上传会话内容。

已知限制

字面匹配：不会理解同义词或语义，找「大意」请换几个关键词；语义检索在路线图 0.3.0（可选、默认关闭）。
长会话：扫描会话数可在设置里调到 300；超过时状态栏会标注「仅扫描前 N 个会话」。更早的会话可按日期过滤缩小范围。
跳转精度：优先按命中片段在聊天行里定位，其次按轮次定位；若当前会话打开的不是「聊天」视图，会提示无法定位。
内部 DOM 依赖：跳转使用聊天行的 data-chat-* 属性（产品内部属性，非公开 API）。选择器集中在 lib/client.js 的跳转区，DSH 升级后只需调整这一处。详见 docs/API-NOTES.md。

隐私与安全

搜索完全在本机完成：没有遥测、没有外部请求、不读取或返回任何凭据。
宿主路由只接受回环地址请求，并拒绝跨站请求（Sec-Fetch-Site: cross-site）与异源 Origin。
查询内容与结果不写入日志。

开发

npm run validate   # 语法检查 + 清单/挂载文件检查
npm test           # node:test 单元测试（检索核心 + 服务编排 + 清单）

lib/index.js         宿主插件：6 条本机 JSON 路由
lib/search-service.js 检索编排（索引候选 → 字面校验 → 扫描兜底）
lib/search-core.js    纯函数：匹配/片段/排序/分页
lib/settings.js       外观设置的校验、读取与原子写入
lib/fence.js          回环与同源校验
lib/protocol.js       路由与常量
lib/client.js         浏览器半侧：右侧栏 tab + 搜索面板 + 外观设置 + 跳转
test/                 node:test
docs/                 API 备注与路线图

开发循环：改客户端（lib/client.js）→ 刷新页面；改宿主（lib/index.js 等）→ 重启 DSH 客户端再验证。只重装插件而不重启时，DSH 的热重载可能在 Host 路由表里留下上一实例的注册，导致新实例的路由被判重复（插件已做自愈清理与重复容错，但首次仍建议重启一次）；版本按语义化递增并更新 CHANGELOG.md。

License

MIT。见 LICENSE。

English summary

A right-sidebar session search plugin for DeepSeek Harness. It searches chat history across all workspaces using literal character matching (phrase, all terms, or any term), lists hits in time order, and jumps the conversation to the matched message with a short highlight.

Requires DSH >= 0.2.2-rc.1 (right-sidebar extension points + sessionQuery).
No corpus, embeddings, or external API calls in v0.1.0.
Host routes are loopback-only and reject cross-site requests; no credentials are read, returned, or logged.
Jumping relies on the product's internal data-chat-* row attributes; the selectors are isolated and documented in docs/API-NOTES.md.
Appearance is configurable (highlight background/text/bold, panel background and opacity, panel text) with presets; settings persist under $DSH_HOME.

Install the absolute package directory with the DSH plugin manager, restart the client if the tab does not appear immediately.

dsh-search-chat

v0.1.0 只做字符匹配（整段短语 / 全部词 / 任一词），不引入语料库、不下载模型、不调用外部 API。

仓库：https://github.com/QwQ2333333-QaQ/dsh-search-chat

功能

🔍 跨工作区搜索：数据来自 DSH 官方的 sessionQuery 会话索引，覆盖所有工作区的历史会话。
🧩 三种字面匹配：整段短语、全部词包含、任一词包含；中文、英文、代码片段都可以。
✅ 结果可信：先走索引找候选，再对每条命中回读原文做字面校验；索引漏检时自动退化为逐会话字面扫描。
🕒 按时间排序：支持时间正序/倒序，结果按天分组。
🎯 点击跳转：打开会话 → 加载到目标 seq → 滚动到匹配消息并高亮 2.4 秒；失败会明确提示（不会静默）。
🗓️ 日期附近检索：选择某一天 + 前后 N 天（0/1/3/7，默认 3），只在该时间窗口内查找；创建时间晚于窗口的会话直接跳过。
🎛️ 搜索范围可调：每会话最多命中、最多扫描会话数、每页结果数都可选并持久化。
🎨 可自定义外观：关键词高亮底色/文字色/加粗、整个搜索面板背景色与不透明度、面板文字色，带预设与恢复默认；设置持久化保存。
🌗 主题中立：默认透明背景继承宿主主题，高亮采用高对比亮黄 + 深色文字，深/浅色皮肤与壁纸下都清晰。
🌐 中英文文案。

环境要求

DSH 0.2.2-rc.1 及以上（需要右侧栏扩展点与 sessionQuery 服务）。
桌面端与 dsh web 均可；本插件不改动任何宿主文件或其它插件。

安装

本机开发安装（推荐给开发者）

在本目录（package.json 所在目录）用 DSH 的插件管理器安装绝对路径：

plugin_manager install_bundle  target = D:\Deepseek Workpalcae\dsh-search-chat

安装完成后如果右侧栏没有立即出现，重启 DSH 客户端（宿主路由与客户端模块在启动时装载）。

作为普通 bundle 发布后安装

发布到 npm 后，用插件管理器按包名安装：

plugin_manager install_bundle  target = dsh-search-chat

卸载

plugin_manager remove_bundle  target = dsh-search-chat

使用

右侧栏点击「会话搜索」（或右侧栏指南页里的同名入口）。
输入要查找的文字；默认「整段匹配」，也可以切「全部词 / 任一词」。
需要时切换「当前工作区」范围与时间顺序。
点击结果：会自动打开该会话、加载历史并滚动到匹配消息附近，同时闪烁高亮。

状态栏会显示命中总数、耗时、以及这次是用「索引」还是「扫描」得到的。

外观与高亮设置

点击标题右侧的 ⚙ 展开「外观设置」：

设置	默认	说明
高亮底色	`#ffd54f`（亮黄）	命中关键词的背景色，附 1px 深色描边，避免与皮肤背景混在一起
高亮文字	自动	默认按底色亮度自动取黑/白，保证对比度；也可以手动指定
关键词加粗	开	关闭后只靠底色区分
面板背景	透明	想更好读可以选一个颜色，并用滑条调整不透明度
面板文字	继承	选深色面板背景后建议改为浅色文字
预设	默认 / 高对比 / 柔和	一键切换整套高亮方案
恢复默认	—	回到透明背景 + 亮黄高亮

搜索范围与日期过滤

设置面板（⚙）的「搜索范围」小节：

选项	可选值	默认	作用
每会话命中	1 / 3 / 5 / 8 / 12 / 20	8	同一个会话最多返回多少条命中，避免一个长会话刷屏
扫描会话数	30 / 80 / 150 / 300	80	一次查询最多读取多少个会话；超出时状态栏提示「仅扫描前 N 个」
每页条数	20 / 40 / 80	40	首屏与「加载更多」每页条数

主控件区的「指定日期」：

选择日期后，按本地时区取 当天 00:00 至次日 00:00，再向两边扩展到「附近 N 天」（0=当天、1、3、7；默认 3）。
过滤条件会下推到本地会话索引与逐会话扫描：只返回落在窗口内的事件；创建时间晚于窗口结束的会话不会被扫描。
「全部时间」恢复无日期限制；清空日期或切回全部时间即可。
结果时间戳与过滤窗口一致；未来日期会得到空结果。
全部在本机完成，不调用任何外部 API、不上传会话内容。

已知限制

字面匹配：不会理解同义词或语义，找「大意」请换几个关键词；语义检索在路线图 0.3.0（可选、默认关闭）。
长会话：扫描会话数可在设置里调到 300；超过时状态栏会标注「仅扫描前 N 个会话」。更早的会话可按日期过滤缩小范围。
跳转精度：优先按命中片段在聊天行里定位，其次按轮次定位；若当前会话打开的不是「聊天」视图，会提示无法定位。
内部 DOM 依赖：跳转使用聊天行的 data-chat-* 属性（产品内部属性，非公开 API）。选择器集中在 lib/client.js 的跳转区，DSH 升级后只需调整这一处。详见 docs/API-NOTES.md。

隐私与安全

搜索完全在本机完成：没有遥测、没有外部请求、不读取或返回任何凭据。
宿主路由只接受回环地址请求，并拒绝跨站请求（Sec-Fetch-Site: cross-site）与异源 Origin。
查询内容与结果不写入日志。

开发

npm run validate   # 语法检查 + 清单/挂载文件检查
npm test           # node:test 单元测试（检索核心 + 服务编排 + 清单）

lib/index.js         宿主插件：6 条本机 JSON 路由
lib/search-service.js 检索编排（索引候选 → 字面校验 → 扫描兜底）
lib/search-core.js    纯函数：匹配/片段/排序/分页
lib/settings.js       外观设置的校验、读取与原子写入
lib/fence.js          回环与同源校验
lib/protocol.js       路由与常量
lib/client.js         浏览器半侧：右侧栏 tab + 搜索面板 + 外观设置 + 跳转
test/                 node:test
docs/                 API 备注与路线图

License

MIT。见 LICENSE。

English summary

Requires DSH >= 0.2.2-rc.1 (right-sidebar extension points + sessionQuery).
No corpus, embeddings, or external API calls in v0.1.0.
Host routes are loopback-only and reject cross-site requests; no credentials are read, returned, or logged.
Jumping relies on the product's internal data-chat-* row attributes; the selectors are isolated and documented in docs/API-NOTES.md.
Appearance is configurable (highlight background/text/bold, panel background and opacity, panel text) with presets; settings persist under $DSH_HOME.

Install the absolute package directory with the DSH plugin manager, restart the client if the tab does not appear immediately.

QwQ2333333-QaQ/dsh-search-chat

dsh-search-chat

功能

环境要求

安装

本机开发安装（推荐给开发者）

作为普通 bundle 发布后安装

卸载

使用

外观与高亮设置

搜索范围与日期过滤

已知限制

隐私与安全

开发

License

English summary

Community comments

QwQ2333333-QaQ/dsh-search-chat

dsh-search-chat

功能

环境要求

安装

本机开发安装（推荐给开发者）

作为普通 bundle 发布后安装

卸载

使用

外观与高亮设置

搜索范围与日期过滤

已知限制

隐私与安全

开发

License

English summary

Community comments