前言¶
在 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
