前言¶
在 DeepSeek Harness（DSH）里读长回答，常见做法是滚聊天区或靠浏览器缩放。字号一调，侧栏、输入框和用量信息跟着变大，公式和表格也未必还顺眼。若同一会话里有多轮对话，想对照某一轮的提问与回答，往往要在时间线里来回找。
下面介绍社区客户端插件 dsh-read-zoom（维护者 liuyifeng-code）：在每条回答的操作行增加固定「放大」入口，把整轮提问与回答克隆进全屏两栏面板，用可调字号重读；公式（KaTeX）、表格、代码块、图片沿用 DSH 已渲染结果，不重新解析 Markdown。
这是什么¶
dsh-read-zoom 归类为 DSH 客户端插件：纯 DOM 注入（window.__ModuleLoader__.load），不依赖 React、不改 app.asar。当前 package.json 版本为 0.3.8，在 DSH 桌面 web 端随进程加载（immediately: true）。
它解决的是「在 DSH 界面内舒适重读、按轮跳转、顺带记一句待发」——而不是替代 DSH 自带的复制或导出。
核心功能¶
三个入口¶
| 入口 | 操作 |
|---|---|
| 操作行按钮（主入口） | 每条回答底部操作行里，在「用量」左侧的展开图标；顺序约为：复制 / 点赞 / 分支 / 放大 / 用量 / 时长 |
| 键盘 | Alt+Z 或 Alt+E（v0.3.3 起）打开视口内最靠下的一条回答 |
| 常驻按钮 | 右下角圆形 Aa，效果同 Alt+Z |
自 v0.2.1 起移除了跟随消息漂移的悬停药丸，入口位置固定。在输入框、文本域或可编辑区域打字时，Alt+Z / Alt+E 不会触发。
全屏两栏阅读区¶
打开后：
- 左栏轮次列表（v0.3.1 起读 DSH 原生轮次导航，可列全量轮次）：标题为「本会话 · N 轮」，每行显示提问摘要；点行或
↑/↓切换当前轮的「提问 + 回答」。未载入 DOM 的历史轮次会先触发 DSH 补载（最多等待 6 秒，提示「正在载入第 N 轮…」）。 - 右栏内容：当前轮提问与回答；
A−/A+调字号（80%–300%，步进 10%），点中间百分比回到 140%；Ctrl/Cmd + 滚轮亦可缩放。比例记在localStorage（键dsh-read-zoom:zoom）。 - 左栏底部输入框（v0.3.0）：写完点「填入输入框」写入 DSH 真实输入框（只填不发）；
Ctrl/Cmd+Enter同效。 - 顶栏：
复制文字（当前轮纯文本）、公式规约（9 条数学/化学输出规约，可粘进AGENTS.md等）、关闭；Esc、点空白处亦可退出，焦点回到原位置。
关闭浮层时会还原主聊天区滚动位置（v0.3.1）。
公式与化学式（仅影响浮层）¶
插件不改 DSH 的 KaTeX 管线，在阅读区做三类增强：
- KaTeX 渲染失败（
.katex-error红字）→ 灰底等宽原文，便于复制改写。 - 行间公式过宽 → 按可用宽度等比缩小字号（下限约 0.45em）。
- 「公式规约」一键复制 9 条规约（基于 DSH 0.2.2 所用 KaTeX 0.18.7 实测；化学式避免
\ce{}等不支持的宏，改用\mathrm{}与箭头类写法）。
被截断的轮次（v0.3.4+）¶
若某轮只有提问、回答在生成中被中断（DSH 显示「已停止」），放大面板在「回答」处显示虚线提示「输出被截断，无回答」，而不是空白或仅两个字。v0.3.8 还处理了「已停止」仅一行小字、class 不含 stop 字样的边界情况。
性能与动效¶
v0.3.2 去掉全屏 backdrop-filter: blur、精简克隆的 KaTeX DOM、批量测量公式宽度，并将操作行按钮扫描改为 requestIdleCallback（浮层打开期间不扫）。v0.3.3 打开/关闭使用约 160–200ms 的 opacity/transform 过渡；系统开启「减少动态效果」时跳过动画。
安装与启用¶
资料中的示例以 desktop profile、本地插件登记为例。社区目录页：https://www.skillhub.cn/plugins/liuyifeng-code/dsh-read-zoom；源码：https://github.com/liuyifeng-code/dsh-read-zoom。
宿主插件管理器安装/更新 bundle 时，不要手改 profile 的 package.json（运行中的 DSH 会用内存里的 bundles 覆盖手改）。客户端代码更新后需让窗口重新加载：Ctrl+Shift+R；若行为仍旧，彻底退出 DSH 再启动。
卸载示例（desktop profile）：
dsh plugin --profile desktop remove dsh-read-zoom
也可在 GUI 插件页停用/移除后重启 DSH。具体 add/install 命令以目录页或仓库当前说明为准；本文不拼接未在资料中出现的安装命令。
典型用法¶
- 在任意一条已完成的回答上，点操作行「放大」图标（或
Alt+E/ 右下角Aa）。 - 在左栏点另一轮摘要，跳转到该轮提问与回答；用
A+把字号调到适合阅读的 140% 或更高。 - 需要跟一句追问时，在左栏底部输入框写好，点「填入输入框」，回到主界面确认后自行发送。
- 模型公式经常报红时，点「公式规约」复制规约，写入智能体说明或提示词。
调试可在 DSH DevTools 控制台执行：
window.__DSH_READ_ZOOM__.peek()
window.__DSH_READ_ZOOM__.openLast()
peek() 返回 version、overlayOpen、tailButtons 等；按钮 DOM 带 data-dshzr-version 便于确认加载版本。
适用场景与注意¶
适合：长技术回答、含大量公式/表格/代码的会话；需要在同一会话内按轮对照、大字号精读；希望把数学/化学输出规约一键拷进项目文档的用户。
注意：
- 插件与当前 DSH 进程同权限运行，安装前请阅读仓库源码与许可证（资料中未单独列出许可证字段则以仓库为准）。
- 操作行与消息 DOM 随 DSH 升级可能变化；若放大按钮不出现，可按 README 顺序查
peek().version、messages()、tailButtons。 - 仅「以回答结尾」的轮次操作行常显；流式生成中按钮由空闲扫描补回，属预期行为。
- SkillHub 社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；星标等元数据以目录页实时显示为准（资料抓取时为 0）。
结尾¶
dsh-read-zoom 把「放大重读、按轮跳转、公式友好展示、规约一键复制」收进一个全屏面板，入口固定在回答操作行与快捷键上，尽量不干扰主聊天流。需要安装说明或提交 issue，见 SkillHub 目录页 与 GitHub 仓库。
