dsh-spirit 0.1.1 → 0.3.0

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 (95) hide show
  1. package/CHANGELOG.en.md +20 -0
  2. package/CHANGELOG.md +218 -0
  3. package/README.en.md +9 -0
  4. package/README.md +60 -6
  5. package/cordis.patch.yml +16 -0
  6. package/dist/client.js +3383 -75
  7. package/dist/config.d.ts +3 -1
  8. package/dist/config.js +112 -1
  9. package/dist/contract.d.ts +562 -17
  10. package/dist/contract.js +93 -4
  11. package/dist/db/migrate.d.ts +15 -10
  12. package/dist/db/migrate.js +76 -7
  13. package/dist/db/open.d.ts +5 -4
  14. package/dist/db/open.js +33 -18
  15. package/dist/db/schema.d.ts +17 -3
  16. package/dist/db/schema.js +142 -4
  17. package/dist/distill/llm.d.ts +56 -0
  18. package/dist/distill/llm.js +109 -0
  19. package/dist/distill/prompts.d.ts +60 -0
  20. package/dist/distill/prompts.js +175 -0
  21. package/dist/distill/ruminate.d.ts +82 -0
  22. package/dist/distill/ruminate.js +346 -0
  23. package/dist/dream/dream.d.ts +70 -0
  24. package/dist/dream/dream.js +156 -0
  25. package/dist/drsc/client.d.ts +18 -2
  26. package/dist/drsc/client.js +20 -4
  27. package/dist/drsc/probe.d.ts +7 -0
  28. package/dist/drsc/probe.js +9 -0
  29. package/dist/embed/probe.d.ts +48 -0
  30. package/dist/embed/probe.js +91 -0
  31. package/dist/embed/remote.d.ts +58 -0
  32. package/dist/embed/remote.js +149 -0
  33. package/dist/experience/compile.js +8 -4
  34. package/dist/experience/render.d.ts +15 -0
  35. package/dist/experience/render.js +36 -1
  36. package/dist/experience/watcher.d.ts +14 -0
  37. package/dist/experience/watcher.js +43 -10
  38. package/dist/hooks/card-observe.js +4 -2
  39. package/dist/hooks/persona-section.d.ts +6 -0
  40. package/dist/hooks/persona-section.js +11 -8
  41. package/dist/index.js +172 -4
  42. package/dist/persona/markdown.d.ts +27 -0
  43. package/dist/persona/markdown.js +175 -0
  44. package/dist/persona/render.d.ts +12 -0
  45. package/dist/persona/render.js +25 -0
  46. package/dist/persona/store.d.ts +50 -7
  47. package/dist/persona/store.js +206 -7
  48. package/dist/persona/types.d.ts +3 -0
  49. package/dist/persona/types.js +15 -1
  50. package/dist/prime/client.d.ts +75 -0
  51. package/dist/prime/client.js +156 -0
  52. package/dist/prime/sync.d.ts +74 -0
  53. package/dist/prime/sync.js +116 -0
  54. package/dist/recall/form.d.ts +75 -0
  55. package/dist/recall/form.js +104 -0
  56. package/dist/recall/recent.d.ts +31 -6
  57. package/dist/recall/recent.js +36 -7
  58. package/dist/rpc.d.ts +38 -1
  59. package/dist/rpc.js +428 -25
  60. package/dist/sea/scene.d.ts +116 -0
  61. package/dist/sea/scene.js +253 -0
  62. package/dist/slot/bias.d.ts +33 -0
  63. package/dist/slot/bias.js +58 -0
  64. package/dist/slot/derive.d.ts +6 -0
  65. package/dist/slot/derive.js +6 -1
  66. package/dist/slot/render.d.ts +5 -0
  67. package/dist/slot/render.js +2 -1
  68. package/dist/spirit.d.ts +35 -2
  69. package/dist/spirit.js +181 -14
  70. package/dist/stats.d.ts +6 -1
  71. package/dist/stats.js +25 -1
  72. package/dist/store/bias.d.ts +37 -0
  73. package/dist/store/bias.js +91 -0
  74. package/dist/store/edges.d.ts +63 -0
  75. package/dist/store/edges.js +146 -0
  76. package/dist/store/experience.d.ts +117 -1
  77. package/dist/store/experience.js +459 -21
  78. package/dist/store/insights.d.ts +53 -0
  79. package/dist/store/insights.js +131 -0
  80. package/dist/store/ledger.d.ts +55 -0
  81. package/dist/store/ledger.js +113 -0
  82. package/dist/store/owner.d.ts +67 -0
  83. package/dist/store/owner.js +179 -0
  84. package/dist/store/topics.d.ts +55 -0
  85. package/dist/store/topics.js +133 -0
  86. package/dist/tools/selfname.d.ts +10 -0
  87. package/dist/tools/selfname.js +84 -0
  88. package/dist/types.d.ts +42 -1
  89. package/dist/types.js +13 -1
  90. package/dist/util/echo-phrases.d.ts +32 -0
  91. package/dist/util/echo-phrases.js +57 -0
  92. package/dist/words.d.ts +10 -1
  93. package/dist/words.js +29 -1
  94. package/dsh.plugin.json +2 -2
  95. package/package.json +126 -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,224 @@
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.3.0
21
+
22
+ 记忆星海:把体验库投影成一张能转的三维星图。**只读投影,不是可查询图谱**(不开写图面、
23
+ 不改 DB schema(仍 v2)、不引入任何渲染库),入口挂在顶部两席位(`sidebar.panellist` + `main`)。
24
+
25
+ ### 新增
26
+
27
+ - **`sea-graph`(只读)**:`listRecent(limit, { includeSuperseded })` 取全库最近 ≤3000 条(带 `LIMIT`:
28
+ 本库只归档不删行,无顶就是随使用时长线性变慢),`src/sea/scene.ts` 纯函数算出点/边/统计。
29
+ 边只允许三类且各自分色分线型:共享 cue / 时间邻近 / 取代链;每点 ≤6 边、全图 ≤6000 边。
30
+ - **编码规则(一个量只编码一次)**:颜色 = trigger 族(**不随主题变**),亮度 = 老化权重,
31
+ 半径 = salience,★ = feedback;`tier`(full/gist/held)与注入侧同公式同阈值,它只门控“能不能发光”。
32
+ - **两种组织方式**(面板「组织」切换,存 localStorage):`双极`(高度 = 归属轴,她 +Y / 主人 −Y,
33
+ 两极与主轴真画出来)与 `星盘`(中心 = 她,半径 = 多淡,相位 = 时间次序螺线,差速旋转 + 相位滞后自然成旋臂)。
34
+ - **渲染层双后端可插拔**:Canvas2D 为交付下限(光晕走**预渲染 sprite** + `lighter` 叠加,禁止逐帧
35
+ `createRadialGradient`);WebGL2 为可选加速(≥1500 点自动升,或用户开「高质量辉光」),
36
+ 中文标签固定叠 2D 层,`webglcontextlost` 当场回退 2D(切换必须换新 canvas 元素)。
37
+ - **人设管理接出已有写面**:`persona-preview`(不写盘)/ `persona-set`(`expectedRevision` 乐观并发)/
38
+ `persona-history` / `persona-restore`(回退也是**追加新 revision**,历史一行不改);面板内可改
39
+ 名字/语气/在意度/在意面,保存前能看见将要注入的原文与字节预算。
40
+
41
+ ### 增补(0.3.0-local.2 / local.3,用户实机反馈后追加)
42
+
43
+ - **靠近激活闪烁(proximity 场)**:对照姊妹包 prime-memory 的图交互——鼠标拂过一片星时
44
+ 半径(90px)内的星逐个拿脉冲辉光(相位用每点 `phase`,不同步闪),而不是只有 16px
45
+ 拾取命中的那一颗有反应;纯函数 `proxBoost` 两后端共用,带 4 例单测(含“齐闪像加载
46
+ 动画”的反例门禁)。
47
+ - **手记改名「灵-鱼的手记」并升级为结构卡片**(对照 prime-memory explorer 的字段分层):
48
+ 徽章行(类型/来源路/在意度/★)→ 正文 → gist 斜体行 → **线索 chips** → 元信息行(轮次·
49
+ 时间·在意面)。线索来自 `experience_cues`,`journal-tail` 行与 `sea-graph` 点**同批下发**
50
+ (≤4 条,不给前端二次请求拼证据面);星海详情卡同样挂线索 chips。在意面徽章单源
51
+ `sea-labels.NOTICE_LABEL`(手记与人设面共用,不给主人看 slug)。
52
+
53
+ ### 增补(0.3.0-local.4,人设进库 + markdown 备份可恢复)
54
+
55
+ - **人设从纯文件迁进 SQLite(schema v3,正向迁移)**:`persona_current`(单行表,
56
+ `CHECK(singleton=1)` 形状即约束)为权威当前位,`persona_revision` 为 append-only 全量
57
+ 历史——历史不再受 256KB 尾窗限制,超窗老版也能按 revision 找回。首次打开时若库里空而
58
+ `persona.json` 存在,自动一次性迁入(原文件不动,留作事故现场);DB 不可用时退回现行
59
+ 文件路径,降级纪律与体验库一致。
60
+ - **每次成功保存自动写单层人话备份 `persona.md`**(文件本身就是恢复源,不嵌 JSON 区;
61
+ 内容零 slug,在意度/在意面/语气全用面板同串中文,词表漂移由门禁测试钉住)。
62
+ 备份写失败只告警不回滚已提交的 DB 事务——备份可滞后,权威不能跟丢。
63
+ - **新端点 `persona-export-md` / `persona-import-md`**:人设页新增「markdown 备份」区——
64
+ 查看/复制当前备份,粘贴改过的文本二次确认后恢复。恢复走 `save()` 唯一写路径 ⇒
65
+ **追加新 revision,历史一行不改**;解析失败整体拒绝并点名非法词,绝不部分恢复。
66
+ - 语气下拉与历史行改显中文(平实/简短/温和,`words.ts` 单源),不再给主人看 slug。
67
+
68
+ ### 增补(0.3.0-local.5 / local.6,主人背景档案:prime-memory 定期同步 + 双段编辑)
69
+
70
+ - **主人背景档案进库(schema v4,正向迁移)**:`owner_profile` 单行表,**双段写路径分离**——
71
+ 同步段(机器投影,整段覆盖)与自述段(主人手写,乐观并发 `expectedRevision`)各列各写,
72
+ 互不抹段;每次成功写入原子落 `owner.md`(双节人话备份)。
73
+ - **定期同步 prime-memory 的 person 实体**(只读消费,无编译期依赖):主路径同源 RPC
74
+ `dsh-memory/rpc/graph-preview` 种子榜取 person 清单,再逐 id `graph-node-get` 取全量详情
75
+ (真宿主实测定案:`graph-search` 空 query 永远返空、preview 的 full 块是轻量形状无 facts);
76
+ 渲染成“名称(别名):facts 摘要”清单(top 8、单条 ≤120 字),**不断言谁是主人**(图上无主人标记)。
77
+ 缺席/空图 ⇒ 跳过且**不清旧段**(拿不到源 ≠ 背景消失)。
78
+ - **三个触发入口共用 60s 去重窗**:日级定时器(缺省 24h,首跑 0–10min 抖动)、面板「立即同步」、
79
+ `owner-sync-ping`(事件接收预备:prime 侧后续“情景更新推送”打这里,推送只发信号不带数据)。
80
+ - **新端点四腿**:`owner-get` / `owner-set-self` / `owner-sync-now` / `owner-sync-ping`;
81
+ 人设页新增「主人档案」区(prime 三态状态行 + 同步段只读 + 自述段可编)。
82
+ - **注入稳定区新增主人段**(`[主人] 自述` 优先、`[主人的背景(同步)]` 次行):独立预算键
83
+ `owner.budgetBytes`(缺省 400B,不挤人格区);两段皆空物理离场;缓存键含同步时刻,
84
+ 后台同步的新段不会因 revision 未变而被旧缓存顶掉。
85
+ - **prime 未装完全不影响运行**(真宿主对照组实测):`owner-get` 报 `primeStatus:'absent'`、
86
+ 同步 `{updated:false, reason:'prime-absent'}`,无报错无重试风暴;解耦门禁同步演进:
87
+ 禁包引用/库直读不变,`dsh-memory/` 端点字面量收口到 `src/prime/client.ts` 单文件。
88
+
89
+ ### 增补(0.3.0-local.10,昵称序列 + 自称序列(模型经 spirit_selfname 工具自改))
90
+
91
+ - **人设卡加两条序列**:`aliases`(昵称:主人日常怎么喊这条鱼)与 `selfNames`(自称:鱼说话时用什么指代自己),
92
+ 去重保序、单条 ≤24 字、列表 ≤8;稳定区新增 `[昵称]`/`[自称]` 两行(名字后、语气前;空 ⇒ 整行物理离场,
93
+ 老卡逐字节不变);markdown 备份新增「昵称/自称」节(round-trip 无损,自由词只套上限不拒收);
94
+ 人设页两条输入行(、/逗号/分号/空白宽进)。
95
+ - **`spirit_selfname` 工具(用户点名:自称允许 LLM 自己改)**:模型可增删自称列表(用顺了新自称当场记下);
96
+ 这是人设面**唯一**对模型开放的写字段(名字/语气/在意度/价值/边界不开);护栏:走 save() 唯一写路径(revision 推进/历史留档/md 重生)、
97
+ 累积式无整表覆盖、列表有顶、部署总闸关 ⇒ 不注册。tools 服务缺席的老宿主线自动不挂(作域注入)。
98
+
99
+ ### 增补(0.3.0-local.16,语气扩到七档 + 长文本框自动长高)
100
+
101
+ - **语气档位 3→7**(用户点名:偏少):新增 俏皮/安静/直白/诗意 四档,每档有开口词与收尾词(只表态度不表事实);
102
+ 单源传导链验证:面板下拉/md 备份反查/稳定区 [语气] 行全部自动跟进;键集闸改单源比对(以后再扩列不用改闸)。
103
+ - **主人档案等同源长文本框自动长高**(用户点名:同步段钉死三行读不了):六处 textarea 统一换 AutoArea,
104
+ 随内容撑开封顶 480px 后内滚;只读同步段(拖拽手柄对只读框不可用)受益最明显。
105
+
106
+ ### 增补(0.3.0-local.12..15,长觉阶梯:主题分区 + 因果边 + LLM 蒸馏反刍 + 碰撞裁决 + 向量能力位)
107
+
108
+ - **三层记忆(schema v6,五张派生表 + entry_vector)**:工作记忆(experience,一字不动)→ 主题分区
109
+ (topic/experience_topic:cues×trigger 确定性骨架即时回填 + 长觉归题精修,改判写新行)→ 蒸馏记忆
110
+ (insight/causal_edge/sleep_run)。派生定性 action_bias 同构:可整表重算,**绝不进 recent()/deriveMood/注入**
111
+ (G15 结构闸 + 行为例:蒸完整轮后注入指纹逐字不变)。
112
+ - **长觉(RuminateRunner,缺省关)**:异步 LLM 归纳 pass——攒批(水位防重蒸)→ 调用#1 归题/洞察/因果提案
113
+ → 调用#2 碰撞去重 → 单事务落库;进度 phase/detail、软取消、退避 120s→15min(配置错误豁免)、去重窗 300s、
114
+ 连败 3 park。面板「做梦」tab 长觉块:一键跑 + 进度轮询 + 叫醒 + 上次长觉报告(含实际模型名)。
115
+ - **蒸馏模型可选(fail-closed)**:distill.{provider,model,reasoningEffort} 留空跟宿主默认(agentDefaultModel 宽容读),
116
+ 显式配了解析不到 ⇒ 拒蒸说人话,**绝不隐式改选**(G13 实闸:代码面不存在退默认分支);llm 缺席整条休眠(域注入,顶层 inject 不变)。
117
+ - **碰撞检查三层(用户点名)**:insight 同题矛盾 ⇒ conflict 双留(机器绝不自动删),翻阅 tab「线索头」视图里
118
+ 人工裁决(「信这条」/「都收起来」走 insight-resolve,只改状态位原文永在);证据条目被藏/取代 ⇒ 读侧 stale 传播(回场自愈);
119
+ 幻觉 id 校验丢弃(evidence 必须 ⊆ 本批)。
120
+ - **因果边**:启发式打底(失败→恢复「导致」)+ LLM 投影(四词单源 SPIRIT_CAUSAL_RELATIONS、只钳长度、
121
+ 显式陈述才写);星海 kind 扩 'causal'(橙实线图例在场才显),截断优先级 causal>cue>time(score 1.1 表达,既有边序零回归)。
122
+ - **向量能力位(缺省关)**:调研实锤 prime 无可借 embedding 服务——定案为「借档位(embedding-state-get 对齐
123
+ baseURL/模型/维度,key 自持)+ 缺席自启(纯 fetch OpenAI 兼容)+ BLOB+Float32Array 零新依赖」;
124
+ 两阶段检索只走冷路径;维度首建锁 meta,不一致显式报错不静默重建;G11 出站收口/G20 出境(prompt 不含用户原文)/
125
+ G24 凭据(apiKey 不回显不落日志)三道新闸落地。
126
+ - **新端点六腿**:`sleep-run/status/cancel/report` + `topics-get` + `insight-resolve`;settings 面加 distillEnabled 热更键。
127
+ - 对外语域仍是鱼/睡/梦:小盹=确定性整理,长觉=深睡想明白——没有「反刍/蒸馏管道」类机械词(R5 禁词族扩 sleep/topic/causal)。
128
+ - 桥 round-29 拓出并修复两枚同源 bug(受理路径自拦双变体):`run()` 预置 running / 预占去重窗后
129
+ 任务体再 precheck 会把自家受理拒掉——受理后专用体 `runAccepted()` 不再重检;回归钉进 distill.test。
130
+ 另补报告跨重启可读(status 懒 hydrate 自 meta,宿主重启后面板不致失忆)。
131
+
132
+ ### 增补(0.3.0-local.9,设置面可见性:睡眠开关 + 回响导航)
133
+
134
+ - **做梦开关进 volatile(六写点全套)**:`live.dreamEnabled`(缺省开)——宿主设置页自动表单与设置卡「睡眠(做梦)」块同时可见可热更;
135
+ 双闸取与(部署面总闸 ∧ live 闸),关闸后定时器空转、手动「让鱼睡一觉」拒并指路(reason:'disabled' 说出口)。
136
+ - **设置卡新增睡眠块**:自动做梦开关 + 上次梦境读数(时间/合并对数/在场数)+ 回响导航行(条目管理与手动做梦在「记忆星海」的 翻阅/做梦 tab)。
137
+
138
+ ### 增补(0.3.0-local.7 / local.8,翻阅 tab:prime 级条目管理面 + 做梦 + DRSC 缺席提示 + 设置卡瘦身)
139
+
140
+ - (local.8 重包)round-28 真浏览器拓出★继承假绿:`reviseEntry` 的 INSERT 没带 feedback_score 列,
141
+ ★只在返回对象里、库里新行是 NULL,刷新即蒸发——新增 REVISE_INSERT_SQL(17 列含 feedback_score),
142
+ 单测同步补**读回断言**(断返回对象不算数,断库里的行才算数)。
143
+
144
+ - **星海面板四 tab(星海/人设/翻阅/做梦)**:设置卡的记录检视整体迁到「翻阅」——
145
+ 搜索(扫描窗内 LIKE,截断如实报)/ 筛选(类型·来源·★·含更正史·藏起来的)/ 服务端分页
146
+ (limit=50 加载更多,hasMore 探界不做全表 COUNT)/ 就地详情 / 「这条重要」/ 导出入口。
147
+ - **藏起来 ⇄ 再想起(schema v5,正向迁移)**:`experience.hidden_at` 标记列——行永不物理删
148
+ (红线闸不变),藏后退出星海图/注入/手记缺省视图,「藏起来的」视图里可恢复。
149
+ - **更正式编辑(「理解变了」)**:插新行 + 旧行置 `superseded_by`(与更正同构,不原地改正文);
150
+ ★ 标记复制进新行,cues 拷贝,`source_ref=rev:<旧 id>`;编辑史以取代链形态在星海自然可见。
151
+ UPDATE 列白名单(superseded_by/updated_at/feedback_score/hidden_at)落成实闸,把 schema
152
+ 注释里声称却不存在的那道纸面闸补成了真闸。
153
+ - **让鱼做梦(确定性整理 pass,零模型调用)**:等值查重合并 + 归档淡出(尊重部署面 dryRun)
154
+ + 梦境报告(合并/归档/在场/幽灵/★/档位读数)落 meta;「让鱼睡一觉」手动按钮 + 日级定时器
155
+ (owner 同款骨架),三入口共用 60s 去重窗;报告不进系统提示。
156
+ - **DRSC 缺席提示(照 prime banner 口径,按 spirit 探测能力封顶两档)**:设置卡 verdict 行下
157
+ warn 态出「影响说明 + 可复制指引」(clipboard 失败退全选,绝不自动执行);skipped 中性不渲染;
158
+ 星海顶栏消息带同位短提示(判定单源在 sea-graph 响应的 drscVerdict 字段)。
159
+ - **设置卡瘦身**:只留运行读数 + 淡出表单 + 导出 + 重试,不再逐轮拉条目;UI 可达性实闸
160
+ (settings-set/journal-export/experience-feedback 必须在 client 源码有引用)防「契约在、UI 没了」。
161
+ - **拟人化文案纪律(R5)**:新机制文案统一鱼的第一人称行为语言(「藏起来」「再想起」「理解变了」
162
+ 「让鱼睡一觉」「鱼梦见了…」),新前缀键(rec/dream/drscHint)禁机械词实闸;词表目录首屏下发,
163
+ client 不手抄枚举。
164
+
165
+ ### 修正
166
+
167
+ - **图上亮度与注入侧分两把尺**(新键 `sea.agingHalfLifeMs`,缺省 7 天):拿 1.5h 的注意力窗口算跨月库
168
+ 会得到“全图都是暗星”(真浏览器实测 `fade` = 0/0/3000);`tier` 仍用小时尺度,因为它的语义就是
169
+ “还在不在注意力窗口里”。
170
+ - **亮度带基座、暗星有地板**:指数衰减动态范围极大(跨月 ÷ 7 天 ≈ 15 个半衰期),从 0 起算会让
171
+ 90% 的点在暗背景上隐形。遗忘是“沉下去”,不是“看不见”。
172
+ - **经度不再按类型分扇区**:`axisOf` 已按 trigger 给基值,经度再按 trigger 分角度就是把同一个量画两次
173
+ (同类排成纬线弧带,读图者会把高度误读成类型);改为 id 哈希铺满整圈 + 正弦弱吸引(线性插值会在
174
+ 基准角对面留出一段无点空弧)。
175
+
176
+ ### 性能
177
+
178
+ 真浏览器实测(Canvas2D,单帧 CPU):300 点 1.29ms、1000 点 5.32ms、3000 点 10.7ms(关边)/ 14.7ms(开边);
179
+ WebGL2 3000 点 4.5–5.1ms(与 2D 同视角对拍验证过色带分群/边网密度逐层一致)。产物增量:`dist/client.js` 24.6KB → 114.8KB(无第三方渲染库,react 仍走 external)。
180
+
181
+ ## 0.2.0
182
+
183
+ 主体性流程记录:**遗忘作为设计**——滑窗淡出、未竟账、条件化、反馈重排,四件全部**缺省关**(灰度闸链:
184
+ `live.fadeEnabled` 与各自静态闸取与,关闸后行为与 0.1.x 逐字节一致,有回归用例钉住)。
185
+
186
+ ### 新增
187
+
188
+ - **滑窗淡出(`recall.fade*`)**:条目按 `m=(salience/2)×注意力权重` 分三态——原文 full / 一句话 gist /
189
+ 不上卡 held。权重与姊妹引擎同式 `0.5^(Δt/halfLife)` 同地板 0.5(时间至多让记忆“变淡一半”,
190
+ held 经“无残句/低档/阈值调高”三路达成);Δt 按半衰期**量化后才进指纹**,档内字节稳定、
191
+ 重发只发生在跨档(护住 unchanged 门与“同档同召回⇒字节全等”红线)。gist 编译期从固定表
192
+ `GIST_TABLE` 派生落库(运行时改写记忆=伪造)。
193
+ - **DB schema v1→v2**:`experience` 加 `salience`/`gist`/`feedback_score` 三列(全部加法迁移,
194
+ `PRAGMA table_info` 先查后加,幂等);新表 `session_ledger`(未竟账,基元=session)与
195
+ `action_bias`(条件化,定性为**可重算派生缓存**,豁免无-UPDATE 纪律并在 schema 头注声明)。
196
+ - **未竟账(`ledger.*`)**:`agent/disposed` 主触发 + `turn/end` 兑底(顺序:先结算后释放);
197
+ 只吃 todo 快照的结构计数(`watcher.openLoops` 为只读快照——中途读不吃计数,集成调出的真 bug
198
+ 已修);措辞档位化,计数真为 3 才说 3;maxAge 过期不带出,镜像有顶。
199
+ - **条件化(`bias.*`)**:强负体验给同名动作短期抑制(三档词:hesitant/guarded),turn/end 冷路径
200
+ upsert、pre-step O(1) 主键查表(禁每轮扫表);两通道:卡状态段倾向短语覆写(renderCard.tendencyOverride)
201
+ 与 derive 乘子(只放大负向条目权重,不跨 reaction 档、不新增输入);**不碰 decision、不注
202
+ 钩子、不对外报数**;验收钉“开/关两臂除 text 外全等”与“缺省乘子集与无乘子逐字一致”。
203
+ - **人工反馈重排(`recall.feedbackEnabled`)**:移植姊妹引擎 recall-usage 形态,-1..5 手打
204
+ (面板两键:这条重要/撤销);**只重排进卡优先序,不回灌衰减曲线与情绪派生**(两轴分离)。
205
+ - **echo 链断言(`tests/echo-chain.test.ts` + `src/util/echo-phrases.ts`)**:短语集单源派生自九档
206
+ label/tendency+签名行+gist;CI 档钉“卡语整段可识别”与入口分流规则;真机档(对方 L1 导出面
207
+ 不含 spirit 短语)列入发版前置。
208
+ - **面板六腿**:淡出开关/窗口尺度经 volatile 接管,新增 rpc `settings-get`/`settings-set`(区间单源 SPIRIT_RANGES;宿主 volatile 写通道不可用时如实报 `no-volatile` 需重启),
209
+ panel 补输入框(开关 + 半衰期分钟)与淡出指标行;手记分页回显 gist/salience/feedback,
210
+ stats 新增淡出计数族(full/gist/held/marked/pool/churn);`ab-report` 新增每轮发卡率与淡出代理量。
211
+ - **调参 SOP**(README):指标→pin→A/B→方向判据→灰度序;可调项封顶四类,`card.maxBytes` 与
212
+ 地板 0.5 不在面板暴露。
213
+
214
+ ### 变更
215
+
216
+ - `SpiritJournalPage.rows` 新增 `gist`/`salience`/`feedbackScore` 三字段(null 合法,v1 旧行不假装知道)。
217
+ - 未竟账/条件化共享 `live.fadeEnabled` 总闸:防止“只开一半”的半新半旧注入形态。
218
+
219
+ ### 未做(有意)
220
+
221
+ - 冷路径叙事块(模型调用×DRSC 滞后源×画像污染放大三重风险,且依赖 echo 链真机档先落地)。
222
+
5
223
  ## 0.1.0
6
224
 
7
225
  第一个可用版本:**第一人称体验条目库 + 双路即时召回**。
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,9 +75,22 @@ 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
  自己列出的已安装插件清单(那是宿主行为,与插件启停无关)。
83
+ - **淡出是逐出注意力,不是删记忆**:存储侧依旧 append-only 一个字节不删;`fadeEnabled`
84
+ 开启后条目按 salience×注意力衰减分三态——原文(full)→一句话(gist)→不上卡(held)。
85
+ gist 只能编译期从固定表派生落库(运行时改写记忆=伪造);衰减权重与姊妹引擎同式
86
+ `0.5^(Δt/halfLife)` 且同地板 0.5:**时间单独永远至多让一条经历“变淡一半”**,
87
+ held 经“无残句可降/低 salience 档/阈值调高”三条路达成,不靠把记忆归零。
88
+ - **反馈两轴分离**:手打分(-1..5)只重排进卡优先序,**不回灌**衰减曲线与情绪派生——
89
+ 打分是“人觉得重不重要”,衰减是“客观变淡”,合并就变成自我强化回路。
90
+ - **未竟账只吃结构计数**:新会话开局那行“上次有口子没放下”只能来自 todo 快照的整数计数,
91
+ 计数真为 3 才说 3;dispose 与 turn/end 双触发,幂等由 id 在存储层收敛。
92
+ - **条件化不是控制面**:bias 只换卡上状态段的倾向半句(三档词),不碰 decision、不注钩子、
93
+ 不对外报数;验收用例钉“开/关两臂除 text 外全等”。
81
94
 
82
95
  ## 想验证它到底有没有用
83
96
 
@@ -107,17 +120,58 @@ npm run ab -- --home "$DSH_HOME" --json # 机读
107
120
 
108
121
  键名与默认值的唯一事实源是 [`src/contract.ts`](src/contract.ts)(部署面契约,不可更名)。
109
122
  常用项:`card.maxBytes`、`card.recentK`、`card.crossSessionM`、`recall.halfLifeMs`、`recall.timeoutMs`、
110
- `tier.stepCap`、`tier.staleAfterMs`、`journal.retentionDays`、`drsc.enabled`。
123
+ `recall.fadeEnabled`(淡出总闸,**缺省关**)、`recall.fadeHalfLifeMs`(窗口尺度,volatile 可热更)、
124
+ `recall.fadeFullMinScore`/`fadeGistMinScore`(千分位双阈值)、`recall.gistMinSalience`、
125
+ `recall.feedbackEnabled`、`ledger.enabled`/`maxAgeMs`(未竟账,缺省关)、
126
+ `bias.enabled`/`halfLifeMs`(条件化,缺省关)、`tier.stepCap`、`tier.staleAfterMs`、
127
+ `journal.retentionDays`、`drsc.enabled`。
111
128
  每项在 [`cordis.patch.yml`](cordis.patch.yml) 的注释里都有一行说明。
112
129
 
130
+ > ⚠ `fadeHalfLifeMs` 属 volatile 接管键:生效值永远来自 `live.fadeHalfLifeMs`,静态节同名的
131
+ > 那份只是缺省——改静态不改 live 不会生效(集成调参时真实踩过这个坑,测试里也踩穿过)。
132
+
113
133
  数据目录:`$DSH_HOME/spirit`(`spirit.db` / `persona.json` / `persona-history.jsonl` / `session-modes.json` / `archive/`)。
114
134
 
115
135
  热改路径:`live.*` 节标了 `.volatile()`,改 `cordis.patch.yml` 不重启即生效;会话级开关走输入栏 pill。
116
- (0.2.0-rc.2 的 web 壳子不渲染 volatile 自动表单,所以这些键不在设置页上。)
117
-
118
- ## 已知边界(v0.1)
119
-
120
- - 不做长期情绪检索、图谱、矛盾裁决、人设自动演化(那是记忆引擎与 soul 的地盘)
136
+ 淡出三键(`live.fadeEnabled`/`fadeHalfLifeMs`/`feedbackEnabled`)另走面板「淡出设置」行与 `settings-get/set` RPC(写 volatile ref;不可热更时面板如实标“需重启”)。
137
+ (0.2.0-rc.2 的 web 壳子不渲染 volatile 自动表单,所以这些键不在设置页上;面板的 `settings-*` RPC 腿不受此限。)
138
+
139
+ ## 遗忘怎么调:观察—pin—对照—定向—灰度(v0.2 淡出/未竟/条件化的调参 SOP)
140
+
141
+ 淡出参数没有“校准过的最优值”,只有“这台机器上观察出来的合适值”,所以给可执行的五步:
142
+
143
+ 1. **指标先行**:面板「淡出(原文/一句话/退场)」行读每会话累计的 full/gist/held 占比与发卡轮次;
144
+ 离线用 `npm run ab` 的「每轮发卡率」与「淡出代理」行归因。
145
+ 2. **基线可 pin**:`live.fadeHalfLifeMs=0` 冻结窗口(只按 salience 定档)与 `fadeEnabled=false`
146
+ 是两个对照臂——任何调参结论都要先跟 pin 臂比过才作数。
147
+ 3. **A/B 双跑**:旁路臂=淡出关,注入臂=淡出开;重点看每轮发卡率(跨档重发强度)与卡字节。
148
+ 4. **调整方向判据**(不凭观感,落证据):
149
+ - held 占比高且反馈高分多落在 held 项 → 半衰期调长或 gistMinSalience 下调;
150
+ - 每轮发卡率升高(档跳频繁)→ 量化档加宽(拉大 fadeHalfLifeMs 或降低 fadeGistMinScore);
151
+ - 卡长期只有状态段、近因段空 → 候选池/阈值过严,回调 fadeFullMinScore。
152
+ 5. **灰度序**:缺省关 → 单会话开 → 反馈闭环数据攒够两个周期再议翻默认。
153
+
154
+ 可调项封顶四类(半衰期/双阈值/gist 最低档/窗口条数走 card.recentK);`card.maxBytes` 与地板 0.5
155
+ 不在面板暴露——防止把窗口调到每轮跨档 churn,或把“淡出”调成“失忆”。
156
+
157
+ ## 与姊妹记忆引擎的 echo 链(v0.2 钉住的唯一活口)
158
+
159
+ 两仓正交靠三道既有守卫:注入署名 `plugin:spirit` 被对方 L0 入口过滤、双库互不读写、
160
+ grep 断言同装跑真回合。但对方证据面**原样收 assistant 发言**——模型若复述卡语,会沿
161
+ 复述→蒸馏→画像的路把体验洗成事实。这条链 spirit 单方面修不了(修它要动对方的提取面,
162
+ 而解耦闸禁止 spirit 出现对方包名字面量),交付的是两条压风险的纪律:
163
+ 卡语汇保持不可蒸馏语(档位词短句、不陈述因果,复述进事实层也无信息量),
164
+ `tests/echo-chain.test.ts` 把“语汇整段可识别”钉成 CI 断言,改版偷换文案会即红。
165
+
166
+ ## 已知边界(v0.2)
167
+
168
+ - 不做长期情绪检索的**语义层**(矛盾裁决、图谱、人设自动演化仍不在——淡出/gist 是注入侧形态,
169
+ 不是新的事实索引);条目库依旧不建 FTS5
170
+ - 历史检索有**扫描窗**:候选池只取最近 5000 条再过滤。理由是 `LIKE '%…%'` 用不上索引、库
171
+ append-only 且永不删行,而这条检索在 pre-step 上**同步**执行(`recall.timeoutMs` 只包 DRSC
172
+ 那次异步检索,管不到本地 SQLite)。超过这个量的旧条目走「手记」分页与导出,不进自动回忆
173
+ - 淡出/未竟账/条件化三面**缺省全关**:实机最佳参数集尚未观察出来;开了的单会话数据只进
174
+ 派生表与卡文本,关闸后行为与 v0.1 逐字节一致(有回归用例钉住)
121
175
  - 中性轮默认不记(`salience.neutral = 0`),否则库会退化成逐轮流水账
122
176
  - 真机 web 冒烟已过(宿主 0.2.0-rc.2,隔离 `DSH_HOME`):宿主半装载、面板六端点(含 403/404/405 三面防线)、
123
177
  pill 三态写盘与重启读回、设置页「手记」分节渲染与导出落盘均逐项验过;
package/cordis.patch.yml CHANGED
@@ -23,6 +23,22 @@
23
23
  # maxResults: 3
24
24
  # maxCharsPerEntry: 120
25
25
  # halfLifeMs: 5400000 # 条目近因半衰期(缺省 90 分钟,经验值可调)
26
+ # fadeEnabled: false # 滑窗淡出总闸(v0.2 新能力,缺省关=与 v0.1 逐字节一致;灰度闸)
27
+ # fadeHalfLifeMs: 5400000 # 淡出档位的 Δt 尺度(与 prime 同式 0.5^(Δt/halfLife);情绪尺度缺省;
28
+ # # 调参 SOP 见 README:held 占比过高→拉长,重发率升高→加宽量化档)
29
+ # fadeFullMinScore: 550 # full 档分数地板(千分位;m=(salience/2)×注意力衰减,反馈不回灌 m)
30
+ # fadeGistMinScore: 250 # gist 档分数地板(千分位;低于它 ⇒ held 不上卡,库内仍在)
31
+ # gistMinSalience: 1 # gist 的最低 salience(弱条目直接 held,宁缺毋造)
32
+ # feedbackEnabled: true # 人工反馈只重排不回灌派生分(两轴分离,移植 prime recall-usage)
33
+ # ledger:
34
+ # enabled: false # 未竟账(会话收尾结构计数,新会话开局带出一行;缺省关)
35
+ # maxAgeMs: 604800000 # 账行过期不再带出(缺省 7 天顶,配合有顶 GC)
36
+ # bias:
37
+ # enabled: false # 条件化(强负体验→同类动作短期抑制,三档词;缺省关)
38
+ # halfLifeMs: 5400000 # 派生缓存表的过期尺度
39
+ # live: # volatile 热更节(改值不重启;0.2.0-rc.2 web 壳不渲染其表单)
40
+ # fadeEnabled: false # 与静态 recall.fadeEnabled 取与:淡出/未竟/条件化统一灰度总开关
41
+ # fadeHalfLifeMs: 5400000 # 面板可调的窗口尺度(六腿的 volatile 腿)
26
42
  # tier:
27
43
  # stepCap: 1 # 单轮最多跨几格(防人格抽动)
28
44
  # staleAfterMs: 600000 # 越此无新条目 ⇒ 退中性档