@wxysskd/dsh-projects
适用于 DSH Desktop 的 Claude-Desktop-style Projects：将对话归入项目，并为每个对话选择工作目录。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:aobakaolengmian/dsh-projects#07caf8c355e818401ba4c7d0181f5b2adea03b5e
Projects 以 @wxysskd/dsh-projects 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Claude-Desktop-style Projects for DSH Desktop (the desktop DSH profile
only — Web and headless profiles are untouched).
The shipped DSH sidebar groups conversations by Workspace (directory). This plugin replaces that sidebar region with a project-first browser:
workingDirectory service — the same durable, model-visible
mechanism as the working_directory tool;blank: true); only
the empty Session that is currently open is shown. The Host also scans legacy
Sessions whose catalog row is not marked blank but whose log contains no
conversation events at all (only tiny header/metadata logs are inspected), so
old "Badstuff"-style empty chats are hidden too. View options → Delete empty
conversations (N) permanently removes both kinds from disk through a
validated Host route (never touches a conversation with content; sessions
still live in the current app run are archived and can be purged after the
next start);+ (new conversation directly in
that directory — assigned to the containing project, or ungrouped under
Other conversations) and ⋯ menu (new conversation, move to another
project, rename, remove from project, delete workspace);The plugin ships as a normal DSH bundle and is published on npm as
@wxysskd/dsh-projects.
Three equivalent ways to install it into the desktop profile
(~/.dsh/profiles/desktop):
# 1. from npm (registry install; also works from Plugins -> Add plugin)
plugin_manager install_bundle target=@wxysskd/dsh-projects@1.0.0
# or: desktop-cli plugin --profile desktop add @wxysskd/dsh-projects@1.0.0
# 2. from the self-contained release tarball
npm run pack # -> dist/wxysskd-dsh-projects-1.0.0.tgz
plugin_manager install_bundle target=/abs/path/dist/wxysskd-dsh-projects-1.0.0.tgz
# 3. source link for development (client.js edits hot-reload)
desktop-cli plugin --profile desktop add link:"$PWD"
The npm package contains only runtime files (index.js, client.js,
cordis.patch.yml, locale/*.json, icon.svg, package.json, README.md,
LICENSE), plus SHA-256/manifest in dist/. See
docs/INSTALL.md for installation, the market index,
activation/verification and rollback details.
DSH has no official built-in market; the Discover tab reads index sources the user adds. This repository publishes a format-1 index with a commit-pinned Git install target:
https://aobakaolengmian.github.io/dsh-projects/market/index.json
Add that URL as an index source in Plugins → Discover and install
Projects from the card; the same index is readable by the plugin_market
tool and by any other DSH Desktop user:
The market entry installs the published npm package
(@wxysskd/dsh-projects@<version>), the same artifact as the tarball. See
market/README.md for the format and how to regenerate it
(npm run market). Installing from the market still needs one app restart for
the Host row.
Project metadata is Host-owned and durable, independent of session logs:
$DSH_HOME/storages/dsh-projects.json — projects, session→project
assignments, last recorded working directory per session;HTTP routes served from the existing DSH web server (same origin as the GUI):
| Method | Path | Purpose |
|---|---|---|
| GET | /dsh-projects/state | complete project state |
| GET | /dsh-projects/health | liveness + counts |
| POST | /dsh-projects/mutate | project.create, project.update, project.delete, session.assign |
| POST | /dsh-projects/cwd | change one conversation's working directory |
| POST | /dsh-projects/purge | permanently remove validated empty sessions (rejects content) |
| GET | /dsh-projects/empty-sessions | list sessions that hold no conversation content |
POST routes require content-type: application/json and x-dsh-projects: 1
and a 64 KiB body limit.
npm install # dev-only: esbuild, react, react-dom, playwright
node scripts/build.mjs # src/client/* -> client.js (committed artifact)
npm run pack # build + dist/<name>-<version>.tgz + SHA-256 + manifest
node harness/build.mjs # mock harness bundle
node harness/shoot.mjs # screenshots -> harness/shots/
npm test # host/model tests (node --test)
sidebar.workspaces single slot
at priority: -1, shadowing ui-workspace's browser. The shipped entry stays
registered underneath: if our component crashes, its entry is abdicated and
the original sidebar comes back.react / react-dom / react/jsx-runtime
from the shell's shared module table and uses ctx services for everything
else (sessions, workspaces, uiWorkspace, locale, slots).--dsw-* theme tokens; literals are limited to project accent
artwork. All classes are prefixed pj-.Everything can be migrated without deleting or recreating sessions, through the project metadata only (session logs are never touched):
⋯ → Move workspace to project → pick the target;⋯ → Move working directory to another project… → pick the
directory → pick the target project (or Remove from project (back to Other
conversations));⋯ → Move to project → pick the target (or No project).Moving a directory between projects also makes future sessions created in that directory (including the shipped Cmd+N flow) land in the target project, and the project keeps the workspace title as a nested folder group.
Workspace headers (both inside projects and under Other conversations) expose their own menu: Rename workspace…, Move workspace to project, Remove from project and Delete workspace. Deleting a workspace removes only its registration, puts its conversations back under Other conversations, and never deletes a conversation.
The installed sidebar-touching plugins were audited and the browser keeps their integration surfaces intact:
| Plugin | Integration surface | Status with Projects |
|---|---|---|
dsh-timeline | DOM-injects its starred-folder section before [data-slot="sidebar.workspaces"]; resolves session rows as div[role="treeitem"][aria-selected]; injects "Star Chat to Folder" into host menus found as body > [role="menu"] | Works: the slot anchor is preserved (its folder section renders above Projects), every row follows the shipped treeitem/title DOM contract, and menus/modals are portaled to document.body, so its injected menu item appears and opens its own dialog |
dsh-cost-meter | Registers sidebar.footer.action entries and styles its own footer stack | Works unchanged: footer actions are outside the replaced region |
dsh-notification, dsh-plugin (hub), dsh-thoughtdag, dsh-dafeiyu, dsh-plugin-whale-pet | No sidebar.workspaces DOM or row-slot usage (audited client bundles) | No interaction |
shipped ui-workspace browser | Registers the slot at priority 0; its child row-extension slots (e.g. schedule marks) are only rendered by its own component | Our entry shadows it at priority -1; if our component crashes it abdicates and the shipped browser returns. Child-slot extensions are not rendered while Projects is active (non-crashing degradation) |
Live verification with dsh-timeline + dsh-cost-meter + Projects mounted in one
real DSH host: our sidebar rendered 57/57 sessions as timeline-compatible
treeitems, timeline's starred-folder section appeared above Projects, timeline's
"Star Chat to Folder" item was injected into our session menu and opened its
dialog, cost-meter's footer card rendered normally, our menus/search stayed
functional, and the browser console reported no errors.
ui-workspace browser's child extension slots
(sidebar.workspaces.session.menu.item, sidebar.session.row.leading, …) are
not rendered by our browser, so shipped/third-party row decorations registered
there (for example the schedule mark) do not appear while it is active. The
shipped built-in session actions are re-implemented directly in the project
menus, and dsh-timeline's DOM-based decorations do work (see above).ui-workspace (Cmd+N / Cmd+K) keep their shipped
behavior; our search field is opened through the header icon.localStorage; project data lives Host-side.