《互联网产品的客户端架构·内容、社交与实时互动》2.3 刷新策略:下拉、自动、回到前台该不该拉
下拉、轮询、回到前台是三种不同意图的刷新,用同一个定时器处理只会在用户阅读时把列表顶走。本节用一段可运行的 TypeScript 策略模块给出逐触发的判定、刷新合并与节流、锚点位置保护,并复盘一次前后台切换风暴导致的三连请求与列表跳动,给出参数取值的依据。
category
下拉、轮询、回到前台是三种不同意图的刷新,用同一个定时器处理只会在用户阅读时把列表顶走。本节用一段可运行的 TypeScript 策略模块给出逐触发的判定、刷新合并与节流、锚点位置保护,并复盘一次前后台切换风暴导致的三连请求与列表跳动,给出参数取值的依据。
分页只保证「不重不漏地取」,端上仍会遇到同一张卡片来自刷新、实时推送与翻页三条路径。本节用带假时钟的 TypeScript 窗口实现已见集合、按时间排序的实时插入、锚点 id 位置恢复与 epoch 乱序丢弃,并复盘一次淘汰条目后「越滑越少」的线上问题。
《游戏设计》卷三《原型、可玩性与品类》全 50 篇。第一部分(第 1–4 章)做原型方法:不写代码先验规则、纸面原型的记录与回放、纸面到规格的转换,数字原型的最小内核、迭代循环、范围与止损,可玩原型的规格内联、浏览器真玩与断言、可分享可回放,以及可玩性测试的目标假设、采样与置信区间、从测试到决策;第二部分(第 5–10 章)逐个解剖六个品类:卡牌构筑 Roguelike 的机制、方差平衡与相变,塔防的机制、策略空间与难度曲线,三消的机制、随机保底与节奏,平台跳跃的机制、技巧曲线与心流带宽,自走棋的机制、经济平衡与涌现,放置的机制、曲线相变与动因;第三部分(第 11–12 章)做两个横切面:战斗作为机制(伤害时序资源、策略空间与平衡、相变与支配)与手感作为机制(手感不是渲染、参数可计算化、度量与断言);第四部分(第 13–16 章)跨品类并收官:规格的品类参数化、六个品类变体的实例化、变体的可玩性闸门,品类特征向量与 6×6 距离矩阵,六品类变体回归、6/6 通过闸门与失败的诚实报告,最后装配成三卷总收官。按章节提供仿真、逻辑内核与可玩原型;配套工程与累计快照已有验证;具体范围以对应目录说明为准,按章复现、全部事实与练习另行验收。全书围绕虚构的卡牌构筑 Roguelike《灰烬牌库》与工具链 ashdeck 展开。
内容流一旦插入新条目,页码就不再是位置:总数漂移会让第二页重复上一页的卡片,深分页还要求数据库扫过前 N 行。本节用一段可运行的 TypeScript 实现时间戳加 id 的复合游标、开区间翻页与 end-of-feed 判定,并复盘一次热榜刷新导致的重复与漏项事故。
《游戏设计》卷二《策略、涌现与体验度量》全 50 篇。第一部分(第 1–3 章)处理策略与均衡:策略的表示与决策树、策略空间枚举与 Shannon 熵、规模控制与剪枝,严格与弱支配关系、检测算法与复杂度、支配策略的修复,极小极大、混合策略与纳什直觉、最优解的计算代价;第二部分(第 4–6 章)处理涌现与相变:从规则到模式、涌现度量与退化解,平衡的定义层次与度量、平衡与多样性的张力,相变的临界点、序参量与临界指数、粗扫加二分细化的工程实现;第三部分(第 7–13 章)把玩家与体验操作化:自我决定动因模型与机制对齐、玩家类型到机制的映射与漂移,张力与释放的情绪曲线、心流带宽、技巧习得曲线与天花板,体验指标选取与置信区间、可玩性的操作化定义与采样、指标的可比性;第四部分(第 14–16 章)做可视化、反推与装配:纯 xml.etree 曲线与谱、策略空间热力图、相变图读法,从指标反推参数的可行域与代价,最后装配成动态与体验度量的完整链路并交付卷三。按章节提供仿真、逻辑内核与原型;配套工程与累计快照已有验证;具体范围以对应目录说明为准,按章复现、全部事实与练习另行验收。全书围绕虚构的卡牌构筑 Roguelike《灰烬牌库》与工具链 ashdeck 展开。
客户端实验最怕「测试全绿但线上照错」。本节把验证分成 L1 纯逻辑、L2 进程内流程、L3 本地实时通道三级,用一段可运行的 TypeScript 判定器逐级说明各自能证明什么、不能证明什么,并复盘一次因并发执行时序用例而产生的假绿灯事故。
内容端的第一处架构决定不是选框架,而是决定哪份状态归谁所有。本节把服务端状态、会话状态与瞬时 UI 状态分开,用一段可运行的 TypeScript 实现带游标、去重与淘汰上限的信息流容器,并复盘一次把游标存在组件里、导致返回页面后重复加载的真实事故。
《游戏设计》卷一《玩法机制与可执行规格》全 50 篇。第一部分(第 1–4 章)把机制写透到可执行:机制的最小构成(动词、规则、状态)、资源与目标、反馈接口,play_spec.json 的字段与模式校验、版本与迁移,S 层从规格到轨迹与资源守恒检验,P 层规格驱动的状态机、不变量断言与死锁可解性;第二部分(第 5–8 章)让规格真的跑起来:规格内联进单文件 HTML、Playwright 注入策略真玩并断言状态、原型与内核同源,参数扰动与相变扫描,反馈回路的增益与稳定性,奖励节奏谱与挫败预算;第三部分(第 9–13 章)处理机制的可计算性:随机性的三种结构、方差与体验、可播种随机与确定性回放,状态可达性与不变量清单,机制数值的整数化与跨语言一致、增长衰减的闭式与递推,机制耦合与协同反协同、组合爆炸的控制,机制的增量兼容、赛季与 DLC、退场;第四部分(第 14–16 章)把机制接到体验并做装配:机制到体验的映射与可观测指标,跨语言 digest 与同源不同宿主、偏差与容差,最后装配成一份规格四处消费的完整链路并交付卷二。按章节提供仿真、逻辑内核与原型;配套工程与累计快照已有验证;具体范围以对应目录说明为准,按章复现、全部事实与练习另行验收。全书围绕虚构的卡牌构筑 Roguelike《灰烬牌库》与工具链 ashdeck 展开。
把「回声」的客户端拆成信息流、详情、互动、实时四条消费线,逐条说明每条线需要什么数据、失败时能退到哪里,并用一段可运行的 TypeScript 把四条面的需求写成结构化输出与测试,最后复盘一次四件事混在一个页面里导致状态互相踩踏的真实事故。
《游戏美术与技术美术》卷三《风格与品类美术实战》全 50 篇。第一部分(第 1–3 章)讲风格的可测三维(色彩 / 形状 / 细节)、风格向量与风格距离矩阵、风格选择与项目约束、像素风的分辨率与调色板上限、调色板量化与抗锯齿替代、像素 tile 预算、2D 手绘的扁平色块与线宽规范、手绘资产的切分与复用;第二部分(第 4–8 章)讲低多边形的面数与顶点预算、平面着色与色块划分、引擎接入约束、NPR 的色阶带与描边参数、光照分层规范、写实 PBR 的通道打包与材质分区、写实的性能代价、厚涂的笔刷与色域参数规范、手绘贴图的分层与复用、体素的网格账与引擎接入;第三部分(第 9–14 章)讲等距投影的整数变换、等距 tile 与遮挡规则、二次元的色彩线条与角色比例规范、暗黑的饱和度分级与亮度分布、清新的高明度低饱和调色板、复古赛博的霓虹调色板与发光溢出、主题切换与变体管理、品类与预算及可读性的关系、跨品类复用与移植;第四部分(第 15–16 章)用 6 个主题包把同一份规范实例化六遍并给出 6×6 风格距离矩阵,再做三卷总收官。按章节提供仿真、逻辑内核与原型;配套工程与累计快照已有验证;具体范围以对应目录说明为准,按章复现、全部事实与练习另行验收。全书围绕虚构等距经营游戏《星屑旅店》与工具链 prism 展开。
《游戏美术与技术美术》卷二《技术美术与管线工程》全 50 篇。第一部分(第 1–6 章)讲 TA 的三类工作与能力矩阵、资产管线四阶段、导出单位与轴向对齐、真实 DCC 不可复现的 X 范式、导入设置与导入期校验、导入失败分级、依赖图的显式与隐式引用、环检测与悬空引用、不可达资源清理、装箱率与 mip 链字节账、图集变更传播、材质参数表与参数打包;第二部分(第 7–12 章)讲 LOD 分级与误差、屏幕占比与三角预算、LOD 切换跳变、骨骼数与调色板上限、蒙皮显存账、动画命名与状态绑定、混合空间与过渡、动画事件一致性、UI 安全区与多分辨率分级、合批归因、清单差异与增量回滚、缓存失效、规则引擎与门禁分级、误报与白名单治理;第三部分(第 13–15 章)讲中台判据与工具链分层、采纳率与维护成本、产能人天与吞吐、依赖排期的关键路径、工业化一致性、外包计价模型、超支归因与供应商质量门;第四部分(第 16 章)把全卷装成一条 10 阶段管线并回放 6 个主题。按章节提供仿真、逻辑内核与原型;配套工程与累计快照已有验证;具体范围以对应目录说明为准,按章复现、全部事实与练习另行验收。全书围绕虚构等距经营游戏《星屑旅店》与工具链 prism 展开。
《游戏美术与技术美术》卷一《美术制作与视觉规范》全 50 篇。第一部分(第 1–4 章)讲美术生产链路与角色分工、技术美术的位置与 ART_SCOPE 分工表、形容词转可测参数、风格向量与参考板、主色辅色强调色与明度梯度、色彩 token 化与跨场景一致性、sRGB 与线性空间、OKLab/OKLCH 与色盲安全对比度下限;第二部分(第 5–8 章)讲资产命名规则与目录层级、保留字与反模式、资产清单字段与依赖声明、清单与目录双向对账、面数与骨骼预算、材质槽与 Draw Call、超支归因、纹理 mip 链字节账、压缩格式显存差与整包预算表;第三部分(第 9–12 章)讲 UI 栅格与安全区、九宫格拉伸、UI 状态反馈、图标网格与描边、图集装箱率与批次耦合、剪影可读性与细节密度、场景模块化 kit、特效与动画预算;第四部分(第 13–16 章)讲外包需求书与交付物清单、验收与返工归因、评审时机与评分卡、走查记录、资产版本治理与大文件协作、diff 与回滚、Art Bible 装配与 6 主题回放。按章节提供仿真、逻辑内核与原型;配套工程与累计快照已有验证;具体范围以对应目录说明为准,按章复现、全部事实与练习另行验收。全书围绕虚构等距经营游戏《星屑旅店》与工具链 prism 展开。
《小游戏开发实战》卷五《跨平台发行与出海》全 50 篇。第一部分(第 1–4 章)讲海外小游戏平台分层与流量结构、各平台分成与结算条款、平台选择与组合、SDK 与广告 API 接入差异、上架审核与驳回、平台专属能力、平台抽象层与构建矩阵、无内购平台的纯 IAA 结构;第二部分(第 5–8 章)讲 i18n 资源结构与键设计、语言包加载与回退、文案膨胀与 UI 适配、文化禁忌与美术变体、日期数字货币与 RTL、伪本地化与语言 QA、本地化成本排期、分语言指标与小语种取舍;第三部分(第 9–12 章)讲 GDPR/CCPA 与 COPPA 的工程落点、同意管理与数据出境、ATT 与无 IDFA 归因、隐私沙盒、跨境收款与税务表单、内容版权与地区可用性、反作弊;第四部分(第 13–16 章)讲海外买量与素材合规、榜单竞品、五平台案例与出海方案装配。按章节提供仿真、逻辑内核与原型;本卷尚未纳入整卷项目复现;配置、共享模块、阶段与交付验收仍待验证。全书围绕虚构小游戏《合成小岛》与工具链 pebble 展开。
《互联网产品的客户端架构·内容、社交与实时互动》的完整目录与学习路径:13 章 39 节从内容端四条消费面讲到信息流、渲染、上传、互动、实时连接、重连补拉、在线状态、关系、通知、审核与搜索,附实验工程、三条阅读路径、数字与版本口径,以及读完应能回答的六个问题。
《小游戏开发实战》卷四《商业运营实战》全 50 篇。第一部分(第 1–4 章)讲投放后台的账户层级与出价方式、oCPM/CPA/ROI 出价与放量止损、素材工业化与衰减、移动归因与三方对账;第二部分(第 5–8 章)讲广告聚合架构与瀑布流竞价、广告位配置与 eCPM 分层、内购通道与订单补单、广告内容与未成年人合规;第三部分(第 9–12 章)讲渠道分级与联运分成、代理发行与合同条款、版号与资质倒排、平台结算与现金流;第四部分(第 13–16 章)讲运营 SOP 与分工边界、从 CAC 到 LTV 的完整账、失败模式复盘、操盘手册装配。按章节提供仿真、逻辑内核与静态清单;本卷尚未纳入整卷项目复现;配置、共享模块、阶段与交付验收仍待验证。全书围绕虚构小游戏《合成小岛》与工具链 pebble 展开。
前言说明卷二在四卷本中的位置、十三章的结构与依赖关系、贯穿案例「回声」的四条内容面、social-client-lab 的目录与三级可运行性,以及代码块三行头、数字口径、错误处理口径与本卷明确的边界,帮助读者决定从哪一章开始读、按什么路径读。
卷一讲清楚端上约束之后,真正难的部分才开始:内容要滚动、互动要即时、连接会断。这篇序说明为什么内容、社交与实时互动值得单独成卷,四条消费面共享哪四条核心判断,本卷十三章如何排布、坚持哪些立场、写给哪些读者,以及明确不承诺什么、与卷一如何衔接。
《互联网产品的客户端架构·内容、社交与实时互动》全 45 篇:13 章正文覆盖内容四条消费面、信息流、富文本、上传、互动、实时连接、重连补拉、在线状态、关系、通知、审核与搜索;附序、前言、目录与三篇附录,配可运行的 TypeScript 实验工程。
一份可直接用于客户端架构评审的清单:从评审前要准备的材料,到约束与端形态、质量预算、分层依赖、状态归属、路由与深链、数据离线、组件契约、构建产物、渲染路径、错误降级、观测与发布兼容十二个维度,每条给出判定标准与常见反例,并附十条自检总表与评审后的跟踪方式。
按用户可描述的症状组织的端上排查手册:白屏、首屏慢、滚动卡顿、内存增长、请求失败、状态丢失、崩溃、深链打不开与版本兼容异常,每种症状都给出按概率排序的原因、验证步骤、处置建议和需要补的观测,并附从产物到渲染的跨症状排查顺序、现场记录模板与常见误判。