dsh-agent-soul 0.2.0 → 0.4.2

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/lib/refine.js ADDED
@@ -0,0 +1,221 @@
1
+ /**
2
+ * refine.js —— 把「主人说的原话」交给模型,提炼成一条条真正的记忆。
3
+ *
4
+ * ── 为什么必须有这一层 ──
5
+ * 自动提取原来是把原话直接塞进记忆卡(extract.js 里 `text: candidate.text`)。
6
+ * 2026-10-30 实测的三条"记忆"长这样:
7
+ * (QQ 私聊·用户本人 [QQ号])起了起了
8
+ * (QQ 私聊·用户本人 [QQ号])唔…早上好喵~
9
+ * (主动搭话:距上次说话已经 6 小时 3 分钟。…就 qq_pass…)
10
+ * 前两条一条是主人的废话、一条是她自己的话,第三条压根是桥的触发模板。
11
+ * 这叫存档,不叫记忆。
12
+ *
13
+ * 记忆该长这样:「树树是烟台大学机器人工程专业大二学生」——
14
+ * 是**提炼过的事实**,不是"他当时说了什么"。所以这里加一次很短的模型调用。
15
+ *
16
+ * ── 三个刻意的设计 ──
17
+ * 1. 一批一次调用(最多 8 条原话),不是一条一次 —— 省 token,也让模型能合并。
18
+ * 2. 没有信息量就输出空数组:**宁可少记**。记忆是有限预算,塞满废话最糟。
19
+ * 3. 失败不丢数据:调用失败/超时/解析不出,调用方退回"原话直存"的老路径。
20
+ */
21
+ import { randomUUID } from 'node:crypto'
22
+ import { sessionModelOf } from './mood.js'
23
+
24
+ /** 提炼调用上限(毫秒)。超时就退回原话,别把记忆这条线堵死。 */
25
+ const REFINE_TIMEOUT_MS = 30000
26
+
27
+ /** 一次最多送几条原话进去(再多模型容易挑花眼、也容易编)。 */
28
+ const MAX_INPUT = 8
29
+
30
+ /**
31
+ * 提炼用的系统提示词。
32
+ *
33
+ * 要「写成记忆」而不是「复述对话」——这是这层存在的全部意义,所以例子给足。
34
+ *
35
+ * ── 2026-10-30 重写:把「任务」挡在记忆之外 ──
36
+ * 用户在项目卡里抓到三条"记忆",全是一次性任务/进度:
37
+ * 「帮我修改一下 onebot 插件,让每一次发给 AI 的信息带时间」
38
+ * 「对当前桥接代码进行最后一次检测。确认整体无误后,进行 git 记录并推到 github。」
39
+ * 「树树最近在排查 pwsh 每次调用都在初始化阶段失败的问题」
40
+ * 旧判据是「有没有信息量」—— 任务指令当然"有信息量",于是被原样放行,
41
+ * 提炼要么照抄要么退回了原话。换成一条可判定的尺子:
42
+ * **换一天、换一个话题之后仍然成立,才值得记。** 任务明天作废,人物信息明年还成立。
43
+ */
44
+ export function buildRefineSystem({ owner = '主人' } = {}) {
45
+ return `你在帮忙整理长期记忆。下面是${owner}刚说过的话(可能夹杂桥接前缀、口癖、错别字、断句、任务指令)。
46
+ 请把其中有价值的信息提炼成一条条**记忆**,只输出一个 JSON 数组,不要任何别的字、不要 markdown 代码块。
47
+
48
+ 每条格式:{"text":"…","importance":60,"kind":"fact"}
49
+
50
+ ⭐ 一句话判据:**只记「换一天、换一个话题之后仍然成立」的信息。**
51
+ 今天要改的插件、这一轮正在排查的 bug、下一步要做的功能 —— 明天就作废了,一条都不要记。
52
+ 记忆里记的是「他是谁」,不是「他今天让我干了什么」。
53
+
54
+ 必须拒掉的(命中就丢,别改写、别"顺手记一笔"、别换个说法留下):
55
+ 1. 祈使句:含「帮我 / 麻烦你 / 请你 / 给我 / 你帮我」的请求。
56
+ ❌「帮我修改一下 onebot 插件,每次发给 AI 的信息都带时间」
57
+ 2. 动作进度:含「检测 / 修复 / 实现 / 重构 / 提交 / 推送 / 跑一下 / 改一下」这类手上正在做的事。
58
+ ❌「对当前桥接代码进行最后一次检测,确认无误后提交并推送」
59
+ 3. 工作状态:「最近在排查 X」「下一步要做 Y」「还在弄 Z」。
60
+ ❌「${owner}最近在排查 pwsh 初始化失败的问题」
61
+ 4. 时间锚点:「今天 / 刚才 / 这一轮 / 这次」串起来的经过。
62
+ ❌「今天把戴维南定理学完了」
63
+ (这四条不是凭空写的:项目卡里那三条垃圾记忆正好命中前三类。)
64
+
65
+ 该记的(换一天、换话题仍然成立):
66
+ ✅ 身份 / 背景:「${owner}是烟台大学机器人工程专业大二学生」
67
+ ✅ 偏好 / 厌恶:「${owner}不敢吃辣」「${owner}讨厌被叫"用户"」
68
+ ✅ 关系:「${owner}和你是在三月的一个雨天认识的」
69
+ ✅ 长期计划 / 目标:「${owner}想明年打蓝桥杯嵌入式赛道」
70
+ ✅ 明确约定:「答应过${owner},以后提醒他别熬夜」
71
+ ✅ 情绪模式 / 习惯:「${owner}晚上 11 点会上线跑图」← 这是习惯,要记;「他今天有点累」不记
72
+
73
+ 一条候选里既有任务又有人物信息时,**只取人物信息,任务部分丢掉**:
74
+ 原话「帮我把这个插件改一下,我最近在准备蓝桥杯,晚上都在画板子上了」
75
+ → 只记「${owner}在准备蓝桥杯,晚上都在画板子上」;「改插件」那半句不要。
76
+
77
+ 写法:
78
+ 1. 用「${owner}」指代他,用「我」指代你自己。
79
+ ❌「${owner}说他是大二的」← 这是复述,不是记忆
80
+ ❌「用户表示……」← 别用"用户",太生分
81
+ 2. 一条只讲一件事,每条 40 字以内。两件不相干的事要拆成两条。
82
+ 3. kind 判据(只能取这五个值):
83
+ · fact —— 客观事实:身份 / 学校 / 专业 / 年级 / 所在地 / 设备 / 长期习惯
84
+ · preference —— 喜好厌恶:爱吃什么 / 讨厌什么 / 雷区 / 口味
85
+ · promise —— 约定:说好的事、以后一起要做的事
86
+ · event —— 一次性经历:某一天发生的具体一件事(这类最容易变成垃圾,从严)
87
+ · feeling —— 稳定的情绪倾向 / 情绪模式(不是「这一轮有点累」)
88
+ 4. importance(0~100):
89
+ · 身份 / 专业 / 目标 / 长期习惯 → 75~90
90
+ · 明确偏好 / 约定 → 65~80
91
+ · kind=event 的一次性经历 → 要有 70 分以上才写,不够就别写
92
+ · 单次情绪 / 状态 → 45~64(通常本来就不该记)
93
+ 5. ⭐ **没有信息量就输出空数组 []**。寒暄、语气词、「嗯」「好的」「起了起了」、任务指令,
94
+ 一条都不要输出。宁可少记,也不要为了完成任务硬凑 —— 记忆位置有限,塞满废话最糟。
95
+ 6. **宁可空数组,也不许把「${owner}让我干什么」当成记忆。** 这是最容易犯的错。
96
+ 7. 不要编:他没说的事一律不写;拿不准就写模糊一点(「在学单片机」而不是「在学 STM32H743」)。`
97
+ }
98
+
99
+ /** 用户消息:把候选原话按顺序编号列出来。 */
100
+ export function buildRefineUser(candidates, { owner = '主人' } = {}) {
101
+ const list = (Array.isArray(candidates) ? candidates : []).slice(0, MAX_INPUT)
102
+ const lines = list.map((item, index) => `${index + 1}. ${String(item?.text ?? '').slice(0, 300)}`)
103
+ return `${owner}这段时间说的话(按时间顺序):\n${lines.join('\n')}\n\n请提炼成记忆,只输出 JSON 数组。`
104
+ }
105
+
106
+ /**
107
+ * 解析模型输出 → 记忆条目。
108
+ *
109
+ * 容错三处(都是实测会遇到):markdown 代码块包着、前后带解释、单条而不是数组。
110
+ * 解析不出就返回 null —— 调用方据此退回原话直存,不能因为格式问题把信息丢了。
111
+ */
112
+ export function parseRefined(text, { max = MAX_INPUT } = {}) {
113
+ const raw = String(text ?? '').trim()
114
+ if (raw === '') return null
115
+
116
+ const start = raw.indexOf('[')
117
+ const end = raw.lastIndexOf(']')
118
+ let list = null
119
+ if (start >= 0 && end > start) {
120
+ try {
121
+ list = JSON.parse(raw.slice(start, end + 1))
122
+ } catch {
123
+ list = null
124
+ }
125
+ }
126
+ if (list === null) {
127
+ // 有的模型会只给一个对象
128
+ const os = raw.indexOf('{')
129
+ const oe = raw.lastIndexOf('}')
130
+ if (os >= 0 && oe > os) {
131
+ try {
132
+ const one = JSON.parse(raw.slice(os, oe + 1))
133
+ list = [one]
134
+ } catch {
135
+ return null
136
+ }
137
+ }
138
+ }
139
+ if (!Array.isArray(list)) return null
140
+
141
+ const KINDS = new Set(['fact', 'preference', 'promise', 'event', 'feeling'])
142
+ const out = []
143
+ for (const item of list) {
144
+ if (item === null || typeof item !== 'object') continue
145
+ const body = String(item.text ?? '').trim()
146
+ if (body.length < 4) continue
147
+ const importance = Number(item.importance)
148
+ out.push({
149
+ text: body.slice(0, 200),
150
+ importance: Number.isFinite(importance) ? Math.min(100, Math.max(0, Math.round(importance))) : 55,
151
+ kind: KINDS.has(String(item.kind)) ? String(item.kind) : 'event'
152
+ })
153
+ if (out.length >= max) break
154
+ }
155
+ return out
156
+ }
157
+
158
+ /**
159
+ * 调一次模型做提炼。
160
+ *
161
+ * @returns {Promise<Array|null>} 条目数组;任何失败都返回 null(调用方退回原话)
162
+ */
163
+ export async function refineCandidates(llm, agent, candidates, {
164
+ note,
165
+ owner = '主人',
166
+ provider = '',
167
+ model = '',
168
+ timeoutMs = REFINE_TIMEOUT_MS
169
+ } = {}) {
170
+ if (!llm || typeof llm.stream !== 'function') return null
171
+ const list = (Array.isArray(candidates) ? candidates : []).filter((item) => String(item?.text ?? '').trim() !== '')
172
+ if (list.length === 0) return []
173
+
174
+ const picked = (provider && model) ? { provider, model } : null
175
+ const target = picked || sessionModelOf(agent)
176
+ if (!target) return null
177
+
178
+ const messages = [{
179
+ role: 'user',
180
+ id: randomUUID(),
181
+ content: [{ type: 'text', text: buildRefineUser(list, { owner }) }],
182
+ source: { kind: 'plugin', plugin: 'dsh-agent-soul' }
183
+ }]
184
+
185
+ let out = ''
186
+ let timer = null
187
+ try {
188
+ const timeout = new Promise((_resolve, reject) => {
189
+ timer = setTimeout(() => reject(new Error(`提炼超时(超过 ${Math.round(timeoutMs / 1000)} 秒)`)), timeoutMs)
190
+ if (timer !== null && typeof timer.unref === 'function') timer.unref()
191
+ })
192
+ const consume = (async () => {
193
+ for await (const chunk of llm.stream({
194
+ provider: target.provider,
195
+ model: target.model,
196
+ system: buildRefineSystem({ owner }),
197
+ messages,
198
+ maxTokens: 900,
199
+ // 带一点温度:提炼要改写,太死板会照抄原话
200
+ temperature: 0.3
201
+ })) {
202
+ if (!chunk) continue
203
+ if (chunk.type === 'text-delta') out += chunk.text
204
+ if (chunk.type === 'finish' && chunk.reason && chunk.reason.kind === 'error') return false
205
+ }
206
+ return true
207
+ })()
208
+ consume.catch(() => {})
209
+ const finished = await Promise.race([consume, timeout])
210
+ if (finished === false) return null
211
+ } catch (error) {
212
+ if (note) note('memory', `提炼调用失败:${error instanceof Error ? error.message : String(error)}`)
213
+ return null
214
+ } finally {
215
+ if (timer !== null) clearTimeout(timer)
216
+ }
217
+
218
+ const parsed = parseRefined(out)
219
+ if (parsed === null && note) note('memory', '提炼结果解析不出 JSON,退回原话直存')
220
+ return parsed
221
+ }