前言¶
在 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
