dsh-conversation-navigator 0.2.4 → 0.2.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.en.md +113 -111
- package/README.md +110 -107
- package/cordis.patch.yml +7 -7
- package/lib/client.js +1870 -1475
- package/lib/index.js +4 -4
- package/package.json +49 -47
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 dsh-conversation-navigator contributors
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dsh-conversation-navigator contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.en.md
CHANGED
|
@@ -1,111 +1,113 @@
|
|
|
1
|
-
# DSH Conversation Navigator (dsh-conversation-navigator)
|
|
2
|
-
|
|
3
|
-
[English](README.en.md) | [中文](README.md)
|
|
4
|
-
|
|
5
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
6
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
7
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
8
|
-
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
9
|
-
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
10
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
11
|
-
[](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
|
|
12
|
-
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
13
|
-
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
14
|
-
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
15
|
-
|
|
16
|
-
A **DeepSeek Harness (DSH) Web conversation navigator panel**: a turn-folded outline floating on the **right** side of the conversation page. Click any node to smooth-jump, watch the current reading position highlight as you scroll, with step badges colored to match the built-in "Trajectory" view.
|
|
17
|
-
|
|
18
|
-
Browser-only (no host behavior), plain JavaScript, zero build step, zero npm dependencies (buttons/tooltips reuse the official primitives from the DSH kernel seed).
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
>
|
|
26
|
-
|
|
27
|
-
## Features
|
|
28
|
-
|
|
29
|
-
- **Turn-folded outline**: shows "Turn N + your question" rows by default, long conversations at a glance
|
|
30
|
-
- **Keyword filter**: click the top-left search icon to reveal the inline input; matches only your questions + the assistant's actual reply text (context, tool calls, commands, compaction and reasoning never match); hits are highlighted and the list text is windowed to the keyword
|
|
31
|
-
- **Expand / collapse steps**: the arrow button on the right of each turn row (`▸ N`, rotates to `▾` when expanded) smoothly expands or collapses the turn's step details (assistant replies, tool calls, commands, compaction points, etc.)
|
|
32
|
-
- **Hover full text**: rest the mouse on a turn row and a bubble shows the user's complete question, no longer truncated to one line
|
|
33
|
-
- **Full / Hidden / Minimal modes**: the header toggle cycles
|
|
34
|
-
- **Full**: the classic grouped view (system events like compaction are shown bold, at the same level as turns)
|
|
35
|
-
- **Hidden**: every row is a trajectory badge + text (user = business blue, assistant = violet, compaction = neutral gray)
|
|
36
|
-
- **Minimal-
|
|
37
|
-
-
|
|
38
|
-
|
|
39
|
-
- **
|
|
40
|
-
- **
|
|
41
|
-
- **
|
|
42
|
-
- **
|
|
43
|
-
- **
|
|
44
|
-
- **
|
|
45
|
-
- **
|
|
46
|
-
- **
|
|
47
|
-
- **
|
|
48
|
-
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
-
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
-
|
|
94
|
-
- **
|
|
95
|
-
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
1
|
+
# DSH Conversation Navigator (dsh-conversation-navigator)
|
|
2
|
+
|
|
3
|
+
[English](README.en.md) | [中文](README.md)
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
6
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
7
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
8
|
+
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
9
|
+
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
10
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
11
|
+
[](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
|
|
12
|
+
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
13
|
+
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
14
|
+
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
15
|
+
|
|
16
|
+
A **DeepSeek Harness (DSH) Web conversation navigator panel**: a turn-folded outline floating on the **right** side of the conversation page. Click any node to smooth-jump, watch the current reading position highlight as you scroll, with step badges colored to match the built-in "Trajectory" view.
|
|
17
|
+
|
|
18
|
+
Browser-only (no host behavior), plain JavaScript, zero build step, zero npm dependencies (buttons/tooltips reuse the official primitives from the DSH kernel seed).
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
> Three forms: full, hidden, and minimal-left (minimal-right is shelved as of 0.2.6, code retained). The minimal strips collapse to the in-row indicator bars; hover expands the positioning panel. More screenshots in [assets/screenshots](./assets/screenshots). The two "community skins" shots are taken under third-party skins (whale-girl maid theme and the "Your Name" theme), not bundled with the plugin.
|
|
26
|
+
|
|
27
|
+
## Features
|
|
28
|
+
|
|
29
|
+
- **Turn-folded outline**: shows "Turn N + your question" rows by default, long conversations at a glance
|
|
30
|
+
- **Keyword filter**: click the top-left search icon to reveal the inline input; matches only your questions + the assistant's actual reply text (context, tool calls, commands, compaction and reasoning never match); hits are highlighted and the list text is windowed to the keyword
|
|
31
|
+
- **Expand / collapse steps**: the arrow button on the right of each turn row (`▸ N`, rotates to `▾` when expanded) smoothly expands or collapses the turn's step details (assistant replies, tool calls, commands, compaction points, etc.)
|
|
32
|
+
- **Hover full text**: rest the mouse on a turn row and a bubble shows the user's complete question, no longer truncated to one line
|
|
33
|
+
- **Full / Hidden / Minimal-left modes**: the header toggle cycles three states —
|
|
34
|
+
- **Full**: the classic grouped view (system events like compaction are shown bold, at the same level as turns)
|
|
35
|
+
- **Hidden**: every row is a trajectory badge + text (user = business blue, assistant = violet, compaction = neutral gray)
|
|
36
|
+
- **Minimal-left**: the indicator-bar strip pinned to the left edge of the conversation area (at the right border of the DSH sidebar), leaving the right side for dsh-better-sidebar and zero overlap with the official rail
|
|
37
|
+
- The minimal strip collapses to the in-row indicator bars (current = solid brand color, others = 40% foreground-color mix); hovering expands a fixed 7-row positioning panel (click to jump, hover bubble for the full question, thumb-only scrollbar beyond 7 rows; left-aligned expands from left to right); a floating button above the bars keeps cycling forward (minimal-left → Full); the toggle yields while the search input is open
|
|
38
|
+
- **Draggable panel**: in Full / Hidden mode, grab the header to drag the panel anywhere in the viewport (auto-clamped to the edges; the expanded height is capped at half the viewport with the top edge fixed and the panel growing downward — expanding a huge turn scrolls the list internally while the "Back to latest / Collapse all" footer stays reachable); the pin button in the header toggles between the default right-dock and the last dragged position; the dragged position and the minimal left/right alignment survive page reloads via localStorage
|
|
39
|
+
- **Resizable panel**: drag from the bottom-left rounded corner (Full / Hidden modes only) — width 240–560 px, height vertical. Height follows a content-adaptive + cap model: actual height = min(turn content, the cap you drag to), tracking the number of turns with no blank space under the footer; floor ~3 turns, ceiling within the conversation viewport. The drag tracks the pointer 1:1 and is fully reversible; width/height persist in localStorage
|
|
40
|
+
- **Silky motion**: panel fade, step expand/collapse height transitions, staggered fade-in of filter results, rotating collapse arrow — all pure CSS, zero dependencies
|
|
41
|
+
- **Click to locate**: click a turn or a step to smooth-scroll the conversation to that exact position (fold state is preserved)
|
|
42
|
+
- **Load earlier / Load all**: two buttons on top — "Load earlier" pages one batch back, "Load all" loads every historical turn into the navigator for arbitrary jumps (the page itself stays lazily loaded until you click)
|
|
43
|
+
- **Position tracking**: scrolling the conversation highlights and follows the turn you are currently reading
|
|
44
|
+
- **Right-side docking (default)**: the panel is anchored to the right edge of the viewport and stays put when the left sidebar collapses or expands; unpin (drag it or hit the pin) to place it anywhere
|
|
45
|
+
- **Back to latest / Collapse all**: two shortcut buttons at the bottom; "Collapse all" is disabled when no turn is expanded, so it never looks broken for doing nothing
|
|
46
|
+
- **Trajectory colors**: user/steering = business blue, context = success green, assistant = violet, tool = amber, compaction = neutral gray (`--dsw` theme tokens matching the built-in trajectory view, light/dark adaptive)
|
|
47
|
+
- **Native DSH look**: action buttons reuse the official `Button`/`Tooltip` components and official icons (search, close); the remaining icons (navigate, load earlier, load all, back to latest, collapse all, switch modes, …) are outline icons from **Lucide** (ISC License, [lucide.dev](https://lucide.dev)), `currentColor` adaptive to light/dark themes
|
|
48
|
+
- Follows workspace/session switches automatically and rebuilds the outline
|
|
49
|
+
|
|
50
|
+
## Install
|
|
51
|
+
|
|
52
|
+
This plugin is a spec-compliant **bundle** (`dsh.bundle` manifest + `dsh.client` declaration), plain JavaScript with no build step. Install with the official CLI:
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
# Option 1: npm (no build authorization needed once published)
|
|
56
|
+
dsh plugin --profile web add dsh-conversation-navigator
|
|
57
|
+
|
|
58
|
+
# Option 2: GitHub (pure JS package, no prepare/allowBuilds required)
|
|
59
|
+
dsh plugin --profile web add github:gjj-star/dsh-conversation-navigator
|
|
60
|
+
|
|
61
|
+
# Option 3: local tarball
|
|
62
|
+
pnpm pack
|
|
63
|
+
dsh plugin --profile web add ./dsh-conversation-navigator-<version>.tgz
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
`dsh plugin` forwards to pnpm inside the profile directory, so **pnpm must be on your PATH**; installation appends this package to the profile's `dsh.profile.bundles`, and its bundled `cordis.patch.yml` layer inserts the plugin row. Restart `dsh web` and the panel appears. **Dual-form defaults**: on official DSH < 0.1.2-rc.1 (no built-in navigator) the panel is expanded by default; on official DSH ≥ 0.1.2-rc.1 (the conversation view ships the built-in TurnNavigator rail) the panel starts closed in "minimal-left" form with the search box collapsed, summoned by the "导航" title-bar toggle, with zero overlap against the official right-edge rail.
|
|
67
|
+
|
|
68
|
+
> Manual install (no pnpm): place the repo at `<DSH_HOME>\profiles\<profile>\node_modules\dsh-conversation-navigator` and append the content of [`example.patch.yml`](./example.patch.yml) to the top-level array of the profile's `cordis.patch.yml`.
|
|
69
|
+
|
|
70
|
+
## Updates
|
|
71
|
+
|
|
72
|
+
Edit `lib/client.js` and restart `dsh web`. Docked state, dragged position, minimal alignment and the panel width/height persist (localStorage `dsh-cnvnav:ui:v2`); the open/closed state is deliberately NOT persisted — on the new host the panel always starts closed — and search keywords still live only within the page session.
|
|
73
|
+
|
|
74
|
+
> Published to npm as `dsh-conversation-navigator` (the version badge above always shows the latest release); to upgrade an installed copy, update from the marketplace or run `dsh plugin --profile web add dsh-conversation-navigator` again, then restart.
|
|
75
|
+
|
|
76
|
+
## How it works
|
|
77
|
+
|
|
78
|
+
- Slots: `conversation.session.header.utilities` (the "导航" toggle in the title bar) + `shell.overlay` (the floating panel)
|
|
79
|
+
- Data (dual-form): legacy hosts read the session-level standard props `useSession`; new hosts (official ≥ 0.1.2-rc.1) read the `uiConversation.binding(binding).target("chat")` snapshot — the primary channel groups by the official `timeline.turnOrder` + `locations` index, backs off to `ChatNodeStore.values()` (mapping via the node's own `location` or its `anchorSeq` against the official turn boundaries), and finally merges the official `turnOutline` projection (`sessions.projectionStore(sid).get("turnOutline")` / the slot standard prop `useProjection`, the same source the official rail's `mergeTurnRailItems` uses) to restore user messages the assembly index drops and to add out-of-window turns; re-derived automatically on `loadOlder`
|
|
80
|
+
- History backfill: pages back through `sessions`'s `binding(sessionId).session.loadOlder()`, "Load all" loops until `hasMore=false`
|
|
81
|
+
- Jumping: reuses the DSH chat view's own stable DOM anchor `[data-chat-anchor-key]` (the same anchor the product uses internally for paging/scroll positioning) with `scrollIntoView` smooth scrolling
|
|
82
|
+
- Position tracking: captures scroll events on the `[data-conversation-scroll]` container (throttled 120ms) and computes the first visible node at the viewport top
|
|
83
|
+
- Keyword filter: extracts searchable text only for `user` and `assistant-step` nodes (`dialogueText`), case-insensitive matching, hits wrapped in `<mark>` and the display windowed around the first hit
|
|
84
|
+
- Hover full text: the turn-row bubble reads `fullDialogueText` (all text blocks of the user node joined), shown via `Tooltip` with a 340px width cap
|
|
85
|
+
- Modes: the header button cycles `viewMode` (full/hidden/minimal-left; `minimal`/minimal-right is commented out and retained); hidden replaces the turn head title with a trajectory badge (`titleNode` strategy); minimal-left is pinned to `scrollport.left + 12` (the placement key includes `r.left` and a ResizeObserver on the chat area re-anchors it whenever the left sidebar expands or collapses); the toggle yields while the search input is open
|
|
86
|
+
- Drag & persistence: the full-panel header is draggable (pointer events, clamped to the viewport); dragging or the pin toggles `docked`; `place()` only clamps a freely-placed panel into the viewport instead of re-docking it; the position, docked state and alignment choice persist in localStorage (`dsh-cnvnav:ui:v1`)
|
|
87
|
+
- Resize: a transparent bottom-left corner grip captures pointer events; width writes `style.width` directly (240–560), height only adjusts `maxHeight` while `height` stays `auto`, so the actual height is always min(content, cap) with no blank space; dragging follows the start point linearly (`base + delta`) and shares the same container/viewport clamps as `place()` so nothing snaps on release; width/height persist as `panelWidth`/`panelHeight`
|
|
88
|
+
- Styling: `Button`/`Tooltip`/search & close icons reuse `@deepseek-ai/dsh-client-ui-primitives`, the rest are inline Lucide SVGs (ISC License); the panel injects its own `<style>` element, colors use `--dsw-*` theme tokens; everything is cleaned up with the fiber on unload
|
|
89
|
+
|
|
90
|
+
## Compatibility
|
|
91
|
+
|
|
92
|
+
- Target platform: DSH Web (`dsh.client.platform: web`), depends on the kernel seed's `react`, `slots`, `sessions` services and `@deepseek-ai/dsh-client-ui-primitives`; `dsh.client.inject` declares `@deepseek-ai/dsh-client-ui-conversation` (`dsh-client-runtime` was removed in official v0.1.2-rc.1 and is no longer injected)
|
|
93
|
+
- **Dual form (0.2.6)**: the host form is detected at runtime via feature detection — the presence of the `uiConversation` service marks the new host (official ≥ 0.1.2-rc.1); no hardcoded version numbers. `uiConversation` is now declared in the client `exports.inject`, so the runtime guarantees it is ready and host detection no longer flips with load timing. Legacy hosts keep the full navigator (expanded by default); new hosts coexist with the official TurnNavigator: closed by default, "minimal-left" form, search box collapsed by default — the official rail handles jumping, this plugin focuses on keyword search, bulk "Load all" and step-level badges
|
|
94
|
+
- **Host version note**: fully verified on official **DSH v0.1.2-rc.1** (Web) — the new `uiConversation` service, the `conversation.session.header.utilities` empty-props contract, the chat target snapshot (`timeline`/`locations`/`nodes`/`navigation`/`legacy`) and the `turnOutline` projection. Legacy hosts (no `uiConversation`) are covered by the `useSession` path; older official versions are not individually regression-tested
|
|
95
|
+
- **Host dependency declaration**: `@deepseek-ai/dsh-client-ui-conversation` is declared as a `peerDependencies` semver range (the awesome-dsh-plugin convention; dshmarket's dependency check surfaces host compatibility from it)
|
|
96
|
+
- **Version-sensitive points**: `[data-chat-anchor-key]` / `[data-conversation-scroll]` are the current DOM anchor conventions of the DSH chat view (verified still present in official v0.1.2-rc.1); if they change after a DSH upgrade, only `findAnchor` / `computeActiveKey` in `lib/client.js` need adjusting
|
|
97
|
+
- No hard `timer` dependency: the client timer service is used for throttling when present, and degrades to unthrottled otherwise
|
|
98
|
+
|
|
99
|
+
## Structure
|
|
100
|
+
|
|
101
|
+
```
|
|
102
|
+
lib/
|
|
103
|
+
index.js # empty host entry (browser-only plugin)
|
|
104
|
+
client.js # full browser implementation (window.__ModuleLoader__ module format)
|
|
105
|
+
assets/
|
|
106
|
+
screenshots/ # screenshots (README hero + market gallery)
|
|
107
|
+
cordis.patch.yml # bundle patch layer (inserts the plugin row)
|
|
108
|
+
example.patch.yml # patch example for manual installs
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
## License
|
|
112
|
+
|
|
113
|
+
MIT
|
package/README.md
CHANGED
|
@@ -1,107 +1,110 @@
|
|
|
1
|
-
# DSH 会话导航插件(dsh-conversation-navigator)
|
|
2
|
-
|
|
3
|
-
[English](README.en.md) | 中文
|
|
4
|
-
|
|
5
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
6
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
7
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
8
|
-
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
9
|
-
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
10
|
-
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
11
|
-
[](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
|
|
12
|
-
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
13
|
-
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
14
|
-
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
15
|
-
|
|
16
|
-
**DeepSeek Harness(DSH)Web 端会话导航面板**:在对话页**右侧**悬浮展示按轮折叠的对话大纲,点击任意节点平滑跳转,滚动对话时实时高亮当前阅读位置,步次徽标配色与内置"轨迹"视图统一。
|
|
17
|
-
|
|
18
|
-
纯浏览器插件(无宿主行为)、纯 JavaScript、零构建、零 npm 依赖(按钮/Tooltip 复用 DSH 内核 seed 的官方 primitives)。
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
>
|
|
26
|
-
|
|
27
|
-
## 功能
|
|
28
|
-
|
|
29
|
-
- **按轮折叠大纲**:默认只显示"第 N 轮 + 你的问题"列表,长对话一目了然
|
|
30
|
-
- **关键词过滤**:点击左上角搜索图标呼出输入框,只按「你的提问 + 助手实际回复文本」过滤(上下文、工具、命令、压缩、推理等不参与匹配),命中词高亮,列表文本自动定位到关键词处
|
|
31
|
-
- **展开/折叠步次**:点击轮次行右侧的箭头按钮(`▸ N`,展开时旋转为 `▾`)平滑展开/折叠该轮的步次明细(助手回复、工具调用、命令、压缩点等)
|
|
32
|
-
- **悬停查看全文**:鼠标在轮次行停留片刻,气泡显示该轮用户提问的完整原文,不再被单行截断
|
|
33
|
-
- **显示 / 隐藏 /
|
|
34
|
-
- 「极简」形态收起时只露行内指示条(当前 = 品牌色实色、非当前 = 主题前景色掺 40%),悬停展开 7 行画幅的定位面板(点击跳转、悬停全文气泡、超 7
|
|
35
|
-
- **面板可拖动**:显示轮次 / 隐藏轮次面板按住头部即可拖到视口任意位置(自动夹边;展开高度至多半屏,上边缘固定、下边缘展开,超长轮次时列表内部滚动,底部「回到最新/全部折叠」始终可达),头部图钉按钮在「默认右侧停靠」与「上次拖动位置」间切换;拖动位置与极简左/右对齐选择持久化于 localStorage,刷新页面原样恢复
|
|
36
|
-
- **面板尺寸可调**:左下角圆角处拖拽缩放(仅显示轮次 / 隐藏轮次)——横向拖宽(240–560px),纵向拖高/拖矮;高度采用「内容自适应 + 上限」模型:实际高度 = min(轮次内容, 你拖到的上限),随轮数变化、不会在底部产生空白,下限约 3 轮,上限不超过会话可视区;拖拽 1:1 线性跟随、可逆,尺寸持久化于 localStorage
|
|
37
|
-
- **丝滑动效**:面板开合淡入淡出、步次展开/折叠高度过渡、过滤结果逐条级联淡入、折叠箭头旋转——全部纯 CSS 实现,零依赖
|
|
38
|
-
- **点击定位**:点击轮次主体或步次条目,平滑滚动跳转到对话中对应位置(不改变折叠状态)
|
|
39
|
-
- **加载更早 / 加载全部**:面板顶部两个按钮——「加载更早」向后翻一页、「加载全部」一键把所有历史轮次载入导航,之后可任意跳转(页面默认仍懒加载,只有点按钮才补载)
|
|
40
|
-
- **位置跟踪**:手动滚动对话时,面板自动高亮并跟随当前正在阅读的轮次
|
|
41
|
-
- **右侧定位**:默认锚定视口右侧,收起/展开左侧边栏时纹丝不动;解除停靠(拖动/图钉)后可自由放置
|
|
42
|
-
- **回到最新 / 全部折叠**:面板底部两个快捷按钮;「全部折叠」在没有展开的轮次时置灰,避免误以为失效
|
|
43
|
-
- **轨迹配色**:用户/插话 = 业务蓝、上下文 = 成功绿、助手 = 紫罗兰、工具 = 琥珀、压缩 = 中性灰(与内置轨迹视图一致的 `--dsw` 主题 token,自动适配明暗主题)
|
|
44
|
-
- **DSH 原生风格**:操作按钮复用官方 `Button`/`Tooltip` 组件与官方图标(搜索、关闭);其余操作图标(导航、加载更早、加载全部、回到最新、全部折叠、切换轮次等)取自 **Lucide** 描边图标集(ISC License,[lucide.dev](https://lucide.dev)),`currentColor` 自动适配明暗主题
|
|
45
|
-
- 切换工作区/会话自动跟随并重建大纲
|
|
46
|
-
|
|
47
|
-
## 安装
|
|
48
|
-
|
|
49
|
-
本插件是官方规范的**组合包**(`dsh.bundle` manifest + `dsh.client` 声明),纯 JavaScript、无构建步骤,推荐用官方 CLI 安装:
|
|
50
|
-
|
|
51
|
-
```sh
|
|
52
|
-
# 方式一:npm(发布后,用户无需任何构建授权)
|
|
53
|
-
dsh plugin --profile web add dsh-conversation-navigator
|
|
54
|
-
|
|
55
|
-
# 方式二:GitHub(纯 JS 包无需 prepare/allowBuilds,直接可用)
|
|
56
|
-
dsh plugin --profile web add github:gjj-star/dsh-conversation-navigator
|
|
57
|
-
|
|
58
|
-
# 方式三:本地 tarball
|
|
59
|
-
pnpm pack
|
|
60
|
-
dsh plugin --profile web add ./dsh-conversation-navigator-<version>.tgz
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
`dsh plugin` 在 profile 目录内转发给 pnpm,因此需要 **pnpm 在 PATH 上**;安装会自动把本包追加进 profile 的 `dsh.profile.bundles`,其自带的 `cordis.patch.yml` 层负责插入插件行。重启 `dsh web`
|
|
64
|
-
|
|
65
|
-
> 手动方式(不依赖 pnpm):把仓库放进 `<DSH_HOME>\profiles\<profile>\node_modules\dsh-conversation-navigator`,并在 profile 的 `cordis.patch.yml` 顶层数组追加 [`example.patch.yml`](./example.patch.yml) 的内容。
|
|
66
|
-
|
|
67
|
-
## 更新
|
|
68
|
-
|
|
69
|
-
修改 `lib/client.js` 后重启 `dsh web`
|
|
70
|
-
|
|
71
|
-
> 已发布到 npm(`dsh-conversation-navigator`,徽章实时显示最新版本);升级已安装副本:市场更新或 `dsh plugin --profile web add dsh-conversation-navigator` 后重启。
|
|
72
|
-
|
|
73
|
-
## 工作原理
|
|
74
|
-
|
|
75
|
-
- 注册槽位:`conversation.session.header.utilities`(标题栏「导航」开关)+ `shell.overlay`(浮动面板)
|
|
76
|
-
-
|
|
77
|
-
- 历史补载:通过 `sessions` 服务的 `binding(sessionId).session.loadOlder()` 分页向后加载,「加载全部」循环至 `hasMore=false`
|
|
78
|
-
- 跳转定位:复用 DSH 聊天视图自身的稳定 DOM 锚点 `[data-chat-anchor-key]`(与产品内部 paging/scroll 定位同源),`scrollIntoView` 平滑滚动
|
|
79
|
-
- 位置跟踪:捕获 `[data-conversation-scroll]` 滚动容器的 scroll 事件(节流 120ms),计算视口顶部首个可见节点
|
|
80
|
-
- 关键词过滤:仅为 `user` 与 `assistant-step` 节点提取检索文本(`dialogueText`),大小写不敏感匹配,命中片段以 `<mark>` 高亮并按首个命中位置截取显示窗口
|
|
81
|
-
- 悬停全文:轮次头气泡读取 `fullDialogueText`(用户节点全部文本块拼接),用 `Tooltip` 展示并限宽 340px
|
|
82
|
-
- 显示/隐藏/极简模式:`viewMode`
|
|
83
|
-
- 拖动定位与持久化:面板头部拖拽(pointer events,视口夹边),拖动或图钉切换 `docked` 状态;`place()` 对自由放置的面板只做视口夹边、不再自动停靠;位置、停靠状态与对齐选择存于 localStorage(`dsh-cnvnav:ui:v1`)
|
|
84
|
-
- 拖拽缩放:左下角透明热区捕获 pointer 事件;宽度直接写 `style.width`(240–560),高度只调 `maxHeight` 并保持 `height:auto`,使实际高度恒为 min(内容, 上限) 而不产生空白;拖动以起点为基准线性跟随(`base + 位移`),上限与 `place()` 的容器/视口钳制同源,松手零回弹;宽高随 `panelWidth`/`panelHeight` 持久化
|
|
85
|
-
- 样式:`Button`/`Tooltip`/搜索与关闭图标复用 `@deepseek-ai/dsh-client-ui-primitives`,其余图标为 Lucide 内联 SVG(ISC License);面板容器自建 `<style>` 注入,颜色使用 `--dsw-*` 主题 token;插件卸载时随 fiber 清理
|
|
86
|
-
|
|
87
|
-
## 兼容性说明
|
|
88
|
-
|
|
89
|
-
- 目标平台:DSH Web 端(`dsh.client.platform: web`),依赖内核 seed 的 `react`、`slots`、`sessions` 服务与 `@deepseek-ai/dsh-client-ui-primitives
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
1
|
+
# DSH 会话导航插件(dsh-conversation-navigator)
|
|
2
|
+
|
|
3
|
+
[English](README.en.md) | 中文
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
6
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
7
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
8
|
+
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
9
|
+
[](https://github.com/gjj-star/dsh-conversation-navigator)
|
|
10
|
+
[](https://www.npmjs.com/package/dsh-conversation-navigator)
|
|
11
|
+
[](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
|
|
12
|
+
[](https://github.com/deepseek-ai/deepseek-harness)
|
|
13
|
+
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
14
|
+
[](https://www.dsh.so/artifact/dsh-conversation-navigator-2/)
|
|
15
|
+
|
|
16
|
+
**DeepSeek Harness(DSH)Web 端会话导航面板**:在对话页**右侧**悬浮展示按轮折叠的对话大纲,点击任意节点平滑跳转,滚动对话时实时高亮当前阅读位置,步次徽标配色与内置"轨迹"视图统一。
|
|
17
|
+
|
|
18
|
+
纯浏览器插件(无宿主行为)、纯 JavaScript、零构建、零 npm 依赖(按钮/Tooltip 复用 DSH 内核 seed 的官方 primitives)。
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
> 三种形态:显示轮次、隐藏轮次、极简·左(极简·右已暂缓,代码保留在仓库中;极简收起仅露行内指示条,悬停展开定位面板)。完整截图见 [assets/screenshots](./assets/screenshots)。其中「社区皮肤适配」两张为第三方皮肤下的效果(鲸鱼娘女仆主题与君の名は主题),非插件自带。
|
|
26
|
+
|
|
27
|
+
## 功能
|
|
28
|
+
|
|
29
|
+
- **按轮折叠大纲**:默认只显示"第 N 轮 + 你的问题"列表,长对话一目了然
|
|
30
|
+
- **关键词过滤**:点击左上角搜索图标呼出输入框,只按「你的提问 + 助手实际回复文本」过滤(上下文、工具、命令、压缩、推理等不参与匹配),命中词高亮,列表文本自动定位到关键词处
|
|
31
|
+
- **展开/折叠步次**:点击轮次行右侧的箭头按钮(`▸ N`,展开时旋转为 `▾`)平滑展开/折叠该轮的步次明细(助手回复、工具调用、命令、压缩点等)
|
|
32
|
+
- **悬停查看全文**:鼠标在轮次行停留片刻,气泡显示该轮用户提问的完整原文,不再被单行截断
|
|
33
|
+
- **显示 / 隐藏 / 极简·左三种形态**:头部切换按钮三态循环——「显示轮次」为经典分组视图(压缩等系统事件与轮次同级加粗展示)→「隐藏轮次」每行统一为轨迹徽标 + 文本(用户 = 业务蓝、助手 = 紫罗兰、压缩 = 中性灰)→「极简·左」锚定对话区左缘(为 dsh-better-sidebar 让出右侧,并与官方右侧轨道零重叠),再回到「显示轮次」;「极简·右」形态自 0.2.6 起暂缓(与官方 TurnNavigator 轨道视觉重叠),代码保留;
|
|
34
|
+
- 「极简」形态收起时只露行内指示条(当前 = 品牌色实色、非当前 = 主题前景色掺 40%),悬停展开 7 行画幅的定位面板(点击跳转、悬停全文气泡、超 7 条仅滑块滚动;左对齐向右展开),外置悬浮按钮继续循环(极简·左→显示轮次),搜索框展开时按钮自动让位
|
|
35
|
+
- **面板可拖动**:显示轮次 / 隐藏轮次面板按住头部即可拖到视口任意位置(自动夹边;展开高度至多半屏,上边缘固定、下边缘展开,超长轮次时列表内部滚动,底部「回到最新/全部折叠」始终可达),头部图钉按钮在「默认右侧停靠」与「上次拖动位置」间切换;拖动位置与极简左/右对齐选择持久化于 localStorage,刷新页面原样恢复
|
|
36
|
+
- **面板尺寸可调**:左下角圆角处拖拽缩放(仅显示轮次 / 隐藏轮次)——横向拖宽(240–560px),纵向拖高/拖矮;高度采用「内容自适应 + 上限」模型:实际高度 = min(轮次内容, 你拖到的上限),随轮数变化、不会在底部产生空白,下限约 3 轮,上限不超过会话可视区;拖拽 1:1 线性跟随、可逆,尺寸持久化于 localStorage
|
|
37
|
+
- **丝滑动效**:面板开合淡入淡出、步次展开/折叠高度过渡、过滤结果逐条级联淡入、折叠箭头旋转——全部纯 CSS 实现,零依赖
|
|
38
|
+
- **点击定位**:点击轮次主体或步次条目,平滑滚动跳转到对话中对应位置(不改变折叠状态)
|
|
39
|
+
- **加载更早 / 加载全部**:面板顶部两个按钮——「加载更早」向后翻一页、「加载全部」一键把所有历史轮次载入导航,之后可任意跳转(页面默认仍懒加载,只有点按钮才补载)
|
|
40
|
+
- **位置跟踪**:手动滚动对话时,面板自动高亮并跟随当前正在阅读的轮次
|
|
41
|
+
- **右侧定位**:默认锚定视口右侧,收起/展开左侧边栏时纹丝不动;解除停靠(拖动/图钉)后可自由放置
|
|
42
|
+
- **回到最新 / 全部折叠**:面板底部两个快捷按钮;「全部折叠」在没有展开的轮次时置灰,避免误以为失效
|
|
43
|
+
- **轨迹配色**:用户/插话 = 业务蓝、上下文 = 成功绿、助手 = 紫罗兰、工具 = 琥珀、压缩 = 中性灰(与内置轨迹视图一致的 `--dsw` 主题 token,自动适配明暗主题)
|
|
44
|
+
- **DSH 原生风格**:操作按钮复用官方 `Button`/`Tooltip` 组件与官方图标(搜索、关闭);其余操作图标(导航、加载更早、加载全部、回到最新、全部折叠、切换轮次等)取自 **Lucide** 描边图标集(ISC License,[lucide.dev](https://lucide.dev)),`currentColor` 自动适配明暗主题
|
|
45
|
+
- 切换工作区/会话自动跟随并重建大纲
|
|
46
|
+
|
|
47
|
+
## 安装
|
|
48
|
+
|
|
49
|
+
本插件是官方规范的**组合包**(`dsh.bundle` manifest + `dsh.client` 声明),纯 JavaScript、无构建步骤,推荐用官方 CLI 安装:
|
|
50
|
+
|
|
51
|
+
```sh
|
|
52
|
+
# 方式一:npm(发布后,用户无需任何构建授权)
|
|
53
|
+
dsh plugin --profile web add dsh-conversation-navigator
|
|
54
|
+
|
|
55
|
+
# 方式二:GitHub(纯 JS 包无需 prepare/allowBuilds,直接可用)
|
|
56
|
+
dsh plugin --profile web add github:gjj-star/dsh-conversation-navigator
|
|
57
|
+
|
|
58
|
+
# 方式三:本地 tarball
|
|
59
|
+
pnpm pack
|
|
60
|
+
dsh plugin --profile web add ./dsh-conversation-navigator-<version>.tgz
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
`dsh plugin` 在 profile 目录内转发给 pnpm,因此需要 **pnpm 在 PATH 上**;安装会自动把本包追加进 profile 的 `dsh.profile.bundles`,其自带的 `cordis.patch.yml` 层负责插入插件行。重启 `dsh web` 后生效。**双形态默认值**:官方 < 0.1.2-rc.1(无内置导航)时面板默认展开;官方 ≥ 0.1.2-rc.1(会话视图内置 TurnNavigator 轮次轨道)时面板默认关闭、默认形态为「极简·左」、搜索框默认收起,由标题栏「导航」按钮主动呼出,与官方右侧轨道零重叠。
|
|
64
|
+
|
|
65
|
+
> 手动方式(不依赖 pnpm):把仓库放进 `<DSH_HOME>\profiles\<profile>\node_modules\dsh-conversation-navigator`,并在 profile 的 `cordis.patch.yml` 顶层数组追加 [`example.patch.yml`](./example.patch.yml) 的内容。
|
|
66
|
+
|
|
67
|
+
## 更新
|
|
68
|
+
|
|
69
|
+
修改 `lib/client.js` 后重启 `dsh web` 即可;停靠状态、拖动位置、极简左对齐、面板宽高持久化于 localStorage(`dsh-cnvnav:ui:v2`;面板的展开/收起 `open` 不再持久化——新宿主每次启动都从默认关闭开始,搜索关键词等界面状态仍只存于页面会话内。
|
|
70
|
+
|
|
71
|
+
> 已发布到 npm(`dsh-conversation-navigator`,徽章实时显示最新版本);升级已安装副本:市场更新或 `dsh plugin --profile web add dsh-conversation-navigator` 后重启。
|
|
72
|
+
|
|
73
|
+
## 工作原理
|
|
74
|
+
|
|
75
|
+
- 注册槽位:`conversation.session.header.utilities`(标题栏「导航」开关)+ `shell.overlay`(浮动面板)
|
|
76
|
+
- 数据来源(双形态):旧宿主走会话级标准 props 的 `useSession`;新宿主(官方 ≥ 0.1.2-rc.1)走 `uiConversation.binding(binding).target("chat")` 快照——主通道为官方 `timeline.turnOrder` + `locations` 索引分组,`ChatNodeStore.values()` 兜底(依节点自带 `location` 或 `anchorSeq` 对照轮次边界归组),再用官方 `turnOutline` 投影(`sessions.projectionStore(sid).get("turnOutline")` / slot 标准 props 的 `useProjection`,与官方 rail 的 `mergeTurnRailItems` 同源)补上被组装器漏挂的用户消息与加载窗口外的轮次;随 `loadOlder` 自动重派生
|
|
77
|
+
- 历史补载:通过 `sessions` 服务的 `binding(sessionId).session.loadOlder()` 分页向后加载,「加载全部」循环至 `hasMore=false`
|
|
78
|
+
- 跳转定位:复用 DSH 聊天视图自身的稳定 DOM 锚点 `[data-chat-anchor-key]`(与产品内部 paging/scroll 定位同源),`scrollIntoView` 平滑滚动
|
|
79
|
+
- 位置跟踪:捕获 `[data-conversation-scroll]` 滚动容器的 scroll 事件(节流 120ms),计算视口顶部首个可见节点
|
|
80
|
+
- 关键词过滤:仅为 `user` 与 `assistant-step` 节点提取检索文本(`dialogueText`),大小写不敏感匹配,命中片段以 `<mark>` 高亮并按首个命中位置截取显示窗口
|
|
81
|
+
- 悬停全文:轮次头气泡读取 `fullDialogueText`(用户节点全部文本块拼接),用 `Tooltip` 展示并限宽 340px
|
|
82
|
+
- 显示/隐藏/极简模式:`viewMode` 三态循环(full/hidden/minimal-left,「极简·右」minimal 已注释保留),隐藏时仅把轮次头标题替换为轨迹徽标(`titleNode` 策略);极简左对齐以 `scrollport.left + 12` 钉在对话区左缘(定位 key 含 `r.left`,并用 ResizeObserver 监听对话区宽度变化,左侧栏展开/折叠时紧贴跟随);搜索框展开时按钮让位
|
|
83
|
+
- 拖动定位与持久化:面板头部拖拽(pointer events,视口夹边),拖动或图钉切换 `docked` 状态;`place()` 对自由放置的面板只做视口夹边、不再自动停靠;位置、停靠状态与对齐选择存于 localStorage(`dsh-cnvnav:ui:v1`)
|
|
84
|
+
- 拖拽缩放:左下角透明热区捕获 pointer 事件;宽度直接写 `style.width`(240–560),高度只调 `maxHeight` 并保持 `height:auto`,使实际高度恒为 min(内容, 上限) 而不产生空白;拖动以起点为基准线性跟随(`base + 位移`),上限与 `place()` 的容器/视口钳制同源,松手零回弹;宽高随 `panelWidth`/`panelHeight` 持久化
|
|
85
|
+
- 样式:`Button`/`Tooltip`/搜索与关闭图标复用 `@deepseek-ai/dsh-client-ui-primitives`,其余图标为 Lucide 内联 SVG(ISC License);面板容器自建 `<style>` 注入,颜色使用 `--dsw-*` 主题 token;插件卸载时随 fiber 清理
|
|
86
|
+
|
|
87
|
+
## 兼容性说明
|
|
88
|
+
|
|
89
|
+
- 目标平台:DSH Web 端(`dsh.client.platform: web`),依赖内核 seed 的 `react`、`slots`、`sessions` 服务与 `@deepseek-ai/dsh-client-ui-primitives`;`dsh.client.inject` 声明 `@deepseek-ai/dsh-client-ui-conversation`(`dsh-client-runtime` 已于官方 v0.1.2-rc.1 移除,不再注入)
|
|
90
|
+
- **双形态(0.2.6)**:运行时用 feature detection 区分宿主——存在 `uiConversation` 服务即新宿主(官方 ≥ 0.1.2-rc.1),不硬编码版本号。`uiConversation` 已加入客户端 `exports.inject` 声明,运行时保证其先就绪,宿主检测稳定不再随加载时序翻转。旧宿主保持全功能导航器(默认展开);新宿主与官方内置 TurnNavigator 共存:默认关闭 + 「极简·左」 + 搜索框默认收起,官方轨道负责跳转,本插件专注关键词搜索、批量「加载全部」与步次级徽标
|
|
91
|
+
- **宿主版本说明**:已在官方 **DSH v0.1.2-rc.1**(Web 端)完整验证——含新的 `uiConversation` 服务、`conversation.session.header.utilities` 空 props 契约、chat target 快照(`timeline`/`locations`/`nodes`/`navigation`/`legacy`)与 `turnOutline` 投影;旧宿主(无 `uiConversation`)经 `useSession` 路径兼容保留,未在 0.1.2-rc.1 之前的官方版本上逐一回归
|
|
92
|
+
- **宿主依赖声明**:`@deepseek-ai/dsh-client-ui-conversation` 以 peerDependencies + semver 范围声明(awesome-dsh-plugin 约定,dshmarket 的依赖检查据此展示宿主兼容性)
|
|
93
|
+
- **版本敏感点**:`[data-chat-anchor-key]` / `[data-conversation-scroll]` 是当前 DSH 聊天视图的 DOM 锚点约定(官方 v0.1.2-rc.1 中已验证仍在),DSH 升级后若锚点变化,只需调整 `lib/client.js` 中 `findAnchor` / `computeActiveKey` 两个函数
|
|
94
|
+
- 未声明 `timer` 硬依赖:客户端的 timer 服务存在则用于节流,不存在时自动退化为未节流模式
|
|
95
|
+
|
|
96
|
+
## 目录结构
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
lib/
|
|
100
|
+
index.js # 宿主侧空入口(纯浏览器插件)
|
|
101
|
+
client.js # 浏览器端完整实现(window.__ModuleLoader__ 模块格式)
|
|
102
|
+
assets/
|
|
103
|
+
screenshots/ # 截图(README 主图 + 市场截图墙)
|
|
104
|
+
cordis.patch.yml # 组合包补丁层(插入插件行)
|
|
105
|
+
example.patch.yml # 手动安装时的补丁示例
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
## License
|
|
109
|
+
|
|
110
|
+
MIT
|
package/cordis.patch.yml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
# dsh-conversation-navigator 组合包补丁层
|
|
2
|
-
# 当 profile 的 dsh.profile.bundles 列出本包时,此层会被应用,
|
|
3
|
-
# 向组合中插入一行浏览器插件(dsh.client row)。
|
|
4
|
-
|
|
5
|
-
- insert:
|
|
6
|
-
- id: ui-conversation-navigator
|
|
7
|
-
name: 'dsh-conversation-navigator'
|
|
1
|
+
# dsh-conversation-navigator 组合包补丁层
|
|
2
|
+
# 当 profile 的 dsh.profile.bundles 列出本包时,此层会被应用,
|
|
3
|
+
# 向组合中插入一行浏览器插件(dsh.client row)。
|
|
4
|
+
|
|
5
|
+
- insert:
|
|
6
|
+
- id: ui-conversation-navigator
|
|
7
|
+
name: 'dsh-conversation-navigator'
|