hiperf_txt_parser 1.0.13 → 1.0.14

package/dist/serializer.d.ts

@@ -3,13 +3,15 @@ import type { PerfData } from "./types.js";
  * 将 PerfData 导出为与 sample/perf_data.txt 相同格式的文本（含缩进与每行前缀）
  */
 export declare function formatPerfDataToText(data: PerfData): string;
-/** 导出用 JSON 的单项：issuce 固定为 "unknow"，call_chain 为 frames 逐行拼接 */
-export interface RecordSampleJsonExportItem {
+/**
+ * 导出用 JSON 单项：固定含 `issuce`、`call_chain`；若存在 `traceFieldDict`，其键值对与二者**同级**平铺。
+ */
+export type RecordSampleJsonExportItem = {
     issuce: "unknow";
     call_chain: string;
-}
+} & Record<string, string>;
 /**
- * 将 PerfData 转为导出用 JSON 结构：顶层为数组，每项为 { issuce: "unknow", call_chain: "" }，
- * call_chain 由对应 record sample 的 callchainFrames.frames 逐行拼接得到，无则为空字符串。
+ * 将 PerfData 转为导出用 JSON 结构：顶层为数组。
+ * call_chain 由 callchainFrames.frames 拼接；有 traceFieldDict 时各字段平铺在对象顶层（与 call_chain 同级）。
  */
 export declare function formatPerfDataToJson(data: PerfData): RecordSampleJsonExportItem[];

package/dist/serializer.js

@@ -19,7 +19,18 @@ function serializeOneSample(sample) {
             lines.push(`    ${addr}`);
         }
     }
-    if (sample.raw) {
+    if (sample.traceFieldDict && Object.keys(sample.traceFieldDict).length > 0 && sample.raw) {
+        lines.push(`  raw size=${sample.raw.size}`);
+        for (const [k, v] of Object.entries(sample.traceFieldDict)) {
+            lines.push(`    ${k}: ${v}`);
+        }
+        const n = Object.keys(sample.traceFieldDict).length;
+        for (let i = n; i < sample.raw.lines.length; i++) {
+            const { hex, short } = sample.raw.lines[i];
+            lines.push(short ? `    ${hex} (${short})` : `    ${hex}`);
+        }
+    }
+    else if (sample.raw) {
         lines.push(`  raw size=${sample.raw.size}`);
         for (const { hex, short } of sample.raw.lines) {
             lines.push(short ? `    ${hex} (${short})` : `    ${hex}`);
@@ -47,12 +58,20 @@ export function formatPerfDataToText(data) {
     return data.recordSamples.map(serializeOneSample).join("\n\n");
 }
 /**
- * 将 PerfData 转为导出用 JSON 结构：顶层为数组，每项为 { issuce: "unknow", call_chain: "" }，
- * call_chain 由对应 record sample 的 callchainFrames.frames 逐行拼接得到，无则为空字符串。
+ * 将 PerfData 转为导出用 JSON 结构：顶层为数组。
+ * call_chain 由 callchainFrames.frames 拼接；有 traceFieldDict 时各字段平铺在对象顶层（与 call_chain 同级）。
  */
 export function formatPerfDataToJson(data) {
-    return data.recordSamples.map((s) => ({
-        issuce: "unknow",
-        call_chain: s.callchainFrames ? s.callchainFrames.frames.join("\n") : "",
-    }));
+    return data.recordSamples.map((s) => {
+        const item = {
+            issuce: "unknow",
+            call_chain: s.callchainFrames ? s.callchainFrames.frames.join("\n") : "",
+        };
+        if (s.traceFieldDict) {
+            for (const [k, v] of Object.entries(s.traceFieldDict)) {
+                item[k] = v;
+            }
+        }
+        return item;
+    });
 }

package/dist/traceFormat.d.ts

@@ -88,6 +88,7 @@ export declare function decodeRawByRegistry(raw: Uint8Array, registry: TracePars
  *
  * 规则：
  * - 若找到 common_type 对应解析器：将 print fmt 渲染结果写入 `sample.raw.lines`（一行）。
+ * - fieldDict：写入 `traceFieldDict`，`raw.lines` 为每行一条 `key: value`；`raw.size` 为行数（含可选 common 行）。
  * - 若找不到解析器：放弃解析，并将 `common_type` 写入 `sample.raw.lines`（一行）。
  */
 export declare function decodePerfRawData(perfData: PerfData, registry: TraceParserRegistry, options?: DecodePerfRawDataOptions): PerfData;

package/dist/traceFormat.js

@@ -441,6 +441,7 @@ export function decodeRawByRegistry(raw, registry, options = {}) {
  *
  * 规则：
  * - 若找到 common_type 对应解析器：将 print fmt 渲染结果写入 `sample.raw.lines`（一行）。
+ * - fieldDict：写入 `traceFieldDict`，`raw.lines` 为每行一条 `key: value`；`raw.size` 为行数（含可选 common 行）。
  * - 若找不到解析器：放弃解析，并将 `common_type` 写入 `sample.raw.lines`（一行）。
  */
 export function decodePerfRawData(perfData, registry, options = {}) {
@@ -461,8 +462,30 @@ export function decodePerfRawData(perfData, registry, options = {}) {
                     .map(([k, v]) => `${k}:${typeof v === "bigint" ? v.toString(10) : v}`)
                     .join(" ")
                 : "";
+            const dict = decoded.renderedFieldDict;
+            const useFieldDict = options.tracePrintMode === "fieldDict" &&
+                dict !== undefined &&
+                Object.keys(dict).length > 0;
+            if (useFieldDict) {
+                const kvLines = Object.entries(dict).map(([k, v]) => ({
+                    hex: `${k}: ${v}`,
+                }));
+                const lines = options.keepCommonFields && commonLine.length > 0
+                    ? [...kvLines, { hex: commonLine }]
+                    : kvLines;
+                return {
+                    ...sample,
+                    traceFieldDict: dict,
+                    raw: {
+                        ...sample.raw,
+                        size: lines.length,
+                        lines,
+                    },
+                };
+            }
             return {
                 ...sample,
+                traceFieldDict: undefined,
                 raw: {
                     ...sample.raw,
                     lines: options.keepCommonFields && commonLine.length > 0

package/dist/types.d.ts

@@ -39,6 +39,8 @@ export interface RecordSample {
     period: number;
     callchain?: CallchainEntry;
     raw?: RawEntry;
+    /** tracePrintMode 为 fieldDict 且解码成功时：print 各参数键值（用于导出 txt/json） */
+    traceFieldDict?: Record<string, string>;
     server?: ServerEntry;
     callchainFrames?: CallchainFramesEntry;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hiperf_txt_parser",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "Parse perf data.txt and output structured TypeScript data",
   "type": "module",
   "main": "dist/index.js",