← 返回列表
D

@yshark/dsh-codex-pet

v0.1.1 · 0 天前发布

DSH 宠物插件：状态驱动悬浮宠物（Codex 宠物包兼容）

deepseekdshdsh-pluginpetfloating-petweb-uicordis

README

@yshark/dsh-codex-pet（DSH 宠物插件）

DSH Web 界面里的状态驱动悬浮宠物。兼容 Codex 宠物包格式（v1 + v2），
通过路径选择导入宠物包，并在 $DSH_HOME/pets/<id>/ 保存包目录。

功能

  • 状态驱动动画：空闲 / 思考中 / 执行工具 / 等待审批 / 等待回答 / 计划审查 / 子代理工作中 / 出错 / 待查看

  • 多会话：跨顶层会话跟踪、按优先级单点展示、活动托盘（点击切换会话）

  • 宠物包：Codex v1/v2 格式解析、PNG/WebP 图集、社区 animations 与

    • interactions.click 扩展
  • 导入：选择本地宠物包目录，校验并复制到 DSH 宠物库

  • 记忆：选中宠物、唤醒状态、拖拽位置、缩放比例存 $DSH_HOME/pet-state.json

  • 缩放：设置页可调整宠物显示大小（50%–200%）

  • 点击技能：按包声明顺序循环播放

  • 设置页：宠物控制入口（唤醒/隐藏、选择、导入）

    • 架构

  • 宿主半：lib/index.mjs

    • - 监听 agent/status、agent/error、tools/execute、approval/request、
    subagent/start|end
    - 每个顶层会话一个状态机，按 sessionId 路由，切页互不串状态
    - 提供 /pet/rpc/<method> JSON RPC，含 activities 与 syncSessions
  • 客户端半：lib/client.js

    • - window.__ModuleLoader__ 工厂，由 window.__DSH_BOOT__ 注入
    - `shell.ov

    版本兼容矩阵

    DSH 版本状态说明
    dsh@0.1.0-rc.6 ✅ 兼容 cordis patch ✅
    dsh@0.1.0 ✅ 兼容 标准 patch ✅
    dsh@0.2.0 ⚠️ 待验证 待实测（API 可能在变）
    dsh@0.3.0+ ❓ 未知 尚未发布

    💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

    元数据

    License
    MIT
    npm
    @yshark/dsh-codex-pet
    Repo
    —
    Engines
    {}
    Weekly DL
    0
    Monthly DL
    0
    dsh.bundle
    {"bundle":{"patch":"./cordis.patch.yml"},"client":{"platform":"web","inject":["@deepseek-ai/dsh-client-runtime"],"immediately":true}}