boogoo619/dsh-focus-overlay
专注模式 / Focus mode for DeepSeek Harness (DSH)：全屏阅读视图，折叠 AI 工具调用为摘要。
Listed
1
Ui
Bundle verified
Preview
What it does
Focus mode with a full-screen reading overlay that hides the header and composer and folds AI tool calls into summaries.
Best for
- Small-screen DSH users who want more vertical space for reading conversations.
- Long-session readers who want tool activity folded into summaries with message navigation and position preservation.
- Users who want optional automatic focus entry and notifications when a reply completes or the AI awaits input.
Not ideal for
- Workflows that require tool calls and intermediate execution steps to remain fully expanded while reading.
- DSH versions earlier than 0.1.0-rc.5.
- GitHub-source installations where install-time builds cannot be authorized; pnpm 10+ may require explicit allowBuilds permission.
README
dsh-focus-overlay
中文 | English
为 DeepSeek Harness（DSH）Web GUI 提供的：一键全屏阅读，隐藏标题区与输入区，把 AI 的工具调用流程折叠成一句话摘要，只保留「你与 AI 的对话」本身。
文本与图片渲染复用官方原语，与聊天视图 1:1 一致。
功能
- 全屏显示 —— 覆盖整个界面，把纵向空间全部留给对话
- 隐藏标题栏和输入栏 —— 顶部只留一条极窄栏，底部输入区收起
- 折叠工具调用 —— 一轮 AI 回复折叠成一句话摘要
- 快速导航 —— 右侧节点导航条，悬停预览、点击跳转
- 自动专注与提醒 —— 回复完成后可自动进入专注并定位到你的提问；专注中收到新回复、或被 AI 提问等待时弹出提醒
这些功能专为小屏幕提供更多内容呈现空间：收起常驻的标题/输入区与工具步骤，让有限的屏幕尽可能多地展示对话。
效果
关闭 —— 普通聊天视图
开启 —— 专注模式
进入专注后，一轮 AI 回复不再逐个展示步骤，而是折叠成一行摘要：
运行了 2 个命令，编辑了 3 个文件，读取了 5 个文件，搜索了 1 个正则
能力
| 功能 | 说明 |
|---|---|
| 全屏专注遮罩 | 经 shell.overlay 注册（纯增量、replaceRisk: none），覆盖标题区/输入区/侧栏，纵向空间尽给对话 |
| 官方渲染 | AI 文本走官方 MarkdownText（GFM + 代码高亮 + TeX），用户消息走 MessageText，用户气泡用官方蓝底无描边样式 |
| 图片解析 | assistant 的 image 块经 conversation.resolveImage 解析，会话授权图片 1:1 显示 |
| 工具调用折叠 | 工具调用 / 命令 / 上下文注入按类型计数折叠成摘要行（命令/编辑/搜索/读取/列目录/子代理/待办/目标/工作流/技能/提问/计划/后台任务） |
| 精确保留位置 | 进入专注时定位到聊天视图中正在阅读的消息（按 seq 对齐），而非从头开始 |
| 右侧节点导航条 | 每个 user 消息一个圆点，激活药丸跟随滚动、悬停预览、点击平滑跳转，少于 2 条自动隐藏 |
| 回到最新 | 离开底部时显示居中的「↓ 回到最新」悬浮按钮 |
| 文件提及 | 接 chatFileMentions，内联代码命中真实文件时变成可点链接 |
| i18n | 中 / 英文案，跟随界面语言 |
| 设置页 | 导航条开关、打开定位策略、文字区宽度，持久化到 localStorage
|
| 自动进入专注 | 回复正常完成后自动打开专注并定位到本轮你的提问；异常结束（停止 / 报错 / 超 token / 打断）不触发 |
| 回复 / 等待提醒 | 专注中回复完成弹「新回复已生成 + 查看」；AI 提问 / 审批等待时弹「AI 正在等待你的回复 + 去回复」，回答完自动消失 |
安装
需要 dsh CLI（>= 0.1.0-rc.5）。
从 npm（推荐）
dsh plugin --profile web add dsh-focus-overlay
dsh web
从 GitHub
dsh plugin --profile web add github:boogoo619/dsh-focus-overlay
dsh web
git 安装拉取源码并由
prepare脚本现场构建。pnpm ≥10 会先拒绝运行prepare，首次add失败后，按dsh提示把包键复制进该 profile 的pnpm-workspace.yaml：allowBuilds: dsh-focus-overlay: true然后重新执行
add。该授权允许本包代码在安装时于你的机器上执行——请只对可信来源授权，并锁定 commit（github:boogoo619/dsh-focus-overlay#<sha>）。
本地目录 / tarball
dsh plugin --profile web add ./dsh-focus-overlay # 本地目录
dsh plugin --profile web add ./dsh-focus-overlay-0.1.0.tgz # tarball
安装后重启 dsh web 生效。
使用
- 打开任意会话，点击标题栏操作区的 「专注」 按钮。
- 进入全屏专注视图：顶部只有一条极窄栏（会话标题 + 退出），正文只显示你与 AI 的对话，工具步骤折叠为摘要行。
- 右侧导航圆点可悬停预览、点击跳转；离开底部时右下出现居中的「↓ 回到最新」。
- 按
Esc或点「退出专注」返回原界面，原位置/状态保持不变。
设置
侧栏「设置 → 专注模式」：
| 选项 | 说明 |
|---|---|
| 显示右侧导航条 | 开关导航圆点（默认开） |
| 打开时保留聊天位置 | 进入时定位到当前阅读位置；关闭则定位到最新（默认开） |
| 文字区宽度 | 480–1200px 滑块，调整阅读列宽（默认 760px） |
| 回复结束后自动进入专注模式 | 回复正常完成后：关闭时自动进入并定位到提问，已打开时弹「新回复已生成」；AI 提问 / 审批等待时弹「AI 正在等待你的回复」（默认关） |
许可
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:boogoo619/dsh-focus-overlay in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.