@nkj/dsh-ui-pet
一个跟随指针的 Canvas 精灵表宠物，渲染在 dsh Web 的 shell.overlay 插槽中。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Nkjv2/dsh-ui-pet#038a6d232225b9705f1e2b034fbb91103aeac149Ui Pet 以 @nkj/dsh-ui-pet 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A canvas pet for the DeepSeek Harness web GUI. It follows the pointer and is styled as a subtle background decoration in the shell.overlay layer: position:fixed (no layout impact), fully click-through (pointer-events:none), a low z-index (below other overlay entries and dialogs), and < 1 opacity so the page content shows through — visible without covering or blocking the real UI. v1 is presentation-only (pointer follow) with a procedurally-drawn vector mascot; a later version reacts to session / agent activity.
The package is a dsh bundle (dsh.bundle → cordis.patch.yml) that is also a client plugin (dsh.client). Installing it into a profile with dsh plugin --profile web add <pkg> auto-registers it (the CLI reconciles installed dependencies that declare dsh.bundle into dsh.profile.bundles), then the client module system serves /plugins/@nkj/dsh-ui-pet/client.js on the next boot. No manual cordis.yml edit.
# once: install build deps
pnpm install
# build both artifacts (lib/index.js host half + lib/client.js browser bundle)
pnpm run build
# iterate: rebuild the browser bundle on source change (the dsh host stat-polls
# the served bundle and broadcasts a reload, so the browser refreshes on write)
pnpm exec tsdown --watch
dsh plugin --profile web add /absolute/path/to/dsh-ui-pet
pnpm dsh web # bind http://127.0.0.1:3080
In the browser at http://127.0.0.1:3080, confirm:
dsh --profile web --dump-config contains the ui-pet row./plugins/@nkj/dsh-ui-pet/client.js (200); or curl http://127.0.0.1:3080/plugins/@nkj/dsh-ui-pet/client.js.<canvas> is inside the shell.overlay layer, position:fixed, pointer-events:none, low z-index, and opacity < 1. Move the pointer; the pet follows it, and the page content remains visible through the semi-transparent pet (it never blocks or covers the UI).pointer-events:none).While SPRITE is empty in src/client/sprite.ts, the pet draws a colorful placeholder blob, so step 4 is verifiable without any asset.
pnpm run build
npm pack # confirm lib/, cordis.patch.yml, and src are in the tarball
npm publish --access public
After publishing, a user installs it with:
dsh plugin --profile web add @nkj/dsh-ui-pet
SPRITE (asset path or URL) and tune FRAME_COLS/FRAME_ROWS/FRAME_W/FRAME_H/FPS in src/client/sprite.ts. Set SIZE/scale in src/client/Pet.tsx to match.None. The pet manages browser-only presentation; nothing reaches a model request.
None; this package neither assembles nor sends a provider request.
Runtime-compatible with dsh 0.1.1-rc.2 (the web profile). The host dsh install supplies the runtime react, @deepseek-ai/cordis, and the slots service.
The published package is intentionally build-dependency-free: the source uses no @deepseek-ai/* imports (the DSH-specific types are left structural/untyped), so the standalone build needs only react + tsdown + typescript. The DSH integration is by convention: apply receives a ctx with a slots service, and the bundle is the standard window.__ModuleLoader__.load closure factory.
shell.overlay slot provides.shell.overlay floating layer, so it paints above the app content (it is deliberately semi-transparent and small so it does not obscure it). Rendering it genuinely behind the content is impossible from a plugin without DSH source changes: the conversation/details/sidebar surfaces are opaque and would fully cover a behind-content canvas.ctx / slot types are structural and untyped to keep the standalone build self-contained. When developing inside the dsh monorepo, restore the real ClientContext / PropsRuntime<'shell.overlay'> types for full checking.clientBundle preset; iterate against a live dsh web to confirm exact output.