返回目录

dsh-pinned-panel

精选清单收录维护状态: 活跃

ouqil/dsh-pinned-panel

在 DeepSeek Harness 会话列表中增加置顶分组和独立页面,并从原工作区打开对应对话。

前往 GitHub
$ dsh plugin add github:OuQiL/dsh-pinned-panel

15

星标

0

Fork

JavaScript

语言

MIT

许可证

2026-10-25

创建于

2026-11-16

最近推送

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 没有可挂载的对象
  • 不需要任何凭据或网络访问

安装步骤

  1. 01

    在应用内:打开 设置 → 插件,点「添加插件」,粘贴 `github:OuQiL/dsh-pinned-panel`

  2. 02

    或用命令行:`dsh plugin add github:OuQiL/dsh-pinned-panel`(加 `--profile desktop` 可显式指定 profile)

    $ dsh plugin add github:OuQiL/dsh-pinned-panel

  3. 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 适配原生运行时

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 …`;卸载旧包或重启应用即可。
2026-10-252026-11-06v0.7.3

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`。它没有改动应用的其他部分,卸载后分组消失即可。

08数据与来源

  • 作者声明github.com90244221aece…

    The plugin mounts one **invisible seat** in the sidebar shell (`sidebar.footer.action`, an empty action beside Settings;…

  • 作者声明github.com90244221aece…

    It inserts one host element as the list's **first child** and portals the group into it, adopting the shipped group wrap…

  • 作者声明github.com90244221aece…

    | Host half | none — it is a no-op; everything runs in the browser |

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-18。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。