# @aws/nx-plugin 中文文档

规范地址：https://npmcn.com/package/%40aws/nx-plugin/

版本：1\.3\.3
npm 元数据更新时间：2026-11-04T04:02:58.598Z
中文译文更新时间：2026-11-07T14:00:58.152Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aws/nx-plugin
原文对照：https://npmcn.com/package/%40aws/nx-plugin/?lang=original
源码仓库：https://github.com/awslabs/nx-plugin-for-aws

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

- 包体积（解压后）：13.9 MB，2036 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：^22\.13\.0 \|\| ^24\.0\.0 \|\| \>=26\.0\.0
- 运行依赖：43 个
- peer 依赖：nx 23\.3\.1
- 首次发布：2024-12-12T04:02:57.754Z
- 最新版本发布：2026-11-04T04:02:58.200Z
- 近 30 天下载量：38721（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：329（近 12 个月 223 个）

## 中文简介

暂无中文简介

## 安装

```sh
npm install @aws/nx-plugin
```

也可以使用：`pnpm add @aws/nx-plugin`、`yarn add @aws/nx-plugin`、`bun add @aws/nx-plugin`

## README

# AWS 的 Nx 插件

### 在几分钟内构建全存储 AWS 应用程序

 [![Apache 2.0 License](https://img.shields.io/badge/License-Apache%202.0-yellowgreen.svg)](https://opensource.org/licenses/Apache-2.0)[![](https://codecov.io/gh/awslabs/nx-plugin-for-aws/graph/badge.svg?token=X27pgFfxuQ) ](https://codecov.io/gh/awslabs/nx-plugin-for-aws)[![Release badge](https://github.com/awslabs/nx-plugin-for-aws/actions/workflows/ci.yml/badge.svg) ](https://github.com/awslabs/nx-plugin-for-aws/actions/workflows/ci.yml)[![Commit activity](https://img.shields.io/github/commit-activity/w/awslabs/nx-plugin-for-aws)](https://github.com/awslabs/nx-plugin-for-aws/commits/main)

[**文档网站**](https://awslabs.github.io/nx-plugin-for-aws/)

* * *

**@aws/nx-插件** 是一个代码生成器的集合, 用于将 AWS 应用程序完全装入其中 [无](https://nx.dev/) 单相机。 每个生成器都会生成最佳做法应用程序代码 **财务报告和审定财务报表** 从一开始就部署,使你更接近生产.

![Scaffolding, running and deploying a full-stack AWS application with the Nx Plugin for AWS](https://raw.githubusercontent.com/awslabs/nx-plugin-for-aws/main/docs/src/content/docs/assets/nx-plugin-showcase-desktop-dark.gif)

## 快速启动

### 以 AI 构建

**1\. 创建工作空间**

```bash
pnpm create @aws/nx-workspace my-project
cd my-project
```

**2\. 在创建的工作空间打开你的人工智能助手并提示**

> _"使用AWS的Nx插件来构建一个由带有shadcn和Cognitto认证的React网站组成的全存储应用程序,通过AG-UI协议连接到TypeScript Strands代理,以及部署它的基础设施"_

您的 AI 助手将使用 AWS MCP 服务器的 Nx 插件, 它在您用上面的命令创建的每一个工作区中预先配置, 用于脚手架、 连接和配置所有设备 。 见 [使用AI指南的大楼](https://awslabs.github.io/nx-plugin-for-aws/en/get_started/building-with-ai/) 更多细节.

### 以 CLI 构建

创建工作空间并开始添加组件——零配置需要:

```bash
# Create a new workspace
pnpm create @aws/nx-workspace my-project
cd my-project

# Add a tRPC API
pnpm nx g @aws/nx-plugin:ts#api --framework=trpc

# Add a Strands AI agent (Python)
pnpm nx g @aws/nx-plugin:py#agent

# Add a React website
pnpm nx g @aws/nx-plugin:ts#website --framework=react

# Add authentication to your website
pnpm nx g @aws/nx-plugin:ts#website#auth

# Connect your website to your API and agent
pnpm nx g @aws/nx-plugin:connection

# Add CDK infrastructure to deploy it all (or choose Terraform)
pnpm nx g @aws/nx-plugin:ts#infra
```

> 见全 [快速启动指南](https://awslabs.github.io/nx-plugin-for-aws/en/get_started/quick-start) 财务报告和审定财务报表 [Dungeon 冒险辅导](https://awslabs.github.io/nx-plugin-for-aws/en/get_started/tutorials/dungeon-game/overview/) 更深入地走过去.

## 可用发电机

| 发电机 | 说明 |
| --- | --- |
| `init` | 配置现有的 Nx 工作空间以使用插件 |
| `ts#project` | 类型脚本库 |
| `ts#api` | TypeScript API (tRPC 或 Smithy) 有 API 网关 + Lambda + [动力工具](https://github.com/aws-powertools/powertools-lambda-typescript) |
| `ts#rdb` | 与Aurora RDS的关系数据库 |
| `ts#dynamodb` | 安全型 DynamoDB 单表设计 (TypeScript, ElectroDB) |
| `ts#website` | 反应应用( Vite) |
| `ts#website#auth` | 在网站上添加 Cognitto 认证 |
| `ts#infra` | AWS CDK基础设施项目 |
| `ts#lambda-function` | TypeScript Lambda 有类型安全事件源 |
| `ts#mcp-server` | MCP 服务器( TypeScript) |
| `ts#dcr-proxy` | OAuth CDR 代理架构,用于认证的 MCP 服务器 |
| `ts#agent` | [斯特兰德斯代理](https://strandsagents.com/) (编) |
| `ts#agent#guardrails` | Amazon Bedrock Guardrail 用于类型脚本代理(实验) |
| `ts#nx-generator` | Nx 发电机脚手架 |
| `ts#docs` | 文献网站(Astro + Starlight) |
| `smithy#project` | Smithy模型项目——服务模型,或由Smithy项目共享的形状库 |
| `py#project` | Python项目(uv) |
| `py#api` | Python API (FastAPI) 有 API 网关 + Lambda + [动力工具](https://github.com/aws-powertools/powertools-lambda-python) |
| `py#rdb` | 与Aurora RDS的关系数据库(Python) |
| `py#dynamodb` | Python DynamoDB项目 |
| `py#lambda-function` | Python Lambda 有类型安全事件源 |
| `py#mcp-server` | MCP 服务器( Python) |
| `py#agent` | [斯特兰德斯代理](https://strandsagents.com/) (P |
| `py#agent#guardrails` | Amazon Bedrock Guardrail 用于 Python 代理(实验) |
| `agentcore-gateway` | [代理核心网关](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html) 项目 |
| `greengrass#component` | [AWS IOT 绿草](https://docs.aws.amazon.com/greengrass/v2/developerguide/) python 或 TypeScript (实验) 的 v2 组件 |
| `agentcore-harness` | [特工科雷·哈内斯](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/harness.html) 代理环( 实验) |
| `connection` | 将项目连接在一起( 如 API 前端) |
| `terraform#project` | 地形项目 |
| `license` | 管理 LICENSE 文件及源头 |

## 社区

加入我们吧 [#nx-插头为锯](https://cdk-dev.slack.com/archives/C0AG11EUHM4) 频道可以提问,分享反馈,并与其他用户和贡献者连接.

## 捐款

读我们 [贡献指南](https://npmcn.com/CONTRIBUTING.md) 学习我们的开发过程,如何提出错误修正和改进,以及如何构建和测试您的变化.

## 行为守则

该项目通过了我们期望项目参与方遵守的《行为守则》。 请读一下 [行为守则](https://npmcn.com/CODE_OF_CONDUCT.md) 这样你就能明白什么行动是不会被容忍的.

## 许可证

@aws/nx-plugin 是 (笑声) [Apache 2.0 许可](https://npmcn.com/LICENSE)。 。 。 .

## 常见问题

### 如何安装 @aws/nx-plugin？

在项目目录运行 npm install @aws/nx-plugin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：nx（23\.3\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aws/nx-plugin 支持 TypeScript 吗？

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

### @aws/nx-plugin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aws/nx-plugin 需要什么版本的 Node\.js？

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

### @aws/nx-plugin 可以商用吗？

@aws/nx-plugin 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aws/nx-plugin 的下载量有多少？

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

### @aws/nx-plugin 还在维护吗？

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