前言¶
DeepSeek Harness（DSH）把能力拆成插件，宿主侧工具与 Web 客户端可以同包安装。若你希望在 Harness 里放一个不抢主对话、又有持续状态的小角色，常见做法是另起服务或手写状态文件；dsh-fishtank 把「鱼」本身做成一份可导出 JSON，Host 插件管数据与定时逻辑，Web 半侧提供鱼缸页，二者通过同源路由交互。
下面介绍插件定位、能力、安装方式与典型用法。
这是什么¶
dsh-fishtank 由维护者 yuyu520fish 发布，在 SkillHub 社区目录中归类为「趣味换装」。README 将其描述为：一条属于 DeepSeek Harness 的小鱼，自带记忆、心情、关系、独处时的念头和日记，并在会话之间记住你；它不是聊天机器人外壳，鱼即数据，所知内容集中在一个 JSON 文件中，可导出、备份并迁移到其他机器。
核心功能¶
经 README 核实，插件主要提供以下行为：
- 对话：以角色口吻短句回复，不切换成助手腔。
- 记忆：记录被告知的事实，并附带当时的心情、原因与日期（例如「下周五」会落成具体日期）。
- 情绪与精力：心情与 energy 随对待方式与对话量变化。
- 识人：按对话对象维护 warmth 分数。
- 独处思考：约 25 分钟无互动后可能产生 private thought；晚间会反思并写 diary。
- 断线记忆：被踢出或登出后不会假装无事发生。
Host 侧暴露四个工具：
| 工具 | 用途 |
|---|---|
fishtank_talk |
对鱼说话（参数 text，可选 from） |
fishtank_status |
查看目录、心情、计数等状态 |
fishtank_export |
导出整条鱼为可携带 JSON |
fishtank_import |
用 fishtank_export 的输出恢复，替换当前鱼 |
Web 半侧增加真实鱼缸页：状态行、对话气泡、输入框，以及最近一条 whisper / diary。页面通过同源路由 /fishtank/state 与 /fishtank/talk 与 Host 通信。
默认数据文件为 ~/.dsh/fishtank/default/fish.json，结构包含 mood、energy、facts[]、people{}、whispers[]、reflections[]、diary[]、self、history[]、thought{}、reflect{}。fishtank_export 输出形如 { v, exportedAt, fish }；fishtank_import 接受该格式并覆盖当前鱼。
安装与启用¶
包声明 dsh.bundle，插件管理器可从源码安装同一 bundle。官方说明支持从插件市场（Discover）安装，或直接使用仓库地址（两种方式安装同一包）：
https://github.com/yuyu520fish/dsh-fishtank
bundle 同时包含 Host 插件（鱼、数据与定时器）与 Web 客户端（鱼缸页及侧栏图标）。安装后刷新页面，在左侧侧栏点击 鱼缸 进入界面。
运行环境（来自 package.json）：Node ^22.19.0 || >=24.0.0，DSH >=0.1.7-rc.2 || >=0.2.0-rc.2。当前包版本为 0.1.0，许可证 MIT。
典型用法¶
- 按上文方式安装并 reload，从侧栏打开鱼缸页，在输入框中与鱼对话（底层可走 Web 路由或 Host 工具
fishtank_talk）。 - 需要查看状态时调用
fishtank_status。 - 迁移或备份前执行
fishtank_export，保留导出 JSON；在新环境用fishtank_import恢复。
可选配置（均为 optional）：
| 键 | 默认值 | 含义 |
|---|---|---|
fishFile |
~/.dsh/fishtank/default/fish.json |
鱼数据路径 |
provider |
deepseek-account |
LLM provider id |
model |
deepseek-flash |
模型 id |
ownerName |
主人 |
对主人的称呼 |
适用场景与注意¶
适合希望在 DSH 工作台里长期养一个轻量、可备份的角色状态、又不把逻辑散落在多处脚本的开发者。独处思考、日记与 export/import 更偏「陪伴 + 可迁移数据」，而非替代主 Agent 的任务编排。
插件在当前 DSH 进程权限下运行，会读写本地 fishFile 并调用所配置的 LLM provider；安装前应阅读 GitHub 仓库 源码与 MIT 许可证。SkillHub 目录页为社区收录站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-fishtank 把「一条会记仇、会写日记的小鱼」收进单文件 JSON，并用 Host + Web 双半侧接入 Harness。目录与源码：
- 目录页：https://www.skillhub.cn/plugins/yuyu520fish/dsh-fishtank
- GitHub：https://github.com/yuyu520fish/dsh-fishtank
