DSH session health check plug-in
omdsh-dev/dsh-session-health · enterprise
DSH session health check plug-in: frame-level scanning diagnosis of multi-frame zstd session files (torn/corruption/null session detection), zero-dependency read-only, registered sessionhealth tool
★ 9GitHub stars
0Forks
2026-08-14Last updated
TypeScriptLanguage
MITLicense
Key features
- Read-only guaranteenever modify/delete any files (test covers "the number of bytes in the file remains unchanged after scanning", see files.spec SH-06 use case)
- zstd-scan.spec.tsboundary/multiframe/not-zstd/truncation/reserved bits of official compressor generated frames + real session difference (large/medium/small files are consistent with official scanZstdFrames frame by frame
- Path fencesession id strict directory name whitelist (prevent ../ traversal)
- Both the absolute path and the final file are subject to fs.realpath real path containment (anti-symbolic link/junction escape)
- Enum reject symlink with lstat
Requirements
- Consumption verificationtarball is loaded into rc.6 consumer → dsh --profile compat --dump-config This plug-in row appears → the actual registration and execution of the tool pass
Install command
dsh plugin --profile web add github:omdsh-dev/dsh-session-health