dsh-plugin-xujie-memory 0.5.0 → 0.7.0

package/ACCEPTANCE.md

@@ -0,0 +1,37 @@
+# 0.7.0 · DSH 0.2.1-rc.5 验收
+
+## 已验证的范围
+
+- 17 项 Python 回归 + 13 项 Node 桥接检查通过；另用原始 0.6 内核创建临时旧库，确认真实升级备份、旧摘要修复、活跃数据保留及升级后编辑。
+- Windows 隔离 DSH Web 宿主以 2000 条模拟原话验证图形上限及图外搜索；抽查不同时间的 8 条均命中，并验证旧记录编辑、删除和重启后持久性。10 路并发执行 20 次写入、20 次图快照和 60 次搜索，全部成功。这不是原生桌面客户端验收或大规模长期运行保证。
+- 临时真实 SQLite / 本地 HTTP：搜索、原子编辑与替代记录、派生画像、删除/摘要清理、跨用户/跨会话隔离、冲突、并发、故障回滚、升级备份与旧残留修复。
+- Host 桥接：使用 Cordis DI 测试替身并连接真实 Python 内核；校验正式生成的 DTO codecs，测试四个工具、owner 限制、缓存隔离/失效及持久化读写。
+- 前端：最终实际构建的 ModuleLoader factory + 共享 React + 测试 main/slots + 临时真实 Python 内核；覆盖旋转、拖转、缩放、搜索、编辑保存、遗忘确认、证据跳转、冲突、空/错误/无权限/加载、减少动态和 390px 窄屏。测试夹具不进入生产前端。
+- 这些测试不等价于启动用户日常使用的 DSH 桌面宿主；未读取真实用户数据库。
+
+## 必须在用户桌面确认
+
+1. 保留 0.6.0 原包和记忆数据备份，以原 profile 安装升级包并重启 rc.5。
+2. 左侧出现「记忆」；点击后在 DSH 当前应用内部显示页面，不开外部窗口；折叠导航后图标仍可用。
+3. 看真实 scope 和三层记录；空库不得出现演示人物或虚假记忆。图外旧记录能由搜索打开。
+4. 旋转/拖拽/缩放、自转暂停与重置；三层结构可辨；搜索能定位；小窗口布局与减少动态效果可用。
+5. 选一条无关紧要的测试记忆，编辑后保存。刷新页面、重启 DSH 再搜索，须看到新内容；原 trace 失效，画像/召回不再使用旧事实。
+6. 两处打开同一条记录，第一处修改后第二处保存旧版本，必须提示冲突或记录已替换，而不是覆盖。
+7. 删除需确认；刷新/重启后搜索与召回不再命中，相关摘要与画像不再活跃。
+8. 正常对话仍能写入记忆；自动注入不带回已纠正/已删旧材料；记忆内核故障不得阻塞对话。
+9. 禁用/卸载插件后，侧栏、样式和 Remote 注册应回收，无遗留动画和多余进程。
+
+## 删除与回滚的实际含义
+
+- 遗忘是应用层清理，不是磁盘安全擦除，也不删除 DSH 聊天历史。
+- 首次迁移备份 `<dbPath>.pre-0.7.0.bak` 保留迁移前数据，必须私密保存。删除操作不会修改旧备份。
+- 回滚先退出 DSH/内核，保留当前库另存一份，再按需恢复备份与 0.6.0 包。备份之后的新记忆不在旧备份中；不要直接覆盖正在使用的库。
+
+## 界面语义
+
+- 光纤、胞体及脉冲是结构性视觉隐喻，不是额外的真实记录；节点计数只统计真实投影。
+- 原话可编辑/忘记；状态、摘要、待澄清项只读，可跳转依据。人设卡由真实库推导，并非独立修改表单。
+- 当前详情时间显示记录版本的 recorded_at；编辑保留内核原始发生时间，但界面显示新版本记录时间。
+- 图默认最近 250 条原话；管理界面搜索当前记忆库的全部有效原话，对话自动召回仍保留最近 800 条候选上限。
+
+最终补充验证：窄屏真实滚轮滚动、触屏手势（代理保存的记录）、切换节点加载时不暴露旧记录操作、同一原话锚点别名切换、卸载回收；桌面/390px 的 24 个三维视角均无层标签重叠或出界。

package/BUILD-PROVENANCE.json

@@ -0,0 +1,53 @@
+{
+  "package": "dsh-plugin-xujie-memory",
+  "version": "0.7.0",
+  "status": "acceptance-candidate-not-desktop-certified",
+  "baseline_sha256": "1e5bbc74cd3208be1066c164ecd8560d60a02e8a8be7a042aa4500a0e7b7c410",
+  "target_dsh": "0.2.1-rc.5",
+  "official_source": "https://github.com/deepseek-ai/deepseek-harness",
+  "official_tag": "dsh-v0.2.1-rc.5",
+  "official_commit": "b830ec950faba0a46dda564be3e2d854afed94f1",
+  "remote_contract_generator": "official rc.5 WorkspaceTypertGenerator; minimal SDK declaration fixture for build; concrete DTO schemas generated and tested",
+  "runtime_rpc": "generated strict descriptors, copied MIT protocol helpers; host-shared Cordis peer",
+  "test_boundary": "real temporary SQLite and HTTP; Node DI test double; not a desktop launcher test",
+  "windows_runtime": "preserved from supplied 0.6.0; not executed on Linux",
+  "frontend": {
+    "implementation": "Opus 5.5 delegated frontend rewrite",
+    "rendering": "3D coordinate projection; soma/dendrites/axon, depth, pulsing light; decorative morphology is not memory data",
+    "validation": "built CJS module-loader factory; simulated DSH main/slots with shared React and actual temporary Python kernel; visual states and motion/drag/zoom/reduced-motion checked",
+    "desktop_certification": false,
+    "final_integration_fixes": [
+      "native scroll in stacked/narrow layout and touch gesture arbitration",
+      "no stale detail mutation during selection/loading; save/delete selection lock",
+      "same-trace alias selection reload",
+      "screen-space three-layer caption collision avoidance"
+    ],
+    "final_parent_qa": {
+      "real_factory": true,
+      "real_temporary_kernel_save_delete": true,
+      "selection_race": true,
+      "same_trace_alias": true,
+      "unload_cleanup": true,
+      "mobile_wheel_scroll": true,
+      "reduced_motion": true,
+      "caption_layouts": 24,
+      "console_errors": 0
+    }
+  },
+  "regression_results": {
+    "python_unittests": 17,
+    "node_bridge_checks": 13,
+    "actual_supplied_060_database_upgrade": "passed with temporary database; consistent backup, active data retention, residual summary repair and subsequent edit",
+    "real_user_data_accessed": false,
+    "windows_runtime_bytes": "identical to supplied baseline"
+  },
+  "stress_verification": {
+    "windows_isolated_dsh_web": true,
+    "synthetic_active_traces": 2000,
+    "old_and_new_search_checks": "8/8",
+    "concurrent_http_requests": 100,
+    "concurrent_workers": 10,
+    "desktop_client_certified": false,
+    "description": "Management search scans all active traces in the selected scope; automatic recall remains capped at 800 candidates."
+  }
+}

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Changelog
 
+## 0.7.0（DSH 0.2.1-rc.5 验收构建）
+
+- 修复管理界面搜索只能查到最近 800 条原话的问题；自动对话召回仍保留原候选上限。
+- 增加 2000 条记忆的搜索回归和隔离环境并发压力验证。
+- 正式双端插件清单、Host owner-only Remote 服务与应用内记忆面板接入。
+- 原子替换式编辑、版本冲突检测、新增 memory_edit 工具。
+- 遗忘清理摘要、澄清与关联投影；旧库迁移备份及残留修复。
+- 按用户隔离提示词回退缓存；内核操作统一排队，避免编辑与对话写入竞争。
+- 三维旋转/拖拽、三层记忆、模糊搜索、人设卡与持久化管理。
+- 新建测试集；不沿用旧 CHANGELOG 中已丢失测试集的通过数。
+- Windows DSH 桌面真机验收待完成，不宣称已通过。
+
+## 0.6.0（内核 0.52.0）
+
+### 发布前修复
+- 修正三个工具的输出 schema，使其符合 DSH 的原始 JSON Schema 校验。
+- 工具使用实际会话标识与账户，删除后刷新画像投影并清除注入缓存。
+- 移除包内 Python 字节码缓存；新增删除后画像回归测试。
+- 暂无记忆编辑工具和图形化管理界面。
+
+### 新增：主动工具（三个）
+- `memory_search`：按字面/错字模糊检索记忆原话，返回内容、`trace_id` 与权重。只读。
+- `memory_forget`：删一条记忆——软删（内容清空、FTS 移除、依赖它的事实失效并重算，`erased_at` 留审计）。用户说「忘掉这条」时用。
+- `memory_status`：原话/已删/状态/锚点/未确认计数 + 内核健康信息。只读。
+- 内核新增 `POST /memory/forget`、`POST /memory/stats`；`memory.py` 增加 `forget()` 与 `stats()`。
+- 宿主没有 `tools` 服务时静默跳过注册，不影响原本的注入。
+
+### 修复：回声
+- 当前这句不再被当成「相关的旧事」注回去：`/turn` 用 `trace_id` 挡，`/context` 只拿得到文本，改为按内容挡（忽略空白与标点）。两条路都经过 `_recall`，挡在源头。
+- `_recent` 兜底同样过滤当前句，避免同一句被记两笔时漏网。
+
+### 测试
+- 新增 `test/echo.test.mjs`：同句、同句不同标点都不出现；换成无关问句时旧记忆照常出现（消回声不能消记忆）。
+- 新增 `test/tools.test.mjs`：三个工具对真内核跑通——检索 → 删除 → 搜不到 → 已删计数 +1；不存在的 `trace_id` 返回错误。
+- 修 `test/smoke.test.mjs` 的测试替身：插件现在有两组 effect，替身只存最后一个 disposer 会漏掉内核，进程留成孤儿占端口和 sqlite 文件。
+
+### 说明
+- Windows x64 默认使用包内运行时；其他平台使用系统 Python。测试在仓库的内核目录中运行。
+
 ## 0.5.0（内核 0.52.0）
 
 ### 性能
@@ -21,7 +60,7 @@
 - 默认 `scope: user`：画像、偏好、锚点、账跨会话共享；追问熔断仍然按会话计算。`scope: session` 可恢复旧行为。
 - 去掉 session 模式下的跨会话 `lastContext` 兜底。
 
-### 准确率（回归集 `test/kernel_regression.py`，31/31）
+### 历史准确率（原回归集 31/31，因沙箱重置丢失，目前无法复现）
 - 问句不再生成事实（「你还记得我欠谁钱吗」）。
 - 「还/本/书/瓶」等单字不再触发记账；日期里的数字（周五、四月）不再当成数量。
 - 无领域词的闲聊（「哈哈」「我女朋友叫小美」）不再落成偏好。

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Shoren-Syi
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Shoren-Syi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,36 @@
+# Xujie Memory 0.7.0 · DSH 应用内记忆工作台
+
+**目标版本：DeepSeek Harness 0.2.1-rc.5。当前为开发验收构建，尚未在用户的 Windows 桌面宿主上完成真机验收。**
+
+## 0.7 新增
+
+- 通过正式 `dsh.client`、`sidebar.panellist` / `main` 插槽提供应用内部的「记忆」页，不另开网站。
+- 三层神经网络界面、原话模糊搜索、人设卡和记忆正文编辑/删除；可见范围来自真实 SQLite 库。
+- 所有管理 Remote 仅允许经过 DSH 验证的 owner 调用。浏览器不持有内核 token，也不直连内核端口。
+- 编辑并非覆盖不可变原话：一次 SQLite 事务中失效旧依据、写入替代原话并重新编码、重算事实与画像、刷新检索。返回的新 trace_id 会替代旧节点。发生时间保留，编辑时间单独留审计。
+- 新增 `memory_edit` 工具。先用 `memory_search` 获取 trace_id 与 content_hash，再带 expected_hash 纠正，冲突时拒绝覆盖。
+- 图中结构性纤维仅作视觉骨架；事实连线来自 evidence、摘要来源、锚点和工作记忆投影，不声称推断出了真实神经/语义关系。
+
+## 数据与升级边界
+
+继续使用原来的 dbPath；默认 `~/.xujie-memory/memory.db`。首次迁移旧库前，会生成 SQLite 一致性备份 `<dbPath>.pre-0.7.0.bak`（不覆盖已有备份）。随后修复旧版遗忘操作可能留下的摘要等派生残留。
+
+**备份含迁移前数据，应私密保存。**「遗忘」清理应用记忆库及依赖投影，不等于安全擦除磁盘，不会删除 DSH 聊天记录、外部导出、旧备份或磁盘/WAL 历史。
+
+所有编辑/删除必须等内核成功响应后才视为保存。失败或版本冲突时不显示假成功；版本冲突需要重新加载。图形默认仅展示最近 250 条原话及部分派生节点，超出范围会标明；管理界面搜索覆盖当前记忆库全部有效原话。对话中的自动召回仍使用最近 800 条候选的上限。
+
+## 验收与开发
+
+按安装 0.6.0 时同一 profile 和方式安装本包/解压目录，然后重启 DSH。不要删除记忆数据目录。侧栏应出现「记忆」。逐项验收见 `ACCEPTANCE.md`。
+
+`npm install` 安装开发依赖后，`npm run build` 构建浏览器 factory 与 Host 控制器，`npm test` 运行真实临时 SQLite/HTTP 回归及使用 DI 测试替身的 Host 桥接检查。Windows 默认使用包内 Python；其他平台用 python3，或设置 PYTHON。测试不会读取用户实际记忆库。使用正式 rpc 生成物；变更 Remote 签名必须重新运行与 rc.5 对应的 Typert 生成流程，不能只改客户端。
+
+本包保留原 0.6.0 的 Windows x64 Python 运行时；本次 Linux 环境未执行该 Windows 运行时。官方接口取自 `dsh-v0.2.1-rc.5`，commit `b830ec950faba0a46dda564be3e2d854afed94f1`。详细构建来源见 `BUILD-PROVENANCE.json`。
+
+---
+
+## 原有内核使用说明（已更新到 0.7）
+
 # dsh-plugin-xujie-memory
 
 [English](README_EN.md) | 简体中文
@@ -39,10 +72,9 @@ flowchart LR
 2. 把"这个人是谁、我现在记得什么、他专门交代过要记住什么"注入提示词
 3. 你没说清楚的地方，**最多问一次**，问过就不再提
 
-它不是"给模型一个 `memory_search` 工具"——工具要模型自己想起来用，
-而记忆的价值恰恰在于**不用想**。
+记忆会自动注入；需要主动查找或删除时，也可以使用下方工具。
 
-### 三层记忆（当前版本 0.5.0）
+### 三层记忆（0.7.0）
 
 | 层 | 内容 | 你怎么用 |
 |---|---|---|
@@ -61,30 +93,47 @@ flowchart LR
 **模糊搜索**：`POST /memory/search`，两字词、错一个字都能捞；
 精确检索落空时，自动注入也会降级到模糊匹配。
 
-本仓库保留 0.5.0 发布包中的内核；上表概括了三层记忆。
+0.7 以内核 0.52.0 为基线扩展管理接口与一致性逻辑；上表概括了三层记忆。
+
+**当前这句不会被当成旧事注回去（0.6 修复）**：`/turn` 用 trace_id 挡，`/context` 只拿得到文本、按内容挡（忽略空白与标点）。换成问别的事，旧记忆照常出现。
+
+---
+
+## 主动工具（0.7）
+
+注入是自动的，但**主动回忆**和**删掉记错的东西**需要有手。0.7 给模型注册了四个工具：
+
+| 工具 | 作用 | 副作用 |
+|---|---|---|
+| `memory_search` | 按字面/错字模糊检索原话，返回内容、`trace_id`、`content_hash`、权重 | 只读 |
+| `memory_edit` | 以 `trace_id`、正文和 `expected_hash` 原子纠正原话 | 写，返回新 trace_id |
+| `memory_forget` | 删一条记忆（软删：内容清空、FTS 移除、依赖它的事实失效并重算） | 写，`erased_at` 留审计 |
+| `memory_status` | 原话/已删/状态/锚点/未确认计数 + 内核健康 | 只读 |
+
+用户说「忘掉这条」时，模型可以自己搜到 `trace_id` 再删，不需要你手动清库。
+对应内核接口：`POST /memory/search`、`POST /memory/forget`、`POST /memory/stats`。
+
+宿主若没有 `tools` 服务（老版本），这些工具静默跳过，注入照常。0.7 新增 memory_edit 工具和应用内图形化管理页，详见本文开头。
 
 ---
 
-## 装上就能用（用户零动作）
+## 安装本地 0.7 验收包
 
 | | |
 |---|---|
-| DSH | 0.2 预览版（`dsh.bundle` 机制） |
+| DSH | **0.2.1-rc.5**（官方 bundle + client 插件机制） |
 | Node | `^22.19 \|\| >=24` |
-| Python | **不用装**：Windows x64 包里自带解释器 |
-| 内核 | **不用装**：Python 内核（`python/xujie_memory`）在包里 |
+| Python | Windows x64 包内自带；macOS/Linux 需系统 Python 3.10+ |
 
-```bash
-dsh plugin --profile <你的profile> add <解压后的 dsh-plugin-xujie-memory 目录>
-# 新开一个会话即可
-```
-
-仓库公开后，也可以从 GitHub 安装指定版本：
+先备份原包与记忆库，退出 DSH，将本地验收包解压后，按 0.6 使用的原 profile 安装：
 
 ```bash
-dsh plugin --profile <你的profile> add github:Shoren-Syi/dsh-plugin-xujie-memory#v0.5.0
+dsh plugin --profile <你的profile> add <tgz 解压后含 package.json 的 package 目录>
+# 然后重启 DSH，检查左侧「记忆」入口
 ```
 
+**本次交付未发布 npm/GitHub 0.7 标签。** 不要用注册表包名或旧 GitHub v0.6.0 命令替代本地验收包；它们可能装回旧版。不要删除原数据目录。安装失败时保留日志，按 `ACCEPTANCE.md` 回滚。
+
 不需要 `pip install`，不需要填 `repoPath`，不需要另外起服务：
 
 - 插件用**包内解释器**（`runtime/win32-x64/python.exe`）拉起**包内内核**
@@ -207,7 +256,7 @@ curl -s --noproxy '*' -X POST http://127.0.0.1:8765/turn \
 
 ```
 dsh-plugin-xujie-memory/
-├── lib/index.js          # 薄壳：挂 section / 收事件 / 起内核
+├── lib/index.js          # 薄壳：挂 section / 注册工具 / 收事件 / 起内核
 ├── python/xujie_memory   # Python 内核（零第三方依赖）
 ├── python/specs          # 判定规则
 ├── runtime/win32-x64/    # 自带解释器（Windows）
@@ -219,6 +268,7 @@ dsh-plugin-xujie-memory/
 
 ## 开发验证
 
-`npm test` 运行插件与内核的集成冒烟测试，覆盖会话隔离和注入消息过滤；Windows x64 默认使用包内 Python，其他平台需要 Python 3.10+，也可通过 `PYTHON` 环境变量指定解释器。执行 `npm pack` 可打包当前仓库自带的内核。
+`npm test` 运行新增的管理、事务、隔离、持久化回归和使用 DI 测试替身的 Host 桥接检查。Windows x64 默认使用包内 Python；其他平台需要 Python 3.10+，也可通过 `PYTHON` 指定解释器。执行 `npm pack` 可打包当前仓库自带的内核。
 
 本仓库由 0.5.0 发布包恢复。原先的回归测试集因之前的沙箱重置而丢失，发布包中也没有包含原来的 `test/kernel_regression.py` 和内核同步脚本。CHANGELOG 中的 31/31 是历史记录，当前仓库无法复现该回归集；冒烟测试不代表这 31 项回归已通过。
+

package/README_EN.md

@@ -1,7 +1,28 @@
-# dsh-plugin-xujie-memory
+# Xujie Memory 0.7.0 · DSH in-app memory workspace
 
 [简体中文](README.md) | English
 
+**Acceptance candidate for DeepSeek Harness 0.2.1-rc.5; not yet verified in a real Windows DSH desktop.**
+
+## New in 0.7
+
+- Native “记忆” page in DSH via the official `sidebar.panellist` and `main` slots; no separate website.
+- A rotating 3D neuronal field with three visible memory layers, fuzzy recall, true person cards, and original-memory edit/forget actions. Decorative fibers are not stored memories or inferred semantic relationships; real evidence edges are distinguished in the legend.
+- Browser management calls use generated Typert Remote contracts and require the authenticated DSH owner. No kernel token or direct kernel URL is exposed to the page.
+- An edit atomically invalidates old evidence and creates a replacement trace, preserving original event time, importance and anchors. Save returns a new trace ID. Dependent facts/person cards and retrieval are recomputed. Conflicting versions are rejected.
+- New `memory_edit` tool: search first to obtain `trace_id` and `content_hash`, then submit `expected_hash` with the correction.
+
+## Upgrade and data boundaries
+
+Use the same profile and `dbPath` as 0.6. Before the first old-schema migration, the kernel creates a consistent private backup named `<dbPath>.pre-0.7.0.bak` without overwriting an existing backup. Previously erased residual summaries/projections are repaired once.
+
+**The migration backup contains pre-upgrade data. Keep it private.** Forgetting is application-level removal, not secure disk erasure; it does not erase DSH chats, exports, old backups or historical disk/WAL contents.
+
+The graph defaults to the latest 250 original traces plus selected derived nodes. Management search covers all active original traces in the selected memory scope; automatic conversational recall retains its latest-800-candidate limit. Derived facts, summaries and clarifications are read-only; follow their evidence to edit original wording. Person cards are derived from actual records, not independent editable profile fields.
+
+Install the supplied local candidate archive/extracted folder with the same method and profile used for 0.6, then restart DSH. Registry and GitHub examples from older releases do not install this unpublished candidate. Preserve your data folder and follow `ACCEPTANCE.md` before relying on the upgrade.
+
+
 Seamless long-term memory built for DeepSeek Harness (DSH).
 
 **The value of memory is not having to think about it.** Xujie-Memory records relevant information locally, assembles memory context, and injects it into the prompt without asking the model to decide whether to call a memory tool. The Windows x64 package includes a runtime and generally requires no extra configuration after installation.
@@ -39,18 +60,42 @@ This compares common design approaches; individual tool-based systems can differ
 
 Importance scoring affects how slowly memories fade. Explicit requests such as “remember this” pin an anchor. Retrieval does not reset decay. The kernel also exposes `/memory/mark`, `/memory/curve`, and `/memory/search` endpoints.
 
+## Active tools (0.7)
+
+Injection is automatic, but **actively recalling** and **removing what was remembered wrong** need a hand. 0.7 registers four tools:
+
+| Tool | What it does | Side effect |
+|---|---|---|
+| `memory_search` | Literal/fuzzy search over stored wording; returns content, `trace_id`, `content_hash`, weight | read-only |
+| `memory_edit` | Atomic replacement using `trace_id`, content and `expected_hash` | write; new trace ID |
+| `memory_forget` | Deletes one memory (soft delete: content cleared, FTS row removed, dependent facts invalidated and recomputed) | write; `erased_at` kept for audit |
+| `memory_status` | Counts for stored/erased entries, states, anchors, open items, plus kernel health | read-only |
+
+When the user says “forget that”, the model can search for the `trace_id` itself and delete it — no manual database surgery. Kernel endpoints: `POST /memory/search`, `POST /memory/forget`, `POST /memory/stats`.
+
+Hosts without a `tools` service skip registration silently; injection keeps working. 0.7 includes the native graphical page and memory editing.
+
+The current sentence is no longer injected back as a past event (0.6 fix): `/turn` excludes it by `trace_id`, `/context` by content (whitespace and punctuation ignored). Ask about something else and older memories still appear.
+
 ## Installation
 
-The package targets the DSH 0.2 preview bundle mechanism and Node.js `^22.19 || >=24`. Windows x64 includes Python and the kernel; no separate Python installation or pip dependencies are needed. On macOS and Linux it falls back to system Python 3.10 or newer.
+This candidate targets the DSH 0.2.1-rc.5 bundle/client mechanism and Node.js `^22.19 || >=24`. Windows x64 includes Python and the kernel; no separate Python installation or pip dependencies are needed. On macOS and Linux it falls back to system Python 3.10 or newer.
 
 ```bash
-dsh plugin --profile <your-profile> add <path-to-extracted-dsh-plugin-xujie-memory>
+dsh plugin --profile <your-profile> add <extracted-package-folder-containing-package.json>
 ```
 
-When the repository is public, install the tagged version directly from GitHub:
+Install by package name from npm:
 
 ```bash
-dsh plugin --profile <your-profile> add github:Shoren-Syi/dsh-plugin-xujie-memory#v0.5.0
+dsh plugin --profile <your-profile> add dsh-plugin-xujie-memory
+```
+
+Or install the tagged version directly from GitHub:
+
+```bash
+# Historical 0.6 command only; NOT this unpublished 0.7 candidate:
+dsh plugin --profile <your-profile> add github:Shoren-Syi/dsh-plugin-xujie-memory#v0.6.0
 ```
 
 Start a new session. The plugin starts the bundled kernel automatically. By default the database is stored at `~/.xujie-memory/memory.db`. Kernel failure skips memory for that turn rather than blocking the conversation.
@@ -80,13 +125,14 @@ Only `user/message` events are ingested. Runtime context and agent-instruction m
 ## Package contents
 
 ```text
-lib/index.js             DSH integration and kernel lifecycle
+lib/index.js             DSH integration, tool registration and kernel lifecycle
 python/xujie_memory/     Python memory kernel
 python/specs/            Interpretation rules
 runtime/win32-x64/       Bundled Windows x64 Python runtime
 cordis.patch.yml         DSH bundle patch
 ```
 
-This repository was reconstructed from the distributed 0.5.0 package. Run `npm test` for the integration smoke test and `npm pack` to package the bundled kernel. Windows x64 uses the bundled Python runtime; other platforms need Python 3.10 or newer. Set `PYTHON` to use a specific interpreter for the smoke test.
+This upgrade is based on the supplied 0.6.0 archive. After installing development dependencies, run `npm run build` and `npm test`: the new suite exercises real temporary SQLite/HTTP and a Cordis DI test double. Browser QA uses a simulated main slot with the built client factory and real temporary kernel, not the real DSH desktop. Run `npm pack` to package built artifacts. Windows x64 uses the bundled Python runtime; other platforms need Python 3.10 or newer. Set `PYTHON` to select an interpreter.
+
+The supplied baseline did not contain its historical regression suite. The distribution did not include `test/kernel_regression.py` or the kernel synchronization script. The 31/31 result in the changelog is historical and cannot be reproduced from this repository; the smoke test does not replace that regression suite.
 
-The original regression suite was lost when the previous sandbox was reset. The distribution did not include `test/kernel_regression.py` or the kernel synchronization script. The 31/31 result in the changelog is historical and cannot be reproduced from this repository; the smoke test does not replace that regression suite.

package/cordis.patch.yml

@@ -1,49 +1,49 @@
-# 这个 bundle 往配置树里插的一行。
-#
-# `name` 必须是包的**名字**（和 package.json 的 name 一致），
-# `id` 是用户之后覆盖配置时的定位锚点——要稳定，不要和别的插件重名。
-#
-# 注意：DSH 0.2.1-rc.2 要求 patch 文件是**顶层数组**，所以整份内容放在
-# 一个 `- insert:` 列表项里（映射形式会被插件安装校验拒绝）。
-- insert:
-    - id: xujie-memory
-      name: dsh-plugin-xujie-memory
-      config:
-        # Python 内核监听地址；宿主的 section 注入和写记忆都走这条本地 HTTP。
-        endpoint: "http://127.0.0.1:8765"
-
-        # 留空 = 用插件包内自带的 python/ 内核（推荐，装上即用）。
-        # 只有开发时想指向仓库才填绝对路径。
-        repoPath: ""
-
-        # 由插件拉起内核进程。设成 false 就要求你另外手动起服务。
-        autoStart: true
-
-        # 留空 = 用插件包内自带的解释器（runtime/<平台>-<架构>/）。
-        # 只有想换成本机 Python 时才填。
-        pythonPath: ""
-
-        # 留空 = ~/.xujie-memory/memory.db；想换位置或跑测试时填绝对路径。
-        dbPath: ""
-
-        # 一个会话最多主动追问几次。超过之后材料里只剩一句总数。
-        maxAskedTotal: 6
-
-        # 记忆范围（v0.5）：
-        #   user    人物卡/偏好/锚点/账跨会话有效（默认，长期记忆）
-        #   session 每个会话一份、互不相通（0.4 的旧行为）
-        scope: "user"
-
-        # 内核日志；留空 = 与记忆库同目录的 kernel.log（超过 2MB 自动轮转）。
-        logFile: ""
-
-        # 插件与内核共享的鉴权 token 文件；留空 = 与记忆库同目录的 token。
-        tokenFile: ""
-
-        # 宿主若会 await section.text 返回的 Promise，可设为 true：
-        # 组装提示词时最多等 waitMs 毫秒拿这一轮的记忆。宿主不支持就别开。
-        asyncSection: false
-        waitMs: 400
-
-        # 可选诊断文件：宿主 logger 把 info 过滤掉时，用它确认插件挂载/内核就绪。
-        statusFile: ""
+# 这个 bundle 往配置树里插的一行。
+#
+# `name` 必须是包的**名字**（和 package.json 的 name 一致），
+# `id` 是用户之后覆盖配置时的定位锚点——要稳定，不要和别的插件重名。
+#
+# 注意：DSH 0.2.1-rc.2 要求 patch 文件是**顶层数组**，所以整份内容放在
+# 一个 `- insert:` 列表项里（映射形式会被插件安装校验拒绝）。
+- insert:
+    - id: xujie-memory
+      name: dsh-plugin-xujie-memory
+      config:
+        # Python 内核监听地址；宿主的 section 注入和写记忆都走这条本地 HTTP。
+        endpoint: "http://127.0.0.1:8765"
+
+        # 留空 = 用插件包内自带的 python/ 内核（推荐，装上即用）。
+        # 只有开发时想指向仓库才填绝对路径。
+        repoPath: ""
+
+        # 由插件拉起内核进程。设成 false 就要求你另外手动起服务。
+        autoStart: true
+
+        # 留空 = 用插件包内自带的解释器（runtime/<平台>-<架构>/）。
+        # 只有想换成本机 Python 时才填。
+        pythonPath: ""
+
+        # 留空 = ~/.xujie-memory/memory.db；想换位置或跑测试时填绝对路径。
+        dbPath: ""
+
+        # 一个会话最多主动追问几次。超过之后材料里只剩一句总数。
+        maxAskedTotal: 6
+
+        # 记忆范围（v0.5）：
+        #   user    人物卡/偏好/锚点/账跨会话有效（默认，长期记忆）
+        #   session 每个会话一份、互不相通（0.4 的旧行为）
+        scope: "user"
+
+        # 内核日志；留空 = 与记忆库同目录的 kernel.log（超过 2MB 自动轮转）。
+        logFile: ""
+
+        # 插件与内核共享的鉴权 token 文件；留空 = 与记忆库同目录的 token。
+        tokenFile: ""
+
+        # 宿主若会 await section.text 返回的 Promise，可设为 true：
+        # 组装提示词时最多等 waitMs 毫秒拿这一轮的记忆。宿主不支持就别开。
+        asyncSection: false
+        waitMs: 400
+
+        # 可选诊断文件：宿主 logger 把 info 过滤掉时，用它确认插件挂载/内核就绪。
+        statusFile: ""