Skip to content

Commit 3ef2942

Browse files
authored
Merge pull request #679 from slow-stack/fix/581-choro-portable-identity
feat(choro): 仓库身份与位置分家——portable_key + 每机位置表(#581)
2 parents 1fb1c4a + 4c582f3 commit 3ef2942

23 files changed

Lines changed: 1125 additions & 97 deletions

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
## [Unreleased]
44

5+
- **仓库地志的身份与位置分家:`portable_key` + 每机位置表,双系统 / 双机共享同一个 memory.db 时地志第一次可以跨端复用(#581)**:mneme 把「库共享」做到了(`memoryDir` + WAL + busy_timeout),chorography 是唯一一处因为记了本机绝对路径而破坏这个前提的功能——Windows 端登记的行,macOS 端拼出来的路径不存在;再跑一次 T0 又多出第二行,从此不带 `repo` 参数的调用命中 repo-ambiguous;T1 的逐字符严格匹配更意味着**每端都必须先各自跑一次 T0**。修法按 issue 的最小方案落地,三个概念各就各位:**身份** = `choro_repos.portable_key`(新列,幂等迁移),取 `remote.origin.url` 归一化——协议头 / 尾斜杠 / 尾 `.git` / 大小写剥平,scp 形态(`git@host:path`)的冒号换 `/`,**userinfo 整体剥掉**(token 不进键:泄进库里是一回事,令牌轮换后同一仓库算出不同键是另一回事);无 remote 退化到**根提交哈希**(`git:<hash>`,跨副本恒定且与「碰巧同名的别的仓库」天然区分——issue 提的「退化为仓库名」不能用,目录名与 package name 重合率太高,第二次登记会吃掉别人的行,实现期在测试夹具上当场撞到)。**位置** = 新表 `choro_repo_paths(repo_key, host_id, root_path, last_seen_at)`,`host_id = os.hostname()`,T0/T1 登记时 upsert。**读侧**(`queries.js` 的 `localRootPath`)按当前 host 取本机路径、取不到回退身份行的 root_path——单机库两个值恒等、行为逐字节不变;本机没登记过时落进既有的 page-missing / unreadable 失败口径,不会拿别的机器的路径读出错误内容。**T1 的登记校验**从「root_path 逐字符相同」改成「本机路径命中**或**身份已登记」——同一仓库在另一台机器登记过,本机直接认领那一行富化,消灭「每端先各跑一次 T0」;认领同时落本机位置行。写路径(`/choro/run`、`/choro/t1` 后台任务、`/choro` 命令的过期判定)同样改吃本机根。**两个刻意的取舍**:① 同键登记收敛到同一行,但 root_path 的 UPDATE 前先查目标值是否被别的行占着(被占保留原值、位置走位置表)——升格期已跨端登记出的重复行**不合并**(页面与 claims 挂在 repo_id 上,机器间合并行等于改写归属),强行改会撞 `idx_choro_repos_root` 直接抛;② 升格存量行的键留 NULL,由它自己的机器重跑 T0/T1 时补上,不猜。已知边界:kb 导入的 choro_page source 是导入当时的绝对路径快照,跨端复用时会失配,另账处理。回归测试 +10(URL 归一化形态表含凭据剥离 / 无 remote 退化链与恒定性 / 旧库补列补表且重开幂等 / 位置表同键同机覆写 / 同键跨端登记收敛同一行且 created_at 不动 / 升格期 root 被占不强改 / 读侧三 host 各解析各的 / **T1 跨端认领端到端**:克隆检出直接富化身份行并登记本机位置),另把四个「同库登记两个相同夹具」的既有用例显式区分开(无 remote 键是根提交哈希,同秒提交的相同内容会同键收敛——这本身就是退化链设计的防误并性质)。变异自证 3 例(删 `upsertChoroRepoPath`/`choroRepoPathFor` 的 return 出口 → store 用例 3 红;读侧 `localRootPath` 去掉位置行解析 → queries 用例红;T1 去掉 byKey 认领 → 端到端用例红),恢复后全绿。**评审补丁(PR #679,六条 Major 全部成立)**:① **路径回退要核验身份**——两台主机的同一条绝对路径可能各自检出不同仓库,`upsertChoroRepo` / T1 的登记校验、读侧 `localRootPath` 都改成「身份优先,路径回退只接受无键存量行或键一致的行」;核验用 `portableKeyFor`(一次 git 读取,按「键+路径」记忆化),不符时读侧返回空串并按 `page-missing` / 不可读上报,绝不 `join("", rel)` 去读进程 CWD;`claimDrift` 的 `hasT1` 同样加了空根守卫。② **身份唯一**:`portable_key` 加部分唯一索引(`WHERE portable_key IS NOT NULL`),插入撞唯一键时回读同一身份行改走更新——并发登记不再产生重复行;索引建失败(存量重复键)退成非唯一索引,不让插件起不来。③ **URL 解析分清端口与 scp 分隔符**:带协议头时 authority 的冒号是端口(默认端口 ssh 22 / https 443 / git 9418 剥掉,其余保留),只有 scp 形态的冒号才是路径分隔符;④ **userinfo 只在 authority 段内剥**,仓库路径里的 `@`(`repo@stable`)不再把主机与路径一起切掉。⑤ `repoByCwd` 的最长前缀改为比较候选自身路径长度(原实现拿身份行里那条外地路径比长度,内层本机路径永远赢不了)。新增回归 5 条(端口 vs 路径段 / 路径里的 @ / 同路径另一身份拒绝且原行不变 / 回退目录身份不符报 page-missing / 前缀比较用候选长度),变异自证 6 例逐条变红。**二轮评审补丁**:① **写路径补空根守卫**——`/choro/run` 原先直接吃 `localRootForRepo` 的返回值,该方法在本机未登记位置、且回退目录身份核验不过时返回空串,`resolve("")` 即宿主 cwd,T0 会把那里的模块与页写进这条 repo 行(「同一路径不同仓库」事故的另一半:读路径挡住了、写路径漏了);现在空根直接 409 `repo-not-reachable-here`,并对旧装配沿用 `typeof` 守卫退回 `root_path`。② **userinfo 只在主机段内剥**:scp 形态先在冒号处切开再找 `@`,`github.com:team/repo@stable` 不再退化成整段丢失的 `stable`。③ 唯一索引建失败退普通索引时补一行 warn,不再静默降级。新增回归 2 条(空根 409 且不触 T0 / 旧装配缺方法退回 `root_path`),URL 形态表补 5 条断言;变异自证 4 红(撤守卫 + 退回全串 `indexOf("@")`)。
56
- **取代链与遗忘的接缝修好了:继任者被 `memory_forget` 之后,被取代的旧值不再回潮成为「当前答案」(#532 存储层半边)**:#532 主楼的现象是「更正两个事实、只忘一个,保留的那个答回更正前的旧值」。`docs/FORGET.md` 的定案把根因拆成三段接缝(更正落新行且旧行活跃 / `memory_forget` 行粒度 / 旧值行成了唯一幸存载体),其中第二、三段的交互有一个**确定性**缺陷:`#650` 给 `supersededIds()` 加的守卫把「继任者归档、遗忘、删除」统一当成「继任者退场」,于是继任者一旦被遗忘,被它取代的旧行就重新回到注入面——而 `memory_forget` 的语义恰恰是「我不要再记得这个内容」,让用户明确抛弃的旧答案借继任者的退场回潮,正是本报的现象。现在两种情况分开:**遗忘继任者**不再恢复旧行可见性(旧行仍留在 suppressed 集合里、注入面不选它,但显式搜索照旧读得到——`fuseRecall` 只降权 0.5,不是沉默的不可逆失效);**归档继任者**维持 #650 原语义恢复可见(归档是整理面退场、可恢复、且常是合并落点,旧行可能是唯一载体),并加回归锁防止这条修正顺手改掉它。`memory_forget` 的回执同时报出连带面:新增只读 `store.supersedeContext(id)`(`{ supersededBy, predecessors }`)经 service 透传,抑制一行时若它取代过 N 条更早的记忆,回执明写「它们保持隐藏(显式搜索仍可达)、不应被当成当前值」——模型不必自己猜;恢复与无链行不渲染那句话。**明确没修的部分**(写进 `docs/FORGET.md` §5,别读成闭环):没有取代链的库(dream/sleep 未运行或 `conflictLedgerMode` 关着)里 `memory_forget` 依旧行粒度,§4 合成轨迹的「旧值幸存」断言依旧成立——写侧自动识别「同主题改值」需要 LLM 判断进热路径,仍按 R2/R3 等排期。回归测试 7 条(遗忘继任者旧行保持抑制且不入注入面 / 显式搜索仍可达 / 恢复继任者后仍抑制 / 归档继任者按 #650 恢复 / 回执报连带面且恢复时不报 / `supersedeContext` 空行返回 null 与计数只认指向本行的行 / **旧装配缺 `supersedeContext` 时回执降级、遗忘本身照常完成**)。最后一条补齐了审计发现的一处健壮性缺口:工具层原本裸调 `service.supersedeContext`,旧装配或手写测试替身没有该方法时会抛 `TypeError` 把整条遗忘操作打掉——回执增强不该有否决权,现按「无链信息」降级(与 `service.js` 的 store 层守卫对称)。变异自证 5 例(把 `forgotten = 0` 条件加回去 → 1 红;去掉 `archived = 0` 守卫 → 1 红;回执 `predecessors` 恒 0 → 2 红;恢复时也渲染连带面 → 1 红;删掉工具层 `typeof` 守卫 → 1 红),恢复后全绿。**评审补丁(PR #681,两条 Minor)**:回执只承诺「现在真的成立」的事——`supersedeContext` 增 `chainActive`(与 `supersededIds` 同判据:继任者被归档 ⇒ 旧行已恢复可见,不再声称被压住)与 `activePredecessors`(仍活跃的前序条数);渲染句改成「不计为当前值」,可查承诺只给活跃的那部分(`the N that remain active`),全退场时不作可查承诺。变异自证 3 例(归档后仍称链生效 / 可查计数不筛活跃 / 渲染不看 `chainActive`)逐条变红。
67
- **设置页加搜索:一张框扫全部组,两层折叠里的行也够得到(#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` / 文案回退 → 各自变红),恢复后全绿。
78
- **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 → 红),恢复后全绿。

‎dsh-mneme/lib/api.js‎

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3458,7 +3458,22 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
34583458
});
34593459
return;
34603460
}
3461-
repoRoot = repo.root_path;
3461+
// 本机可用的根(#581):身份行上的 root_path 可能是别的机器最近一次
3462+
// 登记的位置,直接拿去跑 T0 会 no-such-dir。
3463+
// 旧装配没有 localRootForRepo(#581 之前):退回身份行的 root_path,
3464+
// 与 choro-command 的 typeof 守卫同形,不让装配差异变成 500。
3465+
const localRoot = typeof choro.localRootForRepo === "function"
3466+
? choro.localRootForRepo(repo)
3467+
: repo.root_path;
3468+
// 空串 = 本机不可达(queries.localRootForRepo 的契约:本机没登记位置、
3469+
// 回退目录又核验不过身份时返回空串)。**绝不能**把它交给 T0——
3470+
// realpathSync(resolve("")) 会落到宿主进程的 cwd,把那里的模块与页写进
3471+
// 这条 repo 行,正是本 PR 想挡的「同路径不同仓库」事故(PR #679 评审)。
3472+
if (!localRoot) {
3473+
sendJson(res, 409, { error: "repo-not-reachable-here", repo: repoRef ?? null });
3474+
return;
3475+
}
3476+
repoRoot = localRoot;
34623477
}
34633478

34643479
try {
@@ -3534,6 +3549,8 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
35343549
}
35353550
const started = choro.startT1Job({
35363551
repo,
3552+
// 本机根(#581):身份行的 root_path 可能是别的机器登记的位置。
3553+
rootPath: typeof choro.localRootForRepo === "function" ? choro.localRootForRepo(repo) : null,
35373554
module: body && typeof body.module === "string" && body.module.trim() !== "" ? body.module.trim() : null,
35383555
retryFailed: body && typeof body === "object" ? body.retryFailed === true : false
35393556
});

‎dsh-mneme/lib/choro-command.js‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,12 @@ function dateOnly(iso) {
3333
* 几十毫秒起步(P29)。这里是用户主动敲的,付得起一次 rev-parse。
3434
* 三种结局分开报:一致 / 不一致 / 读不到 git——不能把「读不到」说成「没过期」。
3535
*/
36-
function staleness(repo) {
36+
function staleness(repo, localRoot) {
3737
const baseline = String(repo.git_baseline ?? "").trim();
38-
const head = gitHead(repo.root_path);
38+
// 本机根(#581):repo 由 repoByCwd 解析(身份行),root_path 可能是别的机器
39+
// 最近一次登记的位置;调用方经 queries.localRootForRepo 解析本机路径。旧装配
40+
// 没有这个函数时退回行的 root_path(单机语义不变)。
41+
const head = gitHead(localRoot ?? repo.root_path);
3942
if (!head) return { state: "no-git", baseline, head: null };
4043
if (baseline && baseline === head) return { state: "fresh", baseline, head };
4144
return { state: "stale", baseline, head };
@@ -81,7 +84,7 @@ export function createChoroHandler({ choro, config, language = () => "zh" } = {}
8184
const listed = block ? block.split("\n").filter((line) => line.startsWith("- ")).length : 0;
8285
const rest = Math.max(0, outline.modules.length - listed);
8386
if (rest > 0) lines.push(S.truncated(rest));
84-
const head = staleness(repo);
87+
const head = staleness(repo, typeof choro.localRootForRepo === "function" ? choro.localRootForRepo(repo) : null);
8588
if (head.state === "fresh") lines.push(S.fresh(shortSha(head.head)));
8689
else if (head.state === "stale") lines.push(S.stale(shortSha(head.baseline), shortSha(head.head), cli));
8790
else lines.push(S.noGit);

0 commit comments

Comments
 (0)