# @crediolabs/policy-builder-cli 中文文档

规范地址：https://npmcn.com/package/%40crediolabs/policy-builder-cli/

版本：5\.2\.0
npm 元数据更新时间：2026-10-26T11:50:20.345Z
中文译文更新时间：2026-11-14T13:39:52.833Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：16.4 kB，16 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12
- 运行依赖：3 个
- 首次发布：2026-07-23T13:42:12.594Z
- 最新版本发布：2026-10-26T10:27:31.283Z
- 近 30 天下载量：2030（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 43 个）

## 中文简介

OZ 政策构建器的命令行 : `policy-builder <tool>` 运行8个政策合成工具中的任何一个,并打印其JSON信封.

## 安装

```sh
npm install @crediolabs/policy-builder-cli
```

也可以使用：`pnpm add @crediolabs/policy-builder-cli`、`yarn add @crediolabs/policy-builder-cli`、`bun add @crediolabs/policy-builder-cli`

## README

# @crediolabs/政策建设者-cli

OZ政策构建器的命令行. 每个工具 [`@crediolabs/policy-synth`](https://npmcn.com/package/%40crediolabs/policy-synth/README.md) 是一个命令,从其表格中注册.

```sh
npm install -g @crediolabs/policy-builder-cli@5.2.0
```

```sh
policy-builder <tool> [json | --file path | - | --field value ...] [--out path]
```

```sh
policy-builder record --network testnet --hash <tx>
policy-builder synthesize --network testnet --hash <tx> --limit 5000000
policy-builder synthesize '{"intent": {"calls": [{"contract": "C...", "fn": "pay", "where": [{"constraint": "cap", "at": [0], "max": "100"}]}]}}'
policy-builder verify --file verify.json
policy-builder info --verifyLive true
policy-builder review --network testnet --xdr <unsigned XDR>
policy-builder bind --network testnet --smartAccount C... --sourceAccount G... --ruleId 7 --executor C...
policy-builder install --network testnet --smartAccount C... --sourceAccount G... --signers '["G..."]' --follow '{"smartAccount": "C...", "ruleId": 2}'
```

以工具的全名或该工具的独特起止(`record`, (中文(简体) ), `synthesize`, (中文(简体) ), `simulate`, (中文(简体) ), `verify`, (中文(简体) ), `install`, (中文(简体) ), `revoke`, (中文(简体) ), `bind`, (中文(简体) ), `info`, (中文(简体) ), `review`) (中文(简体) ). 输入是 JSON 参数, `--file`, (中文(简体) ), `-` (sdin) 或 (中文(简体) ) `--field value` 成对( JSON 的值是 读作JSON). 一个JSON信封是Stdout的 同一个MCP服务器 返回 : `{ ok: true, data }` 或者说 `{ ok: false, error: { code, message, retryable } }`。退出代码为:0;拒绝者为1;使用不当者为2; `--out` 将信封写入文件.

CLI没有关键材料 `install` 财务报告和审定财务报表 `revoke` 返回时 未签名 XDR 。 操作员的设置是环境变量: `POLICY_BUILDER_RPC_URL_<NETWORK>`, (中文(简体) ), `POLICY_BUILDER_SAFE_READS_<NETWORK>`, (中文(简体) ), `POLICY_BUILDER_ALLOW_SPOT_READS`, (中文(简体) ), `POLICY_BUILDER_ALLOW_OVERRIDES` (外边) 测试网 a `allow*` 超绝者只负1分,钱包上有许多迹象, `POLICY_BUILDER_AUTH_LEDGERS` (违约300起) `POLICY_BUILDER_MAX_RESOURCE_FEE` (默认 10 XLM). 工具、限制和安装 护栏(门槛或 `anyOne`限制开支的护卫, 读取安全, 重叠扫描)在政策合成README中描述.

`policy-builder review` 用于账户所有者:它读取一个未签名的安装或 仅从字节中删除,没有RPC。 它列出了它在《公约》中发现的问题 字节( e)`problems`, (中文(简体) ), `signable`),然后从这些字节重建评论: 交易、管理局节点和上游. `signable` 这并不意味着安全: 代理可以一致地重写字节,所以所有者读管理局 节点与它们的含义相对 (参见政策合成中的"所有者评论") 读取. 有合同签署人的规则是离线问题; `--readContracts true` 通过操作员的RPC读取分类账上的每一张。 那只有一个 适配器绑入无闸口,适配器签名 标定在自身范围的规则 不是针 `call_fn = run`,或者未部署的合同被标出,以及其他 合同内容为可签但未经核实的:控制合同的业主检查. 遵循另一规则的安装( )`install --follow`没有上游, 因此,它读作一个问题 离线; `--readContracts true` 还读了 遵守规则的上方和下方 现在从被钉住的翻译和显示 他们下 `Follows`。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @crediolabs/policy-builder-cli 是什么？

OZ 政策构建器的命令行 : policy-builder \<tool\> 运行8个政策合成工具中的任何一个,并打印其JSON信封\.

### 如何安装 @crediolabs/policy-builder-cli？

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

### @crediolabs/policy-builder-cli 支持 TypeScript 吗？

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

### @crediolabs/policy-builder-cli 支持 ESM 还是 CommonJS？

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

### @crediolabs/policy-builder-cli 需要什么版本的 Node\.js？

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

### @crediolabs/policy-builder-cli 可以商用吗？

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

### @crediolabs/policy-builder-cli 的下载量有多少？

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

### @crediolabs/policy-builder-cli 还在维护吗？

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