npm - dsh-memoir - Versions diffs - 0.6.0 → 0.6.1 - Mend

dsh-memoir 0.6.0 → 0.6.1

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.

Files changed (9) hide show

package/README.en.md CHANGED Viewed

@@ -12,7 +12,7 @@
 No embeddings, vector database, or cloud memory service. The npm package has zero bundled runtime dependencies; DSH peers are supplied by the host.
 > [!IMPORTANT]
-> `dsh-memoir@0.6.0` is the formal plugin release for the npm-published DSH `0.1.2-alpha.2` line and requires `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`. Upgrade DSH first. Users remaining on `0.1.1-rc.2` should pin `dsh-memoir@0.5.6`.
+> npm `latest` is `dsh-memoir@0.6.1` for `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`, validated against DSH alpha.4 and the current alpha.5. Users remaining on `0.1.1-rc.2` should pin `dsh-memoir@0.5.6`.
 ```bash
 npm install --global @deepseek-ai/dsh@alpha
@@ -35,7 +35,7 @@ Restart `dsh web`. Memory remains local and is not automatically deleted when th
 It fits personal and local development workflows where a new agent should continue understanding a project. It is not a raw chat backup, multi-user cloud sync service, or vector-semantic knowledge base.
-![dsh-memoir native Settings and agent-language selection on DSH alpha.2](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-settings-zh.png)
+![dsh-memoir v0.6.1 global memory grouped and collapsed by project](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-global-project-groups-zh.png)
 ## How it works
@@ -98,17 +98,24 @@ Top-5 recall on the fixed quality set is 100%; the repository gate requires at l
 Installing into a DSH-alpha `web` profile registers a native Memory Conversation view and Memory Settings section through official slots. The DSH shell owns layout, navigation, and unload lifecycle; Memoir no longer takes over the legacy sidebar through DOM selectors.
-- Project memory and all-project global memory;
+- Project memory and all-project global memory, with project groups collapsed by default and complete lifecycle totals;
 - status, section, and keyword filters with BM25 scores;
 - add, edit, pin, archive, restore, and supersede;
 - copy and best-effort navigation for session/turn provenance;
 - Hot Memory Inspector: what the next session will inherit;
 - Retrieval Diagnostics: index, query cache, last query, and session snapshot;
-- one vertical scroll owner, so expanded settings, Hot Memory, and diagnostics remain continuously scrollable;
+- permanent `Browse / Settings / Hot Memory / Diagnostics` navigation with an independent bounded scroll position per surface;
+- progressive batches of 20 entries or projects, plus a controlled six-line preview for long memory bodies;
+- the native DSH composer-overlay contract, keeping the final memory visible above the conversation composer while the list scrolls fully;
+- arrow-key, Home, and End navigation for surface tabs, plus `aria-expanded` project disclosures and visible focus states;
 - live GUI Chinese/English switching from `<html lang>`, with a separate `language` setting for agent-facing copy.
 <details>
-<summary>More stable GUI screenshots</summary>
+<summary>More GUI screenshots</summary>
+![v0.6.1 permanent surface navigation and live settings](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-settings-navigation-zh.png)
+![v0.6.1 conversation view scrolled to the end above the composer](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-conversation-scroll-zh.png)
 ![Native Memory Conversation view on DSH alpha.2](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-native-zh.png)
@@ -124,11 +131,11 @@ Installing into a DSH-alpha `web` profile registers a native Memory Conversation
 | Channel | DSH baseline | Installation | Status |
 | --- | --- | --- | --- |
-| npm `latest` (`0.6.0`) | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | Current formal release for the npm alpha line |
+| npm `latest` (`0.6.1`) | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | Current release; alpha.4 compile and alpha.5 + dsh-web-all browser validated |
 | 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.1.2-alpha.2 <0.1.3` | source clone + `link:` | 0.6.x development line |
+| GitHub `main` (`0.6.1`) | `>=0.1.2-alpha.2 <0.1.3` | source clone + `link:` | Synchronized with npm `0.6.1`; intended for development and debugging |
-Node.js `^22.19.0 || >=24.0.0` is required. v0.6.0 uses the native DSH-alpha `conversation.view` / `settings.section` slots and the Remote-era client module architecture. A formal plugin version means Memoir itself is released; it does not imply compatibility with the older rc2 host. `dsh.engines.dsh` rejects incompatible hosts.
+Node.js `^22.19.0 || >=24.0.0` is required. v0.6.x uses the native DSH-alpha `conversation.view` / `settings.section` slots and the Remote-era client module architecture. v0.6.1 supports both the public `session.events` surface in alpha.2/alpha.3 and `session.snapshotEvents()` in alpha.4+. `dsh.engines.dsh` rejects incompatible hosts.
 <details>
 <summary>Install from source</summary>
@@ -197,7 +204,7 @@ 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.
-v0.6.0 has 182 automated tests covering store/settings migration and locks, Hot Memory, BM25 quality/cache, lifecycle, provenance anti-spoofing, similar-memory governance, automatic distillation, bilingual agent and GUI surfaces, scrolling, DSH alpha.2 integration, and release automation.
+v0.6.1 has 189 automated tests covering store/settings migration and locks, Hot Memory, BM25 quality/cache, lifecycle, provenance anti-spoofing, similar-memory governance, automatic distillation, bilingual agent and GUI surfaces, project disclosure/progressive loading, scrolling, and DSH-alpha compatibility. An isolated DSH alpha.5 + `@linxin666/dsh-web-all@0.3.12` profile also passed Settings and real-session browser regression; alpha.4 type compilation passed separately.
 ## FAQ
@@ -226,6 +233,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 release is [v0.6.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.0).
+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.6.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.1), and `main` is synchronized with it.
 Apache-2.0

package/README.md CHANGED Viewed

@@ -11,7 +11,7 @@
 无需 embedding、向量数据库或云端记忆服务；npm 包零捆绑运行时依赖，DSH peer 由宿主提供。
 > [!IMPORTANT]
-> `dsh-memoir@0.6.0` 是面向 npm 已发布 DSH `0.1.2-alpha.2` 的正式插件版本，要求 `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`。请先升级 DSH；仍使用 `0.1.1-rc.2` 的用户应固定安装 `dsh-memoir@0.5.6`。
+> npm `latest` 为 `dsh-memoir@0.6.1`，适用于 `@deepseek-ai/dsh >=0.1.2-alpha.2 <0.1.3`，已验证 DSH alpha.4 与当前 alpha.5。仍使用 `0.1.1-rc.2` 的用户应固定安装 `dsh-memoir@0.5.6`。
 ```bash
 npm install --global @deepseek-ai/dsh@alpha
@@ -34,7 +34,7 @@ dsh plugin --profile web add dsh-memoir@latest
 适合需要“新 Agent 接手时继续理解项目”的个人或本地开发工作流。它不是原始聊天记录备份、多人云同步服务或向量语义知识库。
-![dsh-memoir 在 DSH alpha.2 中的原生设置与 Agent 语言选择](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-settings-zh.png)
+![dsh-memoir v0.6.1 按项目折叠的全局记忆](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-global-project-groups-zh.png)
 ## 工作原理
@@ -97,17 +97,24 @@ memoir_record / memoir_update
 安装到 DSH alpha 的 `web` profile 后，Memoir 通过官方 slot 注册原生「记忆」会话视图和「记忆」Settings 分区；布局、导航与卸载生命周期均由 DSH shell 管理，不再通过 DOM 选择器接管旧侧边栏。
-- 项目记忆与所有项目的全局记忆；
+- 项目记忆与所有项目的全局记忆；全局视图按项目默认折叠并显示完整生命周期计数；
 - 状态、分类和关键词筛选，BM25 分数展示；
 - 新增、编辑、置顶、归档、恢复和替代；
 - session/turn 来源复制与尽力跳转；
 - Hot Memory Inspector：下一会话将继承什么；
 - Retrieval Diagnostics：索引、查询缓存、最近查询和会话快照；
-- 单一纵向滚动区，展开设置、Hot Memory 与诊断后仍可连续浏览；
+- 常驻 `记忆浏览 / 记忆设置 / Hot Memory / 诊断` 二级导航，各功能区拥有独立有界滚动位置；
+- 每批渐进展示 20 条记忆或 20 个项目，长正文默认折叠为六行并可显式展开；
+- 使用 DSH 原生 composer-overlay 契约，长列表可完整滚动且最后一项不会被对话输入框遮挡；
+- 页签支持方向键、Home、End，项目折叠具备 `aria-expanded` 与清晰焦点状态；
 - GUI 跟随 `<html lang>` 在中文和英文间即时切换；Agent 侧语言由独立的 `language` 设置控制。
 <details>
-<summary>查看更多稳定版 GUI 截图</summary>
+<summary>查看更多 GUI 截图</summary>
+![v0.6.1 常驻功能导航与实时设置](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-settings-navigation-zh.png)
+![v0.6.1 对话视图滚动到底且避让输入框](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.1/picture/v0.6.1-conversation-scroll-zh.png)
 ![DSH alpha.2 原生记忆会话视图](https://raw.githubusercontent.com/Qinling-Melon-Farmers/dsh-memoir/v0.6.0/picture/v0.6.0-alpha2-native-zh.png)
@@ -123,11 +130,11 @@ memoir_record / memoir_update
 | 渠道 | DSH 基线 | 安装方式 | 状态 |
 | --- | --- | --- | --- |
-| npm `latest`（`0.6.0`） | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | 当前正式版，适配 npm alpha |
+| npm `latest`（`0.6.1`） | `>=0.1.2-alpha.2 <0.1.3` | `dsh plugin --profile web add dsh-memoir@latest` | 当前正式版；已验证 alpha.4 编译及 alpha.5 + dsh-web-all 实机 UI |
 | npm 固定版 `0.5.6` | `0.1.1-rc.2` | `dsh plugin --profile web add dsh-memoir@0.5.6` | rc2 兼容线 |
-| GitHub `main` | `>=0.1.2-alpha.2 <0.1.3` | 源码 clone + `link:` | 0.6.x 开发线 |
+| GitHub `main`（`0.6.1`） | `>=0.1.2-alpha.2 <0.1.3` | 源码 clone + `link:` | 与 npm `0.6.1` 同步；供开发和调试使用 |
-需要 Node.js `^22.19.0 || >=24.0.0`。`0.6.0` 使用 DSH alpha 的原生 `conversation.view` / `settings.section` 与 Remote 时代客户端模块；正式版本号表示插件自身完成发布，不表示它兼容旧 rc2。manifest 的 `dsh.engines.dsh` 会拒绝不兼容宿主。
+需要 Node.js `^22.19.0 || >=24.0.0`。`0.6.x` 使用 DSH alpha 的原生 `conversation.view` / `settings.section` 与 Remote 时代客户端模块；`0.6.1` 同时兼容 alpha.2/alpha.3 的公开 `session.events` 与 alpha.4+ 的 `session.snapshotEvents()`。manifest 的 `dsh.engines.dsh` 会拒绝不兼容宿主。
 <details>
 <summary>从源码安装</summary>
@@ -196,7 +203,7 @@ v0.5.6 基准（Node 24.19，900/1200 token；完整数据见 [`bench/report.md`
 基准值取决于机器和语料；它证明的重点是注入预算保持有界、缓存命中路径与记忆总量解耦。
-v0.6.0 有 182 项自动化测试，覆盖存储/设置迁移与锁、Hot Memory、BM25 质量/缓存、生命周期、来源防伪、相似治理、自动蒸馏、Agent 侧与 GUI 双语、滚动布局、DSH alpha.2 集成和发布工作流。
+v0.6.1 有 189 项自动化测试，覆盖存储/设置迁移与锁、Hot Memory、BM25 质量/缓存、生命周期、来源防伪、相似治理、自动蒸馏、Agent 侧与 GUI 双语、项目折叠/渐进加载、滚动布局及 DSH alpha 兼容。另在隔离 profile 中以 DSH alpha.5 + `@linxin666/dsh-web-all@0.3.12` 完成 Settings 与真实会话页浏览器回归；alpha.4 类型编译也已通过。
 ## 常见问题
@@ -225,6 +232,6 @@ pnpm test
 npm run bench
 ```
-提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前版本是 [v0.6.0](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.0)。
+提交前请阅读 [CONTRIBUTING.md](./CONTRIBUTING.md)。版本变化见 [CHANGELOG.md](./CHANGELOG.md)，正式包由 tag 工作流通过 npm OIDC 发布。当前 npm 正式版是 [v0.6.1](https://github.com/Qinling-Melon-Farmers/dsh-memoir/releases/tag/v0.6.1)，`main` 与该版本同步。
 Apache-2.0

package/lib/autodistill.d.ts CHANGED Viewed

@@ -27,6 +27,16 @@ export interface TurnActivity {
     recorded: boolean;
     toolCalls: number;
 }
+/**
+ * Session-log compatibility surface. DSH <= alpha.3 exposed `events` while
+ * alpha.4+ keeps the log private and exposes an immutable snapshot method.
+ */
+export interface SessionEventSource {
+    readonly events?: readonly TurnEventLike[];
+    snapshotEvents?: () => readonly TurnEventLike[];
+}
+/** Read a stable session event snapshot across the old and new DSH APIs. */
+export declare function sessionEventSnapshot(session: SessionEventSource | undefined): readonly TurnEventLike[];
 /** Scan the tail of a session log for one turn's tool activity. */
 export declare function turnActivity(events: readonly TurnEventLike[], turn: number): TurnActivity;
 /** The agent surface the turn-stopping listener needs. */
@@ -37,7 +47,8 @@ export interface AutoDistillAgentLike {
             origin?: string;
             delegationDepth?: number;
         };
-        events: readonly TurnEventLike[];
+        readonly events?: readonly TurnEventLike[];
+        snapshotEvents?: () => readonly TurnEventLike[];
     };
     steer(message: UserMessage): void;
 }

package/lib/autodistill.js CHANGED Viewed

@@ -19,6 +19,12 @@ export function distillPrompt(language = DEFAULT_MEMOIR_LANGUAGE) {
 export const DISTILL_PROMPT = distillPrompt();
 /** Plugin identity stamped on the steering message source. */
 export const AUTO_DISTILL_PLUGIN = 'dsh-memoir';
+/** Read a stable session event snapshot across the old and new DSH APIs. */
+export function sessionEventSnapshot(session) {
+    if (typeof session?.snapshotEvents === 'function')
+        return session.snapshotEvents();
+    return session?.events ?? [];
+}
 /** Scan the tail of a session log for one turn's tool activity. */
 export function turnActivity(events, turn) {
     let recorded = false;
@@ -100,7 +106,7 @@ export function installAutoDistill(wire, options) {
             return;
         if (signal.aborted)
             return;
-        const { worked, recorded, toolCalls } = turnActivity(agent.session.events, turn);
+        const { worked, recorded, toolCalls } = turnActivity(sessionEventSnapshot(agent.session), turn);
         if (!worked || recorded)
             return;
         const live = options.policy?.();