前言¶
DeepSeek Harness (DSH) 採用插件化架構，社區開發者可以針對特定場景擴展功能。hw-cola/dsh-message-enhancer 專注於提升 Web 客戶端的交互體驗，解決長對話中的定位困難、計劃審批流程繁瑣以及消息發送後的反饋延遲等問題。
核心功能¶
消息與計劃索引標尺¶
在聊天輸入框上方的 Dock 中添加一條垂直索引，用於快速掃描和定位當前已加載的用戶消息與最終計劃。
* 內容過濾：僅展示用戶消息和 steering 消息，識別 exit_plan_mode 提交的最終計劃。
* 狀態着色：刻度顏色按用戶操作結果着色。確認執行顯示綠色，空反饋拒絕顯示紅色，提交反饋或去聊天顯示暖黃色，普通消息顯示灰色。
* 交互預覽：懸浮或鍵盤聚焦時顯示白色圓角預覽卡片，支持輕量 Markdown 渲染，底部顯示類型與時間。
* 滾動定位：點擊刻度將對應聊天節點滾動到聊天區域中部。有更早歷史時頂部顯示 ···，每次點擊加載一頁。
計劃審批卡與歷史計劃卡¶
對原生計劃審批功能進行樣式替換與交互增強。
* 卡片樣式：保留原生計劃審批位置、Markdown 內容和審批協議，樣式替換爲主題自適應的中性卡片。
* 內容調整：標題欄提供複製完整 Markdown 的圖標按鈕。卡片底部可直接輸入需調整的內容，非空時“拒絕”變爲“提交反饋”。
* 歷史記錄：每次“去聊天裏說”、“拒絕/提交反饋”或“確認執行”後，聊天時間線都會保留該版計劃的歷史卡（固定高度、底部漸變虛化提示內容未完整展示）。歷史卡可“放大窗口”懸浮閱讀。
回覆完成提醒¶
在模型整輪迴復正常完成時提醒用戶，適合切到別的窗口等回覆的場景。
* 設置入口：設置 → 通用設置，提供“回覆完成提示音”、“提示音類型”、“Windows 系統通知”三行設置。
* 觸發機制：觸發時機爲整個回合完成（completed / max-tokens）。點“停止”、模型報錯或計劃被退回時不提醒。
* 通知方式：系統通知走瀏覽器 Notification API，窗口最小化或切到別的應用也會彈。通知標記靜音，聲音統一由提示音播放。
最後一條消息氣泡編輯重發¶
針對最後一條用戶消息提供編輯與重新生成能力。
* 編輯入口：最後一條用戶消息氣泡的複製按鈕左側出現鉛筆按鈕。
* 操作流程：點擊後氣泡原位變成輸入框，改完直接發送。模型基於編輯後的文本重新回答，舊回覆不出現。
* 機制說明：發送走 DSH 原生 fork 機制，從該消息之前的 completed turn 邊界創建子會話並自動切換。單輪會話時改爲新建會話重發。發送前自動把父會話當前的模型選擇與權限預設同步到子會話。
安裝與啓用¶
安裝插件：
dsh plugin --profile web add "git+https://github.com/hw-cola/dsh-message-enhancer.git"
釘到指定版本（按 tag 鎖定）：
dsh plugin --profile web add "git+https://github.com/hw-cola/dsh-message-enhancer.git#v1.0.0"
生效步驟：
安裝後需重啓 dsh web（讓插件的 cordis 補丁層生效）並刷新瀏覽器頁面。
典型用法¶
- 快速定位：在長對話中，利用聊天輸入框上方的垂直索引快速掃描或定位特定的計劃節點。
- 審批調整：點擊計劃審批卡標題欄的複製按鈕導出 Markdown，或直接在卡片底部輸入框修改內容後提交。
- 接收提醒：在設置 → 通用設置中開啓回覆完成提示音和系統通知，避免錯過模型回覆。
- 修正輸入：點擊最後一條用戶消息氣泡的鉛筆按鈕，修改錯別字後直接重發，模型將基於新文本重新生成。
適用場景與注意¶
- 適用場景：需要頻繁審批計劃、進行長對話管理、希望收到回覆完成提醒、以及需要修正上一條消息再重新生成的開發者。
- 兼容性：插件在 DSH 0.1.1-rc.2 上開發測試。
- 權限要求：系統通知需要瀏覽器權限；頁面非 localhost/https 訪問時可能受限。
- 許可證：MIT 許可證。
短結尾¶
該插件通過索引標尺、審批優化、通知提醒和消息重發四個維度，增強了 DSH Web 的日常使用體驗。所有功能均基於 DSH 原生機制實現，不依賴額外的後端服務。
