dsh-ikunchick-pet
DSH 右下角常驻的「鸡你太美」篮球小鸡桌面宠物：像素帧动画（运球/招手/休息/庆祝）、拖拽吸附、贴左镜像、Q 弹按压、语音气泡与 DeepSeek 余额/今日已用。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:stitchmaps/dsh-ikunchick-pet#6c010dc2d7847c9feb06735143b7487d57e37299
Ikunchick Pet 以 dsh-ikunchick-pet 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A "鸡你太美" basketball-chick desktop pet for the DeepSeek Harness (DSH) Web GUI. It lives in the bottom-right corner of the window as a pixel-art sprite, dribbles while the agent is working, waves when you poke it, dozes off when idle — and doubles as a lightweight DeepSeek balance widget.
Built as a standard DSH bundle plugin: a tiny host half (Cordis plugin + HTTP routes) and a browser
half that renders into the root-scoped shell.overlay slot. No build tooling required at install
time; the only "build" step inlines the spritesheet into the client bundle (see Development).
shell.overlay (covers the whole frame), draggable
anywhere, remembers its position across reloads.image-rendering: pixelated keeps the pixel art crisp at any size.assets/click-*.wav and
rebuilding.ask_user_question) or
approve an action (approval/asked), the chick pops a reminder bubble (with the session name),
plays a little attention hop, and shows a pulsing ! badge until the interaction is resolved. Click
the bubble to dismiss it; it disappears automatically once you answer/approve.usage (input / cache / output) at DeepSeek
peak/off-peak pricing. Auto-dismisses after a few seconds.ledger.json (last 300 turns) so it survives restarts.¥ pill above the pet, refreshed every 60s from
https://api.deepseek.com/user/balance via the DSH credentials service (DEEPSEEK_API_KEY).
Missing key / network errors degrade gracefully — the pet still works.🐤 restore button appears at the corner).desktop profile and dsh web).DEEPSEEK_API_KEY in the DSH credentials service, to show balance.
If you signed in with a DeepSeek account instead, the plugin simply shows "balance unavailable";
it never errors.Copy this repository into the profile's node_modules and register it. The bundled script does all
three steps (copy files, add a file: dependency, append a loader row), with timestamped backups:
pwsh -File .\install.ps1
Then refresh the Web GUI (the client half loads on page load). The host half logs
[dsh-ikunchick-pet] host active · v0.1.0 to %USERPROFILE%\.dsh\logs\desktop-next.log.
Manual install (equivalent):
%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-ikunchick-pet."dsh-ikunchick-pet": "file:<abs path, forward slashes>" to the profile package.json
dependencies.cordis.patch.yml:
- insert:
- id: dsh-ikunchick-pet
name: dsh-ikunchick-pet
Note: the desktop client reads the
desktopprofile;dsh plugin --profile web add …installs into the wrong profile and nothing appears. Use the script above (or your host's plugin manager).
| Action | Result |
|---|---|
| Drag the chick | Move it; release near an edge to snap |
| Click the chick | Toggle the speech bubble (phrase + balance) |
| Right-click the chick | Open the settings menu |
| Menu → 点击音效 / Click sound | Off / Nailong laugh / 唱跳rap (picking one previews it) |
| A session waits for you | Pet auto-pops a reminder bubble + pulsing !; dismiss by click, auto-clears when resolved |
| A conversation turn finishes | Pet pops a per-turn cost bubble (¥ + tokens + model) |
| Menu → 大小 / Size | S / M / L |
| Menu → 动画 / Motion | Slow / Normal / Fast |
| Menu → 刷新余额 / Refresh balance | Force an immediate balance fetch |
| Menu → 查看账单 / View ledger | Today / 7-day / total spend, 7-day bars, recent turns |
| Menu → 回到右下角 / Back to corner | Reset position |
| Menu → 隐藏小鸡 / Hide chick | Hide; a 🐤 button stays at the corner to call it back |
%DSH_HOME%\dsh-ikunchick-pet\state.json (atomic write, normalized on the host).%DSH_HOME%\dsh-ikunchick-pet\usage.json — only a date, last observed
balance and accumulated observed drop. Recharges are ignored, never subtracted.%DSH_HOME%\dsh-ikunchick-pet\ledger.json — the last 300 settled turns
(timestamp, ¥ amount, token splits, model, session title). No messages or prompts are stored.GET /user/balance, and discarded.The spritesheet is an 8×9 grid of equal cells (assets/spritesheet.webp). Animations are simply
frame sequences of [row, col] pairs, drawn by setting the sprite element's background-position
and background-size. Current mappings:
| Animation | Frames | When |
|---|---|---|
idle | row 0 | default |
dribble | row 1 | any session running |
dribble2 | row 2 | (available variant) |
wave | row 3 | click |
raise | row 4 | run finished |
talk | row 5 | (available variant) |
rest | row 8 | idle > 65s |
dsh-ikunchick-pet/
├─ package.json # dsh.bundle.patch + dsh.client.platform
├─ cordis.patch.yml # loader insert row
├─ icon.svg
├─ lib/
│ ├─ index.js # host half: /api/dsh-ikunchick-pet/{state,balance,wait,turn,ledger}
│ ├─ client.src.js # readable browser source (sprite placeholder)
│ └─ client.js # BUILT bundle (sprite inlined) — what ships
├─ assets/spritesheet.webp # pixel art source
├─ assets/click-kun.wav # 唱跳rap篮球 click clip (SAPI-synthesized)
├─ assets/click-nailong.wav # 奶龙笑 click clip (SAPI-synthesized)
├─ scripts/build-client.mjs # inlines sprite + click clips into lib/client.js
├─ scripts/process-audio.py # trim/normalize/speed the raw SAPI clips into assets/
├─ docs/panel.png, preview-dribble.webp
├─ install.ps1
└─ README.md / README.zh.md
lib/client.src.js, then rebuild the shipped bundle:
node scripts/build-client.mjs
require('react') — it cannot load local files — so the webp and the
two click WAVs are inlined as base64 data URIs.) Refresh the GUI to pick up client changes.lib/index.js) require a patch reload (toggle the insert row) — do not restart
the whole desktop process.ctx.on('session/event', …) and tracks the
latest suspended interaction: tool/call with name: 'ask_user_question' → question,
approval/asked → approval; cleared by tool/result, other approval/*, or turn/start|end. The
browser polls POST /api/dsh-ikunchick-pet/wait (every 1.5 s) and pops the reminder on a new
pending id.assistant/message usage (inputTokens + cacheReadTokens
outputTokens) per (session, turn) and settles on turn/end using the price table at the top of
lib/index.js (PRICE_FLASH / PRICE_PRO, peak = weekday 09–12 & 14–18 Beijing). Each settled turn
bumps a persisted seq; the browser polls POST /api/dsh-ikunchick-pet/turn and pops the cost bubble
when seq changes. Subagent sessions are excluded.ledger.json (atomic rename, capped at
300). POST /api/dsh-ikunchick-pet/ledger returns the recent entries plus aggregates (today / 7-day /
all / by-model / last-7-day series), computed in Beijing time.node --check lib/index.js, node --check lib/client.js, and
node scripts/build-client.mjs.Code is MIT (see LICENSE). The pixel-art spritesheet under assets/ is distributed as-is
for running this plugin only and is not relicensed under MIT.