# @fleetbase/valhalla-engine 中文文档

规范地址：https://npmcn.com/package/%40fleetbase/valhalla-engine/

版本：0\.0\.5
npm 元数据更新时间：2026-10-27T09:18:52.897Z
中文译文更新时间：2026-11-14T22:37:17.909Z
软件包许可：AGPL-3\.0-or-later

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

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

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

- 包体积（解压后）：161 kB，52 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>= 18
- 运行依赖：15 个
- peer 依赖：ember-engines ^0\.9\.0
- 首次发布：2025-06-04T03:39:39.452Z
- 最新版本发布：2026-10-27T09:18:52.097Z
- 近 30 天下载量：2654（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 4 个）

## 中文简介

分舰队基地的Valhalla路线发动机扩展

## 安装

```sh
npm install @fleetbase/valhalla-engine
```

也可以使用：`pnpm add @fleetbase/valhalla-engine`、`yarn add @fleetbase/valhalla-engine`、`bun add @fleetbase/valhalla-engine`

## README

![](https://github.com/user-attachments/assets/afac09ee-1fbf-423b-b2a6-7f05a06b12b2)

舰队基地启动器扩展

* * *

## 概览

这个单相机包含Fleetbase的Skeleton/Starter扩展机的前端和后端组件. 前端使用 Ember.js 构建,后端由 PHP 实现.

-   PHP 8.2 或以上
-   Ember.js v5.4 或以上 (中文(简体) )
-   Ember CLI v5.4 或 以上 (中文(简体) )
-   节点.js v18 或以上

## 结构

```
├── addon
├── app
├── assets
├── translations
├── config
├── node_modules
├── server
│ ├── config
│ ├── data
│ ├── migrations
│ ├── resources
│ ├── src
│ ├── tests
│ └── vendor
├── tests
├── testem.js
├── index.js
├── package.json
├── phpstan.neon.dist
├── phpunit.xml.dist
├── pnpm-lock.yaml
├── ember-cli-build.js
├── composer.json
├── CONTRIBUTING.md
├── LICENSE.md
├── README.md
```

## 安装

### 后端

使用作曲器安装 PHP 包 :

```bash
composer require fleetbase/core-api
composer require fleetbase/starter-api
```

### 前端

安装 Ember.js 引擎/ Addon :

```bash
pnpm install @fleetbase/starter-engine
```

## 使用量

### 后端

QQ 保持现代密码库 **Ưμ㼯A**数字 :

```bash
composer lint
```

使用静态分析 **PHP斯坦语**数字 :

```bash
composer test:types
```

使用运行单元测试 **环境、环境和科学司**

```bash
composer test:unit
```

运行整个测试套房:

```bash
composer test
```

### 前端

QQ 保持现代密码库 **ESLint 语录**数字 :

```bash
pnpm lint
```

使用运行单元测试 **Ember/ Q股 (单位)**

```bash
pnpm test
pnpm test:ember
pnpm test:ember-compatibility
```

启动 Ember Addon/ 引擎

```bash
pnpm start
```

· 构建 Ember Addon/ 引擎

```bash
pnpm build
```

## 捐款

关于如何为该项目作贡献的详细情况,见《贡献指南》.

## 许可证

这个项目根据麻省理工学院的许可证获得许可.

## 常见问题

### @fleetbase/valhalla-engine 是什么？

分舰队基地的Valhalla路线发动机扩展

### 如何安装 @fleetbase/valhalla-engine？

在项目目录运行 npm install @fleetbase/valhalla-engine，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：ember-engines（^0\.9\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fleetbase/valhalla-engine 支持 TypeScript 吗？

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

### @fleetbase/valhalla-engine 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fleetbase/valhalla-engine 可以商用吗？

@fleetbase/valhalla-engine 使用 AGPL-3\.0-or-later 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @fleetbase/valhalla-engine 的下载量有多少？

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

### @fleetbase/valhalla-engine 还在维护吗？

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