前言¶
长时间在 DSH 里写代码、看 diff,界面配色越鲜艳越容易累。Animal Island UI 是社区主题插件,属于分类「趣味换装」,由 Shirolin 维护,面向 DSH Web 端和 Windows 桌面端,把界面重心放在低对比的奶油纸面与木色边界上,同时保留一点手账和海岛元素。下面介绍它提供什么、怎么装、需要注意什么。
这是什么¶
Animal Island UI 是 DSH 的主题插件,基于 DSH 公开的 ThemeRuntime Token 与 Slot 接缝实现,版本 0.3.36,许可证 MIT。它不修改 DSH 的布局、快捷键和交互习惯,只覆盖样式层。仓库自述为「A high-fidelity Animal Island inspired DSH Web skin」,视觉参考开源组件库 animal-island-ui。
需要先说明的是:这是开源社区插件,与 DeepSeek 官方及任天堂没有任何隶属、授权或背书关系,也不包含受版权保护的游戏专有资产。
核心功能¶
昼夜两套画布¶
日间用双层波点草坪、底部波浪和低透明度漂浮叶片,主内容区铺半透明奶油白纸面。夜间是独立调校的深青夜空加星点画布,侧栏偏冷色,内容纸面仍为暖棕,代码块使用深棕底色。
手账部件与交互细节¶
- 侧栏顶部的 24px 新会话入口扩展成 216×60 的渡岛船票样式,带奶油纸面、薄荷票根和打孔撕口。
- 顶部路径改为木质绶带,侧栏选中项是竖向木纹牌,底部输入框加了对话气泡尾标和纸纹。
- 主按钮带实体底边和按压位移;键盘焦点环改为 2px 内嵌薄荷环,避免在滚动容器边缘被裁切。
应用内外观设置¶
在「设置 → 插件 → 动森外观」里可以调整:
- 三档预设:纸白 / 均衡 / 海岛。
- 画布浓度滑杆,范围 0.15–0.60,带实时分层预览。
- 可单独开关插画装饰、纸纹颗粒。
- 浅色 Diff 语法配色可选暖色或 DSH 原生。
- 界面字体可选 Nunito 拉丁字体或系统默认字体。
偏好保存在当前客户端的 localStorage 中。
实现边界¶
覆盖 118 项 ThemeRuntime Token 与 4 个公开 Slot,不使用 DOM 轮询、MutationObserver 或构建期随机哈希类名。字体(Nunito WOFF2)和原创 SVG 插画在构建期直接内嵌进 bundle,运行时不发起外部网络请求。
安装与启用¶
README 建议同一 profile 下只启用一个主题插件。三种安装方式如下。
方式一,插件市场安装。在 DSH 内打开「设置 → 插件」,搜索 Animal Island UI 或「动森」,安装后重启应用生效。
方式二,通过 NPM 安装到 Profile。进入 DSH profile 目录直接安装:
cd <DSH_Profile_目录>
pnpm add dsh-theme-animal-island-ui
安装后需要完整重启 DSH 服务并刷新页面。
方式三,离线 .tgz 安装包。从 GitHub Releases 下载对应版本的 .tgz 和 SHA256SUMS:
cd <DSH_Profile_目录>
pnpm add file:<下载目录>/dsh-theme-animal-island-ui-<version>.tgz
Windows 桌面端使用独立的 desktop profile,依赖客户端内置的 Electron Node 运行时执行安装。如果已克隆仓库,可以用脚本一键打包并同步到本机的 web 与 desktop 两个 profile:
pnpm install
pnpm run install:local
典型用法¶
安装启用后,打开「设置 → 插件 → 动森外观」即可调整预设和开关。README 还提供了面向外部脚本的子路径导出,可以直接复用色板和对比度计算:
import { ANIMAL_ISLAND_PALETTES } from 'dsh-theme-animal-island-ui/palette'
import { buildTokenOverrides, contrastRatio } from 'dsh-theme-animal-island-ui/tokens'
适用场景与注意¶
适合希望降低编码界面视觉刺激、又想保留一点个人风格的 DSH 用户。如果只想确认效果,可以看作者的宣传页与实机演示。
两点需要注意:
- 插件以当前 DSH 进程的权限运行,安装前应查看源码和许可证(MIT)后再决定是否启用。
- DSH 升级后如果接缝变更,主题可以自动回退到原生界面,但升级后最好确认一下外观设置是否保持预期。
另外,仓库路径需从 DSH 客户端的插件安装入口进入,不建议凭名称自行拼接 dsh plugin add 命令。
结尾¶
Animal Island UI 做的事不复杂:不改功能,只把界面改成适合长时间阅读的纸面风格,并放在 DSH 公开的样式接缝上。社区目录页在 skillhub.cn,源码和文档在 GitHub。