Potpie

工具简介

Potpie 是 Momenta Softwares Inc. 推出的代码上下文图谱与 AI 开发代理平台，当前定位为大型代码库的规格驱动开发工具。它把代码结构、依赖关系、版本历史、项目文档和工程任务整理成可查询的上下文图谱，让代理在理解项目后回答、规划、修改和调试。

主要功能

代码上下文图谱

Potpie 会索引仓库、分支及连接的工程资料，并建立文件、函数、类、调用关系和语义信息之间的关联。代理可用关键词、节点或自然语言查询图谱，再读取实际代码来回答跨文件问题。

• 适合追踪功能入口、依赖链、实现位置和架构决策。
• 可比较分支或提交之间的变化，并分析受影响的代码元素。
• 首次索引和大型仓库更新需要计算时间，结果质量取决于索引是否完整且足够新。

Ask、Build 与 Debug 工作流

Ask 用于解释代码和架构，Build 会先研究既有模式再生成修改，Debug 则从故障表现追踪到可能根因并给出针对性方案。复杂任务可由主管代理分解给专门子代理，但生成结果仍应通过代码审查和测试。

• 代码问答可返回相关文件和代码位置，便于开发者继续核对。
• 代码生成代理能准备变更，并在用户明确要求后通过 GitHub 创建拉取请求。
• 规格代理可从需求或现有代码生成技术规格，调试代理用于分析错误路径和修复点。

工程系统集成

Potpie 可连接 GitHub、Linear、Jira 和 Confluence，把代码、议题、项目与文档纳入同一上下文。产品文档还列出 Slack、Sentry 和 VS Code，但不同部署版本的可用集成可能不同。

• GitHub 集成可读取仓库、议题和拉取请求，并在授权范围内管理分支与变更。
• Jira、Linear 和 Confluence 工具可查询或更新项目资料，具体操作由管理员授予的权限决定。
• VS Code 扩展把代码库聊天和修改流程带入编辑器，并通过本地隧道连接云端代理。

CLI、API 与自定义代理

当前开源架构以 CLI 为优先，可为 Claude Code、Codex、Cursor 和 OpenCode 安装对应指令或技能。API 可解析仓库、检查索引状态、创建会话、发送消息、列出项目与代理，并执行语义代码搜索。

使用教程

1. 先决定使用托管企业服务还是自托管开源版，并按组织安全要求准备独立测试仓库。
2. CLI 用户安装 Potpie 后运行设置向导，选择本地仓库、编码助手和需要连接的工程系统。
3. 托管用户安装 GitHub 应用并只授权目标仓库，再选择仓库、分支和 Ask、Build 或 Debug 代理。
4. 等待索引状态完成，先询问架构或关键流程，检查回答是否引用了正确文件与实现。
5. 进行代码修改时写清需求、约束和验收标准，在隔离分支查看差异并运行项目测试。
6. 需要自动化时创建 API 密钥，为请求设置最小权限，并在密钥库中保存和定期轮换。

版本与使用方式

适合哪些用户

• 需要理解大型、遗留或跨多个服务代码库的软件工程团队。
• 希望缩短新人熟悉架构、定位实现和分析依赖时间的技术负责人。
• 需要把代码变更与 Jira、Linear、Confluence 等工程资料关联的企业组织。
• 希望自托管代码智能体、扩展代理工具或通过 API 构建内部开发流程的团队。

价格与方案

当前企业定价页不公开固定单价，费用由用户许可证和按支持人数计算的平台费组成，现有技术栈集成本身称不另收费。条款提到可能存在免费与付费计划以及 Pro 方案，但公开购买页没有给出这些档位的统一价格或额度。

产品优势

• 上下文图谱同时连接代码结构、历史和工程资料，比单次文件检索更适合跨组件推理。
• 问答、规格、构建和调试共用项目上下文，减少不同代理之间的信息割裂。
• 核心仓库采用宽松的 Apache 2.0 许可证，可审查代码并自行部署。
• 同时提供 CLI、网页、编辑器扩展和 API，便于接入不同开发流程。

使用限制与注意事项

• 索引过期、缺少私有依赖或工程文档不完整，会让回答和影响分析遗漏关键上下文。
• 代理生成的代码可能引入安全、性能或兼容性问题，不能代替测试、审查和发布审批。
• 连接 GitHub 与任务系统会授予读取或写入权限，应使用最小作用域并隔离生产凭据。
• 开源版免费不代表运行免费，自托管仍需承担模型调用、计算、存储、认证和维护成本。
• 文档同时覆盖新旧架构，CLI 优先版本与网页代理版本的配置和能力可能不完全一致。

隐私、安全与退款

托管服务会处理代码、提示词、生成结果、授权令牌和使用日志，并可能使用去标识后的输入与结果改进内部模型。Pro 数据默认排除训练的功能仍在逐步推出，敏感代码用户应先书面确认设置，或选择符合组织要求的本地与专有部署。

隐私政策称输入、日志和反馈可能因历史、分析与训练需要长期甚至无限期保存，用户可申请删除，但备份、审计和法律义务可能造成保留。平台不适合处理受监管的敏感数据，自托管环境的访问控制、网络与补丁主要由部署组织负责。

付款通常不退款；技术故障、重复扣款、不可抗力或有证明的取消原因可在交易后 7 天内书面申请，由公司自行决定。获批退款预计需要 7 至 14 个工作日，具体仍以订单合同为准。

API、SDK 与开源情况

Potpie 提供带 API 密钥认证的接口，能完成仓库解析、状态查询、会话、消息、项目、代理和语义搜索等操作。当前未见独立命名的通用 SDK，开发者可依据接口文档直接集成。

核心 Potpie 仓库与独立网页界面仓库均采用 Apache 2.0 许可证，完整产品的商标、托管服务、企业功能和第三方集成不因此自动开放。自托管时还要分别遵守模型、数据库、认证和外部平台的许可证与条款。

常见问题

Potpie 是完全免费的吗？

开源代码可以按 Apache 2.0 许可使用，但部署、模型和维护会产生自己的成本。企业托管服务按用户与平台规模报价，并非已公开固定价格的免费产品。

能让 Potpie 直接修改代码吗？

Build 或代码生成代理可以准备修改，并在明确要求后创建拉取请求。用户应先在隔离分支检查差异、运行测试并完成团队审批。

私有代码会用于训练吗？

隐私政策允许使用去标识后的输入与建议改进内部系统，并称 Pro 默认排除训练仍在推出。涉及专有代码时，应在上传前确认合同、数据选项、保留期限和部署边界。