前言¶
在 DeepSeek Harness(DSH)里長時間跑 agent,常見問題是:會話是否在跑、是否在等審批、是否出錯,往往要靠盯日誌或消息流。純 UI 裝飾類插件不會改 agent 邏輯,但可以在輸入框邊緣用視覺信號把狀態「掛」在餘光能掃到的地方。下面介紹社區插件 RainbowSpeak(虹語)——@kenz1117/dsh-ui-rainbowspeak,由維護者 kenz1117 發佈,在 SkillHub 目錄中歸類爲「趣味換裝」,GitHub 星標爲 1。它只做一件事:給聊天 composer 輸入框卡片加一圈可配置的彩虹跑馬燈邊框,並按會話狀態改變流速與配色。
這是什麼¶
RainbowSpeak 的定位是:DeepSeek Harness 聊天輸入框(composer)上的彩虹跑馬燈邊框裝飾。npm 包名 @kenz1117/dsh-ui-rainbowspeak,當前資料中的版本爲 0.0.2,許可證 MIT。
插件自述爲純瀏覽器端裝飾:不接管插槽、不打宿主補丁、不註冊工具、不注入系統提示。客戶端 bundle 約 17 KB;引擎不支持 CSS @property 時,流動動畫會降級爲靜態漸變環。
錨點是宿主上的輸入框卡片元素 [data-composer-card],在卡片 ::before 上用 conic-gradient 與蒙版只保留邊緣環帶。
核心功能¶
彩虹邊框與設置面板¶
默認是一圈沿卡片邊界流動的 conic 漸變綵帶,角度由註冊的 @property --dsh-rainbow-angle 驅動關鍵幀旋轉。
在宿主 Settings → Rainbow border 中可調整:
- 啓用 / 禁用
- 流速(1–10 秒/圈)
- 環寬(1–6 px)
- 配色與位置(四邊 / 頂部 / 底部)
- 反向流動、呼吸亮度疊加
偏好寫入 localStorage,改完即生效。
七種配色¶
資料列出的配色包括:經典彩虹、極光、日落、蜜桃、海洋、賽博霓虹(青/紫/品紅,帶白色燈閃段),以及 跟隨主題——經 color-mix 從宿主品牌色派生,深淺主題切換時邊框跟隨。
會話狀態感知¶
插件通過宿主 dock 座位讀取會話狀態(僅在插件層,不涉及 agent-loop),邊框行爲包括:
| 狀態 | 表現(據 README) |
|---|---|
| agent 運行中 | 環加速(約 4 s → 1.2 s/圈) |
| 工具審批或 ask-user 待處理 | 琥珀色慢脈衝 |
| 發送失敗或 agent 出錯 | 紅色快脈衝 |
| 一輪完成 | 一週期的慶祝閃光 |
優先級:錯誤 > 提醒 > 運行。
其它行爲¶
- 聚焦增亮:輸入框聚焦時環增亮、增飽和,失焦緩退。
- 無障礙:遵循
prefers-reduced-motion(動畫禁用,保留靜態環);設置控件帶本地化標籤與 aria。 - 中英雙語:文案經宿主 locale 註冊表下發。
安裝與啓用¶
官方推薦用 dsh CLI 安裝:
dsh plugin add @kenz1117/dsh-ui-rainbowspeak
也可在 profile 的 package.json 裏手動加入依賴:
{
"dependencies": {
"@kenz1117/dsh-ui-rainbowspeak": "*"
}
}
在 profile 目錄執行 pnpm install 並重啓宿主後生效。
本地開發時,可將依賴指向 checkout(資料示例爲 link: 絕對路徑),在插件倉庫執行 pnpm bundle,宿主下次重啓即可加載改動,無需重裝。
環境要求(package.json):Node ^22.19.0 || >=24.0.0,DSH >=0.1.2-alpha.1;客戶端平臺爲 web(desktop/web 宿主)。Peer 含 @deepseek-ai/cordis 及若干 dsh-client-ui-* 包,由宿主在運行時提供。
典型用法¶
安裝並重啓宿主後,邊框默認出現在 composer 卡片上。日常調節走設置面板即可,無需額外命令。
若需確認插件是否按預期掛載:apply 時會插入一張 <style data-plugin> 樣式表,dispose 時移除;用戶偏好與會話狀態會投影到 <html> 的 data-rainbow-* 屬性與內聯 CSS 變量。
維護者本地開發流程(摘自 README):
pnpm install
pnpm test
pnpm typecheck
pnpm bundle
適用場景與注意¶
適合誰:希望在 DSH Web 客戶端裏給輸入框加一點辨識度、又希望邊框能反映 agent/審批/錯誤狀態的開發者;分類上屬於「趣味換裝」,不改變對話能力本身。
兼容性:流動動畫依賴 @property(Chromium/Electron 構建可用);其它引擎爲靜態環。
安全與權限:與其它 DSH 插件一樣,插件隨當前 dsh 進程與 profile 加載。安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證,確認符合你的環境策略。社區目錄 SkillHub 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係,並非官方應用商店。
結尾¶
RainbowSpeak 把 composer 邊框做成可配置的彩虹環,並把運行、待審、出錯等狀態編碼進流速與顏色,屬於零侵入的 UI 裝飾。需要安裝命令與細節時,以倉庫 README 爲準。