
PetDex Virtual Companion & Emotion State Machine
A multimodal emotion state machine and companion engine for DeepSeek Harness. Delivers dynamic mood vectors, stateful animation hooks, customizable TTS voicepacks, and desktop floating widgets.
Virtual-Pet · Companion · Emotion-FSM · Desktop-Widget
$ pnpm add @crafter-station/petdexArchitecture
Core Features
Continuous PAD Emotional Engine: Smooth, organic mood transitions rather than rigid static states
Lightweight Native Desktop Overlays: Runs with minimal memory on macOS, Windows, and Linux
Live2D & Pixel Art Sprite Support: Easily import custom avatar skins and skeletal animations
Ergonomic Health Reminders: Prompts engineers to hydrate and stretch during prolonged focus sessions
Core Workflow
Context Event Ingestion
Monitors IDE events such as test passes, compiler errors, and marathon coding stretches.
Emotional State Update
Calculates transitions across Pleasure, Arousal, and Dominance emotional dimensions.
Behavior & Stance Trigger
Maps active emotional vectors to sprite animation sequences and sound effects.
Multimodal Expression
Renders responsive desktop animations and dispatches synthesized supportive voice lines.
Configuration Parameters Reference (YAML / JSON)
| Parameter | Type | Default | Description |
|---|---|---|---|
| companionPersonality | string | cheerful | Base companion personality persona |
| enableVoiceAudio | boolean | true | Enable synthesized TTS voice prompts |
| overlayOpacity | number | 0.95 | Desktop floating overlay window opacity |
Recommended Plugins
DSH Pet Interactive Desktop Companion & AI Status Pet
dsh-pet is an open-source transparent desktop pet companion for DeepSeek Harness. Synchronizing in real-time with AI agent states, it triggers reactive animations and speech bubbles during model reasoning, tool execution, code writing, or errors. Features multi-pet displays, physics dragging, customizable scaling, and DIY sprite pack pipelines.
DSH Web Workshop Visual Canvas & Agent Workbench
A real-time developer workbench and visual debugging canvas for DeepSeek Harness. Features live agent trajectory playback, tool call tracing, state inspection, and live variable manipulation.
iPolloWork Human-in-the-Loop Workbench & Governance Hub
An enterprise Human-in-the-Loop (HITL) developer workbench for DeepSeek Harness. Features interactive code diff review, approval gates for critical commands, and web terminal management.