# @flop-labs/cli 中文文档

规范地址：https://npmcn.com/package/%40flop-labs/cli/

版本：0\.5\.0
npm 元数据更新时间：2026-11-12T03:41:39.372Z
中文译文更新时间：2026-11-15T00:47:15.085Z
软件包许可：MIT OR Apache-2\.0

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

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

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

- 包体积（解压后）：687 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：6 个
- 首次发布：2026-10-29T04:00:59.319Z
- 最新版本发布：2026-11-12T03:41:39.116Z
- 近 30 天下载量：3085（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

FLOP 网络 CLI — 从终端与 FLOP 交互

## 安装

```sh
npm install @flop-labs/cli
```

也可以使用：`pnpm add @flop-labs/cli`、`yarn add @flop-labs/cli`、`bun add @flop-labs/cli`

## README

# @flop-labs/ cli (英语)

FLOP网络CLI——与命令行的FLOP网络节点进行互动.

## 安装

完整的CLI(钥匙,矿工,验证器和模型命令)需要Node.js 22+. 运行被绑放 从公共 npm 不在全球安装:

```bash
npx --yes --package @flop-labs/cli@0.4.0 flop --version
```

或者运行所推广的容器图像,它只需要多克. 对于可复制的消化针, 使用情况 [简森](https://flop.network/releases.json)。图像起始于 `/app`因此挂载 您的工作目录并在其中通过绝对路径 :

```bash
docker run --rm --network host -v "$PWD:/work" \
  ghcr.io/flop-labs/flop-core/cli:stable \
  --version
```

`npm install --global @flop-labs/cli` 也有用,不过还有一点 `flop` 打开 `PATH`页:1 hermes发射台下方的公共安装器拒绝安装旁边,两个命令 影相相会.

对于推荐的公有本土 Hermes 提供者路径, 在没有寄存器的情况下安装独立启动器 或软件包注册访问:

```sh
curl -fsSL https://flop.network/releases/cli/0.4.11/install.sh | sh -s -- --version 0.4.11
export PATH="$HOME/.local/bin:$PATH"
flop --network devnet hermes desktop --doctor
```

这个发布需要Node.js 22+,卷曲和合格的赫尔墨斯0.22.2发布. 它包含主机 Hermes命令和本地公共提供者0.1.6并保留现有的完整的CLI. 见 公共发射装置指南`docs/integrations/hermes-public-launcher.md` fLOP 存储器中)用于 原地设置序列,验收和24小时试验和验收限制. 替代主机发射装置需要为其生成的赫尔墨斯进行明确的准备 a. 家;不合格为在新的管理下的装置上单步发射。 完整的CLI 源构建遗存 :

```bash
pnpm install --frozen-lockfile
pnpm --filter @flop-labs/gateway-core build
pnpm --filter @flop-labs/sdk exec tsc
pnpm --filter @flop-labs/sdk run build:a2a-cjs
pnpm --filter @flop-labs/agent-sdk exec tsc
pnpm --filter @flop-labs/cli build
node sdk/cli/dist/cli.js --version # from the repository root
```

## 使用量

```bash
flop [options] [command]
```

### 全球选项

| 选项 | 说明 | 默认 |
| --- | --- | --- |
| `--network <name>` | `local`, (中文(简体) ), `devnet`, (中文(简体) ), `testnet`,或 `mainnet` | `local` |
| `--rpc <url>` | 明确的 RPC 覆盖 | 选中配置文件 |
| `--signer <uri>` | 本地签名符 URI | `//Alice` 仅本地 |
| `--keystore <path>` | 加密了 Polkadot JSON 密钥 | —— 说 |
| `--password-env <name>` | 含有密码的环境变量 | —— 说 |
| `--output <mode>` | `human`美丽 `json`,或紧凑 `agent` | `human` |
| `--json` | 输出为 JSON | 虚假 |

### 图标

#### 统一角色登入

角色命令为入职,诊断,状态, 和生命周期操作. `init` 财务报告和审定财务报表 `doctor` 只读。 诸如 `register`, (中文(简体) ), `calibrate-start`, (中文(简体) ), `commission`, (中文(简体) ), `unjail`, (中文(简体) ), `rejoin`,以及 `exit` 是明显的链子突变.

```bash
# Agents: the devnet tailnet MCP is read-only; local mode is signer-capable.
flop --network devnet agent init --client codex
flop --network devnet agent doctor
flop agent launch codex
flop agent proxy
flop agent hermes desktop
flop keys generate --out agent-key.json --password-env FLOP_KEY_PASSWORD
flop agent wallet create <agent-address>
flop agent session create --delegate <address>

# Miners: sim first, measured TDX for verified production, cloud is non-attested.
flop miner init --mode sim
flop miner doctor --mode sim
# A serving miner: chain state plus the public proof gateway admission checks.
# SESSION_AUTH_TOKEN comes from the environment, never the command line.
flop miner doctor --running --session-url http://127.0.0.1:8645/session/info --endpoint https://<miner-host>
flop miner status [address]
flop --signer <MINER-URI> miner register --commission 10
flop --signer <MINER-URI> miner calibrate-start

# Validators: live stake minimum and PoUI-gated committee state are queried.
flop validator init --mode local
flop validator doctor
flop validator status [address]
flop --signer <VALIDATOR-URI> validator register
flop --signer <VALIDATOR-URI> validator commission 10
flop --signer <VALIDATOR-URI> validator unjail
flop --signer <VALIDATOR-URI> validator rejoin
flop --signer <VALIDATOR-URI> validator exit
```

所有角色规划和诊断命令支助 `--json` 用于自动化. 全球网络和监管选项在任何筑巢深度都起作用.

#### 网络和水龙头

```bash
flop --network devnet network status
flop --network devnet faucet request <address>
flop --network testnet faucet request <address> --amount 25
flop --network mainnet network status       # planned; no faucet
```

Faucet 请求比较 RPC 和 水龙头 `/chain` 起源散开之前 要求资金。 承认的《皇家刑法》与明确 `--network` 实值 拒绝.

#### 具有代理效率的产出

使用 `--output agent` 对于稳定,单行JSON的结果 没有横幅, emoji,缩进,或成功 `doctor` 检查 :

```bash
flop --output agent miner doctor --mode tdx
flop --output agent validator status <address>
flop --output agent agent init --client codex
```

成绩包括 `ok:true`。失败会以非零退出和 紧凑 `code`, (中文(简体) ), `message`, (中文(简体) ), `retryable`选择 `next` 行动. `--json` 仍然是落后相容的JSON格式。 互动进程等 作为 `launch`, (中文(简体) ), `proxy`后,赫尔墨斯本身保留其应用程序输出 启动; 使用 Hermes `--dry-run` 用于一发可读的发射计划.

#### 卫生

```bash
flop health           # Human-readable
flop health --json    # JSON output
```

#### 余额

```bash
flop balance 5Grwva8T1BQxqNJJM...       # Check account balance
flop balance 5Grwva8... --json             # JSON output
```

#### GPU 检测

```bash
flop gpu              # Detect local GPUs
flop gpu --json       # JSON output
```

#### 已申报的GPU库存

```bash
nvidia-smi --query-gpu=name,memory.total --format=csv,noheader,nounits > gpus.csv
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner declare-gpu --nvidia-smi gpus.csv
flop miner declare-gpu --detect --dry-run   # on the GPU host itself; prints the remark only
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner declare-gpu --retract   # withdraw it
```

一个注册的矿工出版它运行的GPU作为签名 `flop.gpu-inventory.v1` 备注(格式: `docs/design/gpu-inventory-remark.md` 在FLOP寄存器中),因此探险家可以显示其硬件. 没错 自报并只显示:校正封顶,SKU天花板和奖励从未读过. 国家行动倡议 图像不能运行主机 `nvidia-smi`,因此将其输出通过 `--nvidia-smi` (单位:千美元)`-` 读取 stdin).

#### 能力预留率

```bash
flop miner capacity-rate show [address]      # rate, cap, reserved and free G_n/s at the finalized head
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner capacity-rate set 25 --dry-run   # encoded call only
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner capacity-rate set 25
flop --keystore miner.json --password-env FLOP_KEY_PASSWORD miner capacity-rate set --whole-cap   # clear it
```

每个频道对矿工的开通都保留这个费率,从接受的上限到频道 错误; 未设置, 它保留整个封顶, 所以每次只有一个通道适合 . `miner-worker` 保留  `floor(cap / MINER_MAX_CONCURRENT_SESSIONS)` 除非你设置了一个更低的。 呼叫只存在 - 命令拒绝.

#### 获取信息

```bash
flop info 5Grwva8...  # Get miner stake info
```

#### 会话密钥

```bash
flop session create --delegate <address> --daily-cap 50 --tx-limit 5
flop session list --owner <address>
flop --signer <DELEGATE-URI> chat --session-owner <OWNER> "hello"
flop --signer <DELEGATE-URI> proxy --session-owner <OWNER>
```

会期推断活动、到期和每日/周期预算, 然后通过 `executeViaSession`。 。 。 . `chat` 持续对话 标识和支持 `--conversation`, (中文(简体) ), `--history`,以及 `--delete`。 。 。 .

#### 命名最小推论

```bash
flop --network devnet --keystore agent.json --password-env FLOP_KEY_PASSWORD \
  session run --miner MINER_SS58 --model qwen/qwen2.5-0.5b-instruct \
  --endpoint MINER_HTTPS_URL --prompt 'Reply OK.' --max-flop 0.01 --max-tokens 8 --json
```

完成限制默认为256个令牌. `--max-tokens` 一定是正保险箱 整数; `--max-flop` 分隔代管。 JSON包括: `finish_reason` 财务报告和审定财务报表 `completion_tokens`· ; `length` 表示响应达到了其符号极限. 转弯 截止时间仍为60秒,所以大的符号限制或缓慢的推论仍然可以持续时间 关闭并跟踪正常的频道恢复。 分开解决 等待矿工 (b) 更快的推断不能绕过这一限制。 遗产矿工可能需要 `--auth-token-env MINER_SESSION_BEARER`。 。 。 .

#### 模型

```bash
flop model list
flop model get <hash-or-name> --precision FP16
flop model fetch <hash-or-name> --output-dir ./weights
flop model fetch <hash> --source hf:org/repo --precision INT8
flop model fetch <hash> --revision <40-hex sha> --output-dir ./weights
flop --signer <PUBLISHER> model upload --model-hash <hash> --path ./weights
flop --signer <PUBLISHER> model mirrors set --model-hash <hash> --append --source da:<table> --dry-run
BASE=http://miner:8000 DECODE_POLICY_HASH=0x<hash> \
  flop --network local model onboard --source org/model --precision BF16

# Existing-commitment recovery/advanced mode:
flop --signer <PUBLISHER> model upload \
  --model-hash <hash> --commitment <0x-hash> --size <bytes>
```

获取接受 `hf:`, (中文(简体) ), `modelscope:`,HTTPS,和 `da:` 来源和只写 dm-verity 匹配已注册根后。 单向一时的一面相机 承诺: `--revision <sha>` 把它钉上,没有它 `main` 仅当其 sha256表复制a `content-v1` 根数( e)`upload --source hf:` 同样;见 `docs/onboarding/model.md`) (中文(简体) ). 完整上传 构建 Canonial 图像, 运行 `da-validator submit`登记它租来的地盘 把它绑起来. 机上额外登记模型,镜像,精度测量根, 并解码政策,但只有在 服务终点通过捕获回放, 装订拒绝,和输出协调探测器。 重运行它不会提交信件 . `--hf-repo owner/model` 给一个本地 `--source` a 拥抱相貌镜,但仅限 复出后再复制被测量的根. 重新运行时添加了镜像 到一个已经注册的模型.

#### 网关配置

```bash
export MINER_GATEWAY_TOKEN='from-a-secret-manager'
flop gateway allowlist \
  --miner https://miner.example \
  --network devnet \
  --auth-token-env MINER_GATEWAY_TOKEN \
  --attestation ./gateway-attestation.json \
  --json
```

命令已准备就绪 `GATEWAY_SESSION_ALLOWLIST` 财务报告和审定财务报表 `GATEWAY_MODEL_CATALOG` 字符串值。 选定网络提供 RPC 默认。 匿名探测 `/session/info` 首先要求持证人, 然后检查每个公布的身份字段 `model-registry`,包括: 测量根和解码政策许可列表,并检查矿工的校正 对定案 `hw-calibration` 示意图.

证明文件的使用 `schema_version: "flop.gateway-attestation.v1"` 财务报告和审定财务报表 包含 `broker` 限制, `deployment` 证据,以及 `catalog` 证据。 这个 目录块是一个 `CanonicalModelRecord` 没有生成的身份字段 或者说 `prices`它携带一个 `price` 换成快照 部署 `observedAt`编号 :`expiresAt`,目录价格有效性,特征符合 使用不变。 过期证据被拒绝,而不是被刷新.

```bash
# GATEWAY_SESSION_ALLOWLIST / GATEWAY_MODEL_CATALOG hold the gateway's own values.
export GPUAI_API_KEY='from-a-secret-manager'
export GATEWAY_RENEWER_SIGNER_URI='dedicated funded account, not the broker signer'
flop --network devnet gateway renew \
  --allowlist-env GATEWAY_SESSION_ALLOWLIST \
  --catalog-env GATEWAY_MODEL_CATALOG --catalog-pricing chain \
  --provider-key-env GPUAI_API_KEY \
  --probe-signer-env GATEWAY_RENEWER_SIGNER_URI --probe-escrow 1 \
  --out /opt/flop/gateway-evidence/gateway-evidence.json
```

`gateway renew` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}然后写着 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080} 文件网关热重装为 `GATEWAY_EVIDENCE_FILE`一个矿工 只有在 GPU.ai 仍然报告该实例时才会更新部署 `deployment.source` (单位:千美元)`operator-observed:gpu.ai/<instance> <region> <gpu>`, (中文(简体) ), 随附 `(label)`,作为 `running` 在那个地区的GPU。 这个 GPU是GPU.ai的标识符(`rtx_a6000`)或它在GPU.ai的GPU类型表格中的名称 (单位:千美元)`RTX A6000`,有或无 `NVIDIA`; 任何其他名称不续用. A 类 尾网托管矿工`operator-observed:tailscale/<host> egress <ipv4> AS<n>`, (中文(简体) ), 网络名称和a `(label)`) 仅在 主机尾缩放( n)`--tailscale-socket`在网上看到这个名字的一个节点, 标记 `tag:miner`,直接走出该 " egress " 地址 因此,该地址仍然保留。 认证 `/session/info` 还必须在被封住的地址上做广告, 飞地钥匙和身份 最终的链条仍然承认。 记录 `tools` 只有通过 一个真正的计算通道转弯, 从探测器的代管人支付 框带 a `lookup` 带有 JSON 的工具调用 `query`。每次更新都保持其 已声明窗口长度 。 所有其他声称的特征 还没有探测和失效. 没有续约的都从档案中遗漏出来,在申报时失效 过期。 命令退出 1 当任何事项失效, 并且从未打印许可列表 . 在每一次探测前,都需要一次 `--probe-escrow` 探测器上的免费 最终头部。 当签字人持少, 没有进一步的探测器运行, Stderr说 `gateway renew: PROBE SIGNER UNDERFUNDED: …`。 。 。 . GPU.ai 单声道响应形状(`status`, (中文(简体) ), `region`, (中文(简体) ), `gpu_type`)为 从定价中假设并创建 API,所以观看第一次运行.

操作员可以公布已结算的拥有者要求的工具资格 不创建另一个探测器或使用直接更新器的签名人/提供者证书:

```bash
flop --network devnet gateway renew \
  --catalog-env GATEWAY_MODEL_CATALOG --catalog-pricing chain \
  --qualification-receipt ./settled-tools-qualification.json \
  --qualification-receipt-sha256 "$QUALIFICATION_RECEIPT_SHA256" \
  --out /opt/flop/gateway-evidence/gateway-evidence.json
```

散列必须识别准确的不可变的收件字节. 只接收模式拒绝 直接测试选项。 它验证原始所有者/居民/用途信封,签名 转接/前置/ACK和警犬最后确定正结算,然后将一个通行证附加到 现有证据文件。 它保留了无关的部署和符合规定的条目, 保留校准的原始探测时间和已宣布窗口,并拒绝 互相矛盾的重新出版。 相同的收据是没有的。 同时 `gateway renew` 命令使用此版本使用独有的出版锁定; 冲突作者 失败而不是替换其内容。 必须协调老作家或无关作家 分别。 只收出版物只保留该制作人最新的未过期通行证 保存其原始时间和所有无关的证据. 在写作时杀死的进程可以离开 `OUT.lock`; 确认作者已停止 手动恢复那个锁, 永远不要去掉另一个活跃的作者的锁. 不得再推论、代管、提交签字或自动公布 资格结束点。 普通聊天继续需要新工具 招生; 资格申请不是允许任意运行 stale-tools 聊天.

#### 钥匙、硬件、多西格和空接签名

```bash
export FLOP_KEY_PASSWORD='from-a-secret-manager'
flop keys generate --name treasury --out treasury.json \
  --password-env FLOP_KEY_PASSWORD
export FLOP_IMPORTED_SECRET='mnemonic from a secret manager'
flop keys import --secret-env FLOP_IMPORTED_SECRET --out imported.json \
  --password-env FLOP_KEY_PASSWORD
flop keys export treasury.json --source-password-env FLOP_KEY_PASSWORD \
  --out treasury-backup.json --password-env FLOP_BACKUP_PASSWORD
flop keys inspect treasury.json
flop keys hardware

flop multisig address --threshold 2 --signatory <A> <B> <C>
flop --keystore treasury.json --password-env FLOP_KEY_PASSWORD \
  multisig propose --threshold 2 --other <B> <C> --call <0x-call>
flop multisig list --account <MULTISIG>

flop tx build --address <ADDRESS> --call <0x-call> \
  --out unsigned.json --qr
flop tx broadcast unsigned.json --signature <0x-multisignature>
```

`tx build` pins 起源、运行时间、交易版本和非ce。 广播 拒绝漂移。 终端 QR 使用可选 `qrencode`JSON信封有用吗 带有 Polkadot 空洞、 硬件钱包、 HSM/ MPC 保管器, 或其他分离器 签名者.

#### 钱包

```bash
flop wallet agent create <agent-address> --daily-cap 50 --tx-limit 5
```

#### 共享脱网代理证书

为任何支持的代理客户端提供一键而不启动赫尔墨斯:

```bash
flop --network devnet agent credential           # path, live model, quota; no bearer
flop --network devnet agent credential --json    # non-secret metadata
flop --network devnet agent credential --print-key # secret on stdout for local auth helpers
flop --network devnet agent credential --tailnet # private lane for approved Tailscale users
```

命令需要明确 `--network devnet`。默认情况下,它将在 公共网关 `https://api.flop.network` 带有钱包签名。 在第一次使用时 它在 `~/.flop/devnet-enroll-wallet.json` (未加密,只有devnet,模式0600;其秘密从未被打印出). 如果是这样 账户持有量低于1 FLOP, 它要求从 `https://faucet.flop.network/fund` 并等待补助金最后确定 `wss://rpc.devnet.flop.network` (单位:千美元)`--rpc` (原始内容存档于2017-03-25). overse. 然后签下 网关单用挑战. 密钥被缓存于 `~/.flop/devnet-wallet-agent-key.json`经营者必须明确资助和配置津贴;建议 临时使用补助金为20,000德文FLOP, 范围为: 入学,24小时内期满。 重新注册 持单人轮换,但绝不延长配额或期满.

`--tailnet` 保留私人专用道,供经批准的Tailscale用户使用。 它的注册在 `http://gateway.ts.flop.network:3201/enroll` 并给养七日, 缓存于 `~/.flop/devnet-agent-key.json` 与赫尔墨斯供养者分享. 两个缓存都是POSIX系统上一个模式-0700目录中的0600模式. A 类 `.lock` 每一个缓存目录都会对本地客户端的注册进行序列化 。 这个 `--print-key` 形式刻意明确; 重新定向或私下消耗 而不是记录终端输出。 烂透了 `.lock` 崩溃后的目录 只有在确认没有进行注册后才能删除.

`flop --network devnet agent init` 财务报告和审定财务报表 `agent doctor` 利用公众 `https://mcp.flop.network/mcp` 默认只读服务; 通过 `--mcp-url` 瞄准另一个经核实的终点.

#### 赫尔墨斯桌面

当地公共提供者(`sdk/hermes_public`与 独立发射器0.4.5. 使用 `flop hermes plugin install` 在一个孤立的 `HERMES_HOME` 之后 `hermes pm repair`,则 `hermes auth add flop-public`, (中文(简体) ), `hermes model` 财务报告和审定财务报表 `hermes desktop`单独的私人提供者(`sdk/hermes_native`(中文(简体) ) 需要经批准的Tailscale身份和FLOP寄存器访问. 遵循公共本地设置指南(`docs/integrations/hermes-public-launcher.md`, (中文(简体) ), 推荐公用路线的"国内公用提供者"). 完整的CLI也保留了私有的尾网道:

```bash
flop --network devnet hermes desktop --dry-run --json # inspect without provisioning
flop --network devnet hermes desktop --gateway http://gateway.ts.flop.network # tailnet lane
```

从源检出, 替换 `flop` 与 `node sdk/cli/dist/cli.js` 之后 上面的建筑. 替代公共主机发射装置需要有管理的家用准备 在公共指南中; 立即启动桌面不合格。 与 尾声网 `--gateway`中,必须先批准您的 Tailscale 用户 ID; 以 [访问请求](https://github.com/flop-labs/network/issues/new?template=access.yml)然后,CLI获得7天、25个FLOP模型范围津贴和 将密钥存储在 `~/.flop/devnet-agent-key.json` (第0600节). 日后发射 以及其它本地代理客户端检查并再使用缓存密钥. 如果本地密钥丢失或拒绝, 注册者在保存时旋转 其支出额和到期日。 用尽、过期和被吊销津贴 操作员可以更新或重新验证它们。 普通 CLI 输出不打印密钥 .

无 `--network devnet`,命令会像以前一样启动嵌入式签名器代理 :

```bash
flop hermes desktop                                  # embedded proxy + launch Hermes
flop --signer //Bob hermes desktop                   # settle under //Bob
flop hermes desktop --model llama-3-8b-instruct --max-flop 10 --max-tokens 4096
flop hermes desktop --proxy-port 1234                # embedded proxy on a custom port
flop --network devnet --signer "$FLOP_SIGNER" hermes desktop --proxy # funded signer
flop hermes desktop --configure                      # also persist via `hermes config set`
flop hermes desktop --no-proxy \
  --gateway http://gateway.ts.flop.network --model "$FLOP_MODEL"
flop hermes desktop --dry-run --json                 # print resolved env/launch plan, don't launch
```

它通过env vars Hermes读取一个自定义将Hermes接入嵌入式代理 OpenAI相容的终点—— `OPENAI_BASE_URL` (- 代理 `/v1`, (中文(简体) ), `OPENAI_API_KEY`, (中文(简体) ), 财务报告和审定财务报表 `HERMES_INFERENCE_MODEL` (单位:千美元)`api_mode` 自动检测 `chat_completions`) ——加 `FLOP_WS_URL`编号 :`FLOP_SIGNER` 联 合 国 `@flop-labs/hermes-plugin`。 。 。 . `--configure` 继续通过真实的线条 `hermes config set` 国 际 (单位:千美元)`model.provider=custom`, (中文(简体) ), `model.base_url`, (中文(简体) ), `model.api_mode`, (中文(简体) ), `model.default`) (中文(简体) ). 需要 Hermes 二进制 (`hermes-desktop` 或者说 `hermes`继续 `PATH`; 使用 `--dry-run` 检查没有它。 自定义主机 `--gateway` 需求 `FLOP_API_KEY` 私人和明确 `--model` 从现场 目录. CLI检查网关健康、模式可用性和关键有效性 在发射前 私人的devnet网关只能从 FLOP 进入 尾声网.

#### 本地 OpenAI 代理服务器

曝光本地 OpenAI 兼容 API( 如 LM Studio / Ollama 本地服务器) 地点 **每一份请求都在您的签名人名下提交和解决**。 。 。 . 代理估计值 G n, 提交 PoI 任务, 等待 TEE 矿工解决 ,然后返回结果 —— 全部在 OpenAI REST 计划后面 :

```bash
flop proxy                                   # http://127.0.0.1:3201/v1
flop --signer //Bob proxy --max-flop 10
flop proxy --port 1234 --host 0.0.0.0        # expose beyond localhost
```

| 终点 | 目的 |
| --- | --- |
| `POST /v1/chat/completions` | 聊天推论( OpenAI 兼容), `stream: true` 支持 |
| `POST /v1/completions` | 文本补全, `stream: true` 支持 |
| `GET /v1/models` | 列出模型( 从有效载荷网关活到默认状态) |
| `GET /v1/models/{id}` | 获取单一模式 |
| `POST /v1/embeddings` | 嵌入,计算 **当地** (无链)-见下文 |
| `GET /health` | 活 动 |
| `OPTIONS *` | CORS 预飞(允许,用于浏览器/电子客户端) |

**嵌入层** 是一个廉价的高频RAG原始,不需要在链上 和解,所以代理计算 **当地** 带有小型嵌入模型 (默认) `Xenova/all-MiniLM-L6-v2`, L2 正常输出, 如 Ollama `/api/embed`) (中文(简体) ). 这需要可选的运行时间依赖性——安装一次:

```bash
pnpm add @huggingface/transformers
```

没有它, `/v1/embeddings` 返回时 `501` 使用此提示( 聊天/ 补全为 (不受影响)。 以 `--embedding-model <hf-id>`。 。 。 .

**流线 :** `stream: true` 返回 OpenAI SSE 块(`data: {…}` . `data: [DONE]`, (中文(简体) ), 包括通过 `stream_options.include_usage`FLOP 解决 解剖任务,所以这是 _清算时流_: 正在等待结果, 那么 以块形式排放(纬度至先入位=结算时间),而非递增 矿工一代.

**型号:** `/v1/models` 反映有效载荷网关登记册 (单位:千美元)`<payload-gateway>/v1/models`),如果是,则会回到内置默认值 不可通达.

选项 : `--port` (3201), (中文(简体) ), `--host` (127.0.0.1) (中文(简体) ), `--payload-gateway` (脱链即时/结果数据平面,默认值) `http://localhost:3200`, (中文(简体) ), `--model`, (中文(简体) ), `--max-tokens` (违约2048), `--max-flop`全球用途 `--rpc`编号 :`--signer`。指向任何 OpenAI 客户端 `OPENAI_BASE_URL=http://127.0.0.1:3201/v1`。 。 。 .

## 建筑

-   由指挥官.js建造
-   通过 `"@flop-labs/sdk": "file:../typescript"`
-   带有 ES 模块的脚本类型,通过 `tsc`
-   所有命令都使用 `FlopClient.create()` 从SDK与 `--rpc` 财务报告和审定财务报表 `--signer` 全球选项
-   角色组 重用已有的启动,代理,密钥,钱包,会话, schoing, TDX, 和提供者的工作流程,而不是引入平行实施.

运算符图像: 使用 `ghcr.io/flop-labs/flop-core/cli:stable` (最低为0.1.272), `ghcr.io/flop-labs/flop-core/miner-worker:stable` (至少0.172)和 `ghcr.io/flop-labs/flop-core/miner-vllm-toploc:stable` (最低为0.1172). 对于可复制的针头,请使用版本和摘要 [简森](https://flop.network/releases.json)。 。 。 . `just miner-pack /tmp/flop-miner-pack` 对照最小值检查、复制和设定图像 `:stable`。 。 。 . 包是公用路线,没有尾网:公共RPC,邮箱和赞助商,以及 `docker-compose.tls.yml` 用于会话结束点.

## 常见问题

### @flop-labs/cli 是什么？

FLOP 网络 CLI — 从终端与 FLOP 交互

### 如何安装 @flop-labs/cli？

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

### @flop-labs/cli 支持 TypeScript 吗？

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

### @flop-labs/cli 支持 ESM 还是 CommonJS？

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

### @flop-labs/cli 需要什么版本的 Node\.js？

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

### @flop-labs/cli 可以商用吗？

@flop-labs/cli 使用 MIT OR Apache-2\.0 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @flop-labs/cli 的下载量有多少？

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

### @flop-labs/cli 还在维护吗？

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