DSH Plugin: UI Session Pin

中文 | English

为 DeepSeek Harness 网页版提供全局会话置顶功能，让你把重要的对话一键置顶，并在不同工作区之间随时打开。

适用人群与场景

适合日常处理多个项目、积累了大量历史会话，希望将核心任务、长期目标或高频参考的对话常驻在侧边栏顶部的用户。

核心特性

• 跨工作区全局常驻：置顶会话保存在独立设置中，切换项目或目录后仍可从工作区列表上方的置顶区打开。
• 操作体验对齐 Codex：通过普通会话的三点菜单执行“置顶/取消置顶”；插件不接管浏览器原生右键菜单，当前会话标题栏也提供同样的操作。
• 置顶与工作区去重：置顶会话集中显示在“工作区”栏上方，并从普通工作区列表中隐藏；置顶区按置顶时间从早到晚排列。
• 原版行行为复用：置顶行复用宿主会话条目的上次交互时间、三点按钮、状态点和详情悬浮卡片；置顶区支持整体折叠。
• 与归档生命周期联动：会话归档时保留置顶标记，还原会话后自动恢复置顶状态。
• 服务端权威状态：置顶会话 ID 统一由 Host 设置服务保存于 $DSH_HOME/settings.yaml 的 ui-session-pin.pinnedSessionIds。回环客户端直接使用 settings scope；远程客户端通过插件自有 Typert Remote 读写同一份 Host 状态，不创建浏览器独立副本。Host 的 settings/document-updated 事件会触发其他客户端重新读取，因此多个客户端共享同一置顶列表。
• 零污染无损卸载：移除插件后，所有会话立即恢复到原工作区的普通列表中，不破坏底层历史记录与工作区数据。

极简安装与使用

请把经过评审的提交安装进正式 Web profile。仓库自带 dsh.bundle 配置和预构建运行文件。按项目约定使用 Node.js + pnpm：

Set-Location 'H:\A137442\Develop\AI\dsh\.dsh\profiles\web'
dsh plugin --profile web add github:ARCJ137442/dsh-session-pin#v0.1.0-rc.20

安装后重启 Web 页面；在宽侧栏中打开任意普通会话的三点菜单，点击“置顶会话”即可生效。

当前候选版本为 v0.1.0-rc.20，Release 页面包含可复用的预构建 tarball。

兼容性说明

当前适配 DeepSeek Harness rc.8 的公开 slot API：使用会话标题栏操作 slot 和侧栏底部 action slot 作为挂载点。置顶区、普通行去重和原生三点菜单适配由插件自己的 DOM 兼容层完成；插件不修改 Harness 核心源码，也不依赖 ctx.sessionPins、sidebar.workspaces.* 等非公开接口。

存储与隐私安全

Host 设置提供方仅保存一份有序的会话 ID 列表。本插件不读取、不上传任何提示词、模型回复、凭据或工作区路径信息。

模型体验

请求上下文与条件

模型看到的内容

无。唯一持久化字段是 pinnedSessionIds，请求组装不会读取它；本包不会增加提示词、消息、工具 schema 或提供方请求字段。

Token 影响

直接 token 数为零。

KV Cache 影响

无；置顶与取消置顶不会发起或改变模型请求。

已知限制与暂缓事项

• 回环模式依赖 Host 设置开放——回环浏览器中，如果部署没有通过设置 API 开放 ui-session-pin，插件不会显示置顶控件。远程访问（非回环）模式下，插件通过自己的 Host Remote 访问相同的 settings 服务，不依赖被 Harness 禁止的远程 settings.* RPC；远程客户端之间的状态由 Host 统一维护并通过 settings/document-updated 收敛。
• 依赖 rc.8 DOM 契约——兼容层通过 sectionHeader、搜索控件和会话操作按钮的 ARIA 标签识别工作区及会话；Harness UI 结构、ARIA 文案或本地化变化后可能需要插件更新。
• 同名会话存在歧义——rc.8 普通会话行没有公开稳定的 Session ID，插件只能按操作按钮标题和可见行顺序匹配；同名会话时建议通过当前会话标题栏操作，或先切换到能区分标题的视图。
• 仅在宽侧栏显示置顶区——收窄/图标侧栏没有足够空间时，标题栏按钮仍可用，置顶区会在恢复宽侧栏后重新出现。
• 置顶区不支持手动排序——置顶操作按时间追加，界面从早到晚排列；拖拽排序不改变置顶时间顺序。