remielle-dsh
小蕾米(Remielle)桌寵的 DeepSeek Harness plugin 移植版:把桌面寵物變成 DSH 插件,直接監聽 DSH 的 session 事件流,即時驅動寵物動作。
> 本插件是 jackuh105/Remielle(二次開發自 HanaAyane/remielle-codex-pet)的 DSH 移植。 > 素材版權與使用限制見 [NOTICE.md](./NOTICE.md) 與 [ASSET-USAGE.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.sectionslot),即時生效
架構
session/event ──▶ server 端 session projection ──▶ browser subscribe ──▶ 動作對映 ──▶ GIF/PNG
(事件 → phase 狀態機) (ObservableSnapshot)- server 端(
lib/index.js):remiellesession projection(純函式狀態機:working / waiting / celebrate / failed / idle)+ 素材 HTTP route(/plugins/remielle-dsh/assets/) - client 端(
lib/client.js):命令式 DOM 寵物 widget(掛在document.body)+ React 設定子頁面(settings.sectionslot) - 期待超時、彩蛋節奏等時間性行為在瀏覽器端執行;事件事實由 server 投影提供
安裝
本插件以 DSH bundle 包形式安裝到 profile:
1. 將插件裝入 web profile:
``bash dsh plugin --profile web add /path/to/remielle-dsh-plugin ``
(或在 profile 目錄直接 pnpm add -w file:/path/to/remielle-dsh-plugin)
2. 在 profile 的 package.json 的 dsh.profile.bundles 中加入 "remielle-dsh"(建議放在 @deepseek-ai/dsh-web-app 之前)。
3. 重啟 dsh web(plugin 集合變更需要重啟生效)。
4. 開發時注意: - pnpm 對 file: 依賴是複製快照,每次改插件原始碼後需在 profile 目錄重新 pnpm install; - 套件的 exports 必須包含 "./package.json"(DSH 掃描 dsh.client 宣告時需要)。
設定
| 設定 | 預設 | 說明 |
|---|---|---|
| 顯示小蕾米 | 開 | 顯示/隱藏寵物 |
| Harness 動畫回應 | 開 | 是否回應 DSH 事件切換動作 |
| 期待超時(秒) | 300 | 工作結束後「期待」動畫的持續時間 |
| 行動間隔最短/最長(秒) | 2 / 6 | 待機時兩次隨機行動的間隔範圍 |
| 彩蛋機率 | 40% | 待機行動中表演彩蛋的機率 |
| 慶祝冷卻(秒) | 30 | 慶祝/失敗動作的最小間隔 |
素材與授權
- 插件程式碼:Apache-2.0(見 [LICENSE](./LICENSE))
- 動畫素材(
assets/):基於《絕區零》公開素材,經 AI 輔助重繪與人工整理;僅限非商業同人交流,詳見 [NOTICE.md](./NOTICE.md) 與 [ASSET-USAGE.md](./ASSET-USAGE.md)。
素材作者:HanaAyane / 小蕾米 來源:https://github.com/HanaAyane/remielle-codex-pet
參考專案
- jackuh105/Remielle — 本插件移植的來源(二次開發版,含 OpenCode / Codex harness 整合)
- HanaAyane/remielle-codex-pet — 原始桌寵專案