dsh-spirit 0.2.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/CHANGELOG.en.md +20 -0
  2. package/CHANGELOG.md +326 -0
  3. package/README.en.md +9 -0
  4. package/README.md +5 -0
  5. package/dist/client.js +3905 -109
  6. package/dist/config.d.ts +1 -1
  7. package/dist/config.js +92 -0
  8. package/dist/contract.d.ts +739 -24
  9. package/dist/contract.js +103 -3
  10. package/dist/db/migrate.d.ts +1 -1
  11. package/dist/db/migrate.js +63 -1
  12. package/dist/db/schema.d.ts +20 -3
  13. package/dist/db/schema.js +233 -4
  14. package/dist/distill/llm.d.ts +67 -0
  15. package/dist/distill/llm.js +117 -0
  16. package/dist/distill/prompts.d.ts +60 -0
  17. package/dist/distill/prompts.js +180 -0
  18. package/dist/distill/ruminate.d.ts +88 -0
  19. package/dist/distill/ruminate.js +351 -0
  20. package/dist/distill/runtime-route.d.ts +24 -0
  21. package/dist/distill/runtime-route.js +55 -0
  22. package/dist/dream/dream.d.ts +70 -0
  23. package/dist/dream/dream.js +156 -0
  24. package/dist/drsc/client.d.ts +18 -2
  25. package/dist/drsc/client.js +20 -4
  26. package/dist/drsc/probe.d.ts +7 -0
  27. package/dist/drsc/probe.js +9 -0
  28. package/dist/embed/probe.d.ts +48 -0
  29. package/dist/embed/probe.js +91 -0
  30. package/dist/embed/remote.d.ts +58 -0
  31. package/dist/embed/remote.js +149 -0
  32. package/dist/experience/cues.d.ts +3 -0
  33. package/dist/experience/cues.js +5 -4
  34. package/dist/experience/events.d.ts +5 -0
  35. package/dist/experience/events.js +6 -1
  36. package/dist/experience/render.js +9 -1
  37. package/dist/hooks/ontology-observe.d.ts +33 -0
  38. package/dist/hooks/ontology-observe.js +110 -0
  39. package/dist/hooks/persona-section.d.ts +6 -0
  40. package/dist/hooks/persona-section.js +11 -8
  41. package/dist/hooks/txn-observe.d.ts +25 -0
  42. package/dist/hooks/txn-observe.js +65 -0
  43. package/dist/index.js +261 -3
  44. package/dist/ontology/anchor.d.ts +31 -0
  45. package/dist/ontology/anchor.js +29 -0
  46. package/dist/ontology/backfill.d.ts +67 -0
  47. package/dist/ontology/backfill.js +255 -0
  48. package/dist/ontology/extractor.d.ts +94 -0
  49. package/dist/ontology/extractor.js +292 -0
  50. package/dist/ontology/prompts.d.ts +53 -0
  51. package/dist/ontology/prompts.js +159 -0
  52. package/dist/ontology/scrub.d.ts +23 -0
  53. package/dist/ontology/scrub.js +40 -0
  54. package/dist/ontology/watcher.d.ts +53 -0
  55. package/dist/ontology/watcher.js +173 -0
  56. package/dist/ontology/workspace.d.ts +17 -0
  57. package/dist/ontology/workspace.js +39 -0
  58. package/dist/persona/markdown.d.ts +27 -0
  59. package/dist/persona/markdown.js +175 -0
  60. package/dist/persona/render.d.ts +12 -0
  61. package/dist/persona/render.js +25 -0
  62. package/dist/persona/store.d.ts +50 -7
  63. package/dist/persona/store.js +206 -7
  64. package/dist/persona/types.d.ts +3 -0
  65. package/dist/persona/types.js +15 -1
  66. package/dist/prime/client.d.ts +75 -0
  67. package/dist/prime/client.js +156 -0
  68. package/dist/prime/sync.d.ts +74 -0
  69. package/dist/prime/sync.js +116 -0
  70. package/dist/rpc.d.ts +78 -1
  71. package/dist/rpc.js +602 -30
  72. package/dist/sea/scene.d.ts +129 -0
  73. package/dist/sea/scene.js +286 -0
  74. package/dist/slot/render.d.ts +22 -5
  75. package/dist/slot/render.js +39 -4
  76. package/dist/spirit.d.ts +13 -1
  77. package/dist/spirit.js +17 -1
  78. package/dist/stats.d.ts +1 -0
  79. package/dist/stats.js +3 -0
  80. package/dist/store/edges.d.ts +63 -0
  81. package/dist/store/edges.js +146 -0
  82. package/dist/store/experience.d.ts +109 -1
  83. package/dist/store/experience.js +423 -19
  84. package/dist/store/insights.d.ts +53 -0
  85. package/dist/store/insights.js +131 -0
  86. package/dist/store/ontology.d.ts +163 -0
  87. package/dist/store/ontology.js +490 -0
  88. package/dist/store/owner.d.ts +67 -0
  89. package/dist/store/owner.js +179 -0
  90. package/dist/store/topics.d.ts +55 -0
  91. package/dist/store/topics.js +133 -0
  92. package/dist/store/transaction.d.ts +151 -0
  93. package/dist/store/transaction.js +388 -0
  94. package/dist/tools/selfname.d.ts +10 -0
  95. package/dist/tools/selfname.js +84 -0
  96. package/dist/transaction/collector.d.ts +78 -0
  97. package/dist/transaction/collector.js +229 -0
  98. package/dist/transaction/gate.d.ts +27 -0
  99. package/dist/transaction/gate.js +45 -0
  100. package/dist/transaction/prompts.d.ts +50 -0
  101. package/dist/transaction/prompts.js +149 -0
  102. package/dist/transaction/watcher.d.ts +73 -0
  103. package/dist/transaction/watcher.js +222 -0
  104. package/dist/types.d.ts +59 -1
  105. package/dist/types.js +42 -1
  106. package/dist/words.d.ts +36 -1
  107. package/dist/words.js +81 -1
  108. package/dsh.plugin.json +4 -4
  109. package/locale/de.json +6 -0
  110. package/locale/en.json +6 -0
  111. package/locale/es.json +6 -0
  112. package/locale/fr.json +6 -0
  113. package/locale/it.json +6 -0
  114. package/locale/ja.json +6 -0
  115. package/locale/ko.json +6 -0
  116. package/locale/ru.json +6 -0
  117. package/locale/zh.json +6 -0
  118. package/package.json +129 -126
package/CHANGELOG.en.md CHANGED
@@ -2,6 +2,26 @@
2
2
 
3
3
  All notable changes to this project are documented here. Versioning is semantic.
4
4
 
5
+ ## Unreleased
6
+
7
+ ### Fixed
8
+
9
+ - **History recall gained a scan window (`LOCAL_SCAN_LIMIT` = 5000 rows)**: `LIKE '%…%'` cannot use
10
+ an index and `LIMIT` truncates the output, not the scan — because the store is append-only and
11
+ never deletes rows, the cost of one lookup grew with total row count. Worse, this lookup runs
12
+ **synchronously** on `agent/pre-step`: `recall.timeoutMs` only covers the async DRSC call and does
13
+ **not** protect local SQLite. It now takes the most recent N rows as a candidate pool and filters
14
+ within it — bounded cost, and byte-for-byte equivalent when the table is smaller than the window
15
+ (regression tests pin this). Cross-session tone anchoring uses the same window.
16
+ - **Degraded-mode wording completed**: the in-memory mirror is memory-only (capped at 200 rows, no
17
+ path back into the DB) — entries recorded while degraded are **not recoverable after a restart**.
18
+ Earlier text only said "history and cross-session stop", which reads like "you merely lose history".
19
+ - **Panel now shows the DRSC projected segment count**: `ok` + **0 segments** means "connected, but
20
+ the projection DB has no content yet". Previously the panel said only "available", which made a
21
+ silent-empty state look healthy. It is deliberately not raised to `warn` (that would produce a
22
+ screenful of false alarms); the count is simply shown, and when the probe has no value nothing is
23
+ shown (**unknown is not zero**).
24
+
5
25
  ## 0.1.0
6
26
 
7
27
  First usable release: **a first-person experience entry store plus dual-lane instant recall**.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,332 @@
2
2
 
3
3
  本项目的所有值得记录的变更都写在这里。版本号遵循语义化版本。
4
4
 
5
+ ## Unreleased
6
+
7
+ ### 修正
8
+
9
+ - **检索有扫描窗(`LOCAL_SCAN_LIMIT` = 5000 行)**:`LIKE '%…%'` 用不上索引、`LIMIT` 只截输出
10
+ 不截扫描,而本库 append-only 且只归档不删行 ⇒ 单次检索的成本原本与库总行数成正比。更关键的是
11
+ 这条检索**同步**跑在 `agent/pre-step` 上,`recall.timeoutMs` 只包 DRSC 那次异步检索、**管不到
12
+ 本地 SQLite**。现改为「先取最近 N 条做候选池,再在其上过滤」:代价有界,行数小于窗时与全表
13
+ 逐行等价(有回归用例钉住)。跨会话基调的会话定位同窗。
14
+ - **降级表述补全**:内存镜像只在内存(上限 200 条、无回灌库路径)——降级期间记下的条目在重启后
15
+ **不可恢复**。此前对外只说“停历史与跨会话”,读起来像“只是少了历史”。
16
+ - **面板显示 DRSC 已投影段数**:`ok` + **0 段** = 「连上了但库里还没有内容」,此前只显示“可用”,
17
+ 把静默为空读成了功能正常。不升 `warn`(那会造一屏假故障),只把 0 显示出来;未探到 ⇒ 不显示
18
+ (**未知不当 0**)。
19
+
20
+ ## 0.6.1
21
+
22
+ - **本体面可搜**(用户点单:本体类为什么不能搜索):「翻阅 · 本体」的实体/任务线子页新增搜索框(Enter 提交)——实体按名字/别名 LIKE、任务线按标题 LIKE;空词回全量,切子页自动清。反馈面是追加型真源,无搜索词表不提供。
23
+ - 宿主:`entity-graph`/`task-list` 接受 `q`(LIKE 字面量转义,%/_ 不当通配符;ASCII 大小写不敏感);顺手接上契约里声明了但一直没接线的 `kind` 过滤。
24
+ - 接 0.6.0:本体交付点入星海(青绿星,只读);接 0.5.9:头部刷新接通翻阅面。
25
+
26
+ ## 0.6.0
27
+
28
+ - **本体交付点入星海**(用户点单:本周/本体的内容不渲染到星海是个问题):`sea-graph` 现在把本体轨交付(`dlv-` 行,上限 500)作为 `kind:'delivery'` 点合入星图——同图异色(青绿)、同尺度老化、同会话时间邻近自动连线。翻阅面(本周/本体)有的记录,星图上也能看见。
29
+ - 纪律:交付点只读——★反馈仍只写情绪轨(详情卡对 delivery 点隐藏 ★);写侧 lane 词表不动,`onto` 只在读侧投影;步骤遥测行(tier3)不入图;backfill 行照画(排除只针对注入不针对展示)。
30
+ - 接 0.5.9:头部「刷新/⟲」接通翻阅面(按当前视图重取条目/本周/本体)。
31
+
32
+ ## 0.5.9
33
+
34
+ - **头部「刷新/⟲」接通翻阅面**(用户实报:重建期间这两个按钮对翻阅/本体面没用):此前它们只重拉星图(sea-graph)/重置图视图。现新增 refreshToken:「刷新」= 重拉星图 + 按当前视图重取(条目流/本周/本体三面);「⟲」= 重置图视图 + 同样重取。重建跑着时不离开翻阅面也能拉新。
35
+
36
+ ## 0.5.8
37
+
38
+ 空 workspaceId 的**修复链**(用户点单:fallback 是全局,但理论上得先修复到对应范围):
39
+
40
+ - 新增 `resolveWorkspaceId`(ontology/workspace.ts):候选值(在线 header / 回填 DRSC cwd)非空⇒直用;空⇒反查同会话既有记录(txn_entry→experience,取最近非空非全局的 workspace_id)修到对应范围;仍无从可考⇒落 `ws:global` 全局桶。
41
+ - 全局桶是**兜底不是首选**:数据照落不丢(写侧闸仍拒空串,纪律不变);翻阅面全局视图(空 workspaceId 查询)含它,注入读面按工作区过滤——归属范围不确定的历史不漏进无关工作区上下文;全局桶值自身不当反查证据二次传播。
42
+ - 接线两处:回填(sessions 无 cwd 时)+ 在线反馈捕获旁路(事件头缺工作区时)。
43
+
44
+ ## 0.5.7
45
+
46
+ 全记忆重建"扫完全程却零记录"的真因修复(真机实锤:水位 132 会话 done、本体表全空):
47
+
48
+ - **workspaceId 传空串被 store 闸整批拒收**:回填把每个会话的 workspaceId 写死 `''`,而 `TxnStore.insert` 拒空 workspaceId ⇒ 每条 delivery 都被静默拒,抽取器却仍报 done。现回填透传会话 `cwd`(与在线 `workspaceIdOfAgent` 取 session header.cwd 同源)。
49
+ - **零产出不再当成功**:非空批落库 0 条 ⇒ 如实 failed(区分"回包不可解析/截断"与"全数被拒"两类文案);旧版回包被 max_tokens 截断后解析 0 行也算"成功",毒水位就是这么来的。
50
+ - **输出预算随批扩**:固定 1600 token 管 8 行批必截断;改按单行 700 预算×批长,封顶 8000。
51
+ - **水位自愈**:每次重建开场把"done 却库里查无 dlv 行"的毒标记摘掉重进重建——已被旧版误标的 132 个会话不需手动清库即可补回。
52
+ - **主键冲突算已记录**:续跑重扫早先已落库的行不再被误判零产出。
53
+ - 面板无需操作:重启后再点一次「全记忆重建」即自动自愈重跑。
54
+
55
+ ## 0.5.6
56
+
57
+ 全记忆重建跑真机 130 会话 / 912 轮时在中途挂了(报 `This operation was aborted`)。三个真因一并修:
58
+
59
+ - **超时预算错乘**:本体抽取误用 `txn.collectorTimeoutMs`(30s)——一批要读十几轮正文、吐十几行 JSON,大模型上稳定撑爆。改取 `max(distill.timeoutMs, 180s)`(本体是冷路径,不影响每轮热路)。
60
+ - **abort 原文没法看**:超时自杀抛的是 DOMException(`This operation was aborted`),面板上等于没说。现换成可读的:`llm 超时被中止(180s,模型 xxx,已收 N 字)`。
61
+ - **一粒老鼠屎坏一锅**:原来一批/一个会话出错就整次重建中止。现在:
62
+ - 抽取器失败**自动对半拆批重试**(8→4→2→1),把坏轮隔离到最小批,好轮照常落库;配置类错误(无路由/忙)不拆。
63
+ - 回填单会话失败**不中断**,继续跑后面的;失败会话不标 done ⇒ 再点一次只补它们(已完成的不重做)。
64
+ - 每会话都刷水位(断点续跑),批从 16 轮缩到 8 轮(单次更快、更不容易撞超时)。
65
+ - 面板 done 阶段显示「部分会话未完成 N · 再点一次可续跑」,不再把部分失败伪装成完成。
66
+
67
+ ## 0.5.5
68
+
69
+ - **全记忆重建升成异步任务 + 进度条 + 批次进度管理**(照长觉 sleep-run/sleep-status 范式,对齐 prime-memory):不再一个哑的「正在重建…」。
70
+ - `ontology-backfill-run` 改为**立即受理**(返回 accepted),新增 `ontology-backfill-status` 轮询面(phase:scanning/extracting/done/failed + totalSessions/doneSessions/totalTurns/doneTurns)。
71
+ - 「做梦」页重建块:轮询 1.5s 一轮,画**进度条**(doneSessions/totalSessions)+ 会话/轮次计数;失败直接显真实原因。
72
+ - 后端 `BackfillRunner`:`start()` 异步受理 + `status()` 进度快照;同步占 running 防连点双跑。
73
+
74
+ ## 0.5.4
75
+
76
+ - **全记忆重建失败不再只说 degraded**:抽取器 `runInner` 的异常现在 `logger.warn` 落日志(此前只塞内存 status),`BackfillRunner` 把 `status.error` 原文上浮到 `SpiritBackfillRunResult.error`,面板直接显示真正原因(路由/超时/解析/忙)。
77
+ - **修掉误报 degraded 的真因之一**:`processBatch` 遇到直播抽取正在跑(`this.running`)时**等它结束**(≤ 60s)再上批,而不是立刻返回一个非 done 状态被判成 degraded。
78
+
79
+ ## 0.5.3
80
+
81
+ - **「全记忆重建」入口移到「做梦」页**(用户点名:它属记忆蒸馏,应与长觉同居):放在长觉块/上次长觉下方,与蒸馏同区;撤掉 0.5.2 放错的设置页入口。
82
+ - 「翻阅·本体」里的「回填历史」保留作上下文次级入口。
83
+
84
+ ## 0.5.2
85
+
86
+ - **全记忆重建真接线**(0.5.1 的「回填历史」其实没生效的根因):旧实现走异步 `enqueue`,而抽取器 `QUEUE_MAX≈24` + 5 分钟去重窗会把大批静默丢掉、又把会话误标 done ⇒ 点了也白点。现改为回填直接调 `extractor.processBatch`(绕过队列上限/去重窗/**同步 await** 真落库),逐会话按批结束才标 done;失败不标 done(可续跑,delivery id 主键幂等)。
87
+ - **设置页新增「全记忆重建」入口**(面板可见一键):扫全部历史会话重建本体层,回显已重建/扫会话/入队轮次。此前入口只在「翻阅·本体」深处,用户找不到。
88
+
89
+ ## 0.5.1
90
+
91
+ 本体层**真机可见化**(0.5.0 装了但看不出变化的修复):
92
+
93
+ - **本体层缺省开**:`ontology.enabled` 与 `ontology.backfillEnabled` 由 false 改 true(脱敏/来源分级/更正通道三条硬前置已就绪)。此前缺省关 ⇒ 采集/抽取零运行,面板与 0.4.0 毫无差别。
94
+ - **面板真开关**:新增 `live.ontologyEnabled`(volatile,缺省开),设置页有「本体层」勾选框——有效 = 静态总闸 ∧ 本键,不再是后台藏着的阻塞默认。
95
+ - **历史回填按钮**:「翻阅 · 本体」面新增「回填历史」,一键跑 `ontology-backfill-run(dryRun:false)` 把既往会话扫进本体层,回显扫了多少会话/入队多少轮。
96
+ - 面板「本体」面(任务线 / 实体 / 反馈 + 点开看做成)此前已在 0.5.0,但缺省关时是空的,现随总闸开启即长数据。
97
+
98
+ ## 0.5.0
99
+
100
+ 本体层记忆:把 0.4.0 的"事务遥测"升级为"语义本体"——采集对象从"哪个工具报错/哪个 basename"
101
+ 换成"从做了什么、聊了什么里抽出交付·实体·关系·任务线",并用**按来源分级信任**取代旧的
102
+ "绝不读正文"(用户原文/助手动作可读进脱敏层,工具返回外部正文仍禁入)。**缺省关**(`ontology.enabled=false`):关时零采集零落库零注入。
103
+
104
+ ### 新增
105
+
106
+ - **四级 salience 分层**:反馈(tier1) > 轮次总结(tier2) > 步骤(tier3) > 被掩埋思考(tier4)。注入丢尾按此逆序;
107
+ 步骤/思考默认不进注入。
108
+ - **评价一等记录 + 锚定**:用户"干的不错/不对"等不再只是埋在批里的意图 bit,而是落 `evaluation` 表并**锚定到具体
109
+ delivery**(显式 cue→同任务→时间邻近→仍不确定则落 unresolved 悬置池,绝不硬绑),使"上次夸的那回"可解析。
110
+ - **实体注册表 + 关系 + 任务线程**:`entity`(人/项目/模块/概念/资源,五 kind,importance/首末出现/别名)、
111
+ `delivery_entity`、`entity_edge`、`task`+`task_delivery`(status 生命周期 + next_step)。
112
+ - **OntologyExtractor**:异步批(寄生 collector/ruminate 节律,严禁每轮同步 LLM)读正文语义→产出
113
+ delivery/entities/relations/task;入库前过 secret/PII 脱敏 + INJECTION_PATTERNS。
114
+ - **注入三段位**:卡新增 `反馈:` / `线程:` 段 + 保留 `事务(做成):`,按 salience 逆序丢尾,指纹只吃稳定 gist。
115
+ - **查询面**:`evaluation-list` / `entity-graph` / `entity-lookup` / `task-list` / `task-detail`;
116
+ `ontology-backfill-run`(历史回填,缺省 dryRun,产物打 TRUST_BACKFILL 不进注入)。
117
+ - **历史回填**:经 DRSC API 扫既有会话(不直读其 db),确定性 id 幂等,backfillEnabled 门控 + secret 脱敏。
118
+
119
+ ### 变更
120
+
121
+ - **schema v7→v8**:txn_entry 升格 delivery(+superseded_by/salience_tier/turn 区间)+ 六张本体表。
122
+ - **旧的"绝不读正文"红线细化**:按来源分级(用户/助手可读进脱敏语义层,工具返回正文仍禁)。
123
+
124
+ ## 0.4.0
125
+
126
+ 语义工作记忆:在此前的"情绪日记"(只记结构信号、不读正文)之外,**并行新增一条事务轨**,
127
+ 让角色记住"做过什么具体事"——用户态度信号、会话级事务摘要、时间线(上周做了什么)、资源图谱
128
+ (这件事牵涉哪些文件/人/工具)。**双轨物理隔离**:情绪轨(`TurnWatcher → deriveMood → 注入`)
129
+ 一字不改,`deriveMood` / 注入指纹 / 防注入三条红线全部不动;事务条目走独立通道、独立表、
130
+ 独立注入段位。**缺省关**(`txn.enabled=false`):关时零采集、零落库、零注入、零副作用。
131
+
132
+ ### 新增
133
+
134
+ - **存储 schema v6 → v7**:新增两张工作记忆真源表 `txn_entry`(四级形态:`card_line`≤60 字进卡 /
135
+ `summary`~500 字存库衍生物 / `gist_key` / `semantic_json`)与 `txn_cues`(资源键,只存 basename)。
136
+ 加法迁移,`IF NOT EXISTS` 幂等;老库重开前向迁移,已有数据不回填(缺列即 null)。
137
+ - **事务采集链**:`TransactionWatcher`(与 TurnWatcher 并列 observe 同一事件流,只取 todo 标题 /
138
+ 工具 basename / 意图 bit,**绝不吃工具返回正文**)+ `TxnCollector`(turn/end 后异步攒批、
139
+ fire-and-forget 调 LLM 出摘要,复用长觉的退避三件套,**严禁每轮同步 LLM**)。
140
+ - **注入卡事务段**:卡新增 `事务:<card_line>` 段(紧跟状态段)。**只有 `card_line` 进卡与进指纹**,
141
+ `summary` 属 LLM 衍生物,与感受句同守 G15——禁入 `deriveMood`、禁入注入、禁入指纹(否则每轮
142
+ 唯一 ⇒ churn 100%)。关轨时该段整体省略,输出与旧四段形状逐字节相同。
143
+ - **长觉原料混喂**:`card_line` 作为标注上下文喂给归纳 prompt(帮模型理解"最近在推什么事"),
144
+ 但事务 id **不进 `batchIds`**——洞察/主题/因果边的证据永远只接地在体验条目上,防派生域被污染。
145
+ - **查询面两个只读 RPC op**:`timeline-query`(按时间范围/近 N 天查事务,支持 workspace 过滤)
146
+ 与 `resource-lookup`(按 cue basename 等值反查关联事务)。面板「翻阅」tab 新增**「本周」视图**
147
+ 调 `timeline-query{days:7}` 渲染事务清单。
148
+ - **长觉蒸馏模型可在面板选**:「做梦」tab 的长觉块新增常驻的**当前生效路由**(`provider/model` + 来源)
149
+ 与 provider/model 下拉选择(枚举走宿主 `ctx.llm.listProviders/listModels`)。优先级 `部署面 pin >
150
+ 运行时覆盖 > 宿主默认`:部署面 `distill.provider/model` 双配即锁路(选择器禁用);否则面板选的存
151
+ `meta` 作运行时覆盖、下次长觉即用(**热生效不重启**,不动 volatile 六腿配置面)。仍是显式选择,不破
152
+ “绝不隐式改选模型”。新 RPC:`distill-models`/`distill-model-list`/`distill-model-set`。
153
+ - **安全实闸**:`source_trust` 三档标记(`user_explicit|derived_summary|structure_signal`)、
154
+ `isSemanticAllowed` 采集边界闸(与 `isStructuredOnly` 并联,任一失败整包拒)、
155
+ `INJECTION_PATTERNS` 落库前黑名单("ignore previous"/"system:"/"<|"/"覆盖以上"…),
156
+ 以及 gates 静态闸确保 `txn_entry` 不出现在情绪派生输入链的任何文件中。
157
+
158
+ ### 修正
159
+
160
+ - **补两张表的关键索引**(perf 规模闸实测抓出):`txn_cues(txn_id)` —— 每个读方法逐行补 cue 的
161
+ `cuesFor` 此前是 N+1 全表扫(`timeline-query` 返 200 行 ⇒ 4.8s);`txn_entry(session_id, ts_ms)` ——
162
+ 注入热路径 `listRecent({sessionId})` 此前全表扫。补齐后 60k 行规模闸从 152s 降到 1.7s。
163
+
164
+ ### 变更
165
+
166
+ - **宿主支持范围改为有界区间**:`engines.dsh` 与 7 个 dsh peer 由逐线枚举改为 `>=0.2.0-rc.1 <0.3.0`(免
167
+ 以后每出一条新 rc 线都要改三处声明)。compat 闸不再拒宽 range,改校“整体落在 0.2.x”(含 0.2.0 起点、
168
+ 不溢出 0.1.x/0.3.0+);已在真宿主(0.2.1-rc.5)实装验证该区间正常装载、预发布线不被误拒。
169
+
170
+ ## 0.3.0
171
+
172
+ 记忆星海:把体验库投影成一张能转的三维星图。**只读投影,不是可查询图谱**(不开写图面、
173
+ 不改 DB schema(仍 v2)、不引入任何渲染库),入口挂在顶部两席位(`sidebar.panellist` + `main`)。
174
+
175
+ ### 新增
176
+
177
+ - **`sea-graph`(只读)**:`listRecent(limit, { includeSuperseded })` 取全库最近 ≤3000 条(带 `LIMIT`:
178
+ 本库只归档不删行,无顶就是随使用时长线性变慢),`src/sea/scene.ts` 纯函数算出点/边/统计。
179
+ 边只允许三类且各自分色分线型:共享 cue / 时间邻近 / 取代链;每点 ≤6 边、全图 ≤6000 边。
180
+ - **编码规则(一个量只编码一次)**:颜色 = trigger 族(**不随主题变**),亮度 = 老化权重,
181
+ 半径 = salience,★ = feedback;`tier`(full/gist/held)与注入侧同公式同阈值,它只门控“能不能发光”。
182
+ - **两种组织方式**(面板「组织」切换,存 localStorage):`双极`(高度 = 归属轴,她 +Y / 主人 −Y,
183
+ 两极与主轴真画出来)与 `星盘`(中心 = 她,半径 = 多淡,相位 = 时间次序螺线,差速旋转 + 相位滞后自然成旋臂)。
184
+ - **渲染层双后端可插拔**:Canvas2D 为交付下限(光晕走**预渲染 sprite** + `lighter` 叠加,禁止逐帧
185
+ `createRadialGradient`);WebGL2 为可选加速(≥1500 点自动升,或用户开「高质量辉光」),
186
+ 中文标签固定叠 2D 层,`webglcontextlost` 当场回退 2D(切换必须换新 canvas 元素)。
187
+ - **人设管理接出已有写面**:`persona-preview`(不写盘)/ `persona-set`(`expectedRevision` 乐观并发)/
188
+ `persona-history` / `persona-restore`(回退也是**追加新 revision**,历史一行不改);面板内可改
189
+ 名字/语气/在意度/在意面,保存前能看见将要注入的原文与字节预算。
190
+
191
+ ### 增补(0.3.0-local.2 / local.3,用户实机反馈后追加)
192
+
193
+ - **靠近激活闪烁(proximity 场)**:对照姊妹包 prime-memory 的图交互——鼠标拂过一片星时
194
+ 半径(90px)内的星逐个拿脉冲辉光(相位用每点 `phase`,不同步闪),而不是只有 16px
195
+ 拾取命中的那一颗有反应;纯函数 `proxBoost` 两后端共用,带 4 例单测(含“齐闪像加载
196
+ 动画”的反例门禁)。
197
+ - **手记改名「灵-鱼的手记」并升级为结构卡片**(对照 prime-memory explorer 的字段分层):
198
+ 徽章行(类型/来源路/在意度/★)→ 正文 → gist 斜体行 → **线索 chips** → 元信息行(轮次·
199
+ 时间·在意面)。线索来自 `experience_cues`,`journal-tail` 行与 `sea-graph` 点**同批下发**
200
+ (≤4 条,不给前端二次请求拼证据面);星海详情卡同样挂线索 chips。在意面徽章单源
201
+ `sea-labels.NOTICE_LABEL`(手记与人设面共用,不给主人看 slug)。
202
+
203
+ ### 增补(0.3.0-local.4,人设进库 + markdown 备份可恢复)
204
+
205
+ - **人设从纯文件迁进 SQLite(schema v3,正向迁移)**:`persona_current`(单行表,
206
+ `CHECK(singleton=1)` 形状即约束)为权威当前位,`persona_revision` 为 append-only 全量
207
+ 历史——历史不再受 256KB 尾窗限制,超窗老版也能按 revision 找回。首次打开时若库里空而
208
+ `persona.json` 存在,自动一次性迁入(原文件不动,留作事故现场);DB 不可用时退回现行
209
+ 文件路径,降级纪律与体验库一致。
210
+ - **每次成功保存自动写单层人话备份 `persona.md`**(文件本身就是恢复源,不嵌 JSON 区;
211
+ 内容零 slug,在意度/在意面/语气全用面板同串中文,词表漂移由门禁测试钉住)。
212
+ 备份写失败只告警不回滚已提交的 DB 事务——备份可滞后,权威不能跟丢。
213
+ - **新端点 `persona-export-md` / `persona-import-md`**:人设页新增「markdown 备份」区——
214
+ 查看/复制当前备份,粘贴改过的文本二次确认后恢复。恢复走 `save()` 唯一写路径 ⇒
215
+ **追加新 revision,历史一行不改**;解析失败整体拒绝并点名非法词,绝不部分恢复。
216
+ - 语气下拉与历史行改显中文(平实/简短/温和,`words.ts` 单源),不再给主人看 slug。
217
+
218
+ ### 增补(0.3.0-local.5 / local.6,主人背景档案:prime-memory 定期同步 + 双段编辑)
219
+
220
+ - **主人背景档案进库(schema v4,正向迁移)**:`owner_profile` 单行表,**双段写路径分离**——
221
+ 同步段(机器投影,整段覆盖)与自述段(主人手写,乐观并发 `expectedRevision`)各列各写,
222
+ 互不抹段;每次成功写入原子落 `owner.md`(双节人话备份)。
223
+ - **定期同步 prime-memory 的 person 实体**(只读消费,无编译期依赖):主路径同源 RPC
224
+ `dsh-memory/rpc/graph-preview` 种子榜取 person 清单,再逐 id `graph-node-get` 取全量详情
225
+ (真宿主实测定案:`graph-search` 空 query 永远返空、preview 的 full 块是轻量形状无 facts);
226
+ 渲染成“名称(别名):facts 摘要”清单(top 8、单条 ≤120 字),**不断言谁是主人**(图上无主人标记)。
227
+ 缺席/空图 ⇒ 跳过且**不清旧段**(拿不到源 ≠ 背景消失)。
228
+ - **三个触发入口共用 60s 去重窗**:日级定时器(缺省 24h,首跑 0–10min 抖动)、面板「立即同步」、
229
+ `owner-sync-ping`(事件接收预备:prime 侧后续“情景更新推送”打这里,推送只发信号不带数据)。
230
+ - **新端点四腿**:`owner-get` / `owner-set-self` / `owner-sync-now` / `owner-sync-ping`;
231
+ 人设页新增「主人档案」区(prime 三态状态行 + 同步段只读 + 自述段可编)。
232
+ - **注入稳定区新增主人段**(`[主人] 自述` 优先、`[主人的背景(同步)]` 次行):独立预算键
233
+ `owner.budgetBytes`(缺省 400B,不挤人格区);两段皆空物理离场;缓存键含同步时刻,
234
+ 后台同步的新段不会因 revision 未变而被旧缓存顶掉。
235
+ - **prime 未装完全不影响运行**(真宿主对照组实测):`owner-get` 报 `primeStatus:'absent'`、
236
+ 同步 `{updated:false, reason:'prime-absent'}`,无报错无重试风暴;解耦门禁同步演进:
237
+ 禁包引用/库直读不变,`dsh-memory/` 端点字面量收口到 `src/prime/client.ts` 单文件。
238
+
239
+ ### 增补(0.3.0-local.10,昵称序列 + 自称序列(模型经 spirit_selfname 工具自改))
240
+
241
+ - **人设卡加两条序列**:`aliases`(昵称:主人日常怎么喊这条鱼)与 `selfNames`(自称:鱼说话时用什么指代自己),
242
+ 去重保序、单条 ≤24 字、列表 ≤8;稳定区新增 `[昵称]`/`[自称]` 两行(名字后、语气前;空 ⇒ 整行物理离场,
243
+ 老卡逐字节不变);markdown 备份新增「昵称/自称」节(round-trip 无损,自由词只套上限不拒收);
244
+ 人设页两条输入行(、/逗号/分号/空白宽进)。
245
+ - **`spirit_selfname` 工具(用户点名:自称允许 LLM 自己改)**:模型可增删自称列表(用顺了新自称当场记下);
246
+ 这是人设面**唯一**对模型开放的写字段(名字/语气/在意度/价值/边界不开);护栏:走 save() 唯一写路径(revision 推进/历史留档/md 重生)、
247
+ 累积式无整表覆盖、列表有顶、部署总闸关 ⇒ 不注册。tools 服务缺席的老宿主线自动不挂(作域注入)。
248
+
249
+ ### 增补(0.3.0-local.16,语气扩到七档 + 长文本框自动长高)
250
+
251
+ - **语气档位 3→7**(用户点名:偏少):新增 俏皮/安静/直白/诗意 四档,每档有开口词与收尾词(只表态度不表事实);
252
+ 单源传导链验证:面板下拉/md 备份反查/稳定区 [语气] 行全部自动跟进;键集闸改单源比对(以后再扩列不用改闸)。
253
+ - **主人档案等同源长文本框自动长高**(用户点名:同步段钉死三行读不了):六处 textarea 统一换 AutoArea,
254
+ 随内容撑开封顶 480px 后内滚;只读同步段(拖拽手柄对只读框不可用)受益最明显。
255
+
256
+ ### 增补(0.3.0-local.12..15,长觉阶梯:主题分区 + 因果边 + LLM 蒸馏反刍 + 碰撞裁决 + 向量能力位)
257
+
258
+ - **三层记忆(schema v6,五张派生表 + entry_vector)**:工作记忆(experience,一字不动)→ 主题分区
259
+ (topic/experience_topic:cues×trigger 确定性骨架即时回填 + 长觉归题精修,改判写新行)→ 蒸馏记忆
260
+ (insight/causal_edge/sleep_run)。派生定性 action_bias 同构:可整表重算,**绝不进 recent()/deriveMood/注入**
261
+ (G15 结构闸 + 行为例:蒸完整轮后注入指纹逐字不变)。
262
+ - **长觉(RuminateRunner,缺省关)**:异步 LLM 归纳 pass——攒批(水位防重蒸)→ 调用#1 归题/洞察/因果提案
263
+ → 调用#2 碰撞去重 → 单事务落库;进度 phase/detail、软取消、退避 120s→15min(配置错误豁免)、去重窗 300s、
264
+ 连败 3 park。面板「做梦」tab 长觉块:一键跑 + 进度轮询 + 叫醒 + 上次长觉报告(含实际模型名)。
265
+ - **蒸馏模型可选(fail-closed)**:distill.{provider,model,reasoningEffort} 留空跟宿主默认(agentDefaultModel 宽容读),
266
+ 显式配了解析不到 ⇒ 拒蒸说人话,**绝不隐式改选**(G13 实闸:代码面不存在退默认分支);llm 缺席整条休眠(域注入,顶层 inject 不变)。
267
+ - **碰撞检查三层(用户点名)**:insight 同题矛盾 ⇒ conflict 双留(机器绝不自动删),翻阅 tab「线索头」视图里
268
+ 人工裁决(「信这条」/「都收起来」走 insight-resolve,只改状态位原文永在);证据条目被藏/取代 ⇒ 读侧 stale 传播(回场自愈);
269
+ 幻觉 id 校验丢弃(evidence 必须 ⊆ 本批)。
270
+ - **因果边**:启发式打底(失败→恢复「导致」)+ LLM 投影(四词单源 SPIRIT_CAUSAL_RELATIONS、只钳长度、
271
+ 显式陈述才写);星海 kind 扩 'causal'(橙实线图例在场才显),截断优先级 causal>cue>time(score 1.1 表达,既有边序零回归)。
272
+ - **向量能力位(缺省关)**:调研实锤 prime 无可借 embedding 服务——定案为「借档位(embedding-state-get 对齐
273
+ baseURL/模型/维度,key 自持)+ 缺席自启(纯 fetch OpenAI 兼容)+ BLOB+Float32Array 零新依赖」;
274
+ 两阶段检索只走冷路径;维度首建锁 meta,不一致显式报错不静默重建;G11 出站收口/G20 出境(prompt 不含用户原文)/
275
+ G24 凭据(apiKey 不回显不落日志)三道新闸落地。
276
+ - **新端点六腿**:`sleep-run/status/cancel/report` + `topics-get` + `insight-resolve`;settings 面加 distillEnabled 热更键。
277
+ - 对外语域仍是鱼/睡/梦:小盹=确定性整理,长觉=深睡想明白——没有「反刍/蒸馏管道」类机械词(R5 禁词族扩 sleep/topic/causal)。
278
+ - 桥 round-29 拓出并修复两枚同源 bug(受理路径自拦双变体):`run()` 预置 running / 预占去重窗后
279
+ 任务体再 precheck 会把自家受理拒掉——受理后专用体 `runAccepted()` 不再重检;回归钉进 distill.test。
280
+ 另补报告跨重启可读(status 懒 hydrate 自 meta,宿主重启后面板不致失忆)。
281
+
282
+ ### 增补(0.3.0-local.9,设置面可见性:睡眠开关 + 回响导航)
283
+
284
+ - **做梦开关进 volatile(六写点全套)**:`live.dreamEnabled`(缺省开)——宿主设置页自动表单与设置卡「睡眠(做梦)」块同时可见可热更;
285
+ 双闸取与(部署面总闸 ∧ live 闸),关闸后定时器空转、手动「让鱼睡一觉」拒并指路(reason:'disabled' 说出口)。
286
+ - **设置卡新增睡眠块**:自动做梦开关 + 上次梦境读数(时间/合并对数/在场数)+ 回响导航行(条目管理与手动做梦在「记忆星海」的 翻阅/做梦 tab)。
287
+
288
+ ### 增补(0.3.0-local.7 / local.8,翻阅 tab:prime 级条目管理面 + 做梦 + DRSC 缺席提示 + 设置卡瘦身)
289
+
290
+ - (local.8 重包)round-28 真浏览器拓出★继承假绿:`reviseEntry` 的 INSERT 没带 feedback_score 列,
291
+ ★只在返回对象里、库里新行是 NULL,刷新即蒸发——新增 REVISE_INSERT_SQL(17 列含 feedback_score),
292
+ 单测同步补**读回断言**(断返回对象不算数,断库里的行才算数)。
293
+
294
+ - **星海面板四 tab(星海/人设/翻阅/做梦)**:设置卡的记录检视整体迁到「翻阅」——
295
+ 搜索(扫描窗内 LIKE,截断如实报)/ 筛选(类型·来源·★·含更正史·藏起来的)/ 服务端分页
296
+ (limit=50 加载更多,hasMore 探界不做全表 COUNT)/ 就地详情 / 「这条重要」/ 导出入口。
297
+ - **藏起来 ⇄ 再想起(schema v5,正向迁移)**:`experience.hidden_at` 标记列——行永不物理删
298
+ (红线闸不变),藏后退出星海图/注入/手记缺省视图,「藏起来的」视图里可恢复。
299
+ - **更正式编辑(「理解变了」)**:插新行 + 旧行置 `superseded_by`(与更正同构,不原地改正文);
300
+ ★ 标记复制进新行,cues 拷贝,`source_ref=rev:<旧 id>`;编辑史以取代链形态在星海自然可见。
301
+ UPDATE 列白名单(superseded_by/updated_at/feedback_score/hidden_at)落成实闸,把 schema
302
+ 注释里声称却不存在的那道纸面闸补成了真闸。
303
+ - **让鱼做梦(确定性整理 pass,零模型调用)**:等值查重合并 + 归档淡出(尊重部署面 dryRun)
304
+ + 梦境报告(合并/归档/在场/幽灵/★/档位读数)落 meta;「让鱼睡一觉」手动按钮 + 日级定时器
305
+ (owner 同款骨架),三入口共用 60s 去重窗;报告不进系统提示。
306
+ - **DRSC 缺席提示(照 prime banner 口径,按 spirit 探测能力封顶两档)**:设置卡 verdict 行下
307
+ warn 态出「影响说明 + 可复制指引」(clipboard 失败退全选,绝不自动执行);skipped 中性不渲染;
308
+ 星海顶栏消息带同位短提示(判定单源在 sea-graph 响应的 drscVerdict 字段)。
309
+ - **设置卡瘦身**:只留运行读数 + 淡出表单 + 导出 + 重试,不再逐轮拉条目;UI 可达性实闸
310
+ (settings-set/journal-export/experience-feedback 必须在 client 源码有引用)防「契约在、UI 没了」。
311
+ - **拟人化文案纪律(R5)**:新机制文案统一鱼的第一人称行为语言(「藏起来」「再想起」「理解变了」
312
+ 「让鱼睡一觉」「鱼梦见了…」),新前缀键(rec/dream/drscHint)禁机械词实闸;词表目录首屏下发,
313
+ client 不手抄枚举。
314
+
315
+ ### 修正
316
+
317
+ - **图上亮度与注入侧分两把尺**(新键 `sea.agingHalfLifeMs`,缺省 7 天):拿 1.5h 的注意力窗口算跨月库
318
+ 会得到“全图都是暗星”(真浏览器实测 `fade` = 0/0/3000);`tier` 仍用小时尺度,因为它的语义就是
319
+ “还在不在注意力窗口里”。
320
+ - **亮度带基座、暗星有地板**:指数衰减动态范围极大(跨月 ÷ 7 天 ≈ 15 个半衰期),从 0 起算会让
321
+ 90% 的点在暗背景上隐形。遗忘是“沉下去”,不是“看不见”。
322
+ - **经度不再按类型分扇区**:`axisOf` 已按 trigger 给基值,经度再按 trigger 分角度就是把同一个量画两次
323
+ (同类排成纬线弧带,读图者会把高度误读成类型);改为 id 哈希铺满整圈 + 正弦弱吸引(线性插值会在
324
+ 基准角对面留出一段无点空弧)。
325
+
326
+ ### 性能
327
+
328
+ 真浏览器实测(Canvas2D,单帧 CPU):300 点 1.29ms、1000 点 5.32ms、3000 点 10.7ms(关边)/ 14.7ms(开边);
329
+ WebGL2 3000 点 4.5–5.1ms(与 2D 同视角对拍验证过色带分群/边网密度逐层一致)。产物增量:`dist/client.js` 24.6KB → 114.8KB(无第三方渲染库,react 仍走 external)。
330
+
5
331
  ## 0.2.0
6
332
 
7
333
  主体性流程记录:**遗忘作为设计**——滑窗淡出、未竟账、条件化、反馈重排,四件全部**缺省关**(灰度闸链:
package/README.en.md CHANGED
@@ -87,6 +87,10 @@ only the live recency lane runs — no errors, nothing invented. spirit calls on
87
87
  and the character has no feelings" happens silently.
88
88
  - **A broken store does not mean no feelings**: if `node:sqlite` is unavailable, entries fall back to
89
89
  an in-memory mirror — this turn's state is still injected, history and cross-session tone stop.
90
+ ⚠️ The mirror is memory-only (capped at 200 rows, **no path back into the DB**): entries recorded
91
+ while degraded do not survive a restart. The "storage unavailable" panel line says exactly this.
92
+ The plugin does not retry reopening in a loop (bounded failure beats infinite restart); restart
93
+ the host to recover.
90
94
  - **Off really means zero bytes**: the host was measured on two arms — installed with
91
95
  `enabled: false` versus not installed at all — pairing request bodies by kind. spirit contributes
92
96
  0 bytes (no injected row, no persona section, identical `system`). The only 40 B difference comes
@@ -138,6 +142,11 @@ not render an automatic volatile form, so those keys are not on the settings pag
138
142
 
139
143
  ## Known limits (v0.1)
140
144
 
145
+ - History recall has a **scan window**: the candidate pool is the most recent 5000 rows. `LIKE '%…%'`
146
+ cannot use an index, the store is append-only (rows are never deleted), and this lookup runs
147
+ **synchronously** on pre-step — `recall.timeoutMs` only covers the async DRSC call, not local
148
+ SQLite. Older entries are reachable through journal paging / export, not automatic recall
149
+
141
150
  - No long-range emotion retrieval, knowledge graph, conflict adjudication or persona self-evolution
142
151
  (that is memory-engine and dsh-soul territory)
143
152
  - Neutral turns are not recorded by default (`salience.neutral = 0`), otherwise the store degrades
package/README.md CHANGED
@@ -75,6 +75,8 @@ spirit 只调用它的 `op` 面(`status` / `session` / `search`),**从不
75
75
  - **卡是否还作数,看会话日志而不是猜**:注入行要真进日志才算生效;压缩/清空会把"已发过"的凭据重置,
76
76
  否则就是"压缩一次,角色再也没情绪了"——而且不报错。
77
77
  - **库坏了不等于没情绪**:`node:sqlite` 不可用就退内存镜像,本轮状态照常出卡,只停历史与跨会话。
78
+ ⚠️ 镜像只在内存(上限 200 条,**没有回灌库的路径**):降级期间记下的条目在重启后不会回来。
79
+ 面板「存储不可用」那行就是在说这件事;本仓不自动反复重开库(有界失败优于无限重试),要恢复就重启宿主。
78
80
  - **关掉就是零字节**:真机把“装了但 `enabled:false`”与“根本没装”两臂的请求体逐类配对比过,
79
81
  spirit 自身贡献 0 字节(无注入行、无人格区、`system` 完全相同);唯一的 40B 差异来自宿主
80
82
  自己列出的已安装插件清单(那是宿主行为,与插件启停无关)。
@@ -165,6 +167,9 @@ grep 断言同装跑真回合。但对方证据面**原样收 assistant 发言**
165
167
 
166
168
  - 不做长期情绪检索的**语义层**(矛盾裁决、图谱、人设自动演化仍不在——淡出/gist 是注入侧形态,
167
169
  不是新的事实索引);条目库依旧不建 FTS5
170
+ - 历史检索有**扫描窗**:候选池只取最近 5000 条再过滤。理由是 `LIKE '%…%'` 用不上索引、库
171
+ append-only 且永不删行,而这条检索在 pre-step 上**同步**执行(`recall.timeoutMs` 只包 DRSC
172
+ 那次异步检索,管不到本地 SQLite)。超过这个量的旧条目走「手记」分页与导出,不进自动回忆
168
173
  - 淡出/未竟账/条件化三面**缺省全关**:实机最佳参数集尚未观察出来;开了的单会话数据只进
169
174
  派生表与卡文本,关闸后行为与 v0.1 逐字节一致(有回归用例钉住)
170
175
  - 中性轮默认不记(`salience.neutral = 0`),否则库会退化成逐轮流水账