@restregular/dsh-memory 0.30.0 → 0.31.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/CHANGELOG.md CHANGED
@@ -2,6 +2,26 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.31.0 — 记忆树标签页新增「星图」视图(Obsidian 式,带纵深)
6
+
7
+ - **问题**:记忆条目上百条之后,记忆树的三层结构(作用域 → 类型 → 记录)依然清楚,但它只回答「这条挂在哪儿」,**看不出记忆堆在什么地方、哪个作用域已经膨胀**。用户要的是「参考 Obsidian 那种有点 3D 的、看起来高级且清晰」的第二视角。
8
+ - **二级切换**:记忆树标签页顶部新增「**记忆树** / **星图**」两个子标签,两个视图共用同一份状态 —— 搜索、作用域筛选、类型筛选、修正连线开关、选中记录、折叠的作用域、缩放全部共享,来回切换不会丢掉刚筛的那一半。
9
+ - **星图布局(纯函数,无随机量)**:每个作用域是一颗星,大小随记忆条数增长(`hubR + min(7, sqrt(n)*1.5)`);它下面的记忆按**黄金角螺旋**(2.39996 rad)铺成同心环,第 i 个点落在 `hubR + hubPad + ring*sqrt(i+0.45)`,因此不需要物理模拟也不会互相压住,同样的数据永远得到同一张图(截图与测试都靠这一点)。
10
+ - **纵深感**:每个点带 `z ∈ [0,1]`,越靠外环越小(`nodeR*(1.42-0.62z)`)、越暗(`--z-op`)、越模糊(`--z-blur`),并用 `z-index` 排前后;簇之间用确定性斥力松弛 + 有界外扩收尾,保证簇与簇之间留出空隙而不是贴在一起。
11
+ - **星与轨道环**:每颗星画一圈轨道环(该簇记忆的真实外沿),外加一层柔光,让散点聚成有边界的「星团」;**点星心折叠 / 展开**它下面的记忆,和记忆树共用同一份折叠状态 —— 两边看到的永远是同一棵树。折叠后星变暗、轨道环消失。
12
+ - **标签克制**:默认只给「命中 / 邻域 / 选中 / 悬停」的点显示标签,全部常显会把星团糊成一片(这也是 Obsidian 图谱默认不标全节点的原因);星名挂在轨道环上方,不压记忆点。
13
+ - **悬停聚焦**:只点亮「这个点 + 它的星 + 修正关系另一端」,其余淡出;修正关系画成金色虚线,与记忆树同一套语义。
14
+ - **样式**:只用宿主 `--dsw-alias-*` token + `color-mix()`,浅色 / 深色主题自动跟随;类型色是唯一硬编码的颜色(与记忆树一致),修正线仍是 `#D9A441`。
15
+ - **修掉的渲染坑**:① `.gnode .orb` 原为 `position:relative;display:block`,在定宽定高的 flex 盒里没有内在尺寸 → 圆点变 0×0,屏幕上只剩外发光;改为 `position:absolute;inset:0`。② `.graph-canvas` 以 `0 0` 为 transform-origin 且没有居中,缩小时整张图往左上角塌;改为居中定位 + `transform-origin:50% 50%` + 负半宽 margin。③ 簇布局原先用 `baseRadius*1.7` 往外拽,与斥力互相抵消,簇仍然相碰;改为纯斥力 + 有界外扩(`worst<=1.004` 退出)。
16
+ - 测试:新增「星图布局:每个作用域一颗星、记忆按同心环铺开、越靠外越远越小」(螺旋半径上限从 `GRAPH_METRICS` 推导而非硬编码、轨道环包住最远记忆、折叠 / 筛选 / 搜索只标记不裁剪、同输入两次结果 `deepEqual`)、「记忆树标签页:二级切换在记忆树与星图之间切,筛选状态跟着走」、「星图节点有实际尺寸、连线真的落在 svg 里」(三条 CSS 回归断言,对应上面三个渲染坑)。全套 544 tests / 544 pass。
17
+
18
+ ## 0.30.1 — 修复 CUDA 运行时安装把 cudart 伴生包当成主包(issue #4)
19
+
20
+ - **问题(issue #4)**:面板选「CUDA(显卡)」点「下载并安装」,报「安装失败:解压完成但没找到 llama-server.exe:cudart-llama-bin-win-cuda-12.4-x64.zip 的目录结构可能变了」。根因是资产匹配正则**只锚了结尾、没锚开头**:CUDA 主包 `llama-b<构建号>-bin-win-cuda-12.4-x64.zip` 与伴生包 `cudart-llama-bin-win-cuda-12.4-x64.zip` 共享同一段 `-bin-win-cuda-12.4-x64.zip` 后缀,而 llama.cpp 的 release 资产顺序**不保证**主包在前(b12023 实测 cudart 一族排在 `llama-*` 之前)。安装器按数组顺序取第一个命中,于是把只有 cudart / cuBLAS 的伴生包当成运行时:约 267 MB 的 CUDA 主包没下,解压出来当然没有 `llama-server.exe`;随后 companion 正则又命中同一个文件,「复用」后错误信息里就出现了 cudart 包名。Linux 的 `cudart-…-bin-ubuntu-cuda-12.8-…tar.gz` 同理。
21
+ - **修复**:`runtimeAssetPattern` 所有主包分支补开头锚定(win32 / linux / darwin × cpu / vulkan / cuda,如 `/^llama-.*-bin-win-cuda-12.4-x64\.zip$/`),伴生包保持 `/^cudart-.*…/`,两类正则从此互不重叠;构建号仍写在中间、不硬编码。只有 cudart、没有主包的发行版会走既有的「找不到风味包 → 退回 CPU 包并说明原因」分支,而不是装出一个缺 exe 的目录。
22
+ - **已踩过坑的用户**:旧版误下的 `cudart-llama-bin-…zip` 正好就是新版要用的伴生包,重试时按「已存在,跳过下载」直接复用(不再白下约 373 MB),主包另下后两个包一起解压,`llama-server.exe` 落地即装完。
23
+ - 测试:`test/model-install.test.ts` 用 b12023 的 38 个真实资产名做回归——cudart 排在主包前时 CUDA 主包仍选中 `llama-*`、companion 选中 `cudart-*`;4 个受支持平台组合(win32 / linux × x64 / arm64)全覆盖;名单倒序不影响结果;6 平台 × 4 风味遍历全名单验证主包 / 伴生包正则互斥。`test/embed-install.test.ts` 的正则逐字断言同步为首尾锚定,并新增**离线全流程**用例:把 cudart 放在资产列表最前,用注入 fetch 跑完「查发行版 → 下主包 + 伴生包 → 解压 → 下模型」,断言真正请求的是 `llama-*` 主包且最终 `phase=done`、`llama-server.exe` 落地(旧代码在这个用例上必红)。另用 b12023 线上 release JSON 实跑确认 win32-x64 CUDA → `llama-b12023-bin-win-cuda-12.4-x64.zip` + `cudart-llama-bin-win-cuda-12.4-x64.zip`。全套 541 tests / 540 pass / 1 skipped(`multiprocess.test.ts` 需真起子进程)。
24
+
5
25
  ## 0.30.0 — 会话作用域绑定会话生命周期(创建自动建 / 归档即冻结 / 恢复即复原)
6
26
 
7
27
  - **问题**:会话作用域此前只在第一次写记忆时才懒创建,且与宿主的会话生命周期完全脱节 —— 会话归档后,它的 `session:<id>` 作用域与记忆仍然"存在",跨作用域检索、面板、`memory_get(id)` 都能碰到;恢复 / 归档也没有任何可见语义。用户想要的是:会话创建时作用域就已存在,归档时连同记忆一起冻结,恢复后原样回来。
package/README.md CHANGED
@@ -79,6 +79,23 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
79
79
 
80
80
  ![记忆树](https://raw.githubusercontent.com/RestRegular/dsh-memory/main/preview/memory-tree.png)
81
81
 
82
+ ### 星图
83
+
84
+ 同一个标签页里的第二个视图(顶部二级切换:**记忆树 / 星图**)。记忆树回答「这条记录挂在
85
+ 哪个作用域、哪个类型下面」,星图回答「记忆堆在哪儿、有多密」:每个作用域是一颗星,它下面
86
+ 的记忆按**黄金角螺旋**(2.39996 rad)铺成同心环 —— 无随机量,同样的数据永远得到同一张图。
87
+
88
+ ![星图](https://raw.githubusercontent.com/RestRegular/dsh-memory/main/preview/memory-graph.png)
89
+
90
+ - **远近**:环越外层的点越小、越暗、带一点点模糊(`z` 值驱动 `--z-op` / `--z-blur` /
91
+ `z-index`),因此看起来有纵深,而不是一屏等大的散点。整张图按椭圆铺开以吃满宽画布,
92
+ 簇之间用确定性斥力松弛 + 外扩收尾,保证不会互相压住。
93
+ - **星**:大小跟着记忆数增长,圆环是这一簇的真实外沿;**点星心折叠 / 展开**它下面的记忆
94
+ (和记忆树共用同一份折叠状态,两边看到的一样)。折叠后星变暗、轨道环消失。
95
+ - **悬停**:只点亮「这个点 + 它的星 + 修正关系另一端」,其余淡出;记忆树里选中一条记录,
96
+ 星图里同一个点也是选中态。搜索命中单独高亮,但**不裁剪图形**(图要保持形状)。
97
+ - 搜索、作用域筛选、类型筛选、修正连线开关、缩放**两个视图共享**,来回切换不会丢上下文。
98
+
82
99
  ### 设置
83
100
 
84
101
  召回、摘要、印象、策略、状态、流程索引、规则、自动召回逐项开关;每个开关都有可见 label、说明和当前状态。
@@ -622,6 +639,7 @@ npm run verify # 构建到 .verify/,不落 packages/
622
639
 
623
640
  ## 更新日志
624
641
 
642
+ - **0.30.1** —— 修复 CUDA 运行时安装误选伴生包(issue #4):`runtimeAssetPattern` 的主包正则补上开头锚定 `^llama-`(此前只锚结尾,release 资产顺序一变就会把共享后缀的 `cudart-llama-…` 当成运行时,解压后找不到 `llama-server.exe`);伴生包仍只认 `^cudart-`,只有 cudart 的发行版会退回 CPU 包而不是装出缺 exe 的目录;已误下 cudart 的用户重试时该文件会直接复用为伴生包。
625
643
  - **0.30.0** —— 会话作用域绑定会话生命周期:会话创建时系统自动建立会话作用域(`ensureSessionScope`,只写 `scope-meta`,`createdBy: system`,幂等且不写记忆);会话归档后该作用域与记忆**冻结**——`search` / `list` / `listSync` / `getByIds` 全部跳过,授权统一返回 `SCOPE_ARCHIVED`(不可申请、无审批路径),目录与面板标「已归档」,归档期间小时级过期清理与容量淘汰也跳过它;取消归档后自动复原(实时读宿主 `workspaceRegistry.archivedSessionIds`,不复制、不缓存,数据文件一个字节不动)。`memory_scopes` 目录项新增 `archived` 与 `accessStatus='archived'`;面板作用域行显示「已归档」徽标;`session/created` 监听失败绝不回滚会话创建,启动时给已存在的会话补建。
626
644
  - **0.29.0** —— 作用域用途 / 别名可编辑:`memory_scopes` 新增 `action="edit"`(`scope` + `scopeDescription?` / `scopeName?`,空串分别表示清空用途 / 移除别名,至少给一个,需要该作用域可写,范围外先走 `request` 申请写权限);面板「记录 → 作用域」每行新增「编辑」,用途编辑框只预填手写的那句,默认描述不预填;`describeScope` 的空描述从报错改为**清空**(保留元数据与 generation,目录回退按类型默认描述),新增 `renameScope`(项目 / 自定义作用域可设别名,global / session 拒绝,重名 `SCOPE_NAME_TAKEN`);`/memory/api/status` 新增 `descriptionSource`(custom / default)与别名 `name`,新增 `POST /memory/api/scope-meta`。
627
645
  - **0.28.0** —— 范围外命中只列作用域:`memory_search` 的 `outOfScope` 去掉条目索引(id / score / 标签 / 短摘要),改为只给命中的作用域、各几条、`description`(作用域用途,`scope-meta` 手写优先、没写过按类型补默认描述)与 `requestable`(该域能否走审批);渲染成「名称(条数 · 可申请性):用途」的独立清单,不再重复 `withheld` 说明。面板「记录」页新增「记忆 / 作用域」两个子标签页,作用域页展示名称、用途、条数、待嵌入与最近更新,可一键跳到该域的记忆列表;`/memory/api/status` 每项新增 `description`(无记录但写过用途的作用域也列出)。