使用

Web 应用组合包将该包作为一个 Cordis 插件加载。小深和阿良都无需 Codex Desktop 即可使用；没有已持久化选择时会使用小深。打开设置 → 宠物即可启用或隐藏浮层、选择其他可用预设或导入宠物、在 80 到 224 个 CSS 像素之间设置宽度，或在修改 Codex home 下的文件后刷新目录。浮层始终位于浏览器视口内；当前页面可用指针拖动或方向键调整其位置。

宠物把 DSH 活动映射到 Codex 图集中的空闲、运行、等待用户输入、所选会话失败和已完成输出待查看等行。悬停和拖动使用兼容的跳跃与左右奔跑行。浏览器要求减少动态效果时，宠物会停在一帧，而不循环播放图集。

配置

该 Cordis 插件接受两个 Host 资源发现配置键：

配置键	默认值	行为
`codexHome`	`$CODEX_HOME`，随后为 `~/.codex`	包含现代 `pets/` 与旧版 `avatars/` 宠物包的目录。Host 会展开 `~`。显式配置的路径不存在或不是目录时，插件启动会失败。
`appAsarPath`	按平台发现	指向 Codex Desktop `app.asar` 的显式路径，用于读取内置图集。显式配置的归档不可读或格式错误时，插件启动会失败，而不是隐藏配置错误。

按平台发现时，macOS 检查 /Applications/ChatGPT.app/Contents/Resources/app.asar，Windows 检查 %LOCALAPPDATA%\Programs\ChatGPT\resources\app.asar。其他平台需要用 appAsarPath 启用 Codex 预设，但没有该配置也仍可使用小深、阿良和 Codex home 中的自定义宠物包。

- id: dsh-pet
  config:
    codexHome: ~/.codex
    appAsarPath: /Applications/ChatGPT.app/Contents/Resources/app.asar

dsh-pet settings namespace 独立于这些 Host 路径存储浏览器偏好：

设置项	默认值	行为
`enabled`	`true`	显示或隐藏 Web 框架内浮层。
`selectedId`	`dsh`	选择小深（`dsh`）、可选的包内阿良（`aliang`）、Codex 预设 id，或发现时分配的不透明 `custom:` id。
`size`	`112`	以 CSS 像素表示的精灵宽度，校验范围为 80 到 224。

常规本地 settings 提供方把这些字段持久化到 $DSH_HOME/settings.yaml。回环浏览器可通过 Host settings API 写入这些值并读取本机宠物目录；远程浏览器的 authority 会从宠物目录与资源路由收到 403，因为这些响应投影了 Host 本机文件。

@deepseek-ai/dsh-pet

AI 分析

インストール

ドキュメント

使用

配置