课程质量报告

验收日期：2026-07-27
范围：Markdown 教材、VitePress HTML、课程校验器、Mini Emperor 配套实现与固定版本参考资料

1. 交付规模

项目	结果
连续教材	11 章（第 0–10 章）
七周安排	7 周，每周 10–14 小时
本地视频	9/9，归一化字幕 2,792 条
claude-agent-examples	12/12 个固定版本步骤
《深入理解 AI Agent》	10/10 章
必做实验	15/15
课程内部链接	326 个
固定仓库源码定位	76 个
术语表	92 个术语
静态 HTML	229 个文件，约 9.2 MiB

每章都包含学习成果、问题背景、最小模型、状态流、代码迭代、失败实验、练习、复习题和“继续深入”来源卡。HTML 与 Markdown 使用同一内容源，避免双份教材漂移。

2. 固定参考版本

资料	Commit
TheSyart/claude-agent-examples	54a18980334541773f13940aa0c0475728d30ee0
TheSyart/emperor-agent	59e06bf681df914af738998b7f70d87f7a534f47
mattpocock/skills	ed37663cc5fbef691ddfecd080dff42f7e7e350d
bojieli/ai-agent-book	1c18370279f8f0457bf2c44dfa585d08d4d5f281

完整锁定信息见 sources.lock.json。课程明确标注：锁定版本的 claude-agent-examples 只有 step01–step12，Goal 章节来自视频、Mini Emperor 和异步 Agent 实验，不虚构 step13。

3. 自动化验收结果

2026-07-27 在本工作区执行：

课程工具测试                         25 passed
Mini Emperor / 项目全量测试          42 passed
Vue / TypeScript 前端测试             5 passed
Vue 生产构建                          passed
Ruff（课程工具、后端和测试）          passed
课程结构与来源覆盖校验                passed
VitePress 生产构建                    passed
npm audit --audit-level=moderate      0 vulnerabilities
customer-support Skill 快速校验       valid
gitlab-mr-review Skill 快速校验       valid

项目测试仅有一条上游兼容性提示：Starlette 的旧 TestClient 入口建议未来迁移到 httpx2；它不是失败，也不影响当前实验。

参考仓库抽样实验在资料提取阶段独立执行：

claude-agent-examples/step12                  11 passed
ai-agent-book/chapter8/trajectory-verifier    3 passed
ai-agent-book/chapter8/self-modifying-agent   4 passed
ai-agent-book/chapter8/prompt-auto-optimization 3 passed

4. 浏览器验收

在本地生产预览上用 Chrome DevTools Protocol 验证：

• 主页 Logo 正常加载，站内搜索入口存在。
• 主页与章节 Mermaid 均转换为 SVG。
• 第 7 章完成按钮会写入 localStorage，验证后已清除测试状态。
• 390×844 移动端视口中 scrollWidth <= innerWidth，无横向溢出。
• 桌面、暗色阅读、移动导航和打印样式均有对应 CSS。
• 离线 HTML 的资源会按页面深度改写为相对路径，章节链接包含 .html；直接双击时样式和页面跳转不会再指向文件系统根目录。

VitePress 只报告 Mermaid 相关客户端包大于 500 KiB 的性能建议；不影响构建或离线阅读，后续可通过动态导入继续优化。

5. 安全与可移植性

• Markdown、生成 HTML 和 JSON 已扫描常见 API Key 形态，未发现密钥。
• 发布版不包含本机用户目录；示例命令从 Git 根目录解析。
• .env、参考仓库检出目录和 node_modules 不进入课件产物。
• 两个 Skill 的权限、网络、密钥和运行模式通过 skill.web.json 单独声明。
• 课程校验器会阻止章节缺段、来源覆盖缺失、坏链接、无效源码定位和疑似密钥。

6. 尚需学习者凭外部账号完成的毕业验收

以下操作会创建外部资源或产生调用费用，因此没有替你自动执行：

• 使用自己的 DeepSeek 账户完成真实模型对比和成本记录。
• 发布到 TestPyPI/PyPI、MCP Registry、Render 和 Cloudflare。
• 在真实 GitLab 项目触发 feature/* → master MR 门禁。
• 在第二台干净环境完成 Skill 下载、校验、安装和远程 MCP 调用。
• 使用 PostgreSQL + pgvector 跑完整 30 题客服 RAG 评估集。

课程已经提供操作步骤、失败边界和完成标准；做完这些外部实验，才算完成毕业演示，而不只是“把代码跑起来”。