READMESource: main@df10b6fd
🐱 泡泡猫的奇幻之境主题 · dsh-client-ui-paopaocat
为 DeepSeek Harness Web 界面打造的奇幻之境主题皮肤:月光下的冥界森林,彼岸花在脚下盛开,流云在头顶缓慢漂移,一只睡着的小猫趴在角落,小鱼在界面里游动。
适配版本 — DSH
0.1.5-rc.1

奇幻之境视觉
一片被月光泡透的森林,青绿色的流云缓缓翻涌,绯红的彼岸花从屏幕左下角蔓延上来,一只白色毛绒小猫在右下角安然入睡——界面不再是容器,而是泡泡猫的梦境现场。
| 元素 | 说明 |
|---|---|
| 🌸 彼岸花 | 左下角成簇的绯红石蒜,花瓣细长舒展,是全主题最强的视觉锚点 |
| ☁️ 流云 | 青绿色烟雾状云层持续翻涌流动,撑起整个画面的纵深感 |
| 🌙 月光 | 画面顶部的冷白光晕,为森林提供唯一光源 |
| 😺 睡着的小猫 | 右下角趴卧的白色毛绒猫,随主题呼吸般微微起伏 |
| 🐟 小鱼 | 侧边栏与装饰层中的卡通小鱼,游动点缀 |
| ⭐ 星光 | 细碎光点漂浮,密度可调 |
双风格一键切换
设置面板顶部「风格」分段控件,淡雅 / 蓝色 实时切换:
- 淡雅:极淡冰蓝白底(
#F5F9FC → #FFFFFF),玻璃近乎透明,装饰极克制 —— 宁静、留白、高字体反差 - 蓝色:饱和蓝白流体(
#87CEEB → #F0F8FF → #E0F7FA),猫爪、泡泡、小鱼、星光装饰饱满 —— 活泼、有存在感

特性
- WebGL2 流体背景:三色渐变 + 噪声 + 漩涡 + 鼠标交互,色调与深浅可调
- 自由背景:流体,或壁纸(内置一张默认壁纸,也可自定义图片/视频;含模糊、磨砂、亮度调节)
- 品牌装饰:猫爪印、小鱼、彩色泡泡、星光、趴卧小猫剪影
- 双模式:云母效果把布局改成悬浮玻璃卡片;兼容模式保持原版排版,只换材质
- 中/英文字体自定义
- 一键开关:关闭即完全还原原生界面,不改 DSH 任何一行源码

🎵 背景音乐
主题内置唯美背景音乐,可边写代码边听。
- 内置 3 首曲目(随包内置,开箱即听):
004雾中谜语、测试、泡泡猫 - 支持上传自己的音乐:设置面板选择任意本地音频文件(
audio/*),存入浏览器 IndexedDB,可随时删除 - 完整播放控制:上一首 / 播放暂停 / 下一首 / 音量,列表循环播放
用户上传的音乐只保存在本机浏览器中,不会随插件分发。
安装
dsh plugin --profile web add dsh-client-ui-paopaocat
刷新 Web 界面即可。关闭开关回到原生界面。
本地开发安装
git clone https://github.com/zmm863-commits/dsh-client-ui-paopaocat
cd dsh-client-ui-paopaocat
npm install
npm run build # tsdown + ModuleLoader 包装 + smoke test
dsh plugin --profile web add "$(pwd)"
设置项
| 分组 | 控件 |
|---|---|
| 总开关 | 开启 / 关闭 |
| 风格 | 淡雅 / 蓝色 |
| 模式 | 云母效果 / 兼容模式 |
| 玻璃材质 | 模糊度 0–40px · 磨砂度 0–100% · 代码块磨砂度 0–100% |
| 背景 | 流体 / 壁纸;流体含色调 0–360° 与深浅 0–100%;壁纸支持图片与视频 |
| 环境装饰 | 猫角色 · 小鱼 · 星光 |
| 悬停效果 | 鼠标辉光 · 悬停下压 |
| 背景音乐 | 内置 3 首 · 上传自己的音乐 · 上一首/播放/下一首 · 音量 |
| 字体 | 英文字体 · 中文字体 |
架构
src/
├── index.ts Host 半边(空实现,纯客户端主题)
└── client/
├── index.ts 入口:locale 注册 + settings.section 挂载
├── ppc-layer.ts 核心层:生命周期 / CSS 变量 / 流体 / 场景 / 辉光
├── ppc-preset.ts 双风格参数(淡雅 / 蓝色)
├── ppc-fluid-shader.ts WebGL2 流体着色器
├── ppc-fluid-tones.ts HSL 调色板生成
├── ppc-ambient-scene.ts 装饰场景组装
├── ppc-brand-assets.ts 猫爪 / 小鱼 / 泡泡 / 星光 / 猫角色 SVG
├── ppc-music.ts 背景音乐播放器(内置曲目 + 用户上传)
├── ppc-settings-row.tsx 设置面板 UI
└── ppc.css.ts 全局样式(属性 gating)
技术要点:
- 全部样式经
[data-ppc]属性 gating,卸载即还原 - 客户端 bundle 为单文件 CJS,由
build.mjs包装为window.__ModuleLoader__.load({ id, factory }) - React 通过 factory 的
require获取,无动态 import - 内置音乐由
build.mjs在构建期转为 data URL 注入,运行时无需额外请求 npm run build内置 headless smoke test,失败即构建失败
素材来源
- 奇幻之境背景壁纸:由 Agnes 图像 API(
agnes-image-2.1-flash)生成,月光森林 + 彼岸花 + 白虎斑猫主题 - 猫爪、小鱼、泡泡、星光、趴卧小猫:本插件自绘的内联 SVG(跟随主题色)
- 内置背景音乐:作者原创曲目
许可
MIT
No comments yet. Be the first to write one.