dsh-chat-comprehension
Verifieddsh-chat-comprehension · v0.4.0 · MIT · Web UI
DeepSeek Harness 聊天理解/陪伴套件:局部人格 + QQ 联动 + 专属记忆 + B站值班 + 表情包 + 文字转语音,一个入口。
Install
dsh plugin add dsh-chat-comprehension Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
dsh-chat-comprehension · 陪伴套件
给 DeepSeek Harness 的一个「一个入口」的陪伴层:项目人格 + QQ 联动 + 专属记忆 + B站 值班 + 表情包 + 语音。 左侧栏只有一个图标「陪伴」,点开就是一整页设置,不用在好几个插件各自的页面之间来回找。
版本 0.4.0:人格、B站、记忆、表情包、视频分镜的宿主代码都已随本插件提供,只装这一个包就能用。 QQ 网关(
@tencent-connect/dsh-qqbot)需要单独安装,本插件会自动为它打上联动补丁。
安装
dsh plugin --profile web add dsh-chat-comprehension
装好重启一次 DSH,左侧栏出现「陪伴」图标。
可选、但常见的配套:
dsh plugin --profile web add @tencent-connect/dsh-qqbot # 需要 QQ 对话时才装
原生工具(ffmpeg / yt-dlp / dashscope / uv)不用手工找,「环境」页有「一键安装全部依赖」。
页面里有什么
| 页签 | 内容 |
|---|---|
| 总览 | B站 登录 / QQ 绑定 / 记忆 / 值守四个状态,今天挑到几条、最近日志、报告路径 |
| 人格 | 按项目目录写人格、按模板新建、打开原文件;QQ 的私聊和每个群还能各写一份 |
| 对话与 QQ | 默认模型(全局)、模型能力(文字 / 图片)、QQ 绑定与扫码、本项目对话列表、每个 QQ 会话的专属人格与模型 |
| 记忆 | 记忆引擎状态、按 QQ 聊天分组的记忆清单、参与记忆的对话数、记忆镜像 |
| B站 | 扫码登录、自动时间(峰谷 / 自定义时间点 / 联网校时)、关注什么、值班模型、私信互通、每天条数、立即跑一轮、日志与报告 |
| 表情包 | 表情包状态、AI 斗图开关、图库管理入口 |
| 语音 | 云端 Qwen-TTS / Sambert,本地 Qwen3-TTS / vLLM / OpenAI 兼容 / GPT-SoVITS / CosyVoice / Fish / 自定义 HTTP,试听、发到 QQ |
| 环境 | 一键安装全部依赖(带网速自适应与每步进度)、逐项体检、一键修复内置引擎 |
| 关于 | 版本、许可、上游署名 |
人格:三种层级,互不打架
- 项目人格:
~/.dsh/agents/projects/<项目>.md,进这个项目生效。 - QQ 会话人格:
~/.dsh/agents/chats/<peer>.md,只对某个私聊或某个群生效,优先于项目人格。 - QQ 绑定会话:把网页里的某个对话接到 QQ 后,这个对话本身继续用它的项目人格。
人格只决定语气、称呼与行事风格,不改变安全规则和事实;拿不准的事以事实为准。
模型:一处默认,多处可覆盖
- 默认模型(全局):在「对话与 QQ」页选一次,QQ 消息和 B站 值班都会用它。
- 每个 QQ 会话可以单独指定模型(只有那个会话变,其他不受影响)。
- B站 值班可以单独指定模型,与 QQ、网页默认互不干扰。
- 三处都可以留空,留空就跟随上一层。
「对话与 QQ」页还有一张「模型能力(输入类型)」:勾上「图片」= 这个模型能看图, DSH 会按这里的声明决定要不要把图片发给它(改的是 DSH 自己的模型配置,立即生效)。 只对能在 DSH 设置里修改的服务显示开关;改过以后可以「恢复默认」。
一键安装依赖(顺序固定)
「环境」页有「一键安装全部依赖」,按下面的顺序执行;已经就绪的步骤会跳过,
每一步都有状态、耗时和日志(日志在 ~/.dsh/companion/setup.log):
| 顺序 | 依赖 | 作用 | 必需 |
|---|---|---|---|
| 1 | 网速探测 | 测各个镜像的速度,选出最快的源 | 自动 |
| 2 | uv |
建 Python 环境、装 Python 包(没有会自动下载) | 是 |
| 3 | B站 Python 环境(venv + MCP 依赖) | B站 值班、私信、扫码登录、转写 | 用 B站 就要 |
| 4 | dashscope |
Sambert 语音 | 否 |
| 5 | ffmpeg |
视频分镜、音频转码 | 否 |
| 6 | yt-dlp |
视频分镜拉 B站 视频 | 否 |
| 7 | 本地 Qwen3-TTS | 本地语音(要下模型) | 否 |
顺序的原因:第 3 步要用第 2 步建的环境,第 4 步要装进第 3 步的环境,第 6 步优先用第 2 步的 uv tool。
网速自适应:装 Python 包前先测 PyPI 官方与清华 / 中科大 / 阿里云镜像的
「响应时间 + 吞吐」,国内镜像能用就优先国内;外网明显更快(>2.5 倍)才走外网。
选中的源和速度会写在步骤详情里,一个源失败会自动换下一个。
ffmpeg 包管理器装不上时,会改用带 GitHub 加速镜像的静态构建。
一次装成的保障:每一步装完都会真的 import 验一遍(不是只看退出码),
验证不过就换镜像重试;已经就绪的步骤直接跳过,不重复下载。
三个平台都支持:Windows 用 winget,macOS 用 brew,Linux 用 apt-get;自动装不上时会显示手动命令。
每个 QQ 对话可以指定工作区
人格是按工作区(会话目录)注入的。不同 QQ 私聊 / 不同群如果都落在同一个目录,就会共用同一份人格。 现在每个 QQ 会话可以单独指定工作区:
- 页面「对话与 QQ」→ 每个会话卡里的「这个会话跑在哪个工作区」;
- 选定后写进
~/.dsh/agents/chat-workspaces.json; - QQ 网关建新会话时会用这个目录(补丁 v3),于是读的是那个工作区的人格;
- 新对话也在这个工作区里创建。
⚠️ 已经存在的 QQ 会话不会自动搬家:改完需要重启一次 DSH(或在 QQ 里让它开一个新会话)才生效。
记忆:私聊和每个群各记各的
- 每个 QQ 聊天(私聊、每个群)是一组独立的记忆:只读自己这个聊天用过的对话。
- 换过对话(比如让它开个新窗口继续聊)时,上一段只作为「以前说过的话」被读取, 不会写进新对话的记忆块。
- 别的 QQ 聊天(包括私聊和别的群)不会读到这边的记忆,互相不串。
- 私聊镜像在
~/.dsh/agents/qq-memory.md;群聊各有一份~/.dsh/agents/qq-memory-group-<群号后8位>.md。「记忆」页按聊天列出分组,并能直接看最近更新的一份。
语音
- 云端:阿里云百炼 Qwen-TTS、Sambert;或任何 OpenAI 兼容的
/audio/speech端点。 - 本地:自带 Qwen3-TTS 小服务(CUDA / Apple MPS / CPU 自动选),也支持 vLLM-Omni、GPT-SoVITS、CosyVoice、Fish-Speech 和自定义 HTTP。
- QQ 回复:语音可用就发语音,失败自动回退文字;没填 Key 或没开语音就发文字。
QQ 分享的视频:卡片能直接用
对方在 QQ 里分享 B站 视频时,QQ 交给机器人的是一张小程序卡片,正文里通常没有链接。 本插件会在访问控制之后接管这张卡片:
- 从
content、message_scene.ext、msg_elements、附件地址等所有可能出现的位置找链接 / BV 号 (不只认ark_data一种形状); b23.tv/bili2233.cn这类短链会只跟随 B站 自己的域名解开成视频地址;- 找到后把「视频链接」补进这条消息,模型可以直接用
video_storyboard打开,不用再向对方要 BV 号; - 群里「回复那张卡片 + @机器人」也能认:卡片在引用(
msg_elements)里时同样会补链接; - 卡片里确实没有链接时,会明确说「这张卡片没有可打开的链接」,不让模型凭标题猜或者按标题去搜。
「环境」页有「QQ 分享卡片」一行:显示网关补丁版本、最近一张卡片的时间和解析出的链接,
「B站」页也能看到最近一张卡片的原始字段(~/.dsh/agents/qq-last-card.json,不含 QQ 号)。
⚠️ 卡片解析依赖 QQ 网关补丁(最新是 v5):补丁更新后要重启一次 DSH 才会进内存, 否则跑的还是旧代码 —— 表现就是「只看到卡片,看不到链接」。 补丁更新时页面顶部会提示重启;「环境」页的「QQ 分享卡片」一行会显示当前补丁版本。
微信 / QQ 里直接发的表情包为什么看不到
看不到,是平台格式限制,不是插件缺工具,也不是模型不支持图片。
- 微信、QQ 聊天里的「表情包 / 贴纸」是各自专有的表情格式(不是标准 PNG / JPEG / GIF / WebP 文件)。
客户端发出去的是专有编码或资源 ID,服务端不会把原始图片字节交给机器人,
所以
read_image拿不到可解码的图片,模型也无图可看。 - 没有任何本地或插件方法能从这种专有格式还原出图片字节。
能看的:
- 普通图片、截图、照片(PNG / JPEG / GIF / WebP)→ 直接让模型看。
- 表情包库里的图(标准图片格式)→ 「表情包」页可以发、可以看。
- 想让模型看见微信 / QQ 表情包里的内容,只能让发送方改发标准图片(截图、另存为 PNG)。
数据放在哪
| 内容 | 位置 |
|---|---|
| 项目人格 | ~/.dsh/agents/projects/<项目>.md |
| QQ 会话人格 | ~/.dsh/agents/chats/<peer>.md |
| QQ 会话工作区 | ~/.dsh/agents/chat-workspaces.json |
| QQ 会话模型 | ~/.dsh/agents/chat-models.json |
| 默认模型(全局) | ~/.dsh/agents/companion-model.json |
| 记忆清单 | ~/.dsh/agents/qq-memory.json(私聊 / 每个群一组) |
| 记忆镜像 | 私聊 ~/.dsh/agents/qq-memory.md;群聊 qq-memory-group-<群号后8位>.md |
| B站 值班 | ~/.dsh/bili-duty/(配置、日志、报告、venv) |
| 语音设置 | ~/.dsh/agents/companion-tts.json(Key 只存本机,不回显) |
| 安装日志 | ~/.dsh/companion/setup.log |
常见问题
- 在 QQ 里发表情包没反应? 先确认还开着 QQ(网关在线)、并且这个聊天里已经说过话。 没有可发的聊天目标时,工具只会返回一行提示(如「还没有 QQ 聊天目标」),不会影响 DSH 运行。
- Windows 上看不了 QQ 分享的视频? 视频分镜要靠
yt-dlp/ffmpeg。插件加载时会自动把常见安装目录 补进 PATH,「环境」页的「视频分镜工具链」一行会显示它找到的绝对路径;没有就点一次「一键安装全部依赖」。 - 改了某个 QQ 会话的人格 / 模型 / 工作区,什么时候生效? 人格和模型下一个会话生效(页面会立即切正在用的模型); 工作区要等它开新会话,或重启一次 DSH。
- 记忆页的数字为什么和 QQ 里看到的不一样? 数字是「所有 QQ 聊天合计」;每个聊天具体记了多少, 看「按 QQ 聊天分组」那张卡。
许可
MIT。上游项目的版权与许可见 NOTICE.md。