dsh-wander-chat
English | 中文
DSH 插件：在侧边栏「新会话」按钮正下方新增一行「新建漫游会话」，一键在不选择本地目录的情况下开启会话。
所有漫游会话统一归入一个固定的工作区分组（默认显示名「漫游会话」，目录 ~/.dsh/wander-chat），目录与分组名都可以在设置里改。
效果
- 侧边栏「新会话」下方多出一行「新建漫游会话」
- 点击后直接创建会话并跳转，不弹目录选择器
- 所有漫游会话在侧边栏归入同一个分组，而不是散成多个工作区
- 每个会话的内容仍然各自独立存放在 DSH 官方的
~/.dsh/sessions/--<目录编码>--/session-/下
安装
cd ~/.dsh/profiles/desktop
# package.json 的 dependencies 加：
# "dsh-wander-chat": "link:/path/to/dsh-wander-chat"
# dsh.profile.bundles 加：
# "dsh-wander-chat"
pnpm install
然后重启 DSH 或重载 profile。
配置
设置 → 插件 → 漫游会话
配置表单直接渲染在这个插件详情页里（描述下方、插件行上方），点进插件就能看到，不需要再找入口。
| 字段 | 默认值 | 说明 |
|---|---|---|
root |
~/.dsh/wander-chat |
漫游会话共用的工作目录，支持 ~ 前缀，不存在时自动创建 |
title |
漫游会话 |
该目录在侧边栏显示的分组名称 |
也可以直接写在 profile 的 cordis.patch.yml 里：
- id: dsh-wander-chat
config:
root: '~/.dsh/wander-chat'
title: '漫游会话'
关于配置页的实现
DSH 的 settings 服务虽然会给带 Config schema 的插件发布 autoGenerate 标志，但不会自动生成 UI —— 配置页必须由客户端半边自己注册。本插件的做法是：
- Host 半边声明 Schemastery
Config（字段与描述即上面的表格） - Client 半边注册
plugins.bundle.config（key 为包名dsh-wander-chat），表单就出现在插件详情页里 - 表单用
@deepseek-ai/dsh-client-ui-primitives的SettingsFormModel/SettingsForm/SettingsValueField，通过ctx.configForms读写 Host 配置
只有点「保存」才会写入；离开页面会丢弃未保存的修改。
只注册这一个插槽是刻意的：plugins.row.config 会让插件行再多出一个 › 配置入口，而详情页已经直接展示同一个表单，重复入口只会让人犹豫该点哪个。
工作原理
点击「新建漫游会话」
→ main 面板 wander-chat 挂载
→ GET /dsh-wander-chat Host：mkdir -p + workspaceRegistry.create(path, title)
→ ctx.workspaces.create({ path }) 客户端：幂等，把工作区同步进本地投影
→ ctx.uiWorkspace.startSession(workspaceId)
startSession(workspaceId) 就是侧边栏「新会话」按钮自己调用的那个 API，只是显式传入了工作区，所以不会弹出目录选择器。
侵入面：一个目录 + 一条 Workspace 注册 + 一条只读路由。不碰会话存储、会话格式、Agent 循环或工作区归属规则。
为什么每会话不单独用一个目录当 cwd
DSH 要求会话的 cwd 与工作区路径严格相等（@deepseek-ai/dsh-workspace 的 attachSession 会校验，启动时还会按 cwd 对账补建工作区）。如果让每个会话的 cwd 是 wander-chat/，DSH 会为每个 UUID 各建一个独立工作区，侧边栏反而散成 N 个分组。
而「每会话独立目录」这个需求，DSH 在存储层已经原生实现 —— 见上文 ~/.dsh/sessions/ 的结构。所以插件只需要一个固定工作区，其余交给 DSH。
注意
link: 方式安装的插件位于 profile 之外，Node 会按软链接的真实路径解析依赖，因此无法引用 profile 里的 @deepseek-ai/* 包。本插件为此：
~展开自行实现（只用node:os），不依赖@deepseek-ai/dsh-home-paths- 只在 Host 半边依赖
@deepseek-ai/schemastery（用于 Config schema），并把它作为本地依赖安装
开发
无构建步骤：client.js 是手写的浏览器 bundle，只注册一个惰性工厂。
客户端改动需要重建 Web 产物后刷新页面；只有 pnpm run dev:web 在跑时才能免刷新热更。
npm test # Host 半边测试（18 项，跑在临时目录里，不碰你的 home）
设计取舍与调研依据（含被否决的方案和 DSH 内部约束的源码定位）记录在 DESIGN.md。
许可
MIT
