电子书籍

《Go 语言编程入门》6.3 errors.Is/As 与自定义错误

本节收尾 TaskAPI 的错误体系。讲清 errors.Is 判根因、errors.As 取回结构化错误类型的区别与用法，实现带字段的 ValidationError 与自定义 Is 方法，并给出哨兵错误、包装、判别三者协作的完整分层方案。

2026-09-276 分钟阅读

Go Go 语言编程入门错误处理

《Go 语言编程入门》6.2 fmt.Errorf 与 %w 包装

错误需要上下文，也需要保留原始原因。本节给 TaskAPI 的错误加上「操作 + ID」上下文，讲清 %w 与 %v 的差别、错误链与 Unwrap、多层包装的可读性、以及 errors.Join 与多个 %w 的用法，让错误既能读懂又能判别。

2026-09-275 分钟阅读

Go Go 语言编程入门错误处理

《Go 语言编程入门》6.1 error 接口与哨兵错误

错误是 Go 里最普通的值。本节为 TaskAPI 定义 ErrNotFound 与 ErrInvalidTitle 两个哨兵错误，讲清 error 接口的极简设计、errors.New 与 fmt.Errorf 的差别、哨兵错误的判等语义、以及为什么错误要显式返回而不是抛出异常。

2026-09-276 分钟阅读

Go Go 语言编程入门错误处理

AI Agent AI Agent 开发入门 Reflexion

《AI Agent 开发入门》5.3 Reflexion：失败后的自我修正

ReAct 与 Plan-and-Solve 都是「一次跑到底」，失败了不会回头。本节给循环外面再套一层 Reflexion：执行后由 evaluator 判定成败，失败就生成一段反思文本写回上下文，带着反思重跑，最多 N 轮。我们用 FakeModel 脚本化「第一次算错 → 反思 → 第二次算对」并真跑打印两轮轨迹，最后给何时值得 Reflexion 的决策清单。

2026-09-2710 分钟阅读

AI Agent AI Agent 开发入门 Plan-and-Solve

《AI Agent 开发入门》5.2 Plan-and-Solve：先出计划再执行

ReAct 边想边做，Plan-and-Solve 则先谋后动。本节把循环拆成 Planner 与 Executor 两段：Planner 用结构化输出（JSON 数组）一次性产出子任务列表，Executor 顺序执行每一步且每步内部仍是一个完整小循环。我们用 FakeModel 演示一个三步计划，打印每步状态，并给出与 ReAct 的取舍表。

2026-09-2711 分钟阅读

AI Agent AI Agent 开发入门 ReAct

《AI Agent 开发入门》5.1 ReAct：把「想—做—看」写进循环

本节给 minagent 装上第一种推理循环 ReAct：把 Thought、Action、Observation 三元组显式写进每轮。我们说明现代 tool-use API 下 Thought 就是 assistant 消息的文本部分，实现一个 ReActAgent，用 FakeModel 脚本化「想—做—看」两轮后收敛的完整轨迹并真跑打印，最后给出与 3.1 朴素循环的差异表。

2026-09-2710 分钟阅读

java

《Spring Boot 实战》7.3 版本演进与兼容性

对比 URL、Header、媒体类型三种版本载体的取舍，讲清 Spring Boot 4 内置 API Versioning 的 spring.mvc.apiversion.* 属性、@GetMapping(version=...) 注解与 ApiVersionConfigurer 精细控制，给出向后兼容判定清单、Deprecation/Sunset 废弃流程与破坏性变更的并行发布策略。

2026-09-269 分钟阅读

Spring Boot Spring Boot 实战 API 版本

《Go 语言运行时原理》5.3 内存布局优化实测

把 5.2 的对齐规则落到一个真实结构体上：100 万个实例的 HeapAlloc 从 48.0 B/对象降到 40.0 B/对象（省 8 MB），并诚实报告「[]struct 遍历 vs []*struct 遍历」在 M1 Pro 上没有可辨识差异，附 GC 扫描面（/gc/scan/heap）的实测数字与为什么它不能被简单归因。

Go Go 语言运行时原理内存布局

《Go 语言运行时原理》5.2 结构体对齐、padding 与缓存行

实测同字段集合重排顺序后结构体从 32 字节降到 24 字节（省 25%），并钉到 go1.27.0 的 CalcStructSize 对齐算法；再用 4 个 goroutine 各写一个原子计数器，实测 false sharing 让单次操作从 14.7ms 涨到 221ms（约 15 倍），并确认 M1 Pro 的缓存行是 128 字节。

2026-09-267 分钟阅读

Go Go 语言运行时原理内存布局

《Go 语言运行时原理》5.1 栈增长与连续栈

用 2 万层递归实测 goroutine 栈：相邻帧地址间距恒为 160 字节（连续栈的证据），全程出现 8 次地址整体搬家（栈复制），StackInuse 从 256 KiB 涨到 4352 KiB；并把「栈检查指令」「翻倍增长」「指针重定位」钉到 go1.27.0 的栈增长序言、newstack、copystack 源码上。

Spring Boot Spring Boot 实战 OpenAPI

Go Go 语言运行时原理栈

java

《Spring Boot 实战》7.2 契约先行与代码生成

把 OpenAPI 文件从代码的产物变成代码的输入：用 openapi-generator 7.26 生成接口与 DTO，用 interfaceOnly 与生成目录划清生成与手写的边界，给出避免重生成覆盖业务逻辑的三条纪律，并在 CI 里用 validate、spectral、漂移检查与 oasdiff 四道关固定契约。

2026-09-267 分钟阅读

《Go 语言高级编程》5.3 可见性陷阱与 -race 实测

把「连不上 happens-before」做成可复现的反例：goroutine 退出无保证、缓冲 channel 方向搞反、无同步计数器、双重检查锁与 busy waiting。每个反例都用本机 go run -race 打出真实的 DATA RACE 报告与退出码 66，并给出对应的修复写法。

2026-09-265 分钟阅读

Go Go 语言高级编程数据竞争

《Go 语言高级编程》5.2 happens-before 的建立

上一节给出了 happens-before 的定义，本节回答它由哪些操作建立。逐条拆解官方文档的 Synchronization 小节：初始化、goroutine 创建、channel 收发与关闭、锁、Once、原子操作、终结器，每条规则配一段本机 -race 实测，并汇总成一张「建立 happens-before 的操作」对照表。

2026-09-265 分钟阅读

Go Go 语言高级编程内存模型

《Go 语言高级编程》5.1 Go 内存模型正式定义

并发正确性不是「加个锁就行」，而是一套可证伪的形式定义。本节逐字拆解官方 Go Memory Model 文档：内存操作的四个细节、sequenced before 与 synchronized before 如何合成 happens-before、三条 Requirement 各自约束什么、data race 的精确定义，以及 DRF-SC 保证的边界。

Go Go 语言高级编程内存模型

《AI Agent 工程实战》4.3 工具权限与审批：高危工具二次确认

本节给 minagent 的 ToolRegistry 加一层权限包装：工具按只读、写入、危险分三档，危险工具调用前挂起等人工审批。我们用假模型驱动一条完整轨迹——模型请求危险工具、被挂起、审批通过、继续执行，把每一步贴出来，并给出权限档位表与审批超时策略。

AI Agent AI Agent 工程实战工具权限

AI Agent AI Agent 工程实战多租户隔离

《AI Agent 工程实战》4.2 授权与租户隔离：workspace 行级隔离

本节把 workspace_id 贯穿所有资源，做行级租户隔离：所有查询强制带租户条件，同一个 run id 在别的 workspace 下取不到，且统一返回 404 而非 403，避免泄露资源是否存在。我们用真连的本机 Postgres 跑一遍「A 租户访问 B 租户资源被拒」，并列出隔离失效的三个高频坑。

2026-09-269 分钟阅读

《AI Agent 工程实战》4.1 认证：JWT 与 API Key 中间件

本节给 ResearchCopilot 装上第一道门：用 FastAPI 依赖注入实现认证，同时支持 Bearer JWT 与 API Key 两种凭证。我们用 PyJWT 2.15.1 真跑签发与校验，演示合法 token 通过、过期 token 401、篡改签名 401 三种情况，并把认证失败统一到 3.3 的错误契约。

AI Agent AI Agent 工程实战 JWT 认证

《Go 语言编程实战》5.3 OAuth2/OIDC 与第三方登录

企业客户会问「能不能用我们自己的 SSO」，这时要接的不是用户名密码而是 OAuth2 授权码加 OIDC。本节在本机起真实身份提供方，把 discovery、PKCE、换 token、JWKS 验 ID token 跑通，实测 PKCE 不匹配与 state 不一致的拦截，记录 x/oauth2 靠 Content-Type 判断格式的踩坑，并给出外部身份与本地账号的绑定规则。