前言¶
DeepSeek Harness (DSH) 在处理文件工具和 shell 命令时，通常需要一个明确的项目目录。对于临时对话、单次任务或不需要复杂上下文的场景，每次创建会话都强制选择项目会带来额外的操作负担。
dsh-auto-workspace 插件接管了 DSH 的默认回退逻辑。它允许用户创建“无项目”会话，并为这些会话自动分配一个独立的本地工作目录。文件工具和 shell 命令将在这个目录中运行，且恢复会话时，上下文会保持在该位置。
核心功能¶
- 独立工作目录：为无项目的聊天创建独立的本地工作目录。
- 上下文隔离：在该目录中运行文件工具和 shell 命令。
- 持久化：恢复会话时保持在该位置工作，文件得以保留。
- 侧边栏清爽：不会向侧边栏的项目列表添加任何内容。
- 逻辑重写：重写默认回退逻辑，提供“不选择项目”的选项。
- 自动分组：将会话保存在 DSH 原生的 “Ungrouped” 组中。
- 徽章交互：提供清除徽章功能，允许用户离开当前项目。
安装与启用¶
该插件是一个 DSH Bundle，通过配置文件注入。
Web 应用：
在终端执行以下命令安装：
dsh plugin --profile web add github:Castor6/dsh-auto-workspace
桌面应用：
桌面应用不支持命令行安装。请打开左侧导航栏的 Plugins，输入 github:Castor6/dsh-auto-workspace 或仓库 URL https://github.com/Castor6/dsh-auto-workspace 进行安装。
典型用法¶
- 创建会话：点击 “new session” 且不选择任何项目，直接开始输入。
- 离开项目：在悬停空白聊天界面的项目 chip 时，文件夹图标会变为圆形的清除徽章，点击即可离开该项目。
- 启动方式：在项目列表中选择 “Work without a project” 选项。
配置说明¶
在配置文件中（~/.dsh/profiles/<profile>/cordis.patch.yml），通过插件的 loader 行设置参数：
- id: auto-workspace
config:
root: '/Volumes/Work/DSH' # 默认：<home>/Documents/DSH
directoryPrefix: 'chat' # 默认：chat → chat-01, chat-02, ...
enabled: true # 默认：true
配置说明：
* root：指定工作目录的根路径。
* directoryPrefix：指定子目录的命名前缀。
* enabled：是否启用该插件。
注意事项¶
- 依赖要求：插件依赖
@deepseek-ai/cordis(~4.0.4)。 - 目录结构：聊天目录默认位于
~/Documents/DSH/<YYYY-MM-DD>/chat-NN/（Windows 下为%USERPROFILE%\Documents\DSH）。 - 清理机制：插件不会删除任何文件或目录。只有在会话创建失败且尚未写入任何内容时，目录才会被回收。
- 安装方式：Web 应用支持 CLI 安装；Desktop app 仅支持 GUI 安装。
