docs: 重构文档体系

- 合并 DEVELOPMENT.md 至 docs/development/README.md
- 合并 CONTRIBUTING.md 至 docs/development/checker.md
- 合并 build-release.md 至 release.md
- 合并 testing-quality.md 内容至各专题文档
- 合并 status-model.md 至 expectations.md
- 新增 docs/user/README.md 用户入口
- 简化 docs/README.md 文档路由
- 各专题文档新增适用场景和更新触发条件
- 更新 openspec/config.yaml 文档规则

docs/user/expectations.md

@@ -1,7 +1,58 @@
 # 校验规则
 
+本文档说明 `expect` 规则、状态判定、failure、observation 和各 checker 的快速失败顺序。
+
+适用场景：编写 `expect`、理解 UP/DOWN、排查 mismatch/error、查看返回结果中的 `failure` 和 `observation`。
+
 `expect` 描述拨测结果必须满足的条件。不同 checker 暴露不同字段，但共享三类基础断言模型：`ValueMatcher`、`ContentExpectations` 和 `KeyedExpectations`。
 
+## 状态判定
+
+DiAL 使用单层状态模型。
+
+| 状态   | 含义                                     |
+| ------ | ---------------------------------------- |
+| `UP`   | 拨测结果符合 `expect` 规则               |
+| `DOWN` | 拨测结果不符合 `expect` 规则，或执行失败 |
+
+执行失败（网络错误、超时、进程崩溃）和 expect 不匹配都统一为 `DOWN`，通过 `failure.kind` 区分原因。
+
+| `failure.kind` | 含义                                     |
+| -------------- | ---------------------------------------- |
+| `error`        | 网络、超时、进程、协议解析或内部执行错误 |
+| `mismatch`     | 拨测完成，但结果不满足 expect            |
+
+## API 结果字段
+
+API 返回的检查结果包含 `detail` 和 `observation`。
+
+| 字段          | 说明                                                         |
+| ------------- | ------------------------------------------------------------ |
+| `detail`      | 后端按 checker 类型从结构化 observation 动态生成的人可读摘要 |
+| `observation` | 保存该次检查的结构化观测数据                                 |
+| `failure`     | 保存首个错误或不匹配原因                                     |
+| `matched`     | 是否符合 expect                                              |
+| `durationMs`  | 本次检查耗时                                                 |
+| `timestamp`   | 本次检查时间                                                 |
+
+`detail` 不写入 SQLite。存储层仅持久化 `observation` JSON、`failure` JSON、匹配状态、耗时和时间戳。
+
+## observation 示例
+
+不同 checker 的 observation 字段不同，常见信息包括：
+
+| Checker | observation 内容示例                                               |
+| ------- | ------------------------------------------------------------------ |
+| HTTP    | 状态码、响应头、按需读取的 body 预览                               |
+| Cmd     | exit code、stdout/stderr 预览                                      |
+| TCP     | 连接结果、banner 摘要                                              |
+| UDP     | 响应内容、来源地址、响应大小                                       |
+| ICMP    | 存活结果、丢包率、平均延迟、最大延迟                               |
+| DNS     | RCODE、记录值、TTL、flags、CNAME 链                                |
+| LLM     | HTTP 状态、模型输出、finish reason、token usage、流式首 token 时间 |
+
+Dashboard 基于存储的检查结果计算实时状态、可用率、耗时趋势、P95、状态条和故障段等指标。指标语义由后端应用层实现，SQLite 主要负责存储、筛选、排序、分页和基础聚合。
+
 ## ContentExpectations
 
 `body`、`stdout`、`stderr`、`banner`、`response`、`output`、`result` 等返回内容字段均使用数组。
@@ -102,3 +153,7 @@ expect:
 旧字段 `maxDurationMs`、`maxPacketLoss`、`maxAvgLatencyMs`、`maxMaxLatencyMs` 和旧正则字段 `match` 已移除，请分别改用 `durationMs`、ICMP matcher 字段和 `regex`。
 
 非法配置会阻止启动并输出错误信息。除动态键值表（`headers`、`env`、`variables`）外，未知字段会导致启动失败，请使用 YAML 注释表达说明。
+
+## 更新触发条件
+
+修改 expect 断言模型、状态判定、failure 字段、observation 字段、快速失败顺序或已移除字段说明时，必须更新本文档。