dsh-layered-memory 0.9.2 → 0.11.0

package/README.en.md

@@ -10,30 +10,29 @@
 [简体中文](README.md) · [Latest release](https://github.com/JunNanLYS/dsh-layered-memory/releases/latest) · [Report issues](https://github.com/JunNanLYS/dsh-layered-memory/issues)
 
 [![npm version](https://img.shields.io/npm/v/dsh-layered-memory?color=6f83ff&style=flat-square&label=npm)](https://www.npmjs.com/package/dsh-layered-memory)
-[![DSH 0.1.2-alpha.x](https://img.shields.io/badge/DSH-0.1.2--alpha.x-8b5cf6?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
+[![DSH 0.1.2](https://img.shields.io/badge/DSH-0.1.2-8b5cf6?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
 [![MIT License](https://img.shields.io/badge/license-MIT-536990?style=flat-square)](LICENSE)
 
 </div>
 
 ## Getting Started
 
-Requires Node ≥ 22.16 and DeepSeek Harness ≥ **0.1.2-alpha.1** (as of 0.8.12 only the
-0.1.2-alpha.x host line is supported; for older hosts see the
+Requires Node ≥ 22.16 and DeepSeek Harness **0.1.2-alpha.1 ~ 0.1.2-rc.1**
+(as of 0.10.0 support extends to 0.1.2-rc.1, which the npm "latest" tag
+already points to; for older hosts see the
 [release history](https://github.com/JunNanLYS/dsh-layered-memory/releases)).
 Two invocation styles — the `npx` prefix can replace `dsh` in
 any command below:
 
 ```bash
-# Option 1: run the official CLI directly via npx (no pre-installed dsh; the host version must
-# be pinned to the alpha line — the npm "latest" tag still points to 0.1.1-rc.x)
-npx -y @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add dsh-layered-memory
+# Option 1: run the official CLI directly via npx (no pre-installed dsh)
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-layered-memory
 
-# Option 2: with the dsh CLI installed (upgrade to the alpha line first:
-# npm i -g @deepseek-ai/dsh@0.1.2-alpha.2, then restart; dsh is a pnpm forwarder —
-# npm i -g pnpm first if missing)
+# Option 2: with the dsh CLI installed (upgrade: npm i -g @deepseek-ai/dsh,
+# then restart; dsh is a pnpm forwarder — npm i -g pnpm first if missing)
 dsh plugin --profile web add dsh-layered-memory
 
-# Alternative sources: GitHub repo / local path (dev & debugging, link: points at the repo; npm run build + restart dsh to apply)
+# Alternative sources: GitHub repo / local path (dev & debugging, link: points at the repo; pnpm run build + restart dsh to apply)
 dsh plugin --profile web add https://github.com/JunNanLYS/dsh-layered-memory
 dsh plugin --profile web add /path/to/dsh-layered-memory
 ```
@@ -71,17 +70,39 @@ and the memory chip in the input bar (`Memory · Auto`) mean the client half is
 **Uninstall**: `dsh plugin --profile web remove dsh-layered-memory` + restart. Data
 stays in `~/.dsh/memory/`; delete the whole directory manually if you don't need it.
 
+### Terminal Hosts (TUI / headless)
+
+Beyond web, the same plugin installs into terminal-shaped hosts:
+
+```bash
+# dsh-tui (Claude Code style TUI front door — see github.com/ccch1mneyyy/dsh-TUI · site https://dshtui.com)
+dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui   # first time: create profile + install the TUI host
+dsh plugin --profile dsh-tui add dsh-layered-memory
+dsh --profile dsh-tui
+```
+
+- **`/memory <auto|chat|work|off>`** switches the current session's memory mode; with no
+  argument a selection panel pops up;
+- **Status line**: a persistent `记忆:智能`-style mode readout sits right above the prompt;
+- **`/settings` section**: master switch, capture, distill, recall, distill model routing and
+  input budget are editable in place (same store as the web settings panel; complex routing
+  chains still go through web / YAML);
+- **headless** (`dsh --profile headless "one-shot task"`): capture and distillation work as
+  usual with no UI elements. Web and terminal hosts share the same `~/.dsh/memory/` store.
+
 ### Development from Source
 
 ```bash
 git clone https://github.com/JunNanLYS/dsh-layered-memory
 cd dsh-layered-memory
-npm install && npm run build
-dsh plugin --profile web add .        # link: install; after code changes, npm run build + restart dsh
-npm run smoke                         # smoke test (rebuild first: see command below)
+pnpm install && pnpm run build
+dsh plugin --profile web add .        # link: install; after code changes, pnpm run build + restart dsh
+pnpm run smoke                        # smoke test (rebuild first: see command below)
 npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
 ```
 
+Dependencies are managed with pnpm (matching the official dsh install channel; the version is pinned via the `packageManager` field).
+
 ## Runtime Data Flow
 
 <p align="center">
@@ -183,6 +204,8 @@ lives in the native host seat designed for it; the plugin no longer owns a strip
   toggle in Automation. Ideal for debug/eval/sensitive sessions that should absorb
   without interference. Orthogonal to Paused: paused is full stealth (capture off
   too), while write-only keeps the "in" and gates the "out".
+- **Terminal host (TUI)**: the same mode system surfaces in the dsh-tui host as the
+  `/memory` command, a status line and a `/settings` section (see Quick Start).
 
 ## UI Preview
 

package/README.md

@@ -10,26 +10,27 @@
 [English](README.en.md) · [最新发行版](https://github.com/JunNanLYS/dsh-layered-memory/releases/latest) · [反馈问题](https://github.com/JunNanLYS/dsh-layered-memory/issues)
 
 [![npm version](https://img.shields.io/npm/v/dsh-layered-memory?color=6f83ff&style=flat-square&label=npm)](https://www.npmjs.com/package/dsh-layered-memory)
-[![DSH 0.1.2-alpha.x](https://img.shields.io/badge/DSH-0.1.2--alpha.x-8b5cf6?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
+[![DSH 0.1.2](https://img.shields.io/badge/DSH-0.1.2-8b5cf6?style=flat-square)](https://github.com/deepseek-ai/deepseek-harness)
 [![MIT License](https://img.shields.io/badge/license-MIT-536990?style=flat-square)](LICENSE)
 
 </div>
 
 ## 快速开始
 
-需要 Node ≥ 22.16 与 DeepSeek Harness ≥ **0.1.2-alpha.1**（0.8.12 起仅支持
-0.1.2-alpha.x 宿主线；旧版插件请看 [历史版本](https://github.com/JunNanLYS/dsh-layered-memory/releases)）。
+需要 Node ≥ 22.16 与 DeepSeek Harness **0.1.2-alpha.1 ~ 0.1.2-rc.1**（0.10.0 起
+支持到 0.1.2-rc.1，npm latest 已指向该版本；旧版插件请看
+[历史版本](https://github.com/JunNanLYS/dsh-layered-memory/releases)）。
 两种调用方式任选（`npx` 前缀可替换下面任何 `dsh` 命令）：
 
 ```bash
-# 方式一：npx 直接跑官方 CLI（无需预装 dsh；宿主须带 alpha 版本号——npm latest 仍指向 0.1.1-rc.x）
-npx -y @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add dsh-layered-memory
+# 方式一：npx 直接跑官方 CLI（无需预装 dsh）
+npx -y @deepseek-ai/dsh plugin --profile web add dsh-layered-memory
 
-# 方式二：已装 dsh CLI（先升级到 alpha 线：npm i -g @deepseek-ai/dsh@0.1.2-alpha.2 并重启；
+# 方式二：已装 dsh CLI（升级：npm i -g @deepseek-ai/dsh 并重启；
 # dsh 是 pnpm 转发器，未装 pnpm 时先 npm i -g pnpm）
 dsh plugin --profile web add dsh-layered-memory
 
-# 包源备选：GitHub 仓库 / 本地路径（开发调试，link: 指向仓库，npm run build + 重启 dsh 即生效）
+# 包源备选：GitHub 仓库 / 本地路径（开发调试，link: 指向仓库，pnpm run build + 重启 dsh 即生效）
 dsh plugin --profile web add https://github.com/JunNanLYS/dsh-layered-memory
 dsh plugin --profile web add /path/to/dsh-layered-memory
 ```
@@ -60,17 +61,37 @@ Agent 应当返回安装结果，并明确告诉你配置中是否已经出现 `
 **卸载**：`dsh plugin --profile web remove dsh-layered-memory` + 重启。数据保留在
 `~/.dsh/memory/`，不需要时手动删除整个目录即可。
 
+### 终端形态（TUI / headless）
+
+除 web 外，同一插件可直接装进终端形态宿主：
+
+```bash
+# dsh-tui（Claude Code 风格 TUI 前门，详见 github.com/ccch1mneyyy/dsh-TUI · 官网 https://dshtui.com）
+dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui   # 首次：建 profile 并装 TUI 宿主
+dsh plugin --profile dsh-tui add dsh-layered-memory
+dsh --profile dsh-tui
+```
+
+- **`/memory <auto|chat|work|off>`** 切换当前会话档位，无参数时弹出档位选择面板；
+- **状态行**：提示框上方常驻 `记忆:智能` 等当前档位读数；
+- **`/settings` 设置区块**：总开关、捕获、蒸馏、召回、蒸馏模型路由与输入预算可直接编辑
+  （与 web 设置面板同一存储；复杂路由链仍走 web / YAML）；
+- **headless**（`dsh --profile headless "一次性任务"`）：捕获与蒸馏照常工作，无界面元素。
+  web 与终端形态共享 `~/.dsh/memory/` 同一份记忆。
+
 ### 从源码开发
 
 ```bash
 git clone https://github.com/JunNanLYS/dsh-layered-memory
 cd dsh-layered-memory
-npm install && npm run build
-dsh plugin --profile web add .        # link: 安装，改代码后 npm run build + 重启 dsh 即生效
-npm run smoke                         # 冒烟测试（先重编：见下方命令）
+pnpm install && pnpm run build
+dsh plugin --profile web add .        # link: 安装，改代码后 pnpm run build + 重启 dsh 即生效
+pnpm run smoke                        # 冒烟测试（先重编：见下方命令）
 npx tsc src/smoke.ts --outDir dist-smoke --module nodenext --moduleResolution nodenext --target es2022 --strict --skipLibCheck --esModuleInterop
 ```
 
+依赖管理用 pnpm（与 dsh 官方安装通道一致，版本由 `packageManager` 字段钉死）。
+
 ## 运行时数据流
 
 <p align="center">
@@ -140,6 +161,8 @@ L1/L2/L3 层级过滤）、层级 × 时间窗口表格（调用数 / 输出与
   一并停止；`memory_search` 等读工具返回只写提示）。覆盖按会话持久化，切回
   「跟随全局」即清除、跟随自动化区的召回开关；适合调试/评测/敏感会话「只吸收不干扰」。
   与暂停正交：暂停是完全隐身（连捕获都关），只写保留「进」关「出」。
+- **终端形态（TUI）**：同一档位体系在 dsh-tui 宿主下以 `/memory` 命令、状态行与
+  `/settings` 区块呈现（安装见快速开始）。
 
 ## 界面预览