hiperf_txt_parser 1.0.0

package/README.md

@@ -0,0 +1,74 @@
+# hiperf_txt_parser
+
+将 perf 文本中的 `record sample` 段解析为结构化数据，并支持导出为：
+- perf 原文本格式（保留缩进和行前缀）
+- JSON 数组格式（每项为 `{ "issuce": "unknow", "call_chain": "..." }`）
+
+> 本项目当前为 **纯 lib 库**，`src` 仅保留库代码，不包含 CLI。
+
+## 安装
+
+```bash
+npm install hiperf_txt_parser
+```
+
+本地调试可直接安装本地路径：
+
+```bash
+npm install /Users/fanghaolei/Workplace/TS/snapshot_checker
+```
+
+## 对外 API
+
+```ts
+import {
+  parsePerfData,
+  formatPerfDataToText,
+  formatPerfDataToJson,
+} from "hiperf_txt_parser";
+```
+
+- `parsePerfData(text: string): PerfData`
+- `formatPerfDataToText(data: PerfData): string`
+- `formatPerfDataToJson(data: PerfData): Array<{ issuce: "unknow"; call_chain: string }>`
+
+## 快速示例
+
+```ts
+import { parsePerfData, formatPerfDataToJson, formatPerfDataToText } from "hiperf_txt_parser";
+
+const input = `record sample: type 9, misc 2, size 520\n  sample_type: 0x8000107e7\n  ID 13`;
+
+const parsed = parsePerfData(input);
+const jsonArray = formatPerfDataToJson(parsed);
+const txt = formatPerfDataToText(parsed);
+```
+
+## Consumer Demo（外部 TS 项目）
+
+提供了两个 demo：
+
+- `demo/external-ts-consumer`：最小调用示例
+- `demo/lib-consumer`：读取 `sample/perf_data.txt`，导出 json/txt 到 `out/lib-consumer/`
+
+运行文件 I/O demo：
+
+```bash
+cd demo/lib-consumer
+npm install
+npm run demo
+```
+
+## 输出结构说明
+
+- 解析结构（`parsePerfData`）：`{ recordSamples: RecordSample[] }`
+- JSON 导出（`formatPerfDataToJson`）：
+
+```json
+[
+  {
+    "issuce": "unknow",
+    "call_chain": "frame1\\nframe2\\nframe3"
+  }
+]
+```

package/dist/__tests__/parser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/parser.test.js

@@ -0,0 +1,163 @@
+import { describe, it } from "node:test";
+import assert from "node:assert";
+import { parsePerfData } from "../parser.js";
+import { formatPerfDataToText } from "../serializer.js";
+const SAMPLE_TWO_RECORDS = `record sample: type 9, misc 2, size 520
+  sample_type: 0x8000107e7
+  ID 13
+  ip ffffffff8d20008c
+  pid 1234, tid 1234
+  time 98022340124
+  stream_id 13
+  cpu 1, res 0
+  period 1
+  callchain nr=2
+    0xffffff800c2b1f2c
+    0x5a5ccdea58
+    0x5a5ccd83ec
+  raw size=8
+    0x000081d2 (81d2)
+    0x00001e89 (1e89)
+  server nr=2
+    pid: 2
+    pid: 1234
+  
+  callchain: 2
+    03:0xffffff800c2b1f2c : sysxxx@0xffffff800c2b1f2c@0xffffff800c2b1f2c:18446744073709551615
+    02:0x5a5ccdea58 : /system/lib/ld-musl-aarch64.so.1+0xa4a58@/system/lib/ld-musl-aarch64.so.1:18446744073709551615
+    01:dlopen_impl[0x0000005a5ccd7bf0:0x000000000009dbf0][0x7fc]@/system/lib/ld-musl-aarch64.so.1:0
+
+record sample: type 9, misc 2, size 520
+  sample_type: 0x8000107e7
+  ID 13
+  ip ffffffff8d20008c
+  pid 1234, tid 1234
+  time 98022340124
+  stream_id 13
+  cpu 1, res 0
+  period 1
+  callchain nr=2
+    0xffffff800c2b1f2c
+    0x5a5ccdea58
+    0x5a5ccd83ec
+  raw size=8
+    0x000081d2 (81d2)
+    0x00001e89 (1e89)
+  server nr=2
+    pid: 2
+    pid: 1234
+  
+  callchain: 2
+    03:0xffffff800c2b1f2c : sysxxx@0xffffff800c2b1f2c@0xffffff800c2b1f2c:18446744073709551615
+    02:0x5a5ccdea58 : /system/lib/ld-musl-aarch64.so.1+0xa4a58@/system/lib/ld-musl-aarch64.so.1:18446744073709551615
+    01:dlopen_impl[0x0000005a5ccd7bf0:0x000000000009dbf0][0x7fc]@/system/lib/ld-musl-aarch64.so.1:0`;
+describe("parsePerfData", () => {
+    it("应解析出 2 个 record sample", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        assert.strictEqual(data.recordSamples.length, 2);
+    });
+    it("每个 record sample 应包含正确的 header", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        for (const sample of data.recordSamples) {
+            assert.deepStrictEqual(sample.header, { type: 9, misc: 2, size: 520 });
+        }
+    });
+    it("应解析 sample_type、id、ip、pid、tid、time 等字段", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        const s = data.recordSamples[0];
+        assert.strictEqual(s.sample_type, "0x8000107e7");
+        assert.strictEqual(s.id, 13);
+        assert.strictEqual(s.ip, "ffffffff8d20008c");
+        assert.strictEqual(s.pid, 1234);
+        assert.strictEqual(s.tid, 1234);
+        assert.strictEqual(s.time, 98022340124);
+        assert.strictEqual(s.stream_id, 13);
+        assert.strictEqual(s.cpu, 1);
+        assert.strictEqual(s.res, 0);
+        assert.strictEqual(s.period, 1);
+    });
+    it("应解析 callchain (nr + addresses)", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        const s = data.recordSamples[0];
+        assert(s.callchain);
+        assert.strictEqual(s.callchain.nr, 2);
+        assert.deepStrictEqual(s.callchain.addresses, [
+            "0xffffff800c2b1f2c",
+            "0x5a5ccdea58",
+            "0x5a5ccd83ec",
+        ]);
+    });
+    it("应解析 raw (size + hex lines)", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        const s = data.recordSamples[0];
+        assert(s.raw);
+        assert.strictEqual(s.raw.size, 8);
+        assert.deepStrictEqual(s.raw.lines, [
+            { hex: "0x000081d2", short: "81d2" },
+            { hex: "0x00001e89", short: "1e89" },
+        ]);
+    });
+    it("应解析 server (nr + pids)", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        const s = data.recordSamples[0];
+        assert(s.server);
+        assert.strictEqual(s.server.nr, 2);
+        assert.deepStrictEqual(s.server.pids, [2, 1234]);
+    });
+    it("应解析 callchainFrames (callchain: N + frame 行)", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        const s = data.recordSamples[0];
+        assert(s.callchainFrames);
+        assert.strictEqual(s.callchainFrames.count, 2);
+        assert.strictEqual(s.callchainFrames.frames.length, 3);
+        assert(s.callchainFrames.frames[0].includes("sysxxx"));
+        assert(s.callchainFrames.frames[1].includes("ld-musl-aarch64.so.1"));
+        assert(s.callchainFrames.frames[2].includes("dlopen_impl"));
+    });
+    it("应忽略 record comm 块，只保留 record sample", () => {
+        const text = `record comm: size 32
+  comm: bash
+
+record sample: type 9, misc 2, size 520
+  sample_type: 0x8000107e7
+  ID 13
+  ip ffffffff8d20008c
+  pid 1234, tid 1234
+  time 98022340124
+  stream_id 13
+  cpu 1, res 0
+  period 1
+
+record comm: size 16
+  comm: node
+
+record sample: type 9, misc 2, size 520
+  sample_type: 0x8000107e7
+  ID 1
+  ip 0
+  pid 0, tid 0
+  time 0
+  stream_id 0
+  cpu 0, res 0
+  period 0`;
+        const data = parsePerfData(text);
+        assert.strictEqual(data.recordSamples.length, 2);
+        assert.strictEqual(data.recordSamples[0].id, 13);
+        assert.strictEqual(data.recordSamples[1].id, 1);
+    });
+    it("空文本应返回空 recordSamples", () => {
+        const data = parsePerfData("");
+        assert.deepStrictEqual(data.recordSamples, []);
+    });
+    it("仅有 record comm 时应返回空 recordSamples", () => {
+        const data = parsePerfData("record comm: size 32\n  comm: bash");
+        assert.deepStrictEqual(data.recordSamples, []);
+    });
+    it("导出为文本后再解析应得到相同结构（往返一致）", () => {
+        const data = parsePerfData(SAMPLE_TWO_RECORDS);
+        const text = formatPerfDataToText(data);
+        const data2 = parsePerfData(text);
+        assert.deepStrictEqual(data.recordSamples.length, data2.recordSamples.length);
+        assert.deepStrictEqual(data.recordSamples, data2.recordSamples);
+    });
+});

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { resolve, dirname } from "path";
+import { parsePerfData } from "./parser.js";
+import { formatPerfDataToText, formatPerfDataToJson } from "./serializer.js";
+const HELP = `perf_parser — 解析 perf data 文本，仅提取 record sample 并输出
+
+用法:
+  perf_parser --input_file <path> [--output_file <path>] [--output_json <path>]
+
+Flags:
+  --input_file <path>    (必填) 输入的 perf data 文本文件路径，如 perf_data.txt
+  --output_file <path>   (可选) 导出 txt（与 sample 同格式）到该路径；若与 --output_json 同时指定则同时输出 txt 与 json
+  --output_json <path>   (可选) 导出 json 到该路径（callchainFrames.frames 用 \\n 拼接，每条带 issue: Unknow）；若与 --output_file 同时指定则同时输出 txt 与 json
+  --help, -h             显示此帮助
+`;
+function parseArgs(argv) {
+    const out = { help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            out.help = true;
+            return out;
+        }
+        if (arg === "--input_file" && argv[i + 1] && !argv[i + 1].startsWith("-")) {
+            out.inputFile = argv[++i];
+        }
+        else if (arg.startsWith("--input_file=")) {
+            out.inputFile = arg.slice("--input_file=".length);
+        }
+        else if (arg === "--output_file" && argv[i + 1] && !argv[i + 1].startsWith("-")) {
+            out.outputFile = argv[++i];
+        }
+        else if (arg.startsWith("--output_file=")) {
+            out.outputFile = arg.slice("--output_file=".length);
+        }
+        else if (arg === "--output_json" && argv[i + 1] && !argv[i + 1].startsWith("-")) {
+            out.outputJson = argv[++i];
+        }
+        else if (arg.startsWith("--output_json=")) {
+            out.outputJson = arg.slice("--output_json=".length);
+        }
+    }
+    return out;
+}
+const args = parseArgs(process.argv.slice(2));
+if (args.help) {
+    console.log(HELP);
+    process.exit(0);
+}
+if (!args.inputFile) {
+    console.error("错误: 请使用 --input_file 指定输入文件。");
+    console.error(HELP);
+    process.exit(1);
+}
+const inputPath = resolve(process.cwd(), args.inputFile);
+let text;
+try {
+    text = readFileSync(inputPath, "utf-8");
+}
+catch (e) {
+    console.error("无法读取文件:", inputPath, e.message);
+    process.exit(1);
+}
+const data = parsePerfData(text);
+const jsonContent = JSON.stringify(formatPerfDataToJson(data), null, 2);
+const textContent = formatPerfDataToText(data);
+function writeTo(path, content) {
+    const outPath = resolve(process.cwd(), path);
+    const outDir = dirname(outPath);
+    mkdirSync(outDir, { recursive: true });
+    writeFileSync(outPath, content, "utf-8");
+    console.error("已写入:", outPath);
+}
+if (args.outputJson) {
+    try {
+        writeTo(args.outputJson, jsonContent);
+    }
+    catch (e) {
+        console.error("无法写入 JSON 文件:", e.message);
+        process.exit(1);
+    }
+}
+if (args.outputFile) {
+    try {
+        writeTo(args.outputFile, textContent);
+    }
+    catch (e) {
+        console.error("无法写入 txt 文件:", e.message);
+        process.exit(1);
+    }
+}
+if (!args.outputJson && !args.outputFile) {
+    console.log(jsonContent);
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { parsePerfData } from "./parser.js";
+export { formatPerfDataToText, formatPerfDataToJson } from "./serializer.js";
+export type { PerfData, RecordSample } from "./types.js";
+export type { RecordSampleJsonExportItem } from "./serializer.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { parsePerfData } from "./parser.js";
+export { formatPerfDataToText, formatPerfDataToJson } from "./serializer.js";

package/dist/parser.d.ts

@@ -0,0 +1,5 @@
+import type { PerfData } from "./types.js";
+/**
+ * 解析 perf data 文本，仅返回 record sample 结构数组
+ */
+export declare function parsePerfData(text: string): PerfData;

package/dist/parser.js

@@ -0,0 +1,204 @@
+const RECORD_SAMPLE_PREFIX = "record sample:";
+const RECORD_COMM_PREFIX = "record comm";
+/**
+ * 获取行首空格数量（缩进）
+ */
+function getIndent(line) {
+    const m = line.match(/^(\s*)/);
+    return m ? m[1].length : 0;
+}
+/**
+ * 解析 "record sample: type 9, misc 2, size 520" 行
+ */
+function parseHeaderLine(line) {
+    const typeMatch = line.match(/type\s+(\d+)/);
+    const miscMatch = line.match(/misc\s+(\d+)/);
+    const sizeMatch = line.match(/size\s+(\d+)/);
+    return {
+        type: typeMatch ? parseInt(typeMatch[1], 10) : 0,
+        misc: miscMatch ? parseInt(miscMatch[1], 10) : 0,
+        size: sizeMatch ? parseInt(sizeMatch[1], 10) : 0,
+    };
+}
+/**
+ * 解析单个 record sample 块（已按行切分好的行数组）
+ */
+function parseOneBlock(lines) {
+    if (lines.length === 0 || !lines[0].trimStart().startsWith(RECORD_SAMPLE_PREFIX)) {
+        throw new Error("Invalid record sample block");
+    }
+    const header = parseHeaderLine(lines[0]);
+    const sample = {
+        header,
+        sample_type: "",
+        id: 0,
+        ip: "",
+        pid: 0,
+        tid: 0,
+        time: 0,
+        stream_id: 0,
+        cpu: 0,
+        res: 0,
+        period: 0,
+    };
+    let i = 1;
+    while (i < lines.length) {
+        const line = lines[i];
+        const indent = getIndent(line);
+        const trimmed = line.trimStart();
+        if (indent === 0 && trimmed.length > 0) {
+            break;
+        }
+        if (indent === 2) {
+            if (trimmed.startsWith("sample_type:")) {
+                sample.sample_type = trimmed.replace(/^sample_type:\s*/, "").trim();
+            }
+            else if (trimmed.startsWith("ID ")) {
+                sample.id = parseInt(trimmed.replace(/^ID\s+/, ""), 10) || 0;
+            }
+            else if (trimmed.startsWith("ip ")) {
+                sample.ip = trimmed.replace(/^ip\s+/, "").trim();
+            }
+            else if (trimmed.startsWith("pid ") && trimmed.includes(", tid ")) {
+                const pidMatch = trimmed.match(/pid\s+(\d+).*tid\s+(\d+)/);
+                if (pidMatch) {
+                    sample.pid = parseInt(pidMatch[1], 10);
+                    sample.tid = parseInt(pidMatch[2], 10);
+                }
+            }
+            else if (trimmed.startsWith("time ")) {
+                sample.time = parseInt(trimmed.replace(/^time\s+/, ""), 10) || 0;
+            }
+            else if (trimmed.startsWith("stream_id ")) {
+                sample.stream_id = parseInt(trimmed.replace(/^stream_id\s+/, ""), 10) || 0;
+            }
+            else if (trimmed.startsWith("cpu ") && trimmed.includes(", res ")) {
+                const cpuMatch = trimmed.match(/cpu\s+(\d+).*res\s+(\d+)/);
+                if (cpuMatch) {
+                    sample.cpu = parseInt(cpuMatch[1], 10);
+                    sample.res = parseInt(cpuMatch[2], 10);
+                }
+            }
+            else if (trimmed.startsWith("period ")) {
+                sample.period = parseInt(trimmed.replace(/^period\s+/, ""), 10) || 0;
+            }
+            else if (trimmed.startsWith("callchain nr=")) {
+                const nrMatch = trimmed.match(/callchain\s+nr=(\d+)/);
+                const nr = nrMatch ? parseInt(nrMatch[1], 10) : 0;
+                const addresses = [];
+                i++;
+                while (i < lines.length && getIndent(lines[i]) >= 4) {
+                    const addr = lines[i].trim();
+                    if (addr && /^0x[0-9a-fA-F]+$/.test(addr)) {
+                        addresses.push(addr);
+                    }
+                    i++;
+                }
+                sample.callchain = { nr, addresses };
+                continue;
+            }
+            else if (trimmed.startsWith("raw size=")) {
+                const sizeMatch = trimmed.match(/raw\s+size=(\d+)/);
+                const size = sizeMatch ? parseInt(sizeMatch[1], 10) : 0;
+                const entries = [];
+                i++;
+                while (i < lines.length && getIndent(lines[i]) >= 4) {
+                    const rawLine = lines[i].trim();
+                    const hexShort = rawLine.match(/^(0x[0-9a-fA-F]+)\s*\(([0-9a-fA-F]+)\)$/);
+                    if (hexShort) {
+                        entries.push({ hex: hexShort[1], short: hexShort[2] });
+                    }
+                    else if (rawLine.startsWith("0x")) {
+                        entries.push({ hex: rawLine });
+                    }
+                    i++;
+                }
+                sample.raw = { size, lines: entries };
+                continue;
+            }
+            else if (trimmed.startsWith("server nr=")) {
+                const nrMatch = trimmed.match(/server\s+nr=(\d+)/);
+                const nr = nrMatch ? parseInt(nrMatch[1], 10) : 0;
+                const pids = [];
+                i++;
+                while (i < lines.length && getIndent(lines[i]) >= 4) {
+                    const pidMatch = lines[i].trim().match(/pid:\s*(\d+)/);
+                    if (pidMatch) {
+                        pids.push(parseInt(pidMatch[1], 10));
+                    }
+                    i++;
+                }
+                sample.server = { nr, pids };
+                continue;
+            }
+            else if (trimmed.startsWith("callchain: ")) {
+                const countMatch = trimmed.match(/callchain:\s*(\d+)/);
+                const count = countMatch ? parseInt(countMatch[1], 10) : 0;
+                const frames = [];
+                i++;
+                while (i < lines.length && getIndent(lines[i]) >= 4) {
+                    frames.push(lines[i].trim());
+                    i++;
+                }
+                sample.callchainFrames = { count, frames };
+                continue;
+            }
+        }
+        i++;
+    }
+    return sample;
+}
+/**
+ * 从完整文本中提取所有 record sample 块（忽略 record comm 等）
+ */
+function extractRecordSampleBlocks(text) {
+    const lines = text.split(/\r?\n/);
+    const blocks = [];
+    let current = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trimStart();
+        const indent = getIndent(line);
+        if (trimmed.startsWith(RECORD_SAMPLE_PREFIX) && indent === 0) {
+            if (current.length > 0) {
+                blocks.push(current);
+            }
+            current = [line];
+            continue;
+        }
+        if (trimmed.startsWith(RECORD_COMM_PREFIX) && indent === 0) {
+            if (current.length > 0) {
+                blocks.push(current);
+                current = [];
+            }
+            continue;
+        }
+        if (current.length > 0) {
+            current.push(line);
+        }
+    }
+    if (current.length > 0) {
+        blocks.push(current);
+    }
+    return blocks;
+}
+/**
+ * 解析 perf data 文本，仅返回 record sample 结构数组
+ */
+export function parsePerfData(text) {
+    const blocks = extractRecordSampleBlocks(text);
+    const recordSamples = [];
+    for (const block of blocks) {
+        if (block.length === 0)
+            continue;
+        if (!block[0].trimStart().startsWith(RECORD_SAMPLE_PREFIX))
+            continue;
+        try {
+            recordSamples.push(parseOneBlock(block));
+        }
+        catch {
+            // 跳过无法解析的块
+        }
+    }
+    return { recordSamples };
+}

package/dist/serializer.d.ts

@@ -0,0 +1,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 {
+    issuce: "unknow";
+    call_chain: string;
+}
+/**
+ * 将 PerfData 转为导出用 JSON 结构：顶层为数组，每项为 { issuce: "unknow", call_chain: "" }，
+ * call_chain 由对应 record sample 的 callchainFrames.frames 逐行拼接得到，无则为空字符串。
+ */
+export declare function formatPerfDataToJson(data: PerfData): RecordSampleJsonExportItem[];

package/dist/serializer.js

@@ -0,0 +1,58 @@
+/**
+ * 将单个 RecordSample 序列化为与 sample/perf_data.txt 一致的文本格式（含缩进与行前缀）
+ */
+function serializeOneSample(sample) {
+    const lines = [];
+    const { header } = sample;
+    lines.push(`record sample: type ${header.type}, misc ${header.misc}, size ${header.size}`);
+    lines.push(`  sample_type: ${sample.sample_type}`);
+    lines.push(`  ID ${sample.id}`);
+    lines.push(`  ip ${sample.ip}`);
+    lines.push(`  pid ${sample.pid}, tid ${sample.tid}`);
+    lines.push(`  time ${sample.time}`);
+    lines.push(`  stream_id ${sample.stream_id}`);
+    lines.push(`  cpu ${sample.cpu}, res ${sample.res}`);
+    lines.push(`  period ${sample.period}`);
+    if (sample.callchain) {
+        lines.push(`  callchain nr=${sample.callchain.nr}`);
+        for (const addr of sample.callchain.addresses) {
+            lines.push(`    ${addr}`);
+        }
+    }
+    if (sample.raw) {
+        lines.push(`  raw size=${sample.raw.size}`);
+        for (const { hex, short } of sample.raw.lines) {
+            lines.push(short ? `    ${hex} (${short})` : `    ${hex}`);
+        }
+    }
+    if (sample.server) {
+        lines.push(`  server nr=${sample.server.nr}`);
+        for (const pid of sample.server.pids) {
+            lines.push(`    pid: ${pid}`);
+        }
+    }
+    if (sample.callchainFrames) {
+        lines.push(`  `);
+        lines.push(`  callchain: ${sample.callchainFrames.count}`);
+        for (const frame of sample.callchainFrames.frames) {
+            lines.push(`    ${frame}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * 将 PerfData 导出为与 sample/perf_data.txt 相同格式的文本（含缩进与每行前缀）
+ */
+export function formatPerfDataToText(data) {
+    return data.recordSamples.map(serializeOneSample).join("\n\n");
+}
+/**
+ * 将 PerfData 转为导出用 JSON 结构：顶层为数组，每项为 { issuce: "unknow", call_chain: "" }，
+ * call_chain 由对应 record sample 的 callchainFrames.frames 逐行拼接得到，无则为空字符串。
+ */
+export function formatPerfDataToJson(data) {
+    return data.recordSamples.map((s) => ({
+        issuce: "unknow",
+        call_chain: s.callchainFrames ? s.callchainFrames.frames.join("\n") : "",
+    }));
+}

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 解析后的 perf record sample 结构
+ */
+export interface RecordSampleHeader {
+    type: number;
+    misc: number;
+    size: number;
+}
+export interface CallchainEntry {
+    nr: number;
+    addresses: string[];
+}
+export interface RawEntry {
+    size: number;
+    lines: Array<{
+        hex: string;
+        short?: string;
+    }>;
+}
+export interface ServerEntry {
+    nr: number;
+    pids: number[];
+}
+export interface CallchainFramesEntry {
+    count: number;
+    frames: string[];
+}
+export interface RecordSample {
+    header: RecordSampleHeader;
+    sample_type: string;
+    id: number;
+    ip: string;
+    pid: number;
+    tid: number;
+    time: number;
+    stream_id: number;
+    cpu: number;
+    res: number;
+    period: number;
+    callchain?: CallchainEntry;
+    raw?: RawEntry;
+    server?: ServerEntry;
+    callchainFrames?: CallchainFramesEntry;
+}
+export type PerfData = {
+    recordSamples: RecordSample[];
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "hiperf_txt_parser",
+  "version": "1.0.0",
+  "description": "Parse perf data.txt and output structured TypeScript data",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test dist/__tests__/parser.test.js"
+  },
+  "keywords": ["perf", "parser", "library"],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "typescript": "^5.7.2"
+  }
+}