Skip to content

maomao-dsh-panel

Verified

maomao-dsh-panel · v0.2.27 · MIT · Web UI

猫猫是适用于 DeepSeek Harness 的聊天伙伴插件,支持桌面、QQ、Telegram 和 Lark / 飞书。

Install

dsh plugin add maomao-dsh-panel

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

猫猫,给 DeepSeek Harness 的聊天伙伴

猫猫 · Maomao for DSH

猫猫是一个适用于 DeepSeek Harness(DSH) 的开源聊天伙伴插件。你可以在 DSH 里直接和猫猫聊天,也可以把自己的 QQ、Telegram 或 Lark / 飞书机器人接进同一个控制面板。

  • 桌面聊天:新建会话时选择「猫猫」预设,即可使用内置人格和独立的本地记忆。
  • 聊天平台:在面板里接入自己的 Bot、绑定会话,再验证首条回复。
  • 按需扩展:单独配置模型、普通记忆、人格、媒体与主动分享。基础文字聊天可以跟随 DSH 默认模型。

自主学习

在「设置 → 猫猫 → 记忆 → 自主学习」管理,默认开启,可单独关闭回复后的后台总结。

猫猫可以在普通聊天中自行判断哪些内容值得记住:对象的偏好与习惯、带时间的经历与待办,以及可复用的任务方法。比如反复调整插画后,可以把构图、透明背景和检查方法整理成技能,下一次相关任务先加载再使用。是否形成经验由对话模型判断,不要求固定句式或累计固定次数;“调用工具成功”不代表用户认可,尚不确定的经验应标为「待验证」。

  • maomao_memory:查询、记录、修正、遗忘当前范围的档案、经历、语气习惯(style)和梗知识(meme)。语气有原话依据,学习句长、节奏和接话方式,不会自动覆盖人格;观察中的习惯标为待验证。
  • maomao_skill:查找技能摘要、加载正文、保存或更新方法。支持导出标准 SKILL.md;技能内容是受当前权限约束的操作参考,不会获得终端或任意文件写入权限,也不会自动安装到 DSH 的全局技能目录。
  • maomao_meme:遇到不熟悉或可能有新含义的中文互联网梗,由模型决定是否查询。复用 DSH 的联网搜索,返回来源和证据;模型再决定是否保存为梗知识。保存时保留实际来源链接,查询失败不建立假出处。群内使用过的梗留在本群,不带到其他群;网页资料不能变成个人档案或语气依据。
  • maomao_stickers:QQ、Lark / 飞书、Telegram 的模型可以直接查看本轮图片、判断收藏价值、搜索本会话表情库、发送选中的表情。首次出现也可以收藏,不再以出现次数或固定关键词决定。收藏理由由对话模型给出,再自然接一句;不自动追加固定“偷走啦”通知。静态图发送为保留透明度的 512px 内 PNG,GIF 保留动画;Telegram 静态图走贴纸接口,GIF 走动画接口。不能下载的商城表情和动态贴纸仅理解平台标签,不凭标签伪造收藏。
  • 表情包需要 Python 3 + Pillow;收藏还需要在「模型与能力」启用识图。在「自主学习」可分别关闭表情工具或收藏。QQ 配置中的显式关闭仍生效。表情库与普通记忆使用同一授权范围:QQ 按群/私聊隔离,已关联同一主人且开启共享的 Lark/TG 可复用。收藏不含私人照片、私人聊天截图和敏感图像。现有 QQ 公共表情包目录 stickers.packRoot 继续可检索;不会从其他群偷读收藏。
  • 普通回复成功后,后台使用猫猫当前配置的对话模型总结;短时间连发按发言者合并,最多同时两项。默认每个范围每天最多 40 次,所有范围合计最多 200 次;会额外消耗模型额度。失败不影响聊天,不发群内系统通知。面板可查看最近总结结果。
  • 写入需要当前对象实际发言的原文依据;修正带版本检查。过期、遗忘的内容不再召回。面板可查看依据、使用次数、最近使用时间、编辑、遗忘、恢复最近 20 个版本,并导出 MEMORY.md 或单个 SKILL.md。遗忘会保留可恢复的版本,不等于彻底擦除。

学习数据存放在 $DSH_HOME/integrations/maomao-learning/,每个范围独立 SQLite 文件;桌面、QQ 每群及每个 QQ 私聊分别隔离。Lark / 飞书和 Telegram 只有在关联同一主人并启用普通记忆共享后才共用学习范围。关闭渠道普通记忆也会停止该渠道的新学习。群成员可以维护自己的记录,主人可以修正本群记录;工具不能指定其他群或文件路径。已授权 QQ 群的未 @ 普通发言也可以由后台模型评估是否值得学习(共用每日限额),沉默不等于没有观察;系统通知和配对消息不参与。

后台只使用本功能采集的普通用户发言、普通回答、本轮媒体执行结果,以及通过梗查询取得的公开资料,不扫描旧日志,不读取 Hermes 导入库,不读取私有模式资料。最近原话证据最多保留 300 条 / 30 天,每范围最多 500 条学习记录;默认档案和技能有效期一年、经历 30 天,可由模型按事实选择有效期,时效性梗建议使用更短期限。新学习库当前采用目录和文字检索,表情库支持已配置的 Embedding,失败时仍可用文字候选。

群内主人身份已支持,且与“允许这个群聊天”分开:在面板「渠道与会话 → QQ → 会话与权限 → 添加绑定 → 绑定 QQ 群或私聊」选择「QQ群主人身份」,生成 /pair 配对码,由本人在目标群 @机器人发送,再把确认码填回面板。绑定只对本群生效,不凭群主/管理员职位或自称认主。@猫猫 /sid 可查看当前发言者的主人状态,@猫猫 /pair 可直接查看步骤。

验证方式:让猫猫记住一个普通偏好,再开新会话询问;让她总结刚完成的工作方法,再换一个相关任务看是否调用技能;纠正内容后确认新会话采用修正版,并检查另一个 QQ 群不出现这份记录。日常对话仍会受模型判断影响,可通过面板纠正遗漏或误记。

飞书 / Lark 使用富文本发送 Markdown,可显示粗体、引用和列表。QQ 优先使用原生 Markdown,平台明确拒绝时回退为纯文本。

安装

目前验证的 DSH 版本为 0.2.2-rc.1。请先在 DSH 的模型设置中准备一个可用的对话模型。使用外部渠道的记忆和分享功能时,还需要系统可调用的 Python 3。QQ 表情缩略图需要 Pillow。

在桌面端打开「插件 → 安装第三方插件」,输入 [email protected],安装后按提示重启。也可以下载并导入 .tgz 安装包。GitHub Releases

Web 版可以用 DSH 命令行从 npm 安装固定版本。npm 包

dsh plugin --profile web add [email protected]

也可以从 GitHub 安装同一个版本。

dsh plugin --profile web add 'github:ififi2017/dsh-plugin-maomao#v0.2.27'

重启后打开「设置 → 猫猫 → 总览」。只在 DSH 聊天的话,直接在新会话的模式菜单选「猫猫」,发一句「猫猫你好」。

第一次接入聊天平台

先选一个平台走通 连接 Bot → 绑定会话 → 验证第一条回复。面板会分别显示连接、配对和这条测试消息的处理进度。

渠道 准备什么 怎么绑定
Lark / 飞书 选对 Lark 或飞书版本,扫码创建应用,或导入已有 App ID 和 App Secret。应用需启用机器人能力和长连接事件,并发布版本 在目标私聊发配对指令,把 Bot 回的确认码填回面板
Telegram 在 BotFather 创建 Bot,将 Token 填到面板。已有开启管理模式的 Bot 也可以扫码创建 打开配对链接点 Start,或在私聊发配对指令,再填确认码
QQ 扫码授权或导入 App ID 和 App Secret。先确认同一个 Bot 只由一个实例连接 选择群或私聊。群内先 @Bot,再发送配对指令,最后填确认码

绑定后进入「测试回复」,点「生成测试消息」,把带编号的整句发到选定会话。QQ 群内需要 @Bot。面板会显示同一条消息的收件、模型和投递结果。平台接受回复后,回到聊天窗口确认。

Lark / 飞书手动配置时,订阅 im.message.receive_v1,启用 im:message.p2p_msg:readonly 和 im:message:send_as_bot。需要读图时再开 im:resource 和 im:message:readonly。改完权限或事件后,在平台发布新版应用,再回面板验证。

QQ 私聊与配对

「渠道与会话 → QQ → 会话与权限 → QQ 私聊」可设置 接受陌生人私聊,默认关闭。关闭时只接受已配对或配置在 dmAllowlist 的用户聊天;其他人会收到限频的配对提示,仍可使用 /sid 查询自己的 QQ OpenID、/pair 查看步骤。开启后,未配对用户也可直接聊天、使用已经启用的媒体工具,会消耗模型额度;这不会赋予主人身份或开放 QQ 群、Lark / Telegram 的记忆。

配对不需要改配置文件:在「会话与权限 → 添加绑定 → 绑定 QQ 群或私聊」选择「QQ 私聊」→ 生成指令 → 私聊 Bot 发送完整 /pair 配对码 → 将收到的确认码填回面板。即使开启了陌生人聊天,也能继续配对;配对后关闭陌生人开关仍可聊天。已授权私聊支持 /sid 和 /status,无需 @。QQ 私聊按 Bot、用户隔离,不会与 Lark / Telegram 主人记忆合并。

QQ、Lark / 飞书、Telegram 新配对成功后,会立即在后台使用当前对话模型和所选人设生成一条简短招呼,发到刚绑定的聊天。招呼保留在该聊天的正常上下文里,后续可以直接接着聊;配对码不传给模型,配对事件也不会被提取为用户的长期记忆。重复确认、刷新面板或重启不会重发;仅关联已有私聊的主人身份也不重复招呼。生成期间解绑、换人设或关闭连接会取消发送,生成失败不会撤销已完成的配对。

面板显示本次启动后的最近私聊收件状态,帮助区分平台未投递和等待配对。QQ 群的直接回复开关不会关闭 QQ 私聊;陌生人开关也不会开放任何新群。若要完全拒绝某个已解绑用户,需关闭陌生人私聊,并从手动 dmAllowlist 中移除该用户(若曾手动配置)。

QQ 群互动

绑定 QQ 群后,可在「主动互动 → QQ 群接话」按群开启。模型会根据收到的群消息和已启用的同群普通记忆判断是否接话。能收到哪些未提及机器人的消息,取决于 QQ 平台的接收设置。

每条群友消息最多续聊 1–5 次,由面板设置,并受 QQ 实际回复额度约束。群友可发送 /停止互动 暂停,已绑定的群主人可发送 /恢复互动,也可以在面板里暂停或恢复。

自然语言的“这轮先停一下”由模型判断,只结束当轮互动并取消排队中的回嘴;下一次群友开启新话题时可重新参与,不会永久关闭群互动。只有斜杠指令和面板暂停会持续生效。普通接话的节奏交给模型结合近期消息判断,不设 3–10 分钟静默或每小时 5 次的固定门槛。 快速追问会先合并等待再交给模型,不直接丢弃;续聊没有额外的 60 秒截止,只遵循 QQ 回复有效期和投递额度。模型能看到已用与剩余轮数,可提前自然结束,不要求把次数用满。

模型可以用 qq_group_query 查询当前群的基本资料、成员列表单页或当前发言者和本轮查到的成员资料。三个接口都受 QQ 平台权限限制,查不到时会继续使用群聊上下文。

模型可直接调用的聊天工具

QQ 群 / 私聊、Lark / 飞书私聊和 Telegram 私聊使用同一套工具接口。启用模型后,对话模型根据当前请求、上下文和已有的本会话记忆自行选择工具,无须固定关键词;工具只对当前授权会话有效。

工具 功能 配置
maomao_generate_image 生成或编辑图片并投递;参考图只取当前发言者本轮可用图片 猫猫面板 → 模型与能力 → 生图
maomao_speak 合成并发送语音;支持接续上一条语音改语言,尊重“只用文字” 猫猫面板 → 模型与能力 → 语音
maomao_web_search 查公共资讯、新梗,返回来源 复用 DSH 已配置的 Web 搜索提供商
maomao_web_fetch 阅读公开网页 复用 DSH 的 Web 抓取提供商及其网络访问保护
maomao_browser_open / maomao_browser_read 打开、读取动态网页 独立的 Chrome / Edge 浏览器环境
maomao_browser_follow 跟随刚读到的页面链接 必须使用本轮最新快照里的链接编号
maomao_browser_screenshot 让模型查看当前网页截图 对话模型须支持图片输入;不自动向聊天发送截图
qq_group_query 查询当前 QQ 群及群成员的公开资料 QQ 平台须授予相应接口权限,缺权限自动回退

给猫猫一个创作项目链接时,模型可以自行查找设定和参考资料,再生成图片:

  • 用 maomao_project_read 读取公开 GitHub 项目的目录、角色索引、设定和提示词文件,返回文件路径、版本 SHA 以及图片直链;不用把整个仓库塞进上下文。
  • 用 maomao_reference_image 读取实际 PNG / JPEG / WebP 原图,支持识图的聊天模型可以直接看图。生图时传入本轮的 reference_id,将原图字节交给已配置的生图模型。也继续支持本轮用户直接上传的参考图。
  • 用 maomao_skill 总结可复用的角色约束、来源、提示词模板和验收点。工具成功读取的项目资料可作为技能证据,不能作为用户个人事实;未经用户验收的项目技能保留为待验证。下次使用时加载技能、重新读取所需资料和参考图,临时图片 ID 不会跨轮复用。

以上选择由模型决定,代码不会按项目名称套用角色模板。项目工具目前只支持公开仓库;私有 GitHub 项目需要另行授权,插件不会借用其他应用的登录、Cookie 或密钥。未读取到资料时应明确说明,不能声称按项目原稿还原。

每轮最多发送一份生成媒体,搜索/普通网页读取最多调用三次,浏览器最多操作四次,项目文件读取最多十次、公开参考图最多三张(每张不超过 5 MB,生成时选一张)。工具报告真实投递状态,投递不确定时不自动重试;搜索服务缺少凭据或权限时正常返回不可用,模型继续用文字回答。搜索只应发送公共关键词,不应传出私人记忆或身份信息。未向渠道模型开放终端、文件访问或任意收件人参数。

联网搜索单独配置。 DSH 当前默认的搜索提供商是 DeepSeek;把聊天模型设为 Google 或 OpenAI,不会自动把搜索也切过去。请到 DSH 的「插件 → 内置插件设置 → 联网搜索」检查所选提供商,并在模型凭据中配置它需要的凭据。仅配置 Google / OpenAI 密钥时,DeepSeek 搜索仍然不可用。猫猫的网页工具会区分缺少凭据、提供商未加载、 提供商选择冲突与请求失败,不应把这些情况一概说成临时断网。公开网页读取使用 单独的抓取提供商,搜索缺少密钥不代表所有网页都不能读取。

猫猫面板的「模型与能力 → 联网与浏览器」可保存 DeepSeek 官方搜索凭据、测试当前搜索、 开启或关闭浏览器,以及试读一个公开页面。凭据保存在 DSH 的凭据库,复用 DEEPSEEK_API_KEY。 使用其他搜索插件时,只要它注册到 DSH 的 ctx.web 并选为当前提供商,猫猫就会使用它。 插件不会自动更换搜索提供商或向多个服务回退。

浏览器基于 Playwright,优先使用本机已安装的 Chrome / Edge;Linux 也支持系统 Chromium。 首次调用才启动,最多三个并行环境;每轮聊天使用独立的临时 context,结束后清理,全部空闲约 30 秒后退出浏览器进程。 不会连接个人浏览器或读取已有 Cookie。第一版限公开 HTTPS 网页的阅读、链接导航和截图,不提供表单、上传、下载或任意脚本执行工具。 截图通过 DSH 附件服务提供给当前模型;文字模型应使用网页正文。 网络出口会校验 DNS 并连接校验后的公网 IP,拒绝内网和特殊地址。若本机 TUN 代理返回 198.18.0.0/15 的 Fake-IP, 仅对这类结果用 Cloudflare 的 HTTPS DNS 重新查询真实公网地址,再执行同样的校验;不会直接放行 Fake-IP。

Lark / 飞书与 Telegram 的语音会在本机用 FFmpeg 转为 Opus,再发送原生语音消息;请安装支持 libopus 的 FFmpeg。Lark / 飞书发送图片和语音需要 im:resource 与机器人发消息权限。工具能力按渠道会话挂载,不会改变桌面通用 Agent 的工具集合。后台定时分享仍由面板中的原有开关控制,这里只增加对话期间的自主查询。

按需配置

面板 能做什么
总览 查看渠道在线和绑定情况,进入常用配置;首次使用可按接入顺序操作
渠道与会话 按平台分别管理「连接 Bot」「会话与权限」「测试回复」。已连接时收起凭据表单;只显示当前平台的绑定
人设 「会话分配」设置默认与每个会话的角色;「角色库」查看内置猫猫设定或编辑自定义角色
模型与能力 分别配置对话、识图、生图、语音、向量检索、联网与浏览器以及服务凭据,每次只展开一种用途
记忆 「记忆内容」查记录;「范围与共享」控制隔离与共享;「向量索引」重建检索
主动互动 「QQ 群接话」管理接话轮数与暂停;「私聊主动分享」管理寂寞小猫、后台浏览、目标、免打扰与试跑
诊断 按平台查收件、模型、投递和媒体下载,并直接跳到连接或回复测试

绑定第二个 Lark / 飞书或 Telegram 私聊时,可关联同一位主人,也可为另一人建立独立记忆。关联同一位主人并开启共享后,两端才共享普通记忆。QQ 群记忆按 Bot 和群隔离。主动分享默认关闭,可以先用试跑查看候选内容。

凭据由 DSH 凭据库管理。普通记忆和绑定保存在运行实例的本地目录。聊天、图片或向量请求会按配置发给所选模型服务。公开源码只包含通用配置和合成测试资料。

未保存的修改会在所属页面和分栏标记;切页或关闭设置面板仍可继续编辑,重启 DSH 前需保存。面板会记住本次运行中最后查看的位置。

欢迎二次开发

欢迎提出改进建议、提交 PR,或 Fork 后扩展人格、渠道和设置界面。开发需要 Node.js >=24.9、Python 3、用于图片测试的 Pillow,以及支持 libopus 的 FFmpeg。

git clone https://github.com/ififi2017/dsh-plugin-maomao.git
cd dsh-plugin-maomao
npm ci --ignore-scripts
npm test
npm run pack:release

这是社区插件,由 fi_niaR Studio 维护。