[2+]):只许 node:*/electron/core/infra/msg/core/identity/library/core/infra/assets + core 的类型;块语义、查询、渲染一律不许。IPC 按 sender.id 路由,渲染层不告诉主进程「我是哪个库」
App 门面。视图配置的读写接缝 ViewOwnerStore 也在这里(wiring/owners.ts)
cmd: 小卡 / 宿主现算的派生卡 / utility: 工具面),没有「页面列表组件」这类实体化容器。一块可以同时有窗口卡与快捷卡(两条独立露面);卡片外壳只有一个产地(ui/dock/dock.ts)
data-block-id / data-depth / .marker / .left / .tx
bindings.ts 一张表供五处共用;when.ts 求值上下文键localStorage 只出现在一个适配器里(arch [20])parent + prev(前兄弟 id)表达,不另造 insert 事件——「它现在在哪」只有一种说法。不用整数下标:下标只对「那一刻的兄弟列表」有意义,同一个下标在短列表上会静默落到别处,而 op 是不可逆历史。格式与原子的一次改动就是一条 upsert{content}:内容整组替换,不是逐段记差。存在是一个格、三个值:软删是可恢复的 deleted,撤销一次插入是终态 purged——曾经它们共用一个 delete,于是撤销后重开,块会从回收站冒出来。一格只有一个地址:地址与露面走 prop 的整袋值,不另立 alias/list 两种「按项增量」——同一个格两条账会让重放顺序决定结果、幂等性也破。只有「绝对的、按格寻址的 set」才能满足应用两次等于一次,而那是撤销与同步的共同前提。Block(正文 run 序列/annos/时刻/落库编码的 parent+left/软删;_display/_kind/_date/_query/_type 升列)+ BlockProperty(一格一行,有序列表拆行+pos)+ BlockAlias(地址,主键是名字)+ BlockList(露面)+ BlockFTS/BlockFTSMap(全文派生:contentless 两表 + 稳定 rowid 映射,状态在 meta)+ meta/settings/op_log(变更流,与内容行同一个事务追加;整份替换=新 genesis:清旧日志、序号归零,再把这一批 op 写进去)。schema 版本=PRAGMA user_version(唯一判据,当前 10)storage/db-rows.ts);主进程只做通用 SQL(表名/列名白名单,不认识块)。一次编辑只写动过的那几块 ⇒ 写成本不随库体量增长{ backend, envelope, data }。浏览器没有用户可选目录的同等语义 ⇒ 单窗口单库qua.db 的 assets 表(hash / mime / size / w / h / added_at),字节在 assets/<hash前2>/<hash>.<ext>,没有侧车;渲染层拿到的是地址 qua-asset://<hash>(壳的协议处理器直出文件),没有对象 URL 生命周期。web 仍走 IndexedDB hash → { mime, size, w?, h?, createdAt, bytes }。内容寻址 ⇒ 同字节只存一份;后缀只写不读(类型只从行里来)WORKSPACE_VERSION + 1 = 旧库显式作废重 seed。
接库之后库内换形状走 user_version + 只加不删迁移 + 迁移前快照(实测:版本号随事务原子回滚)。
换键/换库名 = 用户数据静默消失,所以它们被逐字钉死在门禁里。
applyOps(a, diff(a,b)) 与 b 逐字节相等;② diff(x,x) == [];③ 发射序=目标森林先序(父 op 先于子 op);④ 同一次 diff 跑两次字节相同(at 从目标森林派生,不取墙钟)。scopedOps 的等式:applyOps(now, scopedOps(now, side)) 与 side 的 touched 子集逐字节相等;条目里只有 id/格/落点,没有整片森林。scopedOps(now, 条目前态) → applyOps(…, lookup);首键与 ⌘Z 都不再碰整片森林。仍是状态,不是逆 op;合并窗口内只更新上一条的 after(不新建条目、不取整库快照)store.apply(ops):按 op 增量修补,不整库作废;订阅者只被通知一次。两张含软删的表(all/parentOfAll)专供撤销读面——可见表看不见被软删的块,而恢复路径要找它们applyOps 必须原地写格:索引存的是块的活引用。若替换块对象(CoW/JSON.parse),索引会静默失效——它手里那批对象当场过期,而没有任何一层会报错。
⇒ 这也是「撤销不再需要 forestReplaced 旗标」的原因:旗标存在的唯一理由是旧机制的实现细节。
diff(整片森林, …),省掉的只有序列化,最大那一笔(摊平两份森林)一点没少。⇒ 条目带两侧,撤销/重做各自只对 touched 块生成 op;恢复父先于子、清除子先于父。
fieldsOf(记录 id) 同时供属性区与行内实例字段卡,值只写记录块。query() 服务所有表面:纯函数路径与索引路径由等式测试钉住「结果相同」;上下文($self/scope/exclude)由调用方给。ready 时走 SQLite FTS(worker 建索引),否则扫描;web 恒扫描并在标题标明降级。canonicalSpec 就多一处会漏的分支,而漏掉的表现是「条件看着没变、结果对不上」。
role 与方向原子的分工写死:{up}/{down}/{near} 问位置,role 问身份——「某一天下面」={up:{all:[{role:'journal'},{prop:{id:'_date',eq:…}}]}},不是又一个专用键。
neq 同一条口径——否则它会变成「绝大多数块」。
gt/lt 只在同一量纲上比;比不了返回空 ⇒ 不匹配(按字符串比会让 true > 5 成立)。
empty 与 exists 分开:文本字段「有这一栏、还没填」与「没有这一栏」是两个真问题。
布尔属性没有未填态(声明了就按 false 读)⇒ 对它 empty 与 exists:false 同义,构建器不再给这个选项。
九个算子必须逐支进 canonicalSpec,漏一支=条件静默丢失。
path 行是方向预设:它展开成 {up:…}/{down:…}/{near:…},落盘的只有一种形状 —— 界面留着「上级/下级/任一处」三个词,模型里不多一个原子。
specOfTree(treeOfSpec(s)) 与 canonicalSpec(s) 逐字节相等(有单测);两边各写一份转换,就一定会在某个原子上分叉。
拆不成行的嵌套(not 里套 any)整块走 JSON,不拆——拆了再拼回来就不是它自己。一次「应用」=一笔事务=一轮撤销;JSON 解析失败保留原文,绝不静默清空。
| 表面 | selfId(解析 $self) | excludeIds(结果剔除) | today(相对日期基准) |
|---|---|---|---|
| center 查询块 | parentOf(块) | [查询块自己] | 系统今天 · 可 todayFrom:'host' |
| mount local | 宿主块 | [宿主] | 日记宿主取那一天 |
| embed | parentOf(露面块) | [露面块, 源块] | 系统今天 · 可 todayFrom:'host' |
| dock 窗口 | parentOf(窗口块) | [窗口块] | 系统今天 |
selfId 只负责解析 $self,不再顺带排除——「想解析它、又不得不把它从结果里去掉」是把两件事塞进同一个字段的后果。
挂载宿主与查询块自己一律不进结果:那是位置的性质,不是条件的性质。相对条件解析出空值 ⇒ 永不命中,不退回全库。
scope 已退场:子树锚点与「哪一天」改由 {up}/{down}/{near}/{today} 表达,条件住在内容里;上下文只剩三格。
ViewHost(center)、每个 mount tab、EmbedBody、dock 卡——每个表面实例一份specKey 变(条件被编辑/撤销);viewKey 变(换视图);contextKey 变(换宿主/表面/日期);用户点刷新modified、不进撤销。_queryResult 已删且不得复活_query 在 ⇒ query_embed 在 ⇒ 目标的源(深度 1;目标又是露面就停)| 源 | 记录 | 顺序 |
|---|---|---|
| query | 每条命中一行(大纲才折叠「祖先也在结果里」) | 冻结结果 |
| children | 直接子块(跳过软删) | children |
_query/_embed 互斥:一个块不能同时是查询与露面指针。sourceConflicts 是唯一判据,写入与落盘校验共用——各判一次,「什么算冲突」就会有两个答案。| 源 | 能落盘的 kind | 默认 |
|---|---|---|
| query | table · cards · calendar | 大纲 |
| children | ↑ + list-table · mindmap · tabs | 大纲 |
list-table(结构映射表)与 mindmap/tabs 只接 children——只有 children 是树,命中集合没有「第 k 个孩子」可对齐。
canonicalViews 按这张表丢不兼容项(arch [34] 钉住「不许第二张表」)。
| 谁 | 配置存哪 | 能被引用 |
|---|---|---|
| block | _query · _views · _activeView | 能(内容对象) |
| local tab | 块 _mounts / 日记 Prefs.journalMounts | 不能 |
| derived | 没有配置(宿主现算) | — |
| binding | { block, view } 指针 | 指向别人 |
ViewOwnerStore 读写视图配置(arch [33]):直接摸 _views/_mounts/Prefs 就是在造第二份真相。面板 local 不提升、不转本地;共享/复用一个查询块走 embed,不建指针。_activeView)/派生面/工具面(搜索、设置;派生与工具按 kind 去重)。查询块加抬头:条数/上下文 chip/筛选 chip/刷新+ 直接建 local_embed = {block, view};露面块自己没有 _views,想换看法就在源块上建一张命名视图。深度 1 构造截断,悬空只剩一句实话activeView/大纲/children 列表)。卡片本身是设备状态,不是内容——见第七节$self 的定义。
cmd: 与 utility: 不是块,同一面可两槽同现。
| id 形态 | 是什么 | body |
|---|---|---|
| 32-hex 块 id | 窗口卡(普通块的一次露面) | 那个块的真实编辑器(共享 store:槽里改、正文同步) |
| shortcut:<块 id> | 快捷小卡 | 指向同一个块;与窗口卡是两条独立露面,常驻 |
| inspect · belongs backrefs · trash calendar | 派生卡 | 宿主现算,没有配置;关掉只是摘掉这一次露面 |
| cmd:<命令名> | 小卡(44px 动作格) | 点击执行命令。不是卡片:没有卡头、没有折叠/单卡 |
| utility:<face> | 工具面卡 | 搜索等系统面住进槽;与中心 tab 是同一个面的两种挂载 |
cards(位置)。
快捷小卡与工具面卡是槽的家具:不属于「打开的东西」,重启清理不碰。小卡硬塞进卡壳,会长出「没有折叠按钮的卡」那种半成品,44px 也放不下卡头。
| 轴 | 存哪 | 判据与边界 |
|---|---|---|
| 位置 | cards 顺序 | 拖拽改序、跨槽搬;数组位只表示顺序,条目有稳定 id |
| 收起 | collapsedCards[id] | 只隐藏 body,不销毁编辑器;按卡片实例 id,跨槽移动后状态跟着卡走 |
| 单卡 | solo[side] | 只看这一张,由槽层用 data-solo 过滤其它卡;目标不可见时不生效(状态保留,回来再生效) |
contenteditable 会丢焦点与光标(每敲一个字跳一次)。
ui/dock/dock.ts):头/收起/单卡/关闭/拖拽。窗口、快捷、派生、工具面共用一套,否则「所有卡片都支持 X」一定会漏掉某一张(真踩过:手写的头没有折叠按钮)。hidden(没有内容)≠ data-collapsed(用户收起):前者是可用性,归卡片内容的主人;后者是布局。同一个值表达两件事,就再也分不开「没有主体」和「收起了」。data-collapsed,body 隐藏、编辑器还在);检视是「单卡」(槽层 data-solo,其它卡让位但状态不变)。
收起的卡与单卡的目标都按 id 记在设备状态里,所以拖到另一槽、刷新、重开都还在。
page 露面的块;页名=主别名,正文是描述_date 的块;日期是只读投影,不进正文,全局一天一个tag 露面的块;归属在 props._tags,只有块级一处入口写它,渲染成行右端标签槽 .blk-tags 里的 chip(不占正文)。正文里敲的 #名 是提及(ref run),不写归属props._tags 非空的块就是那个标签的一条记录(归属即实例,不看身份与正文)。行内 #名 的 ref run 指向它,但那只是提及;值住它自己的 props(同一个属性袋),字段来自标签声明;⌥ 字段卡与属性区共用同一行渲染器,值只写记录块_query 的块:条件是内容(入 KB、可引用、进回收站),结果只是表面实例的冻结快照(第五节)_views/_activeView),滚动/选中/冻结结果外挂、不入 KB@ 建页)与身份(tag / schema / journal)创建时物化在森林顶层;记录 / 笔记落当天。标记为页 原地;提取为页 才把块连子树搬到顶层,并在原位置留一枚引用。用户世界仍没有「根」:无根视图、无「提取为无名根」canWriteText 判据喂给所有写路径)。core/ 里维护,只查被操作的那一块自己,不扫子树——代价放到低频入口,让高频出口零判断。
_query/_embed 决定源),
配置只回答「怎么看」(拥有者的 _views),表面只回答「在哪看」(center/mount/embed/dock)。
各自只有一份真相,所以「改一处」不会悄悄改掉另一处。