全书 45 篇 = 序、前言、目录 3 篇 + 13 章 39 节 + 附录 A/B/C 3 篇。
双案例:《潮汐消消》(休闲,陪伴型)为主案例,《潮汐方舟》(中重度,实时型)为对照;两者共用一个工作室与一套中台。
正文代码块带// file:/// tier:/// verify:头,可在实验工程aga-lab中逐字节还原并运行测试。
这本卷回答什么
游戏 Agent 的产品问题不是「接一个大模型」,而是在单局时长、同步对局、玩家公平感与单位成本四条约束下,决定 Agent 能替玩家做多少决定。
本书把这条判断拆成 13 章:先界定通用 Agent 与游戏 Agent 的三点差异,再依次处理任务规格、延迟与降级、确定性与公平、记忆与关系、内容审核、经济与付费、群体涌现、研发与运营流程、度量与实验、组织与平台,最后收口到成熟度分级、路线图与评审清单。
阅读前提
- 了解产品或工程中的至少一侧:做过玩法/数值设计,或做过服务端、客户端与模型接入。
- 能读懂 TypeScript 接口与状态机;不要求会训练模型,本书把模型当作可替换的外部能力。
- 知道休闲与中重度两类产品的差别:单局时长、在线强度、付费结构与运营节奏。
全卷概览
| 章 | 主题 | 节数 | 核心产物 |
|---|---|---|---|
| 1 | 游戏为什么需要另一种 Agent 产品观 | 3 | src/domain/agent-form.ts, src/domain/form-boundary.ts, src/domain/agent-or-script.ts |
| 2 | 玩法约束下的任务定义 | 3 | src/play/task-spec.ts, src/play/capability.ts, src/play/failure-taxonomy.ts |
| 3 | 实时性:延迟预算与降级 | 3 | src/realtime/latency-budget.ts, src/realtime/offload.ts, src/realtime/degradation.ts |
| 4 | 确定性与公平 | 3 | src/fair/seed-replay.ts, src/fair/fairness.ts, src/fair/anti-cheat.ts |
| 5 | 记忆与关系 | 3 | src/memory/memory-scope.ts, src/memory/relationship.ts, src/memory/privacy.ts |
| 6 | 内容生成与审核 | 3 | src/content/guard.ts, src/content/moderation.ts, src/content/report.ts |
| 7 | 玩法中的经济与付费 | 3 | src/econ/cost.ts, src/econ/monetization.ts, src/econ/pay-fairness.ts |
| 8 | 群体与涌现 | 3 | src/swarm/rules.ts, src/swarm/emergence.ts, src/swarm/kill-switch.ts |
| 9 | 研发流程中的 Agent | 3 | src/pipeline/spec.ts, src/pipeline/batch.ts, src/pipeline/qa.ts |
| 10 | 运营与 LiveOps | 3 | src/liveops/content.ts, src/liveops/service.ts, src/liveops/incident.ts |
| 11 | 度量与实验 | 3 | src/metrics/experience.ts, src/metrics/unit-cost.ts, src/metrics/experiment.ts |
| 12 | 组织与平台 | 3 | src/org/ownership.ts, src/org/eval.ts, src/org/build-vs-buy.ts |
| 13 | 收口:成熟度、路线图与评审 | 3 | src/govern/maturity.ts, src/govern/roadmap.ts, src/govern/review.ts |
前置
第 1 章 游戏为什么需要另一种 Agent 产品观
| 节 | 文章 | 代码产物 |
|---|---|---|
| 1.1 | 1.1 通用 Agent 与游戏 Agent 的三点差异 | src/domain/agent-form.ts |
| 1.2 | 1.2 游戏 Agent 的四种形态:NPC、同伴、对手与导演 | src/domain/form-boundary.ts |
| 1.3 | 1.3 什么该做成 Agent,什么该写成脚本 | src/domain/agent-or-script.ts |
第 2 章 玩法约束下的任务定义
| 节 | 文章 | 代码产物 |
|---|---|---|
| 2.1 | 2.1 玩家意图、世界状态与允许动作 | src/play/task-spec.ts |
| 2.2 | 2.2 Agent 能替玩家做多少决定 | src/play/capability.ts |
| 2.3 | 2.3 破坏体验的五类错误 | src/play/failure-taxonomy.ts |
第 3 章 实时性:延迟预算与降级
| 节 | 文章 | 代码产物 |
|---|---|---|
| 3.1 | 3.1 一次思考的延迟预算 | src/realtime/latency-budget.ts |
| 3.2 | 3.2 把非实时部分挪出关键路径 | src/realtime/offload.ts |
| 3.3 | 3.3 模型不可用时玩家看到什么 | src/realtime/degradation.ts |
第 4 章 确定性与公平
| 节 | 文章 | 代码产物 |
|---|---|---|
| 4.1 | 4.1 种子、回放与可审计 | src/fair/seed-replay.ts |
| 4.2 | 4.2 AI 对手不做玩家做不到的事 | src/fair/fairness.ts |
| 4.3 | 4.3 Agent 与反作弊的边界 | src/fair/anti-cheat.ts |
第 5 章 记忆与关系
| 节 | 文章 | 代码产物 |
|---|---|---|
| 5.1 | 5.1 跨局记忆:记住什么、忘掉什么 | src/memory/memory-scope.ts |
| 5.2 | 5.2 关系状态与叙事连续性 | src/memory/relationship.ts |
| 5.3 | 5.3 记忆的隐私与数据最小化 | src/memory/privacy.ts |
第 6 章 内容生成与审核
| 节 | 文章 | 代码产物 |
|---|---|---|
| 6.1 | 6.1 生成内容的可说、可做与可展示 | src/content/guard.ts |
| 6.2 | 6.2 生成前约束与生成后过滤 | src/content/moderation.ts |
| 6.3 | 6.3 玩家举报、内容回滚与追责 | src/content/report.ts |
第 7 章 玩法中的经济与付费
| 节 | 文章 | 代码产物 |
|---|---|---|
| 7.1 | 7.1 每局、每玩家与每月的 Agent 成本 | src/econ/cost.ts |
| 7.2 | 7.2 卖能力、卖内容还是卖陪伴 | src/econ/monetization.ts |
| 7.3 | 7.3 公平性与付费设计的冲突 | src/econ/pay-fairness.ts |
第 8 章 群体与涌现
| 节 | 文章 | 代码产物 |
|---|---|---|
| 8.1 | 8.1 多 Agent 的最小规则 | src/swarm/rules.ts |
| 8.2 | 8.2 涌现的收益与失控风险 | src/swarm/emergence.ts |
| 8.3 | 8.3 观测与刹车:什么时候关掉涌现 | src/swarm/kill-switch.ts |
第 9 章 研发流程中的 Agent
| 节 | 文章 | 代码产物 |
|---|---|---|
| 9.1 | 9.1 从策划表格到可执行规格 | src/pipeline/spec.ts |
| 9.2 | 9.2 美术与音频的批处理一致性 | src/pipeline/batch.ts |
| 9.3 | 9.3 QA 的回归、探索与用例生成 | src/pipeline/qa.ts |
第 10 章 运营与 LiveOps
| 节 | 文章 | 代码产物 |
|---|---|---|
| 10.1 | 10.1 活动与内容的生产化 | src/liveops/content.ts |
| 10.2 | 10.2 玩家服务的分级接管 | src/liveops/service.ts |
| 10.3 | 10.3 Agent 行为异常的事故响应 | src/liveops/incident.ts |
第 11 章 度量与实验
| 节 | 文章 | 代码产物 |
|---|---|---|
| 11.1 | 11.1 体验指标:留存、会话与投诉 | src/metrics/experience.ts |
| 11.2 | 11.2 单位玩家 Agent 成本 | src/metrics/unit-cost.ts |
| 11.3 | 11.3 灰度、对照组与实验设计 | src/metrics/experiment.ts |
第 12 章 组织与平台
| 节 | 文章 | 代码产物 |
|---|---|---|
| 12.1 | 12.1 Agent 归谁拥有:策划、程序还是平台 | src/org/ownership.ts |
| 12.2 | 12.2 工具链与评测集 | src/org/eval.ts |
| 12.3 | 12.3 供应商与自建的边界 | src/org/build-vs-buy.ts |
第 13 章 收口:成熟度、路线图与评审
| 节 | 文章 | 代码产物 |
|---|---|---|
| 13.1 | 13.1 成熟度分级 L0–L4 | src/govern/maturity.ts |
| 13.2 | 13.2 从单点到系统性能力的路线图 | src/govern/roadmap.ts |
| 13.3 | 13.3 全书评审与下一步 | src/govern/review.ts |
附录
| 篇 | 内容 |
|---|---|
| 附录 A 术语与指标 | 全书统一口径:预算、调用量、成本分母、成熟度、公平与信任 |
| 附录 B 双案例唯一事实表 | 两款产品的 DAU、时长、预算、调用量、成本与分章参数 |
| 附录 C 评审清单 | 12 组 48 项检查,含证据类型与门禁判定 |
配套与版本
- 实验工程:
aga-lab,TypeScript + Node 26 原生类型剥离,零第三方依赖。 - 测试命令:
node --test 'test/*/*.test.ts';单章可用node --test test/govern/maturity.test.ts。 - 数字口径:附录 B 是唯一事实表;正文与附录冲突时以附录为准。
- 本书为单卷:13 章 39 节 + 前置 3 篇 + 附录 3 篇,共 45 篇。