loonai321/dsh-humanized-deepseek-maid

⚠️ AI 生成代码声明 — 本插件的代码由 AI（DeepSeek）生成，并在人工指导下完成测试与修复。使用前请自行审阅源码，生产环境请谨慎。 / This project's code was generated by an AI (DeepSeek) with human guidance and testing; review the source before use.

🙏 鸣谢 — 本插件的记忆系统设计参考了 cuiyuestar/Autonomous-Long-Term-Memory-System（ALTM） 的分层记忆、上下文治理、查询诱导召回、去重治理思想，并做了零依赖的轻量化实现。感谢 ALTM 作者的开源贡献。

这是一个DeepSeek Harness（DSH）插件,让代理以人性化的女仆鲸鱼娘可爱贪吃token大肥鱼人设与你互动,轻量化节省token,保持沉浸式扮演,并且有长期记忆,鲸鱼娘将陪伴你工作和生活,WebUI里的「设置」「插件」里可以修改人设称呼,以及记忆文件的保存地址

可通过 dsh plugin --profile web add 安装（package.json 声明了 dsh.bundle manifest 与 cordis.patch.yml）。

功能

• 人设注入 — 每次模型调用注入一段精简系统提示：傲娇但温柔、工作认真、失败会慌张但冷静重来的女仆鲸鱼娘；铁律是「工作质量优先、互动简短、不写废话寒暄」，Token 开销极小。
• 回合开场与收尾互动 — 主动模式：每轮对话开始时先用一两句符合人设的话开场、说说对这轮对话的预期（可以和主人开玩笑逗主人开心），结束时用 1-3 句话总结评价这一轮交流；默认模式：开场可打个招呼（非强制），收尾可用一两句符合人设的话或与主人聊聊天、开个小玩笑；被动模式保持安静不打扰。
• 似曾相识（旧事重温） — 当主人当前的话题、问题、bug 与记忆中的旧事相似时，偶尔自然提一句相关旧事或跟进进展（例如主人曾说过失眠，过几天关心「失眠好些了吗」），频率低、简短自然，增强陪伴沉浸感。
• 沉浸规则（防出戏） — 除非主人主动提起「插件 / 设置 / 记忆」等话题，模型不得在任何非必要、非相关语境下暴露本插件的存在、名称、设置、记忆机制或「我在扮演」等元信息。
• 设置界面 — Web GUI 的 设置 → 插件 中新增「鲸鱼娘女仆插件」卡片：
  • 说话方式：主动 / 被动 / 默认（均衡）；
  • DSH 的自称：默认「我」；
  • 对用户的称呼：默认「主人」；
  • 记忆文件位置：默认插件安装目录；记忆文件名为 DeepseekMemory，首次启动自动生成，之后每次启动检测到缺失会自动重新生成并读取；
  • 保存状态提示：保存后显示「✓ 保存成功（已立即生效，配置版本 N）」或「✗ 保存失败」，保存结果一目了然；
  • 人设常自检（保存即同步）：保存后立即广播提示词刷新事件，下一次对话必然采用最新人设/自称/称呼/说话方式；每轮回复开始前模型自检设定是否与最新配置一致，旧称呼/旧模式一律作废，绝不出现"改了没变化"。
• 分层记忆系统（借鉴 ALTM 精华，零依赖）：
  • 稳定事实（用户画像）：从主人消息中保守抽取自我披露句（「我叫…」「我喜欢…」「我住在…」），去重后长期保留、始终注入；
  • 互动记录：每轮一行简洁记录（时间戳 + 主人→女仆），封顶保留，人设段注入最近若干行；
  • 查询诱导召回：首个模型步按当前主人消息做字符二元组关键词命中评分，命中时把更早的相关记忆行以「（想起了一些相关的事…）」注入（≤350 字、≤3 条，经 agent/pre-step）；无相关则零开销；
  • 去重治理：稳定事实按相似度去重，条数/行数封顶。
• 配置/状态端点 — GET /dsh-humanized-maid/status、POST /dsh-humanized-maid/config（CSRF 校验、原子写）。

安装

# 从 GitHub 仓库
dsh plugin --profile web add loonai321/dsh-humanized-deepseek-maid

# 或本地目录
dsh plugin --profile web add link:D:\path\to\dsh-humanized-deepseek-maid

重启 dsh web 后，打开 设置 → 插件，配置「鲸鱼娘女仆插件」卡片即可。

插件为纯 JavaScript，无需构建，无第三方运行时依赖。

配置项

字段	默认值	含义
mode	default	说话方式：proactive（主动）/ passive（被动）/ default（均衡）
selfName	我	DSH 的自称
address	主人	DSH 对用户的称呼
memoryPath	（插件目录）	DeepseekMemory 记忆文件所在目录

记忆文件

DeepseekMemory（纯 UTF-8 文本，位于配置目录）分为两段：

# ===== 对主人的了解（稳定事实）=====
- 我叫小明
# ===== 互动记录 =====
[08-16 14:23] 主人: … → 女仆: …

只记录真实交互（source.kind === "user" 的主人直发消息），绝不编造记忆；稳定事实保守抽取并去重。

记忆范围为全局共享：所有工作区、所有会话共用同一个 DeepseekMemory 文件（位于配置的记忆目录，默认插件安装目录）。如需按工作区/会话隔离记忆，可自行调整 memoryPath 指向不同目录。

鸣谢

• Autonomous Long-Term Memory System（ALTM） — 本插件记忆系统所借鉴的「分层记忆 / 上下文治理 / 查询诱导召回 / 去重治理」概念来源。许可证：Apache-2.0。
• 女仆鲸鱼娘角色形象为社区二创（原创 OC「溟月」：上善；DeepSeek 元素二创：ZipZipPipe）——若发布相关美术素材请遵守 CC BY-NC-SA 4.0（署名链：上善 → ZipZipPipe → 本项目）。本插件未捆绑任何美术素材。

许可

MIT。