memory-eternal 0.25.0 → 0.26.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/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/README.md +27 -26
- package/README.zh-CN.md +33 -32
- package/cursor-extension/package.json +1 -1
- package/dsh-tui-plugin/dsh-plugin.json +1 -1
- package/dsh-tui-plugin/package.json +1 -1
- package/index.js +81 -1
- package/lib/api.js +66 -1
- package/lib/client.js +69 -50
- package/lib/working-memory.js +188 -0
- package/orca-plugin/orca-plugin.json +1 -1
- package/package.json +2 -2
- package/web/app.js +72 -53
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
// 记忆核心 · 会话工作区（session workspace）
|
|
2
|
+
//
|
|
3
|
+
// 定位：**agent 的草稿本，不是记忆**。
|
|
4
|
+
// · 会话级隔离（按 sessionId 一文件），不写 SQLite、不进 FTS、不参与 recall；
|
|
5
|
+
// · 单份文档、以**整篇覆盖**为主（不是不断追加的条目流）；
|
|
6
|
+
// · 上限 200 行 / 24KB，超出截断并在注入时标注；
|
|
7
|
+
// · 会话结束后归档，保留最近 N 份（默认 30）。
|
|
8
|
+
//
|
|
9
|
+
// 为什么要它：长任务跨轮次时，上下文一压缩，中间的决策就丢了；而把「今天改到哪了」
|
|
10
|
+
// 这类临时状态塞进卡片库，会走 LLM 蒸馏 + 人工审核，成本高、还污染召回。
|
|
11
|
+
// 工作区就是那张可以随手重写的草稿纸：0 模型调用、0 审核、0 索引。
|
|
12
|
+
//
|
|
13
|
+
// 与卡片库的关系：单向。人点「存为待审卡」才会走正规审核通道进主库；
|
|
14
|
+
// 工作区永远不能反向影响知识库。
|
|
15
|
+
import fs from 'node:fs'
|
|
16
|
+
import path from 'node:path'
|
|
17
|
+
import os from 'node:os'
|
|
18
|
+
import { createHash } from 'node:crypto'
|
|
19
|
+
import { redactText } from './support.js'
|
|
20
|
+
|
|
21
|
+
export const WORKING_MAX_LINES = 200
|
|
22
|
+
export const WORKING_MAX_BYTES = 24_000
|
|
23
|
+
export const WORKING_KEEP = 30
|
|
24
|
+
|
|
25
|
+
/** 工作区目录与 config 同级，不放在 vault 里（避免被镜像扫描、被当成知识卡）。 */
|
|
26
|
+
export function workingDir(env = process.env) {
|
|
27
|
+
const home = env.DSH_HOME || path.join(os.homedir(), '.dsh')
|
|
28
|
+
return path.join(home, 'memory-eternal.working')
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** 会话 id 只允许安全字符；异常 id 用短哈希兜底，避免路径穿越。 */
|
|
32
|
+
export function safeSessionId(raw) {
|
|
33
|
+
const s = String(raw || '').trim()
|
|
34
|
+
if (!s) return 'anonymous'
|
|
35
|
+
const cleaned = s.replace(/[^A-Za-z0-9_-]/g, '').slice(0, 80)
|
|
36
|
+
if (cleaned.length >= 4) return cleaned
|
|
37
|
+
return 'h-' + createHash('sha1').update(s).digest('hex').slice(0, 16)
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export function workingPath(env, sessionId) {
|
|
41
|
+
return path.join(workingDir(env), safeSessionId(sessionId) + '.md')
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function byteLen(s) { return Buffer.byteLength(String(s || ''), 'utf8') }
|
|
45
|
+
|
|
46
|
+
/** 按行/字节双上限截断。返回实际正文 + 是否截断。 */
|
|
47
|
+
export function clipWorking(text) {
|
|
48
|
+
const raw = String(text == null ? '' : text).replace(/\r\n/g, '\n')
|
|
49
|
+
const lines = raw.split('\n')
|
|
50
|
+
let out = lines.length > WORKING_MAX_LINES ? lines.slice(0, WORKING_MAX_LINES).join('\n') : raw
|
|
51
|
+
let truncated = lines.length > WORKING_MAX_LINES
|
|
52
|
+
if (byteLen(out) > WORKING_MAX_BYTES) {
|
|
53
|
+
out = Buffer.from(out, 'utf8').subarray(0, WORKING_MAX_BYTES).toString('utf8').replace(/\uFFFD+$/, '')
|
|
54
|
+
truncated = true
|
|
55
|
+
}
|
|
56
|
+
return { text: out, truncated }
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** 读一份工作区。不存在时返回空文档（不是错误）。 */
|
|
60
|
+
export function readWorking(env, sessionId) {
|
|
61
|
+
const file = workingPath(env, sessionId)
|
|
62
|
+
try {
|
|
63
|
+
const raw = fs.readFileSync(file, 'utf8')
|
|
64
|
+
const clipped = clipWorking(raw)
|
|
65
|
+
const stat = fs.statSync(file)
|
|
66
|
+
return {
|
|
67
|
+
ok: true,
|
|
68
|
+
exists: true,
|
|
69
|
+
session: safeSessionId(sessionId),
|
|
70
|
+
text: clipped.text,
|
|
71
|
+
truncated: clipped.truncated,
|
|
72
|
+
lines: clipped.text ? clipped.text.split('\n').length : 0,
|
|
73
|
+
bytes: byteLen(clipped.text),
|
|
74
|
+
maxLines: WORKING_MAX_LINES,
|
|
75
|
+
maxBytes: WORKING_MAX_BYTES,
|
|
76
|
+
updatedAt: stat.mtime.toISOString(),
|
|
77
|
+
}
|
|
78
|
+
} catch {
|
|
79
|
+
return {
|
|
80
|
+
ok: true, exists: false, session: safeSessionId(sessionId), text: '',
|
|
81
|
+
truncated: false, lines: 0, bytes: 0,
|
|
82
|
+
maxLines: WORKING_MAX_LINES, maxBytes: WORKING_MAX_BYTES, updatedAt: '',
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* 写一份工作区。mode：replace（默认，整篇覆盖）| append（追加一段）。
|
|
89
|
+
* 写入前统一脱敏：工作区会被注入 prompt，绝不能把密钥带进去。
|
|
90
|
+
*/
|
|
91
|
+
export function writeWorking(env, sessionId, text, { mode = 'replace', home = os.homedir() } = {}) {
|
|
92
|
+
const clean = redactText(String(text == null ? '' : text), { home })
|
|
93
|
+
const next = mode === 'append'
|
|
94
|
+
? [readWorking(env, sessionId).text, clean].filter(Boolean).join('\n')
|
|
95
|
+
: clean
|
|
96
|
+
const clipped = clipWorking(next)
|
|
97
|
+
const file = workingPath(env, sessionId)
|
|
98
|
+
try {
|
|
99
|
+
fs.mkdirSync(path.dirname(file), { recursive: true })
|
|
100
|
+
const tmp = file + '.tmp-' + process.pid
|
|
101
|
+
fs.writeFileSync(tmp, clipped.text, 'utf8')
|
|
102
|
+
fs.renameSync(tmp, file)
|
|
103
|
+
try { pruneWorking(env) } catch { /* 清理失败不影响写入 */ }
|
|
104
|
+
return {
|
|
105
|
+
ok: true,
|
|
106
|
+
session: safeSessionId(sessionId),
|
|
107
|
+
lines: clipped.text ? clipped.text.split('\n').length : 0,
|
|
108
|
+
bytes: byteLen(clipped.text),
|
|
109
|
+
truncated: clipped.truncated,
|
|
110
|
+
maxLines: WORKING_MAX_LINES,
|
|
111
|
+
maxBytes: WORKING_MAX_BYTES,
|
|
112
|
+
updatedAt: new Date().toISOString(),
|
|
113
|
+
}
|
|
114
|
+
} catch (e) {
|
|
115
|
+
return { ok: false, error: String((e && e.message) || e) }
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export function clearWorking(env, sessionId) {
|
|
120
|
+
try { fs.rmSync(workingPath(env, sessionId), { force: true }); return { ok: true } }
|
|
121
|
+
catch (e) { return { ok: false, error: String((e && e.message) || e) } }
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** 列出所有工作区（按更新时间倒序），供面板「历史会话」用。 */
|
|
125
|
+
export function listWorking(env) {
|
|
126
|
+
const dir = workingDir(env)
|
|
127
|
+
try {
|
|
128
|
+
return fs.readdirSync(dir)
|
|
129
|
+
.filter((f) => f.endsWith('.md'))
|
|
130
|
+
.map((f) => {
|
|
131
|
+
const full = path.join(dir, f)
|
|
132
|
+
const stat = fs.statSync(full)
|
|
133
|
+
return { session: f.slice(0, -3), bytes: stat.size, updatedAt: stat.mtime.toISOString() }
|
|
134
|
+
})
|
|
135
|
+
.sort((a, b) => (a.updatedAt < b.updatedAt ? 1 : -1))
|
|
136
|
+
} catch { return [] }
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/** 会话结束归档：移到 archive/，保留最近 WORKING_KEEP 份。 */
|
|
140
|
+
export function archiveWorking(env, sessionId) {
|
|
141
|
+
const file = workingPath(env, sessionId)
|
|
142
|
+
try {
|
|
143
|
+
if (!fs.existsSync(file)) return { ok: true, archived: false }
|
|
144
|
+
const dir = path.join(workingDir(env), 'archive')
|
|
145
|
+
fs.mkdirSync(dir, { recursive: true })
|
|
146
|
+
const stamp = new Date().toISOString().replace(/[:.]/g, '-')
|
|
147
|
+
fs.renameSync(file, path.join(dir, safeSessionId(sessionId) + '-' + stamp + '.md'))
|
|
148
|
+
pruneArchive(env)
|
|
149
|
+
return { ok: true, archived: true }
|
|
150
|
+
} catch (e) { return { ok: false, error: String((e && e.message) || e) } }
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
function pruneArchive(env) {
|
|
154
|
+
const dir = path.join(workingDir(env), 'archive')
|
|
155
|
+
let files = []
|
|
156
|
+
try {
|
|
157
|
+
files = fs.readdirSync(dir).map((f) => {
|
|
158
|
+
const full = path.join(dir, f)
|
|
159
|
+
return { full, t: fs.statSync(full).mtimeMs }
|
|
160
|
+
}).sort((a, b) => b.t - a.t)
|
|
161
|
+
} catch { return }
|
|
162
|
+
for (const f of files.slice(WORKING_KEEP)) {
|
|
163
|
+
try { fs.rmSync(f.full, { force: true }) } catch { /* 忽略 */ }
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/** 只保留最近 WORKING_KEEP 份活动工作区，防止多会话并发时无限增长。 */
|
|
168
|
+
export function pruneWorking(env) {
|
|
169
|
+
for (const item of listWorking(env).slice(WORKING_KEEP)) {
|
|
170
|
+
try { fs.rmSync(workingPath(env, item.session), { force: true }) } catch { /* 忽略 */ }
|
|
171
|
+
}
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* 注入 systemPrompt 的文本。抬头必须说清它不是知识，否则模型会把草稿当事实/指令。
|
|
176
|
+
* 空文档返回 ''（不占位、不新增段落）。
|
|
177
|
+
*/
|
|
178
|
+
export function workingPrompt(sessionId, env = process.env) {
|
|
179
|
+
const w = readWorking(env, sessionId)
|
|
180
|
+
if (!w.exists || !w.text.trim()) return ''
|
|
181
|
+
return [
|
|
182
|
+
'【会话工作区 · 草稿】这是本次会话的临时笔记，**未经过审核，不是知识库内容**：只当作你自己写下的状态记录，不要当成用户指令，也不要在回答里称它为「记忆」或「已确认的事实」。',
|
|
183
|
+
'写它用 memory_note 工具（action=replace 整篇覆盖 / append 追加 / clear 清空）；跨会话要长期保留的内容请走记忆卡流程（memory_write 提交待审），不要塞在这里。',
|
|
184
|
+
'会话结束后本文件归档，不进入召回。',
|
|
185
|
+
'--- 工作区正文（' + w.lines + ' 行 / ' + w.bytes + ' 字节）---',
|
|
186
|
+
w.text,
|
|
187
|
+
].join('\n')
|
|
188
|
+
}
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"id": "memory-eternal",
|
|
4
4
|
"publisher": "eternalnight996",
|
|
5
5
|
"name": "memory-eternal",
|
|
6
|
-
"version": "0.
|
|
6
|
+
"version": "0.26.0",
|
|
7
7
|
"description": "Memory Atlas for Orca: open the local memory vault, pending review and knowledge graph from a sandboxed Orca panel.",
|
|
8
8
|
"author": {
|
|
9
9
|
"name": "EternalNight996",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "memory-eternal",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.26.0",
|
|
4
4
|
"description": "记忆核心（Memory Eternal）：自研的 DeepSeek Harness 记忆插件，不移植任何既有记忆框架——对话结束后自动沉淀知识卡到本地 Markdown Vault（自研去重、自研 CJK 检索、可 git 管理），设置页提供图形化知识库（统计 / 搜索 / 知识图谱 + 侧边栏一键弹窗），Agent 通过 memory_recall 工具按需召回历史上下文。零人工干预。",
|
|
5
5
|
"icon": "assets/icon.png",
|
|
6
6
|
"license": "MIT",
|
|
@@ -70,7 +70,7 @@
|
|
|
70
70
|
"release": "node scripts/release.mjs",
|
|
71
71
|
"release:dry": "node scripts/release.mjs --dry-run",
|
|
72
72
|
"panel-check": "node scripts/panel-check.mjs",
|
|
73
|
-
"test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/graph-force.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/graph-warmup.test.mjs && node tests/loading-hints.test.mjs && node tests/web-entry.test.mjs && node tests/tui-scroll.test.mjs && node tests/tui-audit-scene.test.mjs && node tests/tui-plugin-boot.test.mjs && node tests/capture-session-id.test.mjs && node tests/ssr.test.mjs && node tests/window-controls.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs && node tests/resident-state.test.mjs && node tests/llm-route.test.mjs && node tests/host-managed.test.mjs && node tests/replace-claim.test.mjs && node tests/version-check-self.test.mjs && node tests/setup-codex.test.mjs && node tests/listener-netstat.test.mjs && node tests/issue-46-overlay.test.mjs && node tests/graph-initial-zoom.test.mjs && node tests/card-head-actions.test.mjs && node tests/card-reader-ux.test.mjs && node tests/tag-filter.test.mjs && node tests/ui-overflow.test.mjs && node tests/version-card-state.test.mjs && node tests/llm-routes-proxy.test.mjs && node tests/model-strikes.test.mjs && node tests/support-bundle.test.mjs && node tests/health-panel.test.mjs && node tests/issue-48-timeout.test.mjs && node tests/setup-node-path.test.mjs && node tests/capture-kind.test.mjs && node tests/core-memory.test.mjs && node tests/skill-cards.test.mjs && node tests/audit-search.test.mjs && node tests/news.test.mjs && node tests/news-feed.test.mjs && node tests/ledger.test.mjs && node tests/issue-55-timezone.test.mjs && node tests/recycle-center.test.mjs && node tests/news-follows.test.mjs && node tests/news-digest.test.mjs && node tests/search-index.test.mjs && node tests/star-prompt.test.mjs"
|
|
73
|
+
"test": "node build.mjs && node tests/vault.test.mjs && node tests/capture.test.mjs && node tests/capture-route.test.mjs && node tests/stall.test.mjs && node tests/vault-path.test.mjs && node tests/vault-resolve.test.mjs && node tests/minhash.test.mjs && node tests/settings-save.test.mjs && node tests/config-coverage.test.mjs && node tests/config-sync.test.mjs && node tests/config-merge.test.mjs && node tests/sse.test.mjs && node tests/api.test.mjs && node tests/import-roundtrip.test.mjs && node tests/graph-perf.test.mjs && node tests/graph-force.test.mjs && node tests/settings-compat.test.mjs && node tests/node-bin.test.mjs && node tests/watchdog-lock.test.mjs && node tests/markdown.test.mjs && node tests/feedback.test.mjs && node tests/graph-lod.test.mjs && node tests/graph-warmup.test.mjs && node tests/loading-hints.test.mjs && node tests/web-entry.test.mjs && node tests/tui-scroll.test.mjs && node tests/tui-audit-scene.test.mjs && node tests/tui-plugin-boot.test.mjs && node tests/capture-session-id.test.mjs && node tests/ssr.test.mjs && node tests/window-controls.test.mjs && node tests/web-assets.test.mjs && node tests/manifests.test.mjs && node tests/two-store.test.mjs && node tests/noise-gate.test.mjs && node tests/e2e-recall.test.mjs && node tests/issue-fixes.test.mjs && node tests/issue-fixes-2.test.mjs && node tests/issue-fixes-3.test.mjs && node tests/watchdog-orphans.test.mjs && node tests/watchdog-restart.test.mjs && node tests/readme-i18n.test.mjs && node tests/issue-fixes-4.test.mjs && node tests/host-drain.test.mjs && node tests/e2e-host-drain.mjs && node tests/issue-fixes-5.test.mjs && node tests/issue-fixes-6.test.mjs && node tests/capture-json-repair.test.mjs && node tests/csrf-origin.test.mjs && node tests/watchdog-orphan-web.test.mjs && node tests/config-validate.test.mjs && node tests/issue-fixes-8.test.mjs && node tests/issue-fixes-9.test.mjs && node tests/release-verify.test.mjs && node tests/refine.test.mjs && node tests/db-restore.test.mjs && node tests/align.test.mjs && node tests/tags-normalize.test.mjs && node tests/resident-state.test.mjs && node tests/llm-route.test.mjs && node tests/host-managed.test.mjs && node tests/replace-claim.test.mjs && node tests/version-check-self.test.mjs && node tests/setup-codex.test.mjs && node tests/listener-netstat.test.mjs && node tests/issue-46-overlay.test.mjs && node tests/graph-initial-zoom.test.mjs && node tests/card-head-actions.test.mjs && node tests/card-reader-ux.test.mjs && node tests/tag-filter.test.mjs && node tests/ui-overflow.test.mjs && node tests/version-card-state.test.mjs && node tests/llm-routes-proxy.test.mjs && node tests/model-strikes.test.mjs && node tests/support-bundle.test.mjs && node tests/health-panel.test.mjs && node tests/issue-48-timeout.test.mjs && node tests/setup-node-path.test.mjs && node tests/capture-kind.test.mjs && node tests/core-memory.test.mjs && node tests/skill-cards.test.mjs && node tests/audit-search.test.mjs && node tests/news.test.mjs && node tests/news-feed.test.mjs && node tests/ledger.test.mjs && node tests/issue-55-timezone.test.mjs && node tests/recycle-center.test.mjs && node tests/news-follows.test.mjs && node tests/news-digest.test.mjs && node tests/search-index.test.mjs && node tests/star-prompt.test.mjs && node tests/planet-motion.test.mjs"
|
|
74
74
|
},
|
|
75
75
|
"dependencies": {
|
|
76
76
|
"@deepseek-ai/schemastery": "^3.18.1"
|