合并包:工作区分组(better-workspace-group)+ 远程 SSH(dsh-remote-ssh)
Go to file
zcol b382a15e11 docs: README 多语言(英文 README.md + 简体中文 README_ZH.md)+ DeepSeek Harness plugin 标
- README.md 改为英文版,README_ZH.md 简体中文版,顶部语言切换链接
- 两版均新增 DeepSeek Harness plugin shields 标(与 dsh-agent-teams 一致)
2026-08-22 01:36:33 +03:00
lib v0.4: 拖拽插入位置指示 + 上下半落点判定(修复分组向下拖逻辑) 2026-08-22 01:20:12 +03:00
scripts v0.4: 拖拽插入位置指示 + 上下半落点判定(修复分组向下拖逻辑) 2026-08-22 01:20:12 +03:00
src v0.4: 拖拽插入位置指示 + 上下半落点判定(修复分组向下拖逻辑) 2026-08-22 01:20:12 +03:00
tests v0.4: 拖拽插入位置指示 + 上下半落点判定(修复分组向下拖逻辑) 2026-08-22 01:20:12 +03:00
.gitignore v0.4: 拖拽插入位置指示 + 上下半落点判定(修复分组向下拖逻辑) 2026-08-22 01:20:12 +03:00
LICENSE chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
README.md docs: README 多语言(英文 README.md + 简体中文 README_ZH.md)+ DeepSeek Harness plugin 标 2026-08-22 01:36:33 +03:00
README_ZH.md docs: README 多语言(英文 README.md + 简体中文 README_ZH.md)+ DeepSeek Harness plugin 标 2026-08-22 01:36:33 +03:00
cordis.patch.yml chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
package.json docs: README 修复过期内容 + 截图缩小一半 2026-08-22 01:29:32 +03:00
pnpm-lock.yaml chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
screenshot.png v0.4: 拖拽插入位置指示 + 上下半落点判定(修复分组向下拖逻辑) 2026-08-22 01:20:12 +03:00
tsconfig.build.json chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
tsconfig.client.json chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
tsconfig.json chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
tsdown.config.ts chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
vitest.config.ts chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00
workspace-groups.example.yaml chore: package dsh-workspace-groups v0.1.0 for GitHub distribution 2026-08-21 23:22:57 +03:00

README.md

English · 简体中文

dsh-workspace-groups

License: MIT DSH DeepSeek Harness plugin

A DeepSeek Harness (DSH) web client plugin: a complete workspace grouping manager. Turns the GUI sidebar's two-level workspace list (Projects → Sessions) into a three-level Category folder → Project folder → Session tree, backed by full group-management capabilities: manual group creation, rename/delete of any group, drag-and-drop grouping, free ordering of projects and groups, rule-based auto-classification, and tree-shaped search. Every action takes effect immediately and persists, with zero intrusion on official data.

Typical scenario: multiple DSH plugin projects (SkillsManagePlugins / Documentation-Driven AI Coding / DeepSeek峰谷小组件, etc.) go into a "DSH 插件" category folder — open it to see each project, open a project to see its sessions. Need a scratch bucket? Create a "临时" group on the spot, drag projects in, then delete the group when done — every project returns to "未分类".

Screenshot

dsh-workspace-groups workspace grouping manager

Features

Three-level tree browsing

  • Category folder → project folder → session row, both levels collapsible; expansion state persists independently (dsh.workspace.groups.view.v1, survives refresh/restart)
  • "未分类" fallback bucket: projects matching no group or moved out of a group land here, always at the very bottom of the list

Group management (full lifecycle)

  • Create groups manually: the "新建分组" button in the section header shows the group immediately (empty groups render too)
  • Rename / delete any group: every group row (rule categories included) has a hover ⋯ menu; deleting a group sends all of its projects back to "未分类"; rule-category rename/delete rides the overlay (renamed / hidden), the rule YAML stays untouched
  • Rule-based auto-classification: the sidecar YAML declares category rules (pathPrefix / pathExact / nameContains / basenameContains); edit the config to adjust grouping without touching code

Drag-and-drop grouping + ordering

  • Drag projects into groups: drop on any group row or on a project row inside a group (cross-group move = overrides the rule classification); drop on "未分类" or use the menu "移到未分类" = forced uncategorized (rule matches are ignored)
  • Reorder projects inside a group: top half of a project row = insert before it, bottom half = insert after it
  • Reorder groups: group rows are draggable — top half of another group row = move before it, bottom half = move after it
  • Insertion position indicator: a 2px line (above/below the row) shows the exact drop point while dragging — what you see is where it lands
  • Smart collapsing: dragging a project folds the other groups' projects (the source group stays open for ordering); dragging a group folds every group (group rows stay visible as reorder targets)

Search & operations

  • Tree-shaped search: results keep the three-level structure (category → project → matched session), matched rows highlighted with a content snippet, 250ms debounce
  • No regression on workspace/session actions: Add Workspace, project rename/delete, session new/open/rename/fork/archive

Persistence & zero intrusion

  • Every manual action (groups, grouping, ordering, rename, hide) is written to the plugin's own overlay (~/.dsh/workspace-groups.manual.json), validated by the host and written atomically (a malformed write returns 400 and keeps the previous file)
  • Zero intrusion: never touches ~/.dsh/storages/workspace.json, session on-disk structures, or the official @deepseek-ai/dsh-client-ui-workspace package; the rule YAML is never rewritten
  • Self-contained artifact: lib/ is prebuilt and shipped with the repo — installing from Git runs no dependency scripts

How it works

  • The plugin is a client plugin registered into the official sidebar shell's sidebar.workspaces slot (kind: 'single') at priority: -1, replacing the official WorkspaceBrowser (registered at priority 0; lowest priority wins in a single slot).
  • All data comes from the runtime API: the useWorkspaces / useSessions global hooks and ctx.workspaces.* / ctx.sessions.* — grouping is purely a presentation-layer transform.
  • The host half does two things: parses the sidecar YAML and merges it with the runtime overlay, served to the client via GET /workspace-groups/config (Cache-Control: no-cache); and PUT /workspace-groups/manual accepts the full overlay (manual groups, per-workspace grouping overrides, group/project ordering, rule-category renames and hides), validates it and writes it atomically to $DSH_HOME/workspace-groups.manual.json.
  • Classification priority: manual override (written by drag/menu; null = forced uncategorized) → YAML rule classification (hidden rule categories are inert) → "未分类" bucket (always at the bottom). The YAML is never rewritten.

Install (GitHub distribution)

Prerequisite: DeepSeek Harness installed (dsh available) with a target profile initialized (e.g. the built-in web).

dsh plugin --profile web add github:z-col/dsh-workspace-groups

This automatically:

  1. Adds "dsh-workspace-groups": "github:z-col/dsh-workspace-groups" (pinned to version/commit) to dependencies in ~/.dsh/profiles/web/package.json
  2. Appends "dsh-workspace-groups" to dsh.profile.bundles
  3. Runs pnpm install and validates the bundle layer

Restart the web profile after installing (both the bundle and the host half only load on restart):

# Stop the running dsh web process and start it again, e.g.:
dsh web

Verify the install:

dsh --profile web --dump-config | grep -A3 workspace-groups
# expect: - id: workspace-groups / name: dsh-workspace-groups / config: {}
curl http://127.0.0.1:3080/workspace-groups/config
# expect: the sidecar YAML parsed as JSON

Uninstall

dsh plugin --profile web remove dsh-workspace-groups

This removes the dependency from dependencies and the matching line from dsh.profile.bundles. A web profile restart is required for it to take effect.

Manual equivalent (pick one, don't repeat): edit ~/.dsh/profiles/web/package.json, remove the dsh-workspace-groups line from dependencies and "dsh-workspace-groups" from dsh.profile.bundles, then run pnpm install in that directory.

Classification config (sidecar)

Default location ~/.dsh/workspace-groups.yaml (override the home dir with the $DSH_HOME env var). Template: workspace-groups.example.yaml at the repo root.

categories:
  - name: DSH 插件
    rules:
      - pathPrefix: /Users/zcol/Project/SkillsManagePlugins
      - nameContains: 插件
      - basenameContains: plugin
  - name: 个人项目
    rules:
      - pathPrefix: /Users/zcol/Project/yeluzi

Rule fields (each rule is an OR — any match classifies; categories are matched in order, first match wins):

Field Meaning
pathPrefix Project absolute path prefix
pathExact Project absolute path exact match
nameContains Project display title contains (case-insensitive)
basenameContains Project directory name contains (case-insensitive)

Projects matching no category go into the "未分类" bucket — never hidden.

Manual groups & drag-and-drop grouping (runtime overlay)

Besides the rule YAML there is a plugin-owned runtime overlay, recording only manual UI operations, at $DSH_HOME/workspace-groups.manual.json (e.g. ~/.dsh/workspace-groups.manual.json):

{
  "categories": ["临时", "归档"],
  "assignments": {
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890": "临时",
    "a1b2c3d4-e5f6-7890-abcd-ef1234567891": null
  },
  "categoryOrder": ["临时", "DSH 插件"],
  "workspaceOrder": { "临时": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"] },
  "renamed": { "DSH 插件": "插件集" },
  "hidden": ["文档"]
}
  • categories — manually created group names (no rules; empty groups render too); names must not collide with rule categories or "未分类".
  • assignments — workspace → group classification overrides keyed by the stable workspace id (renames don't affect it). Takes precedence over YAML rules; a value of null means forced uncategorized (even when a rule would match).
  • categoryOrder — group display order ("未分类" is always at the bottom, not listed here).
  • workspaceOrder — per-group manual ordering of projects (written by drag ordering).
  • renamed / hidden — UI rename/delete of rule categories (a hidden category's rules become inert and its matches fall to "未分类"); the rule YAML stays untouched.
  • The file is written in full by the browser UI (PUT /workspace-groups/manual, atomic replace); manual edits also take effect on next load. A malformed write returns 400 and keeps the previous file — the rule YAML is never at risk.
Action How
Create group "新建分组" button in the section header (folder icon), enter a name in the dialog
Rename/delete group hover ⋯ menu on any group (rule categories included); deleting sends its projects back to "未分类"
Drag project into group drag a project row onto a target group row / any project row inside a group, release to move
Reorder projects drag a project row onto another project row in the same group: top half = insert before, bottom half = insert after (indicator shows the spot); other groups' projects auto-fold while dragging
Move out of a group drop on "未分类", or the project row's "移到未分类" menu (forced uncategorized)
Reorder groups drag a group row onto another group row: top half = move before, bottom half = move after (indicator shows the spot; all groups fold while dragging); "未分类" stays at the bottom

Topics

This repo targets automatic discovery by the DSH plugin ecosystem (community marketplaces scan GitHub topics). Already set:

  • dsh-plugin (core tag; 1024Store and similar marketplaces discover by this topic periodically, validating package.json + the plugin bundle manifest (cordis.patch.yml))
  • deepseek-harness / deepseek-harness-plugin / dsh
  • sidebar / workspace / workspace-groups

package.json also provides keywords for npm/search indexing.

Development

pnpm install
pnpm typecheck   # host + client dual-program type checking
pnpm test        # core rules, overlay, tree derivation unit tests
pnpm build       # build lib/ (node half + client bundle)
pnpm watch       # tsdown watch (client HMR)
node scripts/verify-groups.mjs   # real-browser CDP verification (host restarted; self-spawns a headless Chrome, auto-restores the scene)

Artifact contract (mirrors the official client packages):

  • lib/index.js — host half (ESM; reads the sidecar + /workspace-groups/config route; js-yaml inlined, no runtime dependencies)
  • lib/client.js — browser half (window.__ModuleLoader__.load({id, factory}); only requires platform seeds: react / react/jsx-runtime / @deepseek-ai/dsh-client-runtime/client / @deepseek-ai/dsh-client-ui-primitives; cross-plugin value imports are rejected at build time by the purity gate)
  • lib/types/** — declaration files

Release strategy: lib/ build artifacts are committed (no prepare script), so dsh plugin add github:... never runs third-party build scripts — install and use.

Repository layout

src/
  index.ts              # host half: config snapshot route + manual write route
  host-config.ts        # sidecar YAML reading/validation
  host-manual.ts        # runtime overlay read/write/validation (atomic publish)
  context-types.ts      # host-side cordis service structure types
  core/
    types.ts            # config types (shared by both halves)
    matcher.ts          # classification + manual override priority + ordering pure functions (shared)
  client/
    index.ts            # apply: registers sidebar.workspaces (priority -1)
    contract.ts         # injected surface types
    stores.ts           # expansion-state store (persist: dsh.workspace.groups.view.v1)
    tree.ts             # three-level tree derivation + tree search derivation
    GroupsBrowser.tsx   # browser region component (group dialogs + drag grouping/ordering + insertion indicator)
    rows.tsx            # category/project/session/search-result rows (drag sources/targets)
    locales.ts          # zh/en copy
    styles.css          # inline styles
tests/
  core.test.ts          # classification rules + override priority + moveBefore/moveAfter + config parsing
  manual.test.ts        # overlay validation + atomic file round-trip
  tree.test.ts          # tree derivation rendering contract (manual group empty render / override priority)
  store.test.ts         # expansion semantics (collapse writes false, never deletes the key)
scripts/
  verify-groups.mjs     # real-browser CDP verification (self-spawns headless Chrome, auto-restores the scene)

Development docs (docs/ five-level framework and AGENTS.md) are engineering files for development, not shipped with the repo (excluded via .gitignore).

Verification record

  • v0.1/v0.2 real-combination verification (headless Chrome + CDP): three-level tree takeover, correct classification, expansion persistence, search keeps workspace membership; workspace.json / session on-disk / official store: zero intrusion.
  • v0.3 real-browser verification 24/24 (scripts/verify-groups.mjs: create group / drag / order / collapse / rule-category menu / rename / delete-back-to-uncategorized / bottom-pinned / scene restore; zero-intrusion assertions).
  • v0.4 real-browser verification 30/30 (added: insertion indicator, project/group downward drag (bottom half → insert after the target), group upward drag (top half → move before the target); scene restored).
  • 65 unit tests green (vitest: core / manual / tree / store).
  • Reproducible automated verification: node scripts/verify-groups.mjs (host restarted).

License

MIT