dsh-session-mng 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.2 — 2026-10-27（unreleased）
+
+### Added
+
+- 默认隐藏空会话（`blank: true`）：这类会话本来就不出现在侧栏会话列表；现在「会话管理」默认也不显示，可用「显示空会话」临时查看。
+- 「清理空会话（N）」：批量清理**已归档且可删除**的空会话，仍先弹出删除范围确认；未归档空会话会提示先归档。
+- 全部/活跃/已归档 tab 计数与隐藏空会话后的可见列表一致；总览行显示「已隐藏 N 个空会话」。
+
+### Changed
+
+- 删除范围确认改为**模态对话框**：内容区独立滚动，底部「我已了解」勾选与「确认彻底删除 / 取消」固定可见，不再随列表滚走。
+- 删除范围弹窗支持点击遮罩取消、Esc 取消；加载/错误状态仍显示取消按钮。
+
 ## 0.1.1 — 2026-10-27
 
 ### Changed

package/README.md

@@ -17,6 +17,8 @@
 - **统一会话总览**：按工作区分组列出当前 profile 的全部会话（活跃 + 已归档）。显示标题、路径、会话 id、大小、最后活动时间、运行/已打开/已归档/已置顶/子会话标记；支持搜索、工作区筛选、排序、刷新、批量选择。
 - **工作区优先 + 分页**：会话数 >100 时默认折叠工作区；每个工作区默认 50 条，「加载更多」继续展开；搜索自动展开命中工作区。过滤工具栏和批量条整体吸顶。
 - **选择跟随可见集**：切换筛选/折叠/搜索/刷新后，隐藏会话自动取消选择；`全选当前列表` 只作用于当前筛选与已展开的工作区。
+- **空会话默认隐藏**：侧栏本来就不显示的 `blank` 会话，会话管理默认也不显示；勾选「显示空会话」才出现。提供「清理空会话（N）」快速清理已归档空会话。
+- **删除范围模态确认**：范围内容在弹窗内独立滚动，底部勾选与确认/取消按钮固定可见；支持遮罩点击/Esc 取消。
 - **生成标题**：选中任意会话（**包括已归档的冷会话**），让模型总结整段对话，给出可编辑的标题提案；**确认后才写入**。活跃会话走官方 `sessionTitle.rename`，冷会话按官方 `session/title` 事件形状追加，不需要恢复会话。
 - **归档 / 恢复**：调用官方 `workspaceRegistry.archiveSession` / `unarchiveSession`。运行中的会话先提示，用户二次确认后才停止并归档；恢复后回到原工作区原位置。
 - **跨工作区移动**：把冷会话真正迁移到目标工作区——改写会话日志 header 的 `cwd`、把日志目录迁到目标项目目录、同步 workspace 账本。SessionId、归档状态、pin 状态不变，事件字节不变。
@@ -54,7 +56,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)（审核中；dshmarket 使用同一份目录，合并后可直接在插件市场搜索到）。
+> 市场状态：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`。
 
 ## 使用
 
@@ -94,6 +96,7 @@ Host route (lib/api.js) ──► service (lib/service.js)
 | 会话后端 | 移动/删除只支持本地 JSONL 后端（`sessionPersistence.locate`）；其他后端仍可用总览/标题/归档/恢复 |
 | 官方依赖 | 无 runtime 依赖；只使用 `ctx` 服务 |
 | 已知限制 | 已打开（live）会话不能移动或彻底删除，重启 DSH 后重试；有子代理后代的会话不能单独移动；子会话不出现在主列表（可勾选「显示子会话」查看） |
+| 规模限制 | 0.1.1 的折叠/分页只在客户端压 DOM，`state` 仍一次拉全量（202 条约 103 KB；10000 条约 5 MB）。Host 侧 overview + paged sessions 是 0.2.0 的主任务 |
 
 ### 版本敏感点（请读）
 
@@ -136,14 +139,23 @@ node --check index.js client.js lib/*.js
 npm --cache /tmp/dsh-npm-cache pack --dry-run
 ```
 
-实机验收（详见 `docs/RELEASE-CHECKLIST-0.1.0.md`）：安装到 `desktop` profile → 确认 `settings.section` 出现 `session-mng-section` → 用**一次性测试会话**验证标题/归档/恢复/移动/删除 → 清理测试数据。
+实机验收：安装到 `desktop` profile → 确认 `settings.section` 出现 `session-mng-section` → 用**一次性测试会话**验证标题/归档/恢复/移动/删除 → 清理测试数据。0.1.1 的列表验收见 `docs/RELEASE-CHECKLIST-0.1.1.md`。
+
+## 当前状态与下一步
+
+- `0.1.1` 已发布到 npm / GitHub / Release；26 个测试全绿，31 个文件。
+- `0.1.2`（空会话清理 + 删除范围弹窗）已在工作区实现，待实机测试/发布。
+- 市场 PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 等 1 天仓库年龄 gate，之后等维护者合并。
+- 下一项主任务：**0.2.0 Host 侧 overview + 分页 sessions**，为 1000–10000 条会话设计；详细任务、验收标准、环境坑见 [接手说明](docs/HANDOVER-2026-10-27.md)。
 
 ## 文档索引
 
+- [接手说明（下一步任务）](docs/HANDOVER-2026-10-27.md)
 - [实施计划（批准时原样归档）](docs/PLAN-2026-10-26.md)
 - [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)
 - [设计与实现说明](docs/01-design.md)
 - [开源、发 npm 与市场收录记录](docs/02-open-source-and-marketplace.md)
 - [路线图](ROADMAP.md)

package/ROADMAP.md

@@ -1,5 +1,7 @@
 # Roadmap
 
+> 当前：`0.1.1` 已发布（npm latest / tag `v0.1.1` / Release）。市场 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.0 — delivered
 
 - 统一会话总览（活跃 + 已归档，工作区分组，搜索/筛选/排序，日志大小）。
@@ -17,10 +19,26 @@
 - 选择集裁剪到当前筛选与展开可见集；批量操作不触碰隐藏会话。
 - 批量移动提示区分 live 与一般不可移动项。
 
-## 0.2.0 — candidates
+## 0.1.2 — in progress
+
+- 空会话默认隐藏 + 「显示空会话」开关；tab 计数与可见列表一致。
+- 「清理空会话（N）」批量清理已归档空会话，复用删除范围预览/确认。
+- 删除范围确认改为模态框，内容独立滚动、底部确认区固定，支持遮罩/Esc 取消。
+
+## 0.2.0 — next (planned)
+
+首要目标：真正支撑 1000–10000 条会话，不再首屏拉全量 `state`。实施前先写 `docs/PLAN-2026-10-28.md` 并获批准。
+
+- `GET /session-mng/api/overview`：只返回工作区计数/大小/归档数、totals、capabilities、orphans；不读全部标题/日志。
+- `GET /session-mng/api/sessions`：按 `workspaceId/tab/offset/limit/query/sort` 分页；只对当前页 id 读标题/大小；返回 `hasMore`。
+- 未分组会话懒加载 + 短 TTL 缓存；全局搜索先只读验证宿主 search 是否覆盖标题。
+- Client：overview 首屏 → 工作区展开时取第一页 → 加载更多；保留 sticky、选择裁剪、搜索自动展开。
+- 兼容：保留 `/state` 给 0.1.x 客户端；Host 同时提供新旧接口。
+- 验收：合成 10k 数据首屏不返回 session rows；单页 ≤50 行；不触发全量 `sessionController.list`；现有 26 测试 + 新增分页/overview/search 测试。
+- 详细接口建议、验收与坑：[docs/HANDOVER-2026-10-27.md](docs/HANDOVER-2026-10-27.md)。
+
+## Later candidates
 
-- Host 侧 overview + paged sessions 接口：首屏只取工作区计数，按工作区懒加载 50 条，真正支撑 1000–10000 条会话。
-- 未分组会话懒加载 + 短缓存；全局搜索复用宿主索引。
 - 侧栏会话「...」菜单快捷入口（生成标题 / 会话管理详情），复用同一套 Host 操作。
 - 内容全文搜索（复用 `sessionQuery.searchSessions` / `searchEvents`），不只按标题/路径/id。
 - 导出所选会话为 Markdown / JSON（删除前的安全网；批量）。

package/client.js

@@ -44,6 +44,11 @@ window.__ModuleLoader__.load({
         sortSize: '大小',
         sortTitle: '标题',
         showSubagents: '显示子会话',
+        showBlank: '显示空会话',
+        cleanupBlank: '清理空会话（{n}）',
+        cleanupBlankHint: '批量删除已归档的空会话；未归档的空会话需先归档。',
+        blankActiveHint: '另有 {n} 个未归档空会话，归档后才能清理。',
+        hiddenBlankCount: '已隐藏 {n} 个空会话',
         selectAll: '全选当前列表',
         expandAll: '展开全部',
         collapseAll: '收起全部',
@@ -192,6 +197,11 @@ window.__ModuleLoader__.load({
         sortSize: 'Size',
         sortTitle: 'Title',
         showSubagents: 'Show subagent sessions',
+        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.',
+        hiddenBlankCount: '{n} empty sessions hidden',
         selectAll: 'Select all shown',
         expandAll: 'Expand all',
         collapseAll: 'Collapse all',
@@ -430,6 +440,22 @@ window.__ModuleLoader__.load({
 .dsm-scope-row .dsm-mono{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .dsm-danger-box{border:1px solid var(--dsw-alias-state-error-primary);border-radius:8px;padding:10px;background:var(--dsw-alias-bg-layer-1)}
 .dsm-danger-box h3{color:var(--dsw-alias-state-error-primary)}
+.dsm-scope-overlay{position:fixed;inset:0;z-index:1000;display:flex;align-items:center;justify-content:center;
+ padding:20px;background:rgba(0,0,0,.58)}
+.dsm-scope-dialog{display:flex;flex-direction:column;width:min(660px,100%);max-height:min(82vh,760px);
+ border:1px solid var(--dsw-alias-state-error-primary);border-radius:10px;overflow:hidden;
+ background:var(--dsw-alias-bg-layer-2);box-shadow:0 24px 70px rgba(0,0,0,.5)}
+.dsm-scope-head{display:flex;align-items:center;justify-content:space-between;gap:10px;
+ padding:11px 14px;border-bottom:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1)}
+.dsm-scope-head h3{margin:0;font-size:13px;line-height:18px;color:var(--dsw-alias-state-error-primary)}
+.dsm-scope-body{flex:1 1 auto;min-height:0;overflow:auto;padding:12px 14px}
+.dsm-scope-foot{display:flex;flex-direction:column;gap:8px;padding:10px 14px;
+ border-top:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1)}
+.dsm-scope-dialog .dsm-scope-list{max-height:none;overflow:visible;margin:8px 0}
+@media (max-width:640px){
+ .dsm-scope-overlay{padding:10px}
+ .dsm-scope-dialog{max-height:92vh}
+}
 .dsm-footer{font-size:11px;line-height:17px;color:var(--dsw-alias-label-secondary)}
 .dsm-spin{display:inline-block;width:12px;height:12px;border:2px solid var(--dsw-alias-border-l2);
  border-top-color:var(--dsw-alias-brand-primary);border-radius:50%;animation:dsm-spin .8s linear infinite;vertical-align:-2px}
@@ -919,6 +945,7 @@ window.__ModuleLoader__.load({
       React.useEffect(() => {
         const controller = new AbortController()
         setPhase('loading')
+        setChecked(false)
         post('delete/preview', { sessionIds: ids }, controller.signal)
           .then((value) => {
             if (controller.signal.aborted) return
@@ -933,43 +960,86 @@ window.__ModuleLoader__.load({
         return () => controller.abort()
       }, [idsKey, t])
 
+      React.useEffect(() => {
+        const onKeyDown = (event) => {
+          if (event.key !== 'Escape') return
+          event.preventDefault()
+          event.stopPropagation()
+          if (busy !== true) onCancel()
+        }
+        document.addEventListener('keydown', onKeyDown, true)
+        return () => document.removeEventListener('keydown', onKeyDown, true)
+      }, [busy, onCancel])
+
       const rows = preview?.sessions ?? []
       const blocked = rows.some((row) => row.live || row.running)
+      const ready = phase === 'ready' && preview !== null
       return h(
         'div',
-        { className: 'dsm-danger-box' },
-        h('h3', null, t('deleteScope')),
-        h('p', { className: 'dsm-hint', style: { margin: '0 0 6px' } }, t('deleteHint')),
-        phase === 'loading'
-          ? h('p', { className: 'dsm-hint' }, t('deletePreviewLoading'))
-          : phase === 'error'
-            ? h('p', { className: 'dsm-error' }, error)
-            : h(
-                React.Fragment,
-                null,
-                h('div', { className: 'dsm-hint' },
-                  `${t('deleteRoots')}: ${preview?.roots?.length ?? 0} · ${t('deleteDescendants')}: ${preview?.descendantCount ?? 0} · ${t('deleteTotalSize', { size: formatBytes(preview?.totalBytes ?? 0) })}`,
-                ),
-                h('div', { className: 'dsm-scope-list' },
-                  rows.map((row) =>
-                    h(
-                      'div',
-                      { key: row.id, className: 'dsm-scope-row' },
-                      h('span', { className: 'dsm-badge' }, row.descendant ? t('scopeChild') : t('scopeRoot')),
-                      h('span', { className: 'dsm-mono', title: row.dir ?? row.id }, row.id),
-                      row.live ? h(Badge, { tone: 'brand' }, t('liveBadge')) : null,
-                      row.running ? h(Badge, { tone: 'run' }, t('running')) : null,
-                      row.missing ? h(Badge, { tone: 'warn' }, t('missingDir')) : null,
-                      row.readable === false ? h(Badge, { tone: 'warn' }, t('unreadable')) : null,
-                      h('span', { style: { marginLeft: 'auto' } }, formatBytes(row.bytes)),
+        {
+          className: 'dsm-scope-overlay',
+          onMouseDown: (event) => {
+            if (event.target === event.currentTarget && busy !== true) onCancel()
+          },
+        },
+        h(
+          'div',
+          {
+            className: 'dsm-scope-dialog',
+            role: 'dialog',
+            'aria-modal': 'true',
+            'aria-label': t('deleteScope'),
+          },
+          h(
+            'div',
+            { className: 'dsm-scope-head' },
+            h('h3', null, t('deleteScope')),
+            h('button', {
+              type: 'button',
+              className: 'dsm-btn ghost',
+              'aria-label': t('close'),
+              disabled: busy,
+              onClick: onCancel,
+            }, '×'),
+          ),
+          h(
+            'div',
+            { className: 'dsm-scope-body' },
+            h('p', { className: 'dsm-hint', style: { margin: '0 0 8px' } }, t('deleteHint')),
+            phase === 'loading'
+              ? h('p', { className: 'dsm-hint' }, t('deletePreviewLoading'))
+              : phase === 'error'
+                ? h('p', { className: 'dsm-error' }, error)
+                : h(
+                    React.Fragment,
+                    null,
+                    h('div', { className: 'dsm-hint' },
+                      `${t('deleteRoots')}: ${preview?.roots?.length ?? 0} · ${t('deleteDescendants')}: ${preview?.descendantCount ?? 0} · ${t('deleteTotalSize', { size: formatBytes(preview?.totalBytes ?? 0) })}`,
                     ),
+                    h('div', { className: 'dsm-scope-list' },
+                      rows.map((row) =>
+                        h(
+                          'div',
+                          { key: row.id, className: 'dsm-scope-row' },
+                          h('span', { className: 'dsm-badge' }, row.descendant ? t('scopeChild') : t('scopeRoot')),
+                          h('span', { className: 'dsm-mono', title: row.dir ?? row.id }, row.id),
+                          row.live ? h(Badge, { tone: 'brand' }, t('liveBadge')) : null,
+                          row.running ? h(Badge, { tone: 'run' }, t('running')) : null,
+                          row.missing ? h(Badge, { tone: 'warn' }, t('missingDir')) : null,
+                          row.readable === false ? h(Badge, { tone: 'warn' }, t('unreadable')) : null,
+                          h('span', { style: { marginLeft: 'auto' } }, formatBytes(row.bytes)),
+                        ),
+                      ),
+                    ),
+                    h('p', { className: 'dsm-hint', style: { margin: '0 0 6px' } }, t('deleteCascadeNote')),
+                    blocked ? h('p', { className: 'dsm-error' }, t('deleteLiveHint')) : null,
                   ),
-                ),
-                h('p', { className: 'dsm-hint', style: { margin: '0 0 6px' } }, t('deleteCascadeNote')),
-                blocked
-                  ? h('p', { className: 'dsm-error' }, t('deleteLiveHint'))
-                  : null,
-                h('label', { className: 'dsm-check', style: { marginBottom: 8 } },
+          ),
+          h(
+            'div',
+            { className: 'dsm-scope-foot' },
+            ready
+              ? h('label', { className: 'dsm-check' },
                   h('input', {
                     type: 'checkbox',
                     checked,
@@ -977,20 +1047,22 @@ window.__ModuleLoader__.load({
                     onChange: (event) => setChecked(event.target.checked),
                   }),
                   t('deleteConfirmCheck'),
-                ),
-                h(
-                  'div',
-                  { className: 'dsm-actions' },
-                  h('button', {
-                    type: 'button',
-                    className: 'dsm-btn danger',
-                    disabled: busy || blocked || checked !== true,
-                    onClick: () => onConfirmed(ids),
-                  }, busy ? t('deleting') : t('deleteConfirm')),
-                  h('button', { type: 'button', className: 'dsm-btn ghost', disabled: busy, onClick: onCancel }, t('cancel')),
-                  blocked ? h('span', { className: 'dsm-hint' }, t('liveHint')) : null,
-                ),
-              ),
+                )
+              : null,
+            h(
+              'div',
+              { className: 'dsm-actions' },
+              h('button', {
+                type: 'button',
+                className: 'dsm-btn danger',
+                disabled: busy || ready !== true || blocked || checked !== true,
+                onClick: () => onConfirmed(ids),
+              }, busy ? t('deleting') : t('deleteConfirm')),
+              h('button', { type: 'button', className: 'dsm-btn ghost', disabled: busy, onClick: onCancel }, t('cancel')),
+              blocked ? h('span', { className: 'dsm-hint' }, t('liveHint')) : null,
+            ),
+          ),
+        ),
       )
     }
 
@@ -1153,7 +1225,7 @@ window.__ModuleLoader__.load({
      * Derive the filtered / grouped / rendered view for the list.
      * Pure so the selection-pruning effect can use it before the loading guard.
      */
-    function computeView({ state, tab, workspaceFilter, query, sort, expanded, defaultExpanded, limits }) {
+    function computeView({ state, tab, workspaceFilter, query, sort, expanded, defaultExpanded, limits, showBlank }) {
       const rows = state?.sessions ?? []
       const workspaceOrder = state?.workspaces ?? []
       const text = query.trim().toLowerCase()
@@ -1163,6 +1235,7 @@ window.__ModuleLoader__.load({
         if (tab === 'archived' && !row.archived) return false
         if (workspaceFilter === 'ungrouped' && row.workspaceId !== null) return false
         if (workspaceFilter !== 'all' && workspaceFilter !== 'ungrouped' && row.workspaceId !== workspaceFilter) return false
+        if (showBlank !== true && row.blank === true) return false
         if (filtering) {
           const haystack = `${row.title}\n${row.cwd}\n${row.id}`.toLowerCase()
           if (!haystack.includes(text)) return false
@@ -1233,6 +1306,7 @@ window.__ModuleLoader__.load({
       const [bulkTarget, setBulkTarget] = React.useState('')
       const [expanded, setExpanded] = React.useState(null)
       const [limits, setLimits] = React.useState({})
+      const [showBlank, setShowBlank] = React.useState(false)
       const abortRef = React.useRef(null)
       const searchRef = React.useRef(null)
       const listScroll = React.useRef(0)
@@ -1298,6 +1372,7 @@ window.__ModuleLoader__.load({
         if (selectedId === null) return undefined
         const onKeyDown = (event) => {
           if (event.key === 'Escape') {
+            if (document.querySelector('.dsm-scope-overlay') !== null) return
             event.stopPropagation()
             backToList()
           }
@@ -1308,13 +1383,13 @@ window.__ModuleLoader__.load({
 
       React.useEffect(() => {
         setLimits({})
-      }, [tab, workspaceFilter, query, includeSubagents])
+      }, [tab, workspaceFilter, query, includeSubagents, showBlank])
 
       const rows = state?.sessions ?? []
       const defaultExpanded = (state?.totals?.all ?? 0) <= DEFAULT_COLLAPSE_AFTER
       const view = React.useMemo(
-        () => computeView({ state, tab, workspaceFilter, query, sort, expanded, defaultExpanded, limits }),
-        [state, tab, workspaceFilter, query, sort, expanded, defaultExpanded, limits],
+        () => computeView({ state, tab, workspaceFilter, query, sort, expanded, defaultExpanded, limits, showBlank }),
+        [state, tab, workspaceFilter, query, sort, expanded, defaultExpanded, limits, showBlank],
       )
       const viewKey = React.useMemo(
         () => [
@@ -1323,10 +1398,11 @@ window.__ModuleLoader__.load({
           workspaceFilter,
           query,
           includeSubagents ? 1 : 0,
+          showBlank ? 1 : 0,
           defaultExpanded ? 1 : 0,
           expanded === null ? 'auto' : [...expanded].sort().join(','),
         ].join('|'),
-        [state?.generatedAt, tab, workspaceFilter, query, includeSubagents, defaultExpanded, expanded],
+        [state?.generatedAt, tab, workspaceFilter, query, includeSubagents, showBlank, defaultExpanded, expanded],
       )
       React.useEffect(() => {
         setSelected((previous) => {
@@ -1455,10 +1531,14 @@ window.__ModuleLoader__.load({
         return h('div', { className: 'dsm-page' }, h('p', { className: 'dsm-hint' }, h(Spinner, { t, label: t('loading') })))
       }
 
+      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 tabs = [
-        { key: 'all', label: t('tabAll'), count: rows.length },
-        { key: 'active', label: t('tabActive'), count: rows.filter((row) => !row.archived).length },
-        { key: 'archived', label: t('tabArchived'), count: rows.filter((row) => row.archived).length },
+        { key: 'all', label: t('tabAll'), count: rowsForTabs.length },
+        { key: 'active', label: t('tabActive'), count: rowsForTabs.filter((row) => !row.archived).length },
+        { key: 'archived', label: t('tabArchived'), count: rowsForTabs.filter((row) => row.archived).length },
       ]
       const visibleAllSelected = view.visibleRows.length > 0 && view.visibleRows.every((row) => selected.has(row.id))
       const selectedRows = view.visibleRows.filter((row) => selected.has(row.id))
@@ -1564,9 +1644,24 @@ window.__ModuleLoader__.load({
                 archived: state.totals.archived,
                 size: formatBytes(state.totals.bytes),
               }),
+              blankRows.length > 0 && !showBlank
+                ? ` · ${t('hiddenBlankCount', { n: blankRows.length })}`
+                : '',
             ),
+            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')),
           ),
@@ -1639,6 +1734,14 @@ window.__ModuleLoader__.load({
             }),
             t('showSubagents'),
           ),
+          h('label', { className: 'dsm-check' },
+            h('input', {
+              type: 'checkbox',
+              checked: showBlank,
+              onChange: (event) => setShowBlank(event.target.checked),
+            }),
+            t('showBlank'),
+          ),
         ),
         view.visibleRows.length > 0
           ? h(

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

@@ -118,3 +118,17 @@ curl -s https://awesome-dsh-plugin.com/plugins.json | grep -i session-mng
 - [ ] PR 编号 / 合并状态 / CI 结果
 - [ ] dshmarket 卡片截图或文本记录
 - [ ] `docs/PLAN-2026-10-26.md` 末尾追加「事后差异（补记）」
+
+## 7. 0.1.1 更新发布（2026-10-27）
+
+0.1.1 是客户端可用性修复（工作区优先/分页、sticky、选择裁剪、控件视觉），Host API 未变，marketplace 条目不需要改 YAML。
+
+- 本地提交：`cea99f9 fix: align sticky surface and enlarge list controls`（功能提交 `d36e725`）。
+- `npm publish`：`dsh-session-mng@0.1.1`，31 个文件，tarball 560.7 kB / unpacked 767.4 kB；发布后约 90 秒 packument 出现 0.1.1，`latest` = 0.1.1，版本端点 200。
+- Git：main 已 push；tag `v0.1.1`；GitHub Release 见仓库 Releases。
+- marketplace：PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 不变；`check` 已通过，`Submission gate` 仅因仓库 0.0 天（需要 1 天）失败；该检查会自动重跑，约 24h 后转绿，不需要重新提交。
+- Release：https://github.com/ZilongYang/dsh-session-mng/releases/tag/v0.1.1
+
+## 8. 接手
+
+下一步市场验证与 0.2.0 任务见 [HANDOVER-2026-10-27.md](HANDOVER-2026-10-27.md)。

package/docs/HANDOVER-2026-10-27.md

@@ -0,0 +1,133 @@
+# dsh-session-mng 接手说明（2026-10-27）
+
+> 面向下一个接手的人/会话。先读这一页，再按链接进入详细文档。当前代码在 `main`，工作区干净。
+
+## 1. 当前状态
+
+| 项 | 值 |
+|---|---|
+| 版本 | `0.1.1`（npm `latest`） |
+| npm | https://www.npmjs.com/package/dsh-session-mng |
+| GitHub | https://github.com/ZilongYang/dsh-session-mng |
+| Release | https://github.com/ZilongYang/dsh-session-mng/releases/tag/v0.1.1 |
+| 当前 main | 发布代码/功能提交 `d36e725`、`cea99f9`；交接后的文档提交以远端 `main` 为准 |
+| Tag | `v0.1.1` → `1b6a07f` |
+| 测试 | `node --test` 26 个全绿 |
+| 包内容 | `npm pack` 31 个文件 / 560.8 kB；发布 tarball 560.7 kB |
+| 本地安装 | 已作为 symlink 安装到 Desktop `desktop` profile；改 client 后刷新页面即可，Host 改动需重启 DSH |
+| 市场 PR | awesome-dsh-plugin [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672)，open |
+
+### 市场 PR 的真实状态
+
+- 条目文件：`data/plugins/ZilongYang__dsh-session-mng.yml`，只新增 1 个文件；分支 `add-dsh-session-mng`（fork `ZilongYang/awesome-dsh-plugin`）。
+- CI：`check` **已通过**；`Submission gate` 唯一失败项是**仓库 0.0 天，要求满 1 天**。
+- Gate 原文：`repository is 0.0 days old (needs 1) — this check re-runs by itself and should clear in about 24h. No need to resubmit, push, or close and reopen.`
+- 预计自动转绿：仓库创建于 `2026-10-26T16:44:42Z`，满 1 天约为 **2026-10-27T16:44Z / 2026-10-28 00:44 Asia/Shanghai**。
+- **不要**重新提交 PR 或关闭重开；gate 自动重跑。转绿后等维护者合并。
+- 合并后 dshmarket/awesome 目录才会出现；市场卡片读取 npm 版本，当前应显示 `0.1.1`。验证：`curl -s https://awesome-dsh-plugin.com/plugins.json | grep -i session-mng`，以及在 dshmarket 搜 `dsh-session-mng`。
+
+## 2. 代码地图
+
+| 文件 | 职责 / 接手要点 |
+|---|---|
+| `index.js` | Host 入口、inject、幂等挂载 `/session-mng/api` |
+| `lib/api.js` | 路由、64 KiB body 上限、错误信封；**新增加分页接口从这里开始** |
+| `lib/fence.js` | loopback / trustedHosts / Origin 围栏 |
+| `lib/service.js` | 操作层；state / title / archive / delete / move |
+| `lib/state.js` | 总览组装；0.2.0 的 overview/page 应从这里拆分 |
+| `lib/title.js` | 整段会话标题、模型路由、清洗/截断 |
+| `lib/store-jsonl.js` | header、zstd frame、目录复制/事务/回滚 |
+| `lib/workspace-sync.js` | 移动后的 registry 缓存对账；删除后的账本清理 |
+| `client.js` | 设置页单文件 UI；列表逻辑在 `computeView` / `SessionManagerPage` |
+| `test/` | title / store-jsonl / state / service / api，共 26 个 |
+
+### 0.1.1 列表逻辑（不要改坏）
+
+- `computeView`：过滤 → 排序 → 分组 → 折叠 → 每组分页 → `visibleRows`；纯函数。
+- 默认 `>100` 折叠；每工作区 50 条；`loadMore` 只改 `limits`，不改可见集。
+- `viewKey` 变化（tab/工作区/搜索/展开集合/刷新）后 `selected = selected ∩ visibleIdSet`。
+- 行 checkbox 的 `onSelect` 与工作区头 `onToggle` 必须分开；曾因此误折叠工作区。
+- sticky 使用 `--dsw-alias-bg-layer-2`（与设置面板一致），不要改回 `bg-base` 黑色。
+
+## 3. 下一步任务
+
+### P0 — 等市场 gate / 合并（无代码）
+
+1. 满 1 天后重新查看 `gh pr checks 9672 --repo awesome-dsh-plugin/awesome-dsh-plugin`。
+2. gate 转绿后不要重复提交；等待维护者合并。
+3. 合并后验证市场目录：`plugins.json` / dshmarket 搜索 / 卡片版本 `0.1.1` / 4 张截图 / `icon-180.png`。
+4. 把结果回填到 `docs/02-open-source-and-marketplace.md` 第 7 节和 `docs/RELEASE-CHECKLIST-0.1.1.md` 的 E 节。
+5. 如果维护者要求改描述/分类，只改 PR 里的那 1 个 YAML；代码仓库的发版不受影响。
+
+### P1 — 0.2.0：Host 侧 overview + 分页 sessions（主任务）
+
+目标：真正支撑 **1000–10000 条会话**，不再首屏拉全量 state。0.1.1 只是客户端折叠/分页，state payload 仍是全量（202 条约 103 KB；10000 条约 5 MB）。
+
+建议（实现前先写 `docs/PLAN-2026-10-28.md` 并让子龙批准）：
+
+1. **`GET /session-mng/api/overview`**
+   - 只返回 `workspaces[]`（id/title/path/status/sessionIds.length/archivedCount/总大小）+ `totals` + `capabilities` + `orphans`。
+   - 计数优先用 `workspaceRegistry` 的内存 `sessionIds` / archived set；不要为计数读全部标题或日志。
+   - 未分组会话数量：需要一次 header 扫描；做成懒加载 + 短 TTL 缓存，不阻塞首屏。
+2. **`GET /session-mng/api/sessions?workspaceId=&tab=&offset=&limit=&query=&sort=`**
+   - 只对当前页 id 做 `readTitleSnapshots` / `stat`；返回 `rows/total/offset/limit/hasMore`。
+   - 已归档：用 `archivedSessionIds` 过滤 workspace 账本；不要扫全量日志。
+   - 排序必须在 host 完成，保证分页稳定。
+3. **全局搜索**
+   - 先只读验证 `sessionController.search` / `sessionQuery.searchSessions` 是否覆盖标题；不覆盖就限制为“当前工作区/已加载页标题搜索”，内容搜索走宿主索引。
+   - 搜索结果返回 id 列表后再按页补标题/大小，避免全量读标题。
+4. **Client**
+   - `overview` 首屏 → 默认折叠；展开工作区时请求第一页；`加载更多` 请求下一页；缓存每工作区页。
+   - 保持 0.1.1 的 sticky、选择裁剪、搜索自动展开、视觉规范。
+   - 选择语义：优先保留“可见集”语义；跨页选择需要明确“已加载页”边界，避免隐藏页误操作。
+5. **兼容**
+   - 保留 `GET /state` 给 0.1.x 客户端；Host 同时提供新旧接口，客户端 feature-detect.
+   - 版本 0.2.0；升级 README/CHANGELOG/ROADMAP；新增 `docs/RELEASE-CHECKLIST-0.2.0.md`.
+6. **验收**
+   - 合成 10k 会话数据：首屏 overview 不带 session rows；单页 ≤50 行；不触发全量 `sessionController.list`。
+   - 现有 26 个测试 + 新增 overview/page/search/分页/空态/归档/未分组测试。
+   - 实机只读验证 202 条真实数据，再用手动合成数据验证 1000/10000；写操作仍只用一次性测试会话。
+
+### P2 — 后续候选（不急）
+
+侧栏会话菜单、全文搜索、导出、置顶、整枝移动、会话体检/修复、回收站、增量移动。按 `ROADMAP.md` 逐项排，不要一次全做。
+
+## 4. 发布 / 开发命令
+
+```sh
+cd /Users/zilong/zWork/ai/zl-plugins/dsh-session-mng
+
+npm test
+node --check index.js client.js lib/*.js
+npm --cache /tmp/dsh-npm-cache pack --dry-run
+
+# npm 发布（0.1.x 均出现 202 + 0.0.0-stage 占位，约 90s 后 packument 出现新版本；以版本端点为准）
+npm --cache /tmp/dsh-npm-cache publish
+curl -s -o /dev/null -w "%{http_code}\n" https://registry.npmjs.org/dsh-session-mng/<version>
+
+# GitHub
+git push origin main
+git tag v<version> && git push origin v<version>
+gh release create v<version> --repo ZilongYang/dsh-session-mng --title "dsh-session-mng <version>" --notes-file /tmp/notes.md
+```
+
+## 5. 环境与坑
+
+- DSH `0.2.1-rc.2`；Desktop `desktop` profile **由应用独占**，不要用 `dsh plugin --profile desktop …` 管理；用应用内插件管理器或 `plugin_manager`。
+- Client 服务只能 `ctx.get('uiWorkspace')`；直接 `ctx.uiWorkspace` 在未 inject 时会抛错，且被 try/catch 吞掉会导致“恢复并打开”消失。
+- 移动依赖 workspace registry 内部缓存 seam；已做特性检测和回滚，升级 DSH 先跑测试 + 实机验收。
+- 移动/删除只支持本地 JSONL；live 会话拒绝移动/删除，重启后重试。
+- 测试/截图只用一次性测试会话或 `/Users/demo/...` + `session-demo-*` 假数据；不要提交真实标题/路径/会话 id。
+- 公开计划是脱敏版；逐字原文在 `private/raw-plans/`（gitignore，不进 npm）。
+- 0.1.1 的 npm tarball 是在最终文档回填前打的，包内 checklist 可能显示 pending；功能/README 无影响。不值得为这个单独发 0.1.2。
+- GitHub tag `v0.1.1` 指向 `1b6a07f`；之后只有文档提交 `7e1b457`，代码一致。
+
+## 6. 关键文档
+
+- [0.1.0 批准计划](PLAN-2026-10-26.md)
+- [0.1.1 实施计划](PLAN-2026-10-27.md)
+- [0.1.1 发布清单](RELEASE-CHECKLIST-0.1.1.md)
+- [设计说明](01-design.md)
+- [开源/市场记录](02-open-source-and-marketplace.md)
+- [路线图](../ROADMAP.md)
+- [变更记录](../CHANGELOG.md)

package/docs/PLAN-2026-10-27.md

@@ -67,3 +67,5 @@
 5. **新增第 4 张截图** `screenshot-4-expanded.png`，展示工作区展开、选择 2 条活跃会话、sticky 过滤 + 批量条；市场可展示 4 张。
 6. **实现中修了一个行选择事件绑定 bug**：Group 的行 checkbox 最初误调用工作区折叠函数（`toggleGroup`），已拆成 `onSelect` / `onToggle` 两个 prop；该 bug 只存在于工作区，未进入 0.1.0 发布。
 7. **0.1.1 仍是客户端快修**：首屏继续拉全量 state（202 条约 103 KB；10000 条约 5 MB），真正按工作区懒加载/分页在 0.2.0 做。这一点在验收时明确，不把 0.1.1 当成 10000 条的解决方案。
+
+8. **发布结果（2026-10-27）**：0.1.1 已发布；npm `latest` = 0.1.1（31 文件，560.7 kB），GitHub main / tag `v0.1.1` / Release 已更新；marketplace 条目不变，版本随 npm 自动更新。

package/docs/RELEASE-CHECKLIST-0.1.1.md

@@ -35,8 +35,21 @@
 
 ## D. 发布
 
-- [x] `npm --cache /tmp/dsh-npm-cache pack --dry-run`：31 个文件 / 560.8 kB / unpacked 766.6 kB；包含 4 张截图。
-- [ ] `npm publish` 0.1.1；验证 `registry.npmjs.org/dsh-session-mng/0.1.1`。
-- [ ] Git commit + `git push origin main` + tag `v0.1.1` + GitHub Release。
-- [ ] 确认 npm `latest` = 0.1.1；marketplace 条目无需改 YAML（npm 版本自动更新）。
-- [ ] 在 `docs/02-open-source-and-marketplace.md` 记录 0.1.1 发布结果。
+- [x] `npm --cache /tmp/dsh-npm-cache pack --dry-run`：31 个文件 / 560.8 kB；npm 发布实际 tarball 560.7 kB / unpacked 767.4 kB；包含 4 张截图。
+- [x] `npm publish` 0.1.1（`+ dsh-session-mng@0.1.1`）；版本端点 HTTP 200，`latest` = 0.1.1，`dist.fileCount` = 31。发布后约 90 秒 packument 才出现 0.1.1（与 0.1.0 相同的 staged 处理）。
+- [x] Git commit `cea99f9` + push main + tag `v0.1.1` + GitHub Release（https://github.com/ZilongYang/dsh-session-mng/releases/tag/v0.1.1）。
+- [x] 确认 npm `latest` = 0.1.1；marketplace 条目无需改 YAML，市场卡片版本随 npm 自动更新。
+- [x] 在 `docs/02-open-source-and-marketplace.md` 记录 0.1.1 发布结果。
+
+## E. 市场收录（进行中）
+
+- [x] PR [#9672](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/9672) 已提交，只新增 1 个 YAML；条目不需要随 0.1.1 改。
+- [x] `check` 已通过。
+- [ ] `Submission gate`：当前仅因仓库 0.0 天（需要 1 天）失败；约 2026-10-28 00:44 Asia/Shanghai 自动重跑，不要重新提交/关闭重开。
+- [ ] gate 转绿后等待维护者合并。
+- [ ] 合并后验证 `plugins.json` / dshmarket 搜索、卡片版本 `0.1.1`、4 张截图、icon。
+- [ ] 结果回填 `docs/02-open-source-and-marketplace.md` 与本节。
+
+## F. 接手
+
+完整接手说明、0.2.0 任务、环境坑见 [HANDOVER-2026-10-27.md](HANDOVER-2026-10-27.md)。

package/docs/RELEASE-CHECKLIST-0.1.2.md

@@ -0,0 +1,31 @@
+# dsh-session-mng 0.1.2 发布检查清单
+
+> 记录时间：2026-10-27。0.1.2 是空会话清理 + 删除范围弹窗的客户端修复；Host API 未变。**当前未发布**，等子龙实机测试后再执行 npm/GitHub。
+
+## A. 实现
+
+- [x] 默认隐藏 `blank: true` 的空会话；新增「显示空会话」开关。
+- [x] 全部/活跃/已归档 tab 计数与隐藏空会话后的可见列表一致。
+- [x] 总览行显示「已隐藏 N 个空会话」；显示空会话时才显示“未归档空会话需先归档”提示。
+- [x] 头部新增「清理空会话（N）」：只收集 `blank && archived && can.delete` 的会话，打开删除范围预览；未归档空会话不混入。
+- [x] 删除范围确认改为模态：内容区独立滚动、底部勾选/确认/取消固定；支持遮罩点击与 Esc 取消。
+- [x] 单条详情里的删除范围与批量删除共用同一模态。
+
+## B. 验证
+
+- [x] `node --check client.js`。
+- [x] `node --test` 26 个测试全绿（Host/标题/移动/删除未改）。
+- [x] React render smoke（4 条假会话、2 条空白归档）：
+  - 默认只渲染 2 条非空会话；tab 全部/活跃/已归档 = 2/2/0；`清理空会话` 按钮存在。
+  - 打开清理 → `.dsm-scope-overlay` / `.dsm-scope-dialog` / `.dsm-scope-foot` 存在；确认按钮 disabled；取消后弹窗消失。
+  - 勾选「显示空会话」→ 行数 4；再取消。
+- [ ] 子龙实机测试：默认隐藏、显示空会话、清理空会话（**不要确认删除真实空会话**，除非明确要清）、删除范围弹窗滚动时底部按钮可见。
+- [ ] 若确认文案/按钮位置需要微调，再改一轮。
+
+## C. 发布（待批准）
+
+- [x] `npm pack --dry-run`：33 个文件 / 568.2 kB（比 0.1.1 多 2 个 docs）。
+- [ ] `npm publish` 0.1.2；验证版本端点与 latest。
+- [ ] Git commit / push / tag `v0.1.2` / GitHub Release。
+- [ ] 市场条目不需要改 YAML；版本随 npm 自动更新。
+- [ ] 更新 `CHANGELOG` 的 unreleased 标记、README 当前状态、ROADMAP、`docs/HANDOVER-2026-10-27.md`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-mng",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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",