伙伴人设与记忆 a740411040/dsh-assist

dsh-assist

你的 AI 伙伴，带可复用角色、记忆，以及按需开启的主动聊天。

面向 DeepSeek Harness Desktop 的社区插件。

English · 简体中文 · Download · Documentation

把 Harness 里的一段对话变成可复用的 AI 伙伴：选一个角色，留住有用的记忆，再让它在一段时间没动静后主动开口聊几句。

预览版。 面向 Harness Desktop 0.2.1-rc.3。离线测试和 Windows Desktop 的安装、加载检查均已通过；真实模型下的主动聊天尚未验证。这是独立的社区项目，不是 DeepSeek 官方产品。

v0.3.0 有什么新东西？

在某个聊天里开启一次，重启后自动恢复。 重新打开原来的会话时，已保存的开启状态会恢复，设置和未回复消息计数一并还原。新聊天默认关闭；assist_idle_stop 会清除已保存的开启状态。后端必须处于运行状态。

下载插件 · 安装并启用 · 发送试用反馈

我们在找 Windows + Harness Desktop 0.2.1-rc.3 上的早期测试者。告诉我们安装、激活、重启恢复或停止这几步哪里顺利、哪里出问题。一分钟试用能帮你收集可复现的结果；模型调用走你平时的额度。不必分享私人对话或记忆文件。

它能做什么

| 能力 | 行为 |
| 可移植角色 | 带版本号的 JSON 包，包含身份、语气、问候语和记忆指引 |
| 持久记忆 | 长期笔记在同一角色内共享；短期检查点按会话隔离 |
| 主动聊天 | 按需开启的空闲触发，带冷却、免打扰时段和未回复消息上限 |
| 可分享的包 | 公开导出会略去已存记忆；私有备份需要显式开启选项 |
| 可检查的数据 | 本地 JSON 存储、命令行工具，以及有文档的格式 |

认识默认伙伴

Rice-Loving Chubby Fish Daughter —— 爱吃白饭的大肥鱼女儿 —— 是一条爱开玩笑的虚构小鱼，最爱一碗白米饭。她默认叫你「爸爸」，这个称呼随时可以改。内置角色默认说中文；想换别的语言，跟她说一声就行。
“爸爸，你的胖鱼女儿来啦！今天想要一碗热乎乎的米饭。要聊聊天，还是有什么我能帮你的？”

这只是角色语气的一个示例，不是固定回复。全新安装会自动选中这个角色。已有安装保留自己保存的角色和记忆。

角色 ID： little-fish · 定义： packs/fish.json

下载

从 v0.3.0 release 获取文件。

| 文件 | 用途 |
| dsh-assist-0.3.0.tgz | 桌面插件安装包——不要解压 |
| dsh-assist-0.3.0-source.zip | 完整源码，供开发使用 |
| SHA-256 manifest | 校验下载的文件 |

安装

下面的命令使用 Windows PowerShell。桌面端自带运行时，安装插件不需要另外装系统级 Node.js/npm。

1. 先启动一次 Harness Desktop，初始化它的配置档。在应用菜单里用 Manage dsh Command… 安装或修复它的 dsh 命令。
2. 完全退出 Desktop。 只关窗口可能只是把它隐藏了。
3. 打开新的 PowerShell 终端。确认 dsh 来自 Desktop，版本是 0.2.1-rc.3，然后安装下载好的包：

Get-Command dsh
dsh --version

$package = Join-Path $env:USERPROFILE 'Downloads\dsh-assist-0.3.0.tgz'
dsh plugin --profile desktop add $package
dsh plugin --profile desktop list

下载位置不同就改一下路径。任何命令失败就停下来。安装完成后重新打开 Desktop。

用 npm 装的独立 dsh 改不了 Desktop 的配置档。从源码目录安装、以及已有用户迁移，见安装与故障排查指南。

启用主动聊天

在目标会话里说：

用 assist_list，通过 assist_use 选中 little-fish，再读 assist_memory_read。然后调用 assist_idle_start：空闲 15 分钟后聊天，两次触发至少间隔 30 分钟，连续两次没回应就暂停，23:00 到 08:00 保持安静。

「已启用」的意思是工具返回了 enabled: true，不是模型说它会提醒你就行。

| 操作 | 工具 |
| 启用或修改设置 | assist_idle_start |
| 查看当前会话 | assist_idle_status |
| 停止后续触发 | assist_idle_stop |
安静时段使用后端的本地时区。后端必须保持运行；保存的启用状态会在重启后加载原会话时恢复，恢复前要先经过一次全新的空闲/冷却等待。新会话保持关闭。执行 Stop 也会清除已保存的启用状态。每次触发都使用选定的模型，并产生正常用量。Stop 不会撤回已经提交的一轮对话。

想快速验证一分钟，可以用 idleMinutes: 1、cooldownMinutes: 1、maxUnanswered: 1、quietStart: 0、quietEnd: 0。模型回复结束后，停止打字。大约 60–75 秒后应该触发一次；响应本身也取决于模型延迟。在你回复之前，不应出现第二次触发。然后调用 assist_idle_stop。

完整行为见 idle-chat settings。在 TRAE 或其他工具里读 SKILL.md，本身并不会提供正在运行的 Harness 定时器。本包不连接 QQ、微信或 X。

数据与开发

记忆存放在 DSH_ASSIST_HOME，没有设置时用 DSH_HOME/dsh-assist，两个变量都没设置时用 ~/.dsh/dsh-assist。公开导出会过滤已存记忆字段；它不会抹掉写进人设本身的个人信息。

独立命令行和开发需要 Node.js 20.18+。核心与命令行不需要第三方运行时依赖。

node src/cli.js init --home "$PWD\.work\demo"
npm test
npm run check
npm run release

发布脚本只构建本地产物，不会发布到 GitHub 或 npm。

文档

本 README 为双语。详细指南目前为简体中文。

安装与故障排查 · 主动聊天 · 人设格式 · 命令行参考 · 验证范围 · 更新日志

为 Harness 聊天加入可复用的人设、持续保存的记忆，以及无人回复时主动聊一句的能力。

当前为预发布版。 面向 Harness Desktop 0.2.1-rc.3，已通过离线验证和 Windows 桌面端安装、加载检查；真实模型主动聊天尚未实测。本项目是独立社区插件，并非 DeepSeek 官方产品。

v0.3.0 新增了什么？

在会话里开启一次，重启后继续陪聊。 重新打开原会话后恢复已保存的设置和连续无人回应次数；新会话默认关闭，assist_idle_stop 会取消保存的启用状态。应用后端需要保持运行。

下载安装包 · 安装与开启步骤 · 反馈试用结果

正在寻找使用 Windows + Harness Desktop 0.2.1-rc.3 的早期测试者：安装、首次开启、重启恢复、停止，在哪一步成功或遇到问题都可以反馈。一分钟试用步骤方便复现，模型调用会消耗正常用量；无需提供私人聊天和记忆文件。

功能概览

| 能力 | 说明 |
| 可移植人设 | 用版本化 JSON 封装身份、说话风格、开场白和记忆规则 |
| 持久记忆 | 长期记忆按角色共享，短期摘要按会话保存 |
| 主动聊天 | 显式开启后按空闲时间触发，支持冷却、安静时段和无人回应上限 |
| 角色分享 | 公开导出不含已存记忆，私人备份需要明确选择 |
| 可检查数据 | 本地 JSON 存储，配套命令行和格式文档 |

默认角色：爱吃白饭的大肥鱼女儿

她圆滚滚、俏皮、有自己的小主意，喜欢捧着小饭碗吃热乎乎的白饭。示例默认称呼你“爸爸”，可以随时要求更改称呼。

“爸爸，大肥鱼女儿来啦！今天也想吃一碗热乎乎的白饭。你想先聊聊天，还是让我陪你做点事情？”

这是虚构角色的示例语气，实际措辞由模型生成。全新存储首次初始化会默认选中她；已有角色与记忆不会被覆盖。

角色 ID： little-fish · 人设文件： packs/fish.json

下载与安装

在 v0.3.0 发布页 下载：

| 文件 | 用途 |
| dsh-assist-0.3.0.tgz | 普通用户安装插件，无需解压 |
| dsh-assist-0.3.0-source.zip | 完整开发源码 |
| dsh-assist-0.3.0-manifest.json | SHA-256 校验清单 |

以下为 Windows PowerShell 步骤。桌面端自带运行环境，安装插件无需另行安装系统 Node.js/npm。

1. 先启动一次 Harness Desktop，完成 profile 初始化；在应用菜单的 Manage dsh Command… 中安装或修复桌面端命令。
2. 完全退出桌面端，只关闭窗口可能仍在后台运行。
3. 打开新 PowerShell，确认 dsh 来自桌面端且版本为 0.2.1-rc.3，再安装：

Get-Command dsh
dsh --version

$package = Join-Path $env:USERPROFILE 'Downloads\dsh-assist-0.3.0.tgz'
dsh plugin --profile desktop add $package
dsh plugin --profile desktop list

下载到其他位置时修改路径；命令报错时先处理错误。确认安装后重新打开应用。
不要使用全局 npm 安装的另一个 dsh 修改 desktop profile。

源码目录安装、已有用户切换人设和故障排查见 安装指南。

开启、查询与关闭主动聊天

在目标会话中发送：

请先调用 assist_list，用 assist_use 切换到 little-fish，再调用 assist_memory_read。
然后调用 assist_idle_start：空闲 15 分钟后主动聊天，两次至少间隔 30 分钟，连续两次没人回复就暂停，23:00–08:00 不打扰。

只有工具返回 enabled: true 才算开启，模型口头说“已开启”不代表计时器已经运行。

| 操作 | 工具 |
| 开启或修改设置 | assist_idle_start |
| 查询当前会话 | assist_idle_status |
| 停止未来触发 | assist_idle_stop |

安静时段按后端本地时区计算。应用后端必须保持运行；已启用的原会话重新加载后会恢复，重新等待空闲与冷却；新会话仍需首次启用。停止会同时删除保存的启用状态。每次触发产生正常模型用量，停止不会撤回已提交的回合。

一分钟体验可设为 idleMinutes: 1、cooldownMinutes: 1、maxUnanswered: 1、quietStart: 0、quietEnd: 0。等回复完成后停止输入，约 60–75 秒应触发一个模型回合，实际回复还取决于模型速度。你再次回复前不应有第二次触发；体验后调用 assist_idle_stop。

完整参数见 主动聊天说明。只让 TRAE 等工具读取 SKILL.md，不会自动获得 Harness 计时与唤醒能力。本包不连接 QQ、微信或 X。

数据与开发

记忆优先存放在 DSH_ASSIST_HOME，其次为 DSH_HOME/dsh-assist，均未设置时使用 ~/.dsh/dsh-assist。公开导出会过滤已存记忆，但不会自动脱敏人设正文中的个人信息。

独立 CLI 和开发需要 Node.js 20.18+，核心与 CLI 无第三方运行依赖：

node src/cli.js init --home "$PWD\.work\demo"
npm test
npm run check
npm run release

发布脚本仅生成本地产物，不自动上传 GitHub 或 npm。

文档导航

安装与排错 · 主动聊天 · 角色包格式 · CLI 命令 · 验证范围 · 更新日志

Released under the MIT License. · 本项目采用 MIT 许可。