@kenz1117/dsh-engram 0.9.9 → 0.11.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 +122 -3
- package/README.en.md +4 -3
- package/README.md +7 -6
- package/docs/agent-language-guide.ru.md +102 -0
- package/i18n/panel.ru.txt +57 -0
- package/i18n/ru.txt +517 -0
- package/lib/client.js +4 -2
- package/lib/client.js.map +1 -1
- package/lib/index.js +6279 -870
- package/package.json +6 -2
- package/registry/bindings.json +14 -0
- package/registry/languages.json +8 -0
- package/registry/models.json +27 -0
- package/registry/schema.json +79 -0
- package/scripts/check-hook-order.mjs +129 -0
- package/scripts/check-messages.mjs +112 -24
package/CHANGELOG.md
CHANGED
|
@@ -6,11 +6,129 @@
|
|
|
6
6
|
- 安装:`dsh plugin --profile web add @kenz1117/dsh-engram`
|
|
7
7
|
- 仓库:<https://github.com/kenz1117/dsh-engram>
|
|
8
8
|
|
|
9
|
-
> **v0.x 阶段的版本约定**:`0.MINOR.PATCH` 里的 `MINOR` 是**功能批次**而不是稳定性刻度——0.7.x 整批是「记忆宫殿信息架构」,0.8.x 整批是「面板重构」,0.9.x
|
|
9
|
+
> **v0.x 阶段的版本约定**:`0.MINOR.PATCH` 里的 `MINOR` 是**功能批次**而不是稳定性刻度——0.7.x 整批是「记忆宫殿信息架构」,0.8.x 整批是「面板重构」,0.9.x 整批是「稳定性与可审计」,0.10.x 整批是「多语言与数据驱动」。同一批次内的 `PATCH` 位通常是修复与加固。
|
|
10
10
|
|
|
11
11
|
## [Unreleased]
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## [0.11.0] - 2026-10-25
|
|
14
|
+
|
|
15
|
+
> **0.11 是新的一批功能**:0.10.x 整批是「多语言与数据驱动」,0.11.x 整批是「面板重排与可靠性修复」。
|
|
16
|
+
> 面板的三个视图重排成与首页同一套骨架(同一个底图、同一套尺寸、同一块右侧索引),同时修掉两个
|
|
17
|
+
> 真会让人返工的缺陷:宫殿语言在 macOS 上被误判成英文(于是整套向量要重算),以及往事页的
|
|
18
|
+
> 「邻近」按钮一点就崩掉整个视图。
|
|
19
|
+
|
|
20
|
+
### ⚠️ 升级说明:宫殿语言改按操作系统的真实语言判定
|
|
21
|
+
|
|
22
|
+
- **以前读的是进程 locale,现在读的是操作系统语言**(macOS 读 `AppleLocale`;`C`/`POSIX` 这类"语言没设"不再被当成英文)。中文系统的 macOS 之前被读成 `en`——宫殿语言、目标嵌入模型、乃至整套向量都跟着偏了。
|
|
23
|
+
- **对中文用户**:修好之后宫殿语言是 `zh`、模型是 `bge-small-zh`(512 维)——正好和你库里已有的向量一致,**不需要重算**,插件会把库补上模型标记。
|
|
24
|
+
- **对其他语言的用户**:如果你的系统语言与之前判定出来的不同,宫殿语言会变、目标模型随之变,存量库的向量维度就对不上了——到「运维 → 记忆宫殿」里选好语言按一次「执行」重算一遍即可(面板会先提示"向量需要重算")。
|
|
25
|
+
- 也可以在「运维 → 记忆宫殿」里手动把宫殿语言钉死,之后不再随系统语言变化。
|
|
26
|
+
|
|
27
|
+
### 视觉:关系图改造成「平面图 + 关系边」
|
|
28
|
+
|
|
29
|
+
- **关系图不再是一张满屏乱飞的力导向图**:此前它有自己的 560×320 画布、860px 限宽、5 条竖向色带做背景,节点在色带之间任意漂移,常驻文字标签互相叠字、还被画布边缘切掉——与平面图相比尺寸更大、视觉语言完全不同(用户原话:「尺寸也太大了点吧,好丑,和平面图差别好大」)。
|
|
30
|
+
- **两种视图现在共用同一张建筑底图**:房间排布(`roomBoxes()`)、外墙、中央主通道、门牌样式全部抽成共用件,平面图与关系图画在同一张 720×380 的图上,**房间位置在两个标签页之间保持不变**(位置当索引)。关系图不再是「另一张图」,而是平面图上多画了关系边。
|
|
31
|
+
- **关系图的节点锚在房间里**:一个记忆点归入它所属 kind 的房间,房内做一次确定性的排斥松弛(无随机数、无 rAF 抖动、不再每帧重渲染),房与房之间才画关系边——边因此读起来就是「走廊里的往来」。
|
|
32
|
+
- **节点不再常驻文字标签**(房间小、点多,标签必糊),改为 hover 出提示卡:房间名 + 完整铭牌(按可用宽度截断,不再溢出边框);hover 节点时高亮它、一跳邻居与相关边,其余淡出。点圆点仍触发原有的记忆选中,节点也失去了拖拽功能——节点的位置由房间决定,拖走反而破坏「位置即索引」。
|
|
33
|
+
- **两个标签页的骨架一致**:关系图此前独占整行(没有右侧索引条),现在与平面图一样是「左地图 + 右侧房间索引条」,边类型图例移进右侧索引条(只列出当前库里真实存在的边类型)。
|
|
34
|
+
- **自环边不再冒充关系**:存量库里有历史脏行(`edges.from_id === edges.to_id`,早期写入路径未挡住自己),这类边画不出线却会被计入「3 条走廊」。客户端现在剔除自环边,图例与「还没有关系边」提示因此说的是实话。
|
|
35
|
+
- **主通道门牌加底衬**:旋转的「走廊 · 主通道」此前被虚线与连线切碎,现在压在边之上、带底衬,两个模式同步受益。
|
|
36
|
+
|
|
37
|
+
### 视觉:实体页从「九张大卡」变成「一张卡里九行」
|
|
38
|
+
|
|
39
|
+
- **实体页从「九张大卡」变成「一张卡里九行」**:此前每个实体独占一张满宽卡片,行内大片留白,右端还挂一个重复九遍的「查看」按钮。现在实体列表是一张卡里的紧凑行(色点 + 名称 + 别名 + 类别 + 关联数 + 箭头),**整行可点**(行本身是按钮,键盘可达),不再有重复按钮;行内给出类别标签,色点不再需要靠猜。
|
|
40
|
+
- **类别 chips 带上自己的颜色**:过滤 chip 里的色点就是该类别在图上的颜色,色码自解释;计数从漂在右缘的一行灰字改成一枚药丸(「9 个实体」)。
|
|
41
|
+
- **运维页是长页,给它一枚块导航**:回填 / 插件语言 / 记忆宫殿语言 / 裁决四块工具从上到下排开,顶部新增**吸顶块导航**(点一下就滚到对应工具,滚动时不盖住块标题——`scroll-margin-top` 按吸顶条高度留了余量)。块节点用 ref 登记,不靠 `document.getElementById`,宿主换挂载点也不失效。
|
|
42
|
+
- **解释性长文收进「这是什么?」折叠**:回填与裁决两块开头的三行说明改为按需展开——工具页第一屏应该先给控件,想读的人点一下就在。
|
|
43
|
+
- **「插件语言」块拆成两组并排放**:「现在的词典 / 新建词典」原本挤在同一条长行里(一个 `margin-left:auto` 把右边那组推走),现在分成两组带各自标题的字段,窄栏时各自成列。
|
|
44
|
+
- **词典统计从散文行改成表**:原先是「消息 — 共 501 行 · 已填: 501 · 读取自: — · 问题: 无」这样的文字行,现在是 `词典 / 行数 / 已填 / 文件 / 问题` 五列表,按内容宽度排布,不再拉成满屏空列。
|
|
45
|
+
- **长表格自带滚动**:模型表与库表包进滚动容器(库表另有 320px 高度上限),几十行数据库清单不再把整页撑长。
|
|
46
|
+
- **词典列头新增三条词典键**(`dictColSet` / `dictColRows` / `dictColFilled` / `dictColFiles` 与「这是什么?」`opsMoreInfo`),中英俄三份词典同步补齐。
|
|
47
|
+
|
|
48
|
+
### 视觉:运维页按首页骨架重排
|
|
49
|
+
|
|
50
|
+
- **运维页以前是「一列长表单」,现在和首页一个骨架**:页面头(大标题 + 副标题 + 细分隔线)→ 吸顶块导航 → 两列网格。左列(宽)放需要宽度的「记忆宫殿:语言与记忆库」和「回填」,右列(窄、吸顶)放「插件语言」和「裁决」——与首页「今日速览 → 活动热力 + 房间目录」同一种版式。
|
|
51
|
+
- **工具名从卡片外面搬进卡片里**(首页「近半年活动热力」的写法):每件工具一张卡,标题在卡内,右侧放一句说明或动作(`面板测试` 按钮也回到它所属的卡里)。
|
|
52
|
+
- **「记忆宫殿」卡不再在状态正常时变成一张空卡**:模型表和记忆库表原先只在「出问题时」才出现(一切正常时整张卡只剩一行状态)。现在两张表**常驻**——这张卡是状态卡,不是故障卡;只有「动作」区(锁定 + 执行)仍在需要时才出现。
|
|
53
|
+
- **回填的估算改用首页的大数字**(10 / 24 / 45 三个 32px 指标),不再是小方块;动作区与进度区之间加一道细分隔线。
|
|
54
|
+
- **词典统计从表格改成行**(点 + 名称 + 文件 + 已填/总数 + 问题),和首页「房间目录」同一行式语言。
|
|
55
|
+
- **注册表拆成两张卡**:`RegistryCard`(一个组件塞了两块)拆成 `PalaceLanguageCard` 与 `PluginLanguageCard`,快照由新的 `OpsTab` 统一持有并下传——表读一次,不再各读各的;两张卡也终于能放进宽窄不同的两列。
|
|
56
|
+
- **表头不再折行、表格不再被挤成竖排**:表头 `white-space: nowrap`,表格有最小宽度,窄处改为横向滚动而不是把「模型标识」拆成一列一个字。
|
|
57
|
+
|
|
58
|
+
### 修复:宫殿语言在 macOS 上被误判成英文
|
|
59
|
+
|
|
60
|
+
- **面板、设置、电脑语言全是中文,宫殿却报 English**:`systemLocaleBase()` читался через `Intl.DateTimeFormat().resolvedOptions().locale` — то есть локаль **процесса**. Приложение, запущенное из Dock, наследует `LANG=C.UTF-8` (это «язык не задан»), а Node/ICU отдают для такой локали `en-US` — плагин садился в английский на любой неанглийской macOS. Теперь: переменные окружения читаются как есть, но `C`/`POSIX` — это **«язык не задан», а не «английский»**; если в них настоящего языка нет, на macOS читается `AppleLocale` (настоящий язык ОС), на прочих платформах — ничего (`tests/system-locale.spec.ts`).
|
|
61
|
+
- **Следствие для данных**: вектора в базах оказались посчитаны китайским `bge-small-zh` (512), а целью была английская привязка → «нужна конвертация» и пересчёт ~284 записей. Теперь цель — `zh-bge-small-zh`, базы опознаны как `норма` (совпадают по модели), и остаётся только дешёвое действие «дописать метку» вместо пересчёта всех векторов.
|
|
62
|
+
- **Служебные тексты** поедут за языком дворца (`setMessageLanguage`): у китайского пользователя они теперь на китайском, а не на английском.
|
|
63
|
+
|
|
64
|
+
### 修复:往事页「邻近」按钮一按就崩视图
|
|
65
|
+
|
|
66
|
+
- **形状不匹配(真凶)**:服务端 `GET /api/engram/episode-timeline?around=<id>` 回的是 `{ around: { anchor, neighbors } }`(同一条路由在分组模式下回 `{ groups }`),**客户端却把整个响应体当成 `{ anchor, neighbors }` 读**——`around.anchor` 是 `undefined`,渲染锚点行时读 `.id` 就把整个往事视图带崩:`TypeError: Cannot read properties of undefined (reading 'id')`。客户端现在取出内层 `around` 再渲染。
|
|
67
|
+
- **实证**:把客户端临时改回旧行为复现——锚点行直接消失(没有我的兜底就是崩溃);改回修复后锚点行正常渲染。
|
|
68
|
+
- **形状改由两端共用**(`src/types.ts` 的 `EpisodeTimelineAroundResponse` / `EpisodeTimelineGroupsResponse`):这类"服务端与客户端各写一份形状"的漂移从此是**编译错误**,不会等到用户点按钮才炸。服务端响应也用同一类型标注,锚点缺失时回 404 而不是硬解引用。
|
|
69
|
+
- **兜底**:即使响应形状再变,锚点缺失时只显示一行提示(`episodeAroundMissing`),不再带崩整个视图。
|
|
70
|
+
|
|
71
|
+
### 修复:视图崩溃的反馈信息补上"哪儿崩了"
|
|
72
|
+
|
|
73
|
+
- **崩溃卡只有一句 "Cannot read properties of undefined (reading 'id')"**:错误消息说「哪里错了」,组件栈才说「哪个视图错了」。视图级错误边界现在捕获 React 的组件栈,打印到控制台并显示在兜底卡里(最多 12 行)——反馈时带上它,一次就能定位到具体组件,不必再复现一遍。
|
|
74
|
+
- **响应字段一律兜底**(仓库契约「新增响应字段仍必须可选 + 兜底」):实体列表的 `item.entity`、运维快照的 `bases` / `models` / `languages`、词典统计的 `files.read` / `rows` 全部改为缺字段不崩(缺 `entity` 的行照常显示为"—",不渲染成 `undefined`)。
|
|
75
|
+
|
|
76
|
+
### 修复:运维页「记忆宫殿」块的俄文串与术语堆
|
|
77
|
+
|
|
78
|
+
- **中文界面里蹦出俄文**:服务器在普查记忆库时把版本不符写成了硬编码的俄文短句(`база v11, объявление под v13`),面板原样显示——用户在中文面板里看到两行红字里夹着俄文。现在服务器只给**无语言的事实**(`v11→v13`、表名 `observations`),句子由面板按自己的语言写:`缺少数据表 observations;数据库版本 v11,当前插件需要 v13`。
|
|
79
|
+
- **「标记 / 模型标识 / 维度 / 池化·权重」「无向量 / 长度不符 / 向量长度」这些列头看不懂**:改成 `别名 / 模型 / 向量维度 / 池化·量化` 与 `记忆库 / 记忆数 / 缺向量 / 维度不符 / 向量维度`;库的逐条状态也从「未检查 / 无标记 / 向量混杂」改成「未能检查 / 没记录模型 / 向量维度不一」。
|
|
80
|
+
- **「知识宫殿的语言」与「记忆宫殿语言」两个名字指同一个东西**(界面前后不一致):统一为「宫殿语言」,块标题改为「记忆宫殿:语言与记忆库」。
|
|
81
|
+
- **三行只给名词不给解释**:宫殿语言 / 记忆库里的向量 / 检索记忆用的模型 / 你和代理说话的语言——现在每行都带一句白话说明;红色状态旁补一句「到底差在哪、按下执行会发生什么」(`baseStateConvertHint` / `baseStateRepairHint`);两张表各加一句表头说明(`registryModelsHint` / `registryBasesHint`)。
|
|
82
|
+
|
|
83
|
+
### 修复:清理日志后容量反而变大
|
|
84
|
+
|
|
85
|
+
- **「清理日志」在 WAL 模式下不缩文件、反而把面板上的容量数字推高**:面板显示的容量是 `db + -wal + -shm` 三个文件的大小之和(`routes.ts` 的 `dbFileBytes`),而清理动作是 `DELETE` + `VACUUM`。**WAL 模式下 `VACUUM` 把重建后的整库写进 `-wal`,主库文件一个字节都不截断**——于是每次清理,总字节数不降反升。实测真实库(user.db):清理后 6.82 MB → **7.17 MB**。
|
|
86
|
+
- **`clearLog` 现在补做 TRUNCATE-checkpoint**:`VACUUM` 之后执行 `PRAGMA wal_checkpoint(TRUNCATE)`,把释放出的页写回主库文件并把 `-wal` 归零。同一个真实库:6.82 MB → **0.38 MB**(原来只有等宿主关闭最后一个连接、SQLite 收尾截断时才会回收——而宿主一直开着这些库,所以用户永远看不到回收)。
|
|
87
|
+
- **只在真的删到行时才 `VACUUM`**:原来即使一条都删不掉也照跑,纯粹是在把 `-wal` 越撑越大。响应新增 `checkpointed` 字段(逐库与汇总各一份),面板据此区分「压过了」与「压不动(库被别的进程占着)」。
|
|
88
|
+
- **面板容量数字不再失真**:容量口径仍是三个文件的真实字节数,但现在它会随清理**变小**;`tests/log-clear.spec.ts` 补了回归用例(清理后 `db+wal+shm` 不得变大)。
|
|
89
|
+
- **日志页四个计数瓦片在清理后会自动重取**:`落成类 / 发掘 / 检索 / 整理` 取自总览遥测(182 天窗口的 `op_log` 聚合),此前清理日志**不触发**总览重载,于是瓦片一直显示清理前的旧值(看起来像"日志没被清掉")。现在清理成功后会重取总览,计数与真实剩余行数一致。
|
|
90
|
+
- **说明**:`ingest-*` / `reflect-pending` 这类键仍在清理范围之外(它们是重复摄取的幂等状态,不是日志);若某库只剩这些键,清理会显示「已删除 0 条」——这是正确行为,不是故障。
|
|
91
|
+
|
|
92
|
+
### 修复:备份改走一致性快照,tar 解包拒绝路径穿越
|
|
93
|
+
|
|
94
|
+
- **备份不再直接拷贝活的 .db 文件**:先在临时目录里做**一致性快照**(SQLite 快照 API),再打包。WAL 模式下直接拷贝会把还没落盘的 WAL 混进包里,恢复出来的库可能自相矛盾。
|
|
95
|
+
- **解包端加了三道闸**:条目路径穿越(`../`、绝对路径)直接拒绝;条目名超长拒绝;单条不是可恢复的 Engram SQLite 库就整体拒绝(不再"恢复一半"留在库里)。
|
|
96
|
+
- 三个新错误文案进服务端词典(`store.backupNoDatabases` / `store.backupInvalidDatabase` / `store.tarUnsafeEntry`),中英俄三份齐。
|
|
97
|
+
|
|
98
|
+
### 修复:向量重算的完整性闸与远程嵌入器的目标模型
|
|
99
|
+
|
|
100
|
+
- **模型标记只在完整且无错的重算之后才写进库**(`vectorConversionComplete`)。此前只要"转换了 >0 条"就写标记,部分失败也照样把库标成新模型——往后检索出来的是半新半旧的向量空间。
|
|
101
|
+
- **远程嵌入器的目标模型改由"真正写向量的那一个"决定**(`resolveBaseTarget`):不再从本地绑定借维度与标记,远程的维度与标记本来就无从得知。
|
|
102
|
+
- **重算的写入路径带上期望维度**:一批里出现一条别的维度的向量就整批停下(`rewriteVectors` 本就绕过了普通 guard,多一层检查才拦得住)。
|
|
103
|
+
- **猜测模型时,长度不在目录里就返回"不知道"**(undefined),而不是回落到目标模型——把"不知道"当成"就是它"会盖掉真实的维度不符。
|
|
104
|
+
|
|
105
|
+
## [0.10.0] - 2026-10-24
|
|
106
|
+
|
|
107
|
+
> **0.10 是新的一批功能**:0.9.x 整批是「稳定性与可审计」,0.10.x 整批是「多语言与数据驱动」。
|
|
108
|
+
> 本版首次把「默认值」从代码属性改为数据属性——模型、语言绑定、服务端词典都不再写死在代码里。
|
|
109
|
+
|
|
110
|
+
### 多语言层、数据注册表与库维护(合并 #36)
|
|
111
|
+
|
|
112
|
+
- **默认嵌入模型改为注册表数据,不再是代码常量**:模型目录 `registry/models.json`(`bge-small-zh` 512 维 / `minilm-l12` 384 维)、语言绑定 `registry/bindings.json`(zh → bge-small-zh,`*` → minilm-l12)、语言表 `registry/languages.json` 与结构说明 `registry/schema.json` 全部作为数据文件落盘;`src/embedder/local.ts` 不再硬编码模型标识,`src/embedder/select.ts` 按语言解析模型,`embedder.localModel` 保留为显式覆盖。
|
|
113
|
+
- **服务端词典外置**:`i18n/ru.txt`(498 条)与 `i18n/panel.ru.txt`(48 条)以 TAB 分隔的左原文/右译文格式落盘,服务端消息与面板文案从文件读取,不再内嵌在代码里。
|
|
114
|
+
- **新增 `engram_language_guide` 工具**(工具总数 22 → **23**):输出 `<包根>/docs/agent-language-guide.ru.md`,兑现首启窗口对未内置语言用户的「agent 会输出一份说明」承诺。
|
|
115
|
+
- **面板新增「维护」视图**:库状态、模型标签、向量重算(`runVectorConvert`)、宫殿语言切换、词典查看与维护。
|
|
116
|
+
- **面板词典接口**:`/api/engram/locales` 提供「非内置语言 + 面板词典」,客户端 `src/client/index.ts` 拉取后 `addLanguage` + `register(NS, code, entries)`;路由不可用时回落到内置语言。
|
|
117
|
+
- **语言切换的联锁移到服务端**(`src/registry/palace-guard.ts`):窗口的状态现在活在服务端——它自己记住第一个事件(由 `palace-change/open` 打开窗口)与那一刻库所在的语言,并按自己的状态计算窗口。客户端不再发送 `from` 与 `startedAt`:此前校验的是"客户端送来的值"而非实际状态,任何客户端都能靠伪造当前时间让条件自动成立。重复开窗不会延长窗口;另一条写入路径(`palace-language`)同样受联锁约束(一个联锁挂在两条路径上,等于没有联锁)。此条关闭 `docs/tech-debt.md` 的 3.1。
|
|
118
|
+
- **其余已知边界**记于 `docs/tech-debt.md`(三条,均不阻塞使用):远程嵌入器不参与目标模型选择、未知维度的库可能被盖上目标标签、向量转换只校验条数不校验每条长度。
|
|
119
|
+
- **打包修复**:`i18n/`、`registry/`、`docs/agent-language-guide.ru.md` 三条路径补进 `package.json` 的 `files`;`scripts/check-hook-order.mjs` 新增静态钩子顺序检查(React 只在运行时报 #310,构建与 `tsc` 不会)。
|
|
120
|
+
- **文档**:新增 `docs/author/`(中英俄三语的作者向设计文档与插图,留在仓库不进包)、`docs/tech-debt.md`;工具数 22 → 23 同步到 README(中英)与落地页。
|
|
121
|
+
|
|
122
|
+
### ⚠️ 升级说明:存量库需要重建向量
|
|
123
|
+
|
|
124
|
+
**升级后默认嵌入模型从 512 维的 `bge-small-zh` 变为 384 维的 `minilm-l12`(多语言)。** 宫殿语言为中文的库不受影响(`registry/bindings.json` 里 zh 仍绑定 bge-small-zh 512 维);其余语言的库——包括语言未设、回落默认(`ru`)的库——会落到 384 维的多语言模型。
|
|
125
|
+
|
|
126
|
+
**两套向量不可比,维度也不一致。** 仍在旧模型上的库写入时会被拒绝(`store.embedderDimensionMismatch`:比较与写入都拒绝,不做静默截断)——**如果不重建,升级看起来就像「坏了」**。处理办法二选一:
|
|
127
|
+
|
|
128
|
+
- 用新模型重建:`pnpm backfill --force`(重建全部向量;不带 `--force` 时脚本在写入前就发现维度不符并报错退出,绝不会写出混合维度的库);
|
|
129
|
+
- 或把模型改回去:在配置里写 `embedder.localModel: 'Xenova/bge-small-zh-v1.5'`(此时与旧库同维,可继续用)。
|
|
130
|
+
|
|
131
|
+
想按语言分别用不同模型,改 `registry/bindings.json` 即可,无需动代码。
|
|
14
132
|
|
|
15
133
|
## [0.9.9] - 2026-10-23
|
|
16
134
|
|
|
@@ -208,7 +326,8 @@ _暂无。_
|
|
|
208
326
|
|
|
209
327
|
- 首个可用版本:`engram_*` 工具集、插件入口、画像注入、SQLite + FTS5 + 关系边 + op log 的本地存储。
|
|
210
328
|
|
|
211
|
-
[Unreleased]: https://github.com/kenz1117/dsh-engram/compare/v0.
|
|
329
|
+
[Unreleased]: https://github.com/kenz1117/dsh-engram/compare/v0.10.0...HEAD
|
|
330
|
+
[0.10.0]: https://github.com/kenz1117/dsh-engram/compare/v0.9.9...v0.10.0
|
|
212
331
|
[0.9.9]: https://github.com/kenz1117/dsh-engram/compare/v0.9.8...v0.9.9
|
|
213
332
|
[0.9.8]: https://github.com/kenz1117/dsh-engram/compare/v0.9.7...v0.9.8
|
|
214
333
|
[0.9.7]: https://github.com/kenz1117/dsh-engram/compare/v0.9.6...v0.9.7
|
package/README.en.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
<p align="center"><b>Local-first long-term memory for your coding agent.</b><br>
|
|
8
8
|
Cross-session long-term memory on plain local SQLite: <b>no external service, no API key, no Docker</b> — one command and it works.<br>
|
|
9
|
-
|
|
9
|
+
23 narrow-parameter tools · hybrid retrieval (FTS5 + local vectors, RRF) · an evidence gate · full provenance audit · SM-2 spaced-repetition review · a zh / en / ru panel.</p>
|
|
10
10
|
|
|
11
11
|
<p align="center">
|
|
12
12
|
<a href="https://github.com/kenz1117/dsh-engram/blob/main/LICENSE"><img alt="GitHub license" src="https://img.shields.io/github/license/kenz1117/dsh-engram"></a>
|
|
@@ -72,7 +72,7 @@ Plenty of memory plugins exist, but most want you to stand up infrastructure fir
|
|
|
72
72
|
|---|---|---|---|
|
|
73
73
|
| Setup cost | One npm command, **works immediately** | Docker + database + vector store + migrations | One npm command |
|
|
74
74
|
| External dependencies | **None**: embeddings run offline and degrade to keyword-only with an explicit marker | Required, usually plus an LLM API key | None |
|
|
75
|
-
| Agent-facing tools | **
|
|
75
|
+
| Agent-facing tools | **23 narrow-parameter tools** across the whole lifecycle — save, search, fact chains, timelines, audit, export, distill, beliefs, review | Usually 1–3 (search only) | Usually 0–1 |
|
|
76
76
|
| Evidence gate | **Yes**: `engram_assess` is enforced in code — "claims sufficient" + at least one valid ref from this batch + `nextStrategy=answer` | Generally none | Generally none |
|
|
77
77
|
| Audit | Session/turn/seq provenance, supersede chains, contradiction edges, full `op_log` | Usually logs only | None |
|
|
78
78
|
| Review | **SM-2 spaced repetition**: coordinates and placard cues only, never the body — recall first, reveal later | None | None |
|
|
@@ -196,6 +196,7 @@ Sensory and emotional dimensions (smell, temperature, emotional weight) are deli
|
|
|
196
196
|
| `engram_distill` | Distill: merge same-topic clusters into higher-level rules (LLM) |
|
|
197
197
|
| `engram_reflect` | Belief consolidation: abstract unconsolidated raw memories into proof-backed higher-level beliefs (four actions form/refine/still/refute; automatic vector-near-neighbor merging; raw memories stay active). Also drains the pending-consolidation queue created by reflect=suggest |
|
|
198
198
|
| `engram_profile_edit` | Edit the curated profile block: `view` shows the current content and version history; `edit` writes a new version (optimistic lock via `expectedVersion`, conflicts fail loud); `rollback` restores a historical version (appended as a new version; history is never rewritten). The curated profile is injected ahead of the derived profile; every edit lands in the operation log, and the profile card on the panel's Today view shows version diffs |
|
|
199
|
+
| `engram_language_guide` | Output the plugin language guide (the body of `<package-root>/docs/agent-language-guide.ru.md`). The first-run window promises a human whose language is not built in that the agent will print an instruction; this tool keeps that promise. The source text is written in Russian as a draft — the agent translates it into the asker's language itself |
|
|
199
200
|
|
|
200
201
|
## Configuration
|
|
201
202
|
|
|
@@ -337,7 +338,7 @@ Each turn's first step appends a plugin-source user snapshot: `User memory profi
|
|
|
337
338
|
|
|
338
339
|
#### Token effect
|
|
339
340
|
|
|
340
|
-
Profile injection is a conditional fixed cost (bounded by both the entry cap and the token budget); the tool schemas are a standing cost (
|
|
341
|
+
Profile injection is a conditional fixed cost (bounded by both the entry cap and the token budget); the tool schemas are a standing cost (23 narrow-parameter tools).
|
|
341
342
|
|
|
342
343
|
#### KV Cache effect
|
|
343
344
|
|
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
<p align="center"><b>Local-first long-term memory for your coding agent.</b><br>
|
|
8
8
|
纯本地 SQLite 的跨会话长期记忆:<b>零外部服务 · 零 API Key · 零 Docker</b>,一条命令装完即用。<br>
|
|
9
|
-
|
|
9
|
+
23 个窄参数工具 · 混合检索(FTS5 + 本地向量 RRF)· 证据门 · 全链路审计 · SM-2 间隔重复复习 · 面板中英俄文。</p>
|
|
10
10
|
|
|
11
11
|
<p align="center">
|
|
12
12
|
<a href="https://github.com/kenz1117/dsh-engram/blob/main/LICENSE"><img alt="GitHub license" src="https://img.shields.io/github/license/kenz1117/dsh-engram"></a>
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
- [界面速览](#界面速览)
|
|
33
33
|
- [宫殿结构:目录即房间,路径即路线](#宫殿结构目录即房间路径即路线)
|
|
34
34
|
- [特性](#特性)
|
|
35
|
-
- [工具(
|
|
35
|
+
- [工具(23 个,窄参数)](#工具23-个窄参数)
|
|
36
36
|
- [配置](#配置)
|
|
37
37
|
- [工作原理](#工作原理)
|
|
38
38
|
- [Web 管理面板](#web-管理面板)
|
|
@@ -61,7 +61,7 @@ dsh plugin --profile web add @kenz1117/dsh-engram
|
|
|
61
61
|
请执行这条命令安装 dsh-engram(DeepSeek Harness 的跨会话长期记忆插件):
|
|
62
62
|
dsh plugin --profile web add @kenz1117/dsh-engram
|
|
63
63
|
装完后确认插件中心出现「记忆宫殿」侧栏入口,并在新会话里用 engram_stats
|
|
64
|
-
确认已注册
|
|
64
|
+
确认已注册 23 个 engram_* 工具。
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
## 为什么是它
|
|
@@ -72,7 +72,7 @@ dsh plugin --profile web add @kenz1117/dsh-engram
|
|
|
72
72
|
|---|---|---|---|
|
|
73
73
|
| 安装成本 | 一条 npm 命令,**装完即用** | Docker + 数据库 + 向量库 + 迁移 | 一条 npm 命令 |
|
|
74
74
|
| 外部依赖 | **无**:嵌入模型离线推理,失败自动降级纯关键词并显式标记 | 必装,通常还要 LLM API Key | 无 |
|
|
75
|
-
| agent 工具面 | **
|
|
75
|
+
| agent 工具面 | **23 个窄参数工具**,覆盖保存/检索/事实链/时间线/审计/导出/蒸馏/信念/复习全生命周期 | 常见 1–3 个(只给检索) | 常见 0–1 个 |
|
|
76
76
|
| 证据门 | **有**:`engram_assess` 由代码强制「声称充足 + 本批次有效证据 + nextStrategy=answer」三者齐备才判充足 | 一般无 | 一般无 |
|
|
77
77
|
| 审计 | 来源会话/轮次/seq 三级溯源 + 取代链 + 矛盾边 + op_log 全量流水 | 通常只有日志 | 无 |
|
|
78
78
|
| 复习 | **SM-2 间隔重复**:只给坐标与门牌线索,不给正文,先回忆后揭示 | 无 | 无 |
|
|
@@ -172,7 +172,7 @@ DeepSeek Harness 跨会话长期记忆插件 —— 把记忆宫殿的**信息
|
|
|
172
172
|
- **数据可携带**:`engram_export` 一键导出 Markdown / JSON 文件,支持脱敏视图(内容二次清洗 + 预览截断,分享安全)。`engram_mirror` 导出可漫游的镜像目录(Obsidian / Logseq 友好:每条记忆一个 Markdown,正文 + YAML frontmatter + 双向链接 `[[id]]`),让「宫殿」也成为可人读的私人知识库。
|
|
173
173
|
- **认知架构探索(dsh-market · AGI 架构探索)**:本仓库是 dsh-market「AGI 架构探索」类目下,对 agent 长期记忆的认知科学方法论重构——记忆宫殿(意象标签 + 房间铭牌)、走廊拓扑(力导向图)、闭环提问(摄入时让模型主动追问用户细节)、巩固合并(启发式去重 + 余弦相似度),与 MemGPT/Letta 同层「agent 记忆架构」叙事。
|
|
174
174
|
|
|
175
|
-
## 工具(
|
|
175
|
+
## 工具(23 个,窄参数)
|
|
176
176
|
|
|
177
177
|
| 工具 | 作用 |
|
|
178
178
|
|---|---|
|
|
@@ -197,6 +197,7 @@ DeepSeek Harness 跨会话长期记忆插件 —— 把记忆宫殿的**信息
|
|
|
197
197
|
| `engram_distill` | 蒸馏:同主题簇合并为高层规律(LLM) |
|
|
198
198
|
| `engram_reflect` | 信念巩固:把尚未巩固的原始记忆经辅助 LLM 抽象为带证据数的高层信念(form/refine/still/refute 四动作,向量近邻自动归并,原始记忆保留不归档);同时是 reflect=suggest 待巩固登记的执行出口 |
|
|
199
199
|
| `engram_profile_edit` | 画像 curated block 编辑:`view` 看当前内容与版本历史;`edit` 写入新版本(乐观锁 `expectedVersion`,冲突 loud 失败);`rollback` 回滚到历史版本(作为新版本追加,历史永不改写)。curated 画像优先于派生画像注入;编辑记录入操作日志,面板今日页画像卡可查版本 diff |
|
|
200
|
+
| `engram_language_guide` | 输出插件语言指南(`<包根>/docs/agent-language-guide.ru.md` 的正文)。首启时对未内置语言的人承诺「agent 会输出一份说明」,这份承诺由本工具兑现;正文以俄文写成草稿,由 agent 按提问者的语言自行翻译 |
|
|
200
201
|
|
|
201
202
|
## 配置
|
|
202
203
|
|
|
@@ -339,7 +340,7 @@ pnpm test
|
|
|
339
340
|
|
|
340
341
|
#### Token effect
|
|
341
342
|
|
|
342
|
-
画像注入为条件性固定成本(受条数上限与 token 预算双重约束);工具 schema 为常驻成本(
|
|
343
|
+
画像注入为条件性固定成本(受条数上限与 token 预算双重约束);工具 schema 为常驻成本(23 个窄参数工具)。
|
|
343
344
|
|
|
344
345
|
#### KV Cache effect
|
|
345
346
|
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
# Как ввести новый язык дворца — инструкция для агента (черновик)
|
|
2
|
+
|
|
3
|
+
**Черновик, только по-русски.** Это текст, который агент читает из плагина и переводит на язык
|
|
4
|
+
пользователя. Английская и китайская версии не сделаны намеренно: сначала проверяем содержание
|
|
5
|
+
на одном языке.
|
|
6
|
+
|
|
7
|
+
## Кому
|
|
8
|
+
|
|
9
|
+
Пользователю, чьего языка нет среди вшитых (`zh`, `en`). Окно первого запуска в этом случае
|
|
10
|
+
записывает дворцу настоящий код его языка (например `fr`) и говорит: «попросите агента вывести
|
|
11
|
+
инструкцию». Эта инструкция — то, что агент должен прочитать и выполнить вместе с человеком.
|
|
12
|
+
|
|
13
|
+
## Что важно понять до начала
|
|
14
|
+
|
|
15
|
+
1. **Язык дворца — данные, а не код.** Ничего пересобирать не нужно: язык объявляется файлом
|
|
16
|
+
реестра, его тексты приходят файлами словарей.
|
|
17
|
+
2. **Смена языка и пересчёт баз — одно действие.** Человек выбирает язык, снимает предохранитель
|
|
18
|
+
и нажимает «Выполнить». Всё это в одном окне (по умолчанию 30 секунд, настройка
|
|
19
|
+
`palaceChangeWindowSec`). Раньше условия не выполняются — язык не меняется, базы не трогаются.
|
|
20
|
+
3. **Ничего не пишем руками в пакет плагина.** Правки живут в каталоге данных:
|
|
21
|
+
`<dbDir>/registry/*.json` и `<dbDir>/i18n/*.txt` (по умолчанию `~/.dsh/engram`).
|
|
22
|
+
|
|
23
|
+
## Порядок
|
|
24
|
+
|
|
25
|
+
### 1. Узнать код языка
|
|
26
|
+
|
|
27
|
+
Код — первые две-три латинские буквы локали: `fr`, `de`, `pt`, `zh-Hans`. Проверьте, что такого
|
|
28
|
+
языка ещё нет: в панели «Обслуживание» список языков приходит из реестра.
|
|
29
|
+
|
|
30
|
+
### 2. Объявить язык в реестре
|
|
31
|
+
|
|
32
|
+
Файл `<dbDir>/registry/languages.json`; если его нет — создайте. Формат:
|
|
33
|
+
|
|
34
|
+
```json
|
|
35
|
+
{
|
|
36
|
+
"languages": [
|
|
37
|
+
{ "code": "fr", "label": "Français", "builtin": false }
|
|
38
|
+
]
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Строка этого файла заменяет строку с тем же кодом и добавляется, если кода ещё нет: полный список
|
|
43
|
+
поставки повторять не нужно. `builtin` — есть ли у плагина вшитые тексты; для нового языка всегда
|
|
44
|
+
`false`.
|
|
45
|
+
|
|
46
|
+
После этого язык виден и в списке языков дворца, и в переключателе языка интерфейса.
|
|
47
|
+
|
|
48
|
+
### 3. Привязать язык к модели
|
|
49
|
+
|
|
50
|
+
Файл `<dbDir>/registry/bindings.json` (слой пользователя):
|
|
51
|
+
|
|
52
|
+
```json
|
|
53
|
+
{
|
|
54
|
+
"bindings": [
|
|
55
|
+
{ "language": "fr", "model": "Xenova/paraphrase-multilingual-MiniLM-L12-v2" }
|
|
56
|
+
]
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Если для языка уже действует умолчание `*`, эта строка не нужна. Модель должна быть в каталоге
|
|
61
|
+
`registry/models.json` — иначе плагин скажет, что привязка не работает.
|
|
62
|
+
|
|
63
|
+
### 4. Завести словари и заполнить их
|
|
64
|
+
|
|
65
|
+
Словари — файлы `<dbDir>/i18n/<код>.txt` (служебные сообщения) и `<dbDir>/i18n/panel.<код>.txt`
|
|
66
|
+
(тексты панели). Пустой словарь — это файл с одним заголовком; отдельного «создать словарь» нет,
|
|
67
|
+
его создаёт первое сохранение.
|
|
68
|
+
|
|
69
|
+
Дальше — панель: «Обслуживание» → «Словарь» → выбрать набор → кнопка **«Перевести»**. Она
|
|
70
|
+
отправляет рабочей модели только те клетки, где перевода нет, и держит терминологию по уже
|
|
71
|
+
принятым парам. Заполнение идёт партиями, его можно остановить; файл меняет «Сохранить», а не
|
|
72
|
+
модель.
|
|
73
|
+
|
|
74
|
+
Что сказать человеку: словарь не обязан быть полным с первого раза. Нет строки — показывается
|
|
75
|
+
английский текст, плагин работает.
|
|
76
|
+
|
|
77
|
+
### 5. Сменить язык дворца собранным условием
|
|
78
|
+
|
|
79
|
+
Панель «Обслуживание» → блок «Язык дворца»:
|
|
80
|
+
|
|
81
|
+
1. выберите язык;
|
|
82
|
+
2. снимите предохранитель;
|
|
83
|
+
3. нажмите «Выполнить» — и всё это в пределах окна (по умолчанию 30 секунд с первого действия).
|
|
84
|
+
|
|
85
|
+
Окно истекло — выбор возвращается к языку, на котором стоят базы, предохранитель встаёт обратно.
|
|
86
|
+
Язык записывается в конфигурацию плагина, метки баз переписываются на новый язык, векторы
|
|
87
|
+
пересчитываются на модель нового языка. Всё это делает один запрос: раздельных «сначала язык,
|
|
88
|
+
потом базы» нет намеренно.
|
|
89
|
+
|
|
90
|
+
### 6. Проверить
|
|
91
|
+
|
|
92
|
+
- В карточке обслуживания язык дворца — новый, а рядом нет строки «применится после перезапуска».
|
|
93
|
+
- В таблице баз состояние у всех `normal`, чужих векторов и записей без вектора нет.
|
|
94
|
+
- Откройте любую запись: текст на новом языке, поиск находит по словам этого языка.
|
|
95
|
+
|
|
96
|
+
## Чего не делать
|
|
97
|
+
|
|
98
|
+
- Не менять файлы внутри пакета плагина: они перезапишутся обновлением.
|
|
99
|
+
- Не запускать пересчёт векторов вручную в обход условия: тогда язык и базы разъедутся, и
|
|
100
|
+
дворец будет писать тексты на одном языке, а искать по векторам другого.
|
|
101
|
+
- Не выставлять язык дворца раньше, чем появился словарь: служебные надписи будут английскими,
|
|
102
|
+
и человек решит, что язык не сработал.
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// Словарь панели dsh-engram: русский.
|
|
2
|
+
// Слева — ровно та строка, что стоит в коде (src/client/locales/en.ts), справа — перевод.
|
|
3
|
+
// Формат тот же, что у словаря сообщений (i18n/ru.txt): <слева><TAB><справа>.
|
|
4
|
+
// Этот файл главнее вшитых в сборку текстов: нет строки — берётся вшитый перевод.
|
|
5
|
+
// Пользовательский слой: <каталог данных>/i18n/panel.ru.txt перекрывает этот файл.
|
|
6
|
+
//
|
|
7
|
+
// Первая строка заголовка намеренно отличается от вшитого текста: так видно,
|
|
8
|
+
// что карточка говорит из файла, а не из сборки.
|
|
9
|
+
|
|
10
|
+
Model and dictionaries Модель и словари (словарь панели)
|
|
11
|
+
What this palace counts with, and which dictionary files were read Чем считается содержимое дворца и из каких файлов прочитаны словари
|
|
12
|
+
Embedding model: Модель эмбеддингов:
|
|
13
|
+
remote endpoint (the catalog is not used) удалённый конец (каталог не используется)
|
|
14
|
+
Model catalog Каталог моделей
|
|
15
|
+
Language → model Язык → модель
|
|
16
|
+
Dictionary files Файлы словарей
|
|
17
|
+
panel панель
|
|
18
|
+
messages сообщения
|
|
19
|
+
read from прочитано из
|
|
20
|
+
lines accepted принято строк
|
|
21
|
+
complaints претензии
|
|
22
|
+
none нет
|
|
23
|
+
Loading… Читаю…
|
|
24
|
+
Could not read the registry Не удалось прочитать реестр
|
|
25
|
+
label метка
|
|
26
|
+
model id идентификатор модели
|
|
27
|
+
dims размерность
|
|
28
|
+
pooling · weights сведение · веса
|
|
29
|
+
model locale выбранная локаль модели
|
|
30
|
+
palace language язык Дворца памяти
|
|
31
|
+
Palace bases Базы дворца
|
|
32
|
+
What each base stands on, and what the button will do На чём стоит каждая база и что сделает кнопка
|
|
33
|
+
base база
|
|
34
|
+
state состояние
|
|
35
|
+
records записей
|
|
36
|
+
no vector без вектора
|
|
37
|
+
wrong length чужой длины
|
|
38
|
+
vector length длина вектора
|
|
39
|
+
no base yet базы ещё нет
|
|
40
|
+
empty пустая
|
|
41
|
+
in order в порядке
|
|
42
|
+
no label метки нет
|
|
43
|
+
another model другая модель
|
|
44
|
+
mixed vectors пересортица векторов
|
|
45
|
+
records without a vector записи без вектора
|
|
46
|
+
not checked не проверено
|
|
47
|
+
Run Выполнить
|
|
48
|
+
Writing… Пишу…
|
|
49
|
+
Temporary guard against base conversion Временный предохранитель от конвертации баз
|
|
50
|
+
The base is in order. Nothing to do. База в порядке, действие не требуется.
|
|
51
|
+
The base label {label} will be written. Будет записана метка базы {label}.
|
|
52
|
+
The vectors will be recomputed — not wired up yet (stage 2 of block B). Будет выполнен пересчёт векторов — пока не подключён (этап 2 блока Б).
|
|
53
|
+
The records without a vector will be filled in — not wired up yet (stage 2 of block B). Будут дозаполнены векторы записей без вектора — пока не подключено (этап 2 блока Б).
|
|
54
|
+
Label written: {label} Метка записана: {label}
|
|
55
|
+
Could not write the base label Не удалось записать метку базы
|
|
56
|
+
bases do not exist yet: {n} — the author's code creates them баз ещё нет: {n} — их создаёт код автора
|
|
57
|
+
The schema declaration did not load: base states are unknown. Объявление схемы не прочитано: состояние баз неизвестно.
|