dsh-spirit 0.1.1 → 0.2.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 (48) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.md +55 -6
  3. package/cordis.patch.yml +16 -0
  4. package/dist/client.js +91 -3
  5. package/dist/config.d.ts +2 -0
  6. package/dist/config.js +45 -1
  7. package/dist/contract.d.ts +96 -4
  8. package/dist/contract.js +29 -4
  9. package/dist/db/migrate.d.ts +15 -10
  10. package/dist/db/migrate.js +41 -7
  11. package/dist/db/open.d.ts +5 -4
  12. package/dist/db/open.js +33 -18
  13. package/dist/db/schema.d.ts +10 -3
  14. package/dist/db/schema.js +37 -4
  15. package/dist/experience/compile.js +8 -4
  16. package/dist/experience/render.d.ts +15 -0
  17. package/dist/experience/render.js +27 -0
  18. package/dist/experience/watcher.d.ts +14 -0
  19. package/dist/experience/watcher.js +43 -10
  20. package/dist/hooks/card-observe.js +4 -2
  21. package/dist/index.js +30 -1
  22. package/dist/recall/form.d.ts +75 -0
  23. package/dist/recall/form.js +104 -0
  24. package/dist/recall/recent.d.ts +31 -6
  25. package/dist/recall/recent.js +36 -7
  26. package/dist/rpc.d.ts +7 -0
  27. package/dist/rpc.js +66 -1
  28. package/dist/slot/bias.d.ts +33 -0
  29. package/dist/slot/bias.js +58 -0
  30. package/dist/slot/derive.d.ts +6 -0
  31. package/dist/slot/derive.js +6 -1
  32. package/dist/slot/render.d.ts +5 -0
  33. package/dist/slot/render.js +2 -1
  34. package/dist/spirit.d.ts +35 -2
  35. package/dist/spirit.js +181 -14
  36. package/dist/stats.d.ts +5 -1
  37. package/dist/stats.js +22 -1
  38. package/dist/store/bias.d.ts +37 -0
  39. package/dist/store/bias.js +91 -0
  40. package/dist/store/experience.d.ts +8 -0
  41. package/dist/store/experience.js +36 -2
  42. package/dist/store/ledger.d.ts +55 -0
  43. package/dist/store/ledger.js +113 -0
  44. package/dist/types.d.ts +16 -0
  45. package/dist/util/echo-phrases.d.ts +32 -0
  46. package/dist/util/echo-phrases.js +57 -0
  47. package/dsh.plugin.json +1 -1
  48. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -2,6 +2,48 @@
2
2
 
3
3
  本项目的所有值得记录的变更都写在这里。版本号遵循语义化版本。
4
4
 
5
+ ## 0.2.0
6
+
7
+ 主体性流程记录:**遗忘作为设计**——滑窗淡出、未竟账、条件化、反馈重排,四件全部**缺省关**(灰度闸链:
8
+ `live.fadeEnabled` 与各自静态闸取与,关闸后行为与 0.1.x 逐字节一致,有回归用例钉住)。
9
+
10
+ ### 新增
11
+
12
+ - **滑窗淡出(`recall.fade*`)**:条目按 `m=(salience/2)×注意力权重` 分三态——原文 full / 一句话 gist /
13
+ 不上卡 held。权重与姊妹引擎同式 `0.5^(Δt/halfLife)` 同地板 0.5(时间至多让记忆“变淡一半”,
14
+ held 经“无残句/低档/阈值调高”三路达成);Δt 按半衰期**量化后才进指纹**,档内字节稳定、
15
+ 重发只发生在跨档(护住 unchanged 门与“同档同召回⇒字节全等”红线)。gist 编译期从固定表
16
+ `GIST_TABLE` 派生落库(运行时改写记忆=伪造)。
17
+ - **DB schema v1→v2**:`experience` 加 `salience`/`gist`/`feedback_score` 三列(全部加法迁移,
18
+ `PRAGMA table_info` 先查后加,幂等);新表 `session_ledger`(未竟账,基元=session)与
19
+ `action_bias`(条件化,定性为**可重算派生缓存**,豁免无-UPDATE 纪律并在 schema 头注声明)。
20
+ - **未竟账(`ledger.*`)**:`agent/disposed` 主触发 + `turn/end` 兑底(顺序:先结算后释放);
21
+ 只吃 todo 快照的结构计数(`watcher.openLoops` 为只读快照——中途读不吃计数,集成调出的真 bug
22
+ 已修);措辞档位化,计数真为 3 才说 3;maxAge 过期不带出,镜像有顶。
23
+ - **条件化(`bias.*`)**:强负体验给同名动作短期抑制(三档词:hesitant/guarded),turn/end 冷路径
24
+ upsert、pre-step O(1) 主键查表(禁每轮扫表);两通道:卡状态段倾向短语覆写(renderCard.tendencyOverride)
25
+ 与 derive 乘子(只放大负向条目权重,不跨 reaction 档、不新增输入);**不碰 decision、不注
26
+ 钩子、不对外报数**;验收钉“开/关两臂除 text 外全等”与“缺省乘子集与无乘子逐字一致”。
27
+ - **人工反馈重排(`recall.feedbackEnabled`)**:移植姊妹引擎 recall-usage 形态,-1..5 手打
28
+ (面板两键:这条重要/撤销);**只重排进卡优先序,不回灌衰减曲线与情绪派生**(两轴分离)。
29
+ - **echo 链断言(`tests/echo-chain.test.ts` + `src/util/echo-phrases.ts`)**:短语集单源派生自九档
30
+ label/tendency+签名行+gist;CI 档钉“卡语整段可识别”与入口分流规则;真机档(对方 L1 导出面
31
+ 不含 spirit 短语)列入发版前置。
32
+ - **面板六腿**:淡出开关/窗口尺度经 volatile 接管,新增 rpc `settings-get`/`settings-set`(区间单源 SPIRIT_RANGES;宿主 volatile 写通道不可用时如实报 `no-volatile` 需重启),
33
+ panel 补输入框(开关 + 半衰期分钟)与淡出指标行;手记分页回显 gist/salience/feedback,
34
+ stats 新增淡出计数族(full/gist/held/marked/pool/churn);`ab-report` 新增每轮发卡率与淡出代理量。
35
+ - **调参 SOP**(README):指标→pin→A/B→方向判据→灰度序;可调项封顶四类,`card.maxBytes` 与
36
+ 地板 0.5 不在面板暴露。
37
+
38
+ ### 变更
39
+
40
+ - `SpiritJournalPage.rows` 新增 `gist`/`salience`/`feedbackScore` 三字段(null 合法,v1 旧行不假装知道)。
41
+ - 未竟账/条件化共享 `live.fadeEnabled` 总闸:防止“只开一半”的半新半旧注入形态。
42
+
43
+ ### 未做(有意)
44
+
45
+ - 冷路径叙事块(模型调用×DRSC 滞后源×画像污染放大三重风险,且依赖 echo 链真机档先落地)。
46
+
5
47
  ## 0.1.0
6
48
 
7
49
  第一个可用版本:**第一人称体验条目库 + 双路即时召回**。
package/README.md CHANGED
@@ -78,6 +78,17 @@ spirit 只调用它的 `op` 面(`status` / `session` / `search`),**从不
78
78
  - **关掉就是零字节**:真机把“装了但 `enabled:false`”与“根本没装”两臂的请求体逐类配对比过,
79
79
  spirit 自身贡献 0 字节(无注入行、无人格区、`system` 完全相同);唯一的 40B 差异来自宿主
80
80
  自己列出的已安装插件清单(那是宿主行为,与插件启停无关)。
81
+ - **淡出是逐出注意力,不是删记忆**:存储侧依旧 append-only 一个字节不删;`fadeEnabled`
82
+ 开启后条目按 salience×注意力衰减分三态——原文(full)→一句话(gist)→不上卡(held)。
83
+ gist 只能编译期从固定表派生落库(运行时改写记忆=伪造);衰减权重与姊妹引擎同式
84
+ `0.5^(Δt/halfLife)` 且同地板 0.5:**时间单独永远至多让一条经历“变淡一半”**,
85
+ held 经“无残句可降/低 salience 档/阈值调高”三条路达成,不靠把记忆归零。
86
+ - **反馈两轴分离**:手打分(-1..5)只重排进卡优先序,**不回灌**衰减曲线与情绪派生——
87
+ 打分是“人觉得重不重要”,衰减是“客观变淡”,合并就变成自我强化回路。
88
+ - **未竟账只吃结构计数**:新会话开局那行“上次有口子没放下”只能来自 todo 快照的整数计数,
89
+ 计数真为 3 才说 3;dispose 与 turn/end 双触发,幂等由 id 在存储层收敛。
90
+ - **条件化不是控制面**:bias 只换卡上状态段的倾向半句(三档词),不碰 decision、不注钩子、
91
+ 不对外报数;验收用例钉“开/关两臂除 text 外全等”。
81
92
 
82
93
  ## 想验证它到底有没有用
83
94
 
@@ -107,17 +118,55 @@ npm run ab -- --home "$DSH_HOME" --json # 机读
107
118
 
108
119
  键名与默认值的唯一事实源是 [`src/contract.ts`](src/contract.ts)(部署面契约,不可更名)。
109
120
  常用项:`card.maxBytes`、`card.recentK`、`card.crossSessionM`、`recall.halfLifeMs`、`recall.timeoutMs`、
110
- `tier.stepCap`、`tier.staleAfterMs`、`journal.retentionDays`、`drsc.enabled`。
121
+ `recall.fadeEnabled`(淡出总闸,**缺省关**)、`recall.fadeHalfLifeMs`(窗口尺度,volatile 可热更)、
122
+ `recall.fadeFullMinScore`/`fadeGistMinScore`(千分位双阈值)、`recall.gistMinSalience`、
123
+ `recall.feedbackEnabled`、`ledger.enabled`/`maxAgeMs`(未竟账,缺省关)、
124
+ `bias.enabled`/`halfLifeMs`(条件化,缺省关)、`tier.stepCap`、`tier.staleAfterMs`、
125
+ `journal.retentionDays`、`drsc.enabled`。
111
126
  每项在 [`cordis.patch.yml`](cordis.patch.yml) 的注释里都有一行说明。
112
127
 
128
+ > ⚠ `fadeHalfLifeMs` 属 volatile 接管键:生效值永远来自 `live.fadeHalfLifeMs`,静态节同名的
129
+ > 那份只是缺省——改静态不改 live 不会生效(集成调参时真实踩过这个坑,测试里也踩穿过)。
130
+
113
131
  数据目录:`$DSH_HOME/spirit`(`spirit.db` / `persona.json` / `persona-history.jsonl` / `session-modes.json` / `archive/`)。
114
132
 
115
133
  热改路径:`live.*` 节标了 `.volatile()`,改 `cordis.patch.yml` 不重启即生效;会话级开关走输入栏 pill。
116
- (0.2.0-rc.2 的 web 壳子不渲染 volatile 自动表单,所以这些键不在设置页上。)
117
-
118
- ## 已知边界(v0.1)
119
-
120
- - 不做长期情绪检索、图谱、矛盾裁决、人设自动演化(那是记忆引擎与 soul 的地盘)
134
+ 淡出三键(`live.fadeEnabled`/`fadeHalfLifeMs`/`feedbackEnabled`)另走面板「淡出设置」行与 `settings-get/set` RPC(写 volatile ref;不可热更时面板如实标“需重启”)。
135
+ (0.2.0-rc.2 的 web 壳子不渲染 volatile 自动表单,所以这些键不在设置页上;面板的 `settings-*` RPC 腿不受此限。)
136
+
137
+ ## 遗忘怎么调:观察—pin—对照—定向—灰度(v0.2 淡出/未竟/条件化的调参 SOP)
138
+
139
+ 淡出参数没有“校准过的最优值”,只有“这台机器上观察出来的合适值”,所以给可执行的五步:
140
+
141
+ 1. **指标先行**:面板「淡出(原文/一句话/退场)」行读每会话累计的 full/gist/held 占比与发卡轮次;
142
+ 离线用 `npm run ab` 的「每轮发卡率」与「淡出代理」行归因。
143
+ 2. **基线可 pin**:`live.fadeHalfLifeMs=0` 冻结窗口(只按 salience 定档)与 `fadeEnabled=false`
144
+ 是两个对照臂——任何调参结论都要先跟 pin 臂比过才作数。
145
+ 3. **A/B 双跑**:旁路臂=淡出关,注入臂=淡出开;重点看每轮发卡率(跨档重发强度)与卡字节。
146
+ 4. **调整方向判据**(不凭观感,落证据):
147
+ - held 占比高且反馈高分多落在 held 项 → 半衰期调长或 gistMinSalience 下调;
148
+ - 每轮发卡率升高(档跳频繁)→ 量化档加宽(拉大 fadeHalfLifeMs 或降低 fadeGistMinScore);
149
+ - 卡长期只有状态段、近因段空 → 候选池/阈值过严,回调 fadeFullMinScore。
150
+ 5. **灰度序**:缺省关 → 单会话开 → 反馈闭环数据攒够两个周期再议翻默认。
151
+
152
+ 可调项封顶四类(半衰期/双阈值/gist 最低档/窗口条数走 card.recentK);`card.maxBytes` 与地板 0.5
153
+ 不在面板暴露——防止把窗口调到每轮跨档 churn,或把“淡出”调成“失忆”。
154
+
155
+ ## 与姊妹记忆引擎的 echo 链(v0.2 钉住的唯一活口)
156
+
157
+ 两仓正交靠三道既有守卫:注入署名 `plugin:spirit` 被对方 L0 入口过滤、双库互不读写、
158
+ grep 断言同装跑真回合。但对方证据面**原样收 assistant 发言**——模型若复述卡语,会沿
159
+ 复述→蒸馏→画像的路把体验洗成事实。这条链 spirit 单方面修不了(修它要动对方的提取面,
160
+ 而解耦闸禁止 spirit 出现对方包名字面量),交付的是两条压风险的纪律:
161
+ 卡语汇保持不可蒸馏语(档位词短句、不陈述因果,复述进事实层也无信息量),
162
+ `tests/echo-chain.test.ts` 把“语汇整段可识别”钉成 CI 断言,改版偷换文案会即红。
163
+
164
+ ## 已知边界(v0.2)
165
+
166
+ - 不做长期情绪检索的**语义层**(矛盾裁决、图谱、人设自动演化仍不在——淡出/gist 是注入侧形态,
167
+ 不是新的事实索引);条目库依旧不建 FTS5
168
+ - 淡出/未竟账/条件化三面**缺省全关**:实机最佳参数集尚未观察出来;开了的单会话数据只进
169
+ 派生表与卡文本,关闸后行为与 v0.1 逐字节一致(有回归用例钉住)
121
170
  - 中性轮默认不记(`salience.neutral = 0`),否则库会退化成逐轮流水账
122
171
  - 真机 web 冒烟已过(宿主 0.2.0-rc.2,隔离 `DSH_HOME`):宿主半装载、面板六端点(含 403/404/405 三面防线)、
123
172
  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 # 越此无新条目 ⇒ 退中性档
package/dist/client.js CHANGED
@@ -68,7 +68,20 @@ var __defProp = Object.defineProperty;
68
68
  "panel.exportJsonl": "导出为 JSONL",
69
69
  "panel.exported": "已导出",
70
70
  "panel.exportDry": "导出为干跑(未写文件)",
71
- "panel.exportFailed": "导出失败"
71
+ "panel.exportFailed": "导出失败",
72
+ "panel.fade": "淡出(原文/一句话/退场)",
73
+ "panel.churn": "发卡轮次",
74
+ "panel.markImportant": "这条重要",
75
+ "panel.unmark": "撤销标记",
76
+ "panel.marked": "已记:这条重要",
77
+ "panel.unmarked": "已撤销标记",
78
+ "panel.markFailed": "标记失败",
79
+ "panel.fadeSettings": "淡出设置",
80
+ "panel.fadeOn": "开启滑窗淡出",
81
+ "panel.fadeHalfLife": "窗口半衰期(分钟)",
82
+ "panel.settingsSaved": "已保存(热更生效)",
83
+ "panel.settingsCold": "宿主不支持热更,需重启生效",
84
+ "panel.settingsFailed": "保存设置失败"
72
85
  };
73
86
  var en = {
74
87
  "pill.labelOn": "Mood · on",
@@ -105,7 +118,20 @@ var __defProp = Object.defineProperty;
105
118
  "panel.exportJsonl": "Export as JSONL",
106
119
  "panel.exported": "Exported",
107
120
  "panel.exportDry": "Dry run (no file written)",
108
- "panel.exportFailed": "Export failed"
121
+ "panel.exportFailed": "Export failed",
122
+ "panel.fade": "fading (full/gist/held)",
123
+ "panel.churn": "card re-issues",
124
+ "panel.markImportant": "This mattered",
125
+ "panel.unmark": "Undo mark",
126
+ "panel.marked": "Marked: this mattered",
127
+ "panel.unmarked": "Mark removed",
128
+ "panel.markFailed": "Mark failed",
129
+ "panel.fadeSettings": "fading settings",
130
+ "panel.fadeOn": "Enable sliding-window fading",
131
+ "panel.fadeHalfLife": "window half-life (min)",
132
+ "panel.settingsSaved": "Saved (hot-applied)",
133
+ "panel.settingsCold": "Host has no hot-update channel; restart to apply",
134
+ "panel.settingsFailed": "Save failed"
109
135
  };
110
136
  function copyOf(lang) {
111
137
  return lang !== void 0 && lang.startsWith("en") ? en : zh;
@@ -131,6 +157,8 @@ var __defProp = Object.defineProperty;
131
157
  const copy = copyOf(typeof document === "undefined" ? void 0 : document.documentElement.lang);
132
158
  const [stats, setStats] = (0, import_react.useState)(null);
133
159
  const [page, setPage] = (0, import_react.useState)(null);
160
+ const [settings, setSettings] = (0, import_react.useState)(null);
161
+ const [halfLifeDraft, setHalfLifeDraft] = (0, import_react.useState)("");
134
162
  const [error, setError] = (0, import_react.useState)(null);
135
163
  const seqRef = (0, import_react.useRef)(0);
136
164
  const mountedRef = (0, import_react.useRef)(true);
@@ -148,6 +176,12 @@ var __defProp = Object.defineProperty;
148
176
  const tail = await rpc("journal-tail", target === "" ? {} : { sessionId: target, offset: 0, limit: 30 });
149
177
  if (token !== seqRef.current || !mountedRef.current) return;
150
178
  setPage(tail.ok ? tail.value : null);
179
+ const s = await rpc("settings-get", {});
180
+ if (token !== seqRef.current || !mountedRef.current) return;
181
+ if (s.ok) {
182
+ setSettings(s.value);
183
+ setHalfLifeDraft(String(Math.round(s.value.fadeHalfLifeMs / 6e4)));
184
+ }
151
185
  } catch (err) {
152
186
  if (token !== seqRef.current || !mountedRef.current) return;
153
187
  setError(err instanceof Error ? err.message : String(err));
@@ -185,6 +219,27 @@ var __defProp = Object.defineProperty;
185
219
  }).catch(() => setExportNote(copy["panel.exportFailed"]));
186
220
  };
187
221
  const items = page?.rows ?? [];
222
+ const doMark = (entryId, score) => {
223
+ if (rpc === void 0) return;
224
+ setExportNote(null);
225
+ void rpc("experience-feedback", { entryId, score }).then((result) => {
226
+ setExportNote(result.ok ? score > 0 ? copy["panel.marked"] : copy["panel.unmarked"] : `${copy["panel.markFailed"]}: ${result.error.message}`);
227
+ void load();
228
+ }).catch(() => setExportNote(copy["panel.markFailed"]));
229
+ };
230
+ const fade = stats?.fade;
231
+ const saveSettings = (patch) => {
232
+ if (rpc === void 0) return;
233
+ setExportNote(null);
234
+ void rpc("settings-set", patch).then((result) => {
235
+ if (!result.ok) {
236
+ setExportNote(`${copy["panel.settingsFailed"]}: ${result.error.message}`);
237
+ return;
238
+ }
239
+ setSettings(result.value);
240
+ setExportNote(result.value.hotUpdatable ? copy["panel.settingsSaved"] : copy["panel.settingsCold"]);
241
+ }).catch(() => setExportNote(copy["panel.settingsFailed"]));
242
+ };
188
243
  return (0, import_react.createElement)(
189
244
  "section",
190
245
  { style: { padding: "12px 16px" } },
@@ -207,7 +262,34 @@ var __defProp = Object.defineProperty;
207
262
  { style: mutedStyle },
208
263
  `${copy["panel.injected"]} ${stats.injectedTurns} → ${stats.confirmedTurns} · ${stats.lastRecallHits} · ${copy["panel.confirmedHint"]}`
209
264
  ),
210
- (0, import_react.createElement)("p", { style: mutedStyle }, `${copy["panel.drsc"]}:${copy[DRSC_VERDICT_KEYS[stats.drscVerdict]]}`)
265
+ (0, import_react.createElement)("p", { style: mutedStyle }, `${copy["panel.drsc"]}:${copy[DRSC_VERDICT_KEYS[stats.drscVerdict]]}`),
266
+ // 淡出指标行(调参 SOP 的读数腿):只在淡出真跑过时出现,关闸时不占行不编零
267
+ fade !== void 0 && fade.pool > 0 ? (0, import_react.createElement)("p", { style: mutedStyle }, `${copy["panel.fade"]}:${fade.full}/${fade.gist}/${fade.held}${fade.marked > 0 ? ` · ★${fade.marked}` : ""} · ${copy["panel.churn"]} ${fade.churn}`) : null,
268
+ // 面板可调腿(六腿的写腿):仅当 volatile 通道可读时出现
269
+ settings === null ? null : (0, import_react.createElement)(
270
+ "div",
271
+ { style: { display: "flex", flexWrap: "wrap", gap: 10, alignItems: "center", marginTop: 6 } },
272
+ (0, import_react.createElement)("span", { style: mutedStyle }, copy["panel.fadeSettings"]),
273
+ (0, import_react.createElement)(
274
+ "label",
275
+ { style: { display: "inline-flex", gap: 4, alignItems: "center", fontSize: 12 } },
276
+ (0, import_react.createElement)("input", { type: "checkbox", checked: settings.fadeEnabled, onChange: (e) => saveSettings({ fadeEnabled: e.target.checked }) }),
277
+ copy["panel.fadeOn"]
278
+ ),
279
+ (0, import_react.createElement)("span", { style: mutedStyle }, copy["panel.fadeHalfLife"]),
280
+ (0, import_react.createElement)("input", {
281
+ type: "number",
282
+ min: 0,
283
+ value: halfLifeDraft,
284
+ style: { width: 72 },
285
+ onChange: (e) => setHalfLifeDraft(e.target.value),
286
+ onBlur: () => {
287
+ const minutes = Number.parseFloat(halfLifeDraft);
288
+ if (Number.isFinite(minutes) && Math.round(minutes * 6e4) !== settings.fadeHalfLifeMs) saveSettings({ fadeHalfLifeMs: Math.max(0, Math.round(minutes * 6e4)) });
289
+ }
290
+ }),
291
+ settings.hotUpdatable ? null : (0, import_react.createElement)("span", { style: mutedStyle }, copy["panel.settingsCold"])
292
+ )
211
293
  ),
212
294
  items.length === 0 ? null : (0, import_react.createElement)(
213
295
  "div",
@@ -225,6 +307,12 @@ var __defProp = Object.defineProperty;
225
307
  "div",
226
308
  { style: mutedStyle },
227
309
  `${copy["panel.turn"]} ${item.turnSeq} · ${copy["panel.lane"]} ${item.lane === "drsc" ? copy["panel.laneDrsc"] : copy["panel.laneLive"]}`
310
+ ),
311
+ // 反馈只影响“先进哪条”;已打分的行给撤销入口(显式)
312
+ (0, import_react.createElement)(
313
+ "div",
314
+ { style: { display: "flex", gap: 8, marginTop: 4 } },
315
+ typeof item.feedbackScore === "number" && item.feedbackScore > 0 ? (0, import_react.createElement)("button", { type: "button", style: mutedStyle, onClick: () => doMark(item.id, -1) }, copy["panel.unmark"]) : (0, import_react.createElement)("button", { type: "button", style: mutedStyle, onClick: () => doMark(item.id, 5) }, copy["panel.markImportant"])
228
316
  )
229
317
  )
230
318
  )
package/dist/config.d.ts CHANGED
@@ -8,6 +8,8 @@ import { type SpiritConfig, type SpiritLiveSettings } from './contract.js';
8
8
  */
9
9
  export interface VolatileRef<T> {
10
10
  get(): T;
11
+ /** 宿主 volatile 写通道(schemastery 支持时存在):settings-set 腿用它热更;缺席 ⇒ 面板如实报“需重启”。 */
12
+ update?(patch: Partial<T>): unknown;
11
13
  }
12
14
  /** 显式标注导出面形状,避免 d.ts 里出现不可命名的 schemastery/cosmokit 内部类型。 */
13
15
  export type ConfigSchema = ((value: unknown) => SpiritConfig) & Record<string, unknown>;
package/dist/config.js CHANGED
@@ -43,6 +43,9 @@ function liveSettingsSchema() {
43
43
  drscEnabled: bool(d.drscEnabled),
44
44
  recallMaxResults: num('recall.maxResults', d.recallMaxResults),
45
45
  retentionDays: num('journal.retentionDays', d.retentionDays),
46
+ fadeEnabled: bool(d.fadeEnabled),
47
+ fadeHalfLifeMs: num('recall.fadeHalfLifeMs', d.fadeHalfLifeMs),
48
+ feedbackEnabled: bool(d.feedbackEnabled),
46
49
  });
47
50
  const maybe = node;
48
51
  return (typeof maybe.volatile === 'function' ? maybe.volatile() : node);
@@ -64,6 +67,20 @@ export const spiritSchema = Schema.object({
64
67
  maxResults: num('recall.maxResults', SPIRIT_DEFAULTS.recall.maxResults),
65
68
  maxCharsPerEntry: num('recall.maxCharsPerEntry', SPIRIT_DEFAULTS.recall.maxCharsPerEntry),
66
69
  halfLifeMs: num('recall.halfLifeMs', SPIRIT_DEFAULTS.recall.halfLifeMs),
70
+ fadeEnabled: bool(SPIRIT_DEFAULTS.recall.fadeEnabled),
71
+ fadeHalfLifeMs: num('recall.fadeHalfLifeMs', SPIRIT_DEFAULTS.recall.fadeHalfLifeMs),
72
+ fadeFullMinScore: num('recall.fadeFullMinScore', SPIRIT_DEFAULTS.recall.fadeFullMinScore),
73
+ fadeGistMinScore: num('recall.fadeGistMinScore', SPIRIT_DEFAULTS.recall.fadeGistMinScore),
74
+ gistMinSalience: num('recall.gistMinSalience', SPIRIT_DEFAULTS.recall.gistMinSalience),
75
+ feedbackEnabled: bool(SPIRIT_DEFAULTS.recall.feedbackEnabled),
76
+ }),
77
+ ledger: Schema.object({
78
+ enabled: bool(SPIRIT_DEFAULTS.ledger.enabled),
79
+ maxAgeMs: num('ledger.maxAgeMs', SPIRIT_DEFAULTS.ledger.maxAgeMs),
80
+ }),
81
+ bias: Schema.object({
82
+ enabled: bool(SPIRIT_DEFAULTS.bias.enabled),
83
+ halfLifeMs: num('bias.halfLifeMs', SPIRIT_DEFAULTS.bias.halfLifeMs),
67
84
  }),
68
85
  tier: Schema.object({
69
86
  stepCap: num('tier.stepCap', SPIRIT_DEFAULTS.tier.stepCap),
@@ -103,6 +120,16 @@ export const SCHEMA_FIELD_KEYS = [
103
120
  'recall.maxResults',
104
121
  'recall.maxCharsPerEntry',
105
122
  'recall.halfLifeMs',
123
+ 'recall.fadeEnabled',
124
+ 'recall.fadeHalfLifeMs',
125
+ 'recall.fadeFullMinScore',
126
+ 'recall.fadeGistMinScore',
127
+ 'recall.gistMinSalience',
128
+ 'recall.feedbackEnabled',
129
+ 'ledger.enabled',
130
+ 'ledger.maxAgeMs',
131
+ 'bias.enabled',
132
+ 'bias.halfLifeMs',
106
133
  'tier.stepCap',
107
134
  'tier.staleAfterMs',
108
135
  'journal.retentionDays',
@@ -128,6 +155,9 @@ export const SCHEMA_FIELD_KEYS = [
128
155
  'live.drscEnabled',
129
156
  'live.recallMaxResults',
130
157
  'live.retentionDays',
158
+ 'live.fadeEnabled',
159
+ 'live.fadeHalfLifeMs',
160
+ 'live.feedbackEnabled',
131
161
  ];
132
162
  /** 数值键区间表覆盖检查用的键集(`num()` 引用的键必须都在 SPIRIT_RANGES 里)。 */
133
163
  export const RANGE_KEYS = Object.keys(SPIRIT_RANGES);
@@ -175,6 +205,9 @@ export function resolveLive(raw) {
175
205
  drscEnabled: flag('drscEnabled', d.drscEnabled),
176
206
  recallMaxResults: int('recallMaxResults', d.recallMaxResults),
177
207
  retentionDays: int('retentionDays', d.retentionDays),
208
+ fadeEnabled: flag('fadeEnabled', d.fadeEnabled),
209
+ fadeHalfLifeMs: int('fadeHalfLifeMs', d.fadeHalfLifeMs),
210
+ feedbackEnabled: flag('feedbackEnabled', d.feedbackEnabled),
178
211
  };
179
212
  }
180
213
  export function resolveDataDir(cfg) {
@@ -200,7 +233,18 @@ export function effectiveCfg(cfg, live) {
200
233
  crossSessionM: live.crossSessionM,
201
234
  },
202
235
  drsc: { ...cfg.drsc, enabled: cfg.drsc.enabled && live.drscEnabled },
203
- recall: { ...cfg.recall, timeoutMs: live.recallTimeoutMs, halfLifeMs: live.halfLifeMs, maxResults: live.recallMaxResults },
236
+ recall: {
237
+ ...cfg.recall,
238
+ timeoutMs: live.recallTimeoutMs,
239
+ halfLifeMs: live.halfLifeMs,
240
+ maxResults: live.recallMaxResults,
241
+ // 淡出开关与窗口尺度走 volatile(面板六腿);阈值属部署面,不热更。
242
+ fadeEnabled: cfg.recall.fadeEnabled && live.fadeEnabled,
243
+ fadeHalfLifeMs: live.fadeHalfLifeMs,
244
+ feedbackEnabled: cfg.recall.feedbackEnabled && live.feedbackEnabled,
245
+ },
246
+ ledger: { ...cfg.ledger, enabled: cfg.ledger.enabled && live.fadeEnabled },
247
+ bias: { ...cfg.bias, enabled: cfg.bias.enabled && live.fadeEnabled },
204
248
  tier: { ...cfg.tier, stepCap: live.tierStepCap, staleAfterMs: live.staleAfterMs },
205
249
  journal: { ...cfg.journal, retentionDays: live.retentionDays },
206
250
  live,
@@ -41,7 +41,7 @@ export declare const SPIRIT_RPC_PREFIX = "dsh-spirit/";
41
41
  export declare const SPIRIT_RPC_ROUTE: string;
42
42
  /** 工具名前缀(同栈工具重名即 throw)。 */
43
43
  export declare const SPIRIT_TOOL_PREFIX = "spirit_";
44
- export declare const SPIRIT_OPS: readonly ["session-stats", "journal-tail", "journal-export", "persona-get", "session-mode", "session-mode-get"];
44
+ export declare const SPIRIT_OPS: readonly ["session-stats", "journal-tail", "journal-export", "persona-get", "session-mode", "session-mode-get", "experience-feedback", "settings-get", "settings-set"];
45
45
  export type SpiritOp = (typeof SPIRIT_OPS)[number];
46
46
  export declare function rpcPath(op: SpiritOp): string;
47
47
  /**
@@ -78,6 +78,25 @@ export interface SpiritExportRequest {
78
78
  dirName?: string;
79
79
  dryRun?: boolean;
80
80
  }
81
+ export interface SpiritFeedbackRequest {
82
+ /** 条目 id(journal-tail 回给的)。 */
83
+ entryId: string;
84
+ /** -1..5(对齐 prime 反馈域);-1 = 显式撤销(必须显式动作,不是默认值)。 */
85
+ score: number;
86
+ }
87
+ /** 面板可调的 volatile 键(六腿的写腿;只收这三键,其余属部署面)。 */
88
+ export interface SpiritSettingsRequest {
89
+ fadeEnabled?: boolean;
90
+ fadeHalfLifeMs?: number;
91
+ feedbackEnabled?: boolean;
92
+ }
93
+ export interface SpiritSettingsView {
94
+ fadeEnabled: boolean;
95
+ fadeHalfLifeMs: number;
96
+ feedbackEnabled: boolean;
97
+ /** 热更通道是否真能落盘(宿主 volatile 不可写时为 false,面板要如实标重启生效)。 */
98
+ hotUpdatable: boolean;
99
+ }
81
100
  /** 端点 → 请求/响应类型的查表(两端共享的契约单一事实源)。 */
82
101
  export interface SpiritRequestMap {
83
102
  'session-stats': {
@@ -90,6 +109,9 @@ export interface SpiritRequestMap {
90
109
  'session-mode-get': {
91
110
  sessionId: string;
92
111
  };
112
+ 'experience-feedback': SpiritFeedbackRequest;
113
+ 'settings-get': Record<string, never>;
114
+ 'settings-set': SpiritSettingsRequest;
93
115
  }
94
116
  export interface SpiritResponseMap {
95
117
  'session-stats': SpiritSessionStats;
@@ -98,6 +120,13 @@ export interface SpiritResponseMap {
98
120
  'persona-get': SpiritPersonaView;
99
121
  'session-mode': SpiritSessionModeResult;
100
122
  'session-mode-get': SpiritSessionModeResult;
123
+ 'experience-feedback': {
124
+ entryId: string;
125
+ score: number;
126
+ ok: boolean;
127
+ };
128
+ 'settings-get': SpiritSettingsView;
129
+ 'settings-set': SpiritSettingsView;
101
130
  }
102
131
  /** 端点字面量类型(client 与 host 白名单共用)。 */
103
132
  export type SpiritEndpoint = keyof SpiritRequestMap & string;
@@ -141,6 +170,18 @@ export interface SpiritSessionStats {
141
170
  off: boolean;
142
171
  bypass: boolean;
143
172
  };
173
+ /**
174
+ * v0.2 淡出计数族(调参 SOP 的指标腿;累计整数,未启用淡出时全 0/缺省):
175
+ * full/gist/held = 历轮形态分布累加;pool = 候选池累加;churn = 发卡轮次(重发强度代理)。
176
+ */
177
+ fade?: {
178
+ full: number;
179
+ gist: number;
180
+ held: number;
181
+ marked: number;
182
+ pool: number;
183
+ churn: number;
184
+ };
144
185
  }
145
186
  /** 手记分页视图(读库投影;库是真源,不是文档)。 */
146
187
  export interface SpiritJournalPage {
@@ -156,6 +197,12 @@ export interface SpiritJournalPage {
156
197
  text: string;
157
198
  lane: string;
158
199
  sourceRef: string | null;
200
+ /** v0.2:一句话压缩残句(旧行/缺格 = null)。 */
201
+ gist: string | null;
202
+ /** v0.2:人格在意度 0..2(v1 旧行 = null,不假装知道旧权重)。 */
203
+ salience: number | null;
204
+ /** v0.2:人工反馈 -1..5(未打分 = null,保持原序)。 */
205
+ feedbackScore: number | null;
159
206
  }>;
160
207
  total: number;
161
208
  offset: number;
@@ -211,6 +258,37 @@ export interface SpiritConfig {
211
258
  maxCharsPerEntry: number;
212
259
  /** 条目近因半衰期(ms)。 */
213
260
  halfLifeMs: number;
261
+ /**
262
+ * 滑窗淡出总闸(v0.2 新能力,缺省**关**:关=注入行为与 v0.1 逐字节一致,灰度闸)。
263
+ * 开=条目按 salience×注意力衰减分档:full 原文 / gist 一句话 / held 不上卡。
264
+ */
265
+ fadeEnabled: boolean;
266
+ /**
267
+ * 注意力衰减半衰期(ms)——淡出档位的 Δt 尺度,与 `halfLifeMs`(排序用)解耦。
268
+ * 缺省取情绪尺度(小时,见 decay.ts 注:与 prime 记忆面的“天”同式不同尺);
269
+ * 面板可调(调参 SOP 见 README:held 占比过高→拉长;重发率升高→加宽量化档)。
270
+ */
271
+ fadeHalfLifeMs: number;
272
+ /** full 档分数地板(**千分位**整数,550=0.55;m = (salience/2)×注意力衰减;反馈只重排不回灌 m)。 */
273
+ fadeFullMinScore: number;
274
+ /** gist 档分数地板(千分位,250=0.25;低于 gist 地板 ⇒ held 不上卡)。 */
275
+ fadeGistMinScore: number;
276
+ /** gist 档的最低 salience(弱条目不派生 gist,直接 held,宁缺毋造)。 */
277
+ gistMinSalience: number;
278
+ /** 人工反馈重排总闸(移植 prime recall-usage:-1..5 手打只重排,**不回灌派生分**)。 */
279
+ feedbackEnabled: boolean;
280
+ };
281
+ /** 未竟账(v0.2):会话收尾的结构计数,新会话开局带出一行;缺省关(灰度)。 */
282
+ ledger: {
283
+ enabled: boolean;
284
+ /** 账行过期后不再带出(ms)。0 = 永不过期(配合有顶 GC,默认给顶)。 */
285
+ maxAgeMs: number;
286
+ };
287
+ /** 条件化 bias(v0.2):强负体验给同类动作短期抑制(三档词);缺省关(灰度)。 */
288
+ bias: {
289
+ enabled: boolean;
290
+ /** bias 半衰期(ms):派生缓存表的过期尺度。 */
291
+ halfLifeMs: number;
214
292
  };
215
293
  tier: {
216
294
  /** 单轮最多跨几格(防人格抽动)。 */
@@ -268,15 +346,29 @@ export interface SpiritLiveSettings {
268
346
  recallMaxResults: number;
269
347
  /** 保留天数(同样补进 volatile;0 = 永久)。 */
270
348
  retentionDays: number;
349
+ /** 淡出开关与窗口尺度热更(面板六腿的 volatile 腿;阈值属部署面,不热更)。 */
350
+ fadeEnabled: boolean;
351
+ fadeHalfLifeMs: number;
352
+ /** 人工反馈重排热更(只重排不回灌;闸关=卡片序与闸开前一致)。 */
353
+ feedbackEnabled: boolean;
271
354
  }
272
355
  export declare const SPIRIT_DEFAULTS: SpiritConfig;
273
356
  /** 配置数值键的合法区间(schema 与写入门共用,勿在别处再抄)。 */
274
357
  export declare const SPIRIT_RANGES: Record<string, readonly [number, number]>;
275
- /** SQLite schema 版本;跨版本打开明确拒绝,不静默改库。 */
276
- export declare const SPIRIT_DB_SCHEMA_VERSION = 1;
358
+ /** 单轮淡出形态分布(stats/ab 的计数原料;都是整数计数,无对外数值语义)。 */
359
+ export interface FadeStats {
360
+ full: number;
361
+ gist: number;
362
+ held: number;
363
+ pool: number;
364
+ /** 候选池里被人标过“重要”(feedback>0)的条数——反馈分布的累计面。 */
365
+ marked: number;
366
+ }
367
+ /** SQLite schema 版本;跨版本打开明确拒绝,不静默改库(v1→v2 提供正向迁移)。 */
368
+ export declare const SPIRIT_DB_SCHEMA_VERSION = 2;
277
369
  /** `persona.json` 文件形状版本。 */
278
370
  export declare const SPIRIT_PERSONA_FILE_VERSION = 1;
279
371
  /** `session-modes.json` 文件形状版本。 */
280
372
  export declare const SPIRIT_MODES_FILE_VERSION = 1;
281
373
  /** 插件版本(与 package.json / dsh.plugin.json 同串,由门禁核对)。 */
282
- export declare const SPIRIT_VERSION = "0.1.1";
374
+ export declare const SPIRIT_VERSION = "0.2.0";
package/dist/contract.js CHANGED
@@ -49,6 +49,9 @@ export const SPIRIT_OPS = [
49
49
  'persona-get',
50
50
  'session-mode',
51
51
  'session-mode-get',
52
+ 'experience-feedback',
53
+ 'settings-get',
54
+ 'settings-set',
52
55
  ];
53
56
  export function rpcPath(op) {
54
57
  return `${SPIRIT_RPC_PREFIX}${op}`;
@@ -77,7 +80,20 @@ export const SPIRIT_DEFAULTS = {
77
80
  dataDir: '',
78
81
  persona: { enabled: true, budgetBytes: 700 },
79
82
  card: { maxBytes: 512, recentK: 2, crossSessionM: 4 },
80
- recall: { timeoutMs: 800, maxResults: SPIRIT_DEFAULTS_RECALL_MAX, maxCharsPerEntry: 120, halfLifeMs: 5_400_000 },
83
+ recall: {
84
+ timeoutMs: 800,
85
+ maxResults: SPIRIT_DEFAULTS_RECALL_MAX,
86
+ maxCharsPerEntry: 120,
87
+ halfLifeMs: 5_400_000,
88
+ fadeEnabled: false,
89
+ fadeHalfLifeMs: 5_400_000,
90
+ fadeFullMinScore: 550,
91
+ fadeGistMinScore: 250,
92
+ gistMinSalience: 1,
93
+ feedbackEnabled: true,
94
+ },
95
+ ledger: { enabled: false, maxAgeMs: 604_800_000 },
96
+ bias: { enabled: false, halfLifeMs: 5_400_000 },
81
97
  tier: { stepCap: 1, staleAfterMs: 600_000 },
82
98
  journal: { retentionDays: SPIRIT_DEFAULTS_RETENTION_DAYS, dryRun: true },
83
99
  capture: { userSnippet: false, maxQuoteChars: 160, gapThresholdMs: 180_000 },
@@ -97,6 +113,9 @@ export const SPIRIT_DEFAULTS = {
97
113
  drscEnabled: true,
98
114
  recallMaxResults: SPIRIT_DEFAULTS_RECALL_MAX,
99
115
  retentionDays: SPIRIT_DEFAULTS_RETENTION_DAYS,
116
+ fadeEnabled: false,
117
+ fadeHalfLifeMs: 5_400_000,
118
+ feedbackEnabled: true,
100
119
  },
101
120
  };
102
121
  /** 配置数值键的合法区间(schema 与写入门共用,勿在别处再抄)。 */
@@ -109,6 +128,10 @@ export const SPIRIT_RANGES = {
109
128
  'recall.maxResults': [1, 12],
110
129
  'recall.maxCharsPerEntry': [40, 400],
111
130
  'recall.halfLifeMs': [0, 604_800_000],
131
+ 'recall.fadeHalfLifeMs': [0, 2_592_000_000],
132
+ 'recall.fadeFullMinScore': [0, 1_000],
133
+ 'recall.fadeGistMinScore': [0, 1_000],
134
+ 'recall.gistMinSalience': [0, 2],
112
135
  'tier.stepCap': [1, 2],
113
136
  'tier.staleAfterMs': [0, 86_400_000],
114
137
  'journal.retentionDays': [0, 3_650],
@@ -116,13 +139,15 @@ export const SPIRIT_RANGES = {
116
139
  'capture.gapThresholdMs': [10_000, 3_600_000],
117
140
  'drsc.probeCacheTtlMs': [1_000, 600_000],
118
141
  'drsc.timeoutMs': [200, 20_000],
142
+ 'ledger.maxAgeMs': [0, 2_592_000_000],
143
+ 'bias.halfLifeMs': [0, 604_800_000],
119
144
  };
120
145
  // ─────────────────────────────────────────────────────────── 版本与文件
121
- /** SQLite schema 版本;跨版本打开明确拒绝,不静默改库。 */
122
- export const SPIRIT_DB_SCHEMA_VERSION = 1;
146
+ /** SQLite schema 版本;跨版本打开明确拒绝,不静默改库(v1→v2 提供正向迁移)。 */
147
+ export const SPIRIT_DB_SCHEMA_VERSION = 2;
123
148
  /** `persona.json` 文件形状版本。 */
124
149
  export const SPIRIT_PERSONA_FILE_VERSION = 1;
125
150
  /** `session-modes.json` 文件形状版本。 */
126
151
  export const SPIRIT_MODES_FILE_VERSION = 1;
127
152
  /** 插件版本(与 package.json / dsh.plugin.json 同串,由门禁核对)。 */
128
- export const SPIRIT_VERSION = '0.1.1';
153
+ export const SPIRIT_VERSION = '0.2.0';