前言¶
DSH 的理念是「一切皆插件」。如果你在使用 DSH Web 時,只希望把運行過程中可見的思考狀態換成自定義文字、動畫圖片或圖文組合,而不想改動 DSH 源碼、不想重寫狀態 DOM,也不想引入模型可見的輸入輸出變化,可以看看 dsh-thinking-status-customizer。
社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係。下面只介紹已覈實資料中明確寫出的能力、安裝方式和注意事項。
這是什麼¶
dsh-thinking-status-customizer 是一個 CSS-only DSH Web plugin,由 Dbi-Eshuh 維護,許可證爲 MIT,包版本爲 0.2.2。
它用於自定義 DSH Web 的 thinking status,支持:
- 自定義流動文字
- GIF/APNG/WebP 動畫
- 圖文組合展示
它替換的是可見運行狀態,不修改 DSH source,也不重寫 status DOM。原始 DSH status 仍會保留在 accessibility tree 中。
核心功能¶
下面列出的能力均來自已覈實資料:
- CSS-only DSH Web plugin。
- 替換 DSH Web 可見運行狀態爲自定義流動文字、GIF/APNG/WebP 動畫,或圖文組合展示。
- 不修改 DSH source,不重寫 status DOM。
- 提供浮動的 Thinking status settings panel。
- 跟隨當前 DSH language setting,立即更新英文或中文界面,且不丟棄未保存的表單值。
- 用戶自定義文字會按原文保留。
- 可以啓用或禁用視覺替換。
- 可以在以下展示方式之間切換:
- custom text flow
- animated image
- left-image/right-text combination
- 文字模式支持 2 到 5 個自定義顏色。
- 文字模式支持 4 種 flow directions。
- 文字模式支持 continuous 或 back-and-forth movement。
- 圖片模式接受 HTTPS/Data URL,或本地 GIF、APNG、WebP。
- 圖片模式最大支持 20 MB。
- 包含一個約 12 秒、透明背景的 dance GIF。
- 原始 DSH status 保留在 accessibility tree。
- 不新增 tool、prompt、model-visible input or output、session event 或 model behavior。
安裝與啓用¶
先安裝 v0.2.2 tag 到 Web profile,並查看解析後的配置:
dsh plugin --profile web add github:Dbi-Eshuh/dsh-thinking-status-customizer#v0.2.2
dsh --profile web --dump-config
安裝並檢查配置後,重啓 DSH Web。
重啓後,打開浮動的 Thinking status 按鈕。再次點擊同一按鈕、點擊關閉按鈕,或按 Escape,都可以關閉面板。
在面板中,你可以啓用或禁用視覺替換,並在以下三種展示方式之間切換:
- 自定義文字流動效果。
- 動畫圖片。
- 左圖右文組合。
文字模式可以配置 2 到 5 個自定義顏色、4 種流動方向,以及連續或往返移動。圖片模式可以使用 HTTPS/Data URL,也可以選擇本地 GIF、APNG、WebP 文件,最大 20 MB。面板中還提供了一個約 12 秒的透明背景 dance GIF。
如果不再需要這個插件,可以移除它,然後重啓 DSH Web 恢復內置展示:
dsh plugin --profile web remove dsh-thinking-status-customizer
本地文件與存儲¶
本地圖片需要注意大小限制:
- 本地文件超過 2 MB 時保持未壓縮狀態。
- 超過 2 MB 的本地文件使用 temporary object URL。
- temporary object URL 只在當前 tab 有效。
- 頁面刷新後,需要重新選擇該本地文件。
- 較大的本地圖片不會被持久化。
設置項和 Data URL 圖片約 3 MB 以內,只存儲在瀏覽器 localStorage 中,鍵名如下:
dsh-thinking-status-customizer:v1
如果存儲缺失、損壞或不可用,插件會回落到默認值,不會讓頁面停止。
插件不會上傳設置、狀態文字、圖片或模型交互。如果配置了 HTTPS 圖片 URL,瀏覽器會直接請求該 URL。
兼容性與開發校驗¶
當前 release 已使用 DSH Web 0.1.0-rc.6 測試。如果 DSH 更新改變了 selector,可能導致視覺替換不生效。
包版本 0.2.2 聲明的 Node engines 爲:
^22.19.0 || >=24.0.0
它只使用 public DSH bundle、client-module loading declarations 和 client locale service;不 patch ui-conversation,也不依賴 private DSH build helpers。
在倉庫中做本地校驗時,先安裝依賴,再運行 verify:
npm install
npm run verify
適用場景與注意¶
這個插件適合:
- 只想調整 DSH Web 可見思考狀態外觀的人。
- 希望保留原始狀態文本可訪問性的人。
- 不想改變工具、提示詞、模型可見輸入輸出、會話事件或模型行爲的人。
- 使用本地瀏覽器展示效果,不希望通過該插件改變模型交互內容的人。
安裝前建議檢查源碼和 MIT 許可證。插件會進入對應 profile 的 DSH 環境,並按當前 dsh 進程權限運行,因此只安裝來自可信倉庫的版本。
它不適合用來改變模型推理過程或會話數據。已覈實資料明確:該插件不新增 tool、prompt、model-visible input or output、session event 或 model behavior。
結尾¶
dsh-thinking-status-customizer 的價值在於:只改變 DSH Web 的瀏覽器本地可見展示,不修改 DSH 源碼,不重寫狀態 DOM,也不增加模型側可見變化。
已覈實資料未提供目錄頁 URL;GitHub 倉庫地址如下:
- GitHub: https://github.com/Dbi-Eshuh/dsh-thinking-status-customizer