pp-espn

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ESPN — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the

espn-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install espn --cli-only

Verify:
```
espn-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-cli@latest

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

此技能基于

espn-pp-cli

二进制文件运行。在调用此技能的任何命令前，必须确认CLI已安装。若未安装，请先执行以下步骤：

通过Printing Press安装器安装：

bash

npx -y @mvanhorn/printing-press install espn --cli-only

验证安装：
```
espn-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

若

npx

安装失败（无Node环境、离线等情况），可改用Go直接安装（要求Go 1.23+版本）：

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-cli@latest

若安装后执行

--version

提示“command not found”，说明安装程序未将二进制文件添加到

$PATH

中。请在验证成功前不要执行技能相关命令。

When to Use This CLI

何时使用此CLI

Reach for this when a user wants a quick sports lookup - current score, standings, upcoming schedule, head-to-head record, or a rich per-game summary (box score, leaders, scoring plays, odds, win probability). Also good for cross-league discovery (

today

) and offline search across synced data.

Don't reach for this if the user has a paid feed like Stats Perform or Sportradar that provides cleaner data, or if they need real-time websocket updates (ESPN's endpoints are polling-only). For betting odds in isolation, the per-game

summary

payload includes them but there is no league-wide odds command.

当用户需要快速查询体育信息时使用——包括当前比分、排名、即将到来的赛程、对垒记录，或详细的单场赛事总结（技术统计、领先球员、得分回合、赔率和获胜概率）。也适用于跨联赛发现（

today

命令）和基于同步数据的离线搜索。

若用户拥有Stats Perform或Sportradar等付费数据源（数据更规范），或需要实时WebSocket更新（ESPN仅支持轮询接口），则不建议使用此工具。若仅需查看博彩赔率，单场赛事的

summary

数据中包含相关信息，但暂无全联赛赔率查询命令。

Unique Capabilities

独特功能

Commands that only work because of local sync + cross-league tooling.

以下命令依赖本地同步+跨联赛工具实现：

Cross-league discovery

跨联赛发现

today
— Today's scores across all major sports in one call. The fastest "what's on tonight" answer without picking a sport first.
trending
— Most-followed athletes and teams across all leagues, ranked by current popularity. Good for "who is hot right now" without naming a sport.
dashboard
— Reads
```
[favorites]
```
from
```
~/.config/espn-pp-cli/config.toml
```
and shows scores for each favorited team across leagues, in one call.
watch <sport> <league> --event <game_id>
— Live score updates for a specific game (polls every 30s). Use
```
scores
```
or
```
today
```
to find the game, then
```
watch
```
to follow it live.

today
— 一次调用获取所有主流体育赛事当日比分。无需先选择赛事类型，即可快速获取“今晚有哪些比赛”的答案。
trending
— 跨联赛当前最受关注的运动员和球队，按人气排名。适用于查询“当下热门选手/球队”，无需指定赛事类型。
dashboard
— 读取
```
~/.config/espn-pp-cli/config.toml
```
中的
```
[favorites]
```
配置，一次性展示所有收藏球队的跨联赛比分。
watch <sport> <league> --event <game_id>
— 特定赛事的实时比分更新（每30秒轮询一次）。先使用
```
scores
```
或
```
today
```
找到赛事ID，再用
```
watch
```
实时跟进。

Game-state intelligence

赛事状态分析

summary <sport> <league> --event <game_id>
— Detailed game summary including box score, leaders, scoring plays, odds, and win probability. The single richest payload per game.
boxscore <event_id>
— Just the per-player box score for an event id, with sport+league inferred from a recent scoreboard cache hit. Pass
```
--sport
```
/
```
--league
```
to skip inference.
plays <sport> <league> --event <id>
— Play-by-play feed for a specific event. Optional
```
--limit
```
(default 200).
recap <sport> <league>
— Post-game recap with box score and leaders for the most recent completed game in a league.
scoreboard <sport> <league>
— Live scoreboard with date filtering, week/group selectors, and competition metadata.
odds <sport> <league>
— Spread, over/under, and moneyline lines for tonight's slate, derived from the scoreboard payload (no per-game summary calls).

summary <sport> <league> --event <game_id>
— 详细赛事总结，包含技术统计、领先球员、得分回合、赔率和获胜概率。单场赛事最完整的数据集合。
boxscore <event_id>
— 仅展示指定赛事ID的球员技术统计，赛事类型和联赛会从最近的积分榜缓存中自动推断。可传入
```
--sport
```
/
```
--league
```
参数跳过推断。
plays <sport> <league> --event <id>
— 指定赛事的逐回合记录。可选
```
--limit
```
参数（默认200条）。
recap <sport> <league>
— 联赛最近结束赛事的赛后总结，包含技术统计和领先球员。
scoreboard <sport> <league>
— 实时积分榜，支持日期筛选、周/组选择和赛事元数据展示。
odds <sport> <league>
— 当日赛事的让分、总分和胜负赔率，从积分榜数据中提取（无需调用单场赛事总结接口）。

Standings and rankings

排名与榜单

standings <sport> <league>
— Conference/division standings.
rankings <sport> <league>
— Current AP, Coaches, and CFP poll rankings (NCAAF/NCAAM).
streak <sport> <league>
— Current win/loss streaks across teams in a league, computed from synced data.
rivals <sport> <league>
— Head-to-head records between teams in a league from synced data.
h2h <team1> <team2> --sport <s> --league <l>
— Deeper head-to-head detail for one specific pair, including average score and recent meetings list.
sos <sport> <league>
— Strength-of-schedule per team, derived from the standings payload, sorted descending.

standings <sport> <league>
— 分区/联盟排名。
rankings <sport> <league>
— 当前AP、教练和CFP排名（适用于NCAAF/NCAAM）。
streak <sport> <league>
— 联赛各球队当前的连胜/连败记录，基于同步数据计算。
rivals <sport> <league>
— 联赛内球队间的对垒记录，基于同步数据生成。
h2h <team1> <team2> --sport <s> --league <l>
— 特定两队的详细对垒数据，包括平均得分和近期交锋记录。
sos <sport> <league>
— 各球队的赛程强度，基于排名数据计算，按降序排列。

People

球员相关

leaders <sport> <league> [--category <name>]
— Statistical leaders across categories with optional filter.
compare <athlete1> <athlete2> --sport <s> --league <l>
— Side-by-side season stats for two athletes. Ambiguous names list candidates and exit 2.
injuries <sport> <league>
— Active injury report across the league, grouped by team.
transactions <sport> <league>
— Recent trades, signings, and waivers.

leaders <sport> <league> [--category <name>]
— 各数据类别中的领先球员，支持筛选。
compare <athlete1> <athlete2> --sport <s> --league <l>
— 两名球员的赛季数据对比。若姓名存在歧义，会列出候选选项并以状态码2退出。
injuries <sport> <league>
— 联赛内现役球员的伤病报告，按球队分组展示。
transactions <sport> <league>
— 近期交易、签约和弃权信息。

Local store

本地存储

sync
— Pull a sport+league dataset into local SQLite for offline analysis.
search "<query>"
— Full-text search across synced events and news.
sql <query>
— Run read-only SQL queries against the local database.

sync
— 将指定赛事类型+联赛的数据拉取到本地SQLite数据库，用于离线分析。
search "<query>"
— 对同步的赛事和新闻进行全文搜索。
sql <query>
— 对本地数据库执行只读SQL查询。

Command Reference

命令参考

Live action:

```
espn-pp-cli scores <sport> <league>
```
— Current scores
```
espn-pp-cli today
```
— Today's scores across all major sports
```
espn-pp-cli scoreboard <sport> <league>
```
— Scoreboard with optional date filtering

espn-pp-cli watch <sport> <league> --event <game_id>

— Live score polling for one game

```
espn-pp-cli standings <sport> <league>
```
— League standings
```
espn-pp-cli trending
```
— Most-followed athletes and teams across leagues

espn-pp-cli dashboard

— Favorites snapshot from

~/.config/espn-pp-cli/config.toml

Team detail:

espn-pp-cli teams <sport> <league> <team_id>

— Schedule for one team (past + upcoming)

espn-pp-cli teams get <sport> <league> <team_id>

— Team record, links, and logos

```
espn-pp-cli teams list <sport> <league>
```
— All teams in a league
```
espn-pp-cli streak <sport> <league>
```
— Current win/loss streaks from synced data
```
espn-pp-cli rivals <sport> <league>
```
— Head-to-head records between teams from synced data
```
espn-pp-cli h2h <team1> <team2> --sport <s> --league <l>
```
— Deeper detail for one team pair (avg score, meetings)
```
espn-pp-cli sos <sport> <league>
```
— Strength-of-schedule, sorted descending

Game detail:

```
espn-pp-cli summary <sport> <league> --event <game_id>
```
— Full game summary (box score, leaders, scoring plays, odds, win probability)
```
espn-pp-cli boxscore <event_id>
```
— Just the box score subtree (sport/league inferred from cache)

espn-pp-cli plays <sport> <league> --event <id>

— Play-by-play feed (optional

--limit

, default 200)

```
espn-pp-cli recap <sport> <league>
```
— Most recent completed game recap
```
espn-pp-cli odds <sport> <league>
```
— Spread, over/under, moneyline for tonight's slate

People:

espn-pp-cli leaders <sport> <league> [--category <name>]

— Statistical leaders by category

espn-pp-cli compare <athlete1> <athlete2> --sport <s> --league <l>

— Side-by-side athlete stats

```
espn-pp-cli injuries <sport> <league>
```
— Active injury report

espn-pp-cli transactions <sport> <league>

— Recent trades, signings, waivers

Polls and rankings:

```
espn-pp-cli rankings <sport> <league>
```
— AP, Coaches, and CFP polls

Info:

```
espn-pp-cli news <sport> <league>
```
— Latest news

Discovery and local:

```
espn-pp-cli search "<query>"
```
— Full-text search across synced events and news
```
espn-pp-cli sync
```
— Sync a sport+league into local SQLite
```
espn-pp-cli sql "<query>"
```
— Run read-only SQL against the local store
```
espn-pp-cli load
```
— Show workload distribution per assignee (synced data)
```
espn-pp-cli orphans
```
/
```
stale
```
— Maintenance views over the local store
```
espn-pp-cli doctor
```
— Verify connectivity and configuration

Sport values:

football

basketball

baseball

hockey

soccer

. League values:

nfl

nba

mlb

nhl

ncaaf

ncaam

ncaaw

mls

eng.1

(EPL),

wnba

实时赛事：

```
espn-pp-cli scores <sport> <league>
```
— 当前比分
```
espn-pp-cli today
```
— 所有主流体育赛事当日比分
```
espn-pp-cli scoreboard <sport> <league>
```
— 积分榜，支持日期筛选

espn-pp-cli watch <sport> <league> --event <game_id>

— 单场赛事实时比分轮询

```
espn-pp-cli standings <sport> <league>
```
— 联赛排名
```
espn-pp-cli trending
```
— 跨联赛最受关注的运动员和球队

espn-pp-cli dashboard

— 从

~/.config/espn-pp-cli/config.toml

中读取收藏球队的快照

球队详情：

```
espn-pp-cli teams <sport> <league> <team_id>
```
— 单支球队的赛程（已结束+即将到来）

espn-pp-cli teams get <sport> <league> <team_id>

— 球队战绩、链接和队徽

```
espn-pp-cli teams list <sport> <league>
```
— 联赛内所有球队
```
espn-pp-cli streak <sport> <league>
```
— 基于同步数据的当前连胜/连败记录
```
espn-pp-cli rivals <sport> <league>
```
— 基于同步数据的球队对垒记录
```
espn-pp-cli h2h <team1> <team2> --sport <s> --league <l>
```
— 特定两队的详细对比（平均得分、交锋记录）
```
espn-pp-cli sos <sport> <league>
```
— 赛程强度，按降序排列

赛事详情：

```
espn-pp-cli summary <sport> <league> --event <game_id>
```
— 完整赛事总结（技术统计、领先球员、得分回合、赔率、获胜概率）
```
espn-pp-cli boxscore <event_id>
```
— 仅展示技术统计子数据（赛事类型/联赛从缓存推断）

espn-pp-cli plays <sport> <league> --event <id>

— 逐回合记录（可选

--limit

参数，默认200条）

```
espn-pp-cli recap <sport> <league>
```
— 最近结束赛事的总结
```
espn-pp-cli odds <sport> <league>
```
— 当日赛事的让分/总分/胜负赔率

球员相关：

espn-pp-cli leaders <sport> <league> [--category <name>]

— 按数据类别筛选的领先球员

espn-pp-cli compare <athlete1> <athlete2> --sport <s> --league <l>

— 球员数据对比

```
espn-pp-cli injuries <sport> <league>
```
— 现役伤病报告

espn-pp-cli transactions <sport> <league>

— 近期交易、签约、弃权信息

投票与排名：

```
espn-pp-cli rankings <sport> <league>
```
— AP、教练和CFP排名

资讯：

```
espn-pp-cli news <sport> <league>
```
— 最新资讯

发现与本地功能：

```
espn-pp-cli search "<query>"
```
— 对同步的赛事和新闻进行全文搜索
```
espn-pp-cli sync
```
— 将指定赛事类型+联赛同步到本地SQLite
```
espn-pp-cli sql "<query>"
```
— 对本地存储执行只读SQL查询
```
espn-pp-cli load
```
— 展示同步数据中各负责人的工作负载分布
```
espn-pp-cli orphans
```
/
```
stale
```
— 本地存储的维护视图
```
espn-pp-cli doctor
```
— 验证连接性和配置

赛事类型取值：

football

basketball

baseball

hockey

soccer

联赛取值：

nfl

nba

mlb

nhl

ncaaf

ncaam

ncaaw

mls

eng.1

（EPL）,

wnba

Recipes

使用示例

Morning sports scan

晨间体育概览

bash

espn-pp-cli today --agent --select events.shortName,events.status
espn-pp-cli scores football nfl --agent --select events.shortName,events.competitions.competitors.team.displayName,events.status.type.detail
espn-pp-cli standings football nfl --agent

One

today

call covers cross-league activity, one

scores

for the league you care about, one

standings

for context. The nested

--select

paths cut a scoreboard payload from tens of KB down to the fields that actually matter — essential for keeping agent context small.

bash

espn-pp-cli today --agent --select events.shortName,events.status
espn-pp-cli scores football nfl --agent --select events.shortName,events.competitions.competitors.team.displayName,events.status.type.detail
espn-pp-cli standings football nfl --agent

一次

today

调用覆盖跨联赛动态，一次

scores

查询关注的联赛，一次

standings

获取排名背景。嵌套的

--select

路径可将数十KB的积分榜数据精简到关键字段——这对控制Agent上下文大小至关重要。

Pre-game research from synced data

基于同步数据的赛前调研

bash

espn-pp-cli sync --sport football --league nfl
espn-pp-cli rivals football nfl --agent         # historical records from synced data
espn-pp-cli streak football nfl --agent         # current streaks
espn-pp-cli summary football nfl --event <id> --agent   # full game payload incl. odds and box score

Run

sync

once, then

rivals

and

streak

answer instantly from the local store.

summary

is the richest single payload for a specific game (box score, leaders, scoring plays, odds, win probability).

bash

espn-pp-cli sync --sport football --league nfl
espn-pp-cli rivals football nfl --agent         # 同步数据中的历史对垒记录
espn-pp-cli streak football nfl --agent         # 当前连胜/连败记录
espn-pp-cli summary football nfl --event <id> --agent   # 包含赔率和技术统计的完整赛事数据

只需运行一次

sync

，后续

rivals

和

streak

即可从本地存储快速获取结果。

summary

是单场赛事最丰富的数据集合（技术统计、领先球员、得分回合、赔率、获胜概率）。

Offline search after sync

同步后的离线搜索

bash

espn-pp-cli sync --sport football --league nfl
espn-pp-cli search "Mahomes"                    # finds in local store

Useful for repeated lookups in poor-connectivity environments or when batch-analyzing historical data.

bash

espn-pp-cli sync --sport football --league nfl
espn-pp-cli search "Mahomes"                    # 在本地存储中查找相关内容

适用于网络环境较差时的重复查询，或批量分析历史数据。

Favorites dashboard

收藏球队仪表盘

Add a

[favorites]

block to

~/.config/espn-pp-cli/config.toml

[favorites]
nfl = ["KC", "BAL"]
nba = ["LAL"]

Then:

bash

espn-pp-cli dashboard --agent

One call surfaces tonight's matchup status for every favorited team, grouped by league. Per-league fetches run in parallel and partial failures are reported alongside successful results.

在

~/.config/espn-pp-cli/config.toml

中添加

[favorites]

配置块：

[favorites]
nfl = ["KC", "BAL"]
nba = ["LAL"]

然后执行：

bash

espn-pp-cli dashboard --agent

一次调用即可按联赛分组展示所有收藏球队的当日赛事状态。各联赛查询并行执行，部分失败会与成功结果一同返回。

Pre-game odds and player digging

赛前赔率与球员分析

bash

espn-pp-cli odds basketball nba --agent          # tonight's spreads / totals / moneylines
espn-pp-cli leaders basketball nba --category points --agent
espn-pp-cli compare "LeBron James" "Stephen Curry" --sport basketball --league nba --agent
espn-pp-cli boxscore <event_id> --agent          # post-game player stats
espn-pp-cli plays basketball nba --event <id> --limit 50 --agent

odds

reads the scoreboard's per-event lines (no per-game summary calls).

leaders --category

filters to one stat category.

compare

resolves athlete ids by name, listing candidates and exiting 2 on ambiguity.

boxscore

infers sport+league from the most recent cache hit; pass

--sport

--league

to skip inference.

bash

espn-pp-cli odds basketball nba --agent          # 当日赛事的让分/总分/胜负赔率
espn-pp-cli leaders basketball nba --category points --agent
espn-pp-cli compare "LeBron James" "Stephen Curry" --sport basketball --league nba --agent
espn-pp-cli boxscore <event_id> --agent          # 赛后球员数据
espn-pp-cli plays basketball nba --event <id> --limit 50 --agent

odds

从积分榜的单场数据中读取赔率（无需调用单场赛事总结接口）。

leaders --category

筛选指定数据类别。

compare

通过姓名解析球员ID，若存在歧义则列出候选选项并以状态码2退出。

boxscore

从最近的缓存命中结果推断赛事类型/联赛；可传入

--sport

--league

参数跳过推断。

Auth Setup

认证设置

None required. ESPN's public endpoints don't require an API key. The

auth

command exists for consistency but is a no-op.

Optional config:

```
ESPN_CONFIG
```
— override config file path
```
ESPN_BASE_URL
```
— override base URL (for proxies or mirrors)
```
NO_COLOR
```
— standard no-color env var

无需认证。ESPN的公开接口不需要API密钥。

auth

命令仅为保持一致性而存在，实际无任何操作。

可选配置：

```
ESPN_CONFIG
```
— 覆盖配置文件路径
```
ESPN_BASE_URL
```
— 覆盖基础URL（用于代理或镜像）
```
NO_COLOR
```
— 标准无颜色输出环境变量

Agent Mode

Agent模式

Add

--agent

to any command. Expands to

--json --compact --no-input --no-color --yes

. Use

--select

for field cherry-picking,

--dry-run

to preview requests,

--no-cache

to bypass GET cache.

在任何命令后添加

--agent

参数，等效于

--json --compact --no-input --no-color --yes

。可使用

--select

筛选字段，

--dry-run

预览请求，

--no-cache

绕过GET缓存。

Filtering output

输出过滤

--select

accepts dotted paths to descend into nested responses; arrays traverse element-wise:

bash

espn-pp-cli <command> --agent --select id,name
espn-pp-cli <command> --agent --select items.id,items.owner.name

Use this to narrow huge payloads to the fields you actually need — critical for deeply nested API responses.

--select

接受点分隔路径以遍历嵌套响应；数组会逐个元素处理：

bash

espn-pp-cli <command> --agent --select id,name
espn-pp-cli <command> --agent --select items.id,items.owner.name

使用此功能可将庞大的响应数据精简到所需字段——这对处理深度嵌套的API响应至关重要。

Response envelope

响应信封

Data-layer commands wrap output in

{"meta": {...}, "results": <data>}

. Parse

.results

for data and

.meta.source

to know whether it's

live

or local. The

N results (live)

summary is printed to stderr only when stdout is a TTY; piped/agent consumers see pure JSON on stdout.

数据层命令会将输出包裹在

{"meta": {...}, "results": <data>}

中。解析

.results

获取数据，通过

.meta.source

判断数据来自

live

（实时）还是本地。当stdout为TTY时，

N results (live)

总结会打印到stderr；管道/Agent消费者仅会在stdout看到纯JSON数据。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error
3	Not found (team, game, athlete)
5	API error
7	Rate limited

代码	含义
0	成功
2	使用错误
3	未找到（球队、赛事、球员）
5	API错误
7	速率限制

Installation

安装

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-cli@latest
espn-pp-cli doctor

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-cli@latest
espn-pp-cli doctor

MCP Server

MCP服务器

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-mcp@latest
claude mcp add espn-pp-mcp -- espn-pp-mcp

bash

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/espn/cmd/espn-pp-mcp@latest
claude mcp add espn-pp-mcp -- espn-pp-mcp

Argument Parsing

参数解析

Given

$ARGUMENTS

Empty,
help
, or
--help
→ run
```
espn-pp-cli --help
```
install
→ CLI; install mcp
→ MCP
Anything else → resolve
```
<sport> <league>
```
from user intent (e.g., "Lakers" →
```
basketball nba
```
), check
```
which espn-pp-cli
```
(offer install if missing), run with
```
--agent
```
.

针对

$ARGUMENTS

：

为空、
help
或
--help
→ 执行
```
espn-pp-cli --help
```
install
→ 安装CLI；install mcp
→ 安装MCP
其他内容 → 从用户意图解析
```
<sport> <league>
```
（例如“Lakers” →
```
basketball nba
```
），检查
```
which espn-pp-cli
```
（若缺失则提示安装），并添加
```
--agent
```
参数执行命令。

Agent Workflow Features

Agent工作流特性

This CLI exposes three shared agent-workflow capabilities patched in from cli-printing-press PR #218.

此CLI提供三项从cli-printing-press PR #218中移植的通用Agent工作流功能。

Named profiles

命名配置文件

Persist a set of flags under a name and reuse them across invocations.

bash

undefined

将一组标志保存为命名配置，可在多次调用中复用。

bash

undefined

Save the current non-default flags as a named profile

将当前非默认标志保存为命名配置

espn-pp-cli profile save <name>

Use a profile — overlays its values onto any flag you don't set explicitly

使用配置文件——其值会覆盖未显式设置的标志

espn-pp-cli --profile <name> <command>

List / inspect / remove

列出/查看/删除配置

espn-pp-cli profile list espn-pp-cli profile show <name> espn-pp-cli profile delete <name> --yes


Flag precedence: explicit flag > env var > profile > default.

espn-pp-cli profile list espn-pp-cli profile show <name> espn-pp-cli profile delete <name> --yes


标志优先级：显式标志 > 环境变量 > 配置文件 > 默认值。

--deliver

Route command output to a sink other than stdout. Useful when an agent needs to hand a result to a file, a webhook, or another process without plumbing.

bash

espn-pp-cli <command> --deliver file:/path/to/out.json
espn-pp-cli <command> --deliver webhook:https://hooks.example/in

File sinks write atomically (tmp + rename). Webhook sinks POST

application/json

(or

application/x-ndjson

when

--compact

is set). Unknown schemes produce a structured refusal listing the supported set.

将命令输出路由到stdout以外的目标。适用于Agent需要将结果传递到文件、webhook或其他进程的场景，无需额外管道配置。

bash

espn-pp-cli <command> --deliver file:/path/to/out.json
espn-pp-cli <command> --deliver webhook:https://hooks.example/in

文件目标会原子性写入（先写入临时文件再重命名）。Webhook目标会POST

application/json

数据（若设置

--compact

则为

application/x-ndjson

）。未知协议会返回结构化提示，列出支持的类型。

feedback

Record in-band feedback about this CLI from the agent side of the loop. Local-only by default; safe to call without configuration.

bash

espn-pp-cli feedback "what surprised you or tripped you up"
espn-pp-cli feedback list         # show local entries
espn-pp-cli feedback clear --yes  # wipe

Entries append to

~/.espn-pp-cli/feedback.jsonl

as JSON lines. When

ESPN_FEEDBACK_ENDPOINT

is set and either

--send

is passed or

ESPN_FEEDBACK_AUTO_SEND=true

, the entry is also POSTed upstream (non-blocking — local write always succeeds).

从Agent端记录关于此CLI的反馈。默认仅本地存储；无需配置即可安全调用。

bash

espn-pp-cli feedback "what surprised you or tripped you up"
espn-pp-cli feedback list         # 显示本地记录
espn-pp-cli feedback clear --yes  # 清空记录

记录会以JSON行格式追加到

~/.espn-pp-cli/feedback.jsonl

。当设置

ESPN_FEEDBACK_ENDPOINT

且传递

--send

参数或设置

ESPN_FEEDBACK_AUTO_SEND=true

时，记录还会被POST到上游（非阻塞——本地写入始终成功）。