dsh-session-stars

dsh-session-stars

English | 中文

Star-rating favorites with five importance levels for sessions in the DeepSeek Harness Web UI.

The workspace sidebar gets a star control on every session row: rate a session from 1 to 5 stars, and the rating is shown as a single color-coded star that barely takes any width. Ratings are stored on the Host in one JSON file, so they survive page reloads, restarts, and web-server port changes.

Features

• 1-5 star importance — one star is low, five stars is critical. Hovering a session row reveals a star button; the row's ... menu also carries an Importance… item, so the picker is reachable without hovering. Both open the same compact picker.
• Obvious importance levels, minimal width — every rated row shows one small filled star whose color is the level (gray, green, blue, amber, red), so the list stays compact. The session hover card keeps the full five-star gauge plus a tinted chip with the level name.
• A real scale in the picker — the picker pairs five large stars with a five-step importance scale (Low · Minor · Important · Very important · Critical), highlights the current level, supports number keys 1-5, and confirms with a brief “Saved”.
• Live across windows — /session-stars/events streams each committed change over Server-Sent Events, so every open Web UI window updates immediately; focus refresh stays as a fallback.
• Durable Host storage — ratings live in ~/.dsh/session-stars.json (or $DSH_HOME/session-stars.json). Writes are serialized and published atomically.
• Agent tool — session_stars lets the agent read ratings, assign stars, or clear a rating, using the same store as the UI.
• Localized — Simplified Chinese and English copy; other locales fall back to English.
• Theme-native — the picker and badges use only --dsw-alias-* theme tokens, so light/dark themes work.

Install

From GitHub

dsh plugin --profile desktop add github:879745uhjun/dsh-session-stars

Reload the Web UI page after installing.

From a local checkout

This package is a DSH bundle (dsh.bundle.patch). Install the directory with the Plugin Manager:

1. Ask the DSH agent to install this bundle from the project directory (it calls plugin_manager with action: install_bundle and the absolute package path).
2. The bundle is linked into the active profile and its rows are applied live; reload the Web UI page if the client half does not appear immediately.

The Host row inserts as dsh-session-stars; the browser half is declared by dsh.client in package.json.

Use

Surface	Behavior
Session row hover actions	Click the star button to open the importance picker.
Session row ... menu	Importance… opens the same picker.
Picker	Five large stars plus the five-step scale; pick 1-5, press 1-5, or clear the rating. Esc or a click outside closes it.
Session row trailing badge	One small star in the importance color; the title/aria-label carries N of 5 and the level name.
Session hover card	Gauge plus a tinted chip with the localized level name.
Agent tool session_stars	list reads ratings, set assigns 1-5 stars, clear removes one. Omitting sessionId targets the calling session.

Levels: 1 low, 2 minor, 3 important, 4 very important, 5 critical.

Data and interface

• File: <DSH home>/session-stars.json, format { "version": 1, "updatedAt": <ms>, "ratings": { "<sessionId>": { "stars": 1-5, "updatedAt": <ms> } } }.
• Browser route: GET /session-stars returns the ratings, POST /session-stars with { "sessionId": "...", "stars": 0-5 } writes one. GET /session-stars/events is the Server-Sent Events stream (event: ratings) that pushes every committed snapshot. The routes answer same-origin requests only; a cross-site Origin is refused.
• Ratings are keyed by session id. Deleting a session does not delete its rating; clearing it from the picker does.
• Every open window receives each committed change over the event stream; a focus/visibility refresh stays as a fallback if the stream drops.

Compatibility

• DSH >=0.2.2-rc.1 <0.2.3-0, Web profile (a webServer service is present).
• The Host tool still works on non-web surfaces, but the star UI requires the Web UI.

Development

node --check client.js
node test/host.test.mjs

The Host test covers the ratings store, the JSON route (including validation and the cross-origin fence), the Server-Sent Events stream, the agent tool, and persistence across remounts.

License

MIT