dsh-session-control：DeepSeek Harness 侧边栏会话管理

前言¶

在使用 DeepSeek Harness 的 Web 模式时，侧边栏是主要的工作区。默认的会话列表会混合活跃会话、空白会话和归档会话，查找特定对话或管理历史记录需要频繁滚动。dsh-session-control 旨在解决这一问题，通过替换侧边栏主体来提供结构化的会话管理功能。

插件定位¶

这是一个客户端插件，由开发者 GooDAnDReaDY 维护。它接管侧边栏中原本显示工作区和会话列表的部分，提供固定、搜索、归档和降噪等能力，而不改变侧边栏的其他 UI 组件（如品牌区、新建按钮或设置入口）。

安装与启用¶

通过 DSH CLI 安装该插件：

dsh plugin --profile web add @goodandready/dsh-session-control

安装完成后，需要重启 DeepSeek Harness 的 Web Profile 以激活插件。

核心功能¶

1. 固定会话
   将重要对话固定在侧边栏顶部，形成一个全局可见的固定区域。配置会持久化存储，刷新页面或切换设备后依然存在。

2. 带上下文的搜索
   搜索对话内容时，不仅返回标题，还会显示匹配片段的预览，帮助快速判断会话相关性。

3. 按时期归档
   会话自动按时间分组为“今天”、“本周”、“本月”和“更早”。折叠时期可以提升性能，尤其是当历史会话数量较多时。

4. 只读归档查看器
   对于已归档的会话，无法直接用于聊天。插件提供了一个只读的转写查看器模态框，用于检查过往的对话记录、工具调用和用户提示。

5. 自动降噪
   自动隐藏无消息的空白会话（如调度程序或网关产生的会话），保持侧边栏整洁。当前活跃的会话即使为空也不会被隐藏。

6. 可逆的会话隐藏
   支持一键隐藏活跃会话。与归档不同，这种隐藏是可逆的，可以随时恢复查看。

7. 多选和批量操作
   通过复选框和 Shift+Click 范围选择，支持批量隐藏、取消隐藏或固定多个会话。

8. 原地重命名
   无需弹出模态框，直接双击会话标题或按 F2 键即可在行内修改名称。

9. 标签系统
   为会话打标签，便于按标签筛选。标签系统独立于文件夹结构，弥补了会话归属由工作目录决定的限制。

典型用法¶

• 快速跳转：按下 Alt + K 快速打开跳转模态框，筛选活跃和归档会话。
• 重命名：双击会话标题或按 F2 键进行原地编辑。

注意事项¶

• 架构变更：该插件会替换侧边栏主体（sidebar.workspaces slot），这是架构设计的要求。
• 环境依赖：依赖 Node.js 20+ 环境，且需要安装 @deepseek-ai/cordis ^4.0.2。
• 会话归属：会话的归属由其工作目录决定，无法通过插件跨文件夹移动会话。

生态背景¶

DeepSeek Harness 遵循“一切皆插件”的理念。此插件属于社区插件，与 DeepSeek 官方或幻方没有任何从属关系。