Skip to content
Back to search

dsh-strata

Session strata for the DeepSeek Harness Web GUI: the transcript's scrollbar becomes a to-scale, colour-coded map of the whole run, with your own messages emphasised and clickable anchors.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jsdvjx--dsh-strata/badge.svg)](/listings/jsdvjx--dsh-strata)

HTML

<a href="/listings/jsdvjx--dsh-strata"><img src="/api/listings/jsdvjx--dsh-strata/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

dsh plugin --profile web add dsh-strata

Or straight from the repo:

dsh plugin --profile web add "github:jsdvjx/dsh-strata#main"

Then restart `dsh web`. To remove:

dsh plugin --profile web remove dsh-strata

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 226 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dsh-strata
  2. [![npm version](https://img.shields.io/npm/v/dsh-strata?logo=npm&color=cb3837)](https://www.npmjs.com/package/dsh-strata)
  3. [![license](https://img.shields.io/npm/l/dsh-strata?color=blue)](LICENSE)
  4. [![listed on awesome-dsh-plugin](https://img.shields.io/badge/awesome--dsh--plugin-listed-6f42c1)](https://awesome-dsh-plugin.com/p/jsdvjx/dsh-strata/)
  5. > *Read the strata of a run.*
  6. English | [中文](README.zh.md)
  7. **A real minimap of the session trajectory for the DeepSeek Harness Web GUI** — it takes
  8. the transcript's scrollbar seat and turns it into a scaled, colored picture of the whole
  9. loaded conversation, with your own messages emphasised and clickable anchors beside it.
  10. Not a tick rail. Every other conversation navigator draws one evenly-spaced dot per prompt,
  11. which throws away the only thing a long agent session has too much of: *volume*. Here a
  12. band's height is the row's **real rendered height**, so the map is a proportional
  13. compression of the scroll extent — a 300-line answer looks like 300 lines, forty tool calls
  14. look like forty tool calls, and the viewport lens maps 1:1 onto the scrollbar. What you get
  15. is the shape of the run at a glance: where you spoke, how much work each prompt cost, and
  16. where it went wrong.
  17. <p align="center">
  18. <img src="https://raw.githubusercontent.com/jsdvjx/dsh-strata/main/docs/demo.gif" alt="Live demo: hovering expands the rail and lights the band under the cursor, clicking a band or an anchor dot jumps, dragging the lens scrubs the whole session" width="840">
  19. </p>
  20. ## What the map shows
  21. | Band | Meaning |
  22. |---|---|
  23. | **Full-width blue** | your message (and steering) — always the widest, brightest, never thinner than 5px |
  24. | Grey block | a model reply; block height is how much it wrote |
  25. | Thin grey tick | one tool call |
  26. | Green | a slash command |
  27. | Amber | a model retry, or a turn cut short by the output cap |
  28. | Red | a failed turn — or any tool/command row that reported an error |
  29. | Horizontal rule | a compaction checkpoint: where the model stopped seeing the history above |
  30. | Rounded outline | the viewport lens (drag it) |
  31. The ragged left edge is the index: every blue bar is a turn you started, and the block of
  32. agent work under it is what that turn cost.
  33. ## It replaces the scrollbar
  34. The rail sits in the transcript's own scrollbar gutter and the native thumb is suppressed
  35. while it is up, so there is one scroll control, not two — no layout shifts, because the
  36. gutter stays reserved either way. It is a takeover, not a theft: the moment the map stands
  37. down (Trajectory tab, no session, a transcript that does not scroll) the native scrollbar
  38. comes straight back, and uninstalling restores it permanently.
  39. ## …and the turn rail beside it
  40. DSH 0.1.2-rc.1 grew a navigator of its own: a fixed-pitch rail of turn marks
  41. down the right edge of the transcript — the same strip this map lives in, so
  42. the two land on top of each other and the host's rail covers the anchor dots.
  43. The map treats it exactly like the scrollbar: while the map is up the host
  44. rail is hidden, and the moment the map stands down (Trajectory, no session, a
  45. transcript that does not scroll) it is handed straight back. Nothing reflows
  46. either way — that rail is absolutely positioned inside a zero-height sticky
  47. slot, so hiding it costs no layout.
  48. Want both? Keep the host's rail with
  49. ```js
  50. localStorage['dsh-strata.native-turn-rail'] = 'keep'
  51. ```
  52. and reload. On DSH releases without that rail (0.1.1-rc.2 and earlier) there
  53. is nothing to hide and nothing changes.
  54. ## Anchors
  55. Beside the rail is a column of clickable anchor dots — **blue for every message you sent,
  56. red for every failed tool call or command**. Click one to jump there. The dot for wherever
  57. you are reading stays enlarged, so the anchors double as a position indicator. Anchors that
  58. would collide collapse to keep the column readable; failures never collapse, since they are
  59. usually the reason you reached for the map.
  60. ## The clue wall
  61. **Hovering a user anchor dot** floats the clue wall over the right half of
  62. the screen: **every user message in the session — including the ones above
  63. the loaded window** (read from the session's own export log) — packed
  64. like an evidence board: every card takes exactly the size its content needs
  65. (a one-word prompt is a small slip, a long one a tall note), flowing into
  66. masonry columns so the whole session fits on one board whenever it can.
  67. Each card is tied to its anchor dot by a bezier that tracks live as the
  68. transcript scrolls; unloaded prompts get a dashed border, tag and dashed
  69. string, and the message you came from is spotlighted. Only when the board
  70. truly cannot hold everything do **↑/↓ pager buttons** appear. **Click a card** to jump — an unloaded one
  71. chain-loads the missing history first. The wall retires when the pointer
  72. leaves it (grace period), or instantly on **Esc**; clicking a dot jumps
  73. straight to that message.
  74. ## Map scale
  75. A small **近 / 中 / 全** switcher sits under the rail while it is awake:
  76. - **近** (initial) restores the view from when the session opened — however
  77. much history has been loaded since, the map keeps that scale and slides
  78. with your reading position;
  79. - **中** (medium) spans twice the initial view, loading the difference on
  80. demand;
  81. - **全** (full) maps everything — pulling in any unloaded history first,
  82. with the same rail progress bar the unloaded jump uses.
  83. The choice persists per browser. Zoomed scales are pinned: loading more
  84. history shifts the window, never the scale.
  85. ## Use
  86. - **Click an anchor dot** to jump to that message or failure.
  87. - **Hover** the rail — it widens, the band under the cursor lights up, and on one of
  88. your own messages the clue wall opens (an anchor dot's tooltip carries the kind and
  89. `n/total`).
  90. - **Click** a band to scroll it into reading position; the row flashes when it lands.
  91. - **Click empty track or drag** to scrub proportionally, like a scrollbar.
  92. - **Wheel** over the rail or the dots to scroll the transcript.
  93. - **Keyboard**: the rail is focusable — arrows nudge, PageUp/PageDown page,
  94. Home/End jump to the ends (`role=scrollbar` with a live `aria-valuenow`).
  95. - **Double-click** to pin the rail open (persisted per browser).
  96. - Older history loads by itself: scroll (or drag the lens) to the top and the transcript's
  97. own *load older* fires, the map rescaling as history arrives. The faint `⌃` above the rail
  98. just says *there is more above*; it retires once everything is loaded.
  99. The map hides itself when there is nothing to navigate: no session, a transcript that does
  100. not scroll, or a non-chat view such as Trajectory.
  101. ## Compatibility
  102. | DSH | Status |
  103. |---|---|
  104. | 0.1.2-rc.1 | Tested — turn folding, the turn navigator, the width handle and the locale switch are all accounted for (see below) |
  105. | 0.1.1-rc.2 | Tested — nothing 0.1.2-specific is required; every seam degrades to the old behaviour |
  106. What 0.1.2 brought, and what the map does about it:
  107. - **Turn folding** (Compact mode hides a finished turn's process rows in place): folded
  108. rows leave the map the moment they fold, and come back the moment they open.
  109. - **The turn navigator**: hidden while the map is up, handed back when it stands down
  110. (`localStorage['dsh-strata.native-turn-rail'] = 'keep'` keeps both).
  111. - **The content-width handle** sits under the dot column at laptop widths: the column
  112. owns its 14px, so a gap between two dots is not a resize grip.
  113. - **Language switching**: labels come through the host's locale service and follow a
  114. switch in Settings → General without a reload; a language pack can translate the
  115. `dsh-strata` namespace into a third-party language. A host without the service
  116. gets the built-in zh/en table keyed on the document language.
  117. - **Pager lifecycle**: 0.1.2 unmounts the "load older" control while a page is in
  118. flight; the load chain waits for it to come back instead of calling the history
  119. exhausted, and measures progress by rows landed rather than by scroll height.
  120. ## Install
  121. ```sh
  122. dsh plugin --profile web add dsh-strata
  123. ```
  124. Or straight from the repo:
  125. ```sh
  126. dsh plugin --profile web add "github:jsdvjx/dsh-strata#main"
  127. ```
  128. Then restart `dsh web`. To remove:
  129. ```sh
  130. dsh plugin --profile web remove dsh-strata
  131. ```
  132. ## How it works
  133. Pure browser half; the Node half is empty and no session data crosses the wire for it.
  134. Geometry and semantics both come from anchors the conversation view already publishes —
  135. `[data-conversation-scroll]` for the scrollport, `[data-chat-anchor-key]` per flow row
  136. (the *outermost* one: a tool renderer nests a `call:<id>` anchor of its own inside the
  137. row, and that belongs to the row rather than being a row), `data-chat-flow-kind` for
  138. that row's registered Chat Node kind, `data-state="error"` for a failed tool or command,
  139. `hidden` on a row for the turn folding DSH 0.1.2 does in Compact mode,
  140. `[data-composer-seat]` to stay clear of the sticky composer. It
  141. contributes one entry to the frame-wide `shell.overlay` list slot, so it adds a surface
  142. instead of replacing one, and uninstalling leaves the native UI untouched. Labels are
  143. registered with the host's locale service as the `dsh-strata` namespace and translated
  144. through its `t` seat, so they follow the UI language live. The scrollbar
  145. takeover uses the theme's documented seam — rebinding `--dsh-scrollbar-thumb` to
  146. `transparent` on the scrollport, the same mechanism ui-sidebar uses — so both the WebKit
  147. and Firefox rendering paths are covered and no stylesheet is overridden.
  148. Rendering is a canvas repainted on a rAF, re-measuring rows only when the transcript's
  149. structure changes — a streaming reply grows one band through its own ResizeObserver
  150. report, a plain scroll moves the lens and nothing else, and the strata are cached as a
  151. base layer so a hover repaints one band, not the session. Colors are read from the theme's own
  152. `--dsw-alias-*` tokens, so light and dark both come out right, and `prefers-reduced-motion`
  153. disables the transitions.
  154. ## Limits
  155. - **The map covers the loaded window.** DSH pages older history in on demand; until it is
  156. loaded it has no layout to map. The `⌃` indicator is the honest signal that more
  157. exists; reaching the top pulls it in automatically.
  158. - **Chat view only.** The Trajectory tab renders its own event ledger with different
  159. anchors; the map stands down there rather than guessing.
  160. - The rail occupies a ~14px strip of the transcript's right padding, so clicks in that
  161. strip go to the map.
  162. - Hiding the host's turn rail is keyed on the stylesheet that rail ships
  163. (the rule declaring `--turn-rail-band`). A DSH that stops shipping it under
  164. that name gets its rail back, not a broken map.
  165. ## Development
  166. ```sh
  167. npm test # node --test over the DOM-free internals
  168. node test/replay/replay.mjs # headless-Chrome replay against a live `dsh web` (see the file header)
  169. ```
  170. The geometry, caches and the history-load state machine are exported as
  171. `internals` from `client.js` and tested without a browser; the replay drives
  172. a real session through Chrome's DevTools protocol (scroll consistency, drag,
  173. wall paging, load chains, session switch). The mounted map exposes a read-only
  174. seam for it on its root element (`root.__dshStrata`: the measured bands, the
  175. observation set, hot-path tallies) — a test hook, not an API. Keep the DSH
  176. tab in the foreground while replaying: a background tab gets no animation
  177. frames, and the map legitimately reads as stood down.
  178. ## License
  179. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.