getpapi/papi

PAPI

npm @papi-ai/server
MCP Registry
Smithery
Cycles shipped
GitHub stars
License

你的 AI 每次会话都从零开始。你的项目却始终不偏航。

PAPI 中运行的一个周期：中枢、看板、决策日志以及项目的历史

AI 编码工具擅长写代码，却极不擅长把握方向。范围不断扩大，计划不断变化，而背后的决策在聊天窗口里做出，又在那里丢失。PAPI 让项目始终不偏航。它为你的助手提供结构化的规划、构建、审查和发布周期，外加一份决策记录，记录下选择了什么、放弃了什么以及为什么。你的助手在工作时写入和读取它，因此它无需任何人维护就能保持最新。

你只需连接一次。从那时起，你的助手每次会话开始时都知道你处于哪个周期、正在进行什么以及下一步该做什么。

免费开始。 完整的规划 → 构建 → 审查 → 发布循环，最多支持三个项目，无需信用卡。免费版可完整运行一个真实项目；它不是试用版。定价。

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

快速开始

让你的 AI 来安装它。 把这段内容粘贴给你的助手——Cursor、Claude Code、Windsurf、Codex、VS Code 或任何其他 MCP 客户端：

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

这就是整个安装过程。你的助手会阅读它所在工具的运行手册，并自行完成连接配置。（如果你的助手无法获取 URL，同样的说明也以 llms.txt 和 llms-install.md 的形式存在于本仓库中。）
然后进行身份验证——这一步由你完成。 PAPI 通过 OAuth 登录，没有任何 AI 能替你点击浏览器上的授权同意页面。你的助手会明确告诉你该在哪里点击；在你完成之前，服务器会停留在 Needs authentication 状态，任何工具调用都无法工作。这正是人们常忽略的一步。

连接成功后，告诉你的助手：

运行 setup 工具来搭建这个项目，然后运行 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。

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 和 release 闭环收尾，让每个周期都为下一个计划提供输入。
- strategy reviews 每隔几个周期退后一步，检查方向，而不只是速度。
- getpapi.ai 上的仪表盘 展示你的周期、看板和决策，让你无需询问就能看到项目状态。

方法论本身就是产品：一个由你的助手与你共同运行的 plan、build、review、release 循环，并带有不断累积的记忆。PAPI 的每一个周期都是用 PAPI 构建的，正如上方徽章所示。

PAPI 中心：哪些事项需要你关注、当前周期进展如何，以及下一步行动

中心页面围绕一个问题展开——接下来会发生什么。周期在 plan、build、review 和 release 中的进展就位于其下方。

PAPI 看板：按状态分组的任务，并标注优先级、规模、类型和模块

看板呈现全貌。你的助手在工作过程中会顺带写入看板，因此它无需任何人维护就能保持最新。

这与追踪器有何不同
与 Linear、Jira、Asana 或 Notion 不同， 这个工具并非先为人类构建、再向智能体开放。那些看板假定由人类编写工单、由人类阅读工单，而你的 AI 看不到那个标签页。PAPI 的看板由你的助手在工作的过程中顺带写入和读取：开始构建时打开任务，完成时提交报告，发布时结束周期。你批准计划，你签署评审。中间那些工单管理事务正是消失的部分。你管理的是结果，而不是按键操作。

与 Taskmaster 及其他仓库内任务文件不同，PAPI 的状态不是一个工具生成一次、之后便逐渐偏离的文件。它是托管且结构化的——周期、构建报告、评审结论，以及带有置信水平的 Active Decisions，这些置信水平会随着证据的出现而变化。无论从 Claude Code、Cursor、VS Code 还是 Codex 访问，同一份项目记忆都在那里，因此切换工具不会重置你的上下文，而上一个周期的经验会成为下一个计划的输入，而不是你必须记得提及的东西。

这两者都不是在贬低那些工具。它们解决的问题，与每次你的助手打开一个新窗口时就会出问题的那个问题不同。

PAPI 中的 Active Decisions：每个决策及其置信水平和它所经历的周期

Active Decisions 是任务跟踪器没有字段来记录的部分：决定了什么、为什么、拒绝了什么，以及何时重新审视。置信水平会随着证据的出现而变化。

PAPI 中的项目历史：周期、已交付任务、决策事件和策略评审在同一条时间线上

每个周期都会留下痕迹，因此项目的推理过程在几个月后依然存在——包括供助手重新阅读时使用。

工具

PAPI 向你的助手公开这些 MCP 工具。整个循环只需少量调用。

核心循环
- orient — 一次调用返回当前周期、正在进行的工作以及推荐的下一步操作。在每个会话开始时运行它。
- setup — 将 PAPI 脚手架搭建到新项目上。
- plan — 将目标分解为一个由大小合适的任务组成的周期，每个任务都带有你的助手可以直接执行的构建交接。
- build_list — 列出当前周期的任务及其交接。
- build_execute — 开始任务（创建分支和交接）并完成任务（记录构建报告）。
- review_list / review_submit — 展示已完成的构建，并记录接受 / 请求修改 / 拒绝的结论。
- release — 合并已完成的工作并推进周期。

看板和待办事项
- board_view — 读取项目看板和任何任务。
- board_edit — 更改任务的状态、周期、优先级或备注。
- ad_hoc — 记录周期之外完成的快速工作，使其显示在项目历史中。
- idea — 将功能、缺陷或研究笔记捕获到待办事项中。
- bug — 针对看板提交缺陷。

策略与智能
- strategy_review — 每隔几个周期就退后一步，检查方向，而不只是速度。
- strategy_change — 记录一个 Active Decision，并带有取代历史。
- zoom_out — 跨多个周期进行定期回顾。

文档和项目
- doc_register / doc_search — 注册并查找项目参考文档。
- project_list / project_switch / project_create — 管理多个 PAPI 项目。

文档

在此仓库中：

| 文档 | 涵盖内容 |
|-----|----------------|
| llms.txt | 智能体运行手册——让你的 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 无法连接或无法认证，connection problem 那个模板就是你应该用的，因为这是人们最容易卡住的地方：

- 连接问题 · 错误报告 · 问题 · 功能请求
- 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 名称或徽标，这些均为商标。