pp-render

Render — Printing Press 命令行工具

前置条件：安装命令行工具

此技能依赖 render-pp-cli 二进制文件。**调用此技能中的任何命令前，必须确认已安装该命令行工具。**如果尚未安装，请先安装：

1. 通过 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install render --cli-only
   

2. 验证：render-pp-cli --version
3. 确保报告的安装目录位于将调用此技能的 Agent／运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接 Go 安装（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/cloud/render/cmd/render-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功前，请勿继续执行技能命令。

何时使用此命令行工具

当你需要从整体上分析 Render 资源，而不是逐个查看资源时，请使用 render-pp-cli。它非常适合跨环境提升环境变量、在 CI 中检查 Blueprint 漂移、汇总月度成本、清理预览环境，以及分析审计日志。对于 render psql 或 render ssh 这类一次性的交互式工作流，官方命令行工具就够用了——render-pp-cli 也能处理这些场景，但它真正的价值在于那些仪表板隐藏的分析命令。

独特功能

这些功能在该 API 的其他工具中均不可用。

持续积累的本地状态

• env diff — 以三方差异比较的方式，对比任意两个服务、环境组之间，或服务与环境组之间的环境变量。

  跨环境提升配置时使用——这是无需逐页点击就能了解实际差异的最简便方式。

  render-pp-cli env diff srv-staging-api srv-prod-api --json
  

• env promote — 使用 --only/--exclude/--dry-run，将环境变量从源服务或环境组复制到目标服务或环境组。

  发布已验证的暂存环境配置到生产环境时使用，避免一并复制仅供开发环境使用的密钥。

  render-pp-cli env promote --from srv-staging-api --to srv-prod-api --exclude DEBUG_TOKEN --dry-run
  

• drift — 将纳入版本控制的 render.yaml 与实时工作区状态进行比较，并按名称报告新增、移除或修改的实体。

  在 CI 中运行此命令；如果有人绕过 Blueprint、直接通过仪表板修改生产环境，就让构建失败。

  render-pp-cli drift --blueprint render.yaml --json
  

• cost — 汇总服务、postgres、key-value、redis 和磁盘的月度成本；按项目、环境或所有者分组。

  可在周五进行成本审查时使用，或者当财务询问“如果缩减这三个服务的规格会怎样？”时使用。

  render-pp-cli cost --group-by project --json
  

• rightsize — 对每个服务，获取最近 --since 7d 的 CPU 和内存数据，计算 p95 利用率，并根据计划容量标记超出 --high 或 --low 阈值的服务。

  在汇总成本前运行此命令，找出可快速缩减规格的对象，或即将受到限流的服务。

  render-pp-cli rightsize --since 7d --high 80 --low 20 --json
  

生命周期管理

• preview-cleanup — 列出超过 --stale-days N 天的预览服务；使用 --confirm 批量删除。

  当月度账单突然升高，且你怀疑存在未清理的预览环境时使用。

  render-pp-cli preview-cleanup --stale-days 14 --confirm
  

• orphans — 查找未关联的磁盘、空环境组、指向已删除服务的自定义域名、未被任何服务引用的注册表凭据，以及超出保留期限的磁盘快照。

  清理审计、账单审查和 SOC 2 证据收集都可以从这里开始。

  render-pp-cli orphans --json
  

Agent 原生基础设施

• env where — 给定一个环境变量键，列出定义了该变量的所有服务和环境组，并显示哈希、长度和最后修改时间戳（绝不显示原始值）。

  凭据轮换或“谁在使用这个密钥”审计时的首次调用。

  render-pp-cli env where STRIPE_KEY --json
  

• incident-timeline — 将一个服务在指定时间范围内的部署、事件和审计日志合并为一个按时间顺序排列的表格。

  部署后凌晨 2 点收到告警时，值班人员应运行的第一条命令。

  render-pp-cli incident-timeline srv-checkout-api --since 2h --json
  

• audit search — 按操作者、目标、操作和时间范围，对缓存的审计日志进行 FTS5 搜索。

  用于收集 SOC 2 证据，或回答“上个季度是谁轮换了这个密钥”。

  render-pp-cli audit search --actor [email protected] --target STRIPE_KEY --since 30d --json
  

• deploys diff — 显示同一服务两次部署之间的提交范围、环境变量变更、镜像标签变更，以及方案／区域／规模变更。

  部署后回归问题排查时的第一条命令，可回答“实际变更了什么”。

  render-pp-cli deploys diff srv-checkout-api dep-aaa dep-bbb --json
  

命令参考

blueprints — Blueprints 允许你在 render.yaml 文件中定义资源，并自动将变更同步到你的 Render 服务。 API 可控制如何使用 Blueprints 创建和管理资源。

• render-pp-cli blueprints disconnect — 断开与指定 ID 的 Blueprint 的连接。断开 Blueprint 后，将停止通过...自动同步资源
• render-pp-cli blueprints list — 列出指定工作区的 Blueprints。如果未指定工作区，则返回 API 密钥可访问的所有 Blueprints...
• render-pp-cli blueprints retrieve — 获取指定 ID 的 Blueprint。
• render-pp-cli blueprints update — 更新指定 ID 的 Blueprint。
• render-pp-cli blueprints validate — 验证 render.yaml Blueprint 文件，但不创建或修改任何资源。此端点会检查语法...

cron-jobs — 管理 cron 作业

disks — 磁盘 允许你为服务附加持久存储。

• render-pp-cli disks add — 为 Web 服务、私有服务或后台工作进程附加持久磁盘。必须重新部署服务才能...
• render-pp-cli disks delete — 删除附加到服务的持久磁盘。磁盘上的所有数据都将丢失。 磁盘关联的服务...
• render-pp-cli disks list — 列出符合指定筛选条件的持久磁盘。如果未指定筛选条件，则返回你拥有的所有磁盘...
• render-pp-cli disks retrieve — 获取指定 ID 的持久磁盘。
• render-pp-cli disks update — 更新指定 ID 的持久磁盘。磁盘关联的服务必须已部署且处于活动状态，才能...

env-groups — 管理环境组

• render-pp-cli env-groups create — 创建新的环境组。
• render-pp-cli env-groups delete — 删除指定 ID 的环境组，包括其中包含的所有环境变量和密钥文件。
• render-pp-cli env-groups list — 列出符合指定筛选条件的环境组。如果未指定筛选条件，则返回所有环境组。
• render-pp-cli env-groups retrieve — 按 ID 获取环境组。
• render-pp-cli env-groups update — 更新环境组的属性。

environments — 管理环境

• render-pp-cli environments create — 在指定 ID 的项目中创建新环境。

• render-pp-cli environments delete — 删除指定 ID 的环境。要求该环境为空（即不包含任何服务...

• render-pp-cli environments list — 列出指定项目中符合筛选条件的环境。如果未指定筛选条件，则返回所有环境...

• render-pp-cli environments retrieve — 获取指定 ID 的环境。

• render-pp-cli environments update — 更新指定 ID 的环境详情。 events — 查看服务、Postgres 或键值存储的事件

• render-pp-cli events <eventId> — 获取特定事件的详细信息

key-value — Key Value 允许你与 Render Key Value 实例交互。

• render-pp-cli key-value create — 创建新的 Key Value 实例。
• render-pp-cli key-value delete — 按 ID 删除 Key Value 实例。
• render-pp-cli key-value list — 列出符合所提供筛选条件的 Key Value 实例。如果未提供筛选条件，则列出所有 Key Value 实例……
• render-pp-cli key-value retrieve — 按 ID 获取 Key Value 实例。
• render-pp-cli key-value update — 按 ID 更新 Key Value 实例。

logs — 日志允许你获取服务、Postgres 数据库和 redis 实例的日志。 你可以查询日志，也可以通过 websocket 实时订阅日志。

• render-pp-cli logs delete-owner-stream — 移除指定工作区的日志流。
• render-pp-cli logs delete-resource-stream — 移除指定资源的日志流覆盖设置。删除后，该资源将使用工作区的……
• render-pp-cli logs get-owner-stream — 返回指定工作区的日志流信息。
• render-pp-cli logs get-resource-stream — 返回指定资源的日志流覆盖信息。日志流覆盖设置的优先级高于……
• render-pp-cli logs list — 列出符合所提供筛选条件的日志。日志按开始和结束时间戳分页。还有更多日志……
• render-pp-cli logs list-resource-streams — 列出指定工作区中符合所提供筛选条件的日志流覆盖设置。这些覆盖设置……
• render-pp-cli logs list-values — 列出符合所提供筛选条件的日志中给定日志标签的所有值。
• render-pp-cli logs subscribe — 打开 websocket 连接，以订阅符合所提供筛选条件的日志。日志会实时流式传输……
• render-pp-cli logs update-owner-stream — 更新指定工作区的日志流信息。此工作区拥有的所有资源的日志都将……
• render-pp-cli logs update-resource-stream — 更新指定资源的日志流覆盖信息。日志流覆盖设置的优先级高于……

maintenance — Maintenance 端点允许你获取 Render 服务最近的维护运行记录。你还可以重新安排维护时间，或立即触发维护。

• render-pp-cli maintenance list — 列出指定资源已安排和／或最近的维护运行记录。
• render-pp-cli maintenance retrieve — 获取具有所提供 ID 的维护运行记录。
• render-pp-cli maintenance update — 更新具有所提供 ID 的维护运行记录。此端点的更新操作是异步的。若要检查更新的……

metrics — Metrics 端点允许你获取服务、Postgres 数据库和 redis 实例的指标。

• render-pp-cli metrics get-active-connections — 获取一个或多个 Postgres 数据库或 Redis 实例的活动连接数。
• render-pp-cli metrics get-bandwidth — 获取一个或多个资源的带宽使用量。
• render-pp-cli metrics get-bandwidth-sources — 获取一个或多个资源按流量来源（HTTP、WebSocket、NAT、PrivateLink）细分的带宽使用量……
• render-pp-cli metrics get-cpu — 获取一个或多个资源的 CPU 使用量。
• render-pp-cli metrics get-cpu-limit — 获取一个或多个资源的 CPU 限制。
• render-pp-cli metrics get-cpu-target — 获取一个或多个资源的 CPU 目标值。
• render-pp-cli metrics get-disk-capacity — 获取一个或多个资源的持久磁盘容量。
• render-pp-cli metrics get-disk-usage — 获取一个或多个资源的持久磁盘使用量。
• render-pp-cli metrics get-http-latency — 获取一个或多个资源的 HTTP 延迟指标。
• render-pp-cli metrics get-http-requests — 获取一个或多个资源的 HTTP 请求数。
• render-pp-cli metrics get-instance-count — 获取一个或多个资源的实例数。
• render-pp-cli metrics get-memory — 获取一个或多个资源的内存使用量。
• render-pp-cli metrics get-memory-limit — 获取一个或多个资源的内存限制。
• render-pp-cli metrics get-memory-target — 获取一个或多个资源的内存目标值。
• render-pp-cli metrics get-replication-lag — 获取 Postgres 副本的复制延迟秒数。
• render-pp-cli metrics get-task-runs-completed — 获取一个或多个任务已完成的任务运行总数。可按状态（succeeded/failed）筛选，也可……
• render-pp-cli metrics get-task-runs-queued — 获取一个或多个任务已排队的任务运行总数。
• render-pp-cli metrics list-application-filter-values — 列出一个或多个资源可用于筛选的实例值。
• render-pp-cli metrics list-http-filter-values — 列出一个或多个资源可用于筛选的状态码和主机值。
• render-pp-cli metrics list-path-filter-values — 路径建议基于最近 5000 行日志，并按提供的筛选条件筛选

metrics-stream — 管理指标流

• render-pp-cli metrics-stream delete-owner — 删除指定工作区的指标流。
• render-pp-cli metrics-stream get-owner — 返回指定工作区的指标流信息。
• render-pp-cli metrics-stream upsert-owner — 创建或更新指定工作区的指标流。

notification-settings — 通知设置允许你配置希望接收哪些通知，以及 接收通知的位置。

• render-pp-cli notification-settings list-notification-overrides — 列出与提供的筛选条件匹配的通知覆盖项。如果未提供筛选条件，则返回所有通知……
• render-pp-cli notification-settings patch-owner — 更新指定 ID 的所有者的通知设置。
• render-pp-cli notification-settings patch-service-notification-overrides — 更新指定 ID 的服务的通知覆盖项。
• render-pp-cli notification-settings retrieve-owner — 获取指定 ID 的所有者的通知设置。请注意，此命令需要提供所有者 ID……
• render-pp-cli notification-settings retrieve-service-notification-overrides — 获取指定 ID 的服务的通知覆盖项。请注意，此命令需要提供服务 ID……

organizations — 管理组织

owners — 管理所有者

• render-pp-cli owners list — 列出你的 API 密钥有权访问的工作区，可按名称或所有者邮箱地址筛选。

• render-pp-cli owners retrieve — 获取指定 ID 的工作区。工作区 ID 以 tea- 开头。如果提供用户 ID（以……开头 postgres — Postgres 端点可让你与 Render Postgres 数据库进行交互。 你可以管理数据库、导出、恢复和故障转移。

• render-pp-cli postgres create — 创建新的 Postgres 实例。

• render-pp-cli postgres delete — 按 ID 删除 Postgres 实例。此操作不可撤销，所有数据都将丢失。

• render-pp-cli postgres list — 列出符合所提供筛选条件的 Postgres 实例。如果未提供筛选条件，则返回所有 Postgres 实例。

• render-pp-cli postgres retrieve — 按 ID 获取 Postgres 实例。

• render-pp-cli postgres update — 按 ID 更新 Postgres 实例。

projects — 管理项目

• render-pp-cli projects create — 创建新项目。
• render-pp-cli projects delete — 删除具有所提供 ID 的项目。要求该项目的 所有 环境均为空（即，它们必须...
• render-pp-cli projects list — 列出符合所提供筛选条件的项目。如果未提供筛选条件，则返回所有项目。
• render-pp-cli projects retrieve — 获取具有所提供 ID 的项目。
• render-pp-cli projects update — 更新项目的详细信息。若要更新项目中特定 环境 的详细信息，请改用...

redis — 管理 redis

• render-pp-cli redis create — 创建新的 Redis 实例。此 API 已弃用，请改用 Key Value API。
• render-pp-cli redis delete — 按 ID 删除 Redis 实例。此 API 已弃用，请改用 Key Value API。
• render-pp-cli redis list — 列出符合所提供筛选条件的 Redis 实例。如果未提供筛选条件，则返回所有 Redis 实例...
• render-pp-cli redis retrieve — 按 ID 获取 Redis 实例。此 API 已弃用，请改用 Key Value API。
• render-pp-cli redis update — 按 ID 更新 Redis 实例。此 API 已弃用，请改用 Key Value API。

registrycredentials — 管理 registrycredentials

• render-pp-cli registrycredentials create-registry-credential — 创建新的注册表凭据。
• render-pp-cli registrycredentials delete-registry-credential — 删除具有所提供 ID 的注册表凭据。
• render-pp-cli registrycredentials list-registry-credentials — 列出符合所提供筛选条件的注册表凭据。如果未提供筛选条件，则返回所有注册表...
• render-pp-cli registrycredentials retrieve-registry-credential — 获取具有所提供 ID 的注册表凭据。
• render-pp-cli registrycredentials update-registry-credential — 更新具有所提供 ID 的注册表凭据。使用此凭据的服务必须重新部署才能使用...

services — 服务可让你管理 Web 服务、私有服务、后台工作进程、Cron 作业和静态站点。

• render-pp-cli services create — 在指定的工作区中，根据指定的配置创建新的 Render 服务。
• render-pp-cli services delete — 删除具有所提供 ID 的服务。
• render-pp-cli services list — 列出符合所提供筛选条件的服务。如果未提供筛选条件，则返回你有权限访问的所有服务...
• render-pp-cli services retrieve — 获取具有所提供 ID 的服务。
• render-pp-cli services update — 更新具有所提供 ID 的服务。

task-runs — 管理任务运行

• render-pp-cli task-runs cancel — 取消具有指定 ID 的运行中任务运行。
• render-pp-cli task-runs create-task — 启动具有指定 ID 的工作流任务，并传入指定的输入数据。
• render-pp-cli task-runs get — 获取具有指定 ID 的工作流任务运行。
• render-pp-cli task-runs list — 列出符合指定筛选条件的任务运行。如果未提供筛选条件，则列出所有可访问的任务运行……
• render-pp-cli task-runs stream-events — 建立单向事件流。服务端会按照 SSE 规范将事件作为格式化的行发送。客户端……

tasks — 管理任务

• render-pp-cli tasks get — 获取具有指定 ID 的工作流任务。
• render-pp-cli tasks list — 列出符合指定筛选条件的工作流任务。如果未提供筛选条件，则列出所有可访问的任务定义……

users — User 端点允许你获取经过身份验证的用户信息

• render-pp-cli users — 获取与指定 API 密钥关联的用户。

webhooks — Webhooks 允许你管理 Render 的 webhook 配置。

• render-pp-cli webhooks create — 创建新的 webhook。
• render-pp-cli webhooks delete — 删除具有指定 ID 的 webhook。
• render-pp-cli webhooks list — 列出 webhook
• render-pp-cli webhooks retrieve — 获取具有指定 ID 的 webhook
• render-pp-cli webhooks update — 更新具有指定 ID 的 webhook。

workflows — 管理工作流

• render-pp-cli workflows create — 使用指定配置创建新的工作流服务。
• render-pp-cli workflows delete — 删除具有指定 ID 的工作流服务。
• render-pp-cli workflows get — 获取具有指定 ID 的工作流服务。
• render-pp-cli workflows list — 列出符合指定筛选条件的工作流。如果未提供筛选条件，则列出所有可访问的工作流……
• render-pp-cli workflows update — 更新具有指定 ID 的工作流服务。

workflowversions — 管理工作流版本

• render-pp-cli workflowversions create-workflow-version — 创建并部署新的工作流版本。
• render-pp-cli workflowversions get-workflow-version — 获取具有指定 ID 的特定工作流服务版本。
• render-pp-cli workflowversions list-workflow-versions — 列出具有指定 ID 的工作流服务的已知版本。

找到合适的命令

当你知道要做什么，但不知道该用哪个命令时，可以直接向 CLI 提问：

render-pp-cli which "<capability in your own words>"

which 会根据自然语言功能查询，从此 CLI 精选的功能索引中找出最匹配的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示没有足够可信的匹配项，此时可改用 --help 或使用范围更窄的查询。

操作示例

将预发布环境提升到生产环境，排除调试密钥

render-pp-cli env promote --from srv-staging --to srv-prod --exclude DEBUG_TOKEN,SENTRY_DEV_DSN

先执行差异对比，查看将发生哪些变化，然后筛除仅供开发环境使用的密钥并执行提升。审核后添加 --apply，即可实际写入更改。

轮换密钥前，查找所有使用该密钥的服务

render-pp-cli env where STRIPE_KEY --json --select 'service.name,service.id,updatedAt'

返回所有引用 STRIPE_KEY 的位置对应的服务名称、ID 和时间戳，作为密钥轮换检查清单。

按项目汇总周五的成本

render-pp-cli cost --group-by project --json --select 'project,monthly_usd,resource_count'

将缓存的服务、postgres、kv 和磁盘方案与精选价格表进行关联；导出为 CSV，供财务部门使用。

在 CI 中检测 blueprint 漂移

render-pp-cli drift --blueprint render.yaml --json --quiet || exit 1

当在线工作区与检入的 blueprint 不一致时，以非零状态码退出；将其接入 CI 管道。

查看过去 2 小时内某服务的事件时间线

render-pp-cli incident-timeline srv-checkout-api --since 2h --json --select 'timestamp,kind,actor,summary'

将部署、事件和审计日志合并为一张按时间排序的表格，回答值班告警期间“发生了哪些变化”。

身份验证设置

Render 使用 bearer 令牌身份验证。设置 RENDER_API_KEY（在 https://dashboard.render.com/u/settings#api-keys 生成），或运行 render-pp-cli auth set-token <RENDER_API_KEY> 以交互方式粘贴令牌。每条命令都会发送 Authorization: Bearer <key>；doctor 会验证密钥是否有效。

运行 render-pp-cli doctor 以验证设置。

Agent 模式

为任意命令添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可用于管道 — stdout 输出 JSON，stderr 输出错误

• 可筛选 — --select 保留一部分字段。点分路径可深入嵌套结构；数组会逐个遍历元素。对于内容冗长的 API，这对控制上下文大小至关重要：

  render-pp-cli blueprints list --agent --select id,name,status
  

• 可预览 — --dry-run 显示请求，但不会发送

• 支持离线 — 有本地 SQLite 存储时，同步/搜索命令可以使用该存储

• 非交互式 — 从不提示输入；所有输入都通过标志提供

• 显式重试 — 仅当已存在的创建结果应视为成功时使用 --idempotent；仅当缺失的删除目标应视为成功时使用 --ignore-missing

响应封装

从本地存储或 API 读取数据的命令会将输出包装在来源信息封装中：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析 .results 获取数据，并查看 .meta.source 以了解数据来自实时 API 还是本地存储。只有当 stdout 连接到终端时，才会向 stderr 输出便于阅读的 N results (live) 摘要；通过管道传输或由 Agent 使用时，stdout 只会输出纯 JSON。

Agent 反馈

当你（或 Agent）发现此 CLI 有不妥之处时，请记录下来：

render-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
render-pp-cli feedback --stdin < notes.txt
render-pp-cli feedback list --json --limit 10

条目保存在本地的 ~/.render-pp-cli/feedback.jsonl。除非设置了 RENDER_FEEDBACK_ENDPOINT，且传入了 --send 或设置了 RENDER_FEEDBACK_AUTO_SEND=true，否则绝不会通过 POST 发送。默认行为仅在本地保存。

记录让你感到意外的地方，而不是提交错误报告。简短、具体、单行：这部分会不断积累价值。

输出交付

每条命令都接受 --deliver <sink>。输出除了写入 stdout（或替代 stdout）外，还会发送到指定的目标，这样 Agent 无需手动通过管道传递，就能路由命令结果。支持三种目标：

目标	效果
stdout	默认；仅写入 stdout
file:<path>	以原子方式将输出写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到该 URL（--compact 时使用 application/json 或 application/x-ndjson）

不支持的方案会被拒绝，并返回结构化错误，其中会列出受支持的方案。Webhook 失败时会返回非零退出码，并在 stderr 中记录 URL 和 HTTP 状态码。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。当定时运行的 Agent 每次都以相同配置调用同一命令时，可以使用配置——这就是 HeyGen 的“Beacon”模式。

render-pp-cli profile save briefing --json
render-pp-cli --profile briefing blueprints list
render-pp-cli profile list --json
render-pp-cli profile show briefing
render-pp-cli profile delete briefing --yes

显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，让进行自省的 Agent 能在运行时发现它们。

异步任务

对于提交长时间运行任务的端点，生成器会检测“提交后轮询”模式（响应中包含 job_id/task_id/operation_id 字段，且存在对应的状态端点），并为提交命令添加三个额外标志：

标志	用途
--wait	阻塞至任务达到终止状态，而不是立即返回任务 ID
--wait-timeout	最大等待时长（默认 10m，0 表示无限制）
--wait-interval	初始轮询间隔（默认 2s；采用指数退避逐渐延长，最长为 30s）

如果希望提交后不再等待，请在异步提交时不使用 --wait；如果希望单条命令返回已完成的产物，请使用 --wait。

退出码

代码	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
4	需要身份验证
5	API 错误（上游问题）
7	受到速率限制（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 render-pp-cli --help 的输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的前置条件
3. 其他任何内容 → 直接使用（将其作为 CLI 命令执行，并添加 --agent）

安装 MCP 服务

从此 CLI 发布的公共库条目或预构建版本中安装 MCP 二进制文件，然后进行注册：

claude mcp add render-pp-mcp -- render-pp-mcp

验证：claude mcp list

直接使用

1. 检查是否已安装：which render-pp-cli 如果未找到，提供安装选项（参见本技能开头的前置条件）。
2. 根据用户查询，从上文的独特功能和命令参考中选择最合适的命令。
3. 使用 --agent 标志执行：

   render-pp-cli <command> [subcommand] [args] --agent
   

4. 如果存在歧义，查看子命令帮助：render-pp-cli <command> --help。