Repository navigation
fix: 跨平台提示如何安装 zstd(Windows/Linux 不再只有 brew) - #21
Merged
luwill merged 2 commits intoOct 28, 2026
Merged
Conversation
dsh 多帧会话必须用外部 zstd CLI 解压,但旧报错/自检只给了 macOS 的 `brew install zstd`,Windows 与 Linux 用户看到后无法落地。 - src/zstd.js: 新增 zstdInstallHint(),按 process.platform 返回对应包管理器命令或官方二进制下载地址 - src/doctor.js: 健康自检的 zstd 缺失提示改用 zstdInstallHint() - README.zh-CN.md: 安装说明补充 Windows/Linux 的安装方式 实测:Windows 未装 zstd 时 update-and-resync 会因 34 个 dsh 多帧文件解压失败而卡在 rescanning;装好 zstd 后重算正常。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
dsh数据源的会话快照是追加式多帧 zstd 写入,必须用外部zstdCLI 解压(Node 内置实现只解第一帧)。当系统缺少zstd时,旧代码提示请安装 zstd:brew install zstd,但brew仅 macOS 可用,Windows / Linux 用户看到后完全无法落地。实测:Windows 未装 zstd 时
update-and-resync因 34 个 dsh 多帧文件解压失败卡在rescanning,云端统计一直无法重算替换;装好 zstd 后重算 472 个文件、94 天统计完整替换成功。改动
src/zstd.js:新增zstdInstallHint(),按process.platform返回对应安装方式(Windows 给scoop/choco/官方zstd.exe;Linux 给apt/dnf/pacman;macOS 仍是brew),两处报错改用它。src/doctor.js:健康自检的 zstd 缺失提示改用zstdInstallHint()。README.zh-CN.md:安装说明补上 Windows / Linux 方式。验证
node --check两个改动文件均通过;