前言¶
在 DeepSeek Harness（DSH）里跑智能体时，常见需求不止是 Web 面板里对话，还要把同一人设、同一套记忆接到 QQ 群、Telegram 或 Lark / 飞书。自己写 Bot 桥接、再维护会话隔离和人设，工作量往往很大。猫猫（dsh-plugin-maomao）是社区维护的客户端类插件：在 DSH 内提供预设聊天伙伴，并把多个 IM 渠道收口到同一套面板里配置。
下面按定位、能力、安装和接入顺序说明，事实以仓库 README 与 npm 包信息为准。
这是什么¶
猫猫是适用于 DeepSeek Harness 的开源聊天伙伴插件，维护者为 GitHub 用户 ififi2017，在 SkillHub 上归类为「客户端」。当前 npm 包名为 maomao-dsh-panel，版本 0.2.26；package.json 中声明的 DSH 引擎版本为 0.2.2-rc.1，Node 需 >=24.9。
核心价值可以概括为两点：桌面端选「猫猫」预设即可本地人格与独立记忆；在面板里接入自有的 QQ、Telegram 或 Lark / 飞书 Bot，绑定会话后走同一控制流。
核心功能¶
桌面聊天¶
新建会话时在模式菜单选择「猫猫」预设，使用内置人格和独立的本地记忆。仅做 DSH 内聊天时，不必先配置外部渠道。
多渠道接入¶
支持 Lark / 飞书、Telegram、QQ。README 给出的接入节奏统一为：连接 Bot → 绑定会话 → 验证第一条回复；面板会分别显示连接、配对和测试消息的处理进度。
各渠道准备与绑定方式摘要如下（细节以面板向导为准）：
| 渠道 | 准备什么 | 怎么绑定 |
|---|---|---|
| Lark / 飞书 | 选对版本，扫码创建应用或导入 App ID / App Secret；启用机器人能力与长连接事件并发布 | 目标私聊发配对指令，把 Bot 回的确认码填回面板 |
| Telegram | 在 BotFather 创建 Bot，Token 填入面板 | 打开配对链接点 Start，或私聊发配对指令后填确认码 |
| 扫码授权或导入 App ID / App Secret；同一 Bot 只由一个实例连接 | 选群或私聊；群内先 @Bot，再发配对指令，填确认码 |
QQ 群支持「主人身份」绑定：在「渠道与会话 → QQ → 会话与权限 → 添加绑定」选择「QQ群主人身份」，生成 /pair 配对码，在目标群 @机器人发送，再把确认码填回面板；绑定只对本群生效。
按需扩展：模型、记忆、媒体与群互动¶
面板按用途拆分配置，README 中的主要区块包括：总览、渠道与会话、人设、模型与能力、记忆、主动互动、诊断。
对话模型可按用途分别配置；基础文字聊天可跟随 DSH 默认模型。启用识图、生图、语音、联网搜索、浏览器、向量检索等需在「模型与能力」中单独展开并配置凭据。联网搜索与对话模型提供方解耦：猫猫复用 DSH 已配置的 Web 搜索与抓取提供商；需在 DSH「插件 → 内置插件设置 → 联网搜索」检查提供商与凭据。
模型在已授权的 QQ / Lark / Telegram 会话上可调用一组工具（由对话模型自主选择，无固定关键词），例如 maomao_generate_image、maomao_speak、maomao_web_search、maomao_web_fetch、浏览器类工具，以及 QQ 场景下的 qq_group_query。生图、语音、浏览器等能力在猫猫面板对应子项中开关与配置。
QQ 群可开启「主动互动 → QQ 群接话」：模型结合群消息与同群普通记忆判断是否接话；每条群友消息续聊轮数可在面板设置（1–5 次），并受平台回复额度约束。群友可用 /停止互动，已绑定群主人可用 /恢复互动。
自主学习（开发版说明）¶
README 标明：自主学习尚未包含在 npm 0.2.26 中，开发版在「设置 → 猫猫 → 记忆 → 自主学习」管理。该能力让猫猫在聊天中判断值得记住的偏好、带时间的经历与待办、可复用的任务方法，并通过 maomao_memory、maomao_skill、maomao_meme、maomao_stickers 等工具读写；学习数据存放在 $DSH_HOME/integrations/maomao-learning/，按桌面、QQ 群 / 私聊等范围隔离。安装稳定版时，以当前发布包实际功能为准，勿按开发版文档假定已内置。
表情包收藏依赖 Python 3 与 Pillow，并在「模型与能力」启用识图；QQ 配置中的显式关闭仍生效。
安装与启用¶
README 写明目前验证的 DSH 版本为 0.2.2-rc.1。安装前应在 DSH 模型设置中准备可用的对话模型；使用外部渠道的记忆和部分媒体能力时，需要系统可调用的 Python 3；QQ 表情缩略图需要 Pillow。Lark / 飞书与 Telegram 语音发送需要本机安装支持 libopus 的 FFmpeg。
桌面端：打开「插件 → 安装第三方插件」，输入 maomao-dsh-panel@0.2.26，安装后按提示重启；也可从 GitHub Releases 下载 .tgz 导入。
Web 版命令行（npm 固定版本）：
dsh plugin --profile web add maomao-dsh-panel@0.2.26
也可从 GitHub 安装同一标签版本：
dsh plugin --profile web add 'github:ififi2017/dsh-plugin-maomao#v0.2.26'
重启后打开「设置 → 猫猫 → 总览」。若只在 DSH 内聊天，在新会话模式菜单选「猫猫」，发送一句「猫猫你好」即可验证。
典型用法：第一次接入聊天平台¶
1、在「渠道与会话」中为目标平台完成 连接 Bot（填入 Token、App 凭据或 QQ 扫码等）。
2、在 会话与权限 里添加绑定：按平台完成配对（私聊或群内配对指令 + 确认码回填）。
3、进入 测试回复：点「生成测试消息」，把带编号的整句发到选定会话（QQ 群内需 @Bot）；在面板确认收件、模型与投递结果，再在客户端看到回复。
Lark / 飞书手动配置时，README 要求订阅 im.message.receive_v1，启用 im:message.p2p_msg:readonly 与 im:message:send_as_bot；需要读图时再开 im:resource 与 im:message:readonly，改权限后需在平台发布新版应用并回面板验证。
绑定第二个 Lark / 飞书或 Telegram 私聊时，可关联同一位主人并开启记忆共享，或为另一人建立独立记忆；QQ 群记忆按 Bot 和群隔离。
适用场景与注意¶
适合谁：已在 DSH 上跑对话模型，希望用同一套人设与面板管理桌面聊天 plus QQ / Telegram / Lark 的开发者或小团队；需要群接话、语音、生图、联网查阅等可选能力时，可按面板逐项打开，避免一开始堆满配置。
权限与安全：插件以当前 DSH 进程权限运行，Bot Token 与渠道凭据保存在你的 DSH 环境中。安装第三方插件前，应自行查看 GitHub 仓库 源码与许可证（包内包含 LICENSES）。工具接口不对渠道模型开放任意终端、任意文件写入或任意收件人参数；搜索与网页读取有调用次数上限，且应只传公共关键词。
生态说明：DSH 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；猫猫仓库当前 GitHub 星标为 0，不代表功能缺失，仅反映社区关注度。
结尾¶
猫猫把「DSH 内聊天伙伴」和「多 IM Bot 统一配置」放在同一个插件里：桌面用预设即可上手，接渠道时按连接、绑定、测试回复三步走。进一步了解可在 SkillHub 查看插件页，或阅读 GitHub README 与 Releases 中的安装包版本说明。
- 目录页：https://www.skillhub.cn/plugins/ififi2017/dsh-plugin-maomao
- GitHub：https://github.com/ififi2017/dsh-plugin-maomao
