英雄联盟桌宠陪玩 jinghuashuiyue2004/dsh-plugin-lol-companion

LOL 陪玩数据插件

把英雄联盟实时数据接进你原有的 DeepSeek Harness 对话，让你养的角色通过桌宠陪你玩。

演示视频：【我把大肥鱼拉到LOL当陪玩娘了】 https://www.bilibili.com/video/BV1axHV6EErM/?share_source=copy_web&vd_source=63af640136307ef4b250dddc1f4d121b

插件读取本机 LOL 客户端和对局接口，把数据交给当前绑定的对话，再把模型的最终纯文本回复显示在桌宠气泡里。性格、知识、记忆和说什么，由原会话、用户及其已有工具决定。

当前版本：0.7.1。运行环境：Windows + DeepSeek Harness；已验证宿主版本为 0.2.1-rc.2。

文档

| 文档 | 内容 |
| 用户使用教程 | 安装、开始陪玩、游戏内打字、调整设置、常见问题 |
| 技术文档 | 架构、接口、数据协议、调度、桌面通信、配置、开发与验证 |
| 验证记录 | 已执行的检查及其覆盖边界 |
| 贡献指南 | 反馈问题、提交改进、开发验证与设计约定 |
| 来源与许可说明 | 第三方素材与证书来源 |

能做什么

- 读取账号等级、大厅与房间、匹配、选人、局内事件及赛后结果，以接口实际提供的字段为准。
- 选择主要数据或详细数据，自行调整投递间隔、回复长度偏好和气泡停留时间。
- 等当前整条回复显示完，再把最新状态和期间新增事件交给模型判断下一句。
- 三击桌宠打开输入条，直接向原对话打字；手动输入和回复保留在工作区 Chat。
- 自动游戏轮次在主 Chat 隐藏，原始会话记录和轨迹仍保留。

插件没有独立模型后端，不内置教练人设、攻略知识库或角色记忆。当前也没有聊天 OCR、语音播放或游戏内发言功能。

快速开始

1. 将完整项目放到固定目录，例如 D:\Apps\lol-companion。确认包含 package.json 和 dist\LolCompanion-0.7.1.exe；仅下载源码且没有 EXE 时，见构建方法。
2. 在 DeepSeek Harness 的 插件 → 添加插件 → 安装第三方插件 中填写该目录，安装并启用，然后完整退出并重开 DSH。
3. 回到原来的角色对话，发送：“我要打英雄联盟，陪我玩。请调用 lol_watch_start。”
4. 将游戏设置为无边框或窗口模式。三击人物即可在游戏中打字。

模型沿用原会话配置，不需要为此插件另配 API Key。正常使用由 DSH 启动桌宠，不直接双击 EXE。

默认：主要数据、每秒本地采样、每 15 秒最多自动投递一批、回复尽量 20 字。设置可调整；每页固定最多 20 个可见字符，长回复自动分页，总页数不限。

数据与费用

本机读取不调用模型；自动投递进入原会话后，按该会话所用模型的实际用量计费。<silent/> 只关闭气泡输出，已经发生的推理仍可能计费。详细数据和更短间隔通常会增加用量。

游戏数据通过 LCU 和 Live Client Data API 读取，使用本机 HTTPS GET；不注入游戏、不读进程内存、不模拟游戏输入。接口无法覆盖所有屏幕信息，详细档也不等于完整游戏内部状态。游戏昵称等数据会随上下文交给原会话配置的模型服务。

欢迎参与

欢迎大家基于这个项目的框架适配更多游戏。

这个项目的核心思路是：插件负责接收游戏数据、连接用户已有的对话，并通过桌宠展示回复；角色的性格、知识和表达方式由用户培养。欢迎为其他游戏开发数据适配器，让自己的角色陪伴更多游戏。

也欢迎分享自己绘制或有权分享的桌宠图片、气泡样式等素材，让桌宠拥有不同的外观。

- 反馈问题、提出适配建议或分享素材：提交 Issue。
- 贡献代码、文档或素材文件：提交 Pull Request。
- 分享素材时，请注明作者、来源和许可范围，以及是否允许修改、商用和再次分发。

具体参与方式见 贡献指南。
欢迎通过 Issues 反馈问题、提出建议，也欢迎 Fork 本项目并提交 Pull Request。修复兼容问题、改进桌宠交互、补充测试和完善文档都很有帮助。开始前请阅读贡献指南，保持“插件提供游戏数据，角色由用户培养”的设计原则。

许可与素材

本项目自主编写的代码、文档和脚本采用 MIT 许可证，允许修改、分发和商用，须保留版权及许可声明。鲸鱼娘图片来自 DeepSeek-Balance-Whale-Widget，按维护者确认保留，第三方图片不适用本项目的 MIT 授权；详见来源与许可说明。

本项目不是 Riot、DeepSeek 或素材作者提供的官方 LOL 插件。