前言¶
DeepSeek Harness (DSH) 默认将每个会话（Session）保留在其所属的工作区（Workspace）中。当会话列表变长时，想要快速回到几个活跃的会话，需要反复扫描列表。DSH Pinned Sessions 在工作区标题下方增加了一个紧凑的固定区域，允许用户在不改变原生列表结构的情况下，将重要的会话置顶。
插件简介¶
名称：DSH Pinned Sessions
所有者：Anionex
核心价值：从侧边栏顶部快速访问活跃工作；保持原生组织完整；使用熟悉的操作；处理精确的会话身份；本地化存储；支持键盘导航。
安装与启用¶
在 Web 或 Desktop 配置文件中安装，或执行以下两条命令：
dsh plugin add @anionex/dsh-pinned-sessions --profile web
dsh plugin add @anionex/dsh-pinned-sessions --profile desktop
安装完成后，刷新 Web 界面或重启 Desktop 客户端即可生效。
使用方法¶
- 在任意原生会话的菜单（Ellipsis menu）中选择 Pin session。
- 固定后的副本会出现在工作区标题下方，按最新置顶。
- 若要移除，在任意固定行的菜单中选择 Unpin session。
特性与兼容性¶
插件为固定行提供了完整的原生操作菜单：
* Web 配置文件：支持 Rename（重命名）、Fork session（分叉会话）、Unpin session（取消固定）、Archive session（归档）。
* Desktop 配置文件：支持上述所有 Web 操作，以及 Delete session（删除）。注意：删除功能仅在 Archive Manager 暴露该能力时显示。
工作原理与数据¶
- 存储机制：插件将 Session ID 和
pinnedAt时间戳存储在浏览器的localStorage中，键名为dsh.pinned-sessions.v1。 - 渲染逻辑：
shell.overlay监听侧边栏工作区插槽，将固定列表注入到原生列表上方。 - 数据限制：存储的 ID 最多保留 500 个，并会自动清理已归档或不再存在的会话。
注意事项¶
- 本地化：固定项属于当前 DSH 浏览器源（Origin/Profile），不会在设备间同步。
- 原生关系：固定行是原生行的副本，不会移动或移除原始行。
- API 版本：插件基于 pre-0.2.0 的 DSH 客户端 API 构建。若 DSH 更新客户端契约，需安装兼容的插件版本。
生态与资源¶
该插件遵循 MIT 许可证。DSH 生态遵循「一切皆插件」的理念，社区目录与 DeepSeek 官方无直接隶属关系。
- GitHub 仓库：https://github.com/Anionex/dsh-pinned-sessions
- 社区目录：https://www.skillhub.cn/plugins/Anionex/dsh-pinned-sessions
