---
## 插件对侧边栏的改造
本插件**替换了侧边栏的主体内容**——即工作区与会话列表部分。侧边栏的其他原生部分完全保持原样：品牌标识、新建会话按钮、底部状态栏以及设置导航入口均不受影响。
替换是架构上的必然要求：Harness 核心将 `sidebar.workspaces` 插槽声明为 `kind: "single"`，不允许注册多个并列组件，且侧边栏主体没有其他扩展插槽。
---
## 架构与数据流
```mermaid
graph LR
subgraph Browser ["浏览器客户端 (lib/client.js)"]
UIW["uiWorkspace 服务\n(Cordis 服务替代)"]
PANEL["SessionListPanel\n(sidebar.workspaces 插槽)"]
JUMP["QuickJump 弹窗\n(Alt+K 快捷键)"]
VIEWER["ArchiveViewer 弹窗\n(JSONL 记录查看器)"]
SETTINGS["SettingsCard\n(settings.plugin.item)"]
end
subgraph Host ["Node.js 服务端 (lib/index.js & transcript.js)"]
SERVER["Cordis WebServer\nHTTP 路由"]
STORE["DSH 会话持久化\n(句柄读取 / 日志)"]
TRANS["纯文本记录解析器\n(JSONL -> Markdown)"]
end
PANEL -->|"切换 / 连接 / 重命名"| UIW
JUMP -->|"筛选并快速跳转"| UIW
VIEWER -->|"GET /dsh-session-control/transcript"| SERVER
PANEL -->|"GET /dsh-session-control/titles"| SERVER
PANEL -->|"GET /dsh-session-control/export-batch"| SERVER
SERVER -->|"读取会话日志"| STORE
STORE -->|"句柄 / 原始事件"| TRANS
TRANS -->|"格式化记录 / Markdown"| SERVER
```
## 功能对比：原生侧边栏 vs dsh-session-control
| 功能特性 | 原生侧边栏 | `dsh-session-control` |
|---|---|---|
| **会话置顶 (Pin)** | ❌ 无 | ✅ 顶部全局置顶区，统一管理 |
| **归档视图 (Archive)** | ❌ 完全不可见 | ✅ 独立归档分区，按时间段折叠聚合 |
| **阅读归档会话** | ❌ 无法打开 | ✅ 只读完整会话转录记录弹窗 |
| **内容搜索结果** | ⚠️ 仅显示标题 | ✅ 标题 + 匹配内容上下文摘要预览 |
| **空白会话** | ⚠️ 与活跃会话混杂 | ✅ 自动隐藏无消息会话（当前会话除外） |
| **批量操作** | ❌ 无 | ✅ 复选框多选及 Shift+Click 范围批量操作 |
| **可逆隐藏** | ❌ 仅支持不可逆归档 | ✅ 一键可逆隐藏与恢复 |
| **活跃运行指示** | ❌ 无指示 | ✅ 实时运行脉冲状态圆点 |
| **就地快速重命名** | ⚠️ 弹窗修改 | ✅ 双击标题或按 F2 直接在行内重命名 |
| **跨文件夹分组** | ❌ 无法实现（归属由工作目录推导） | ✅ 独立标签，不受文件夹限制 |
| **会话名称** | ⚠️ 未命名会话一律显示项目目录名 | ✅ 取自你在该会话中的第一条消息 |
| **键盘导航** | ❌ 无 | ✅ `Alt+K` 快速跳转，活跃与归档会话通搜 |
| **导出内容** | ❌ 无法带走 | ✅ 复制或保存为 Markdown |
> 原生 Harness 核心功能（工作区目录、深度会话搜索、会话分支等）完全保留：插件复用并强化了核心能力，而非重复造轮子。
---
## 安装方法
通过 `dsh` CLI 为 web profile 安装：
```bash
dsh plugin --profile web add @goodandready/dsh-session-control
```
重启 DeepSeek Harness web profile 以应用 bundle patch。
---
## 恢复原生侧边栏
随时可以通过卸载命令恢复默认侧边栏：
```bash
dsh plugin --profile web remove @goodandready/dsh-session-control
```
原生 `ui-workspace` 模块将立即恢复启用，侧边栏恢复默认外观。所有置顶和隐藏配置安全保留在宿主存储中，重新安装插件后自动恢复。
---
## 核心功能
### 📌 会话置顶 (Pinned Sessions)
将高频核心对话置顶在侧边栏最上方的全局置顶区。由于配置存储在宿主端，置顶状态在页面刷新、更换浏览器或跨设备访问时均能持久保持。
### 🔍 上下文片段搜索 (Search with Snippets)
核心支持对话内容全文检索，`dsh-session-control` 在搜索结果中提取并展示匹配文本的上下文摘要行，无需打开会话即可快速确认匹配细节。
### 🗄️ 按时间段归档聚合 (Period-Based Archive)
归档会话按 *今天*、*本周*、*本月*、*更早* 进行分组折叠展示。折叠的时间段不会在 DOM 中渲染，即使存在数千个历史会话也不会造成界面卡顿。搜索时命中的时间段会自动展开。
### 📜 只读归档转录查看器 (Archived Transcript Viewer)
在核心中已归档的会话无法直接进入对话模式。插件通过独立服务端路由 `GET /dsh-session-control/transcript?session=
