DSH 动森主题 · Animal Island UI
English · 官方宣传站 · 30 秒实机短片 · 作者：Shirolin
Animal Island UI 是为 DeepSeek Harness（Web 与 Windows 桌面端）打造的动森风主题插件。它将渡岛船票品牌区、奶油手账纸、木牌选中态与夜岛星空带入工作台，还原 animal-island-ui 的手账质感，同时完整保留 DSH 的所有原生交互、布局与快捷键。
[!NOTE] 本项目为开源社区插件，与 DeepSeek 官方无隶属、授权或背书关系。主题仅作用于 DSH 公开的 ThemeRuntime Token 与 Slot 接缝，不劫持私有组件，DSH 升级后可安全降级。
界面预览
| 日间模式 (Light) | 夜间模式 (Dark) |
|---|---|
 |
 |
 |
 |
核心特性
- 🏝️ 昼夜双岛画布
- 日间：双层波点草坪、水纹底浪与漂浮叶片，搭配高可读性的奶油白纸面。
- 夜间：独立绘制的星空、月光与萤火虫微光，深青侧栏配暖棕内容纸面，久看不刺眼。
- 🎫 手账质感与微交互
- 渡岛船票品牌区：
216×60奶油纸面 + 薄荷票根 + 虚线撕口，替代单调顶栏。 - 木牌与气泡容器：木质标题绶带、木牌选中态、对话气泡输入框与纸纹弹窗。
- 触感反馈：3D 奶油主按钮按压回弹、输入气泡呼吸发光、2px 内嵌薄荷键盘焦点环（滚动容器内不裁切）。
- 渡岛船票品牌区：
- 🎛️ 应用内外观设置
- 在「设置 → 插件 → 动森外观」中提供「纸白 / 均衡 / 海岛」三档预设与
0.15–0.60画布浓度滑杆，支持面板内实时分层预览。 - 支持独立开关插画装饰、纸纹质感与界面字体（内嵌 Nunito Latin 字体或系统原生字体栈），配置按客户端独立保存在本地。
- 在「设置 → 插件 → 动森外观」中提供「纸白 / 均衡 / 海岛」三档预设与
- 🛡️ 零侵入与离线自包含
- 字体（Nunito WOFF2）与原创 SVG 插画均在构建时内嵌，运行时零外部网络请求。
- 严格遵循 DSH 公开契约（覆盖 118 项 ThemeRuntime Token），不触碰私有模块或 DOM Observer，不改写其他插件的自身布局。
快速安装
1. 下载发行包
前往 GitHub Releases 下载最新版本的 .tgz 安装包与 SHA256SUMS 校验文件。
2. 安装到 DSH Web Profile
进入你的 DSH profile 目录，将依赖指向下载的 .tgz 包（确保后续 pnpm install 不会回退版本）：
cd <DSH_Profile_目录>
pnpm add file:<下载目录>/dsh-theme-animal-island-ui-<version>.tgz
安装完成后，完整重启 DSH Web 服务并刷新浏览器页面。建议同一 profile 下仅启用一个主题插件。
3. Windows 桌面端（Electron）
DSH 桌面客户端使用独立的 desktop profile，且需通过客户端内置的 Electron Node 运行时安装。完整安装、HMR 热更新与回滚命令请参阅 桌面客户端指南 (docs/desktop.md)。
如果是克隆本仓库进行本地构建体验，可直接运行一键同步脚本（同时写入 web 与 desktop profile）：
pnpm install
pnpm run install:local
开发与验证
需要 Node.js ≥ 22.13 与 pnpm 11.1.2。
pnpm install
pnpm run build # 构建客户端 bundle（lib/）
pnpm run check # 统一门禁：站点检查 + 类型 + 构建 + 契约测试 + DSH 兼容性检查
pnpm run format # Biome 代码格式化
pnpm run lint # Biome 静态检查
视觉与离屏夹具验收：
pnpm run fixture sidebar-masthead # 使用真实 DSH CSS 渲染指定夹具（产物位于 artifacts/smoke/）
pnpm run fixture boot-loading --desktop # 自动解包桌面端 app.asar 并渲染桌面夹具
pnpm run check:visual # 运行侧栏船票真实 DOM 视觉门禁
作为 NPM 包复用色板或 Token 派生逻辑时，可从独立子路径导入：
import { ANIMAL_ISLAND_PALETTES } from 'dsh-theme-animal-island-ui/palette'
import { buildTokenOverrides, contrastRatio } from 'dsh-theme-animal-island-ui/tokens'
文档索引
详细的设计规范、兼容契约与排障记录均保存在仓库文档中：
- 🎨 设计语言与样式边界 (docs/design.md)：色板规范、明暗派生、组件形状及不可越界的样式禁区
- 🔌 DSH 兼容性契约 (docs/compatibility.md)：已审阅的公开 Slot、
data-*/ ARIA 接缝清单与离屏验收夹具说明 - 🖥️ 桌面客户端指南 (docs/desktop.md)：Electron profile 隔离机制、安装/回滚、CDP/DWM 截图与远程调试
- ⚖️ Web 与桌面端差异清单 (docs/web-vs-desktop.md)：跨平台标题栏、折叠侧栏与历史适配问题归档
- 🔍 侧栏会话列表空白排查 (docs/session-list-blank.md)：DSH 侧槽位错误边界与快照问题的诊断路径
- 📊 社区主题设置项调研 (docs/research/theme-settings-survey.md)：主题配置面设计与取舍依据
- 📝 版本变更日志 (CHANGELOG.md)：各版本功能演进与修复记录
贡献与反馈
非常欢迎提交 Issue 或 Pull Request！
- 提交代码前请阅读 贡献指南 (CONTRIBUTING.md)，了解接缝契约登记、离屏夹具验证与发版流程。
- 参与社区交流请遵守 行为准则 (CODE_OF_CONDUCT.md)。
- 如发现安全隐患，请按 安全策略 (SECURITY.md) 通过私有渠道报告，勿在公开 Issue 中披露。
许可证与致谢
本项目基于 MIT License 开源发布。
- 🎨 视觉致谢：衷心感谢 @guokaigdg 创作的优秀开源组件库 animal-island-ui（MIT）！本项目深受其动森手账设计语言与精致交互节奏的启发。
- 🔤 字体许可：内嵌的 Nunito 字体遵循 SIL Open Font License 1.1。
- ⚖️ 独立实现说明：本项目基于 DeepSeek Harness 的公开扩展机制独立编码构建，未复制上游工程代码与专有资产，完整第三方声明详见 THIRD_PARTY_NOTICES.md。
赞助与支持
如果你觉得 Animal Island UI 让你的日常工作台更加舒适愉悦，欢迎支持开发者的持续创作与维护：
- ❤️ 爱发电 (Afdian)：https://ifdian.net/a/shirolin
- ☕ Ko-fi：https://ko-fi.com/shirolin
- ⭐ 也欢迎为本仓库点亮一颗 Star，或体验作者的另一个开源项目 S1er！
No comments yet. Be the first to write one.