# @flisk-sh/flisk-export 中文文档

规范地址：https://npmcn.com/package/%40flisk-sh/flisk-export/

版本：0\.10\.0
npm 元数据更新时间：2026-11-03T18:51:45.384Z
中文译文更新时间：2026-11-14T23:26:42.010Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：63.8 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12\.0
- 运行依赖：1 个
- 首次发布：2026-10-31T13:26:07.586Z
- 最新版本发布：2026-11-03T18:51:45.005Z
- 近 30 天下载量：4705（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

从Flisk service.json文件中写出Render Blueprint(render.yaml),Cloudflare wrangler.toml或独立多克-compose.yml. 从来没有部署.

## 安装

```sh
npm install @flisk-sh/flisk-export
```

也可以使用：`pnpm add @flisk-sh/flisk-export`、`yarn add @flisk-sh/flisk-export`、`bun add @flisk-sh/flisk-export`

## README

# flisk - 导出

写出一个 Render 蓝图 (`render.yaml`)或云花(云花) `wrangler.toml` 从 `service.json` a 文件 [颜色](https://github.com/flisk-sh/flisk) 项目.

它只写文件。 它从不部署,从不创建 DNS 记录,从不调用云 API,并写入环境变量 **名称**,从不重视。 Flisk CLI 以被绑定的版本运行它 : `flisk export`。 。 。 .

## 使用

```sh
npx @flisk-sh/flisk-export render [dir] [--resource <name>] [--out <dir>] [--dry-run] [--force]
npx @flisk-sh/flisk-export wrangler [dir] --resource <name> [--route <host>] [--out <dir>] [--allow-non-worker] [--dry-run] [--force]
```

或者,从一个Flisk项目: `flisk export render --dry-run`。 。 。 .

### 提交

-   出口其 `appType` 实值 `backend`, (中文(简体) ), `frontend`, (中文(简体) ), `agent`, (中文(简体) ), `mcp` 或者说 `bring-your-own` (资源无) `appType` 不导出),或带有 `--resource`。 。 。 .
-   带有 Docker 文件的资源变为 `runtime: docker`; 一个带有 `package.json` 变成 `runtime: node`。 。 。 .
-   这个 `service.json` `port` 以 `PORT`,因为Render路线的交通到 `$PORT`。 。 。 .
-   其它的巢穴名称都用 `sync: false`,所以Render问 值。 无效的可变名称会被留出警告.
-   `healthCheckPath` 来自 `service.json` (默认) `/health`) (中文(简体) ).
-   路径相对 **git 仓库根**,这就是Render读取它们的地方,文件默认写在那里. `--out` 移动文件而不是路径.
-   两种资源成为同一种服务名称(`api_v1` 财务报告和审定财务报表 `api-v1`)被拒绝.

### 响铃

-   一个资源. `main` 来自 `package.json` `main`,或第一个 `src/index.ts`, (中文(简体) ), `src/index.js`, (中文(简体) ), `src/worker.ts`, (中文(简体) ), `src/worker.js`, (中文(简体) ), `index.ts`, (中文(简体) ), `index.js`。 。 。 .
-   带有 Docker 文件或没有文件的资源 `wrangler`, (中文(简体) ), `@cloudflare/workers-types` 或者说 `hono` 除非 `--allow-non-worker`。 。 。 .
-   `--route api.example.com` 写入自定义域路由。 免签:自定义域不接受.
-   信封名称列于注释中 `wrangler secret put`。 。 。 .

## 开发

```sh
npm install
npm run typecheck && npm run lint && npm run build && npm test
```

## 编曲

```sh
flisk-export compose            # writes .autogenerated/docker-compose.yml
flisk-export compose --check    # exit 1 when that file is out of date (for CI)
```

写入 a **独立** `docker-compose.yml` 从你所有的 `service.json` 文档(`image` 或者说 `dockerfile`, (中文(简体) ), `env`, (中文(简体) ), `secrets.required`, (中文(简体) ), `envFile`, (中文(简体) ), `profiles`, (中文(简体) ), `models`, (中文(简体) ), `volumes`, (中文(简体) ), `extraPorts`, (中文(简体) ), `dependsOn`, (中文(简体) ), `healthCheck`, (中文(简体) ), `sidecarOf`, (中文(简体) ), `container`) (中文(简体) ). 它运行时没有Flisk(`docker compose --env-file .env -f .autogenerated/docker-compose.yml up -d` 从工程根,因为 作曲寻找 `.env` 它读取的文件旁边: 没有外部 网络,无 `FLISK_*` 变量,没有生成机密. `${VAR}` 参考文献 `env`,每个名字在 `secrets.required`,以 `${NAME}` 用于编写 `.env`。 。 。 . 一册 `name` (一个安装的 Docker 音量) 被保留,项目以其堆栈命名( 或当 `.flisk/project.json` 已经 `composeProjectNames.<stack>` 从flisk-import中,它以前拥有的编译项目名称,例如 `pl_mail`),这样 `docker compose up` 找到和以前相同的数据. 一个 `image` 组合变量( C)`postgres:${POSTGRES_VERSION:-18}-alpine`其文如出一辙,由作曲解决; `restart: "on-failure:N"` 保持 N. 从 `container`数字 : `stopGracePeriod` 变成 `stop_grace_period`, (中文(简体) ), `networkAliases` 变成 `networks: { default: { aliases } }` (不见于a) `sidecarOf` 服务,没有自己的网络, `extraHosts` 变成 `extra_hosts` 财务报告和审定财务报表 `ulimits` 留下来 `ulimits`。检查每个值,使其不能添加 YAML 密钥;不匹配的是一个错误. `healthCheck.command` 成为作曲 `healthcheck` (与 `startPeriod` 作为 `start_period`); 列出在 `dependsOn` 等待时间 `service_healthy` (仅在健康检查书写时:仅提供 `healthCheckPath`,或 `enabled: false`,等待着 `service_started`页:1 `dependsOn` 条目写入为 `{ name, condition }` (flisk#2983)保持其状态. `buildArgs` 变成 `build.args`, (中文(简体) ), `logging` 留下来 `logging`,绑定源 `${NAME:-./path}` 持续读取 NAME 并默认重写此文件, `selinux` 成为 `:z`编号 :`:Z` 挂载选项, 图像可能使用 `${NAME:?message}` (英语:Flisk 1.4.28 fields). `container.command` 财务报告和审定财务报表 `container.entrypoint` (Flisk 1.4.31)成为编曲 `command:` 财务报告和审定财务报表 `entrypoint:` 以书面形式提交的清单`$$` 财务报告和审定财务报表 `${VAR}` stay,一个空入点将图像的ENTRYPOINT). 无服务 `restart` 获得无( Confose 的默认) , 因为项目自己的 Compose 文件有它 。 并列出一个 `restart: "no"` 任务等待 `service_completed_successfully`。 。 。 . 其他资源类型和 `command` (本土)服务不出口。 文件生成: 更改 `service.json` 运行它 再次使用 `--force`。它从不启动容器,也不叫API.

## 许可证

麻省理工学院

## 常见问题

### @flisk-sh/flisk-export 是什么？

从Flisk service\.json文件中写出Render Blueprint\(render\.yaml\),Cloudflare wrangler\.toml或独立多克-compose\.yml\. 从来没有部署\.

### 如何安装 @flisk-sh/flisk-export？

在项目目录运行 npm install @flisk-sh/flisk-export，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 flisk-export，可以用 npx flisk-export 直接运行。

### @flisk-sh/flisk-export 支持 TypeScript 吗？

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

### @flisk-sh/flisk-export 支持 ESM 还是 CommonJS？

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

### @flisk-sh/flisk-export 需要什么版本的 Node\.js？

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

### @flisk-sh/flisk-export 可以商用吗？

@flisk-sh/flisk-export 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @flisk-sh/flisk-export 的下载量有多少？

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

### @flisk-sh/flisk-export 还在维护吗？

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