dsh-sidebar-suite 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,12 +1,30 @@
 # 更新日志 / Changelog
 
-> 版本号以 npm registry **实际发布记录**为准（当前：`0.0.0-stage`、`0.1.3`、`0.2.4`、`0.2.5`、`0.2.6`、`0.2.7`、`0.2.8`、`0.2.9`、`0.3.0`）。
+> 版本号以 npm registry **实际发布记录**为准（当前：`0.0.0-stage`、`0.1.3`、`0.2.4`、`0.2.5`、`0.2.6`、`0.2.7`、`0.2.8`、`0.2.9`、`0.3.0`、`0.4.0`）。
+> ⚠️ **`0.3.0` 已弃用 / deprecated**：它会让 DSH 卡在 `Loading plugins…` 且主窗口不显示（见 0.4.0 章节第一条）。请升级到 `0.4.0` 或更高版本。`0.3.0` hangs DSH on the loading screen; upgrade to 0.4.0 or later.
 > `0.2.0`、`0.2.1`、`0.2.2`、`0.2.3` 是开发过程中的本地迭代号，**从未单独发布**；它们的功能一次性随 `0.2.4` 上线，所以在下面合并记录。
 >
 > Versions mirror the npm registry. `0.2.0`–`0.2.3` were local iteration numbers that were never published on their own; all of their features shipped together in `0.2.4`.
 
 ---
 
+## 0.4.0 — 临时会话可以「转正」或「立即删除」/ Promote or delete a temp session（2026-11-11）
+
+**这次改了运行时代码**（`lib/client.js` 与宿主半 `lib/temp-session-host.mjs`），所以**升级后要托盘退出 DSH 再重开一次**。This release touches both halves; quit DSH from the tray and reopen once after upgrading.
+
+- **⛔ 修复启动死循环（严重，0.3.0 起就有）** — 0.3.0 的页签条插在控制栏与宿主「扩展」面板之间，但 `ensureBar()` 仍要求控制栏的 `nextSibling` 就是那个面板，于是每次 `paint()` 把控制栏搬一次、`ensureTabStrip()` 又搬回来；root 的 childList 变化触发插件自己的 `MutationObserver` → `scheduleSync()` → `paint()`，微任务队列永不排空。表现是**渲染进程 100%、主窗口隐藏、停在 `Loading plugins…`，整个 DSH 打不开**。修复后位置判断改成「顺序在前」而不是「紧邻」，`ensureTabStrip()` 同理；并加了一道「同一宏任务内最多 16 次 sync」的熔断，将来任何重绘自激也不会再把应用锁死。三种布局、以及插件页签接管侧栏的场景都做了真机验收（窗口正常、CDP 秒回、root 子节点顺序 4 次采样不变、8 秒内各进程 CPU 增量 ≤ 0.17s）。**`0.3.0` 已在 npm 标记弃用，请升级到 0.4.0。** The 0.3.0 tab strip sat between the control bar and the panels nav while `ensureBar()` still demanded adjacency, so every repaint moved the bar and fired the plugin's own observer — an endless microtask loop that hid the window on "Loading plugins…". Position checks now compare order instead of adjacency, plus a per-macrotask sync cap. The published 0.3.0 is affected and has been deprecated on npm.
+- **测试** — 新增 `tests/test_033.mjs`（13 项）：让 DOM 桩真的把 `MutationObserver` 回调投递回来，一次普通的宿主 DOM 变化就会复现自激。修复前 6 项失败（撞上 200 次变更上限，三种布局全部中招），修复后每次重绘 0 次 root 变更、节点顺序不变。`npm test` 链扩为 11 套。A new suite delivers observer callbacks the way a browser does; the old code spins past a 200-mutation cap, the fixed code settles on zero mutations.
+- **右键临时会话行，弹出「保留为正式会话 / 立即删除」** — 之前临时会话是「要么全删，要么全留」：想留下某一个，只能去把 `DELETE_ON_EXIT` 关掉，结果**所有**临时会话都变成永久。现在单个会话可以就地处理。Right-clicking a temporary row now offers both options, so one session no longer forces a global setting.
+- **只接管临时会话那一行** — 右键普通会话行时插件**完全不碰事件**（不 `preventDefault`、不 `stopPropagation`），宿主或别的插件的右键菜单照常工作。The handler never touches rows it does not own.
+- **「保留为正式会话」后端零改动** — 走的是 0.2.0 就有的 `POST /api/dsh-temp-session.untrack`，只是过去没有入口。Promotion reuses the existing untrack route.
+- **「立即删除」新增一个路由** — `POST /api/dsh-temp-session.remove?sessionId=…`，复用 `purgeAll` 的删除与兜底：先删目录，确认真的没了；文件被占用就先从列表隐藏（`archiveSession`），下次启动再删；**删不掉就仍然留在 tracked 里**，保证下次启动会重试，而不是悄悄变成一个点不开的幽灵。A new single-id route reuses the same delete/hide/retry ladder as the bulk cleanup.
+- **这条路由只接受「临时会话」** — 命中 `state.tracked` 之外的 id 直接拒绝，且在任何文件操作之前拒绝。它能从页面调到，所以绝不能变成「按 id 删任意会话」的接口。It refuses anything outside the tracked set, before touching the filesystem.
+- **菜单本身** — 顶部一行是被右键那一行的标题（截断 48 字，因为会话标题由宿主拥有），下面两个动作各带一句后果说明；靠近视口右/下边缘会自动翻转回界内；`Esc` 关闭并把焦点还给那一行、方向键在两项间移动、点菜单外 / 滚动 / 改窗口大小都会关掉。The menu echoes the row title, explains each consequence, flips near viewport edges, and closes on Esc, outside click, scroll or resize.
+- **`TEMP_ROW_MENU=on` 新开关** — 万一和别的插件抢右键菜单，把它改成 `off` 即可（详情页也有同一个开关，不用手改文件）。A new switch, also exposed on the detail page, in case another plugin owns the context menu.
+- **测试** — 新增 `tests/test_032.mjs`（60 项）：跑真实 `lib/client.js`，按宿主的方式造出 `data-row-key="session:<id>"` 行，然后像用户那样右键、点动作、按 Esc、点外部；覆盖「非临时行完全不被拦截」「保留后属性消失」「删除后调用正确的路由」「文件被占用时提示隐藏而非删除」「失败不吞掉」以及尺寸翻转。顺手把 DOM 桩抽成 `tests/dom-stub.mjs`，由 `test_031` 与 `test_032` 共用（`test_031` 仍是 53 项）。`npm test` 链扩为 10 套。One new suite drives the real bundle against fabricated session rows and clicks through the menu; the fake DOM is now shared by both rendering suites.
+
+---
+
 ## 0.3.0 — 第三方插件可以注册自己的页签 / Third-party tabs（2026-11-11）
 
 **这次改了运行时代码**（`lib/client.js`），所以**升级后要托盘退出 DSH 再重开一次**。This release touches `lib/client.js`; quit DSH from the tray and reopen once after upgrading.

package/DETAIL.md

@@ -157,7 +157,7 @@ For local development, point the same command at this folder or a packed `.tgz`.
 
 **为什么删除是安全的**：`dsh-session-query-sqlite` 的 `_reconcile()` 会拿「磁盘上实际存在的会话」和索引行对比，多出来的行直接 `persistentDeletes`，因此删目录之后搜索索引会自愈，不会留下点不开的幽灵会话。
 
-配置：`SHOW_TEMP_BUTTON` / `TEMP_IN_CHAT_MODE` / `TEMP_BUTTON_STYLE` / `EXPAND_ALL_SESSIONS` / `DELETE_ON_EXIT` / `SCHEDULE_DELETE` / `SCHEDULE_TIME` / `MAX_KEPT` —— **全部 8 项都能在详情页设**，用记事本改等号右边也行，保存后约 3 秒自动生效，不用重启。
+配置：`SHOW_TEMP_BUTTON` / `TEMP_IN_CHAT_MODE` / `TEMP_BUTTON_STYLE` / `EXPAND_ALL_SESSIONS` / `TEMP_ROW_MENU` / `DELETE_ON_EXIT` / `SCHEDULE_DELETE` / `SCHEDULE_TIME` / `MAX_KEPT` —— **全部 9 项都能在详情页设**，用记事本改等号右边也行，保存后约 3 秒自动生效，不用重启。
 
 **详情页设置（0.2.2）**：插件详情页顶部卡片新增「临时会话自动删除」区块 —— 「退出 DSH 时删除」和「每天定时清理 + 时间」两个独立开关。它不走 `configForms`，而是 `GET/POST /api/dsh-temp-session.config` 交给 Host 半执行，因为**只有一个数据源**：`temp-session-config.txt`。Host 半按行替换（`KEY=value` 只换 `= ` 右边），注释、空行、键顺序原样保留，用户手写的内容不会丢；缺失的键追加到末尾。保存后立即 `restartScheduler()`，无需重启。
 
@@ -171,12 +171,29 @@ For local development, point the same command at this folder or a packed `.tgz`.
 - 退出删除（`DELETE_ON_EXIT`）不受 `skipActiveMs` 保护：退出本身就是用户要求清理，而且进程马上消失，没有「下次再说」的机会。
 - 两个开关互相独立，可以同时开：白天不关 DSH 的人要「每晚 3 点清」，每天关机的人要「退出即清」。
 
+**单条转正 / 立即删除（0.4.0）**
+
+之前临时会话是「要么全删、要么全留」：想留下某一个，只能关掉 `DELETE_ON_EXIT`，代价是**所有**临时会话一起变成永久。0.4.0 补上了单行入口 —— 右键带「临时」标签的会话行。
+
+四个设计取舍：
+
+- **入口用右键，不在行里加按钮**。会话行由 React 拥有，往里塞节点会被下一次重渲染清掉；`data-dsbs-temp-row` 是属性，`applyTempRows()` 随时能补回来，节点不行。右键是零 DOM 侵入的入口。
+- **只拦自己的行**。`onTempContextMenu` 先解析 `data-row-key`，id 不在 `tempIds` 里就直接 `return`，`preventDefault()` 根本不会执行。所以宿主或别的插件的右键菜单在普通会话上照常工作 —— 这是这条功能唯一的兼容性风险，用「不碰」消掉它。真撞上了还有 `TEMP_ROW_MENU=off` 整条让出。
+- **「保留」复用已有后端**。0.2.0 起就有 `POST /api/dsh-temp-session.untrack`，只是当时没有 UI 入口。所以转正是纯前端改动，Host 半一行没动。
+- **「删除」新增路由，且只能删 tracked**。`POST /api/dsh-temp-session.remove?sessionId=…` 走 `removeOne()`：先 `removeSession()` 删目录，再用 `sessionDirsSync()` 确认真的空了；没删掉就 `hideSession()` 归档隐藏。关键在**只接受 `state.tracked` 里的 id，且在调用任何文件操作之前就拒绝** —— 这条路由能从页面调到，不能变成「按 id 删任意会话」的通用删除接口。删除失败时不从 tracked 移除，下次启动继续重试（与 `purgeAll` 一致），否则会留下「已经不算临时、却还在磁盘上」的孤儿。
+
+菜单本身：`role="menu"` + `role="menuitem"`，首项自动获得焦点；方向键在两项间循环，`Esc` 关闭并把焦点还给那一行，点外部 / `scroll` / `resize` 都会关闭（菜单是 `position:fixed`，不关就会飘在错误的行旁边）。视口边缘翻转用 `getBoundingClientRect()` 实测，读不到时退回 `offsetWidth`/`offsetHeight` 与保守的 220×96。
+
+Plain English: right-clicking a temporary row opens a two-item menu. "Keep" simply calls the untrack route that has existed since 0.2.0; "Delete now" goes through a new single-id route that refuses anything outside the tracked set before touching the filesystem, hides the row when a file is locked, and keeps the id tracked so the next launch retries. The menu never touches rows this plugin does not own.
+
 **限制 / Limits**
 
 - 退出前会话仍写在磁盘上（原生窗口的前提）。
 - 强杀 DSH 时退出钩子来不及跑，残留会话在下一次启动时删除。
 - 文件被占用导致删不掉时，先归档隐藏，下一次启动再删。
 - CHAT 官网模式下临时按钮默认隐藏（那条链路是 DeepSeek 网页账号，和 DSH 会话不是一回事）；`TEMP_IN_CHAT_MODE=show` 可强显，`TEMP_BUTTON_STYLE=own` 可完全避开与侧栏顶部控件的抢位。
+- 右键菜单只作用于**临时会话行**。若另一个插件也接管了这些行的右键，把 `TEMP_ROW_MENU` 改成 `off` 让出位置（详情页有同一个开关）。
+- 菜单动作是异步的：点「立即删除」后，行从列表里消失要等宿主自己刷新（插件会尝试调 `uiWorkspace().sessions.reload/refresh/invalidate`，没有这个 API 时静默跳过）。
 
 **侧栏顶部按钮的 DOM 约束（0.2.1）**：`dsh-deepseek-chat` 的侧栏适配器（`lib/client.js` 里的 `attachSidebarAdapter`）会从 `sidebar.brand.name` 插槽往上走五层，然后要求侧栏根节点下 `<button>` 子元素**恰好 1 个**（`controls()` 里的 `buttons.length === 1 && buttons[0] === row.nextElementSibling`）。0.2.0 把「临时」按钮作为根节点的第 2 个 `<button>` 插进去，适配器直接 `return null`，于是它在切换器下渲染「当前侧栏不兼容：顶部新会话仍使用 HARNESS」并且不再接管「新会话」。0.2.1 把按钮装进 `[data-dsbs-temp-slot]`（`<div>`），根节点的 `<button>` 计数回到 1，适配器恢复。回归测试见 `_probe/chat-compat.mjs`：它从插件 bundle 里抽出真实的 `attachSidebarAdapter` 跑一遍假 DOM。
 

package/README.md

@@ -24,7 +24,7 @@ The full detail document is [DETAIL.md](DETAIL.md).
 
 | 设计取向 / Design goal | 落在哪 / What it means |
 | --- | --- |
-| **强实用性 / Seriously practical** | 三种布局一键切换、默认布局在详情页顶部直接改、会话列表默认全展开（不用再点「展开其余」）、「临时」开真会话且**默认在退出 DSH 时删除**（`DELETE_ON_EXIT=on`；**每天定时清理默认关**，需要时在详情页开启并设时间）、详情页三种反馈入口 |
+| **强实用性 / Seriously practical** | 三种布局一键切换、默认布局在详情页顶部直接改、会话列表默认全展开（不用再点「展开其余」）、「临时」开真会话且**默认在退出 DSH 时删除**（`DELETE_ON_EXIT=on`；**每天定时清理默认关**，需要时在详情页开启并设时间）、**临时会话可右键「保留为正式会话」或「立即删除」**（0.4.0）、详情页三种反馈入口 |
 | **美观性 / Looks native** | 颜色与层级全取宿主设计变量、深浅主题自动跟随；细字号控制栏、迷你布局示意图、「临时」用 CSS 标签不破坏行高；不重构宿主 DOM、不弹窗、不另起一套皮肤 |
 
 完整的「强实用性 / 美观性」逐条说明见 [DETAIL.md](DETAIL.md) 的「这是一款什么插件」一节。
@@ -209,6 +209,27 @@ DSH 自己的会话列表每个工作区只先显示 5 条，剩下的折叠成
 - **用的是 DSH 原生会话窗口**：原生消息流、原生输入框、原生的工具调用/文件读写/命令执行，模型就是你当前在 DSH 里选的那个。插件不再自己画窗口，也不再自己调模型。
 - 唯一的区别是**退出 DSH 时它会被删掉**。行首会有一个「**临时**」小标签，方便你一眼认出来。
 
+### 右键：保留为正式会话 / 立即删除（0.4.0）
+
+**在侧栏里右键任何一个带「临时」标签的会话行**，会弹出一个两项菜单：
+
+| 选项 | 结果 |
+|---|---|
+| **保留为正式会话** | 它从此不算临时 —— 退出 DSH 不会删、定时清理不会碰，和普通会话完全一样 |
+| **立即删除** | 当场删掉这个会话的磁盘文件，不用等退出（不可恢复） |
+
+出现的时机与边界：
+
+- **只对临时会话行生效**。右键普通会话时插件**完全不碰那个事件**，宿主或别的插件的右键菜单照常弹出。
+- 菜单第一行是那一行的标题（太长会截断），每个选项下面有一句后果说明，避免误点「立即删除」。
+- `Esc` 关闭、方向键切换、`Enter` 执行；点菜单外面、滚动、改变窗口大小都会关掉。
+- 靠近屏幕右边缘或底边缘时会自动往回收，不会被切掉。
+
+**想关掉它**：详情页的「临时会话右键菜单」开关，或把 `TEMP_ROW_MENU` 改成 `off`。如果哪天有别的插件也想接管右键，用这个开关把位置让出去即可。
+
+> 「删不掉」时不会假装成功：文件被别的进程占用时，先把这行从列表里隐藏，并提示「下次启动再删」，而不是留一个点不开的幽灵会话。
+> If a file is locked, the row is hidden and retried next launch instead of pretending the delete worked.
+
 ### 它是怎么被删掉的（说清楚，不夸大）
 
 DSH **没有公开的「删除会话」接口**（我核对过 `app.asar`：`session/create`、`session/rename`、`workspace/archiveSession` 都有，就是没有 delete；官方界面上的「归档」只是把会话从列表里藏起来，文件还在磁盘上）。所以删除是插件自己做的，两道保险：
@@ -233,7 +254,7 @@ DSH **没有公开的「删除会话」接口**（我核对过 `app.asar`：`ses
 
 ### 全部设置图形化 + 配置热重载（0.2.8）
 
-详情页最上面那张卡现在能改**全部 8 项**配置，不用再碰文本：
+详情页最上面那张卡现在能改**全部 9 项**配置，不用再碰文本：
 
 | 设置 | 对应键 |
 | --- | --- |
@@ -241,6 +262,7 @@ DSH **没有公开的「删除会话」接口**（我核对过 `app.asar`：`ses
 | CHAT 官网模式：隐藏 / 显示 | `TEMP_IN_CHAT_MODE` |
 | 按钮摆法：并排 / 独占一行 | `TEMP_BUTTON_STYLE` |
 | 会话默认全展开 | `EXPAND_ALL_SESSIONS` |
+| 临时会话右键菜单 | `TEMP_ROW_MENU` |
 | 退出 DSH 时删除 | `DELETE_ON_EXIT` |
 | 每天定时清理 + 时间 | `SCHEDULE_DELETE` / `SCHEDULE_TIME` |
 | 最多保留几个 | `MAX_KEPT` |
@@ -261,6 +283,7 @@ DSH **没有公开的「删除会话」接口**（我核对过 `app.asar`：`ses
 | `TEMP_IN_CHAT_MODE` | `hide` | 装了 `dsh-deepseek-chat` 时，处于 CHAT 官网模式要不要显示按钮 |
 | `TEMP_BUTTON_STYLE` | `pair` | `pair` = 和「新会话」并排；`own` = 单独占一行，完全不动「新会话」 |
 | `EXPAND_ALL_SESSIONS` | `on` | 会话列表全部展开并隐藏「展开其余 N 个会话」；`off` = 恢复宿主折叠 |
+| `TEMP_ROW_MENU` | `on` | 右键临时会话是否弹出「保留为正式会话 / 立即删除」；`off` = 不接管右键 |
 | `DELETE_ON_EXIT` | `on` | 退出时删除；改 `off` 就不再删，临时会话等于普通会话 |
 | `SCHEDULE_DELETE` | `off` | 每天定时清理；`on` = 到点把临时会话删掉 |
 | `SCHEDULE_TIME` | `03:00` | 定时清理的时间（24 小时制 `HH:MM`，本机时间） |

package/lib/client.js

@@ -21,7 +21,7 @@ window.__ModuleLoader__.load({
     var ENTRY = 'dsh-sidebar-suite'
     // Reported to tab consumers so they can feature-detect. Kept in lockstep
     // with package.json by tests/test_030.mjs.
-    var VERSION = '0.3.0'
+    var VERSION = '0.4.0'
     var NS = 'sidebar-suite'
     var LS_KEY = 'dsh-sidebar-suite:state'
     // Where the third-party tab choice lives. Kept out of LS_KEY on purpose:
@@ -106,6 +106,15 @@ window.__ModuleLoader__.load({
         'temp.feedbackHint': 'Report it on the plugin detail page.',
         'temp.restartHint': 'Fully quit DSH (tray icon → Quit) and reopen it — a hot reload does not reload the plugin host.',
         'temp.badge': 'TEMP',
+        'temp.menu.label': 'Temporary session actions',
+        'temp.menu.keep': 'Keep as a normal session',
+        'temp.menu.keep.hint': 'It will no longer be deleted when DSH quits.',
+        'temp.menu.delete': 'Delete now',
+        'temp.menu.delete.hint': 'Removes this session from disk. It cannot be undone.',
+        'temp.menu.kept': 'Kept as a normal session — it now survives quitting DSH.',
+        'temp.menu.deleted': 'Temporary session deleted.',
+        'temp.menu.hidden': 'Files were locked, so the row was hidden instead. Deletion is retried next launch.',
+        'temp.menu.failed': 'Action failed: ',
         'policy.title': 'Temporary session cleanup',
         'policy.help': 'Choose when temporary sessions are removed. Defaults: delete on quit = on, daily cleanup = off. Saved to the plugin settings file and applied immediately — no restart.',
         'policy.onQuit': 'Delete when DSH quits',
@@ -160,6 +169,15 @@ window.__ModuleLoader__.load({
         'temp.feedbackHint': '可在插件详情页反馈。',
         'temp.restartHint': '请从托盘图标彻底退出 DSH 再打开 —— 热重载不会重载插件后端。',
         'temp.badge': '临时',
+        'temp.menu.label': '临时会话操作',
+        'temp.menu.keep': '保留为正式会话',
+        'temp.menu.keep.hint': '退出 DSH 时不再删除它。',
+        'temp.menu.delete': '立即删除',
+        'temp.menu.delete.hint': '把这个会话从磁盘删掉，无法恢复。',
+        'temp.menu.kept': '已保留为正式会话：退出 DSH 时不会再删除它。',
+        'temp.menu.deleted': '临时会话已删除。',
+        'temp.menu.hidden': '文件被占用，已先把它从列表里隐藏，下次启动再删。',
+        'temp.menu.failed': '操作失败：',
         'policy.title': '临时会话自动删除',
         'policy.help': '决定临时会话什么时候被清掉。默认：退出 DSH 时删除=开，每天定时清理=关。写入插件设置文件，改完立即生效，不用重启。',
         'policy.onQuit': '退出 DSH 时删除',
@@ -206,6 +224,8 @@ window.__ModuleLoader__.load({
       'options.styleOwn': '独占一行 / Own row',
       'options.expandAll': '会话默认全展开 / Always expand sessions',
       'options.expandHint': '关掉后恢复 DSH 原来的折叠行为；已经展开的列表要切换一次工作区才会收回去。 / Turning it off restores host folding; already-expanded groups collapse after you switch workspaces once.',
+      'options.rowMenu': '临时会话右键菜单 / Right-click menu on temp sessions',
+      'options.rowMenuHint': '右键临时会话可「保留为正式会话」或「立即删除」。若和别的插件抢右键菜单，关掉这一项即可。 / Right-clicking a temp session offers "keep as normal" or "delete now". Turn this off if another plugin owns the context menu.',
       'options.maxKept': '最多保留 / Keep at most',
       'options.maxKeptHint': '个临时会话（1–200） / temp sessions (1–200)',
       'options.purge': '立即清理临时会话 / Clean up now',
@@ -314,6 +334,19 @@ window.__ModuleLoader__.load({
       // In the collapsed rail there is no horizontal room for two buttons.
       'html[data-dsbs-temp-solo="true"] [data-dsbs-temp-slot]{display:none!important}',
       'html[data-dsbs-temp-solo="true"]:not([data-dsbs-chat-mode]) [data-dsbs-newchat] button[class*="newSession"]{width:auto!important;height:38px!important;font-size:14px!important;line-height:22px!important;margin:0 calc(var(--dsh-sidebar-paint-inset,3px) + 1px) 10px!important}',
+      // ---- per-row menu on temporary sessions (0.4.0) -------------------
+      // Right-clicking a temporary row offers "keep as normal" and "delete
+      // now". Styled from host tokens like every other surface here; the row
+      // itself gains no children, so React re-renders cannot wipe it.
+      '[data-dsbs-temp-menu]{position:fixed;z-index:9400;min-width:196px;max-width:min(280px,calc(100vw - 16px));box-sizing:border-box;padding:4px;display:flex;flex-direction:column;gap:1px;border-radius:10px;background:var(--dsw-alias-bg-overlay,var(--dsw-alias-bg-base,#1f1f1f));color:var(--dsw-alias-label-primary,inherit);border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.3));box-shadow:0 12px 32px rgba(0,0,0,.32)}',
+      '[data-dsbs-temp-menu][hidden]{display:none!important}',
+      '[data-dsbs-temp-menu-head]{padding:4px 8px 6px;margin-bottom:2px;border-bottom:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.22));font-size:11px;line-height:1.5;color:var(--dsw-alias-label-tertiary,rgba(127,127,127,.9));overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '[data-dsbs-temp-menu] button{appearance:none;-webkit-appearance:none;display:block;width:100%;box-sizing:border-box;border:0;background:transparent;color:inherit;font:inherit;font-size:12px;line-height:1.45;text-align:left;padding:6px 8px;border-radius:7px;cursor:pointer;white-space:normal}',
+      '[data-dsbs-temp-menu] button:hover,[data-dsbs-temp-menu] button:focus-visible{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.16));outline:none}',
+      '[data-dsbs-temp-menu] button:focus-visible{outline:2px solid var(--dsw-alias-label-primary,currentColor);outline-offset:-2px}',
+      '[data-dsbs-temp-menu] button[data-dsbs-temp-action="delete"]{color:var(--dsw-alias-state-business-danger,#d9534f)}',
+      '[data-dsbs-temp-menu-sub]{display:block;font-size:10px;line-height:1.4;opacity:.68}',
+      'html[data-dsbs-temp-menu="false"] [data-dsbs-temp-menu]{display:none!important}',
       // A temporary session is a NORMAL DSH session, so its sidebar row is the
       // host's own row. Nothing is added to the DOM: we tag the row and let CSS
       // draw the badge, which survives every React re-render of the list.
@@ -714,6 +747,12 @@ window.__ModuleLoader__.load({
       var configPollPending = false
       var tempChatGuard = null
       var tempIds = [] // session ids the Host half will delete on quit
+      // 0.4.0 — per-row menu. `tempMenuEnabled` mirrors TEMP_ROW_MENU and is the
+      // escape hatch if another plugin wants the context menu on these rows.
+      var tempMenuEnabled = true
+      var tempRowMenu = null
+      var tempMenuRow = null
+      var tempMenuDismiss = null
       var tempBusy = false
       var tempToastTimer = 0
 
@@ -982,6 +1021,275 @@ window.__ModuleLoader__.load({
         }
       }
 
+      // ---- per-row menu on temporary rows (0.4.0) -----------------------
+      // A temporary session used to be all-or-nothing: either it vanished at
+      // quit, or you turned DELETE_ON_EXIT off and every temp session became a
+      // normal one. Now a single row can be promoted ("keep as a normal
+      // session") or deleted on the spot.
+      //
+      // Both actions already existed on the Host half — `untrack` and the new
+      // `remove` route — so this is purely a missing entrance. It never touches
+      // rows that are not temporary: no preventDefault, no stopPropagation, the
+      // host's own context menu keeps working everywhere else.
+
+      /** Nearest ancestor carrying data-row-key="session:<id>". */
+      function tempRowOf(node) {
+        var el = node
+        var guard = 0
+        while (el && el !== document && guard < 60) {
+          guard += 1
+          var key = el.getAttribute ? el.getAttribute('data-row-key') : ''
+          if (key && key.indexOf('session:') === 0) return el
+          el = el.parentNode
+        }
+        return null
+      }
+
+      function tempMenuButtons() {
+        var out = []
+        if (!tempRowMenu) return out
+        var list = null
+        try { list = tempRowMenu.querySelectorAll('button[data-dsbs-temp-action]') } catch (error) { void error }
+        if (!list) return out
+        for (var i = 0; i < list.length; i++) out.push(list[i])
+        return out
+      }
+
+      function closeTempMenu(restoreFocus) {
+        if (!tempRowMenu) return false
+        var row = tempMenuRow
+        try { if (tempRowMenu.parentNode) tempRowMenu.parentNode.removeChild(tempRowMenu) } catch (error) { void error }
+        tempRowMenu = null
+        tempMenuRow = null
+        detachTempMenuDismiss()
+        if (restoreFocus && row && typeof row.focus === 'function') {
+          try { row.focus() } catch (error) { void error }
+        }
+        return true
+      }
+
+      function detachTempMenuDismiss() {
+        var handlers = tempMenuDismiss
+        if (!handlers) return
+        tempMenuDismiss = null
+        try { document.removeEventListener('pointerdown', handlers.onDown, true) } catch (error) { void error }
+        try { document.removeEventListener('keydown', handlers.onKey, true) } catch (error) { void error }
+        try { window.removeEventListener('resize', handlers.onViewport) } catch (error) { void error }
+        try { window.removeEventListener('scroll', handlers.onViewport, true) } catch (error) { void error }
+      }
+
+      function attachTempMenuDismiss() {
+        if (tempMenuDismiss) return
+        var handlers = {
+          onDown: function (event) {
+            if (!tempRowMenu) return
+            var target = event && event.target
+            if (target && tempRowMenu.contains && tempRowMenu.contains(target)) return
+            closeTempMenu(false)
+          },
+          onKey: function (event) {
+            if (!tempRowMenu || !event) return
+            var key = event.key
+            if (key === 'Escape') {
+              event.preventDefault()
+              event.stopPropagation()
+              closeTempMenu(true)
+              return
+            }
+            if (key === 'Tab') { closeTempMenu(false); return }
+            if (key !== 'ArrowDown' && key !== 'ArrowUp') return
+            var buttons = tempMenuButtons()
+            if (!buttons.length) return
+            event.preventDefault()
+            var active = document.activeElement
+            var at = buttons.indexOf(active)
+            var next
+            if (key === 'ArrowDown') next = at < 0 ? 0 : (at + 1) % buttons.length
+            else next = at <= 0 ? buttons.length - 1 : at - 1
+            try { buttons[next].focus() } catch (error) { void error }
+          },
+          // The menu is positioned in viewport coordinates, so any scroll or
+          // resize would leave it floating next to the wrong row.
+          onViewport: function () { closeTempMenu(false) },
+        }
+        tempMenuDismiss = handlers
+        try { document.addEventListener('pointerdown', handlers.onDown, true) } catch (error) { void error }
+        try { document.addEventListener('keydown', handlers.onKey, true) } catch (error) { void error }
+        try { window.addEventListener('resize', handlers.onViewport) } catch (error) { void error }
+        try { window.addEventListener('scroll', handlers.onViewport, true) } catch (error) { void error }
+      }
+
+      function makeTempMenuItem(action, labelKey, hintKey, onClick) {
+        var button = document.createElement('button')
+        button.type = 'button'
+        button.setAttribute('role', 'menuitem')
+        button.setAttribute('data-dsbs-temp-action', action)
+        var label = document.createElement('span')
+        label.textContent = t(labelKey)
+        button.appendChild(label)
+        var hint = t(hintKey)
+        if (hint) {
+          var sub = document.createElement('span')
+          sub.setAttribute('data-dsbs-temp-menu-sub', '')
+          sub.textContent = hint
+          button.appendChild(sub)
+        }
+        button.addEventListener('click', function (event) {
+          if (event) {
+            event.preventDefault()
+            event.stopPropagation()
+          }
+          closeTempMenu(false)
+          onClick()
+        })
+        return button
+      }
+
+      function openTempMenu(row, id, x, y) {
+        closeTempMenu(false)
+        var menu = document.createElement('div')
+        menu.setAttribute('data-dsbs-temp-menu', '')
+        menu.setAttribute('role', 'menu')
+        menu.setAttribute('aria-label', t('temp.menu.label'))
+        // The row's own text is the only title available (the host owns the
+        // session list), and it is what the user just pointed at.
+        var text = (row.textContent || '').replace(/\s+/g, ' ').trim()
+        if (text) {
+          var head = document.createElement('div')
+          head.setAttribute('data-dsbs-temp-menu-head', '')
+          head.textContent = text.length > 48 ? text.slice(0, 48) + '…' : text
+          menu.appendChild(head)
+        }
+        menu.appendChild(makeTempMenuItem('keep', 'temp.menu.keep', 'temp.menu.keep.hint', function () {
+          keepTempSession(id)
+        }))
+        menu.appendChild(makeTempMenuItem('delete', 'temp.menu.delete', 'temp.menu.delete.hint', function () {
+          deleteTempSession(id)
+        }))
+        document.body.appendChild(menu)
+
+        // Measure first, then flip near the viewport edges. Both reads are
+        // wrapped: a detached or unmeasured node must not break the menu.
+        var width = 0
+        var height = 0
+        try {
+          var rect = menu.getBoundingClientRect ? menu.getBoundingClientRect() : null
+          width = (rect && rect.width) || menu.offsetWidth || 0
+          height = (rect && rect.height) || menu.offsetHeight || 0
+        } catch (error) { void error }
+        if (!width) width = 220
+        if (!height) height = 96
+        var vw = window.innerWidth || 1024
+        var vh = window.innerHeight || 768
+        var left = Number.isFinite(x) ? x : 0
+        var top = Number.isFinite(y) ? y : 0
+        if (left + width > vw - 8) left = Math.max(8, vw - width - 8)
+        if (top + height > vh - 8) top = Math.max(8, vh - height - 8)
+        menu.style.left = Math.round(left) + 'px'
+        menu.style.top = Math.round(top) + 'px'
+
+        tempRowMenu = menu
+        tempMenuRow = row
+        attachTempMenuDismiss()
+        var buttons = tempMenuButtons()
+        if (buttons.length) {
+          try { buttons[0].focus() } catch (error) { void error }
+        }
+      }
+
+      /** Promote one session: it stops being temporary, nothing is deleted. */
+      function keepTempSession(id) {
+        tempCall('api/dsh-temp-session.untrack?sessionId=' + encodeURIComponent(id), { method: 'POST' })
+          .then(function (data) {
+            if (!data || data.ok !== true) throw new Error((data && data.error) || 'untrack failed')
+            applyTempIdList(data.ids, id)
+            toast(t('temp.menu.kept'), false)
+            scheduleSync()
+          })
+          .catch(function (error) {
+            toast(t('temp.menu.failed') + String((error && error.message) || error), true)
+          })
+      }
+
+      /** Delete one session now, with the same fallback `purgeAll` uses. */
+      function deleteTempSession(id) {
+        tempCall('api/dsh-temp-session.remove?sessionId=' + encodeURIComponent(id), { method: 'POST' })
+          .then(function (data) {
+            if (!data || data.ok !== true) throw new Error((data && data.error) || 'delete failed')
+            applyTempIdList(data.ids, id)
+            toast(t(data.hidden ? 'temp.menu.hidden' : 'temp.menu.deleted'), false)
+            refreshHostSessions()
+            scheduleSync()
+          })
+          .catch(function (error) {
+            toast(t('temp.menu.failed') + String((error && error.message) || error), true)
+          })
+      }
+
+      /** Adopt the id list the Host returned, or just drop the one id. */
+      function applyTempIdList(ids, removedId) {
+        if (Array.isArray(ids)) tempIds = ids.slice()
+        else tempIds = tempIds.filter(function (item) { return item !== removedId })
+        applyTempRows()
+        if (tempRowMenu && tempMenuRow) {
+          var key = tempMenuRow.getAttribute('data-row-key') || ''
+          if (tempIds.indexOf(key.slice('session:'.length)) < 0) closeTempMenu(false)
+        }
+      }
+
+      /**
+       * Ask the host's own session list to re-read. There is no documented API
+       * for this, so every common name is tried and failure is silent: a row
+       * that outlives its files disappears on the next list refresh anyway.
+       */
+      function refreshHostSessions() {
+        try {
+          var ui = uiWorkspace()
+          var sessions = ui && ui.sessions
+          var names = ['reload', 'refresh', 'reloadSessions', 'invalidate']
+          for (var i = 0; i < names.length; i++) {
+            if (sessions && typeof sessions[names[i]] === 'function') {
+              sessions[names[i]]()
+              return true
+            }
+          }
+        } catch (error) {
+          void error
+        }
+        return false
+      }
+
+      function onTempContextMenu(event) {
+        if (runtime.disposed || !tempMenuEnabled || !event) return
+        var row = tempRowOf(event.target)
+        if (!row) return
+        var key = row.getAttribute('data-row-key') || ''
+        var id = key.slice('session:'.length)
+        // Not one of ours: leave the event completely alone so the host (or
+        // whichever plugin owns that row) still gets its own menu.
+        if (!id || tempIds.indexOf(id) < 0) return
+        event.preventDefault()
+        event.stopPropagation()
+        openTempMenu(row, id, event.clientX, event.clientY)
+      }
+
+      var tempMenuUnmount = null
+      function mountTempRowMenu() {
+        if (typeof document === 'undefined' || typeof document.addEventListener !== 'function') return
+        document.addEventListener('contextmenu', onTempContextMenu)
+        tempMenuUnmount = function () {
+          try { document.removeEventListener('contextmenu', onTempContextMenu) } catch (error) { void error }
+          closeTempMenu(false)
+        }
+      }
+
+      function applyTempMenuSetting(data) {
+        var next = !data || data.rowMenu !== false
+        if (next === tempMenuEnabled) return
+        tempMenuEnabled = next
+        if (!next) closeTempMenu(false)
+      }
+
       function refreshTempIds() {
         return tempCall('api/dsh-temp-session.list')
           .then(function (data) {
@@ -1089,6 +1397,8 @@ window.__ModuleLoader__.load({
         expandAll = !data || data.expandAllSessions !== false
         expandAllKnown = true
         applyExpandFlag()
+        // 0.4.0 — same treatment: a Host without this key keeps the menu on.
+        applyTempMenuSetting(data)
         syncChatMode()
         expandAllSessions()
         scheduleSync()
@@ -1282,11 +1592,32 @@ window.__ModuleLoader__.load({
         return bar
       }
 
+      // A paint must be able to leave the tree exactly as it found it. Asking
+      // for an exact neighbour is not enough: the 0.3.0 tab strip (and an
+      // active plugin's panel) legitimately sit between the control bar and
+      // the host's panels nav, so `bar.nextSibling === nav` can never be true
+      // once those exist. Moving the bar on every paint mutates the observed
+      // root, which fires the MutationObserver, which schedules another paint
+      // -- a microtask loop that never returns to the event loop and hangs DSH
+      // on "Loading plugins..." with the renderer at 100%. Compare ORDER, not
+      // adjacency.
+      function isBefore(node, reference) {
+        if (!node || !reference || !node.parentNode || node.parentNode !== reference.parentNode) return false
+        var list = node.parentNode.children
+        var at = -1
+        var before = -1
+        for (var i = 0; i < list.length; i++) {
+          if (list[i] === node) at = i
+          if (list[i] === reference) before = i
+        }
+        return at >= 0 && before >= 0 && at < before
+      }
+
       function ensureBar(fx) {
         var bar = runtime.bar
         if (bar && bar.parentNode !== fx.root) {
           try {
-            bar.parentNode.removeChild(bar)
+            if (bar.parentNode) bar.parentNode.removeChild(bar)
           } catch (error) {
             void error
           }
@@ -1298,7 +1629,7 @@ window.__ModuleLoader__.load({
         }
         var anchor = fx.nav || fx.regionArea
         if (anchor && anchor.parentNode === fx.root) {
-          if (bar.nextSibling !== anchor) fx.root.insertBefore(bar, anchor)
+          if (bar.parentNode !== fx.root || !isBefore(bar, anchor)) fx.root.insertBefore(bar, anchor)
         } else if (bar.parentNode !== fx.root) {
           fx.root.appendChild(bar)
         }
@@ -1566,7 +1897,7 @@ window.__ModuleLoader__.load({
         var strip = runtime.tabStrip
         if (strip && strip.parentNode !== fx.root) {
           try {
-            strip.parentNode.removeChild(strip)
+            if (strip.parentNode) strip.parentNode.removeChild(strip)
           } catch (error) {
             void error
           }
@@ -1579,12 +1910,17 @@ window.__ModuleLoader__.load({
           strip.setAttribute('aria-label', t('tabs.label'))
           runtime.tabStrip = strip
         }
-        // Sits under the control bar so the two read as one header. The
-        // anchor matters: the host rebuilds the groups, never the bar.
-        if (strip.parentNode === fx.root && runtime.bar && strip.previousSibling === runtime.bar) return strip
-        var anchor = runtime.bar ? runtime.bar.nextSibling : (fx.nav || fx.regionArea)
-        if (anchor && anchor.parentNode === fx.root && anchor !== strip) fx.root.insertBefore(strip, anchor)
-        else if (strip.parentNode !== fx.root) fx.root.appendChild(strip)
+        // Sits under the control bar so the two read as one header. A plugin
+        // panel may sit after it, so "immediately after the bar" is too strict
+        // a condition for the steady state: demanding an exact previousSibling
+        // moves the strip on every paint and spins the observer loop.
+        if (strip.parentNode === fx.root && (!runtime.bar || isBefore(runtime.bar, strip))) return strip
+        var anchor = runtime.bar && runtime.bar.parentNode === fx.root
+          ? runtime.bar.nextSibling
+          : (fx.nav || fx.regionArea)
+        if (anchor === strip) return strip
+        if (anchor && anchor.parentNode === fx.root) fx.root.insertBefore(strip, anchor)
+        else fx.root.appendChild(strip)
         return strip
       }
 
@@ -2033,8 +2369,32 @@ window.__ModuleLoader__.load({
       }
 
       var pending = false
+      var syncStreak = 0
+      var streakTimer = null
+      var streakDeferred = false
+      // Safety net for the observer feedback loop: a paint that mutates the
+      // observed root chains MutationObserver -> scheduleSync -> paint in
+      // microtasks forever, so the renderer never gets a turn and DSH hangs on
+      // "Loading plugins...". A healthy startup needs only a handful of syncs
+      // between two macrotasks. Cap the streak, yield once, then resume; this
+      // cannot lose a state change, and it keeps unrelated future regressions
+      // from taking the whole app down.
       function scheduleSync() {
         if (runtime.disposed || pending) return
+        if (!streakTimer) {
+          streakTimer = setTimeout(function () {
+            streakTimer = null
+            syncStreak = 0
+            var again = streakDeferred
+            streakDeferred = false
+            if (again && !runtime.disposed) scheduleSync()
+          }, 0)
+        }
+        if (syncStreak >= 16) {
+          streakDeferred = true
+          return
+        }
+        syncStreak += 1
         pending = true
         Promise.resolve().then(function () {
           pending = false
@@ -2488,6 +2848,8 @@ window.__ModuleLoader__.load({
               inChatMode: data.inChatMode === 'show' ? 'show' : 'hide',
               buttonStyle: data.buttonStyle === 'own' ? 'own' : 'pair',
               expandAllSessions: data.expandAllSessions !== false,
+              // Older Host halves have no rowMenu key; the menu ships on.
+              rowMenu: data.rowMenu !== false,
               maxKept: kept > 0 ? Math.min(Math.round(kept), 200) : 20,
               configRevision: typeof data.configRevision === 'number' ? data.configRevision : null,
               configFile: typeof data.configFile === 'string' ? data.configFile : '',
@@ -2690,6 +3052,10 @@ window.__ModuleLoader__.load({
                       persist({ expandAllSessions: next })
                     }),
                     h('div', { style: dim }, t('options.expandHint')),
+                    policyRow(t('options.rowMenu'), policy.rowMenu === true, function (next) {
+                      persist({ rowMenu: next })
+                    }),
+                    h('div', { style: dim }, t('options.rowMenuHint')),
                     h('div', { style: { display: 'flex', alignItems: 'center', gap: '8px', flexWrap: 'wrap' } },
                       h('span', { style: { fontSize: '12px', color: 'var(--dsw-alias-label-primary,inherit)' } }, t('options.maxKept')),
                       h('input', {
@@ -2993,6 +3359,14 @@ window.__ModuleLoader__.load({
         }
       }, 'sidebar-suite: dismissal')
 
+      effect(function () {
+        // 0.4.0 — right-click on a temporary row. One delegated listener on the
+        // document, because the host recreates session rows on every list
+        // refresh; per-row listeners would need re-binding after each render.
+        mountTempRowMenu()
+        return tempMenuUnmount
+      }, 'sidebar-suite: temp row menu')
+
       effect(function () {
         // Safety net: the sidebar root is created and destroyed by the host, so
         // a root replacement is invisible to an observer that watches the old
@@ -3038,6 +3412,13 @@ window.__ModuleLoader__.load({
         teardown = function () {
           if (runtime.disposed) return
           runtime.disposed = true
+          try {
+            if (streakTimer) clearTimeout(streakTimer)
+            streakTimer = null
+            streakDeferred = false
+          } catch (error) {
+            void error
+          }
           try {
             clearTimeout(tempToastTimer)
             var toastNode = document.querySelector('[data-dsbs-temp-toast]')
@@ -3091,6 +3472,17 @@ window.__ModuleLoader__.load({
           } catch (error) {
             void error
           }
+          try {
+            // 0.4.0 — the row menu lives in <body> and its document listeners
+            // outlive the sidebar if they are not dropped explicitly.
+            closeTempMenu(false)
+            detachTempMenuDismiss()
+            if (tempMenuUnmount) { tempMenuUnmount(); tempMenuUnmount = null }
+            tempRowMenu = null
+            tempMenuRow = null
+          } catch (error) {
+            void error
+          }
           try {
             if (runtime.bar && runtime.bar.parentNode) runtime.bar.parentNode.removeChild(runtime.bar)
           } catch (error) {

package/lib/temp-session-host.mjs

@@ -58,6 +58,10 @@ const DEFAULT_CONFIG = {
   // 0.2.4: the host's workspace list folds after five sessions and paints a
   // "展开其余 N 个会话" button. This plugin expands every group instead.
   expandAllSessions: true,
+  // 0.4.0: right-clicking a temporary session row offers "keep as a normal
+  // session" and "delete now". Off means the row behaves like a plain session
+  // row again — the escape hatch if another plugin owns the context menu.
+  rowMenu: true,
   deleteOnExit: true,
   // Daily cleanup (0.2.2). Independent of deleteOnExit: a user who keeps DSH
   // open for days wants "delete at 03:00 every night", and a user who closes it
@@ -148,6 +152,7 @@ const CONFIG_KEYS = {
   inChatMode: { key: 'TEMP_IN_CHAT_MODE', text: (value) => String(value) },
   buttonStyle: { key: 'TEMP_BUTTON_STYLE', text: (value) => String(value) },
   expandAllSessions: { key: 'EXPAND_ALL_SESSIONS', text: (value) => (value ? 'on' : 'off') },
+  rowMenu: { key: 'TEMP_ROW_MENU', text: (value) => (value ? 'on' : 'off') },
   deleteOnExit: { key: 'DELETE_ON_EXIT', text: (value) => (value ? 'on' : 'off') },
   scheduleDelete: { key: 'SCHEDULE_DELETE', text: (value) => (value ? 'on' : 'off') },
   scheduleTime: { key: 'SCHEDULE_TIME', text: (value) => String(value) },
@@ -185,6 +190,7 @@ function parseConfig() {
   if (kv.EXPAND_ALL_SESSIONS !== undefined) {
     next.expandAllSessions = kv.EXPAND_ALL_SESSIONS.toLowerCase() !== 'off'
   }
+  if (kv.TEMP_ROW_MENU !== undefined) next.rowMenu = kv.TEMP_ROW_MENU.toLowerCase() !== 'off'
   if (kv.DELETE_ON_EXIT !== undefined) next.deleteOnExit = kv.DELETE_ON_EXIT.toLowerCase() !== 'off'
   if (kv.SCHEDULE_DELETE !== undefined) next.scheduleDelete = kv.SCHEDULE_DELETE.toLowerCase() !== 'off'
   if (kv.SCHEDULE_TIME !== undefined) {
@@ -224,7 +230,7 @@ function refreshConfigIfChanged() {
   state.configStamp = stamp
   const next = parseConfig()
   const fields = [
-    'showButton', 'inChatMode', 'buttonStyle', 'expandAllSessions',
+    'showButton', 'inChatMode', 'buttonStyle', 'expandAllSessions', 'rowMenu',
     'deleteOnExit', 'scheduleDelete', 'scheduleTime', 'maxKept',
   ]
   const changed = fields.some((field) => next[field] !== state.config[field])
@@ -255,6 +261,7 @@ function saveConfig(patch) {
   if (input.inChatMode === 'show' || input.inChatMode === 'hide') next.inChatMode = input.inChatMode
   if (input.buttonStyle === 'own' || input.buttonStyle === 'pair') next.buttonStyle = input.buttonStyle
   if (typeof input.expandAllSessions === 'boolean') next.expandAllSessions = input.expandAllSessions
+  if (typeof input.rowMenu === 'boolean') next.rowMenu = input.rowMenu
   if (typeof input.deleteOnExit === 'boolean') next.deleteOnExit = input.deleteOnExit
   if (typeof input.scheduleDelete === 'boolean') next.scheduleDelete = input.scheduleDelete
   const clock = normalizeClock(input.scheduleTime)
@@ -324,6 +331,7 @@ function publicConfig() {
     inChatMode: state.config.inChatMode,
     buttonStyle: state.config.buttonStyle,
     expandAllSessions: state.config.expandAllSessions,
+    rowMenu: state.config.rowMenu,
     deleteOnExit: state.config.deleteOnExit,
     scheduleDelete: state.config.scheduleDelete,
     scheduleTime: state.config.scheduleTime,
@@ -536,6 +544,59 @@ async function purgeAll(reason, options) {
   return report
 }
 
+/**
+ * Delete one tracked session from the sidebar menu (0.4.0).
+ *
+ * Same steps as `purgeAll` for a single id: remove the directories, verify they
+ * are really gone, fall back to hiding the row when a file is locked. Two
+ * deliberate differences:
+ *
+ * - **Only tracked ids are accepted.** This route is reachable from the page, so
+ *   it must never become "delete any session by id". An untracked id is refused
+ *   before any filesystem call.
+ * - **A failed delete keeps the id tracked**, exactly like `purgeAll`, so the
+ *   next launch retries it instead of leaving an undeletable row that silently
+ *   stopped being temporary.
+ */
+async function removeOne(sessionId) {
+  await ensureReady()
+  const id = normalizeId(sessionId)
+  if (id.length === 0) return { ok: false, error: 'invalid session id' }
+  if (!state.tracked.includes(id)) return { ok: false, error: 'not a temporary session' }
+  let removed = 0
+  try {
+    removed = await removeSession(id)
+  } catch (error) {
+    void error
+  }
+  const gone = removed > 0 && sessionDirsSync(id).length === 0
+  let hidden = false
+  if (!gone) hidden = await hideSession(id)
+  const report = {
+    reason: 'single',
+    at: new Date().toISOString(),
+    tried: 1,
+    removed: gone ? 1 : 0,
+    hidden: hidden ? 1 : 0,
+    skipped: 0,
+    failed: [],
+  }
+  if (gone || hidden) {
+    state.tracked = state.tracked.filter((item) => item !== id)
+    await saveStore()
+    state.lastPurge = report
+    return { ok: true, removed: gone, hidden, ids: state.tracked.slice(), count: state.tracked.length }
+  }
+  report.failed.push(id)
+  state.lastPurge = report
+  return {
+    ok: false,
+    error: 'delete failed — the session files are locked',
+    ids: state.tracked.slice(),
+    count: state.tracked.length,
+  }
+}
+
 /** Delete every tracked session synchronously — the quit path has no `await`. */
 function purgeSync(reason) {
   if (state.tracked.length === 0) return { reason, tried: 0, removed: 0, kept: [] }
@@ -723,6 +784,7 @@ function status() {
     chatModePolicy: state.config.inChatMode,
     buttonStyle: state.config.buttonStyle,
     expandAllSessions: state.config.expandAllSessions,
+    rowMenu: state.config.rowMenu,
     deleteOnExit: state.config.deleteOnExit,
     scheduleDelete: state.config.scheduleDelete,
     scheduleTime: state.config.scheduleTime,
@@ -860,6 +922,12 @@ export function createTempSessionHost(initialCtx) {
         if (sessionId.length === 0) return json({ ok: false, error: 'sessionId required' }, 400)
         return json(await untrack(sessionId))
       }],
+      // 0.4.0 — delete one temporary session from the row menu.
+      ['/api/dsh-temp-session.remove', ['POST', 'GET'], async (request) => {
+        const { sessionId } = queryOf(request)
+        if (sessionId.length === 0) return json({ ok: false, error: 'sessionId required' }, 400)
+        return json(await removeOne(sessionId))
+      }],
       ['/api/dsh-temp-session.purge', ['POST', 'GET'], async () => {
         await ensureReady()
         return json({ ok: true, ...(await purgeAll('manual')) })

package/locale/en.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "侧栏布局大师 · Sidebar Suite",
-    "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、会话默认全展开、临时会话默认在退出 DSH 时删除（每天定时清理默认关，可在本页开启并设时间）、设置与反馈都在本页（全部 8 项配置都有开关，改配置文件约 3 秒自动生效、免重启），强实用性；界面沿用宿主原生配色、圆角与间距，只加属性不重构宿主结构，克制又好看。｜A plugin dedicated to a better DSH sidebar: one-click layouts, always-expanded sessions, temp sessions deleted when DSH quits by default (daily cleanup off by default and opt-in) and in-page settings/feedback — every config key has a switch and file edits hot-reload — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
+    "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、会话默认全展开、临时会话默认在退出 DSH 时删除（每天定时清理默认关，可在本页开启并设时间）、临时会话可右键保留为正式会话或立即删除、设置与反馈都在本页（全部 9 项配置都有开关，改配置文件约 3 秒自动生效、免重启），强实用性；界面沿用宿主原生配色、圆角与间距，只加属性不重构宿主结构，克制又好看。｜A plugin dedicated to a better DSH sidebar: one-click layouts, always-expanded sessions, temp sessions deleted when DSH quits by default (daily cleanup off by default and opt-in) and a right-click menu to keep or delete one temp session, in-page settings/feedback — every config key has a switch and file edits hot-reload — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
     "detail": "DETAIL.md"
   }
 }

package/locale/zh.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "侧栏布局大师 · Sidebar Suite",
-    "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、会话默认全展开、临时会话默认在退出 DSH 时删除（每天定时清理默认关，可在本页开启并设时间）、设置与反馈都在本页（全部 8 项配置都有开关，改配置文件约 3 秒自动生效、免重启），强实用性；界面沿用宿主原生配色、圆角与间距，只加属性不重构宿主结构，克制又好看。｜A plugin dedicated to a better DSH sidebar: one-click layouts, always-expanded sessions, temp sessions deleted when DSH quits by default (daily cleanup off by default and opt-in) and in-page settings/feedback — every config key has a switch and file edits hot-reload — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
+    "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、会话默认全展开、临时会话默认在退出 DSH 时删除（每天定时清理默认关，可在本页开启并设时间）、临时会话可右键保留为正式会话或立即删除、设置与反馈都在本页（全部 9 项配置都有开关，改配置文件约 3 秒自动生效、免重启），强实用性；界面沿用宿主原生配色、圆角与间距，只加属性不重构宿主结构，克制又好看。｜A plugin dedicated to a better DSH sidebar: one-click layouts, always-expanded sessions, temp sessions deleted when DSH quits by default (daily cleanup off by default and opt-in) and a right-click menu to keep or delete one temp session, in-page settings/feedback — every config key has a switch and file edits hot-reload — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
     "detail": "DETAIL.md"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidebar-suite",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "license": "MIT",
   "author": "Yonan",
   "repository": {
@@ -14,7 +14,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、默认布局在详情页顶部直接设、会话列表默认全展开、「临时会话」开原生会话且默认在退出 DSH 时删除（DELETE_ON_EXIT 默认开；每天定时清理默认关，可在详情页开启并自设时间）、详情页三种反馈入口、全部 8 项配置都有图形开关且改文件免重启 —— 强实用性；界面沿用宿主原生配色、圆角与间距，只加属性与一条控制栏、不重构宿主结构 —— 克制美观。｜A plugin dedicated to the DSH sidebar experience: one-click layouts, always-expanded sessions, native temp sessions deleted when DSH quits by default (DELETE_ON_EXIT on; daily cleanup off by default and opt-in) in-page settings/feedback, a control for every config key and hot-reloaded config edits — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
+  "description": "一款专门针对改进 DSH 左侧栏体验的插件：三种布局一键切换、默认布局在详情页顶部直接设、会话列表默认全展开、「临时会话」开原生会话且默认在退出 DSH 时删除（DELETE_ON_EXIT 默认开；每天定时清理默认关，可在详情页开启并自设时间）、详情页三种反馈入口、临时会话可右键「保留为正式会话」或「立即删除」、全部 9 项配置都有图形开关且改文件免重启 —— 强实用性；界面沿用宿主原生配色、圆角与间距，只加属性与一条控制栏、不重构宿主结构 —— 克制美观。｜A plugin dedicated to the DSH sidebar experience: one-click layouts, always-expanded sessions, native temp sessions deleted when DSH quits by default (DELETE_ON_EXIT on; daily cleanup off by default and opt-in) in-page settings/feedback, a right-click menu to keep or delete one temp session, a control for every config key and hot-reloaded config edits — seriously practical; native colours, radii and spacing with zero host-DOM rewrites — restrained and good-looking.",
   "keywords": [
     "dsh-plugin",
     "dsh",
@@ -27,7 +27,7 @@
   ],
   "type": "module",
   "scripts": {
-    "test": "node tests/test_020.mjs && node tests/test_022.mjs && node tests/test_023.mjs && node tests/test_024.mjs && node tests/test_025.mjs && node tests/test_028.mjs && node tests/test_029.mjs && node tests/test_030.mjs && node tests/test_031.mjs",
+    "test": "node tests/test_020.mjs && node tests/test_022.mjs && node tests/test_023.mjs && node tests/test_024.mjs && node tests/test_025.mjs && node tests/test_028.mjs && node tests/test_029.mjs && node tests/test_030.mjs && node tests/test_031.mjs && node tests/test_032.mjs && node tests/test_033.mjs",
     "check": "node --check lib/index.js && node --check lib/client.js && node --check lib/temp-session-host.mjs && npm pack --dry-run"
   },
   "main": "lib/index.js",

package/temp-session-config.txt

@@ -33,6 +33,13 @@ TEMP_BUTTON_STYLE=pair
 # off = keep DSH's own folding and leave that button visible
 EXPAND_ALL_SESSIONS=on
 
+# 右键临时会话时，是否弹出「保留为正式会话 / 立即删除」菜单 / Right-click menu
+# on  = 弹出（默认）。选「保留为正式会话」后，这个会话就不再算临时，退出时不会删。
+# off = 不接管右键菜单（别的插件抢右键时用这个）
+# on  = show the menu (default). "Keep as a normal session" makes it permanent.
+# off = leave the context menu alone (use this if another plugin owns it)
+TEMP_ROW_MENU=on
+
 # 退出 DSH 时删除临时会话 / Delete temporary sessions when DSH quits
 # on  = 退出时删除（默认）；off = 不删除，临时会话就变成普通会话
 DELETE_ON_EXIT=on

package//344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -183,9 +183,16 @@ DSH **没有公开的「删除会话」接口**（官方界面的「归档」只
 
 为什么必须这样：要用原生窗口、还要能中途切走再切回，它就只能是真会话。如果要求「连磁盘都不许写」，那就只能是不在侧栏、不能多任务的纯内存方案 —— 和你要的正好相反。
 
-### 4.5 想让它别删
+### 4.5 想留住某一个 / 想全都不删
 
-配置第 38 行 `DELETE_ON_EXIT=off`（见下一节）。关掉后不删除，临时会话就等于普通会话。
+**只想留住某一个（推荐，0.4.0）**：在侧栏里**右键那个带「临时」标签的会话**，选「保留为正式会话」。
+
+它立刻变成普通会话 —— 退出不删、定时清理也不碰，**其它临时会话照旧按时删掉**。同一个菜单里还有「立即删除」，用来当场删掉这一个，不用等退出。
+
+- 右键**普通会话**时插件完全不插手，你的其它右键菜单照常出现。
+- 右键没反应？看配置第 41 行 `TEMP_ROW_MENU` 是不是被改成 `off` 了（详情页的「临时会话右键菜单」开关写的是同一行）。
+
+**想全部保留**：把配置第 45 行 `DELETE_ON_EXIT=off`（见下一节）。关掉后所有临时会话都不再删除，等于普通会话。
 
 ---
 
@@ -201,18 +208,19 @@ DSH **没有公开的「删除会话」接口**（官方界面的「归档」只
 | **19** | `TEMP_IN_CHAT_MODE=hide` | `hide` / `show` | 装了 `dsh-deepseek-chat` 时，处于 CHAT 官网模式要不要显示按钮 |
 | **27** | `TEMP_BUTTON_STYLE=pair` | `pair` / `own` | `pair` = 和「新会话」并排；`own` = 单独占一整行，完全不改「新会话」 |
 | **34** | `EXPAND_ALL_SESSIONS=on` | `on` / `off` | `on` = 会话列表全部展开、隐藏「展开其余 N 个会话」；`off` = 恢复 DSH 原来的折叠 |
-| **38** | `DELETE_ON_EXIT=on` | `on` / `off` | **退出 DSH 时**删不删 |
-| **44** | `SCHEDULE_DELETE=off` | `on` / `off` | **每天定时清理**要不要开 |
-| **49** | `SCHEDULE_TIME=03:00` | `HH:MM`（如 `03:00`、`23:30`） | 定时清理的时间点，24 小时制、本机时间 |
-| **53** | `MAX_KEPT=20` | 1–200 | 最多同时留几个临时会话，超了先删最早的 |
+| **41** | `TEMP_ROW_MENU=on` | `on` / `off` | `on` = 右键临时会话可「保留为正式会话 / 立即删除」；`off` = 不接管右键（别的插件抢右键时用） |
+| **45** | `DELETE_ON_EXIT=on` | `on` / `off` | **退出 DSH 时**删不删 |
+| **51** | `SCHEDULE_DELETE=off` | `on` / `off` | **每天定时清理**要不要开 |
+| **56** | `SCHEDULE_TIME=03:00` | `HH:MM`（如 `03:00`、`23:30`） | 定时清理的时间点，24 小时制、本机时间 |
+| **60** | `MAX_KEPT=20` | 1–200 | 最多同时留几个临时会话，超了先删最早的 |
 
-> 这一整节都可以不动手改文件 —— 0.2.8 起详情页有**全部 8 项的图形化开关**，见 5.1。两种改法写的是**同一份文件**，改完都在约 3 秒内生效，不会打架。
+> 这一整节都可以不动手改文件 —— 0.2.8 起详情页有**全部 9 项的图形化开关**，见 5.1。两种改法写的是**同一份文件**，改完都在约 3 秒内生效，不会打架。
 
 ### 5.1 全部设置都在详情页里改（推荐，不用改文件）
 
 打开 DSH → 插件 → `dsh-sidebar-suite` → 详情页最上面那张卡。0.2.8 起这里是**两块设置**：
 
-**第一块「侧栏与临时会话」**（这一节表里 8 个键里的前 4 个 + 保留上限，全都能点）：
+**第一块「侧栏与临时会话」**（这一节表里 9 个键里的前 5 个 + 保留上限，全都能点）：
 
 ```
 侧栏与临时会话 · Sidebar & temp session options
@@ -222,6 +230,7 @@ DSH **没有公开的「删除会话」接口**（官方界面的「归档」只
 CHAT 官网模式           [隐藏按钮] / [照常显示]
 按钮摆法                [并排] / [独占一行]
 会话默认全展开          [开] / [关]
+临时会话右键菜单        [开] / [关]
 最多保留                [ 20 ] 个临时会话（1–200）
 设置版本 12 · …/temp-session-config.txt
 ```