coloured-favicon:DSH Web 的彩色小鯨魚 favicon 插件

前言

在 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.platformwebdsh.client.immediatelytrue

核心功能

  • 彩色漸變流動: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

動態形態

動態形態適合只給自己或單會話使用。步驟如下:

  1. 在 DSH 會話中加載 cordis-plugin-development 技能。
  2. 調用 cordis_define,把 src/index.js 的內容作爲 code.client 傳入。
  3. 調用 cordis_run 激活返回的 pluginId / packageId,並在運行卡片上批准授權。

經過上面的步驟,瀏覽器標籤頁的小鯨魚 favicon 會開始彩色流動;運行卡片內可以繼續調整「暫停 / 恢復」與變色模式。

構建與調整

倉庫提供 npm run build。如果按 bundle 形態修改了需要打包的代碼,可執行構建後再重新打包或分發:

npm run build

動態形態修改 src/index.js 後,可按上面的 cordis_definecordis_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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜