前言¶
DeepSeek Harness（DSH）的 Web 客戶端提供了基礎的模型交互界面。對於高頻使用者而言，默認的輸入框在鍵位配置、快捷指令和輔助功能上存在提升空間。本插件旨在解決這些問題，爲 Web 模式下的 Composer（輸入框）提供增強體驗。
插件定位¶
- 名稱：
dsh-composer-ux - 定位：DeepSeek Harness Web 輸入體驗增強插件
- 維護者：fangwen9527
- 協議：MIT
核心功能¶
1. 鍵位配置與輸入安全¶
插件允許自定義輸入框的發送鍵和換行鍵（如 Enter / Ctrl+Enter / Alt+Enter 等）。錄製支持自定義組合鍵，並支持一鍵恢復默認。
* IME 安全：在中文或日文輸入法組合期間（isComposing 狀態），系統會放行輸入，不會觸發誤發或誤換行。
* 兼容性：發送/換行通過回放官方按鍵管線實現，保留了官方的忙時排隊、連發防重等保護機制。如果未綁定 Enter 系按鍵，默認保留官方行爲。
2. 右鍵菜單¶
設置頁提供三種菜單來源選項：
* 官方：完全由 DSH 和瀏覽器原生處理，無插件介入。
* 瀏覽器：使用瀏覽器自帶菜單，粘貼功能無需授權。
* 自定義：提供 7 項固定樣式的右鍵菜單（撤銷、重做、剪切、複製、粘貼、刪除、全選）。
* 注意：Firefox 的剪貼板訪問需要手動授權，每次點擊粘貼都會彈出確認窗口，這是瀏覽器的安全機制。
3. 設置面板與全局開關¶
- 全局開關：設置頁頂部設有總開關，可一鍵啓用或禁用所有增強功能。
- 持久化尺寸：設置面板支持調整大小，尺寸變化會自動保存，關閉後再次打開保持上次狀態。
- 重啓 DSH：設置頁卡片頭部提供“重啓 DSH”按鈕，點擊後通過助手進程重啓，釋放端口並重載配置。
4. 快捷指令與提示詞優化¶
- 快捷指令面板：內置常用提示詞列表，支持分類管理。點擊指令按鈕可插入文本，每條指令可獨立配置“發送時總是追加”模式。
- 提示詞優化器：發送前自動運行一次獨立的模型調用，對輸入內容進行優化，再執行發送操作。
5. 輔助功能¶
- OpenCode 請求頭：自動注入
x-opencode-session請求頭，確保 OpenCode 相關路由在 DSH 中正常工作。 - Windows 終端切換：在 Windows 上，可將模型調用的默認終端從 PowerShell 切換爲 Git Bash。
- 統計行升級：輸入框下方顯示緩存命中百分比，精度保留 3 位小數（v0.7.0 起，默認開啓）。
- 費用膠囊：顯示本會話費用估算。支持按模型編輯高峯/非高峯價格，並支持自動獲取中國法定節假日。價格結算依據事件發生時的具體時間點，而非查看面板的時間。
安裝與啓用¶
安裝該插件需要 DSH 的 Web Profile。執行以下命令：
# 安裝
dsh plugin --profile web add dsh-composer-ux
# 更新
dsh plugin --profile web update dsh-composer-ux
安裝完成後，根據提示重啓 DSH 或刷新頁面即可生效。
典型用法¶
- 調整鍵位：進入設置頁的“輸入體驗”，根據習慣修改發送和換行鍵。
- 使用快捷指令：在輸入框工具欄點擊指令按鈕，快速插入預設提示詞。
- 優化輸入：在發送前，利用優化器對長文本進行潤色。
- 配置價格：在“金額”設置中，針對特定模型編輯峯谷價格或同步官方價目。
注意事項¶
- 默認啓用項：在 v0.7.0 版本中，“統計行”是唯一默認開啓的功能項，其餘功能默認關閉。
- Firefox 限制：由於瀏覽器的安全策略，Firefox 下使用自定義剪貼板功能時無法避免授權彈窗。
- 權限與許可：插件以當前 DSH 進程權限運行，安裝前建議查閱源碼與許可證（MIT）。
- 數據保留：關閉某個功能欄（如關閉鍵位配置）會禁用該功能，但已保存的配置數據會保留，重新開啓即可恢復。
