PetDex 桌面伙伴多模态状态机与伴侣系统
@crafter-station/petdex · v1.1.2
为桌面智能体与陪伴型机器人注入生动个性的多模态状态机。提供细腻的情绪能量数值演进、交互触发式动画状态流转、个性化语音音色包挂载与桌面悬浮微应用。
虚拟伴侣情绪状态机Live2D桌面悬浮窗
GitHub Stars
23 K+
+12.4% this month
月度调用量
88 K+
Monthly registry pulls
Reach 影响力
97.6/ 100
Top Tier Ecosystem
运行环境
Cordis v3+
Node 18+ / Bun / Deno
安装与配置
支持 CLI 一键执行、包管理器以及 Cordis 总线编排
bash
manager:
$ pnpm add @crafter-station/petdex架构解析
「PetDex Companion」将冷冰冰的生产力工具转变为富有生命力的桌面助手。传统的智能体只有在收到指令时才会给出机械的回应，缺乏情感温度与拟人化的动态互动。
本扩展在 Cordis 架构中建立了一个连续的情绪动力学模型（Pleasure-Arousal-Dominance 空间）。智能体可以根据用户的使用频率、编程任务的进展甚至外界天气，动态改变自身的心情与待机动作。支持通过轻量悬浮窗展示生动的像素/Live2D 动画，并在开发者遭遇连环 Bug 沮丧时主动发送暖心鼓励，打造有温度的技术陪伴体验。
架构设计原则与约束
01
强类型契约隔离
基于 TypeScript 编译期深度推断，跨插件总线调用享受严格类型校验与零偏差提示。
02
毫秒级热插拔调度
支持微内核动态注册与安全平滑卸载，无需重启主宿主进程即可完成逻辑热替换。
03
确定性有限状态机
内置严谨的多阶段任务生命周期控制，防止复杂长时迭代推理场景中会话状态丢失。
04
零动态构建底层依赖
采用纯原生跨平台运行时环境设计，在 Node.js、Bun 及 Deno 容器中极速冷启动。
核心特性
01
连续三维情感动力学空间：告别死板的条件分支，情绪变化细腻平滑且不可预测
02
多端轻量化悬浮窗组件：开箱即用支持 Windows、macOS 与 Linux 桌面原生渲染
03
丰富的 Live2D/像素皮肤库：支持开发者自由导入自定义角色立绘与骨骼动画资产
04
久坐与护眼健康关怀：根据开发者实际键盘敲击时长智能提醒休息与喝水
核心机制
01
情境交互事件监听
监听开发者操作流（如代码测试通过、编译失败、长时间伏案等）。
02
情绪状态向量演化
在三维 PAD 空间中实时计算愉悦度、激活度与主导度数值变动。
03
动态行为与姿态匹配
根据当前情绪匹配对应的待机动作、面部表情与动作音效。
04
多模态拟人反馈
在桌面悬浮窗中渲染生动微动画，并按需播放温暖的个性化提示语音。
配置参数参考 (YAML / JSON)
| 参数名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| companionPersonality | string | cheerful | 伴侣初始性格基调 (cheerful / calm / tsundere / witty) |
| enableVoiceAudio | boolean | true | 是否开启语音合成音效与问候播放 |
| overlayOpacity | number | 0.95 | 桌面悬浮窗默认显示透明度 (0.1 - 1.0) |
应用场景
企业级生产智能体运行时
依托微内核生命周期与容错状态机，保障企业复杂 Agent 全天候稳定执行不崩溃。
基准测试标准化评测运行
深度原生集成 SWE-bench 标准流程，自动化抓取代码变更并产出规范复现指标。
全自主代码工程重构演进
精准拆解模型思考流与具体操作，跨多文件自主排查并高质量完成大型模块重构。
跨系统多工具流协同自动化
在多进程沙箱间安全并发调度事件，打通研发上下游系统实现端到端自动化流转。
最佳实践
01
权限沙箱隔离机制
严格限定子进程系统调用与外部网络范围，在生产环境中建议结合 Docker 独立容器执行。
02
配置指数退避重试
针对上游模型接口限流与偶发网络抖动，建议开启自适应退避重试并设定最大执行上限。
03
长时任务状态快照
利用内核事件总线快照功能实时固化会话节点，发生不可抗意外时支持秒级断点恢复。
04
全量结构化链路追踪
开启全量 Trace 日志输出，将大模型思考过程与具体工具入参返回值集中汇聚至监控。
常见问题
Q1:长时间执行任务超时如何正确配置？
可在配置文件中调大 timeout 阈值，并通过生命周期钩子定期向总线派发心跳信号。针对长耗时推理与工具调用，建议配合持久化会话快照机制，在任务暂停或重启后无缝恢复执行上下文，避免会话被内核提前回收。
Q2:如何捕获并流式解析模型思考过程？
框架原生提供流式回调机制，会话状态机自动拦截并剥离大模型的 <think> 思考标签。开发者只需监听 onThink 事件即可实时获取推理增量，结合前端流式渲染呈现动效，并支持将完整推导链沉淀至审计日志。
Q3:多个插件依赖冲突时如何按需加载？
Cordis 微内核基于有向无环图进行拓扑排序并解析依赖树。当插件间存在同名服务或版本冲突时，可通过命名空间隔离机制按需挂载；结合上下文注入与惰性初始化技术，仅在工具唤起时动态加载资源，保障系统稳定。
Q4:生产环境中如何实施权限与沙箱隔离？
推荐结合容器沙箱与细粒度权限管控，严密禁止插件越权访问敏感文件与未授权外部网络。可通过微内核提供的权限白名单机制严格限制系统调用，并将工具执行环境置于隔离容器内，彻底阻断潜在的代码注入与提权安全风险。
相关生态插件推荐
为你推荐同分类及高度协同的 Cordis 扩展
protocols46 K+
DSH Web Workshop 可视化调试画板与工作台
为开发者提供直观监控与交互调试环境的轻量级 Web 工作台。提供可视化会话时间轴、实时工具调用跟踪、状态机图谱呈现与即时变量注入修改功能。
View details
protocols34 K+
iPolloWork 人机协同研发工作台与断点治理器
专为企业级全自主编程智能体设计的人机交互治理工作台。提供生产代码合并审查、关键环境变更一键确认、沙箱交互式 Web 终端与多分支执行断点恢复能力。
View details
protocols32 K+
Better Sidebar 智能侧边栏与工作区层级导航器
为复杂项目工作区提供极速目录树检索、多会话分屏管理与符号语义导览的高级侧边栏扩展。支持大仓数十万文件瞬时展开、多标签页状态保持与即时过滤定位。
View details