跳转到主要内容

​
概述

类型: 编码工具主要路径: OpenAI-compatible支持级别: 支持路径
Pi 是一个极简终端编码代理工具。在 LemonData 的文档信息架构里，它更适合归类到 Coding Tools，而不是原生 SDK。 Pi 的特殊点在于它介于经典 CLI 工具和可嵌入运行时之间：
  • 可交互的终端编码工作流
  • 用于进程集成的 JSON / RPC 模式
  • 可嵌入你自己应用里的 SDK 风格能力
对 LemonData 来说，Pi 通常最适合先走 OpenAI-compatible 路径，除非你明确要用 Anthropic-native 或 Google-native 行为。

​
推荐的 LemonData 路径

将 LemonData 作为 OpenAI-compatible 端点 使用： 
export OPENAI_API_KEY="sk-your-lemondata-key"
export OPENAI_BASE_URL="https://api.lemondata.cc/v1"
然后在 Pi 的 provider 或自定义模型配置中，把它的 OpenAI 风格路径指向 LemonData。
Pi 也可以走 Anthropic 风格和 Google 风格的接入配置。如果你需要 Claude-native 或 Gemini-native 行为，请把它视为 Pi 的专用配置，而不是通用的 OpenAI-compatible 配置。

​
为什么 Pi 不能简单归为 SDK

Pi 不只是“另一个 SDK”。
  • 如果你把 Pi 当作终端代理使用，它更像 coding tool
  • 如果你把 Pi 嵌入自己的应用里，它又更像 代理运行时 / 执行框架
因此这页更关注 LemonData 的实际接入路径，而不是把 Pi 简化成纯 SDK。

​
实用配置说明

除非你的 Pi 工作流明确依赖原生协议，否则优先从 LemonData 的 https://api.lemondata.cc/v1 路径开始。
Claude-native 或 Gemini-native 的 Pi 配置应被视为独立的专用路径，不应默认等同于 OpenAI-compatible 路径。
Pi 的可配置性很强。LemonData 可以文档化连接路径，但不应把每个 extension、skill 或自定义执行框架行为都视为兼容性契约的一部分。

​
故障排查

  • 确认配置的 OpenAI 风格 base URL 完全等于 https://api.lemondata.cc/v1
  • 确认 key 以 sk- 开头
  • 确认 Pi 当前走的接入路径和你预期的协议一致
  • 把 LemonData 模型 id 和 Pi 本地 alias 分开管理
  • 如果你在测试原生协议行为，请确认 Pi 实际走的是对应原生路径