电子书籍

《Go 语言高级编程》2.1 os.Root 与受限文件系统

用 filepath.Join 拼接用户输入是经典的目录穿越漏洞。Go 1.24 引入 os.Root 把「只能访问某个目录树」做成内核级保证。本节实测相对路径、绝对路径、符号链接三种逃逸全部被挡在 root 之外，并给出 OpenRoot 的 1.24 版本证据与 1.25 方法集扩充（11→23 个方法）的对照。

Go Go 语言高级编程文件系统

《AI Agent 工程实战》1.3 仓库与工程骨架：monorepo + TS 包，CI 跑通 lint/test

本节把 ResearchCopilot 落成 monorepo：packages/researchcopilot 是 Python 服务包，packages/web 是 TS 前端包。给出 pyproject.toml 与 package.json 片段，在本机真跑 pytest、node --test、tsc --noEmit 并贴出输出，最后给出 GitHub Actions CI 形态。

AI Agent AI Agent 工程实战 monorepo

AI Agent AI Agent 工程实战架构设计

《AI Agent 工程实战》1.2 架构总览：引擎 / 服务 / worker / 存储边界

本节给 ResearchCopilot 画出四层边界：卷一的 minagent 引擎层、FastAPI 服务层、异步 worker 层、Postgres 加 Redis 的存储层。我们用一张 ASCII 图和一张职责表说清每层管什么、不该管什么，用可跑的检查脚本钉死依赖方向，并完整走一遍一个提问从进来到出结果、跨四层的时序。

2026-09-2310 分钟阅读

AI Agent AI Agent 工程实战需求分析

《AI Agent 工程实战》1.1 需求与用例：3 个核心用例与验收标准

本节为 ResearchCopilot 立下 3 个可验收的核心用例：单跳事实问答、多跳研究并输出带引用报告、后台周期 digest。每个用例都给出量化验收标准与落地章节映射，并明确列出不做通用聊天、不做 MCP Server 实现、不做多租户计费这三条边界，把项目范围钉死在可交付的一小块上。

2026-09-2310 分钟阅读

《Go 语言编程实战》2.3 供应链安全与 SBOM（govulncheck）

TaskHub 依赖几十个模块，其中任何一个的已知漏洞都可能成为攻击面。本节实测 govulncheck v1.8.0 的三种扫描层级（module/package/symbol），用真实输出说明「模块有漏洞」与「你的代码真的调用了漏洞函数」的区别，并演示它如何顺带产出 SBOM 与 SARIF，接进 CI。

Go Go 语言编程实战供应链安全

《Go 语言编程实战》2.2 升级、replace 与私有模块

依赖不会永远停在原版本：要升级、要临时指向 fork、要让公司内网的私有仓库能被解析。本节实测 go get -u 与 -u=patch 的差异、replace 指向本地目录的效果，以及 GOPRIVATE/GONOPROXY/GONOSUMDB 三件套如何把私有模块从公共代理里摘出来，附 TaskHub 的升级纪律。

2026-09-235 分钟阅读

Go Go 语言编程实战依赖升级

《Go 语言编程实战》2.1 最小版本选择与冲突排查

TaskHub 的四个模块各自声明依赖版本，冲突迟早会发生。本节用 x/text 与 x/net 两个真实模块实测最小版本选择的裁决过程：直接要求 v0.14.0 却因间接依赖被抬到 v0.19.0，再演示 go get 强制降级报错、go mod graph 定位引入者、exclude 干预的完整排查链路。

Go Go 语言编程实战依赖管理

typescript

《TypeScript编程实战》5.3 优雅关闭与健康检查

本节讲解服务进程如何正确地「活着」与「死去」：从 SIGTERM 信号处理、连接排空与资源释放的关闭流程，到 liveness、readiness、startup 三类健康检查的语义差异与实现方式。你将学会为数据库、缓存等依赖编写带超时的探活，并把探针与容器、编排系统配置对齐，避免发布期间丢请求或误判重启。

TypeScript TypeScript编程实战优雅关闭

typescript

《TypeScript编程实战》5.2 中间件与请求上下文

本节讲解 HTTP 服务的横切关注点如何组织：从洋葱模型与 Fastify hooks 的执行顺序，到用 AsyncLocalStorage 建立请求级上下文并贯穿日志与追踪，再到把认证结果类型安全地挂到请求对象上。你将掌握认证、校验、限流、错误收口四类中间件的写法与顺序约束，并学会避免重复执行与上下文丢失两类高频故障。

TypeScript TypeScript编程实战中间件

typescript

《TypeScript编程实战》5.1 HTTP 服务与路由（Fastify / Hono）

本节从 Node 原生 http 模块的类型缺口讲起，对比 Fastify 与 Hono 两套框架的路由声明、请求校验与类型推导方式。你将学会用 JSON Schema 与 Zod 让请求参数自动获得类型，用插件与分组路由组织大型服务的路由树，并理解 Web 标准 Request/Response 在边缘运行时上的取舍。读完后你能按部署形态选出合适框架，写出端到端类型安全的接口层。

TypeScript TypeScript编程实战 Fastify

java

《Spring Boot 实战》4.1 测试分层策略

本节用图书借阅服务的借阅流程，把单元、切片、集成、端到端四层测试的成本与收益逐项拆开，给出各层配比与 CI 分阶段执行命令，并对齐 Spring Boot 4.x 的测试注解口径（@MockitoBean、RestTestClient、@AutoConfigureMockMvc），最后讲清测试并行与上下文缓存的取舍。

Spring Boot Spring Boot 实战测试分层

java

《Spring Boot 入门》11.1 静态资源映射

图书服务要加一个管理页面，HTML、CSS、JS 与封面图该放哪、用什么 URL 访问？本节讲清 Spring Boot 四个默认静态资源目录及优先级、默认 /** 映射规则，区分 static-locations 与 static-path-pattern，并演示自定义映射、缓存控制与内容哈希指纹，最后说清静态资源与接口路径冲突时谁优先。

Spring Boot Spring Boot 入门静态资源

python

《Python编程实战》4.3 属性测试、性能回归与覆盖率门禁

给测试体系补上三块短板：用 hypothesis 的性质测试突破手写用例的输入盲区并靠反例缩小定位真实缺陷，用 pytest-benchmark 把性能退化成一道可对比的门禁，用 pytest-cov 的覆盖率与 --cov-fail-under 卡住底线。

Python Python编程实战属性测试

python

《Python编程实战》4.2 集成测试与容器化测试环境

单元测试之外的第二层防线：先划清单元与集成的边界，再用 SQLite + fixture 在本机搭出可跑的等价数据层，讲透外层事务加 SAVEPOINT 的用例隔离，最后给出 testcontainers 真实容器环境的配置并明确标注未实测。

Python Python编程实战集成测试

python

《Python编程实战》4.1 pytest 工程化：fixture 分层与插件

把 pytest 从「能跑」推到「可维护」：conftest.py 向上合并与就近覆盖、fixture 作用域与依赖注入、工厂型 fixture 避免共享可变状态，再把约定写进 pyproject.toml，最后用一个本地 conftest 插件和实测插件清单收尾。

Python Python编程实战 pytest

《Go 语言编程入门》2.3 函数、多返回值与 defer

本节把 TaskAPI 的 add、list、toggle 抽成真正的函数：先讲函数签名与多返回值为何是 Go 的错误传递方式，再讲命名返回值、可变参数与闭包；随后重点拆解 defer 的 LIFO 顺序和「参数立即求值」这一最容易踩的坑，最后用三个函数重写命令派发器并实测运行。

Go Go 语言编程入门函数

《Go 语言编程入门》2.2 控制流与循环

本节用 TaskAPI 的 list 命令把 Go 的控制流走一遍：if 的初始化语句、for 的三种写法、range 遍历切片与 map 的差异、带标签的 break/continue，以及默认不穿透的 switch 的四种形态；最后把 os.Args 接到一个 switch 派发器上，让 add/list/toggle 真正能跑起来。

Go Go 语言编程入门控制流

《Go 语言编程入门》2.1 变量、常量与基本类型

本节为 TaskAPI 定义第一个数据结构：先用 var 与 := 的四种写法引出 Go 的零值哲学，再对照列出 bool、string、各类整数、float、byte 与 rune 的取值与默认值，讲清「没有隐式转换」意味着什么；随后用 const 与 iota 给任务状态建模，最后落定 Task 三个字段的类型选择。

Go Go 语言编程入门基本类型

《AI Agent 开发入门》1.3 可编程假模型 FakeModel

本节写下全书的测试基石 FakeModel：一个按脚本列表吐响应的假模型，脚本元素可以是文本、ToolCall 列表或 ModelResponse，它记录每次调用入参、脚本耗尽即抛 RuntimeError。随后用一个极简循环跑通「add 到 mul 再文本收敛」，打印完整轨迹并断言两次运行逐字节一致。

AI Agent AI Agent 开发入门 FakeModel

《AI Agent 开发入门》1.2 Agent 的最小定义与消息协议

本节给 Agent 一个可执行的最小定义——模型 + 工具 + 循环 + 状态，并把它落成 minagent/types.py 里的 Role、ToolCall、Message、ModelResponse 四个类型；重点讲清 Message.to_wire() 如何把对象变成模型能消费的线格式，再用一段离线断言脚本实测「序列化到反序列化再回放」全程往返一致。