这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
《互联网产品的客户端架构·交易、增长与平台化》9.1 分享卡片的参数与归因
分享链接不是拼几个查询参数，而是一份要穿过渠道、安装包和归因窗口的承诺。本节拆开渠道码、活动 id、邀请人、商品与时间戳的生成与校验，说明分享卡片和落地页不一致时以谁为准、参数丢失后如何兜底，并给出一个可运行、可测试的 L1 分享参数与归因模型。
posts
文章归档
PlumePHP 全站文章的归档入口，按时间倒序汇总各专题的技术文章，并提供按主题浏览的专题分类入口。
《互联网产品的 AI 架构·模型接入与能力边界》6.1 提示是产物，不是字符串
「回声」把运营活动文案整段塞进 system 后，智能回复开始复读活动、忽略用户问题。本节由此说明提示为什么是产物而不是字符串：模板、变量声明、版本、所有者与评审缺一不可，并用可运行的 TypeScript 实现受限模板语法、编译期变量校验与严格渲染，最后复盘一次靠记忆改提示的事故。
《Java 编程实战》附录 A Maven 配置模板
给出一套可直接对照的 libraryd 多模块 Maven 配置：父 POM 的属性与 dependencyManagement、五个子模块的依赖声明、编译与测试插件、Enforcer、JaCoCo、Checkstyle、SpotBugs、Shade、Jib 的完整片段，以及 quality、integration 两个 profile 与常用诊断命令。
SDK 与示例：薄封装边界、版本策略与多语言维护成本
从手写两套 SDK 拖了三个月的教学案例讲起，给出要不要做 SDK 的三个可观测判据、生成与手写的分工边界、版本对应与弃用节奏，以及按语言复算年维护成本、采用率和接入步骤差的验收方法，并说明示例仓库的跑通标准与低成本替代方案。
对外 Webhook：事件签名、重试、幂等与死信队列
从一次付款成功事件漏投的教学案例讲起，拆解对外 Webhook 的事件信封与版本、HMAC 签名与时间戳防重放、带抖动的重试窗口与幂等键、死信队列与订阅方自助排障，并给出可复算的有效投递率和重复投递率验收口径，以及本地接收器的复现步骤。
配额与限流：免费层、突发额度与超额计费
免费层开大了会破产，开小了没人愿意试。本文给出按请求、按 token 与按任务三种计量口径的取舍，免费层覆盖率怎么算，令牌桶与突发额度如何设置，429 响应头、软硬上限、超额计费的可解释性与异常用量识别，附 8 条验收清单与复算示例。
《游戏服务端架构·品类、状态与拓扑》12.2 时序图、状态机与契约表
《裂隙战场》的一次断线重连在时序图上只有三条箭头，线上却出现房间已满、票据过期、重复重连三个异常。本节把时序图限制在跨边界交互，用状态机覆盖异常路径，用契约表固定请求、响应、错误与幂等键，并给出三者同源的 Go 校验：不可达状态、未覆盖错误和缺失幂等键都会被测试拒绝。
《后端架构设计·分布式与数据一致性》前言
说明卷三怎么用：13 章四段结构、arch-lab 新增的时钟/复制/共识/分片/事务/对账组件、L1–L4 可运行性分级、代码块 file/tier/verify 标记、S1–S3 固定场景、实测与目标与示例的数字口径，以及顺序阅读和带着一次跨库改造来读的两条路线。
API key 管理：签发、最小权限、轮换与泄露响应
一次复制粘贴就能让 API key 出现在公开仓库里。本文给出签发与环境隔离、按端点最小权限、审计字段的设计、轮换重叠期，以及泄露后 0–24 小时的处置顺序与负责人分工，并附影响面复算口径、8 条验收清单和一次可执行的桌面演练方法。
API 规范：OpenAPI 契约、统一错误模型与分页约定
三个端点把同一个错误返回成三种形状，客户只好写三套解析。用 OpenAPI 当单一事实源，固定字段与时间格式，统一错误信封与状态码语义，再定游标分页、过滤白名单与幂等键保留期，最后用契约覆盖率与错误码重复率两个数字验收，且都要能复算。
要不要做 API：三类买家、收入结构与退出条件
三个客户都问有没有接口，真正付费的只有一个。把 API 当独立产品线来算：三类买家的稳定性要求、三种收入结构的对账成本、五项固定开支与四条退出条件，并复算每千次调用成本与保本量。先证明有人为可编程访问单独付钱，再写第一个端点。
《后端架构设计·分布式与数据一致性》序
为什么卷二之后还要单独写分布式与数据一致性：跨库半成功、库存超卖、切换后订单倒退三个场景，暴露了单机结论的边界。这篇序交代卷二留下的六个未证明假设、本书的四个立场、Go 主线与 Java 21 对照的口径，以及不伪造多节点实测、不承诺生产级 Raft 的边界。
《游戏服务端架构·品类、状态与拓扑》12.1 C4、部署视图与数据流
北辰工作室的架构图半年后就和仓库对不上：匹配服务拆了、存储换了、分片扩了，图还在原处。本节用上下文、容器、组件、部署四类视图加数据流视图，说明每类视图的读者与更新频率，并给出锚点校验、悬空链接检查和跨视图一致性检查的 Go 实现，让图和代码不再各说各话。
《游戏服务端架构·品类、状态与拓扑》11.3 故障域与爆炸半径
《裂隙战场》一台战斗节点故障带走 250 间房，而一个单实例会话存储故障能让全部品类同时掉线。本节把故障域分为进程、节点、机架、可用区和地域，用容量占比度量爆炸半径，给出舱壁、配额、独立连接池与去相关部署的取舍，并用 Go 实现的故障域树计算单房间、单节点与单可用区故障的影响面。
《游戏服务端架构·品类、状态与拓扑》11.2 有状态服务的边界
《裂隙战场》的房间服在滚动重启时丢掉进行中的对局，租约过期后新旧两个房间进程同时写结算，造成双份奖励。本节比较状态外置、分区归属、主备租约三条出路，给出房间服、地图服、会话服的边界，并用带 fencing epoch、续约、drain 与双主拒绝的 Go 租约注册表说明重启、迁移和缩容时如何不丢状态。
商店页素材：截图顺序、演示视频与版本同步验收
用户第一眼看到的不是产品，是商店页的那五张图。首图放 logo、截图顺序没有逻辑、界面改版三个月素材还是旧的，都会让下载量白白流失。本文给出各商店素材清单、结果到流程的叙事顺序，以及素材与版本同步的验收方法。
版本节奏与回滚：发布列车、兼容窗口与一次撤回
安装包、更新清单与商店三处的版本号对不上，用户就装不到新版本；回滚时找不到可下载的旧包，撤回就只剩道歉。本文给出固定发布列车与紧急通道、三处版本一致性验收、N−2 兼容窗口，以及一份能在半小时内执行的回滚 runbook。
原生商店审核：Mac App Store、Microsoft Store 与 App Store 的拒绝点
审核不是一次提交，而是一段需要排期的不确定时间。演示账号没给、隐私申报漏项、账号删除入口缺失、元数据写得比产品强，都会换来一次拒绝与三五天等待。本文拆开四类原生商店的差异、五类高频拒绝与一次通过的提交清单。
《互联网产品的客户端架构·交易、增长与平台化》8.3 权益降级与到期提醒
会员到期不是一瞬间的 UI 状态：权益会逐条失效，提醒要按节奏升级，已支付订单还要保住下单时的会员价。本节把降级拆成权益比较、提醒阶段与订单价格快照三层，说明为什么已支付订单永久锁价、待支付订单只保留到支付截止时间，并给出一个可测试的 TypeScript 模型。
移动端内测与分阶段发布：TestFlight、封闭测试与 1% 灰度
移动端分阶段发布不是精确的功能分流。本文区分 TestFlight 内测、App Store 七天自动更新节奏与 Google Play 自定发布比例，说明手动下载、暂停和已升级用户的边界，并用实际新版本会话核算崩溃率，给出观察窗口、暂停信号与发布检查清单。