# @alexaltea/capstone-js 中文文档

规范地址：https://npmcn.com/package/%40alexaltea/capstone-js/

版本：5\.0\.9
npm 元数据更新时间：2026-06-15T18:35:55.047Z
中文译文更新时间：2026-11-05T23:51:25.461Z
软件包许可：BSD-3-Clause

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

原始 npm 页面：https://www.npmjs.com/package/%40alexaltea/capstone-js
原文对照：https://npmcn.com/package/%40alexaltea/capstone-js/?lang=original
项目主页：http://alexaltea.github.io/capstone.js/
源码仓库：https://github.com/AlexAltea/capstone.js

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

- 包体积（解压后）：3.6 MB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2022-05-25T13:57:32.437Z
- 最新版本发布：2026-06-15T18:35:54.938Z
- 近 30 天下载量：8926（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 1 个）

## 中文简介

JavaScript 的 Capstone 拆卸框架端口

## 安装

```sh
npm install @alexaltea/capstone-js
```

也可以使用：`pnpm add @alexaltea/capstone-js`、`yarn add @alexaltea/capstone-js`、`bun add @alexaltea/capstone-js`

## README

# (原始内容存档于2018-06-21). Capstone.js

港口 [顶岩](https://github.com/aquynh/capstone) javaScript/WASM的分解框架. 电源 [标记](https://github.com/emscripten-core/emscripten)。 。 。 .

**所需经费:** JavaScript 环境 [网络大会](https://developer.mozilla.org/en-US/docs/WebAssembly) 财务报告和审定财务报表 [大点](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt) 支助.

**注释:** _顶岩_ 是一种轻量级的多结构分解框架,最初由阮安奎恩开发并被BSD许可放出. 关于贡献者和许可条款的更多信息可见于文件 `CREDITS.TXT` 财务报告和审定财务报表 `LICENSE.TXT` 会 议 日 程 和 议 程 _顶点石_ 此寄存器中的子模块 .

## 安装

要将 Capstone.js 添加到您的网页应用程序中,请包括:

```html
<script src="capstone.js"></script>
```

或与国家预防机制指挥部安装:

```bash
npm install @alexaltea/capstone-js
```

## 使用量

```javascript
// Input: Machine code bytes and offset where they are located
var buffer = [0x55, 0x31, 0xD2, 0x89, 0xE5, 0x8B, 0x45, 0x08];
var offset = 0x10000;

MCapstone().then((cs) => {
    // Initialize the decoder
    var d = new cs.Capstone(cs.ARCH_X86, cs.MODE_32);

    // Output: Array of cs.Instruction objects
    var instructions = d.disasm(buffer, offset);

    // Display results
    instructions.forEach((instr) => {
        console.log("0x%s:\t%s\t%s",
            instr.address.toString(16),
            instr.mnemonic,
            instr.op_str
        );
    });

    // Delete decoder
    d.close();
});
```

## 大楼

要建造 Capstone.js 图书馆:

1.  克隆此寄存器包括其子模块:
    
    ```bash
    git clone --recursive https://github.com/AlexAltea/capstone.js
    ```
    
2.  安装最新的 [Py 3.x](https://www.python.org/downloads/), (中文(简体) ), [计算](http://www.cmake.org/download/) 编辑 [标记 SDK](https://emscripten.org/docs/getting_started/downloads.html)。遵循相应的指示,确保所有环境变量的配置正确.
    
3.  运行构建脚本 :
    
    ```bash
    python3 build.py
    ```
    

建造的文物将保存到 [`dist`](https://npmcn.com/package/%40alexaltea/capstone-js/dist/)。 。 。 .

> \[TIP\] 传出架构名以产生一个更小的,单一的建筑包(例如. `python3 build.py x86`),或 `python3 build.py --release` 来构建每一个变体.

## 常见问题

### @alexaltea/capstone-js 是什么？

JavaScript 的 Capstone 拆卸框架端口

### 如何安装 @alexaltea/capstone-js？

在项目目录运行 npm install @alexaltea/capstone-js，或使用 pnpm add / yarn add / bun add。

### @alexaltea/capstone-js 支持 TypeScript 吗？

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

### @alexaltea/capstone-js 支持 ESM 还是 CommonJS？

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

### @alexaltea/capstone-js 可以商用吗？

@alexaltea/capstone-js 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @alexaltea/capstone-js 的下载量有多少？

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

### @alexaltea/capstone-js 还在维护吗？

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