《AI Agent 游戏产品开发·玩法、实时与玩家信任》前言:双案例、实验工程与阅读路径

本书的使用说明:双案例的口径与分工、aga-lab 的目录与测试命令、每节固定的六段结构、代码块三行头与 L1/L2 可运行层级的区别,以及顺序读、带问题查、只读产物三条路径和四条读完自检标准,附与站内其它书稿的分工边界。写作期的每道门禁都围绕这三件事。

这本书怎么用

序里说明了为什么写这本书。前言只回答一个更具体的问题:拿到这本书之后,应该怎么读、怎么验、读到什么程度算读完。

本书不是点子合集,每一节都遵循同一套结构,每一个判断都能落到一个可运行的产物或一张可核对的表上。下面把使用约定一次讲清楚,后面正文不再重复。

双案例:一组刻意设计的对照

本书使用同一 IP 下的两款产品作为案例。它们不是「大厂 vs 小厂」的对比,而是同一工作室、同一套中台、同一批人面对两种约束:

维度《潮汐消消》《潮汐方舟》
品类三消 + 家园装饰(休闲)卡牌策略 RPG(中重度)
DAU80 万25 万
单局/单场90 秒8–12 分钟
Agent 形态陪伴型实时型
单次思考预算2,000ms800ms
每玩家日均调用0.3 次5.4 次
主要收入广告 55% + 内购 45%内购 90% + 广告 10%

基础规模、包体、帧率等字段继承《移动游戏产品的架构》的案例表,本书不重复定义;Agent 侧的延迟、调用量、成本、成熟度与路线周期全部是教学设定值。全书只使用这一套数字,任何章节不得出现第二套 DAU、延迟或成本口径。

三条使用规则要提前说明:

  1. 每节一个主案例。 例如第 3 章实时性以方舟为主,因为 800ms 是硬约束;第 7 章成本以消消为主,因为 DAU 高、ARPU 低,成本最敏感。另一个案例只在关键分歧处作对照,每段不超过 150 字。
  2. 所有数字都是案例设定。 它们用于演练口径与决策,不是线上数据。正文统一写「案例设定」或「本书口径」,不会出现「实测」「生产数据」这类措辞,除非同时给出命令与输出。
  3. 数字一旦矛盾,以附录 B 为准。 如果你发现正文与附录 B 不一致,那是正文的错。

aga-lab:可运行的实验工程

本书附带的实验工程叫 aga-lab,写作期位于仓库的 private/labs/aga-lab/。它有三个刻意的约束:

  • TypeScript,Node 26 原生类型剥离。 不需要编译步骤,node file.ts 直接运行。代价是只能用可擦除语法:禁止 enum、namespace、构造函数参数属性和装饰器。
  • 零第三方依赖。 只用 node: 内置模块。测试用 node:test 加 node:assert/strict。
  • 本地导入必须带 .ts 后缀。 这是原生类型剥离的运行要求,不是风格偏好。

目录按「能力方向」组织,与章节一一对应:

aga-lab/
├─ package.json                # type: module
├─ src/play/                   # 任务规格、能力边界、失败分类
├─ src/realtime/               # 延迟预算、异步拆分、降级
├─ src/fair/                   # 种子回放、公平性、反作弊
├─ src/memory/                 # 记忆范围、关系状态、隐私
├─ src/content/                # 审核、举报、回滚
├─ src/econ/                   # 成本、付费、公平与付费
├─ src/swarm/                  # 多 Agent 规则、涌现、刹车
├─ src/pipeline/               # 规格、批处理、QA
├─ src/liveops/                # 内容流水线、客服、事故
├─ src/metrics/                # 体验指标、单位成本、实验
├─ src/org/                    # 所有权、评测、自建与采购
├─ src/govern/                 # 成熟度、路线图、评审
└─ test/                       # 与 src 镜像的 node:test 用例

运行全部测试:

cd private/labs/aga-lab
node --test 'test/*/*.test.ts'

只跑某一章的测试(通配符必须落到具体文件,这是 node --test 在 Node 26 下的行为):

node --test test/govern/maturity.test.ts

正文中的每一个可运行代码块都以三行注释开头:

行形式含义
第 1 行file: 加相对路径这段代码在实验工程里的位置
第 2 行tier: 加 L1 或 L2可运行层级
第 3 行verify: 加命令验证它的测试命令

正文代码块与该文件逐字节一致——这不是排版约定,而是写作期的门禁:任何一个字符不同,校验脚本都会失败。

L1 与 L2 是什么意思

层级含义典型内容
L1纯逻辑,可在 Node 下直接运行并断言规格校验、延迟预算、种子回放、成本模型、门禁
L2依赖外部接口,运行的是 mock 而非线上模型模型调用、审核服务、客服路由、事故通报

L2 不是「没写完」,而是刻意把模型与外部服务抽象成接口。凡属于 L2 的段落,正文会明确写出「这里是模型,不是线上实测」。读到这类代码,请关注结构:接口切在哪里、失败怎么降级、状态如何恢复。

每一节的固定结构

本书每一节都是六段,顺序固定:

  1. 开场:一个具体事故或决策场景,说明这一节要解决什么。
  2. 分析:三到六个小节,至少一张表,给出判据、取舍与失败后果。
  3. 可运行判定:一段带三行头的 TypeScript,把判据写成纯函数。
  4. 小结:八到十条可以直接带走的判断。
  5. 阅读导航:一行,指向上一个和下一个可读单元。
  6. 常见错误与边界:六到十条可操作的错误清单,每条说明后果。

这种结构是为了防止两种常见的写作病:只讲趋势不讲判据,以及只讲结论不讲前提。如果你读某一节时发现「分析」部分没有表,或者「常见错误」在说空话,那大概率是写作缺陷。

三类阅读路径

路径一:顺序读。 适合第一次接触游戏 Agent 产品设计的人。按 1 → 13 章顺序读,每章三节连着读。第 13 章会把前 12 章的结论收口成成熟度、路线图与评审三张表,顺序读到这里会有明显的「对上了」的感觉。

路径二:带问题查。 适合已经在做线上产品的人。先看下面这张问题索引,直接跳到对应章节,再回头补读它依赖的前置章节:

你遇到的问题先读再补
Agent 回复太慢、战斗卡顿3.1、3.23.3、11.1
玩家说 AI 作弊4.2、4.34.1、13.3
AI 说了不该说的话6.1、6.26.3、5.3
成本突然涨了7.1、11.27.2、12.3
多 Agent 失控8.1、8.28.3、10.3
不知道怎么验收一次改动12.2、11.313.3、9.3
活动内容生产不过来10.1、9.19.2、11.1
团队没人对 Agent 负责12.1、12.313.1、13.2

路径三:只读产物。 适合想直接看代码的人。按 src/play → src/realtime → src/fair → src/metrics 的顺序读实验工程,先跑测试再读实现。这种读法会错过一部分决策背景,但能最快建立「判断长什么样」的直觉。

与站内其他书稿的分工

本书与站内已有的几套书稿有明确边界,读到重叠概念时不必怀疑重复:

  • 通用 Agent 的任务定义、交互信任、组织规模化,在《AI Agent 产品开发》三卷里;本书只写游戏侧多出来的实时、公平与玩家信任约束。
  • 模型接入、路由、编排与成本治理,在「互联网产品的 AI 架构」系列里;本书只写这些能力在游戏产品层产生的取舍。
  • 客户端运行时、包体、热更,在《移动游戏产品的架构》里;本书复用它的双案例与基础规模,不重复工程细节。
  • 服务端拓扑、协议、战斗同步,在《游戏服务端架构》与《MMO 服务器开发》里;本书只写 Agent 服务在产品侧的位置。
  • 游戏设计、叙事、美术的方法,在对应的设计类书稿里;本书只写「Agent 介入之后,产品决策变了什么」。

遇到重叠点时,正文会用一段概述加一个站内链接带过,然后把篇幅留给本书真正新增的部分:可运行产物、双案例对照、带后果的决策记录。

读完这本书的标准

最后一节 13.3 会给出一份四十八项的评审清单。在那之前,你可以用下面四条自检:

  • 能画出自己产品的 Agent 任务规格,写清玩家意图、世界状态与允许动作;
  • 能给出一次思考的延迟预算拆解,并说明超时后玩家看到什么;
  • 能说出 AI 对手与玩家能力对齐的三项:动作空间、冷却、信息可见性;
  • 能列出三条体验护栏与单位成本的三个分母。

四条都能答上来,这本书就算读完了。答不上来的那一条,就是下一次重读的入口。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图