前言¶
DSH 的 Web GUI 中，一轮 AI 回复可能同时包含标题区、输入区、侧栏和工具调用流程，屏幕空间会被多个区域分散。dsh-focus-overlay 是一个 DSH 插件，用于把当前会话切换成全屏阅读视图：隐藏标题区与输入区，折叠 AI 工具调用流程为摘要，并保留导航和就地输入。下面介绍它的功能、安装方式和常用操作。
这是什么¶
dsh-focus-overlay 由 boogoo619 维护，许可证为 MIT。它面向 DSH Web GUI，提供专注模式：全屏阅读、隐藏标题区与输入区，并把 AI 工具调用流程折叠成摘要。项目列在独立社区插件目录中，不属于 DeepSeek / 幻方官方应用商店。
核心功能¶
- 全屏专注遮罩，覆盖标题区、输入区和侧栏。
- 隐藏标题栏和输入栏。
- 把一轮 AI 回复折叠成一句话摘要。
- 右侧节点导航条，悬停预览、点击跳转。
- 支持回复完成后自动进入专注并定位到提问。
- 专注中收到新回复，或 AI 等待时弹出提醒。
- 按
F键进入专注模式。 - 专注内精简输入条，与主输入框共享草稿。
- 文件提及：内联代码命中真实文件时变成可点链接。
- 中 / 英文案，跟随界面语言。
- 插件配置卡片可设置导航条开关、定位策略、文字区宽度。
- 兼容 DSH-better-sidebar。
安装与启用¶
先确认运行环境：需要 dsh CLI >= 0.1.0-rc.5，package.json 声明 node >=22.19.0。
从 npm 安装时，先执行安装命令，把插件加入 web profile：
dsh plugin --profile web add dsh-focus-overlay
安装完成后，重启 dsh web 让插件生效：
dsh web
如果 add 没有拿到最新版本，可能是 pnpm minimumReleaseAge 的 24 小时安全机制；可显式指定版本号，或等 24 小时后再执行不带版本号的 add 命令。
从 GitHub 安装会拉取源码，并由 prepare 脚本现场构建。若使用 pnpm >=10，需按提示在 pnpm-workspace.yaml 设置：
allowBuilds:
dsh-focus-overlay: true
然后重新执行安装命令。该授权允许本包代码在安装时于本地执行，应只对可信来源授权，并建议锁定 commit。
典型用法¶
- 打开任意会话，点击标题栏操作区的「专注」按钮，或按
F键进入专注模式。 - 右侧导航圆点可悬停预览、点击跳转；滚到最底部时，底部居中自动展开精简输入条。
- 在输入条里直接回复：
Enter发送、Shift+Enter换行；草稿与主输入框互通。 - AI 提问 / 审批时弹「去回答」卡片，就地进行选项 / 文本 / 审批作答。
- 按
Esc逐层退出，或点「退出专注」返回原界面。
设置项¶
在「设置 → 插件 → 插件配置」中，可调整「专注模式」卡片：
- 自动进入专注
F键快捷键- 同步当前阅读位置
- 右侧导航条
- 文字区宽度
适用场景与注意¶
适合希望减少界面干扰、在 DSH Web GUI 中更集中阅读对话，并在专注视图中继续回复的场景。
使用前注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 许可证为 MIT。
- 需要
dshCLI>= 0.1.0-rc.5，node >=22.19.0。 - 安装后需重启
dsh web。 - 从 GitHub 安装时，
prepare脚本会在安装时本地构建；只应对可信来源授权，并建议锁定 commit。 - 若同时使用 DSH-better-sidebar，
dsh-focus-overlay兼容该插件。
资源¶
- 目录页：https://www.skillhub.cn/plugins/boogoo619/dsh-focus-overlay
- GitHub：https://github.com/boogoo619/dsh-focus-overlay
