@restregular/dsh-memory 0.5.5 → 0.6.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.
package/README.md CHANGED
@@ -7,6 +7,16 @@ DeepSeek Harness 的本地长期记忆插件 —— **一个包、一条 Loader
7
7
 
8
8
  English: Local, durable memory for DeepSeek Harness — one npm package, one loader entry: a JSONL store, local vector recall through llama-server, four model-facing tools, automatic recall injection, and a management panel in the settings page.
9
9
 
10
+ ## 预览 / Preview
11
+
12
+ 设置页 →「记忆」:顶部统计(记忆数 / 作用域数 / 待嵌入向量)、向量服务(运行状态、本机配置、当前模型)、维护(卸载向量服务 / 清空记忆数据)、记录列表(搜索 + 作用域筛选 + 按 scope / 类型 / 时间展开)。
13
+
14
+ ![设置页「记忆」面板](./preview/memory-panel.png)
15
+
16
+ 模型在对话里查记忆 —— `memory_search` 的入参与召回结果:
17
+
18
+ ![memory_search 工具调用](./preview/memory-search.png)
19
+
10
20
  ## 它给你什么
11
21
 
12
22
  | 能力 | 说明 |
@@ -15,8 +25,12 @@ English: Local, durable memory for DeepSeek Harness — one npm package, one loa
15
25
  | **作用域** | 默认写进**当前会话**;读默认合并「会话 + 项目 + global」。也能写 `global`、当前项目,或任意自定义名(首次写入自动建) |
16
26
  | **双通道检索** | 词法(IDF + CJK bigram)**+** 向量(llama-server 的 `/v1/embeddings`)。向量缺席时自动降级为纯词法,**不报错、不阻塞** |
17
27
  | **自动召回** | `agent/pre-step` 注入相关记忆(可关、有 token 预算、按 topK 截断,范围同为会话+项目+global) |
28
+ | **印象形态** | 每轮只给每条记忆的短摘要;模型判断相关但需要细节时再 `memory_search` 取全文(可在面板关掉,退回长文召回) |
29
+ | **会话摘要** | 会话第一步注入一次「已有记忆」概览:项目 + global 按**重要度 × 新鲜度**挑几条,省得模型从头摸索 |
30
+ | **记忆使用策略** | 系统提示常驻段:什么时候该查记忆、查到怎么复用、查不到时低风险推断 / 高风险先问用户 |
31
+ | **硬性规则** | `kind: rule` 的记忆进系统提示常驻段(限量、可关)。能机械校验的规则应该做成钩子,提示词只做解释 |
18
32
  | **四个工具** | `memory_save` / `memory_search` / `memory_list` / `memory_forget` |
19
- | **管理面板** | 设置页「记忆」:浏览 / 搜索 / 编辑 / 删除、向量服务启停、模型与硬件、维护(卸载 / 清空) |
33
+ | **管理面板** | 设置页「记忆」:记录(浏览 / 搜索 / 新建 / 编辑 / 删除)+ 设置(召回、摘要、印象、策略、规则、轮末提醒逐项开关、导入导出)、向量服务启停、模型与硬件、维护(卸载 / 清空) |
20
34
  | **向量后端一键装** | 面板里选模型 → 下 llama.cpp 运行时 + 模型 → 托管 `llama-server` 进程;内置 8 个模型 + 硬件推荐 + 自定义 GGUF |
21
35
 
22
36
  ## 安装 / Install
@@ -78,13 +92,14 @@ memory_save({
78
92
  **2. 检索**:`memory_search({ query: "pnpm 装依赖", topK: 5 })` —— 省略 `scope` = 会话 + 项目 + global 合并(按来源标注、按 id 去重);`scope: "all"` 查所有作用域;写具体名字则只查那一个。
79
93
  **3. 列出 / 忘记**:`memory_list({ limit: 20 })`(默认只列当前会话,末尾附作用域清单 + 记录数)、`memory_forget({ id })` 或 `memory_forget({ query, scope })`(按内容删默认**只作用于当前会话**,防止跨作用域误删)。
80
94
 
81
- **4. 打开面板**:设置页 →「记忆」。面板里能做的事:
95
+ **4. 打开面板**:设置页 →「记忆」。面板分两个标签:
96
+
97
+ - **记录**:顶部统计(记忆数 / 作用域数 / 待嵌入向量数)、**新建**(任意作用域 + 类型,类型里含 `rule`)、记录列表(搜索、按作用域筛选、展开编辑、删除);作用域下拉**动态枚举实际存在的作用域**(`global` 显示「全局」、project 显示 cwd、会话 scope 显示会话标题、自定义 scope 显示原名);「向量服务」:状态、地址、启停开关、**模型与硬件**(见下)、维护(卸载向量服务 / 清空记忆数据,两步确认)
98
+ - **设置**:注入链路逐项开关 —— 每轮召回(topK / 预算)、印象形态(每条字数)、会话摘要(条数 / 预算)、记忆使用策略段、硬性规则段(条数 / 预算,并显示当前规则条数)、轮末提醒;底部「数据」:导出全部 / 导入文件。改完立即生效,不需要重启
82
99
 
83
- - 顶部统计(记忆数 / 作用域数 / 待嵌入向量数)与记录列表(搜索、按作用域筛选、展开编辑、删除)
84
- - 作用域下拉**动态枚举实际存在的作用域**:`global` 显示「全局」、project 显示 cwd、会话 scope 显示会话标题(拿不到就显示「会话 <id 前 8 位>」)、自定义 scope 显示原名
85
- - 「向量服务」:状态、地址、启停开关、**模型与硬件**(见下)、维护(卸载向量服务 / 清空记忆数据,两步确认)
100
+ > **导入 / 导出**:导出的是纯文本 —— 作用域、类型、内容、标签、重要度、时间戳,**没有向量**。导入时逐条走保存路径,按**当前模型重新嵌入**,并按「作用域 + 内容」去重(重复的计入「跳过」)。一次最多 5000 条。
86
101
 
87
- 面板后端在 `/memory/api`,全部路由:`GET /status`、`GET /records`、`POST /update`、`POST /delete`、`GET /embed/status`、`POST /embed/start|stop`、`GET /embed/model`、`POST /embed/model/refresh|install|install/cancel|uninstall`、`POST /data/wipe`。
102
+ 面板后端在 `/memory/api`,全部路由:`GET /status`、`GET /records`、`POST /create`、`POST /update`、`POST /delete`、`GET /settings`、`POST /settings`、`GET /export`、`POST /import`、`GET /embed/status`、`POST /embed/start|stop`、`GET /embed/model`、`POST /embed/model/refresh|install|install/cancel|uninstall`、`POST /data/wipe`。
88
103
 
89
104
  ## 数据与文件布局
90
105
 
@@ -93,6 +108,7 @@ memory_save({
93
108
  | `<storeDir>/global.jsonl` | global 作用域的记忆,一行一条 |
94
109
  | `<storeDir>/projects/<sha1(scope)>.jsonl` | 其它作用域(会话 / 项目 / 自定义)各一个文件;文件名是 scope 键的 SHA-1,所以名字里带路径分隔符也不可能穿越 |
95
110
  | `<storeDir>/projects/<sha1(scope)>.vec` | 向量边车。首行是身份头 `#<model>\t<dims>`,后面每行 `id\t<base64 向量>` |
111
+ | `<storeDir>/settings.json` | 面板「设置」里改过的注入开关(配置里的值是默认值,这里覆盖它) |
96
112
  | `<installRoot>/llamacpp/` | llama-server 运行时(exe + 依赖 dll + `llama-server.log`) |
97
113
  | `<installRoot>/models/` | 下载的 GGUF 模型 |
98
114
  | `<installRoot>/selected-model.json` | 面板里选过哪一档(比配置优先级低) |
@@ -141,7 +157,16 @@ provider 的配置在顶层,工具 / 注入 / 面板各占一个小节(合并前
141
157
  limits: { maxRecordsPerScope: 2000, maxRecordChars: 4000 }
142
158
  secrets: { enabled: true, mode: refuse }
143
159
  tools: { defaultScope: session } # session(新默认)/ project / global;projectScope 默认 project:<会话 cwd>
144
- inject: { enabled: true, tokenBudget: 500, topK: 5 } # 可加 extraScopes: ['handbook']
160
+ inject:
161
+ enabled: true # 整个注入半边(含下面的段)的总开关
162
+ extraScopes: ['handbook'] # 可选:额外参与召回的 scope
163
+ # 以下都可以在面板「记忆 → 设置」里改(立即生效);这里是默认值
164
+ recall: { enabled: true, topK: 5, tokenBudget: 500 }
165
+ impression: { enabled: true, chars: 120 } # 每条只给摘要,细节再 memory_search
166
+ digest: { enabled: true, topK: 8, tokenBudget: 400 } # 会话第一步的概览
167
+ policy: { enabled: true } # 系统提示:记忆使用策略
168
+ rules: { enabled: true, maxItems: 10, tokenBudget: 300 } # 系统提示:kind=rule
169
+ turnEnd: { enabled: false } # 轮末提醒(下一轮开头提示落盘)
145
170
  panel: { route: '/memory/api' }
146
171
  ```
147
172
 
@@ -150,6 +175,9 @@ provider 的配置在顶层,工具 / 注入 / 面板各占一个小节(合并前
150
175
  - **读与写的默认是一致的**:写进会话的东西,`memory_search` 默认就能读回来(合并会话 + 项目 + global,按 id 去重,同分时 session > project > 自定义 > global)。想只看某一个就显式给 `scope`。
151
176
  - 旧配置(只有 `scopes: { global: true, project: true }`、`tools.defaultScope: project`)照常工作 —— 不写新字段就是新默认值(`session: true`、`custom: { enabled: true, max: 200 }`),想保持 0.4.x 的老行为就显式写 `tools.defaultScope: project`。
152
177
 
178
+ - **注入分四层**:`recall`(每轮按问题检索)、`digest`(会话第一步给概览)、`policy`(系统提示常驻的使用策略)、`rules`(系统提示常驻的 `kind=rule` 规则),外加 `turnEnd`(轮末提醒,默认关)。每层独立开关,`inject.enabled: false` 全关。面板改过的值写在 `<storeDir>/settings.json`,**优先级高于这里的配置**。
179
+ - **写规则**:`memory_save({ kind: 'rule', content: '改 lib 必须同时改 source' })`。规则会进系统提示常驻段;能机械校验的规则更适合做成钩子,提示词只负责解释。
180
+
153
181
  向量检索是**按配置启用**的:写了 `endpoint`、配了 `spawn`、或面板里装了本地后端才会碰网络,否则一个请求都不发,检索自动降级为纯词法(IDF + CJK bigram)。不需要自动召回就 `inject.enabled: false`。
154
182
 
155
183
  `spawn.enabled: true` 时:应用启动后台拉起向量服务、退出时自动关闭;带 PID 文件的遗留实例会被接管,没有 PID 文件的外部实例不接管。
@@ -280,6 +308,17 @@ tools/build-single-package.mjs 构建(产物契约检查 + 可选加载验证)
280
308
 
281
309
  ## 版本
282
310
 
311
+ - **0.6.0** —— 注入分层,面板加「设置」标签页:
312
+ - **印象形态召回**:每轮召回默认只给每条记忆的开头(默认 120 字)+「需要细节用 memory_search」的指引,不再一次灌 300 字全文;面板可关掉退回长文。
313
+ - **会话摘要**:会话第一步注入一次概览 —— 项目 + global 按「新鲜度(30 天半衰期)× 重要度」挑 8 条,同分时会话 > 项目 > 自定义 > 全局。
314
+ - **记忆使用策略**:系统提示常驻段,写清什么时候该查、查到怎么复用、查不到时低风险推断 / 高风险先问用户、什么时候该写。
315
+ - **硬性规则**:新增记忆类型 `rule`,`kind=rule` 的记忆进系统提示常驻段(限量 10 条 / 300 token);能机械校验的规则建议做成钩子。
316
+ - **轮末提醒**:可选(默认关),本轮跑过多步时,下一轮开头提醒「若产生了可复用结论先 memory_save」。
317
+ - **面板设置页**:以上逐项开关 + 数值(条数 / 预算 / 每条字数),保存即生效;落盘 `<storeDir>/settings.json`。
318
+ - **新建记忆 / 规则**:记录页「新建」,作用域可选现有作用域或直接填 `project:<路径>` / `session:<id>` / 自定义名,类型含 `rule`。
319
+ - **导入 / 导出**:导出纯文本 JSON(不含向量),导入时按当前模型重新嵌入,按「作用域 + 内容」去重,单次上限 5000 条。
320
+ - 摘要 / 召回 / 提醒合并成**同一条** `source.kind='memory'` 消息,不再一步两张卡片;注入按内容幂等,重复激活也不会出现两份。
321
+ - **0.5.6** —— **`project:` 作用域此前是失效的**。项目键本应跟着工作区走,但代码把 `project:${process.cwd()}` 当"显式配置"抢先传进解析函数,而 `process.cwd()` 在 DSH 里是**服务进程的启动目录 = profile 目录**(`~/.dsh/profiles/<name>`),不是工作区。后果:该 profile 下**所有项目的项目级记忆挤进同一个桶**(`project:C:\Users\…\.dsh\profiles\desktop`),互相被检索到,而真正的 `project:<工作区>` 永远是空的;面板「当前项目」也指向那里。三处同一份逻辑(服务解析、装配层默认、工具层各算一份)全部统一:**会话 `cwd` > 显式配置 `projectScope` > `process.cwd()`**,工具层改为向服务端要解析结果(`projectKeyFor`),不再自己算。显式配置现在会正确脱掉 `project:` 前缀,不再拼出 `project:project:/x`。之前写进错误桶里的数据不会自动搬家(那需要判断哪条属于哪个项目),受影响的话请手动重存。
283
322
  - **0.5.5** —— 侧栏图标改成**与那一列同风格**的线稿芯片。0.5.4 虽然修好了"空一格",但画的是"蓝色瓦片 + 深墨蓝芯片"的实心方块,那是**插件管理器卡片/行**(36/30px,`icon.svg`)那套插件美术;而设置侧栏这一列全是 16px 单色细线图标(宿主内置 `Icon*OutlineMedium`:16 网格、`fill:none`、`stroke:currentColor`、线宽 1.3),实心蓝块混在里面格格不入。现在只用宿主渲染的那颗 svg 的**子节点**画线稿芯片(圆角方 + 内方 + 四引脚,1.3 描边、跟随主题),尺寸/对齐/行高仍由宿主保证。三条被验证过走不通的路都写进了代码注释:`::before` 补一个(盒子不成形 → 空一格)、给 svg 上背景(画不出描边线稿)、`content: url(...)` 替换 svg 内容(SVG 不支持 content 替换)。
284
323
  - **0.5.4** —— 修 0.5.3 的图标空洞。0.5.3 是"把齿轮 `display:none` 藏掉、再用 `::before` 在同一格补一个记号",真机上出现**齿轮没了、记号也没画出来**,只剩一个空位。改成**就地覆盖**那颗 svg(不再隐藏、不再插节点)。同时删掉 0.1.0 遗留的空壳目录 `packages/dsh-memory-panel`(0.4.0 起已被单包取代),免得它继续干扰"哪个子包才是可安装的"这类判断。
285
324
  - **0.5.3** —— 设置页侧栏「记忆」那一行的图标。宿主 `dsh-client-ui-settings-general` 把导航图标写死在 `navIcon(id)` 里:只有 `account` / `models` / `agent-presets` / `plugins` / `archived-sessions` 五个 id 有专属图标,其余(含 `memory`)一律回退成**齿轮**;`settings.section` 的注册契约里没有 icon 字段,宿主也不读包的 `icon`(那个只用于插件管理器)。所以插件侧按宿主的类名约定做了一次**定向覆盖**。标记只打在"文案等于「记忆」"的那个按钮上,其它区块不受影响;宿主类名约定一旦改变,规则匹配不到就自动退回齿轮。
package/lib/client.js CHANGED
@@ -135,6 +135,21 @@ window.__ModuleLoader__.load({
135
135
  '.memp .dropitem.on{background:var(--dsw-alias-bg-layer-2)}',
136
136
  '.memp .dropitem.on .dropname{font-weight:600;color:var(--dsw-alias-brand-primary)}',
137
137
  '.memp .warn{font-size:11.5px;color:var(--dsw-alias-label-secondary)}',
138
+ // 面板内的标签栏:记录 / 设置
139
+ '.memp .tabs{display:flex;gap:2px;border-bottom:1px solid var(--dsw-alias-border-l1);margin-bottom:12px}',
140
+ '.memp .tab{background:none;border:0;border-bottom:2px solid transparent;padding:6px 12px;color:var(--dsw-alias-label-secondary);cursor:pointer;font-size:13px}',
141
+ '.memp .tab.on{color:var(--dsw-alias-brand-primary);border-bottom-color:var(--dsw-alias-brand-primary);font-weight:600}',
142
+ '.memp .setrow{display:flex;flex-wrap:wrap;align-items:center;gap:8px 14px;padding:10px 0;border-bottom:1px solid var(--dsw-alias-border-l1)}',
143
+ '.memp .setrow .set-title{min-width:132px;font-weight:600;font-size:13px}',
144
+ '.memp .setrow .set-desc{flex:1 1 100%;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.5}',
145
+ '.memp .setrow .set-field{display:inline-flex;align-items:center;gap:5px;font-size:12px;color:var(--dsw-alias-label-secondary)}',
146
+ '.memp .setrow input[type=number]{width:78px}',
147
+ '.memp .setfoot{display:flex;align-items:center;gap:10px;padding-top:12px}',
148
+ '.memp .create{padding:10px 12px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;margin:8px 0;background:var(--dsw-alias-bg-layer-2)}',
149
+ '.memp .create .row{display:flex;gap:8px;align-items:center;margin:6px 0;flex-wrap:wrap}',
150
+ '.memp .create textarea{width:100%;min-height:64px}',
151
+ '.memp .data{padding-top:4px}',
152
+ '.memp .data .row{display:flex;gap:10px;align-items:center;flex-wrap:wrap;margin-top:8px}',
138
153
  ].join('')
139
154
 
140
155
  async function api(method, body) {
@@ -240,7 +255,7 @@ window.__ModuleLoader__.load({
240
255
  h('div', { className: 'editrow' },
241
256
  // 类型也用同一个自绘下拉(全站不再有原生 select)
242
257
  h(Dropdown, {
243
- items: ['fact', 'decision', 'preference', 'procedure', 'note'].map((k) => ({ value: k, label: k })),
258
+ items: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule'].map((k) => ({ value: k, label: k })),
244
259
  value: kind,
245
260
  disabled: busy,
246
261
  onChange: (next) => setKind(next),
@@ -543,6 +558,251 @@ window.__ModuleLoader__.load({
543
558
  )
544
559
  }
545
560
 
561
+ /**
562
+ * 设置标签页:这些开关直接改注入行为,保存后下一步生效(不进 cordis 配置,
563
+ * 落盘在记忆数据目录的 settings.json)。分组顺序与「注入链路」一致:
564
+ * 每轮召回 → 印象 → 会话摘要 → 系统提示(策略/规则) → 轮末提醒。
565
+ */
566
+ const SETTINGS_GROUPS = [
567
+ {
568
+ key: 'recall', title: '每轮召回',
569
+ desc: '按这一轮的问题检索记忆并插入上下文;内容没变时不会重复注入。',
570
+ fields: [
571
+ { k: 'enabled', label: '启用', type: 'bool' },
572
+ { k: 'topK', label: '最多条数', type: 'num', min: 1, max: 20, step: 1 },
573
+ { k: 'tokenBudget', label: 'token 预算', type: 'num', min: 50, max: 4000, step: 50 },
574
+ ],
575
+ },
576
+ {
577
+ key: 'impression', title: '印象形态',
578
+ desc: '召回只给每条的开头摘要;模型判断相关但需要细节时,自己用 memory_search 取全文。',
579
+ fields: [
580
+ { k: 'enabled', label: '启用', type: 'bool' },
581
+ { k: 'chars', label: '每条字数', type: 'num', min: 40, max: 800, step: 20 },
582
+ ],
583
+ },
584
+ {
585
+ key: 'digest', title: '会话摘要',
586
+ desc: '会话第一步给一次「这个项目 / 全局已有记忆」的概览(按重要度 × 新鲜度挑选,每个会话一次)。',
587
+ fields: [
588
+ { k: 'enabled', label: '启用', type: 'bool' },
589
+ { k: 'topK', label: '最多条数', type: 'num', min: 1, max: 30, step: 1 },
590
+ { k: 'tokenBudget', label: 'token 预算', type: 'num', min: 50, max: 4000, step: 50 },
591
+ ],
592
+ },
593
+ {
594
+ key: 'policy', title: '记忆使用策略',
595
+ desc: '系统提示里的常驻段:什么时候该查记忆、查到怎么用、查不到怎么办。文本稳定,可随前缀缓存。',
596
+ fields: [{ k: 'enabled', label: '启用', type: 'bool' }],
597
+ },
598
+ {
599
+ key: 'rules', title: '硬性规则',
600
+ desc: '把 kind = rule 的记忆放进系统提示常驻段。可机械校验的规则更适合做成钩子,而不是写在这里。',
601
+ fields: [
602
+ { k: 'enabled', label: '启用', type: 'bool' },
603
+ { k: 'maxItems', label: '最多条数', type: 'num', min: 1, max: 40, step: 1 },
604
+ { k: 'tokenBudget', label: 'token 预算', type: 'num', min: 50, max: 4000, step: 50 },
605
+ ],
606
+ },
607
+ {
608
+ key: 'turnEnd', title: '轮末提醒',
609
+ desc: '本轮跑过多步时,下一轮开头提醒一句「若产生了可复用的结论,先 memory_save」。默认关闭。',
610
+ fields: [{ k: 'enabled', label: '启用', type: 'bool' }],
611
+ },
612
+ ]
613
+
614
+ function SettingsTab() {
615
+ const [settings, setSettings] = React.useState(null)
616
+ const [busy, setBusy] = React.useState(false)
617
+ const [error, setError] = React.useState('')
618
+ const [notice, setNotice] = React.useState('')
619
+ const [rulesCount, setRulesCount] = React.useState(null)
620
+ const [dataNotice, setDataNotice] = React.useState('')
621
+
622
+ React.useEffect(() => {
623
+ api('settings').then(setSettings).catch((e) => setError(String(e.message || e)))
624
+ api('status')
625
+ .then((status) => setRulesCount(status && status.rules ? status.rules : null))
626
+ .catch(() => setRulesCount(null))
627
+ }, [])
628
+
629
+ /** 导出:纯文本 JSON,不含向量(导入时按当前模型重新嵌入)。 */
630
+ const exportAll = async () => {
631
+ setDataNotice('')
632
+ try {
633
+ const doc = await api('export')
634
+ const blob = new Blob([JSON.stringify(doc, null, 2)], { type: 'application/json' })
635
+ const url = URL.createObjectURL(blob)
636
+ const a = document.createElement('a')
637
+ a.href = url
638
+ a.download = `dsh-memory-${new Date().toISOString().slice(0, 10)}.json`
639
+ a.click()
640
+ setTimeout(() => URL.revokeObjectURL(url), 2000)
641
+ setDataNotice(`已导出 ${doc.records.length} 条(${doc.records.length > 0 ? '含作用域与类型' : '暂无记忆'})`)
642
+ } catch (e) {
643
+ setDataNotice(`导出失败:${String(e.message || e)}`)
644
+ }
645
+ }
646
+
647
+ /** 导入:接受导出的同一个文档(或记录数组),逐条走 save,自动重新嵌入。 */
648
+ const importFile = async (event) => {
649
+ const file = event && event.target && event.target.files && event.target.files[0]
650
+ if (!file) return
651
+ setDataNotice('')
652
+ try {
653
+ const text = await file.text()
654
+ const doc = JSON.parse(text)
655
+ const result = await api('import', doc)
656
+ const firstError = result.errors && result.errors.length > 0 ? `;${result.errors[0]}` : ''
657
+ setDataNotice(`导入完成:新增 ${result.imported},跳过重复 ${result.skipped},失败 ${result.rejected}${firstError}`)
658
+ if (result.imported > 0 && typeof window !== 'undefined' && typeof window.dispatchEvent === 'function') {
659
+ try { window.dispatchEvent(new CustomEvent('dsh-memory:refresh')) } catch { /* 没有 CustomEvent 就靠下次打开面板刷新 */ }
660
+ }
661
+ } catch (e) {
662
+ setDataNotice(`导入失败:${String(e.message || e)}`)
663
+ }
664
+ event.target.value = ''
665
+ }
666
+
667
+ const patch = (group, key, value) => setSettings((current) => {
668
+ if (!current) return current
669
+ return { ...current, [group]: { ...current[group], [key]: value } }
670
+ })
671
+
672
+ const save = async () => {
673
+ setBusy(true); setError(''); setNotice('')
674
+ try {
675
+ const next = await api('settings', settings)
676
+ setSettings(next)
677
+ setNotice('已保存,下一步生效')
678
+ } catch (e) {
679
+ setError(String(e.message || e))
680
+ }
681
+ setBusy(false)
682
+ }
683
+
684
+ if (!settings) return h('div', { className: 'empty' }, error || '加载设置…')
685
+
686
+ return h('div', { className: 'setp' },
687
+ h('div', { className: 'hint' }, '开关立即生效,无需重启;设置保存在记忆数据目录的 settings.json。'),
688
+ SETTINGS_GROUPS.map((group) => {
689
+ const value = settings[group.key] || {}
690
+ return h('div', { className: 'setrow', key: group.key },
691
+ h('span', { className: 'set-title' }, group.title),
692
+ group.fields.map((field) => field.type === 'bool'
693
+ ? h('label', { className: 'set-field', key: field.k }, ' ',
694
+ h('input', {
695
+ type: 'checkbox',
696
+ checked: Boolean(value[field.k]),
697
+ disabled: busy,
698
+ onChange: (e) => patch(group.key, field.k, e.target.checked),
699
+ }), ' ', field.label)
700
+ : h('label', { className: 'set-field', key: field.k }, field.label, ' ',
701
+ h('input', {
702
+ type: 'number', min: field.min, max: field.max, step: field.step, value: value[field.k],
703
+ disabled: busy,
704
+ onChange: (e) => patch(group.key, field.k, Number(e.target.value)),
705
+ }))),
706
+ h('span', { className: 'set-desc' }, group.desc),
707
+ group.key === 'rules' && rulesCount !== null
708
+ ? h('span', { className: 'set-field' }, `${rulesCount.total} 条规则 / ${rulesCount.scopes} 个作用域(在「记录 → 新建」里选 kind=rule 添加)`)
709
+ : null,
710
+ )
711
+ }),
712
+ h('div', { className: 'setrow data' },
713
+ h('span', { className: 'set-title' }, '数据'),
714
+ h('span', { className: 'set-desc' }, '导出只含文本(作用域 / 类型 / 内容 / 标签 / 重要度),不含向量;导入时按当前模型重新嵌入。导入按「作用域 + 内容」去重。'),
715
+ h('div', { className: 'row' },
716
+ h('button', { onClick: exportAll }, '导出全部'),
717
+ h('label', { className: 'set-field' }, '导入文件',
718
+ h('input', { type: 'file', accept: '.json,application/json', onChange: importFile })),
719
+ dataNotice ? h('span', { className: 'muted' }, dataNotice) : null,
720
+ ),
721
+ ),
722
+ h('div', { className: 'setfoot' },
723
+ h('button', { onClick: save, disabled: busy }, busy ? '保存中…' : '保存设置'),
724
+ notice ? h('span', { className: 'muted' }, notice) : null,
725
+ error ? h('span', { className: 'err' }, error) : null,
726
+ ),
727
+ )
728
+ }
729
+
730
+ /**
731
+ * 新建记忆 / 规则。作用域必须是**明确的键**:面板拿不到会话上下文,所以
732
+ * 'project' / 'session' 这种相对写法不提供,列出现有作用域 + global,再加
733
+ * 一个自定义输入(project:<路径> / session:<id> / 自定义名)。
734
+ */
735
+ function CreateForm({ scopes, onCancel, onCreated }) {
736
+ const [scope, setScope] = React.useState('global')
737
+ const [customScope, setCustomScope] = React.useState('')
738
+ const [kind, setKind] = React.useState('note')
739
+ const [content, setContent] = React.useState('')
740
+ const [tags, setTags] = React.useState('')
741
+ const [importance, setImportance] = React.useState(0.6)
742
+ const [busy, setBusy] = React.useState(false)
743
+ const [error, setError] = React.useState('')
744
+
745
+ const scopeItems = [
746
+ { value: 'global', label: '全局(global)' },
747
+ ...scopes
748
+ .filter((s) => s.scope !== 'global')
749
+ .map((s) => ({ value: s.scope, label: s.label || scopeLabel(s.scope) })),
750
+ { value: '__custom__', label: '自定义 / 指定作用域…' },
751
+ ]
752
+ const resolvedScope = scope === '__custom__' ? customScope.trim() : scope
753
+
754
+ const submit = async () => {
755
+ setBusy(true); setError('')
756
+ try {
757
+ await api('create', {
758
+ scope: resolvedScope,
759
+ kind,
760
+ content,
761
+ tags: tags.split(',').map((t) => t.trim()).filter(Boolean),
762
+ importance: Number(importance),
763
+ })
764
+ setBusy(false)
765
+ onCreated()
766
+ } catch (e) {
767
+ setError(String(e.message || e))
768
+ setBusy(false)
769
+ }
770
+ }
771
+
772
+ return h('div', { className: 'create' },
773
+ h('div', { className: 'row' },
774
+ h(Dropdown, { items: scopeItems, value: scope, disabled: busy, onChange: setScope }),
775
+ scope === '__custom__'
776
+ ? h('input', {
777
+ type: 'text', style: { width: 260 },
778
+ placeholder: 'project:<路径> / session:<id> / 自定义名',
779
+ value: customScope, onChange: (e) => setCustomScope(e.target.value),
780
+ })
781
+ : null,
782
+ h(Dropdown, {
783
+ items: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule'].map((k) => ({ value: k, label: k })),
784
+ value: kind, disabled: busy, onChange: setKind,
785
+ }),
786
+ kind === 'rule' ? h('span', { className: 'warn' }, '规则会进入系统提示常驻段') : null,
787
+ ),
788
+ h('div', { className: 'row' },
789
+ h('textarea', {
790
+ rows: 3,
791
+ placeholder: '内容:一句自洽的话,脱离上下文也能读懂(写之前先搜一下有没有重复)',
792
+ value: content, onChange: (e) => setContent(e.target.value),
793
+ }),
794
+ ),
795
+ h('div', { className: 'row' },
796
+ h('input', { type: 'text', placeholder: '标签, 逗号分隔', value: tags, onChange: (e) => setTags(e.target.value) }),
797
+ h('label', null, '重要度 ',
798
+ h('input', { type: 'number', min: 0, max: 1, step: 0.1, value: importance, onChange: (e) => setImportance(e.target.value) })),
799
+ h('button', { onClick: submit, disabled: busy || content.trim() === '' || resolvedScope === '' }, busy ? '保存中…' : '保存'),
800
+ h('button', { className: 'linkbtn', onClick: onCancel, disabled: busy }, '取消'),
801
+ ),
802
+ error ? h('div', { className: 'err' }, error) : null,
803
+ )
804
+ }
805
+
546
806
  function MemoryPanel() {
547
807
  const [records, setRecords] = React.useState([])
548
808
  const [scopes, setScopes] = React.useState([])
@@ -555,6 +815,8 @@ window.__ModuleLoader__.load({
555
815
  const [q, setQ] = React.useState('')
556
816
  const [loading, setLoading] = React.useState(true)
557
817
  const [error, setError] = React.useState('')
818
+ const [tab, setTab] = React.useState('records')
819
+ const [creating, setCreating] = React.useState(false)
558
820
 
559
821
  const load = async (query, scopeF) => {
560
822
  setLoading(true); setError('')
@@ -575,6 +837,13 @@ window.__ModuleLoader__.load({
575
837
  setLoading(false)
576
838
  }
577
839
  React.useEffect(() => { load('', '') }, [])
840
+ // 导入完成后从设置页切换回记录页时,列表要能看到新数据(事件由设置页发出)。
841
+ React.useEffect(() => {
842
+ if (typeof window === 'undefined' || typeof window.addEventListener !== 'function') return undefined
843
+ const onRefresh = () => { load('', '') }
844
+ window.addEventListener('dsh-memory:refresh', onRefresh)
845
+ return () => window.removeEventListener('dsh-memory:refresh', onRefresh)
846
+ }, [])
578
847
 
579
848
  const embedAction = async (action, body = {}) => {
580
849
  setEmbedBusy(true); setEmbedNotice('')
@@ -740,6 +1009,11 @@ window.__ModuleLoader__.load({
740
1009
  const filtering = q.trim() !== '' || scopeFilter !== ''
741
1010
 
742
1011
  return h('div', { className: 'memp' },
1012
+ h('div', { className: 'tabs' },
1013
+ h('button', { className: 'tab' + (tab === 'records' ? ' on' : ''), onClick: () => setTab('records') }, '记录'),
1014
+ h('button', { className: 'tab' + (tab === 'settings' ? ' on' : ''), onClick: () => setTab('settings') }, '设置'),
1015
+ ),
1016
+ tab === 'settings' ? h(SettingsTab, {}) : h('div', { className: 'memp-body' },
743
1017
  h('div', { className: 'stats' },
744
1018
  h('div', { className: 'stat' }, h('b', null, String(total)), h('span', null, '条记忆')),
745
1019
  h('div', { className: 'stat' }, h('b', null, String(scopes.length)), h('span', null, '个作用域')),
@@ -817,14 +1091,23 @@ window.__ModuleLoader__.load({
817
1091
  disabled: loading,
818
1092
  onChange: (next) => { setScopeFilter(next); load(q, next) },
819
1093
  }),
1094
+ h('button', { onClick: () => setCreating((v) => !v), disabled: loading }, creating ? '收起' : '新建'),
820
1095
  h('button', { onClick: () => load(q, scopeFilter), disabled: loading }, loading ? '刷新中…' : '刷新'),
821
1096
  filtering ? h('button', { className: 'linkbtn', onClick: () => { setQ(''); setScopeFilter(''); load('', '') } }, '清空筛选') : null,
822
1097
  ),
1098
+ creating
1099
+ ? h(CreateForm, {
1100
+ scopes,
1101
+ onCancel: () => setCreating(false),
1102
+ onCreated: () => { setCreating(false); load('', '') },
1103
+ })
1104
+ : null,
823
1105
  error ? h('div', { className: 'err' }, error) : null,
824
1106
  !loading && !error && records.length === 0
825
1107
  ? h('div', { className: 'empty' }, filtering ? '没有匹配的记忆' : '还没有记忆')
826
1108
  : h('div', { className: 'list' },
827
1109
  records.map((rec) => h(RecordCard, { key: rec.id, rec, vectorOn: configured && vectorEnabled, labels: labels, onSaved: () => load(), onDeleted: () => load() }))),
1110
+ ),
828
1111
  )
829
1112
  }
830
1113