这里是全站文章的归档入口,下面是按时间倒序排列的全部文章。若想按主题浏览,请从首页的专题分类进入。
《AI Agent 高级编程》11.1 平台化:Agent 注册、版本与配额
把单实例 ResearchCopilot 推进成多 Agent 平台:用一份可运行的注册表实现 Agent 的注册、发现与 semver 版本路由,再用配额账本在调用前完成扣减与拒绝。附真跑输出,并给出「平台替你做了什么、你又让渡了什么」的对照表。
posts
这里是全站文章的归档入口,下面是按时间倒序排列的全部文章。若想按主题浏览,请从首页的专题分类进入。
把单实例 ResearchCopilot 推进成多 Agent 平台:用一份可运行的注册表实现 Agent 的注册、发现与 semver 版本路由,再用配额账本在调用前完成扣减与拒绝。附真跑输出,并给出「平台替你做了什么、你又让渡了什么」的对照表。
服务端与客户端首帧不一致通常来自时钟、随机数、本地状态与权限四个来源,本节用字段级帧对比把它们分开,给出可运行的 TypeScript 差异检测器与八组测试,检测器不依赖浏览器,只在进程内比较两棵字段树并标出可延后项,所有结论都由测试固定,方便照搬到自己的组件树。
把支付回调当作不可信外部输入:用 HMAC 覆盖 provider、kid、时间戳、nonce 与 body 哈希,按密钥有效期选择 kid,验签后查重放并核对订单金额与币种;附密钥轮换重叠窗、四类失败路径的测试与真实 go test 输出。
把 Maven 生命周期还原成一条可执行的流水线:validate、compile、test、package、verify、install、deploy 各自做什么,为什么 mvn package 会顺带跑测试,target 下每个目录从哪来;再用 library 工程实跑 compile、test、package,检查 jar 内容与 No tests to run 的真实输出。
把 CSR、SSR、SSG 与流式放回成本与页面类型的约束里,用七项页面特征推导渲染模式,给出可运行的 TypeScript 选择器与七组测试,逐条说明每种模式被拒绝的理由,并复盘一次把商品详情页从 SSR 改成 SSG 的收益与回退边界,所有结论都用本机测试固定。
把 library 拆成 com.plume.library 与 com.plume.library.cli 两个包,用 public、包私有、protected、private 四种可见性解释谁能看见谁,并用真实编译错误验证包私有边界;再对比 classpath 与 module path,给出 module-info.java 的 exports/requires 写法与卷一不启用模块的理由。
从零走完 Hello, Library 的完整链路:源码、javac -d、包目录、class 文件、java -cp 逐层拆解,解释 main 签名与 args 的来源;再用 javap 看字节码、用 --release 21 对比 class 文件版本,并给出文件名不匹配、缺少 main、类路径写错三类真实报错。
《AI Agent 工程实战》全书导航页:说明本卷定位、读者画像与前置知识、六到八周学习节奏与三条阅读路径,交代贯穿项目 ResearchCopilot 与「与既有 AI 专题的分工」,并按六个部分列出 18 章 54 节的完整章节索引,另含常见问题速查表与通往卷三的路线。
收官节分三块收束全卷:上线检查单、上线后的观察节奏(第 1 小时/第 1 天/第 1 周各看什么、何时回滚)、把线上失败与成本异常回流成评测样本与优化项的迭代闭环。再给出可选的真实 API 端到端冒烟流程与代码,明确标注需自备密钥、本机未执行,并用假模型跑同一脚本做离线等价验证,最后给全卷回顾与通往卷三的路线。
设计三个受控故障演练:模型超时(假模型注入延迟,验证超时止损与降级链)、DB 不可达(连不存在的端口,验证 readiness 摘流量与明确报错)、队列积压(往队列塞远超消费能力的任务,验证背压与告警)。每个都写清注入方式、预期表现、观测点、恢复动作与复盘问题,并逐个在本机真跑贴出日志、耗时与队列深度,最后给出复盘模板表。
收官章先把全卷散落的工程决策收成一份可执行清单:接口与契约、数据与一致性、并发与资源、可观测与告警、安全与合规五组,每条给出可判定的通过标准。再给一套容量估算方法,用一个真跑的脚本代入具体参数,算出每日 token、模型成本、DB 增速、Redis 内存与 worker 数。
从内容哈希、缓存头语义、版本兼容窗口和旧资源退役四条线,给出可运行的 TypeScript 缓存决策函数与八组测试,解释 immutable 的前提、HTML 与 Service Worker 为什么必须回源校验,以及灰度窗口内旧哈希文件应该保留多久。
从订单 API 的 JSON 边界讲到业务边界:64 KiB 体积上限、未知字段拒绝、单对象校验、SKU/数量/金额/总额范围与重复项拒绝,再把日志字段分为 public/internal/pii/payment/secret 五类做脱敏,附表驱动测试与真实 go test 输出。
把构建产物的体积拆成产物、模块与包装开销三个口径,给出按模块归因、按预算阈值判定 pass/warn/fail 的 TypeScript 检查器与八组测试,讨论重复模块、贡献榜和超限后的处理顺序,并说明为什么抬高预算通常是最后而不是最先做的动作。
把 IDE、JShell 与命令行放在同一套工作流里:用 JShell 快速验证表达式和 library 的字符串格式,用 javac/java 理解编译与运行的分工,再说明 IDE 导入 Maven 工程、指定 JDK 25 和避免提交 .idea 的具体做法,最后给出三套工具之间切换的检查清单。
把 library 从单文件 javac 推进到 Maven 工程:解释 groupId、artifactId、version 与标准目录结构,逐项拆开最小 pom.xml 里的 release 与编码配置,再用 mvn compile 验证 target/classes 的产物,并列出目录放错、POM 缺失、编码未设三类常见故障。
汇总本次完整项目复现中的启动、API、循环、预算、引用、取消、恢复和写操作边界,提供可执行排查路径。
区分标准库离线项目、可选 SDK/HTTP 环境和付费冒烟,明确版本、运行入口、SSE 与 TypeScript 验证边界。
整理 FakeModel、合成夹具与真实录制的区别,提供标准库回归、练习验收点及已运行的参考检查。
核对全卷项目公开 API、模块归属、停止条件、会话、预算与计费边界,提供已复现项目与运行入口。