PAPI

PAPI

你的 AI 每次会话都从零开始。你的项目始终沿着既定方向前进。

AI 编码工具擅长编写代码，却不擅长把握方向。项目范围不断扩大，计划不断变更，而背后的决策在聊天窗口中做出，也在那里被遗忘。PAPI 帮助项目始终沿着既定方向前进。它为助手提供结构化的规划、构建、审查和发布周期，以及一条决策轨迹，记录做出了什么选择、舍弃了什么，以及原因。助手在工作时会读写这些内容，因此信息始终保持最新，无需任何人维护。

只需连接一次。之后，助手每次开始会话时都会知道你正在进行哪个周期、哪些工作正在进行，以及下一步该做什么。

免费开始。 完整的规划 → 构建 → 审查 → 发布工作流，最多支持 3 个项目，无需银行卡。免费版可让真实项目从头到尾完整运行，并非试用版。定价。

本仓库的内容。 文档、安装指南和问题跟踪器。PAPI 的引擎为闭源托管服务——你可以连接使用，但不能从这里构建。npm 上的 @papi-ai/server 包是受支持的本地运行时。本仓库内容采用 MIT 许可证。

快速开始

让 AI 为你安装。 将以下内容粘贴给你的助手——Cursor、Claude Code、Windsurf、Codex、VS Code，或任何其他 MCP 客户端：

阅读 https://getpapi.ai/llms.txt 并设置 PAPI

助手会读取操作指南，并引导你完成首次运行的全部步骤：检查是否位于正确的项目文件夹、连接、设置项目、规划第一个周期，以及构建第一个任务。它适用于编码工具和 claude.ai、ChatGPT 等聊天应用，你不必是开发者。（如果助手无法获取 URL，本仓库中也有同一份操作指南：llms.txt 和 llms-install.md。）

只有你能完成的一件事。 你需要在 getpapi.ai 注册一个免费账户。之后有两种连接方式：

• 连接令牌（默认）。 打开 getpapi.ai 上的 Connect 面板，复制 “This is your project” 下的项目 ID 和连接令牌，然后交给助手。助手会将它们写入工具配置，PAPI 随即即可使用，无需通过浏览器操作。
• 浏览器登录。 助手添加服务后，你在浏览器中批准连接。没有助手能够替你点击该页面；在你完成操作之前，服务会显示 Needs authentication。

大多数工具只有在对话开始时才会加载新连接，因此连接后请开启一个新对话，并让助手运行 orient。

想自己动手接入？

在 Claude Code 中，最快的方式是使用插件——只需两行，无需复制或编辑任何内容：

/plugin marketplace add getpapi/papi
/plugin install papi@papi

插件包含服务器配置，以及两个技能：check-mcp 用于诊断无法正常工作的连接，papi-verify 用于检查当前周期的运行状况。

每种工具也都可以直接使用相同的可流式 HTTP 端点 https://mcp.getpapi.ai/mcp。在 Claude Code 中，配置如下：

claude mcp add --transport http papi https://mcp.getpapi.ai/mcp

无论采用哪种方式，最后都要前往 /mcp → papi → Authenticate。或者，使用 Connect 面板中的连接令牌，完全跳过浏览器步骤：

claude mcp add --transport http papi https://mcp.getpapi.ai/mcp --header "Authorization: Bearer YOUR_CONNECTION_TOKEN" --header "x-papi-project-id: YOUR_PROJECT_ID"

DeepSeek Harness 用户可以在创建 PAPI 连接令牌后安装仓库提供的套件：

dsh plugin --profile web add @papi-ai/deepseek-harness

有关令牌处理、验证、兼容性和移除，请参阅 PAPI for DeepSeek Harness。

Cursor、VS Code、Windsurf、Codex 以及任何通用 MCP 客户端的各工具配置见 docs/install.md。

你将获得什么

• plan 将你的目标拆解为一系列规模合适的周期任务，每项任务都附有构建交接内容，助手可以直接执行。
• build 跟踪已构建的内容、意外情况以及过程中发现的问题。
• review and release 完成闭环，让每个周期都为下一次计划提供依据。
• 策略评审 每隔几个周期就退一步审视方向，而不只是关注进度。
• getpapi.ai 上的 仪表板 会显示你的周期、看板和决策，让你无需询问也能了解项目状态。

方法论就是产品：由助手与你共同运行的计划、构建、评审、发布循环，以及不断积累的记忆。上方徽章中的每个周期，PAPI 都是用 PAPI 构建的。

中心页围绕一个问题展开——接下来做什么。周期在计划、构建、评审和发布各阶段的进度显示在其下方。

看板呈现完整情况。助手工作时会顺带更新看板，因此无需任何人维护，它也能保持最新。

与跟踪工具有何不同

与 Linear、Jira、Asana 或 Notion 不同， PAPI 并非先为人类打造，再向 Agent 开放。这些看板假设由人类编写工单、由人类在 AI 看不到的标签页中阅读工单。PAPI 的看板由助手在工作过程中顺带读写：开始构建时打开任务，完成时提交报告，发布时关闭周期。你审批计划，并签核评审。中间那些工单管理工作就此省去。你管理的是结果，而不是按键操作。

与 Taskmaster 及其他仓库内任务文件不同，PAPI 的状态不是由某个工具生成一次后就逐渐过时的文件。它托管于云端且结构化，包含周期、构建报告、评审结论，以及会随证据到来而改变置信度的有效决策。从 Claude Code、Cursor、VS Code 或 Codex 都能访问同一份项目记忆，因此切换工具不会重置上下文；上一周期的经验也会成为下一次计划的依据，而不是需要你记得主动提及的内容。

这并不是在贬低那些工具，而是因为它们解决的是另一个问题——助手每次打开新窗口都会遇到的问题。

有效决策填补了任务跟踪工具缺少的字段：做出了什么决定、原因是什么、否决了什么，以及何时重新审视。随着证据到来，置信度也会变化。

每个周期都会留下记录，因此几个月后仍能看到项目背后的推理过程——包括回顾这些记录的助手。

工具

PAPI 向你的助手提供这些 MCP 工具。整个流程只需调用几次。

核心流程

• orient — 一次调用即可返回当前周期、正在进行的事项和建议的下一步操作。每次会话开始时都运行此工具。
• setup — 为新项目搭建 PAPI。
• plan — 将目标拆解为一个周期内规模适当的任务，每项任务都附带可由助手直接执行的构建交接。
• build_list — 列出当前周期的任务及其交接内容。
• build_execute — 启动任务（创建分支和交接），并完成任务（记录构建报告）。
• review_list / review_submit — 查看已完成的构建，并记录接受 / 请求修改 / 拒绝的评审结果。
• release / close_cycle — 结束周期，可发布版本（release），也可不发布（close_cycle）。
• tutorial_mode — 启用简短说明，并在每条回复中提供一个明确的下一步操作。适合最初几个周期使用。

看板和待办列表

• board_view — 查看项目看板和任意任务。
• board_edit — 更改任务的状态、周期、优先级或备注。
• ad_hoc — 记录在周期之外完成的快速工作，以便将其纳入项目历史。
• idea — 将功能、Bug 或研究笔记记入待办列表。
• bug — 在看板上登记 Bug。

策略与洞察

• strategy_review — 每隔几个周期审视一次方向，而不只是关注进度。
• strategy_change — 记录一项 Active Decision，并保留取代历史。
• zoom_out — 定期回顾多个周期。

文档和项目

• doc_register / doc_search — 登记和查找项目参考文档。
• project_list / project_switch / project_create — 管理多个 PAPI 项目。

团队

• join — 加入队友邀请你加入的项目。
• contributor_list / contributor_add — 查看和管理项目参与者。

文档

在此仓库中：

文档	内容
llms.txt	Agent 操作手册 — 将此文档提供给你的 AI（在线版本：getpapi.ai/llms.txt）
llms-install.md	面向 AI 助手的各工具安装说明
docs/install.md	所有受支持工具的安装方式
docs/how-it-works.md	周期、交接、决策，以及各部分如何协同
docs/troubleshooting.md	连接问题、项目路由和常见修复方法

网站上提供完整文档，无需账号：

页面	内容
快速入门	从零开始，不到 5 分钟制定你的第一个周期计划
工作流	完整的计划 → 构建 → 评审 → 发布流程
概念	周期、交接、Active Decisions — 相关术语介绍
速查表	一页列出所有命令
工具参考	PAPI 的所有 MCP 工具、参数和使用场景
故障排除	连接和身份验证急救指南
手册	面向团队：查看仪表板、周期报告和评审流程

社区与支持

遇到问题，或有东西坏了？请提交 issue——每种情况都有对应的模板。如果 PAPI 无法连接或通过身份验证，请使用连接问题模板；这是大家最常遇到的难题：

• 连接问题 · 错误报告 · 提问 · 功能请求
• 在 Discord 上提问能更快得到答复，发布说明也会优先在那里发布。
• CONTRIBUTING.md 介绍了有用的报告应该包含哪些内容，以及文档 PR 可以修改什么。
• 发现漏洞？请不要提交 issue——SECURITY.md 中提供了私密联系渠道。

为仓库点星

如果 PAPI 对你有帮助，请为它点星。仅此而已；这也能帮助其他使用 AI 助手进行开发的人找到它。

链接

• 网站和仪表板：getpapi.ai
• 定价：getpapi.ai/pricing——免费套餐，无需银行卡
• 每个周期发布的内容：getpapi.ai/changelog
• 数据、访问权限，以及 PAPI 目前尚不具备的内容：getpapi.ai/trust
• **许可证：**本仓库的内容（文档、指南、配置示例、Dockerfile）均采用 MIT 许可证。该许可证仅适用于本仓库，不适用于 PAPI 引擎，也不适用于作为商标的 PAPI 名称或徽标。