pp-delta-trip

Delta Trip — Printing Press 命令行工具

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

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

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

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

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

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

go install github.com/mvanhorn/printing-press-library/library/travel/delta-trip/cmd/delta-trip-pp-cli@latest

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

何时不使用此命令行工具

对于需要创建、更新、删除、发布、评论、点赞、邀请、订购、发送消息、预订、购买或更改远程状态的请求，请勿启用此命令行工具。此打印版命令行工具仅提供只读的检查、导出、同步和分析命令。

HTTP 传输

此命令行工具对面向浏览器的端点使用兼容 Chrome 的 HTTP 传输。常规 API 调用无需常驻的浏览器进程。

命令参考

baggage — 行程的行李信息与追踪

• delta-trip-pp-cli baggage — 查看确认编号对应的行李额度和追踪信息

flights — 行程航班详情，包括出发、到达、座位、票价等级和运营方

• delta-trip-pp-cli flights — 列出行程安排中的所有航班及其详情

seats — 按航班和乘客查看座位分配及升舱资格

• delta-trip-pp-cli seats — 查看所有乘客的座位分配和升舱选项

trips — 根据确认编号查找和管理 Delta 行程

• delta-trip-pp-cli trips — 根据确认编号、名字和姓氏查找行程

查找合适的命令

知道要做什么，但不清楚该用哪个命令时，可以直接向命令行工具查询：

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

which 会根据自然语言能力查询，从此命令行工具精选的功能索引中匹配最合适的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示没有可信的匹配项，此时请改用 --help 或尝试更具体的查询。

身份验证设置

无需身份验证。

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

Agent 模式

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

• 可通过管道传递 — JSON 输出到标准输出，错误输出到标准错误

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

  delta-trip-pp-cli flights --confirmation example-value --first-name example-resource --last-name example-resource --agent --select id,name,status
  

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

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

• 非交互式 — 不会显示提示，所有输入均通过标志提供

• 只读 — 请勿将此命令行工具用于创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他会修改数据的请求

响应封装

从本地存储或 API 读取数据的命令，会使用来源信息封装输出：

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

解析 .results 获取数据，并查看 .meta.source 以判断数据来自实时来源还是本地来源。仅当标准输出连接到终端，且未设置任何机器格式标志（--json、--csv、--compact、--quiet、--plain、--select）时，才会将便于阅读的 N results (live) 摘要输出到标准错误；管道/Agent 使用者以及指定格式运行时，标准输出只包含纯 JSON。

Agent 反馈

当你（或 Agent）发现此 CLI 有任何不对劲的地方时，请记录下来：

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

条目保存在本地的 ~/.delta-trip-pp-cli/feedback.jsonl 中。除非设置了 DELTA_TRIP_FEEDBACK_ENDPOINT，并且传入了 --send 或将 DELTA_TRIP_FEEDBACK_AUTO_SEND 设为 true，否则绝不会发送 POST 请求。默认情况下仅保存在本地。

记录让你感到意外的事，而不是提交 Bug 报告。简短、具体，写成一行：这才是能累积成效的部分。

输出传递

每条命令都接受 --deliver <sink>。除标准输出之外（或替代标准输出），输出还会发送到指定的接收端，让 Agent 无需手动管道传输即可路由命令结果。支持三种接收端：

接收端	效果
stdout	默认；仅写入标准输出
file:<path>	将输出原子性地写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到 URL（使用 --compact 时为 application/json 或 application/x-ndjson）

遇到未知协议时会拒绝执行，并返回列出受支持协议的结构化错误。Webhook 失败时会返回非零状态，并在标准错误中记录 URL 和 HTTP 状态码。

命名配置

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

delta-trip-pp-cli profile save briefing --json
delta-trip-pp-cli --profile briefing flights --confirmation example-value --first-name example-resource --last-name example-resource
delta-trip-pp-cli profile list --json
delta-trip-pp-cli profile show briefing
delta-trip-pp-cli profile delete briefing --yes

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

退出代码

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

参数解析

解析 $ARGUMENTS：

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

MCP 服务安装

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

claude mcp add delta-trip-pp-mcp -- delta-trip-pp-mcp

验证：claude mcp list

直接使用

1. 检查是否已安装：which delta-trip-pp-cli 如果未找到，请提供安装选项（参见本技能开头的先决条件）。
2. 将用户查询与上文“独特功能”和“命令参考”中最合适的命令对应起来。
3. 使用 --agent 标志执行：

   delta-trip-pp-cli <command> [subcommand] [args] --agent
   

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