无工作区会话 jarvisluk/dsh-projectless-session

dsh-projectless-session

一个 DeepSeek Harness Web/Desktop 插件，在现有 Workspace 选择器里加入 Session without workspace。每个会话都有自己的工作目录，按日期归档：

~/Documents/DSH/YYYY-MM-DD/session-HH-mm-ss-random/

Workspace 选择器里的 Session without workspace

插件使用 DSH 的 Cordis Host/Client 扩展 API，不改动 DeepSeek Harness 源码。界面跟随 DSH 的 Language 设置，内置完整的英文和简体中文字典。

工作原理

DSH 0.2.x 在会话没有注册 Workspace 时，会禁用原生的空白会话编辑器。为了保留完整的原生编辑器——包括智能体预设、命令与附件、访问模式、模型选择和发送按钮——插件采用下面的生命周期：

1. Host 通过共享 /api 通道上已认证的 DSH Connection 端点创建目录。
2. 客户端把该目录注册为临时 Workspace。
3. DSH 在临时 Workspace 里创建并打开会话，标准空白会话界面因此完全可用。
4. DSH 接受第一条提示词并报告 blank === false 后，插件只删除 Workspace 注册。
5. DSH 保留会话、日志、cwd 和目录；对话移到内置的 Ungrouped 分区，仍可继续。
6. 如果空白会话一直没用——用户切走、DSH 退出，或启动时发现上次遗留——插件会注销 Workspace、归档未使用的会话，并删除空目录。

保留在 Ungrouped 下的会话

第一条提示词之后删除注册，不会删除工作目录或会话历史。空目录只有在仍符合插件的日期/会话命名格式、且不含用户文件时才会被删除。.DS_Store 这类 Finder 元数据不会让目录保留下来。

兼容性

- DeepSeek Harness 0.2.0-rc.2 到 0.2.x（已在 0.2.1-rc.2 上测试）
- Node.js 22.19 或更高版本
- 本地 Web/Desktop 配置档

安装

从 npm 安装（推荐）：

dsh plugin --profile web add dsh-projectless-session

从 GitHub 源码安装：

dsh plugin --profile web add github:jarvisluk/dsh-projectless-session

离线安装：从 最新 GitHub Release 下载预构建的 tarball，然后安装这个本地文件：

dsh plugin --profile web add /absolute/path/to/dsh-projectless-session.tgz

不要把 https://github.com/…/releases/latest/download/dsh-projectless-session.tgz 这样的 release 资源 URL 直接交给 pnpm。
这个地址会变，而 pnpm 11（DSH Desktop 配置档使用 nodeLinker: hoisted）按 URL 缓存。缓存命中时 pnpm 会写入解析时没有 integrity 字段，会以 ERR_PNPM_MISSING_TARBALL_INTEGRITY 中止，甚至可能解析到过期版本。
npm 包、github: 快捷方式、下载到本地的文件，三者都锁定不可变产物。

安装完成后，重启正在运行的 dsh web 进程。卸载：

dsh plugin --profile web remove dsh-projectless-session

行为

- 保留每个已有的 Workspace 条目，也保留 DSH 原生的 Add workspace… 操作。
- 打开无项目的空白会话时，选择器勾选停在 Session without workspace，项目列表里隐藏临时目录。
- 创建隔离的工作目录，后缀带防冲突标识。
- 首条提示词之前，使用 DSH 完整的原生新建会话界面。
- 使用当前 DSH 默认的智能体预设、模型和权限预设；发送前可用原生选择器修改。
- 首条提示词之后，只删除临时 Workspace 注册。
- 没有发送提示词时，注销未使用的空白无项目 Workspace。
- DSH 重启后，会话仍可在 Ungrouped 下恢复。
- 插件文案跟随 DSH Language 设置，在英文和简体中文之间实时切换。
- 文件系统调用走 DSH 已认证的 /api Connection 通道；插件卸载时干净移除其路由。
- Add workspace… 仍走 DSH 组合的目录流程（原生选择器或应用内浏览器），插件把它镜像到选择器自己的槽位。
- 移除插件后，自动恢复 DSH 内置优先级为 0 的 Workspace 选择器。

自定义根目录

在 Web 配置档的 cordis.patch.yml 中覆盖插件配置：

- id: dsh-projectless-session
config:
root: /absolute/path/to/DSH

开发

npm ci
npm run verify
npm pack

测试覆盖：双语词典、目录安全约束、本地日期层级、临时 Workspace 生命周期、选择器选中状态重映射、首条提示词被接受后的清理、未使用空白 Workspace 的废弃处理，以及会话创建失败时的回滚。

这是一个 DeepSeek Harness Web/Desktop 插件，在现有工作区选择器中加入 无工作区会话。每个会话都会获得一个按日期整理的独立工作目录：

~/Documents/DSH/YYYY-MM-DD/session-HH-mm-ss-random/

工作区选择器中的无工作区会话

插件使用 DSH 的 Cordis Host/Client 扩展接口，不修改 DeepSeek Harness 源码。界面文案跟随 DSH Language 设置，完整支持英文和简体中文。

工作方式

在 DSH 0.2.x 中，没有已注册 Workspace 的空白 Session 会禁用原生编辑器。为了完整保留 Agent 预设、命令与附件、访问模式、模型选择和发送按钮，插件采用以下生命周期：

1. Host 通过共享 /api 通道上已认证的 DSH Connection 接口创建目录。
2. 客户端把该目录注册为临时 Workspace。
3. DSH 在临时 Workspace 中创建并打开 Session，因此空白会话继续使用完整的原生界面。
4. DSH 接受首条消息并报告 blank === false 后，插件只删除 Workspace 注册。
5. DSH 保留 Session、日志、cwd 和目录；会话进入内置的未分组区域，之后仍可恢复和继续。
6. 如果空白 Session 没有被使用——用户切走、DSH 退出，或启动时发现上次残留——插件会注销 Workspace、归档未使用的 Session，并删除空目录。

保留在未分组区域的会话首条消息后删除 Workspace 注册，不会删除工作目录或会话历史。只有仍符合插件日期/会话目录形态、并且里面没有用户文件的空目录才会被删除。.DS_Store 这类系统元数据不会阻止删除。

兼容性

- DeepSeek Harness 0.2.0-rc.2 至 0.2.x（已用 0.2.1-rc.2 验证）
- Node.js 22.19 或更高版本
- 本机 Web/Desktop 配置档

安装

从 npm 安装（推荐）：

dsh plugin --profile web add dsh-projectless-session

从 GitHub 源码安装：

dsh plugin --profile web add github:jarvisluk/dsh-projectless-session

离线安装：从 最新 GitHub Release 下载预构建压缩包到本地后再安装：

dsh plugin --profile web add /下载目录/dsh-projectless-session.tgz

不要把 Release 资产地址直接交给 pnpm，例如 https://github.com/…/releases/latest/download/dsh-projectless-session.tgz。
这个地址是可变的，而 pnpm 11（DSH Desktop 配置档使用 nodeLinker: hoisted）按 URL 缓存它：命中缓存时写出的解析结果没有 integrity 字段，安装会以 ERR_PNPM_MISSING_TARBALL_INTEGRITY 失败，甚至可能解析到过期版本。npm 包、github: 简写和下载到本地的文件都指向不可变产物，请使用其中之一。

安装后重启正在运行的 dsh web。卸载：

dsh plugin --profile web remove dsh-projectless-session

行为

- 保留已有 Workspace 和 DSH 原生的添加工作区…入口。
- 无工作区空白会话打开时，选择器的选中标记落在无工作区会话上，并隐藏临时目录，避免它出现在项目列表里。
- 创建带防冲突随机后缀的独立工作目录。
- 首条消息前完整复用 DSH 原生新会话界面。
- 使用 DSH 当前默认的 Agent 预设、模型和权限；发送前可以通过原生控件修改。
- 首条消息接受后只删除临时 Workspace 注册。
- 若未发送消息，会注销仍空白的无工作区 Workspace。
- 会话进入未分组，重启 DSH 后仍可恢复并继续。
- 跟随 DSH Language 设置即时切换英文或简体中文。
- 文件系统调用使用 DSH 已认证的 /api Connection 通道，并在插件卸载时干净移除路由。
- 添加工作区… 继续使用 DSH 组合的目录选择流程（原生选择器或应用内浏览器），插件会把它镜像到自身选择器的插槽中。
- 卸载插件后，DSH 内置优先级 0 的 Workspace 选择器自动恢复。

自定义根目录

在 Web 配置档的 cordis.patch.yml 中覆盖插件配置：

- id: dsh-projectless-session
config:
root: /absolute/path/to/DSH

开发

npm ci
npm run verify
npm pack

测试覆盖双语词典、目录安全约束、本地日期层级、临时 Workspace 生命周期、选择器选中态映射、首条消息后的注销、未使用空白 Workspace 的回收，以及会话创建失败时的回滚。

License

MIT