前言¶
在 DSH 的插件思路里,Web 頁面的外觀並不只能由宿主代碼寫死:一個客戶端插件可以替換 favicon,也可以把頁面內的品牌元素一起改色。coloured-favicon 做的就是這樣一件事:把 DSH Web 頁面的小鯨魚 favicon 做成彩色漸變持續流動,並把頁面內的鯨魚圖標、deepseek 文字、hero 標題「探索未至之境」以及「預覽版」徽章一併彩色化。
這是什麼¶
coloured-favicon 是一個 Cordis 客戶端插件,維護者爲 Elipese568,代碼、文檔與腳本遵循 MIT License。它面向 DSH Web 頁面,純客戶端 JS 實現,無構建步驟、無運行時依賴。package.json 版本爲 2.0.0,聲明 engines.node 爲 >=18,並聲明 dsh.client.platform 爲 web、dsh.client.immediately 爲 true。
核心功能¶
- 彩色漸變流動:7 段彩虹色相循環,同時漸變方向旋轉,顏色在小鯨魚身上持續流動。
- 頁面內彩色化:鯨魚圖標、deepseek 文字、hero 標題「探索未至之境」以及「預覽版」徽章同樣使用流動彩虹漸變。
- 直接替換 DSH Web 頁面的 favicon,無需刷新頁面。
- 動態形態下,
cordis_run卡片內提供即時彩虹圓點、「暫停 / 恢復」按鈕與變色模式配置,可在「漸變變色 / 整體變色」之間切換頁面內顏色的呈現方式。 - 停用或更新插件時自動恢復原始 favicon,不留殘留。
安裝與啓用¶
bundle 形態¶
bundle 形態適合分發給其他用戶、一次裝全部署。按倉庫給出的安裝命令,先把本地 tgz 包加入 web profile,再啓動 DSH:
npx @deepseek-ai/dsh plugin --profile web add ./coloured-favicon-2.0.0.tgz
npx @deepseek-ai/dsh web
啓動時不要額外疊加 --patch,否則會重複 insert 並報錯。npx @deepseek-ai/dsh web --patch ./cordis.patch.yml 只在包未進 bundles 時使用;疊加兩次會報 duplicate loader entry id: coloured-favicon。
動態形態¶
動態形態適合只給自己或單會話使用。步驟如下:
- 在 DSH 會話中加載
cordis-plugin-development技能。 - 調用
cordis_define,把src/index.js的內容作爲code.client傳入。 - 調用
cordis_run激活返回的pluginId / packageId,並在運行卡片上批准授權。
經過上面的步驟,瀏覽器標籤頁的小鯨魚 favicon 會開始彩色流動;運行卡片內可以繼續調整「暫停 / 恢復」與變色模式。
構建與調整¶
倉庫提供 npm run build。如果按 bundle 形態修改了需要打包的代碼,可執行構建後再重新打包或分發:
npm run build
動態形態修改 src/index.js 後,可按上面的 cordis_define 與 cordis_run 流程重新部署。
適用場景與注意¶
- 動態形態:適合個人開發、單會話驗證,不需要把插件裝進完整 DSH 部署。
- bundle 形態:適合把插件作爲部署的一部分分發,其他用戶不需要在會話中再次執行 define/run。
- 插件以當前 dsh 進程權限運行。安裝前建議先閱讀
src/index.js、相關腳本與許可證,確認其副作用可接受。 - 小鯨魚圖形版權歸 DeepSeek 所有;本項目僅用於個人學習與界面美化,不構成官方授權。
- DSH 插件生態強調「一切皆插件」;社區目錄是獨立站點,與 DeepSeek / 幻方無官方從屬關係,也不應將本文介紹的插件理解成官方應用商店裏的官方組件。
結尾¶
coloured-favicon 提供的是一個較窄但具體的外觀改動:讓 DSH Web 的 favicon 和頁面內品牌元素變成持續流動的彩虹小鯨魚。它保留了卸載恢復、純客戶端和兩種部署形態,適合作爲 DSH 插件改外觀的一個例子。
GitHub 倉庫:
https://github.com/Elipese568/coloured-favicon