獨立繁體中文 README

deepseek娘 DeepSeek Harness 桌寵

一個給 DeepSeek Harness Web UI 使用的開源 Cordis 桌寵外掛。她會待在介面右下角，依照目前 Session 狀態切換動畫，也會用 16 個方向跟著滑鼠看。

實際在 DeepSeek Harness 中使用的畫面：

這是社群製作的非官方外掛，不會修改 Session 資料、對話記錄或 DeepSeek Harness 核心原始碼。

功能

• DeepSeek Harness 原生 Cordis 外掛與 shell.overlay 擴充槽
• 待機時拿著簡體「区」的板子，對話框文字維持「凶」
• Harness 執行任務時切換至工作動畫
• Session 等待互動時切換至等待動畫
• 完整 16 方向滑鼠追視，每 22.5 度一格
• 滑鼠停止 1.1 秒後回到拿板子的待機動畫
• 點擊桌寵可在一般與放大尺寸間切換
• 支援 prefers-reduced-motion
• Codex pet v2 圖集：1536 × 2288 WebP、8 × 11、每格 192 × 208

相容性

0.2.0 起改用 dsh-client-ui-renderer／dsh-client-ui-session 取得 slots 與 Session 狀態，並改讀獨立的 useSessionPendingInteraction snapshot——官方在 0.1.2-alpha.1 移除了舊的 dsh-client-runtime 套件，並把 pending interaction 從 session summary 移到獨立的 snapshot map。

桌寵與其他 web profile 外掛可以同時安裝。已用官方 cordis-plugin-include 對 dsh-base + dsh-web-app + @linxin666/dsh-web-all（dsh-web 全家桶）+ 本外掛 + dsh-plugin-verified-search 的五層疊層做過組合驗證：169 個 entries、零重複 id、零缺漏、零警告；dsh-web 各套件的 HTTP 路由也與本外掛的 spritesheet 路由無碰撞。

注意：dsh-web 內建桌寵（@linxin666/dsh-pet）預設出現在右下角（可拖曳、可在「Web 插件 → 桌寵」設定隱藏），與本桌寵的預設位置會有視覺重叠；兩者 API 層互不衝突，擇一顯示或拖開即可。

固定版本下載

0.2.0 TGZ 與 SHA-256 · 重現、驗證與還原

安裝

一行安裝

dsh plugin --profile web add github:f0909172434/dsh-deepseek-girl-pet#v0.2.0

安裝後重新啟動 Harness：

# 先在原本執行 dsh web 的視窗按 Ctrl+C，確認 3080 已停止，再執行：
dsh web

如果看到 EADDRINUSE: address already in use 127.0.0.1:3080，代表舊的 Harness 還在執行，不是安裝失敗。請先回到原本的 Harness 終端按 Ctrl+C，再重新執行 dsh web；最後在瀏覽器按 Ctrl+F5 強制重新載入。

安裝時出現 Issues with peer dependencies found，需查看列出的套件與版本，不能假定警告與本外掛無關。Done 只表示套件管理步驟完成；先用下列指令確認設定，再檢查實際畫面與狀態切換：

dsh --profile web --dump-config | Select-String deepseek-girl-pet

然後開啟 http://127.0.0.1:3080/。

從原始碼安裝

git clone https://github.com/f0909172434/dsh-deepseek-girl-pet.git
cd dsh-deepseek-girl-pet
npm pack
dsh plugin --profile web add .\dsh-deepseek-girl-pet-0.2.0.tgz

狀態映射

外掛直接讀取 Harness 的官方狀態來源——useSessions 的 Session summary（待機／工作）與 useSessionPendingInteraction 的等待互動 snapshot（等待）——不會用脆弱的 DOM 文字掃描猜測狀態。

技術方式

• Host plugin 只在 /deepseek-girl-pet/spritesheet.webp 提供固定 WebP 圖集
• Client plugin 只註冊 shell.overlay slot
• 不修改 DeepSeek Harness 核心檔案
• 不讀取或寫入對話內容
• 不依賴外部 CDN 或追蹤服務

驗證

新增的封裝校驗與 CI 範圍見 RELEASE.md。以下圖集與宿主畫面是既有紀錄，沒有因包裝更新而重新宣稱為新的宿主實測。

• node --check lib/index.js
• node --check lib/client.js
• Hatch Pet deterministic v2 atlas validation：PASS
• 圖集 SHA-256：234F24A97C18195A00C6093DA0090773E675993C169E92E7E13A24C37B323FA2
• DeepSeek Harness 首頁、client module 與 spritesheet route：HTTP 200

授權與聲明

本專案採用 MIT License。

這是社群製作的非官方專案，與 DeepSeek、OpenAI 或 Codex 沒有從屬、合作或背書關係。DeepSeek、Codex 與相關名稱及標誌仍屬其各自權利人所有。

共用圖集來源

圖集的唯一維護來源是 Codex pet 的 pet/spritesheet.webp。本套件保留經 hash 核對的副本，執行時不下載圖集；host adapter 與安裝入口各自保留。完整 commit、路徑、SHA-256 與大小在 atlas-source.json。

npm run atlas:check
node scripts/sync-atlas.mjs --source ../deepseek-girl-codex-pet
# 或從 manifest 指定的完整 commit 下載（需要網路）：
node scripts/sync-atlas.mjs --download
npm test

更新圖集時，先在 Codex 來源完成 QA，再明確更新 manifest 的 commit/hash/大小與 SHA256SUMS，同步後跑測試。舊的 v0.2.0 release 保留原始 bytes；目前 main 的來源追蹤工具不代表新的 host 功能版本。