# @firestone-hs/simulate-bgs-battle 中文文档

规范地址：https://npmcn.com/package/%40firestone-hs/simulate-bgs-battle/

版本：1\.1\.779
npm 元数据更新时间：2026-11-12T07:54:16.924Z
中文译文更新时间：2026-11-14T19:59:02.093Z
软件包许可：All rights reserved

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

原始 npm 页面：https://www.npmjs.com/package/%40firestone-hs/simulate-bgs-battle
原文对照：https://npmcn.com/package/%40firestone-hs/simulate-bgs-battle/?lang=original

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

- 包体积（解压后）：8.8 MB，2795 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2020-03-26T15:46:50.367Z
- 最新版本发布：2026-11-12T07:54:16.714Z
- 近 30 天下载量：8684（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：773（近 12 个月 122 个）

## 中文简介

```
 npm install
 npm run test-board
```

## 安装

```sh
npm install @firestone-hs/simulate-bgs-battle
```

也可以使用：`pnpm add @firestone-hs/simulate-bgs-battle`、`yarn add @firestone-hs/simulate-bgs-battle`、`bun add @firestone-hs/simulate-bgs-battle`

## README

# 试试看

```
npm install
npm run test-board
```

然后,你可以只是修改 `test/full-game/game3.json` 用于更改棋盘初始组成.

## 从应用程序中获取棋盘状态

寻找 `MainWindow.html.log` 文件位于 `%localappdata%\Overwolf\Log\Apps\Firestone`搜索 `[bgs-simulation] battle simulation request prepared`,此行应登录您可以用作输入的 JSON 全文(通常情况下,这是您在 `game3.json` 页:1.

## 检查模拟输出

您首先需要下载、 构建和运行本地实例 [殖民地](https://github.com/Zero-to-Heroes/coliseum)

然后,在测试结束时(如. `full-test.test` 增加/删除这些行:

```
const sample = simulationResult.outcomeSamples.lost[0];
const base64 = encode(JSON.stringify(sample));
```

(使用时) `won` 或者说 `tied` 改为 `lost` 如果这就是你要找的).

一个大碱基64字符串会输出到控制台.

复制后, 在您的导航器中打开一个新的标签 : `file:///<path_to_your_coliseum_repo>/dist/index.html?bgsSimulation=<the_big_base64_string`然后它会重放模拟.

# 部署

```
npm run build && npm run package && npm run deploy

rm -rf dist && tsc && rm -rf dist/node_modules && 'cp' -rf dist/ /e/Source/zerotoheroes/firestone/node_modules/\@firestone-hs/simulate-bgs-battle/
rm -rf dist && tsc && rm -rf dist/node_modules && 'cp' -rf dist/ /e/Source/zerotoheroes/coliseum/node_modules/\@firestone-hs/simulate-bgs-battle/
rm -rf dist && tsc && rm -rf dist/node_modules && 'cp' -rf dist/ /e/Source/zerotoheroes/firestone-libs/node_modules/\@firestone-hs/simulate-bgs-battle/
rm -rf dist && tsc && rm -rf dist/node_modules && npm publish
```

# 剖析

要使用 Chrome 的 DevTools 来描述一个 Node.js 应用程序, 您可以使用 `--inspect` 财务报告和审定财务报表 `--inspect-brk` 运行脚本时标记。 这是你怎么做到的:

1.  运行您的脚本 `--inspect-brk` 旗帜。 这将启动检查员并暂停执行, 直到您连接到调试器 .

```bash
node --inspect-brk -r ts-node/register test/full-game/full-test.ts
```

2.  打开色调并导航到 `chrome://inspect`。 。 。 .
3.  点击“ Open devTools for Node” 链接。 这将打开一个新的 DevTools 窗口 .
4.  在 DevTools 窗口中,点击"Performation"标签.
5.  点击"Start"按钮开始剖析.
6.  一旦您的脚本完成执行,请回到 DevTools 窗口并点击"Stop"按钮停止配置.
7.  您可以在 DevTools 窗口中分析 CPU 配置 .

记得替换 `node` 与 `npx ts-node` 如果您使用 TypeScript 不首先编译到 JavaScript .

# 参考文献

将此项目用作模板 : [https://github.com/alukach/aws-sam-typescript-boilerplate 页面存档备份,存于互联网档案馆](https://github.com/alukach/aws-sam-typescript-boilerplate)

# 开始

有些事情还没有完成:

-   一些关于小狗产卵的边缘案例 暂时无法解决
-   没有关于如何使用它的指导(无论是作为独立的包还是通过API). 想用的话就用我

## 常见问题

### @firestone-hs/simulate-bgs-battle 是什么？

npm install npm run test-board

### 如何安装 @firestone-hs/simulate-bgs-battle？

在项目目录运行 npm install @firestone-hs/simulate-bgs-battle，或使用 pnpm add / yarn add / bun add。

### @firestone-hs/simulate-bgs-battle 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @firestone-hs/simulate-bgs-battle 支持 ESM 还是 CommonJS？

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

### @firestone-hs/simulate-bgs-battle 可以商用吗？

@firestone-hs/simulate-bgs-battle 使用 All rights reserved 许可。声明的许可为 All rights reserved，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @firestone-hs/simulate-bgs-battle 的下载量有多少？

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

### @firestone-hs/simulate-bgs-battle 还在维护吗？

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