- Startseite
- Plugins
- Sitzungen & Nachrichten
- dsh-session-boxes
dsh-session-boxes
879745uhjun/dsh-session-boxes
Organizes sessions in the DSH workspace sidebar into custom named, colored boxes without moving them between workspaces: multi-box membership with mirrored rows, collapse, drag or menu assignment, and a box manager in the workspace header. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
Installation
dsh plugin --profile web add github:879745uhjun/dsh-session-boxesREADME
dsh-session-boxes
Custom-named session boxes and one-level sub-boxes for the DeepSeek Harness workspace sidebar.
English | 中文
What it does
Sessions in one workspace can be classified into named, colored boxes without changing the workspace they belong to. A top-level box can contain one level of sub-boxes (folders), so “前端” can hold “组件” and “构建” inside it. The native sidebar rows keep their stars, status dots, hover cards, pin and archive actions, and menus; the plugin inserts collapsible box headers between the rows and orders the rows under those headers.
A session lives in exactly one box or sub-box at a time. Moving it elsewhere removes it from the previous box, so it never appears twice and no mirrored rows are needed.
- Boxes and one-level sub-boxes — create, rename inline, recolor, reorder, delete; a parent delete promotes its sub-boxes to the top level. The parent frame runs continuously around its sub-boxes: sub-boxes are inset inside the same card instead of floating as separate cards.
- Single location — choose one box or sub-box from the row menu; “Ungrouped” clears the location. The old location is replaced.
- Per-box pin — pin a session to the top of one box or sub-box from that box's settings; it does not touch the native global pin. Pinned rows sort first, carry a colored pin badge in the box header, and use a stronger tint, a double colored spine, and a top accent instead of an extra row icon, so they stay recognizable without taking horizontal space. The row's “...” menu offers Unpin inside so a pinned session can be released and reordered.
- Box aggregates — each box header shows
★ 4.2(average stars of its members) and☑ 3/7(completed / total todos) whendsh-session-starsanddsh-session-todosare installed. A parent box includes its sub-box members. Segments with no data are omitted; a 404, 1.5 s timeout, or bad JSON hides them and leaves the header unchanged. The routes are read-only same-origin GETs; the other plugins are never imported. - Configurable box headers — each box chooses which of
count,pinned,subs,stars,todos,add, andmenuappear; the chevron is always kept. Compact mode keeps only chevron + count + menu. The manager stores a default for new boxes and can apply it to every box. A missingheadermeans all items (old data needs no migration); invalid values fall back to the default. - Drag to reorder — drag a box header onto another header at the same level to change the custom order. Sub-boxes reorder among their siblings; the manager and box settings also have up/down buttons.
- Drag sessions — drag a session row onto a box header to move it there; drop it on Ungrouped to clear its location.
- Manager — the box button in the workspace section header (beside search, view options, and add workspace) opens a manager for the whole tree: create top-level boxes, add a sub-box with
+, rename/recolor/reorder/delete, and open a box's settings. - Theme-aware controls and palette — box colors use paired
--dshc-*variables (:rootfor light,body[data-ds-dark-theme]for dark); headers, dots, and drop indicators usevar(--dsb-color, var(--dshc-gray)). Dark headers raise the overlay mix (18%→24%, 45%→52%) while light keeps 18%/45%. Buttons, inputs, and badges use the DSH theme tokens. - Durable — boxes, sub-boxes, memberships, and per-box pins live in
~/.dsh/session-boxes.jsonon the Host. - Agent tool —
session_boxescan list, create (withparentId), rename, delete, move, assign, pin, unpin, collapse, and read/write each box'sheadervisibility.
Blank New Session rows, and pinned sessions that have no box, stay on top. A pinned session that belongs to a box is shown inside that box and sorts first, keeping its native pin marker. The native “Show more” watermark expands automatically while boxes are in use; choosing “Show less” yourself is respected.
Install
This package is a DSH bundle (dsh.bundle.patch). Install the directory with the Plugin Manager:
- Ask the DSH agent to install this bundle from the project directory (it calls
plugin_managerwithaction: install_bundleand the absolute package path). - Reload the Web UI page.
Use
- Move a session: open the row's
...menu → Box settings → Move to session box… → choose one box or sub-box (or Ungrouped). A new top-level box can be created from the same dialog. - Manage the tree: click the box button in the workspace section header. Use
+on a top-level row to create a sub-box; “设置” opens name, color, parent, order, delete, members, and pin controls. - Reorder boxes: drag a box header onto another header at the same level, or use the manager's ↑/↓ buttons. In a box's settings, the parent selector moves a child between levels.
- Pin inside a box: open the row's
...menu → Box settings → Pin inside (the item appears when the session is already in a box), or open the box's⋯settings and click the pin at the right of a member. The session moves to the top of that box only; the same submenu offers Unpin inside . - Collapse: click the chevron (or the box name). Collapsing a parent hides its direct rows and its sub-box cards.
Notes and limitations
- Sub-boxes are limited to one level; a box with sub-boxes cannot itself become a sub-box.
- Grouping applies to the default WorkSpace / Workspace Tree sidebar views. The flat “In one list” view and the search result list keep their native order.
- A box with no members in the current workspace is shown only while one workspace section is visible.
- Sessions are never moved between workspaces or deleted by this plugin.
Data
~/.dsh/session-boxes.json:
{
"version": 1,
"boxes": [
{ "id": "b_ab12cd34ef", "name": "前端", "color": "blue", "collapsed": false, "parentId": null, "order": 0 },
{ "id": "b_ff00aa11bb", "name": "组件", "color": "green", "collapsed": false, "parentId": "b_ab12cd34ef", "order": 1, "header": { "count": true, "pinned": true, "subs": true, "stars": false, "todos": false, "add": true, "menu": true } }
],
"memberships": { "session-…": ["b_ff00aa11bb"] },
"pins": { "b_ff00aa11bb": ["session-…"] },
"ungroupedCollapsed": false
}
Development
npm test # Host store/route/tool + grouping and aggregate badges in Chromium (Playwright)
The Host test covers the durable store, one-level tree validation, promotion on delete, sibling moves, per-box pins, validation, the JSON route, the cross-origin fence, the agent tool, and persistence across remounts. The DOM test loads the real client.js with a stubbed Module Loader and a mock sidebar that mirrors the ui-workspace markup, including its hover-card wrapper.
Install from GitHub
dsh plugin --profile desktop add github:879745uhjun/dsh-session-boxes
Reload the Web UI page after installing.
License
MIT
Ähnliche Plugins
billion-context
ranxianglei/billion-context
dsh-web-ui (dsh-chat-recovery)
zhu1090093659/dsh-web-ui
dsh-synapse
liangmianya/dsh-synapse
dsh-archive-manager
michengai/dsh-archive-manager