养鱼 · 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 安装机制见官方打包安装文档。

从第一位伙伴开始

1. 打开侧栏「养鱼」，点击添加伙伴，填写名字，例如「小鱼」。人设可以留空，之后再补充。
2. 选择 DSH 工作区，然后在角色卡片或「聊天」页点击开始聊天。插件创建原生会话、绑定角色后打开对话；没有工作区时先添加一个。
3. 在「人设」页调整性格与背景，在「记忆库」页填写固定资料或相处经历。
4. 返回角色的「聊天」页继续已有对话，或为同一个角色开始新对话。
5. 在角色的「管理 → 出游」选择微信或 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 提供的本机接口。