用途:该技能生成 ClickHouse RowBinary 线格式的双向代码——读取器(字节解码为值)与写入器(值编码为字节),通常一次任务只需其中一侧。入口文件负责格式判断与通用原则,具体决策和按类型参考表分别放在 reader.md 与 writer.md 两个同级文件中。
主要能力:按方向提供真实代码,读取器位于 src/readers/,写入器位于 src/writers/。读取侧覆盖流式与整缓冲、行对象与列式、固定与运行时 schema;写入侧提供 Sink/writeX 构建块与 writeRows 流式写入。
使用方式:先判断 RowBinary 是否合适。结果以字符串或类 JSON 值为主、整体消费时,优先 JSON* 格式(如 JSONEachRow),配合 gzip/zstd 压缩;宽数值(Int128/Int256/UInt128/UInt256、Decimal128/Decimal256)、二进制或定宽块(IPv4、IPv6、UUID、FixedString)以及高吞吐定宽数值列时 RowBinary 更优;列式加载与客户端分析优先 Native 格式。通用原则:仅小端,用 DataView 访问器并传字面量 true;先正确后优化;对已知类型做单态化内联;每列注释其 ClickHouse 类型;共享 scratch 不可重入,异步边界会破坏值;默认生成 TypeScript。
适用场景:Node.js 中为 ClickHouse HTTP 服务器编写高性能 RowBinary 编解码器。
限制:不涉及 JSON/CSV/TSV/Parquet 解析(用 clickhouse-js-node-coding)、连接错误与类型不匹配(用 clickhouse-js-node-troubleshooting)、浏览器/Web Worker/Edge(用 @clickhouse/client-web)。具体安装命令、收费与平台信息暂未提供。