前言¶

在 DSH 的 Web GUI 里，侧边栏会话通常按工作区分组展示。常用会话如果不置顶，跨工作区查找时需要反复滚动或切换。dsh-pin 给会话行增加两个悬停按钮：📌 工作区内置顶，⌃⌃ 全局置顶区，用于把常用会话放到更醒目的位置。

这是什么¶

dsh-pin 是 Yu-tao-Li 维护的 DSH 插件，许可证为 MIT。它给 DeepSeek Harness 侧边栏会话增加两级置顶：工作区内置顶或全局置顶区，并支持多会话置顶与取消后精确还原。

它是纯客户端插件，零运行时依赖，不改 DSH 本体，仅 Web GUI 可用。

核心功能¶

下面介绍几个可落地的能力：

1、悬停会话行时，显示 📌 工作区内置顶和 ⌃⌃ 全局置顶按钮。按钮出现在侧边栏会话行的悬停菜单里（⋯ 左侧）。

2、支持同时置顶多个会话。

3、支持在 📌 与 ⌃⌃ 之间切换置顶级别。

4、取消置顶时，精确还原会话被置顶前的位置。

5、全局置顶为纯显示级置顶，不动任何持久顺序，取消即还原。

6、工作区内置顶走宿主官方顺序 API，并持久化到 DSH 工作区注册表。

7、「未分组」会话支持全局置顶，但不支持工作区内置顶。

8、平铺列表（“In one list”）没有手动顺序，按钮自动隐藏。

安装与启用¶

先执行安装命令，把插件装入 web profile：

dsh plugin --profile web add github:Yu-tao-Li/dsh-pin

安装后重启 dsh web 生效。也可以在 DSH 设置的插件市场(dshmarket)搜索 dsh-pin。

该命令中的 --profile web 与“仅 Web GUI 可用”的限制一致。仓库 package.json 声明需要 Node >=22。

典型用法¶

1、悬停任意会话，点击 📌，将会话置顶到本工作区。

2、点击 ⌃⌃，将会话置顶到所有工作区最上面的全局置顶区。

3、点击置顶区里的行，直接打开该会话。

4、再点一次按钮，或点击置顶区的 ✕ 取消置顶，并精确还原原位置。

适用场景与注意¶

适合使用 DSH Web GUI、需要频繁打开若干工作区中的常用会话的人。DSH 插件生态强调“一切皆插件”，插件市场(dshmarket)等目录是社区目录，不等同于 DeepSeek 官方应用商店。

使用或安装前注意以下几点：

• 仅 Web GUI 可用；TUI/Headless 没有侧边栏。
• 全局置顶按浏览器本地生效；工作区内置顶全局持久。
• 只写宿主工作区/会话顺序和浏览器本地记录，不碰会话内容、凭据，不新增网络端点。
• 工作区内置顶的还原依赖原相邻会话仍存在；相邻会话缺失时按回退规则放置。
• 依赖应用内部结构（React fiber 行身份、视图存储键名 dsh.workspace.view.v5）；DSH 大版本升级后，若结构变化，按钮可能失效。
• 存储损坏自动降级为空；RPC 失败有红色反馈。
• DSH 插件以当前 dsh 进程权限运行；安装前应检查源码与许可证。

结尾¶

dsh-pin 的价值在于不改 DSH 本体，只给 Web 侧边栏增加两级会话置顶：工作区内置顶适合持久顺序，全局置顶区适合跨工作区快速打开，取消后可以还原原位置。

GitHub 仓库：https://github.com/Yu-tao-Li/dsh-pin