用途:该技能用于把 Pi 编码代理集成到外部程序,提供两种路径——无头 RPC 子进程通信,以及 Node/TypeScript 进程内嵌入。
主要能力:RPC 模式通过 stdin/stdout 传输 JSONL,记录分隔符仅用 \n,输入可选剥离 \r;注意 U+2028/U+2029 与 readline 不兼容。--mode json 为只读观察,输出 session header 及 agent_/turn_/message_/tool_execution_ 事件,可用 jq 过滤;--mode rpc 为双向控制,stdin 发命令、stdout 收响应。RPC 提示会展开技能命令与提示模板。
使用方式:Node/TypeScript 用户优先用 AgentSession 而非子进程。进程内嵌入用 createAgentSession(),需提供 sessionManager、authStorage、modelRegistry;多会话托管用 createAgentSessionRuntime(),返回 AgentSessionRuntime,可访问 agent、sessionManager、settingsManager、modelRegistry、extensions、bashExecutor、resourceLoader。相关 API 从 @mariozechner/pi-coding-agent 导入,参考 sdk.md 与 examples/sdk/。
适用场景:需要程序化驱动 Pi 代理、观察代理活动事件流,或在 Node 服务中嵌入代理会话。
限制:分帧规则以 rpc.md 为准,不得使用通用按行读取器;不要描述与文档冲突的分隔符行为。具体安装命令、版本与收费信息暂未提供。