前言¶

在 DeepSeek Harness（下稱 DSH）的使用過程中，開發者通常可以看到命令、日誌和會話結果，但不一定能直觀判斷當前會話正處在“思考、工作、等待確認、報錯、完成”等哪個階段。dsh-live2d-companion 是一個面向 DSH 的 Live2D 監控面板插件：接入 Cubism 4/5 模型後，它會訂閱 DSH 會話事件流，並即時反映 AI 工作狀態。

該插件提供網頁掛件與 Electron 透明置頂桌面桌寵兩種形態，共用前端內核，適合作爲 DSH 會話狀態的可視化補充。

這是什麼¶

dsh-live2d-companion 由 Tisitan 維護，定位是 DeepSeek Harness 的 Live2D 監控面板和看板娘桌寵。它把 Live2D 角色接入 DSH 會話狀態，用於把“當前會話在做什麼”變成可見的界面反饋。

資料顯示許可證標註爲 MIT，但 LICENSE 文件內容未在已覈實資料中完整展示，使用前仍應檢查源碼與許可證。

核心功能¶

會話狀態可視化¶

• 訂閱 DSH 會話事件流，即時反映 AI 工作狀態。
• 提供 8 態狀態機與狀態燈，覆蓋空閒、思考、工作、等待確認、報錯、完成、睡眠、離線等狀態。
• 多任務並行時，每個會話可顯示獨立任務燈，並支持聚合主燈。

網頁掛件與桌面桌寵¶

• 支持網頁掛件形態，默認開啓。
• 支持 Electron 透明置頂桌面桌寵形態，默認關閉。
• 兩種形態共用前端內核。

角色交互¶

支持 Live2D 角色交互，包括：

• 點擊
• 摸頭
• 拖拽
• 縮放
• 叫醒
• 全局視線跟隨

氣泡臺詞與臺詞預設¶

• 支持氣泡臺詞。
• 支持臺詞預設編輯。
• 官方默認臺詞庫只讀。
• 用戶自定義臺詞可另存與切換，避免與上游更新衝突。

多模型支持¶

• 支持 Cubism 4/5 模型。
• 模型可放入 model/ 目錄。
• 可通過模型面板掃描、切換、導入、預覽模型。

遊戲中心¶

內置遊戲中心包含：

• 五子棋
• 國際象棋

支持：

• 本地引擎裁決
• 本地 AI 執子
• 在線 LLM 解說
• 阿爾法狗模式

對 DSH 本體的接入方式¶

• 對 DSH 本體零修改。
• 通過 cordis patch 層掛載。
• DSH 升級免疫。

standalone 獨立入口¶

插件提供 standalone 獨立運行入口。不啓動 DSH 時，也能使用部分桌寵渲染、模型面板、遊戲中心和狀態聯動。

需要注意，standalone 獨立版仍不包含模型、Cubism Core、Electron 二進制或第三方角色 Prompt。

安裝與啓用¶

運行前提¶

• 已安裝 DSH，且 dsh web 可用。
• Node.js 版本需 ≥ 18。

安裝插件¶

在已安裝 DSH 的環境中執行：

dsh plugin --profile web add github:Tisitan/dsh-live2d-companion

調整網頁掛件與桌寵開關¶

默認網頁掛件開啓、桌面桌寵關閉。

如要調整，可在以下路徑追加同 id 覆蓋行：

$env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml

例如：

- insert:
    - id: live2d-companion
      name: 'dsh-live2d-companion'
      config:
        widget: false
        pet: true

可通過 cordis.patch.yml 中 live2d-companion 的 config 調整以下配置項：

• widget
• pet
• petDir
• model

放入 Live2D 模型¶

將 Cubism 4/5 模型整目錄放入：

public/model/<模型名>/

然後在 patch config 中配置 model 路徑。

本倉庫不分發任何模型文件，需要用戶自備 Cubism 4/5 模型，並遵守其原始許可。

下載 Cubism Core¶

Cubism Core 爲許可要求，且倉庫不包含。需要從 Live2D 官方下載 live2dcubismcore.min.js，並放入：

public/vendor/live2dcubismcore.min.js

啓用 Electron 桌寵¶

如啓用桌面桌寵，進入 pet 目錄安裝依賴：

cd pet
npm.cmd install

然後重啓 DSH Web。

典型用法¶

1、安裝插件後，先使用默認網頁掛件，觀察 DSH 會話狀態。

2、準備一個 Cubism 4/5 模型，將整目錄放入 public/model/<模型名>/，並在 cordis.patch.yml 的 config.model 中指定模型路徑。

3、將 Live2D 官方下載的 live2dcubismcore.min.js 放到 public/vendor/live2dcubismcore.min.js。

4、如需桌面桌寵，在 pet 目錄執行：

npm.cmd install

然後重啓 DSH Web。

5、使用模型面板掃描、切換、導入、預覽模型。

6、通過氣泡臺詞與臺詞預設編輯功能，另存或切換用戶自定義臺詞預設。官方默認臺詞庫保持只讀。

7、進入遊戲中心，使用內置五子棋和國際象棋。可啓用本地引擎裁決、本地 AI 執子，或在線 LLM 解說、阿爾法狗模式。

適用場景與注意¶

適合誰¶

• 希望把 DSH 會話狀態從日誌和終端中抽出來，用可視化方式顯示。
• 需要在網頁掛件或桌面透明置頂窗中使用 Live2D 角色。
• 想接入自己的 Cubism 4/5 模型，並保留角色交互、臺詞預設和模型面板。
• 希望在等待、思考、工作、報錯等階段有更直觀的反饋。

使用限制¶

• 插件不綁定特定角色，但需要用戶自備 Cubism 4/5 模型，並遵守模型原始許可。
• Cubism Core 爲許可要求，且倉庫不包含，需要從 Live2D 官方下載。
• standalone 獨立入口不包含模型、Cubism Core、Electron 二進制或第三方角色 Prompt。
• 官方默認臺詞庫 public/quips.json 只讀，用戶自定義臺詞寫入本地忽略文件，避免與上游更新衝突。

安全與合規¶

插件以當前 dsh 進程權限運行，並會在 DSH Web 環境中加載。安裝前應檢查源碼、依賴與許可證。

資料顯示 package.json 標註許可證爲 MIT，但 LICENSE 文件內容未完整展示，建議以倉庫中的實際許可證文本爲準。

鏈接¶

GitHub 倉庫：https://github.com/Tisitan/dsh-live2d-companion