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 架构·平台化与治理》8.1 数据分级与出域

数据分级不是给整份文档贴一个标签,而是给字段定级、再取最高项。本节给出公开、内部、敏感、受限四级与每级允许的出域方式、区域、留存和训练用途,把它们落成能力目录的五个字段,并用可运行的路由校验回答一条客服消息能否发给某个指定模型,而不是靠文档约定。

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

《互联网产品的 AI 架构·平台化与治理》7.3 优化优先级与投资回报

优化清单按节省额排序,往往把预算压在一个回本慢、风险高的项目上。本节把节省额、回本期、质量风险与实施成本放进同一套门槛和评分,先判断能不能做,再决定先做哪个,并用示例样本上的 1 亿实施预算说明最大节省项为何被推迟、被拒绝与推迟又有何不同。

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

《互联网产品的 AI 架构·平台化与治理》6.3 质量报告与季度复盘

总体合格率下降 0.5 个百分点,三个能力的合格率却都上升了。本节给出季度复盘的六段结构、基线冻结口径,用可运行代码把差异拆成份额、分段率与交叉项,并列出不该进入质量报告的指标:无分母计数、序数平均、口径不明的准确率与使用量,最后说明行动项如何验收。

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

《互联网产品的 AI 架构·平台化与治理》6.1 线上质量信号与抽检

线上质量不能只看满意度均分。本节把点赞、采纳、转人工、重复提问与投诉定义成五类可计量的信号,给出按请求数归一、按能力与租户切分的口径,并用可运行代码计算抽检样本量、Wilson 置信区间与分层配额,最后说明小样本为何必须合并发布、为什么只能报区间。

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

《互联网产品的 AI 架构·平台化与治理》5.3 人工评审与仲裁

人工评审不是抽检的补充,而是语义边界与新型失败的唯一入口。本节定义高风险全检、常规按比例的分层抽样,作者与利益冲突过滤的双盲派单,48 小时分歧仲裁,以及用金标样本做评审员校准的阈值,并给出示例样本上的抽检、仲裁与校准结果,评审记录还会回流到评测集版本。

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

《互联网产品的 AI 架构·平台化与治理》5.2 自动化回归与门禁

门禁要回答三件事:哪些改动必须拦、样本要多少、证据留多久。本节把门禁分为提交级、发布级与模型换代级,逐级给出指标阈值、样本下限、豁免窗口与证据留存,并用可运行代码在示例样本上演示缺失即失败、硬指标不可豁免、证据包可复现的判定过程,并把结论写入治理报表。

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

《互联网产品的 AI 架构·平台化与治理》5.1 评测集的治理:版本、来源与污染

评测集一旦被多个团队共用,版本、来源与污染就会变成治理问题。本节定义评测集的三段版本、人工/线上/合成三层来源与配额、训练与调优语料的污染检查、90 天更新节奏,并用可运行代码在示例样本上给出 0 个结构错误、1 次主版本升级与 3 条污染命中的判定结果。

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

《互联网产品的 AI 架构·平台化与治理》4.3 借用、回收与隔离

低峰借用、高峰归还是额度治理里最容易口头约定、最难回收的一环。本节定义借用的四个前置条件与到期、高峰、强制三级回收顺序,用回声的 1,000 万借用示例跑出债务 500 万的回收结果,并给出缓存键、向量命名空间、日志与限流的租户隔离校验,并说明借用协议应写入的治理流程。

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

《互联网产品的 AI 架构·平台化与治理》4.2 公平性与优先级

配额只回答「能不能花」,公平性回答「资源紧张时先给谁」。本节给出租户、团队、任务价值三层判据,用价值权重压住基础优先级造成的反转,用有上限的老化与强制位防止低价值任务饿死,并在 20,000 微元容量上跑出一轮可复核的调度顺序,并说明公平性验收的四个可计算指标。

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

《互联网产品的 AI 架构·平台化与治理》4.1 三层配额:总额、份额、单次

多租户配额不是把预算除以人数。本节把租户总额、团队份额、单次上限拆成三层账本,定义统一的微元计量、固定扣减顺序与拒绝、降档、排队三种超限行为,并用回声的 1 亿、4,000 万、6,200 微元示例跑出可复核的拒绝位置与剩余额度,并给出配额变更的审批边界。

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

《互联网产品的 AI 架构·平台化与治理》3.2 模型与提示版本的联动

模型换代、提示改版、评测集换版如果各发各的,契约版本不变而行为已经变了。本节把三者绑成「能力版本」三元组,给出七种变化组合的联动规则、原子回滚矩阵与确定性测试,并说明提供方、调用方与平台各自该签什么字、如何用评测证据约束版本发布,以及迁移窗口内怎样保持基线可比。

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

《互联网产品的 AI 架构·平台化与治理》3.1 契约版本与兼容规则

契约版本治理要回答三件事:哪些变更兼容、版本号怎么升、灰度怎么退。本节按输入、输出、错误码与行为四个面列出十类变更的兼容判定,用可运行代码计算所需版本位、拦截版本号作弊,并给出 9 项变更、7 项不兼容的示例结果、灰度举证方式与多团队发布流程。

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

《互联网产品的 AI 架构·平台化与治理》2.3 能力退役与迁移

退役不是删除目录条目,而是一次跨团队迁移项目。本节把退役拆成公告、双跑、下线三个阶段,定义 90 天公告期、30 天双跑窗口与强制下线的四项判据,用确定性状态机校验日期顺序、迁移工具、调用方迁移率与残余流量,并给出示例样本上 5 个调用方从 100% 迁移到 1.1% 残余的判定结果。

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

《互联网产品的 AI 架构·平台化与治理》2.2 提供方与调用方的契约

能力条目只写了提供方的一半承诺。本节把契约拆成提供方承诺与调用方义务:输入约束、配额、重试、缓存键与反馈渠道,并规定可覆盖参数的责任归属。用确定性代码校验三个月度配额共 1 亿微元、单次上限 6,200/4,200/3,000 的调用方契约,给出 11 个违约码与两个覆盖参数的归属判定。

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

《互联网产品的 AI 架构·平台化与治理》2.1 一条能力条目的最小字段

卷三 11.3 给出了能力目录的七个字段,但没有回答字段如何被机器校验。本节把条目扩展为十一个最小字段,定义标识、契约、默认档位、可覆盖参数、失败语义、计费单位、SLA、下游依赖与退役日期的 schema,用确定性代码检查缺字段、契约错配、依赖环和退役顺序,并逐条说明缺字段在调用、计费、迁移中的后果。

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

《互联网产品的 AI 架构·平台化与治理》1.3 平台与业务的职责边界

平台与业务的边界不能靠「谁更懂」来划,否则每次事故都会重新吵一遍。本节把提示、契约、配额、版本、模型、评测、事故、租户与工具九类任务做成可判定的职责表,用确定性函数返回 platform、business 或 shared 及判定依据,并给出七类越界信号的评分口径与三档处置。

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