dsh-memorytree-rule 1.0.2 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +6 -6
- package/cordis.patch.yml +2 -0
- package/docs/DETAIL.md +4 -4
- package/docs/EMOTION.md +12 -10
- package/examples/AGENTS.template.md +1 -1
- package/lib/emotion.mjs +2 -2
- package/lib/runtime.mjs +3 -3
- package/lib/tools.mjs +1 -1
- package/package.json +2 -2
- package/tests/emotion.test.mjs +18 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# 更新记录
|
|
2
2
|
|
|
3
|
+
## 1.1.0(2026-11-18)
|
|
4
|
+
|
|
5
|
+
- **情感候选采集改为默认开启**:`emotionCapture` 默认 `true`,装上即可用;不想用设 `emotionCapture:false` 关闭,重启 DSH 生效。采集仍是本机行为(0 token、不调 LLM、不联网),候选只留脱敏节选、30 天过期、不直接写记忆。
|
|
6
|
+
- **文档与配置同步**:`cordis.patch.yml` 显式列出 `emotionCapture: true`;README、EMOTION.md、DETAIL.md、AGENTS 模板写清默认开启、关闭方法与边界。
|
|
7
|
+
- **测试**:情感用例改为验证「未配置时默认采集、显式 false 关闭」,总数仍 103。
|
|
8
|
+
|
|
3
9
|
## 1.0.2(2026-11-18)
|
|
4
10
|
|
|
5
11
|
- **可选情感候选采集**:新增 `emotionCapture`(默认 `false`)。开启后监听 `session/event`,本地按情绪/记忆/关系/工作挫折等规则打分,≥35 分才入候选;每会话每天 6 条、全局 12 条、插件类别 4 条;正文 800 字 + 上下文 240 字;30 天过期。不联网、不调 LLM。
|
package/README.md
CHANGED
|
@@ -47,11 +47,11 @@
|
|
|
47
47
|
| `memory_ingest` | `sync` 把 `AGENTS.md` 的 §1 主干同步成索引;`migrate` 迁移旧库;`status` 看环境。 |
|
|
48
48
|
| `memory_daily` | 每日分拣:出报告(待分拣叶、聚类、陈旧卡、过期项),或一次提交去枝/遗忘决定。 |
|
|
49
49
|
| `memory_admin` | `doctor` / `stats` / `reindex` / `export` / `import` / `audit` / `report` / `diary` / `placement`。 |
|
|
50
|
-
| `memory_emotion` |
|
|
50
|
+
| `memory_emotion` | 情感候选日结:`list` / `mark` / `stats` / `budget` / `report`;只动候选表,不直接写记忆。 |
|
|
51
51
|
|
|
52
|
-
##
|
|
52
|
+
## 情感候选采集(默认开启,可关闭)
|
|
53
53
|
|
|
54
|
-
|
|
54
|
+
插件默认**开启**本地候选采集:在本地按规则挑出可能值得回顾的片段,先脱敏、截断、打分,存进 `emotion_candidate`。采集到的只是「候选」,不是记忆:30 天后自动清理,真正的记忆仍由 `memory_write` 写入;不想用就设 `emotionCapture: false`,重启 DSH 后停止。
|
|
55
55
|
|
|
56
56
|
```json
|
|
57
57
|
{
|
|
@@ -103,7 +103,7 @@
|
|
|
103
103
|
- 写入默认脱敏:常见密钥、`Bearer`、`password/secret/token/api_key = …`、邮箱、长数字串、`openid`/`qq` 值。
|
|
104
104
|
- 全量导出:`memory_admin action=export`(JSONL);审计:`memory_admin action=audit`。
|
|
105
105
|
- 日记:`memory_admin action=diary`;只写「库内当天发生了什么」的索引,不写会话正文;手写日记不会被自动覆盖(`force=true` 才行)。
|
|
106
|
-
-
|
|
106
|
+
- 默认在本地按规则挑情感候选:0 token、不联网、不调外部 API;候选先脱敏、只留节选、30 天过期,不写记忆。设 `emotionCapture: false` 可关闭,关闭后不再读会话正文。
|
|
107
107
|
- 主干正本始终是 `AGENTS.md`;只有看板里显式确认的「写入正本」才会改它,改前备份、改后回读校验。
|
|
108
108
|
|
|
109
109
|
## 命令行
|
|
@@ -129,12 +129,12 @@ node bin/mt.mjs report --out report.html
|
|
|
129
129
|
node --test tests/memory-tree.test.mjs tests/renumber.test.mjs tests/trunk-bucket.test.mjs tests/regressions.test.mjs tests/emotion.test.mjs
|
|
130
130
|
```
|
|
131
131
|
|
|
132
|
-
103 个用例、5 个测试文件,覆盖分词、脱敏、空结果诚实、作用域隔离、默认作用域与全库检索、`init` 备份/拒绝覆盖、主干候选规则、取代、归档/硬删、任务卡唯一、`AGENTS.md` 解析与幂等同步、旧库迁移、每日分拣、过期降权、JSONL
|
|
132
|
+
103 个用例、5 个测试文件,覆盖分词、脱敏、空结果诚实、作用域隔离、默认作用域与全库检索、`init` 备份/拒绝覆盖、主干候选规则、取代、归档/硬删、任务卡唯一、`AGENTS.md` 解析与幂等同步、旧库迁移、每日分拣、过期降权、JSONL 往返、日记自动索引与手写保护、工具渲染内容块契约、看板自包含与关键组件、看板写正本/备份/信任升档、客户端侧栏入口契约、规则归枝,以及情感候选的提取/打分/分类/脱敏/去重/上限/默认开启与显式关闭/预算/迁移。测试全部用临时目录隔离,不碰真实库。
|
|
133
133
|
|
|
134
134
|
## 明确没做的
|
|
135
135
|
|
|
136
136
|
- **不做自动注入**:不会每轮把记忆塞进系统提示,避免与「单一注入源」冲突;召回靠模型主动调 `memory_search`。
|
|
137
|
-
-
|
|
137
|
+
- **默认只落候选,不自动写记忆**:情感候选默认开启,但只进 `emotion_candidate`,不直接改记忆;设 `emotionCapture: false` 关闭后,入库只走显式 `memory_write` 与每日分拣。
|
|
138
138
|
- **不是自动写记忆**:候选要经过日结判断,写不出第一人称感受的候选会被丢弃;插件不替用户决定什么是「值得记的」。
|
|
139
139
|
- **不做加密**:库是明文 SQLite,靠脱敏与文件权限;需要加密请用磁盘加密或容器卷。
|
|
140
140
|
- **不是神经语义检索**:字符 n-gram 只做措辞相近加分;没命中会如实说没有。
|
package/cordis.patch.yml
CHANGED
package/docs/DETAIL.md
CHANGED
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
- `memory_ingest`:`sync` 同步 `AGENTS.md` §1;`migrate` 迁移旧库;`status` 看环境。
|
|
35
35
|
- `memory_daily`:生成待分拣报告,或一次提交去枝/遗忘决定。
|
|
36
36
|
- `memory_admin`:`doctor` / `stats` / `reindex` / `export` / `import` / `audit` / `report` / `diary` / `placement`。
|
|
37
|
-
- `memory_emotion
|
|
37
|
+
- `memory_emotion`:情感候选日结(`list` / `mark` / `stats` / `budget` / `report`);采集默认开启(可配 `emotionCapture: false` 关闭),只动候选表,不直接写记忆。
|
|
38
38
|
|
|
39
39
|
## 看板与命令行
|
|
40
40
|
|
|
@@ -57,13 +57,13 @@ node bin/mt.mjs report --out report.html
|
|
|
57
57
|
|
|
58
58
|
- 库在 `<DSH_HOME>/memory-tree/memory.db`,WAL 单文件,可整体备份。
|
|
59
59
|
- 写入默认脱敏:常见密钥、`Bearer`、`password/secret/token/api_key = …`、邮箱、长数字串、`openid`/`qq` 值。
|
|
60
|
-
-
|
|
61
|
-
-
|
|
60
|
+
- 默认在本地按规则挑情感候选:0 token、不联网、不调 LLM;候选先脱敏、只留节选、30 天过期,不写记忆。插件 cwd 用 `emotionPluginCwdPatterns` 配置,不内置具体平台;设 `emotionCapture: false` 关闭。
|
|
61
|
+
- 情感采集默认开启;关闭方法、候选字段、日结流程见 [EMOTION.md](./EMOTION.md)。
|
|
62
62
|
- 主干正本始终是 `AGENTS.md`;只有看板里显式确认的「写入正本」才会改它,改前备份、改后回读校验。
|
|
63
63
|
|
|
64
64
|
## 边界
|
|
65
65
|
|
|
66
66
|
- 不做自动注入:不会每轮把记忆塞进系统提示,召回靠主动调用 `memory_search`。
|
|
67
|
-
-
|
|
67
|
+
- 情感候选默认采集,但只落候选表,不直接改记忆;设 `emotionCapture: false` 关闭后,入库走显式 `memory_write` 与每日分拣。
|
|
68
68
|
- 向量检索是字符 n-gram 特征哈希,只用于措辞相近加分,不是神经语义模型;没命中不会编造。
|
|
69
69
|
- 看板是快照,实时数据仍以 `memory.db` 为准。
|
package/docs/EMOTION.md
CHANGED
|
@@ -1,20 +1,22 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 情感候选采集(默认开启,可关闭)
|
|
2
2
|
|
|
3
3
|
这个功能不是「自动写记忆」,而是给情感枝加一个**本地候选池**:插件在会话事件里按规则挑出可能值得回顾的片段,先脱敏、截断、打分,存进 `emotion_candidate`;真正写不写、写成什么,仍由你在日结时用 `memory_write` 决定。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
默认开启。不想用就在配置里设 `emotionCapture: false`,重启 DSH 后不再采集。
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## 为什么默认开启
|
|
8
8
|
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
9
|
+
- 装上就能用:不用先翻文档、改配置才知道插件有这项能力。
|
|
10
|
+
- 采集全程在本机:0 token、0 网络请求、不调 LLM;候选先脱敏、只留节选、30 天自动清理,不写记忆。
|
|
11
|
+
- 默认开启不等于自动写记忆:候选只是线索,写不写、写成什么仍由日结时的 `memory_write` 决定;插件不会自动建日结任务,不建就没有模型成本。
|
|
12
|
+
- 代价说清:会读本地会话的 text 块,并在 `emotion_candidate` 里留下节选;不能接受时设 `emotionCapture: false`,重启后不再采集。
|
|
12
13
|
|
|
13
14
|
## 配置
|
|
14
15
|
|
|
15
16
|
在 DSH 的插件配置里给 `dsh-memorytree-rule` 加(具体层级以你的 DSH 配置格式为准):
|
|
16
17
|
|
|
17
18
|
```yaml
|
|
19
|
+
# 默认开启;设为 false 关闭
|
|
18
20
|
emotionCapture: true
|
|
19
21
|
emotionMinScore: 35
|
|
20
22
|
emotionPluginCwdPatterns:
|
|
@@ -25,7 +27,7 @@ emotionRetentionDays: 30
|
|
|
25
27
|
|
|
26
28
|
| 配置 | 默认 | 说明 |
|
|
27
29
|
|---|---|---|
|
|
28
|
-
| `emotionCapture` | `
|
|
30
|
+
| `emotionCapture` | `true` | 默认采集;设 `false` 关闭(其它非 `true` 值也按关闭处理)。 |
|
|
29
31
|
| `emotionMinScore` | `35` | 候选入池的最低分;调高更严,调低更松。 |
|
|
30
32
|
| `emotionPluginCwdPatterns` | `[]` | 插件会话的 cwd 子串列表;命中才把候选归为 `plugin`。不内置任何平台名。 |
|
|
31
33
|
| `emotionReviewCostCapCny` | `0.3` | 日结预算上限(元);`memory_emotion budget` 用。 |
|
|
@@ -47,7 +49,7 @@ emotionRetentionDays: 30
|
|
|
47
49
|
- **上限**:每会话每天 6 条、全局 12 条、`plugin` 类别 4 条;同一会话内按分数取前几条。
|
|
48
50
|
- **截断**:正文最多 800 字,另存 240 字上下文;不保存整段会话。
|
|
49
51
|
- **去重**:`sha1(session_id + role + day + text)`,同一天同一条消息只入一次。
|
|
50
|
-
- **脱敏**:候选正文先过本地脱敏(密钥、`Bearer`、邮箱、长数字、`openid`/`qq` 值、访客昵称与 @
|
|
52
|
+
- **脱敏**:候选正文先过本地脱敏(密钥、`Bearer`、邮箱、长数字、`openid`/`qq` 值、访客昵称与 @ 提及)。脱敏是尽力而为,不保证覆盖所有敏感格式;如果环境里可能有人查看本机库,自行评估要不要保留采集。
|
|
51
53
|
|
|
52
54
|
## 候选长什么样
|
|
53
55
|
|
|
@@ -74,7 +76,7 @@ emotionRetentionDays: 30
|
|
|
74
76
|
|
|
75
77
|
- 采集:0 token、0 网络请求、不调 LLM;只在本地 SQLite 写候选。
|
|
76
78
|
- 日结:模型读候选 + 写记忆的 token,按你自己的模型价格算;`budget` 会读本机 DSH 成本账本(如果存在),读不到就明确说「账本未读到」,不编造数字。
|
|
77
|
-
- 硬上限:`emotionReviewCostCapCny` 只是 `budget`
|
|
79
|
+
- 硬上限:`emotionReviewCostCapCny` 只是 `budget` 的提示,不会自动阻止模型调用;要真正停,把 `emotionCapture` 设为 `false`,或不要建日结任务。
|
|
78
80
|
|
|
79
81
|
## 关闭与清理
|
|
80
82
|
|
|
@@ -89,7 +91,7 @@ emotionRetentionDays: 30
|
|
|
89
91
|
- 只处理 text 块;图片、语音、工具结果不采集。
|
|
90
92
|
- 不自动写记忆、不自动归枝、不自动改 `AGENTS.md`。
|
|
91
93
|
- 不做跨会话拼接;每条候选只带 240 字上下文。
|
|
92
|
-
-
|
|
94
|
+
- 脱敏是尽力而为;默认开启只在本机库留节选,不能接受时设 `emotionCapture: false` 关闭。
|
|
93
95
|
|
|
94
96
|
## 排障
|
|
95
97
|
|
|
@@ -174,7 +174,7 @@
|
|
|
174
174
|
|
|
175
175
|
- **§3-2 记忆树插件卡**:
|
|
176
176
|
**subject**:`memorytree`。
|
|
177
|
-
**用途**:DSH 本地记忆树插件 `dsh-memorytree-rule`,提供 9 个 `memory_*`
|
|
177
|
+
**用途**:DSH 本地记忆树插件 `dsh-memorytree-rule`,提供 9 个 `memory_*` 工具(含情感候选 `memory_emotion`,默认开启、可配置关闭)、CLI 与星图看板;数据在 `<DSH_HOME>/memory-tree/memory.db`,主干正本是 `<DSH_HOME>/AGENTS.md`。
|
|
178
178
|
**常用命令**:`node bin/mt.mjs doctor`(自检)、`stats`(四枝统计)、`sync`(同步 AGENTS.md §1)、`search "关键词"`(检索)、`daily`(待分拣报告)、`report --out report.html`(看板)、`demo`(隔离示例库,不影响真实记忆)。
|
|
179
179
|
**坑**:① 手写 `trunk` 层只会落 `candidate`,不会冒充规则;主干 `active` 只能由 `AGENTS.md` 同步产生。② 改完插件代码要重装/重启 DSH,别只改源码就以为生效。③ 不要直接改 `memory.db`;用工具或 CLI。④ 物理删除前先导出或确认有备份。
|
|
180
180
|
**卡内路径**:`<插件安装目录>`(首次使用按实测填写)。
|
package/lib/emotion.mjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// lib/emotion.mjs — 情感枝自动收录(可选):本地采集、打分、候选表与日结数据。
|
|
2
2
|
//
|
|
3
3
|
// 边界(说明见 docs/EMOTION.md):
|
|
4
|
-
// -
|
|
4
|
+
// - 默认开启(emotionCapture:true);采集只在本机 SQLite 里做,不调模型、不联网;设 false 关闭。
|
|
5
5
|
// - 候选只留节选(默认 30 天清掉),不是记忆;真正写进 node 的仍走 memory_write,日结时按第一人称感受门槛筛。
|
|
6
6
|
// - 采集失败绝不影响会话:captureEmotionEvent 只返回结果,不向调用方抛错。
|
|
7
7
|
import { createHash } from "node:crypto";
|
|
@@ -239,7 +239,7 @@ function contextOf(runtime, sessionId, role) {
|
|
|
239
239
|
*/
|
|
240
240
|
export function captureEmotionEvent(runtime, session, event, opts = {}) {
|
|
241
241
|
const cfg = { ...(runtime?.config ?? {}), ...(opts ?? {}) };
|
|
242
|
-
//
|
|
242
|
+
// 默认开启;只有显式 emotionCapture:false 才关闭(其它非 true 值同样按关闭处理)。
|
|
243
243
|
if (cfg.emotionCapture !== true) return { ok: false, skipped: "disabled" };
|
|
244
244
|
|
|
245
245
|
const role = eventRole(event);
|
package/lib/runtime.mjs
CHANGED
|
@@ -23,11 +23,11 @@ function stripEmpty(obj) {
|
|
|
23
23
|
export class MemoryRuntime {
|
|
24
24
|
constructor(config = {}) {
|
|
25
25
|
// 优先级:行 config > <dataDir>/config.json > 默认值。
|
|
26
|
-
//
|
|
26
|
+
// 情感候选采集默认开启:装上即可用;不想用设 emotionCapture:false,重启后不再采集。
|
|
27
27
|
const defaults = {
|
|
28
28
|
redact: true,
|
|
29
29
|
autoSync: true,
|
|
30
|
-
emotionCapture:
|
|
30
|
+
emotionCapture: true,
|
|
31
31
|
emotionMinScore: 35,
|
|
32
32
|
emotionRetentionDays: 30,
|
|
33
33
|
emotionReviewCostCapCny: 0.3,
|
|
@@ -95,7 +95,7 @@ export class MemoryRuntime {
|
|
|
95
95
|
}
|
|
96
96
|
|
|
97
97
|
/**
|
|
98
|
-
*
|
|
98
|
+
* 情感枝采集入口。采集失败只记录,不向会话抛错;显式关闭(emotionCapture:false)时直接跳过。
|
|
99
99
|
* 返回 captureEmotionEvent 的结果,便于调用方决定是否记日志。
|
|
100
100
|
*/
|
|
101
101
|
captureEvent(session, event) {
|
package/lib/tools.mjs
CHANGED
|
@@ -833,7 +833,7 @@ const adminTool = {
|
|
|
833
833
|
const emotionTool = {
|
|
834
834
|
name: "memory_emotion",
|
|
835
835
|
description:
|
|
836
|
-
"
|
|
836
|
+
"情感枝日结工具:查看/标记本地采集的候选、看候选统计与日结预算、记录一次日结。候选由插件在会话里按本地规则打分生成(0 token,正文只留节选,默认 30 天清;采集默认开启,可配 emotionCapture:false 关闭);真正的记忆仍用 memory_write 写,本工具只动候选表与 review 表。日结流程:list 读候选 → memory_write 写 0–6 条 → mark 标记 accepted/dismissed → report 记账。候选不足就少写;写不出第一人称感受的候选宁可不写。",
|
|
837
837
|
parameters: {
|
|
838
838
|
action: { type: "string", enum: ["list", "mark", "stats", "budget", "report"], required: true, description: "list=读候选;mark=标记;stats=统计;budget=看日结预算;report=记录本次日结" },
|
|
839
839
|
day: { type: "string", description: "YYYY-MM-DD,默认今天" },
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-memorytree-rule",
|
|
3
|
-
"version": "1.0
|
|
4
|
-
"description": "Memorytree:DSH 本地记忆树插件。四枝分层(主干/情感枝/任务枝/判断叶)、按作用域隔离、逐字证据与审计、离线 BM25 + 字符 n-gram
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "Memorytree:DSH 本地记忆树插件。四枝分层(主干/情感枝/任务枝/判断叶)、按作用域隔离、逐字证据与审计、离线 BM25 + 字符 n-gram 检索、星图看板与日记索引;本地情感候选采集(默认开启、可配置关闭、不调 LLM);不联网、零外部服务。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.js",
|
|
7
7
|
"exports": {
|
package/tests/emotion.test.mjs
CHANGED
|
@@ -8,6 +8,7 @@ import { DatabaseSync } from "node:sqlite";
|
|
|
8
8
|
import { openMemoryDb } from "../lib/db.mjs";
|
|
9
9
|
import { MemoryStore } from "../lib/store.mjs";
|
|
10
10
|
import { currentVersion, SCHEMA_VERSION } from "../lib/schema.mjs";
|
|
11
|
+
import { MemoryRuntime } from "../lib/runtime.mjs";
|
|
11
12
|
import { localDate } from "../lib/diary.mjs";
|
|
12
13
|
import {
|
|
13
14
|
budgetFor,
|
|
@@ -92,14 +93,28 @@ test("分类:主会话用户 / 插件 cwd / 助手工作复盘", () => {
|
|
|
92
93
|
assert.equal(classifyEvent(mainSession, assistantEvent("又崩了,报错修了一晚上,还是失败。")).category, "work");
|
|
93
94
|
});
|
|
94
95
|
|
|
95
|
-
test("
|
|
96
|
-
const
|
|
96
|
+
test("默认开启:未配置 emotionCapture 时也采集;显式 false 关闭", () => {
|
|
97
|
+
const dir = fs.mkdtempSync(path.join(os.tmpdir(), "mt-emo-default-"));
|
|
98
|
+
const rt = new MemoryRuntime({ dataDir: dir });
|
|
97
99
|
try {
|
|
100
|
+
assert.equal(rt.config.emotionCapture, true);
|
|
98
101
|
const res = captureEmotionEvent(rt, mainSession, userEvent("我今天很难过,想起以前的事。"));
|
|
102
|
+
assert.equal(res.ok, true, JSON.stringify(res));
|
|
103
|
+
} finally {
|
|
104
|
+
rt.close();
|
|
105
|
+
fs.rmSync(dir, { recursive: true, force: true });
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
const offDir = fs.mkdtempSync(path.join(os.tmpdir(), "mt-emo-off-"));
|
|
109
|
+
const offRt = new MemoryRuntime({ dataDir: offDir, emotionCapture: false });
|
|
110
|
+
try {
|
|
111
|
+
assert.equal(offRt.config.emotionCapture, false);
|
|
112
|
+
const res = captureEmotionEvent(offRt, mainSession, userEvent("我今天很难过,想起以前的事。"));
|
|
99
113
|
assert.equal(res.ok, false);
|
|
100
114
|
assert.equal(res.skipped, "disabled");
|
|
101
115
|
} finally {
|
|
102
|
-
|
|
116
|
+
offRt.close();
|
|
117
|
+
fs.rmSync(offDir, { recursive: true, force: true });
|
|
103
118
|
}
|
|
104
119
|
});
|
|
105
120
|
|