dsh-sidebar-suite 0.2.9 → 0.4.0

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.2.9",
+  "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",
+    "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

@@ -117,6 +117,29 @@
 
 ---
 
+### 3.4 第三方插件加的页签（0.3.0）
+
+这一版给**别的插件**开了一个口：它们可以往你侧栏里加自己的一页。
+
+你不需要做任何设置。什么时候会看到：
+
+- 装了某个使用这个接口的插件之后，**控制栏下面会多出一排页签**，比如 `扩展 │ 工作区 │ 那个插件的名字`。
+- 点哪个，侧栏中间那块就换成哪一页。
+- **再点一次当前页签**，就退回原来的会话列表 / 扩展列表。
+- 你在哪一页会被记住，下次打开还在那一页。
+
+三种布局下的差别：
+
+| 你选的布局 | 页签条长什么样 |
+|---|---|
+| 标签页（默认） | `扩展 / 工作区 / 插件页` 三种并排 |
+| 折叠 | 只有插件页进条；扩展和工作区还是用原来那两个折叠按钮 |
+| 浮层 | 只有插件页进条；扩展还是用「浮出面板」按钮 |
+
+**一个都没装的话，这排页签根本不会出现** —— 界面和 0.2.x 一模一样，不会平白多一行东西。
+
+> 想自己写一个？接口是 `ctx.sidebarSuite.registerTab({ id, title, icon, mount })`，`mount` 拿到一个空容器，你爱画什么画什么。完整示例在 README 和 DETAIL 里。
+
 ## 四、临时会话（重点）
 
 ### 4.1 它到底是什么
@@ -160,9 +183,16 @@ DSH **没有公开的「删除会话」接口**（官方界面的「归档」只
 
 为什么必须这样：要用原生窗口、还要能中途切走再切回，它就只能是真会话。如果要求「连磁盘都不许写」，那就只能是不在侧栏、不能多任务的纯内存方案 —— 和你要的正好相反。
 
-### 4.5 想让它别删
+### 4.5 想留住某一个 / 想全都不删
+
+**只想留住某一个（推荐，0.4.0）**：在侧栏里**右键那个带「临时」标签的会话**，选「保留为正式会话」。
+
+它立刻变成普通会话 —— 退出不删、定时清理也不碰，**其它临时会话照旧按时删掉**。同一个菜单里还有「立即删除」，用来当场删掉这一个，不用等退出。
+
+- 右键**普通会话**时插件完全不插手，你的其它右键菜单照常出现。
+- 右键没反应？看配置第 41 行 `TEMP_ROW_MENU` 是不是被改成 `off` 了（详情页的「临时会话右键菜单」开关写的是同一行）。
 
-配置第 38 行 `DELETE_ON_EXIT=off`（见下一节）。关掉后不删除，临时会话就等于普通会话。
+**想全部保留**：把配置第 45 行 `DELETE_ON_EXIT=off`（见下一节）。关掉后所有临时会话都不再删除，等于普通会话。
 
 ---
 
@@ -178,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
@@ -199,6 +230,7 @@ DSH **没有公开的「删除会话」接口**（官方界面的「归档」只
 CHAT 官网模式           [隐藏按钮] / [照常显示]
 按钮摆法                [并排] / [独占一行]
 会话默认全展开          [开] / [关]
+临时会话右键菜单        [开] / [关]
 最多保留                [ 20 ] 个临时会话（1–200）
 设置版本 12 · …/temp-session-config.txt
 ```