最近会话 · 侧栏浮层

一条入口行，随时回到刚才的会话。

这是 DeepSeek Harness 的侧栏插件。工作区列表下方多出一行「最近会话」，点开是一张浮在工作区列表上方的卡片：按最后活动时间列出最近的会话，点一行直接切过去；再点入口行或按 Esc 收起。

下载安装包 · 报告问题 · 更新记录

配图按真实界面排版渲染，样式取自插件构建产物；会话、工作区与头像为演示数据。

它能做什么

• 一行入口：最近会话 7 落在工作区列表下方、设置上方，和侧栏其他行同一款式 —— 看上去就是侧栏多了一行。
• 浮层不抢眼：卡片不画自己的底色，直接用侧栏自己的背景，展开后仍然像侧栏的一部分，不像多出来一个窗口。
• 点一行切过去：走官方导航，当前会话整行高亮；正在运行的会话标题前有一枚呼吸点。
• 悬停出操作：和工作区会话行同一套 —— 右侧依次出现 ⋯、归档、叉（移除），16px 图标、10px 间距；文字让位，不遮字。
• 菜单同工作区：置顶、重命名、分叉、归档、复制 Session ID，行高 34px、13px 字、14px 图标，快捷键 ⌥⌘G / ⌥⌘F / ⇧⌘A。
• 归档会先问：会话还在跑时先确认「停止并归档此会话？」；归档后从最近列表退场。
• 移除只是移出列表：叉号只把会话从这个列表拿掉，会话本身不动，带撤销。
• 已归档抽屉：列表滚到底后再往上推，拉出弹性、拉满时底部弹出一颗玻璃胶囊「已归档 N」；滚轮不会把它收回去，停手 4.5s 自动收起。
• 每行带状态：等待批准、等待计划确认、等待回答、跑完未读 —— 一眼看出哪个会话在等自己。
• 高度可调：往上拖卡片顶边改高度，双击复位；上限是工作区列表的高度，不会盖住上方内容。
• 滚动不切字：滚动停下后自动对齐到整行，列表顶部不会停在一行字的中间。
• 不打扰：点卡片外面不会收起，连续切几个会话不会被打断；Esc 或再点入口行才收起。
• 侧栏收起就消失：侧栏收成细轨道时，入口行和浮层一起隐藏 —— 不留圆点、不占位。

怎么用

1. 看向左侧栏底部，在「设置」上方找到 最近会话 这一行，右侧数字是列表里的条数。
2. 点这一行，列表从它上方浮出来，盖住工作区列表。
3. 点其中一行切换会话；浮层会保持展开，方便连着切几个。
4. 鼠标移到任意一行：右侧出现 ⋯ / 归档 / 叉。⋯ 是和工作区一样的会话菜单；叉只把这一行移出最近列表（可撤销）。
5. 想看归档：列表滚到底，再继续往上推，拉满后底部会弹出「已归档 N」，点进去可以搜索、多选；底部标题行的图标依次是搜索、选择，选择态下可用全选/取消、批量恢复、批量删除。停手几秒自动收起。
6. 再点入口行、或按 Esc 收起。想调高度就拖浮层的顶边，双击顶边复位。

安装

在 Harness 左侧的 插件 页面点 添加插件，填写下面任一个地址：

github:yfwu2020/dsh-recent-sessions

# 或固定版本
github:yfwu2020/dsh-recent-sessions#v0.2.0

# 或直接给安装包地址（从 Releases 下载）
https://github.com/yfwu2020/dsh-recent-sessions/releases/download/v0.2.0/yfwu2020-dsh-recent-sessions-0.2.0.tgz

也可以用 npm 包名：

@yfwu2020/dsh-recent-sessions

安装后在已安装列表里打开 @yfwu2020/dsh-recent-sessions 的开关。仓库和安装包都带有构建好的插件文件，不需要自行编译。如果直链打不开，可以从 Releases 下载 .tgz，解压后在「添加插件」里填写包含 package.json 的目录绝对路径。

配置

在 profile 的 cordis.patch.yml 里，找到 id: recent-sessions 那一行改配置：

键	默认	说明
maxItems	12	列表最多显示几条（3–50）
showWorkspace	true	每行第二行是否显示所属工作区名
defaultCollapsed	true	打开 Harness 时浮层是否处于收起状态
refreshMs	30000	相对时间文案的刷新间隔（毫秒）

折叠状态与高度会记在本机，不需要每次重设。

兼容范围

在 macOS Desktop 上验证。插件挂在 Harness 侧栏的官方扩展点上，需要宿主提供：

• 侧栏页脚的操作席位 sidebar.footer.action（入口行）
• 侧栏的工作区浏览区与侧栏列（浮层定位和裁切要用）

宿主改掉侧栏结构时，浮层会自动退回"自带底色"的兜底形态，入口行照常可用。

开发

npm install
bash scripts/build.sh   # host tsc → lib/ + client tsdown → lib/client.js

改动客户端代码后需要刷新一次 Harness 窗口才会加载新的 lib/client.js。 仓库里提交了构建产物，所以从 GitHub 安装的用户不需要自己编译。

实现思路、踩过的坑和排错线索记在 开发记录。

更新记录

0.3.0

• 行操作：悬停一行，右侧按工作区会话行的规格出现三枚操作（⋯ 菜单 / 归档 / 移除）；操作占位出现，文字让位，不遮字。
• 会话菜单：与工作区一致 —— 置顶、重命名、分叉、归档、复制 Session ID（含 ⌥⌘G / ⌥⌘F / ⇧⌘A）。归档正在运行的会话先确认「停止并归档」。
• 从最近会话列表移除：叉号只影响这个列表，会话本身与工作区不受影响；写入本地偏好，可撤销。
• 已归档抽屉：默认隐藏；列表到底后继续上推，按渐进阻尼拉出弹性，拉满时底部弹出一颗玻璃胶囊「已归档 N」，覆盖在列表上（不挤压列表）。上下边缘由胶囊自己的圆角 + 描边 + 投影交代，不画横线。露出后滚轮不收回，4.5s 无操作自动收起；点进去可逐条恢复。
• 菜单、重命名弹窗都 portal 到 document.body，不被侧栏裁切。
• 归档页标题行：搜索 / 选择 / 全选 / 恢复 / 删除全部收进「已归档」这一行的图标里（14px 图标、22px 命中区），不再占列表顶部一行；搜索对归档会话实时过滤，选择态支持批量恢复与批量删除。搜索与选择都按工作区搜索的展开方式做行内宽度动画（360ms）：点搜索，标签收起、图标长成带描边的输入框；点选择，选择按钮撑成四枚动作（全选 / 恢复 / 删除 / 退出），标签交叉淡换为「已选 N」；返回 / 清除 / 退出叉收回。

0.2.3

• 最近会话列表保持在解读小窗下方，普通分栏和完整视图中都不会遮挡解读内容；侧栏入口、列表操作和高度调整保持原来的方式。
• 建议配合划词解读 0.10.2、完整视图 0.1.6 使用，三个插件各自管理自己的界面，不调整 Harness 的公共浮层。

0.2.2

• 修掉「改别的插件，这一行就变样」：面板样式表现在带自己的归属标签 （data-plugin），并在模块加载时就注入 —— 以前它是在组件挂载时才注入、 又没有标签，会被宿主的样式回收机制当成"无主样式"认领走，等那个插件一热重载 就一并删掉，面板于是裸成一个带边框的默认按钮，直到刷新页面才恢复。
• 样式改成幂等注入（取或建），改 CSS 后热重载即可生效，不必再刷新窗口。

0.2.1

• 文档与市场配图整理：README 改为面向使用者，实现记录移到 开发记录。
• 在仓库里声明 screenshots.json，插件市场的详情页使用这张配图。
• 去掉控制台里那个调试抓手（window.__dshRecentSessions），功能不变。

0.2.0

• 侧栏底部的入口行改成浮层：卡片浮在工作区上方，不再从工作区借高度。
• 卡片融入侧栏背景；展开与收起都是整卡滑出 / 滑回，工作区列表被卡片边缘逐条让开。
• 滚动停下后自动对齐到整行；列表底部留白按高度换算，最后一行始终完整可见。
• 每行增加状态标识：运行中、等待批准、等待计划确认、等待回答、跑完未读。
• 侧栏收成细轨道时，入口行与浮层一起隐藏。

许可

MIT