posts

《互联网产品的 AI 架构·平台化与治理》 · 已发布章节索引(45 篇)

《互联网产品的 AI 架构·平台化与治理》全 45 篇:13 章正文覆盖治理对象与职责、能力目录与所有权、版本兼容、多租户配额、评测平台、质量与成本运营、合规与安全治理、平台工程、组织流程与长期演进;附序、前言、目录与三篇附录,配可运行的 TypeScript 实验工程。

全书 45 篇:13 章正文 + 序、前言、目录 + 附录 A/B/C。每节配可运行的 TypeScript 代码,代码块用 // file: / // tier: / // verify: 标注,可在实验工程中逐字节还原。

本页是卷三的完整索引。可以从目录与学习路径 按顺序通读,也可以按问题跳读。

全书概览

项目内容
书稿《互联网产品的 AI 架构》卷三
已发布篇数45 篇(含目录与附录)
主线语言TypeScript(Node 26 原生类型剥离,零第三方依赖)
贯穿案例内容社区 + IM + 轻交易「回声」
阅读方式目录篇顺序通读,或按章节表跳读
上级专题书稿专题

前置

篇文章核心内容
序序从同一能力被多团队调用、配额争抢与版本漂移讲起,说明治理的四个对象。
前言前言13 章结构、src/gov 模块地图、L1/L2 分级、代码块约定与阅读节奏。
目录目录13 章 39 节、三条阅读路径、十五个问题、每章产出物与实验工程说明。

第 1 章 治理问题与边界

节文章核心内容
1.11.1 从一条链路到很多条链路:回声的规模化现场回声从三条链路扩到多团队、多租户后,治理问题不再是单条链路的重试与预算。本节把能力重复、版本漂移、配…
1.21.2 治理的四个对象:能力、调用方、租户、版本治理不是给网关再加一层看板,而是先回答「治什么」。本节把能力、调用方、租户、版本四个对象各自的字段、…
1.31.3 平台与业务的职责边界平台与业务的边界不能靠「谁更懂」来划,否则每次事故都会重新吵一遍。本节把提示、契约、配额、版本、模型…

第 2 章 能力目录与所有权

节文章核心内容
2.12.1 一条能力条目的最小字段卷三 11.3 给出了能力目录的七个字段,但没有回答字段如何被机器校验。本节把条目扩展为十一个最小字…
2.22.2 提供方与调用方的契约能力条目只写了提供方的一半承诺。本节把契约拆成提供方承诺与调用方义务:输入约束、配额、重试、缓存键与…
2.32.3 能力退役与迁移退役不是删除目录条目,而是一次跨团队迁移项目。本节把退役拆成公告、双跑、下线三个阶段,定义 90 天…

第 3 章 版本与兼容治理

节文章核心内容
3.13.1 契约版本与兼容规则契约版本治理要回答三件事:哪些变更兼容、版本号怎么升、灰度怎么退。本节按输入、输出、错误码与行为四个…
3.23.2 模型与提示版本的联动模型换代、提示改版、评测集换版如果各发各的,契约版本不变而行为已经变了。本节把三者绑成「能力版本」三…
3.33.3 版本矩阵与弃用窗口五个能力乘三个模型代际就是十五个格子,再加上提示与评测集,矩阵会迅速失控。本节给出 active、d…

第 4 章 多租户与配额

节文章核心内容
4.14.1 三层配额:总额、份额、单次多租户配额不是把预算除以人数。本节把租户总额、团队份额、单次上限拆成三层账本,定义统一的微元计量、固…
4.24.2 公平性与优先级配额只回答「能不能花」,公平性回答「资源紧张时先给谁」。本节给出租户、团队、任务价值三层判据,用价值…
4.34.3 借用、回收与隔离低峰借用、高峰归还是额度治理里最容易口头约定、最难回收的一环。本节定义借用的四个前置条件与到期、高峰…

第 5 章 评测平台

节文章核心内容
5.15.1 评测集的治理:版本、来源与污染评测集一旦被多个团队共用,版本、来源与污染就会变成治理问题。本节定义评测集的三段版本、人工/线上/合…
5.25.2 自动化回归与门禁门禁要回答三件事:哪些改动必须拦、样本要多少、证据留多久。本节把门禁分为提交级、发布级与模型换代级,…
5.35.3 人工评审与仲裁人工评审不是抽检的补充,而是语义边界与新型失败的唯一入口。本节定义高风险全检、常规按比例的分层抽样,…

第 6 章 质量运营

节文章核心内容
6.16.1 线上质量信号与抽检线上质量不能只看满意度均分。本节把点赞、采纳、转人工、重复提问与投诉定义成五类可计量的信号,给出按请…
6.26.2 质量事故的分级与响应事故分级不能靠群里的音量。本节把质量事故拆成危害事实与影响范围两组输入,给出 P0 到 P3 的判定…
6.36.3 质量报告与季度复盘总体合格率下降 0.5 个百分点,三个能力的合格率却都上升了。本节给出季度复盘的六段结构、基线冻结口…

第 7 章 成本治理的组织视角

节文章核心内容
7.17.1 预算、账单与归因的分工预算、账单与归因常被当成同一本账,超支时三个团队只能互相指责。本节区分三本账的时点、单位、责任人与粒…
7.27.2 成本分摊与内部计价共享池只有一笔钱,按用量、按收益、按固定比例却会算出三张完全不同的账单。本节定义按次、按千 toke…
7.37.3 优化优先级与投资回报优化清单按节省额排序,往往把预算压在一个回本慢、风险高的项目上。本节把节省额、回本期、质量风险与实施…

第 8 章 合规与数据治理

节文章核心内容
8.18.1 数据分级与出域数据分级不是给整份文档贴一个标签,而是给字段定级、再取最高项。本节给出公开、内部、敏感、受限四级与每…
8.28.2 留存、删除与审计删除请求发出后,主库删掉不等于数据消失:缓存、日志、检索索引、评测集和备份都可能是副本。本节定义各存…
8.38.3 供应商合规与模型变更通知供应商换模型、改价格、调整训练策略时,通知期往往比技术方案更先决定风险。本节给出数据处理协议、区域、…

第 9 章 安全治理

节文章核心内容
9.19.1 提示与工具的风险登记风险登记表不是漏洞清单,而是把提示注入、工具滥用、数据外泄与越权动作变成可评分、可复查、可追责的条目…
9.29.2 红队与滥用检测红队是计划性的证据生产,滥用检测是持续性的信号发现,两者都不能用一次总通过率代替。本节定义红队计划的…
9.39.3 事故响应与披露安全事件响应不是一份事后复盘模板,而是分级、止血、取证、披露四条并行的时间线。本节定义 sev1 到…

第 10 章 平台工程

节文章核心内容
10.110.1 平台的自助服务边界自助服务不是把所有按钮都放开。本节把回声平台的七类请求拆成四类自助与三类人工,用准入目录、档位、额度…
10.210.2 SDK、CLI 与配置分发同一个能力,三个团队跑出三种行为。本节把问题拆成 SDK 与 CLI 的职责分界、六层配置覆盖、灰度…
10.310.3 平台自身的 SLO 与容量平台说自己 99.99% 可用,业务方却每天遇到失败。本节把平台 SLO 拆成网关、配额与评测三个部…

第 11 章 组织与流程

节文章核心内容
11.111.1 谁拥有 AI 能力:平台团队与业务团队能力归属不能按组织架构图分配。本节给出平台全权、业务全权、平台管契约业务管内容三种模型,用七个现场事…
11.211.2 评审委员会与决策记录评审委员会的价值不在开会,而在可重算的决策记录。本节定义七个席位的职责、七类议题的到会人数与否决席,…
11.311.3 培训、文档与知识传递文档不是写完就算,培训也不是听一次课。本节把文档分为入门、操作、参考、决策四层,按槽位而不是篇数计算…

第 12 章 长期演进

节文章核心内容
12.112.1 模型换代与迁移计划模型换代不是改一个模型 ID,而是一次跨团队迁移。本节给出迁移计划的六个字段与五个阶段(评估、影子、…
12.212.2 技术债与退出条件兼容层留了两年、旧提示没人敢删、两个能力永远在合并路上,技术债的问题不是记不住,而是没有退出条件。本…
12.312.3 治理的度量:不是流程数量治理周报列了 47 个流程、12 个委员会,变更失败率却从 10% 涨到 16.67%。本节用五个结…

第 13 章 卷四收口与全书回顾

节文章核心内容
13.113.1 治理基线:回声的平台化清单前十二章分别讲了目录、版本、配额、评测、质量、成本、合规、安全与平台工程,但团队真正需要的是能勾选的…
13.213.2 一次跨团队治理评审治理基线只有进入评审桌才有意义。本节还原回声 2026 年 11 月 5 日的一次真实形态评审:内容…
13.313.3 全书回顾与继续阅读四卷分别回答能力边界、链路性能、多能力协同与多团队治理四个问题,但它们不是四个可以随意套用的模板。本…

附录

篇文章核心内容
附录 A附录 A 治理角色与职责速查六类角色的职责、决策权、产物与交接物,附 RACI 表与冲突裁决。
附录 B附录 B 能力目录与配额字段速查能力条目、提供方/调用方契约、三层配额与版本矩阵字段表。
附录 C附录 C 平台化评审清单十三组六十五问、评审流程、结论模板与季度复盘表。

实验工程

ai-lab 在卷一至卷三基础上新增 src/gov/:scope、catalog、versions、quota、eval-platform、quality-ops、chargeback、compliance、security-gov、platform-eng、org、evolution-gov、baseline 等模块。全部零第三方依赖,每个模块配 node --test 用例;书稿代码块与源文件逐字节一致。

上一卷

上一卷《多能力编排与任务闭环》回答“多个能力怎样协同”:结构、交接、执行图、失败传播、评测与权限。

本卷是四卷本的收口:把前三卷的能力契约、度量与编排产物放进同一套所有权、版本、配额、评测与合规制度中,并给出全书回顾与继续阅读方向。

全部文章 Books game Java Indie golang 客户端开发 Minigame Saas rust Python
books

《互联网产品的 AI 架构·平台化与治理》附录 C 平台化评审清单

把平台化治理压缩成一份可打印的评审清单:目录、所有权、版本、配额、评测、质量、成本、合规、安全、平台工程、组织、演进与收口十三组共六十五问,每组附通过判据与常见驳回,并给出三个快速判据、四十五分钟评审流程、结论模板、季度复盘表与三个常见误区,帮助评审现场把结论写成可验证的条件。

11 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》附录 B 能力目录与配额字段速查

把能力目录、契约、配额与版本矩阵四类字段压成可直接照抄的速查表:每个字段给出类型、是否必填、示例与缺失后果,覆盖能力条目十八字段、提供方与调用方请求响应字段、租户总额与团队份额与单次上限三层配额、契约模型提示策略评测五版本矩阵,并给出六层校验顺序、失败输出样例与最小可用条目。

10 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》附录 A 治理角色与职责速查

把卷四的治理角色压成一页可查的职责表:平台团队、能力提供方、调用方、租户管理员、安全合规与评审委员会六类角色,逐项列出职责、决策权、明确不负责的边界与交接物,附一张十二行 RACI 表、角色与治理对象对应关系、三个真实职责冲突的裁决过程,以及交接物验收口径,便于在跨团队评审现场直接定位责任主体。

11 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》13.3 全书回顾与继续阅读

四卷分别回答能力边界、链路性能、多能力协同与多团队治理四个问题,但它们不是四个可以随意套用的模板。本节回顾四卷的分工与各自边界,给出四组可对齐的计量口径,逐条说明这套架构在单团队、低调用量、单租户、单一供应商、短周期业务与无裁决权组织里为什么不适用,并按架构师、平台工程、安全合规与业务负责人给出继续阅读方向。

14 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》13.2 一次跨团队治理评审

治理基线只有进入评审桌才有意义。本节还原回声 2026 年 11 月 5 日的一次真实形态评审:内容团队要把摘要与审核能力开放给创作者工具,七个参会方带来七份证据,四个争议点分别涉及重复建设、额度借用、评测隐私与放量节奏。文章给出决议规则、待办跟踪与一次反例,并用确定性代码演示基线如何把结论限定为试点。

10 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》13.1 治理基线:回声的平台化清单

前十二章分别讲了目录、版本、配额、评测、质量、成本、合规、安全与平台工程,但团队真正需要的是能勾选的一张表。本节把治理对象、目录字段、版本矩阵、配额、评测门禁、四类流程、平台 SLO 与所有权压成 12 条基线条目,每条给出判据、证据与责任人,并用确定性代码算出通过、部分、失败与总体结论,最后说明 blocking 项与非 blocking 项的区别。

10 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》12.2 技术债与退出条件

兼容层留了两年、旧提示没人敢删、两个能力永远在合并路上,技术债的问题不是记不住,而是没有退出条件。本节给出五类债与五种退出动作,把调用方、流量、静默天数与证据写成可判定条件,并说明永远不还的债如何按年化成本单独记账,让还债与做新功能能在同一张预算表上比较。

9 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》12.1 模型换代与迁移计划

模型换代不是改一个模型 ID,而是一次跨团队迁移。本节给出迁移计划的六个字段与五个阶段(评估、影子、两档灰度、全量),用确定性代码判定推进、保持与回滚,并把灰度比例、回滚红线和旧模型下线日写成可执行条件,最后说明它如何与卷四 3.2 的版本矩阵衔接。

8 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》11.3 培训、文档与知识传递

文档不是写完就算,培训也不是听一次课。本节把文档分为入门、操作、参考、决策四层,按槽位而不是篇数计算覆盖度,参考文档必须钉住当前主版本,受监管能力的操作与参考文档 90 天复审;培训路径按读、跟岗、受控独立、独立四阶段单调推进;新人上手用「首次独立上线且复核通过」定义,示例样本上中位数 31 天、P90 44 天。

10 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》11.2 评审委员会与决策记录

评审委员会的价值不在开会,而在可重算的决策记录。本节定义七个席位的职责、七类议题的到会人数与否决席,给出「流会、否决、弃权、票数」的判定顺序,并用代码把 outcome 从 ballots 重算出来。示例样本上五个议题得到批准、流会与否决三种结果,四条记录中三条因结果不一致、缺条件或复查超期被拒绝。

9 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》11.1 谁拥有 AI 能力:平台团队与业务团队

能力归属不能按组织架构图分配。本节给出平台全权、业务全权、平台管契约业务管内容三种模型,用七个现场事实排出判定顺序,并把结论落到能力目录的 owner 字段:accountable、contractOwner、contentOwner、oncall、escalation 与复查周期。配套代码校验模型、团队类型与复查节奏,示例样本上五条能力得到三种归属,三条问题条目一次返回八个错误。

10 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》9.1 提示与工具的风险登记

风险登记表不是漏洞清单,而是把提示注入、工具滥用、数据外泄与越权动作变成可评分、可复查、可追责的条目。本节定义风险类别、影响面、可能性、现有控制、剩余风险、负责人与复查日期七个字段,用确定性代码计算剩余分与复查到期,并给出红队与事件回写登记表的接口。

11 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》8.3 供应商合规与模型变更通知

供应商换模型、改价格、调整训练策略时,通知期往往比技术方案更先决定风险。本节给出数据处理协议、区域、留存、训练用途、变更通知与安全通告六类清单字段,按数据级别收紧要求,并用可运行判定把变更分为接受、有条件接受与拒绝,同时给出通知窗口与评估流程。

10 分钟阅读
书稿 互联网产品 AI 架构
books

《互联网产品的 AI 架构·平台化与治理》8.2 留存、删除与审计

删除请求发出后,主库删掉不等于数据消失:缓存、日志、检索索引、评测集和备份都可能是副本。本节定义各存储的留存上限与删除传播时限,用确定性回执检查每条路径,生成可复核的删除证明,并给出审计记录的最小字段与校验规则,避免删了主库却留下副本而无人察觉。

10 分钟阅读
书稿 互联网产品 AI 架构