fykuang02/furina-desk-pet

芙宁娜卡通大头桌宠 · Furina Desk Pet

为 DeepSeek Harness Web GUI 制作的可移植客户端插件：一只漂浮在页面上的
卡通大头芙宁娜桌宠，带点击特效与好感度系统。

纯展示层客户端插件：不注入任何服务、不发 Cordis 事件、不触碰模型请求；
卸载即还原（所有 DOM / CSS 写入都由 Cordis effect 销毁器收回）。

⚠️ 版权与免责声明：本插件的芙宁娜图片素材系发布者从网络公开资源
收集，无法核实其原始版权归属；本项目不涉及任何商业行为，
仅作学习与同好分享。如相关素材存在侵权，请联系发布者
（提交 GitHub Issue 或联系仓库维护者），将立即删除相关内容。
素材来源明细见 NOTICE.md。

✨ 特性

- 点击特效：点击芙宁娜会弹跳 + 迸发爱心粒子 + “+1” 飘字 + 随机台词气泡；
约 8% 概率触发金色暴击（好感度 +3）。
- 好感度系统：宠物下方常驻好感度条（❤ 数值 + 等级名 + 进度），
点击即可涨好感度，随等级成长并触发升级庆祝：
初识 → 相识 → 熟悉 → 亲密 → 挚友 → 水神的宠儿。
- 可拖拽：按住芙宁娜拖动到任意位置（拖拽时切换惊讶表情），位置按
视口百分比持久化，窗口缩放自动钳制在可视区内。
- 右键菜单：重置好感度（二次确认）/ 收起·展开好感条 / 暂时隐藏
（右下角“芙”按钮唤回）。
- 本地持久化：好感度、位置、紧凑模式写入 localStorage
（键 dsh-furina-desk-pet.v1），刷新页面 / 跨标签页自动同步。
- 零运行时依赖：两张透明 chibi 表情以 data URI 内联进 bundle，
不依赖任何外部图片 URL 或资源服务器。
- 支持键盘（Tab 聚焦后 Enter/空格 摸摸头）、prefers-reduced-motion 降级。

🖼 插图预览

插件内置的两张透明 chibi 表情（构建时以 data URI 内联进 bundle，
运行时不依赖任何外部图片；下方引用的是仓库内 assets/source/ 原始文件，
GitHub 会直接渲染仓库内相对路径的图片）：

开心 · 常驻表情 / 点击时

惊讶 · 拖拽时 / 升级庆祝时

🚀 安装（移植到任意 DeepSeek Harness）

插件遵循 dsh 官方插件形态（dsh.bundle + dsh.client 双面声明），
可安装到任意一个 profile（下例为 web）。

方式一：自己一条命令搞定（推荐）

dsh plugin --profile web add "github:fykuang02/furina-desk-pet"

然后重启 web 界面（dsh web）并刷新浏览器页面即可。

方式二：让你的 DeepSeek Harness 帮你安装

如果你是 DeepSeek Harness 用户但不想自己敲命令，直接把下面这段话发给
你自己的 harness（Chat 或 Web 界面里的 AI 助手），它会自己完成
克隆、安装与验证：

请帮我安装 GitHub 上的芙宁娜桌宠插件（仓库 fykuang02/furina-desk-pet）
到我的 dsh web 界面：克隆该仓库，然后用
dsh plugin --profile web add 或等效方式装进 web profile 并让它生效。
如果本机无法直连 GitHub，请按你环境里的网络方案（镜像/代理）克隆。

方式三：克隆后本地链接

git clone https://github.com/fykuang02/furina-desk-pet.git
dsh plugin --profile web add link:"/furina-desk-pet"

只想下载源码（不安装插件）

git clone https://github.com/fykuang02/furina-desk-pet.git
或直接下载 ZIP：
https://github.com/fykuang02/furina-desk-pet/archive/refs/heads/main.zip

说明：dsh plugin add 本质是向 profile 的 pnpm 依赖里加入本包；
本包通过 dsh.bundle.patch（cordis.patch.yml）自动把客户端条目
furina-desk-pet 插入插件花名册，因此安装即生效，卸载即还原。

热更新（不重启 dsh，适用于已经跑着的实例）

如果 dsh web 已经在本机运行、不想重启进程：把本包用 junction/符号链接
挂进 profile 的 node_modules（例如
/profiles/web/node_modules/@dsh-external/dsh-client-ui-furina-desk-pet），
然后在 /profiles/web/cordis.patch.yml 末尾追加：

- insert:
- id: furina-desk-pet
name: '@dsh-external/dsh-client-ui-furina-desk-pet'

profile 的补丁层由 Cordis HMR 监听，保存后数秒内生效，刷新浏览器即可。
（注意：这种方式与“方式 A/B”二选一，不要叠加使用，避免条目重复。）

卸载

dsh plugin --profile web remove "@dsh-external/dsh-client-ui-furina-desk-pet"

🖱 使用说明

| 操作 | 效果 |
| --- | --- |
| 单击芙宁娜 | 好感度 +1（暴击 +3）、爱心粒子、弹跳、台词气泡 |
| 按住拖动 | 移动位置（惊讶表情），松手记住位置 |
| 右键 | 打开菜单：重置好感度 / 收起好感条 / 暂时隐藏 |
| 连续点击 | 每次点击都涨好感度（粒子特效有 250ms 节流防刷屏） |

🖼 独立预览（无需 dsh）

直接用浏览器打开 preview/demo.html 即可体验（preview/pet-standalone.js
由构建脚本生成，内置模块加载协议的模拟层）。

🛠 开发与构建

零依赖构建链，不需要 npm install：

node build/build.mjs   # 生成 lib/client.js、lib/index.js、preview/pet-standalone.js
node tests/smoke.mjs   # Node 冒烟测试（自带极简 DOM shim，37 项断言）

- 桌宠全部逻辑在 src/client/index.js（原生 JS，无框架、无导入）。
- 换表情图：替换 assets/source/furina-happy.webp / furina-shocked.webp
后重新构建即可（建议 300×300 以上、透明背景的方形 webp/png）。
- 改台词、等级阈值、暴击率：编辑 src/client/index.js 顶部的常量表。

📁 目录结构

furina-desk-pet/
├── package.json          # dsh.bundle.patch + dsh.client 声明
├── cordis.patch.yml      # 把客户端条目插入插件花名册
├── src/
│   ├── index.js          # 主机侧入口（无行为）
│   └── client/index.js   # 桌宠全部客户端逻辑
├── build/build.mjs       # 零依赖构建脚本（内联素材 + 包装 bundle）
├── lib/                  # 构建产物（client.js / index.js，随仓库分发）
├── assets/source/        # 原始素材（透明 chibi 表情）
├── preview/              # 独立演示页（demo.html）
└── tests/                # 冒烟测试 + 极简 DOM shim

⚖ 许可与版权

- 插件代码：MIT License（见 LICENSE）。
- 素材（assets/source/ 两张 chibi 表情）：系从网络公开资源收集
（原神维基 Genshin Impact Wiki），发布者不确定其原始版权归属；
来源与链接详见 NOTICE.md。角色“芙宁娜”及其形象版权归
© miHoYo / HoYoverse 所有。
- 本项目是非商业同人分享，不进行任何商业行为；请勿将本仓库用于商业用途。
- 如相关素材存在侵权，请联系发布者（提交 GitHub Issue 或联系仓库维护者），
发布者收到通知后将立即删除相关内容。