演讲实录：揭秘 P4 2025.2 版本核心更新——REST API 及面向未来的游戏开发工具矩阵
在上一期“ Perforce on Tour 游戏研发效能进阶沙龙”回顾文章中，我们分享了Perforce 资深技术工程师 Kory Luo 关于P4 MCP（Model Context Protocol）服务器 的前瞻解析。作为连接 AI 模型与本地数据的开放标准，MCP 为 P4 引入了前所未有的“语义理解”能力。
要让这项能力顺畅落地，离不开现代化的接口与工具支持。今天，我们将继续回顾 Kory Luo 演讲中的核心内容：2025.2 版本重磅推出的 REST API，以及专为现代研发场景设计的P4产品矩阵。
以下为演讲实录，欢迎收藏阅读！
地基开放——REST API 开启“无客户端”运维
讲完 MCP，我们再来看看 2025.2 版本（即 2025 年下半年）推出的另一项重大创新功能——REST API。
简单来讲，REST API 允许开发者通过 Web 方式（HTTP REST 端点）直接与 P4 服务器交互，返回 JSON 格式的数据。整个过程中你完全不需要安装 P4 命令行或客户端。只需一条简单的命令，就可以启动随 P4D 引擎自带的 P4 Web Server，无需安装额外组件。调用该接口需要具备 Super 或 Operator 权限，目前在安全性上使用的是基于 P4 Tickets 的基本身份验证（Basic Authentication），官方也在规划后续版本支持更现代化的身份验证方式。
技术预览版：您的反馈决定 26.1 的走向
需要强调的是，2025.2 版本推出的 REST API 目前是一个“技术预览版”，它是一个很好的起点，目前只支持核心的基础功能。我们正在进行第二阶段的开发，预计在今年 5 到 6 月份左右会推出功能更完善的阶段版本。我们非常鼓励大家去试用 REST API，在试用过程中，如果有任何你希望通过 REST API 实现的特定业务需求，欢迎随时发邮件告诉我们。尽早提交建议，我们很可能就会把你的需求采纳并集成到 26.1 版本（5 月份发布）中去，越早反馈，越早受益。
REST API 目前开放的三大接口能力
我们来看一下目前开放了哪些接口能力。
第一类是服务器与仓库的智能化查询。通过 REST API，你可以查询服务器的关键信息（如版本号、运行时间、License 信息）以及当前的所有配置项（Configurables）。你还可以按名称或类型对仓库进行列举和筛选。这非常适合用于自动化运维和监控场景，方便开发者构建自定义面板来实时访问服务器状态。
第二类能力是文件操作。例如，它支持从任意 Depot 路径下直接下载文件。基于此，你可以构建一个纯 Web 的前端界面，让用户点击按钮就能将仓库里的内容直接下载到本地工作区。同时，它也支持版本说明符（Revision Specifier），比如你可以指定访问版本 1 到 5 的文件，或是查询某个特定 Change List 下的历史记录。
最后一类是关于 Change List 的详细信息查询。包括谁在什么时间提交的、具体内容、变更描述以及关联的 Jobs 等。它可以通过接口直接列出已提交变更列表中的所有信息。这非常适用于代码变更审计、自动化数据分析，或者用于自动生成团队的一周开发简报，总结本周重大的代码改动。
如何利用 REST API 构建实用工具？
利用 REST API，大家可以构建出哪些实用的工具呢？
首先是构建自定义的数据仪表板。通过可视化界面展示服务器的健康状态、各个 Depot 仓库的活跃度以及代码提交趋势，极大方便了运维和管理。
第二个场景是 CI/CD 流水线的深度集成。你可以直接基于特定 Change List 的提交来触发构建，将变更的元数据引入自动化流水线中，实现 P4 与现有 CI/CD 系统的无缝衔接。
第三个场景是构建基于 Web 的轻量级资产浏览器。这意味着非技术人员可以直接通过浏览器页面浏览并下载 Depot 仓库中的文件，完全不需要繁琐地安装 P4V 或其他客户端。
第四个是合规审查与报告生成。你可以用它进行审计追踪，生成 Change List 报表，并实时监控 License 的使用情况生成汇报。
最后一个场景是轻量级的微服务集成。通过标准的 HTTP 接口，你几乎可以在任何编程语言或平台上，无需安装 SDK 或下载客户端，就能轻松接入 P4 系统后台。
产品矩阵——专为现代研产而生的“利器”
前面介绍的是 P4 系统底层开放的接口能力。现在我们将视角拉回到产品本身，看看 P4 One、P4 Code Review、P4 DAM 和 P4 Plan 在整个平台矩阵中的定位。
P4 One：艺术家的本地“版本保险箱”
大家之前有没有用过 P4 One？这是我们去年专为 2D/3D 艺术家打造的版本控制客户端。它和传统的 P4V 最大的区别在于，它不需要依赖网络连接就能实现极速的本地化版本管控。
我们都知道，在美术开发中，一张贴图或数字资产可能会被反复修改很多遍。而最终选定的版本，可能并非最后修改的一版，而是中间的某一版。如何将所有中间迭代版本安全保存在本地，并在需要时一键回退？P4 One 就是答案。在 P4 One 界面中，你可以直接看到 2D/3D 文件的真实缩略图预览。文件在 Unreal Engine 或 Unity 里呈现出什么效果，在 P4 One 里就能看到相同的渲染表现。
界面左侧提供了一条可视化的时间线，让你清晰看到每个时间节点所做的变更。需要回退时，只需在时间线上操作即可。作为一款本地版本控制软件，它处理资产的速度比 Git 快 10 倍以上。加载项目到工作区后瞬间就能投入使用。它的回退操作极为简单，美术人员完全不需要学习复杂的版本控制概念，只需把资产拖拽进 P4 One 界面，它就会自动在后台完成版本管控。
P4 Code Review：AI 驱动的协作温度
接下来是 P4 Code Review（以前叫 Swarm），它与 P4 紧密集成，主要用于代码审查管理。通常服务器中既有代码也有美术资产，针对这两类对象的评审流程是不一样的。对于核心代码，我们要求采用“提交前审查”（Pre-commit Review）。在提交到主库之前，必须跑完自动化测试并确认代码无误，因为提交有致命 Bug 的代码极大概率会导致整个项目崩溃。因此，代码需要严格遵守提交前审查模板。
而对于 2D/3D 的美术资产，其版本变更提交到仓库通常不会导致服务器崩盘。为了不阻塞工作流，我们采用“提交后审查”（Post-commit Review），允许美术直接提交，随后系统自动生成审查任务。项目经理可以在每天结束时，通过查看提交后审查列表，快速了解每位美术师今天的工作量和修改细节。此外，系统也完全支持与 Jira 任务系统的双向关联。
刚才提到了 AI，P4 Code Review 也深度集成了 AI 辅助功能。当提交代码评审时，AI 会自动对代码变动生成技术解释和总结（Summary），指出新旧版本间的差异。这样评审人员就无需逐行肉眼排查代码，AI 提供了客观的第二视角参考，大幅提升审查效率。此外，系统界面支持对 Review 任务发表评论、投票表态，后续版本还加入了 Emoji 表情支持，让审查系统多一些人性化交流的温度。
P4 DAM：高级可视化资源库
接着来看 P4 DAM。这是我们去年大力打造的核心产品之一，是一个专为 2D/3D 美术资产打造的高级可视化资源库。虽然可以用 Code Review 页面审查资产，但在浏览器加载 uasset 或 Blender 文件时速度往往较慢，且呈现的状态远没有在 Unity 等引擎中原生打开时直观。P4 DAM 解决了这个痛点，它能自动生成高保真的交互式缩略图和动画视图。文件在 Unreal Engine 中渲染出什么效果，在 P4 DAM 界面里就能高保真还原展示。
除了审查预览功能，它最重要的作用是作为 2D/3D 资产的存储库。游戏开发中许多资产是可以复用的，但要在海量 P4 历史库中快速查找到旧资产并不容易。P4 DAM 引入了基于元数据（Metadata）的追踪功能，让你能迅速锁定所需资产。比如开发新关卡需要一把狙击枪，只需在 P4 DAM 中输入描述（如“黑色、某种造型的狙击枪”），它就能精准搜索出匹配的模型，你可以一键拷贝至新项目中复用，避免重新制作浪费人力。
为什么它能搜得这么准？比如“黑色狙击枪”的属性是如何记录到 P4 数据库中的？这得益于强大的 AI Tagging（AI 智能打标签）功能。启用该工具后，每次提交美术资产到 P4 服务器时，AI 引擎会在后台自动扫描并分析图像的视觉特征，自动生成极其详尽的标签写入数据库。同时，人工也可以手动增加、修改或删除这些标签，确保搜索逻辑符合项目规范。
P4 Plan：项目规划的理想替代方案
最后是 P4 Plan，这是我们专为游戏研发打造的项目实施规划与跟踪工具。它提供了全局统一的管理视图，兼容敏捷（Agile）及瀑布模型（Waterfall），全面支持 Scrum 看板、甘特图（Gantt Chart）等项目进度追踪功能。它拥有极其强大的 Backlog（待办事项）视图底座，即使承载成千上万条任务，其视图依然能保持卓越的性能与超快的响应速度。并且，它还能与 P4 Change List 相关联。
在 P4 平台产品线中，各产品间都是无缝互联的。想提醒大家注意一个动向：像 Atlassian 以及 Microsoft Project 等部分项目管理工具，已经或即将发布停产公告，预计在 2026 至 2029 年间逐步退出舞台。面对工具链断层的风险，如何选择能与版本仓库结合的规划工具？P4 Plan 是非常理想的替代选择。如果不了解该产品，会后可以联系龙智或 Perforce 团队，我们会为大家安排 Demo 演示。
构建无缝互联、面向未来的研发工具链
利用 REST API 与 MCP 协议，您可以为 P4 系统插上 AI 的翅膀；而在 P4 产品矩阵中，不同角色的团队成员得以在统一、智能的生态中协作。
下周预告：下周我们将继续带您走进 Perforce 2026 发展路线图，并分享《阿凡达》等项目团队如何利用 P4 架构实现 20 分钟内完成新项目点火部署的实战秘籍！
未完待续…..
Perforce中国授权合作伙伴—上海龙智
如果您想更深入地了解REST API、MCP服务器，或希望了解如何通过 AI 提升美术资产复用率，欢迎联系Perforce授权合作伙伴——龙智（DragonSoft），抢先体验 AI 驱动的 Perforce 解决方案。
官网：www.shdsd.com
电话：400-666-7732
邮箱：marketing@shdsd.com
最新文章
相关产品
