前言¶
在 DeepSeek Harness（DSH）裏做開發時，隨手問一句「這個函數名怎麼念」並不罕見。若走「側邊對話」或「創建分支」，主會話歷史會被帶過去，工具描述也會一併繼承——README 中寫明，即便 minimal 預設，工具描述實測仍約 16K token 起步。代價與問題不匹配。
維護者 ZIye1208 的客戶端插件 dsh-clean-chat 走的是另一條路：在 DSH 自帶右側欄增加一格「閒聊」，宿主直接發 messages，不帶 tools 字段，不寫會話文件，首輪上下文接近「一句系統提示 + 你的問題」。下面介紹它的定位、安裝與用法；事實以 GitHub 倉庫 README 與 package.json 爲準。
這是什麼¶
- 名稱：
dsh-clean-chat（npm 包名相同） - 分類：客戶端（走 DSH 原生右側欄
@deepseek-ai/dsh-client-ui-sidebar-right的ctx.sidebarRightTabs與sidebar.right.pane.tab席位） - 許可證：MIT
- 當前發佈版本（package.json）：
1.0.0 - 兼容說明：README 標註 DSH
0.2.2-rc.1桌面端實測可用；要求宿主暴露webServer與llm服務。模型由宿主llm服務提供，插件本身不帶密鑰。
與「側邊對話」「創建分支」的對比如下（摘自 README 表格）：
| 側邊對話（better-sidebar） | 創建分支 | 閒聊（本插件） | |
|---|---|---|---|
| 帶上主會話歷史 | 全量原文（上行被壓縮） | 全量原文 | 不帶 |
| 帶工具描述 | 是（繼承預設） | 是 | 不帶 |
| 寫會話文件 | 是 | 是 | 不寫 |
| 進會話列表 | 否 | 是 | 否 |
| 首輪 token 量級 | 十幾 K 起 | 十幾 K 起 | 一句話系統提示 + 你的問題 |
核心功能¶
對話面板¶
右側欄 + 菜單 → 閒聊。
- 左上角下拉選模型，按 provider 分組；默認「默認模型」（即設置裏的默認模型）
- 「提示」可改系統提示（默認
You are a helpful assistant.，留空則完全不帶系統提示） - 「清空」丟棄這段對話；Enter 發送，Shift+Enter 換行；生成中可「停止」
- 回覆支持輕量 Markdown；每條回覆下有「用量」膠囊，可查看提供方、模型、未緩存輸入、輸出等（路由返回緩存統計時還會顯示緩存相關字段）
- 思考過程默認摺疊，可展開查看
對話歷史只在內存裏：關掉面板或重啓 DSH 即消失。系統提示與模型選擇會寫入宿主磁盤 ~/.dsh/storages/clean-chat/settings.json（system、provider、model 三個字段），重啓後仍保留。
刻意不帶的能力¶
- 不帶工具：不能讀文件、搜索或執行命令（需要上下文時請自行粘貼）
- 不帶主會話上下文
- 不寫會話日誌，不會多出會話列表或上下文報表條目
宿主 HTTP 接口（供本機腳本）¶
插件在宿主 webServer 上註冊路由，例如：
| 方法 | 路徑 | 說明 |
|---|---|---|
| GET | /clean-chat/api/ping |
探活 |
| GET | /clean-chat/api/models |
可用 provider/model 列表 + 當前默認 |
| GET/POST | /clean-chat/api/settings |
讀寫存盤設置 |
| POST | /clean-chat/api/chat |
SSE 流式對話，messages 必填，無 tools 字段 |
README 給出 PowerShell 調用示例（迴環地址，端口隨 DSH 啓動變化）：
$body = @{ messages = @(@{ role = 'user'; content = '你好' }) } | ConvertTo-Json -Depth 5
Invoke-RestMethod "http://127.0.0.1:<端口>/clean-chat/api/chat" -Method Post `
-ContentType 'application/json; charset=utf-8' -Body $body
安全與限流（插件側）¶
宿主路由掛在 127.0.0.1:<隨機端口>，README 說明：迴環來源與外鏈 Origin 的 CSRF 由插件攔截；同機其它程序與腳本無法靠 HTTP 頭完全區分，README 明確「同機即同權」。此外對 /chat 有模型白名單（llm.listModels）、頻率與體量上限（如每分鐘 20 次、單條 4 萬字等），超限返回 429 / 413。
安裝與啓用¶
前置：不需要先裝其它側欄插件；已裝 dsh-better-sidebar 也不衝突。
方式一：npm（README 推薦）¶
裝最新版：
dsh plugin --profile desktop add dsh-clean-chat
釘住版本：
dsh plugin --profile desktop add dsh-clean-chat@1.0.0 --save-exact
方式二：DSH 設置界面¶
- DSH 桌面端 → 左下角設置 → 插件
- 右上角添加，可填：
dsh-clean-chat、github:ZIye1208/dsh-clean-chat，或本地目錄路徑 - 安裝完成後完全退出 DSH 再打開（啓動時加載，熱重載不生效）
方式三：命令行（與上等價）¶
dsh plugin --profile desktop add dsh-clean-chat --save-exact
dsh plugin --profile desktop add github:ZIye1208/dsh-clean-chat
裝完後同樣需完全重啓 DSH。驗證是否寫入 profile：
Select-String -Path "$env:USERPROFILE\.dsh\profiles\desktop\package.json" -Pattern "dsh-clean-chat"
README 要求 dependencies 與 dsh.profile.bundles 兩處都出現該包名，否則插件不會激活。
典型用法¶
日常開發中最常見的路徑：
- 按上文任一方式安裝並重啓 DSH
- 右側欄
+→ 選 閒聊 - 如需固定模型或系統提示，在面板中設置（會落到
settings.json） - 輸入問題，Enter 發送；輕量問答、念讀函數名、解釋概念等，無需把主會話「分叉」出去
若要從腳本自動化調用，先用 GET /clean-chat/api/models 確認 provider/model，再 POST /clean-chat/api/chat；端口在 DSH 運行時可從宿主獲知。
適用場景與注意¶
適合：需要「像網頁版聊天」那樣乾淨的一問一答；希望避免工具描述與主會話歷史佔滿首輪 token；臨時請教、潤色一句話，且不需要插件讀倉庫或跑命令。
不適合：要讓模型看項目文件、調工具鏈、或把對話納入 DSH 會話體系——應繼續使用主會話或其它帶工具的側欄能力。
安裝前建議：插件以當前 DSH 進程用戶權限運行，本機腳本理論上可訪問 ~/.dsh 與 settings.json；安裝前可在 GitHub 瀏覽源碼與 MIT 許可證。社區目錄 skillhub.cn 插件頁 爲社區收錄站點，與 DeepSeek / 幻方無 README 所稱的官方從屬關係。
生態上 DSH 奉行「一切皆插件」；dsh-clean-chat 用最小補丁佔右側欄一格，把「重會話 + 重工具」與「輕閒聊」拆開，降低隨手提問的 token 與心智負擔。
- 目錄頁：https://www.skillhub.cn/plugins/ZIye1208/dsh-clean-chat
- 源碼與文檔：https://github.com/ZIye1208/dsh-clean-chat
