Skip to content
Back to search

dsh-remembers

Long-term memory for DeepSeek Harness, built for companion AI. It says it does not remember instead of making things up. 情感陪伴向记忆插件:向量 + 中文 BM25 + 分层衰减。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/derkinl--dsh-remembers/badge.svg)](/listings/derkinl--dsh-remembers)

HTML

<a href="/listings/derkinl--dsh-remembers"><img src="/api/listings/derkinl--dsh-remembers/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 154 lines
  1. # dsh-remembers
  2. > **她记得。想不起的时候,她会说想不起。**
  3. 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 做的**人格 + 记忆**插件,为情感陪伴场景设计——不是给代码助手用的。
  4. ```
  5. 你:哎
  6. 她:[想起 3 个月前那通凌晨两点的电话] ……还在想那天的事。
  7. ```
  8. 不是「检索到相关文档」,是「她记得你说过什么」。
  9. 人格每轮必带,记忆按相关性出现,学说话让她的句子像人说的。
  10. **两部分**:
  11. - DSH 插件(Node)——人格段、记忆召回、21 个工具、左边栏「她的记忆」面板(9 张卡)。
  12. - 记忆服务(Python + SQLite,独立进程)——分层记忆、LLM 抽取、向量/关键词检索、定时调度。
  13. ---
  14. ## 功能
  15. | 类别 | 能力 | 文档 |
  16. |---|---|---|
  17. | **分层记忆** | L0 原话 → L1 事实 → L2 画像 → L3 事件 → L4 里程碑;BM25 + 向量 + 时间衰减 + 诚实出口 | [memory](docs/features/memory.md) |
  18. | **人格注入** | 身份卡 / 形象 / 主人画像 / 铁律 / 口音,走 systemPrompt 独立段,每轮必带 | [persona](docs/features/persona.md) |
  19. | **学说话** | 参考语料(1020 条默认 + 抓来的原句,每轮挑 1–2 句贴现场)+ 口音档案(从**她自己说过的话**统计,每 3 天写进人格) | [phrases](docs/features/phrases.md) |
  20. | **表情包** | 按情绪/关键词找图、学图、多图库、发送频率(0 / 20% / 50% / 100%) | [memes](docs/features/memes.md) |
  21. | **日记** | 23:00 提醒她写;`write_diary` 她自己写、`read_diary` 翻旧账(连当天活动一起返回) | [persona](docs/features/persona.md) |
  22. | **主动消息** | 内置调度:唤醒 / 刷 B 站 / 逛贴吧 / 写日记 / 自我认知,不依赖 cron | [proactive](docs/features/proactive.md) |
  23. | **贴吧** | 逛吧、读帖、楼中楼、回帖;回帖时给几句「那个吧的人这么说的」当参考 | [tieba](docs/features/tieba.md) |
  24. | **B 站** | 刷视频、看视频(字幕 + 九宫格帧)、发评论 | [bili](docs/features/bili.md) |
  25. | **QQ 通道** | 接第三方 onebot 插件;主动唤醒靠它才真的开口 | [qq](docs/features/qq.md) |
  26. | **设置页** | 12 家厂商的对话/向量模型(带 logo 和常用模型下拉)、密钥脱敏、热生效 | [settings](docs/features/settings.md) |
  27. | **语气后处理** | `tone_fix`:纯规则压标点、破折号换逗号、可选句尾尾巴 | [tone](docs/features/tone.md) |
  28. ## 快速开始
  29. 前置:**Node.js ≥ 22.19**、**Python ≥ 3.10**、DSH 0.2.x。
  30. ### Windows
  31. ```powershell
  32. git clone https://github.com/derkinL/dsh-remembers
  33. cd dsh-remembers
  34. .\install.ps1 -Profile desktop
  35. ```
  36. ### Linux / VPS(推荐)
  37. ```bash
  38. git clone https://github.com/derkinL/dsh-remembers
  39. cd dsh-remembers
  40. bash install.sh # 默认 web profile
  41. sudo bash service/deploy/deploy-native.sh # 开机自启 + 崩溃重启(systemd)
  42. ```
  43. ### 装完三步
  44. 1. 填 key:`service/.env`(Windows 是 `service/.env.win`)→ `CMEM_LLM_KEY=sk-xxx`
  45. —— 或者启动后在「她的记忆 → 记忆服务」里填,热生效。
  46. 2. 重启 DSH。
  47. 3. 左边栏「插件」下面会出现 **她的记忆**。
  48. 不填 key 也能跑:原话会存成 L0,只是不会抽事实、不会写日记。
  49. 详细步骤与排错:[Windows](docs/deploy/windows.md) · [Linux/VPS](docs/deploy/linux.md) · [Docker](docs/deploy/docker.md)
  50. ## 工作原理
  51. ```
  52. 用户说话
  53. ├─ agent/pre-step 画像(一次)→ 发言人说明 → 记忆召回 → 状态块
  54. ├─ 模型回答
  55. └─ session/event 写 L0 → 异步抽 L1/L2/L3 → 情绪/亲密度/活动 → 攒够压 episode
  56. ```
  57. 人格走 `systemPrompt`(稳定,缓存友好),召回和状态走追加消息(每轮会变)。
  58. 细节见 [架构](docs/architecture.md)。
  59. ## 项目结构
  60. ```
  61. dsh-remembers/
  62. ├─ index.mjs 主机插件:人格段 / 4 个钩子 / 21 个工具
  63. ├─ client.js 浏览器插件:左栏入口 + 9 个面板(单文件,DSH 前端常态)
  64. ├─ client.mjs 插件 → 服务的 HTTP 客户端
  65. ├─ config.mjs 配置解析(patch config > env > 默认)
  66. ├─ cordis.patch.yml bundle patch(插入插件行 + 自带 custom 预设)
  67. ├─ icon.png locale/ 插件页图标与文案
  68. ├─ tools/
  69. │ ├─ tone.js 纯规则语气后处理
  70. │ └─ tieba/ 贴吧 CLI(服务端 subprocess 调用)
  71. ├─ service/ 记忆服务(Python)
  72. │ ├─ server.py 90+ 个路由 + 配置热重载
  73. │ ├─ memory_core.py SQLite / BM25 / 向量 / 衰减
  74. │ ├─ extractor.py LLM 抽取 + 转正
  75. │ ├─ scheduler.py 唤醒 / B站 / 贴吧 / 日记 / 演化
  76. │ ├─ seeds.json 默认语料(随包发布)
  77. │ ├─ schema.sql static/ deploy/
  78. │ └─ data/ 运行时数据(gitignore)
  79. ├─ tests/ node + python 测试
  80. ├─ docs/ 架构 / 每个功能一份文件树 / 部署 / 体检报告
  81. ├─ ops/ 个人 VPS 脚本与第三方补丁(与安装无关)
  82. ├─ install.mjs/.sh/.ps1
  83. └─ run_all_tests.sh/.ps1
  84. ```
  85. 每个功能点对应哪些文件,见 [docs/features/](docs/features/) 里各篇的文件树。
  86. ## 配置
  87. 两层,互不干扰:
  88. | 层 | 位置 | 谁改 |
  89. |---|---|---|
  90. | 插件 | profile 的 `cordis.patch.yml`、环境变量 `CMEM_*` | 手工 |
  91. | 服务 | `service/data/config.json`(设置页写)、`service/.env` | 设置页 / 安装脚本 |
  92. 常用环境变量:`CMEM_PORT`(默认 8080)、`CMEM_HOST`(默认 127.0.0.1)、`CMEM_DATA_DIR`、`CMEM_EXTRACT`、`CMEM_SCHEDULER=0`(关调度)、`CMEM_INJECT_PATH`(QQ 注入文件)。
  93. ## 功能可用性(重要)
  94. 装完就有的是**记忆 + 人格 + 语料库 + 表情包 + 设置**。下面这些要额外条件,不满足不会崩,只是没效果:
  95. | 功能 | 需要 |
  96. |---|---|
  97. | 记忆抽取 / 日记 / 转正 | LLM key |
  98. | 语义召回 | embedding(不配就 BM25) |
  99. | 主动开口 | QQ 通道(`dsh-onebot-qq` + NapCat) |
  100. | 贴吧(默认关) | Node + 贴吧 Cookie;开了才会逛,回帖另算 |
  101. | B 站(默认关) | 外部 `bili-cli`,用 `CMEM_BILI_DIR` / `CMEM_NODE_BIN` 指过去;开了才刷 |
  102. 完整矩阵:[compatibility](docs/compatibility.md)。
  103. ## 测试
  104. ```bash
  105. bash run_all_tests.sh # 或 Windows: .\run_all_tests.ps1
  106. ```
  107. 5 个 Python 套件(检索/门控/迁移/解析/门槛)+ 3 个 Node 套件(主机注册面、前端 9 页、语气规则)。当前 **8/8 全绿**。
  108. ## 已知问题
  109. 完整清单在 [体检报告](docs/audit.md),最值得知道的三条:
  110. 1. **B 站/贴吧默认关闭**:要开了才动;B 站还要外部 `bili-cli`(路径现在可用环境变量指定)。
  111. 2. **没有 QQ 通道时主动唤醒只写日志**,不会真的发消息。
  112. 3. **`slang` 表是上一代机制**:已停写,只留读接口兼容老数据。
  113. ## 许可
  114. MIT。默认语料来自 [dsh-fish-tone-flavor](https://github.com/MX3a48c5/dsh-fish-tone)(MIT),贴吧 CLI 基于 [dsh-tieba-dive](https://github.com/Topkill/tiebaskill)(见 `tools/tieba/LICENSE-tieba-dive`)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.