# Agent 开发教程与学习笔记 · 验证记录

日期：2026-11-08。环境：Windows、Node.js 25.2.1、Microsoft Edge（Playwright 无头检查）。

## 本次内容

- [Agent 入门教程](../notebook/agent-development-guide.html)：学习顺序、工具循环、参数、确认、状态、RAG／MCP 与评估。
- [实现学习笔记](../notebook/agent-runtime-notes.html)：确认快照、迟到结果、重复操作及本次练习的取舍。
- [离线源代码与说明](../notebook/examples/agent-learning/README.md)：三条合成资料、固定模型脚本、进程内阅读草稿。

## 代码检查

运行 `node --test agent.test.mjs`：18 项通过，0 项失败。

覆盖正常检索后确认、拒绝、未知工具、伪造批准字段、参数类型／长度／重复值、未检索来源、预览篡改、确认编号不匹配、重复确认、确认过期、会话内重复内容去重、轮次上限、确认恢复后预算保留、超时迟到结果、并发调用、取消待确认、空检索、无效模型响应和终态不再执行。部分测试内有多个断言。

另运行三个命令行分支：默认预览停在 `awaiting_approval`；交互输入 `yes` 后只有一份内存草稿；拒绝返回 `USER_DENIED`，没有草稿。

## 页面检查

首页、笔记目录、两篇文章分别在中文和英文下检查 320、390、768、1440 像素宽度，共 32 个布局组合，无页面横向溢出。新文章正文计算字号在窄屏为 17px、宽屏为 18px。

目录共 47 篇；搜索 Agent 命中这两篇新文章，主题筛选、可分享查询地址、刷新和清除有效。手机目录可展开，章节锚点能跳转；代码复制按钮有反馈；打印模式隐藏侧边目录。关闭 JavaScript 后仍可阅读教程和命令。

首页保留三篇最近笔记入口，时间轴增至八条。浏览器检查未捕获页面脚本错误或本站 HTTP 失败响应。本地预览的既有素材来自站点目录和此前保存的公开素材基线。

## 范围

以上不是模型能力评测。没有接入真实模型，没有测量任务成功率、费用、真实检索效果、跨进程恢复或全面的提示注入防御。写入只是进程内 Map；示例没有用户认证或网络工具。生产适配需要单独补齐鉴权、持久化、网络限制和任务评估。

教程参考 Anthropic、Node.js、MCP、JSON Schema 与 LangGraph 官方资料，并在文章末尾提供来源。示例中的声明和手写校验已用测试检查，未声称完整实现 JSON Schema。