会话沉浸 · Session Immersion

DSH 录屏辅助插件，版本 1.0.3，MIT 许可。原创聚焦图标随包分发。

安装与分享

把 dsh-session-immersion-1.0.3.tgz 发给其他 DSH 用户即可。接收者将压缩包保存到本机，在 DSH 会话中发送：

请使用插件管理工具安装这个本地插件包：/填写本机绝对路径/dsh-session-immersion-1.0.3.tgz

必须使用接收者自己的文件路径，不要沿用发送者路径。不需要 npm 登录、编译、API Key、额外依赖或安装脚本。若界面不支持选择本地压缩包，直接用上述会话安装方式即可。

源码 ZIP 解压后也可以将内含项目目录的绝对路径交给插件管理工具安装。目录安装可能以链接方式引用源码，安装后请勿移动或删除该目录。推荐普通用户安装 tgz。

使用

1. 安装后刷新现有 DSH 页面。插件管理中会出现“会话沉浸 / Session Immersion”。
2. 打开要录制的会话，在左侧栏底部、设置旁点击三横线图标（中间长粗，上下短淡）（悬停显示“沉浸当前会话”）。
3. 会话管理区切换为受保护视图：当前会话置顶，其余会话显示固定长度的灰色条，没有时间、状态、真实标题、悬停预览、菜单、拖拽或点击入口。
4. 再次点击侧栏底部的三横线图标即可退出沉浸。会话标题栏不再重复显示开关。
5. 退出后恢复 DSH 原生会话管理区域。搜索、筛选、分组和会话切换请先退出沉浸再使用。

插件启用不等于沉浸已开启。插件默认处于普通浏览状态，刷新或重新启用后需要再次点击聚焦按钮。建议先开启沉浸、确认画面，再开始录屏。

在插件管理中启用 / 停用 / 卸载

在 DSH“插件”页面找到“会话沉浸”，使用原生启用/停用开关。停用会移除开关及受保护视图，恢复原生会话列表；不修改会话数据。可用插件管理的卸载操作删除此插件包。停用、卸载、退出沉浸都会重新显示会话信息，请先停止录屏。

动效与主题

按钮缩放回弹、占位条约 220ms 淡入；敏感内容不参与淡出，受保护视图直接不渲染原文。遵循系统“减少动态效果”。使用 DSH 主题变量，按钮跟随应用强调色，未硬编码淡紫色，以兼容深色主题和自定义主题。

为什么按钮在底部？

DSH 0.2.1-rc.2 尚未开放会话标题栏动作和会话标题替换的专用插槽。插件采用官方侧栏底部动作插槽提供常驻入口；仅在沉浸期间高优先级注册会话管理区域视图，退出时撤销注册。没有修改 DSH 安装文件，没有读取或改写其他插件的 DOM、私有类名，也没有拦截全局操作。

因此这是独立的安全列表视图，而非原列表上的模糊滤镜：开启时当前会话置顶，其他会话按目录顺序排列，行数可能包含原列表筛选隐藏的普通会话；不复制原生分组、排序、折叠和搜索。原生区域会暂时卸载，原生组件未持久化的搜索输入、滚动位置或显示更多状态可能重置。占位条长度按 5 种预设循环，与原标题长度无关。

安全边界

• 保护范围仅为左侧会话管理区域；不是加密、权限控制或全页面脱敏工具。
• 不保护当前会话正文、标题、输入框、附件、文件预览、终端、工作区选择器、浏览器标签页等区域。
• 不拦截 DSH 全局新会话按钮、快捷键、深链接等区域之外的导航。使用这些入口切换会话后，受保护列表会跟随新的当前会话显示，不能视作全应用导航锁。
• 隐藏行不渲染真实标题、时间、状态、提示或可访问性原文，不因悬停恢复。宿主的会话目录数据仍存在内存中，因此不防开发者工具或其他插件读取。
• 无网络请求、遥测、文件写入或会话历史修改；不向模型注册工具。开关为纯视图交互。
• 录屏前建议检查工作区路径、当前正文和附件，关闭无关弹窗，先试录几秒再正式录制。

兼容与验证

目标版本：DSH 0.2.1-rc.2；声明范围 >=0.2.1-rc.2 <0.3.0，不保证其他版本未经测试即兼容。若新版本拒绝安装，不建议绕过版本检查。

交付时检查 JavaScript 语法、清单、分发内容与已安装插槽。当前环境没有浏览器控制能力，无法代替用户验证实机点击、逐帧遮蔽和深浅色视觉效果；首次使用前请按上面步骤做一次试录。

源码结构

• client.js：React 视图、局部样式、字典、插槽注册与清理。
• index.js：无副作用的 Host 入口。
• cordis.patch.yml：独立插件条目，不覆盖用户配置。
• locale/、icon.svg：插件管理元信息与原创图标。

本地重新打包：在源码目录运行 npm pack --ignore-scripts，分发生成的 tgz。无构建步骤。