dsh-workbench

DSH Workbench

中文文档 · Changelog · Issues · npm

Codex-style workspace and Git review for DeepSeek Harness Web. Review a session's edits alongside Git changes without leaving the conversation.

Highlights

• Review with the right baseline — switch between session edits, uncommitted, unstaged, and staged changes; the diff and file tree share one file and +/− source.
• Read and diff beside the conversation — open files from agent tool calls, the workspace tree, or search without losing your place.
• Stay in your current tab — new edits update only the affected review file; a direct conversation-file click opens and reveals its diff.
• Close the conversation loop — edit workspace files safely, copy paths, and reference a selected diff range in the active Harness draft.

read       → source
write/edit → captured DSH diff

Why it is useful

• Keep the conversation and the file you are inspecting visible together.
• See real DSH write/edit changes, with captured before/after content; compare Git changes as uncommitted, unstaged, or staged when needed.
• Edit a workspace file with an optimistic external-change check before saving.
• Open several files, switch tabs, copy paths, and resize the panel. A tree or Quick Open click previews; double-click pins. Conversation writes open a kept tab.
• Shortcuts: ⌥⌘B toggle, ⌘⇧E hide or show the file pane, ⌘P open file, tree search to locate without opening, ⌘F / ⌘L find or jump, ⌘W close, ⌘1–⌘9 switch tabs. Drag or right-click to insert a path.
• Review scopes list session edits or Git changes with matching +/−; the toolbar also shows Git branch/status and session tool activity.
• UI follows the DSH language setting.

Install

dsh plugin --profile web add dsh-workbench
dsh web

If dsh is not on your PATH:

pnpm dlx @deepseek-ai/dsh plugin --profile web add dsh-workbench
pnpm dlx @deepseek-ai/dsh web

Local checkout:

git clone https://github.com/lee259/dsh-workbench.git
cd dsh-workbench
pnpm install
pnpm run build
dsh plugin --profile web add "$(pwd)"
dsh web

Rebuild and restart dsh web after plugin changes.

Local start

pnpm start -- /absolute/path/to/your/project

Builds the plugin, registers it on the target project, and starts DSH Web. Without a path, uses the current directory.

Previews

DSH operation	View
read	Source; images and Markdown render
write / edit	Captured DSH diff
File mention	Source; images and Markdown render

Host listens to tool/call, tool/result, and tool/code-dispatch. Prefers dsh-tool-fs meta.diffs.

Development

pnpm install
pnpm test
pnpm start -- /absolute/path/to/your/project

• Host: name, inject, apply(ctx) from src/index.ts
• Client: dsh.client, exports["./client"], window.__ModuleLoader__.load
• Styles: src/client/styles.css
• Third-party React components: use the React runtime injected by DSH. Components that statically import react-dom, need unbridged React APIs, or inject global CSS need an adapter; see src/client/react-bridge.ts and tsdown.config.ts.
• UI strings: src/shared/i18n.ts

Roadmap

Inspect, navigate, and review what the agent touched. Diffs stay on captured DSH writes.

Done

• Read-only previews for read and file mentions
• Captured DSH diffs for write / edit
• Persistent, resizable right-side workspace
• Multi-file tabs, preview / pin, path copy, and desktop shortcuts
• In-file find / go-to-line, plus conversation :line / #Lline targets
• Chinese / English UI following DSH locale
• Quick Open (⌘/Ctrl+P) and tree search that locates without opening
• Workspace file tree with breadcrumbs, keyboard navigation, and path insert
• Syntax highlighting, folding, and live refresh when the workspace changes on disk
• Image previews and rendered Markdown, including relative images
• Change review: session edits plus uncommitted, unstaged, and staged Git scopes, with shared +/− counts
• Short operation summaries for each captured write
• Incremental review updates that preserve the active tab and keep large review panels responsive
• Workspace content search (⌘/Ctrl+⇧+F) with line-focused results
• Reference files, folders, and selected preview lines in the composer
• Editable workspace previews with external-change protection
• Git branch/status and session tool-activity metadata in the review toolbar

Next

The target is a Codex-like development experience inside DeepSeek Harness: reuse proven workspace interactions where they help, while keeping DSH-native write capture and session review as the workbench's center of gravity.

• Add terminal and background-task surfaces in small, DSH-native slices.
• Tighten review-to-conversation feedback, including inline guidance on diffs.
• Continue refining session-scoped workspace state and review performance.

The existing DSH event capture, meta.diffs, session review, operation summaries, and incremental review updates remain the differentiating foundation.

Near-term sequence

• Terminal and background task surfaces
• Inline review comments and richer review-to-conversation feedback

Exploring

• Open-in-editor and reveal-in-folder
• Inline comments on a diff line that send guidance back to the composer
• Native DSH panel controls and layout slots, if the host exposes a usable one
• Pluggable workspace panels (Files / Review, and later DSH tools)

License

MIT