前言¶
在 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 倉庫。
