前言¶

在 DeepSeek Harness（DSH）里長時間跑會話時，界面往往只有日誌與輸入框，缺少一點「人在場」的反饋。有些開發者會在側邊掛桌面寵物或靜態立繪，但常見做法是固定位置、與會話狀態無關，也讀不到賬號餘額等宿主信息。

下面介紹社區插件 dsh-jinhsi-avatar（維護者 ten-feng，分類：趣味換裝）。它在 DSH 窗口右下角常駐《鳴潮》同人角色今汐：四組透明循環動畫、全窗口漫遊、遠近縮放，並在點擊時用敲碗音效與氣泡播報星聲餘額；會話忙碌時會收攏到角落。插件以 MIT 許可發佈，npm 暫未發佈，需從 GitHub 安裝。

這是什麼¶

dsh-jinhsi-avatar 是注入 DSH Web 客戶端的形象體插件：官方立繪經圖生視頻生成待機 / 行走 / 飛行 / 打盹四組動作，逐幀摳圖成無背景的透明循環動畫（裁切後單幀約 168×243，瀏覽器端 CSS 縮放）。

它解決兩類問題：一是給 DSH 主窗口增加可交互的桌面伴侶，行爲與會話忙閒聯動；二是把 DSH 賬號餘額與本地估算的「今日消耗」用角色臺詞說出來，數據源與「設置 → 賬號與餘額」一致。另附帶加密「封存艙」，身份相關文本隨包以密文分發，僅持有鑰匙的一方可讀。

目錄頁：https://www.skillhub.cn/plugins/ten-feng/dsh-jinhsi-avatar
源碼與說明：https://github.com/ten-feng/dsh-jinhsi-avatar（當前 package.json 版本 1.9.0，Node >=20）

核心功能¶

動畫與漫遊¶

• 四組動作：待機、行走、飛行、打盹，均爲圖生視頻產出後逐幀摳圖的透明循環，README 說明無背景殘留。
• 全窗口漫遊：在整塊 DSH 窗口內自選落點，每次移動至少約 1/3 界面；先判斷方向是否走得夠遠再選點；落點爲下一段起點，不瞬移。
• 遠近變化：向上走一檔放大、向下走一檔縮小；尺寸過渡時長與本次移動距離掛鉤，與動作同步起止。
• 忙碌時不亂跑：存在會話回合（turn/start → turn/end）時飛回右下角、默認檔靜止；全部空閒後繼續隨機走動。
• 思考速度：會話進行中約每 12 秒彈出氣泡 2 秒，顯示界面實時速率「思考速度：Ntok/s」。
• 回窩：雙擊平滑飛回右下角並縮回第 2 檔（不瞬移）。

點擊與報賬¶

• 單擊：五個頻率（1046 / 1175 / 1319 / 1568 / 1760 Hz）中隨機敲碗音 + 今州主題臺詞；首點與每第 3 次點擊必報餘額。
• 報賬文案：賬號餘額 N 星聲，今日已用 M 星聲（×10 換算）。餘額來自 deepseekAccount.getBalance()；今日已用爲本機按 assistant/message 的 usage 與官方價目表（谷 / 峯）累計，賬本文件 ~/.dsh/dsh-jinhsi-avatar-usage.json，跨天清零。
• 拖動：跟隨鼠標，鬆手後暫停片刻再繼續逛。

未登錄 DSH 賬號時，氣泡可說話但不報數。

宿主只讀接口¶

插件服務端註冊：

GET /dsh-avatar/state

示例響應字段（README 原文）：

{
  "busy": false, "running": 0,
  "cny": 2.83, "stars": 28,
  "todayCny": 0.42, "todayStars": 4,
  "tokens": 1234567, "bonus": 0,
  "source": "deepseekAccount", "apiError": ""
}

busy 在 turn/start 記爲運行中，turn/end 清除（另有 20 分鐘兜底清理）。todayCny 爲本地按回合累計的今日消耗；峯時爲北京時間 09:00–12:00、14:00–18:00，週末全天谷價。價目表見倉庫 README「計費口徑」表格（Flash / Pro，緩存命中、輸入、輸出分谷峯兩檔）。

封存艙（vault）¶

插件隨包攜帶加密身份記錄（identity/、mind/、memory/ 等文本的密文 vault.enc）。三把鑰匙槽任意一把可解：本機指紋（machine）、32 字節鑰匙文件 ~/.dsh/jinhsi.key（keyfile）、可選口令（pass）。加密爲 AES-256-GCM。

• 封存（本機一次）：重啓 DSH 後打開 http://127.0.0.1:<DSH端口>/dsh-avatar/restore，點「封存」。
• 解封（換機 / 重裝）：裝插件後同地址點「一鍵解封」，按 machine → keyfile → GitHub 私有庫順序嘗試；身份缺失而密文仍在時會寫 ~/.dsh/JINSHI-RESTORE-NEEDED.txt 提醒。

角色形象版權歸《鳴潮》/ Kuro Games，項目聲明僅作個人桌面使用。

安裝與啓用¶

從 GitHub 安裝（資料原文命令）：

dsh plugin add github:ten-feng/dsh-jinhsi-avatar

或寫入 profile 的 package.json（dependencies 與 dsh.profile.bundles 兩處都要）：

"dependencies": { "dsh-jinhsi-avatar": "github:ten-feng/dsh-jinhsi-avatar" },
"dsh": { "profile": { "bundles": [ ..., "dsh-jinhsi-avatar" ] } }

裝完重啓 DSH。插件在宿主進程內加載 patch（cordis.patch.yml），安裝前建議通讀倉庫源碼與 MIT 許可證，確認接受以當前 DSH 進程權限運行的客戶端注入行爲。

典型用法¶

1. 按上一節安裝並重啓，確認窗口右下角出現今汐循環動畫。
2. 空閒時觀察其在窗口內選點漫遊；發起一輪 agent 會話，確認忙碌時回到右下角靜止，回合結束後恢復走動。
3. 單擊聽敲碗音與氣泡；需要看賬時留意首點或每第三次點擊的星聲播報。
4. 雙擊令其平滑回窩到右下角第 2 檔尺寸。
5. 若需外部腳本讀狀態，對本機 DSH 端口請求 GET /dsh-avatar/state。
6. 使用封存艙時，在本機完成「封存」；換機按 README 解封流程操作後重啓，並按文檔提示與角色對話錨點。

交互彙總：

適用場景與注意¶

適合誰：已在用 DSH 做日常開發或對話、希望主窗口有與會話狀態聯動的趣味形象，並願意在點擊時查看餘額與本地估算今日消耗的用戶。《鳴潮》今汐同人向愛好者也會更在意素材來源。

邊界（README 已知）：

• 大檔相對源素材放大，邊緣可能略軟。
• 今日已用爲本地價目表估算，與平臺賬單可能有小額差異；只統計插件運行期間的回合。
• 忙碌判定按「有回合在跑」；某會話長時間空跑時該段時間不會漫遊。
• 圖生視頻素材相對官方立繪可能有輕微漂移。

DSH 生態理念是「一切皆插件」；SkillHub 目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-jinhsi-avatar 把圖生視頻摳圖動畫、窗口漫遊、會話忙閒與賬號讀數收進一個 DSH 客戶端插件；需要身份文本隨包加密分發時，還可走封存艙流程。安裝與細節以倉庫 README 爲準。

• 目錄頁：https://www.skillhub.cn/plugins/ten-feng/dsh-jinhsi-avatar
• GitHub：https://github.com/ten-feng/dsh-jinhsi-avatar