# @flickfyi/flkr 中文文档

规范地址：https://npmcn.com/package/%40flickfyi/flkr/

版本：0\.0\.210
npm 元数据更新时间：2026-11-12T04:20:00.704Z
中文译文更新时间：2026-11-14T22:47:32.010Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40flickfyi/flkr
原文对照：https://npmcn.com/package/%40flickfyi/flkr/?lang=original
项目主页：https://flick.fyi/docs/flkr/quick-start
源码仓库：https://github.com/zshannon/crayon

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

- 包体积（解压后）：245 MB，34031 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：30 个
- 首次发布：2026-10-20T18:03:35.201Z
- 最新版本发布：2026-11-12T04:20:00.454Z
- 近 30 天下载量：3095（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

管理您浮点的工具

## 安装

```sh
npm install @flickfyi/flkr
```

也可以使用：`pnpm add @flickfyi/flkr`、`yarn add @flickfyi/flkr`、`bun add @flickfyi/flkr`

## README

# 调值

编辑并发布您的应用程序的 Flick 视图从终端.

```sh
npm install --global @flickfyi/flkr
flkr
```

需要节点.js 24或后. 运行 `flkr` 从您的应用程序的 Xcode 工程目录.

1.  [快开始](https://flick.fyi/docs/flkr/quick-start): 签名、编辑视图并发布
2.  [公用钥匙基础设施](https://flick.fyi/docs/public-key-infrastructure): 授权使用您的应用程序信任根发布
3.  [持续融合](https://flick.fyi/docs/flkr/continuous-integration): 发表于 GitHub 动作并附有代表证书

## 发展

从单列波根:

```sh
bunx --no-install turbo run build:package --filter=@flickfyi/flkr
bun run --filter @flickfyi/flkr typecheck
bun run --filter @flickfyi/flkr lint
bun run --filter @flickfyi/flkr test
```

本地构建并安装释放的焦油球 :

```sh
bun run --filter @flickfyi/flkr pack:release
bun run --filter @flickfyi/flkr test:release "$PWD/.build-storage/flkr-release/flickfyi-flkr-0.0.0.tgz"
```

包装包括内部JavaScript包及其依赖性. TSRS 保持 npm 依赖, 因此安装会选择其本地二进制为用户平台 。 沥青球测试检查可执行文件,子命令,并在单独的安装中生成了SDK发现.

被钉住的TSRS为Apple Silicon macOS和Linux x64/arm64(GNU和musl)发行了舰只编译器二进制. 它不运送Windows或Intel macOS 二进制.

这个版本来自这个软件包 `package.json`。在包装前遵循发布工作流程的清洁生产安装步骤:它使用Bun的悬挂式生产布局,其工作空间的悬挂边界如此原始 `bun pm pack` 包括完整捆绑的依赖树.

把它的目录登记为私人Bun工作空间 核心和光子的使用 `workspace:*`,所以他们的源和构建 留在本地到检查。 Bun更新了普通的根表和锁文件;不需要包注册或路径链接协议. 外部 Bun 项目使用已公布的 SDK 依赖性,由 SDK 运单提供React和编辑器类型版本.

## npm 释放量

[`flkr-release.yml`](https://npmcn.com/package/.github/workflows/flkr-release.yml) 构建、检查和安装用于改变flkr或者其依赖性的PR上的放出沥青球。 合并到 `main`,它出版 `@flickfyi/flkr` 到 npm 有版本 `0.0.<GitHub run number>`。仅文档更改为 `packages/flkr/docs/` 不发布发布.

工作空间和已发布的软件包都使用名称 `@flickfyi/flkr`。 。 。 .

### 第一份出版物

在合并发布工作流程之前, npm 账户与发布访问 `@flickfyi` 范围必须创建软件包。 使用节点(Node.js 24或后期),npm 11.5.1或后期,并启用一个有两要素认证的账户.

使用自定义 npm 登录后发布 :

```sh
bunx --no-install turbo run build:package --filter=@flickfyi/flkr
bun run --filter @flickfyi/flkr pack:release
bun run --filter @flickfyi/flkr test:release "$PWD/.build-storage/flkr-release/flickfyi-flkr-0.0.0.tgz"
npm login
npm publish .build-storage/flkr-release/flickfyi-flkr-0.0.0.tgz --access public
```

版本 `0.0.0` 离开工作流程 `0.0.<run number>` 现有版本。 在合并前完成下面可信任的出版商设置; GitHub 不需要 npm 出版秘密 .

### 受托出版

一旦软件包存在,请配置其 [npm 信任的出版商](https://docs.npmjs.com/trusted-publishers/) gitHub 动作 :

| 设置 | 数值 |
| --- | --- |
| 组织或用户 | `zshannon` |
| 仓库 | `crayon` |
| 工作流程文件名 | `flkr-release.yml` |
| 环境 | 空闲 |
| 允许的行动 | 允许直接 `npm publish` |

只有发布工作 `main` 接收 `id-token: write`. PRs 以只读权限构建并测试相同的柏油球. npm将 GitHub 身份交换为短寿命的出版证书.

第一个工作流程发布成功后,请选择 **需要双要素认证和不允许的令牌** 在包裹下 **设置 – 出版访问**。为此软件包撤销任何旧的发布符并删除任何相应的 `NPM_TOKEN` GitHub 密报.

### 私营储存库出版

[npm 信任的出版](https://docs.npmjs.com/trusted-publishers/#troubleshooting) 支持私有源寄存器。 本工作流程向公众发布 `@flickfyi/flkr` npm 直接从私有软件包 `zshannon/crayon`npm 省略了私人寄存器的出处;出版物仍然有效。 工作流程不要求出处或更改存储器的能见度.

消费者可以检查 [npm 登记签名](https://docs.npmjs.com/verifying-registry-signatures/) 在安装软件包的项目中:

```sh
npm audit signatures
```

登记处的签名在登记处验证软件包的完整性;它们没有确定哪个来源承诺生产软件包.

[分阶段出版](https://docs.npmjs.com/staged-publishing/) 每次发布都需要维护者的2FA批准. 本工作流程使用直接发布,在合并到 `main`。 。 。 .

## 常见问题

### @flickfyi/flkr 是什么？

管理您浮点的工具

### 如何安装 @flickfyi/flkr？

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

### @flickfyi/flkr 支持 TypeScript 吗？

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

### @flickfyi/flkr 支持 ESM 还是 CommonJS？

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

### @flickfyi/flkr 需要什么版本的 Node\.js？

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

### @flickfyi/flkr 可以商用吗？

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

### @flickfyi/flkr 的下载量有多少？

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

### @flickfyi/flkr 还在维护吗？

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