codex-to-dsh-pet
精选清单收录维护状态: 活跃signalight/codex-to-dsh-pet
Convert Codex desktop pets (spritesheet atlases) into DeepSeek Harness (DSH) web-GUI pets — zero-dependency renderer, drag/wave/jump interactions, live activity poses & progress bubbles. 把 Codex 桌宠移植为 DSH 网页桌宠的通用框架
$ dsh plugin add codex-to-dsh-pet5
星标
3
Fork
JavaScript
语言
MIT
许可证
2026-08-15
创建于
2026-10-23
最近推送
README
🌐 中文 · English
codex-to-dsh-pet

把 Codex 桌宠(spritesheet 图集)移植为 DeepSeek Harness(DSH)网页 GUI 桌宠的通用框架 / 适配器。 本项目系通过DSH编写,有问题和报错还请指正,我们会不断调试。
- 零依赖的核心渲染器(纯 DOM,无构建步骤)
- 开箱即用的交互:拖拽(按方向奔跑)、悬停挥手、双击跳跃、眼睛跟随鼠标(请注意,只有 Codex 桌宠 v2 版本(11 行动作图片)才支持;运行时插件可在设置里关闭)
- 实时响应 agent 活动状态,切换姿势
- 工作时头顶弹出进度气泡(工具名 / 流式文本 / "思考中…")
- 可选定期总结:用所选 LLM 汇总模型请求进展,并带每个会话的总结记录面板(默认关闭)
- 完成 / 错误 / 中断三类场景提示音,可试听、可上传自定义音频
- 逐行尺寸归一化,修正某些图集里姿势大小不一致的问题
⚠️ 本框架(构建脚本)不内置第三方桌宠素材。随附的运行时插件内置一只 示例桌宠
nastya(娜斯佳,原创角色,CC BY-NC 4.0),仅用于演示。 内置场景提示音由贡献者用 Qwen3-TTS 生成、按 MIT 许可证提供,与示例角色分离 (角色图集仍为 CC BY-NC 4.0);详见 LEGAL.md。
推荐:运行时插件(装一次 + 图形界面导入)
packages/dsh-codex-pet 是一个运行时插件——装一次,之后在 DSH 设置里点按钮导入
.webp 图集即可,不用再跑命令行。支持换宠、大小、位置、气泡颜色/透明度、
鼠标视觉追踪(仅 v2 图集,默认开启,可关闭),并内置
一只示例桌宠 nastya(娜斯佳,原创角色,CC BY-NC)。
🧭 桌宠跑到屏幕外回不来? 改分辨率后如果桌宠停在看不见的地方,打开 设置 → 桌宠 → 还原 Reset,点 「还原位置」 它就会回到所选角落; 点 「还原全部设定」 则把位置、大小、显示、鼠标追踪、气泡、定期总结和提示音 一次性恢复默认(宠物选择与已导入的文件、自定义提示音会保留)。 桌宠在屏幕内时,也可以右键点它选 「还原位置」。
安装(仅一次,任选其一):
方式 A —— 一条命令(需要 pnpm):
# 从 npm
dsh plugin --profile web add @signalight/dsh-codex-pet
# 或直接从 GitHub
dsh plugin --profile web add github:Signalight/codex-to-dsh-pet#path:/packages/dsh-codex-pet
方式 B —— 脚本(无需 pnpm): 在解压出的 codex-to-dsh-pet 文件夹里打开 PowerShell(空白处 Shift + 右键 → 在此处打开 PowerShell),运行:
.\install-runtime.ps1
装完后:DSH 会热加载 cordis.patch.yml,直接浏览器硬刷新 http://127.0.0.1:3080(Ctrl+Shift+R)即可;若仍未出现,再完全退出并重启 DSH 桌面应用(命令行版则重启 dsh web)。
⚠️ 避免「重复 loader entry」导致 cordis 卡死:同一个插件只选一种方式装一次 (方式 A 或 方式 B 二选一,别混用)。本仓库的
install-runtime.ps1/install-to-dsh.ps1幂等且自带去重——重复安装只保留恰好一条- insert:条目,绝不会叠加,并会自动归并历史残留的重复行。若你之前同时用过「手动脚本」和「
dsh market/dsh plugin add」两种方式,cordis.patch.yml里就可能出现同一条- insert:两次(DSH 启动会卡住): 重新跑一次install-runtime.ps1即可自动归并回一条,然后浏览器硬刷新 (Ctrl+Shift+R),并按需要完全重启 DSH 桌面应用。想手动核对:打开
~/.dsh/profiles/web/cordis.patch.yml(桌面版为%APPDATA%\io.github.hairyf.deepseek-harness-desktop\data\dsh\profiles\web\cordis.patch.yml), 每个插件只应有一条- insert:。注意select-pet.ps1只管理「旧式每宠插件」, 运行时插件(如@signalight/dsh-codex-pet)由「设置 → 桌宠」管理,不会也不应由它改动。
之后加桌宠(全图形界面): 打开 设置 → 桌宠,点 导入桌宠,选一张 .webp
图集即可(可输入中文名,宠物 id 自动取自文件名;id 重复时自动加 -2/-3 后缀,
不会覆盖之前导入的桌宠)。详见
packages/dsh-codex-pet/README.md。
📢 给早期用户:如果你之前用下面「旧方法」给每只桌宠单独装过插件,它们仍然 有效,不会失效。想换到新方式:先跑一次上面的
install-runtime.ps1装上运行时 插件,之后新桌宠都用「设置 → 桌宠 → 导入」添加;旧的每宠插件可保留,也可先用.\select-pet.ps1停用,再手动删除profiles\node_modules\<宠物名>及补丁里的对应行。
旧方法:每宠构建一个插件(build.js)
安装步骤(零基础,照着做就行)
开始前需要两样:① 电脑装了 Node.js(运行 node 用);② 已经装好、能跑起来的 DeepSeek Harness(DSH)。
第 1 步:拿到代码
- 点仓库页绿色 Code → Download ZIP,下载后解压,得到一个
codex-to-dsh-pet文件夹; - 或命令行克隆:
git clone https://github.com/Signalight/codex-to-dsh-pet.git
第 2 步:打开 PowerShell(位置要对)
- 用文件资源管理器进入解压出来的
codex-to-dsh-pet文件夹; - 在文件夹空白处,按住 Shift 键 + 鼠标右键;
- 菜单里选 "在此处打开 PowerShell 窗口"(Windows 11 可能是"在终端中打开",一样)。
窗口里光标前面显示着 ...\codex-to-dsh-pet,就说明位置对了。
第 3 步:放图集
把桌宠图集(.webp 图片)改名成你想叫的宠物名(如 nastya.webp),拖进 codex-to-dsh-pet 文件夹。
第 4 步:运行两条命令
在 PowerShell 窗口里依次输入下面两条,每条输完按 Enter:
node build.js
.\install-to-dsh.ps1
看到 Done. 就成功了。
第 5 步:刷新生效
DSH 会热加载 cordis.patch.yml,直接在浏览器硬刷新 http://127.0.0.1:3080(Ctrl+Shift+R),桌宠就出现在右下角了 🎉(桌面应用无需重启;若仍未出现,完全退出并重启桌面应用;命令行版则重启 dsh web。)
常见报错:
- 出现「禁止运行脚本」→ 先输入
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned回车(选Y),再重跑第 4 步。- 出现「
node不是内部或外部命令」→ 还没装 Node.js,去 nodejs.org 装一下。- 装了多个桌宠后想切换,用
.\select-pet.ps1(见下文)。
1. 准备素材
把一张 Codex 桌宠的 spritesheet 命名成你的宠物名(如 fluffy.webp)放进本目录。
插件名会自动取自这个文件名——一张图集 = 一个插件。
2. 配置(可选)
name / label 不用填(自动从图集文件名推导)。只有需要改尺寸、归一化、
气泡文案等时才建 config.json:
Copy-Item config.example.json config.json
config.json 字段(name/label 可省略,缺省取图集文件名):
| 字段 | 说明 | 默认 |
|---|---|---|
name |
插件名(也是 node_modules 目录名 / 注册名) | 图集文件名 |
label |
悬浮层里显示的标签 | 图集文件名 |
spritesheetPath |
图集相对路径 | 自动检测 |
spriteVersionNumber |
图集版本:1(8×9)或 2(8×11,含注视帧) |
自动检测(按图集尺寸 1872/2288) |
size |
显示宽度 px | 120 |
pin |
初始位置(bottom-right / bottom-left / …) |
bottom-right |
normalize |
可选:逐行尺寸归一化 [null, …, { s, cx, cy }, …] |
无 |
look.enabled |
是否开启「眼睛跟随鼠标」;旧版桌宠(无注视帧)设为 false |
true |
look.deadzone |
注视死区(px,指针距桌宠中心小于该值不触发) | 28 |
bubble.enabled |
是否显示进度气泡 | true |
bubble.maxChars |
流式文本截取长度 | 140 |
bubble.runningText |
工具运行时文案({tool} 会被替换成工具名) |
运行中:{tool}… |
bubble.workingText |
工作但无工具名时的文案 | 工作中… |
bubble.thinkingText |
思考时的文案 | 思考中… |
💡 版本自动识别:build.js 会按图集尺寸自动判断 v1/v2——高 1872px = v1 (9 行,无注视帧,自动关闭鼠标追踪),高 2288px = v2(11 行,含 16 方向注视帧, 自动开启鼠标追踪)。所以一般不需要手动设
spriteVersionNumber;只有当你的图集 不是标准尺寸时,才需要在config.json里显式指定。
3. 构建
node build.js
会自动检测图集、从文件名推导宠物名,生成自包含的 lib/client.js 和
config.effective.json。
只想构建指定的一张图集时,可以用一步命令(写 config.json + 跑 build.js):
.\build-pet.ps1 nastya # 名字与图集文件名一致
.\build-pet.ps1 nastya -NodePath C:\path\to\node.exe # 指定 node 路径(一般不用)
构建后可以运行冒烟测试验证产物:
node verify-bundle.cjs
4. 安装到 DSH
.\install-to-dsh.ps1
脚本会自动定位 DSH home,复制插件到 <DSH home>/profiles/node_modules/<name>,
并注册到 <DSH home>/profiles/web/cordis.patch.yml(幂等、自动备份)。
更多「纯属好玩」插件
dsh-pet
作者 pc2005-cloud
DSH 桌面宠物:一行命令装好即用的透明动画小桌宠,支持多开、大小位置随心配置;还内置 DIY 素材链,能用 AI 视频自造专属宠物
dsh-tavern
作者 flizzywine
基于DSH的Agent酒馆。类酒馆文字游戏Agent。兼容SillyTavern生态,人物卡直接导入就能玩。更快、更稳、更鲜活。所有模型都能用。手机也能玩。
dsh-dafeiyu
作者 qcytsn
DeepSeek Harness 的桌面原生大飞鱼陪伴插件,实时展示智能体状态,Windows 上置顶显示。
dsh-meme
作者 yyh-001
DeepSeek Harness 表情包插件:输入框一键发图、文字 token 斗图、情绪主动发图、AI 自动学图,图库市场一键安装。 · Meme/sticker plugin for DeepSeek Harness: one-click picker in the composer, text-token memes, mood-driven sending, AI learns your images, marketplace packs.
