前言¶
在 DeepSeek Harness(DSH)Web GUI 里,默认「新建会话」要先选定项目目录。试写脚本、一次性实验或不想动现有仓库时,往往要多建目录、再在列表里选一次,还容易把杂项写进正式项目。
社区插件 dsh-temporary-project(维护者 ZoeHao2026,分类:客户端)在「新建会话」行增加 「临时对话」 入口:一次点击创建独立临时目录、注册 Workspace,并打开空白 Agent 会话,无需先选文件夹。
这是什么¶
插件在 DSH 的 New Session 流程中提供 Temporary conversation / 临时对话 选项。点击后自动完成:创建临时项目目录 → 向 DSH 注册 Workspace → 创建并打开空白会话。每次点击生成独立目录,多个临时任务可并行、互不影响。
仓库为纯 JavaScript bundle,运行时无 npm 依赖;许可证 MIT。在资料记载的范围内,已在 DSH Desktop 0.2.2-rc.1 的 Web GUI 上完成安装与静态校验(具体交互需在目标桌面人工确认)。
核心功能¶
依据 README 与 package.json 声明,插件具备以下能力:
- 在 New Session hero 行(工作区选择器与 Agent preset 之后)显示「临时对话」按钮。
- 一键串联:建目录、注册 Workspace、打开空白会话。
- 中英双语文案、跟随宿主主题、键盘可达;创建过程中禁用按钮,避免重复提交。
- 失败时在页面底部显示本地化错误提示。
- 不向模型侧注册工具、提示词或会话事件,对模型请求不增加额外 token。
宿主侧通过 Connection 注册 Fetch 路由 /api/temporary-project;浏览器侧在 conversation.hero.options 注册按钮,在 shell.overlay 注册错误提示。
环境与依赖¶
- 需要 DSH 自带的 Connection、Workspace、Session 与
ui-workspace服务(与 Desktop 0.2.2-rc.1 验证环境一致)。 - 开发与校验脚本需要 Node.js 22+;日常使用插件本身不需要
npm install或构建步骤。
安装与启用¶
资料中的安装方式为:取得仓库目录后,作为 本地 bundle 装入 DSH profile。README 给出的获取仓库命令如下:
git clone https://github.com/ZoeHao2026/dsh-temporary-project.git
完成 clone 后,任选其一:
- 让 DSH Agent 执行
plugin_manager的install_bundle,target指向该仓库目录;或 - 按你当前 DSH 环境的插件管理流程,从本地目录安装 bundle。
安装后若按钮未立即出现,刷新页面一次即可。安装前建议阅读仓库源码与 MIT 许可证;插件 Host 部分以当前 DSH 进程权限创建目录并注册 Workspace,应对照权限与安全说明自行判断是否适用。
资料中未给出 dsh plugin add github:... 一类远程一键安装命令,本文不臆造安装语句。
典型用法¶
- 点击侧栏 「新建会话」。
- 在 New Session 行右侧点击 「临时对话」。
- DSH 会创建标题形如
临时项目 · <本地时间>的 Workspace,并打开其中的空白会话;发送第一条消息即可开始任务。
新会话使用 DSH 配置的默认 Agent preset 与模型;本入口暂不支持单独选择 preset。
目录位置与清理¶
临时项目落在用户 harness home 下,而非系统临时目录,避免系统清理导致长会话丢失工作目录:
$DSH_HOME/temporary-projects/project-XXXXXX # DSH_HOME 未设置时默认为 ~/.dsh
在侧栏删除该 Workspace 仅移除注册(符合 DSH workspace registry 语义:删除项目不删磁盘文件)。不再需要内容时,需在文件管理器中手动删除目录;插件不会自动清理历史临时项目。
适用场景与注意¶
适合: 快速试代码、隔离实验、一次性脚本、不想污染已有仓库的短任务。
已知限制(README 记载):
- 「临时对话」只出现在空白 New Session hero 行;按 DSH 现有实现,该行仅在存在已选中的空白 Session 时渲染,欢迎页无 Session 时可能看不到按钮。
- 每次点击都会新建目录,不做自动回收。
- 若 Host 创建成功但客户端 5 秒内未收到 Workspace 投影,会提示稍后从项目列表打开。
安全要点: 请求须通过 DSH Connection 的 Host/Origin 校验与浏览器认证,非 owner Peer 会被拒绝;调用方不能指定目录路径,根目录固定、项目名由 mkdtemp 生成;Workspace 标题会规范化并限制为 80 个 Unicode 码点。
开发与校验(可选)¶
维护者或二次开发者可在仓库根目录执行(无需先 npm install):
npm run check # 语法检查 + 清单校验 + Host 路由单元测试
npm run validate # 只校验 bundle 清单/图标/语言资源
npm test # 只跑 Host 路由单元测试
结尾¶
dsh-temporary-project 把「先选目录再开会话」收成 New Session 行上的一次点击,临时任务有独立 Workspace 与磁盘目录,又不必改动正式项目。插件以社区目录条目形式分发,与 DeepSeek / 幻方无官方商店从属关系;安装与使用前以仓库 README 与源码为准。