remielle-dsh
小蕾米（Remielle）桌寵的 DeepSeek Harness plugin 移植版：把桌面寵物變成 DSH 插件，直接監聽 DSH 的 session 事件流，即時驅動寵物動作。
本插件是 jackuh105/Remielle（二次開發自 HanaAyane/remielle-codex-pet）的 DSH 移植。
素材版權與使用限制見 NOTICE.md 與 ASSET-USAGE.md。
功能
-
浮動桌寵：透明 GIF 動畫、拖曳（位置記憶於 localStorage）、點擊表演慶祝
-
Harness 整合：監聽 DSH session 事件流，即時切換動作：
| DSH 事件 | 動作 |
|---|
turn/start、step/start、tool/call | 工作中 |
turn/end (completed) | 慶祝 |
turn/end (error) | 失敗 |
approval/asked、turn/end (blocked) | 等待確認 |
| 工作結束後 | 期待 →（超時後）鋼筆待機 |
-
待機行為：行動間隔隨機（2~6 秒可調）、彩蛋表演（40% 機率可調、8 動作池、可連續）、自由移動（視窗內走動、邊緣反彈）
-
右鍵選單：表演動作（8 種）、自由移動開關、隱藏/顯示
-
設定子頁面：DSH Settings 側邊的「Remielle 桌寵」分頁（settings.section slot），即時生效
架構
session/event ──▶ server 端 session projection ──▶ browser subscribe ──▶ 動作對映 ──▶ GIF/PNG
（事件 → phase 狀態機） （ObservableSnapshot）
- server 端（
lib/index.js）：remielle session projection（純函式狀態機：working / waiting / celebrate / failed / idle）+ 素材 HTTP route（/plugins/remielle-dsh/assets/）
- client 端（
lib/client.js）：命令式 DOM 寵物 widget（掛在 document.body）+ React 設定子頁面（settings.section slot）
- 期待超時、彩蛋節奏等時間性行為在瀏覽器端執行；事件事實由 server 投影提供
安裝
本插件以 DSH bundle 包形式安裝到 profile：
-
將插件裝入 web profile：
dsh plugin --profile web add /path/to/remielle-dsh-plugin
（或在 profile 目錄直接 pnpm add -w file:/path/to/remielle-dsh-plugin）
-
在 profile 的 package.json 的 dsh.profile.bundles 中加入 "remielle-dsh"（建議放在 @deepseek-ai/dsh-web-app 之前）。
-
重啟 dsh web（plugin 集合變更需要重啟生效）。
-
開發時注意：
- pnpm 對
file: 依賴是複製快照，每次改插件原始碼後需在 profile 目錄重新 pnpm install；
- 套件的
exports 必須包含 "./package.json"（DSH 掃描 dsh.client 宣告時需要）。
設定
| 設定 | 預設 | 說明 |
|---|
| 顯示小蕾米 | 開 | 顯示/隱藏寵物 |
| Harness 動畫回應 | 開 | 是否回應 DSH 事件切換動作 |
| 期待超時（秒） | 300 | 工作結束後「期待」動畫的持續時間 |
| 行動間隔最短/最長（秒） | 2 / 6 | 待機時兩次隨機行動的間隔範圍 |
| 彩蛋機率 | 40% | 待機行動中表演彩蛋的機率 |
| 慶祝冷卻（秒） | 30 | 慶祝/失敗動作的最小間隔 |
素材與授權
素材作者：HanaAyane / 小蕾米
來源：https://github.com/HanaAyane/remielle-codex-pet
參考專案
