node.js流不支持composer镜像metadata动态转换，因其packages.json为php生态分层结构，需手动桥接解析逻辑；必须用stream-json等库流式提取子结构，避免chunk截断导致syntaxerror，并在流末尾集中计算sha256签名以满足composer校验要求。
Node.js 流处理本身不支持 Composer 镜像的 Metadata 动态转换——因为 Composer 的 packages.json 是 PHP 生态的静态元数据格式，Node.js 流（ReadableStream / TransformStream）默认只处理字节流或对象流，无法原生解析或生成符合 Composer 官方校验规则的 JSON 结构（比如带 notify-batch、providers 哈希、dist.reference 签名等字段）。必须手动桥接解析逻辑与流控制。
Composer metadata 结构不匹配 Node.js Stream 默认行为
Composer 的 packages.json 不是纯扁平 JSON，而是分层聚合结构：顶层含 packages、notify、notify-batch，每个包下又有 versions 数组，每个版本含 dist 和 source 对象。Node.js 的 JSON.parse() 无法增量解析这种嵌套结构；直接用 readable.pipe(JSONParseTransform) 会失败，因为整个文件必须一次性加载才能安全解析——这违背流式初衷。
实际做法是：先用 Readable 分块读取原始文件，再用 JSONStream 或自定义 Transform 按路径提取子结构（如 packages.vendor/package），或改用 stream-json 库的 parser() + streamValues() 组合做流式 JSON 路径匹配。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 不要对整份
packages.json直接调用JSON.parse(chunk.toString())—— chunk 可能截断在字符串中间，抛出SyntaxError: Unexpected end of JSON input - 若需重写
dist.shasum或注入私有dist.url，必须在解析后重建完整对象树，不能只 patch 片段 —— Composer 客户端会校验顶层packages的 SHA256 总和 -
highWaterMark设为1（对象流）比默认16更安全：避免 Transform 缓存过多未完成的包版本导致内存堆积
transform.write() 返回 false 时必须暂停上游读取
当你用 Transform 流修改每个包的 dist 字段并写入新 Writable（如文件或 HTTP 响应），如果下游写入慢（例如磁盘 I/O 延迟或网络限速），writable.write() 会返回 false。此时若不暂停上游 Readable 的 push()，缓冲区就会膨胀 —— 即使你用 pipeline()，它只自动处理 pipe() 链路的背压，对自定义 transform.write() 调用无感知。
- 监听
writable的drain事件，在回调里恢复readable.resume() - 在
transform._transform()中检查writable.write(data) === false，然后调用readable.pause() - 别依赖
pipeline()的自动错误传播来掩盖背压逻辑缺失 —— 它不会阻止内存溢出
metadata 签名与哈希校验必须在流末尾集中计算
Composer 要求最终输出的 packages.json 包含 providers 字段的 SHA256 值，以及整个文件的 content-hash。这些值无法在流中增量生成，必须等所有包处理完毕后，对最终 JSON 字符串重新计算。
- 用
Writable的write()收集所有处理后的包对象，而不是直接fs.createWriteStream写入磁盘 - 在
finish事件触发后，调用crypto.createHash('sha256').update(JSON.stringify(finalObj)).digest('hex') - 如果使用
pipeline()，需配合stream.pipeline的signal参数或手动监听end，避免在流结束前就尝试签名
真正麻烦的不是“怎么转”，而是“转完怎么让 Composer 认得”。Metadata 动态转换必须严格复现 Packagist 的字段生成逻辑，比如 dist.reference 要对应 Git commit hash，dist.url 要带 token 签名参数——这些细节一旦漏掉，composer install 就会静默跳过该包或报 Invalid package information 错误。
