用途:通过 Pi(pi)CLI 以非交互模式执行提示,每次调用固定网关与模型(--provider、--model),或用 --seat 选择中央命名席位。适用于明确要求 Pi CLI 或特定 Pi 提供方路由的场景;本机原生命令能派发同一提供方模型时应优先本机路径。
主要能力:严格请求控制走 RPC 并带启动握手,旧式调用保留 print 模式。隐私策略以紧凑 JSON 经 --provider-routing 传入,如 gateway: openrouter、zdr: true、data_collection: deny、require_parameters: true;已具隐私块的席位在省略时套用中央 profile_policy.provider_routing。工具模式有 act(完整内置工具)、restricted(--restrict-tools,仅文件读取)、no_tools(--no-tools)、browser(--tool-policy browser,需 --browser-mechanism 与 --browser-preflight)。可用 --image-file <path> 传显式图像附件,可重复。--output-schema 在本地校验最终输出。
用法要点:从技能目录运行 python3 "$SKILL_DIR/scripts/run_pi.py",按运行快照复制所选 --provider、--model、--thinking、--session 与 --provider-routing;先读 shared/references/host-model-execution.md 与 model-preview.md。命名席位与模型 ID 见 shared/model-routing.json。结果读取封套中的 agent_message,而非 stdout。
限制:需预先安装 pi CLI 并置于 PATH,环境需有所选提供方的密钥(默认提供方为 OPENROUTER_API_KEY);缺凭据时包装器报 success: false、status: auth_missing。缺 CLI 或密钥报 status: seat_unavailable,无其他席位回退。严格执行需满足运行适配器声明的最低稳定 Pi 版本,且上下文压缩前需停止等待。没有原生超时参数,超时由包装器在子进程层以 return_code -1 报告;会话恢复用原生 --session。模型目录外的 ID 需已验证的能力元数据,单独传入字符串不证明可访问、图像或工具支持。其他细节资料未提供。