@vincent-guo/dsh-loading-phrases
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": [] }
}
}
| Key | Values | Default | Meaning |
|---|
mode | tips / witty / all / off | all | off yields entirely: the original Deep diving... stays untouched |
wittyIntervalMs | number | 5000 | Dwell time for a witty phrase |
tipsIntervalMs | number | 10000 | Dwell time for a tip |
shuffle | boolean | true | No-repeat rotation; false = random with replacement |
language | auto / en / zh | auto | Force a language instead of following the GUI locale |
phrases, tips | { "en": [...], "zh": [...] } | empty | Per-language overrides; a non-empty list replaces the built-in list for that language |
Customizing phrases
- Edit
src/data/witty.json and/or src/data/tips.json
(en / zh arrays are independent content, not translations).
- Run
node scripts/sync-data.js (or npm run sync) to regenerate the
data blocks in lib/client.js, then npm run check.
- 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
| Channel | EN | ZH | Source |
|---|
| Witty phrases | 49 | 24 | Derived from Qwen Code web-shell lists (Apache-2.0, see NOTICE.md) |
| Tips | 40 | 40 | Written against real DSH UI behavior |
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.
