dsh-session-deck
Codex 风格的 DeepSeek Harness 侧边栏：用于固定项目和对话的置顶栏，可折叠的置顶/项目/组件分区，显示最近使用对话的铃铛活动视图（以最后一条回答作为预览），以及每个项目的表情图标。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Timebro9999/dsh-session-deck#0bef2066e048bc3117dc7121c153b54e871e78eeSession Deck 以 dsh-session-deck 发布，当前版本为 0.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
Manage your whole workspace, not just one conversation. A Codex-style sidebar for DeepSeek Harness: pin projects and conversations to one band, switch the sidebar to a "recently used" activity view, give every project its own icon, and collapse the sections you are not using.
DSH's sidebar is organized per project, and that is fine until you work across several of them:
This plugin adds the four things you reach for: a pinned band, a recent view, an icon per project, and collapsible sections.
Pinned band (置顶) | Pin a conversation or a whole project into one band above every project. A pinned project unfolds in place and lists its own conversations — like the project row below, but reachable without scrolling. Click to open, ✕ to unpin, the header collapses. |
Activity view (🔔) | The last icon of the workspace row switches the sidebar to recently used: day groups (today / yesterday / weekday / date), two lines per conversation (title + project, then the beginning of the last answer), a running indicator, and click-through that keeps the view open so you can walk through several threads in a row. |
| Project icons | Replace a project's folder icon with any emoji — on the sidebar's project rows and in the directory picker. A Codex-style picker: recently used, category tabs, an icon grid, and reset. |
| One state everywhere | Rename a conversation, finish a turn or change a project icon and every view follows: the pinned band and the activity view resolve each row against the live stores, and a working conversation shows the shell's own running ring. |
| Collapsible sections | 置顶, 项目 (the shipped project list) and 组件 (the sidebar's bottom widgets) each collapse from their own header and remember their state. |
┌ 工作区 🔍 ⌘ 📁+ 🔔 ← the bell opens the activity view
│ ▾ 置顶 3 ← pinned band (conversations + projects)
│ ▸ 🌈 deepseek调试 项目
│ 🚀 新出了个GLM5.3 flashx… 会话
│ 🌈 我没发现现在有什么这个左侧… 会话
│ ────────────────────────────────────
│ ▾ 项目 9 ← the shipped project list, collapsible
│ 📁 pdf
│ 🚀 前沿方向研究
│ 新出了个GLM5.3 flashx… 1天
└
⋯ widgets ⋯
▸ 组件 ← the bottom widgets, collapsible
☆ in its action strip, or hover a project row and
press the ☆ left of the pencil. The pinned band appears on top; its header collapses it and ✕
removes a single pin.✕) to return to the project list.置顶 / 项目 / 组件). States are remembered per DSH home.# from npm — also available in the in-app "add plugin" dialog by name
dsh plugin --profile desktop add dsh-session-deck
# or straight from this repository (no npm)
dsh plugin --profile desktop add github:Timebro9999/dsh-session-deck
Restart the desktop app (or reload the window) once; after that the plugin loads with the profile.
The same spec works in the in-app plugin pages (they accept a GitHub target), and #v0.1.1 pins a
release instead of tracking main:
dsh plugin --profile desktop add github:Timebro9999/dsh-session-deck#v0.1.1
Listing in the DSH plugin market comes from the curated index
awesome-dsh-plugin (the market reads its
plugins.json). The submission is one file — data/plugins/Timebro9999__dsh-session-deck.yml, kept in
this repo under marketplace/ — and
scripts/open-marketplace-pr.sh opens the PR.
Platform: anywhere DSH's web client runs — the macOS desktop app, Windows and Linux builds alike: the plugin is a browser-side DOM overlay with no native code and no OS-specific API (the only platform-aware bit is the emoji-panel shortcut printed in the icon picker).
DSH 0.1.7-rc.2 on the desktop profile. The plugin reads the shipped sidebar's DOM and its client
services, so there is no slot or service contract to depend on — but a future shell redesign can move
the anchors it uses.
No runtime dependencies and no build step: lib/client.js is hand-written and
shipped as-is.
The interface follows DSH's own language (the locale service first, then the rendered UI, then the browser), so its copy is Chinese or English like the rest of the app.
The plugin registers no slot and requires no client service (inject: []). It mounts a DOM
overlay: it finds the shipped rows ([data-row-key^="workspace:"], session:), the section header, the
list scroller and the sidebar foot area; adds controls styled from the row's own buttons; and paints the
states the shell does not offer. Anything it needs beyond the DOM comes from client services it reads on
demand (ctx.get('sessions' | 'workspaces' | 'uiWorkspace' | 'locale')).
Every node it inserts is marked data-dsh-session-deck, so a later mount reclaims its predecessor's
leftovers — the shell does not unload an old client instance when it reloads a bundle. The working
notebook of that exploration (anchors, mirrored CSS, traps, and the remote probe that reports page state
through a slot id) lives in docs/implementation.md (Chinese).
Everything is browser localStorage, per DSH home:
| Key | Contents |
|---|---|
dsh-session-deck:v1 | { emoji, recent, pinnedSessions, pinnedProjects, expandedProjects, pinnedCollapsed, workspaceCollapsed, widgetsCollapsed } |
dsh-session-deck:previews:v3 | The answer preview of each conversation, keyed by its updatedAt stamp |
Project icons are stored under two keys on purpose — the workspace id when a surface knows it, and
name:<basename> when only the folder name exists — and either resolves everywhere.
npm test # 148 + 7 assertions, no dependencies
The suite boots the real lib/client.js under a fake module loader with a fake DOM, a fake client
context and fake session records, then drives every surface: registrations, painted icons, triggers, the
picker, the pinned band, the sections, the activity view (including which part of a message becomes the
preview), locale handling, and unload/reload safety. CI runs it on Node 22 and 24.
dsh plugin --profile desktop remove dsh-session-deck
There is no host-side state: remove it, reload, and the shell is exactly as it was.
MIT