预览查找栏 Makk9609/dsh-find-viewer

dsh-find-viewer

给 DeepSeek Harness 侧边栏的文本预览加一条查找栏，位置就在预览自带的文档工具栏里。
它搜索文件、显示命中数量、高亮命中，并在命中之间跳转。

查找栏覆盖在 Markdown 预览上，当前命中为橙色

查找栏：输入框、计数、上一个/下一个、区分大小写、全字匹配、关闭

功能

- 文档工具栏里的放大镜按钮，紧挨 Open in app。只在预览显示文本文件时出现，因此 PDF、图片、HTML、表格与 Office 预览的工具栏保持原样。
- 查找栏：输入框、n/m 计数、上一个/下一个、区分大小写（Aa）、全字匹配（W）、关闭。Enter 到下一处，Shift+Enter 到上一处，Esc 关闭。
- Cmd/Ctrl+F：当预览是你最后点击的面板时打开查找栏。
- 配色与 Edge/Chrome 页内查找一致：命中 #FFFF00 黄，当前命中 #FF9632 橙，两者文字都是黑色。输入关键词时会自动滚到第一处命中。

计数范围

| 预览 | 计数 | 跳转 | 高亮 |
| 纯文本、代码 | 整份文件，精确 | 任意行，包括查看器尚未加载的行 | 已渲染的每一处 |
| Markdown | 当前已渲染的文字 | 已渲染的每一处 | 已渲染的每一处 |

Markdown 不同，是因为官方 Markdown 视图渲染的是排版后的 HTML：源码标记已不存在，也没有源码行锚点，所以它上面的查找只能在已渲染的内容里计数与跳转，计数随加载增长。纯文本与代码把源码行保留在 DOM 里，因此这两者是整份文件计数。

覆盖的文件：Markdown（.md、.markdown、.mdx）、纯文本与日志、以及代码（.js、.ts、.py、.go、.rs、.java、.c、.cpp、.css、.json、.yaml、 .toml、.sh、.sql 等）。表格（.csv、.tsv）、HTML 与 SVG 保留各自的预览。
Dockerfile 这类没有后缀的文件不在覆盖范围内，因为查看器按文件名后缀选择渲染器。

安装

从 npm：

dsh plugin --profile web add dsh-find-viewer

直接从 GitHub：

dsh plugin --profile web add github:Makk9609/dsh-find-viewer

然后重启 dsh web。也可以在插件市场或插件管理器里一键安装，它们会顺带启用该 bundle。

卸载：

dsh plugin --profile web remove dsh-find-viewer

实现方式

插件没有构建步骤，也没有运行时依赖。它的浏览器半边只在文档工具栏的追加型 list 槽位（sidebar.right.tab.document.actions）里注册一个条目；list 槽位只做追加，不会顶掉任何既有控件。

- 整份文件计数用 harness 自己的分页读取（remote.workspaceFiles.read）——与预览本身用的是同一个读取入口。
- 高亮走 CSS Custom Highlight API：只登记 Range，不修改官方渲染器拥有的 DOM。
- 跳到尚未加载的行时，请求侧边栏导航到该行（sidebarRight.openResource），由查看器自己加载所需页面。
- 文案走客户端 locale 服务（内置中英文字典）。

它不以模块方式引用任何 harness 客户端包，也不注册全局快捷键；只有在预览是你最后点击的面板时才会接管 Cmd/Ctrl+F。

限制

- 整份文件扫描最多覆盖前 20,000 行或 4 MiB（先到者为准），文件更大时查找栏会注明。
最多绘制 3,000 处高亮，最多计数 50,000 处（超出显示 50000+）。
- 高亮需要 CSS Custom Highlight API（Chromium 105+、Safari 17.2+、Firefox 140+）。缺少该 API 时计数与跳转照常，只是不绘制高亮。
- 命中不跨行。
- 已在 DeepSeek Harness 0.2.0-rc.2 上验证。清单里没有声明 engines.dsh 范围，因为与后续版本的兼容性尚未测试。

开发

npm test # 用桩件加载浏览器半边，检查匹配、地址解码、注册形态与输出的高亮规则

client.js 是浏览器半边，index.js 是空的宿主半边——它的存在只是为了让 loader 载入这个包。

许可

MIT