dsh-macro-memory 0.0.0-stage → 0.3.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/LICENSE +21 -0
- package/README.md +457 -2
- package/cordis.patch.yml +6 -0
- package/lib/client.js +3623 -0
- package/lib/index.js +469 -0
- package/lib/macro/brand.js +82 -0
- package/lib/macro/bridge.js +158 -0
- package/lib/macro/chain.js +206 -0
- package/lib/macro/contract.js +471 -0
- package/lib/macro/cost.js +164 -0
- package/lib/macro/defs/admin.js +439 -0
- package/lib/macro/defs/dream.js +24 -0
- package/lib/macro/defs/link.js +257 -0
- package/lib/macro/defs/project.js +25 -0
- package/lib/macro/defs/read.js +145 -0
- package/lib/macro/defs/remember.js +213 -0
- package/lib/macro/defs/search.js +661 -0
- package/lib/macro/defs/update.js +161 -0
- package/lib/macro/dreamledger.js +1398 -0
- package/lib/macro/facade.js +135 -0
- package/lib/macro/fusion.js +182 -0
- package/lib/macro/linkflow.js +391 -0
- package/lib/macro/links.js +448 -0
- package/lib/macro/neighbor.js +209 -0
- package/lib/macro/panel.js +96 -0
- package/lib/macro/prompt.js +139 -0
- package/lib/macro/provenance.js +148 -0
- package/lib/macro/render.js +35 -0
- package/lib/macro/revisions.js +253 -0
- package/lib/macro/shared.js +113 -0
- package/lib/macro/store.js +103 -0
- package/lib/macro/tokencost.js +90 -0
- package/lib/macro/tools.js +67 -0
- package/package.json +54 -4
- package/vendor/VENDOR.json +23 -0
- package/vendor/dsh-memory-nebula/CONTRIBUTING.md +48 -0
- package/vendor/dsh-memory-nebula/LICENSE +21 -0
- package/vendor/dsh-memory-nebula/README.en.md +203 -0
- package/vendor/dsh-memory-nebula/README.md +253 -0
- package/vendor/dsh-memory-nebula/SECURITY.md +43 -0
- package/vendor/dsh-memory-nebula/SUPPORT.md +33 -0
- package/vendor/dsh-memory-nebula/cordis.patch.yml +4 -0
- package/vendor/dsh-memory-nebula/lib/client.js +105 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/index.js +279 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/ingest.js +230 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/meow.js +317 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/notes.js +305 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/sqlite.js +287 -0
- package/vendor/dsh-memory-nebula/lib/host/adapters/util.js +231 -0
- package/vendor/dsh-memory-nebula/lib/host/bridge.js +351 -0
- package/vendor/dsh-memory-nebula/lib/host/compress.js +97 -0
- package/vendor/dsh-memory-nebula/lib/host/demo.js +357 -0
- package/vendor/dsh-memory-nebula/lib/host/diagnostics.js +125 -0
- package/vendor/dsh-memory-nebula/lib/host/doctor.js +270 -0
- package/vendor/dsh-memory-nebula/lib/host/graph.js +1663 -0
- package/vendor/dsh-memory-nebula/lib/host/graphcache.js +282 -0
- package/vendor/dsh-memory-nebula/lib/host/http.js +993 -0
- package/vendor/dsh-memory-nebula/lib/host/injectcfg.js +95 -0
- package/vendor/dsh-memory-nebula/lib/host/ledger.js +175 -0
- package/vendor/dsh-memory-nebula/lib/host/live.js +204 -0
- package/vendor/dsh-memory-nebula/lib/host/nebula.js +2105 -0
- package/vendor/dsh-memory-nebula/lib/host/page.js +75 -0
- package/vendor/dsh-memory-nebula/lib/host/path.js +83 -0
- package/vendor/dsh-memory-nebula/lib/host/recall.js +451 -0
- package/vendor/dsh-memory-nebula/lib/host/share.js +633 -0
- package/vendor/dsh-memory-nebula/lib/host/sources.js +266 -0
- package/vendor/dsh-memory-nebula/lib/host/store.js +333 -0
- package/vendor/dsh-memory-nebula/lib/host/text.js +410 -0
- package/vendor/dsh-memory-nebula/lib/host/transcripts.js +396 -0
- package/vendor/dsh-memory-nebula/lib/index.js +759 -0
- package/vendor/dsh-memory-nebula/lib/standalone.mjs +315 -0
- package/vendor/dsh-memory-nebula/lib/web/api.js +426 -0
- package/vendor/dsh-memory-nebula/lib/web/app.js +4159 -0
- package/vendor/dsh-memory-nebula/lib/web/i18n.js +580 -0
- package/vendor/dsh-memory-nebula/lib/web/index.html +174 -0
- package/vendor/dsh-memory-nebula/lib/web/nav.js +132 -0
- package/vendor/dsh-memory-nebula/lib/web/render.js +1890 -0
- package/vendor/dsh-memory-nebula/lib/web/space3d.js +1883 -0
- package/vendor/dsh-memory-nebula/lib/web/style.css +1402 -0
- package/vendor/dsh-memory-nebula/locale/en.json +7 -0
- package/vendor/dsh-memory-nebula/locale/zh.json +7 -0
- package/vendor/dsh-memory-nebula/market/assets/icon-180.png +0 -0
- package/vendor/dsh-memory-nebula/market/assets/icon.svg +40 -0
- package/vendor/dsh-memory-nebula/market/index.json +101 -0
- package/vendor/dsh-memory-nebula/package.json +87 -0
- package/vendor/dsh-memory-nebula/sidecar.ps1 +119 -0
- package/vendor/meow-memory/LICENSE +21 -0
- package/vendor/meow-memory/README.en.md +192 -0
- package/vendor/meow-memory/README.md +174 -0
- package/vendor/meow-memory/README.pt-br.md +180 -0
- package/vendor/meow-memory/cordis.patch.yml +7 -0
- package/vendor/meow-memory/lib/client.js +3344 -0
- package/vendor/meow-memory/lib/client.js.map +7 -0
- package/vendor/meow-memory/lib/index.js +9567 -0
- package/vendor/meow-memory/lib/index.js.map +7 -0
- package/vendor/meow-memory/lib/prompts/README.md +65 -0
- package/vendor/meow-memory/lib/prompts/en/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/en/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/en/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/en/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/en/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/en/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/en/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/en/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/en/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/en/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-project-summary.md +12 -0
- package/vendor/meow-memory/lib/prompts/pt-br/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/pt-br/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/pt-br/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/pt-br/reflect.md +31 -0
- package/vendor/meow-memory/lib/prompts/pt-br/system-guide.md +121 -0
- package/vendor/meow-memory/lib/prompts/pt-br/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/pt-br/welcome-guide.md +12 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-atomic.md +36 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-header.md +9 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-project-summary.md +19 -0
- package/vendor/meow-memory/lib/prompts/zh/dream-topic.md +27 -0
- package/vendor/meow-memory/lib/prompts/zh/external-memory-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/first-create-notice.md +8 -0
- package/vendor/meow-memory/lib/prompts/zh/labels.md +98 -0
- package/vendor/meow-memory/lib/prompts/zh/reflect.md +30 -0
- package/vendor/meow-memory/lib/prompts/zh/system-guide.md +119 -0
- package/vendor/meow-memory/lib/prompts/zh/tools.md +83 -0
- package/vendor/meow-memory/lib/prompts/zh/welcome-guide.md +12 -0
- package/vendor/meow-memory/package.json +64 -0
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 面板口径(0.2.25):八个面板共用一个抬头,名字只有一份。
|
|
3
|
+
*
|
|
4
|
+
* 以前每个面板各写各的开头:成本账本用 `# macro-memory 成本账本(最近 N 次)`,
|
|
5
|
+
* 待补连线直接甩 `待补连线:N 条`,星图那四个干脆是 vendor 原文(开头是它自己的话)。
|
|
6
|
+
* 模型一次只拿到一段文本,八段八套开头等于没有抬头——既看不出这是哪个面,
|
|
7
|
+
* 也分不清「空」是因为没数据、还是因为星图没接上。
|
|
8
|
+
*
|
|
9
|
+
* 三条约定:
|
|
10
|
+
* 1. 抬头只由这里产;名字只从 defs/admin.js 的 ACTIONS 表来,不在这里再抄一遍。
|
|
11
|
+
* 2. 抬头加在正文**上面**,正文一个字不动(vendor 原文照旧原样)。
|
|
12
|
+
* 3. 手册(guide)没有统计口径可报,不加抬头——全表唯一豁免,理由写在那一行上。
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
export const PANEL_BRAND = '宏记忆'
|
|
16
|
+
|
|
17
|
+
/** 抬头本身:`【宏记忆|成本账本】`。note 是口径说明(最近多少次 / 最多列几条)。 */
|
|
18
|
+
export function panelHead(label, note) {
|
|
19
|
+
const head = `【${PANEL_BRAND}|${String(label ?? '')}】`
|
|
20
|
+
const extra = String(note ?? '').trim()
|
|
21
|
+
return extra.length > 0 ? `${head}${extra}` : head
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** 面板全文:抬头 + 正文(正文空就只剩抬头,不留一行空白)。 */
|
|
25
|
+
export function panelText(label, body, note) {
|
|
26
|
+
const text = String(body ?? '').trim()
|
|
27
|
+
return text.length > 0 ? `${panelHead(label, note)}\n${text}` : panelHead(label, note)
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* 去掉抬头,拿回正文(给「按行读数据」的调用方用:探针要读的是正文第一行)。
|
|
32
|
+
*
|
|
33
|
+
* 有这个函数,说明「抬头」这件事有契约:读的人不靠猜第几行是数据,而靠剥掉抬头。
|
|
34
|
+
* 不带抬头(比如手册)时原样返回,不做任何改写。
|
|
35
|
+
*/
|
|
36
|
+
export function stripHead(text) {
|
|
37
|
+
const s = String(text ?? '')
|
|
38
|
+
const mark = `【${PANEL_BRAND}|`
|
|
39
|
+
if (!s.startsWith(mark)) return s
|
|
40
|
+
const at = s.indexOf('】')
|
|
41
|
+
if (at < 0) return s
|
|
42
|
+
return s.slice(s[at + 1] === '\n' ? at + 2 : at + 1)
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* 条数上限:默认值跟着动作表走。[macro-fusion 0.2.61]
|
|
47
|
+
* 以前是各写各的 `args.limit === undefined ? 200 : Number(args.limit)`,成本用 200、
|
|
48
|
+
* 队列用 20,两处默认值散在两个方法里;换默认值得翻两处,且没有地方能一眼看全。
|
|
49
|
+
* 现在默认值写在那张表的 defaultLimit,读取只有这一条路径。
|
|
50
|
+
*
|
|
51
|
+
* 0.2.61:这条路径原来对四种输入一声不吭地退回默认值——
|
|
52
|
+
* `limit: 0`(明说「一条都别列」)、`limit: -3`(负条数)、`limit: "十"`(不是数字)、
|
|
53
|
+
* `limit: 2.7`(非整数)。用户拿着被换过的条数读结论,还以为看到的是自己要求的那一段。
|
|
54
|
+
* 判定规则跟 vendor 侧的 numParam()(0.2.57)同一套:能照办就照办,改了就说话。
|
|
55
|
+
*/
|
|
56
|
+
export function limitOf(spec, args) {
|
|
57
|
+
const fallback = Number(spec?.defaultLimit ?? 0)
|
|
58
|
+
const raw = args?.limit
|
|
59
|
+
if (raw === undefined || raw === null || raw === '') return { value: fallback, note: '' }
|
|
60
|
+
const n = Number(raw)
|
|
61
|
+
if (!Number.isFinite(n)) {
|
|
62
|
+
return { value: fallback, note: `limit 给的是「${String(raw)}」,不是数字——这次按默认 ${fallback} 条算,不是你给的那个。` }
|
|
63
|
+
}
|
|
64
|
+
if (n < 0) {
|
|
65
|
+
return { value: fallback, note: `limit 给的是「${n}」,是负数——条数没有「从后往前数」这回事,这次按默认 ${fallback} 条算。` }
|
|
66
|
+
}
|
|
67
|
+
if (n === 0) {
|
|
68
|
+
return { value: 0, note: 'limit 给的是 0,这次一条都不列——不是「一条都没有」,是你要求不列。' }
|
|
69
|
+
}
|
|
70
|
+
const whole = Math.floor(n)
|
|
71
|
+
if (whole === n) return { value: whole, note: '' }
|
|
72
|
+
return { value: whole, note: `limit 给的是「${n}」,条数只能是整数,这次按 ${whole} 条算——少掉的那半条不是你给的条件。` }
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* 卡片标题(0.2.60):抬头与卡片是同一套口径,标题也只有这一条出口。[macro-fusion 0.2.60]
|
|
77
|
+
*
|
|
78
|
+
* 以前八个 presentCall 各写各的模板串:admin 用中文 label(0.2.25 修过),
|
|
79
|
+
* link 却直接把参数键贴上去——`星图连线:link`、`检索记忆:graph`,
|
|
80
|
+
* 正是 0.2.25 在 admin 里明确禁止的那种「谁也不认识的东西」。
|
|
81
|
+
* 另外参数没给时会留下悬空的冒号(`项目全景:`),多行内容会撑爆一行卡片。
|
|
82
|
+
*
|
|
83
|
+
* 三条约定:
|
|
84
|
+
* 1. 标题 = 前缀 + 「:」 + 细节;细节为空就只留前缀,不留悬空分隔符。
|
|
85
|
+
* 2. 细节压成一行、去掉首尾空白;超过 40 字截断加省略号(卡片只有一行)。
|
|
86
|
+
* 3. 任何面板都不许自己拼字符串——只认 prefix(中文名)+ detail(参数的值)。
|
|
87
|
+
*/
|
|
88
|
+
export const CARD_DETAIL_MAX = 40
|
|
89
|
+
|
|
90
|
+
export function cardTitle(label, detail) {
|
|
91
|
+
const prefix = String(label ?? '').trim()
|
|
92
|
+
const flat = typeof detail === 'string' ? detail.replace(/\s+/g, ' ').trim() : ''
|
|
93
|
+
if (flat.length === 0) return prefix
|
|
94
|
+
const short = flat.length > CARD_DETAIL_MAX ? `${flat.slice(0, CARD_DETAIL_MAX)}…` : flat
|
|
95
|
+
return `${prefix}:${short}`
|
|
96
|
+
}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* macro-memory 的注入层:L0(每轮常驻的最小手册)+ L2(按需吐回的完整手册)。
|
|
3
|
+
*
|
|
4
|
+
* 设计:整段注入只有一处(section `macro-memory:guide`,order 130),
|
|
5
|
+
* 内容 ≤ GUIDE_MAX_CHARS;详细手册(meow 的 system-guide 全文 + 星图规则)
|
|
6
|
+
* 不在每轮注入,改由 memory_admin(action="guide") 按需取回 —— 省钱的核心。
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
export const GUIDE_NAME = 'macro-memory:guide'
|
|
10
|
+
export const GUIDE_ORDER = 130
|
|
11
|
+
/**
|
|
12
|
+
* [macro-fusion 0.2.130] 1300 → 1400。
|
|
13
|
+
*
|
|
14
|
+
* 加的是「回执没写全不等于没有」这句(回答准则)——它只在 system prompt 层起作用:
|
|
15
|
+
* LoCoMo 1,193 题同题对照,同一句话挂在 system prompt 里 45.9%→54.2%,
|
|
16
|
+
* 挂在回执里只值 +1.4pt(见 docs/INTERNAL.md 9.134)。而融合层把子插件的 section 全吞了,
|
|
17
|
+
* 子插件 system-guide 里写的那句到不了模型眼前,只能由这段 L0 带过去。
|
|
18
|
+
* 100 字符的代价留在常驻前缀里(缓存后边际成本近乎为 0),换的是整整 8 个点。
|
|
19
|
+
*/
|
|
20
|
+
export const GUIDE_MAX_CHARS = 1400
|
|
21
|
+
/** 上限之下要留的余量:低于这个数说明手册已经贴到边,该删句子了而不是等它被截。 */
|
|
22
|
+
export const GUIDE_MIN_HEADROOM = 120
|
|
23
|
+
/** 真的超上限时的收尾——截断必须自己说出来,而且必须把「去哪看全文」留住。 */
|
|
24
|
+
export const GUIDE_TAIL_MARK = '…(已按上限截断,完整手册见 memory_admin(action="guide"))'
|
|
25
|
+
|
|
26
|
+
export const GUIDE_TEXT = `【宏记忆 macro-memory】跨会话记忆与记忆星图由 macro-memory 统一提供:memory_* 工具管条目,星图管条目之间的关联(跨会话、跨工作区已验证的连线)。不必再找别的记忆插件。
|
|
27
|
+
|
|
28
|
+
level(每条都要):soul=AI 自身 / user=用户与设备环境 / rules=准则 / fact=原子事实 / lesson=经验教训 / topic=一件事的来龙去脉 / project=项目(子类 overview|structure|decisions|quotes|ops|todo)。
|
|
29
|
+
|
|
30
|
+
memory_remember(content、project、keywords、importance 必填):keywords 给 8–13 个,按「用户提到哪些词时该召回它」反过来想;importance 4=红线致命 3=主人强调 2=抽象决策 1=琐碎;已有相近条目先 memory_update,或把旧的标 stale/archived,别堆重复。写入时可用 links=[邻居 id] 顺手把关联固化进星图。
|
|
31
|
+
memory_update(id, …):改内容/状态/关键词/归属,status=active|stale|archived。
|
|
32
|
+
memory_search(query, budget):默认本地检索;expand=true 沿星图扩散;mode=graph|bridge 走关联,mode=similar 找相似;memory_project 看项目全景;memory_read(id, neighbors=12, budget)连邻居一起读——预算不够先砍邻居、正文一字不截、砍到底只给骨架。回执够大自带成本尾注(≈N token);想省上下文就给 budget=N,五路都吃(本地/星图/补邻居/相似/读),工具自己砍并交代砍了什么。
|
|
33
|
+
memory_link(action=link|unlink|mute|unmute|path):path 看两条记忆怎么连上的;mute 断掉错的关联(重建也不会再连);写记忆时没连上的连线会排队,读记忆时自动补;排队欠账用 memory_admin(action="links") 看,按理由分组。
|
|
34
|
+
整理:memory_dream。运维与体检:memory_admin(action=home|stats|hygiene|sources|ingest|cost|dream|links|guide)。
|
|
35
|
+
|
|
36
|
+
纪律:一条一事、保持最新;冲突以时间戳最新者为准;注入的记忆可能无关或过时,发现就更新它。回执没写全≠没有:只提到一部分也给最可能答案,完全无关才说不记得(回执层只值 +1.4pt,这一层值 +8.3pt)。三面都在:工具 / 命令(/dream、/meow-trust)/ 面板(宏记忆、宏记忆 · 星图)。完整手册见 memory_admin(action="guide")。`
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* L2 手册的「门牌」:融合之后用户能碰到的三面——工具、命令、面板。
|
|
40
|
+
*
|
|
41
|
+
* 命令名(`/dream`、`/meow-trust`)是 vendor 实际注册的名字,这里硬编码但由 verify A14 与
|
|
42
|
+
* `vendor/meow-memory/lib/index.js` 交叉核对:vendor 改名而这里没跟,脚本会红,手册不会说谎。
|
|
43
|
+
* 为什么不把命令改成 `/macro-dream` 之类更整齐的名字:用户敲字的习惯比整齐值钱,改名的收益
|
|
44
|
+
* 远小于「昨天还在用的命令今天不见了」的代价。
|
|
45
|
+
*/
|
|
46
|
+
export const NAV_TEXT = `宏记忆有三个面,工具只是其中之一:①工具——8 个 memory_*,下面这本手册讲的就是它们;②命令——用户自己敲的 /dream(手动唤起一次记忆整理)与 /meow-trust(信任当前工作区自带的记忆库);③面板——设置里的「宏记忆」,以及独立的「宏记忆 · 星图」。融合之后这三面一件都没少;命令名沿用 vendor 的注册名,没为了整齐去改它。`
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* 把注入文本压到上限内。
|
|
50
|
+
*
|
|
51
|
+
* 以前是「超了就在行边界切一刀」——切完什么也没说:模型以为手册就这么多,
|
|
52
|
+
* 而最可能被切掉的恰恰是最后那行「完整手册见 memory_admin(action="guide")」。
|
|
53
|
+
* 现在截断必须带尾巴:既承认被截了,又把去哪看全文留住;尾巴本身也算在上限里。
|
|
54
|
+
*/
|
|
55
|
+
/**
|
|
56
|
+
* 注入上限的唯一出口:把配置里那个 `guideMaxChars` 解析成「这次真的按多少字算」,
|
|
57
|
+
* 并带上「改过就要说话」的那句话。
|
|
58
|
+
*
|
|
59
|
+
* [macro-fusion 0.2.63] 以前先把 maxChars 塞进 Number(),再用「不是有限数就用 0」兜底:
|
|
60
|
+
* 配置写错一个字(`guideMaxChars: "4k"`、`-5`、`null`)都会被读成 0,
|
|
61
|
+
* 而 0 在这条路上等于**整段 L0 注入变成空串**——插件最显眼的那段东西消失了,
|
|
62
|
+
* 日志、面板、回执一个字都不说。这不是「上限很严」,是「配置错了但看起来像没配」。
|
|
63
|
+
*
|
|
64
|
+
* 语义按「能不能照办」分:
|
|
65
|
+
* - 缺省 / 空串 → 默认值,不吭声
|
|
66
|
+
* - 非数字 → 回默认,说明给的是什么(绝不落成 0)
|
|
67
|
+
* - 负数 → 回默认,说明上限没有「从后往前数」
|
|
68
|
+
* - 0 → **照办 0**(明确不要注入),但要说清「不是手册空了」
|
|
69
|
+
* - 非整数 → 抹掉小数,说明少掉的那半字不是你给的条件
|
|
70
|
+
* - 太小 → 照办,但说明连「被截断了」的尾巴都放不下、注入没有指路
|
|
71
|
+
*/
|
|
72
|
+
export function guideBudget(raw) {
|
|
73
|
+
if (raw === undefined || raw === null || raw === '') return { value: GUIDE_MAX_CHARS, note: '' }
|
|
74
|
+
const n = Number(raw)
|
|
75
|
+
if (!Number.isFinite(n)) {
|
|
76
|
+
return {
|
|
77
|
+
value: GUIDE_MAX_CHARS,
|
|
78
|
+
note: `guideMaxChars 给的是「${String(raw)}」,不是数字——这次按默认 ${GUIDE_MAX_CHARS} 字算,不是你给的那个(注入没有变成空的)。`,
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
if (n < 0) {
|
|
82
|
+
return {
|
|
83
|
+
value: GUIDE_MAX_CHARS,
|
|
84
|
+
note: `guideMaxChars 给的是「${n}」,是负数——上限没有「从后往前数」这回事,这次按默认 ${GUIDE_MAX_CHARS} 字算。`,
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
if (n === 0) {
|
|
88
|
+
return { value: 0, note: 'guideMaxChars 给的是 0,这次一个字都不注入——不是「手册空了」,是你把上限设成了 0。' }
|
|
89
|
+
}
|
|
90
|
+
const whole = Math.floor(n)
|
|
91
|
+
if (whole !== n) {
|
|
92
|
+
return { value: whole, note: `guideMaxChars 给的是「${n}」,上限只能是整数,这次按 ${whole} 字算——少掉的那半字不是你给的条件。` }
|
|
93
|
+
}
|
|
94
|
+
if (whole <= GUIDE_TAIL_MARK.length) {
|
|
95
|
+
return {
|
|
96
|
+
value: whole,
|
|
97
|
+
note: `guideMaxChars 给的是 ${whole},连「被截断了,完整手册见 …」这句尾巴都放不下——注入只剩硬切的前 ${whole} 字,没有指路。`,
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
return { value: whole, note: '' }
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
export function clampGuide(text = GUIDE_TEXT, maxChars = GUIDE_MAX_CHARS) {
|
|
104
|
+
const t = String(text)
|
|
105
|
+
const cap = guideBudget(maxChars).value
|
|
106
|
+
if (t.length <= cap) return t
|
|
107
|
+
// 上限小到连一句「被截断了」都放不下时,只能硬切——但绝不返回空串以外的东西假装完整。
|
|
108
|
+
if (cap <= GUIDE_TAIL_MARK.length) return t.slice(0, cap)
|
|
109
|
+
const budget = cap - GUIDE_TAIL_MARK.length - 1
|
|
110
|
+
const cut = t.slice(0, budget)
|
|
111
|
+
const line = cut.lastIndexOf('\n')
|
|
112
|
+
const head = line > budget * 0.6 ? cut.slice(0, line) : cut
|
|
113
|
+
return `${head}\n${GUIDE_TAIL_MARK}`
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* L2 按需手册:直接复用两个子插件自己产出的注入原文(不复制、不改写),
|
|
118
|
+
* 所以 memory_admin(action="guide") 吐出来的永远和 vendor 一致。
|
|
119
|
+
*/
|
|
120
|
+
export function buildFullGuide(bridge) {
|
|
121
|
+
const parts = []
|
|
122
|
+
for (const item of bridge.promptDeclarations()) {
|
|
123
|
+
const text = resolveDeclText(item?.decl?.text)
|
|
124
|
+
if (typeof text === 'string' && text.trim().length > 0) {
|
|
125
|
+
const title = item.vendor === 'nebula' ? '星图规则' : '记忆手册'
|
|
126
|
+
parts.push(`## ${title} — ${String(item.decl?.name ?? '')}\n\n${text.trim()}`)
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
if (parts.length === 0) return '(子插件尚未提供手册:可能还没装配完成,或对应功能被关闭。)'
|
|
130
|
+
return parts.join('\n\n---\n\n')
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
function resolveDeclText(text) {
|
|
134
|
+
try {
|
|
135
|
+
return typeof text === 'function' ? text() : text
|
|
136
|
+
} catch {
|
|
137
|
+
return undefined
|
|
138
|
+
}
|
|
139
|
+
}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [macro-fusion 0.2.156] 来源一行:这条记忆「从哪来、为什么存在、还有人用吗」。
|
|
3
|
+
*
|
|
4
|
+
* 为什么补这一行:0.2.138 的取代链(chain.js)只解决了谱系的一半——「它被谁接走了」。
|
|
5
|
+
* 另一半一直空着:这条是谁写的、什么时候进库的、是整理封存的还是会话里直接写的、
|
|
6
|
+
* 被读过几次。库里的字段其实都在(source_session / hit_count / last_accessed_at /
|
|
7
|
+
* created_at,还有 dream_log 与 windows 两张表),可**没有一个工具读它们**:
|
|
8
|
+
* `memory_read` 只印 level/标题/项目/目标/正文,最后一句是「需要更多细节就去聊天记录里搜」——
|
|
9
|
+
* 可真相就在库里的三列上,让人肉去猜,等于可追溯性只做了一半。
|
|
10
|
+
*
|
|
11
|
+
* 四条约束(照抄 chain.js 的纪律,因为它们是被同一批教训换来的):
|
|
12
|
+
* 1. **只在有话说时才出现**:来源会话、整理归属、使用次数三块各自可缺;全缺就返回空串,
|
|
13
|
+
* 绝不给一句「来源未知」占着 token。
|
|
14
|
+
* 2. **不改任何数据**:只读三列 + 两张日志表,不新增列、不回填、不 markAccessed
|
|
15
|
+
* (读一条记忆的元数据不该让它变成「最近被用过」)。
|
|
16
|
+
* 3. **拿不到就闭嘴**:没工作区 / 没库 / 读失败一律空串——先 existsSync 判存在,
|
|
17
|
+
* 不为了一句说明去 getDb 建一个空库。
|
|
18
|
+
* 4. **近似要说明白**:整理归属是按「created_at 落在某次 dream 的账之前 6 小时内」推的,
|
|
19
|
+
* 所以措辞用「那次整理封存的」,不用肯定句;推不出来就说「当次会话直接写的」。
|
|
20
|
+
*/
|
|
21
|
+
import { existsSync } from 'node:fs'
|
|
22
|
+
import { join } from 'node:path'
|
|
23
|
+
import * as Meow from '../../vendor/meow-memory/lib/index.js'
|
|
24
|
+
// [macro-fusion 0.2.157] 「这条被改过吗」也是来源的一部分:只在真留过底时才有这一句。
|
|
25
|
+
import { revisionNote } from './revisions.js'
|
|
26
|
+
|
|
27
|
+
/** 整理账本与条目写入时间的最大落差:超过这个数就不认「是那一轮封存的」。 */
|
|
28
|
+
const DREAM_WINDOW_MS = 6 * 60 * 60 * 1000
|
|
29
|
+
/** 会话 id 形如 `session-4be47b9a-…`;回执里只留 8 位,够对上是哪次。 */
|
|
30
|
+
const SESSION_SHORT = 8
|
|
31
|
+
/** 迁移脚本写进去的来源标记(meow 自己的口径)。 */
|
|
32
|
+
const MIGRATION = 'migration'
|
|
33
|
+
|
|
34
|
+
function dbFile(workspace, dir) {
|
|
35
|
+
return join(workspace, dir, 'memory.db')
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function fmtTs(ms) {
|
|
39
|
+
const n = Number(ms)
|
|
40
|
+
if (!Number.isFinite(n) || n <= 0) return ''
|
|
41
|
+
const d = new Date(n)
|
|
42
|
+
if (Number.isNaN(d.getTime())) return ''
|
|
43
|
+
const p = (x) => String(x).padStart(2, '0')
|
|
44
|
+
return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function shortSession(raw) {
|
|
48
|
+
const s = String(raw ?? '').trim()
|
|
49
|
+
if (s === '') return ''
|
|
50
|
+
const body = s.startsWith('session-') ? s.slice('session-'.length) : s
|
|
51
|
+
return body.slice(0, SESSION_SHORT)
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* 这一条记忆的来源事实。`missing` 非空表示「读不到」,调用方据此闭嘴。
|
|
56
|
+
* row: { id, level, created_at, source_session, hit_count, last_accessed_at, corrected }
|
|
57
|
+
* dream: { at, summary } | null —— 推定封存它的那一轮整理(可能推不出来)
|
|
58
|
+
*/
|
|
59
|
+
export function provenanceOf({ workspace = '', dir = '.dsh-meow', id = '' } = {}) {
|
|
60
|
+
const out = { missing: '', row: null, dream: null }
|
|
61
|
+
const want = String(id ?? '').trim()
|
|
62
|
+
if (want === '') {
|
|
63
|
+
out.missing = 'bad-arg'
|
|
64
|
+
return out
|
|
65
|
+
}
|
|
66
|
+
if (typeof workspace !== 'string' || workspace.length === 0) {
|
|
67
|
+
out.missing = 'no-workspace'
|
|
68
|
+
return out
|
|
69
|
+
}
|
|
70
|
+
if (!existsSync(dbFile(workspace, dir))) {
|
|
71
|
+
out.missing = 'no-db'
|
|
72
|
+
return out
|
|
73
|
+
}
|
|
74
|
+
try {
|
|
75
|
+
const read = Meow.readRowsByIds(workspace, dir, [want])
|
|
76
|
+
const rows = Array.isArray(read.rows) ? read.rows : []
|
|
77
|
+
// 短 id 可能撞车(meow 的 id 前 8 位是写入时刻):只认前缀真正对得上的那条。
|
|
78
|
+
const row = rows.find((r) => String(r.id ?? '').startsWith(want)) ?? rows[0] ?? null
|
|
79
|
+
if (row === null) {
|
|
80
|
+
out.missing = 'not-found'
|
|
81
|
+
return out
|
|
82
|
+
}
|
|
83
|
+
out.row = {
|
|
84
|
+
id: String(row.id ?? ''),
|
|
85
|
+
level: String(row.sessionLevel ?? ''),
|
|
86
|
+
created_at: Number(row.created_at ?? 0),
|
|
87
|
+
source_session: String(row.source_session ?? ''),
|
|
88
|
+
hit_count: Number(row.hit_count ?? 0),
|
|
89
|
+
last_accessed_at: row.last_accessed_at == null ? null : Number(row.last_accessed_at),
|
|
90
|
+
corrected: Number(row.corrected ?? 0) === 1,
|
|
91
|
+
}
|
|
92
|
+
const created = out.row.created_at
|
|
93
|
+
if (created > 0) {
|
|
94
|
+
const logs = Meow.getDb(workspace, dir)
|
|
95
|
+
.p('SELECT run_at, summary FROM dream_log WHERE run_at IS NOT NULL ORDER BY run_at ASC')
|
|
96
|
+
.all()
|
|
97
|
+
for (const log of Array.isArray(logs) ? logs : []) {
|
|
98
|
+
const at = Number(log.run_at ?? 0)
|
|
99
|
+
// 整理先写条目、再落账,所以账在条目之后;落差太大就不是同一轮。
|
|
100
|
+
if (at < created) continue
|
|
101
|
+
if (at - created > DREAM_WINDOW_MS) break
|
|
102
|
+
out.dream = { at, summary: String(log.summary ?? '') }
|
|
103
|
+
break
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
return out
|
|
107
|
+
} catch (e) {
|
|
108
|
+
out.missing = `read-failed: ${e instanceof Error ? e.message : String(e)}`
|
|
109
|
+
return out
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* 回执里的那一行。读不到 / 什么都没有 → 空串(不占位、不猜)。
|
|
115
|
+
*/
|
|
116
|
+
export function provenanceNote({ workspace = '', dir = '.dsh-meow', id = '' } = {}) {
|
|
117
|
+
const p = provenanceOf({ workspace, dir, id })
|
|
118
|
+
if (p.missing.length > 0 || p.row === null) return ''
|
|
119
|
+
const parts = []
|
|
120
|
+
const sess = String(p.row.source_session ?? '')
|
|
121
|
+
const wrote = fmtTs(p.row.created_at)
|
|
122
|
+
if (sess === MIGRATION) {
|
|
123
|
+
parts.push(`来源:老库迁移过来的${wrote ? `(${wrote} 落库)` : ''},没有原始会话`)
|
|
124
|
+
} else if (sess !== '') {
|
|
125
|
+
const short = shortSession(sess)
|
|
126
|
+
if (p.dream !== null) {
|
|
127
|
+
const at = fmtTs(p.dream.at)
|
|
128
|
+
parts.push(`来源:会话 ${short}${at ? ` 在 ${at} 那次整理里封存` : ' 在某次整理里封存'}`)
|
|
129
|
+
} else {
|
|
130
|
+
parts.push(`来源:会话 ${short} 当次直接写进来${wrote ? `(${wrote})` : ''}`)
|
|
131
|
+
}
|
|
132
|
+
} else {
|
|
133
|
+
// 来源会话都空着:只说「哪天进的库」,别把「没记来源」说得像「没有来源」。
|
|
134
|
+
if (wrote) parts.push(`来源:没有记来源会话,${wrote} 进的库`)
|
|
135
|
+
}
|
|
136
|
+
if (p.row.hit_count > 0) {
|
|
137
|
+
const last = fmtTs(p.row.last_accessed_at)
|
|
138
|
+
parts.push(`被读过 ${p.row.hit_count} 次${last ? `(最近 ${last})` : ''}`)
|
|
139
|
+
} else {
|
|
140
|
+
parts.push('还没被检索用过')
|
|
141
|
+
}
|
|
142
|
+
// [macro-fusion 0.2.157] 改过几次:留底表里没有这条就是没改过,一个字都不多说。
|
|
143
|
+
const rev = revisionNote({ workspace, dir, id })
|
|
144
|
+
if (rev.length > 0) parts.push(rev.replace(/^🕘\s*/, '').replace(/,留底的旧版本能退回去$/, ''))
|
|
145
|
+
if (p.row.corrected) parts.push('主人纠正过')
|
|
146
|
+
if (parts.length === 0) return ''
|
|
147
|
+
return `📜 ${parts.join(' · ')}`
|
|
148
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 子插件返回值的「出文本」这一件事(0.2.26 从 bridge.js 分出来)。
|
|
3
|
+
*
|
|
4
|
+
* 约定:
|
|
5
|
+
* - 只用子插件自己的 output.render,绝不重写它的返回结构;
|
|
6
|
+
* - 渲染抛错 / 没给 render 才退回字符串或 JSON —— 这里不做品牌改口(那在 bridge.call 里决定)。
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
export function errText(err) {
|
|
10
|
+
if (err instanceof Error) return err.message
|
|
11
|
+
return String(err)
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
/** 用子插件自己的 output.render 把结果渲染成文本,绝不重写返回结构。 */
|
|
15
|
+
export function renderToolText(def, args, value) {
|
|
16
|
+
const render = def?.output?.render
|
|
17
|
+
if (typeof render === 'function') {
|
|
18
|
+
try {
|
|
19
|
+
const blocks = render(args, value)
|
|
20
|
+
const list = Array.isArray(blocks) ? blocks : []
|
|
21
|
+
const texts = list
|
|
22
|
+
.map((b) => (typeof b === 'string' ? b : typeof b?.text === 'string' ? b.text : ''))
|
|
23
|
+
.filter((t) => t !== '')
|
|
24
|
+
if (texts.length > 0) return texts.join('\n')
|
|
25
|
+
} catch {
|
|
26
|
+
/* 渲染失败就退回 JSON */
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
if (typeof value === 'string') return value
|
|
30
|
+
try {
|
|
31
|
+
return JSON.stringify(value, null, 2)
|
|
32
|
+
} catch {
|
|
33
|
+
return String(value)
|
|
34
|
+
}
|
|
35
|
+
}
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [macro-fusion 0.2.157] 改前留一版:可更新性的另一半是「改坏了能退回来」。
|
|
3
|
+
*
|
|
4
|
+
* 为什么有这一层:0.2.156 让读者看清「这条谁写的、还有人用吗」,但一眼看不见的是
|
|
5
|
+
* 「它被改过什么」。真库体检:513 条 active 里 **412 条** `updated_at` 明显晚于
|
|
6
|
+
* `created_at`(其中 lesson 260 条),而正文里带「(已被取代:…)」的只有 2 条——
|
|
7
|
+
* 说明绝大多数「改」是**正文被重写**,不是取代。重写是破坏性的:旧正文当场就没了,
|
|
8
|
+
* 事后一句「我改错了」没有任何退路。
|
|
9
|
+
*
|
|
10
|
+
* 所以这里只做三件事,一件都不多:
|
|
11
|
+
* 1. `saveRevision`:每次要写正文之前,把**旧正文**留底(同一条最多留 3 版,
|
|
12
|
+
* 与上一版逐字相同时不重复记——留底不是记流水账)。
|
|
13
|
+
* 2. `revisionContent`:按「上 N 版」取回一份旧正文,给 `memory_update(restore:N)` 用。
|
|
14
|
+
* 3. `revisionNote`:给回执一行「改过几次、最近一次是什么时候」,让「这条在演进」
|
|
15
|
+
* 和「这条一直没动」在阅读时就能分开。
|
|
16
|
+
*
|
|
17
|
+
* 纪律(与 chain.js / provenance.js 同源,都是被同一批教训换来的):
|
|
18
|
+
* - **没库不说话、也不建库**:先 `existsSync`,读不到就返回 null / 空串。
|
|
19
|
+
* - **只读不写地读**:`revisionNote` 不 markAccessed、不动 hit_count。
|
|
20
|
+
* - **留底有上限**:`REVISION_KEEP = 3`,常量只有一个出口(写侧清理与读侧范围都读它)。
|
|
21
|
+
* - **纯度优先**:`applyPatches` / `appendTo` / `shrinkGuard` 是纯函数,不碰库——
|
|
22
|
+
* 这样「按句改」的判据可以在探针里逐条量,不用先造一个库。
|
|
23
|
+
*/
|
|
24
|
+
import { existsSync } from 'node:fs'
|
|
25
|
+
import { join } from 'node:path'
|
|
26
|
+
import * as Meow from '../../vendor/meow-memory/lib/index.js'
|
|
27
|
+
|
|
28
|
+
const REVISION_KEEP = 3
|
|
29
|
+
const TABLE = 'memory_revisions'
|
|
30
|
+
/** 结果比原文短到这个比例以下,必须显式 `allowShrink` 才许写(防「按句改」变成「整段删」)。 */
|
|
31
|
+
const SHRINK_FLOOR = 0.7
|
|
32
|
+
|
|
33
|
+
const DDL = `CREATE TABLE IF NOT EXISTS ${TABLE} (
|
|
34
|
+
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
35
|
+
memory_id TEXT NOT NULL,
|
|
36
|
+
level TEXT,
|
|
37
|
+
title TEXT,
|
|
38
|
+
content TEXT NOT NULL,
|
|
39
|
+
reason TEXT,
|
|
40
|
+
saved_at INTEGER NOT NULL
|
|
41
|
+
)`
|
|
42
|
+
const DDL_INDEX = `CREATE INDEX IF NOT EXISTS ${TABLE}_memory_id ON ${TABLE}(memory_id)`
|
|
43
|
+
|
|
44
|
+
function dbFile(workspace, dir) {
|
|
45
|
+
return join(workspace, dir, 'memory.db')
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
function hasDb(workspace, dir) {
|
|
49
|
+
if (typeof workspace !== 'string' || workspace === '') return false
|
|
50
|
+
return existsSync(dbFile(workspace, dir))
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function readyDb(workspace, dir) {
|
|
54
|
+
const db = Meow.getDb(workspace, dir)
|
|
55
|
+
db.p(DDL).run()
|
|
56
|
+
db.p(DDL_INDEX).run()
|
|
57
|
+
return db
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
function fmtTs(ms) {
|
|
61
|
+
const n = Number(ms)
|
|
62
|
+
if (!Number.isFinite(n) || n <= 0) return ''
|
|
63
|
+
const d = new Date(n)
|
|
64
|
+
if (Number.isNaN(d.getTime())) return ''
|
|
65
|
+
const p = (x) => String(x).padStart(2, '0')
|
|
66
|
+
return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** 当前这一条的正文与层(给「按句改」当底稿)。读不到就说读不到,不编。 */
|
|
70
|
+
export function currentRow({ workspace = '', dir = '.dsh-meow', id = '' } = {}) {
|
|
71
|
+
const out = { missing: '', row: null }
|
|
72
|
+
const want = String(id ?? '').trim()
|
|
73
|
+
if (want === '') {
|
|
74
|
+
out.missing = 'bad-arg'
|
|
75
|
+
return out
|
|
76
|
+
}
|
|
77
|
+
if (!hasDb(workspace, dir)) {
|
|
78
|
+
out.missing = 'no-db'
|
|
79
|
+
return out
|
|
80
|
+
}
|
|
81
|
+
try {
|
|
82
|
+
const read = Meow.readRowsByIds(workspace, dir, [want])
|
|
83
|
+
const rows = Array.isArray(read.rows) ? read.rows : []
|
|
84
|
+
const row = rows.find((r) => String(r.id ?? '').startsWith(want)) ?? rows[0] ?? null
|
|
85
|
+
if (row === null) {
|
|
86
|
+
out.missing = 'not-found'
|
|
87
|
+
return out
|
|
88
|
+
}
|
|
89
|
+
out.row = {
|
|
90
|
+
id: String(row.id ?? ''),
|
|
91
|
+
level: String(row.sessionLevel ?? ''),
|
|
92
|
+
title: String(row.title ?? ''),
|
|
93
|
+
content: String(row.content ?? ''),
|
|
94
|
+
}
|
|
95
|
+
return out
|
|
96
|
+
} catch (e) {
|
|
97
|
+
out.missing = `read-failed: ${e instanceof Error ? e.message : String(e)}`
|
|
98
|
+
return out
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* 按句改:`patches` = `[{ find, replace }]`。
|
|
104
|
+
* **唯一命中**才算数:0 次=这段不在这一版正文里(可能已经改过或被改写);多次=
|
|
105
|
+
* 这句话不足以定位,要人补上下文。两种情况都**一个字都不写**,把理由原样说出来。
|
|
106
|
+
* 补丁按顺序作用(后一条看得到前一条的结果),这样「先改 A 再改 B」的直觉不会被推翻。
|
|
107
|
+
*/
|
|
108
|
+
export function applyPatches(content, patches) {
|
|
109
|
+
let next = String(content ?? '')
|
|
110
|
+
const list = Array.isArray(patches) ? patches : []
|
|
111
|
+
if (list.length === 0) return { ok: false, why: 'patch 是空的:一条 {find, replace} 都没有' }
|
|
112
|
+
let changed = 0
|
|
113
|
+
for (let i = 0; i < list.length; i += 1) {
|
|
114
|
+
const one = list[i] ?? {}
|
|
115
|
+
const find = typeof one.find === 'string' ? one.find : ''
|
|
116
|
+
const replace = typeof one.replace === 'string' ? one.replace : ''
|
|
117
|
+
if (find === '') return { ok: false, why: `第 ${i + 1} 条 patch 的 find 是空串(空串会命中每一处,等于没定位)` }
|
|
118
|
+
const parts = next.split(find)
|
|
119
|
+
const hits = parts.length - 1
|
|
120
|
+
if (hits === 0) {
|
|
121
|
+
return { ok: false, why: `第 ${i + 1} 条 patch 要找的「${find.slice(0, 40)}」在这一版正文里找不到——可能已经改过,或者原文不是这几个字` }
|
|
122
|
+
}
|
|
123
|
+
if (hits > 1) {
|
|
124
|
+
return { ok: false, why: `第 ${i + 1} 条 patch 要找的「${find.slice(0, 40)}」出现了 ${hits} 次,定位不到唯一一处——把上下文带长一点再改` }
|
|
125
|
+
}
|
|
126
|
+
next = parts.join(replace)
|
|
127
|
+
changed += 1
|
|
128
|
+
}
|
|
129
|
+
return { ok: true, content: next, changed }
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** 追加一段:放在正文末尾,中间空一行(追一段不该把上一段连成一句)。 */
|
|
133
|
+
export function appendTo(content, extra) {
|
|
134
|
+
const before = String(content ?? '').replace(/\s+$/, '')
|
|
135
|
+
const add = String(extra ?? '').trim()
|
|
136
|
+
if (add === '') return { ok: false, why: 'append 是空的:没有要追加的内容' }
|
|
137
|
+
return { ok: true, content: before === '' ? add : `${before}\n\n${add}` }
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/**
|
|
141
|
+
* 防误删闸门:按句改的本意是「改一句」,不该顺手把整段删光。
|
|
142
|
+
* 比原文短到 `SHRINK_FLOOR` 以下、又没有 `allowShrink: true`,就拒绝写。
|
|
143
|
+
* 短文本(< 40 字)不设闸——一句话本来就可以被改短,20 字砍到 8 字也未必是事故。
|
|
144
|
+
*/
|
|
145
|
+
export function shrinkGuard(before, after, allowShrink = false) {
|
|
146
|
+
const b = String(before ?? '').length
|
|
147
|
+
const a = String(after ?? '').length
|
|
148
|
+
if (allowShrink === true) return { ok: true }
|
|
149
|
+
if (b < 40) return { ok: true }
|
|
150
|
+
if (a >= Math.ceil(b * SHRINK_FLOOR)) return { ok: true }
|
|
151
|
+
return {
|
|
152
|
+
ok: false,
|
|
153
|
+
why: `改完只剩 ${a} 字,原文 ${b} 字(少了 ${b - a} 字,超过三成)——这看着像整段被删,不像改一句。真要删就带 allowShrink: true 再调一次。`,
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/** 留底。只留旧正文,不覆盖任何东西;同一条最多 `REVISION_KEEP` 版。 */
|
|
158
|
+
export function saveRevision({ workspace = '', dir = '.dsh-meow', id = '', level = '', title = '', content = '', reason = '' } = {}) {
|
|
159
|
+
const want = String(id ?? '').trim()
|
|
160
|
+
const body = String(content ?? '')
|
|
161
|
+
if (want === '' || body === '') return { saved: false, why: '空 id 或空正文,没什么可留的' }
|
|
162
|
+
if (!hasDb(workspace, dir)) return { saved: false, why: 'no-db' }
|
|
163
|
+
try {
|
|
164
|
+
const db = readyDb(workspace, dir)
|
|
165
|
+
const newest = db.p(`SELECT content FROM ${TABLE} WHERE memory_id = ? ORDER BY id DESC LIMIT 1`).get(want)
|
|
166
|
+
if (newest && String(newest.content ?? '') === body) {
|
|
167
|
+
// 上一版跟这一版逐字一样:再记一条只是流水账,读的人还得自己分辨哪条才是「上一版」。
|
|
168
|
+
return { saved: false, why: 'same-as-last', kept: revisionCount({ workspace, dir, id: want }) }
|
|
169
|
+
}
|
|
170
|
+
db.p(`INSERT INTO ${TABLE} (memory_id, level, title, content, reason, saved_at) VALUES (?,?,?,?,?,?)`).run(
|
|
171
|
+
want,
|
|
172
|
+
String(level ?? ''),
|
|
173
|
+
String(title ?? ''),
|
|
174
|
+
body,
|
|
175
|
+
String(reason ?? ''),
|
|
176
|
+
Date.now(),
|
|
177
|
+
)
|
|
178
|
+
db.p(
|
|
179
|
+
`DELETE FROM ${TABLE} WHERE memory_id = ? AND id NOT IN (SELECT id FROM ${TABLE} WHERE memory_id = ? ORDER BY id DESC LIMIT ${REVISION_KEEP})`,
|
|
180
|
+
).run(want, want)
|
|
181
|
+
return { saved: true, kept: revisionCount({ workspace, dir, id: want }) }
|
|
182
|
+
} catch (e) {
|
|
183
|
+
return { saved: false, why: `save-failed: ${e instanceof Error ? e.message : String(e)}` }
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
export function revisionCount({ workspace = '', dir = '.dsh-meow', id = '' } = {}) {
|
|
188
|
+
const want = String(id ?? '').trim()
|
|
189
|
+
if (want === '' || !hasDb(workspace, dir)) return 0
|
|
190
|
+
try {
|
|
191
|
+
const row = Meow.getDb(workspace, dir).p(`SELECT COUNT(*) AS n FROM ${TABLE} WHERE memory_id = ?`).get(want)
|
|
192
|
+
return Number(row?.n ?? 0)
|
|
193
|
+
} catch {
|
|
194
|
+
return 0
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/** 由新到旧列出留底的版本(不含正文,正文用 `revisionContent` 取)。 */
|
|
199
|
+
export function listRevisions({ workspace = '', dir = '.dsh-meow', id = '', limit = REVISION_KEEP } = {}) {
|
|
200
|
+
const want = String(id ?? '').trim()
|
|
201
|
+
if (want === '' || !hasDb(workspace, dir)) return []
|
|
202
|
+
try {
|
|
203
|
+
const rows = Meow.getDb(workspace, dir)
|
|
204
|
+
.p(`SELECT id, level, title, reason, saved_at, length(content) AS bytes FROM ${TABLE} WHERE memory_id = ? ORDER BY id DESC LIMIT ?`)
|
|
205
|
+
.all(want, Math.max(1, Math.min(REVISION_KEEP, Number(limit) || REVISION_KEEP)))
|
|
206
|
+
return (Array.isArray(rows) ? rows : []).map((r) => ({
|
|
207
|
+
id: Number(r.id ?? 0),
|
|
208
|
+
level: String(r.level ?? ''),
|
|
209
|
+
title: String(r.title ?? ''),
|
|
210
|
+
reason: String(r.reason ?? ''),
|
|
211
|
+
saved_at: Number(r.saved_at ?? 0),
|
|
212
|
+
bytes: Number(r.bytes ?? 0),
|
|
213
|
+
}))
|
|
214
|
+
} catch {
|
|
215
|
+
return []
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/** 上 `back` 版的正文(back=1 就是改之前那一版)。没有就 null。 */
|
|
220
|
+
export function revisionContent({ workspace = '', dir = '.dsh-meow', id = '', back = 1 } = {}) {
|
|
221
|
+
const want = String(id ?? '').trim()
|
|
222
|
+
const n = Number(back)
|
|
223
|
+
if (want === '' || !hasDb(workspace, dir)) return null
|
|
224
|
+
if (!Number.isInteger(n) || n < 1 || n > REVISION_KEEP) return null
|
|
225
|
+
try {
|
|
226
|
+
const row = Meow.getDb(workspace, dir)
|
|
227
|
+
.p(`SELECT content FROM ${TABLE} WHERE memory_id = ? ORDER BY id DESC LIMIT 1 OFFSET ?`)
|
|
228
|
+
.get(want, n - 1)
|
|
229
|
+
return row ? String(row.content ?? '') : null
|
|
230
|
+
} catch {
|
|
231
|
+
return null
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
/** 回执里那一行:只在真改过的时候出现,改过几次、最近一次什么时候。 */
|
|
236
|
+
export function revisionNote({ workspace = '', dir = '.dsh-meow', id = '' } = {}) {
|
|
237
|
+
const want = String(id ?? '').trim()
|
|
238
|
+
if (want === '' || !hasDb(workspace, dir)) return ''
|
|
239
|
+
let rows = []
|
|
240
|
+
try {
|
|
241
|
+
rows = Meow.getDb(workspace, dir)
|
|
242
|
+
.p(`SELECT saved_at FROM ${TABLE} WHERE memory_id = ? ORDER BY id DESC LIMIT ${REVISION_KEEP}`)
|
|
243
|
+
.all(want)
|
|
244
|
+
} catch {
|
|
245
|
+
return ''
|
|
246
|
+
}
|
|
247
|
+
const list = Array.isArray(rows) ? rows : []
|
|
248
|
+
if (list.length === 0) return ''
|
|
249
|
+
const last = fmtTs(list[0].saved_at)
|
|
250
|
+
return `🕘 改过 ${list.length} 次${last ? `(最近 ${last})` : ''},留底的旧版本能退回去`
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
export { REVISION_KEEP, SHRINK_FLOOR }
|