前言¶
在 DeepSeek Harness(DSH)里长时间跑多个会话时,侧边栏往往是按时间或默认列表平铺:正在跑的任务、等输入的对话、已经跑完但还没处理的记录混在一起,找一条会话或判断「哪条需要先看」都要扫一遍。社区插件 dsh-session-inbox(仓库名,展示名 DSH Session Workbench)用一套紧凑的侧边栏工作台,把会话按「待处理 / 执行中 / 已整理」分层,并保留一键切回 DSH 原布局。下面介绍它是什么、能做什么,以及如何安装与日常使用。
这是什么¶
dsh-session-inbox 是 Tracest 维护的 客户端 类 DSH 插件(MIT 许可证)。它替换 DSH 的会话浏览器(sidebar / 工作区相关 UI 模块),而不是给所有插件做通用皮肤。当前包版本 0.4.2,在 package.json 中声明依赖 DSH 0.2.1-rc.5,并有意锁定该 UI 契约,升级 DSH 前需作者重新验证。
插件界面标签为中文;README 写明 macOS Desktop 为最初验证平台。0.4.2 继承 0.4.1+windows.1 的 Windows 修复,并在 DSH 0.2.1-rc.5 上通过 Windows Desktop 冷启动、紧凑网格与原布局等检查;Linux 桌面几何与任意第三方插件组合尚未验证。同一浏览器组件也可在 dsh web 中加载。
核心功能¶
三层列表与 Settle¶
- 上方无标题收件区:已完成、空闲、等待输入的会话直接列在这里,直到你手动 Settle(整理) 才移出该区的「待处理」语义;不会自动归档或删除对话。
- 底部 Working 架:只有无人值守、仍在执行的任务会出现在底部;完成或需要输入时会回到上方收件区,按返回时间排序。Working 为空时该架隐藏。
- 底部 Settled:已整理会话在列表最下方,展开时可独立滚动。Settle / Restore 只改插件侧的列表元数据,不停止、不删改会话内容。
未读完成项有圆点与加粗标题;打开或 Settle 会消除未读。待审批、提问、计划审阅等在无标题收件区里优先排序。
搜索、项目与原生操作¶
- 一行搜索配合项目筛选与列表选项;搜索匹配标题、项目名与路径,不搜对话正文;清空搜索后恢复折叠状态。搜索时可临时展开 Settled 等区域并高亮字面匹配。
- 项目分组可选,默认关闭;只分组上方收件区,底部 Working / Settled 保持紧凑,每行仍显示项目。
- 行内 ⋯、右键或 Shift+F10 打开 DSH 原生会话菜单(置顶、重命名、分叉、归档及已注册扩展);双击标题可重命名。归档会话的打开按钮标注为「restore and open」,走 DSH 原生取消归档;Settle 不会取消归档。
- 顶部保留紧凑的 New session、原生侧栏开关,以及原生全局工具入口(图标、可访问名称、回调与注册顺序不变);账号菜单仍在下方。
原布局与工作台切换¶
- 原布局:恢复完整原生侧栏与会话列表样式;原生搜索 展开时,返回工作台的小控件会隐藏。
- 切到工作台:回到本插件布局。
键盘与备份¶
- 原生搜索快捷键仍可用(macOS 默认 Command+K)。方向键选行,Home/End 到首末可见行,Enter 打开,Shift+Enter 整理/恢复,Escape 清空搜索并聚焦搜索框(列表快捷键不接管对话编辑器)。
- 偏好、折叠状态与 Settle 标记存在当前 DSH 浏览器源的
localStorage,键名dsh-session-inbox:state:v1,与聊天记录分离、不跨设备同步。通过 ⋯ → 导出整理备份… / 恢复整理备份… 可导出/合并 JSON(含会话 ID、Settle 时间戳与显示偏好,不含对话正文、标题、路径与账号设置)。
安装与启用¶
DSH Desktop¶
在 Plugins → Add plugin → Git source 中使用:
https://github.com/Tracest/dsh-session-inbox
安装后,在 DSH 任务空闲时退出并重新打开,以便 UI 依赖绑定到替换后的工作区模块。仓库已提交编译好的浏览器 bundle,安装不需要跑构建或 npm 账号。
若曾使用更早的仅本地构建,需先用该构建的恢复脚本去掉标记为 # dsh-session-inbox managed section 的覆盖,再安装本标准包;不要同时加载两份。聊天记录与本地 Settle 记录共用同一存储键,移除旧覆盖后仍可用。
命令行(web profile 示例)¶
dsh plugin --profile web add git+https://github.com/Tracest/dsh-session-inbox.git
请使用实际服务应用的 profile;装到 web 不会改变 Desktop 的 desktop profile。
插件市场索引(DSH 0.2.1)¶
启用实验性 Custom plugin markets 后,在 Plugins → Discover → Add index source 添加作者维护的索引:
https://raw.githubusercontent.com/Tracest/dsh-session-inbox/main/market/index.json
与社区目录无关,是否收录社区目录取决于各目录自身规则。
典型用法¶
- 安装并重启 DSH 后,侧边栏即为工作台:跑完或等输入的会话在上方,无人值守执行中的在底部 Working。
- 处理完一条会话后,用 Settle 将其移入底部 Settled;若还要跟进,用 Restore 拉回上方收件区(不删对话)。
- 会话多时用搜索与文件夹按钮筛项目;需要 DSH 默认列表时点 原布局,用完点 切到工作台。
- 换机或清浏览器数据前,用 导出整理备份… 保存 JSON,在新环境 恢复整理备份… 合并(活跃、等待与新更新的会话不会被旧备份隐藏)。
适用场景与注意¶
适合:在 DSH Desktop 或 dsh web 上同时维护多条智能体会话,希望区分「还在跑 / 等我 / 已处理」、并偶尔回到原生侧栏的用户。
与其他插件:标准 sidebar.panellist 工具仍出现在顶部网格;模型、工具、MCP、skills 等配置仍在 DSH 本体。README 在 macOS DSH 0.2.1-rc.5 上验证过与 Context、图像生成、tide badge、任务板等共存。若另一插件也替换 sidebar、sidebar.workspaces 或 uiWorkspace 服务,则互斥,只应启用一个替换件。仅注册在 sidebar.workspaces.session.row.action 的行内按钮扩展,在工作台中仍可通过 原布局 使用。
安全与权限:插件以当前 DSH 进程的权限运行,安装前请自行查看 GitHub 源码 与 MIT 许可证,确认符合你的环境与合规要求。社区目录页 skillhub.cn 为独立生态站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-session-inbox 把 DSH 侧边栏收成「上方待处理、底部 Working、可逆 Settle、一键原布局」的工作台,并保留原生会话菜单与快捷键。需要细节与截图见仓库 README;安装与索引 URL 以 README 为准。
- 目录页:https://www.skillhub.cn/plugins/Tracest/dsh-session-inbox
- GitHub:https://github.com/Tracest/dsh-session-inbox