前言¶

在 DeepSeek Harness（DSH）Web UI 中，如果希望不進入設置頁、直接在會話標題欄調整對話內容區寬度，magicOF2/dsh-chat-width-customizer 提供了一個標題欄按鈕。它用於循環切換寬度檔位，並讓對話消息區、底部輸入框（Composer）、用戶氣泡同步加寬。

下面介紹插件定位、核心功能、安裝啓用和典型用法。

插件定位¶

插件名稱爲：

magicOF2/dsh-chat-width-customizer

維護者爲 magicOF2，許可證爲 MIT。它面向 DSH Web UI，在會話標題欄的工具區增加寬度切換按鈕。根據已覈實資料，插件註冊在以下槽位：

conversation.session.header.utilities

這是純增量添加。

核心功能¶

下面列出已覈實的功能點：

• 點擊標題欄按鈕循環切換寬度檔位，檔位範圍爲 748 → 1600 px，無需進入設置頁。
• 對話消息區、底部輸入框（Composer）、用戶氣泡同步加寬。
• 寬度爲全局狀態，跨會話保持一致。
• 跨標籤頁通過 storage 事件即時同步。
• 實際寬度按視口自動鉗制，鉗制規則爲視口寬度減 24px，下限爲 320px；窗口縮放時即時重算，按鈕仍顯示所選檔位。
• 選擇寫入 localStorage，刷新頁面或重新打開瀏覽器後恢復。
• 使用 DSH 主題 CSS 變量，淺色/深色模式自動適配。
• 註冊在 conversation.session.header.utilities 槽位，屬於純增量添加。

默認寬度檔位¶

默認檔位爲：

[748, 896, 1024, 1152, 1280, 1440, 1600]

單位爲 px。若要自定義寬度檔位，需要編輯以下文件頂部的 PRESETS 常量：

lib/client.js

安裝與啓用¶

先使用 GitHub 安裝命令：

dsh plugin --profile web add https://github.com/magicOF2/dsh-chat-width-customizer.git

安裝後需要重啓：

dsh web

並在瀏覽器裏執行強制刷新：

Ctrl+Shift+R

經過上面的步驟，插件隨 GUI 自動加載，無需任何手動啓用。

典型用法¶

1、打開任意會話，點擊標題欄右側的「寬度 · NNNpx」按鈕。

2、每點一次循環到下一檔：

748 → 896 → 1024 → 1152 → 1280 → 1440 → 1600 → 748 …

3、切換會話時，寬度與按鈕顯示保持一致。

4、刷新頁面後，自動恢復上次選擇的寬度。

兼容性與運行邊界¶

已覈實兼容以下環境：

DeepSeek Harness 0.1.0-rc.6 及以上（開發環境驗證版本）
Cordis 4.x

package.json 中聲明的 peerDependencies 爲：

{
  "@deepseek-ai/cordis": "^4.0.1",
  "react": "^18.2.0"
}

該插件數據僅寫入 localStorage，不依賴 API Key，無數據上傳。作爲 DSH 插件，插件以當前 dsh 進程權限運行；安裝前應檢查源碼與 MIT 許可證，確認符合你的使用環境。

鏈接¶

社區目錄頁：

https://www.skillhub.cn/plugins/magicOF2/dsh-chat-width-customizer

GitHub：

https://github.com/magicOF2/dsh-chat-width-customizer