dsh-plugin-xujie-memory 0.6.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,17 @@
 # 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）
 
 ### 发布前修复

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) | 简体中文
@@ -41,7 +74,7 @@ flowchart LR
 
 记忆会自动注入；需要主动查找或删除时，也可以使用下方工具。
 
-### 三层记忆（当前版本 0.6.0）
+### 三层记忆（0.7.0）
 
 | 层 | 内容 | 你怎么用 |
 |---|---|---|
@@ -60,54 +93,46 @@ flowchart LR
 **模糊搜索**：`POST /memory/search`，两字词、错一个字都能捞；
 精确检索落空时，自动注入也会降级到模糊匹配。
 
-本仓库保留 0.6.0 发布包中的内核；上表概括了三层记忆。
+0.7 以内核 0.52.0 为基线扩展管理接口与一致性逻辑；上表概括了三层记忆。
 
 **当前这句不会被当成旧事注回去（0.6 修复）**：`/turn` 用 trace_id 挡，`/context` 只拿得到文本、按内容挡（忽略空白与标点）。换成问别的事，旧记忆照常出现。
 
 ---
 
-## 主动工具（0.6 新增）
+## 主动工具（0.7）
 
-注入是自动的，但**主动回忆**和**删掉记错的东西**需要有手。0.6 给模型注册了三个工具：
+注入是自动的，但**主动回忆**和**删掉记错的东西**需要有手。0.7 给模型注册了四个工具：
 
 | 工具 | 作用 | 副作用 |
 |---|---|---|
-| `memory_search` | 按字面/错字模糊检索原话，返回内容、`trace_id`、权重 | 只读 |
+| `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` 服务（老版本），这三个工具静默跳过，注入照常。目前尚无编辑记忆工具或图形化记忆管理界面。
+宿主若没有 `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`）在包里 |
-
-```bash
-dsh plugin --profile <你的profile> add <解压后的 dsh-plugin-xujie-memory 目录>
-# 新开一个会话即可
-```
+| Python | Windows x64 包内自带；macOS/Linux 需系统 Python 3.10+ |
 
-也可以在 DSH 的「添加插件」中输入包名 `dsh-plugin-xujie-memory` 安装，或通过命令安装：
+先备份原包与记忆库，退出 DSH，将本地验收包解压后，按 0.6 使用的原 profile 安装：
 
 ```bash
-dsh plugin --profile <你的profile> add dsh-plugin-xujie-memory
+dsh plugin --profile <你的profile> add <tgz 解压后含 package.json 的 package 目录>
+# 然后重启 DSH，检查左侧「记忆」入口
 ```
 
-也可以从 GitHub 安装指定版本：
-
-```bash
-dsh plugin --profile <你的profile> add github:Shoren-Syi/dsh-plugin-xujie-memory#v0.6.0
-```
+**本次交付未发布 npm/GitHub 0.7 标签。** 不要用注册表包名或旧 GitHub v0.6.0 命令替代本地验收包；它们可能装回旧版。不要删除原数据目录。安装失败时保留日志，按 `ACCEPTANCE.md` 回滚。
 
 不需要 `pip install`，不需要填 `repoPath`，不需要另外起服务：
 
@@ -243,7 +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,28 +60,29 @@ 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 (new in 0.6)
+## Active tools (0.7)
 
-Injection is automatic, but **actively recalling** and **removing what was remembered wrong** need a hand. 0.6 registers three tools:
+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`, weight | read-only |
+| `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. Editing memories and a graphical memory-management interface are not yet available.
+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>
 ```
 
 Install by package name from npm:
@@ -72,6 +94,7 @@ 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
 ```
 
@@ -109,7 +132,7 @@ runtime/win32-x64/       Bundled Windows x64 Python runtime
 cordis.patch.yml         DSH bundle patch
 ```
 
-The repository was reconstructed from the 0.5.0 package and updated for 0.6.0. Run `npm test` for the smoke, echo, tools, and deletion projection tests; run `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 select an interpreter.
+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 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.
+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.