dsh-session-ops 0.2.0 → 0.2.1

package/README.md

@@ -7,7 +7,7 @@ One package, one host-plugin row, two halves:
 
 | Half | What it does | Entry points |
 | --- | --- | --- |
-| delete | filter by workspace / archive / subagent, batch select, per-session guards; removes data from disk | HTTP `/session-admin/api/*`, model tool `session_admin`, right-pane "会话管理" tab, conversation-header trash icon, settings page "会话工具" |
+| delete | filter by ungrouped / temp / archive / subagent, batch select, per-session guards; removes data from disk | HTTP `/session-admin/api/*`, model tool `session_admin`, right-pane "会话管理" tab, conversation-header trash icon, settings page "会话工具" |
 | move | relocate the log, rewrite `header.cwd`, follow workspace membership; optional memory follow (off by default) | HTTP `/session-move/api/*`, model tool `session_move`, right-pane "会话归位" tab, session context menu |
 
 The session-storage primitives live in this package under `lib/store/` (project-directory key
@@ -49,10 +49,10 @@ The plugin row has one shared `enabled` master switch; every other key is indepe
 
 | Key | Default | Meaning |
 | --- | --- | --- |
-| `enabled` | `true` | master switch; `false` registers no routes, tools or slots |
-| `root` | `''` | session root override; empty derives it from `$DSH_HOME/sessions` |
+| `enabled` | `true` | master switch; `false` registers no host routes or tools (the browser half still loads its tabs) |
+| `root` | `''` | session root override; empty reads `sessionPersistence.root` (`$DSH_HOME/sessions` for the jsonl backend) |
 | `adminAllowHosts` | `[]` | delete-half LAN trust list (parsed from the `Host` header) |
-| `moveAllowHosts` | `[]` | move-half LAN trust list (exact socket `remoteAddress` match) |
+| `moveAllowHosts` | `[]` | move-half LAN trust list (exact `Host` header match) |
 | `headerDeleteButton` | `true` | conversation-header trash icon (icon + two confirmations) |
 | `allowWorkspaceSessions` | `false` | allow deleting sessions that belong to a workspace |
 | `allowLiveSessions` | `false` | allow deleting sessions still loaded in the host |
@@ -62,10 +62,11 @@ The plugin row has one shared `enabled` master switch; every other key is indepe
 | `memoryFollow` | `off` | project-memory follow: `off` / `copy` / `move` (`move` is irreversible) |
 | `repairForkChildrenOnBoot` | `true` | re-file fork children whose membership was lost, at boot |
 
-The two trust keys **cannot** be merged: the delete half parses the `Host` header and additionally
-rejects `sec-fetch-site: cross-site` and cross-origin `Origin`, while the move half matches the
-socket address exactly. Merging them would loosen one half. Both only affect LAN access; loopback is
-always trusted.
+The two trust keys **cannot** be merged: the delete half decides loopback from the `Host` header and
+matches `adminAllowHosts` as a `host` or `host:port` authority, while the move half decides loopback
+from the socket's `remoteAddress` and matches `moveAllowHosts` against the exact `Host` value. Both
+reject `sec-fetch-site: cross-site` and cross-origin `Origin`; merging them would change one half's
+observable behaviour. Both only affect LAN access, and only loopback is trusted by default.
 
 The browser half registers one config card on the Plugins page: slot `plugins.bundle.config`, key =
 the package name `dsh-session-ops`, carrying the seven volatile knobs (4 delete + 3 move). Saving

package/README.zh.md

@@ -1,16 +1,15 @@
 # dsh-session-ops
 
-DeepSeek Harness（DSH）的**会话运维插件**：真删除会话、把会话搬到另一个工作区，并把工作区成员关系修好。
+DeepSeek Harness（DSH）的会话运维插件：真删除已持久化的会话，把会话搬到另一个工作区，并同步修好工作区成员关系。
 
 一个包、一个插件行，包含两个半边：
 
 | 半边 | 能力 | 入口 |
 | --- | --- | --- |
-| 删除 | 按工作区 / 归档 / 子代理筛选、批量选择、逐条守卫；真删磁盘数据 | HTTP `/session-admin/api/*`、模型工具 `session_admin`、右栏「会话管理」页签、会话标题栏垃圾桶、设置页「会话工具」 |
+| 删除 | 按未分组、临时或失效目录、归档、子代理筛选；批量选择；逐条守卫；真删磁盘数据 | HTTP `/session-admin/api/*`、模型工具 `session_admin`、右栏「会话管理」页签、会话标题栏垃圾桶、设置页「会话工具」 |
 | 搬迁 | 搬日志、改写 header 的 `cwd`、跟随工作区成员表；可选项目记忆跟随（默认关） | HTTP `/session-move/api/*`、模型工具 `session_move`、右栏「会话归位」页签、会话右键菜单 |
 
-会话存储原语（项目目录键编解码、`session[.vN].jsonl[.zstd]` 帧读写、工作区注册表、
-`$DSH_HOME` 与文件日志、HTTP 底座）收在本包的 `lib/store/`，两个半边共用同一份实现。
+会话存储原语收在本包的 `lib/store/`：项目目录键编解码、`session[.vN].jsonl[.zstd]` 帧读写、工作区注册表、`$DSH_HOME` 与文件日志、HTTP 底座。两个半边共用同一份实现。
 
 ## 安装
 
@@ -18,37 +17,32 @@ DeepSeek Harness（DSH）的**会话运维插件**：真删除会话、把会话
 dsh plugin --profile <profile> add dsh-session-ops
 ```
 
-装好后重启宿主（或按 DSH 的热加载规则让 profile 重组）。插件行由包内
-`cordis.patch.yml` 声明，entry id 是 `session-toolbox`。
+装好后重启宿主，或按 DSH 的热加载规则让 profile 重组。插件行由包内 `cordis.patch.yml` 声明，entry ID 是 `session-toolbox`。
 
-## ⚠️ 破坏性删除
+## 破坏性删除
 
-「删除」是**真删除**，不是归档：
+「删除」是真删除，不是归档。三处数据一起从磁盘移除：
 
-- `<DSH_HOME>/sessions/<项目目录键>/<session-id>/`（会话日志）
-- `<DSH_HOME>/storages/session_projcache/sessions/<session-id>.json`（投影缓存）
-- `<DSH_HOME>/rewind-snapshots/<session-id>/`（回退快照，若有）
+- `<DSH_HOME>/sessions/<项目目录键>/<session-id>/`：会话日志
+- `<DSH_HOME>/storages/session_projcache/sessions/<session-id>.json`：投影缓存
+- `<DSH_HOME>/rewind-snapshots/<session-id>/`：回退快照（若有）
 
-三处一起从磁盘移除，并顺手清理因此变空的项目目录。**没有回收站，删了无法恢复。**
-删除前请自行备份 `$DSH_HOME`；面板提供预演与二次确认，但最终责任在操作者。
+删除后顺手清理因此变空的项目目录。没有回收站，删了无法恢复；删除前请自行备份 `$DSH_HOME`。面板提供预演与二次确认，但最终责任在操作者。
 
-默认安全边界（可在配置里改）：`allowWorkspaceSessions=false`、`allowLiveSessions=false`、
-`refuseRunning=true` —— 工作区会话、正在跑的会话、运行中的搬迁默认都被拒绝。
+默认安全边界（可在配置里改）：`allowWorkspaceSessions=false`、`allowLiveSessions=false`、`refuseRunning=true`。工作区会话、正在跑的会话、运行中的搬迁默认都被拒绝。
 
-搬迁不是删除：日志目录从旧 project 目录整体移到新目录，`header.cwd` 改写，工作区
-成员表跟着变；0.2.2+ 内核里 `session.lock` 会一起搬走（inode 不变），目标目录已有
-租约时直接拒绝，不会制造「锁在旧目录、日志在新目录」的半套状态。
+搬迁不是删除：日志目录从旧 project 目录整体移到新目录，`header.cwd` 改写，工作区成员表跟着变。内核 0.2.2+ 的会话目录里有 `session.lock`，搬迁时会一起搬走（inode 不变）；目标目录已有租约时直接拒绝，不会留下「锁在旧目录、日志在新目录」的半套状态。
 
 ## 配置
 
-插件行只有一个 `enabled` 总开关，两半共用；其余键各自独立：
+插件行只有一个 `enabled` 总开关，两个半边共用；其余键各自独立：
 
 | 键 | 默认 | 作用 |
 | --- | --- | --- |
-| `enabled` | `true` | 总开关；`false` 时不注册任何路由、工具、槽位 |
-| `root` | `''` | 会话根目录；空表示用 `$DSH_HOME/sessions` |
-| `adminAllowHosts` | `[]` | 删除半边的 LAN 信任列表（按 `Host` 头解析 host/hostname 匹配） |
-| `moveAllowHosts` | `[]` | 搬迁半边的 LAN 信任列表（按 socket `remoteAddress` 精确匹配） |
+| `enabled` | `true` | 总开关；`false` 时宿主不注册路由与工具（浏览器侧页签仍会加载） |
+| `root` | `''` | 会话根目录；空则取 `sessionPersistence.root`（jsonl 后端为 `$DSH_HOME/sessions`） |
+| `adminAllowHosts` | `[]` | 删除半边的 LAN 信任列表（按 `Host` 头解析 `host` 或 `host:port`） |
+| `moveAllowHosts` | `[]` | 搬迁半边的 LAN 信任列表（按 `Host` 头完整值精确匹配） |
 | `headerDeleteButton` | `true` | 会话标题栏垃圾桶图标（图标 + 两步确认） |
 | `allowWorkspaceSessions` | `false` | 允许删除已归属工作区的会话 |
 | `allowLiveSessions` | `false` | 允许删除宿主里驻留的会话 |
@@ -58,36 +52,29 @@ dsh plugin --profile <profile> add dsh-session-ops
 | `memoryFollow` | `off` | 项目记忆跟随：`off` / `copy` / `move`（`move` 不可逆） |
 | `repairForkChildrenOnBoot` | `true` | 启动时补挂漏记账的 fork 子会话 |
 
-两个信任键**不能合并**：删除半边按 `Host` 头并拒绝 `sec-fetch-site: cross-site` 与
-跨源 `Origin`，搬迁半边按 socket 地址精确匹配；合成一个等于放宽其中一边。两者都只
-影响 LAN 访问，loopback 始终被信任。
+两个信任键不能合并：删除半边按 `Host` 头解析回环 authority，`adminAllowHosts` 可写 `host` 或 `host:port`；搬迁半边按 socket 的 `remoteAddress` 判断回环，`moveAllowHosts` 只认 `Host` 头的完整值。两边都拒绝 `sec-fetch-site: cross-site` 与跨源 `Origin`，合并会改掉其中一边的对外行为。两者都只影响 LAN 访问，默认只信回环。
 
-浏览器侧还有一处指向本行的配置卡片：槽 `plugins.bundle.config`，key 是包名
-`dsh-session-ops`，7 个 volatile 旋钮（删除 4 + 搬迁 3）保存即写回 profile 的
-`cordis.patch.yml`，无需重启。
+浏览器侧还有一处指向本行的配置卡片：槽 `plugins.bundle.config`，key 是包名 `dsh-session-ops`，含 7 个 volatile 旋钮（删除 4 + 搬迁 3）。保存即写回 profile 的 `cordis.patch.yml`，无需重启宿主。
 
 ## 兼容区间
 
 - Node.js `>=24`
 - DSH `^0.2.1-rc.2 || ^0.2.2-alpha.2`
 
-会话右键菜单需要内核提供 `@deepseek-ai/dsh-client-ui-context-menu`（0.2.2+）；没有这个
-服务时只少两个菜单项，页签、工具与 HTTP 入口照旧。搬迁时携带 `session.lock`、
-启动期 fork 子会话补记账同样以 0.2.2+ 的持久化实现为准。
+会话右键菜单需要内核提供 `@deepseek-ai/dsh-client-ui-context-menu`（0.2.2+）。没有这个服务时只少两个菜单项，页签、工具与 HTTP 入口照旧。搬迁时携带 `session.lock`、启动期 fork 子会话补记账，同样以 0.2.2+ 的持久化实现为准。
 
 ## 排障产物
 
 两份文件日志保留各自原有的行格式（历史产物，刻意不统一）：
 
-- `$DSH_HOME/logs/dsh-session-admin.log` —— `[时间] 级别 正文`
-- `$DSH_HOME/logs/dsh-session-move.log` —— `时间 [级别] 正文`
+- `$DSH_HOME/logs/dsh-session-admin.log`：`[时间] 级别 正文`
+- `$DSH_HOME/logs/dsh-session-move.log`：`时间 [级别] 正文`
 
-搬迁与自愈的关键行：`membership repair mounted`、`membership: attached fork child …`、
-`membership: attach failed …`、`membership sweep: re-attached N of M fork child(ren) …`。
+搬迁与自愈的关键行：`membership repair mounted`、`membership: attached fork child …`、`membership: attach failed …`、`membership sweep: re-attached N of M fork child(ren) …`。
 
 ## 作为库使用
 
-`lib/store/` 与插件生命周期无关、零 `@deepseek-ai/*` 依赖，可以单独引用。包里提供两种入口：
+`lib/store/` 与插件生命周期无关，零 `@deepseek-ai/*` 依赖，可以单独引用。包里提供两种入口：
 
 ```js
 // 根入口（与合并前的会话存储共享库公开面一致）
@@ -105,10 +92,7 @@ npm run build     # 宿主 tsc（src/ -> lib/、lib/types/）、浏览器 tsc（
 npm test          # 先 build，再用 node --test 跑 test/**/*.test.ts（Node ≥24 原生执行 TS）
 ```
 
-手写代码现在全是 TypeScript：宿主在 `src/`，浏览器半边在 `client/`（给
-`window.__ModuleLoader__` 用的经典脚本 IIFE，按单文件发射、不打包）。
-`lib/**/*.js` 与 `lib/types/` 是随仓库入库的构建产物（checkout / profile 安装不先 build 也能用）；
-`test/*.ts` 由 Node 直接执行，不参与发射。
+手写代码全部是 TypeScript：宿主在 `src/`，浏览器半边在 `client/`（给 `window.__ModuleLoader__` 用的经典脚本 IIFE，按单文件发射、不打包）。`lib/**/*.js` 与 `lib/types/` 是随仓库入库的构建产物，checkout 或 profile 安装不先 build 也能用；`test/*.ts` 由 Node 直接执行，不参与发射。
 
 ## License
 

package/cordis.patch.yml

@@ -2,7 +2,7 @@
 #
 # 合并包：一个插件行同时提供原先两个插件的能力。
 #   - 删除（原 dsh-session-admin）：HTTP /session-admin/api，模型工具 session_admin，
-#     右栏「会话管理」页签，会话标题栏垃圾桶图标，设置页「会话清理」卡片。
+#     右栏「会话管理」页签，会话标题栏垃圾桶图标，设置页「会话工具」卡片。
 #   - 搬迁（原 dsh-session-move）：HTTP /session-move/api，模型工具 session_move，
 #     右栏「会话归位」页签（含左栏底部入口）。
 # 两个半边共用本行的这一份配置；插件页上本行的「配置」卡片就是合并后的那张（7 个旋钮）。

package/docs/DETAIL.md

@@ -4,19 +4,21 @@ Turns the session-to-workspace binding into an explicit tool: really delete sess
 between workspaces while keeping the registry consistent.
 
 ## Two right-pane tabs
-  - Delete: filter by workspace, archive or subagent; batch select; running sessions refused by default.
+  - Delete: filter by ungrouped, temp, archived or subagent; batch select; running sessions refused by default.
   - Move: relocate the log, rewrite header cwd, follow workspace membership; optional memory follow (off).
 
 ## Other entry points
   - Session context menu: move / delete.
   - Model tools session_admin, session_move; host HTTP /session-admin/api, /session-move/api.
 
-## Shared storage primitives (`lib/store`)
-  - `paths.js`: project-directory key codec (`projectKey` / `encodeSegment`), session and generation file naming.
-  - `frames.js`: `session[.vN].jsonl[.zstd]` frame scanning, header read (two strictness levels), cwd rewrite.
-  - `registry.js`: workspace membership and archive sets, resident sessions, mid-turn detection, write-handle redirection.
-  - `host.js`: `$DSH_HOME`, best-effort file logging, volatile config unwrapping.
-  - `http.js`: shared JSON response / request-body plumbing and the prefixed route skeleton.
+## Shared storage primitives
+
+Sources live in `src/store/*.ts` and are built to `lib/store/*.js`:
+  - `paths.ts`: project-directory key codec (`projectKey` / `encodeSegment`), session and generation file naming.
+  - `frames.ts`: `session[.vN].jsonl[.zstd]` frame scanning, header read (two strictness levels), cwd rewrite.
+  - `registry.ts`: workspace membership and archive sets, resident sessions, mid-turn detection, write-handle redirection.
+  - `host.ts`: `$DSH_HOME`, best-effort file logging, volatile config unwrapping.
+  - `http.ts`: shared JSON response / request-body plumbing and the prefixed route skeleton.
 
 ## Notes
   - A move carries session.lock (0.2.2+ write lease) and empties the source directory; it refuses when the target already holds a lease.

package/docs/DETAIL.zh.md

@@ -1,23 +1,29 @@
 # 会话运维
 
-把 DSH 的「会话 → 工作区」绑定关系做成可操作的工具：真实删会话、把会话搬到另一个工作区，并把成员关系修好。
+把 DSH 的「会话 → 工作区」绑定关系做成可操作的工具：真删除会话、把会话搬到另一个工作区，并修好成员关系。
 
 ## 两个页签
-  - 删除：按工作区、归档、子代理筛选，批量选择；运行中会话默认拒绝。
-  - 搬迁：列出会话与归属，选择目标工作区后搬日志、改 header cwd、跟随注册表成员；支持记忆条目跟随（默认关）。
+
+- 删除：按未分组、临时或失效目录、归档、子代理筛选，支持批量选择；运行中的会话默认拒绝。
+- 搬迁：列出会话与归属，选择目标工作区后搬日志、改 header 的 `cwd`、跟随注册表成员；支持项目记忆跟随（默认关）。
 
 ## 其他入口
-  - 会话右键菜单：移动会话到工作区…、删除会话…
-  - 模型工具 session_admin、session_move；宿主 HTTP /session-admin/api、/session-move/api。
 
-## 共享存储原语（`lib/store`）
-  - `paths.js`：项目目录 key 编解码（projectKey / encodeSegment）、会话目录与 generation 文件名规则。
-  - `frames.js`：`session[.vN].jsonl[.zstd]` 帧扫描、header 读取（两种严格度）、cwd 改写。
-  - `registry.js`：工作区成员表 / 归档集合、驻留会话、「正在跑一轮」判定、写入句柄重定向。
-  - `host.js`：`$DSH_HOME`、尽力而为的文件日志、volatile 配置解包。
-  - `http.js`：JSON 响应 / 请求体读取底座与前缀路由骨架。
+- 会话右键菜单：移动会话到工作区…、删除会话…
+- 模型工具 `session_admin`、`session_move`；宿主 HTTP `/session-admin/api`、`/session-move/api`。
+
+## 共享存储原语
+
+源码在 `src/store/*.ts`，构建后是 `lib/store/*.js`：
+
+- `paths.ts`：项目目录 key 编解码（`projectKey` / `encodeSegment`）、会话目录与 generation 文件名规则。
+- `frames.ts`：`session[.vN].jsonl[.zstd]` 帧扫描、header 读取（两种严格度）、cwd 改写。
+- `registry.ts`：工作区成员表与归档集合、驻留会话、「正在跑一轮」判定、写入句柄重定向。
+- `host.ts`：`$DSH_HOME`、尽力而为的文件日志、volatile 配置解包。
+- `http.ts`：JSON 响应与请求体读取底座、前缀路由骨架。
 
 ## 注意
-  - 搬迁会把 session.lock 一起搬走（0.2.2+ 写租约），源目录清空；目标已有租约时拒绝。
-  - 启动时会做一次 fork 子会话的定向补记账（repairForkChildrenOnBoot，默认开）。
-  - 删除是永久性的：没有回收站、无法恢复，操作前请备份 `$DSH_HOME`。
+
+- 搬迁会把 `session.lock` 一起搬走（内核 0.2.2+ 写租约），源目录清空；目标已有租约时拒绝。
+- 启动时会做一次 fork 子会话的定向补记账（`repairForkChildrenOnBoot`，默认开）。
+- 删除是永久性的：没有回收站、无法恢复；操作前请备份 `$DSH_HOME`。

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "dsh-session-ops",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "publishConfig": {
     "access": "public"
   },
-  "description": "Session operations for DeepSeek Harness: really delete persisted sessions (workspace/archive/subagent filters, running-session guards) and move sessions between workspaces (log relocation, header.cwd rewrite, workspace registry follow). Ships the shared session-store primitives (project-directory keys, jsonl.zstd frames, workspace registry, host/HTTP plumbing) as lib/store. One host entry with two HTTP prefixes and two model tools, one browser bundle with two right-pane tabs and a merged config card.",
+  "description": "Session operations for DeepSeek Harness: really delete persisted sessions (ungrouped/temp/archive/subagent filters, running-session guards) and move sessions between workspaces (log relocation, header.cwd rewrite, workspace registry follow). Ships the shared session-store primitives (project-directory keys, jsonl.zstd frames, workspace registry, host/HTTP plumbing) as lib/store. One host entry with two HTTP prefixes and two model tools, one browser bundle with two right-pane tabs and a merged config card.",
   "keywords": [
     "dsh",
     "dsh-plugin",