[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-potpie-ai--potpie":3,"tool-potpie-ai--potpie":62},[4,18,28,37,45,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":59,"last_commit_at":60,"category_tags":61,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":110,"forks":111,"last_commit_at":112,"license":113,"difficulty_score":114,"env_os":115,"env_gpu":116,"env_ram":116,"env_deps":117,"category_tags":130,"github_topics":131,"view_count":24,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":141,"updated_at":142,"faqs":143,"releases":173},9955,"potpie-ai\u002Fpotpie","potpie","Spec-driven development for large codebases","Potpie 是一款专为大型代码库设计的开源开发辅助工具，它能将整个项目代码转化为结构化的“知识图谱”。通过深度索引每一个文件、类和函数，并梳理它们之间的复杂关联，Potpie 让 AI 智能体能够像原作者一样精准理解代码上下文，从而高效完成从故障调试到新功能开发的各种任务。\n\n面对日益庞大的代码库，开发者常因难以快速理清模块依赖和逻辑脉络而降低效率。Potpie 正是为了解决这一痛点而生，它打破了传统搜索仅匹配文本的局限，提供了基于代码结构的深层推理能力，帮助团队在维护遗留系统或扩展复杂架构时更加得心应手。\n\n这款工具非常适合需要处理大规模项目的软件工程师、技术负责人以及希望提升代码理解效率的开发团队。其核心技术亮点在于构建了全量代码的知识图谱，并支持多种主流大语言模型（如 OpenAI、Ollama、Anthropic 等），允许用户根据需求灵活配置推理模型。此外，Potpie 提供了完善的本地部署方案，结合 Docker 与 Python 环境即可快速启动，既保障了数据安全，又赋予了极高的定制化自由度，是现代化规范驱动开发的得力助手。","\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fpotpie.ai?utm_source=github\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\".\u002Fassets\u002Freadme_logo_dark.svg\" \u002F>\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\".\u002Fassets\u002Freadme_logo_light.svg\" \u002F>\n      \u003Cimg src=\".\u002Fassets\u002Flogo_light.svg\"  alt=\"Potpie AI logo\" \u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\n# Potpie\n\n[Potpie](https:\u002F\u002Fpotpie.ai) turns your entire codebase into a **knowledge graph** - a structural index of every file, class, and function, capturing all their relationships and what each part of the code does in context of everything else. AI agents built on this graph can reason about your code with the precision of someone who wrote it - from debugging to feature development.\n\n\n\u003Cp align=\"center\">\n\u003Cimg width=\"700\" alt=\"Potpie Dashboard\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpotpie-ai_potpie_readme_8416dc002086.gif\" \u002F>\n\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-Read-blue?logo=readthedocs&logoColor=white\" alt=\"Docs\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002FLICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fpotpie-ai\u002Fpotpie\" alt=\"Apache 2.0\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fpotpie-ai\u002Fpotpie\" alt=\"GitHub Stars\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Fryk5CMD5v6\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?logo=discord&logoColor=white\" alt=\"Discord\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=PotpieAI.potpie-vscode-extension\">\u003Cimg src=\"https:\u002F\u002Fcustom-icon-badges.demolab.com\u002Fbadge\u002FVSCode-Extension-0078d7.svg?logo=vsc&logoColor=white\" alt=\"VSCode Extension\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\n## Quick Start\n\n### Prerequisites\n\n- [Docker](https:\u002F\u002Fdocker.com) installed and running\n- [Git](https:\u002F\u002Fgit-scm.com) installed\n- [Python 3.11+](https:\u002F\u002Fpython.org) with [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F)\n\n### Installation\n\n1. **Clone the repository**\n\n   ```bash\n   git clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie.git\n   cd potpie\n   ```\n\n2. **Configure your environment**\n\n   ```bash\n   cp .env.template .env\n   ```\n\n   Edit `.env` with the following required values:\n\n   ```bash\n   # App & Environment\n   isDevelopmentMode=enabled\n   ENV=development\n   defaultUsername=defaultuser\n\n   # AI \u002F LLM Configuration\n   LLM_PROVIDER=openai                    # openai | ollama | anthropic | openrouter\n   OPENAI_API_KEY=sk-proj-your-key\n   CHAT_MODEL=gpt-4o\n   INFERENCE_MODEL=gpt-4o-mini\n\n   # Database\n   POSTGRES_SERVER=postgresql:\u002F\u002Fpostgres:mysecretpassword@localhost:5432\u002Fmomentum\n   NEO4J_URI=bolt:\u002F\u002F127.0.0.1:7687\n   NEO4J_USERNAME=neo4j\n   NEO4J_PASSWORD=mysecretpassword\n\n   # Redis & Background Jobs\n   REDISHOST=127.0.0.1\n   REDISPORT=6379\n   BROKER_URL=redis:\u002F\u002F127.0.0.1:6379\u002F0\n   CELERY_QUEUE_NAME=dev\n\n   # Project & Repo Management\n   PROJECT_PATH=projects\n   ```\n\n   > **`CHAT_MODEL`** and **`INFERENCE_MODEL`** are used for agent reasoning and knowledge graph generation respectively. Model names follow the `provider\u002Fmodel_name` format as expected by [LiteLLM](https:\u002F\u002Fdocs.litellm.ai\u002Fdocs\u002Fproviders).\n\n   > **💡 Using Ollama instead?** Set `LLM_PROVIDER=ollama` and use `CHAT_MODEL=ollama_chat\u002Fqwen2.5-coder:7b` and `INFERENCE_MODEL=ollama_chat\u002Fqwen2.5-coder:7b`.\n\n   See `.env.template` for the full list of optional configuration (logging, feature flags, object storage, email, analytics, etc.).\n\n3. **Install dependencies**\n\n   ```bash\n   curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n   uv sync\n   ```\n\n4. **Start all services**\n\n   ```bash\n   chmod +x scripts\u002Fstart.sh\n   .\u002Fscripts\u002Fstart.sh\n   ```\n\n   This will start Docker services, apply migrations, start the FastAPI app, and start the Celery worker.\n\n5. **Health Check**\n\n   ```bash\n   curl -X GET 'http:\u002F\u002Flocalhost:8001\u002Fhealth'\n   ```\n\n6. **Check parsing status**\n\n   ```bash\n   curl -X GET 'http:\u002F\u002Flocalhost:8001\u002Fapi\u002Fv1\u002Fparsing-status\u002Fyour-project-id'\n   ```\n\nTo stop all services:\n\n```bash\n.\u002Fscripts\u002Fstop.sh\n```\n\n#### Now set up Potpie Frontend\n\n```bash\ncd potpie-ui\n\ncp .env.template .env\n\npnpm build && pnpm start\n```\n\n\n---\n\n## How it works?\n\nPotpie parses your repository into a **knowledge graph** stored in Neo4j - capturing every file, function, class, and the relationships between them. Agents read directly from this graph to answer questions and complete tasks grounded in your actual code.\n\n**Architecture**\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\".\u002Fassets\u002Farchitecture.svg\" alt=\"Potpie Architecture\" width=\"900\"\u002F>\n\u003C\u002Fp>\n\n- [**FastAPI**](https:\u002F\u002Ffastapi.tiangolo.com\u002F) serves as the API layer - all requests enter through `localhost:8001` with CORS, Logfire tracing, and optional Sentry error tracking.\n- [**Firebase Auth**](https:\u002F\u002Ffirebase.google.com\u002Fdocs\u002Fauth) handles production authentication. In development mode a dummy user is created locally - no Firebase needed.\n- [**Celery Worker**](https:\u002F\u002Fdocs.celeryq.dev\u002F) with [Redis](https:\u002F\u002Fredis.io\u002F) as the broker handles async repo parsing - cloning, AST extraction, and knowledge graph construction run entirely in the background.\n- [**Conversation Service**](https:\u002F\u002Fdocs.potpie.ai\u002Fconversations) manages chat sessions and agent memory across multi-turn interactions.\n- [**Agent Router**](https:\u002F\u002Fdocs.potpie.ai\u002Fagents\u002Fintroduction) dispatches prompts to the correct pre-built or custom agent based on intent.\n- [**Tool Service**](https:\u002F\u002Fdocs.potpie.ai\u002Ftools) exposes callable functions to agents - code search, file fetch, knowledge graph queries, web tools, and more.\n- [**Neo4j Knowledge Graph**](https:\u002F\u002Fneo4j.com\u002F) stores your codebase as a property graph - functions, classes, files, imports, and call relationships - the backbone of every agent's context.\n- [**PostgreSQL**](https:\u002F\u002Fwww.postgresql.org\u002F) stores users, projects, conversations, and message history.\n\n\n## GitHub Authentication\n\n\n| Method | Configuration | Best For |\n|--------|--------------|----------|\n| **GitHub App** | `GITHUB_APP_ID`, `GITHUB_PRIVATE_KEY` | Production |\n| **PAT Pool** | `GH_TOKEN_LIST=ghp_token1,ghp_token2` | Development \u002F Higher rate limits |\n| **Unauthenticated** | No configuration required | Public repositories only (60 req\u002Fhr) |\n\nSet `GITHUB_AUTH_MODE` to `app`, `pat`, or `none` to select the method.\n\n---\n\n## Self-Hosted Git Providers\n\nFor self-hosted Git servers (e.g., GitBucket, GitLab, etc.), configure:\n\n      \n      uv sync\n    \n\nThis will create a `.venv` directory and install all dependencies from `pyproject.toml`\n\n#### GitHub Authentication Setup\n\nPotpie supports multiple authentication methods for accessing GitHub repositories:\n\n##### For GitHub.com Repositories:\n\n**Option 1: GitHub App (Recommended for Production)**\n  - Create a GitHub App in your organization\n  - Set environment variables:\n    ```bash\n    GITHUB_APP_ID=your-app-id\n    GITHUB_PRIVATE_KEY=your-private-key\n    ```\n\n**Option 2: Personal Access Token (PAT) Pool**\n  - Create one or more GitHub PATs with `repo` scope\n  - Set environment variable (comma-separated for multiple tokens):\n    ```bash\n    GH_TOKEN_LIST=ghp_token1,ghp_token2,ghp_token3\n    ```\n  - Potpie will randomly select from the pool for load balancing\n  - **Rate Limit**: 5,000 requests\u002Fhour per token (authenticated)\n\n**Option 3: Unauthenticated Access (Public Repos Only)**\n  - No configuration needed\n  - Automatically used as fallback for public repositories\n  - **Rate Limit**: 60 requests\u002Fhour per IP (very limited)\n\n##### For Self-Hosted Git Servers (GitBucket, GitLab, etc.):\n\n      Set the following environment variables:\n      \n    \n      CODE_PROVIDER=github   # Options: github, gitbucket\n      CODE_PROVIDER_BASE_URL=http:\u002F\u002Fyour-git-server.com\u002Fapi\u002Fv3\n      CODE_PROVIDER_TOKEN=your-token\n    \n\n**Important**: `GH_TOKEN_LIST` tokens are always used for GitHub.com, regardless of `CODE_PROVIDER_BASE_URL`.\n\n2. **Start Potpie**\n\n   To start all Potpie services:\n\n   ```bash\n   chmod +x scripts\u002Fstart.sh\n   .\u002Fscripts\u002Fstart.sh\n   ```\n\n   This will:\n   - Start required Docker services\n   - Wait for PostgreSQL to be ready\n   - Apply database migrations\n   - Start the FastAPI application\n   - Start the Celery worker\n\n    **Optional: Logfire Tracing Setup**\n\n      To monitor LLM traces and agent operations with Pydantic Logfire:\n\n      1. Get a Logfire token from https:\u002F\u002Flogfire.pydantic.dev\n      2. Add it to your `.env` file:\n      ```bash\n      LOGFIRE_TOKEN=your_token_here\n      ```\n      3. Tracing is automatically initialized when Potpie starts. View traces at https:\u002F\u002Flogfire.pydantic.dev\n\n      **Note:** Set `LOGFIRE_SEND_TO_CLOUD=false` in your `.env` to disable sending traces to Logfire cloud.\n\n3. **Stop Potpie**\n\n   To stop all Potpie services:\n\n   ```bash\n   .\u002Fscripts\u002Fstop.sh\n   ```\n\n   **Windows**\n\n   ```powershell\n   .\u002Fstop.ps1\n   ```\n\n   This will gracefully stop:\n   - The FastAPI application\n   - The Celery worker\n   - All Docker Compose services\n\n## Potpie's Prebuilt Agents\n\nPotpie offers a suite of specialized codebase agents for automating and optimizing key aspects of software development:\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>Debugging Agent\u003C\u002Fh3>\n      \u003Cp>Automatically analyzes stacktraces and provides step-by-step debugging guidance specific to your codebase - not generic advice.\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fpre-built-agents\u002Fdebugging-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"Docs\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>Codebase Q&A Agent\u003C\u002Fh3>\n      \u003Cp>Answers questions about your codebase and explains functions, features, and architecture from first principles.\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fpre-built-agents\u002Fcodebase-qna-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"Docs\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Code Generation Agent\u003C\u002Fh3>\n      \u003Cp>Generates code for new features, refactors existing code, and suggests optimizations grounded in your actual codebase.\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fpre-built-agents\u002Fcodegen-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"Docs\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Spec Agent\u003C\u002Fh3>\n      \u003Cp>Generates detailed software specifications, PRDs, and architecture documents grounded in your codebase.\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fagents\u002Fspecification-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"Docs\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\n### Custom Agents\n\nWith Custom Agents, you can design personalized tools that handle repeatable tasks with precision. Define:\n\n- **System Instructions** - The agent's task, goal, and expected output\n- **Tasks** - Individual steps for job completion\n- **Tools** - Functions for querying the knowledge graph or retrieving code\n\n```bash\ncurl -X POST \"http:\u002F\u002Flocalhost:8001\u002Fapi\u002Fv1\u002Fcustom-agents\u002Fagents\u002Fauto\" \\\n     -H \"Content-Type: application\u002Fjson\" \\\n     -d '{\"prompt\": \"An agent that takes stacktrace as input and gives root cause analysis and proposed solution as output\"}'\n```\n\nRead more in our [documentation](https:\u002F\u002Fdocs.potpie.ai\u002Fopen-source\u002Fagents\u002Fcreate-agent-from-prompt).\n\n\n\n## Use Cases\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>Onboarding\u003C\u002Fh3>\n      \u003Cp>Get new developers productive in hours, not weeks. Potpie maps your architecture, entry points, and setup flows so anyone can hit the ground running.\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>Codebase Q&A\u003C\u002Fh3>\n      \u003Cp>Ask anything about your codebase - functions, data flows, design decisions. Get precise answers grounded in your actual code, not guesses.\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Debugging\u003C\u002Fh3>\n      \u003Cp>Paste a stacktrace. Get a root-cause analysis and step-by-step fix path pinpointed to your code - not generic troubleshooting advice.\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Code Review\u003C\u002Fh3>\n      \u003Cp>Before you merge, understand the blast radius of your changes. Potpie surfaces affected APIs, downstream impacts, and potential regressions.\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Test Generation\u003C\u002Fh3>\n      \u003Cp>Generate unit and integration tests that understand your code structure - not boilerplate. Covers edge cases your manual tests would miss.\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Feature Planning\u003C\u002Fh3>\n      \u003Cp>Turn a requirement or open issue into a low-level implementation plan - with component breakdown, API surface, and suggested code structure.\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fusecases\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FExplore%20All%20Use%20Cases-Docs-22c55e?style=for-the-badge\" alt=\"Explore All Use Cases\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## Extensions & Integrations\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>VSCode Extension\u003C\u002Fh3>\n      \u003Cp>Use Potpie's AI agents directly inside your editor - no tab switching, no copy-pasting. Ask questions, get explanations, and ship code without leaving VSCode.\u003C\u002Fp>\n      \u003Cul>\n        \u003Cli>Agents understand your open repo instantly\u003C\u002Fli>\n        \u003Cli>Works with any codebase - local or remote\u003C\u002Fli>\n      \u003C\u002Ful>\n      \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=PotpieAI.potpie-vscode-extension\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall-VSCode%20Extension-0078d7?style=for-the-badge&logo=visualstudiocode&logoColor=white\" alt=\"Install VSCode Extension\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\u003Ctd>\u003Chr\u002F>\u003C\u002Ftd>\u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Slack Integration\u003C\u002Fh3>\n      \u003Cp>Bring Potpie into your team's Slack workspace. Debug code, answer codebase questions, and get project insights - all in threads your team already uses.\u003C\u002Fp>\n      \u003Cul>\n        \u003Cli>Set up in under 2 minutes\u003C\u002Fli>\n        \u003Cli>Works with your custom configured agents\u003C\u002Fli>\n      \u003C\u002Ful>\n      \u003Ca href=\"https:\u002F\u002Fslack.potpie.ai\u002Fslack\u002Finstall\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAdd%20to-Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white\" alt=\"Add to Slack\"\u002F>\n      \u003C\u002Fa>\n       \n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fextensions\u002Fslack\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSetup-Guide-22c55e?style=for-the-badge\" alt=\"Setup Guide\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\u003Ctd>\u003Chr\u002F>\u003C\u002Ftd>\u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>API Access\u003C\u002Fh3>\n      \u003Cp>Integrate Potpie into CI\u002FCD pipelines and automation workflows via API key. Trigger agents programmatically to fit your existing DevOps setup.\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fagents\u002Fapi-access\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FView-API%20Docs-22c55e?style=for-the-badge\" alt=\"API Docs\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\u003Ctd>\u003Chr\u002F>\u003C\u002Ftd>\u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Custom Tool Integration\u003C\u002Fh3>\n      \u003Cp>Extend Potpie's capabilities by building and registering your own tools. Add files to \u003Ccode>app\u002Fmodules\u002Fintelligence\u002Ftools\u002F\u003C\u002Fcode> and register them in \u003Ccode>tool_service.py\u003C\u002Fcode>.\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\n## Community & Support\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fissues). Best for: bugs and errors you encounter using Potpie.\n- [Discord](https:\u002F\u002Fdiscord.gg\u002Fryk5CMD5v6). Best for: sharing your projects and hanging out with the community.\n- [Email Support](https:\u002F\u002Fpotpie.ai). Best for: problems with your setup or infrastructure.\n\n\nSee the [Contributing Guide](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002F.github\u002FCONTRIBUTING.md) for more details.\n\n## License\n\nThis project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.\n\n## Contributors\n\nThanks for spending your time helping build Potpie. Keep rocking 🥂\n\nWant to contribute? Read the [Contributing Guide](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002F.github\u002FCONTRIBUTING.md) to get started.\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpotpie-ai_potpie_readme_b5e809794df4.png\" alt=\"Contributors\"\u002F>\n\u003C\u002Fa>\n","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fpotpie.ai?utm_source=github\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\".\u002Fassets\u002Freadme_logo_dark.svg\" \u002F>\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\".\u002Fassets\u002Freadme_logo_light.svg\" \u002F>\n      \u003Cimg src=\".\u002Fassets\u002Flogo_light.svg\"  alt=\"Potpie AI logo\" \u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\n# Potpie\n\n[Potpie](https:\u002F\u002Fpotpie.ai) 可以将您的整个代码库转换为一个**知识图谱**——即对每个文件、类和函数的结构化索引，捕捉它们之间的所有关系以及代码各部分在整体上下文中的作用。基于该图谱构建的 AI 代理能够像编写代码的人一样精确地理解并推理您的代码，从调试到功能开发都能胜任。\n\n\n\u003Cp align=\"center\">\n\u003Cimg width=\"700\" alt=\"Potpie 控制面板\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpotpie-ai_potpie_readme_8416dc002086.gif\" \u002F>\n\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-Read-blue?logo=readthedocs&logoColor=white\" alt=\"文档\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002FLICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fpotpie-ai\u002Fpotpie\" alt=\"Apache 2.0\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fpotpie-ai\u002Fpotpie\" alt=\"GitHub 星标\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Fryk5CMD5v6\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join-5865F2?logo=discord&logoColor=white\" alt=\"Discord\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=PotpieAI.potpie-vscode-extension\">\u003Cimg src=\"https:\u002F\u002Fcustom-icon-badges.demolab.com\u002Fbadge\u002FVSCode-Extension-0078d7.svg?logo=vsc&logoColor=white\" alt=\"VSCode 扩展\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\n## 快速入门\n\n### 前置条件\n\n- 已安装并运行 [Docker](https:\u002F\u002Fdocker.com)\n- 已安装 [Git](https:\u002F\u002Fgit-scm.com)\n- 安装了 [Python 3.11+](https:\u002F\u002Fpython.org)，并配备 [uv](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002F)\n\n### 安装步骤\n\n1. **克隆仓库**\n\n   ```bash\n   git clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie.git\n   cd potpie\n   ```\n\n2. **配置环境变量**\n\n   ```bash\n   cp .env.template .env\n   ```\n\n   编辑 `.env` 文件，填写以下必填项：\n\n   ```bash\n   # 应用与环境\n   isDevelopmentMode=enabled\n   ENV=development\n   defaultUsername=defaultuser\n\n   # AI \u002F LLM 配置\n   LLM_PROVIDER=openai                    # openai | ollama | anthropic | openrouter\n   OPENAI_API_KEY=sk-proj-your-key\n   CHAT_MODEL=gpt-4o\n   INFERENCE_MODEL=gpt-4o-mini\n\n   # 数据库\n   POSTGRES_SERVER=postgresql:\u002F\u002Fpostgres:mysecretpassword@localhost:5432\u002Fmomentum\n   NEO4J_URI=bolt:\u002F\u002F127.0.0.1:7687\n   NEO4J_USERNAME=neo4j\n   NEO4J_PASSWORD=mysecretpassword\n\n   # Redis 与后台任务\n   REDISHOST=127.0.0.1\n   REDISPORT=6379\n   BROKER_URL=redis:\u002F\u002F127.0.0.1:6379\u002F0\n   CELERY_QUEUE_NAME=dev\n\n   # 项目与仓库管理\n   PROJECT_PATH=projects\n   ```\n\n   > **`CHAT_MODEL`** 和 **`INFERENCE_MODEL`** 分别用于代理推理和知识图谱生成。模型名称应遵循 [LiteLLM](https:\u002F\u002Fdocs.litellm.ai\u002Fdocs\u002Fproviders) 所要求的 `provider\u002Fmodel_name` 格式。\n\n   > **💡 使用 Ollama？** 将 `LLM_PROVIDER=ollama`，并设置 `CHAT_MODEL=ollama_chat\u002Fqwen2.5-coder:7b` 和 `INFERENCE_MODEL=ollama_chat\u002Fqwen2.5-coder:7b`。\n\n   您可以参考 `.env.template` 查看完整的可选配置列表（日志记录、功能开关、对象存储、邮件、分析等）。\n\n3. **安装依赖**\n\n   ```bash\n   curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n   uv sync\n   ```\n\n4. **启动所有服务**\n\n   ```bash\n   chmod +x scripts\u002Fstart.sh\n   .\u002Fscripts\u002Fstart.sh\n   ```\n\n   这将启动 Docker 服务、应用数据库迁移、启动 FastAPI 应用程序以及 Celery 工作进程。\n\n5. **健康检查**\n\n   ```bash\n   curl -X GET 'http:\u002F\u002Flocalhost:8001\u002Fhealth'\n   ```\n\n6. **查看解析状态**\n\n   ```bash\n   curl -X GET 'http:\u002F\u002Flocalhost:8001\u002Fapi\u002Fv1\u002Fparsing-status\u002Fyour-project-id'\n   ```\n\n要停止所有服务：\n\n```bash\n.\u002Fscripts\u002Fstop.sh\n```\n\n#### 接下来设置 Potpie 前端\n\n```bash\ncd potpie-ui\n\ncp .env.template .env\n\npnpm build && pnpm start\n```\n\n\n---\n\n## 工作原理？\n\nPotpie 会将您的代码仓库解析成一个存储在 Neo4j 中的**知识图谱**，其中包含每个文件、函数、类及其相互之间的关系。代理可以直接从该图谱中读取信息，从而根据您实际的代码回答问题或完成任务。\n\n**架构图**\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\".\u002Fassets\u002Farchitecture.svg\" alt=\"Potpie 架构\" width=\"900\"\u002F>\n\u003C\u002Fp>\n\n- [**FastAPI**](https:\u002F\u002Ffastapi.tiangolo.com\u002F) 作为 API 层——所有请求通过 `localhost:8001` 进入，支持 CORS、Logfire 跟踪，并可选集成 Sentry 错误监控。\n- [**Firebase Auth**](https:\u002F\u002Ffirebase.google.com\u002Fdocs\u002Fauth) 负责生产环境的身份验证。在开发模式下，本地会创建一个虚拟用户，无需 Firebase。\n- [**Celery Worker**](https:\u002F\u002Fdocs.celeryq.dev\u002F) 结合 [Redis](https:\u002F\u002Fredis.io\u002F) 作为消息代理，负责异步解析代码库——克隆、AST 提取和知识图谱构建都在后台进行。\n- [**Conversation Service**](https:\u002F\u002Fdocs.potpie.ai\u002Fconversations) 管理多轮对话中的聊天会话及代理记忆。\n- [**Agent Router**](https:\u002F\u002Fdocs.potpie.ai\u002Fagents\u002Fintroduction) 根据意图将提示分发给合适的预构建或自定义代理。\n- [**Tool Service**](https:\u002F\u002Fdocs.potpie.ai\u002Ftools) 向代理暴露可调用的功能——代码搜索、文件获取、知识图谱查询、网络工具等。\n- [**Neo4j Knowledge Graph**](https:\u002F\u002Fneo4j.com\u002F) 以属性图的形式存储您的代码库——函数、类、文件、导入关系及调用关系，是所有代理上下文的核心。\n- [**PostgreSQL**](https:\u002F\u002Fwww.postgresql.org\u002F) 存储用户、项目、对话记录及消息历史。\n\n\n## GitHub 身份验证\n\n\n| 方法 | 配置 | 适用场景 |\n|--------|--------------|----------|\n| **GitHub App** | `GITHUB_APP_ID`, `GITHUB_PRIVATE_KEY` | 生产环境 |\n| **PAT 池** | `GH_TOKEN_LIST=ghp_token1,ghp_token2` | 开发环境 \u002F 更高速率限制 |\n| **未认证** | 无需配置 | 仅限公开仓库（60 请求\u002F小时） |\n\n通过设置 `GITHUB_AUTH_MODE` 为 `app`、`pat` 或 `none` 来选择相应的方法。\n\n---\n\n## 自托管 Git 服务提供商\n\n对于自托管的 Git 服务器（例如 GitBucket、GitLab 等），请进行如下配置：\n\n      \n      uv sync\n    \n\n这将创建一个 `.venv` 目录，并从 `pyproject.toml` 中安装所有依赖项。\n\n#### GitHub 身份验证设置\n\nPotpie 支持多种身份验证方法来访问 GitHub 仓库：\n\n##### 对于 GitHub.com 仓库：\n\n**选项 1：GitHub 应用程序（推荐用于生产环境）**\n  - 在您的组织中创建一个 GitHub 应用程序\n  - 设置环境变量：\n    ```bash\n    GITHUB_APP_ID=your-app-id\n    GITHUB_PRIVATE_KEY=your-private-key\n    ```\n\n**选项 2：个人访问令牌池**\n  - 创建一个或多个具有 `repo` 范围的 GitHub PAT\n  - 设置环境变量（多个令牌用逗号分隔）：\n    ```bash\n    GH_TOKEN_LIST=ghp_token1,ghp_token2,ghp_token3\n    ```\n  - Potpie 将从令牌池中随机选择以实现负载均衡\n  - **速率限制**：每个令牌每小时 5,000 次请求（已认证）\n\n**选项 3：未认证访问（仅限公共仓库）**\n  - 无需配置\n  - 自动作为公共仓库的后备方案\n  - **速率限制**：每个 IP 每小时 60 次请求（非常有限）\n\n##### 对于自托管 Git 服务器（GitBucket、GitLab 等）：\n\n      设置以下环境变量：\n      \n    \n      CODE_PROVIDER=github   # 选项：github、gitbucket\n      CODE_PROVIDER_BASE_URL=http:\u002F\u002Fyour-git-server.com\u002Fapi\u002Fv3\n      CODE_PROVIDER_TOKEN=your-token\n    \n\n**重要提示**：无论 `CODE_PROVIDER_BASE_URL` 如何设置，`GH_TOKEN_LIST` 中的令牌始终用于 GitHub.com。\n\n2. **启动 Potpie**\n\n   要启动所有 Potpie 服务：\n\n   ```bash\n   chmod +x scripts\u002Fstart.sh\n   .\u002Fscripts\u002Fstart.sh\n   ```\n\n   这将：\n   - 启动所需的 Docker 服务\n   - 等待 PostgreSQL 准备就绪\n   - 应用数据库迁移\n   - 启动 FastAPI 应用程序\n   - 启动 Celery 工作器\n\n    **可选：Logfire 追踪设置**\n\n      若要使用 Pydantic Logfire 监控 LLM 跟踪和代理操作：\n\n      1. 从 https:\u002F\u002Flogfire.pydantic.dev 获取 Logfire 令牌\n      2. 将其添加到你的 `.env` 文件中：\n      ```bash\n      LOGFIRE_TOKEN=your_token_here\n      ```\n      3. Potpie 启动时会自动初始化追踪功能。你可以在 https:\u002F\u002Flogfire.pydantic.dev 查看追踪记录。\n\n      **注意**：在你的 `.env` 文件中设置 `LOGFIRE_SEND_TO_CLOUD=false` 可以禁用向 Logfire 云端发送追踪数据。\n\n3. **停止 Potpie**\n\n   要停止所有 Potpie 服务：\n\n   ```bash\n   .\u002Fscripts\u002Fstop.sh\n   ```\n\n   **Windows**\n\n   ```powershell\n   .\u002Fstop.ps1\n   ```\n\n   这将优雅地停止：\n   - FastAPI 应用程序\n   - Celery 工作器\n   - 所有 Docker Compose 服务\n\n## Potpie 的预构建代理\n\nPotpie 提供了一系列专门的代码库代理，用于自动化和优化软件开发的关键方面：\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>调试代理\u003C\u002Fh3>\n      \u003Cp>自动分析堆栈跟踪，并根据您的代码库提供逐步调试指导——而不是通用建议。\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fpre-built-agents\u002Fdebugging-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"文档\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>代码库问答代理\u003C\u002Fh3>\n      \u003Cp>回答有关您代码库的问题，并从基本原理出发解释函数、特性及架构。\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fpre-built-agents\u002Fcodebase-qna-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"文档\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>代码生成代理\u003C\u002Fh3>\n      \u003Cp>为新功能生成代码、重构现有代码，并基于您实际的代码库提出优化建议。\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fpre-built-agents\u002Fcodegen-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"文档\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>规格代理\u003C\u002Fh3>\n      \u003Cp>根据您的代码库生成详细的软件规格说明、PRD 和架构文档。\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fagents\u002Fspecification-agent\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLearn%20More-Docs-22c55e?style=flat-square\" alt=\"文档\"\u002F>\u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\n### 自定义代理\n\n借助自定义代理，您可以设计个性化的工具，以精确处理重复性任务。定义：\n\n- **系统指令** - 代理的任务、目标和预期输出\n- **任务** - 完成工作所需的各个步骤\n- **工具** - 用于查询知识图谱或检索代码的函数\n\n```bash\ncurl -X POST \"http:\u002F\u002Flocalhost:8001\u002Fapi\u002Fv1\u002Fcustom-agents\u002Fagents\u002Fauto\" \\\n     -H \"Content-Type: application\u002Fjson\" \\\n     -d '{\"prompt\": \"一个以堆栈跟踪为输入，输出根本原因分析和解决方案的代理\"}'\n```\n\n更多内容请参阅我们的[文档](https:\u002F\u002Fdocs.potpie.ai\u002Fopen-source\u002Fagents\u002Fcreate-agent-from-prompt)。\n\n\n\n## 使用场景\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>入职培训\u003C\u002Fh3>\n      \u003Cp>让新开发者在数小时内就能高效工作，而不是几周。Potpie 会映射您的架构、入口点和设置流程，使任何人都能快速上手。\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\" width=\"50%\">\n      \u003Ch3>代码库问答\u003C\u002Fh3>\n      \u003Cp>关于您的代码库，无论是函数、数据流还是设计决策，都可以随时提问。您将获得基于实际代码的精准答案，而非猜测。\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>调试\u003C\u002Fh3>\n      \u003Cp>粘贴堆栈跟踪信息，即可获得针对您代码的根本原因分析和逐步修复方案——而不是通用的故障排除建议。\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>代码审查\u003C\u002Fh3>\n      \u003Cp>在合并代码之前，了解您的更改可能带来的影响范围。Potpie 会展示受影响的 API、下游影响以及潜在的回归问题。\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>测试生成\u003C\u002Fh3>\n      \u003Cp>生成能够理解您的代码结构的单元测试和集成测试——而不是千篇一律的模板。这些测试可以覆盖手动测试遗漏的边缘情况。\u003C\u002Fp>\n    \u003C\u002Ftd>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>功能规划\u003C\u002Fh3>\n      \u003Cp>将需求或开放问题转化为低层级的实施计划——包括组件分解、API 接口以及建议的代码结构。\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fusecases\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FExplore%20All%20Use%20Cases-Docs-22c55e?style=for-the-badge\" alt=\"探索所有使用场景\"\u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 扩展与集成\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>VSCode 扩展\u003C\u002Fh3>\n      \u003Cp>直接在你的编辑器中使用 Potpie 的 AI 助手——无需切换标签页，也不用复制粘贴。在不离开 VSCode 的情况下，提问、获取解释并完成代码提交。\u003C\u002Fp>\n      \u003Cul>\n        \u003Cli>助手能够即时理解你当前打开的代码库\u003C\u002Fli>\n        \u003Cli>适用于任何本地或远程代码库\u003C\u002Fli>\n      \u003C\u002Ful>\n      \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=PotpieAI.potpie-vscode-extension\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall-VSCode%20Extension-0078d7?style=for-the-badge&logo=visualstudiocode&logoColor=white\" alt=\"安装 VSCode 扩展\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\u003Ctd>\u003Chr\u002F>\u003C\u002Ftd>\u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>Slack 集成\u003C\u002Fh3>\n      \u003Cp>将 Potpie 引入你团队的 Slack 工作区。在团队已有的聊天线程中进行代码调试、解答代码库相关问题以及获取项目洞察。\u003C\u002Fp>\n      \u003Cul>\n        \u003Cli>不到两分钟即可完成设置\u003C\u002Fli>\n        \u003Cli>支持你自定义配置的助手\u003C\u002Fli>\n      \u003C\u002Ful>\n      \u003Ca href=\"https:\u002F\u002Fslack.potpie.ai\u002Fslack\u002Finstall\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAdd%20to-Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white\" alt=\"添加到 Slack\"\u002F>\n      \u003C\u002Fa>\n       \n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fextensions\u002Fslack\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSetup-Guide-22c55e?style=for-the-badge\" alt=\"设置指南\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\u003Ctd>\u003Chr\u002F>\u003C\u002Ftd>\u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>API 访问\u003C\u002Fh3>\n      \u003Cp>通过 API 密钥将 Potpie 集成到 CI\u002FCD 流水线和自动化工作流中。以编程方式触发助手，以适应你现有的 DevOps 环境。\u003C\u002Fp>\n      \u003Ca href=\"https:\u002F\u002Fdocs.potpie.ai\u002Fagents\u002Fapi-access\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FView-API%20Docs-22c55e?style=for-the-badge\" alt=\"API 文档\"\u002F>\n      \u003C\u002Fa>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\u003Ctd>\u003Chr\u002F>\u003C\u002Ftd>\u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd valign=\"top\">\n      \u003Ch3>自定义工具集成\u003C\u002Fh3>\n      \u003Cp>通过构建并注册你自己的工具来扩展 Potpie 的功能。将文件放入 \u003Ccode>app\u002Fmodules\u002Fintelligence\u002Ftools\u002F\u003C\u002Fcode> 目录，并在 \u003Ccode>tool_service.py\u003C\u002Fcode> 中进行注册。\u003C\u002Fp>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n\n## 社区与支持\n\n- [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fissues)。适合：你在使用 Potpie 时遇到的 bug 和错误。\n- [Discord](https:\u002F\u002Fdiscord.gg\u002Fryk5CMD5v6)。适合：分享你的项目并与社区交流。\n- [电子邮件支持](https:\u002F\u002Fpotpie.ai)。适合：关于你的设置或基础设施的问题。\n\n\n更多详情请参阅 [贡献指南](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002F.github\u002FCONTRIBUTING.md)。\n\n## 许可证\n\n本项目采用 Apache 2.0 许可证授权——详细信息请参阅 [LICENSE](LICENSE) 文件。\n\n## 贡献者\n\n感谢你抽出时间帮助构建 Potpie。继续加油 🥂\n\n想参与贡献吗？请阅读 [贡献指南](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002F.github\u002FCONTRIBUTING.md)，开始行动吧。\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpotpie-ai_potpie_readme_b5e809794df4.png\" alt=\"贡献者\"\u002F>\n\u003C\u002Fa>","# Potpie 快速上手指南\n\nPotpie 能将你的整个代码库转化为**知识图谱**（Knowledge Graph），构建包含所有文件、类、函数及其相互关系的结构索引。基于此图谱，AI Agent 能够像代码作者一样精准地理解上下文，从而执行调试、功能开发等任务。\n\n## 环境准备\n\n在开始之前，请确保你的系统满足以下要求：\n\n*   **操作系统**：Linux \u002F macOS \u002F Windows (需支持 Docker)\n*   **Docker**：已安装并正在运行（用于启动数据库和中间件服务）\n*   **Git**：已安装\n*   **Python**：版本 3.11 或更高\n*   **uv**：Python 包管理工具（推荐用于快速安装依赖）\n    *   安装命令：`curl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh`\n*   **Node.js & pnpm**：用于构建前端界面（可选，仅当需要运行 UI 时）\n\n## 安装步骤\n\n### 1. 克隆项目\n```bash\ngit clone --recurse-submodules https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie.git\ncd potpie\n```\n\n### 2. 配置环境变量\n复制模板文件并编辑配置：\n```bash\ncp .env.template .env\n```\n\n使用编辑器打开 `.env` 文件，修改以下关键配置：\n\n```bash\n# 应用模式\nisDevelopmentMode=enabled\nENV=development\ndefaultUsername=defaultuser\n\n# AI \u002F LLM 配置 (以 OpenAI 为例)\nLLM_PROVIDER=openai                    # 支持：openai, ollama, anthropic, openrouter\nOPENAI_API_KEY=sk-proj-your-key        # 填入你的 API Key\nCHAT_MODEL=gpt-4o                      # 用于对话推理\nINFERENCE_MODEL=gpt-4o-mini            # 用于知识图谱生成\n\n# 如果使用 Ollama (本地模型)，配置如下：\n# LLM_PROVIDER=ollama\n# CHAT_MODEL=ollama_chat\u002Fqwen2.5-coder:7b\n# INFERENCE_MODEL=ollama_chat\u002Fqwen2.5-coder:7b\n\n# 数据库配置 (通常无需修改，除非端口冲突)\nPOSTGRES_SERVER=postgresql:\u002F\u002Fpostgres:mysecretpassword@localhost:5432\u002Fmomentum\nNEO4J_URI=bolt:\u002F\u002F127.0.0.1:7687\nNEO4J_USERNAME=neo4j\nNEO4J_PASSWORD=mysecretpassword\n\n# Redis 配置\nREDISHOST=127.0.0.1\nREDISPORT=6379\nBROKER_URL=redis:\u002F\u002F127.0.0.1:6379\u002F0\nCELERY_QUEUE_NAME=dev\n\n# 项目路径\nPROJECT_PATH=projects\n```\n\n### 3. 安装后端依赖\n使用 `uv` 同步安装 Python 依赖：\n```bash\nuv sync\n```\n\n### 4. 启动服务\n赋予脚本执行权限并启动所有服务（包括 Docker 容器、数据库迁移、FastAPI 应用和 Celery _worker_）：\n```bash\nchmod +x scripts\u002Fstart.sh\n.\u002Fscripts\u002Fstart.sh\n```\n\n> **注意**：首次启动可能需要几分钟时间等待数据库就绪和完成迁移。\n\n### 5. (可选) 启动前端界面\n如果需要图形化界面，请进入前端目录并启动：\n```bash\ncd potpie-ui\ncp .env.template .env\npnpm build && pnpm start\n```\n\n## 基本使用\n\n### 1. 健康检查\n确认后端服务是否正常运行：\n```bash\ncurl -X GET 'http:\u002F\u002Flocalhost:8001\u002Fhealth'\n```\n如果返回正常响应，说明服务已就绪。\n\n### 2. 配置 GitHub 访问权限\nPotpie 需要访问你的代码仓库来构建图谱。根据需求在 `.env` 中选择一种认证方式：\n\n*   **方式 A：GitHub App (生产环境推荐)**\n    设置 `GITHUB_APP_ID` 和 `GITHUB_PRIVATE_KEY`。\n*   **方式 B：Personal Access Token (开发推荐)**\n    创建具有 `repo` 权限的 Token，并在 `.env` 中设置：\n    ```bash\n    GITHUB_AUTH_MODE=pat\n    GH_TOKEN_LIST=ghp_your_token_here\n    ```\n*   **方式 C：无认证 (仅限公开仓库)**\n    无需配置，但速率限制为每小时 60 次请求。\n\n对于自建 Git 服务器 (如 GitLab\u002FGitBucket)，需额外设置：\n```bash\nCODE_PROVIDER=github\nCODE_PROVIDER_BASE_URL=http:\u002F\u002Fyour-git-server.com\u002Fapi\u002Fv3\nCODE_PROVIDER_TOKEN=your-token\n```\n\n### 3. 检查解析状态\n当你通过 API 或前端添加项目后，可以使用以下命令检查代码库的解析和图谱构建进度（将 `your-project-id` 替换为实际 ID）：\n```bash\ncurl -X GET 'http:\u002F\u002Flocalhost:8001\u002Fapi\u002Fv1\u002Fparsing-status\u002Fyour-project-id'\n```\n\n### 4. 开始对话\n服务启动并解析完成后，你可以：\n*   **通过前端界面**：访问 `http:\u002F\u002Flocalhost:3000` (默认前端端口) 进行对话。\n*   **通过 API**：调用预置 Agent 进行代码问答、调试分析或代码生成。\n\n例如，创建一个自定义 Agent 进行堆栈跟踪分析：\n```bash\ncurl -X POST \"http:\u002F\u002Flocalhost:8001\u002Fapi\u002Fv1\u002Fcustom-agents\u002Fagents\u002Fauto\" \\\n     -H \"Content-Type: application\u002Fjson\" \\\n     -d '{\"prompt\": \"An agent that takes stacktrace as input and gives root cause analysis and proposed solution as output\"}'\n```\n\n### 停止服务\n如需停止所有服务：\n```bash\n.\u002Fscripts\u002Fstop.sh\n```\n*(Windows PowerShell 用户请使用 `.\u002Fstop.ps1`)*","某电商平台的后端团队需要在拥有百万行代码的遗留系统中，紧急修复一个涉及订单、库存和支付模块的深层耦合 Bug。\n\n### 没有 potpie 时\n- 开发人员需手动翻阅数十个文件，依靠记忆或全局文本搜索拼凑调用链路，极易遗漏间接依赖。\n- 修改核心逻辑时因无法预判影响范围，导致“修好一个 Bug 引出三个新 Bug\"的回归问题频发。\n- 新入职成员面对复杂的代码迷宫无从下手，理解业务逻辑往往需要数周时间的摸索与请教。\n- AI 辅助编程工具因缺乏整体上下文，只能提供片段级建议，经常产生幻觉或错误的重构方案。\n\n### 使用 potpie 后\n- potpie 将整个代码库转化为知识图谱，自动梳理出从订单创建到库存扣减的完整调用链，精准定位故障点。\n- 基于图谱的推理能力让 potpie 能预先分析变更影响面，明确指出哪些测试用例必须执行，大幅降低回归风险。\n- 新人可直接向 potpie 提问“支付失败如何触发库存回滚”，获得包含具体文件跳转的结构化解释，上手时间缩短至几天。\n- 构建在图谱之上的 AI Agent 具备“作者级”理解力，能生成符合项目架构规范的完整修复代码而非零散片段。\n\npotpie 通过将静态代码转化为动态知识图谱，让开发团队在超大型项目中拥有了上帝视角般的精准掌控力。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fpotpie-ai_potpie_8416dc00.gif","potpie-ai","potpie.ai","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fpotpie-ai_4b152f79.png","Potpie provides codebase agents for Q&A, debugging, low level design, test planning and coding. Create task-oriented custom Agents for your codebase in minutes.",null,"hello@potpie.ai","potpiedotai","https:\u002F\u002Fpotpie.ai\u002F","https:\u002F\u002Fgithub.com\u002Fpotpie-ai",[83,87,91,95,99,103,107],{"name":84,"color":85,"percentage":86},"Python","#3572A5",98.2,{"name":88,"color":89,"percentage":90},"Tree-sitter Query","#8ea64c",0.7,{"name":92,"color":93,"percentage":94},"Rust","#dea584",0.5,{"name":96,"color":97,"percentage":98},"Shell","#89e051",0.4,{"name":100,"color":101,"percentage":102},"Dockerfile","#384d54",0.2,{"name":104,"color":105,"percentage":106},"Mako","#7e858d",0,{"name":108,"color":109,"percentage":106},"PowerShell","#012456",5334,602,"2026-04-19T18:27:06","Apache-2.0",4,"Linux, macOS, Windows","未说明",{"notes":118,"python":119,"dependencies":120},"该工具主要基于 Docker 运行，需安装 Docker、Git 和 uv 包管理器。核心组件包括用于知识图谱的 Neo4j、关系型数据库 PostgreSQL 以及消息队列 Redis。支持多种 LLM 提供商（OpenAI, Ollama, Anthropic 等），若使用本地模型（如 Ollama）则对本地硬件有相应要求，但 README 未明确具体 GPU 或内存数值。前端需使用 pnpm 构建。","3.11+",[121,122,123,124,125,126,127,128,129],"FastAPI","Celery","Redis","PostgreSQL","Neo4j","uv","LiteLLM","Firebase Auth","Pydantic Logfire",[13,14,16],[132,133,134,135,136,137,138,139,140],"agents","artificial-intelligence","developer-tools","generative-ai","knowledge-graph","rag","ai-agents","ai-agents-framework","devtools","2026-03-27T02:49:30.150509","2026-04-20T12:54:36.704209",[144,149,154,158,163,168],{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},44699,"如何在本地开发模式下运行项目而不依赖第三方服务（如 Firebase、GitHub API）？","可以通过启用 `isDevelopmentMode` 标志来禁用第三方服务。具体配置包括：\n1. 确保环境变量 `ENV='development'`。\n2. 认证服务将使用模拟认证，返回 `{\"user_id\": os.getenv(\"defaultUsername\")}`。\n3. Provider 服务会绕过 Portkey 直接初始化 ChatOpenAI 或 ChatAnthropic。\n4. GitHub 服务将改为读取本地仓库结构和 Neo4j 节点中的 'text' 键，而非调用 GitHub API。\n5. 密钥管理将改用环境变量。\n相关功能已在 PR #195 中实现，请参考该 PR 进行测试。","https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fissues\u002F174",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},44700,"使用 Azure OpenAI API Key 时应该如何配置模型？","需要在 `provider_service.py` 的 `MODEL_CONFIGS` 中指定 `AzureChatOpenAI` 类，并配置以下参数：\n- `openai_api_base`: 对应环境变量 `AZURE_ENDPOINT`\n- `openai_api_version`: 对应 `AZURE_API_VERSION`\n- `openai_api_key`: 对应 `AZURE_API_KEY`\n- `deployment_name`: 对应 `AZURE_DEPLOYMENT_NAME`\n- `openai_api_type`: 设置为 \"azure\"\n如果遇到问题，请检查是否已提交相关修复 PR（如 PR #288）。","https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fissues\u002F279",{"id":155,"question_zh":156,"answer_zh":157,"source_url":153},44701,"为什么使用小型本地大语言模型（如 Ollama 运行的 7B 模型）时会出现幻觉或工具调用不准确？","小型本地模型（如 deepseek-r1:latest 7b 或 llama3.2:latest）可能因上下文理解能力有限，导致工具调用不准确或产生幻觉（例如虚构不存在的文件路径）。\n维护者建议：\n1. 查看详细日志以定位具体错误原因。\n2. 尝试使用托管版本的模型（hosted versions），它们在系统中表现更好。\n3. 确保提供的上下文信息足够清晰，减少模型猜测的可能性。",{"id":159,"question_zh":160,"answer_zh":161,"source_url":162},44702,"克隆仓库时遇到错误或卡住不动怎么办？","如果克隆仓库时出现错误或状态一直停留在 \"submitted\" 或 \"parsing\"：\n1. 这可能是由 GitHub 侧的临时故障触发的边缘情况，通常稍后重试即可恢复正常。\n2. 如果状态卡在解析（parsing），请耐心等待一段时间，有时处理大型仓库需要较长时间。\n3. 如果问题持续存在，请尝试重新克隆并联系维护者提供详细日志。","https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fissues\u002F456",{"id":164,"question_zh":165,"answer_zh":166,"source_url":167},44703,"当遇到 \"Context length exceeded\"（上下文长度超限）错误导致 LLM 卡住时该如何解决？","当日志显示 \"Context length exceeded. Summarizing content to fit the model context window.\" 且 LLM 卡在调用 OpenAI API 步骤时：\n1. 系统通常会尝试自动总结内容以适应模型的上下文窗口。\n2. 如果仍然卡住，可能是自动总结机制未生效或陷入循环。建议检查 LiteLLM 的完整日志输出。\n3. 尝试减小输入内容的规模，或手动对代码库进行预筛选以减少 token 数量。","https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fissues\u002F315",{"id":169,"question_zh":170,"answer_zh":171,"source_url":172},44704,"如何为 Anthropic 模型优化分类和 Agent 任务的提示词（Prompts）？","原有的提示词是为其他模型设计的，在 Anthropic 模型上表现不佳。优化步骤包括：\n1. 审查并更新分类提示词以兼容 Anthropic。\n2. 修改 Agent 任务描述以匹配 Anthropic 的能力特点。\n3. 使用 Anthropic 模型测试更新后的提示词效果。\n4. 记录表现良好的 Anthropic 专用提示词模式。\n注意：这是一个临时解决方案，未来将集成到基于模型名称的动态提示注入系统（Issue #189）中。","https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fissues\u002F211",[174,179,184,189,194,199,204,209,214,219,224,229,234,239,244,249],{"id":175,"version":176,"summary_zh":177,"released_at":178},352141,"v0.1.1","🔀 多大模型支持！\n\n## 变更内容\n* 补丁：@nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F272 中将 transformers 更新至 4.48.0\n* 更新 pre-commit 以自动修复代码风格检查：@dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F271 中完成\n* 多大模型支持：@dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F274 中实现\n* 扩展 fetch_parsing_status 功能：@kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F273 中完成\n* 更新提供商处理逻辑：@dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F280 中完成\n* 适用于 CPU 的句子转换器：@kanavfarishta 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F281 中实现\n* 添加表格检查功能：@dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F282 中完成\n* 修复 crewai llm 中的提供商参数问题：@dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F283 中完成\n* 移除 openrrouter 提供商参数：@dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F284 中完成\n* 支持 3.7 版本的 Sonnet：@dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F285 中完成\n\n## 新贡献者\n* @kanavfarishta 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F281 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.1.0...v0.1.1","2025-02-25T20:10:49",{"id":180,"version":181,"summary_zh":182,"released_at":183},352142,"v0.1.0","🤖 自定义智能体上线啦——自定义智能体创建模块现已开源！\n\n### 通过简单提示创建自定义智能体：\n只需使用简洁明了的提示，就能将您的想法转化为功能强大的AI智能体。无需博士学位！为您的独特应用场景设计专属智能体，见证它们栩栩如生地运行起来。\n\n## 变更内容\n* 修复：分类器不应选择自定义智能体 —— @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F262 中完成\n* 自定义智能体 —— @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F263 中实现\n* LocalRepoService 相关修复 —— @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F266 中完成\n* 自定义智能体迁移的 Alembic 更新及 README 文件修改 —— @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F270 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.0.6...v0.1.0","2025-02-19T12:38:32",{"id":185,"version":186,"summary_zh":187,"released_at":188},352143,"v0.0.6","## What's Changed\r\n* Add api access details to readme by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F228\r\n* Updated Documentation for Production Setup by @kinshuksinghbist in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F229\r\n* Deepseek R1 integration for Agent Interactions  by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F236\r\n* Pin dependencies by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F237\r\n* Update fastapi requirement by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F238\r\n* Fix model name for deepseek in crewai by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F239\r\n* fix: anthropic prompts (issue #211) by @simin75simin in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F230\r\n* Update custom agent API and payload by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F242\r\n* avoiding creation of multiple agent nodes to improve latency by @kinshuksinghbist in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F243\r\n* Fix github api pagination by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F247\r\n* Update fetch user repo logic by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F248\r\n* Update celery config by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F253\r\n* Feat\u002Fdirect message api by @nndn in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F252\r\n* fix: collect message from stream by @nndn in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F245\r\n* Firecrawl tool for accessing web pages  by @kinshuksinghbist in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F251\r\n* Add github issues and PR tool by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F257\r\n* Handle public repos fallback in Github Tool by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F259\r\n\r\n## New Contributors\r\n* @kinshuksinghbist made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F229\r\n* @simin75simin made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F230\r\n* @nndn made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F252\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.0.5...v0.0.6","2025-02-13T16:20:15",{"id":190,"version":191,"summary_zh":192,"released_at":193},352144,"v0.0.5","## What's Changed\r\n* Update readme by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F225\r\n* Basic API key setup with core APIs by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F226\r\n* Route directly to custom agents by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F227\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.0.4...v0.0.5","2025-01-14T15:54:38",{"id":195,"version":196,"summary_zh":197,"released_at":198},352145,"v0.0.4","## What's Changed\r\n* Parsing support: Only XML\u002FMarkdown files in repo by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F212\r\n* Streaming and Agent Routing using langgraph by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F213\r\n* Update langgraph version by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F214\r\n* Update EOL check in response by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F215\r\n* Handle response format in agent classifier by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F216\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.0.3...v0.0.4","2024-12-21T07:21:45",{"id":200,"version":201,"summary_zh":202,"released_at":203},352146,"v0.0.3","## What's Changed\r\n* Add agentstack and formbricks to demo project list by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F199\r\n* Update email copy by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F200\r\n* Update add column query by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F201\r\n* Debugging agent double response fix by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F202\r\n* update demo projects when stale by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F204\r\n* Dedup user repo list by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F205\r\n* Support for anthropic, req pinning by @vineetshar in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F203\r\n* feat: Adding usage apis by @vineetshar in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F206\r\n* Update GETTING_STARTED.md by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F209\r\n* Enhanced java parsing support by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F210\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.0.2...v0.0.3","2024-12-13T13:22:39",{"id":205,"version":206,"summary_zh":207,"released_at":208},352147,"v0.0.2","## What's Changed\r\n* Feat: Support for custom agents by @vineetshar in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F181\r\n* Code Generation Agent by @dhirenmathur in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F184\r\n* added public repo support by @GodReaper in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F144\r\n* feat: initial changes for support for isDevelopmentMode=enabled by @waveywaves in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F192\r\n* feat: public user profile pic by @Yash-pede in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F177\r\n* Add Support For Parsing Local Code Repos by @vineetshar in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F190\r\n\r\n## New Contributors\r\n* @waveywaves made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F192\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.0.1...v0.0.2","2024-11-29T13:37:23",{"id":210,"version":211,"summary_zh":212,"released_at":213},352148,"v0.0.1","## What's Changed\r\n\r\nWe are excited to announce the first official release of Potpie, a Prompt-To-Agent platform designed to understand your codebase, and provide the tooling required by the agents to accomplish any engineering task.\r\n\r\n**Key Features:**\r\n\r\n- **Comprehensive Codebase Analysis:** Potpie constructs a detailed knowledge graph of your codebase, capturing relationships between functions, classes, and files to facilitate intelligent code analysis and manipulation.\r\n\r\n- **Pre-built AI Agents:** Utilize specialized agents to automate common engineering tasks:\r\n  - *Debugging Agent:* Analyzes stack traces and provides tailored debugging steps.\r\n  - *Codebase Q&A Agent:* Answers questions about your codebase, explaining functions, features, setup and architecture.\r\n  - *Code Changes Agent:* Evaluates code changes, identifies blast radius of changes, and suggests improvements.\r\n  - *Integration Test Agent:* Generates integration test plans and code to ensure component compatibility.\r\n  - *Unit Test Agent:* Creates unit test plans and code to enhance test coverage.\r\n  - *Low-Level Design (LLD) Agent:* Develops low-level designs for new features based on functional requirements.\r\n\r\n- **Custom Agent Development Platform:** Beyond pre-built agents, Potpie offers a platform to create custom agents tailored to your project's unique needs, enabling automation of specific, repeatable tasks.\r\n\r\n- **Extensible Tooling System:** Potpie provides a set of tools that agents can use to interact with the knowledge graph and the underlying infrastructure. These tools are vital for creating custom agents and for performing highly contextual tasks with precision. The available tools include:\r\n  - *get_code_from_probable_node_name:* Retrieves code snippets based on a probable node name from the knowledge graph.\r\n  - *get_code_from_node_id:* Fetches code snippets associated with a specific node ID.\r\n  - *get_code_from_multiple_node_ids:* Allows retrieval of code snippets for multiple node IDs simultaneously.\r\n  - *ask_knowledge_graph_queries:* Executes vector similarity search queries against the knowledge graph to obtain relevant information.\r\n  - *get_nodes_from_tags:* Retrieves nodes that are associated with specific tags in the knowledge graph.\r\n  - *get_code_from_node_name:* Obtains code snippets linked to a specific node name.\r\n  - *get_code_graph_from_node_id:* Fetches the code graph structure related to a particular node ID (works best with Python, JavaScript, TypeScript).\r\n  - *get_code_graph_from_node_name:* Retrieves the code graph structure associated with a specific node name (works best with Python, JavaScript, TypeScript).\r\n  - *change_detection:* Detects changes in the current branch with respect to the default branch of the repository and retrieves updated function details.\r\n\r\n**Getting Started:**\r\n\r\nTo begin using Potpie, refer to the [Getting Started Guide](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002FGETTING_STARTED.md) and the [README](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002Freadme.md) for detailed setup instructions and usage guidelines.\r\n\r\n## Contributing:\r\n\r\nWe welcome contributions from the community. Please review our [Contributing Guidelines](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fblob\u002Fmain\u002Fcontributing.md) for information on how to get involved.\r\n\r\n## New Contributors\r\n* @vineetshar made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F1\r\n* @dhirenmathur made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F5\r\n* @Yash-pede made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F7\r\n* @GodReaper made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F13\r\n* @eltociear made their first contribution in https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F182\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcommits\u002F0.0.1","2024-11-22T14:15:46",{"id":215,"version":216,"summary_zh":217,"released_at":218},352140,"v0.1.2","Potpie 的 UI 开源啦！\n\n## 变更内容\n* 修复：@nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F287 中实现的 get_custom_aget\n* @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F294 中更新了 README.md\n* @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F296 中修复了因共享聊天导致的 API 认证问题\n* @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F300 中修复了开发模式下的 bug\n* @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F297 中添加了 UI 子模块\n* @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F302 中更新了 UI 子模块的提交\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.1.1...v0.1.2","2025-03-09T14:15:00",{"id":220,"version":221,"summary_zh":222,"released_at":223},352133,"v1.0.1","## 变更内容\n* 由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F624 中更新了演示项目列表\n* 由 @shmbhvi101 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F621 中为仓库应用了分页功能\n* 由 @ASCE-D 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F623 中添加了解析失败的邮件告警\n* 由 @kshitij2040 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F625 中更改了链接并添加了 Spec 代理\n* 由 @shmbhvi101 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F597 中新增了 Spec Gen 代理\n* 由 @ASCE-D 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F650 中改进了代码生成代理，使其能够将更改写入工作树，并修复了 PR 创建工具无法获取必要上下文以创建 PR 的问题\n* 由 @ASCE-D 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F663 中重构了 update_file_lines_tool 和 show_diff_tool，以改善错误处理…\n* 由 @ASCE-D 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F664 中进行了修复和代码修改\n* 由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F673 中修复并修改了代码变更管理器\n* 由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F685 中进行了异步修复\n* 由 @shmbhvi101 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F679 中实现了在本地生成 API 密钥的功能，通过回退到本地密钥加密环境变量来实现\n* 由 @yashkrishan 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F672 中修复了 Neo4j 泄漏和 httpx 监控问题\n* 由 @yashkrishan 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F680 中测试：添加了测试套件结构、解析测试、自动化测试以及压力测试\n* 由 @yashkrishan 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F694 中修复了测试套件和运行脚本\n* 由 @Harigithub11 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F696 中修复了 Vanta 中等严重程度的漏洞\n* 由 @yashkrishan 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F695 中完成了杂项工作：设定了 50% 的覆盖率目标，并设置了 PR 回归门控\n* 由 @yashkrishan 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F697 中修复了解析相关问题：避免了在 setup_project_directory 中出现 UnboundLocalError 错误\n* 由 @humblefoo02 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F690 中添加了 Logfire 集成\n* 由 @Harigithub11 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F707 中修复了 Vanta 高危漏洞\n* 由 @ASCE-D 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F716 中对大型工具结果进行了截断，并移除了数据库中的持久化存储\n* 由 @shmbhvi101 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F709 中集成了订阅功能，将消息使用情况报告给 Stripe-Potpie\n* 由 @Harigithub11 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F718 中修复了多个依赖项中的 Vanta 安全漏洞\n* 由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F733 中新增了用于测试的数据种子功能\n* 由 @shmbhvi101 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F734 中修复了该仓库中的高危、严重、中等和低危漏洞\n* 由 @Dsantra92 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F735 中开发了新的 Rust 解析模块\n\n## 新贡献者\n* @Harigithub11 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F696 中做出了首次贡献\n* @humblefoo02 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F690 中做出了首次贡献\n\n**完整变更日志**: https:","2026-04-15T11:30:35",{"id":225,"version":226,"summary_zh":227,"released_at":228},352134,"v1.0.0","## 变更内容\n\n这是在大型代码库中，面向规范驱动开发复杂功能方向的一次重大发布。它不仅包含了大量上下文工程相关的开发工作，还构建了用于研究、规划和实施复杂变更的基础架构。此次发布的编码代理在 SWE Bench Lite 上取得了 63% 的成绩，位居排行榜前列。此外，本次发布还包括一些必要的改动，使 VSCode 插件能够在与本地开发者终端交互时，充分利用 Potpie 的知识图谱基础设施和代理能力。\n\n## 亮点\n\n- 引入了**子代理**，通过全新的多代理监督\u002F委派架构，实现专注且隔离的任务执行。\n- 推出了**待办事项工具链**，帮助代理跟踪进度、管理任务并协调多步骤工作。\n- 对**编码代理**进行了优化，采用了更强大的结构化工作流（调研\u002F规划\u002F实施模式），提升了编排能力，并持续改进后续版本的代理性能。\n- 增加并稳定了通过**仓库管理器**提供的 Bash 工具支持，从而为代理工作流提供更可靠的本地仓库和工作树操作能力。\n\n## 代理与编码体验\n\n- 对代理系统进行了重大重构，并在编排、流式处理、工具使用及编码任务执行等方面进行了后续改进。\n- 在编码工作流中新增了面向 PR 的工具（提交\u002F推送\u002FPR\u002F评论支持），以实现更端到端的自动化。\n- 改进了多代理追踪与可观ability，便于调试委派执行过程。\n- 为 VS Code 插件增加了隧道和本地工作区支持，以强化本地执行流程。\n\n## 仓库管理、解析与本地执行\n\n- 将仓库管理器与解析和工作树注册集成，实现一致的仓库管理。\n- 依托仓库管理器支持的工作树，提升了 Bash 和本地代码工具的可靠性。\n- 优化了工作树的创建与重建逻辑，包括对旧版或非裸仓库的处理，以及仅针对工作树的解析路径。\n- 新增了分支拉取、缓存和搜索功能的改进，并对仓库和分支的用户体验进行了优化。\n- 通过推理缓存以及多项 Celery 和解析模块的生产修复，提升了解析的可靠性。\n\n## 集成与平台功能\n\n- 扩展了集成范围，支持 Slack、Linear、Confluence 和 Jira 的 OAuth 及 Webhook。\n- 增强了可扩展代码提供商的支持，新增对 Gitbucket 的支持。\n- 在聊天中增加了图片支持，并引入了多模态功能的特性开关。\n- 新增了会话管理端点，支持流式传输，并对对话 API 进行了改进。\n\n## 认证与账户管理\n\n- 引入了 Gmail SSO 支持。\n- 新增了工作邮箱验证功能，用于 SSO 身份认证。\n\n## 可靠性、安全性与运维\n\n- 发布了广泛的依赖项更新和安全加固措施（包括 CVE 相关修复）。\n- 从 `pip` 迁移到 `uv`，并清理了依赖关系。\n- 提升了日志记录与可观ability，包括引入 Logfire 日志库，以及全面的错误处理和日志记录改进。\n\n## 文档与开发者体验\n\n- 重新设计了 README 文件，并更新了文档。\n- 新增了问题模板和","2026-02-23T05:49:02",{"id":230,"version":231,"summary_zh":232,"released_at":233},352135,"v0.1.7","## 变更内容\n* 由 @sankalpchandra 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F383 中减少自定义代理服务中的冗长日志记录\n* 由 @ayush2390 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F387 中将 Slack 集成添加到 README 文件中\n* 由 @prajaktad18 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F390 中为服务器添加停止脚本\n* 修复：日志传播问题，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F391 中完成\n* 修复：改进了 api_key_service 的错误处理，由 @harshit078 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F385 中完成\n* 由 @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F343 中为对话和 API 路由器设置使用限制\n* 修复：从更新分支工具中移除 token，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F395 中完成\n* 由 @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F401 中将网页搜索工具添加到工具辅助程序中\n* 修复：捕获解码错误，并支持 UTF-8 及其他编码格式……，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F400 中完成\n* 为分享聊天的收件人添加电子邮件验证功能，由 @mirzauu 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F397 中完成\n* 新特性：文件获取工具，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F399 中实现\n* 由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F404 中将 UI 更新至最新版本\n* 修复本地文件结构获取问题，由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F405 中完成\n* 为避免每次递归时都解析 .gitignore 文件而进行的更改，由 @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F406 中完成\n* 新特性：添加重试机制、更新模型列表并支持 OpenRouter 等……，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F413 中实现\n* 新特性：提示优化、新增工具以及 Pydantic 代理更新，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F412 中完成\n* 新特性：按提交 ID 进行解析，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F414 中完成\n* 修复：合并 commit_id，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F415 中完成\n\n## 新贡献者\n* @sankalpchandra 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F383 中完成了首次贡献\n* @ayush2390 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F387 中完成了首次贡献\n* @prajaktad18 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F390 中完成了首次贡献\n* @mirzauu 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F397 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.1.6...v0.1.7","2025-06-13T11:15:31",{"id":235,"version":236,"summary_zh":237,"released_at":238},352136,"v0.1.6","大量小错误修复和改进\n\n## 变更内容\n* 在搜索模式中添加空字符串验证，由 @bnishit 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F363 中完成\n* 更新 UI 至最新提交，由 @KanavRajFarishta 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F364 中完成\n* 搜索 API 的变更，由 @aravindaak 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F369 中完成\n* 将 start.sh 转换为 PowerShell 脚本，由 @xuweicheng 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F298 中完成\n* 新特性：更新 LLM 配置以包含 GPT-4.1 模型，并进行调整…，由 @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F367 中完成\n* 修复：在历史记录中发送消息类型，由 @rahulshenoy27 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F372 中完成\n* 更新工具名称以符合标准，由 @nndn3 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F374 中完成\n* 新特性：Litellm 重试功能，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F375 中完成\n* 将非错误情况下的警告级别改为信息级别，由 @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F370 中完成\n* 为所有创建对话的 API 添加隐藏参数，由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F335 中完成\n* 新特性：为对话 API 添加排序选项，由 @YashPatrot 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F376 中完成\n* 新特性：为对话列表 API 添加排序和顺序参数，由 @TsainGra 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F377 中完成\n* 更新创建者写入权限，由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F382 中完成\n* 新特性：为 auth_service.py 添加单元测试，由 @harshit078 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F381 中完成\n* 在 auth_router 和 auth_service 中添加优雅的错误处理机制，由 @anarchymonkey 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F380 中完成\n\n## 新贡献者\n* @bnishit 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F363 中完成了首次贡献\n* @KanavRajFarishta 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F364 中完成了首次贡献\n* @aravindaak 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F369 中完成了首次贡献\n* @xuweicheng 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F298 中完成了首次贡献\n* @rahulshenoy27 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F372 中完成了首次贡献\n* @nndn3 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F374 中完成了首次贡献\n* @YashPatrot 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F376 中完成了首次贡献\n* @TsainGra 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F377 中完成了首次贡献\n* @harshit078 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F381 中完成了首次贡献\n* @anarchymonkey 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F380 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.1.5...v0.1.6","2025-04-25T09:50:18",{"id":240,"version":241,"summary_zh":242,"released_at":243},352137,"v0.1.5","🚀 Potpie v0.1.5 — 超级charged 的工作流、更流畅的图表，以及全新集成！\n\n准备好迎接这一强大新版本吧，它带来了诸多提升效率的更新、新鲜的集成功能以及性能优化。\n\n✨ 亮点\n\t•\t📈 Linear 集成：现在你可以使用自定义智能体直接读取和写入 Linear 工单。是时候像专业人士一样自动化你的冲刺看板了。\n\t•\t🐙 GitHub 工具链：借助全新的工具管理 GitHub 任务——你的智能体如今对代码仓库更加得心应手。\n\t•\t⚡️ 极速图表：图表创建速度显著提升，效率更高。我们对插入流程进行了精细调优，以实现更快的速度和更强的可扩展性。\n\t•\t🔧 更流畅的智能体体验：我们修复了自定义智能体工具选择器中的 bug——现在创建智能体如丝般顺滑。\n\n⸻\n\n🛠 变更内容\n\t•\t🧠 @dhirenmathur 在 [#332](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F332) 中更新了 README 中的 Ollama 引用\n\t•\t🆕 @dhirenmathur 在 [#328](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F328) 中将 DeepSeek Chat 模型升级至 0324 版本\n\t•\t🔍 @kinshuksinghbist 在 [#323](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F323) 中新增了网络搜索工具\n\t•\t🛠️ @dhirenmathur 在 [#333](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F333) 中实现了 Linear 工单的读写工具\n\t•\t🔐 @dhirenmathur 在 [#336](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F336) 中改进了 Linear 工具的 API 密钥处理机制\n\t•\t⚡ @dhirenmathur 在 [#337](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F337) 中对图表插入进行了速度优化\n\t•\t🐞 @kinshuksinghbist 在 [#317](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F317) 中修复了自定义智能体 ID 的 bug\n\t•\t🧪 @dhirenmathur 在 [#338](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F338) 中更新了 Sentence Transformers 版本\n\t•\t🧹 @kinshuksinghbist 在 [#339](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F339) 中移除了 Signoz 和 mem0 的清理逻辑\n\t•\t🧰 @dhirenmathur 在 [#340](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F340) 中修复了自定义智能体中工具选择的 bug\n\t•\t🧩 @dhirenmathur 在 [#341](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F341) 中调整了图表插入的批次大小，以提升稳定性\n\t•\t🔒 @nndn 在 [#342](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F342) 中引入了内部认证系统\n\t•\t🧑‍💻 @nndn 在 [#334](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F334) 中推出了 GitHub 相关工具\n\t•\t🔁 @dhirenmathur 在 [#360](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F360) 中优化了 API 密钥获取逻辑\n\n⸻\n\n🔗 [完整变更日志 →](https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.1.4...v0.1.5)\n\n","2025-04-15T06:15:26",{"id":245,"version":246,"summary_zh":247,"released_at":248},352138,"v0.1.4","使用 Pydantic AI 代理提升代理运行速度。  \n在流式响应中添加代理工具和思考过程。  \n更新 LLM 上下文传递给代理的方式，为聊天和代理推理分别配置不同的 LLM 设置。  \n更新密钥管理以支持新的 LLM 配置样式。\n\n## 变更内容\n* 重构\u002Fagents 最终版，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F286 中完成  \n* （重复）全面革新：代理系统焕然一新！！，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F269 中完成  \n* 修复：捕获分类器异常，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F308 中完成  \n* 修复：分类功能，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F309 中完成  \n* 功能：Pydantic AI 支持，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F303 中完成  \n* 杂项：使用路由提供商，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F310 中完成  \n* 杂项：在 PromptController 中实例化额外的服务，由 @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F312 中完成  \n* 添加用于解析的 proto 文件，由 @Dimpal-Kalita 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F313 中完成  \n* 杂项：移除对 OpenAI 密钥的硬依赖，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F293 中完成  \n* 杂项：默认使用 Crew AI，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F314 中完成  \n* 添加对 Azure OpenAI API 密钥的支持，由 @Dimpal-Kalita 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F288 中完成  \n* 在 README 的对话 API 中添加“node_ids”，由 @Dimpal-Kalita 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F318 中完成  \n* 更新聊天与推理的提供商配置，简化环境搭建，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F316 中完成  \n* 杂项：禁用 Pydantic，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F319 中完成  \n* 使用新的提供商设置更新密钥管理器，由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F320 中完成  \n* 修复：优化输出结构，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F322 中完成  \n* 提升 Pydantic 性能，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F321 中完成  \n* 杂项：在模型检查中使用聊天配置，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F324 中完成  \n* 修复：自定义代理中的 Crew AI 提供商，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F326 中完成  \n* 修复：CrewAI 和通用代理的 LLM 提示词，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F325 中完成  \n* 修复：工具响应问题，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F327 中完成  \n* 更新 README.md 截图，由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F329 中完成  \n* 功能：列出代理和项目的 API，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F330 中完成  \n* 修复：多任务上下文及工具增强，由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F331 中完成  \n\n## 新贡献者\n* @Dimpal-Kalita 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F313 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.1.3...v0.1.4","2025-03-30T14:57:52",{"id":250,"version":251,"summary_zh":252,"released_at":253},352139,"v0.1.3","可通过电子邮件与任何人共享自定义智能体，也可将其设为公开，供所有人访问。\n\n## 变更内容\n* 由 @kinshuksinghbist 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F295 中实现的提示优化功能\n* 由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F299 中实现的自定义智能体共享功能\n* 由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F304 中修复的自定义智能体共享相关迁移问题\n* 修复：添加缺失的 chardet 导入，由 @nndn 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F306 中完成\n* 修复开发模式下的功能问题，由 @dhirenmathur 在 https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fpull\u002F307 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fpotpie-ai\u002Fpotpie\u002Fcompare\u002Fv0.1.2...v0.1.3","2025-03-15T05:18:35"]