dsh-memoir 0.7.1 → 0.8.0

package/README.en.md

@@ -12,11 +12,13 @@
 No embeddings, vector database, or cloud memory service. The npm package has zero bundled runtime dependencies; DSH peers are supplied by the host.
 
 > [!IMPORTANT]
+> **0.8.0 requires DSH `>=0.1.7-rc.1 <0.1.8-0`**, tested against `0.1.7-rc.1` with Windows/WSL regressions and an isolated Windows host. Pin `dsh-memoir@0.7.1` on legacy DSH 0.1.5 instead of upgrading to latest. Real-browser interaction and paid-model end-to-end validation remain unverified.
+>
 > `dsh-memoir@0.7.1` fixes lost session snapshots after restart or RAM eviction (#10), supporting DSH **0.1.5-rc.1 / rc.2**. It requires `>=0.1.5-rc.1 <0.1.6-0`; check your host first. Keep `0.6.2` on DSH 0.1.2, or `0.5.6` on DSH 0.1.1-rc.2; those older lines do not include this fix.
 
 ```bash
-npm install --global @deepseek-ai/dsh@0.1.5-rc.1
-dsh plugin --profile web add dsh-memoir@latest
+npm install --global @deepseek-ai/dsh@0.1.7-rc.1
+dsh plugin --profile web add dsh-memoir@0.8.0
 ```
 
 Restart `dsh web`. Memory remains local and is not automatically deleted when the plugin is updated or removed.
@@ -88,7 +90,7 @@ Similar-memory governance starts with BM25 candidates, then combines title simil
 
 v0.6.2 diagnostics show the latest decision and process-local counters. Turns calling `memoir_record` or `memoir_update` skip reminders; submitting a reminder does not confirm persistence. Agent disposal clears gate state, with a fallback cap of 1024 recently active agents (eviction also forgets their turn watermark and cooldown). Manual recording remains available when automatic distillation is disabled.
 
-DSH `0.1.5-rc.1` and the newest rc.2 are supported (pre-release verification: npm `next` is rc.2, while `latest` remains rc.1). BM25 is lexical retrieval and does not guarantee cross-language semantic matches without shared terms. Distillation guidance does not replace fact checking.
+0.8.0 targets DSH `0.1.7-rc.1`; 0.7.1 was validated on `0.1.5-rc.1 / rc.2`. BM25 is lexical retrieval and does not guarantee cross-language semantic matches without shared terms. Distillation guidance does not replace fact checking.
 
 Automatic distillation is an observable agent turn-end reminder, not silent background scraping of every chat. The default `1 / 0 / 1` means every eligible worked turn, no extra cooldown, and at least one tool call.
 
@@ -150,20 +152,21 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 
 | Channel | DSH baseline | Installation | Status |
 | --- | --- | --- | --- |
-| npm `latest` (`0.7.1`) | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@latest` | Snapshot recovery fix; rc.1 / rc.2 validated |
+| npm `latest` (`0.8.0`) | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.0` | DSH 0.1.7 line |
+| pinned npm `0.7.1` | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@0.7.1` | Legacy 0.1.5 line |
 | pinned npm `0.6.2` | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@0.6.2` | Legacy 0.1.2 line |
 | pinned npm `0.5.6` | `0.1.1-rc.2` | `dsh plugin --profile web add dsh-memoir@0.5.6` | rc2 compatibility line |
-| GitHub `main` (`0.7.1`) | `>=0.1.5-rc.1 <0.1.6-0` | source clone + `link:` | Development and debugging |
+| Source `v0.8.0` | `>=0.1.7-rc.1 <0.1.8-0` | local build + `link:` | Development; not compatible with legacy 0.1.5 / 0.1.6 |
 
 Node.js `^22.19.0 || >=24.0.0` is required. 0.7.1 keeps the native `conversation.view` / `settings.section` slots and `snapshotEvents()`. DSH 0.1.5 uses Session log V3, independent of Memoir store v4 / settings v3. Back up DSH_HOME before upgrading DSH; migrated sessions are not guaranteed readable by older hosts. This Memoir release neither migrates nor resets memory and retains frozen session snapshots without enabling new dynamic-prompt behavior.
 
 <details>
 <summary>Install from source</summary>
 
-0.7.x source:
+Published 0.7.1 source (legacy DSH 0.1.5):
 
 ```bash
-git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
+git clone --branch v0.7.1 https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
@@ -173,6 +176,8 @@ dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 
 </details>
 
+0.8.0 uses native `uiWorkspace` navigation, `conversation.view` / `settings.section`, and a producer-owned Session V4 distillation source. Source links open the session and turn IDs remain copyable; global DOM turn scrolling is removed to avoid targeting another conversation. `snapshotEvents()` remains in use (deprecated but still available); migration to public asynchronous projections is planned. Memoir data formats are unchanged. Back up DSH_HOME before upgrading: DSH Session V4 migration is separate from plugin memory storage.
+
 ## Storage, privacy, and security boundaries
 
 ```text
@@ -224,7 +229,9 @@ v0.5.6 benchmark (Node 24.19, 900/1200-token budget; full data in [`bench/report
 
 Numbers vary by machine and corpus. The important properties are that injection remains bounded and the cache-hit path is independent of total memory size.
 
-0.7.1 has 202 tests: 201 pass on Windows with one POSIX permission test skipped; all pass on Linux. Coverage includes actual process restart, same-session concurrent creation, LRU, empty baselines, forks, language isolation, corruption and permission errors, plus existing BM25/Hot Memory/tool regressions. DSH rc.1 and the newest rc.2 are validated. Prefix equality in tests is not a guarantee of actual billing savings.
+0.8.0: Windows passes 206 of 207 tests with one skip; WSL passes all 207. Typecheck/build pass on both. Three Cordis lifecycle cycles and client slot/style/language-observer cleanup pass, as do the isolated Windows page, official client combo and Memoir APIs. Real-browser interaction and paid-model end-to-end validation remain unverified; historical screenshots are not visual evidence for this version.
+
+Historical 0.7.1 has 202 tests: 201 pass on Windows with one POSIX permission test skipped; all pass on Linux. Coverage includes actual process restart, same-session concurrent creation, LRU, empty baselines, forks, language isolation, corruption and permission errors, plus existing BM25/Hot Memory/tool regressions. DSH rc.1 and the newest rc.2 are validated. Prefix equality in tests is not a guarantee of actual billing savings.
 
 ## FAQ
 
@@ -253,6 +260,6 @@ pnpm test
 npm run bench
 ```
 
-Read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes. See [CHANGELOG.md](./CHANGELOG.md) for version history. Formal packages are published by the tag workflow through npm OIDC. The current npm release is [v0.7.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.7.1), and `main` is synchronized with it.
+Read [CONTRIBUTING.md](./CONTRIBUTING.md) before submitting changes. See [CHANGELOG.md](./CHANGELOG.md) for version history. Formal packages are published by the tag workflow through npm OIDC. The current version is [v0.8.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.0), targeting DSH 0.1.7. Keep 0.7.1 on legacy DSH 0.1.5.
 
 Apache-2.0

package/README.md

@@ -11,11 +11,13 @@
 无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH peer 由宿主提供。
 
 > [!IMPORTANT]
+> **0.8.0 要求 DSH `>=0.1.7-rc.1 <0.1.8-0`**，已针对 `0.1.7-rc.1` 完成 Windows/WSL 自动化回归与 Windows 隔离宿主验证。旧 DSH 0.1.5 请固定安装 `dsh-memoir@0.7.1`，不要直接升级 latest。真实浏览器交互与付费模型端到端验证尚未完成。
+>
 > `dsh-memoir@0.7.1` 修复重启和内存淘汰后旧会话快照丢失（#10），支持 DSH **0.1.5-rc.1 / rc.2**。要求 `>=0.1.5-rc.1 <0.1.6-0`；请先核对宿主版本。旧 DSH 0.1.2 用户固定使用 `0.6.2`，0.1.1-rc.2 用户固定使用 `0.5.6`；这些旧版未包含本次修复。
 
 ```bash
-npm install --global @deepseek-ai/dsh@0.1.5-rc.1
-dsh plugin --profile web add dsh-memoir@latest
+npm install --global @deepseek-ai/dsh@0.1.7-rc.1
+dsh plugin --profile web add dsh-memoir@0.8.0
 ```
 
 重启 `dsh web` 即可。记忆保存在本机，不会随插件升级或卸载自动删除。
@@ -87,7 +89,7 @@ memoir_record / memoir_update
 
 v0.6.2 的诊断页显示最近触发或跳过原因及本次进程计数。已经调用 `memoir_record` 或 `memoir_update` 的回合不再提醒；提交提醒不代表写入已完成。Agent 销毁会清理门控状态，最多保留 1024 个最近活动 Agent（淘汰后不再保留其回合水位和冷却）。关闭自动蒸馏后仍可手动记录。
 
-当前支持 DSH `0.1.5-rc.1` 与最新 rc.2（发布前核验：npm `next` 为 rc.2、`latest` 仍为 rc.1）。BM25 是词项召回，不能保证无共同词项的跨语言语义匹配；提炼质量提示也不能替代事实核验。
+0.8.0面向 DSH `0.1.7-rc.1`；0.7.1 的历史验证范围为 `0.1.5-rc.1 / rc.2`。BM25 是词项召回，不能保证无共同词项的跨语言语义匹配；提炼质量提示也不能替代事实核验。
 
 自动蒸馏是可观察的 Agent 收尾提醒，不是后台静默抓取聊天内容。默认 `1 / 0 / 1` 表示：每个有效 worked turn、无额外冷却、至少一次工具调用即可提醒。
 
@@ -149,20 +151,21 @@ v0.6.2 的诊断页显示最近触发或跳过原因及本次进程计数。已
 
 | 渠道 | DSH 基线 | 安装方式 | 状态 |
 | --- | --- | --- | --- |
-| npm `latest`（`0.7.1`） | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@latest` | 快照恢复修复；已验证 rc.1 / rc.2 |
+| npm `latest`（`0.8.0`） | `>=0.1.7-rc.1 <0.1.8-0` | `dsh plugin --profile web add dsh-memoir@0.8.0` | 0.1.7 兼容线 |
+| npm 固定版 `0.7.1` | `>=0.1.5-rc.1 <0.1.6-0` | `dsh plugin --profile web add dsh-memoir@0.7.1` | 旧 0.1.5 维护线 |
 | npm 固定版 `0.6.2` | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@0.6.2` | 旧 0.1.2 兼容线 |
 | npm 固定版 `0.5.6` | `0.1.1-rc.2` | `dsh plugin --profile web add dsh-memoir@0.5.6` | rc2 兼容线 |
-| GitHub `main`（`0.7.1`） | `>=0.1.5-rc.1 <0.1.6-0` | 源码 clone + `link:` | 开发和调试使用 |
+| 源码 `v0.8.0` | `>=0.1.7-rc.1 <0.1.8-0` | 本地构建 + `link:` | 开发调试，不兼容旧 0.1.5 / 0.1.6 |
 
 需要 Node.js `^22.19.0 || >=24.0.0`。0.7.1 继续使用原生 `conversation.view` / `settings.section` 与 `snapshotEvents()`。DSH 0.1.5 的会话日志升级至 V3；其迁移与 Memoir 的 store v4 / settings v3 是独立格式。升级 DSH 前备份 DSH_HOME，迁移后的 DSH 会话不能承诺被旧宿主读取。Memoir 本次不迁移或清空记忆，也不启用新动态提示词行为；既有会话快照语义保持不变。
 
 <details>
 <summary>从源码安装</summary>
 
-0.7.x 源码：
+已发布 0.7.1 源码（旧 DSH 0.1.5）：
 
 ```bash
-git clone https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
+git clone --branch v0.7.1 https://github.com/Qinling-Melon-Farmers/dsh-memoir.git
 cd dsh-memoir
 pnpm install --frozen-lockfile
 pnpm run build
@@ -172,6 +175,8 @@ dsh plugin --profile web add "link:/absolute/path/dsh-memoir"
 
 </details>
 
+0.8.0使用原生 `uiWorkspace` 导航、`conversation.view` / `settings.section` 和 Session V4 专属蒸馏来源。来源链接打开会话，回合编号可复制；不再通过全局 DOM 自动滚到回合，避免多会话串扰。`snapshotEvents()` 仍在使用（宿主已标记弃用但尚未移除），公开异步 projection 迁移列入后续版本。Memoir 数据格式不变；升级 DSH 前备份 DSH_HOME，其 Session V4 迁移与插件记忆迁移是两回事。
+
 ## 存储、隐私与安全边界
 
 ```text
@@ -223,7 +228,9 @@ v0.5.6 基准（Node 24.19，900/1200 token；完整数据见 [`bench/report.md`
 
 基准值取决于机器和语料；它证明的重点是注入预算保持有界、缓存命中路径与记忆总量解耦。
 
-0.7.1 含 202 项测试：Windows 201 项通过、1 项 POSIX 权限测试跳过；Linux 全部通过。覆盖实际跨进程快照恢复、同会话并发写入、LRU、空基线、fork、语言隔离、损坏与权限失败，以及原有 BM25/Hot Memory/工具回归。已核验 DSH rc.1 和最新 rc.2；没有把测试前缀一致性等同于实际账单节省保证。
+0.8.0：Windows 207 项测试中 206 通过、1 项跳过，WSL 207 项全部通过；双端类型检查/构建通过。三轮 Cordis 生命周期与客户端 slots/样式/语言 observer 清理测试通过，Windows 隔离宿主页、官方客户端组合资源及 Memoir API 通过。未完成真实浏览器交互和付费模型端到端验收；历史截图不是本版实机证据。
+
+历史 0.7.1 含 202 项测试：Windows 201 项通过、1 项 POSIX 权限测试跳过；Linux 全部通过。覆盖实际跨进程快照恢复、同会话并发写入、LRU、空基线、fork、语言隔离、损坏与权限失败，以及原有 BM25/Hot Memory/工具回归。已核验 DSH rc.1 和最新 rc.2；没有把测试前缀一致性等同于实际账单节省保证。
 
 ## 常见问题
 
@@ -252,6 +259,6 @@ pnpm test
 npm run bench
 ```
 
-提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前 npm 正式版是 [v0.7.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.7.1)，`main` 与该版本同步。
+提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前版本是 [v0.8.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.8.0)，面向 DSH 0.1.7；旧 0.1.5 保留 0.7.1。
 
 Apache-2.0

package/cordis.patch.yml

@@ -1,8 +1,7 @@
 # dsh-memoir bundle patch: inserts the host-half plugin row into the web
 # profile roster. Applied as a profile bundle layer (the `dsh.bundle.patch`
-# manifest field) over dsh-base. dsh-memoir v0.7.0 targets the published DSH
-# line >=0.1.5-rc.1 <0.1.6-0 and installs from npm with
-#   dsh plugin --profile web add dsh-memoir@latest
+# manifest field) over dsh-base. dsh-memoir v0.8.0 targets the DSH
+# line >=0.1.7-rc.1 <0.1.8-0. Keep Memoir 0.7.1 on older DSH 0.1.5.
 #
 # The row is a bare plugin by package name: the node half (exports ".")
 # registers the memoir_record / memoir_read tools, the /api/dsh-memoir panel

package/lib/autodistill.d.ts

@@ -11,6 +11,13 @@
  */
 import type { UserMessage } from '@deepseek-ai/dsh-llm';
 import type { MemoirLanguage } from './i18n.js';
+declare module '@deepseek-ai/dsh-llm/message' {
+    interface MessageSourceMap {
+        'dsh-memoir': {
+            kind: 'dsh-memoir';
+        };
+    }
+}
 /** The steering prompt injected at the end of an active turn. */
 export declare function distillPrompt(language?: MemoirLanguage): string;
 /** Backwards-compatible Chinese prompt constant. */

package/lib/autodistill.js

@@ -155,7 +155,7 @@ export function installAutoDistill(wire, options) {
         try {
             agent.steer(createUserMessage({
                 content: [{ type: 'text', text: distillPrompt(options.language?.()) }],
-                source: { kind: 'plugin', plugin: AUTO_DISTILL_PLUGIN },
+                source: { kind: AUTO_DISTILL_PLUGIN },
             }));
         }
         catch (error) {

package/lib/client.js

@@ -241,7 +241,7 @@ var dictionaries = {
     "session": "\u4F1A\u8BDD",
     "source.label": "\u6765\u6E90",
     "source.turn": "\u56DE\u5408",
-    "source.open": "\u6253\u5F00\u6765\u6E90\u4F1A\u8BDD\u5E76\u5B9A\u4F4D\u5230\u5BF9\u5E94\u56DE\u5408",
+    "source.open": "\u6253\u5F00\u6765\u6E90\u4F1A\u8BDD\uFF08\u56DE\u5408\u7F16\u53F7\u53EF\u590D\u5236\uFF09",
     "source.copy": "\u590D\u5236\u4F1A\u8BDD\u4E0E\u56DE\u5408\u6807\u8BC6",
     "source.copied": "\u5DF2\u590D\u5236",
     "sections.work": "\u5DE5\u4F5C\u8BB0\u5F55",
@@ -431,7 +431,7 @@ var dictionaries = {
     "session": "session",
     "source.label": "Source",
     "source.turn": "turn",
-    "source.open": "Open the source session and reveal its turn",
+    "source.open": "Open the source session (turn ID can be copied)",
     "source.copy": "Copy session and turn identifiers",
     "source.copied": "Copied",
     "sections.work": "Work Log",
@@ -2738,15 +2738,15 @@ body[data-ds-dark-theme] [data-dsh-memoir-view] {
 }
 `;
 
+// src/client/native-navigation.ts
+function mainWorkspaceCwd(snapshot) {
+  const main = Object.values(snapshot.byId).filter((session) => (session.retainedBy.mainView ?? 0) > 0);
+  return main.length === 1 ? main[0].cwd ?? "" : "";
+}
+
 // src/client/index.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
-var inject = ["sessions", "slots"];
-function revealSourceTurn(turnId) {
-  if (turnId === void 0) return;
-  const reveal = () => document.querySelector(`[data-turn-tail="${turnId}"]`)?.scrollIntoView({ block: "center", behavior: "smooth" });
-  setTimeout(reveal, 0);
-  setTimeout(reveal, 250);
-}
+var inject = ["uiWorkspace", "slots"];
 function ConversationMemoirView({
   api,
   ctx,
@@ -2754,7 +2754,8 @@ function ConversationMemoirView({
   sessionId,
   useSessions,
   viewRequest,
-  completeViewRequest
+  completeViewRequest,
+  openView
 }) {
   const cwd = useSessions((snapshot) => snapshot.byId[sessionId]?.cwd ?? "");
   (0, import_react2.useEffect)(() => {
@@ -2773,9 +2774,9 @@ function ConversationMemoirView({
           api,
           cwd,
           t,
-          openSource: (sourceSessionId, turnId) => {
-            ctx.sessions.open(sourceSessionId);
-            revealSourceTurn(turnId);
+          openSource: (sourceSessionId) => {
+            if (sourceSessionId === sessionId) openView("chat", "");
+            ctx.uiWorkspace.openSession(sourceSessionId);
           }
         }
       )
@@ -2789,10 +2790,7 @@ function SettingsMemoirSection({
   close,
   useSessions
 }) {
-  const cwd = useSessions((snapshot) => {
-    const current = snapshot.current;
-    return current === void 0 ? "" : snapshot.byId[current]?.cwd ?? "";
-  });
+  const cwd = useSessions(mainWorkspaceCwd);
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "memoir-settings-section", "data-dsh-plugin": "memoir", "data-dsh-part": "settings-section", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
     MemoirPanel,
     {
@@ -2800,10 +2798,9 @@ function SettingsMemoirSection({
       cwd,
       t,
       onClose: close,
-      openSource: (sourceSessionId, turnId) => {
+      openSource: (sourceSessionId) => {
         close();
-        ctx.sessions.open(sourceSessionId);
-        revealSourceTurn(turnId);
+        ctx.uiWorkspace.openSession(sourceSessionId);
       }
     }
   ) });