Skip to content

Commit f3701f2

Browse files
committed
Merge origin/main into fix/582-wiki-rendering
CHANGELOG 保留 main 上的 #557 条目与本分支的 #582 条目,lib/ 与 src/ 重新对齐。
2 parents cdc9bc3 + 6f2adbf commit f3701f2

11 files changed

Lines changed: 890 additions & 616 deletions

File tree

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
## [Unreleased]
44

55
- **wiki 面板三处「给人看」的口径修正:机器标记不再露、文件 status 与库同步、树的缩进看真父子(#582)**:chorography 的价值主要在「人看」,但面板把三件「给程序看的东西」也摆了出来。**① `<!-- CHORO:T1:START/END -->` 等机器标记原样显示**——`renderWikiMarkdown` 没有 HTML 注释分支,t0/t1 用来剥段与回填的段落边界成了一行行裸文本;现在渲染层跳过「整行以 `<!--` 开头」的行,且**挂在代码围栏分支之后**(``` 块里的 HTML 注释是内容不是标记,先剥了它示例就缺行);`choro_read_page` 的工具回执与磁盘文件原样不动——真源纪律只约束数据面,渲染层另有一层口径。**② frontmatter 的 `status` 在 T1 之后不回写**——T1 成功只改库(`markChoroPageEnriched`),文件里那行永远停在 T0 写的 `skeleton`:11 个已富化模块页的文件与数据库状态全部不一致,看文件的人会以为从没富化过。现在 T1 成功路径(`enrichPageFile` → `markChoroPageEnriched` 同一条)把 `status: enriched` 一起写进 frontmatter(键名进 `render.js` 的 `FM_STATUS`,与 verified 两键同住——frontmatter 的形状属于页面格式);失败路径不写,文件停在 skeleton 与「首次失败不标 failed(骨架仍是有效产物)」的库侧口径一致;重富化幂等覆写、不重复插行。**存量已富化页的文件不做批量回填**(那些文件有用户手写的 HUMAN 保留区,机器批量改写内容文件不可逆),重跑一次 T1 即自然对齐。**③ 左侧模块树的缩进按 slug 连字符数算**——slugify 把路径分隔与一切非字母数字都变成 `-`,目录名自带的连字符与去重序号(`-2`)都会冒充层级,`packages-computer-use-src` 被画成三层深而 `docs`/`root` 顶格;现在用 `moduleMap` 本来就返回的 `id`/`parent_id` 建真父子序:根(无父或父不在表里)按 slug 序先出、孩子紧跟父后,环成员防御性归入根层兜底(宁可用根层平铺也不能静默丢行——树少一页等于入口没了)。回归测试 5 条:T1 成功把文件 status 推进到 enriched / 重富化幂等且 status 只有一行 / 失败路径不动文件 / 渲染器跳过分支必须挂在围栏分支之后 / 树构建必须用 parent_id 且连字符计数彻底退场。变异自证 4 例(删标记跳过 → 红;树退回连字符 → 红;撤 status 回写 → 红;回写错值 skeleton → 红),恢复后全绿。
6+
- **`dream_runs` 第一次有了保留期:`dreamRunsTrimDays`(opt-in 默认 0)裁掉窗口外轮次的重载列,行与骨架一个字节都不动(#557)**:这张表是四个 `*RetentionDays` 都不覆盖、也没有任何 `DELETE` 路径的唯一一张——单行 `input` 快照体量随记忆数涨、轮数随天数涨,两个因子**相乘超线性**(报告库占约 43% 的页),再叠加热快照 `VACUUM INTO` 是整库副本,它同时放大库与备份两处开销。issue 的建议 1(加保留期键 + 启动期清理)方向对,但按 11-04 的评论对齐口径落地:维护者 2026-09-23 拍板 3 是「**裁列同意、删行不同意**」,而 `dream_runs` 的每一行能回放一次巩固是 `distill_runs` 不复用它的理由——所以这里**不删行、不判「最近 N 轮」**(那三处读最新行的消费者 `lastDreamRunAt` / `lastDreamBaseline` / `getLatestPolicyEpoch` 读的全是骨架列,不受裁剪影响,自然也不必为它们保尾)。裁的是三列重载:`input`(记忆库快照,可由库重建)、`decisions`(原始 LLM 决策)、`outcome`(action 映射)——issue 评论实测列文本 13.26 MB 里 50.1% + 30.5% + 17.8%;`snapshot_hash` / `status` / `provider` / `receipt` / `policy_epoch` / `store_count` 等骨架列与行本身永远保留,窗口外轮次的离线回放降级为**骨架级**(与 `reclaim` 清 input、`dreamInputSummaryEnabled` 的瘦身同一条口径,`docs/CONFIGURATION.md` 写明三处互不冲突)。**`organize` 行整体豁免**:它的 `input` 是 apply 的重放载荷、`outcome` 挂着 `dry_run_id` / `applied_at` 链,裁了会让 apply 静默空转并锁死报告——谓词与 `clearDreamRunInputs` 同一条边界。**opt-in 默认 0 = 不裁**:升级后行为逐字节不变,键的形态对齐 `recallRetentionDays` 一族(顶层扁平键、只从配置文件改、`settings.js` 白名单同族现状一样不进——族里还没人开「进面板」这个头,要开得同时补 `api.js` 的 NESTED 表与 `client.js` 的面板行)。启动期执行(与其余四张表同策略:读装配后的 cfg、失败只 warn 不挡启动),**真裁到了才出一行 info**——常态一个字都不出,别把启动日志刷成心跳。`dreamRunsTrimStats` 与 `trimDreamRunPayloads` 共用同一谓词,报告数字与执行数字同源。回归测试 7 条(窗口外裁三列且骨架列逐列不变 / 行永不删 / organize 整体豁免 / 重跑 changes 为 0 / stats 与执行同口径 / 空表与无命中不抛 / 配置键默认 0 与边界 + 文档面列出该键 + 接线锁「0 不裁、读 cfg、失败只 warn」)。变异自证 4 例(删 organize 豁免 → 2 红;`> 0` 改 `>= 0` → 1 红;默认改 90 → 1 红;裁剪 SQL 漏掉 `outcome` → 3 红),恢复后全绿。
67

78
## [0.14.0-beta.3] - 2026-11-12
89
- **品牌视觉换新:README 头图与插件列表图标**。三处 README(根、`dsh-mneme/`、`mcp/`)顶部改用 `images/mneme-banner-hero.webp`(1672×941,282 KiB)——原图 2.1 MiB 的 PNG 会让 `images/` 目录体积翻倍。根目录用相对路径,两个子目录用 raw 绝对地址:npm 详情页不解析相对图片路径,`../images/...` 在 npmjs.com 上必然裂图。

‎dsh-mneme/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -523,6 +523,7 @@ dsh web
523523
| `sleepReasoningEffort` | 未配置=最低档 | sleep 各阶段 LLM 推理档位(同 dreamReasoningEffort 语义,v0.7.26) |
524524
| `recallRecordDefault` | `true` | recall_runs 记录默认开(显式传 `recordRecall:false` 的调用方不受影响);注入同样落账(`mode='inject'`,随本开关,#217) |
525525
| `recallRetentionDays` | `90` | recall_runs 滚动清理保留天数 |
526+
| `dreamRunsTrimDays` | `0` | dream_runs 重载列(input/decisions/outcome)的启动期裁剪窗口(天);0 = 不裁。裁列不删行(#557),organize 行豁免,窗口外回放降级为骨架级 |
526527
| `hotMemoryRounds` | `5` | 会话级短期热记忆轮次(v0.5.0):最近 N 轮对话滚动注入,从会话事件日志无状态重建、不落库 |
527528
| `hotMemoryMaxTokens` | `2000` | 热记忆 token 预算(v0.5.0,200-32000),超出滚动截断 |
528529
| `selectiveInjectEnabled` | `true` | 选择性注入(v0.5.0):query 向量可用时注入候选按主题相似度重排,替代固定规则序 |

‎dsh-mneme/docs/CONFIGURATION.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,7 @@
306306
| `evalPersistTestResults` | `false` | 检索评测快照落 `recall_evals` | 生产检索恒只进 `recall_runs`,与此键无关 |
307307
| `recallRecordDefault` | `true` | `recall_runs` 记录默认开 | 显式传 `false` 的调用方不受影响 |
308308
| `recallRetentionDays` | `90` | `recall_runs` 滚动清理保留天数 | — |
309+
| `dreamRunsTrimDays` | `0` | `dream_runs` 重载列(input / decisions / outcome)的启动期裁剪窗口(天) | opt-in,`0` = 不裁(#557:该表单行体量随记忆数、轮数随天数,相乘超线性,是四个保留期键都不覆盖的无界大户)。**裁列不删行**(拍板 3):骨架列与 receipt 永远保留,窗口外轮次的离线回放降级为骨架级;`organize` 行整体豁免(input 是 apply 的重放载荷)。与 `dreamInputSummaryEnabled`(写入期瘦身)、`dsh-mneme reclaim`(手动回收)互不冲突:三处都只是把对应列置空 |
309310
| `trustEpistemicWeighting` | `false` | 来源可信度(observation/subjective/inferred)参与排序与标注 | opt-in;关时 epistemic_status 只是惰性数据 |
310311

311312
### 重排层

‎dsh-mneme/lib/config.js‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1053,6 +1053,16 @@ export const Config = z.object({
10531053
recallRecordDefault: z.boolean().default(true),
10541054
// recall_runs 滚动清理保留天数。
10551055
recallRetentionDays: z.natural().min(1).max(3650).default(90),
1056+
// dream_runs 重载列(input 快照 / decisions / outcome)的启动期裁剪窗口(天),
1057+
// opt-in 默认 0 = 不裁(现状逐字节不变;#557:这张表是四个 *RetentionDays 都不
1058+
// 覆盖的无界增长大户,单行体量随记忆数涨、轮数随天数涨,相乘超线性)。拍板 3:
1059+
// 裁列同意、删行不同意——行与骨架列永远保留,回放能力对窗口外的轮次降级为骨架
1060+
// 级(与 reclaim 清 input、dreamInputSummaryEnabled 的瘦身同一条口径);organize
1061+
// 行整体豁免(input 是 apply 的重放载荷)。顶层扁平键、只从配置文件改,与
1062+
// recallRetentionDays 同族(进面板要同时补 api.js 的 NESTED 表与 client.js 的
1063+
// 面板行,族里还没人开这个头)。窗口别配得比「最近几轮」还短:/dream-status 的
1064+
// 最近 5 轮里被裁掉的老轮,decisions.demotion 会退化成 null(骨架与时间戳不受影响)。
1065+
dreamRunsTrimDays: z.natural().min(0).max(3650).default(0),
10561066

10571067
// --- tool exposure: 慢模型/轻量模型的工具往返节流(v0.8.5)----------------
10581068
// 跨会话记忆已由 inject.js 每轮自动注入系统提示词,memory_search 只用于

‎dsh-mneme/lib/index.js‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -333,6 +333,21 @@ export const apply = (ctx, config) => {
333333
ctx.logger?.warn?.(`[dsh-mneme] recall_runs retention purge failed: ${String(err)}`);
334334
}
335335

336+
// #557:dream_runs 重载列(input / decisions / outcome)的启动期裁剪。opt-in 默认
337+
// 0 = 不裁(零行为变化);开窗后与上面四处同策略——读装配后的 cfg、失败只 warn
338+
// 不挡启动。裁的是列不是行(拍板 3),organize 行豁免(store 层谓词,与 reclaim
339+
// 的 clearDreamRunInputs 同一条边界)。真裁到了才出一行 info:常态(库还小 /
340+
// 没开窗)一个字都不出,别把启动日志刷成心跳。
341+
try {
342+
const dreamRunsTrimDays = Number.isInteger(cfg.dreamRunsTrimDays) ? cfg.dreamRunsTrimDays : 0;
343+
if (dreamRunsTrimDays > 0) {
344+
const trimmed = store.trimDreamRunPayloads(new Date(Date.now() - dreamRunsTrimDays * 86400000).toISOString());
345+
if (trimmed > 0) ctx.logger?.info?.(`[dsh-mneme] dream_runs payload trim: ${trimmed} run(s) beyond the ${dreamRunsTrimDays}d window (columns cleared, rows kept)`);
346+
}
347+
} catch (err) {
348+
ctx.logger?.warn?.(`[dsh-mneme] dream_runs payload trim failed: ${String(err)}`);
349+
}
350+
336351
// 记忆语言(memory.language):本实例逐层传入 inject / summarize / dream /
337352
// sleep / mirror,多实例(如 agent preset 内挂载)互不影响。
338353
const mirror = createMirror(memoryDir, langOf(cfg));

‎dsh-mneme/lib/store.js‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3871,6 +3871,38 @@ export function createStore(path) {
38713871
).run(before).changes;
38723872
}
38733873

3874+
// #557 的裁列面:input 之外的大头是 decisions / outcome 两列 JSON(issue 评论区
3875+
// 实测 13.26 MB 列文本里 50.1% + 30.5%)。拍板 3 的口径是「裁列同意、删行不同意」
3876+
// ——行与骨架列(status / provider / receipt / policy_epoch / store_count…)永远
3877+
// 保留,回放能力对窗口外的轮次降级为骨架级(与 reclaim 清 input、#625 的瘦身同
3878+
// 一条口径)。organize 行整体豁免:input 是 apply 的重放载荷、outcome 挂着
3879+
// dry_run_id / applied_at 链,裁了会让 apply 静默空转(clearDreamRunInputs 的同一
3880+
// 条边界)。读侧已逐个核对:lastDreamRunAt / lastDreamBaseline / getLatestPolicyEpoch
3881+
// 读的都是骨架列,/dream-status 的 decisions.demotion 是可选链(裁掉的老轮退化成
3882+
// null);reclaim 的 A 项刻意不碰 decisions/outcome——那是「随手跑的无损回收」的
3883+
// 边界,这里是显式配置键(dreamRunsTrimDays,opt-in 默认 0 = 关)驱动的启动期裁剪。
3884+
function dreamRunsTrimStats(before) {
3885+
const row = db.prepare(
3886+
`SELECT count(*) AS c,
3887+
COALESCE(SUM(LENGTH(input)), 0) + COALESCE(SUM(LENGTH(decisions)), 0)
3888+
+ COALESCE(SUM(LENGTH(outcome)), 0) AS b
3889+
FROM dream_runs
3890+
WHERE created_at < ? AND run_type != 'organize'
3891+
AND (input IS NOT NULL OR decisions IS NOT NULL OR outcome IS NOT NULL)`
3892+
).get(before);
3893+
return { runs: row.c, bytes: row.b };
3894+
}
3895+
3896+
/** 裁掉窗口外 run 的三列重载(organize 豁免)。返回实际改动的行数;重跑幂等。 */
3897+
function trimDreamRunPayloads(before) {
3898+
return db.prepare(
3899+
`UPDATE dream_runs
3900+
SET input = NULL, decisions = NULL, outcome = NULL
3901+
WHERE created_at < ? AND run_type != 'organize'
3902+
AND (input IS NOT NULL OR decisions IS NOT NULL OR outcome IS NOT NULL)`
3903+
).run(before).changes;
3904+
}
3905+
38743906
/**
38753907
* 归档行仍带的向量统计(#275 B 项)。检索 SQL 恒带 `archived = 0`,所以这部分
38763908
* 向量按定义不可达,清掉不改变任何检索结果。
@@ -5986,6 +6018,8 @@ export function createStore(path) {
59866018
// 存储生命周期(#275 第一批):无损回收的统计、清理与体积口径。
59876019
dreamRunInputStats,
59886020
clearDreamRunInputs,
6021+
dreamRunsTrimStats,
6022+
trimDreamRunPayloads,
59896023
archivedEmbeddingStats,
59906024
clearArchivedEmbeddings,
59916025
storageStats,

0 commit comments

Comments
 (0)