dsh-terminal-context
通过编辑器上方的按钮和键盘快捷键，将 DSH 内置侧边栏终端中的选区转换为编辑器中的 @file 引用。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ZHOU-ZHIZHEN/dsh-terminal-context#1a986d018914031b3c0e4a9f44054bf7474187a1Terminal Context 以 dsh-terminal-context 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →Turn selected text from DeepSeek Harness (DSH)'s built-in sidebar terminal into a native @file reference chip in your chat composer with a single click.
Inspired by Cursor's @Terminals and Trae's "Add to Conversation": eliminates manual copy-pasting of long terminal logs. References are inserted as clean, structured chips that can be clicked to preview and are automatically expanded to full text when the message is sent.
The workflow integrates naturally with your regular typing habits—no chasing floating buttons:
Ctrl+L (macOS: Cmd+L).Why a docked button instead of floating next to selection? Practical testing shows that xterm's highlight overlay cannot provide a reliable screen bounding box across platforms once a selection collapses on mouse-up. Floating buttons frequently drifted out of the viewport or obstructed terminal text. Anchoring the button above the composer keeps it predictable, visible, and unobtrusive.
dsh-terminal-context.add. Rebind it anytime under Settings → Keyboard shortcuts.Ctrl+L, allowing the terminal's native screen clearing to function normally. To clear the terminal while a selection is active, use clear.Ctrl+L will not send stale captures.Terminal logs often range from dozens to hundreds of lines. Inlining raw text directly into the chat composer has major downsides:
This plugin implements a "local capture file + native reference injection" pattern:
<workspace>/.dsh/term-captures/terminal-<timestamp>.txt with a short provenance header.@.dsh/term-captures/terminal-….txt, allowing the Agent to read the full content cleanly on demand.Automatic Trimming: When saving, trailing whitespace on every row and leading/trailing blank lines are stripped. Because xterm pads rows with spaces to the terminal viewport width, this cleanup removes hundreds of invisible space characters while preserving all visible text verbatim.
DSH has no centralized plugin marketplace. Plugins are installed using DSH's built-in plugin manager. This repository ships pre-bundled client code, requiring no local build steps or allowBuilds permissions.
If you use the DeepSeek Harness desktop application, install directly from the graphical interface without using a terminal:
github:ZHOU-ZHIZHEN/dsh-terminal-context
Local Development Tip: If you are developing locally, you can also enter the absolute local path of this directory into the "Add Plugin" field to load it as a linked local plugin.
If you run DSH Web or manage profiles via CLI, run in your terminal:
dsh plugin --profile web add github:ZHOU-ZHIZHEN/dsh-terminal-context
Note: The desktop profile is managed exclusively by the Electron application. Running the CLI command against
desktopwill returnprofile "desktop" is managed exclusively by the Electron application. For the desktop app, always use Option 1 via the GUI.
Pack the repository locally and install the tarball:
pnpm pack
dsh plugin --profile web add ./dsh-terminal-context-0.1.0.tgz
Injecting a native reference chip requires dispatching the session-scoped event slash/input-insert-reference. The payload's span must carry the current draft revision (draftRev) for the host's compare-and-swap check, and reference.source must match a recognized core source identifier.
To reliably obtain insertion and cursor context across versions, the plugin attempts three paths in order:
conversation.input.dock (where core todo and queue widgets live). This component receives standard inputActions containing captureInsertion and insertText for the active conversation.ctx.get('conversation').input.for(scope) to resolve the active composer session.false), the plugin falls back to inserting @relative/path as plain text, which DSH still renders as a folder reference.| Extraction Path | When Triggered | Precision |
|---|---|---|
| xterm DOM Selection | Browser selection remains readable | Exact character match |
| Highlight Geometry Reconstruction | Browser selection has collapsed on mouse-up | Full line extraction (errs on inclusion) |
By the time the mouse button is released over xterm, browser selections often collapse to collapsed: true (reporting zero-width bounding rects), returning empty strings from window.getSelection(). However, xterm's grey highlight on the .xterm-selection layer remains active.
The plugin inspects the positioned highlight divs in .xterm-selection, maps their vertical ranges to covered lines, and extracts text directly from corresponding .xterm-rows nodes. This design ensures user-selected content (such as multiline shell commands or stack traces) is never accidentally truncated by character-column rounding errors.
| File | Purpose |
|---|---|
lib/client.js | Client-side bundle (window.__ModuleLoader__.load format): selection tracking, composer docking, shortcut management, and reference injection |
lib/index.js | Host-side Node.js module: provides /capture (writing files), /sweep (retention pruning), and /diag (logging) HTTP endpoints |
cordis.patch.yml | Cordis bundle manifest declaring the runtime plugin entry |
test-host.mjs | Offline host unit test suite (mocking WebServer, Sessions, and edge cases) |
test-client.mjs | Offline browser unit test suite (mocking DOM, Lexical composer, and xterm events) |
Offline tests run without a live DSH runtime:
node test-host.mjs lib/index.js # Validates routing, workspace jail security, and retention limits
node test-client.mjs lib/client.js # Validates module contracts, event pipelines, fallback paths, and shortcuts
/capture, /sweep, and /diag routes run on DSH's internal webServer without a separate authentication token layer. Ensure DSH's Web port binds strictly to the loopback address (127.0.0.1); do not expose it directly to public or untrusted local networks.[data-sidebar-terminal] (covering native terminals and dsh-better-sidebar v0.19.0+). The plugin does not rely on private terminal APIs.dsh-api-terminal-controller conventions). The plugin never logs terminal activity in the background; it acts strictly when a user selects text and triggers an action.<workspace>/.dsh/term-captures/terminal-<timestamp>.txt. The host automatically prunes captures, keeping only the 20 most recent files. Files typically occupy 0.5–6 KB each. If your workspace uses Git, add .dsh/ to your root .gitignore./diag into $DSH_HOME/dsh-terminal-context-diag.json (capped at the 200 most recent entries, max 4MB) to facilitate headless troubleshooting.Released under the MIT License.