dsh-loading-phrases

DSH Loading Phrases

English | 中文

Replace the "Deep diving..." running status in the DeepSeek Harness Web
GUI with alternating witty phrases and practical tips — in the
original position, with the original shimmer effect and the elapsed clock
intact.

Behavior

While a turn is running (the same condition under which the original status
line appears):

• the original "Deep diving..." text gives way to a rotating line in the
  same place, rendered with the same gradient-shimmer recipe;
• strict alternation: witty phrase for 5 s → tip for 10 s → witty phrase…
  each run starts with a witty phrase;
• rotation is a no-repeat shuffle (Fisher–Yates decks, reshuffled on
  exhaustion) — no back-to-back repeats, every entry shown once per cycle;
• the elapsed clock that appears after 15 s keeps working exactly as before;
• the line follows the GUI locale: zh → Chinese lists, otherwise English;
• the phrase is mirrored onto the status line's aria-label, so assistive
  tech announces real text changes instead of the CSS pseudo-element;
• long phrases truncate with an ellipsis in narrow windows;
• if the product DOM changes and the status line can no longer be found,
  the plugin logs a console diagnostic instead of failing silently.

Fail-safe by construction: the original text is hidden only while the
plugin's script is alive. Any failure degrades back to the product's own
status text.

Install

dsh plugin --profile <profile> add @vincent-guo/dsh-loading-phrases

0.7.0 note: the npm package was renamed from dsh-loading-phrases to
@vincent-guo/dsh-loading-phrases; the old name is deprecated on npm.
Existing installs should switch the dependency and the
dsh.profile.bundles entry to the scoped name.

The package declares dsh.bundle.patch — a cordis.patch.yml at the package
root that inserts the loading-phrases row — so dsh plugin add reconciles
the profile's dsh.profile.bundles automatically and the row is composed
from the package itself. No hand-written load row is needed. For a local
checkout, pass the absolute path instead of the package name (or run
corepack pnpm add /absolute/path/to/dsh-loading-phrases inside the profile
directory).

Restart the profile process so the host half loads, then hard-refresh the Web
GUI page (⌘/Ctrl+Shift+R).

If the package is installed as a plain dependency without bundle
reconciliation, add the load row manually to
~/.dsh/profiles/<profile>/cordis.patch.yml:

- insert:
    - id: loading-phrases
      name: '@vincent-guo/dsh-loading-phrases'

Settings panel

The plugin registers a Loading Phrases page in the GUI Settings (sidebar
foot → Settings), styled with the official design-system primitives (selector
pills, buttons, inputs), the shipped settings-row layout, and the Plugins-
page heading/intro pattern. From it you can:

• switch mode (alternating / witty only / tips only / off), the dwell
  times (shown in seconds, stored as milliseconds), the no-repeat
  switch, and the language policy — preference changes save themselves
  (debounced, with a Saving…/Saved status) and apply immediately, no button
  needed;
• edit the phrase and tip lists (one per line) behind English / 中文
  tabs (labeled like the language options) that open on the language
  currently in effect — the tab is just an editor
  view, never coupled to the runtime language preference;
• save phrase edits explicitly with Save phrases — saving writes only
  what you changed: a list left at the built-in content (or cleared) stays
  empty in the file and follows the built-ins, while a customized list is
  written in full; Restore defaults re-seeds everything;
• the panel re-reads the config every time it opens, so hand-edited file
  changes are never overwritten by a stale draft (panel save still replaces
  the whole section — the panel view wins when both were edited).

The Open phrase config button (beside Save/Restore on the page itself)
opens ~/.dsh/dsh-loading-phrases.json in your default editor for bulk
editing; it is enabled after the first save creates the file. File edits
apply after a page refresh.

Configuration

The user-owned config lives at $DSH_HOME/dsh-loading-phrases.json (usually
~/.dsh/dsh-loading-phrases.json) — machine-local and shared by every
profile, so it survives plugin updates. It is served by the host half and
read by the client on every page load; edits apply on the next refresh, and
settings-panel saves apply immediately. The package-root
dsh-loading-phrases.json serves only as a development seed and is never
written by the plugin.

{
  "loadingPhrases": {
    "mode": "all",
    "wittyIntervalMs": 5000,
    "tipsIntervalMs": 10000,
    "shuffle": true,
    "language": "auto",
    "phrases": { "en": [], "zh": [] },
    "tips": { "en": [], "zh": [] }
  }
}

Customizing phrases

1. Edit src/data/witty.json and/or src/data/tips.json
   (en / zh arrays are independent content, not translations).
2. Run node scripts/sync-data.js (or npm run sync) to regenerate the
   data blocks in lib/client.js, then npm run check.
3. Hard-refresh the page for config edits. Code edits (lib/*.js)
   require a web profile restart — bundle revisions only re-enter the module
   graph through HMR or a restart.

Content

Repository layout

dsh-loading-phrases.json   default configuration (served by the host half)
cordis.patch.yml           profile bundle patch (the loading-phrases row)
CHANGELOG.md               release notes
NOTICE.md                  Apache-2.0 attribution for the derived phrases
LICENSE                    MIT license
lib/index.js               host half (config HTTP route)
lib/client.js              client bundle (DOM target, rotation engine, generated data)
src/data/*.json            phrase/tips content (single source of truth)
scripts/sync-data.js       regenerates the data blocks in lib/client.js
scripts/test-manifest.mjs  distribution-manifest contract test
scripts/test-client.mjs    client bundle behavior simulation
scripts/test-host.mjs      host config route test
docs/design.md             design baseline and decisions

Roadmap

The settings panel (v3), the profile-bundle distribution (v0.5), and the
minimal-write save (v0.6) are delivered. No further milestones are planned;
optional future work:

• re-evaluate migrating preferences into the durable settings service
  only if a concrete need appears (e.g. a DSH settings export/sync feature
  users want this plugin's preferences to ride). See docs/design.md for
  the decision record.

License

MIT. Release notes: CHANGELOG.md.