前言¶
在 DeepSeek Harness（DSH）里长时间跑任务时，界面往往只有日志和工具调用状态，缺少一个固定在桌面、能反映当前会话阶段的视觉锚点。社区里已有把 Codex 图集转成桌宠的做法，但若每次都要自己找素材、校验格式、手动打包，成本偏高。下面介绍维护者 Matthew-Laplace 发布的 dsh-ark-pet：在 DSH 里提供桌宠渲染，内置明日方舟干员与皮肤的目录（按需从上游下载 Codex v2 图集），也支持导入本地 Codex 图集或普通图片，并按思考、调工具、等待确认等状态切换动作。
这是什么¶
dsh-ark-pet 是 DSH 的桌宠类插件，分类为「趣味换装」。它不把干员美术打进安装包，只维护一份固定上游版本的目录（486 位干员与皮肤），选中后从上游仓库拉取对应 Codex v2 图集、逐文件校验 Git blob 哈希再写入本地；你也可以跳过库，直接导入符合尺寸要求的 Codex 图集或 PNG / WebP / GIF。渲染逻辑改编自 Signalight/codex-to-dsh-pet（MIT，固定 commit d41f0121552f837c36a9cc7fbcb073881f391616），本插件新增干员库、哈希校验下载、普通图导入与会话级活动状态聚合。插件以 MIT 许可发布，当前 package 版本为 0.1.0。
核心功能¶
干员素材库（按需下载）¶
内置目录记录干员名称、标识符与 Git 文件哈希，不包含任何明日方舟图片或转换脚本。在设置里选定干员后，插件从固定上游 revision 下载该干员的 Codex v2 图集，逐个校验 blob 哈希后安装到数据目录 ${DSH_HOME:-~/.dsh}/ark-pet。下载拒绝重定向，且安装前会拒绝符号链接与越界路径。
导入自己的图片¶
支持两类来源：
- Codex 图集：分辨率必须正好为 1536×1872 或 1536×2288。
- 普通图片：PNG、WebP 或 GIF，单张不超过 8 MiB；服务端只做头部解析、不解码，动画图片会被拒绝。
内置的 Rookie 机器人与插件图标为本项目原创（MIT）。导入图片的权利归使用者自行负责。
状态联动与互动¶
桌宠会随 DSH 会话阶段切换表现：思考、调用工具、等待你确认、完成、出错各对应不同动作；等待确认时会显示气泡。交互包括拖动改位置、悬停挥手、双击跳跃；对 v2 图集可选开启鼠标视线跟随。上述选项与尺寸、停靠位置、显示、状态气泡等，集中在同一设置页调整。
安装与启用¶
安装命令以 README 为准。--profile 填你实际使用的 DSH 形态：桌面应用为 desktop，dsh web 为 web。
dsh plugin --profile desktop add github:Matthew-Laplace/dsh-ark-pet
装完后需要重启 DSH（桌面版需完全退出再打开，不是刷新页面）。GitHub Releases 提供预构建包 dsh-ark-pet-0.1.0.tgz；pnpm 11.9 及以上可直接装该 tarball，pnpm 11.0–11.8 对裸 tarball 链接可能报 ERR_PNPM_MISSING_TARBALL_INTEGRITY，建议仍用上面的 GitHub 路径安装。
开发与测试环境为 DSH 0.2.0-rc.2、Node.js >= 22.19；插件通过 @deepseek-ai/dsh* 的 peerDependencies 参与版本判定。安装前请自行查看仓库源码与 LICENSE、NOTICE.md，插件以当前 dsh 进程权限运行。
典型用法¶
经过上面的安装与重启，按 README 中的步骤即可配置桌宠：
- 打开 设置 → 方舟桌宠。
- 在「干员素材库」里勾选权利说明，搜索干员，点选后开始下载。
- 或使用「导入自己的图片」添加本地文件。
- 在同一页调整尺寸、停靠位置、显示、视线跟随与状态气泡。
素材权利与安全边界¶
明日方舟角色与美术权利属于鹰角网络及相关权利人。上游 lockon-n/Arknights-Codex-Pets 明确不授予再分发或商业使用权；公开链接与下载确认都不产生授权，使用前请自行确认合规方式。本插件与鹰角网络、OpenAI、DeepSeek 均无官方或授权关系。
HTTP 接口挂在 /ark-pet/ 前缀下。写操作要求请求头 x-dsh-ark-pet: 1；在未装 connection 服务时，路由使用本地同源闸门（Host 须为回环地址、拒绝跨站 Sec-Fetch-Site、Origin 与 Host 同源），装了 connection 服务时使用其 requestRejection。
适用场景与注意¶
适合希望在 DSH 桌面或 Web 载体上放置桌宠、且愿意自行承担素材来源与版权合规的开发者。若你只需要固定一套自制图，「导入自己的图片」即可；若希望从社区整理的干员 Codex 目录按需取用，可走干员素材库路径，但务必阅读 README 中的「素材与权利」一节。
DSH 生态强调「一切皆插件」；社区目录页（SkillHub 插件条目）是独立站点，并非 DeepSeek 或幻方官方应用商店。更多细节与 issue 见仓库：github.com/Matthew-Laplace/dsh-ark-pet。
