dsh-branch-companion
划词分支助手：框选回答文字 → 添加到新的分支，保留原文标记与分支树面板
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Tetro02/dsh-branch-companion#556d76f08c460743deb6364ce4f7a796ba6a8f51Branch Companion 以 dsh-branch-companion 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
dsh-branch-companion adds one path the Web client does not have: growing a branch out of a passage. Selecting text in a transcript reveals Add to new branch; choosing it forks the current Session through the Host, opens the child, records the reference, leaves a clickable ⑂ marker beside the quoted text, and keeps a navigable tree in the top-right corner.
The node document lives in the browser (localStorage). The Host gains no service and no event; removing the plugin takes away the panel and the markers and nothing else.
About this passage: "…".localStorage; the Host gains no service or event, and removing the plugin takes only the panel and markers.Take a multi-section technical answer (for example "explain OFDM"):
About this passage: "cyclic prefix (CP)" already in the composer; ask the follow-up there.Screenshot walkthrough: the ChatGPT / Codex desktop edition, chatgpt-desktop-branch-companion, shares the same core interaction (select → branch → marker → tree panel). The DSH edition runs in the DSH Web UI and keeps nodes in browser
localStorage.
| Action | Result |
|---|---|
| Select text in a transcript | Add to new branch appears under the selection |
| Choose it | Forks the current Session, opens the child, prefills About this passage: "…" |
| ⑂ marker beside the quote | Jumps to the branch; re-anchors on scroll, re-render, and streaming output |
| ⑂ Branch pill, top right | Opens the tree; click a node to jump, hover ✕ to remove it and its sub-branches |
| Branch from inside a branch | The child node hangs under its parent and indents accordingly |
This package is itself a DSH bundle: it declares dsh.bundle, ships its own cordis.patch.yml, and needs no manual Loader edit.
Install it with the plugin manager (plugin_manager, action: install_bundle), passing either spec:
https://github.com/Tetro02/dsh-branch-companionfile:C:\path\to\dsh-branch-companionThe manager writes the profile dependency, selects the bundle, and applies its patch layer live; remove_bundle reverts the profile completely. A DSH 0.2.x runtime and the Web UI are required — the Host half exists only so the client half can be composed.
The plugin does three things, all in the browser: turn a selection into a fork, record the fork relationship, and draw that record back beside the source text. It registers no slot and renders no React node, so the transcript's own tree is untouched; the price is a dependency on DOM contracts ([data-conversation-content], [data-conversation-session]).
Markers never wrap text. The plugin concatenates the transcript's text nodes, matches the stored quote with whitespace-insensitive patterns, builds a Range to measure getBoundingClientRect(), and positions an absolutely placed badge to its right. When React re-renders, the next paint measures the new nodes.
| File | Responsibility |
|---|---|
src/index.ts | Host half: exists so the Loader can compose the client bundle; no services, no state |
src/client/index.ts | Browser entry: registers dictionaries, mounts the overlay, hands teardown to the plugin fiber |
src/client/overlay.ts | Selection action, source markers, branch panel, prefill retry |
src/client/anchor.ts | Re-anchors a stored quote to the live transcript and returns a Range |
src/client/quote.ts | Quote normalization and whitespace-tolerant matching (pure, unit-tested) |
src/client/tree.ts | Node document parsing, parent/child queries, subtree removal, depth (pure, unit-tested) |
src/client/types.ts | Structural types for the client services used here (no DSH type imports) |
scripts/build.mjs | esbuild emits the Host ESM and the wrapped browser bundle; tsc emits declarations |
Selection → sessions.fork({ sessionId, increaseTitle: true }) → child id → append and persist the node → uiWorkspace.openSession(childId) → poll sessions.binding(childId) and conversation.input.requestDraftInitialization to prefill (up to 15 attempts, 200 ms apart, silent on failure).
sessions.fork in @deepseek-ai/dsh-api-session-controller; title increment and the atSeq boundary come from there.uiWorkspace.openSession in @deepseek-ai/dsh-client-ui-workspace.conversation.input.requestDraftInitialization in @deepseek-ai/dsh-client-ui-conversation.None directly. The plugin registers no tool, injects no prompt, and sends no message; any difference between a source Session and its branch comes from the user's own input.
Zero. No system-prompt paragraph, no runtime-context line.
None. The plugin neither assembles nor sends provider requests.
sessions.fork cuts at the last completed turn by default; the selected text is context and a node reference, not a precise cut.localStorage and the old document does not follow.localStorage instead of a branch-state.json file.pnpm install # esbuild + typescript
pnpm run build # lib/index.js, lib/client.js, lib/internal/*, lib/types/**
pnpm test # node --test, pure-function unit tests
pnpm run typecheck # tsc --noEmit
A browser bundle must be window.__ModuleLoader__.load({ id, factory }) with module side effects inside the factory; scripts/build.mjs embeds esbuild's IIFE in that factory so nothing runs early.