DahliaVoid/dsh-temp-session

dsh-temp-session

DeepSeek Harness Web (dsh) 插件：工作区可选化 + 免工作区临时会话。

- 未选定工作区时，Hero 工作区入口显示 「选择工作区（可选）」（点击行为与原选择菜单完全一致）；
- 已选定工作区时，入口内下拉箭头原位变成 ×：鼠标悬停到大按钮上时箭头自动变 ×，点击 × 取消工作区选择（回到未选定状态）；点击按钮其他区域仍是正常打开工作区选择；
- 未选择工作区的会话 = 临时会话：独占一个独立目录 $DSH_HOME/tmp-sessions/session-（默认即 ~/.dsh/tmp-sessions/…），会话的 cwd、沙盒写边界、侧边栏归组（Ungrouped）全部自动以该目录为准，与 dsh 安装目录及彼此之间相互独立；
- 侧边栏通用 「新建会话」 按钮（未指定工作区时）默认直接创建临时会话；工作区行内的 + 仍创建该工作区的会话（原行为不变）。

来源与依赖

- 宿主半区：lib/index.js —— 注册 POST /api/dsh-temp-session/reserve（预留独立目录）、启动清理、临时会话语义提示注入、内核客户端补丁安装器。零 @deepseek-ai/ 运行依赖。
- 浏览器半区：lib/client.js —— 纯 DOM/状态对账 + store 订阅，无构建步骤、无第三方 import。
- 适配对象：dsh 0.1.2-rc.x 的 web profile（基于对 dsh-client-ui-conversation 的 WorkspaceChip / 插槽结构的代码级校验）；
详见下方「行为细节」的内核适配说明。

内核客户端补丁（可选工作区的关键）

dsh 在 workspaces.phase === "ready" 时会把"无工作区会话"的 chipTitle 置空，
进而使组合输入框整体失效（必须选工作区）。该逻辑是 React 闭包状态，插件层面
无法覆盖，因此本插件在每次启动时对安装的内核文件
@deepseek-ai/dsh-client-ui-conversation/lib/client.js 做一行幂等替换
（去掉 workspaces.phase === "ready" 这一条件），让无工作区会话也能获得 cwd
标签 → 输入框可输入、可发送。

- 首次修补前自动备份为 client.js.dsh-temp-session.bak；已修补则跳过；
- 补丁带标记 / dsh-temp-session /，可随时检查（Select-String -SimpleMatch）；
- 恢复原状：把 .bak 复制回 client.js（或升级 dsh 内核后重新安装本插件）；
- 若内核升级改动了目标代码，插件启动日志会输出 "conversation bundle drifted"，
此时需更新插件版本以匹配新内核。

安装

方式一：

dsh plugin --profile web add dsh-temp-session
:: 或 GitHub 安装：
dsh plugin --profile web add github:DahliaVoid/dsh-temp-session

dsh plugin add 会把包写入 ~/.dsh/profiles/web/package.json 的依赖与 dsh.profile.bundles，无需手改。

方式二（本机开发安装，用 link: 指向源码目录）：

dsh plugin --profile web add link:PATH_TO_DSH_TEMP_SESSION

注意：dsh plugin 内部经 cmd shell 拼接参数，路径含空格时会被截断（例如用户名含空格时）。
此时改为直接调 pnpm（在 ~/.dsh/profiles/web 下执行）：
pnpm add "link:PATH_TO_DSH_TEMP_SESSION"
然后再手动把 dsh-temp-session 追加进 dsh.profile.bundles。

方式三（手动）：编辑 ~/.dsh/profiles/web/package.json：

{
"dependencies": {
"dsh-temp-session": "^0.1.0"          // 已发布：用版本；未发布：用 link: 指向本地源码目录
},
"dsh": {
"profile": {
"bundles": [ / 追加 */ "dsh-temp-session" ]
}
}
}

随后在 profile 目录（~/.dsh/profiles/web）执行 pnpm install（或直接由 desktop 的插件面板管理）。

生效方式：修改 profile 后需重启 Harness 进程（桌面版：退出并重新打开 App；内置 Web 界面会随内核重启加载新 bundle 行）。

目录约定

| 项目 | 值 |
|---|---|
| 临时会话根目录 | ~/.dsh/tmp-sessions/（行配置 tempRoot 可改） |
| 单个会话目录 | /session- |
| 临时会话日志 | 仍写入 ~/.dsh/sessions/（与普通会话一致） |

行为细节与已知边界

- 沙盒：临时会话的 workspace-write 写边界 = 该会话自己的临时目录（会话创建后 header.cwd 即为此目录，dsh-sandbox-policy 据此解析）。dsh 沙盒对读取不设限（设计如此），因此"不读取 dsh 主目录"由 cwd/上下文提示软性引导实现；如需硬性读隔离，需要上游扩展新的沙盒模式。
- 重启物化：workspace 注册表会按会话 cwd 把目录物化为一条 Workspace 记录；本插件在每次启动时自动注销 tmp-sessions/ 下目录的这类记录，使临时会话始终以 Ungrouped 出现（会话与日志不受影响）。
- 空白临时会话：未发送任何消息的临时会话不产生日志，重启后自然消失（符合"临时"语义）。
- 自动预建：启动期仅当“无当前会话、无最近工作区可自动连接”时才自动预建临时空白会话；有工作区时仍保留上游“自动恢复最近会话”的行为，通过 × 到达未选定状态。运行期中（删除/归档当前会话导致 current 归零）则始终自动补建——上游的初始选择是一次性启动策略，此后不会再行动，不补位的话 hero 输入框会因“无当前会话”被内核判为 inert（显示“选择一个工作区开始”且无法输入）。
- 内核适配（0.1.2-rc.x）：workspaces 快照改为 { items, archivedSessionIds, state, phase, error }（0.1.1-rc.x 的 baselinesReady/recentWorkspaceId 已移除），“新建会话”无参入口也从 workspaces.startSession 迁至 uiWorkspace.startSession。0.1.2 起插件：
- autoEnsure 就绪守卫改用 phase === "ready"，最近工作区按上游同款算法（items + 会话列表 byId 的 updatedAt 最大值）实时复算；
- 拦截 uiWorkspace.startSession() 的无参调用（工作区行的 + 与显式选工作区仍走原路径），旧 workspaces.startSession 补丁保留以兼容早期内核；
- reconcile 在“已选定工作区”分支把芯片标签断言回工作区标题——修复清空全部工作区后首次创建会话时标签残留下“选择工作区（可选）”的问题（该时序下 reconcile 可能先于工作区归属的快照事件写入可选文案，而 React 对标签节点不再重渲染，只能由插件自身修回）。
- 临时会话身份校验（0.1.3）：桌面外壳 / 第三方插件也可能创建“空白 + 无工作区”的会话
（例如按项目目录预建的空会话，cwd 是真实项目目录）。0.1.3 起复用/识别临时会话时增加
硬校验：cwd 末段必须等于会话 id 且 id 形如 session-（本插件创建的临时会话
永远是 /session-），不再把外来空白会话误当临时会话复用
（此前会表现为“临时对话跑进了 ~/.dsh/profiles/web 等外部目录”）。
- 遗留空白会话：从工作区 × 切换后，原空白会话会被保留（隐藏但可复用，之后再次选择该工作区时会被复用），不会重复堆积。

卸载

dsh plugin --profile web remove dsh-temp-session

或从 ~/.dsh/profiles/web/package.json 删除依赖与 bundles 条目，然后重启 Harness。