Repository navigation
v0.1.0 — first public release / 首个公开版本
dsh-cache-cleaner v0.1.0
First public release. A DeepSeek Harness plugin that finds and removes the
rebuildable caches of DSH itself, its desktop client, and the plugins installed
into a profile — with a settings page, two agent tools, and an HTTP route that
all run the same cleanup engine.
What it cleans
13 targets in four groups (13 个目标,四组):
| Group | Targets |
|---|---|
| DSH core | request-image cache, session projection cache, prepared-shell spill |
| Temp spill | dsh-subprocess-*, dsh-spill-*, other dsh-* temp entries |
| Desktop client | HTTP cache, Code Cache, GPU/shader caches, logs |
| Plugins & updater | updater installer cache, plugin context overview cache, cc-safety-net build cache |
On the author's machine the first launch reported 1.5 GB / 1213 files, of
which 8.8 MB / 202 files was older than a week.
Entry points
- Settings → 缓存清理 / Cache Cleaner — rescan, review per-target sizes and
paths, tick a subset, confirm with a second click. - Agent tools —
cache_scanandcache_clean(olderThanHours), so an
agent can plan a cleanup before running it. - HTTP route —
POST /dsh-cache-cleaner/api/{scan,clean}, same-origin and
authenticated through the host's connection trust checks (untrusted requests
are answered 401).
Cleaning options
| Option | olderThanHours |
Meaning |
|---|---|---|
| 仅 7 天前的 / 7+ days old | 168 |
only entries untouched for the last week |
| 全部缓存 / Everything | null |
every entry, including caches written seconds ago |
| default | omitted | per-target cutoff (temp targets keep entries newer than 6 h) |
Install
The package is installed by link, not from npm:
git clone https://github.com/you112358/dsh-cache-cleaner.gitthen, in a DSH session:
plugin_manager action=install_bundle target=<absolute path to the checkout>
The settings page appears under Settings → 缓存清理 / Cache Cleaner; refresh the
page once after installing. Uninstall with
plugin_manager action=remove_bundle target=dsh-cache-cleaner.
Safety
- Only declared roots are touched (
~/.dsh, the OS temp directory, the desktop
client's userData, the updater directory,~/.cc-safety-net); sessions,
attachments, profiles, credentials and client Local Storage are explicitly
protected. - Symlinks are never followed. Files held open by the running process are
reported as skipped, never forced. Deleting a cache only costs a rebuild.
Checks
node --check client/client.js, a host-half import probe, and
node scripts/check-client.mjs run in CI on Node 22.
Full Changelog: https://github.com/you112358/dsh-cache-cleaner/commits/v0.1.0