dsh-codex-pet

把 OpenAI Codex 桌面宠物（Codex Pet）的社区皮肤自动迁移到 DeepSeek Harness（DSH），在 DSH Web 界面右下角渲染一只功能与 Codex 完全一致的桌宠：动画状态、多会话对话框、设置面板，一键迁移、即插即用。

图片来源声明：示例图中的鲸鱼娘皮肤图片来源于网络分享，仅用于演示本项目功能，版权归原作者所有；如涉及侵权，请联系作者删除。

特性

• 自动迁移 Codex 皮肤：自动扫描 CODEX_HOME（及 LOCALAPPDATA/APPDATA 下的 Codex 路径）中的社区皮肤（pet.json + spritesheet.webp），拷贝到 DSH 家目录，无需手动操作。
• 逐帧动画：完整支持 Codex 精灵表动画轨——待机、行走、挥手、跳跃、失败、等待、奔跑、审查、视线跟随，以及 v2 皮肤的双向注视。
• 状态驱动的行为：根据当前对话阶段自动切换动画与气泡——思考、使用工具、等待批准、出错、完成、睡眠（90 秒无活动后打盹）。
• 多会话对话框：每个活跃会话一个白色毛玻璃对话框，第一行加粗显示会话标题，第二行显示最新输出或状态；单击折叠、双击跳转并移除气泡、悬停显示终止按钮。
• 设置面板：DSH 设置页新增「桌宠」栏目——皮肤选择、缩放/速度滑杆、动画/随机行为/置顶/点击穿透/空闲隐藏开关、空闲动画间隔、重新扫描并迁移。
• 持久化：位置、缩放、速度与各项开关保存在 $DSH_HOME/pet.json，刷新/重启后自动恢复。
• 全部事件映射：会话启动、思考、工具执行、审批等待、错误、工作流阶段、流式输出均实时反映到桌宠。

安装

方式一：作为 profile bundle（推荐）

# 在 DSH 安装目录下（profile 名按你的实际使用，如 web）
dsh plugin --profile web add dsh-codex-pet

或手动安装：

1. 把本仓库复制到 profile 的 node_modules：

   cp -r dsh-codex-pet "$DSH_HOME/profiles/web/node_modules/"
   

2. 在 $DSH_HOME/profiles/web/package.json 的 dsh.profile.bundles 中加入 "dsh-codex-pet"，并在 dependencies 中加入 "dsh-codex-pet": "file:D:/path/to/dsh-codex-pet"。

3. 重启 DSH，桌宠出现在页面右下角；设置 → 桌宠 可调整。

方式二：动态插件（开发调试）

在 DSH 会话中通过 Cordis 工具 cordis_define / cordis_run 加载本仓库 lib/ 下的 host/client 代码（详见仓库内注释）。动态插件在 DSH 进程重启后丢失，仅用于开发调试。

前置条件

• Windows（皮肤迁移当前使用 node:fs 直接扫描，跨平台通用；Codex 皮肤目录需可读）。
• DSH 0.1.0-rc.6+（依赖 webServer、slots、timer、agents、sessionTitle 服务）。
• Codex 桌面宠物皮肤：/pets//{pet.json, spritesheet.webp}，社区皮肤可从 Codex 社区获取。

使用