前言¶
DSH 的会话默认和项目工作区绑定。遇到临时问答或小任务时，为了不污染当前工作区，通常要先新建一个目录、切换过去再开始；如果同时处理几个不相干的任务，目录管理会更麻烦。
zsqbfan/dsh-chat-sessions 做的是这件事：一键新建自带独立工作区的会话，让日常问答和小型任务无需手动选择项目目录即可开始，各个会话产生的文件互不影响。外观与交互贴近 DSH 原生侧栏，沿用现有的会话操作习惯。
它由 zsqbfan 个人维护，分类为客户端，是社区目录收录的第三方插件，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
一句话定位：一个 DeepSeek Harness 插件，为主界面新增“自带独立工作区”的会话，并把新建、切换、归档等操作接入原生侧栏。
它解决的是多任务并行时“先准备目录、再开工”的负担。新房间有独立的工作区和目录，标题链接提供文件入口，不需要先手动选择项目目录。派生或后续会话可能共享该目录。
宿主要求：DeepSeek Harness >=0.2.0-rc.2 <0.3.0-0，开发与测试基线为 0.2.2-rc.1。许可证为 MIT。当前版本 v0.1.1。
核心功能¶
- 一键开始，工作区独立。一键新建带独立工作区的对话，各自存放任务产生的文件，不同任务互不混杂，无需先手动选择项目目录。
- 现有的会话操作习惯。交互方式与原版 DSH 保持一致，切换、置顶、归档与恢复等操作沿用熟悉的方式，上手无需重新适应。
- 文件管理，方便查找。按会话标题整理文件入口，方便找到某次对话中产生的文件，随时查看、编辑或继续使用。
需要明确的一点：独立目录不等于系统沙箱。房间位于 <root>/.sessions/，标题链接只是文件入口。插件不会在系统层面隔离进程或权限。
安装与启用¶
下面是 README 给出的官方安装步骤，命令与路径照原文记录：
1. 从 Release 下载 dsh-chat-sessions-0.1.1.tgz（另附 SHA256 校验文件）。
2. 在 DSH「插件 → 添加插件」中填写下载文件的绝对路径，安装并启用；按宿主提示重新加载或重启。
当前 Release 为 v0.1.1。main 分支用于后续开发，需要固定版本时使用对应 Release 的安装包，不要直接跟踪 main。
典型用法¶
- 在侧栏新建会话，直接得到一个带独立工作区的房间，无需先选目录。
- 在该房间中正常提问、生成文件；文件落在房间自己的工作区，不进入其他会话的目录。
- 用原生会话菜单归档该房间；需要恢复时从原生归档列表找回。归档会取消置顶，恢复后可重新置顶。
- 通过标题链接作为文件入口，查看、编辑或继续使用该会话产生的文件。
后台约每 15 秒同步一次标题链接和工作区归属；未发送的草稿保存在浏览器中。
适用场景与注意事项¶
适合相信把 DSH 用于并行小任务、希望每个任务有独立目录的开发者，以及不想为临时任务反复切换项目工作区的人。
安装前请注意，插件以当前 DSH 进程的权限运行，能读写该进程可访问的目录；启用前先检查源码与 MIT 许可证，确认来源后再使用。它通过插件页面向宿主注入原生会话与工作区相关模块，DSH 大版本更新后可能需要适配；目前主要在 macOS 的 0.2.2-rc.1 环境验证，其他平台与版本尚待验证。
使用中需要注意的几点：
- 升级时保留原有
root配置。更改存放位置不会自动迁移旧数据；旧版已归档的会话可从原生归档列表手动恢复。 - 启动或重新启用插件时，只回收已经归档、且没有未归档会话共享的自有空目录（允许仅有
.DS_Store），保留归档状态和会话日志；非空目录保留。 - 停用、卸载走 DSH 插件页面操作。停用后可能显露底层工作区，房间、日志和已有工作区保留；本版没有自动停用回收，也没有多会话房间退出管理功能。备份时同时保留房间文件和 DSH 的会话、工作区及归档记录。
- 旧配置项
idleMs已停用，保留旧配置也不会生效。
v0.1.1 修复了空白对话等待约 90 秒后被自动归档、编辑器退回工作区选择的问题。
小结¶
这个插件把“会话先绑工作区”改成一键开始，适合在 DSH 里并行处理多个小任务、又不想互相干扰的场景。它依赖原生侧栏结构，属于个人维护项目，遇到问题建议附上 DSH 版本、系统和复现步骤到 GitHub Issues。
目录页：https://www.skillhub.cn/plugins/ZSQBFan/dsh-chat-sessions
GitHub：https://github.com/ZSQBFan/dsh-chat-sessions
