Skip to content

Commit 78523cc

Browse files
authored
Merge branch 'main' into fix/embed-reasons
2 parents 9c5e90c + 068e852 commit 78523cc

10 files changed

Lines changed: 353 additions & 21 deletions

File tree

‎README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-3E63DD?style=flat-square" alt="license"></a>
1111
<a href="https://github.com/slow-stack/mneme/actions"><img src="https://img.shields.io/github/actions/workflow/status/slow-stack/mneme/ci.yml?style=flat-square&label=CI" alt="CI"></a>
1212
<a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-22%2B-3E63DD?style=flat-square&logo=nodedotjs&logoColor=white" alt="node"></a>
13-
<a href="https://github.com/slow-stack/mneme"><img src="https://img.shields.io/badge/tests-2205%20passed-3E63DD?style=flat-square" alt="tests"></a>
13+
<a href="https://github.com/slow-stack/mneme"><img src="https://img.shields.io/badge/tests-2214%20passed-3E63DD?style=flat-square" alt="tests"></a>
1414
<a href="https://codecov.io/gh/slow-stack/mneme"><img src="https://img.shields.io/codecov/c/github/slow-stack/mneme/main?style=flat-square" alt="coverage"></a>
1515
<a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome"></a>
1616
</p>
@@ -271,7 +271,7 @@ dsh-mneme-serve # 默认 ~/.dsh/memory + 127.0.0.1:8790
271271

272272
```bash
273273
cd dsh-mneme && npm install
274-
npm test # 2205 个测试
274+
npm test # 2214 个测试
275275
npm run stress # 三轴线压测
276276
npm run sync # src → lib 同步
277277
```
@@ -552,7 +552,7 @@ Community projects that wire mneme into more platforms — not part of this repo
552552

553553
```bash
554554
cd dsh-mneme && npm install
555-
npm test # 2205 tests
555+
npm test # 2214 tests
556556
npm run stress # three-axis stress test
557557
npm run sync # src → lib sync
558558
```

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,12 @@
44

55
## 🆕 新增
66

7+
- **功能开关的第三态「待重启」:把「面板显示已改 ≠ 运行时已改」这个落差摆到界面上(#481)**:功能开关的生效节奏一直是**启动期**的——`lib/index.js` 在装配时把 kv 里的覆盖合并进一份 cfg,注入器与后台任务闭包持有那份快照,此后运行中的实例不再重读(`index.js` 装配处的注释早就写明「合并结果只作用于本次启动」)。这是有意为之的设计,不是 bug;**缺的是提示**:面板上「已改」徽标亮起只说明值进了库,不说明运行中用上了它。实测代价很具体——人格总闸在面板上显示已开启、人格段却整整一轮没注入,排查到最后才发现唯一变量是那份冻结 cfg 里 `personaEnabled` 仍是 `false`,把插件关开一次就好了;而在此之前,用户能拿到的唯一反馈是「怎么没用」。修法分两层,**后端只做比较、前端只做显示**:`featureSnapshot()` 新增 `pendingRestart`,列出「kv 里有显式覆盖、且该覆盖与冻结值不同」的键(嵌套点号键走既有 `NESTED_FLAG_PATHS`,比较用 `Object.is` 而不是 `!==`——NaN 与 ±0 上两者结论相反,开关值里不该出现它们,但「值是否相同」的语义要对齐);面板把 `flagTag` 从两态扩成三态(待重启 / 已改 / 默认)并在卡片顶部加一条提示行,写明「重启 DSH,或在插件管理里把本插件关开一次」。**为什么必须由后端算**:前端手上只有 `overrides`,它能回答「改没改」,回答不了「用没用上」——那需要另一份冻结值,前端拿不到。`effective` 也反推不出待重启,它按「overrides 优先」取值,恰好在有覆盖时把落差盖住了,所以只能是新字段而不是新语义。`config` 缺席时(旧调用方直连、未传 cfg)返回空数组而不编造,`pendingRestart` 恒为数组、恒不为 `undefined`(面板按长度渲染,字段缺失会渲染出 `undefined.length`)。既有 `overrides` / `effective` 语义一字未动,回归锁四条:值不同→列出、值相同→不列、无覆盖→不列、无 cfg→空数组。
78
- **作用域级可逆闸门:让一路记忆能被单独按下与松开,而不必改配置重启(#471,默认关)**:此前的开关全是**进程级**——想停掉某一路(比如「别再把工作区 A 的记忆注进来」)只有两条路,改全局配置(一起停,误伤别的路)或逐条 `memory_forget`(太细,几百条要手工捞,还会漏掉中途新写的行)。缺的不是开关数量,而是**另一根轴**:本仓早就有完整的事实轴(`memories.agent_scope` / `workspace_scope` 与 `scope_changes` 审计),却没有任何**可逆政策轴**——一个「人给的、可撤回的、存续到下次开工的」暂停状态,它与标注正交:按下不改任何一条记忆的标注,松开也不需要把标注改回来。实现是 `scope_state` 表(`dimension` × `scope_value` 唯一索引 + `state` 二值 `active`/`paused` + `note`),配 `src/scope-state.js` 承载判定,闸门挂在 `gateByScope` 旁并**前置**于既有 `strictScope` 硬过滤——于是两条轴串联而不是互相替代:先按人给的政策把整路按下,再按标注做可见性过滤。**重复按下同一状态不刷新 `decided_at`**(用 `ON CONFLICT ... DO UPDATE SET decided_at = CASE WHEN scope_state.state = excluded.state THEN scope_state.decided_at ELSE excluded.decided_at END` 一条语句表达):「什么时候真的变了」比「最后一次谁点了按钮」更接近审阅时想知道的事实,反复点同一个按钮不该把它变成刚发生的事。覆盖范围刻意与既有的四处 `gateByScope`/硬过滤落点对齐(三条检索路 + 注入候选池),**并单独接了巩固与睡眠两侧的全部读入口**(日间:活跃库尺寸、叙述条 inputs、巩固 `runDream`、**总览 `summaryAll`**;夜间:冲突消解、归档降级、模式发现、关系补全四个相位)——只改检索与注入会让整理与叙述仍读到被按下的行,那等于闸门只关了一半。**睡眠侧尤其要紧,因为那几个相位不只读**:`phaseDemotion` 会 `setArchived` 与 `demoteToSummary`(真改归档面),`phasePatterns` 会铸出 `type=pattern` 的新行——闸门开着而每 6 小时一次的睡眠照样在被按下的作用域上动手,「按下」就只等于让它在白天看不见。两处位置纪律也写进了注释:降级的过滤放在循环之外而不是循环体里 `continue`(一旦将来有人在循环体里加副作用,漏掉那条 `continue` 就是静默改到被按下的行),模式发现的过滤排在 `.slice(0, limit)` 之前(否则被按下的行照样占掉名额,它们既不会被扫、也不该挤掉别人)。**总览那一处是唯一「必须在源头挡」的**:总览落库走 `saveWithDedupe` 且不带 `agent_scope`/`workspace_scope`,它是**无作用域**的 summary 行,而 `gateInjection` 只拦匹配暂停作用域的行——没有标注的行永远不会被它拦下。于是被按下的内容一旦进了总览就变成「洗干净的全局行」,此后一直注入;别的入口漏一次只漏那一条,这里漏了是每轮洗一遍。回归用例把这条写成了可执行断言:总览落库后其 `workspace_scope` 恒为 `null`,将来若有人把总览改成带作用域的,它会红。两级语义沿用 #254:`enabled` 开判定、`enforce` 开拦截,`enforce` 关时只留审计行而注入照常(线上回滚不必改配置重启)。`set_scope_state` 是唯一新工具,回执**如实回显库里当前的 `decided_at`** 而不是回显入参——重复按下时这两个值不同,回显入参会让界面显示一个从未落盘的时间。默认全关时输出与改动前**逐字节一致**,且有回归用例锁住这条。
9+
## 🐛 修复
10+
11+
- **`--flag` 的值以 `--` 开头时被当成新旗标吞掉:一次 CI 红背后的真实 CLI 缺陷**:崩在 `test (windows-latest, 22)` 的那条用例是 `reclaim 默认 dry-run 报数字`,报错却是「未配置访问 token」——命令自身没问题,问题在 token 的形状。token 由 `randomBytes(24).toString("base64url")` 生成,而 base64url 的字母表**含 `-`**,于是约 1/4096 的 token 前两位都是 `-`,拼进命令行就成了 `--UYoOHxr6…`;旧 `parseArgv` 只要看到下一个词以 `--` 开头就当上一个旗标没有值(`token = true`),`flagValue` 再按「`true` 等于没给」回退 `DSH_MNEME_TOKEN` 与 `~/.dsh-mneme/cli.json`,两者都空 → 报未配置 token。**这是随机性,不是测试写法**:同一个缺陷平时一律绿,只在 token 恰好掷中这 1/4096 时才现形,因此它潜伏了整整一个发布周期而没有任何检查会红。影响面也不止 token:`--type` / `--title` / `--content` 只要值以 `--` 开头就同样坏,而这三个值完全由用户输入。修法是把「像不像旗标」从字符串前缀改成**登记表**:新增 `KNOWN_FLAGS` 收录全部取值旗标与布尔旗标,`flagKeyOf()` 认 `--foo` / `--foo=bar` 两种写法取键名,只有**已登记**的词才算旗标,其余一律当上一个旗标的值——`--limit --json` 这类旧语义(`limit` 无值、`json` 为布尔)分毫不动。选登记表而不是加引号规则:引号要经过 shell 才生效、PowerShell 与 cmd 的转义还不一样,而登记表在进程内就能判定。回归锁六条,最关键的两条覆盖 CI 现场(断言 `flags` 的键恰好是 `["token","url"]`,token 尾巴不得成为旗标)与「未知 `--` 词按值处理」;另有一条文本锁扫 `cli.mjs` 里所有 `flagValue`/`flagBool` 调用的字面量键名,要求全部已登记——漏登记的后果正是这里修的静默吞值,所以让它变成一条会红的测试而不是等下一个 1/4096。顺带补 `invokedDirectly` 守卫(`realpathSync` 双侧比较,因全局安装走 `.bin` 符号链接,字符串相等会误判),使 `cli.mjs` 可被测试 import 而不触发 `main()`;在旧实现上撤掉修复,这两条会变红,恢复后 6/6 绿。
12+
- **人格卡删除 × 永远不可见(v2 修法)**:卡标签的 × 复用了规则删除按钮的 `mneme-set-del` 样式,其 `opacity:0` 只在 `.mneme-set-row:hover` 下解除,而卡标签不在该悬停容器里,导致 × 永远透明——功能在、入口不可见(v1.2 实测踩中)。#457 曾以内联 `opacity:1` 覆写修复,但悬停变红仍走 `.mneme-set-del:hover`,连带常点亮了规则区的删除按钮,被 #459 回滚。本修复改用独立类 `mneme-persona-del`(常显、悬停变红),不触碰 `mneme-set-del`,规则区行为分毫不动;回归锁直接钉死卡删除按钮的 `className` 值,防 #457 式修法回归。
813

914
## 📚 文档
1015

‎dsh-mneme/README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
[![npm version](https://img.shields.io/npm/v/@modusensus/dsh-mneme?color=blue&label=npm)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
66
[![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
77
[![Awesome](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
8-
[![tests](https://img.shields.io/badge/tests-2205%20passed-success)](https://github.com/slow-stack/mneme)
8+
[![tests](https://img.shields.io/badge/tests-2214%20passed-success)](https://github.com/slow-stack/mneme)
99
[![CI](https://img.shields.io/github/actions/workflow/status/slow-stack/mneme/ci.yml)](https://github.com/slow-stack/mneme/actions)
1010
[![node](https://img.shields.io/badge/node-22%2B-blue)](https://nodejs.org)
1111
[![npm downloads](https://img.shields.io/npm/d18m/@modusensus/dsh-mneme.svg?color=blue&label=downloads)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
@@ -674,7 +674,7 @@ src/
674674
├── api.js # HTTP 路由(Web 面板数据通道,含 /conflicts 冲突队列)
675675
└── index.js # 插件接线
676676
lib/ # src 的同步分发产物(npm run sync,prepack 钩子在发布时自动跑;一致性由 scripts/check-sync.js 在 CI 与 release.yml 校验——它只查不同步;唯一手写例外 lib/client.js——Web 面板 bundle,sync 不覆盖)
677-
test/ # 2205 个 node:test 测试(审计与三轴线压测不变量;src↔lib 一致性由 scripts/check-sync.js 发布闸门校验)
677+
test/ # 2214 个 node:test 测试(审计与三轴线压测不变量;src↔lib 一致性由 scripts/check-sync.js 发布闸门校验)
678678
scripts/ # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压测 · sync-lib.js 同步 · check-sync.js 发布闸门 · benchmark-recall.js / benchmark-embed.js / benchmark-rerank.js 基准 · sync-test-badge.mjs 测试徽章 · build-runtime-manifest.mjs 运行时清单
679679
```
680680
@@ -683,7 +683,7 @@ scripts/ # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压
683683
```bash
684684
cd dsh-mneme
685685
npm install # 安装 peer 依赖(以 devDependencies 形式,用于本地测试)
686-
npm test # 运行 2205 个测试
686+
npm test # 运行 2214 个测试
687687
npm run stress # 三轴线压测:长会话检索 / 冲突仲裁 / 多 Agent 并发(离线 mock LLM)
688688
npm run sync # 把 src/ 同步到 lib/(发布时由 prepack 钩子自动执行)
689689
```

‎dsh-mneme/bin/cli.mjs‎

Lines changed: 61 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,40 @@ const USAGE = `${CLI_NAME} —— DSH 记忆插件(@modusensus/dsh-mneme)外
102102

103103
/* ---------------------------------- 参数解析 ---------------------------------- */
104104

105+
// `--flag value` 形态下,「下一个词以 -- 开头就别当值」这条规则有一个致命反例:
106+
// 值本身就可能是 `--` 开头的字符串。外部 API 的 token 由
107+
// `crypto.randomBytes(24).toString("base64url")` 生成(src/api-standalone.js),
108+
// base64url 的字母表含 `-`,所以约 1/4096 的 token 头两位恰好都是 `-`:
109+
//
110+
// dsh-mneme reclaim --url http://127.0.0.1:55423 --token --UYoOHxr6PtE2-bfqW...
111+
//
112+
// 旧规则把 `--UYoOHxr6PtE2-bfqW...` 当成一个新旗标(键名 `uyoohxr6pte2-bfqw...`),
113+
// 于是 token 解析成 `true`,flagValue 视作「没给」→ 退回环境变量/配置文件 → 全空
114+
// → 报「未配置访问 token」。而 CLI 生成 token 的另一半同样会撞:`--token=--abc`
115+
// 走等号分支没事,`--token --abc` 就废。这不是测试的随机性,是真实用户的随机性。
116+
//
117+
// 修法:区分「已知旗标」与「未知词」。下一个词以 `--` 开头时,只有它确实是一个
118+
// 已注册的旗标才当作旗标,否则当作当前 flag 的值。于是 `--limit --json` 仍按
119+
// 旧语义把 --json 当旗标,而 `--token --UYo...` 正确取到 token。
120+
// 已知旗标表必须与下面 flagValue/flagBool 的实际用法保持同步;漏登记的代价是
121+
// 该旗标被当成值吞掉,所以 test/cli-flag-value.test.js 用文本锁对齐两者。
122+
const KNOWN_FLAGS = new Set([
123+
// 取值的旗标
124+
'url', 'token', 'type', 'title', 'content', 'importance', 'tags', 'source',
125+
'limit', 'offset', 'mode', 'topk', 'top-k', 'min-importance', 'minimportance',
126+
'older-than', 'olderthandays',
127+
// 布尔旗标
128+
'apply', 'vacuum', 'json', 'help', 'version'
129+
]);
130+
131+
/** `--foo=bar` / `--foo` 取出小写键名;非旗标词返回 null。 */
132+
function flagKeyOf(word) {
133+
if (typeof word !== 'string' || !word.startsWith('--') || word === '--') return null;
134+
const key = word.slice(2);
135+
const eq = key.indexOf('=');
136+
return (eq >= 0 ? key.slice(0, eq) : key).toLowerCase();
137+
}
138+
105139
function parseArgv(argv) {
106140
const positionals = [];
107141
const flags = {};
@@ -118,10 +152,14 @@ function parseArgv(argv) {
118152
if (eq >= 0) {
119153
value = key.slice(eq + 1);
120154
key = key.slice(0, eq);
121-
} else if (i + 1 < argv.length && !argv[i + 1].startsWith('--') && argv[i + 1] !== '--') {
122-
value = argv[++i];
123155
} else {
124-
value = true;
156+
const next = argv[i + 1];
157+
const nextIsFlag = next !== undefined && flagKeyOf(next) !== null && KNOWN_FLAGS.has(flagKeyOf(next));
158+
if (next !== undefined && next !== '--' && !nextIsFlag) {
159+
value = argv[++i];
160+
} else {
161+
value = true;
162+
}
125163
}
126164
flags[key.toLowerCase()] = value;
127165
} else {
@@ -691,7 +729,23 @@ async function main(argv) {
691729
}
692730
}
693731

694-
main(process.argv.slice(2)).catch((err) => {
695-
console.error(err?.stack ?? String(err));
696-
process.exit(1);
697-
});
732+
// 直接运行才进 main(import 只取 parseArgv 做单测时必须安静):npm 全局安装走
733+
// node_modules/.bin 的符号链接,argv[1] 是链接路径而非真身,所以要 realpath 两侧
734+
// 再比,不能用字符串相等。
735+
const invokedDirectly = (() => {
736+
if (process.argv[1] == null) return false;
737+
try {
738+
return fs.realpathSync(process.argv[1]) === fs.realpathSync(fileURLToPath(import.meta.url));
739+
} catch {
740+
return false;
741+
}
742+
})();
743+
744+
if (invokedDirectly) {
745+
main(process.argv.slice(2)).catch((err) => {
746+
console.error(err?.stack ?? String(err));
747+
process.exit(1);
748+
});
749+
}
750+
751+
export { parseArgv, KNOWN_FLAGS, flagValue, flagBool, flagKeyOf };

‎dsh-mneme/lib/api.js‎

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,15 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
207207
// feature flags 快照(GET/PUT 共用):overrides 是持久化的用户显式覆盖;
208208
// effective 是启动配置在白名单键上被 overrides 覆盖后的最终值。config 缺席
209209
// (旧调用方直连、未传 cfg)时只报被覆盖的键,不把不存在的默认值编造给前端。
210+
//
211+
// pendingRestart 回答的是第三个问题:「我改的开关,现在真的生效了吗?」
212+
// 功能开关的生效节奏与 panel_mode 相同——启动时由 index.js 合并进 cfg,运行中
213+
// 那份 cfg 是冻结的(见 index.js 装配处的注释)。于是面板显示「已改」不等于
214+
// 运行时已改:#481 实测人格总闸正是这样,面板开着、人格段却不注入,用户只能
215+
// 靠反复试错发现。effective 表达的是「运行时取什么值」(overrides 优先),
216+
// **反推不出待重启**,必须另比一次冻结值——这是本字段存在的唯一理由。
217+
// 只报「显式覆盖 ≠ 冻结值」的键:未被覆盖的键运行时值就是 cfg 值,不存在落差;
218+
// config 缺席(旧调用方直连、未传 cfg)时无从比较,返回空数组而不编造。
210219
const flagKeys = [
211220
...FEATURE_FLAG_SPEC.booleans,
212221
...Object.keys(FEATURE_FLAG_SPEC.ints),
@@ -245,6 +254,19 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
245254
if (path) return config?.[path[0]]?.[path[1]];
246255
return config?.[key];
247256
}
257+
// 「显式覆盖 ≠ 冻结值」的键。用 Object.is 比而不是 !==:NaN 与 ±0 的边角上
258+
// 两者会给出相反的结论(Object.is(NaN, NaN) 为真、Object.is(0, -0) 为假),
259+
// 开关值里虽然不该出现它们,但比较语义与「值是否相同」对齐更省心。
260+
// 未被覆盖的键不看:它的运行时值本来就取自 cfg,不存在落差。
261+
function pendingRestartKeys(overrides) {
262+
if (!config) return [];
263+
const pending = [];
264+
for (const key of flagKeys) {
265+
if (overrides[key] === undefined) continue;
266+
if (!Object.is(overrides[key], configFlagValue(key))) pending.push(key);
267+
}
268+
return pending;
269+
}
248270
function featureSnapshot() {
249271
const overrides = settings.getFeatureFlags();
250272
const effective = {};
@@ -255,7 +277,7 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
255277
if (value !== undefined) effective[key] = value;
256278
}
257279
}
258-
return { overrides, effective };
280+
return { overrides, effective, pendingRestart: pendingRestartKeys(overrides) };
259281
}
260282

261283
// Ensure the service has an embedder when the API layer was handed one

0 commit comments

Comments
 (0)