jarvisluk/dsh-projectless-session

dsh-projectless-session

English

一个 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 源代码。其 UI 遵循 DSH 的语言设置，并包含完整的英文和简体中文字典。

工作原理

DSH 0.1.5-rc.2 会在 Session 没有注册 Workspace 时禁用其原生空白会话编辑器。为了保留完整的原生编辑器——包括 agent 预设、命令和附件、访问模式、模型选择以及发送按钮——该插件使用以下生命周期：

1. Host 通过仅限回环的 DSH Connection RPC 创建一个目录。
2. 客户端将该目录注册为临时 Workspace。
3. DSH 在临时 Workspace 中创建并打开一个 Session，因此标准的空白会话 UI 仍然完全可用。
4. 在 DSH 接受第一个提示并报告 blank === false 后，插件仅删除 Workspace 注册。
5. DSH 保留 Session、日志、cwd 和目录；对话会移动到内置的 Ungrouped（未分组）部分，并且仍然可以恢复。
6. 如果空白 Session 未被使用——用户切换到别处、DSH 退出，或启动时发现之前的遗留项——插件会取消注册 Workspace、归档未使用的 Session，并删除空目录。

Ungrouped 下保留的 Session

在第一个提示之后删除注册不会删除工作目录或 Session 历史记录。未使用的空目录只有在仍然符合插件的日期/会话形态且不包含用户文件时才会被删除。Finder 元数据（如 .DS_Store）不会保留该目录。

兼容性

- DeepSeek Harness 0.1.5-rc.2
- Node.js 22.19 或更高版本
- 本地 Web/Desktop 配置文件

安装

从 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

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

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

行为

- 保留所有现有的 Workspace 条目以及 DSH 原生的 Add workspace…（添加工作区…）操作。
- 当无项目空白会话打开时，选择器中的勾选标记位于 Session without workspace 上，并且临时目录会从项目列表中隐藏。
- 创建一个带有抗冲突后缀的隔离工作目录。
- 在首条提示词之前，使用 DSH 完整的原生新会话界面。
- 使用当前 DSH 默认的 Agent 预设、模型和权限预设；
原生选择器可以在发送前更改它们。
- 在首条提示词之后，仅移除临时的 Workspace 注册。
- 如果未发送提示词，则注销未使用的空白无项目 Workspace。
- 使 Session 在 DSH 重启后仍可在未分组下恢复。
- 通过 DSH 的 Language 设置，在英文和简体中文之间实时切换插件文案。
- 使用 DSH 已认证的 Connection 通道进行文件系统 RPC 调用，并在插件卸载时
干净地注销该通道。
- 移除插件后，自动恢复 DSH 内置的优先级为 0 的 Workspace 选择器。

自定义根目录

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

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

开发

npm ci
npm run verify
npm pack

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

简体中文

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

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

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

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

工作方式

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

1. Host 通过仅允许 loopback 调用的 DSH Connection RPC 创建目录。
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.1.5-rc.2
- Node.js 22.19 或更高版本
- 本机 Web/Desktop profile

安装

从 GitHub 安装：

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

从
最新 GitHub Release
下载预构建压缩包后安装：

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

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

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

行为

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

自定义根目录

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

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

开发

npm ci
npm run verify
npm pack

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

License

MIT