@trillboards/cli

中文文档
0.1.12发布于 2026/11/03MITTypeScriptES Module

Trillboards DOOH API的官方CLI

中文使用文档
文档目录52 节
  1. trillboards ads disable
  2. trillboards ads enable
  3. trillboards ads login
  4. trillboards ads start
  5. trillboards api METHOD PATH
  6. trillboards audience live SCREEN_ID
  7. trillboards autocomplete [SHELL]
  8. trillboards billing
  9. trillboards billing usage
  10. trillboards code
  11. trillboards debug SCREEN_ID
  12. trillboards devices reconcile FILE
  13. trillboards doctor
  14. trillboards earnings [MODE]
  15. trillboards endpoints
  16. trillboards errors [CODE]
  17. trillboards fill-rate
  18. trillboards generated generated-approved-metric-get METRIC
  19. trillboards generated generated-approved-metrics-list
  20. trillboards generated generated-changelog-query
  21. trillboards generated generated-configure-creative-feedback…
  22. trillboards generated generated-creative-feedback-experimen…
  23. trillboards generated generated-creative-feedback-experimen…
  24. trillboards generated generated-creative-feedback-policy-up…
  25. trillboards generated generated-creative-feedback-rewards-g…
  26. trillboards generated generated-creative-feedback-variants-…
  27. trillboards generated generated-csi-venue-history SCREENID
  28. trillboards generated generated-csi-venue-occupancy SCREENID
  29. trillboards generated generated-curation-set-coverage-get S…
  30. trillboards generated generated-curation-set-roads-get SETK…
  31. trillboards generated generated-curation-set-viewsheds-get …
  32. trillboards generated generated-curation-sets-list
  33. trillboards generated generated-data-api-ad-sightings
  34. trillboards generated generated-data-api-ad-sightings-histo…
  35. trillboards generated generated-data-api-aggregate
  36. trillboards generated generated-data-api-list-screens
  37. trillboards generated generated-data-api-lookalike-screens
  38. trillboards generated generated-data-api-query-dsl
  39. trillboards generated generated-data-api-screen-audience-hi…
  40. trillboards generated generated-data-api-screen-audience-li…
  41. trillboards generated generated-data-api-semantic-search
  42. trillboards generated generated-data-api-stats
  43. trillboards generated generated-data-api-stream
  44. trillboards generated generated-data-api-usage
  45. trillboards generated generated-device-ota-manifest
  46. trillboards generated generated-device-retained-cctv-review
  47. trillboards generated generated-device-sensing-profile
  48. trillboards generated generated-error-code-get CODE
  49. trillboards generated generated-error-codes-list
  50. trillboards generated generated-example-healthcheck
  51. trillboards generated generated-federated-get-latest-model-…
  52. trillboards generated generated-federated-get-model-weights…

trillboards-cli

使用oclif生成的新CLI

oclif Version Downloads/week

使用

$ npm install -g @trillboards/cli
$ trillboards COMMAND
running command...
$ trillboards (--version)
@trillboards/cli/0.1.12 linux-x64 node-v22.23.4
$ trillboards --help [COMMAND]
USAGE
  $ trillboards COMMAND
...

命令

trillboards ads disable

关闭本地赞助行(移除Claude Code死时间钩子)。

USAGE
  $ trillboards ads disable [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Turn off the in-place sponsored lines (removes the Claude Code dead-time hook).

EXAMPLES
  $ trillboards ads disable

trillboards ads enable

在Claude Code中打开本地赞助行(安装死时间钩子)。选择;撤销与 ads disable.

USAGE
  $ trillboards ads enable [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Turn on in-place sponsored lines in Claude Code (installs the dead-time hook). Opt-in; undo with `ads disable`.

EXAMPLES
  $ trillboards ads enable

trillboards ads login

用你的Trillboards账号(邮箱+密码)登录代理广告程序

USAGE
  $ trillboards ads login [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--email <value>]
    [--password <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --email=<value>     Account email (prompts if omitted)
  --format=<option>   Output format
                      <options: json|table|yaml>
  --password=<value>  Account password (prompts hidden if omitted; avoid passing on the command line)

DESCRIPTION
  Log in to the agent-ads program with your Trillboards account (email + password)

EXAMPLES
  $ trillboards ads login

  $ trillboards ads login --email [email protected]

  TRILLBOARDS_USER_TOKEN=<jwt> trillboards ads login

trillboards ads start

将这台机器注册为虚拟屏幕,并租用其人工智能编码代理的死亡时间来赚钱

USAGE
  $ trillboards ads start [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--name <value>]
    [--once] [--simulate] [--interval <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --interval=<value>  Seconds between dead-time fills in --simulate mode (default 60)
  --name=<value>      Display name for this virtual screen (defaults to "Claude Code on <hostname>")
  --once              Register, heartbeat once, serve a single ad, then exit (great for testing)
  --simulate          Treat each interval tick as a dead-time trigger (v0 stand-in for real detection)

DESCRIPTION
  Register this machine as a virtual screen and rent its AI-coding-agent dead-time for money

EXAMPLES
  $ trillboards ads start

  $ trillboards ads start --once

  $ trillboards ads start --simulate --interval 30

trillboards api METHOD PATH

生成原始API请求(如gh API)

USAGE
  $ trillboards api METHOD PATH [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [-d
    <value>] [--jq <value>]

ARGUMENTS
  METHOD  HTTP method (GET, POST, PUT, PATCH, DELETE)
  PATH    API path (e.g. /v1/partner/screens)

FLAGS
  -d, --data=<value>      Request body (JSON string)
      --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
      --base-url=<value>  [default: https://api.trillboards.com] API base URL
      --format=<option>   Output format
                          <options: json|table|yaml>
      --jq=<value>        JSON path expression to extract (e.g. "data.items" or "name")

DESCRIPTION
  Make raw API requests (like gh api)

EXAMPLES
  $ trillboards api GET /v1/partner/screens

  $ trillboards api POST /v1/partner/device --data '{"name":"test"}'

  $ trillboards api GET /v1/partner/info --jq partner_name

trillboards audience live SCREEN_ID

实时观众感应数据的屏幕

USAGE
  $ trillboards audience live SCREEN_ID [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--interval <value>]

ARGUMENTS
  SCREEN_ID  Screen ID to monitor

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --interval=<value>  [default: 5] Polling interval in seconds

DESCRIPTION
  Real-time audience sensing data for a screen

EXAMPLES
  $ trillboards audience live scr_abc123

  $ trillboards audience live scr_abc123 --format json

  $ trillboards audience live scr_abc123 --interval 3

trillboards autocomplete [SHELL]

显示自动完成安装说明。

USAGE
  $ trillboards autocomplete [SHELL] [-r]

ARGUMENTS
  [SHELL]  (zsh|bash|powershell) Shell type

FLAGS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

DESCRIPTION
  Display autocomplete installation instructions.

EXAMPLES
  $ trillboards autocomplete

  $ trillboards autocomplete bash

  $ trillboards autocomplete zsh

  $ trillboards autocomplete powershell

  $ trillboards autocomplete --refresh-cache

看代码: @oclif / plugin-autocomplete

trillboards billing

账单摘要-当前计划和使用情况

USAGE
  $ trillboards billing [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Billing summary — current plan and usage

EXAMPLES
  $ trillboards billing

  $ trillboards billing --format json

trillboards billing usage

账单使用详细信息以及可选的每个产品细分

USAGE
  $ trillboards billing usage [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--breakdown]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --breakdown         Show per-product breakdown table
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Billing usage details with optional per-product breakdown

EXAMPLES
  $ trillboards billing usage

  $ trillboards billing usage --breakdown

  $ trillboards billing usage --format json

trillboards code

包装你的编码代理并从它的空闲时间(在它思考的时候播放文本/图像/视频广告)中获利。

USAGE
  $ trillboards code [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Wrap your coding agent and earn from its dead-time (plays text/image/video ads while it thinks)

EXAMPLES
  $ trillboards code

  $ trillboards code claude

  $ trillboards code -- codex --foo

trillboards debug SCREEN_ID

诊断屏幕-状态,性能,观众,问题

USAGE
  $ trillboards debug SCREEN_ID [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

ARGUMENTS
  SCREEN_ID  Screen ID to diagnose

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Diagnose a screen — status, performance, audience, issues

EXAMPLES
  $ trillboards debug scr_abc123

  $ trillboards debug scr_abc123 --format json

trillboards devices reconcile FILE

调和您的设备舰队-将您的外部id与Trillboards已注册的id(匹配/缺失/孤儿/畸形/重复)进行区分

USAGE
  $ trillboards devices reconcile FILE [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

ARGUMENTS
  FILE  Path to your device external IDs — a JSON array, {"external_ids":[...]}, or one ID per line

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Reconcile your device fleet — diff your external IDs against what Trillboards has registered (matched / missing /
  orphan / malformed / duplicate)

EXAMPLES
  $ trillboards devices reconcile my-devices.json

  $ trillboards devices reconcile ids.txt --format json

trillboards doctor

运行系统诊断并检查API连接

USAGE
  $ trillboards doctor [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Run system diagnostics and check API connectivity

EXAMPLES
  $ trillboards doctor

trillboards earnings [MODE]

收入仪表板-今天的总结,历史图表,或直播

USAGE
  $ trillboards earnings [MODE] [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--period
    <value>]

ARGUMENTS
  [MODE]  (live) Mode: "live" for real-time streaming

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --period=<value>    [default: 1d] Time period (e.g. 1d, 7d, 30d)

DESCRIPTION
  Revenue dashboard — today's summary, historical charts, or live streaming

EXAMPLES
  $ trillboards earnings

  $ trillboards earnings --period 30d

  $ trillboards earnings live

  $ trillboards earnings --format json

trillboards endpoints

发现可用的API端点

USAGE
  $ trillboards endpoints [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [-s <value>]

FLAGS
  -s, --search=<value>    Search query to filter endpoints
      --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
      --base-url=<value>  [default: https://api.trillboards.com] API base URL
      --format=<option>   Output format
                          <options: json|table|yaml>

DESCRIPTION
  Discover available API endpoints

EXAMPLES
  $ trillboards endpoints

  $ trillboards endpoints --search screens

  $ trillboards endpoints --format json

trillboards errors [CODE]

从错误目录中查找错误代码

USAGE
  $ trillboards errors [CODE] [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

ARGUMENTS
  [CODE]  Error code to look up (e.g. screen_not_found)

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Look up error codes from the error catalog

EXAMPLES
  $ trillboards errors

  $ trillboards errors screen_not_found

  $ trillboards errors --format json

trillboards fill-rate

填充率分析-整体,每屏幕,或按时间

USAGE
  $ trillboards fill-rate [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--by
    partner|screen|hour]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --by=<option>       Breakdown dimension
                      <options: partner|screen|hour>
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Fill rate analysis — overall, per-screen, or by time

EXAMPLES
  $ trillboards fill-rate

  $ trillboards fill-rate --by screen

  $ trillboards fill-rate --by hour

  $ trillboards fill-rate --format json

trillboards generated generated-approved-metric-get METRIC

一个被认可的公制只适用于一天或一段时间。

USAGE
  $ trillboards generated generated-approved-metric-get METRIC [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--agencies <value>] [--board_id <value>] [--boards <value>] [--brands <value>] [--by <value>] [--categories
    <value>] [--cbsas <value>] [--day <value>] [--daypart <value>] [--dimensions <value>] [--formats <value>] [--grade
    <value>] [--grain <value>] [--markets <value>] [--media_owners <value>] [--parents <value>] [--population <value>]
    [--screens <value>] [--stats <value>] [--surfaces <value>] [--window <value>] [--window_end <value>]

ARGUMENTS
  METRIC  An approved metric name.

FLAGS
  --agencies=<value>
      Agency names, |-separated (or repeated): the brands one of them holds as agency of record (Winmo), any case. Taken
      by: creative_brand_history.

  --api-key=<value>
      [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)

  --base-url=<value>
      [default: https://api.trillboards.com] API base URL

  --board_id=<value>
      Board face id (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.

  --boards=<value>
      Face keys, |-separated (or repeated): f:<board id>:<face index> or p:<point id>. Taken by: creative_brand_history.

  --brands=<value>
      Comma-separated resolved brand ids. Taken by: creative_brand_history.

  --by=<value>
      Condition scope (board metrics): daypart, light, weather or speed. Taken by: board_measured_impressions_per_spot.

  --categories=<value>
      Comma-separated IAB tier-1 codes (IAB1..IAB25): the brands of those categories. A slice filter narrows the
      denominators with the rows. Taken by: creative_brand_history.

  --cbsas=<value>
      Comma-separated 5-digit Census CBSA codes (OMB July 2023 delineation). Taken by: creative_brand_history.

  --day=<value>
      One day (YYYY-MM-DD). Give day or window; neither is the last settled day. Taken by: camera_people_per_screen_hour,
      camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, sensing_census,
      same_panel_index, radio_identifiers_per_person, creative_sightings, creative_share_of_voice,
      creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance,
      seatbelt_unbuckled_ride_rate.

  --daypart=<value>
      Daypart filter (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.

  --dimensions=<value>
      Comma-separated dimensions (dimension= is the one-value spelling): the audience dimensions of a demographics metric
      (default all), or the slices creative_brand_history cuts its rows by (category, parent, agency, media_owner, format,
      surface, board, cbsa; default none), every share over its slice. Taken by: demographic_share,
      creative_brand_history.

  --format=<option>
      Output format
      <options: json|table|yaml>

  --formats=<value>
      Comma-separated face formats: static, digital. Taken by: creative_brand_history.

  --grade=<value>
      Camera evidence grade: face_backed or person_backed. Taken by: camera_people_per_screen_hour,
      camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct.

  --grain=<value>
      The answer grain (screen_hour, screen_day, fleet_day, market_day, market_month, ...): one of the metric's grains.
      Taken by: camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct,
      demographic_share, sensing_census, same_panel_index, radio_identifiers_per_person, creative_sightings,
      creative_share_of_voice, creative_street_presence, creative_vacancy_rate, creative_brand_history,
      seatbelt_compliance, seatbelt_unbuckled_ride_rate.

  --markets=<value>
      Comma-separated markets as COUNTRY:CODE (US DMA, CA CMA). Taken by: creative_sightings, creative_share_of_voice,
      creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance,
      seatbelt_unbuckled_ride_rate.

  --media_owners=<value>
      Media owner names, |-separated (or repeated): the faces whose registry owner holds a name's letters and digits, any
      case and punctuation. Taken by: creative_brand_history.

  --parents=<value>
      Comma-separated brand graph ids: the brands whose parent company is in one of those Wikidata families. Taken by:
      creative_brand_history.

  --population=<value>
      The population the shares are over. Taken by: sensing_census, same_panel_index.

  --screens=<value>
      Comma-separated 24-hex screen ids, up to the metric's max_screens. Taken by: camera_people_per_screen_hour,
      camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share, seatbelt_compliance,
      seatbelt_unbuckled_ride_rate.

  --stats=<value>
      Comma-separated statistics (mean, p50, ...), from the metric's allowed stats. Taken by:
      camera_people_per_screen_hour, camera_head_pose_index.

  --surfaces=<value>
      Comma-separated reader surfaces: billboard, digital_board, bus_shelter, kiosk. Taken by: creative_brand_history.

  --window=<value>
      An inclusive span, YYYY-MM-DD..YYYY-MM-DD, up to the metric's max_window_days. Taken by:
      camera_people_per_screen_hour, camera_dwell_capped_ms, camera_head_pose_index, camera_gaze_pct, demographic_share,
      same_panel_index, radio_identifiers_per_person, creative_sightings, creative_share_of_voice,
      creative_street_presence, creative_vacancy_rate, creative_brand_history, seatbelt_compliance,
      seatbelt_unbuckled_ride_rate.

  --window_end=<value>
      Currency window end (board metrics). Taken by: board_measured_impressions_per_spot, board_pass_audience.

DESCRIPTION
  One approved metric answered for a day or window, at its grain.

EXAMPLES
  $ trillboards generated approved-metric get

trillboards generated generated-approved-metrics-list

被认可的指标是:你可以买到的每一个受控制的观众、摄像机、创意、安全带、董事会和座谈回答。

USAGE
  $ trillboards generated generated-approved-metrics-list [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  The approved metrics: every governed audience, camera, creative, seatbelt, board and panel answer you can buy.

EXAMPLES
  $ trillboards generated approved-metrics list

trillboards generated generated-changelog-query

查询API变更日志

USAGE
  $ trillboards generated generated-changelog-query [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--since <value>]
    [--type <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --since=<value>     Only entries dated on or after this date (YYYY-MM-DD). Unreleased entries always included.
  --type=<value>      Filter by change category: "breaking" (changed+removed), "additive" (added), "deprecation"
                      (deprecated), "fix" (fixed). Comma-separated for multiple.

DESCRIPTION
  Query API changelog

EXAMPLES
  $ trillboards generated changelog query

trillboards generated generated-configure-creative-feedback-brand EXPERIMENT_ID

配置您的本地品牌配置文件,并启用其预订的响应式活动

USAGE
  $ trillboards generated generated-configure-creative-feedback-brand EXPERIMENT_ID [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--data <value>]

ARGUMENTS
  EXPERIMENT_ID  Native experiment ID returned by create_creative_experiment.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --data=<value>      JSON request body
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Configure your native brand profile and enable its booked reactive campaign

EXAMPLES
  $ trillboards generated configure-creative-feedback-brand

trillboards generated generated-creative-feedback-experiment-create

在原生媒体购买广告投放上进行实验

USAGE
  $ trillboards generated generated-creative-feedback-experiment-create [--api-key <value>] [--base-url <value>]
  [--format json|table|yaml] [--data <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --data=<value>      JSON request body
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Create an experiment on a funded native media-buy placement

EXAMPLES
  $ trillboards generated creative-feedback-experiment create

trillboards generated generated-creative-feedback-experiment-get EXPERIMENT_ID

阅读本地实验,政策和最新的500个拥有的创意恢复记录

USAGE
  $ trillboards generated generated-creative-feedback-experiment-get EXPERIMENT_ID [--api-key <value>] [--base-url
  <value>] [--format json|table|yaml]

ARGUMENTS
  EXPERIMENT_ID  Native experiment ID returned by create_creative_experiment.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Read your native experiment, policy and latest 500 owned creative recovery records

EXAMPLES
  $ trillboards generated creative-feedback-experiment get

trillboards generated generated-creative-feedback-policy-update EXPERIMENT_ID

在预期的策略版本中替换原生创意权重

USAGE
  $ trillboards generated generated-creative-feedback-policy-update EXPERIMENT_ID [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--data <value>]

ARGUMENTS
  EXPERIMENT_ID  Native experiment ID returned by create_creative_experiment.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --data=<value>      JSON request body
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Replace native creative weights at the expected policy version

EXAMPLES
  $ trillboards generated creative-feedback-policy update

trillboards generated generated-creative-feedback-rewards-get EXPERIMENT_ID

阅读最新测量的本地游戏状态的计量页面

USAGE
  $ trillboards generated generated-creative-feedback-rewards-get EXPERIMENT_ID [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--from <value>] [--to <value>] [--limit <value>] [--cursor <value>] [--idempotency_key <value>]

ARGUMENTS
  EXPERIMENT_ID  Native experiment ID returned by create_creative_experiment.

FLAGS
  --api-key=<value>          [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>         [default: https://api.trillboards.com] API base URL
  --cursor=<value>           Opaque next_cursor from this same date scope; rewind after scan_complete.
  --format=<option>          Output format
                             <options: json|table|yaml>
  --from=<value>             Inclusive first play date, YYYY-MM-DD; date range is at most 31 days.
  --idempotency_key=<value>  Unique caller-owned billing key for this page; committed retries return the receipt, not
                             another read.
  --limit=<value>            Maximum native play states returned on this metered page.
  --to=<value>               Inclusive last play date, YYYY-MM-DD; date range is at most 31 days.

DESCRIPTION
  Read a metered page of latest measured native play states

EXAMPLES
  $ trillboards generated creative-feedback-rewards get

trillboards generated generated-creative-feedback-variants-register EXPERIMENT_ID

注册批准的本地生成的创造性变体

USAGE
  $ trillboards generated generated-creative-feedback-variants-register EXPERIMENT_ID [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--data <value>]

ARGUMENTS
  EXPERIMENT_ID  Native experiment ID returned by create_creative_experiment.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --data=<value>      JSON request body
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Register approved native generated creative variants

EXAMPLES
  $ trillboards generated creative-feedback-variants register

trillboards generated generated-csi-venue-history SCREENID

以10分钟为单位的历史场馆占用率。

USAGE
  $ trillboards generated generated-csi-venue-history SCREENID [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--hours
    <value>]

ARGUMENTS
  SCREENID  Mongo ObjectId of the screen / venue sensing node (24-char lowercase hex).

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --hours=<value>     Look-back window in hours. Absent or non-positive values fall back to 24; values above 168 are
                      capped to 168 (7 days).

DESCRIPTION
  Historical venue occupancy in 10-minute CSI buckets.

EXAMPLES
  $ trillboards generated csi-venue-history

trillboards generated generated-csi-venue-occupancy SCREENID

实时场地占用从WiFi CSI传感。

USAGE
  $ trillboards generated generated-csi-venue-occupancy SCREENID [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml]

ARGUMENTS
  SCREENID  Mongo ObjectId of the screen / venue sensing node (24-char lowercase hex).

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Real-time venue occupancy from WiFi CSI sensing.

EXAMPLES
  $ trillboards generated csi-venue-occupancy

trillboards generated generated-curation-set-coverage-get SETKEY

一个策划集的测量覆盖率。

USAGE
  $ trillboards generated generated-curation-set-coverage-get SETKEY [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml]

ARGUMENTS
  SETKEY  A curated set key, as listed by /curation-sets.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  The measured coverage of one curated set.

EXAMPLES
  $ trillboards generated curation-set-coverage get

trillboards generated generated-curation-set-roads-get SETKEY

为特定人群服务的道路,有交通指数和速度。

USAGE
  $ trillboards generated generated-curation-set-roads-get SETKEY [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--bbox
    <value>] [--dow_type <value>] [--hour <value>] [--metric <value>] [--road_class <value>]

ARGUMENTS
  SETKEY  A curated set key, as listed by /curation-sets.

FLAGS
  --api-key=<value>     [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>    [default: https://api.trillboards.com] API base URL
  --bbox=<value>        minLon,minLat,maxLon,maxLat (RFC 7946 order). The span is capped (`max_bbox_deg` on
                        /curation-sets); a wider box answers 413 bbox_too_large.
  --dow_type=<value>    Day-of-week type (default weekday).
  --format=<option>     Output format
                        <options: json|table|yaml>
  --hour=<value>        Local hour 0-23. Absent: every hour.
  --metric=<value>      traversal_index (default), speed or speed_ratio.
  --road_class=<value>  Comma-separated OSM classes: motorway, motorway_link, trunk, trunk_link, primary, primary_link,
                        secondary, secondary_link, tertiary, tertiary_link, unclassified, residential, living_street,
                        service.

DESCRIPTION
  The roads that serve a curated set, with the traffic index and speeds.

EXAMPLES
  $ trillboards generated curation-set-roads get

trillboards generated generated-curation-set-viewsheds-get SETKEY

一个策展集合中每个成员的视角和面点。

USAGE
  $ trillboards generated generated-curation-set-viewsheds-get SETKEY [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--bbox
    <value>]

ARGUMENTS
  SETKEY  A curated set key, as listed by /curation-sets.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --bbox=<value>      minLon,minLat,maxLon,maxLat (RFC 7946 order). The span is capped (`max_bbox_deg` on
                      /curation-sets); a wider box answers 413 bbox_too_large.
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  The viewsheds and face points of every member of a curated set.

EXAMPLES
  $ trillboards generated curation-set-viewsheds get

trillboards generated generated-curation-sets-list

策划板组(批准包)及其测量的覆盖范围。

USAGE
  $ trillboards generated generated-curation-sets-list [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--q <value>]
    [--limit <value>] [--offset <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --limit=<value>     Page size (default 200).
  --offset=<value>    Page offset.
  --q=<value>         Search the set names.

DESCRIPTION
  The curated board sets (approved packages) with their measured coverage.

EXAMPLES
  $ trillboards generated curation-sets list

trillboards generated generated-data-api-ad-sightings

广告目击记录:出租车摄像头看到的户外广告,每个广告都有签名照片链接。

USAGE
  $ trillboards generated generated-data-api-ad-sightings [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--brand
    <value>...] [--brand_id <value>...] [--market <value>...] [--surface <value>...] [--board_id <value>...]
    [--creative_id <value>...] [--instrument <value>...] [--category <value>...] [--media_owner <value>...] [--has_photo
    <value>] [--from <value>] [--to <value>] [--limit <value>] [--cursor <value>]

FLAGS
  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>        [default: https://api.trillboards.com] API base URL
  --board_id=<value>...     A board the sighting was matched to, repeatable.
  --brand=<value>...        A brand, repeatable for a brand set (competitors). Matched however it is typed:
                            "McDonald's", "mcdonalds" and "Mc Donalds" find the same records.
  --brand_id=<value>...     A resolved brand id, repeatable. Combined with `brand` as either-or.
  --category=<value>...     The brand's IAB tier-1 category (IAB1..IAB25), repeatable: the records whose resolved brand
                            votes in it (brand_knowledge_graph.iab_category, the `category` field).
  --creative_id=<value>...  A sighted creative (the campaign artwork), repeatable.
  --cursor=<value>          The `next_cursor` of the previous page.
  --format=<option>         Output format
                            <options: json|table|yaml>
  --from=<value>            Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`.
  --has_photo=<value>       true returns only records that carry a photo (photo_url set): a record without a shareable
                            face-blurred picture is skipped, so it is never returned or billed. The page can hold fewer
                            than limit records; keep following next_cursor until it is null.
  --instrument=<value>...   The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.
  --limit=<value>           Records per page, 1..500 (default 50). The page limit is reserved; the records returned are
                            billed.
  --market=<value>...       A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.
  --media_owner=<value>...  A media owner, repeatable: the records matched to a face whose owner (`publisher_name`, the
                            registry's) holds the name's letters and digits, any case and punctuation (Lamar finds
                            LAMAR-PITTSBURGH and Lamar (Cincinnati)).
  --surface=<value>...      The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.
  --to=<value>              End (exclusive). Default: now. The span is at most 400 days.

DESCRIPTION
  Ad-sighting records: outdoor ads our cab cameras read, each with a signed photo link.

EXAMPLES
  $ trillboards generated data-api-ad-sightings

trillboards generated generated-data-api-ad-sightings-history

户外创意历史按品牌、市场和月份,从创意分类账。

USAGE
  $ trillboards generated generated-data-api-ad-sightings-history [--api-key <value>] [--base-url <value>] [--format <value>...] [--brand <value>...]
    [--brand_id <value>...] [--market <value>...] [--from <value>] [--to <value>] [--grain <value>] [--dimension
    <value>...] [--category <value>...] [--parent <value>...] [--agency <value>...] [--media_owner <value>...]
    [--surface <value>...] [--board <value>...] [--cbsa <value>...] [--limit <value>] [--cursor <value>]

FLAGS
  --agency=<value>...       Narrow to brands this agency holds as agency of record (Winmo), by name in any case,
                            repeatable.
  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>        [default: https://api.trillboards.com] API base URL
  --board=<value>...        Narrow to faces by face key, repeatable for a set of boards: f:<board id>:<face index> (a
                            registered face) or p:<point id> (an unregistered board point), the `face_key` a board slice
                            answers with.
  --brand=<value>...        A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search
                            does.
  --brand_id=<value>...     A resolved brand id, repeatable.
  --category=<value>...     Narrow to brands of an IAB tier-1 category (IAB1..IAB25), repeatable. A slice filter narrows
                            the denominators with the rows: the shares are within the categories named.
  --cbsa=<value>...         Narrow to faces in a Census CBSA (5-digit code, OMB July 2023 delineation), repeatable.
  --cursor=<value>          The `next_cursor` of the previous page.
  --dimension=<value>...    A slice the rows are cut by, repeatable: category, parent, agency (what the brand is),
                            media_owner, format, surface, board, cbsa (where it ran). Each row is a brand within its
                            slice, and every share is over its slice: a slice recomputes every denominator, and every
                            distinct count is counted within it. The market vacancy is cut by where-it-ran slices only.
  --format=<value>...       Narrow to static or digital faces, repeatable.
  --from=<value>            First month (YYYY-MM) or day. Default: 12 months before `to`.
  --grain=<value>           market_month (default) or fleet_month; market_week or fleet_week (ISO weeks from their
                            Monday, each counted whole, every week the from..to span touches); market_window or
                            fleet_window (the from..to span as one period). A fleet grain drops the market: with
                            dimension=cbsa it is the CBSA geography.
  --limit=<value>           Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are
                            billed.
  --market=<value>...       A market as COUNTRY:CODE, repeatable.
  --media_owner=<value>...  Narrow to faces whose registry owner holds the name's letters and digits, any case and
                            punctuation (Lamar finds LAMAR-PITTSBURGH and Lamar (Cincinnati)), repeatable.
  --parent=<value>...       Narrow to brands whose parent company is in this brand graph id's family (the `parent_id` a
                            parent slice answers with), repeatable.
  --surface=<value>...      Narrow to faces of a reader surface (billboard, digital_board, bus_shelter, kiosk),
                            repeatable.
  --to=<value>              Last month (YYYY-MM, inclusive) or day. Default: this month.

DESCRIPTION
  Outdoor creative history by brand, market and month, from the creative ledger.

EXAMPLES
  $ trillboards generated data-api-ad-sightings-history

trillboards generated generated-data-api-aggregate

为时间窗口聚合受众分析。

USAGE
  $ trillboards generated generated-data-api-aggregate [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--group_by
    <value>] [--metric <value>] [--since <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --group_by=<value>  Dimension to group aggregations by.
  --metric=<value>    Metric to aggregate on.
  --since=<value>     Relative time window (e.g. "24h", "7d").

DESCRIPTION
  Aggregate audience analytics for a time window.

EXAMPLES
  $ trillboards generated data-api-aggregate

trillboards generated generated-data-api-list-screens

列出对调用者可见的屏幕。

USAGE
  $ trillboards generated generated-data-api-list-screens [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--limit <value>]
    [--offset <value>] [--venue_type <value>] [--country <value>]

FLAGS
  --api-key=<value>     [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>    [default: https://api.trillboards.com] API base URL
  --country=<value>     ISO-3166 alpha-2 country code.
  --format=<option>     Output format
                        <options: json|table|yaml>
  --limit=<value>       limit
  --offset=<value>      offset
  --venue_type=<value>  Filter by venue taxonomy type (e.g. bar, restaurant).

DESCRIPTION
  List screens visible to the caller.

EXAMPLES
  $ trillboards generated data-api-list-screens

trillboards generated generated-data-api-lookalike-screens

寻找具有相似用户概况的屏幕。

USAGE
  $ trillboards generated generated-data-api-lookalike-screens [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--screen_id
    <value>] [--limit <value>] [--min_similarity <value>]

FLAGS
  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>        [default: https://api.trillboards.com] API base URL
  --format=<option>         Output format
                            <options: json|table|yaml>
  --limit=<value>           limit
  --min_similarity=<value>  min_similarity
  --screen_id=<value>       Internal screen identifier.

DESCRIPTION
  Find screens with similar audience profiles.

EXAMPLES
  $ trillboards generated data-api-lookalike-screens

trillboards generated generated-data-api-query-dsl

经过批准的数据集上的可组合查询DSL。

USAGE
  $ trillboards generated generated-data-api-query-dsl [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml] [--data <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --data=<value>      JSON request body
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Composable query DSL over approved datasets.

EXAMPLES
  $ trillboards generated data-api-query-dsl

trillboards generated generated-data-api-screen-audience-history SCREENID

屏幕的历史audience_metrics行。

USAGE
  $ trillboards generated generated-data-api-screen-audience-history SCREENID [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--since
    <value>] [--until <value>] [--limit <value>]

ARGUMENTS
  SCREENID  Internal screen identifier.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --limit=<value>     limit
  --since=<value>     ISO-8601 start timestamp.
  --until=<value>     ISO-8601 end timestamp.

DESCRIPTION
  Historical audience_metrics rows for a screen.

EXAMPLES
  $ trillboards generated data-api-screen-audience-history

trillboards generated generated-data-api-screen-audience-live SCREENID

屏幕上的实时观众快照。

USAGE
  $ trillboards generated generated-data-api-screen-audience-live SCREENID [--api-key <value>] [--base-url <value>]
  [--format json|table|yaml]

ARGUMENTS
  SCREENID  Internal screen identifier.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Real-time audience snapshot for a screen.

EXAMPLES
  $ trillboards generated data-api-screen-audience-live

场景嵌入的相似度搜索。

USAGE
  $ trillboards generated generated-data-api-semantic-search [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--q <value>]
    [--limit <value>] [--since <value>] [--min_similarity <value>]

FLAGS
  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>        [default: https://api.trillboards.com] API base URL
  --format=<option>         Output format
                            <options: json|table|yaml>
  --limit=<value>           limit
  --min_similarity=<value>  min_similarity
  --q=<value>               q
  --since=<value>           Relative time window (e.g. "24h", "7d").

DESCRIPTION
  Similarity search over scene embeddings.

EXAMPLES
  $ trillboards generated data-api-semantic-search

trillboards generated generated-data-api-stats

Platform-wide计数器。

USAGE
  $ trillboards generated generated-data-api-stats [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Platform-wide counters.

EXAMPLES
  $ trillboards generated data-api-stats

trillboards generated generated-data-api-stream

现场观众/观察事件的服务器发送事件流。

USAGE
  $ trillboards generated generated-data-api-stream [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--observation_family <value>] [--venue_type <value>]

FLAGS
  --api-key=<value>             [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>            [default: https://api.trillboards.com] API base URL
  --format=<option>             Output format
                                <options: json|table|yaml>
  --observation_family=<value>  observation_family
  --venue_type=<value>          venue_type

DESCRIPTION
  Server-Sent Events stream of live audience/observation events.

EXAMPLES
  $ trillboards generated data-api-stream

trillboards generated generated-data-api-usage

已验证密钥(计费指示板)的API使用情况。

USAGE
  $ trillboards generated generated-data-api-usage [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
  [--days <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --days=<value>      days
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  API usage for the authenticated key (billing dashboard).

EXAMPLES
  $ trillboards generated data-api-usage

trillboards generated generated-device-ota-manifest

托管设备更新客户端的已签名OTA清单。

USAGE
  $ trillboards generated generated-device-ota-manifest [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml] [--agent <value>]

FLAGS
  --agent=<value>     Optional agent type filter (`agent-core`, `agent-core-lite`, etc.). When omitted the caller
                      receives the default manifest bundle.
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Signed OTA manifest for managed-device update clients.

EXAMPLES
  $ trillboards generated device-ota-manifest

trillboards generated generated-device-retained-cctv-review

保存原始闭路电视证据及其完成的本地审查。

USAGE
  $ trillboards generated generated-device-retained-cctv-review [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml] [--data <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --data=<value>      JSON request body
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Store original CCTV evidence and its completed local review.

EXAMPLES
  $ trillboards generated device-retained-cctv-review

trillboards generated generated-device-sensing-profile

用于调用连接器绑定屏幕的主动传感配置文件。

USAGE
  $ trillboards generated generated-device-sensing-profile [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Active sensing profile for the calling connector's bound screen.

EXAMPLES
  $ trillboards generated device-sensing-profile

trillboards generated generated-error-code-get CODE

查找单个错误代码

USAGE
  $ trillboards generated generated-error-code-get CODE [--api-key <value>] [--base-url <value>] [--format
  json|table|yaml]

ARGUMENTS
  CODE  A stable error code from the catalog. See GET /v1/errors for the full list.

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  Look up a single error code

EXAMPLES
  $ trillboards generated error-code get

trillboards generated generated-error-codes-list

列出所有错误代码

USAGE
  $ trillboards generated generated-error-codes-list [--api-key <value>] [--base-url <value>] [--format json|table|yaml]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>

DESCRIPTION
  List all error codes

EXAMPLES
  $ trillboards generated error-codes list

trillboards generated generated-example-healthcheck

示例健康检查(阶段3管道验证)

USAGE
  $ trillboards generated generated-example-healthcheck [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--verbose
    <value>]

FLAGS
  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>  [default: https://api.trillboards.com] API base URL
  --format=<option>   Output format
                      <options: json|table|yaml>
  --verbose=<value>   When `true`, include diagnostic fields in the response.

DESCRIPTION
  Example healthcheck (Phase 3 pipeline proof)

EXAMPLES
  $ trillboards generated example-healthcheck

trillboards generated generated-federated-get-latest-model-descriptor MODELTYPE

获取最新的聚合模型描述符(下载URL + sha256 +版本)。

USAGE
  $ trillboards generated generated-federated-get-latest-model-descriptor MODELTYPE [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--venue_type <value>] [--venue_subtype <value>] [--daypart <value>] [--geo <value>] [--device_profile <value>]

ARGUMENTS
  MODELTYPE  Federated model name.

FLAGS
  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>        [default: https://api.trillboards.com] API base URL
  --daypart=<value>         daypart
  --device_profile=<value>  device_profile
  --format=<option>         Output format
                            <options: json|table|yaml>
  --geo=<value>             geo
  --venue_subtype=<value>   venue_subtype
  --venue_type=<value>      Venue category (required).

DESCRIPTION
  Fetch the latest aggregated model descriptor (download URL + sha256 + version).

EXAMPLES
  $ trillboards generated federated-get-latest-model-descriptor

trillboards generated generated-federated-get-model-weights MODELTYPE

获取特定于设备的片的聚合权重。

USAGE
  $ trillboards generated generated-federated-get-model-weights MODELTYPE [--api-key <value>] [--base-url <value>] [--format json|table|yaml]
    [--venue_type <value>] [--venue_subtype <value>] [--daypart <value>] [--geo <value>] [--device_profile <value>]

ARGUMENTS
  MODELTYPE  Federated model name.

FLAGS
  --api-key=<value>         [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
  --base-url=<value>        [default: https://api.trillboards.com] API base URL
  --daypart=<value>         daypart
  --device_profile=<value>  device_profile
  --format=<opti

版本与发布记录

@trillboards/cli 共发布 12 个版本,首次发布于 2026/04/17;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.1.12latest2026/11/03今天
0.1.112026/11/012 天前
0.1.102026/11/012 天前
0.1.92026/11/012 天前
0.1.82026/10/312 天前
0.1.72026/10/304 天前

关于 @trillboards/cli 的常见问题

@trillboards/cli 是什么?

Trillboards DOOH API的官方CLI

如何安装 @trillboards/cli?

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

@trillboards/cli 支持 TypeScript 吗?

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

@trillboards/cli 支持 ESM 还是 CommonJS?

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

@trillboards/cli 需要什么版本的 Node.js?

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

@trillboards/cli 可以商用吗?

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

@trillboards/cli 还在维护吗?

最新版本 0.1.12 发布于 2026/11/03(今天);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/04/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。