Frieren桌宠
A chibi Frieren desktop pet for the DeepSeek Harness Web GUI
(dsh --profile web).
Idles beside your workspace · waves on its own · jumps when clicked · draggable · remembers where you left it.
Install
One command. The plugin installs into the web profile as a standard
dsh bundle (the same
mechanism the bundled dsh web surfaces use):
dsh plugin --profile web add github:dakeshui123/dsh-pet-frieren
Then (re)start the GUI and Frieren is there:
dsh --profile web
- Update:
dsh plugin --profile web update dsh-pet-frieren - Pin a release:
dsh plugin --profile web add github:dakeshui123/dsh-pet-frieren#v0.1.0 - Remove:
dsh plugin --profile web remove dsh-pet-frieren - Install from git directly:
dsh plugin --profile web add git+https://github.com/dakeshui123/dsh-pet-frieren.git
The plugin ships its client bundle prebuilt (no
prepare/build step), so it installs cleanly with any pnpm version — noallowBuildsfiddling required.
Interactions
| Action | Effect |
|---|---|
| (nothing) | Idle animation loop |
| Wait 12–30 s | Waves at you on its own |
| Click | Jump |
| Drag | Move the pet (position is remembered) |
| Double-click | Hide / show the pet |
prefers-reduced-motion is respected: the pet sits still (no auto wave)
while the OS accessibility setting is on.
How it works
A dsh plugin is an npm package that declares dsh.bundle.patch (a
cordis.patch.yml profile layer) plus a dsh.client browser half:
dsh-pet-frieren/
├── package.json dsh.bundle.patch → cordis.patch.yml;
│ dsh.client { platform: "web" } → exports["./client"]
├── cordis.patch.yml inserts the plugin's own row into the web profile
├── lib/index.js node half: empty apply (the row's presence is the point)
├── lib/client.js browser half: the pet overlay (prebuilt bundle)
├── pet.json petdex-format pet manifest
└── spritesheet.webp petdex v1 atlas: 8×9 grid of 192×208 px frames
At boot, the dsh client-modules node half scans the profile's Loader
entries for dsh.client packages, serves /plugins/dsh-pet-frieren/client.js,
and injects the boot graph into the page. The browser Loader then materializes
the bundle and calls its apply(ctx), which mounts the pet — a
self-contained DOM overlay animated with requestAnimationFrame against the
embedded atlas (no React, no host services, no inject edges).
The sprite is embedded in the bundle as a base64 data URL because the plugin route serves the client bundle only (no generic asset route).
Development
lib/client.js is a hand-written bundle in the exact
window.__ModuleLoader__.load shape the dsh web module system consumes, so no
build step is needed to ship. The embedded sprite is generated from the
canonical lossless spritesheet.webp:
python scripts/build-assets.py # requires cwebp on PATH
Pet format
This repository root is also a valid Petdex-format pet
folder (pet.json + spritesheet.webp), so the same art can be submitted to
the Petdex gallery (npx petdex submit .). Frame counts used by the
animations match the populated cells of the atlas:
| row | state | frames |
|---|---|---|
| 0 | idle | 6 |
| 1 | running-right | 8 |
| 2 | running-left | 8 |
| 3 | waving | 4 |
| 4 | jumping | 5 |
| 5 | failed | 8 |
| 6 | waiting | 6 |
| 7 | running | 6 |
| 8 | review | 6 |
License & IP
Code and this fan-art arrangement: MIT. "Frieren" is a character from Frieren: Beyond Journey's End (葬送のフリーレン) by Kanehito Yamada and Tsukasa Abe; the artwork here is personal, non-commercial fan art. See LICENSE for the full note.
中文
在 DeepSeek Harness 网页版（dsh --profile web）里养一只 Q 版芙莉莲桌宠：
发呆循环、偶尔朝你挥手、点击会跳、可拖拽、位置会被记住。
安装（一条命令）：
dsh plugin --profile web add github:dakeshui123/dsh-pet-frieren
然后启动 dsh --profile web 即可看到芙莉莲。卸载：
dsh plugin --profile web remove dsh-pet-frieren。
角色版权说明：芙莉莲出自山田钟人原作、阿部司作画的《葬送的芙莉莲》， 本仓库素材为个人非商用同人作品，详见 LICENSE。
No comments yet. Be the first to write one.