dsh-session-mng 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.4 — 2026-10-28
+
+### Fixed
+
+- **会话详情页标题行不随页面滚动**：详情页顶部（「← 返回列表」、标题、运行/分支等徽标、「打开 / 归档」按钮）改为吸顶（`position: sticky`），滚动摘要、生成标题、最近消息等内容时始终可见，与列表页的筛选工具栏行为一致。
+- **操作结果提示不再常驻**：提示改为浮动 toast（固定在右下角，不随列表滚动消失），纯成功提示 5 秒后自动隐藏；失败提示与带操作按钮的提示保留到手动关闭，避免错过失败原因。
+- **一键清理空会话超过 50 条时预览报错**：删除范围预览与彻底删除改为按 `maxBatch`（默认 50）分批请求并汇总结果，一次确认可清理任意数量（如「清理空会话（80）」）。
+
+### Added
+
+- **「归档空会话（N）」**：有未归档空会话时显示，一键分批（每批 50）归档，归档后即可用「清理空会话」删除。
+
+### Changed
+
+- **「清理空会话（N）」显示条件**：只要存在已归档空会话就显示（不再要求其中必须有可删除项）；数量按全部已归档空会话计算，若其中有在 DSH 中打开、暂时无法删除的，按钮禁用并在悬停提示「重启后才能清理」。
+- **页面头部布局**：「归档空会话 / 清理空会话 / 刷新」三个按钮移到「会话管理」标题同一行的右侧（顶部右对齐），副标题与统计信息在下方独占整行。
+
 ## 0.1.3 — 2026-10-28
 
 ### Fixed

package/README.md

@@ -59,7 +59,7 @@ dsh plugin --profile <profile> add link:/绝对路径/dsh-session-mng
 
 Host 半是进程内模块：装完如果看不到页面，重启一次 dsh/应用再刷新页面；Client 半刷新页面即可。
 
-> 市场状态：awesome-dsh-plugin 收录 PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 的 `check` 已通过；`Submission gate` 目前只差仓库满 1 天（约 2026-10-28 00:44 Asia/Shanghai 自动重跑），无需重新提交。合并后 dshmarket 读取同一份目录，卡片版本随 npm 显示 `0.1.1`。
+> 市场状态：awesome-dsh-plugin 收录 PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 已于 2026-10-27 合并（`check` 与 `Submission gate` 均通过）。dshmarket 读取同一份目录，卡片版本随 npm 自动更新，当前显示 `0.1.3`。
 
 ## 使用
 
@@ -137,19 +137,20 @@ Host route (lib/api.js) ──► service (lib/service.js)
 ## 开发
 
 ```sh
-npm test                      # node --test，26 个单元/集成测试
+npm test                      # node --test，29 个单元/集成测试
 node --check index.js client.js lib/*.js
 npm --cache /tmp/dsh-npm-cache pack --dry-run
 ```
 
-实机验收：安装到 `desktop` profile → 确认 `settings.section` 出现 `session-mng-section` → 用**一次性测试会话**验证标题/归档/恢复/移动/删除 → 清理测试数据。0.1.1 的列表验收见 `docs/RELEASE-CHECKLIST-0.1.1.md`。
+实机验收：安装到 `desktop` profile → 确认 `settings.section` 出现 `session-mng-section` → 用**一次性测试会话**验证标题/归档/恢复/移动/删除 → 清理测试数据。0.1.3 的验收与实机记录见 `docs/RELEASE-CHECKLIST-0.1.3.md`。
 
 ## 当前状态与下一步
 
-- `0.1.3` 待发布：修复分支会话被当成子会话隐藏（三态会话模型 + 缩进显示 + 隐藏子代理提示），并修正「删除父会话级联删掉历史分支」「父会话因历史分支无法移动」两个问题；等实机验证后再发 npm/GitHub。
-- `0.1.2` 已发布到 npm / GitHub / Release；空会话默认隐藏、清理空会话、删除范围模态确认。
-- `0.1.1` 已发布；26 个测试全绿，0.1.2 包 33 个文件 / 568.3 kB。
-- 市场 PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 等 1 天仓库年龄 gate，之后等维护者合并。
+- `0.1.4` 已发布到 npm / GitHub / Release：详情页标题行吸顶；操作结果改为浮动 toast（成功 5 秒自动消失）；头部按钮移到标题右侧；新增「归档空会话（N）」，「清理空会话（N）」只要有已归档空会话就显示，且超过 50 条自动分批预览/删除。
+- `0.1.3` 已发布到 npm / GitHub / Release：三态会话模型（根/分支/子代理），分支默认显示并缩进在父会话下；删除父会话不再级联删掉普通分支；父会话有历史分支时也能移动；兼容声明增加 DSH `0.2.1-rc.3`。
+- `0.1.2` 已发布：空会话默认隐藏、清理空会话、删除范围模态确认。
+- 29 个测试全绿；0.1.4 包 37 个文件 / 583.2 kB（unpacked 834.8 kB）。
+- 市场条目已收录：PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 已于 2026-10-27 合并（`check` 与仓库年龄 gate 均通过）；卡片版本随 npm 自动更新，当前 0.1.4。
 - 下一项主任务：**0.2.0 Host 侧 overview + 分页 sessions**，为 1000–10000 条会话设计；详细任务、验收标准、环境坑见 [接手说明](docs/HANDOVER-2026-10-27.md)。
 
 ## 文档索引
@@ -159,10 +160,11 @@ npm --cache /tmp/dsh-npm-cache pack --dry-run
 - [0.1.0 发布检查清单](docs/RELEASE-CHECKLIST-0.1.0.md)
 - [0.1.1 实施计划](docs/PLAN-2026-10-27.md)
 - [0.1.1 发布检查清单](docs/RELEASE-CHECKLIST-0.1.1.md)
-- [0.1.2 发布检查清单（待发布）](docs/RELEASE-CHECKLIST-0.1.2.md)
+- [0.1.2 发布检查清单](docs/RELEASE-CHECKLIST-0.1.2.md)
 - [0.1.3 实施计划（分支会话默认可见）](docs/PLAN-2026-10-28-branch-visibility.md)
 - [0.1.3 实施计划（历史分支删除/移动安全）](docs/PLAN-2026-10-28-legacy-fork-safety.md)
-- [0.1.3 发布检查清单（待发布）](docs/RELEASE-CHECKLIST-0.1.3.md)
+- [0.1.3 发布检查清单](docs/RELEASE-CHECKLIST-0.1.3.md)
+- [0.1.4 发布检查清单](docs/RELEASE-CHECKLIST-0.1.4.md)
 - [设计与实现说明](docs/01-design.md)
 - [开源、发 npm 与市场收录记录](docs/02-open-source-and-marketplace.md)
 - [路线图](ROADMAP.md)

package/ROADMAP.md

@@ -1,6 +1,6 @@
 # Roadmap
 
-> 当前：`0.1.2` 已发布；`0.1.3`（分支会话默认可见）已实现待实机验证/发布。市场 PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 的 `check` 已过，只差仓库 1 天年龄 gate（约 2026-10-28 00:44 Asia/Shanghai 自动重跑）。下一项主任务是 0.2.0 的 Host 分页；详细接手任务见 [docs/HANDOVER-2026-10-27.md](docs/HANDOVER-2026-10-27.md)。
+> 当前：`0.1.4` 已发布（npm latest / tag `v0.1.4` / Release）：详情页吸顶、结果 toast、空会话归档/清理与分批删除。市场条目已收录（PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 于 2026-10-27 合并）。下一项主任务是 0.2.0 的 Host 分页；详细接手任务见 [docs/HANDOVER-2026-10-27.md](docs/HANDOVER-2026-10-27.md)。
 
 ## 0.1.0 — delivered
 
@@ -25,7 +25,7 @@
 - 「清理空会话（N）」批量清理已归档空会话，复用删除范围预览/确认。
 - 删除范围确认改为模态框，内容独立滚动、底部确认区固定，支持遮罩/Esc 取消。
 
-## 0.1.3 — delivered (待实机验证/发布)
+## 0.1.3 — delivered (published)
 
 - 三态会话模型：根 / 分支（fork）/ 子代理；分支不再因 `parentSession` 被误判成子会话隐藏。
 - 分支会话默认显示，缩进挂在父行下，父行「N 分支」、分支行「↳ 来自：父标题」；搜索父标题命中分支。
@@ -33,6 +33,13 @@
 - 删除只级联子代理：历史分支保留（预览提示会失去来源标识），不再静默删除；父会话有历史分支时也能移动。
 - 分支的来源父会话被删除后显示「来源父会话已不存在」；移动有分支的会话时提示分支留在原工作区。
 
+## 0.1.4 — delivered (published)
+
+- 详情页标题/操作行吸顶（返回列表、标题、徽标、打开/归档始终可见）。
+- 操作结果改为浮动 toast：成功提示 5 秒自动消失，失败/带操作提示保留。
+- 头部三个按钮移到会话管理标题右侧；副标题与统计信息独占下方整行。
+- 空会话：「归档空会话（N）」一键分批归档；「清理空会话（N）」只要有已归档空会话就显示；删除范围预览与删除按 `maxBatch` 分批，超过 50 条也能一次确认完成。
+
 ## 0.2.0 — next (planned)
 
 首要目标：真正支撑 1000–10000 条会话，不再首屏拉全量 `state`。实施前先写 `docs/PLAN-2026-10-28.md` 并获批准。

package/client.js

@@ -48,7 +48,9 @@ window.__ModuleLoader__.load({
         showBlank: '显示空会话',
         cleanupBlank: '清理空会话（{n}）',
         cleanupBlankHint: '批量删除已归档的空会话；未归档的空会话需先归档。',
-        blankActiveHint: '另有 {n} 个未归档空会话，归档后才能清理。',
+        cleanupBlankLockedHint: '有 {n} 个已归档空会话已在 DSH 中打开，重启后才能清理。',
+        archiveBlank: '归档空会话（{n}）',
+        archiveBlankHint: '把未归档的空会话批量归档；归档后即可用「清理空会话」彻底删除。',
         hiddenBlankCount: '已隐藏 {n} 个空会话',
         selectAll: '全选当前列表',
         expandAll: '展开全部',
@@ -212,7 +214,9 @@ window.__ModuleLoader__.load({
         showBlank: 'Show empty sessions',
         cleanupBlank: 'Clean up empty sessions ({n})',
         cleanupBlankHint: 'Permanently delete archived empty sessions; unarchived empty sessions must be archived first.',
-        blankActiveHint: '{n} unarchived empty sessions must be archived before cleanup.',
+        cleanupBlankLockedHint: '{n} archived empty sessions are open in this DSH process; restart DSH before cleaning them up.',
+        archiveBlank: 'Archive empty sessions ({n})',
+        archiveBlankHint: 'Archive every unarchived empty session in one batch; they can then be cleaned up with "Clean up empty sessions".',
         hiddenBlankCount: '{n} empty sessions hidden',
         selectAll: 'Select all shown',
         expandAll: 'Expand all',
@@ -356,10 +360,13 @@ window.__ModuleLoader__.load({
 
     const CSS = `
 .dsm-page{display:flex;flex-direction:column;gap:12px;font:inherit;color:var(--dsw-alias-label-primary);min-width:0}
-.dsm-head{display:flex;align-items:flex-start;justify-content:space-between;gap:12px;flex-wrap:wrap}
+/* Page head: title and its actions share the first row; the subtitles use the
+   full width below, so the buttons sit in the top-right corner. */
+.dsm-head{display:flex;flex-direction:column;gap:2px;min-width:0}
+.dsm-head-row{display:flex;align-items:center;justify-content:flex-start;gap:12px;flex-wrap:wrap;min-width:0}
 .dsm-title{margin:0;font-size:17px;font-weight:600;line-height:24px}
 .dsm-sub{margin:2px 0 0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}
-.dsm-head-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
+.dsm-head-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-left:auto}
 .dsm-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;min-height:28px;padding:0 10px;
  border:1px solid var(--dsw-alias-border-l1);border-radius:6px;background:transparent;color:var(--dsw-alias-label-primary);
  font:inherit;font-size:12px;line-height:18px;cursor:pointer;white-space:nowrap}
@@ -387,6 +394,12 @@ window.__ModuleLoader__.load({
 .dsm-note.warn{border-color:var(--dsw-alias-state-warn-primary)}
 .dsm-note-actions{display:flex;gap:6px;flex-wrap:wrap;flex:0 0 auto}
 .dsm-note detail{flex:1 1 100%}
+/* Operation-result toast: floats above the pane so scrolling never hides it. */
+.dsm-toast{position:fixed;bottom:18px;right:18px;z-index:1200;width:max-content;
+ max-width:min(460px,calc(100vw - 36px));padding:10px 12px;border-radius:8px;
+ background:var(--dsw-alias-bg-layer-2);box-shadow:0 14px 40px rgba(0,0,0,.45);
+ animation:dsm-toast-in .16s ease-out}
+@keyframes dsm-toast-in{from{opacity:0;transform:translateY(6px)}to{opacity:1;transform:none}}
 .dsm-sticky{position:sticky;top:0;z-index:3;display:flex;flex-direction:column;gap:8px;
  padding:6px 0 8px;background:var(--dsw-alias-bg-layer-2);border-bottom:1px solid var(--dsw-alias-border-l1)}
 .dsm-batch{display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:8px 10px;border-radius:7px;
@@ -438,7 +451,10 @@ window.__ModuleLoader__.load({
 .dsm-empty{padding:22px 10px;text-align:center;font-size:12px;color:var(--dsw-alias-label-secondary);
  border:1px dashed var(--dsw-alias-border-l2);border-radius:8px}
 .dsm-detail{display:flex;flex-direction:column;gap:12px}
-.dsm-detail-head{display:flex;align-items:flex-start;justify-content:space-between;gap:10px;flex-wrap:wrap}
+/* The title row and its actions stay in view while the detail page scrolls. */
+.dsm-detail-head{position:sticky;top:0;z-index:2;display:flex;align-items:flex-start;justify-content:space-between;
+ gap:10px;flex-wrap:wrap;padding:6px 0 8px;background:var(--dsw-alias-bg-layer-2);
+ border-bottom:1px solid var(--dsw-alias-border-l1)}
 .dsm-detail-title{margin:0;font-size:16px;line-height:23px;font-weight:600;word-break:break-word}
 .dsm-card{border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:var(--dsw-alias-bg-layer-1);padding:10px}
 .dsm-card h3{margin:0 0 8px;font-size:12px;line-height:18px;font-weight:600}
@@ -655,11 +671,33 @@ window.__ModuleLoader__.load({
       return h('span', null, h('span', { className: 'dsm-spin', 'aria-hidden': 'true' }), ' ', label ?? t('working'))
     }
 
+    /** How long a plain success toast stays before hiding itself. */
+    const NOTICE_HIDE_MS = 5000
+
+    /**
+     * Operation-result toast.
+     *
+     * It floats above the settings pane (instead of sitting in the scroll flow),
+     * so a result is visible no matter where the list is scrolled. A plain
+     * success toast hides itself after a few seconds; failures and notices with
+     * an action stay until the user dismisses them, because they carry details
+     * worth reading.
+     */
     function Notice({ notice, t, onDismiss }) {
+      const dismiss = React.useRef(onDismiss)
+      dismiss.current = onDismiss
+      const transient = notice !== null && notice !== undefined
+        && notice.tone !== 'error' && notice.tone !== 'warn'
+        && notice.details === undefined && notice.action === undefined
+      React.useEffect(() => {
+        if (!transient) return undefined
+        const timer = setTimeout(() => dismiss.current?.(), NOTICE_HIDE_MS)
+        return () => clearTimeout(timer)
+      }, [notice, transient])
       if (notice === null || notice === undefined) return null
       return h(
         'div',
-        { className: `dsm-note ${notice.tone ?? ''}`, role: 'status' },
+        { className: `dsm-note dsm-toast ${notice.tone ?? ''}`, role: 'status' },
         h('div', { style: { flex: '1 1 auto', minWidth: 0 } },
           h('div', null, notice.text),
           notice.detail ? h('div', { className: 'dsm-hint', style: { marginTop: 3 } }, notice.detail) : null,
@@ -982,30 +1020,44 @@ window.__ModuleLoader__.load({
     // Delete scope (shared by single and batch)
     // ---------------------------------------------------------------------
 
-    function DeleteScope({ ctx, t, ids, onConfirmed, onCancel, busy }) {
+    function DeleteScope({ ctx, t, ids, maxBatch, onConfirmed, onCancel, busy }) {
       const [phase, setPhase] = React.useState('loading')
       const [preview, setPreview] = React.useState(null)
       const [error, setError] = React.useState(null)
       const [checked, setChecked] = React.useState(false)
       const idsKey = ids.join('\u0000')
 
+      // One confirmation may name more sessions than a single request admits
+      // (the empty-session shortcut does). Preview in batches and merge the
+      // scopes so the dialog still shows one combined result.
       React.useEffect(() => {
         const controller = new AbortController()
         setPhase('loading')
         setChecked(false)
-        post('delete/preview', { sessionIds: ids }, controller.signal)
-          .then((value) => {
+        const size = Number.isFinite(maxBatch) && maxBatch > 0 ? maxBatch : 50
+        const merge = async () => {
+          const merged = { roots: [], errors: [], sessions: [], descendantCount: 0, forkChildren: [], totalBytes: 0 }
+          for (let index = 0; index < ids.length; index += size) {
+            const value = await post('delete/preview', { sessionIds: ids.slice(index, index + size) }, controller.signal)
             if (controller.signal.aborted) return
-            setPreview(value)
-            setPhase('ready')
-          })
-          .catch((failure) => {
-            if (failure?.name === 'AbortError') return
-            setError(errorText(t, failure))
-            setPhase('error')
-          })
+            merged.roots.push(...(value?.roots ?? []))
+            merged.errors.push(...(value?.errors ?? []))
+            merged.sessions.push(...(value?.sessions ?? []))
+            merged.descendantCount += value?.descendantCount ?? 0
+            merged.forkChildren.push(...(value?.forkChildren ?? []))
+            merged.totalBytes += value?.totalBytes ?? 0
+          }
+          if (controller.signal.aborted) return
+          setPreview(merged)
+          setPhase('ready')
+        }
+        merge().catch((failure) => {
+          if (failure?.name === 'AbortError') return
+          setError(errorText(t, failure))
+          setPhase('error')
+        })
         return () => controller.abort()
-      }, [idsKey, t])
+      }, [idsKey, maxBatch, t])
 
       React.useEffect(() => {
         const onKeyDown = (event) => {
@@ -1272,6 +1324,7 @@ window.__ModuleLoader__.load({
                     ctx,
                     t,
                     ids: deleteIds,
+                    maxBatch: state.limits?.maxBatch ?? 50,
                     busy,
                     onCancel: () => setShowDelete(false),
                     onConfirmed: (ids) => onDelete(ids),
@@ -1559,17 +1612,43 @@ window.__ModuleLoader__.load({
         return value
       }
 
+      /**
+       * Permanently delete sessions in backend-sized batches. One confirmation
+       * may cover more ids than a single request admits (the empty-session
+       * shortcut can), so the request is split and the totals are summed into
+       * one notice.
+       */
       const deleteRows = async (ids) => {
-        const value = await run(
-          () => post('delete', { sessionIds: ids, confirm: true }),
-          (result) => resultText(result),
-        )
-        if (value !== undefined) {
+        if (ids.length === 0) return undefined
+        const max = state?.limits?.maxBatch ?? 50
+        setBusy(true)
+        setNotice(null)
+        try {
+          let succeeded = 0
+          let failed = 0
+          const failures = []
+          for (let index = 0; index < ids.length; index += max) {
+            const value = await post('delete', { sessionIds: ids.slice(index, index + max), confirm: true })
+            succeeded += value?.totals?.succeeded ?? 0
+            failed += value?.totals?.failed ?? 0
+            for (const item of value?.results ?? []) if (item.ok === false) failures.push(item)
+          }
+          setNotice(
+            failed === 0
+              ? { tone: 'ok', text: t('batchDone', { ok: succeeded, failed: 0 }) }
+              : { tone: 'error', text: t('batchDone', { ok: succeeded, failed }), details: failures.slice(0, 20) },
+          )
           setBulkDeleteIds(null)
           setSelected(new Set())
           if (selectedId !== null && ids.includes(selectedId)) setSelectedId(null)
+          await load({ silent: true })
+          return { totals: { succeeded, failed } }
+        } catch (failure) {
+          setNotice({ tone: 'error', text: errorText(t, failure), detail: failure?.message })
+          return undefined
+        } finally {
+          setBusy(false)
         }
-        return value
       }
 
       const cleanupOrphans = async () => {
@@ -1593,6 +1672,40 @@ window.__ModuleLoader__.load({
         }
       }
 
+      /**
+       * Archive every unarchived empty session, in backend-sized batches. The
+       * user can then clean them up with one confirm dialog.
+       */
+      const archiveBlankSessions = async (ids) => {
+        if (ids.length === 0) return
+        const max = state?.limits?.maxBatch ?? 50
+        setBusy(true)
+        setNotice(null)
+        try {
+          let archived = 0
+          const failures = []
+          for (let index = 0; index < ids.length; index += max) {
+            const value = await post('archive', { sessionIds: ids.slice(index, index + max) })
+            archived += value?.totals?.succeeded ?? 0
+            for (const item of value?.results ?? []) if (item.ok === false) failures.push(item)
+          }
+          if (failures.length === 0) {
+            setNotice({ tone: 'ok', text: t('archiveDone', { n: archived }) })
+          } else {
+            setNotice({
+              tone: 'error',
+              text: t('batchDone', { ok: archived, failed: failures.length }),
+              details: failures.slice(0, 20),
+            })
+          }
+          await load({ silent: true })
+        } catch (failure) {
+          setNotice({ tone: 'error', text: errorText(t, failure) })
+        } finally {
+          setBusy(false)
+        }
+      }
+
       const openSession = (id) => {
         let service
         try {
@@ -1629,8 +1742,9 @@ window.__ModuleLoader__.load({
 
       const rowsForTabs = rows.filter((row) => showBlank || row.blank !== true)
       const blankRows = rows.filter((row) => row.blank === true)
-      const blankArchivedRows = blankRows.filter((row) => row.archived === true && row.can?.delete === true)
-      const blankActiveCount = blankRows.filter((row) => row.archived !== true || row.can?.delete !== true).length
+      const blankUnarchivedRows = blankRows.filter((row) => row.archived !== true)
+      const blankArchivedRows = blankRows.filter((row) => row.archived === true)
+      const blankDeletableRows = blankArchivedRows.filter((row) => row.can?.delete === true)
       const tabs = [
         { key: 'all', label: t('tabAll'), count: rowsForTabs.length },
         { key: 'active', label: t('tabActive'), count: rowsForTabs.filter((row) => !row.archived).length },
@@ -1731,38 +1845,48 @@ window.__ModuleLoader__.load({
         h(
           'div',
           { className: 'dsm-head' },
-          h('div', null,
+          h(
+            'div',
+            { className: 'dsm-head-row' },
             h('h2', { className: 'dsm-title' }, t('pageTitle')),
-            h('p', { className: 'dsm-sub' }, t('pageSubtitle')),
-            h('p', { className: 'dsm-sub' },
-              t('totalLine', {
-                all: state.totals.all,
-                archived: state.totals.archived,
-                size: formatBytes(state.totals.bytes),
-              }),
-              blankRows.length > 0 && !showBlank
-                ? ` · ${t('hiddenBlankCount', { n: blankRows.length })}`
-                : '',
-              (state.totals?.hiddenSubagents ?? 0) > 0 && !includeSubagents
-                ? ` · ${t('hiddenSubagentCount', { n: state.totals.hiddenSubagents })}`
-                : '',
+            h('div', { className: 'dsm-head-actions' },
+              blankUnarchivedRows.length > 0
+                ? h('button', {
+                    type: 'button',
+                    className: 'dsm-btn',
+                    disabled: busy,
+                    title: t('archiveBlankHint'),
+                    onClick: () => void archiveBlankSessions(blankUnarchivedRows.map((row) => row.id)),
+                  }, t('archiveBlank', { n: blankUnarchivedRows.length }))
+                : null,
+              blankArchivedRows.length > 0
+                ? h('button', {
+                    type: 'button',
+                    className: 'dsm-btn',
+                    disabled: busy || blankDeletableRows.length === 0,
+                    title: blankDeletableRows.length === blankArchivedRows.length
+                      ? t('cleanupBlankHint')
+                      : t('cleanupBlankLockedHint', { n: blankArchivedRows.length - blankDeletableRows.length }),
+                    onClick: () => setBulkDeleteIds(blankDeletableRows.map((row) => row.id)),
+                  }, t('cleanupBlank', { n: blankArchivedRows.length }))
+                : null,
+              h('button', { type: 'button', className: 'dsm-btn', disabled: busy, onClick: () => void load({ silent: true }) },
+                busy ? h(Spinner, { t, label: t('working') }) : t('refresh')),
             ),
-            blankActiveCount > 0 && showBlank
-              ? h('p', { className: 'dsm-hint' }, t('blankActiveHint', { n: blankActiveCount }))
-              : null,
           ),
-          h('div', { className: 'dsm-head-actions' },
-            blankArchivedRows.length > 0
-              ? h('button', {
-                  type: 'button',
-                  className: 'dsm-btn',
-                  disabled: busy,
-                  title: `${t('cleanupBlankHint')}${blankActiveCount > 0 ? ` ${t('blankActiveHint', { n: blankActiveCount })}` : ''}`,
-                  onClick: () => setBulkDeleteIds(blankArchivedRows.map((row) => row.id)),
-                }, t('cleanupBlank', { n: blankArchivedRows.length }))
-              : null,
-            h('button', { type: 'button', className: 'dsm-btn', disabled: busy, onClick: () => void load({ silent: true }) },
-              busy ? h(Spinner, { t, label: t('working') }) : t('refresh')),
+          h('p', { className: 'dsm-sub' }, t('pageSubtitle')),
+          h('p', { className: 'dsm-sub' },
+            t('totalLine', {
+              all: state.totals.all,
+              archived: state.totals.archived,
+              size: formatBytes(state.totals.bytes),
+            }),
+            blankRows.length > 0 && !showBlank
+              ? ` · ${t('hiddenBlankCount', { n: blankRows.length })}`
+              : '',
+            (state.totals?.hiddenSubagents ?? 0) > 0 && !includeSubagents
+              ? ` · ${t('hiddenSubagentCount', { n: state.totals.hiddenSubagents })}`
+              : '',
           ),
         ),
         h(Notice, { notice, t, onDismiss: () => setNotice(null) }),
@@ -1932,6 +2056,7 @@ window.__ModuleLoader__.load({
               ctx,
               t,
               ids: bulkDeleteIds,
+              maxBatch: state.limits?.maxBatch ?? 50,
               busy,
               onCancel: () => setBulkDeleteIds(null),
               onConfirmed: (ids) => void deleteRows(ids),

package/docs/02-open-source-and-marketplace.md

@@ -139,3 +139,11 @@ curl -s https://awesome-dsh-plugin.com/plugins.json | grep -i session-mng
 - `npm publish`：`dsh-session-mng@0.1.2`，33 个文件，568.3 kB / unpacked 789.1 kB；约 3 分钟后 packument 出现，`latest` = 0.1.2，版本端点 200。
 - Git：main 已 push；tag `v0.1.2`；Release 见仓库 Releases。
 - marketplace 条目不变；卡片版本随 npm 自动更新，PR gate 仍只差仓库满 1 天。
+
+## 10. 0.1.3 更新发布（2026-10-28）
+
+- 功能修复：分支会话三态模型（根/分支/子代理）、分支默认可见并缩进；删除父会话不再级联普通分支；父会话有历史分支时也能移动；兼容声明增加 `0.2.1-rc.3`。
+- `npm publish`：`dsh-session-mng@0.1.3`，36 个文件，579.7 kB / unpacked 821.7 kB，shasum `e524c50988bb55a97b37ed08b6d94abcfc372b03`；约 1 分钟后 packument 出现 0.1.3，`latest` = 0.1.3。
+- Git：main 已 push（功能提交 `a827495`）；tag `v0.1.3`；Release https://github.com/ZilongYang/dsh-session-mng/releases/tag/v0.1.3
+- marketplace：条目不需要改 YAML，卡片版本随 npm 自动更新；PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 仍只差仓库年龄 gate。
+- 遗留：当前安装的 DSH `0.2.1-rc.3` 构建仍写 fork 的 `parentSession`（「独立 fork」变更只在 DSH 源码里），所以历史分支形态会继续出现，0.1.3 的删除/移动策略长期有效。

package/docs/RELEASE-CHECKLIST-0.1.3.md

@@ -30,9 +30,11 @@
 - [ ] 子龙实机复核完整流程（重启/重载 Desktop 后）：工作区从 1 条变 2 条，分支缩进在父会话下；勾选开关后子代理出现；搜索父标题命中分支；删除父会话的预览里出现分支保留提示；父会话移动不再报 `has-descendants`。
 - [ ] 若缩进/徽标观感需要微调，再改一轮。
 
-## C. 发布
+## C. 发布（已完成）
 
-- [ ] `npm --cache /tmp/dsh-npm-cache --logs-dir /tmp/dsh-npm-logs pack --dry-run` 检查文件清单。
-- [ ] `npm publish` 0.1.3；确认版本端点 `latest` = 0.1.3。
-- [ ] Git commit / push / tag `v0.1.3` / GitHub Release。
-- [ ] 更新 CHANGELOG 的发布标记、README 当前状态、ROADMAP。
+- [x] `npm --cache /tmp/dsh-npm-cache --logs-dir /tmp/dsh-npm-logs pack --dry-run`：36 个文件 / 579.7 kB（unpacked 821.7 kB），shasum `e524c50988bb55a97b37ed08b6d94abcfc372b03`。
+- [x] `npm publish` 0.1.3 成功；约 1 分钟后 packument 出现 0.1.3，`latest` = 0.1.3，`dist.fileCount` = 36。
+- [x] Git：功能提交 `a827495`，main 已 push；tag `v0.1.3`；GitHub Release https://github.com/ZilongYang/dsh-session-mng/releases/tag/v0.1.3
+- [x] 更新 CHANGELOG、README 当前状态、ROADMAP、`docs/02-open-source-and-marketplace.md`（0.1.3 发布记录）。
+- [x] marketplace 条目不需要改 YAML（版本随 npm 自动更新；PR #9672 仍等仓库年龄 gate）。
+- [ ] 子龙实机复核（见 B 节）：缩进/徽标观感、删除预览分支提示、父会话移动。

package/docs/RELEASE-CHECKLIST-0.1.4.md

@@ -0,0 +1,33 @@
+# dsh-session-mng 0.1.4 发布检查清单
+
+> 记录时间：2026-10-28。0.1.4 是详情页吸顶 + 操作提示与空会话入口三个交互修复，Host API 未变。
+
+## A. 实现
+
+- [x] `client.js`：`.dsm-detail-head` 改为 `position: sticky`（不透明背景 + 底部分隔线），返回列表/标题/徽标/打开归档始终可见。
+- [x] `client.js`：操作结果提示改为右下角浮层 toast（`position: fixed`），不随滚动消失。
+- [x] `client.js`：纯成功提示 5 秒后自动隐藏；失败与带 action 的提示保留到手动关闭。
+- [x] `client.js`：新增「归档空会话（N）」按钮（有未归档空会话时显示），按 `maxBatch` 分批归档并刷新。
+- [x] `client.js`：「清理空会话（N）」改为只要有已归档空会话就显示；数量按全部已归档空会话计；存在已打开（不可删）项时禁用并提示「重启后才能清理」。
+- [x] 中英双语文案（`archiveBlank` / `archiveBlankHint` / `cleanupBlankLockedHint`，移除 `blankActiveHint`）。
+- [x] 页面头部重排：标题与三个操作按钮同一行（按钮右对齐），副标题/统计行在下方独占整行（`.dsm-head-row` + `margin-left:auto`）。
+- [x] 删除范围预览与删除请求按 `maxBatch` 分批（空会话快捷清理可超过 50 条），结果合并成一个确认/一条提示。
+
+## B. 验证
+
+- [x] `node --check client.js`；i18n 键覆盖检查（zh/en 各 164 项，引用键全部存在）。
+- [x] `npm test`：29 个测试全绿（Host 未改）。
+- [x] 客户端无头渲染冒烟（假 state：2 条未归档空会话 + 2 条已归档空会话，其中 1 条已打开）：
+  - 头部出现「归档空会话（2）」与「清理空会话（2）」，清理按钮可用、悬停提示含「重启后才能清理」。
+  - 点击归档 → 发出 `POST /archive`（2 条），出现 toast「已归档 2 个会话。」。
+  - 等待 5.3 秒后 toast 自动消失。
+  - 头部结构为「标题行（标题 + 按钮）→ 副标题 → 统计行」；「归档空会话」「刷新」等按钮都在标题行内。
+  - 80 条已归档空会话：点「清理空会话（80）」→ 预览分 2 批（50+30）请求并合并显示「根会话: 80」；勾选确认后删除也分 2 批，toast 汇总「成功 80，失败 0」。
+- [ ] 子龙实机：滚动详情页时标题行保持可见；操作后提示在右下角且自动消失；空会话按钮行为符合预期。
+
+## C. 发布（未开始）
+
+- [ ] `npm --cache /tmp/dsh-npm-cache --logs-dir /tmp/dsh-npm-logs pack --dry-run`。
+- [ ] `npm publish` 0.1.4；确认 `latest` = 0.1.4。
+- [ ] Git commit / push / tag `v0.1.4` / GitHub Release。
+- [ ] 更新 README 当前状态、ROADMAP、`docs/02-open-source-and-marketplace.md`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-mng",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "Session management for DeepSeek Harness: one Settings page for every session — whole-session title generation, archive/restore, cross-workspace move, and permanent deletion of archived sessions.",
   "license": "MIT",