前言¶
DeepSeek Harness (DSH) 採用插件化架構。在調試或臨時對話場景下，開發者通常需要一個輕量級的交互入口，既能快速調用大模型，又不干擾主會話的歷史記錄。dsh-temp-chat 正是爲了解決這個問題而設計，它在 DSH 頁面中放置了一個漂浮的“精靈”（鯨魚圖標）和一個可拖拽的臨時聊天窗口。
核心功能¶
- 漂流的精靈：精靈在錨點附近緩慢漂流（包含正弦漂移和上下浮動動畫），支持拖拽，位置在重啓後持久保存。
- 即時聊天：點擊精靈打開窗口，可拖拽標題欄移動，按
—鍵可最小化回精靈狀態。 - 零配置：默認情況下，插件自動跟隨會話的默認模型，無需手動輸入 API Key。
- 自定義端點：支持開啓獨立配置，接入 DeepSeek、OpenAI、Moonshot、GLM、Qwen 或任意 OpenAI 兼容的自定義 Base URL。
- 真實流式輸出：主機路由模式下支持約 55ms 的輪詢流式輸出；自定義端點模式下使用原生 SSE。
- 輔助功能：支持單條消息複製、一鍵清空、模型徽章顯示、深色/淺色主題切換、空狀態提示以及防止精靈被拖出屏幕的拖拽限制。
- 語言跟隨：界面語言會根據 DSH 的語言設置自動在中文和英文之間切換。
安裝與啓用¶
使用 npm 包安裝：
dsh plugin --profile desktop add dsh-temp-chat
安裝後重啓 DSH，頁面右下角會出現鯨魚精靈。從源碼安裝需要 Node.js 環境。
典型用法¶
- 移動精靈：直接拖拽鯨魚圖標將其停靠在頁面任意位置，位置會被保存。
- 打開/最小化：點擊（未拖拽時）打開聊天窗口；在窗口中按
—鍵可最小化回精靈。 - 發送消息：在輸入框按
Enter發送，按Shift+Enter換行。 - 複製內容：將鼠標懸停在消息上，點擊消息右側的
📋圖標複製。 - 配置模型：點擊聊天窗口頂部的
⚙圖標，可切換是否跟隨會話默認模型，或配置自定義端點的 Provider、API 地址和 Key。
適用場景與注意¶
- 環境要求：需要運行在 DSH 的
web或desktop配置文件下，且構建環境需安裝 Node.js ^22.19.0 或 >=24.0.0。 - 安全性：默認路由複用 Harness 的提供方，不發送額外憑證；自定義模式的 API Key 僅存儲在瀏覽器
localStorage中，不上傳至服務器。 - 數據存儲：聊天記錄僅保存在內存中，不會寫入 DSH 會話歷史，插件停止運行或清空後數據即丟失。
- 卸載方式：需從 profile 的
dependencies和dsh.profile.bundles中移除，並清理已安裝的鏈接。
總結¶
dsh-temp-chat 提供了一個輕量級、零配置的臨時對話入口。它通過漂浮精靈和臨時窗口的形式，既保持了界面的整潔，又提供了靈活的模型切換能力，適合需要在 DSH 頁面中快速進行臨時交互或測試的場景。
- 插件目錄：dsh-temp-chat (winditer)
- 項目源碼：winditer/dsh-elf
