dsh-agent-soul 0.1.0 → 0.4.1
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/README.md +245 -111
- package/assets/face-good.png +0 -0
- package/assets/face-great.png +0 -0
- package/assets/face-ok.png +0 -0
- package/assets/face-sad.png +0 -0
- package/assets/face-worry.png +0 -0
- package/docs/preview.html +8 -8
- package/lib/api.js +375 -38
- package/lib/client/api.js +91 -0
- package/lib/client/app.js +122 -0
- package/lib/client/components.js +68 -0
- package/lib/client/diary-tab.js +347 -0
- package/lib/client/memory-tab.js +174 -0
- package/lib/client/mood-tab.js +198 -0
- package/lib/client/overview-tab.js +110 -0
- package/lib/client/persona-tab.js +333 -0
- package/lib/client/purpose-tab.js +71 -0
- package/lib/client/settings-tab.js +45 -0
- package/lib/client/styles.js +156 -0
- package/lib/client.js +558 -90
- package/lib/diary.js +1265 -0
- package/lib/env.js +57 -9
- package/lib/extract.js +330 -9
- package/lib/index.js +515 -24
- package/lib/memory.js +1377 -805
- package/lib/mood.js +296 -33
- package/lib/paths.js +196 -167
- package/lib/purpose.js +195 -1
- package/lib/refine.js +221 -0
- package/lib/registry.js +236 -228
- package/lib/store.js +697 -376
- package/lib/tool.js +27 -8
- package/package.json +84 -69
- package/tools/build-client.mjs +94 -0
- package/tools/sync.mjs +131 -130
package/README.md
CHANGED
|
@@ -1,60 +1,46 @@
|
|
|
1
1
|
# dsh-agent-soul
|
|
2
2
|
|
|
3
|
-
> 给 DSH 的 agent
|
|
3
|
+
> 给 DSH 的 agent 一份**会忘事的记忆**、一套**会变的人格**和一份**会起伏的心情**。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
它做五件事:
|
|
6
6
|
|
|
7
7
|
| | 解决什么 |
|
|
8
8
|
|---|---|
|
|
9
|
-
| **人格** | 用 Markdown
|
|
9
|
+
| **人格** | 用 Markdown 写「你是谁」。项目人格只覆盖同名小节,全局的照常生效 —— 不会因为某个目录里有 `AGENT.md`,你在全局写的话就整份失效 |
|
|
10
10
|
| **记忆** | 值得记的事自己进来,随时间变模糊:清晰 → 清楚 → 模糊 → 只剩印象 → 遗忘。忘了不是删掉,是**先变得说不清** |
|
|
11
11
|
| **目的** | 从记忆里长出一份「心里惦记的事」,让她的主动有连续性 —— 不是定时问候,是主动想起 |
|
|
12
|
+
| **心情** | 每轮对话后自己判一次起伏(心情值 + 七情 + 时间线),**不注入提示词**。记下来的情绪有两个出口:当日记的底色、推着目的机制的驱动 |
|
|
13
|
+
| **日记** | 开机时把**前一天**沉淀成两篇:一篇公开(可以拿给你看),一篇私密(只写给自己)。插件自己调模型生成、自己写文件,不走消息投递 |
|
|
12
14
|
|
|
13
|
-
不管 B站、不管 QQ、不管桌宠。这个插件只关心「她是谁」和「她记得什么」。
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## 从 dsh-agent-md 迁移
|
|
18
|
-
|
|
19
|
-
人格文件的**路径完全一致**,装上就能用,不用搬家:
|
|
20
|
-
|
|
21
|
-
```
|
|
22
|
-
<DSH_HOME>/AGENT.md 全局人格(它已经在这写了)
|
|
23
|
-
<DSH_HOME>/agents/projects/<slug>.md 项目人格(同 slug 规则,同一目录算出同一个 slug)
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
所以你现有的两份人格文件会被直接认领,一个字都不用改。
|
|
27
|
-
|
|
28
|
-
**行为上有一处关键差异**(也是这个插件存在的主要理由):它的人格是互斥的,我的是按小节叠加的 —— 详见下面的[人格注入区别](#人格注入和-dsh-agent-md-的区别)。
|
|
29
|
-
|
|
30
|
-
卸载 `dsh-agent-md` 时注意它 README 里写的两步都要做(`dependencies` 和 `dsh.profile.bundles` 各删一行),否则下次启动会因为「声明了却装不起来」卡住。
|
|
15
|
+
不管 B 站、不管 QQ、不管桌宠。这个插件只关心「她是谁」和「她记得什么」。
|
|
31
16
|
|
|
32
17
|
---
|
|
33
18
|
|
|
34
19
|
## 日常怎么用
|
|
35
20
|
|
|
36
|
-
|
|
21
|
+
装好之后基本**不需要操作**。想干预时有三个入口:
|
|
37
22
|
|
|
38
23
|
### 1. 什么都不做(大多数时候)
|
|
39
24
|
|
|
40
|
-
-
|
|
25
|
+
- 你说话,值得记的事自动进记忆卡
|
|
41
26
|
- 每天第一次打开,它会把不重要的事降一格清晰度
|
|
42
27
|
- 她答应过的事、没弄明白的事,自动变成「心里惦记的事」
|
|
28
|
+
- 开机时自动补写前一天的日记
|
|
43
29
|
|
|
44
|
-
### 2. 设置 →
|
|
30
|
+
### 2. 设置 → 灵魂(七个标签)
|
|
45
31
|
|
|
46
32
|
| 标签 | 用来干什么 |
|
|
47
33
|
|---|---|
|
|
48
|
-
| **概览** |
|
|
34
|
+
| **概览** | 一眼看「到底生效没有」:人格来源、记忆条数与容量、惦记几件事、**最近**(当前心情 + 昨天日记写没写) |
|
|
49
35
|
| **人格** | 直接编辑全局 / 项目人格。存完下一个回合生效 |
|
|
50
|
-
| **记忆** |
|
|
51
|
-
| **目的** |
|
|
36
|
+
| **记忆** | 搜、看清晰度和重要度、固定(永不遗忘)、删、手动加 |
|
|
37
|
+
| **目的** | 四个驱动读数 + 惦记清单,可以「放下了」 |
|
|
38
|
+
| **心情** | 心情值 + 七情 + 时间线;可重置、可手动跑一次平复 |
|
|
39
|
+
| **日记** | 开关、兜底检查间隔、公开/私密语气、手动触发(可带备注)、最近日记列表 |
|
|
52
40
|
| **设置** | 注入预算、叠加还是互斥、各项开关、立即整理一次 |
|
|
53
41
|
|
|
54
42
|
### 3. 直接跟她说话
|
|
55
43
|
|
|
56
|
-
记忆有两个工具,她自己会用,你也可以直接要求:
|
|
57
|
-
|
|
58
44
|
```
|
|
59
45
|
「记住:我下周一开始做蓝桥杯的题」
|
|
60
46
|
「你还记得我之前说过什么关于 STM32 的事吗」
|
|
@@ -64,69 +50,74 @@
|
|
|
64
50
|
|
|
65
51
|
工具是 `soul_memory`(write/recall/forget/pin/list)和 `soul_goal`(add/done/list)。
|
|
66
52
|
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
全是纯文本,用任何编辑器都行:
|
|
53
|
+
文件全是纯文本,也可以直接改:
|
|
70
54
|
|
|
71
55
|
```
|
|
72
|
-
~/.dsh/AGENT.md
|
|
73
|
-
~/.dsh/agents/memory/global.json
|
|
56
|
+
~/.dsh/AGENT.md 全局人格
|
|
57
|
+
~/.dsh/agents/memory/global.json 记忆卡(改完刷新页面生效)
|
|
74
58
|
```
|
|
75
59
|
|
|
76
60
|
---
|
|
77
61
|
|
|
78
|
-
##
|
|
62
|
+
## 人格注入
|
|
79
63
|
|
|
80
|
-
|
|
64
|
+
### 三层来源与优先级
|
|
81
65
|
|
|
82
|
-
| |
|
|
66
|
+
| 层 | 文件 | 怎么改 |
|
|
83
67
|
|---|---|---|
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
|
|
|
68
|
+
| 1 | `<cwd>/AGENT.md` | 自己的编辑器(跟着仓库走,可提交进 git) |
|
|
69
|
+
| 2 | `~/.dsh/agents/projects/<slug>.md` | 设置 → 人格 → **项目人格(本机)** |
|
|
70
|
+
| 3 | `~/.dsh/AGENT.md` | 设置 → 人格 → **全局人格** |
|
|
87
71
|
|
|
88
|
-
|
|
72
|
+
**项目层只取 1、2 里优先级最高的那一份**(不是两份合并)——两份都写着 `# 你是谁` 时,模型会各听一半,最后谁也不像。
|
|
89
73
|
|
|
90
|
-
|
|
91
|
-
# 你是谁 # 语气与形态 # 与树树的关系 # 行事准则 # 边界 # 互动约定 # 工程约定
|
|
92
|
-
```
|
|
74
|
+
### 叠加还是互斥
|
|
93
75
|
|
|
94
|
-
|
|
76
|
+
| | 互斥(`exclusive`) | 叠加(`stack`,默认) |
|
|
77
|
+
|---|---|---|
|
|
78
|
+
| 有项目人格时全局怎么办 | **整份不注入** | **按小节叠加**:项目覆盖同名小节,全局其余保留 |
|
|
79
|
+
| 你在全局写的通用约定 | 某些工作区完全不遵守,像没读到 | 到处生效,除非项目里显式覆盖同名小节 |
|
|
95
80
|
|
|
96
|
-
|
|
97
|
-
# 工程约定
|
|
98
|
-
这个项目用 Vue 3 + Vite。
|
|
99
|
-
```
|
|
81
|
+
### 什么时候注入
|
|
100
82
|
|
|
101
|
-
|
|
102
|
-
- **现在**:只有「工程约定」被替换,另外 6 个小节原样继承
|
|
83
|
+
**会话第一轮注入一次,之后每 15 轮补一次。**
|
|
103
84
|
|
|
104
|
-
|
|
85
|
+
不每轮重发(那是纯浪费),也不注入一次就再也不管 —— 上下文压缩之后会把人格正文压掉,那时她会「记得聊过什么,但不记得自己是谁」。15 轮补一次,成本可以忽略,压缩后能自己找回来。
|
|
105
86
|
|
|
106
|
-
|
|
87
|
+
> ⚠️ 如果 `<cwd>/AGENT.md` 存在,它会盖住设置页编辑的第 2 层。你在设置页改了、保存了、提示「已保存」,但其实**没生效**。页面会亮黄框提示。
|
|
107
88
|
|
|
108
|
-
|
|
109
|
-
2. **注入留痕更细**:概览页直接列出「这次注入了哪几份文件」,不用去翻 `inject-log.jsonl`。
|
|
89
|
+
---
|
|
110
90
|
|
|
111
|
-
##
|
|
91
|
+
## 记忆
|
|
112
92
|
|
|
113
|
-
|
|
114
|
-
|---|---|---|
|
|
115
|
-
| 1 | `<cwd>/AGENT.md` | 自己的编辑器(跟着仓库走,可提交进 git) |
|
|
116
|
-
| 2 | `~/.dsh/agents/projects/<slug>.md` | 设置 → 人格 → **项目人格(本机)** |
|
|
117
|
-
| 3 | `~/.dsh/AGENT.md` | 设置 → 人格 → **全局人格** |
|
|
93
|
+
### 什么会被记住
|
|
118
94
|
|
|
119
|
-
|
|
95
|
+
自动提取分三步:**过滤 → 提炼 → 打分入库**。
|
|
120
96
|
|
|
121
|
-
|
|
97
|
+
**1. 过滤(纯规则)**:只收「人在说话」。丢掉宿主注入的上下文、桥接层的触发模板、信封前缀(「(QQ 私聊·用户本人 [QQ号])」),以及她自己被桥回显的话。
|
|
122
98
|
|
|
123
|
-
>
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
99
|
+
> 信封前缀有 20 多字,会把「起了起了」这种 4 字短句凑够 8 字门槛,长度过滤直接失效。而回显的那条更糟:她的每句自言自语都会变成记忆,是自我强化的死循环。
|
|
100
|
+
|
|
101
|
+
**2. 提炼(模型)**:过了过滤的原话**不直接入库**,先交给模型改写成记忆。
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
原话:(QQ 私聊·用户本人 [QQ号])今早上7点多才起来。昨晚上在忙着给你做插件,睡的晚了。
|
|
105
|
+
记忆:树树今早七点多才起,昨晚熬夜在做插件
|
|
106
|
+
```
|
|
128
107
|
|
|
108
|
+
提示词里写死三条硬约束:写成「关于树树的一条记忆」而不是复述对话、不许编他没说过的事、**没有信息量就输出空数组**(宁可少记)。提炼失败一律退回原话直存,不丢信息。
|
|
129
109
|
|
|
110
|
+
**3. 打分入库**:过线(42)才写进卡。
|
|
111
|
+
|
|
112
|
+
| 你说的 | 结果 |
|
|
113
|
+
|---|---|
|
|
114
|
+
| 「今晚吃牛肉丸子汤」 | **不记** —— 一次性日常,记下来只占位置 |
|
|
115
|
+
| 「我手上有一块 F103 开发板」 | 记 |
|
|
116
|
+
| 「我目标是当嵌入式工程师」「我是烟台大学大二」 | 记,且**额外写一份进全局卡**(换工作区也认得你) |
|
|
117
|
+
|
|
118
|
+
打分是**纯规则 + 数值,不调模型** —— 什么时候该记、记多久,确定性比聪明重要。模型只负责把话改写成记忆,不参与「要不要记」。
|
|
119
|
+
|
|
120
|
+
### 会忘记
|
|
130
121
|
|
|
131
122
|
```
|
|
132
123
|
清晰 ──→ 清楚 ──→ 模糊 ──→ 只剩印象 ──→ 遗忘
|
|
@@ -134,24 +125,45 @@
|
|
|
134
125
|
「记不清了」「好像有…」 进 archive.jsonl
|
|
135
126
|
```
|
|
136
127
|
|
|
137
|
-
|
|
138
|
-
「……(细节记不清了)」,只剩印象的写成「好像有「xx」这件事…(想不起来了)」。
|
|
139
|
-
模型看到的是「我隐约记得」,而不是「查无此事」或者「细节完备但其实已经不可靠」。
|
|
140
|
-
|
|
141
|
-
四条规则:
|
|
128
|
+
关键不在阶梯,在**注入时的措辞**:模糊的写成「……(细节记不清了)」,只剩印象的写成「好像有「xx」这件事…(想不起来了)」。模型看到的是「我隐约记得」,而不是「查无此事」或者「细节完备但其实已经不可靠」。
|
|
142
129
|
|
|
143
|
-
-
|
|
130
|
+
- **一天只降一档**:慢慢模糊,不是某天突然想不起来
|
|
144
131
|
- **重要的事降得慢**:普通记忆每天 -0.35 留存,和主人相关的只有 -0.12
|
|
145
132
|
- **永远不会忘的**:固定的,和「第一次」类的事
|
|
146
133
|
- **提起来会变清楚**:被再次提及就刷新时间、召回 +1,一天回升一档
|
|
147
134
|
|
|
148
|
-
|
|
135
|
+
入库前脱敏(密钥 / 手机号 / 身份证 / 卡号 / 链接 / QQ 号),太短的不记。
|
|
136
|
+
|
|
137
|
+
### 注入策略
|
|
138
|
+
|
|
139
|
+
- **第一轮**:整张卡 + 一段「最近」(见下节)
|
|
140
|
+
- **之后**:按当前这句话召回相关几条,同一话题没变就复用上次的文本,不重拼
|
|
141
|
+
- **近似重复**:新记忆和已有条目字面相近时,**只记一行日志提醒,不自动替换** —— 让字符串算法决定「哪句是真的」太危险
|
|
142
|
+
|
|
143
|
+
### 「最近」:跨对话的那条通路
|
|
144
|
+
|
|
145
|
+
新会话第一轮,除了记忆卡,还会带上:
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
### 前几天的日记
|
|
149
|
+
(最近 2 天的公开日记,超 6000 字留最近的)
|
|
150
|
+
|
|
151
|
+
### 今天到目前为止(可能来自别的对话)
|
|
152
|
+
[14:20] 树树:……
|
|
153
|
+
[14:21] 我:……
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
**为什么需要**:人不会在一个对话里做完所有事 —— 修插件、QQ 聊天、闲聊是分开的会话。记忆卡只有零碎事实,日记只写到昨天,所以新开一个对话时她不知道今天早些时候在别的对话里做过什么。
|
|
157
|
+
|
|
158
|
+
数据来源是 `conversations/<今天>.jsonl` —— 这个流水本来就是**所有会话共同汇总**的(原来只用来生成日记,从没读回过会话)。
|
|
159
|
+
|
|
160
|
+
配置 `memoryRecentDiaryDays` / `memoryRecentChatChars` 控制,设 0 关闭。私密日记默认不进(`memoryRecentDiaryIncludePrivate`)。
|
|
149
161
|
|
|
150
162
|
---
|
|
151
163
|
|
|
152
164
|
## 目的机制:「主动想起」而不是「主动发消息」
|
|
153
165
|
|
|
154
|
-
|
|
166
|
+
四个驱动维度,各 0~1,**8 小时落一半**:
|
|
155
167
|
|
|
156
168
|
| 维度 | 被什么推高 |
|
|
157
169
|
|---|---|
|
|
@@ -160,14 +172,92 @@
|
|
|
160
172
|
| 想分享 | 有意思的发现、推荐 |
|
|
161
173
|
| 想搞懂 | 学会了、跑通了、踩坑了 |
|
|
162
174
|
|
|
163
|
-
|
|
164
|
-
|
|
175
|
+
再加上从记忆里长出来的「没闭合的事」,渲染成很短的一段(默认 ≤ 320 字,最多 3 条)。里面明确写着「**这不是任务清单,不需要每轮都提**」。
|
|
176
|
+
|
|
177
|
+
**心情会推着它走**:担心/心疼 → `在乎` 涨,开心/甜蜜 → `想分享` 涨。不是每轮往上加,而是让驱动**向情绪推出的目标靠拢**(每轮 15%)—— 累加式写法几十轮后会把所有驱动顶到 1,等于没有状态;靠拢则天然有收敛点。
|
|
178
|
+
|
|
179
|
+
**说出去了才算完**:渲染出去的目标会被记下来,下一轮看她有没有真的说出口。说到了 → 驱动 ×0.45;超过 6 小时没说到 → ×0.85,慢慢淡了。只判一次,判完移出列表。
|
|
165
180
|
|
|
166
|
-
|
|
167
|
-
决定权在她手里,这比硬塞一句「去问候主人」更像自主,也不容易变成复读。
|
|
181
|
+
> 本地 DSH 没有推送渠道(你不打开就没有回合),所以「主动」只能是主动想起。真正主动发消息属于 QQ 那边的事。
|
|
168
182
|
|
|
169
|
-
|
|
170
|
-
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## 心情
|
|
186
|
+
|
|
187
|
+
心情是**全局一份**(`agents/mood/global.json`),不按工作区拆。
|
|
188
|
+
|
|
189
|
+
> 2026-10-31 改的。原来每个工作区一份,实测四份分数从 71 到 99.95 —— 同一个人换个目录就换一份心情,会出现「刚在 A 里说累、切到 B 又满血」。心情是「这个人现在的状态」,不是「这个文件夹的状态」。
|
|
190
|
+
>
|
|
191
|
+
> 迁移是自动的:`global.json` 不存在时,从旧文件里挑记录最完整的那份搬过来,**旧文件保留不删**。
|
|
192
|
+
|
|
193
|
+
**七情的满格是 20 不是 100**:判定单次上限 ±10,又被 90 分钟半衰期往回磨,实测一整天峰值只到 13。所以设置页和日记都按 20 当 100% 折算 —— 「踏实 65%」是很踏实,不是刚过一半。
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
## 日记
|
|
198
|
+
|
|
199
|
+
**规则:开机时写前一天。**
|
|
200
|
+
|
|
201
|
+
当天写只写得到半天;第二天再写,昨天的窗口已经完整闭合。而且「开机写」和「一直不关机」用的是同一条逻辑 —— 都是补昨天,不用区分机器什么时候开。
|
|
202
|
+
|
|
203
|
+
```
|
|
204
|
+
DSH 启动 5 秒后 → 看昨天的两篇在不在
|
|
205
|
+
├─ 都在 → 跳过(同一天重启多次不会重写、不会白花钱)
|
|
206
|
+
└─ 缺了 → 生成并写盘 → 再往前找有没有更早漏的,补一天
|
|
207
|
+
|
|
208
|
+
看门狗每 30 分钟 → 同上检查(兜住「一直不关机」的情况)
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
**怎么写的**:插件自己调 `llm.stream` 生成,再用 Node 的 `fs` 直接写文件。
|
|
212
|
+
|
|
213
|
+
> 2026-10-31 改的。原来是把一条消息投进会话,让 agent 自己用工具写。可 `followup()` 是**同步返回 void** 的,旧判据「没抛异常就算成功」对 void 函数恒为真 —— 日志天天报「已发送」,会话里却零命中(解了 4 个会话、32 个 inbox 事件,`schedule` 来源的 0 个)。
|
|
214
|
+
>
|
|
215
|
+
> 现在两道就够:生成 → 写盘。写完就在那儿,没有中间态可以静默失败。
|
|
216
|
+
|
|
217
|
+
**生成时不先做摘要**:直接把对话原文喂进去(超上限才截尾部)。实测摘要会把 17945 字压成 128 字,且挑的全是窗口开头那段,同一天后半段整个被丢掉。
|
|
218
|
+
|
|
219
|
+
**两篇的隔离靠调用顺序**:先写公开(只带公开历史),落盘成功后才写私密(这时才给全部历史)。写在一条里的话,私密历史就摆在下面,她写公开那一步已经看到了本不该给人看的内容。
|
|
220
|
+
|
|
221
|
+
**「私密」完全靠提示词措辞** —— 文件是明文,没有加密。设置页的「最近日记」只展示公开那篇,私密只显示有/没有。
|
|
222
|
+
|
|
223
|
+
### 日记里带着当天的情绪
|
|
224
|
+
|
|
225
|
+
除了对话原文,还会附一段**情绪底色**:心情从多少走到多少、七情峰值、几段「当时她自己的想法」。
|
|
226
|
+
|
|
227
|
+
- 公开给 3 条,措辞是「可以写进去,但这是会拿给对方看的版本」
|
|
228
|
+
- 私密给 6 条,措辞是「这是你当时的真实想法,不用收着」
|
|
229
|
+
|
|
230
|
+
只给事实与素材,不给「你要写得开心一点」这类指令 —— 一旦让她照着情绪演,日记就假了。
|
|
231
|
+
|
|
232
|
+
### 一天的边界
|
|
233
|
+
|
|
234
|
+
**自然日。** 日记 `2026-10-31` 覆盖的是 **2026-10-31 00:00 ~ 2026-11-01 00:00** 的对话。心情时间线按同一个窗口筛,两边才对得上。
|
|
235
|
+
|
|
236
|
+
> 2026-10-31 从「22:00 分界」改成自然日。原来那套是给「当晚十点写日记」设计的 —— 晚上十点时「今天」在感受上还没结束。但现在已经改成「第二天写前一天」,那个理由不成立了:隔一天再写,昨天一整天早已闭合,写的是哪一天就该是哪一天。
|
|
237
|
+
|
|
238
|
+
### 对话是怎么拿到的
|
|
239
|
+
|
|
240
|
+
不是写日记时才去翻会话(冷会话拿不到),而是**平时就攒**:
|
|
241
|
+
|
|
242
|
+
```
|
|
243
|
+
每轮对话(tick 注入时)
|
|
244
|
+
└─ 扫描新增的 user/message + assistant/message
|
|
245
|
+
└─ 追加到 ~/.dsh/agents/diary/conversations/YYYY-MM-DD.jsonl
|
|
246
|
+
```
|
|
247
|
+
|
|
248
|
+
过滤口径跟记忆提取一致。助手那边**只记她说出口的话**:`reasoning` 和工具调用都不进。实测一个活跃会话里 90% 的助手消息是思考过程、只有 10% 是真正在说话,全收的话一天能攒几十万字。
|
|
249
|
+
|
|
250
|
+
JSONL 默认保留 7 天,写日记时顺手清理旧的。
|
|
251
|
+
|
|
252
|
+
### 手动触发
|
|
253
|
+
|
|
254
|
+
设置页「日记」页签点「现在写日记」,可以选日期、加备注。或者:
|
|
255
|
+
|
|
256
|
+
```bash
|
|
257
|
+
curl -X POST http://127.0.0.1:<PORT>/api/soul/diary \
|
|
258
|
+
-H 'content-type: application/json' \
|
|
259
|
+
-d '{"date":"2026-10-31","note":"今天发生了一些特别的事"}'
|
|
260
|
+
```
|
|
171
261
|
|
|
172
262
|
---
|
|
173
263
|
|
|
@@ -177,8 +267,7 @@
|
|
|
177
267
|
# 1) 取代码
|
|
178
268
|
git clone https://github.com/danshuyue/dsh-agent-soul.git "<DSH_HOME>/plugins/dsh-agent-soul"
|
|
179
269
|
|
|
180
|
-
# 2) 挂进 profile
|
|
181
|
-
# <DSH_HOME>/profiles/desktop/package.json:
|
|
270
|
+
# 2) 挂进 profile:<DSH_HOME>/profiles/desktop/package.json
|
|
182
271
|
# dependencies 加 "dsh-agent-soul": "link:../../plugins/dsh-agent-soul"
|
|
183
272
|
# dsh.profile.bundles 加 "dsh-agent-soul"
|
|
184
273
|
# 3) 建 junction(Windows)
|
|
@@ -187,21 +276,22 @@ mklink /J "<DSH_HOME>\profiles\desktop\node_modules\dsh-agent-soul" "<DSH_HOME>\
|
|
|
187
276
|
# 4) 重启 DSH → 设置 → 灵魂
|
|
188
277
|
```
|
|
189
278
|
|
|
190
|
-
|
|
279
|
+
> ⚠️ 改完 `lib/` 要同步到**运行副本**(`profiles/<profile>/node_modules/<插件>/`)—— DSH 加载的是那份,不是 `plugins/` 里的源码。同步完拿两边哈希对一下,别靠「我改过了」这个印象。
|
|
191
280
|
|
|
192
281
|
---
|
|
193
282
|
|
|
194
283
|
## 花钱的地方
|
|
195
284
|
|
|
196
|
-
|
|
285
|
+
| 项 | 频率 | 大约 |
|
|
286
|
+
|---|---|---|
|
|
287
|
+
| 人格 | 首轮 + 每 15 轮 | 你写多少就是多少 |
|
|
288
|
+
| 记忆 | 每回合 | 默认 3200 字预算,实际约 2200~3000 token |
|
|
289
|
+
| 目的 | 每回合 | ≤ 320 字,约 300~500 token |
|
|
290
|
+
| 日记 | 每天一次 | 一次生成调两次模型(公开 + 私密) |
|
|
197
291
|
|
|
198
|
-
|
|
199
|
-
(DSH 按 4 字符/token 粗算,中文真实是它的 1.4~1.9 倍)
|
|
200
|
-
- 目的段默认 ≤ 320 字,约 **300~500 token**
|
|
201
|
-
- 人格正文你写多少就是多少
|
|
292
|
+
DSH 按 4 字符/token 粗算,中文真实是它的 1.4~1.9 倍。
|
|
202
293
|
|
|
203
294
|
觉得贵:先砍 `injectMaxChars`,再考虑关「目的机制」。
|
|
204
|
-
用工具 schema 省下来的那点钱,别在这两段上花回去。
|
|
205
295
|
|
|
206
296
|
---
|
|
207
297
|
|
|
@@ -214,13 +304,33 @@ mklink /J "<DSH_HOME>\profiles\desktop\node_modules\dsh-agent-soul" "<DSH_HOME>\
|
|
|
214
304
|
| `mode` | `stack` | `stack` 叠加 / `exclusive` 互斥 |
|
|
215
305
|
| `includeGlobal` | `true` | 全局人格是否参与注入 |
|
|
216
306
|
| `projectPersonaEnabled` | `true` | 是否启用项目人格 |
|
|
217
|
-
| `injectMaxChars` | `
|
|
307
|
+
| `injectMaxChars` | `3200` | 记忆注入预算 |
|
|
308
|
+
| `memoryRecall` | `true` | 注入时按当前消息召回相关区(关掉 = 每轮回退整卡) |
|
|
309
|
+
| `memoryRecallTopK` | `3` | 相关区最多召回几条 |
|
|
310
|
+
| `memoryRecentDiaryDays` | `2` | 第一轮带几天日记(0 = 关) |
|
|
311
|
+
| `memoryRecentChatChars` | `3000` | 第一轮带多少字今天流水(0 = 关) |
|
|
312
|
+
| `memoryRecentDiaryIncludePrivate` | `false` | 「最近」里是否含私密日记 |
|
|
313
|
+
| `memoryRefine` | `true` | 自动提取时先让模型提炼(关掉 = 原话直存,会变流水账) |
|
|
314
|
+
| `memoryRefineProvider` / `memoryRefineModel` | `""` | 提炼用的模型(空 = 跟随会话模型) |
|
|
218
315
|
| `memoryEnabled` | `true` | 是否注入记忆(关掉仍在后台记) |
|
|
219
316
|
| `projectMemoryEnabled` | `true` | 项目记忆独立一张卡 |
|
|
220
317
|
| `purposeEnabled` | `true` | 是否注入「心里惦记的事」 |
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
318
|
+
| `diaryEnabled` | `true` | 是否启用日记 |
|
|
319
|
+
| `diaryWatchdogMinutes` | `30` | 兜底检查间隔(分钟) |
|
|
320
|
+
| `diaryBackfillDays` | `4` | 写新日记时参考前几天的旧日记 |
|
|
321
|
+
| `diaryOverwrite` | `true` | 同日重复触发是否覆盖 |
|
|
322
|
+
| `diaryManualNote` | `true` | 手动触发是否允许附备注 |
|
|
323
|
+
| `diaryPublicTone` / `diaryPrivateTone` | `""` | 语气(空 = 让她自己把握) |
|
|
324
|
+
| `diaryMaxConversationChars` | `30000` | 喂给日记的对话上限(超了留尾部) |
|
|
325
|
+
| `diaryPublicMoodMoments` | `3` | 公开日记带几条「当时的想法」(0 = 不带) |
|
|
326
|
+
| `diaryPrivateMoodMoments` | `6` | 私密日记带几条 |
|
|
327
|
+
| `diarySummarizeProvider` / `diarySummarizeModel` | `""` | 生成用的模型(空 = 跟随会话模型) |
|
|
328
|
+
| `diarySummarizeTimeoutMs` | `30000` | 生成调用超时 |
|
|
329
|
+
| `diaryJsonlKeepDays` | `7` | 对话 JSONL 保留天数 |
|
|
330
|
+
|
|
331
|
+
记忆引擎参数(衰减天数、阈值、压缩)在 `lib/memory.js` 的 `DEFAULTS`,全部有注释说明为什么是这个值。
|
|
332
|
+
|
|
333
|
+
> `diarySchedule`(默认 `"22:00"`)**已完全停用**:不再触发定时(定时器已删除),也不再参与日记的「一天边界」(现在是自然日)。保留这个键只是为了不让旧配置报错。
|
|
224
334
|
|
|
225
335
|
---
|
|
226
336
|
|
|
@@ -234,10 +344,14 @@ mklink /J "<DSH_HOME>\profiles\desktop\node_modules\dsh-agent-soul" "<DSH_HOME>\
|
|
|
234
344
|
<DSH_HOME>/agents/memory/projects/<slug>.json 项目记忆卡
|
|
235
345
|
<DSH_HOME>/agents/memory/purpose.json 目的状态
|
|
236
346
|
<DSH_HOME>/agents/memory/archive.jsonl 遗忘档案(append-only)
|
|
237
|
-
<DSH_HOME>/agents/
|
|
347
|
+
<DSH_HOME>/agents/mood/global.json 心情状态(全局一份)
|
|
348
|
+
<DSH_HOME>/agents/diary/conversations/YYYY-MM-DD.jsonl 当天对话流水(所有会话汇总)
|
|
349
|
+
<DSH_HOME>/agents/diary/public/YYYY-MM-DD.md 公开日记
|
|
350
|
+
<DSH_HOME>/agents/diary/private/YYYY-MM-DD.md 私密日记(明文,靠提示词区分)
|
|
351
|
+
<DSH_HOME>/agents/soul.log 日志(超 2MB 归档成 soul.log.<时间戳>,留 5 份)
|
|
238
352
|
```
|
|
239
353
|
|
|
240
|
-
|
|
354
|
+
全是纯文件,没有数据库。备份就是复制目录。
|
|
241
355
|
|
|
242
356
|
---
|
|
243
357
|
|
|
@@ -246,38 +360,58 @@ mklink /J "<DSH_HOME>\profiles\desktop\node_modules\dsh-agent-soul" "<DSH_HOME>\
|
|
|
246
360
|
```bash
|
|
247
361
|
grep "\[apply\]" ~/.dsh/agents/soul.log | tail -3 # 三段注入有没有起来
|
|
248
362
|
grep "\[extract\]" ~/.dsh/agents/soul.log | tail -5 # 自动记忆记了几条
|
|
249
|
-
grep "\[memory\]" ~/.dsh/agents/soul.log | tail -5 #
|
|
250
|
-
grep "\[
|
|
363
|
+
grep "\[memory\]" ~/.dsh/agents/soul.log | tail -5 # 衰减/压缩/丢弃了什么
|
|
364
|
+
grep "\[diary\]" ~/.dsh/agents/soul.log | tail -10 # 写没写、跳过原因
|
|
365
|
+
grep "\[mood\]" ~/.dsh/agents/soul.log | tail -5 # 心情合并/读取
|
|
251
366
|
```
|
|
252
367
|
|
|
253
|
-
**设置页「灵魂」不出现**:① 插件是不是真加载了(看 `[apply]
|
|
254
|
-
|
|
255
|
-
|
|
368
|
+
**设置页「灵魂」不出现**:① 插件是不是真加载了(看 `[apply] 启动`)② 目录名 / `package.json` 的 name / `cordis.patch.yml` 的 name 三处是否完全一致 ③ 重启 DSH
|
|
369
|
+
|
|
370
|
+
**改了 `lib/` 没反应**:多半是没同步到运行副本,见上面安装那节的 ⚠️。
|
|
371
|
+
|
|
372
|
+
**人格变了但没生效**:DSH 只在渲染文本**变化时**才重新追加,改完在下一个回合生效。
|
|
373
|
+
|
|
374
|
+
**记忆一直在掉条数**:`archive.jsonl` 里能查回来。不该忘的就在设置页固定(固定后永不淘汰)。
|
|
256
375
|
|
|
257
|
-
|
|
258
|
-
|
|
376
|
+
**日记没写**:
|
|
377
|
+
1. `grep "\[diary\]"` 看是「跳过」还是「失败」—— 跳过说明两篇都在或功能关了
|
|
378
|
+
2. 「写未完成」= 生成失败,日志上一行会写原因(模型取不到 / 超时 / 写盘失败)
|
|
379
|
+
3. 同一天重启多次只有第一次会写,之后是「跳过」,这是设计
|
|
259
380
|
|
|
260
|
-
|
|
261
|
-
在设置页把它固定(固定后永不淘汰),或者把 `forgetAfterDays` 调大。
|
|
381
|
+
**日记内容不像自己**:`diaryPublicTone` / `diaryPrivateTone` 留空时语气全靠模型发挥;写两句具体的(「温暖但克制」「真实、不设防」)比写「好好写」有用得多。
|
|
262
382
|
|
|
263
383
|
---
|
|
264
384
|
|
|
265
385
|
## 开发
|
|
266
386
|
|
|
267
387
|
```bash
|
|
268
|
-
npm test #
|
|
388
|
+
npm test # 全量:先构建 client,再跑全部单测
|
|
389
|
+
npm run build:client # 只把 lib/client/*.js 拼成 lib/client.js
|
|
269
390
|
npm run test:memory # 只跑记忆引擎
|
|
391
|
+
npm run test:diary # 只跑日记
|
|
270
392
|
npm run test:smoke # 用假宿主跑一遍 apply():注入段 + 工具 + API
|
|
271
|
-
npm run test:client #
|
|
393
|
+
npm run test:client # 先构建,再用假 __ModuleLoader__ 跑一遍浏览器 bundle
|
|
272
394
|
```
|
|
273
395
|
|
|
274
396
|
单测只碰纯函数,用临时目录,不动真实的 `~/.dsh`。
|
|
275
397
|
|
|
276
|
-
|
|
398
|
+
### 浏览器半侧是拆开写的,`lib/client.js` 是生成物
|
|
399
|
+
|
|
400
|
+
DSH 客户端模块系统**一个包只出一个 bundle、兄弟文件无法同步 require**,所以浏览器半侧不能真的拆成互相 `import` 的文件。源码按职责放在 `lib/client/`:
|
|
401
|
+
|
|
402
|
+
```
|
|
403
|
+
styles.js api.js components.js 基础
|
|
404
|
+
overview-tab.js persona-tab.js memory-tab.js 标签页
|
|
405
|
+
purpose-tab.js mood-tab.js diary-tab.js settings-tab.js
|
|
406
|
+
app.js 外壳
|
|
407
|
+
```
|
|
408
|
+
|
|
409
|
+
`tools/build-client.mjs` 按固定顺序把它们拼回**唯一入口 `lib/client.js`**。改浏览器半侧就改 `lib/client/` 里的片段,然后跑 `npm run build:client`(`npm test` 会自动先构建)。
|
|
410
|
+
|
|
411
|
+
两个测试是**装进 DSH 之前唯一的保险**,因为这两类错误 `node --check` 抓不到:
|
|
277
412
|
|
|
278
413
|
- `smoke`:`apply()` 在某个 ctx 服务上炸掉 → 插件加载了但注入没生效
|
|
279
|
-
- `client`:浏览器 bundle
|
|
280
|
-
DSH 报 `1 entry did not activate` 直接起不来
|
|
414
|
+
- `client`:浏览器 bundle 里用到宿主没提供的全局 → DSH 报 `1 entry did not activate` 直接起不来
|
|
281
415
|
|
|
282
416
|
两个都真实发生过,所以留下了。
|
|
283
417
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/docs/preview.html
CHANGED
|
@@ -122,7 +122,7 @@ border:1px solid var(--soul-line);border-radius:14px;overflow:hidden;background:
|
|
|
122
122
|
<div>
|
|
123
123
|
<p class="soul-kicker">agent soul</p>
|
|
124
124
|
<h1 class="soul-title">灵魂</h1>
|
|
125
|
-
<p class="soul-sub">工作目录:D
|
|
125
|
+
<p class="soul-sub">工作目录:D:\projects\demo</p>
|
|
126
126
|
</div>
|
|
127
127
|
<div class="soul-dots">
|
|
128
128
|
<span class="soul-dot ok"><i></i>人格已注入</span>
|
|
@@ -218,7 +218,7 @@ border:1px solid var(--soul-line);border-radius:14px;overflow:hidden;background:
|
|
|
218
218
|
<div>
|
|
219
219
|
<p class="soul-kicker">agent soul</p>
|
|
220
220
|
<h1 class="soul-title">灵魂</h1>
|
|
221
|
-
<p class="soul-sub">工作目录:D:\
|
|
221
|
+
<p class="soul-sub">工作目录:D:\projects\demo</p>
|
|
222
222
|
</div>
|
|
223
223
|
<div class="soul-dots">
|
|
224
224
|
<span class="soul-dot ok"><i></i>人格已注入</span>
|
|
@@ -248,11 +248,11 @@ border:1px solid var(--soul-line);border-radius:14px;overflow:hidden;background:
|
|
|
248
248
|
<div class="soul-banner">
|
|
249
249
|
<div class="soul-banner-line">
|
|
250
250
|
<span class="soul-banner-key">本会话当前生效</span>
|
|
251
|
-
<span class="soul-banner-val">项目内 AGENT.md · D:\
|
|
251
|
+
<span class="soul-banner-val">项目内 AGENT.md · D:\projects\demo\AGENT.md(+叠加全局底座)</span>
|
|
252
252
|
</div>
|
|
253
253
|
<div class="soul-banner-line">
|
|
254
254
|
<span class="soul-banner-key">当前工作目录</span>
|
|
255
|
-
<span class="soul-banner-val">D:\
|
|
255
|
+
<span class="soul-banner-val">D:\projects\demo</span>
|
|
256
256
|
</div>
|
|
257
257
|
</div>
|
|
258
258
|
|
|
@@ -283,9 +283,9 @@ border:1px solid var(--soul-line);border-radius:14px;overflow:hidden;background:
|
|
|
283
283
|
<div class="soul-row">
|
|
284
284
|
<span class="soul-row-label">工作区</span>
|
|
285
285
|
<select class="soul-select">
|
|
286
|
-
<option>
|
|
287
|
-
<option>
|
|
288
|
-
<option>
|
|
286
|
+
<option>demo(已有人格·已登记) — D:\projects\demo</option>
|
|
287
|
+
<option>chat(空·已登记) — D:\projects\chat</option>
|
|
288
|
+
<option>one(空·已登记) — D:\projects\one</option>
|
|
289
289
|
</select>
|
|
290
290
|
</div>
|
|
291
291
|
<div class="soul-row">
|
|
@@ -297,7 +297,7 @@ border:1px solid var(--soul-line);border-radius:14px;overflow:hidden;background:
|
|
|
297
297
|
|
|
298
298
|
<!-- 文件栏:路径 + 上次改动 -->
|
|
299
299
|
<div class="soul-filebar">
|
|
300
|
-
<span class="soul-filebar-path">C:\Users\
|
|
300
|
+
<span class="soul-filebar-path">C:\Users\you\.dsh\agents\projects\demo-a1b2c3d4…</span>
|
|
301
301
|
<span>上次改动 10月26日 12:48</span>
|
|
302
302
|
</div>
|
|
303
303
|
|