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 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 写「你是谁」。项目人格只覆盖同名小节,全局的交待照常生效 —— 不会因为某个目录里有 `AGENT.md`,你在全局写的话就整份失效 |
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
- ### 4. 直接改文件
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
- ## 人格注入:和 dsh-agent-md 的区别
62
+ ## 人格注入
79
63
 
80
- **核心差异只有一条:找到项目人格时,全局那份是「消失」还是「补齐」。**
64
+ ### 三层来源与优先级
81
65
 
82
- | | dsh-agent-md | dsh-agent-soul |
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
- 具体到你的文件。你全局 `AGENT.md` 有 7 个小节:
72
+ **项目层只取 1、2 里优先级最高的那一份**(不是两份合并)——两份都写着 `# 你是谁` 时,模型会各听一半,最后谁也不像。
89
73
 
90
- ```
91
- # 你是谁 # 语气与形态 # 与树树的关系 # 行事准则 # 边界 # 互动约定 # 工程约定
92
- ```
74
+ ### 叠加还是互斥
93
75
 
94
- 假设某个项目里只写了:
76
+ | | 互斥(`exclusive`) | 叠加(`stack`,默认) |
77
+ |---|---|---|
78
+ | 有项目人格时全局怎么办 | **整份不注入** | **按小节叠加**:项目覆盖同名小节,全局其余保留 |
79
+ | 你在全局写的通用约定 | 某些工作区完全不遵守,像没读到 | 到处生效,除非项目里显式覆盖同名小节 |
95
80
 
96
- ```markdown
97
- # 工程约定
98
- 这个项目用 Vue 3 + Vite。
99
- ```
81
+ ### 什么时候注入
100
82
 
101
- - **以前**:全局整份消失 → 「你是谁」「语气与形态」「边界」全丢了,那个工作区的她完全变成另一个人
102
- - **现在**:只有「工程约定」被替换,另外 6 个小节原样继承
83
+ **会话第一轮注入一次,之后每 15 轮补一次。**
103
84
 
104
- 这正是你问题库 [Q20](../../DSH%20workspace/DSH问题库/F-工具与人格注入.md) 记的那个坑的正面修法。
85
+ 不每轮重发(那是纯浪费),也不注入一次就再也不管 —— 上下文压缩之后会把人格正文压掉,那时她会「记得聊过什么,但不记得自己是谁」。15 轮补一次,成本可以忽略,压缩后能自己找回来。
105
86
 
106
- 另外两个附带差异:
87
+ > ⚠️ 如果 `<cwd>/AGENT.md` 存在,它会盖住设置页编辑的第 2 层。你在设置页改了、保存了、提示「已保存」,但其实**没生效**。页面会亮黄框提示。
107
88
 
108
- 1. **`{{xxx}}` 会被降级成 `{xxx}`**:DSH 把双花括号当模板变量,未注册的名字会让**整轮注入失败**。两个插件都做了兜底。
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
- **项目层只取 1、2 里优先级最高的那一份**(不是两份合并)——两份都写着 `# 你是谁` 时,模型会各听一半,最后谁也不像。
95
+ 自动提取分三步:**过滤 → 提炼 → 打分入库**。
120
96
 
121
- 设置页的「人格」标签会把这个层级**画出来**:逐层标「存在 / 没有」、给全路径、给正在生效的那层打标,并且顶部写明当前会话的工作目录和项目标识。
97
+ **1. 过滤(纯规则)**:只收「人在说话」。丢掉宿主注入的上下文、桥接层的触发模板、信封前缀(「(QQ 私聊·用户本人 [QQ号])」),以及她自己被桥回显的话。
122
98
 
123
- > ⚠️ **最容易踩的一个坑**:如果 `<cwd>/AGENT.md` 存在,它会盖住设置页编辑的第 2 层。
124
- > 你在设置页改了、保存了、提示"已保存",但其实**没生效** —— 因为第 1 层压着它。
125
- > 页面检测到这种情况会亮一个黄框,直接告诉你「要么改那个文件,要么删掉它」。
126
- >
127
- > 实测你机器上 `D:\DSH workspace\work\AGENT.md` 就属于这种情况。
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
- 四个驱动维度,各有 0~1 的值,**8 小时落一半**:
166
+ 四个驱动维度,各 0~1,**8 小时落一半**:
155
167
 
156
168
  | 维度 | 被什么推高 |
157
169
  |---|---|
@@ -160,14 +172,92 @@
160
172
  | 想分享 | 有意思的发现、推荐 |
161
173
  | 想搞懂 | 学会了、跑通了、踩坑了 |
162
174
 
163
- 再加上从记忆里长出来的「没闭合的事」(答应过的、没弄明白的、想试试的),
164
- 渲染成很短的一段注入(默认 ≤ 320 字,最多 3 条)。
175
+ 再加上从记忆里长出来的「没闭合的事」,渲染成很短的一段(默认 ≤ 320 字,最多 3 条)。里面明确写着「**这不是任务清单,不需要每轮都提**」。
176
+
177
+ **心情会推着它走**:担心/心疼 → `在乎` 涨,开心/甜蜜 → `想分享` 涨。不是每轮往上加,而是让驱动**向情绪推出的目标靠拢**(每轮 15%)—— 累加式写法几十轮后会把所有驱动顶到 1,等于没有状态;靠拢则天然有收敛点。
178
+
179
+ **说出去了才算完**:渲染出去的目标会被记下来,下一轮看她有没有真的说出口。说到了 → 驱动 ×0.45;超过 6 小时没说到 → ×0.85,慢慢淡了。只判一次,判完移出列表。
165
180
 
166
- 里面明确写着「**这不是任务清单,不需要每轮都提**」——
167
- 决定权在她手里,这比硬塞一句「去问候主人」更像自主,也不容易变成复读。
181
+ > 本地 DSH 没有推送渠道(你不打开就没有回合),所以「主动」只能是主动想起。真正主动发消息属于 QQ 那边的事。
168
182
 
169
- > 本地 DSH 没有推送渠道(你不打开就没有回合),所以「主动」只能是主动想起。
170
- > 真正的主动发消息属于 QQ 那边的事,不在这里。
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(本地 link)
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
- **记忆和目的这两段是每回合重发的**,跟工具 schema 一样不进压缩,是常驻成本。
285
+ | 项 | 频率 | 大约 |
286
+ |---|---|---|
287
+ | 人格 | 首轮 + 每 15 轮 | 你写多少就是多少 |
288
+ | 记忆 | 每回合 | 默认 3200 字预算,实际约 2200~3000 token |
289
+ | 目的 | 每回合 | ≤ 320 字,约 300~500 token |
290
+ | 日记 | 每天一次 | 一次生成调两次模型(公开 + 私密) |
197
291
 
198
- - 默认记忆预算 1600 字,实际约 **1100~1500 token**
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` | `1600` | 记忆注入预算 |
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
- 记忆引擎参数(衰减天数、阈值、压缩)在 `lib/memory.js` 的 `DEFAULTS`,
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/soul.log 日志(2MB 轮转)
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 "\[tool\]" ~/.dsh/agents/soul.log | tail -5 # 工具注册成功没
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
- ② 目录名 / `package.json` 的 name / `cordis.patch.yml` 的 name 三处是否完全一致
255
- ③ 重启 DSH —— 浏览器半侧是启动时装配的
368
+ **设置页「灵魂」不出现**:① 插件是不是真加载了(看 `[apply] 启动`)② 目录名 / `package.json` 的 name / `cordis.patch.yml` 的 name 三处是否完全一致 ③ 重启 DSH
369
+
370
+ **改了 `lib/` 没反应**:多半是没同步到运行副本,见上面安装那节的 ⚠️。
371
+
372
+ **人格变了但没生效**:DSH 只在渲染文本**变化时**才重新追加,改完在下一个回合生效。
373
+
374
+ **记忆一直在掉条数**:`archive.jsonl` 里能查回来。不该忘的就在设置页固定(固定后永不淘汰)。
256
375
 
257
- **人格变了但没生效**:DSH 只在渲染文本**变化时**才重新追加这一段,
258
- 改完在下一个回合生效。设置页「概览」里能看到当前实际注入的是哪几份文件。
376
+ **日记没写**:
377
+ 1. `grep "\[diary\]"` 看是「跳过」还是「失败」—— 跳过说明两篇都在或功能关了
378
+ 2. 「写未完成」= 生成失败,日志上一行会写原因(模型取不到 / 超时 / 写盘失败)
379
+ 3. 同一天重启多次只有第一次会写,之后是「跳过」,这是设计
259
380
 
260
- **记忆一直在掉条数**:`archive.jsonl` 里能查回来。觉得不该忘就
261
- 在设置页把它固定(固定后永不淘汰),或者把 `forgetAfterDays` 调大。
381
+ **日记内容不像自己**:`diaryPublicTone` / `diaryPrivateTone` 留空时语气全靠模型发挥;写两句具体的(「温暖但克制」「真实、不设防」)比写「好好写」有用得多。
262
382
 
263
383
  ---
264
384
 
265
385
  ## 开发
266
386
 
267
387
  ```bash
268
- npm test # 210 条断言:记忆 65 / 人格 35 / 目的 48 / 主进程冒烟 41 / 浏览器半侧 21
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 # 用假 __ModuleLoader__ 跑一遍浏览器 bundle
393
+ npm run test:client # 先构建,再用假 __ModuleLoader__ 跑一遍浏览器 bundle
272
394
  ```
273
395
 
274
396
  单测只碰纯函数,用临时目录,不动真实的 `~/.dsh`。
275
397
 
276
- 后两个测试是**装进 DSH 之前唯一的保险**,因为这两类错误 `node --check` 抓不到:
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 里用到宿主没提供的全局(`module` / `exports`)→
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://DSH workspace\work</p>
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:\DSH workspace\work</p>
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:\DSH workspace\work\AGENT.md(+叠加全局底座)</span>
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:\DSH workspace\work</span>
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>work(已有人格·已登记) — D:\DSH workspace\work</option>
287
- <option>QQ对话(空·已登记) — D:\DSH workspace\QQ对话</option>
288
- <option>1(空·已登记) — D:\DSH workspace\1</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\Administrator\.dsh\agents\projects\work-ea826e02…</span>
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