EIGHTfs/dsh-session-group

README 摘要

dsh-session-group DSH 会话分组（Workspace）管理插件： 创建分组（.dsh/Group 软链接方案）、重命名/删除分组引用、在分组下新建会话（工作移交）、禁止手动新建 。设置页一键操作。 机制依据：源码 + 实测三重印证（见下文「DSH 机制事实」）。分组 = 采纳一个目录路径（ workspace.create ）， 项目本体不移动 。 功能 - 📁 创建分组 ：给分组名 → 自动建 .dsh/Group/ 软链接 → workspace/ 并采纳为分组；项目实际写在 workspace，不污染 .dsh - 🏷️ 重命名 / 删除 ：改分组显示名；删除只移除分组引用（目录与会话保留） - ✨ 在分组下新建会话（工作移交） ：转发公开 RPC session.create {workspaceId} → cwd 自动取分组 path（=workspace 项目目录）→ 自动归属；支持 handoff 参数把交接说明作为新会话首条消息发出 - 🔄 移动会话 = 归档原会话 + 分组下新建会话 （2026-08-18 用户约定）：DSH 机制不允许已有会话跨 cwd 移动，正确语义是把工作移交给分组新会话，原会话用 dsh-session-manager 归档（可还原） - 🚫 禁止在分组下直接新建会话 （ blockGroupNewSession ，默认 true ）：服务端拒绝 + 前端隐藏官方分组行的「+」按钮 - 🧭 入口在设置 ：设置 → 插件配置 → 「会话分组」卡片 安装 测试实例（隔离）部署：源码放 node modules local/ + file: 依赖 + patch insert + 软链（见 dsh-test-env skill），重启测试实例。 使用（设置 → 插件配置 → 会话分组） - 创建分组 ：输入分组名（在配置的 groupRoot 下建目录）或绝对路径 → 创建 - 分组列表 ：显示 标题/path/会话数；可 重命名 / 删除 - 移动会话 ：填会话 ID + 选目标分组 → 移动（cwd 匹配才成功） - 分组下新建会话 ：选分组 → 新建（自动归属该分组；可填交接说明 handoff，作为新会话首条消息） - 禁止开关 ：默认开启，勾选后隐藏侧边栏所有分组行的「+ 新建会话」按钮，并拒绝服务端请求 - 移动会话 ：DSH 机制限制下"移动" = 归档原会话（dsh-session-manager）+ 在分组下新建会话（工作移交） API 方法 路径 说明 GET /api/session-group/status 状态（分组数/groupRoot/workspaceRoot/profile/block） GET /api/session-group/list 全部分组（含 …

分类