dsh-session-find 0.0.0-stage → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+## 1.4.0 — 2026-10-18
+
+- **Copy / export Markdown**: header buttons copy the current result set, or save it as `.md`; the document has an H1, a metadata block (scope, options, timestamp, match count) and `### 第 N 轮` sections with `- **source** — snippet` rows.
+- **Search options row**: regex (`.*`), case-sensitive (`Aa`), whole word (`ab`); invalid patterns are reported inline instead of failing silently. Options persist in localStorage.
+- Regex mode wraps the pattern in lookbehind/lookahead for whole-word matching and skips zero-length matches so `*` style patterns cannot loop.
+
+## 1.3.0
+
+- **Turn derivation and grouping**: each row carries the turn it belongs to (count of `user` nodes up to that point), and the list is grouped under turn headers.
+- **Query history**: last 12 queries, `↑`/`↓` in the input; last query is restored when the panel reopens.
+- **Navigation**: `Ctrl+G` / `F3` (Shift to reverse), `↑`/`↓` row selection when the input is not focused.
+- **Highlight all matches** in the conversation, not just the active one.
+- **Prose mode payload toggle** no longer resets on every keystroke and gets its own wording; "excluded N" is now clickable and switches to full-content search.
+
+## 1.2.0
+
+- **Prose-only scope** (default): search your messages and assistant replies only, with a one-click switch to everything and an "excluded N matches" counter.
+
+## 1.1.0
+
+- **Wider panel** (up to 820px) and a 3-line snippet per row.
+- **Source classification**: you / assistant / reasoning / tool call / tool result / system, with a filter bar and per-source counts.
+- **Friendly rows**: source chip, turn chip, `同文 ×N`, hit count per row.
+
+## 1.0.0
+
+- `Ctrl+F` panel over the loaded conversation: results list, click to jump, CSS Custom Highlight API highlighting, same-text merging, collapsed-step expansion.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fomalhaut
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,72 @@
+# dsh-session-find
+
+**Find in session** for DeepSeek Harness: press `Ctrl+F` to search the current conversation, click a hit to jump to that message, with every match highlighted.
+
+Client-only, zero dependencies, no network — all searching happens in the browser, nothing leaves your machine.
+
+[中文](README.md) · [Changelog](CHANGELOG.md)
+
+![Find panel](assets/overview.png)
+
+## Why
+
+Harness conversations run for dozens of turns and interleave prose with tool calls and long JSON. The browser's built-in find only sees *rendered, visible* text: it misses collapsed steps, tool arguments and reasoning, and it cannot tell you who said what, or in which turn.
+
+This plugin makes search conversation-native:
+
+| Capability | What it does |
+|---|---|
+| Source labels | Every hit is tagged **you / assistant / reasoning / tool call / tool result / system**, and can be filtered by source |
+| Turn grouping | Results are grouped under 「第 N 轮」 (turn N) headers, with a per-row turn chip |
+| Same-text merging | Identical snippets (e.g. repeated tool output) collapse into one row marked `同文 ×N` |
+| Prose vs everything | Defaults to **prose only** (your messages + assistant replies); one click searches reasoning, tool payloads and system prompts too, showing how many hits were excluded |
+| Regex / case / whole word | For tokens like `m0\d{3}`, `session-`, `D:\\DSH`; whole-word applies to ASCII words only |
+| Highlight everything | All matches are highlighted in the conversation; the active hit gets an outline |
+| Copy / export | Copy results as Markdown (turn + source + snippet) or save a `.md` file |
+| Persisted state | Query, scope, regex flags and the last 12 queries live in localStorage (`↑`/`↓` in the input recalls history) |
+
+## Install
+
+```sh
+# npm (`--profile` defaults to the current profile)
+dsh plugin add dsh-session-find
+dsh plugin --profile desktop add dsh-session-find
+
+# or track main
+dsh plugin add github:fomalhaut1998/dsh-session-find
+```
+
+Fully quit and restart DSH once: client bundles are assembled at host startup and are not hot-loaded. After that, editing `client.js` only needs a page reload.
+
+Remove: `dsh plugin remove dsh-session-find` (also accepts `--profile`).
+
+## Shortcuts
+
+| Key | Action |
+|---|---|
+| `Ctrl+F` | Open / close the panel |
+| `Enter` / `Shift+Enter` | Next / previous hit |
+| `Ctrl+G` / `F3` (with `Shift` to reverse) | Same, for editor habits |
+| `↑` / `↓` | In the input: recall query history. In the list (input not focused): move the selection |
+| `Esc` | Close the panel (highlights stay until the next search) |
+
+## How it works
+
+- Reads the conversation store's canonical `order` node by node (`nodeStore.get(key)`) instead of walking the DOM, so collapsed steps and unrendered tool payloads are searchable.
+- Projects each node into source-tagged fragments; prose mode concatenates only `user` + `assistant` text, and "excluded N" is the difference to the full hit count.
+- Jumping expands the target turn/step first, then converges with a turn-level binary search plus a single-direction `scrollTop`, falling back to content matching when keys disagree.
+- Highlighting uses the CSS Custom Highlight API, so the DOM is never mutated and React rendering is untouched.
+- `index.js` `apply()` is empty: no IPC, no background index, no requests.
+
+## Limitations
+
+| Limit | Why |
+|---|---|
+| Only **loaded** history | The session is paged in on demand; unloaded messages are not in the store |
+| Result list capped at 300 rows | A scrolling panel beyond that is not usable; the match count itself is uncapped |
+| Whole-word is ASCII-only | Chinese has no word boundaries, so the option only applies to pure ASCII queries |
+| No cross-session search | That needs a host-side index; out of scope for v1 |
+
+## License
+
+MIT

package/README.md

@@ -1,3 +1,103 @@
-# Temporary Holding Version
+# dsh-session-find
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness 的**会话内查找**：按 `Ctrl+F` 在当前对话里全文搜索，点结果跳到那条消息并高亮。
+
+纯客户端插件、零依赖、不联网——所有搜索都在浏览器里完成，会话内容不出本机。
+
+[English](README.en.md) · [更新日志](CHANGELOG.md)
+
+![会话内查找面板](assets/overview.png)
+
+## 它解决什么问题
+
+Harness 的对话动辄几十轮、正文里混着工具调用与长 JSON，原生页内查找（Ctrl+F 开浏览器搜索框）只能命中**渲染出来的可见文字**，找不到折叠的步骤、工具参数、思考内容，也不会告诉你「这条是谁说的、第几轮」。
+
+这个插件把查找做成对话原生的：
+
+| 能力 | 说明 |
+|---|---|
+| 来源分类 | 每条命中标出来源：**你 / 助手 / 思考 / 工具调用 / 工具输出 / 系统**，可按来源过滤 |
+| 轮次分组 | 结果按「第 N 轮」分组，行内也带 `第 N 轮` 标签，一眼看出上下文位置 |
+| 同文合并 | 同一段文字在多处出现（比如重复的工具返回）合并成一条 `同文 ×N` |
+| 正文 / 全量 | 默认只搜**正文**（你发的 + 助手回复），一键切到搜全部内容（含思考、工具参数、系统提示），并显示「已排除 N 处」 |
+| 正则 · Aa · 全词 | 查 `m0\d{3}`、`session-`、`D:\\DSH` 这类 token 时用；全词只对英文/数字词生效 |
+| 全量高亮 | 命中的每一处都在对话里高亮，当前选中的那条额外描边 |
+| 复制 / 导出 | 一键把结果复制成 Markdown（轮次 + 来源 + 片段），或导出 `.md` 文件 |
+| 记住状态 | 查询词、搜索范围、正则开关、历史记录（最近 12 条，输入框里 ↑↓ 调取）都记在 localStorage |
+
+## 安装
+
+```sh
+# 从 npm 装（--profile 省略时改默认 profile）
+dsh plugin add dsh-session-find
+dsh plugin --profile desktop add dsh-session-find
+
+# 或从 GitHub 装（跟踪 main）
+dsh plugin add github:fomalhaut1998/dsh-session-find
+
+# 本地开发：profile 的 package.json 里
+#   dependencies["dsh-session-find"] = "link:/path/to/dsh-session-find"
+#   再把 "dsh-session-find" 加进 dsh.profile.bundles（走 CLI remove → add 会自动写）
+```
+
+装完**完全退出 DSH 再启动**：客户端 bundle 在宿主启动时组装，新插件不会在运行中热加载。之后改 `client.js` 只需刷新页面（桌面端 Ctrl+R）。
+
+卸载：`dsh plugin remove dsh-session-find`（同样支持 `--profile`）。
+
+## 快捷键
+
+| 按键 | 动作 |
+|---|---|
+| `Ctrl+F` | 打开 / 关闭查找面板（焦点在输入框时再次按下也关闭） |
+| `Enter` / `Shift+Enter` | 下一个 / 上一个命中 |
+| `Ctrl+G` / `F3`（`Shift` 反向） | 同上，来自编辑器习惯 |
+| `↑` / `↓` | 输入框里：调取历史查询；列表里（焦点不在输入框）：逐条选结果 |
+| `Esc` | 关闭面板（保留对话里的高亮，直到再次搜索） |
+| `Tab` / 点击 | 在「只在正文里搜」「正则 / Aa / 全词」「来源筛选」之间移动 |
+
+## 一个例子
+
+```
+Ctrl+F → 输入 dsh → 面板顶部：198 处匹配 · 已合并 3 条同文 · 已排除 6347 处
+        点「Aa」→ 156 处匹配（只剩大小写完全一致的）
+        点「只在正文里搜」→ 只保留你和助手说过的话，工具 JSON 里的命中被排除
+```
+
+数字都是实测口径：**匹配数**是全部命中（含同文重复），**列出的条数**是合并去重后能点开的行。
+
+## 复制 / 导出的格式
+
+```markdown
+# 检索：工具
+
+> 只在正文里搜 · 2026/10/18 14:56:48
+> 45 处匹配 · 列出 1 条
+
+### 第 4 轮
+
+- **你** — …g 我自己的这个插件，有以下地方可以优化一下： 1、横向的长度可以长一点…
+```
+
+直接粘进笔记 / issue / 文档就能用。
+
+## 实现要点
+
+- **数据来源**：从对话 store 的 canonical `order` 逐条读节点（`nodeStore.get(key)`），而不是抓 DOM——所以折叠的步骤、未渲染的工具参数都能搜到。
+- **命中投影**：每个节点把内容拆成带来源标记的片段（`role`），正文模式只拼 `user` + `assistant` 的文本；「已排除 N 处」= 全量命中数 − 正文命中数。
+- **定位**：点结果时先把所在轮次/步骤展开，再按轮次二分 + 单向 `scrollTop` 收敛到目标行；key 对不上时按内容兜底，因此长会话里也是稳定的一两步滚动。
+- **高亮**：CSS Custom Highlight API（`::highlight(dsh-session-find)` 与 `::highlight(dsh-session-find-all)`），不改 DOM、不打断 React 渲染。
+- **零宿主依赖**：`index.js` 的 `apply()` 是空的，没有 IPC、没有后台索引、不发网络请求。
+
+## 已知限制
+
+| 限制 | 原因 |
+|---|---|
+| 只搜**已加载**的历史 | 会话是按需分页加载的；未加载的旧消息不在 store 里 |
+| 结果列表上限 300 条 | 面板是滚动列表，再多也没人点；匹配总数不受限 |
+| 全词只对 ASCII 生效 | 中文没有词边界，"全词"对中文无意义，所以只在查询是纯英文/数字时启用 |
+| 不跨会话搜索 | 需要宿主索引，属于另一个量级的功能，未做 |
+| 折叠步骤里的命中 | 会跳到所在回合并提示「已跳到所在回合」 |
+
+## License
+
+MIT