lanyuanxiaoyao
c2dcfab80c
- 新增 type: cpu checker，基于 os.cpus() 两次快照计算 CPU 使用率 - 配置项：sampleDuration（默认 1s）、includePerCore（默认 false） - expect 字段：usagePercent、idlePercent、maxCoreUsagePercent、minCoreUsagePercent、durationMs - idlePercent 与 usagePercent 互补恒等于 100，百分比范围 0-100 - logicalCoreCount 仅输出到 observation，不作为 expect 字段 - 不暴露 userPercent / systemPercent - 语义校验禁止 sampleDuration >= timeout - 支持 AbortSignal 超时取消 - 完整测试覆盖：schema、validate、normalize、resolve、calculate、execute、expect、config-loader - 新增用户文档 docs/user/checkers/cpu.md - 更新 checker 索引、配置类型列表、示例配置和 schema
用户文档
本文档是 DiAL 的用户使用入口，说明如何阅读配置、部署、expect 规则、故障排查和各 checker 参考。
适用场景：编写 YAML 配置、部署 DiAL、理解拨测结果、排查运行问题、查询某个 checker 的字段和示例。
文档索引
| 文档 | 内容 |
|---|---|
| configuration.md | YAML 顶层结构、变量、server、targets 通用字段 |
| deployment.md | 生产构建、Docker、ICMP 权限、发布包运行方式 |
| expectations.md | expect 规则、状态判定、failure、observation |
| troubleshooting.md | 配置校验、变量、ICMP、CMD、Docker、证书和正则问题 |
| checkers/README.md | 各 checker 的配置项、expect 字段和示例 |
按任务阅读
| 任务 | 建议阅读 |
|---|---|
| 首次运行 | 项目快速开始、配置文件 |
| 编写配置 | 配置文件、Checker 参考 |
| 编写 expect | 校验规则、对应 checker 文档 |
| 容器或生产部署 | 部署、故障排查 |
| 排查启动或运行问题 | 故障排查、相关 checker 文档 |
| 查询 checker 专属字段 | Checker 参考 |
用户文档更新规则
- 配置结构、变量、server、probes、targets 通用字段变化时，更新 configuration.md。
- checker 配置项、expect 字段、示例或运行行为变化时，更新
checkers/<type>.md和 checkers/README.md。 - expect 模型、状态判定、failure、observation 或快速失败顺序变化时，更新 expectations.md。
- 构建产物运行方式、Docker 参数、镜像内置依赖、发布包结构变化时，更新 deployment.md。
- 常见错误、运行依赖、权限、证书或配置校验排查方式变化时，更新 troubleshooting.md。
- 用户文档只解释“如何使用”和“用户能观察到什么”，实现细节放入
../development/。