@dsh-external/dsh-side
DSH 插件：在临时右侧工作区面板中提供 Codex 风格的侧边对话（/side、/btw），包含 Side/Subagents/Goal 区块和 ChatGPT 风格的置顶摘要小黑板，并尽力实现侧边栏折叠热区。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:invalidnaaaame/dsh-side-workspace#6ee19381d9d5590bb5f457ceb4d500f62e45a86e
Side 以 @dsh-external/dsh-side 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A DeepSeek Harness (DSH) plugin built in the spirit of the ChatGPT / Codex trio — side conversations · integrated workspace · pinned notes (置顶摘要小黑板)
dsh-side-workspace@dsh-external/dsh-side (unchanged)Disclaimer: an independent open-source project. Not affiliated with, endorsed by, or sponsored by OpenAI or DeepSeek. "ChatGPT" and "Codex" are trademarks of their respective owners, referenced only to describe feature parity.
Official naming reference (the basis for the repo name):
| This plugin's feature | Official name | Source |
|---|---|---|
/side conversations | Codex side conversations | openai/codex#18190 |
| Integrated right workspace | ChatGPT Workspace | OpenAI workspace agent |
| Pinned summary board | ChatGPT Notes (pinned message notes) | Pin a Note to Any Message |
/side — Codex side conversations/side <question> forks the current conversation's full history into a
background side conversation via a boundary context, while the main
conversation stays focused — the two never block each other; /btw <question>
is a one-shot side question (read-only). The child is an ordinary top-level
session (ctx.agents.create) that inherits the parent's agent preset, model,
and cwd, and goes through the deployment's own approval/sandbox policy — side
output never flows back into the main conversation's log.
ephemeral: archived on creation, never enters the ordinary session
list; idle children past the TTL (default 60 min) are swept by the host;
running/approval-waiting children never expire; a new /side replaces idle
older /side children of the same parent./side opens an EMPTY side conversation: no question is injected,
the child waits in a ready state, and you type the question directly in
the panel composer; afterwards it returns to the normal run/complete flow.session.selectModel, persists on that child, and applies to its
next step.The session-header toggle opens the shell's right column (the details column; the main conversation is squeezed), hosting a grouped list + detail pages:
/btw is read-only).A per-session board pinned to the top of the right workspace with its own pin toggle: a slim chip when collapsed; when expanded it edits a small structured document — title / objective / one-line status / next steps (checkable) / decisions and any other non-empty section.
$DSH_HOME/dsh-side-boards.json (atomic write, tolerant of
corrupt files); route /plugins/dsh-side/board
(GET/PATCH/DELETE, same-origin, follows the deployment's ordinary access
rules).goals.create when no goal exists,
or goals.edit on the projection's CAS revision when one does; non-empty
next steps ride along as a compact "下一步" list appended to the objective
text.A thin drag strip just inside the left sidebar's right edge: drag left past
the threshold to fully collapse the sidebar to its 56px rail, drag right from
the rail to expand. Everything delegates to the host's own toggleSidebar();
geometry discovery is structural (never shadows the sidebar slot, the host
handle, or internal stores).
The plugin mounts into the web profile via link:. You must restart dsh web yourself after changes (this plugin ships no HMR):
# 1. add the dependency (and register the client bundle under the profile's
# dsh.profile.bundles list) to the profile package.json
"@dsh-external/dsh-side": "link:<absolute path to this repo>"
# 2. add the insert row to the profile cordis.patch.yml (this repo's
# cordis.patch.yml is exactly that row)
# 3. install in the profile directory
pnpm install --config.confirmModulesPurge=false
| Key | Default | Description |
|---|---|---|
retention | ephemeral | ephemeral (archive + TTL expiry) / persistent (ordinary durable top-level sessions) |
idleTtlMinutes | 60 | Idle minutes before an ephemeral side is swept (1–1440) |
/side <question> Start a continuable side conversation (runs in the
background; the right panel reveals it when it settles)
/side Open an EMPTY side conversation and ask directly in the panel
/btw <question> One-shot side question (read-only, no follow-ups)
/side list List this session's side conversations
UI layout (three-column grid + right workspace + pinned board + notification dot)
Architecture & data flow (browser/host halves + shell services + lifecycle)
The hero screenshot lives at
assets/screenshot-workspace.png; to replace it, capture a new full-window shot with one running/sideand the board expanded, then overwrite that file.
src/
index.ts node half: create/archive/cleanup state machine + TTL
sweep + web routes (/plugins/dsh-side/list, /last,
/board) + command wiring
side.ts fork cut (host fork RPC contract), model inheritance,
message shapes
prompts.ts boundary prompt / persona / mode line (self-written
equivalent of the /side contract)
registry.ts parent → child registry + cleanup lifecycle + pure
TTL/retry decisions
board.ts pure board domain: sections, items, CAS patch engine,
locked-item protection, size caps
board-persistence.ts BoardStore: one atomic JSON file under DSH_HOME,
per-board save chains, patch idempotency
client/ browser half: right workspace (Side/Subagents/Goal +
board), transcript layer (paged history readers with
seed cut, streaming merge, FIFO cache), catalog
refcount, action gates, session-fenced pollers,
sidebar collapse hotzone
tests/ 165 unit tests (domain / persistence / client stores /
registry / transcript / …)
pnpm install --config.confirmModulesPurge=false # see the link notes below
pnpm check # typecheck (node + client) && vitest && build
pnpm build emits lib/index.js (ESM node half) + lib/index.d.ts +
lib/client.js (CJS browser half wrapped in window.__ModuleLoader__.load;
react/cordis/dsh-client-* externalized, lucide imported per-icon, bundle
≈195kB / gzip 43kB).
Dependency notes: devDependencies reference a local DSH install through
relative link:./dsh-dev/* entries (the official packages are injected by the
profile's pnpm closure — never use the bare cordis/schemastery npm
packages as substitutes). dsh-dev/ is a gitignored junction directory; after
cloning, create it before pnpm install:
# run at the repo root; first confirm `npm root -g` contains @deepseek-ai/dsh
$dsh = (npm root -g) + '\@deepseek-ai\dsh\node_modules'
New-Item -ItemType Junction -Path dsh-dev/ai -Target "$dsh\@deepseek-ai"
New-Item -ItemType Junction -Path dsh-dev/react -Target "$dsh\react"
New-Item -ItemType Junction -Path dsh-dev/react-dom -Target "$dsh\react-dom"
pnpm-lock.yaml embeds absolute paths and is not committed (regenerated per
machine).
setSidebar/setDetails (clamped 264–420 / 300–520), but ctx.layout
still exposes only toggleSidebar/openDetails/closeDetails — the collapse
hotzone stays toggle-based until those setters reach the public face.dsh web restart sides no
longer appear in the panel (that is the default semantics — see the
retention contract below).assistant-proposal data model and locked
items are ready; the proposal entry point is pending);ctx.layout.setSidebar);Default is ephemeral (ChatGPT-style temporary side threads): archived on
creation (never in the left session list), registry is process-local (forgotten
on restart), idle past TTL is swept by the host (running children are never
swept), and cleanup failures stay visible with bounded retries. Set
retention: persistent for the pre-0.2 durable top-level-session behavior.
MIT. Third-party notices in licenses/THIRD-PARTY-NOTICES.md.