# @geekmidas/cloud 中文文档

规范地址：https://npmcn.com/package/%40geekmidas/cloud/

版本：9\.6\.1
npm 元数据更新时间：2026-11-16T09:30:53.227Z
中文译文更新时间：2026-11-16T09:39:15.056Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：69.7 kB，36 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：sst ^4\.15\.2
- 首次发布：2025-10-07T10:48:01.708Z
- 最新版本发布：2026-11-16T09:30:52.350Z
- 近 30 天下载量：12696（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：202（近 12 个月 200 个）

## 中文简介

SST(离子/钚)集成 `@geekmidas` 应用——可观察,可链接的构造,将1:1映射到可部署部队和 **在部署前验证其环境**,加上将资源与环境变量连接起来的运行时间帮助器.

## 安装

```sh
npm install @geekmidas/cloud
```

也可以使用：`pnpm add @geekmidas/cloud`、`yarn add @geekmidas/cloud`、`bun add @geekmidas/cloud`

## README

# @geekmidas/云

SST(离子/钚)集成 `@geekmidas` 应用——有见解,可链接 将1:1地图绘制到可部署部队和 **验证其环境 部署前**,加上解决链接资源的运行时间助手 环境变量.

两分之一:

-   **`@geekmidas/cloud/sst`** - 那个 **临时** 构造您在 `sst.config.ts` (单位:千美元)`App`, (中文(简体) ), `Stack`, (中文(简体) ), `Function`, (中文(简体) ), `Api`, (中文(简体) ), `Cron`) (中文(简体) ).
-   **`@geekmidas/cloud` 编号 : `@geekmidas/cloud/utils`** - 那个 **运行时间** 帮助者 (单位:千美元)`buildResourceEnv`, (中文(简体) ), `ResourceType`变成SST `Resource` 链接为平面 在Lambda内的环境变量.

> 设计说明和原理 [`docs/sst-constructs.md`](https://npmcn.com/package/%40geekmidas/cloud/docs/sst-constructs.md) (建筑)和 [`docs/sst-testing.md`](https://npmcn.com/package/%40geekmidas/cloud/docs/sst-testing.md) (测试).

## 安装

```bash
pnpm add @geekmidas/cloud
```

`./sst` 目标 **SST v4 请检查url=值 (帮助)** (同类依赖) `sst@^4`) 并按原样分发 TypeScript source — 它延伸环境 `sst.aws.*` 仅存在的环球 之后 `sst install` 在你的应用程序.

## `@geekmidas/cloud/sst`

```ts
import { App, Api, Function, Cron } from '@geekmidas/cloud/sst';
```

### 应用堆栈( S)

`App` 是一个简单的同步构造; 在呼叫时解决主控区域 并传递到现场. `app.stack(name)` 创建一个 `Stack` 绑在应用程序.

```ts
const { zoneId } = await aws.route53.getZone({ name: 'example.com' });

const app = new App({
  name: 'my-app',
  stage: 'prod',
  domain: 'example.com',
  hostedZoneId: zoneId,
  region: 'us-east-1',
});

const stack = app.stack('api');
stack.logicalPrefixedName('handler'); // "prod-my-app-api-handler"
stack.select({ prod: 'live', default: 'dev' }); // by-stage value with a default
```

### 函数

扩展 `sst.aws.FunctionArgs` (本地选项通过),合并标准 env 默认,默认为 `nodejs24.x` + JSON 伐木,以及 **验证 `envVars` 反对 `links` 合成时间** - 只附加一个函数需要的链接 (最少的特权).

```ts
const fn = new Function(stack, 'Processor', {
  handler: 'src/processor.handler',
  links: [db, topic],
  envVars: ['DATABASE_URL'], // validated against links; fails synth if missing
});
```

### 阿庇语Name

扩展 `sst.aws.ApiGatewayV2Args` (CORS/域/etc.通过). 路线是 键入的表格,每条路由内嵌验证,最小连接,以及一个键入 授权模式.

```ts
const api = new Api(stack, 'Api', {
  links: [db],
  authorizers: {
    jwt:      { issuer: 'https://issuer', audiences: ['aud'] }, // 'jwt' → JWT settings
    employee: { handler: 'src/employee-auth.handler' },         // custom → Lambda authorizer
  },
  routes: [
    { method: 'GET',  path: '/me',  handler: 'me.handler',  authorizer: 'jwt' },
    { method: 'GET',  path: '/adm', handler: 'adm.handler', authorizer: 'employee' },
    { method: 'POST', path: '/pub', handler: 'pub.handler' }, // public (none)
  ],
});
```

一条路线 `authorizer` 类型限制为 `'iam' | 'none'` 加上声明 授权人名称——未申报名称是编译错误,以及 `jwt` 要求 JWT 自定义授权方需要设置时 `handler`。 。 。 .

### 克龙

环绕 `sst.aws.CronV2` (单位:千美元)`sst.aws.Cron` 已贬值. `processor` 是一个 `Function` (或任何带有 `arn`(三); `schedule` 是输入的 `cron(…)` 编号 : `at(…)`。 。 。 .

```ts
const cron = new Cron(stack, 'Nightly', { processor: fn, schedule: 'cron(0 0 * * ? *)' });
```

### 从a `gkm build` 显示

`gkm build` 发布部署清单(类型: `@geekmidas/manifest`) (中文(简体) ). 每个 构造有静态 `fromManifest` 将它直接映射到下面的工厂:

```ts
import routes from './.gkm/routes-manifest.json';

const api     = Api.fromManifest(stack, 'Api', routes, { links: [db], authorizers });
const workers = Function.fromManifest(stack, functionsManifest, { links: [db] });
const crons   = Cron.fromManifest(stack, cronsManifest, { links: [db] });
```

## `@geekmidas/cloud/utils` (运行时间)

```ts
import { buildResourceEnv } from '@geekmidas/cloud';
```

`buildResourceEnv` 转换 SST 的记录 `Resource` 连接到平坦环境中 变量,使用共享 `ResourceType` 词汇.

## 常见问题

### @geekmidas/cloud 是什么？

SST\(离子/钚\)集成 @geekmidas 应用——可观察,可链接的构造,将1:1映射到可部署部队和 在部署前验证其环境,加上将资源与环境变量连接起来的运行时间帮助器\.

### 如何安装 @geekmidas/cloud？

在项目目录运行 npm install @geekmidas/cloud，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：sst（^4\.15\.2）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @geekmidas/cloud 支持 TypeScript 吗？

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

### @geekmidas/cloud 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @geekmidas/cloud 可以商用吗？

@geekmidas/cloud 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @geekmidas/cloud 的下载量有多少？

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

### @geekmidas/cloud 还在维护吗？

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

