dsh-yangyu
IdentifiedMulti-character companions with optional personas, editable per-character memories, persistent chat bindings, and QQ and WeChat bot connections with QR login and refresh. QQ requires a separately inst
养鱼 · dsh-yangyu
给 DeepSeek Harness 增加一个「养鱼」入口:创建多位陪伴角色,填写或留空人设,在各自的聊天中积累独立记忆,也可以从「出游」页扫码连接微信和 QQ。
当前版本为 0.2.0。源码仓库为 YKY0521/dsh-yangyu,安装包见 GitHub Release。插件市场收录申请 #12324 已提交,等待审核;尚未发布到 npm,包名是否可用仍待确认。
可以做什么
- 从侧栏「养鱼」进入角色列表,添加、编辑或删除角色;名字、表情头像和人设均可管理,人设可以留空。
- 每个角色拥有「聊天」「人设」「记忆库」「出游」「设置」页面。通过 DSH 原生会话开始或继续对话,一个角色的多段对话共享该角色的记忆,会话绑定在重启后保留。
- 粘贴人设,导入
.md/.markdown/.txt文件;已启用dsh-persona-dafeiyu时,可选择其中一份人设文本填入。 - 查看、搜索、新增、修改和删除记忆,区分「固定资料」「相处记忆」,支持重要标记。
- 在角色设置中控制「聊天时使用记忆」和「允许聊天中记忆」。
- 导出或导入养鱼角色 JSON,包括角色设定和记忆。
- 页面使用宿主主题变量,适配明暗主题;已绑定聊天显示角色标记,可返回对应的角色管理页。
- 「出游」提供微信和 QQ 二维码、刷新、扫码确认、过期与连接状态;微信要求数字验证码时,可在页面手动填写。
- 确认连接后自动开启角色私聊,可暂停、恢复或解除本地连接。平台授权与角色备份分别保存。
dsh-persona-dafeiyu 与 dsh-dafeiyu-life 都不是必装依赖。养鱼不捆绑它们的源码、预设人设或私人记忆,也不替它们发布更新。
安装
需要 Node.js 22.12.0 或以上;包声明 DSH >=0.2.1-rc.3,本机加载与原生会话流程验证使用 DSH 0.2.1-rc.5。其他版本尚未逐一验证。
推荐安装打包好的 .tgz。将下面的示例路径替换为实际文件的绝对路径,在能运行 dsh 的终端中执行:
dsh plugin --profile desktop add "C:\path\to\dsh-yangyu-0.2.0.tgz"
开发时也可以安装本地源码目录:
dsh plugin --profile desktop add "C:\path\to\dsh-yangyu"
源码目录安装通常使用链接,安装后必须保留该目录。安装完成后重启 DSH;修改客户端代码后也需要重启。安装到其他 profile 时,请相应替换 desktop。DSH 的 bundle 与 profile 安装机制见官方打包安装文档。
从第一位伙伴开始
- 打开侧栏「养鱼」,点击添加伙伴,填写名字,例如「小鱼」。人设可以留空,之后再补充。
- 选择 DSH 工作区,然后在角色卡片或「聊天」页点击开始聊天。插件创建原生会话、绑定角色后打开对话;没有工作区时先添加一个。
- 在「人设」页调整性格与背景,在「记忆库」页填写固定资料或相处经历。
- 返回角色的「聊天」页继续已有对话,或为同一个角色开始新对话。
- 在角色的「管理 → 出游」选择微信或 QQ,点击连接后用本人的手机扫码确认;二维码过期时点刷新。微信如要求验证码,按手机提示手动填写并提交。
聊天沿用 DSH 当前配置的模型和登录状态;养鱼不提供独立的模型账号或 API Key 配置。首版建议使用 DSH 标准 Agent 预设;完全覆盖系统提示的自定义预设可能覆盖角色提示。
微信与 QQ 出游
微信使用腾讯官方 ClawBot / iLink 通道,当前只回复扫码微信用户与机器人的新文字私聊。QQ 使用本机 NapCat 的扫码服务与 OneBot 连接,只回复原配置 ownerUid / allowedUids 允许名单内的新文字私聊。群聊和媒体消息暂不接入。连接步骤与范围见 TRAVEL.md。
出游为平台和联系人建立角色绑定的独立 DSH 会话,沿用默认模型与本角色的记忆工具。模型只获得 yangyu_remember 和 yangyu_recall,私聊内容不会赋予电脑文件、终端或其他外部工具权限。会话按联系人分开,但同一角色的长期记忆仍共享;请据此选择 QQ 允许名单。
一个平台账号同时只能绑定一个养鱼角色,一套 NapCat 实例只能分配给一个角色。多 QQ 并行需要独立实例;当前页面默认发现已有本机 NapCat,不提供安装或新增实例向导。安全启动仅运行已安装的 Boot 组件,不调用会终止 QQ 的旧脚本,也不关闭正在运行的 QQ。
记忆如何工作
每条记忆归属一个角色 ID。召回只从当前会话绑定角色的记忆中选择,结合本地关键词、固定资料与重要标记排序,再将有限数量的结果放入当前回复的上下文。
「允许聊天中记忆」开启时,当前模型可调用 yangyu_remember 保存一条相处记忆,调用 yangyu_recall 检索当前角色的记忆。这是在当前聊天里提供记忆工具,不保证模型每轮都会自动提取或记住所有内容;首版没有另一个模型逐轮整理,也不额外调用 embedding 服务。是否记住一件事,可在记忆库中查看、补充或纠正。正常聊天和工具结果进入上下文仍会使用所选模型的额度。
关闭「聊天时使用记忆」会保留已有数据并暂停聊天召回与模型写入;仅关闭「允许聊天中记忆」会暂停模型写入,保留召回。手动管理记忆仍可使用。
数据、备份与删除
数据保存在当前 DSH Home 的:
$DSH_HOME/storages/dsh-yangyu/state.json
未设置 DSH_HOME 时,通常位于用户目录的 .dsh/storages/dsh-yangyu/state.json。文件包含全部养鱼角色、记忆及会话绑定;完整备份请退出写入该数据的 DSH 后复制此文件。同一个 DSH Home 目前只支持一个 profile / 宿主进程写入养鱼数据,不支持多进程并发写。
已确认的平台授权、收取游标和出游会话映射另存到同目录的 travel-private.json,二维码挑战只保存在内存。这个本地文件含授权秘密,不进入角色 JSON 导出,本版未提供独立密码加密。完整迁移需要在 DSH 停止写入后单独保存,勿将它作为人设分享或上传公开仓库。
角色导出包含人设、设置与记忆,不包含会话绑定表或 DSH 聊天正文;记忆条目可能带有来源会话标识。导入时生成新的角色与记忆 ID,并移除来源会话标识,不接管原来的聊天。角色 JSON 导入上限为 16 MiB,全部本地存储也受 16 MiB 容量限制;单个人设最多 64,000 字符,单条记忆最多 8,000 字符。分享导出文件前请检查其中的私人记忆。
删除角色会清除养鱼中的该角色、人设、记忆及会话绑定,并移除其本地出游连接,保留 DSH 原始聊天。这些旧聊天仍可能显示过去内容,不应作为另一个角色的全新对话;请为新角色新建会话。改名或修改人设不会清空原有记忆。
“暂停角色聊天”保留连接和授权,停止本地收取与回复;“解除连接”停止本地回复并忘记本地授权,不远程登出微信或 QQ。需要撤销平台授权时,请由账号本人在平台侧处理。
与现有插件共存
养鱼不会自动导入原 life 的私人记忆。为避免继承原角色的身份与生活通知,原 life 指定的主会话不能绑定养鱼角色;绑定之后出现主会话冲突时会阻止继续生成,角色管理页仍可使用。冲突期间原 life 通知可能已经进入该会话历史,即使改回主会话选择,也应为养鱼角色新建对话。养鱼会话还过滤已知的大肥鱼提示及生活工具,普通会话保持原插件行为。
这些是应用层的角色与记忆隔离,不是操作系统沙箱。用户主动要求使用宿主原生文件或终端工具时,仍遵循宿主权限。原插件更新后需要复核已知过滤范围,详情见 COMPATIBILITY.md。
旧 dsh-qq-bridge 和养鱼不能同时消费同一套 NapCat 连接。迁移时先备份旧桥配置,再停用旧桥 DSH 启用项与自动回复开关,然后连接养鱼;原聊天、旧桥历史及 life 记忆文件可保留。停用 QQ 桥不要求停用 life 或 persona。发现旧桥仍启用时,养鱼会拒绝连接或暂停该 QQ 聊天,避免重复回复。
范围与验证
当前尚未实现生活动态、B站活动、自主情绪、群聊、媒体消息、酒馆 PNG 角色卡导入或 AI 视频能力;角色 JSON 仅支持养鱼自己的备份格式。
基础 0.1.0 已验证原生安装、侧栏入口、多角色与空人设、会话创建和持久绑定、重启恢复,并使用当前 DSH 的 DeepSeek-V4.1-Flash 完成真实模型记忆写入、同角色跨会话召回与不同角色隔离测试;其他模型与自定义预设未逐一覆盖。
0.2.0 已通过 80 项自动测试,并在真实 DSH 中验证了出游页面、微信二维码显示与刷新。QQ 已复用已有 NapCat 登录会话完成一次真实私聊回复;对应模型会话归属正确,仅开放角色记忆工具。没有为测试强制退出 QQ,因此全新 QQ 扫码流程尚待验证。微信本人扫码、可能出现的验证码及微信消息往返尚待验证。完整范围见 VALIDATION.md。首次授权必须由账号本人操作手机。
开发检查与打包:
npm test
npm run check
npm pack --dry-run
npm pack
发布前的仓库、作者、npm 与市场准备见 PUBLISHING.md。更新记录见 CHANGELOG.md,许可为 MIT。
二维码由 MIT 许可的 qrcode 依赖在本地生成,无需第三方二维码图像服务。微信协议参考 Tencent/openclaw-weixin,QQ 对接 NapCatQQ 提供的本机接口。
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.2.0 | — | — |
Comments
Loading…
Similar plugins
by bamboosir1109
可扩展的 DSH QQ 角色集成包 · NapCatQQ / SnowLuma 双后端 · B站浏览、评论与回复 · GPT-SoVITS 语音 · 可塑记忆与日记 · 自主活动与本地控制台(开发预览,组件需配置)
★ 4
MIT
Python
Nov 18, 2026
dsh plugin --profile web add dsh-lanyaby wz20
A whale companion with configurable roles, emotional speech through local TTS, persistent file-based memory, QQ messaging, and half-duplex voice calls. QQ requires a NapCatQQ-compatible OneBot v11 gat
★ 9
MIT
JavaScript
Nov 2, 2026
dsh plugin --profile web add dsh-dafeiyu-dotKeeps a panel of what you must do, what you can apply for and what is worth knowing, distilled from your WeChat and QQ chat logs by one resident agent session that re-reads them on a schedule or when
★ 0
dsh plugin --profile web add dsh-chat-digestby mario841859784
QQ channel for dsh via OneBot 11 (NapCat and friends): reverse or forward WebSocket, DM and group chats, image and voice transcription, t2i text-image cards, merged forwards, and a settings page.
★ 20
BSD-3-Clause
TypeScript
Nov 16, 2026
dsh plugin --profile web add @dsh-external/dsh-onebotby Applepinea
DeepSeek Harness 接入个人 QQ插件,集成 NapCat 托管、私聊与群聊 AI 回复、QQ 空间读取和留言功能。带有左侧栏面板,可进行可视化人设与权限管理
★ 4
↓ 2.8k/wk
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add dsh-qq-accessby cheems135
QQ (NapCat / OneBot 11) bridge for DeepSeek Harness - chat with your harness from QQ, with a full management panel
★ 9
↓ 140/wk
MIT
JavaScript
Nov 18, 2026
dsh plugin --profile web add dsh-im-bridge