tequed232/DSH-L2D

项目介绍

DSH-L2D 把 Live2D Cubism 角色接入 DeepSeek Harness（DSH）工作区。Agent 不再只靠文字回应，而是描述「看向用户」「进入思考状态」这类语义目标，由本地运行时解析为表情、视线和连续动作。项目把语义意图与渲染分开：动作队列和参数所有权负责仲裁写入，最后交给 Cubism/WebGL 渲染器执行（系统架构）。

代码按职责拆成模型无关的 core、renderer、DSH 插件、stdio MCP Server、MCP Bridge 和 SQLite 动作/模型注册表（模块职责）。MCP 客户端可以启动 Server，从 Agent 侧执行动作的入队、查询和取消。

README 对成熟度的说明比较明确：渲染器、参数注入、FIFO 调度、动作库和 MCP Server 已实现；Workspace Bridge 与 Overlay 仍在验收；侧栏/独立桌宠窗口切换、自动肢体分配和双视图 UI 属于部分实现、规划或实验（实现状态）。如果想要开箱即用的桌宠成品，目前还达不到。

快速使用

环境要求：Node.js 22 及以上、pnpm 12.5.1、可运行的 DeepSeek Harness，以及自行准备的 Live2D 模型和 Cubism Core（环境要求）。

1. 获取代码并安装依赖：

git clone https://github.com/tequed232/DSH-L2D.git
cd DSH-L2D
pnpm install

2. 构建 Renderer：

pnpm build:renderer

3. 打包 DSH 插件，按当前 DSH profile 的插件安装方式部署，然后按宿主要求重启 DSH：

npm pack ./packages/dsh-l2d-plugin

插件注册方式、profile 路径可能随 DSH 版本变化，以当前宿主和插件包说明为准。

4. 把有合法授权的 Live2D 模型和 Cubism Core 放到插件设置约定的位置。两者都不随仓库分发，Cubism Core 需从 Live2D 官方 SDK 页面获取。

5. 可选：启动 MCP Server：

node packages/dsh-l2d-mcp/src/server.mjs

并在 MCP 客户端中注册，路径替换成本机绝对路径：

{
  "mcpServers": {
    "dsh-l2d": {
      "command": "node",
      "args": ["/absolute/path/DSH-L2D/packages/dsh-l2d-mcp/src/server.mjs"]
    }
  }
}

只调试 Overlay 和动作链路、不接 DSH 时，先执行 pnpm build:renderer，再执行 pnpm dev:server，打开启动日志里的地址（本地调试）。可用的 MCP 工具以运行时 tools/list 返回为准，工具语义和回执示例见 MCP 包说明。

使用约束

• 系统与媒体传感器默认关闭，需要用户明确开启。Bridge 只应监听本机回环地址，不要把服务或 API Key 暴露到公网（Workspace 与隐私边界）。
• 动作请求成功不代表动作已经播放完成。accepted 只表示已受理，pending 不应重复提交；完成还是中断，要看实际回执和事件（动作链语义）。
• 动作链最多 15 个 segment，Renderer 单批次最多 8 个 step。模型能力分为 supported、approximate、unsupported、unknown，未知能力不能按支持处理。
• 单元测试、契约检查、浏览器验证和真实 DSH 宿主验收是不同层级，通过一层不能说明所有模型、GPU 或窗口容器都已验证（验收口径）。
• 模型、纹理、动作素材和 Cubism Core 二进制不随仓库分发，可能受各自许可约束；仓库本身采用 MIT 许可（资源与许可）。

HotRepo 点评

2026-11-07，该项目进入 HotRepo 新项目 JavaScript 榜，当时 106 Star、18 Fork，在约两小时的统计窗口内净增 5 Star；当天下午的小时采样从 102 增至 106。观察窗口很短，只能确认早期有一次增长，不足以判断趋势。

对一个新项目来说，这份工程文档相当坦诚：区分了已实现、已接线、实验性和规划中的子系统，并明确说明对话服务是 mock、本地 Agent Client 是降级实现而非真实后端。需要注意的正是这种坦诚和 Workspace Bridge 尚未完成之间的落差——渲染器和动作链路是较具体的部分，Agent 集成仍在验收阶段。