MIT 许可的 DSH 客户端插件,在侧栏会话列表最前面加一个置顶分组:行仍在原工作区打开,附带行内重命名 / fork / 取消置顶 / 归档与可折叠的已归档区,Host 半边是空实现,无网络、无凭据。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-18
许可证
MIT
01它能帮你完成什么?
把所有置顶会话集中在一处,而不是在各工作区里翻找
侧栏会话列表最前面的一个 Pinned 分组,默认展开、可从表头折叠,折叠状态记在 `localStorage`
在多个工作区里都置顶过会话的 DeepSeek Harness Web GUI 用户
让置顶会话回到它真正所属的工作区里打开
点击即调用官方 `uiWorkspace.openSession()`——同样的工作目录、同样的上下文、同样的历史——并且每一行都标出来源工作区
同时开很多工作区、不希望置顶行把自己带进错误上下文的使用者
不离开分组就能重命名、fork、取消置顶或归档会话
每行的 ⋯ 菜单(或右键)提供重命名 / fork / 复制会话 ID / 取消置顶 / 归档,支持键盘导航与就地改标题,另有一个可折叠的已归档区可一键恢复
直接在置顶分组里整理长会话列表的人
02如何接入 DeepSeek Harness?
前置条件
- DeepSeek Harness Web GUI 界面——README 说明 Desktop 应用渲染的也是同一套 Web 界面
- 必须有侧栏:TUI / headless profile 没有可挂载的对象
- 不需要任何凭据或网络访问
安装步骤
- 01
在应用内:打开 设置 → 插件,点「添加插件」,粘贴 `github:OuQiL/dsh-pinned-panel`
- 02
或用命令行:`dsh plugin add github:OuQiL/dsh-pinned-panel`(加 `--profile desktop` 可显式指定 profile)
$ dsh plugin add github:OuQiL/dsh-pinned-panel
- 03
刷新页面——Pinned 分组会出现在会话列表顶部
验证接入成功
- 页面加载时控制台会打印 `[dsh-pinned-panel] active vX.Y.Z`;插件页的条目也会显示当前加载的版本
- 如果分组没出现且控制台打印 `sidebar list seam not found`,说明你的 DSH 版本移动了侧栏列表,接缝需要适配
回滚
- 设置 → 插件 → dsh-pinned-panel → 禁用 / 卸载,或执行 `dsh plugin remove dsh-pinned-panel`
03DSH 适配与能力边界
DSH 客户端插件:Host 半边是空的 `apply()`,浏览器端 bundle 在侧栏外壳(`sidebar.footer.action`,设置按钮旁)挂一个不可见的 seat,从它走到侧栏列表,把宿主元素插成列表的第一个子节点,再用 React portal 把 Pinned 分组渲染进去。
侧栏置顶分组
Host 自己的 `pinnedSessionIds` 与工作区成员关系→会话列表最前面的一个分组,默认展开,折叠状态记在 `localStorage`
把宿主元素插成侧栏列表的第一个子节点,并用 React portal 渲染进去写入 `localStorage['dsh-pinned-panel.sidebar.collapsed']`在原工作区打开
点击某一行→通过官方 `uiWorkspace.openSession()` 打开会话,与直接点侧栏里那一行完全一致
行内操作与就地重命名
悬停出现的 ⋯ 菜单或右键点击某行;双击标题→重命名 / fork / 复制会话 ID / 取消置顶 / 归档,以及就地改标题(回车保存,Esc 取消)
调用应用自带的 `session.rename`、`forkSession`、`unpinSession`、`archiveSession`,因此改变的是应用自身状态已归档区
所列会话中已归档的对话→一个默认折叠的 *Archived N* 条目,最多展示最近 10 条,每条都可一键恢复
通过 `uiWorkspace.unarchiveSession` 恢复实时状态指示
与应用自带状态圆点相同的数据源→行首图标变成圆点:运行中脉动、等待审批 / 计划复核 / 回答时呈琥珀色、未读完成呈绿色
04适合谁?何时不该用?
适合
- 在多个工作区里都置顶过会话的 DeepSeek Harness Web GUI 用户
- 同时开很多工作区、不希望置顶行把自己带进错误上下文的使用者
- 直接在置顶分组里整理长会话列表的人
不适合
- 只支持 Web GUI——分组要挂到侧栏列表上,TUI / headless profile 没有可挂载的对象。README 记录的是在 Windows 上按 `0.2.1-rc.2` 验证。
- 未来重构侧栏浏览器的 DSH 版本可能需要适配接缝;类名后缀就是契约,而插件在找不到结构时会退化成「没有分组」而不是把应用弄坏。
05兼容性、维护与安全提示
- 只支持 Web GUI——分组要挂到侧栏列表上,TUI / headless profile 没有可挂载的对象。README 记录的是在 Windows 上按 `0.2.1-rc.2` 验证。
- 这个分组只是显示层的插入:它不改变会话顺序、不额外写状态;不属于任何工作区的置顶会话会内联展示且没有来源标签;行按最后更新时间排序。
- 未来重构侧栏浏览器的 DSH 版本可能需要适配接缝;类名后缀就是契约,而插件在找不到结构时会退化成「没有分组」而不是把应用弄坏。
- 改名前的包 id `@local/dsh-pinned-panel` 如果还装着,会让分组出现两次,或加载时报 `loaded without registering …`;卸载旧包或重启应用即可。
MIT · README 分支 main · 最新 release v0.7.3(2026-11-16)
06常见问题
在这个分组里置顶,会话会被移出原工作区吗?
不会。原来那一行仍在原处——置顶分组只是额外的入口,不是迁移。它读取 Host 自己的 `pinnedSessionIds` 与工作区成员关系,置顶 / 取消置顶仍然是应用自带的 📌 操作,外加分组里悬停出现的 ✕。
怎么把它装进 DeepSeek Harness?
打开 设置 → 插件,点「添加插件」,粘贴 `github:OuQiL/dsh-pinned-panel`(对话框也接受完整 GitHub URL、tarball 或本地绝对路径),然后刷新页面。命令行则是 `dsh plugin add github:OuQiL/dsh-pinned-panel`,加 `--profile desktop` 可显式指定 profile。
分组没出现,应该先查什么?
打开浏览器控制台。如果打印 `[dsh-pinned-panel] sidebar list seam not found; the Pinned group cannot be placed.`,说明你的 DSH 版本移动了侧栏列表,接缝需要适配——请把这一行和你的 DSH 版本一起反馈。另外确认你在 Web GUI 界面里:TUI / headless profile 没有侧栏可挂载。
它会存什么、发什么数据?
不发起网络请求,没有遥测也没有凭据,Host 半边是空的 `apply()`。它读取侧栏本来就展示的工作区与会话快照,只写一个浏览器键——`localStorage['dsh-pinned-panel.sidebar.collapsed']`。置顶变更都走应用自己的 `uiWorkspace` 操作。
怎么卸载?
设置 → 插件 → dsh-pinned-panel → 禁用 / 卸载,或执行 `dsh plugin remove dsh-pinned-panel`。它没有改动应用的其他部分,卸载后分组消失即可。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件,高性能低占用,可爱像素鲸鱼,流畅鼠标交互,npm 一键安装
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座,支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
dsh-drawai
作者 fourzkw
DSH 右侧栏里的可编辑画布 —— 加上让模型直接改图的两个工具
08数据与来源
The plugin mounts one **invisible seat** in the sidebar shell (`sidebar.footer.action`, an empty action beside Settings;…
It inserts one host element as the list's **first child** and portals the group into it, adopting the shipped group wrap…
| Host half | none — it is a no-op; everything runs in the browser |
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
