书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》
作者：陈堂会
章节：第二章 TypeScript / Node Runtime 基础 / 2.6 资源清理比重试更重要
电子版系列：查看完整目录
第二章 TypeScript / Node Runtime 基础：2.6 资源清理比重试更重要
很多系统把重试当作可靠性的同义词。对 Agent Runtime 来说，重试之前先问一句：上一次有没有留下副作用？
如果模型请求超时，重试通常安全。如果读文件失败，重试也通常安全。如果写文件执行到一半，重试可能覆盖用户改动。如果 npm install 被中断，重试前要检查 lockfile 和目录状态。如果迁移数据库失败，绝不能盲目重试。
工程上应给每个工具声明副作用等级：
type SideEffect = "none" | "workspace-read" | "workspace-write" |
"network" | "external-write" | "destructive";
type ToolDefinition = {
name: string;
inputSchema: unknown;
sideEffect: SideEffect;
execute(input: unknown, ctx: ToolContext): Promise<ToolResult>;
};
这不是形式主义。后面章节的权限、checkpoint、eval、成本治理都会依赖这些元数据。
