DSH-Plugs

A monorepo of plugins for DeepSeek Harness (DSH) — one folder = one plugin.

Plugins

@just-genius/dsh-codex

Side Chat, Terminal, and Git tab types for DSH's official right Sidebar. Files use DSH's built-in packages by default, with the retained custom preview available from Codex settings; the Warp-style terminal is backed by a real login-shell PTY. Optional: pin the newest question while scrolling, and drain a session's full history on open.

@just-genius/dsh-debug-mode

Cursor-style debug mode: /debug, a red Debug chip, a Debug Logs dock above the composer, and a reproduction-steps card with Proceed / Mark as fixed. Instrumentation goes through a workspace helper under .dsh/debug/; the dock can be cleared; runtime lines are mirrored to .dsh/debug/debug.log. Mode/wait stay in process memory for the live session only (not written to the durable session log).

@just-genius/dsh-flow

Leader-plans / subagent-executes orchestration, off until you run /flow. Once on, the main agent only plans — it lays work out as a DAG with flow.plan, each node is dispatched to its own child agent, and it reshapes the graph mid-flight with flow.patch (retry with a revised prompt, skip, insert a corrective step) as results land. Execution tools (edit/write/bash) are genuinely removed from the Leader while the mode is on; read-only tools stay. A dedicated Flow tab beside Chat draws the live graph with React Flow: node colour = status, edges = dependencies, click a node for its brief, result, and failure reason. Leave with /flow off (which also cancels running children).

@just-genius/dsh-multi-repo

Multi-folder workspaces (Codex-style, no git scan): add folders one by one, pick one as the primary — the official workspace, session cwd, and workspace-write scope — while the rest stay readable and coordinatable. Bindings live in ~/.dsh/multi-repo/projects.json and are injected into the system prompt.

@just-genius/dsh-workspace-plus

Workspace enhancement that supersedes installing dsh-multi-repo plus a row-menu plugin together: attach multiple folders to one workspace (primary folder is the official cwd / workspace-write scope), and add double-click / right-click menus on workspace and session rows — pin, rename, unread, archive, fork, open folder. Bindings live in ~/.dsh/workspace-plus/bindings.json. Session menus do not offer permanent delete.

@just-genius/dsh-memory

Global markdown memory: Settings → Memory for manual CRUD, memory_propose for AI writes that wait for user confirmation, and enabled entries injected into the system prompt. Stored under ~/.dsh/memory/ as index.json + entries/*.md.

@just-genius/dsh-sync

GitHub Device Flow + secret Gist config sync: Settings → Sync pushes/pulls settings.yaml and the web plugin list (portable specs + cordis.patch.yml) with no self-hosted sync server. State lives in ~/.dsh/sync/state.json.

@just-genius/dsh-desktop-update

Update badge for DSH-Desktop next to the sidebar Settings button, driven by the window.dshDesktop Electron bridge. App updates jump to GitHub Releases; DSH runtime updates install in place. Renders nothing in a plain browser.

@just-genius/dsh-model-custom-ex

Replaces the official Models settings page (fork of ui-settings-models) to add per-model dropdown multi-selects for vision (input) and thinking strength (reasoningEfforts), plus a per-model default thinking strength and typeable capacity combos — the controls the stock page punts to settings.yaml.

@just-genius/dsh-notify-jump

Click a dsh-notification system banner to focus the window and open that session; when the DSH-Desktop bridge is present it routes through window.dshDesktop.notify so click-to-jump survives the Electron shell. Also notifies on the rising edge of approval / ask / plan-review waits.

@just-genius/dsh-session-archive

Settings → 会话归档: archived sessions grouped by workspace, with a confirmed delete. The sidebar keeps its one-click 归档会话 entry.

@just-genius/dsh-plugin-config

Settings → 插件管理 in one tab for two kinds: Cordis npm plugins (awesome-dsh-plugin marketplace + profile inventory) and Agent capability packs (builtin catalog → ~/.dsh/agent-plugins). Shared top search. Agent packs mount hosted MCP tools/skills on enable without a DSH restart; Cordis plugins still need restart. Replaces the official read-only Plugin list.

@just-genius/dsh-quick-notes

随手笔记: floating sticky-note cards over the shell, with a search overlay (Mod+Shift+F; Mod+Shift+N opens a new note). Cards are WYSIWYG — # becomes a heading as you type, - [ ] a real checkbox, a GFM table stays an editable table — while the note on disk stays plain Markdown. A model round mints a title and up to 3 tags; renaming by hand freezes further AI overwrites. Settings → 随手笔记 manages the library (search, tags, pin / archive / delete, bulk actions). Notes are global rather than per-workspace, under $DSH_HOME/quick-notes, and every write is atomic (temp file + rename).

dsh-synapse

A visual, non-linear conversation workspace (vendored from liangmianya/dsh-synapse 0.4.1): the sessions, follow-ups, and forks of one workspace drawn as a draggable, zoomable map, reached from the top-level 会话地图 switch and served at /synapse. DSH's session log stays the single source of truth — Synapse projects committed events only, connects cards by the real fork edges instead of building a second history, and keeps its canvas layout in $DSH_HOME/synapse/, so deleting that directory never deletes a session. A card can also save its answer into a 随手笔记 note. Web profile only, reusing the existing DSH server. It is the one plugin that is plain root-level JS (index.js / client.js / app.js, built with node --check) — no @just-genius scope, no shared runtime, no typecheck.

@just-genius/dsh-whale-girl

Desktop pet (whale-girl). In a plain browser it is the in-page companion; in DSH-Desktop it opens a transparent always-on-top overlay via window.dshDesktop.overlays so the pet sits on the OS desktop.

Shared packages

packages/runtime (@just-genius/dsh-plugin-runtime) is the only package that directly adapts official DSH host/client APIs. All plugins depend on this boundary instead of importing @deepseek-ai/* packages or pinning their versions independently.

packages/agent-plugin (@just-genius/dsh-agent-plugin) is the pure logic for Agent capability packs: manifest validation, variable substitution, hosted MCP HTTP, OAuth, and install/enable/disable state. Host UI lives in dsh-plugin-config.

packages/ui (@just-genius/dsh-plugin-ui) ships DSH --dsw-* theme tokens plus React primitives (Button, Input, Menu, Modal, Markdown, confirmation and toast UI) and settings chrome. Plugins bundle it at build time; standalone apps (e.g. Vellum) can depend on it via file: / npm and call installTheme() once at boot. See packages/ui/README.md.

Official DSH contracts are pinned at the shared boundary to the newest tested published APIs (0.1.1-rc.2 at this migration).

Repository layout

DSH-Plugs/
├── package.json          # root workspace (shared build/type toolchain)
├── pnpm-workspace.yaml   # packages: ['plugins/*', 'packages/*']
├── tsconfig.base.json    # shared TS config
├── packages/
│   ├── runtime/          # @just-genius/dsh-plugin-runtime
│   ├── agent-plugin/     # @just-genius/dsh-agent-plugin (Agent pack logic)
│   └── ui/               # @just-genius/dsh-plugin-ui
└── plugins/
    └── <plugin>/         # one plugin per folder

What a plugin is

A plugin is a Cordis plugin npm package split in two halves:

| Half | Source | Output | Role | | --- | --- | --- | --- | | node | src/index.ts | lib/index.js | Host entry (usually an empty apply for pure UI plugins) | | browser | src/client/index.tsx | lib/client.js | Browser entry, registered via window.__ModuleLoader__.load({ id, factory }), mounting React UI with ctx.slots.register in apply |

Two key declarations in package.json:

• dsh.client — declares the browser-side injection (inject lists the client package names it depends on; platform: web).
• dsh.bundle.patch — points at cordis.patch.yml, so installing the package automatically inserts its loader row into the profile.

Develop

pnpm install      # install dependencies
pnpm build        # build all plugins (src → lib)
pnpm watch        # watch and rebuild
pnpm typecheck    # type-check
pnpm clean        # remove all lib/

Adding a plugin

Before creating a plugin, follow the dependency rule in AGENTS.md.

Installing a plugin

# Link a local folder into the profile (relative paths anchor to the current directory)
dsh plugin --profile web add ./plugins/dsh-codex

Because the package declares dsh.bundle.patch, it joins the profile's bundle layer automatically on install; restart DSH web (a plain refresh is not enough for bundle-stack changes).

Uninstall:

dsh plugin --profile web remove @just-genius/dsh-codex