前言¶

在 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