dsh-session-manager — session and workspace manager for DeepSeek Harness

English | 中文

0 Overview

DeepSeek Harness session and workspace manager —— Workspaces: archive and visibility. Sessions: move, migrate presets, delete, favorite, review later, prioritize, tag, and annotate. Batch operations.

Verified with the official DSH Desktop client; see 5 Compatibility for the current verification scope. Both environments share the same plugin Host/client functionality; environment-specific installation notes are documented below.

1 Features

1.1 Session lifecycle management

• Delete is irreversible and always asks for confirmation. Subagent sessions and transient blank placeholders (no persisted artifact) cannot be deleted.
• Archive / Unarchive moves a session in and out of the active list without touching its disk content.
• Move to workspace keeps history, title, archive state and derived-session relationships intact, rewrites the session's cwd to the target workspace, synchronizes the runtime workingDirectory projection for active agents, and updates the live writer's header in place so any pending tool calls keep landing on the new path. When the session's cwd already equals the target workspace path but its membership was never recorded, only the missing membership is repaired: no cwd rewrite, no artifact rewrite or move, and no session restart.
• Migrate Agent preset rewrites the latest agent-preset/selected event (or the session header if no such event exists) so a session whose preset was renamed or removed can resume. Message history is never altered.

1.2 Session shortcuts

• Favorites / Review-later are manual flags that survive archive and session end; neither is cleared automatically.
• Search matches title, session ID, note and tags case-insensitively, trims whitespace, and never reads chat history.
• Filters and sorting combine a workspace selector (All / Ungrouped / specific) with an archive filter (All / Active / Archived), then layer favorites / review, tag and priority filters on top. Sort by recently updated (default), least recently updated, newest created, oldest created, name ascending (A-Z), name descending (Z-A), or priority (1 → 5).
• Priority is a dropdown 1 Highest, 2 High, 3 Normal, 4 Low, 5 Lowest, default 3 (Normal); legacy null priorities are normalized to 3.
• Tags / Notes: up to 20 tags per session (≤ 32 characters each) and a 2000-character note. Both English , and Chinese ， are separators, whitespace is trimmed, duplicate tags are merged case-insensitively.
• AI-assisted tagging is manual and opt-in: Copy Prompt writes a structured prompt (Chinese or English, matched to the active UI) to the clipboard; Import parses the clipboard JSON (tolerating Markdown fences, conversational wrappers, smart quotes, stray backslashes and a leading BOM), validates it against the same limits, and populates the editor fields. Neither button calls a model automatically.
• Annotations live in plain text under the DSH home (dsh-session-manager/annotations.v1.json), keyed by session ID. Same-origin client instances stay in sync via BroadcastChannel. Saves are durable across crashes; revision conflicts surface a "load latest" prompt.

1.3 Bulk management

…