mengyun233/dsh-codex-pet

Name: mengyun233/dsh-codex-pet
Author: mengyun233

Desktop桌面端 Native原生 ⭐ 8 Pets & Fun桌宠与娱乐 Migration & Compatibility迁移与兼容 Sessions & Context会话与上下文

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

catalog descriptioncatalog 简介 / catalog description：将 Codex 桌宠皮肤自动迁移到 DeepSeek Harness，在 DSH Web 界面渲染功能一致的桌宠：动画、多会话对话框、设置面板，一键迁移即插即用。

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a native plugin built exclusively for DeepSeek Harness (DSH) that ports the popular Codex Pet desktop pet experience from OpenAI Codex to DSH. It automatically scans for existing Codex community pet skins in the CODEX_HOME directory and migrates them without manual steps, fully supporting all original frame-by-frame animations and state-driven behaviors from the original Codex Pet. The pet renders in the bottom-right corner of the DSH web interface, and users can also opt to run it as a standalone Electron desktop app that works completely separate from the DSH web browser.

This plugin is designed for DSH users who want a fun interactive pet that also visualizes the current agent status. After installation, the pet automatically switches animations and status bubbles based on the active DSH session’s current phase. When multiple sessions run in parallel, each session gets its own dedicated bubble, which can be collapsed with a click or used to jump directly to the session with a double-click. You can drag the pet to reposition it anywhere on the screen, click it to trigger random interactions, and all your settings are automatically persisted so they load correctly after a DSH restart.

The plugin is released under the MIT license, and the recommended installation method is as a DSH profile bundle installed directly from the git source. Note that there is an unrelated package of the same name on npm, so you must avoid installing it from npm to prevent getting the wrong plugin. You need DSH version 0.1.0-rc.6 or newer to run this plugin, and if you want to use the standalone desktop mode you will need to install the Electron dependency first. All configuration is stored in the $DSH_HOME/pet.json file, and the standalone desktop window position is saved separately in pet.desktop.json.

这是一个专为DeepSeek Harness（DSH）开发的原生插件，用于将OpenAI Codex桌面宠物（Codex Pet）的功能和社区皮肤迁移到DSH中。它可以自动扫描并迁移现有Codex路径下的社区皮肤，完整支持原Codex宠物的所有逐帧动画和状态行为，会在DSH网页界面右下角渲染出桌宠，同时还提供可选的独立Electron桌面模式，可脱离浏览器运行在系统桌面上。

适合喜欢桌宠互动、希望在使用DSH时获得状态可视化反馈的用户使用。安装后桌宠会根据DSH当前会话的不同阶段自动切换动画和状态气泡，多会话并行时每个会话对应一个独立气泡，支持点击折叠、双击跳转会话。你可以拖动桌宠改变位置，点击触发随机互动，所有设置会自动持久化保存，重启后自动恢复。

项目遵循MIT许可证，推荐以profile bundle方式通过git源安装，注意npm上存在同名无关包，请勿从npm安装。要求DSH版本不低于0.1.0-rc.6，主要支持Windows平台，皮肤迁移依赖已存在的Codex社区皮肤。独立桌面模式需要额外安装Electron依赖，所有配置保存在$DSH_HOME/pet.json中。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-codex-pet（mengyun233/dsh-codex-pet）
仓库：https://github.com/mengyun233/dsh-codex-pet
本站详情页：https://www.yhbd.top/plugins/mengyun233-dsh-codex-pet/
本站登记：类型 client · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 8 · 最近提交 2026-08-17 · 主语言 JavaScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 3 warnings3 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
Only 8 stars - very few users, little community feedback星标只有 8，几乎没人在用，遇到问题缺少社区反馈
Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端：安装会下载可执行文件，请核对发布者与校验和

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:mengyun233/dsh-codex-pet

把 mengyun233/dsh-codex-pet 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

7.9 KB · 缓存于 2026-08-23 03:41:48 · 7.9 KB

dsh-codex-pet

pet

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

特性

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

安装

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

⚠️ 注意包名冲突：dsh-codex-pet 在 npm 上已被另一个同名桌宠插件占用（skr311/dsh-codex-pet，路由 /api/pets/*，与本仓库无关）。本仓库没有发布到 npm，请务必使用下面的 git 源安装，否则会装到错误插件。

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

git 源安装会自动把 dsh-codex-pet 加入 profile 的 dsh.profile.bundles，重启 DSH 后生效。

或手动安装（不使用 dsh plugin 时）：

把本仓库复制到 profile 的 node_modules：

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

在 $DSH_HOME/profiles/web/package.json 的 dsh.profile.bundles 中加入 "dsh-codex-pet"，并在 dependencies 中加入 "dsh-codex-pet": "file:D:/path/to/dsh-codex-pet"。
重启 DSH，桌宠出现在页面右下角；设置 → 桌宠可调整。

方式二：独立桌面应用（脱离网页，桌面上动）

桌宠也可以脱离浏览器，作为独立的透明置顶窗口显示在桌面上（需要已通过方式一迁移好皮肤）：

cd desktop
npm install        # 首次需要（安装 Electron）
npm start          # 启动桌面桌宠

功能：透明无边框置顶窗口（不占任务栏）、拖拽移动（位置自动保存到 $DSH_HOME/pet.desktop.json）、右键菜单（随机散步/摸摸/置顶/点击穿透/重新扫描/退出）、随 DSH agent 状态实时变化、多会话对话框。DSH 未运行时桌宠保持待机动画。

与网页设置联动：桌面窗口以 $DSH_HOME/pet.json 的 codexPet 为主配置源，网页设置面板（设置 → 桌宠）里的皮肤、缩放、速度、动画开关、随机行为、空闲动画间隔、置顶、点击穿透、空闲隐藏实时同步生效（每 1.5s 轮询）；桌面右键菜单的置顶/穿透切换也会写回共享配置，两种模式始终一致。桌面窗口位置单独保存在 pet.desktop.json，不受网页位置影响。

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

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 mengyun233/dsh-codex-pet 的 README.md。在 GitHub 查看原文 →