@hy-sde-org dsh-zstd-frame

由DeepSeek Harness会话共享的标准帧原语 持久性后端(session.jsonl.zstd)和项目记忆库 （bank.jsonl.zstd）. 两者都存储仅追加、校验和、每批zstd 帧;这个包拥有结构扫描，一次性压缩/ 解压缩API与校验和，扭转帧恢复，和可互换 多帧解码器，因此消费者永远不会重新实现帧布局或 节点私有解码器生命周期。

独立发布为 @hy-sde-org/dsh-zstd-frame;这镜子 @deepseek-ai/dsh-zstd-frame 在 侧深seek-harness叉.

完全由 node:zlib -没有原生模块，工作在进程中。

API

import {
  compressZstdFrame,
  decompressZstdFrame,
  decompressZstdFrameSync,
  decompressZstdPrefix,
  scanZstdFrames,
  createZstdFrameDecoder,
} from '@hy-sde-org/dsh-zstd-frame'

• scanZstdFrames(buffer, maxFrames?) → { frames: ZstdFrameRange[], tornStart? } - - - - - - 定位完整帧而不解压它们的块；内部的EOF 最后一帧返回其开始进行修复。
• compressZstdFrame(input) -一个独立可解码，校验和帧。
• decompressZstdFrame(input, maxOutput?) / decompressZstdFrameSync(...) - - - - - - 带有可选明文绑定的单帧解压缩。
• decompressZstdPrefix(input) -恢复可用的明文 结构不完整的最终框架。
• createZstdFrameDecoder() - - - - - - NodePrivateZstdFrameDecoder 当跑步时 节点形状是兼容的，否则 PublicZstdFrameDecoder;两者都实现了 常见的 ZstdFrameDecoder 接口(decode(source, frames) 发电机+ close()）。

已知的限制和延迟的工作

• 私有句柄解码器(NodePrivateZstdFrameDecoder)取决于 私人 zlib._handle.writeSync 这是公共Node API所没有的 文档;解码器特征探测在负载和回落到 one-shot-based PublicZstdFrameDecoder 当形状不相容时，那么 正确性从不依赖于私有内部。
• 无流增量压缩；每批写入整个帧。
• 只有 校验和 框架是由 compressZstdFrame （ZSTD_c_checksumFlag), decompressZstdPrefix 故意抑制 最终帧/校验和完成-调用者必须建立撕裂边界 在使用它之前自己。

许可证

麻省理工学院。源自DeepSeek线束代码库；看到 THIRD-PARTY-NOTICES.md 出处。