Skip to content

Commit a34bbe0

Browse files
committed
Merge origin/main into feat/653-settings-search
在远端已有的 main 合流之上再并一次当前 main(含 #680/#678): CHANGELOG 保留 #557/#582 与本分支 #653 条目;test/client.test.js 两段新增 测试都留(#653 搜索在前、#582 wiki 在后);lib/ 与 src/ 对齐。
2 parents da820bb + ef821d7 commit a34bbe0

17 files changed

Lines changed: 413 additions & 9 deletions

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,10 @@
33
## [Unreleased]
44

55
- **设置页加搜索:一张框扫全部组,两层折叠里的行也够得到(#653)**:设置页攒到 30+ 个开关后,「新增功能找不到入口」成了反复出现的抱怨(#607 的知识库、#653 的原话「浏览器的搜索功能在设置页面也搜不到『知识库』」)。浏览器 Ctrl+F 搜不到的机理很具体:**收起的组根本不在 DOM 里**——「全部设置」与「高级」两层折叠把不渲染的行藏在了 React 树之外,页内查找无从谈起。修法是在设置页顶部加一个常驻搜索框:有词时目录(#518)让位(跳转目标多半已被过滤掉,留着只会点到没反应),五组卡片按节过滤——**组标题或该组任一卡标题命中则整节原样显示**(搜「连接」应该看到全节而不是几行),**功能开关卡则切成命中行平铺**,两层折叠被绕开:折叠里的行恰恰是搜索最该够到的地方。行目录从六张常量表拼出来(`FEATURE_GROUPS` / `FEATURE_CHILDREN` / `FEATURE_ADVANCED_BOOLS` / `FEATURE_ENUMS` / `FEATURE_STRINGS` / `FEATURE_NUMBERS`),刻意不立第二份清单——任何一张表被绕开,那一层的行就从搜索里消失;四个没有通用渲染器的枚举键(embedProvider / 思考强度×2 / 地志档位)经 `SEARCH_ENUM_SOURCES` 补登记,取值直接引用各自已有常量。搜索分支的行渲染器与正常视图**同一份**(`boolRow`/`enumRow`/`strRow`/`numRow`,`enumRow` 为此加了 `valuesOverride` 形参而不是被克隆一份)——搜索路径改的行与正常路径逐字一致。子行在搜索结果里不缩进、不带 gate 标注:搜索结果是「这个键存在、可在这里改」,父子关系留给正常视图讲。全搜无果时有明确空态(点名搜索范围是名称/说明/键名),不是白屏也不是空卡。无新配置键(搜索不改任何行为,是纯视图过滤)、无新 CSS 色声明(布局走内联样式与既有类,#178 的对比度锁不受影响)。回归测试 9 条:索引必须走全六张表、**索引里每个键在双语词典各有一条标签**(76 键全量核对,缺一侧就会有一侧把键名当标签渲染)、目录让位与空态在场、`FeaturesCard` 唯一调用点且搜索分支复用四类渲染器、四条 i18n 键恰好中英各一条,以及评审补的四条:**每个用字面量渲染的行键都必须登记进某张可搜表**(`injectRotationTurns` 此前漏登记——它挂在自己的总闸下、不在任何组项数组里,只断言「索引引用了六张表」抓不到这一类)、搜索结果分支必须渲染 `saveError`(PUT 失败时控件回滚,不显示就成了「改了没反应」)、组内每张卡片标题都要在 `SECTION_TITLE_KEYS` 里(`configKeys.title` 此前缺席)、搜索框与空态文案必须分清「开关按行匹配」与「分组/卡片按标题匹配」。变异自证 8 例(索引删 `FEATURE_ADVANCED_BOOLS` / 删 `FEATURE_ENUMS` / 目录不让位 / enumRow 不传 valuesOverride / 漏登记 `injectRotationTurns` / 搜索分支不渲染 saveError / 漏登记 `configKeys.title` / 文案回退 → 各自变红),恢复后全绿。
6+
- **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 → 红),恢复后全绿。
7+
- **`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 红),恢复后全绿。
8+
9+
## [0.14.0-beta.3] - 2026-11-12
610
- **品牌视觉换新:README 头图与插件列表图标**。三处 README(根、`dsh-mneme/`、`mcp/`)顶部改用 `images/mneme-banner-hero.webp`(1672×941,282 KiB)——原图 2.1 MiB 的 PNG 会让 `images/` 目录体积翻倍。根目录用相对路径,两个子目录用 raw 绝对地址:npm 详情页不解析相对图片路径,`../images/...` 在 npmjs.com 上必然裂图。
711
- **插件列表图标从手绘 SVG 换成位图**:`package.json` 的 `icon` 改为 `assets/icon.png`(256×256 RGBA、圆角透明、120 KiB,仍在宿主 `iconOf()` 的 256 KiB 上限内);`assets/icon.svg` 删除。列表图标不再要求与客户端内联 mark(`MNEME_MARK_D`)同形,`test/client.test.js` 的图标用例改验 PNG 魔数、IHDR 边长、位深与 RGBA 通道——宿主对坏文件是静默回落成通用插画,不报错。
812

‎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/client.js‎

Lines changed: 60 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11748,6 +11748,11 @@ window.__ModuleLoader__.load({
1174811748
};
1174911749
let listItems = [];
1175011750
let inCode = false;
11751+
// 围栏要记「开启用的字符与长度」(PR #678 评审):只认三反引号会把
11752+
// `~~~html` 整块当正文,于是一条 `<!-- -->` 注释行会被下面的隐藏规则
11753+
// 删掉;四反引号块内部出现三反引号时旧写法也会提前退出代码态。
11754+
// CommonMark:结束围栏必须与开启同字符、长度不小于开启、其后只有空白。
11755+
let fence = null;
1175111756
let codeLines = [];
1175211757
// --- 表格(v0.11.1 美化):连续 `|` 行解析成真 table,不再按等宽行画竖线 ---
1175311758
const splitRow = (line) => String(line).trim().replace(/^\|/, "").replace(/\|$/, "")
@@ -11789,14 +11794,31 @@ window.__ModuleLoader__.load({
1178911794
};
1179011795
for (; i < lines.length; i++) {
1179111796
const line = lines[i];
11792-
if (line.trim().startsWith("```")) {
11793-
if (inCode) {
11797+
const fenceOpen = /^(`{3,}|~{3,})(.*)$/.exec(line.trim());
11798+
if (!inCode && fenceOpen) {
11799+
flushList(); flushTable();
11800+
inCode = true;
11801+
fence = { ch: fenceOpen[1][0], len: fenceOpen[1].length };
11802+
codeLines = [];
11803+
continue;
11804+
}
11805+
if (inCode) {
11806+
if (fenceOpen && fenceOpen[1][0] === fence.ch && fenceOpen[1].length >= fence.len
11807+
&& fenceOpen[2].trim() === "") {
1179411808
out.push(h("pre", { key: out.length, className: "mneme-wikipre" }, codeLines.join("\n")));
11795-
codeLines = []; inCode = false;
11796-
} else { flushList(); flushTable(); inCode = true; }
11809+
codeLines = []; inCode = false; fence = null;
11810+
} else {
11811+
codeLines.push(line);
11812+
}
1179711813
continue;
1179811814
}
11799-
if (inCode) { codeLines.push(line); continue; }
11815+
// 机器标记行不进正文(#582):`<!-- CHORO:T1:START/END -->` 与
11816+
// `<!-- CHORO:HUMAN:START/END -->` 是 t0/t1 剥段与回填用的段落边界,
11817+
// 给程序看的;排版里它们是一行裸文本噪音。只隐藏「整行以 <!-- 开头」
11818+
// 的情况;代码围栏里的注释原样保留(上面 inCode 分支已经 continue),
11819+
// choro_read_page 的工具回执与磁盘文件同样原样——真源纪律只约束数据
11820+
// 面,渲染层另有一层口径。
11821+
if (/^\s*<!--/.test(line)) continue;
1180011822
const heading = line.match(/^(#{1,6})\s+(.*)$/);
1180111823
if (heading) {
1180211824
flushList(); flushTable();
@@ -13738,9 +13760,40 @@ window.__ModuleLoader__.load({
1373813760
if (c.reason === "unverifiable") return t("wiki.drift.unverifiable");
1373913761
return String(c.reason ?? "");
1374013762
};
13763+
// 树的层级看 parent_id 真父子(#582),不看 slug 里的连字符数——
13764+
// slugify 把路径分隔与一切非字母数字都变成 `-`,目录名自带的连字符与
13765+
// 去重序号(-2)都会冒充层级,`packages-computer-use-src` 会被画成
13766+
// 三层深。moduleMap 本来就回了 id/parent_id,拿它建序:根(无父或父
13767+
// 不在表里)按 slug 序先出、孩子紧跟父后;环成员防御性归入兜底。
13768+
const depthById = new Map();
13769+
const order = [];
13770+
{
13771+
const ids = new Set(state.modules.map((m) => m.id));
13772+
const byParent = new Map();
13773+
for (const mod of state.modules) {
13774+
const pid = mod.parent_id != null && ids.has(mod.parent_id) ? mod.parent_id : null;
13775+
if (!byParent.has(pid)) byParent.set(pid, []);
13776+
byParent.get(pid).push(mod);
13777+
}
13778+
const bySlug = (a, b) => (a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0);
13779+
for (const list of byParent.values()) list.sort(bySlug);
13780+
const walk = (pid, depth) => {
13781+
for (const mod of byParent.get(pid) || []) {
13782+
if (depthById.has(mod.id)) continue; // 环防御:同一模块只进一次
13783+
depthById.set(mod.id, depth);
13784+
order.push(mod);
13785+
walk(mod.id, depth + 1);
13786+
}
13787+
};
13788+
walk(null, 0);
13789+
// 兜底:上面走不到的(不该存在的环)按 slug 序补在根层,不静默丢行。
13790+
for (const mod of state.modules.slice().sort(bySlug)) {
13791+
if (!depthById.has(mod.id)) { depthById.set(mod.id, 0); order.push(mod); }
13792+
}
13793+
}
1374113794
const tree = [];
13742-
for (const mod of state.modules) {
13743-
const depth = (mod.slug.match(/-/g) || []).length;
13795+
for (const mod of order) {
13796+
const depth = depthById.get(mod.id) ?? 0;
1374413797
// 树里直接挂「这页有几条要复核」:用户不用先点开才知道哪页被改动碰到。
1374513798
const dp = driftBySlug.get(mod.slug);
1374613799
const riskN = dp && dp.atRisk ? dp.atRisk.length : 0;

‎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));

0 commit comments

Comments
 (0)