前言¶
DeepSeek Harness（DSH）在录制智能体对话时，左侧会话管理区往往会显示大量历史会话，容易分散注意力。尤其在需要聚焦当前会话的场景下，其他会话的标题、时间、状态和预览内容仍会出现在画面中，影响录屏效果。
会话沉浸插件通过视图层隔离，将当前会话置顶，并用不可交互的占位条遮蔽其他会话，只保留当前会话的可视区域，帮助在录制时聚焦关键内容。
插件定位¶
- 名称：会话沉浸（Session Immersion）
- 维护者：baigo8
- 版本：1.0.3
- 许可证：MIT
- 核心价值：录制时聚焦当前会话，用不可交互的占位条遮蔽其他会话，减少干扰
核心功能¶
-
沉浸视图切换
- 在左侧栏底部、设置旁点击三横线图标（悬停显示“沉浸当前会话”）即可开启沉浸。
- 会话管理区切换为受保护视图：当前会话置顶，其余会话显示固定长度的灰色条，没有时间、状态、真实标题、悬停预览、菜单、拖拽或点击入口。
- 再次点击该图标即可退出沉浸，恢复 DSH 原生会话管理区域。 -
独立列表视图
- 插件注册的是高优先级会话管理区域视图，而非原列表上的模糊滤镜。
- 开启时当前会话置顶，其余会话按目录顺序排列，行数可能包含原列表筛选隐藏的普通会话。
- 不复制原生的分组、排序、折叠和搜索功能；原生区域会暂时卸载，原生组件未持久化的搜索输入、滚动位置或显示更多状态可能重置。 -
安全边界
- 保护范围仅为左侧会话管理区域；不保护当前会话正文、标题、输入框、附件、文件预览、终端、工作区选择器、浏览器标签页等区域。
- 不拦截 DSH 全局新会话按钮、快捷键、深链接等区域之外的导航；使用这些入口切换会话后，受保护列表会跟随新的当前会话显示。
- 隐藏行不渲染真实标题、时间、状态、提示或可访问性原文，不因悬停恢复。
- 无网络请求、遥测、文件写入或会话历史修改；不向模型注册工具；开关为纯视图交互。 -
动效与主题
- 按钮缩放回弹、占位条约 220ms 淡入；敏感内容不参与淡出，受保护视图直接不渲染原文。
- 遵循系统“减少动态效果”；使用 DSH 主题变量，按钮跟随应用强调色，未硬编码淡紫色，兼容深色主题和自定义主题。
安装与启用¶
安装方式¶
- 从维护者处获取
dsh-session-immersion-1.0.3.tgz压缩包。 - 接收者将压缩包保存到本机。
- 在 DSH 会话中使用插件管理工具安装本地插件包：
请使用插件管理工具安装这个本地插件包：/填写本机绝对路径/dsh-session-immersion-1.0.3.tgz
必须使用接收者自己的文件路径，不要沿用发送者路径。
启用与卸载¶
- 安装后刷新现有 DSH 页面。插件管理中会出现“会话沉浸 / Session Immersion”。
- 在 DSH“插件”页面找到“会话沉浸”，使用原生启用/停用开关。
- 停用会移除开关及受保护视图，恢复原生会话列表；不修改会话数据。
- 可用插件管理的卸载操作删除此插件包。
- 插件启用不等于沉浸已开启；插件默认处于普通浏览状态，刷新或重新启用后需要再次点击聚焦按钮。
兼容范围¶
- 目标版本：DSH 0.2.1-rc.2
- 声明范围：>=0.2.1-rc.2 <0.3.0
- 不保证其他版本未经测试即兼容；若新版本拒绝安装，不建议绕过版本检查。
使用建议¶
- 开启沉浸后，确认画面再开始录屏。
- 录屏前建议检查工作区路径、当前正文和附件，关闭无关弹窗。
- 搜索、筛选、分组和会话切换建议在退出沉浸后再使用。
- 停用、卸载、退出沉浸都会重新显示会话信息，请先停止录屏。
总结¶
会话沉浸插件通过视图层隔离，将当前会话置顶并用不可交互的占位条遮蔽其他会话，帮助在录制时聚焦关键内容。它不修改会话数据，不涉及加密或权限控制，仅作用于左侧会话管理区域，属于安全的视图增强工具。
- 目录页：https://www.skillhub.cn/plugins/baigo8/dsh-session-immersion
- GitHub：https://github.com/baigo8/dsh-session-immersion
