READMESource: main@d601608c

功能
- 视图:
分组 / 项目两个页签——分组是自定义归类,项目按宿主 Workspaces 分节;右上切换「最近更新 / 手动排序」(仅本浏览器);搜索图标展开输入框,按会话标题或工作区名过滤(不区分大小写),过滤时自动展开、隐藏无匹配组,Esc 或 ✕ 清空。 - 折叠侧栏:和内置一致,只剩「添加工作区」「搜索」两个图标;点搜索会展开侧栏并直接进入搜索态。
- 会话行:左键打开;行首状态槽显示进行中 / 等待交互 / 未读,置顶会话排最前;hover 时行尾时间原位换成归档按钮(不占位、标题不位移);标题溢出时 hover 横向滚动并在两侧渐隐,移开复位。
- 分组:彩色图标徽章(8 色 × 31 图标,可搜索;默认
#)、折叠、会话数、⊕新建会话;空组是虚线落点;组头可拖拽调整分组顺序。 - 未分组:没有可见会话时整节隐藏,拖拽会话时临时出现,作为「移出分组」的落点。
- 项目:每个工作区一节,空项目只显示「新建会话」。
- 新建会话:分组内先弹工作区选择(按最近会话倒序),项目内直接在该工作区创建。
- 右键:会话行 → 移动到分组(二级菜单:分组列表 + 新建分组并移入)/ 移出分组 / 重命名 / 分叉 / 归档;组头 → 重命名 / 更换徽章 / 上移 / 下移 / 删除;项目头 → 新建会话 / 重命名工作区 / 删除工作区。
- 拖拽:跨组归组并按落点插入、同组排序、拖到「未分组」移出、拖到空组归组;组头调序;项目页签仅同项目内排序。
- 归档:侧栏始终不显示,取消归档走内置归档入口(命令面板 / 会话内操作)。
安装
环境:DSH Web(本插件只提供浏览器端,dsh.client.platform = "web")。不需要 Node 依赖,也没有构建步骤。
方式一:Web「插件」页(推荐)
侧栏打开「插件」(Plugins)页,点「添加插件」(Add plugin)。
包名输入框接受 npm 包名 / Git 地址 / tarball / 本地目录绝对路径。填:
https://github.com/llklkl/dsh-workspace-groups想改代码即时生效的话,先 clone 再把本地仓库的绝对路径填进去(等价于
link:安装)。安装完成点「立即启用」(Enable now),侧栏立刻变成分组视图;若 profile 未启用 HMR,重启
dsh web后生效。
方式二:CLI
git clone https://github.com/llklkl/dsh-workspace-groups.git ~/src/dsh-workspace-groups
dsh plugin --profile web add link:$HOME/src/dsh-workspace-groups
锁定版本(tag):
dsh plugin --profile web add "github:llklkl/dsh-workspace-groups#v3.2.0"
dsh plugin 只装依赖、不选层;装完到「插件」页启用(或往 profile package.json 的 dsh.profile.bundles 数组追加 @local/dsh-workspace-groups,再重启)。profile 名默认 web,按你实际使用的 profile 替换。
方式三:会话里用工具装(可选)
在能调用 plugin_manager 的会话里:
plugin_manager install_bundle target: "link:/abs/path/dsh-workspace-groups"
Git 地址同理;install_bundle 会顺手启用。
生效、升级与卸载
| 场景 | 做法 |
|---|---|
本地 link: 安装 |
改仓库代码 → 刷新页面即生效,不用重装 |
| Git 安装升级 | 卸载后重装,或在 clone 目录 git pull 后刷新 |
| 禁用 / 卸载 | 「插件」页关掉开关或移除 → 侧栏立刻恢复内置工作区列表;分组数据留在 localStorage,重新启用即恢复 |
许可
MIT © 2026 llklkl
No comments yet. Be the first to write one.