# @fluid-app/fluid-cli-localization 中文文档

规范地址：https://npmcn.com/package/%40fluid-app/fluid-cli-localization/

版本：0\.1\.690
npm 元数据更新时间：2026-11-15T00:20:33.009Z
中文译文更新时间：2026-11-15T01:35:59.698Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40fluid-app/fluid-cli-localization
原文对照：https://npmcn.com/package/%40fluid-app/fluid-cli-localization/?lang=original

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

- 包体积（解压后）：643 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：3 个
- 首次发布：2026-10-01T21:34:40.333Z
- 最新版本发布：2026-11-15T00:20:32.805Z
- 近 30 天下载量：134072（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：691（近 12 个月 691 个）

## 中文简介

Fluid CLI 插件,用于打开国家并翻译存储头条——从国家地图集中种子一个国家,将价格转换为货币,使语言能够使用,并找到、机器翻译和保存翻译

## 安装

```sh
npm install @fluid-app/fluid-cli-localization
```

也可以使用：`pnpm add @fluid-app/fluid-cli-localization`、`yarn add @fluid-app/fluid-cli-localization`、`bun add @fluid-app/fluid-cli-localization`

## README

# @fluid-app/fluid-cli-本地化

流体CLI插件,用于在另一国和以另一种语言销售. 这个 增加两个指挥组:

-   `fluid countries` 从 Fluid 的国家图集中打开一个国家,转换您的 价格与货币挂钩,达成协定,并检查结果.
-   `fluid translations` 打开语言, 报告购买者还会有什么 见"未译","机"用"流"作"活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活活.

乡下流传着手语 `fluid translations`所以每个步骤 只有一个命令.

```bash
npm install -g @fluid-app/fluid-cli @fluid-app/fluid-cli-localization
fluid login

# Open a country
fluid countries atlas DE                       # the atlas: modes, tax, legal, address, payments, languages
fluid countries plan DE --mode otg             # preview, changes nothing
fluid countries open DE --mode otg --yes       # add the country, seeded from the atlas
fluid countries prices DE                      # preview converting US prices into EUR
fluid countries prices DE --rate 0.92 --write --yes
fluid countries languages DE                   # which market languages are off, and the command to turn them on
fluid translations enable de --yes
fluid countries agreements DE --create --yes   # the atlas agreements, in every atlas language
fluid countries forms DE                       # the atlas enrollment fields against the country's forms
fluid countries forms DE --create --yes        # the country's enrollment form, as a draft to review
fluid countries status DE                      # check against the atlas

# Translate
fluid translations missing de                  # what isn't translated yet, per type
fluid translations auto de --limit 10          # machine-translate 10 per type, print only
fluid translations auto de --limit 25 --write --yes
fluid translations set products 60311 --lang de --yes --set title="Rote-Bete-Mischung"
```

每个命令印出JSON。 打印 JSON 失败 `error` 显示和退出 非为零。 更改现场配置、价格或内容的指令 除非您通过 `--yes`。 。 。 .

## 走动

两个团体都有 `walk` 在终端里提问而不是 举起旗帜。 类型 `<` 回去的时候, `>` 跳过, `?` 菜单,和Ctrl - C级 停下来。 每个行走都会通过与命令相同的呼叫和脚本来保存 和代理使用命令代替.

-   `fluid countries walk [iso]` 打开一个像雾一样的国家。 它要求 然后询问操作模式 (每一行都用一行解释) 仓库,它推销语言 启用、创建或翻译哪些地图集协议以及是否保留 或更改每个地图集的违约情况:货币、税收、三维安全、支付令和 地址布局 。 然后它问是否要添加 Fluid 的通用默认和 显示要确认的摘要。 在你确认之前,什么也救不了 这样吧 开放国家,打开语言,并创建协议。 下一个 它提供价格转换:它显示数字和样本 给与和保存的利率只以"是"为准。 最后,它掌握每个市场语言 到翻译行走.
-   `fluid translations walk [iso]` 问语言,如果你没有命名 一,提议打开它。 它显示每个类型缺少什么,然后让你 分批翻译每种类型。 你仔细看建议 用于接受、编辑或跳过的时间,每个时间都会被保存。 这个 覆盖每个类型,包括主题字符串和主题页面字符串.

## `fluid countries`

| 命令 | 它会做什么 |
| --- | --- |
| `atlas <iso>` | 市场地图集,没有协议法律文本. `--agreement <localId>` 完整打印一个协议. |
| `compliance <iso>` | 地图集的披露页、饼干规则、税务显示和单位定价. |
| `list` | 公司出售的国家. |
| `plan <iso> --mode <m>` | 什麽 `open` 将发送具有语言和协议状态的仓库和发射清单。 唯相读取. |
| `open <iso> --mode <m>` | 以地图集为种子的国家:货币、模式、税务名称、兼顾税收的定价、税务发票、三维安全、法律环境、地址布局和支付方法顺序. |
| `update <iso>` | 只更改您在开放国家上命名的设置( N)`--set key=value`, (中文(简体) ), `--warehouse-id`, (中文(简体) ), `--business-id`, (中文(简体) ), `--entity-registered`, (中文(简体) ), `--settlement-currency`例如,实体。 嵌入式设置合并为当前设置 . |
| `prices <iso>` | 从另一个国家转换出每个变体的价格(`--from-country`默认值 `US`进入这个国家的货币。 干燥,除非 `--write`。 。 。 . |
| `languages <iso>` | 市场的主要语言 以及每种语言是否都使用 `fluid translations enable` 命令那些关闭. |
| `agreements <iso>` | 阿特拉斯协议与公司的产权相符. `--create` 增加缺失的; `--translate` 将地图集的译名写入国内已有的地图集. |
| `forms <iso>` | 对照国家邮购表格的地图集注册区:收集哪些,缺失哪些,以及哪些 `--create` 将会发出. `--create` 使国家的入学情况形成或增加缺失的栏目. |
| `status <iso>` | 将国家与地图集进行对比, 检查一下您当前产品中的每个变种都有价格, 并且有东西在出售, 入学要求地图集域, 然后列出运行的命令和留给一个人的工作. |

`open` 带 `--warehouse-id`, (中文(简体) ), `--business-id`, (中文(简体) ), `--entity-registered` 财务报告和审定财务报表 `--settlement-currency` 因为地图册不知道 `--set key=value` 以覆盖种子值。 它跳过了Fluid的通用国家协议和 窗体( 通过) `--legacy-defaults` 并不会改变任何开放的 国家,除非您通过 `--reseed`,它写每个地图集的价值. 在开放的国家中更改几个字段, 请使用 `update`。 。 。 .

### 转换价格

`fluid countries prices DE` 读取每个活性产品(`--status` 页:1 对每种变式,其美国价格以利率和轮数相乘 货币小单位的一半(全部单位为日元、韩元和 其他十进制货币,其余部分为美分。 它印出速率,该 四舍五入、计数和价格前后的样本。 无所取救.

-   **速率.** 过 `--rate`:来源单位新币单位 货币。 没有它,预览 使用欧洲中央银行的日报 参考率. `--write` 总是需要 `--rate`因此,节省的利率是: 一个你审查过.
-   **田园.** `price`, (中文(简体) ), `subscription_price` 财务报告和审定财务报表 `compare_price` 默认. 添加 `wholesale` 财务报告和审定财务报表 `wholesale_subscription_price` 与 `--fields`一字段 没有源量就被抛在一边.
-   **从不自由.** 一个转换为零价的变体被跳过 (单位:千美元)`roundsToZero`),而任何其它弹出到零的球场则被忽略.
-   **复作是说已.** 国内已有价格的变体是: 跳过( e)`alreadyPriced`),因此第二次运行从不转换转换转换出的价格. 用另一种货币节省的价格也被跳过(`pricedInOtherCurrency`) (中文(简体) ). `--overwrite` 替换两者.
-   **卖出.** 转换后的价格保持变体当前出售状态 国家. `--activate` 把每个变体都卖掉.
-   **失败者.** 每个变体都是自己保存的. 列出被拒绝的保存 下级 `failed` 和API的讯息, 其余继续.
-   **运行中的变化 .** 每种产品在读完之前 变体被保存。 一种变体,有人在这个国家定价 自 预览被单独保留并列在下面 `changedSincePreview`。 。 。 .
-   **价格编辑.** 当价格编辑管理公司价格时, `priceEditor` 实值 `true`。每个保存然后进入价格编辑器的价格 列表; 无法放置的列表 `refusedByPriceEditor: true`。 。 。 . `--overwrite` 被这些公司拒绝, 所以一个价格 有人设置在 价格编辑器从此不再被替换.

### 设立入学表

录入检出会显示每张正在运行的手推车购买表 国家付款后,合并为一个国家. `fluid countries forms DE` 读取 这些表格和指纹,对于每个地图集的输入字段,它所绘制的元素 入学和入学是否要求入学`collected`, (中文(简体) ), `inDraft`, (中文(简体) ), `missing` 或者说 `byHand`),与 `plan`: 内容 `--create` 将会发出。 无所取救.

| Atlas部分 | 元素类型 |
| --- | --- |
| `LegalName`, (中文(简体) ), `FullName`, (中文(简体) ), `Email`, (中文(简体) ), `PhoneNumber` | `input`, (中文(简体) ), `puck_type` `legal_name`, (中文(简体) ), `full_name`, (中文(简体) ), `email`, (中文(简体) ), `phone_number` |
| `DateOfBirth` | `input`, (中文(简体) ), `puck_type` `date_of_birth`,存储敏感 |
| `ShortTextEntry`, (中文(简体) ), `LongTextEntry`, (中文(简体) ), `NumberEntry` | `short_text_entry`, (中文(简体) ), `long_text_entry`, (中文(简体) ), `number_entry` |
| `YesNo`, (中文(简体) ), `MultipleChoice` | `yes_no_entry`, (中文(简体) ), `multiple_choice_entry` |
| `FileUpload`, (中文(简体) ), `Checkbox` | `file_upload`, (中文(简体) ), `checkbox` |
| `SocialSecurityNumber` | 没有创建,也没有标注为ID、税务、银行或卡片号码的文本字段 |

-   **形式.** `--create` 制造 `Enrollment - <Country>`后购 仅以国家为单位,行政主管国家为单位 核对表是有用的。 如果作为草稿存在或已公布,则缺失的字段 改为添加其中. `--form <id>` 在另一邮购表中添加 仅局限于国家.
-   **草案第一.** 新的表格是草稿,所以一个人在表格中审查 入学前先建房. `--activate` (或 现有草案)在同一行中.
-   **惟有所缺.** 用于 已收集的国家不再添加 。 身份字段( 名称, 按类型分列的电子邮件、电话、出生日期;按类型分列的任何其他字段,以及 标签.
-   **没有被删除.** 在表格中再读一遍,然后把每个 其组件及其元素代号,所以其上没有任何被关闭或没有 字段的敏感性变化.
-   **其他国家.** 与其他国家共享的表格会被读取,永远不会 更改: 一个国家的地图集要求的字段不属于另一个字段 国家入学率。 它缺乏的是国家本身的形式.
-   **会员类型.** 购买后表格可送达报名的所有人 因此地图集只要求某些成员类型(日期: 和大多数税务问题)列于下文 `byHand` 与原因 换句话说 地图集给出的多种选择也没有选择.
-   **数据表不得收集.** SSN 和任何需要值的字段 (除了 " 是/否 " 或 " 复选箱 " 以外,任何其他)其标签名称为国家或税务身份证号码、银行或卡片细节,或 密码(一个CPF,一个TIN,一个IBAN),从未创建;它列在下面 `byHand`。通过您的税收或付款提供者来收取这些款项.
-   **敏感领域.** 出生日期很敏感 所以角色没有 表格视图敏感权限,请查看其答案被掩盖。 创建一个 需要表格管理敏感权限;没有它, API 拒绝 整个保存,命令是这样说的. `--skip-sensitive` 创建其他和 列出它漏掉的那些.

## `fluid markets` 顺序和货币

| 命令 | 它会做什么 |
| --- | --- |
| `reorder <market...>` | 设置完整的市场秩序(标识或名称,每个市场一次). 第一个变成倒数. `--preview` 无所写; `--yes` 跳过提示. |
| `set-fallback <market>` | 让市场倒闭。 拒绝,与所列国家,而下跌价格国家没有市场. `--preview` 无所写; `--yes`。 。 。 . |
| `currency add <market> <currency>` | 将货币添加到市场。 加上一个它已经有一个是没有的. |
| `currency remove <market> <currency>` | 从市场中删除货币。 在计费、定价或市场最后时拒绝计数. `--yes` 跳过提示. |

每个API拒绝都会打印它的代码和细节. 需要市场配置发布 .

## `fluid translations`

| 命令 | 它会做什么 |
| --- | --- |
| `languages` | 每种语言Fluid都支持,是否开着. |
| `enable <iso...>` 编号 : `disable <iso>` | 打开或关闭语言. |
| `types` | 易变型和它们的田地. |
| `missing <iso>` | 还没有翻译的,每个类型. `done` 实值 `true` 当什么都没有的时候. |
| `show <type> <id> --lang <iso>` | 翻译旁边有一个项的默认文本 . |
| `set <type> [id] --lang <iso> --set field=value` | 以手省一译. `--file` 为长值或 HTML 值取一个 JSON 对象. |
| `auto <iso>` | 机器翻译所缺少的与流体AI. `--write` 保护它. |

| 类型 | 字段 | 计数为翻译时 |
| --- | --- | --- |
| `products` | 标题、导言、描述、特征 文本、图像 url | 该行 `languages` 列出语言 |
| `categories`, (中文(简体) ), `collections`, (中文(简体) ), `pages`, (中文(简体) ), `playlists` | 标题、 描述、 图像url | 同样的 |
| `posts` | 标题、描述、摘要、图像url | 同样的 |
| `media` | 标题、描述、图像 url、视频 url、pdf url | 同样的 |
| `enrollment-packs` | 标题、说明 | 同样的 |
| `menu-items` | 标题 | 标题在语言中有一个值 |
| `theme` | 每个字符串 `locales/<iso>.json` | 键有非空白值 |
| `theme-sections` | 一个页面模板的自有字符串,该字符串将覆盖该页面上的地方文件 | 该密钥在模板的翻译中有非空白值 |
| `agreements` | 标题和描述,一起保存 | a 以该语文读取,在其中使用 |
| `labels` | 标题( 您创建的产品徽章) | 其语言标题与默认不同 |

注释:

-   `auto` 翻译存储前行、菜单项、协议和标签 商店默认语言, 从商店前行读取 (单位:千美元)`--store-language` 只有无法读取的时候才能读取). 主题字符串翻译 从 `--from` 语言, `en` 默认。 翻译器返回的项目 仅其中一部分列于以下 `incomplete` 未保存; `--skip <type>:<id>` 别管它了 API 拒绝的项目列在下面 `failed`都数到 `remaining`。 。 。 .
-   一个存储前行,任何翻译都算作翻译,因为已读 返回默认的字段.
-   一个翻译与默认相同(品牌名)的标签 保留列表; 跳过 `--skip labels:<id>`。 。 。 .
-   `missing` 列出源代码中值仍然是单词的主题密钥 下级 `sameAsSource`用眼睛来审查.
-   主题写作立即发布. 本地文件写入发送主题 它读取的版本,所以同时编辑使其失败,而不是 覆盖; `auto` 列出拒绝写入的每个密钥 `failed`A级 无法列出文件的主题( 无效的成员配置 ) 读而未保存,因为写作无法被守护. 主题章节 在保存和合并到模板之前,将模板再次读取.

## 未涵盖

他们没有翻译他们的API,所以他们留在液管或与一个 人员:

-   晋升(标题、描述、术语).
-   校对:Soup.
-   Fluid自己的标签("New","Trending"),由Fluid翻译.
-   区块设置以文字写出,而不是以地方键写出 。 使用 页面编辑器的翻译模式,将设置变成密钥,然后 `fluid translations` 盖取之.
-   一个国家的付款提供商上船和发射清单.

行走道是"开放一国家"和"添加一语言"指导设置 时间 [https://docs.fluid.app/设置](https://docs.fluid.app/setup)。 。 。 .

## 常见问题

### @fluid-app/fluid-cli-localization 是什么？

Fluid CLI 插件,用于打开国家并翻译存储头条——从国家地图集中种子一个国家,将价格转换为货币,使语言能够使用,并找到、机器翻译和保存翻译

### 如何安装 @fluid-app/fluid-cli-localization？

在项目目录运行 npm install @fluid-app/fluid-cli-localization，或使用 pnpm add / yarn add / bun add。

### @fluid-app/fluid-cli-localization 支持 TypeScript 吗？

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

### @fluid-app/fluid-cli-localization 支持 ESM 还是 CommonJS？

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

### @fluid-app/fluid-cli-localization 需要什么版本的 Node\.js？

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

### @fluid-app/fluid-cli-localization 可以商用吗？

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

### @fluid-app/fluid-cli-localization 的下载量有多少？

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

### @fluid-app/fluid-cli-localization 还在维护吗？

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