前言¶
DeepSeek Harness(dsh)的 Web 聊天界面默認沒有頭像,消息左側是 AI 回覆、右側是用戶輸入,視覺上是一整塊文本流。很多開發者希望在對話裏區分“誰在說話”,但又不想改動 React 組件本身。misszqm/dsh-feiyu-avatar 就是在這個需求下給出的一個輕量方案:不侵入原有組件,而是通過 CSS 在現有消息容器上疊加頭像,讓每條消息各自顯示自己的頭像,像微信那樣。
它是什麼¶
這是一個爲 DeepSeek Harness Web 界面增加頭像顯示的插件,分類屬於“趣味換裝”。維護者爲 MissZQM。插件通過一層 CSS 覆蓋在 DSH 現有的聊天結構上,給用戶消息和 AI 回覆分別添加圓形頭像,支持上傳或指定本地圖片路徑,頭像大小可在 24–64 px 之間調整,設置修改後立即生效。
核心功能¶
- 用戶頭像:貼在每條用戶消息的右側,包括運行途中追加的追問。
- AI 頭像:貼在 AI 回覆的左側。
- 各自配置:每側可以獨立控制是否顯示、上傳圖片或指定本地圖片路徑、調整頭像大小(24–64 px,默認 36)。
- 兩種圖片來源:
- 直接上傳一張圖片,插件會自動裁剪成圓形。
- 填寫圖片的絕對路徑,插件直接讀取該文件,修改文件後頭像自動更新。
- 不預設任何圖片:未配置時兩側都不顯示頭像,不會出現空圓圈。
- 設置入口:DSH 設置 → 聊天頭像。
- 即時生效:修改配置後無需重啓或刷新頁面。
- 權限與存儲:圖片和配置僅保存在本機
$DSH_HOME/dsh-feiyu-avatar/下,不上傳到任何服務器,也不會進入代碼倉庫。
安裝與啓用¶
從 GitHub 安裝:
dsh plugin add github:MissZQM/dsh-feiyu-avatar
如果使用命名 profile(例如桌面端),帶上 --profile:
dsh plugin --profile desktop add git+https://github.com/MissZQM/dsh-feiyu-avatar.git
或者從本地目錄安裝(開發時用):
dsh plugin add link:/path/to/dsh-feiyu-avatar
安裝完成後刷新一次頁面,設置中的“聊天頭像”入口就會出現在側邊欄裏。
典型用法¶
- 打開 DSH 的設置界面,找到“聊天頭像”選項。
- 在“在聊天裏顯示頭像”總開關中選擇開啓。
- 在“頭像大小”中調整到需要的尺寸(例如 40 px)。
- 點擊“你的頭像”上傳一張圖片,或直接填寫本地圖片的絕對路徑。
- 同樣方式配置“AI 的頭像”。
- 保存設置後,在 Web 聊天界面查看效果。
適用場景與注意¶
- 適合需要在 Web 聊天界面中快速區分用戶與 AI 回覆的開發者。
- 適合希望自定義頭像風格、統一或區分多輪對話場景的用戶。
- 注意:插件以當前 DSH 進程的權限運行,安裝前建議查看源碼與許可證(MIT)。
- 已知限制:頭像掛在每個
assistant-step行上,工具調用過程通常被摺疊進“思考過程”,一輪裏一般只能看到一個 AI 頭像;如果一輪中有多個可見步驟,會顯示多個頭像。僅在 Web 界面生效,終端界面沒有聊天行,自然沒有頭像。
短結尾¶
misszqm/dsh-feiyu-avatar 通過 CSS 覆蓋的方式,爲 DSH Web 聊天添加了微信式的雙側頭像,配置簡單、即時生效,適合希望在聊天界面中增加視覺區分的開發者。
- 目錄頁:https://www.skillhub.cn/plugins/MissZQM/dsh-feiyu-avatar
- GitHub:https://github.com/MissZQM/dsh-feiyu-avatar