docs: 更新项目介绍与特性总览(完整的分组管理工具)

- 定位从三层树插件升级为完整工作区分组管理工具
- 特性按能力重组:三层树浏览 / 分组管理生命周期 / 拖拽归类与排序 /
  搜索与操作 / 持久化与零侵入
- 覆盖 v0.1~v0.4 全部能力(建组/重命名/删除、拖拽移入移出、项目与分组
  双向排序、插入位置指示线、未分类置底、树形搜索、overlay 持久化、零侵入)
This commit is contained in:
zcol 2026-08-22 01:22:09 +03:00
parent e08c4ed1e8
commit 26c816ea58
1 changed files with 42 additions and 26 deletions

View File

@ -3,40 +3,56 @@
![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)
![DSH](https://img.shields.io/badge/DSH-0.1.1--rc.2-purple.svg)
> **DeepSeek Harness(DSH)Web 客户端插件**:把 GUI 侧边栏的工作区列表从两层
> 「项目 → 会话」变成三层 **「分类文件夹 → 项目文件夹 → 会话」**。
> **DeepSeek Harness(DSH)Web 客户端插件:完整的工作区分组管理工具。**
> 把 GUI 侧边栏的工作区列表从两层「项目 → 会话」升级为三层
> **「分类文件夹 → 项目文件夹 → 会话」**,并围绕它提供完整的分组管理能力——
> 手动建组、重命名/删除分组、拖拽归类、项目与分组的自由排序、规则自动归类、
> 树形搜索。所有操作**即时生效并持久化**,对官方数据**零侵入**。
典型场景:多个 DSH 插件项目(SkillsManagePlugins / Documentation-Driven AI Coding /
DeepSeek峰谷小组件 等)归入一个「DSH 插件」分类文件夹,点开是各项目,再点开是各自会话。
DeepSeek峰谷小组件 等)归入一个「DSH 插件」分类文件夹,点开是各项目,再点开是各自会话;
临时项目随手建个「临时」分组拖进去,用完删除分组即全部回到「未分类」。
## 截图
![dsh-workspace-groups 侧边栏三层树](screenshot.png)
![dsh-workspace-groups 工作区分组管理](screenshot.png)
## 特性
- **三层侧边栏**:分类文件夹(可折叠)→ 项目文件夹(可折叠)→ 会话行
- **sidecar 配置**:分类规则写在 `~/.dsh/workspace-groups.yaml`,改配置即可增删分类 /
调整归类,无需改代码、无需重启(刷新页面生效)
- **树形搜索**:搜索命中后仍保留三层树结构(分类 → 项目 → 命中会话),命中行高亮并
显示内容摘要,而不是扁平的结果列表
- **手动分组管理(所有分组)**:侧边栏区头「新建分组」按钮即建即显(空分组也渲染);
**每个分组行**(含规则分类)悬停出现 `⋯` 菜单 → 重命名 / 删除。删除分组后,
组内所有项目回到「未分类」;规则分类的重命名/删除经 overlay 生效(`renamed`/
`hidden`),规则 YAML 原样保留
- **拖拽归类 + 排序**:拖动项目文件夹到任意分组行 / 分组内项目行 = 移入该组
(拖到某项目行上半 = 插到它前面、下半 = 插到它后面,即**组内位置排序**,
拖动时实时显示 2px **插入位置指示线**,落点所见即所得);拖动时
**其他分组的项目自动收起**,源分组保留以便排序;拖到「未分类」或菜单
「移到未分类」= 强制归入未分类
- **分组拖拽排序**:分组行也可拖动(拖动时所有分组收起),拖到另一个分组行
上半 = 移到它前面、下半 = 移到它后面(指示线显示落点),即改变分组顺序;
**「未分类」永远在列表最底部**(分组恒在未分类项目之上)
- **零侵入**:不修改 `~/.dsh/storages/workspace.json`、不修改会话落盘结构、
不修改官方 `@deepseek-ai/dsh-client-ui-workspace` 包;手动分组/归类/排序写入独立
sidecar JSON(`~/.dsh/workspace-groups.manual.json`),规则 YAML 原样保留
- **功能不退化**:打开/新建/搜索会话、Add Workspace、项目重命名/删除、
会话重命名/派生/归档、展开状态持久化(独立 key,重启保留)
### 三层树浏览
- **分类文件夹 → 项目文件夹 → 会话行**,分类/项目均可折叠;展开状态独立持久化
(`dsh.workspace.groups.view.v1`,刷新/重启保留)
- **「未分类」兜底桶**:不匹配任何分组、被移出分组的项目自动归入,**恒在列表最底部**
### 分组管理(完整生命周期)
- **手动新建分组**:区头「新建分组」按钮即建即显,空分组也渲染
- **重命名 / 删除任意分组**:每个分组行(**含规则分类**)悬停 `⋯` 菜单;
删除分组后组内所有项目回到「未分类」;规则分类的改名/删除经 overlay 生效
(`renamed` / `hidden`),**规则 YAML 原样保留**
- **规则自动归类**:sidecar YAML 声明分类规则(`pathPrefix` / `pathExact` /
`nameContains` / `basenameContains`),改配置即可调整归类,无需改代码
### 拖拽归类 + 排序
- **拖项目进分组**:拖到任意分组行 / 分组内项目行即移入(跨组移动 = 覆盖规则归类);
拖到「未分类」或菜单「移到未分类」= **强制归入未分类**(规则匹配也无效)
- **项目组内排序**:拖到项目行上半 = 插到它前面、下半 = 插到它后面
- **分组排序**:分组行可拖动,拖到另一分组行上半 = 移到它前面、下半 = 移到它后面
- **插入位置指示线**:拖动中实时显示 2px 指示线(行上/下方),松手落点所见即所得
- **智能收起**:拖项目时其他分组的项目自动收起(源分组保留便于排序);拖分组时所有
分组收起(分组行仍可见作排序目标)
### 搜索与操作
- **树形搜索**:命中后仍保留三层树结构(分类 → 项目 → 命中会话),命中行高亮 +
内容摘要,防抖 250ms
- **工作区/会话操作不退化**:Add Workspace、项目重命名/删除、新建/打开/重命名/
派生/归档会话
### 持久化与零侵入
- 所有手动操作(分组、归类、排序、改名、隐藏)写入插件自有 overlay
(`~/.dsh/workspace-groups.manual.json`),host 校验后**原子写入**(写坏返回 400 并
保留原文件)
- **零侵入**:不修改 `~/.dsh/storages/workspace.json`、不修改会话落盘结构、不修改官方
`@deepseek-ai/dsh-client-ui-workspace` 包;规则 YAML 永不改写
- **产物自包含**:`lib/` 已构建并随仓库分发,Git 安装无需执行任何依赖脚本
## 工作原理