前言¶

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。

典型用法¶

1. 打開任意會話，點擊標題欄操作區的「專注」按鈕，或按 F 鍵進入專注模式。
2. 右側導航圓點可懸停預覽、點擊跳轉；滾到最底部時，底部居中自動展開精簡輸入條。
3. 在輸入條裏直接回復：Enter 發送、Shift+Enter 換行；草稿與主輸入框互通。
4. AI 提問 / 審批時彈「去回答」卡片，就地進行選項 / 文本 / 審批作答。
5. 按 Esc 逐層退出，或點「退出專注」返回原界面。

設置項¶

在「設置 → 插件 → 插件配置」中，可調整「專注模式」卡片：

• 自動進入專注
• F 鍵快捷鍵
• 同步當前閱讀位置
• 右側導航條
• 文字區寬度

適用場景與注意¶

適合希望減少界面干擾、在 DSH Web GUI 中更集中閱讀對話，並在專注視圖中繼續回覆的場景。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• 需要 dsh CLI >= 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