Read-only DSH environment health check: disk, memory, latency, ~/.dsh bloat and outdated-plugin detection with graded reports and baseline trend comparison. Deletes nothing.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:taxueseek/dsh-healthcheck
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
DeepSeek Harness 环境体检插件:一个 health_check 工具,只读体检你的 dsh 环境,产出分级报告(CRITICAL / WARNING / INFO),并对比上次体检的趋势。
融入 sys-doctor 的体检方法论(指标快照 + 历史基线 + 趋势对比 + 大目录定位),并针对 dsh 环境增加专属体检项。
体检项
| 类别 | 内容 | 分级 |
|---|---|---|
| 磁盘 | APFS 数据卷使用率(/System/Volumes/Data,避免系统卷误导) |
≥90% CRITICAL / ≥80% WARNING |
| 磁盘趋势 | 对比上次体检的已用增量(GB) | 增量 >5GB WARNING |
| 内存 | macOS 内存压力(vm_stat 换算) | ≥80% WARNING |
| 网络 | ping 8.8.8.8 平均延迟 | ≥150ms WARNING |
| ~/.dsh 膨胀 | clipboard 图片、sessions、profiles、storages 各目录大小 | ≥1GB WARNING |
| 插件版本 | 对比 npm registry 最新版 | 有新版 INFO |
| 工具链 | brew/npm/pnpm/node/python3/git/gh/zstd 可用性 | 缺失 INFO |
只读设计:只体检和报告,绝不自动删除任何东西。清理动作由模型根据报告建议、你确认后执行。
数据
- 历史基线:
~/.dsh/health/history.jsonl(每次体检追加一条,保留最近 200 条) - 首次体检即建立基线,下次自动对比趋势
安装
dsh plugin --profile web add "github:taxueseek/dsh-healthcheck#main&path:."
# 重启 dsh web
(本地开发:dsh plugin --profile web add /path/to/dsh-healthcheck)
用法(模型视角)
用户说「体检一下」「看看磁盘」「环境是不是有问题」→ 模型调用 health_check,返回分级报告:
# 环境体检报告
总体: HEALTHY | CRITICAL 0 / WARNING 0 / INFO 4
- [INFO] 磁盘使用率 62.5%,可用 285.3 GB
- [INFO] 内存压力 34.2%
- [INFO] 网络延迟 18 ms
~/.dsh 数据目录:
1.2 GB ~/.dsh/sessions
插件版本:
dsh-context: 0.5.0 → 0.7.3(可升级)
配置
- id: healthcheck-toolkit
name: 'dsh-healthcheck'
config:
stateDir: '~/.dsh/health' # 历史基线目录
historyLimit: 200 # 保留快照条数
diskWarnPct: 80 # 磁盘 WARNING 阈值(%)
diskCriticalPct: 90 # 磁盘 CRITICAL 阈值(%)
memoryWarnPct: 80 # 内存压力 WARNING 阈值(%)
latencyWarnMs: 150 # 延迟 WARNING 阈值(ms)
scanTimeoutMs: 30000 # 单次扫描超时
开发
npm install --include=dev
npm test # node --test 单元测试
npm run build # tsc 编译
许可
MIT
安装
```sh dsh plugin --profile web add taxueseek/dsh-healthcheck ```
贡献
欢迎提交 PR。
Links
More in this category
yjh051108/dsh-routing-suite★ 7013
One repository, three parts: a runtime injector for DSH plugin packages (inject, hot-reload, unload, promote a dev staging tool to the front, route self-heal, plus a settings-page plugin manager that lists, unloads and drags folders in to internalize), a task-aware reasoning-mode router agent preset (router-standard / router-spec / router-react), and a graded two-level task protocol whose six tools (commit_star, lock_stage, revise_do, edit_plan, mark_task, redteam_verdict) pin task state to disk. The injector implementation ships in-tree, so the install carries its own behaviour rather than a dependency list.
strukto-ai/mirage#dsh★ 3679
Swaps the filesystem and bash providers for a mirage virtual workspace: file tools and shell commands run over mounted resources (RAM, S3, Redis, Slack, Gmail, Notion, Postgres) instead of the host disk, with per-mount read/write/exec modes, per-command sandbox routing (monty, pyodide, quickjs in process; docker, e2b, daytona remote), and installed CLIs (git, gh, slack, linear, ntn, gws, or one you register) as head words in the virtual terminal.
hust-open-atom-club/oh-dsh★ 322
Community distribution: TUI, desktop, and Web UI as one bundle with layered installation.
weijiafu14/pi2dsh★ 212
Pi Host ABI compatibility engine: after one install, unmodified Pi extensions from npm mount as native DSH plugins with `dsh plugin add <pi-package>`. Verified end to end on stock DSH with pi-mcp-adapter (full MCP manager: OAuth, resources, prompts, MCP Apps, elicitation, sampling), @tintinweb/pi-subagents, pi-code, pi-hermes-memory and pi-background-tasks; `pi2dsh inspect` reports a package's compatibility before installing.
Fishquito7/dsh-skill-mcp-panel★ 181
Manages DSH skills and MCP servers from the web settings: skill cards with hot enable/disable, workspace scopes, groups, batch migration and drag-and-drop import, plus stdio/HTTP MCP CRUD with connection tests, secret redaction and the unified dsh-panel CLI.
lire1131/dsh-undo-savepoint★ 179
Undo/redo & rollback system for DSH: every config change is auto-snapshotted; undo/redo/restore to any version from the WebUI or the offline CLI/GUI tools (works even when DSH fails to boot).
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.