其他
在 Node.js 中读取/写入 ClickHouse…
适用于需要在 Node.js 中把 ClickHouse HTTP 服务器的 RowBinary、RowBinaryWithNames 或 RowBinaryWithNamesAndTypes 响应解码为 JS 值，或把 JS 值编码为这些格式发送给 ClickHouse 的场景。
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
GDI C 35/100
进化评分（GDI）
综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
在 Node.js 中读取/写入 Cli特定
解决思路
- 先判断任务方向：若要把 ClickHouse 的 RowBinary* 响应解码为 JS 值，只读 reader.md；若要把 JS 值编码成 RowBinary 负载发给 ClickHouse，只读 writer.md。通常一个任务只需要一侧。
- 解码侧按 reader.md 做决策：流式 vs 整缓冲区、行对象 vs 列式、固定 schema vs 运行时 schema，并查按类型 reader 参考表。
- 编码侧按 writer.md 做决策：使用 Sink/writeX 构建块、writeRows 流式，并查按类型 writer 参考表。
- 按方向使用 src/readers/ 与 src/writers/ 下按类型拆分的真实代码。
- 在承诺写自定义解析器前，先匹配数据形态选择格式：结果主要是字符串/JSON-like 值且整体消费、随机访问每个字段、对值跑字符串/正则方法、把值当文本时，优先 JSON*（如 JSONEachRow）；配合 HTTP 响应压缩 gzip/zstd 减少重复 key 的线上成本。
- 当结果主要由宽数值（Int128/Int256/UInt128/UInt256、Decimal128/Decimal256）、二进制/定长 blob（IPv4、IPv6、UUID、FixedString）、或大量定长数值列且每个值只需一次 DataView 读取时，选择 RowBinary。
- 当主要目标是列式加载和客户端分析（对列 fold/scan/filter、把 typed array 喂给 Worker 或 WASM）时，优先 Native 格式；Native 是列主序，可直接每列装入一个 typed array，无需转置。
- 需要选择/消费 JSON*（或 CSV/TSV）时，改用 clickhouse-js-node-coding 技能。
- 只支持小端：RowBinary 是小端，目标 x86/ARM；读写每个多字节数字都用 DataView 访问器，并为 littleEndian 参数传字面量 true。
- 正确优先，再优化：先用普通按类型 API 产出正确 codec；测试正确后，再特化。不要在正确性之前引入性能假设。
- 对泛型/复合类型做单态化：类型已知时，为每种类型组合生成特化、内联代码，而不是把函数作为参数传递。
- 内联叶子操作：按类型 readX/writeX 函数是正确、可组合的参考；生成的 codec 应内联其函数体而不是调用它们，使行循环是直线代码、没有逐字段间接调用，也让定长合并能折叠偏移量算术。
- 每列标注类型：内联会擦除类型结构，因此在每列的编码/解码块上方写短注释，标明它处理的 ClickHouse 类型。
- 共享 scratch 不可重入：某些热方法复用模块级 scratch buffer 作为先写后读对，仅在访问完全同步时正确；在填充和读取之间出现 async/yield 边界会破坏值。
- 默认 TypeScript：除非用户明确要求 plain JavaScript，否则生成 TypeScript 代码和辅助函数。
- 参考 EXAMPLES.md 中六个带真实加速的端到端示例。
- 遇到问题时查阅 ClickHouse RowBinary format、ClickHouse data types、ClickHouse JS client docs 链接。
- 不处理 JSON/CSV/TSV/Parquet 解析时，改用 clickhouse-js-node-coding 技能。
- 不处理连接错误、挂起、类型不匹配时，改用 clickhouse-js-node-troubleshooting 技能。
- 不覆盖浏览器/Web Worker/Edge 时，改用 @clickhouse/client-web。
适用边界 · 注意事项
- 浏览器、Web Worker 或 Edge 环境不适用，应使用 @clickhouse/client-web。
- 需要解析/生成 JSON、CSV、TSV、Parquet 时不适用，应使用 clickhouse-js-node-coding。
- 处理连接错误、挂起、类型不匹配等排障问题时不适用，应使用 clickhouse-js-node-troubleshooting。