dsh-pin-workspaces
Manifest validPins whole workspaces from the sidebar right-click menu: pinned workspaces move to the top in pin order, their sidebar rows take the theme accent color, and a Pinned workspaces page in Settings lists
dsh-pin-workspaces
把工作区置顶到侧栏最前。DSH 原生只有「会话置顶」(会话行 hover 的图钉,置顶后在所属工作区分组内排最前),没有工作区级别的置顶;这个插件补的就是后者。
用法
- 侧栏某个工作区标题上右键,菜单里多出 置顶工作区(已置顶时是 取消置顶工作区)。
- 置顶的工作区按置顶先后排在列表最前,最近置顶的在最上面。
- 置顶的工作区在侧栏里用强调色显示(标题与文件夹图标),和普通工作区一眼分得开。
- 取消置顶后,该工作区落到置顶区之下的第一位。
- DSH 新建工作区(比如新建会话时自动登记一个新目录)时,它会被 DSH 插到列表最前;插件会自动把置顶项压回前排,新工作区落在置顶区之后。
- 顺序持久化,DSH 重启后自动恢复。
- 设置 → 工作区置顶 里能看到当前置顶清单,也可以逐条取消置顶。
状态与接口
- 状态文件:
%USERPROFILE%\.dsh\dsh-pin-workspaces\state.json($DSH_HOME存在时以它为准),结构为{ "version": 1, "pinnedWorkspaceIds": [...] },最近置顶的在前。删掉这个文件即清空全部置顶。 - 本地路由(同源,浏览器半侧用):
GET /dsh-pin-workspaces/state、POST /dsh-pin-workspaces/pin、POST /dsh-pin-workspaces/unpin,请求体{ "workspaceId": "..." }。/state同时返回workspaces({ id, title }列表),设置页用它显示工作区名字。 - 顺序写入走宿主
workspaceRegistry.insertBefore,与拖拽排序是同一份持久顺序。 - 顺序看护:工作区注册表没有「持久顺序变了」的事件,插件每 0.6 秒对账一次(
DSH_PIN_WORKSPACES_WATCH_MS可改间隔,最小 20 毫秒),发现置顶项被挤出前排就重新压回去。DSH 新建工作区会把它插到最前,这一步就是靠看护纠正的。
配色怎么来的
置顶行的强调色由浏览器半侧注入一段样式表实现:选择器是 [data-row-key="workspace:<工作区 id>"],颜色取主题 token --dsw-alias-state-business-primary(跟随浅色/深色主题)。data-row-key 是侧栏工作区行的现有标记,不是公开契约;DSH 大版本升级后若这个标记变了,配色会失效,需要跟着改选择器(不影响置顶本身)。
已知限制
- DSH 没有「工作区行级别」的装饰 slot,所以行上没有图钉图标,状态体现在右键菜单文案和强调色上。
- 置顶项的排位由看护强制维持:把置顶项拖出前排会在 0.6 秒内被挪回去;把普通工作区拖到置顶区之前同样会被挪回置顶区之后。
- 只处理工作区。会话置顶用 DSH 自带的会话行图钉,两者互不影响。
- 改完插件文件(或把插件禁用再启用)之后,必须在 DSH 窗口按 Ctrl+R 重载页面。宿主重载会让页面里的客户端模块图失效,页面不重载时这个插件会整个消失,连右键菜单都没了。
安装与卸载
dsh plugin --profile desktop add ./dsh-pin-workspaces
dsh plugin --profile desktop remove dsh-pin-workspaces
或在 DSH 应用内用 plugin_manager 的 install_bundle / remove_bundle。
开发与发布流程
正本是这个工作区里的插件目录:
cd C:\Users\Administrator\Desktop\test\dsh-pin-workspaces
git add -A
git commit -m "..."
git push origin main
DSH 实际加载的是安装点 C:\Users\Administrator\.dsh\plugin-sources\dsh-pin-workspaces(profile 里的依赖是 link: 指向它)。发布后在那里拉一次远端:
cd C:\Users\Administrator\.dsh\plugin-sources\dsh-pin-workspaces
git pull --ff-only
然后重启 DSH(宿主改动必须整进程重启;只有浏览器半侧改动时按 Ctrl+R 即可)。
许可证
MIT,见 LICENSE。
Comments
Loading…
Similar plugins
by akilonewbility
Redraw the left-hand workspace sidebar to add color highlighting, sorting, status indicators, and system notifications. You can also switch back to the original sidebar, which likewise implements some
★ 2
MIT
JavaScript
Nov 2, 2026
dsh plugin --profile web add dsh-workspace-optimizeby ice5kysl
Workspace-first enhanced sidebar for dsh Web that shadows the built-in workspace browser at low priority (one-click toggle back to the official one) and adds soft workspace archive/restore, per-worksp
★ 1
↓ 203/wk
MIT
JavaScript
Oct 19, 2026
dsh plugin --profile web add dsh-workspace-kitby baifagg
DeepSeek Harness (dsh) Web GUI plugin: highlight running sessions and pin busy workspaces to the top of the sidebar. Theme-adaptive, zero-config.
★ 2
MIT
JavaScript
Oct 14, 2026
dsh plugin --profile web add dsh-plugin-busy-workspaceby PerryLink
Pin sessions and workspaces to the top of the DeepSeek Harness sidebar with per-pin row colors - a dual-face (host + client) dsh plugin.
★ 14
↓ 457/wk
Apache-2.0
TypeScript
Nov 18, 2026
dsh plugin --profile web add dsh-session-pinby TLEWA
Right-click menus for DSH sidebar workspace and session rows: open folders in VS Code or Explorer, copy paths and session links.
★ 1
MIT
JavaScript
Nov 8, 2026
dsh plugin --profile web add dsh-sidebar-row-menuby miao-ge
DSH plugin: right-click menu on the left sidebar workspace rows - rename, delete workspace, open in VS Code, reveal in File Explorer, plus open in a new tab when dsh-project-tabs is installed.
★ 0
MIT
JavaScript
Oct 5, 2026
dsh plugin --profile web add dsh-sidebar-context-menu