boogoo619/dsh-focus-overlay

功能

• 全屏显示 —— 覆盖整个界面，把纵向空间全部留给对话
• 隐藏标题栏和输入栏 —— 顶部只留一条极窄栏，底部输入区收起
• 折叠工具调用 —— 一轮 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 生效。

使用

1. 打开任意会话，点击标题栏操作区的 「专注」 按钮。
2. 进入全屏专注视图：顶部只有一条极窄栏（会话标题 + 退出），正文只显示你与 AI 的对话，工具步骤折叠为摘要行。
3. 右侧导航圆点可悬停预览、点击跳转；离开底部时右下出现居中的「↓ 回到最新」。
4. 按 Esc 或点「退出专注」返回原界面，原位置/状态保持不变。

设置

侧栏「设置 → 专注模式」：

选项	说明
显示右侧导航条	开关导航圆点（默认开）
打开时保留聊天位置	进入时定位到当前阅读位置；关闭则定位到最新（默认开）
文字区宽度	480–1200px 滑块，调整阅读列宽（默认 760px）
回复结束后自动进入专注模式	回复正常完成后：关闭时自动进入并定位到提问，已打开时弹「新回复已生成」；AI 提问 / 审批等待时弹「AI 正在等待你的回复」（默认关）

许可

MIT