这本书怎么用
序里说明了为什么写这本书。前言只回答一个更具体的问题:拿到这本书之后,应该怎么读、怎么验、读到什么程度算读完。
本书不是点子合集,每一节都遵循同一套结构,每一个判断都能落到一个可运行的产物或一张可核对的表上。下面把使用约定一次讲清楚,后面正文不再重复。
双案例:一组刻意设计的对照
本书使用同一 IP 下的两款产品作为案例。它们不是「大厂 vs 小厂」的对比,而是同一工作室、同一套中台、同一批人面对两种约束:
| 维度 | 《潮汐消消》 | 《潮汐方舟》 |
|---|---|---|
| 品类 | 三消 + 家园装饰(休闲) | 卡牌策略 RPG(中重度) |
| DAU | 80 万 | 25 万 |
| 单局/单场 | 90 秒 | 8–12 分钟 |
| Agent 形态 | 陪伴型 | 实时型 |
| 单次思考预算 | 2,000ms | 800ms |
| 每玩家日均调用 | 0.3 次 | 5.4 次 |
| 主要收入 | 广告 55% + 内购 45% | 内购 90% + 广告 10% |
基础规模、包体、帧率等字段继承《移动游戏产品的架构》的案例表,本书不重复定义;Agent 侧的延迟、调用量、成本、成熟度与路线周期全部是教学设定值。全书只使用这一套数字,任何章节不得出现第二套 DAU、延迟或成本口径。
三条使用规则要提前说明:
- 每节一个主案例。 例如第 3 章实时性以方舟为主,因为 800ms 是硬约束;第 7 章成本以消消为主,因为 DAU 高、ARPU 低,成本最敏感。另一个案例只在关键分歧处作对照,每段不超过 150 字。
- 所有数字都是案例设定。 它们用于演练口径与决策,不是线上数据。正文统一写「案例设定」或「本书口径」,不会出现「实测」「生产数据」这类措辞,除非同时给出命令与输出。
- 数字一旦矛盾,以附录 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 的段落,正文会明确写出「这里是模型,不是线上实测」。读到这类代码,请关注结构:接口切在哪里、失败怎么降级、状态如何恢复。
每一节的固定结构
本书每一节都是六段,顺序固定:
- 开场:一个具体事故或决策场景,说明这一节要解决什么。
- 分析:三到六个小节,至少一张表,给出判据、取舍与失败后果。
- 可运行判定:一段带三行头的 TypeScript,把判据写成纯函数。
- 小结:八到十条可以直接带走的判断。
- 阅读导航:一行,指向上一个和下一个可读单元。
- 常见错误与边界:六到十条可操作的错误清单,每条说明后果。
这种结构是为了防止两种常见的写作病:只讲趋势不讲判据,以及只讲结论不讲前提。如果你读某一节时发现「分析」部分没有表,或者「常见错误」在说空话,那大概率是写作缺陷。
三类阅读路径
路径一:顺序读。 适合第一次接触游戏 Agent 产品设计的人。按 1 → 13 章顺序读,每章三节连着读。第 13 章会把前 12 章的结论收口成成熟度、路线图与评审三张表,顺序读到这里会有明显的「对上了」的感觉。
路径二:带问题查。 适合已经在做线上产品的人。先看下面这张问题索引,直接跳到对应章节,再回头补读它依赖的前置章节:
| 你遇到的问题 | 先读 | 再补 |
|---|---|---|
| Agent 回复太慢、战斗卡顿 | 3.1、3.2 | 3.3、11.1 |
| 玩家说 AI 作弊 | 4.2、4.3 | 4.1、13.3 |
| AI 说了不该说的话 | 6.1、6.2 | 6.3、5.3 |
| 成本突然涨了 | 7.1、11.2 | 7.2、12.3 |
| 多 Agent 失控 | 8.1、8.2 | 8.3、10.3 |
| 不知道怎么验收一次改动 | 12.2、11.3 | 13.3、9.3 |
| 活动内容生产不过来 | 10.1、9.1 | 9.2、11.1 |
| 团队没人对 Agent 负责 | 12.1、12.3 | 13.1、13.2 |
路径三:只读产物。 适合想直接看代码的人。按 src/play → src/realtime → src/fair → src/metrics 的顺序读实验工程,先跑测试再读实现。这种读法会错过一部分决策背景,但能最快建立「判断长什么样」的直觉。
与站内其他书稿的分工
本书与站内已有的几套书稿有明确边界,读到重叠概念时不必怀疑重复:
- 通用 Agent 的任务定义、交互信任、组织规模化,在《AI Agent 产品开发》三卷里;本书只写游戏侧多出来的实时、公平与玩家信任约束。
- 模型接入、路由、编排与成本治理,在「互联网产品的 AI 架构」系列里;本书只写这些能力在游戏产品层产生的取舍。
- 客户端运行时、包体、热更,在《移动游戏产品的架构》里;本书复用它的双案例与基础规模,不重复工程细节。
- 服务端拓扑、协议、战斗同步,在《游戏服务端架构》与《MMO 服务器开发》里;本书只写 Agent 服务在产品侧的位置。
- 游戏设计、叙事、美术的方法,在对应的设计类书稿里;本书只写「Agent 介入之后,产品决策变了什么」。
遇到重叠点时,正文会用一段概述加一个站内链接带过,然后把篇幅留给本书真正新增的部分:可运行产物、双案例对照、带后果的决策记录。
读完这本书的标准
最后一节 13.3 会给出一份四十八项的评审清单。在那之前,你可以用下面四条自检:
- 能画出自己产品的 Agent 任务规格,写清玩家意图、世界状态与允许动作;
- 能给出一次思考的延迟预算拆解,并说明超时后玩家看到什么;
- 能说出 AI 对手与玩家能力对齐的三项:动作空间、冷却、信息可见性;
- 能列出三条体验护栏与单位成本的三个分母。
四条都能答上来,这本书就算读完了。答不上来的那一条,就是下一次重读的入口。
继续阅读
探索更多技术文章
浏览归档,发现更多关于系统设计、工具链和工程实践的内容。