前言¶
在 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。
