# @clinic/flame 中文文档

规范地址：https://npmcn.com/package/%40clinic/flame/

版本：13\.0\.0
npm 元数据更新时间：2023-06-27T20:57:58.910Z
中文译文更新时间：2026-11-10T01:46:09.389Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40clinic/flame
原文对照：https://npmcn.com/package/%40clinic/flame/?lang=original
项目主页：https://github.com/clinicjs/node-clinic-flame#readme
源码仓库：https://github.com/clinicjs/node-clinic-flame

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：457 kB，173 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：11 个
- 首次发布：2021-11-12T15:03:18.818Z
- 最新版本发布：2023-06-27T20:57:58.646Z
- 近 30 天下载量：169224（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 0 个）

## 中文简介

Clinic.js Flame 可编程界面

## 安装

```sh
npm install @clinic/flame
```

也可以使用：`pnpm add @clinic/flame`、`yarn add @clinic/flame`、`bun add @clinic/flame`

## README

# 诊所.js 火焰

[![npm version](https://img.shields.io/npm/v/@clinic/flame.svg?style=flat-square)](https://www.npmjs.org/@clinic/flame) [![Stability Stable](https://img.shields.io/badge/stability-stable-green.svg?style=flat-square)](https://nodejs.org/api/documentation.html#documentation_stability_index) [![Github Actions build status](https://github.com/clinicjs/node-clinic-flame/workflows/CI/badge.svg)](https://github.com/clinicjs/node-clinic-flame/actions) [![Downloads](http://img.shields.io/npm/dm/@clinic/flame.svg?style=flat-square)](https://www.npmjs.org/@clinic/flame) [![Code style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/feross/standard)

可编程接口到 [诊所.js](https://github.com/clinicjs/node-clinic) 发焰. 更多关于诊所的知识 [https://clinicjs.org/ (中文(简体) )](https://clinicjs.org/)

![Screenshot](https://npmcn.com/package/%40clinic/flame/screenshot.png)

## 问题

打开一个问题,请使用 [主要仓库](https://github.com/clinicjs/node-clinic) 与 `flame` 标签.

## 安装

```
npm i -S @clinic/flame
```

## 支持的节点版本

-   16及以上节点j

## 示例

```js
const ClinicFlame = require('@clinic/flame')
const flame = new ClinicFlame()

flame.collect(['node', './path-to-script.js'], function (err, filepath) {
  if (err) throw err

  flame.visualize(filepath, filepath + '.html', function (err) {
    if (err) throw err
  })
})
```

## 文档

```js
const ClinicFlame = require('@clinic/flame')
const flame = new ClinicFlame()
```

### 新临床火焰( \[设置\])

-   设置 [`<Object>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)
    -   检测端口 [`<boolean>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type) **默认**错误
    -   调试 [`<boolean>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type) 如果设置为真, 生成的 html 将不会被修改 . **默认**错误
    -   离线 [`<String>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String) 存储所收集数据的文件夹 . **默认**:"'
    -   内核跟踪 [`<boolean>`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type) 如果设定为真, 它将使用 `linux_perf` 以配置应用程序. (仅在linux上提供) **默认**错误

#### `flame.collect(args, callback)`

通过使用 [0个](https://github.com/davidmarkclements/0x)

0x 将在当前的工作目录中生成一个文件, 进程 PID 在 它的文件名。 相对于当前工作目录的文件路径是 值.

`stdout`, (中文(简体) ), `stderr`,以及 `stdin` 将转发到呼叫程序。 也一样 页:1 `SIGINT` 活动.

#### `flame.visualize(dataFilename, outputFilename, callback)`

将消耗由 `dataFilename`,此数据文件将是 采样者使用 `flame.collect`。 。 。 .

`flame.visualize` 然后输出一个独立的 HTML 文件到 `outputFilename`。 。 。 . 完成后 `callback` 将被调用,除了一个 可能的错误.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40clinic/flame/LICENSE)

## 常见问题

### @clinic/flame 是什么？

Clinic\.js Flame 可编程界面

### 如何安装 @clinic/flame？

在项目目录运行 npm install @clinic/flame，或使用 pnpm add / yarn add / bun add。

### @clinic/flame 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/clinic\_\_flame 是否存在。

### @clinic/flame 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @clinic/flame 可以商用吗？

@clinic/flame 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @clinic/flame 的下载量有多少？

根据 npm 官方下载统计，@clinic/flame 在 2026/10/10 – 2026/11/08 这 30 天内被下载 169,224 次，日均约 5,641 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @clinic/flame 还在维护吗？

最新版本 13\.0\.0 发布于 2023/06/28（3 年前）；至今共发布 9 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/11/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。