Introduction¶
The DSH Web UI is suitable for long-term continuous use. However, when coding, debugging, or running sessions for extended periods, it is easy to continue operating late at night or after several hours. dsh-prevent-scd is a plugin for the DeepSeek Harness (DSH) Web UI designed to detect late-night or prolonged manual operations and prompt the user to rest using a “Nurse Cat” interface.
It does not alter the main DSH workflow but adds a rest reminder layer alongside the DSH Web session: the host side listens for real user messages, while the browser side displays a status bar, cute pop-up windows, and a full-screen blocking overlay.
What is this¶
Codingendless/dsh-prevent-scd is maintained by Codingendless, licensed under MIT, and categorized as a Fun/Costume Change.
Its one-sentence positioning is: detect late-night or prolonged manual operations, use a Nurse Cat to intercept the Web UI and remind to rest.
The plugin emphasizes local execution: no external assets, no network calls, and works offline.
Core Features¶
Below are a few verified capabilities.
- Detect late-night or prolonged manual operations and remind to rest.
- Listen for real
user/messagein DSHsession/event; plugin-injected events and historical replay events are not counted as manual operations. - Provide a status bar, cute pop-up windows, and a full-screen blocking overlay on the browser side, using embedded SVG and CSS animations.
- Support configurable thresholds, including
maxWorkMinutes,idleBreakMinutes, late-night windows,cooldown, andsnooze. - Persist state to
$DSH_HOME/prevent-scd/state.json, preserved after restartingdsh. - Provide HTTP endpoints:
-GET /prevent-scd/state.json
-POST /prevent-scd/ack
Installation and Enabling¶
The installation command provided in the documentation is for local path installation:
dsh plugin --profile web add -w "path/to/dsh-prevent-scd"
After installation, the dsh web service needs to be restarted. Profile bundle list changes require a restart, but running instances are unaffected.
Uninstall command:
dsh plugin --profile web remove dsh-prevent-scd
Typical Usage¶
Overriding Configuration¶
Override config in the profile’s cordis.patch.yml by id prevent-scd. For example:
- id: prevent-scd
config:
maxWorkMinutes: 120
idleBreakMinutes: 20
lateNightStart: '23:00'
lateNightEnd: '06:00'
Here, maxWorkMinutes, idleBreakMinutes, lateNightStart, and lateNightEnd correspond to the continuous work limit, no-operation interrupt threshold, and late-night window start and end times.
Browser Polling¶
The browser side can poll the current status via the state snapshot interface:
GET /prevent-scd/state.json
The example frequency provided in the documentation is once every 15 seconds.
User Response¶
When the plugin triggers a rest reminder, the user can respond via the ack interface:
POST /prevent-scd/ack
Request body example:
{ "kind": "rest" }
Or:
{ "kind": "snooze" }
Dependencies and Deployment Notes¶
Verified dependency information is as follows:
dependencies:
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/schemastery ^3.18.1
peerDependencies:
@deepseek-ai/dsh-client-runtime ^0.1.0-rc.6
@deepseek-ai/dsh-host-webserver ^0.1.0-rc.6
The README notes: pnpm does not install transitive dependencies for link: dependencies. When deploying on a different machine, you need to execute in the plugin directory:
pnpm install
Or install @deepseek-ai/cordis and @deepseek-ai/schemastery into an accessible node_modules.
Use Cases and Notes¶
Suitable for users who perform long-term continuous operations in the DSH Web UI and wish to be reminded to rest. Especially suitable for late-night usage or scenarios involving long-term continuous coding, debugging, and running sessions.
Please note: The plugin is loaded with the dsh web service and runs with the permissions of the current dsh process. Source code, dependencies, and licenses should be checked before installation. The license for this plugin is MIT.
If you only want to clear the timing state, you can delete:
$DSH_HOME/prevent-scd/
Related Links¶
- Plugin directory page:
https://www.skillhub.cn/plugins/Codingendless/dsh-prevent-scd - GitHub:
https://github.com/Codingendless/dsh-prevent-scd