第十二章：测试与验证

🧪 本章详细介绍 MiniClaw 的测试机制和验证方法。

12.1 验证脚本分析

12.1.1 verify_kernel.ts 功能

┌─────────────────────────────────────────────────────────────────────┐
│                    verify_kernel.ts 概述                            │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  位置：scripts/verify_kernel.ts                                     │
│  功能：验证 MiniClaw 内核功能是否正常工作                           │
│                                                                     │
│  验证项目：                                                         │
│  ├── ✅ 运行时信息生成                                              │
│  ├── ✅ 身份注入                                                    │
│  ├── ✅ 子代理模式                                                  │
│  ├── ✅ 工作空间感知                                                │
│  └── ✅ 执行能力                                                    │
│                                                                     │
│  运行方式：                                                         │
│  npx ts-node scripts/verify_kernel.ts                               │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

12.1.2 验证项目详解

┌─────────────────────────────────────────────────────────────────────┐
│                    验证项目详解                                      │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  1️⃣ 运行时信息生成                                                 │
│  • 当前时间戳是否正确                                               │
│  • 时间模式是否匹配当前时段                                         │
│  • 运行时环境信息是否完整                                           │
│                                                                     │
│  2️⃣ 身份注入                                                       │
│  • IDENTITY.md 是否存在                                             │
│  • 身份信息是否正确加载                                             │
│  • Emoji 是否正确显示                                               │
│                                                                     │
│  3️⃣ 子代理模式                                                     │
│  • minimal 模式是否正常工作                                         │
│  • 子代理上下文是否精简                                             │
│  • 是否跳过不必要的加载                                             │
│                                                                     │
│  4️⃣ 工作空间感知                                                   │
│  • 项目名称是否正确识别                                             │
│  • Git 状态是否正确检测                                             │
│  • 技术栈是否正确识别                                               │
│                                                                     │
│  5️⃣ 执行能力                                                       │
│  • 安全命令是否能执行                                               │
│  • 危险命令是否被拒绝                                               │
│  • 超时机制是否生效                                                 │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

12.2 测试建议

12.2.1 单元测试覆盖

┌─────────────────────────────────────────────────────────────────────┐
│                    单元测试建议                                      │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  建议测试框架：Jest / Vitest                                        │
│                                                                     │
│  测试文件结构：                                                     │
│  tests/                                                             │
│  ├── unit/                                                          │
│  │   ├── kernel.test.ts        # 内核单元测试                      │
│  │   ├── skillCache.test.ts    # 技能缓存测试                      │
│  │   ├── entityStore.test.ts   # 实体存储测试                      │
│  │   └── utils.test.ts         # 工具函数测试                      │
│  └── integration/                                                   │
│      ├── boot.test.ts          # 启动集成测试                       │
│      ├── tools.test.ts         # 工具集成测试                       │
│      └── prompts.test.ts       # 提示词集成测试                     │
│                                                                     │
│  关键测试用例：                                                     │
│  • boot() 正常启动                                                  │
│  • Token 预算管理                                                   │
│  • 技能缓存 TTL                                                     │
│  • 命令白名单                                                       │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

12.2.2 集成测试

┌─────────────────────────────────────────────────────────────────────┐
│                    集成测试场景                                      │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  场景 1：首次启动                                                   │
│  • 删除 ~/.miniclaw/ 目录                                           │
│  • 启动 MiniClaw                                                    │
│  • 验证目录结构创建                                                 │
│  • 验证模板文件复制                                                 │
│                                                                     │
│  场景 2：日常对话                                                   │
│  • 模拟用户对话                                                     │
│  • 验证日志记录                                                     │
│  • 验证记忆更新                                                     │
│                                                                     │
│  场景 3：记忆蒸馏                                                   │
│  • 创建大量日志条目                                                 │
│  • 触发蒸馏                                                         │
│  • 验证 MEMORY.md 更新                                              │
│                                                                     │
│  场景 4：技能加载                                                   │
│  • 创建测试技能                                                     │
│  • 验证技能发现                                                     │
│  • 验证技能缓存                                                     │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

12.3 调试技巧

12.3.1 常见问题排查

┌─────────────────────────────────────────────────────────────────────┐
│                    常见问题排查                                      │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  问题 1：MCP 客户端无法连接                                         │
│  排查：                                                             │
│  • 检查 Node.js 版本 (>= 18)                                        │
│  • 检查 npx 是否可用                                                │
│  • 手动测试：npx -y github:8421bit/miniclaw                         │
│                                                                     │
│  问题 2：上下文加载失败                                             │
│  排查：                                                             │
│  • 检查 ~/.miniclaw/ 目录是否存在                                   │
│  • 检查 DNA 文件是否存在                                            │
│  • 检查文件权限                                                     │
│                                                                     │
│  问题 3：技能未加载                                                 │
│  排查：                                                             │
│  • 检查 skills/ 目录结构                                            │
│  • 检查 SKILL.md 格式                                               │
│  • 等待缓存过期或重启                                               │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

本章小结

┌─────────────────────────────────────────────────────────────────────┐
│                     第十二章 核心要点                                │
├─────────────────────────────────────────────────────────────────────┤
│                                                                     │
│  🧪 验证脚本                                                        │
│     • verify_kernel.ts                                              │
│     • 5 个验证项目                                                  │
│     • 一键运行                                                      │
│                                                                     │
│  📝 测试建议                                                        │
│     • 单元测试（Jest/Vitest）                                       │
│     • 集成测试                                                      │
│     • 关键用例覆盖                                                  │
│                                                                     │
│  🐛 调试技巧                                                        │
│     • 日志分析                                                      │
│     • 常见问题排查                                                  │
│     • 手动验证                                                      │
│                                                                     │
│  ✅ 最佳实践                                                        │
│     • 定期运行验证脚本                                              │
│     • 自动化测试                                                    │
│     • 持续集成                                                      │
│                                                                     │
└─────────────────────────────────────────────────────────────────────┘

本文档是《MiniClaw 深度解析》系列的第十二章，下一章将详细介绍技术栈分析。