DSH-better-classifier

中文 · English

Organize the DSH conversation sidebar with nested virtual folders, colored tags, and search results that preserve the tree.

Version 0.2.1 targets stock DSH 0.2.2-rc.2, without modifying DSH source or installed packages. Node.js 24.9.0 or later is required. Validated on Windows x64; other host versions and platforms are not declared compatible. See the validation record.

What it does

• Organizes projects in outer folders and conversations in folders within their project. Moving classification never moves files or changes working directories.
• Creates root folders from a right-click on list whitespace, including empty lists and empty search results. The focused background also supports the menu key and Shift+F10.
• Supports nested folders, single-item drag and drop, ordering, rename, and move menus. Deleting a folder moves its direct children up one level.
• Edits direct tags as chips on one page. Add, remove, create, rename, or recolor in a draft; Save commits together and Cancel discards it. Tags never inherit.
• Fits tags to the available row width, using +N only for overflow and keeping space before the time/actions.
• Searches names, direct tag names, conversation IDs, and message content through the stock DSH index. Matching containers start collapsed; leaf matches show their ancestor path. Up to 20 result entries are shown.
• Retains native project/session menus, pinning, archive filters, status indicators, sorting, directory picker, and shortcuts. Disabling the plugin restores the native list.

Installation

Verify dsh --version reports 0.2.2-rc.2, then install from npm:

dsh plugin --profile web add dsh-better-classifier@0.2.1
dsh web --no-open

Restart an already running DSH process and refresh its browser after installing. Replace web with the intended profile. The archive includes its build output; installation does not run a build or apply a source patch.

Alternatively, download dsh-better-classifier-0.2.1.tgz from GitHub Releases, verify its SHA-256 against the accompanying checksum file, and pass the local archive path to the same install command.

The Git repository contains source code and needs the development build below before local installation. npm publication and community-directory submissions are tracked in distribution status.

Upgrade and remove

The better_classifier storage domain remains version 1. Versions 0.1.x and 0.2.x share the folder, tag, placement, revision, and order representation; no data migration is required. The browser expansion key is unchanged. Old tag visibility and standalone-filter preferences remain ignored.

Version 0.1.x required a custom host patch. For 0.2.x, install into a stock 0.2.2-rc.2 host using the same DSH data directory/profile, after making a backup. Do not reverse-apply an old patch over a working tree with unrelated edits. An existing trial can remain alongside an isolated 0.2.1 development instance.

Disable the plugin through DSH's Plugins page, or remove it with:

dsh plugin --profile web remove dsh-better-classifier

Classification data remains in the configured DSH storage backend (by default storages/better_classifier.json) for reinstallation. Folder expansion remains browser-local. No cloud synchronization is provided.

Development and verification

Build dependencies come from npm; the Loader regression also uses the system tar utility. No DSH source checkout, local symlink, or fixed machine path is needed.

corepack pnpm install --frozen-lockfile --ignore-scripts
pnpm build
pnpm typecheck
pnpm package
pnpm test
pnpm dev --fixture

pnpm verify runs build → typecheck → package → test in that order. Typechecking needs the generated Remote declarations; the Loader test needs the current tarball. Host and Client test files are checked separately along with production source.

The isolated review uses .dev/review-0.2.1/home and port 3085 (--port=3087 keeps an older trial running alongside it). The startup output contains a local authentication URL. --fixture seeds synthetic projects/conversations and exercises storage and search without calling a model. Fixture modules receive a separate private package boundary so DSH cannot discover the repository's Client through them. After seeding, stop the process and run pnpm dev --installed --port=3087 without --fixture for browser lifecycle checks. Tests use their own homes and the exact published DSH CLI. The tarball and source ZIP are written to dist/; source selection respects root and nested ignore rules and also works without .git.

The client adapter shadows the public sidebar.workspaces registration while borrowing its native action/state shares. Native picker and row contributions are mirrored into plugin-owned child seats and released with the owning registration. The compatibility boundary is therefore pinned, rather than claiming support for future DSH releases. betterClassifier.searchContent owns candidate-filtered search; authorization and filters run before the result limit. Remote metadata is generated in a disposable build workspace; installed host/generator files remain unchanged.

Data and failures

Classification metadata is separate from conversation logs and model context. Saves use the server revision and commit atomically. A conflicting draft is refused and must be reopened; write failures retain the draft. Body-search failures retain name matches and offer Retry. Unknown/unloaded project and conversation IDs are not automatically deleted from classification storage.

An unsupported sidebar contribution restores the original sidebar and hides new classification actions. An open draft is retained with Save disabled until the adapter is available again. Removing the conflicting nested contribution restores classification automatically.

Body-search index

The standard bundle configuration enables the shared SQLite query service on the first body search, using storages/better_classifier_search.sqlite under DSH_HOME. The index stores searchable message text, not just hashes or snippets. It can index all persisted conversations; candidate IDs and access checks restrict search results, not which conversations are indexed. Disk use grows with the indexed history.

Configuration precedence is bundle → profile patch → DSH_HOME patch → command-line overlay. Your later configuration remains authoritative. For a memory-only index, add this to your profile's cordis.patch.yml (or an existing user overlay):

- id: session-query-sqlite
  config:
    path: ':memory:'
    openAt: first-search

Setting openAt: never disables body indexing; name/tag search remains available. Disabling or uninstalling BetterClassifier removes its configuration layer but leaves the derived index file. Removing a conversation does not guarantee immediate physical erasure from SQLite. To discard the default derived index, close every DSH process using that DSH_HOME, then manually remove only better_classifier_search.sqlite and its -wal/-shm sidecars from storages; it can be rebuilt on a later search. Do not remove better_classifier.json, session logs, or a custom database path shared by other configurations.

Only synthetic test data is used in public documentation. Local profiles, session files, credentials, build caches, logs, and work records are excluded from distributable archives.

License

MIT. The UI adapter derives from MIT-licensed DeepSeek Harness. See THIRD_PARTY_NOTICES.md.