命令行、模式与 SDK

调用与输出：pi 默认交互；message 提供初始提示；@path 把文本文件或图片加入第一条提示；-- 停止选项解析（提示可以以 - 开头）。-p / --print 运行给定提示、把最终助手文本写到 stdout 后退出（适合一次性和脚本任务）；--mode text 选择文本输出（stdin 与 stdout 都是终端时仍打开终端界面）；--mode json 运行并把 JSONL 事件写到 stdout 后退出；--mode rpc 从 stdin 读取 JSONL 命令、把响应和事件写到 stdout，直到关闭，用来控制单独的 Pi 进程；--export <input> [output] 把会话文件导出为 HTML。其他选项涉及模型（--models 等）、会话（--continue、--resume、--session、--fork、--no-session、--name、--session-dir）、工具（defaultTools 设置的默认是 read、bash、edit、write）、资源与进程；包命令见「扩展与 Pi 包」。

TypeScript SDK：在应用进程内创建和控制智能体会话，与交互模式共用同一套智能体和会话机制：会话生命周期与存储、发送提示、订阅事件、配置会话。官方 SDK 页给出完整示例。四种接口（交互、打印、JSON、RPC、SDK）使用同样的智能体与会话机制。