lanyuanxiaoyao/DiAL
1
0
Fork 0
Code Activity
74 Commits 1 Branch 0 Tags
7a635a0a9fb64719363a01d7615052708eee6243
Commit Graph

38 Commits

Author SHA1 Message Date
lanyuanxiaoyao
7a635a0a9f refactor: 统一 expect 断言体系，引入共享 ValueMatcher/ContentRules/KeyValueExpect 模型 
- 引入共享 ValueMatcher（equals/contains/regex/exists/empty/gt/gte/lt/lte）
- 引入共享 ContentRules 数组（direct/json/css/xpath 提取器）
- 引入共享 KeyValueExpect（动态键值断言，字面量等价 equals）
- maxDurationMs → durationMs: ValueMatcher（所有 checker）
- match → regex（固定无 flags）
- Ping max* → packetLossPercent/avgLatencyMs/maxLatencyMs（ValueMatcher）
- LLM finishReason/rawFinishReason → ValueMatcher
- DB 新增 result: ContentRules
- TCP banner → ContentRules 数组
- 删除旧模块：operator.ts、validate-operator.ts、duration.ts、body.ts、text.ts、output.ts
- 更新全部 checker schema/validate/expect/execute
- 更新 probe-config.schema.json、probes.example.yaml
- 更新 README.md、DEVELOPMENT.md（含 expect 字段选择规范）
- 同步 10 个 delta specs 到主 specs，归档 change
 2026-05-19 14:24:27 +08:00
lanyuanxiaoyao
349896bd02 feat: 新增 LLM checker 支持大模型服务应用层拨测 
基于 AI SDK v6 实现 openai/openai-responses/anthropic 三类 provider 的 http/stream 模式调用
支持 output/finishReason/usage/stream 等完整 expect 断言链路
新增 9 个源文件和 5 个测试文件共 78 个测试
更新 README/DEVELOPMENT/probes.example.yaml 和 probe-config.schema.json
 2026-05-19 00:06:53 +08:00
lanyuanxiaoyao
52262a31f6 feat: 新增 UDP checker，支持自定义 payload 请求-响应探测与断言 
基于 Bun connected UDP socket 实现通用 UDP 拨测能力：
- 支持 text/hex/base64 payload 编码与独立 responseEncoding 响应视图
- 支持 responded、response、responseSize、sourceHost、sourcePort、maxDurationMs 专属 expect
- 单 datagram 发送，仅断言首个 UDP 响应 datagram
- 通过 maxResponseBytes 和 flags.truncated 进行响应大小限制与截断保护
- payload 可选，省略时发送空 datagram
- 自包含模块结构（types/schema/validate/expect/encoding/execute）
- 新增 741 tests（含 unit、execute 集成、expect 和编码 roundtrip），全部通过
 2026-05-18 17:23:17 +08:00
lanyuanxiaoyao
550c427814 feat: 新增 ICMP/Ping checker，支持跨平台主机存活检测与延迟监控 
实现 type: ping checker，通过 Bun.spawn 调用系统 ping 命令，自行实现跨平台
输出解析器（Linux/macOS/Windows 含中文 locale），支持 alive、丢包率、延迟、
耗时等 expect 断言，复用现有 checker 架构零外部依赖。

包含完整的类型定义、TypeBox schema、语义校验、命令构建、解析、断言、执行、
注册、配置加载测试，以及 probe-config.schema.json 更新和文档更新。

审查修复：提取 buildPingCommand 为独立纯函数并补充跨平台单测，补充
maxDurationMs/maxAvgLatencyMs 类型非法和空字符串 host 边界测试用例。

变更已归档，delta specs 已同步至 main specs。
 2026-05-18 10:45:17 +08:00
lanyuanxiaoyao
0a9a9016be feat: 新增 TCP checker，支持端口可达性探测与 banner 读取 
- 新增 src/server/checker/runner/tcp/ 自包含目录（types/schema/validate/execute/expect）
- 注册 TcpChecker 到 checkerRegistry，schema/engine/store/config-loader 自动委托
- 支持 expect.connected 正反向语义（默认期待可达，可配置期待不可达）
- 支持 readBanner opt-in banner 读取，受 bannerReadTimeout + maxBannerBytes 双重限制
- 复用电有 expect/operator/duration/failure 基础设施
- 新增 3 个测试文件 51 条用例（execute/validate/expect），全量 634 测试通过
- 更新 README/DEVELOPMENT/probes.example.yaml，新增 tcp-checker capability spec
 2026-05-17 23:53:37 +08:00
lanyuanxiaoyao
31fd3a2a43 refactor: 统一 target name/description 可空语义，前端展示 fallback 到 id 
- schema: name/description 允许省略或显式 null，TypeBox Union([Null, String])
- 类型: RawTargetConfig/ResolvedTargetBase/子类型/StoredTarget/TargetStatus name 改为 string | null
- checker resolve: name: t.name ?? null，不再 fallback 到 id
- 语义校验: 拒绝空字符串和纯空白 name
- SQLite: targets.name 列改为可空 TEXT
- 前端: 新增 getTargetDisplayName(target) 展示 name ?? id
- 测试: 覆盖 name/description null 全场景，查找改为按 id
- 文档: 更新 README/DEVELOPMENT 和 6 个 openspec specs
 2026-05-17 20:12:39 +08:00
lanyuanxiaoyao
f7193e98ff feat: 新增 target description 字段，收紧 id/name 长度，调整延迟列和名称列 2026-05-17 18:42:46 +08:00
lanyuanxiaoyao
7926514986 feat: 配置变量系统与 target id/name 双字段标识 
- 新增顶层 variables 段支持 string/number/boolean 字面量
- target 字符串字段支持 、、{...} 转义语法
- 变量解析优先级: variables -> process.env -> 默认值 -> 报错
- 完整引用保留原始类型，部分引用拼接为字符串
- 变量替换在 YAML 解析后、AJV 校验前执行
- 替换仅作用于 targets，跳过 id/type 字段
- target 新增必填 id 字段作为唯一标识，name 改为可选展示名称
- 数据库存储/API/前端全面迁移到 id 标识
- 统一 checker 运行时类型检查为 es-toolkit predicates
- 同步 delta specs 到主 specs，归档 config-variables 变更
 2026-05-17 00:37:54 +08:00
lanyuanxiaoyao
e924732a02 refactor: 移除 defaults.http.method 配置，简化默认值体系 
- HTTP checker defaults schema 不再支持 method 字段
- resolve 逻辑从三级 fallback 简化为两级（target -> 内置默认）
- 配置文件中出现 defaults.http.method 将触发未知字段校验错误
- per-target http.method 覆盖功能保持不变
- 同步更新示例配置、README 文档和测试用例
 2026-05-16 21:45:08 +08:00
lanyuanxiaoyao
146cef982e feat: 新增 DB checker — 支持 PostgreSQL/MySQL/SQLite 连接测试与 SQL 查询断言 
- 实现 db 类型 checker，使用 Bun 内置 SQL 类
- 支持 db.url 连接字符串和可选 db.query 查询语句
- expect 支持 maxDurationMs、rowCount、rows 逐列校验
- 凭据屏蔽序列化输出
- SQLite 内存数据库测试覆盖
 2026-05-16 09:00:15 +08:00
lanyuanxiaoyao
c46ab14cce feat: Dashboard 主题模式切换 — 系统跟随/明亮/黑暗，localStorage 持久化，TDesign theme-mode 驱动 
新增 useThemePreference hook 和纯工具函数，支持系统/明亮/黑暗三态主题选择、
matchMedia 系统主题跟随、localStorage 持久化和启动期主题预应用，通过 <html
theme-mode> 驱动 TDesign 主题变量切换。

Header 右侧控件重新组织为 .dashboard-header-controls 单行桌面布局，主题
RadioGroup 位于刷新频率 RadioGroup 前。

附带：build.ts import specifier 改为跨平台 sep 转换；config-loader 测试适配
Windows PATH 和 YAML 路径转义；test-utils 类型窄化修复。
 2026-05-15 22:18:29 +08:00
lanyuanxiaoyao
8793fbd786 test: 重构测试体系 — 建立组件测试层、补充后端测试、清理低质量测试 
- 新增 jsdom + @testing-library/react 组件测试环境
- 新增 12 个组件测试，覆盖所有前端组件
- 补充后端 middleware 和 helpers 单元测试
- 删除伪测试 use-target-detail-logic.test.ts
- 精简过度枚举的 color-threshold.test.ts
- 新增 bunfig.toml 配置测试 preload
- 更新 DEVELOPMENT.md 测试章节
- 安装 @types/jsdom 修复类型声明
 2026-05-15 18:31:33 +08:00
lanyuanxiaoyao
d6a77b2c6e feat: 迁移前端构建从 Bun fullstack 到 Vite 
前端性能问题根因在于 Bun bundler 无法有效 code split、CSS
tree-shake 和产出优化的前端资源。经多轮 Bun 原生优化尝试
均无明显效果后，决定将前端构建迁回 Vite。

主要变更：

- 前端构建：从 Bun HTML import bundling 切换为 Vite build
  （Rolldown code splitting、vendor chunk、CSS 优化）
- 开发模式：从 Bun fullstack 单进程 HMR 切换为 Vite dev
  server + Bun API server 双进程（:5173 + :3000）
- 生产构建：三步流水线（Vite build → code generation →
  Bun compile），通过 `import with { type: "file" }` 嵌入前端资源
- 静态资源服务：从 Bun HTML import manifest 切换为自定义
  serveStaticAsset 函数，支持 SPA fallback 和正确的 Cache-Control
- Server 接口：BootstrapOptions 和 StartServerOptions 增加
  staticAssets? 可选参数
- 文档更新：DEVELOPMENT.md 和 README.md 反映新的开发模式，
  主 specs 同步 delta 变更

新增能力：
- static-asset-embedding: 构建时资源扫描与 code generation、
  运行时静态资源服务
- vite-frontend-bundling: Vite 构建配置、code splitting 策略、
  CSS 处理
 2026-05-15 11:26:46 +08:00
lanyuanxiaoyao
1c5cfafda6 feat: 前端指标体系增强 — Dashboard/Metrics API、2×4 统计区、趋势图面积+异常标记、连续状态列 
- 新增 GET /api/dashboard 合并原 summary+targets 首屏接口
- 新增 GET /api/targets/:id/metrics 合并原 stats+trend 概览接口
- 后端指标纯函数：可用率、百分位、故障段分析、连续状态、UTC 小时分桶
- ProbeStore 窗口取数方法替代全量历史查询
- SummaryCards 扩展为 4 卡片（新增异常事件数）+ 数据新鲜度展示
- 表格新增「连续」列（Tag 渲染 capped 状态）
- OverviewTab 重构为 2×4 Statistic 多维度布局
- TrendChart 改为延迟范围面积图 + 红色异常标记点
- 删除旧路由（summary/targets/trend）和 computeTrendStats
- 同步 delta specs 到主 specs 并归档变更
 2026-05-14 12:32:41 +08:00
lanyuanxiaoyao
e983e5d75d refactor: 重命名 command checker 为 cmd checker 并适配跨平台测试 
将 type/configKey 从 "command" 统一为 "cmd"，源码目录 runner/command/ → runner/cmd/，
spec 目录 command-checker/ → cmd-checker/，测试全部改用 bun -e 替代 Unix 系统命令，
归档 cmd-checker-enhancement 变更并同步 delta spec 到主 spec。
 2026-05-14 09:23:10 +08:00
lanyuanxiaoyao
6e485cc991 refactor: 迁移 Bun fullstack 架构 2026-05-14 00:23:37 +08:00
lanyuanxiaoyao
bcfac52112 refactor: HTTP checker 质量加固 
- failure actual 截断格式改为 …(共 N 字符)，标量不序列化直接返回
- 新增 redos.ts 实现 ReDoS 静态检测（嵌套量词/重叠交替），启动期拒绝危险正则
- JSON body rules 共享同一次 JSON.parse 结果，避免重复解析
- checkCssRule 重构为线性流程，消除 exist:true 与无 operator 的冗余分支
- extract checkEarlyTimeout 辅助函数，明确提前 duration 检查意图
- 补充 303/307/308 重定向、相对路径 Location、混合 body rules 集成测试
 2026-05-13 21:35:05 +08:00
lanyuanxiaoyao
31aeee6d60 refactor: 前端架构重构 — hook拆分、组件拆分、类型筛选器动态化、Meta API 
- 后端新增 GET /api/meta 端点（checkerRegistry.supportedTypes）及 MetaResponse 类型
- 前端 hook 拆分为 use-queries.ts（全局查询+useMeta）和 use-target-detail.ts（Drawer状态）
- TargetDetailDrawer 拆分为 OverviewTab + HistoryTab + history-table-columns + stats.ts
- 类型筛选器由 meta API 动态驱动，删除 target-type-display 静态映射
- 列定义改为工厂函数 createTargetTableColumns(checkerTypes)，TargetGroup 新增 columns prop
- 修复 StatusDonut key、StatusBar maxSlots prop、TrendChart 移除 loading prop
- 补充 utils/time、utils/stats、动态列工厂测试，删除旧 mapping 测试
- 同步 delta specs 到主 specs，归档 frontend-architecture-refactor change
 2026-05-13 20:55:42 +08:00
lanyuanxiaoyao
147a2559ae refactor: 后端架构加固 — 泛型化、批量查询、bootstrap 统一、路径修复与 pageSize 上限 
- CheckerDefinition 泛型化，HTTP/Command checker 移除 resolved target 断言
- 新增 ProbeStore.getAllRecentSamples 消除 targets 路由 N+1 查询
- 统一 getAllTargetStats 与 getTargetStats 的 availability 精度
- Engine rejected 结果写入 internal error 记录，提升可观测性
- 新增 bootstrap.ts 统一 dev/production 启动序列
- dataDir 相对路径改为基于配置文件目录解析
- validatePagination 增加 pageSize 上限 200 校验
- 修复 ErrorBoundary override 标记
- 更新 README/DEVELOPMENT 文档，新增完整测试覆盖
 2026-05-13 18:15:46 +08:00
lanyuanxiaoyao
bcfb907bd3 feat: 基础设施加固 — 修复构建、数据保留、错误边界、bundle 拆分 
- 修复 build script 引用已删除的 registerCheckers，恢复生产构建
- 生产入口添加 SIGINT/SIGTERM 优雅关闭（与 dev.ts 一致）
- 新增 runtime.retention 配置（默认 7d），ProbeStore.prune() 定时清理过期数据
- parseDuration 扩展支持 h/d 单位
- 新增前端 ErrorBoundary 组件，防止渲染错误白屏
- Vite codeSplitting.groups 拆分 vendor chunks（业务代码 1180KB → 47KB）
- 同步 delta specs 到主规范
 2026-05-13 16:48:56 +08:00
lanyuanxiaoyao
bb6b2bc20b refactor: checker 模块内聚化 — 每个 checker 自包含于独立目录 
将 checker 架构重构为完全内聚模式：每个 checker 目录包含自身的
types、schema、validate、execute、expect 和 index，新增 checker
只需创建一个目录并在 runner/index.ts 添加一行注册。

主要变更：
- runner/shared/ 拆分：断言基础设施迁入 checker/expect/，
  body.ts 迁入 http/，text.ts 迁入 command/
- config-contract/ 重命名为 schema/，schema.ts → builder.ts
- size.ts + parseDuration 合并为 utils.ts
- 顶层 types.ts 改为 base interface + index signature，
  checker 专属类型下沉到各自 types.ts
- runner/index.ts 改为显式数组注册模式
- 更新 DEVELOPMENT.md 项目结构和开发新 Checker 指南
 2026-05-13 14:38:21 +08:00
lanyuanxiaoyao
aade0bbff7 refactor: 清理 checker 遗留边界 2026-05-13 12:53:03 +08:00
lanyuanxiaoyao
7b20b59b79 feat: 重构配置校验为 TypeBox + Ajv + semantic validator，严格禁止未知字段 
- 新增 config-contract 模块（TypeBox fragments、Ajv 契约校验、ConfigValidationIssue）
- CheckerDefinition 扩展为含 configKey、schemas、validate 的完整插件接口
- HTTP/Command 各自维护 contract.ts + validate.ts，校验从 resolve 中分离
- resolve 不再承担校验，只做默认值合并和路径/单位解析
- config-loader 流程: unknown → RawProbeConfig → ValidatedProbeConfig → ResolvedConfig
- 导出 probe-config.schema.json，新增 schema/schema:check 脚本
- 更新 DEVELOPMENT.md 新增 1.7 开发新 Checker 完整指引
- 同步更新 4 个 main specs（probe-config、command-checker、expect-body-checkers、checker-runner-abstraction）
 2026-05-13 12:19:36 +08:00
lanyuanxiaoyao
bce0f8e7a8 feat: 增强 HTTP checker 鲁棒性 — 严格配置校验、完整耗时、流式body、重定向与编码完善 
启动期校验: 新增 validate.ts 对 HTTP config/expect/body rule/operator 全方位严格校验
执行语义: body 改为 Web Stream 流式超限中止，durationMs 覆盖完整执行
错误归属: status/header 失败不读 body，phase 分层 request/body，early duration skip body
重定向: 跟随前释放 body，POST/303 改 GET 清理 header，跨 origin 剥离敏感 header
编码: 支持 quoted charset，未知编码返回结构化解码错误
文档: README match→regex+durationMs，DEVELOPMENT 执行流程与错误归属
测试: +63 测试覆盖全部新增场景，325 pass 0 fail
规格: 同步 probe-config/probe-engine/expect-body-checkers 3 个 delta spec
 2026-05-13 08:00:05 +08:00
lanyuanxiaoyao
2fd0f206be feat: HTTP 探针增强 — ignoreSSL、精确重定向控制、状态码范围匹配、编码自动检测 2026-05-13 00:02:04 +08:00
lanyuanxiaoyao
87d946a441 fix: 修复 Windows 平台测试兼容性问题 
- 新增 tests/helpers.ts 的 rmRetry 工具函数，解决 SQLite 文件句柄未及时释放导致 afterAll 清理时 EBUSY 错误
- 修改通配符测试用例，使用 bun -e 替代 echo 命令，确保跨平台行为一致
 2026-05-12 22:12:32 +08:00
lanyuanxiaoyao
a5cf6065c2 chore: 强化代码质量与风格检查体系 
ESLint 升级到 recommended-type-checked + stylistic-type-checked，
引入 perfectionist 导入排序和 import 插件导入验证。

Prettier 显式声明全部格式化参数，消除跨环境差异。
TypeScript 启用 noUnusedLocals 和 noPropertyAccessFromIndexSignature。
完善 ignore 列表，排除 .agents/、bun.lock、data/ 等。
引入 husky + lint-staged（pre-commit）+ commitlint（commit-msg）。
更新 DEVELOPMENT.md 代码质量章节。
修复所有新增规则检测到的类型和风格违规。
 2026-05-12 18:44:59 +08:00
lanyuanxiaoyao
ce8baae3d1 refactor: 引入 Checker 统一接口与 Runner 抽象机制 
定义 Checker 接口（resolve/execute/serialize）和 CheckerRegistry
注册中心，消除 engine/config-loader/store 中硬编码类型分支。
按 checker 类型分子包（runner/http/、runner/command/），提取
共享 expect 到 runner/shared/。超时控制通过引擎注入 AbortSignal。
CheckFailure.phase 从联合类型改为 string。配置校验下沉到各
Checker.resolve() 内部。

新增 checker-runner-abstraction spec，更新 DEVELOPMENT.md。
 2026-05-12 17:08:57 +08:00
lanyuanxiaoyao
f7facb7232 refactor: 全面优化后端代码质量与架构 
- app.ts 单体路由拆分为 routes/ + helpers + middleware + static 独立模块
- 类型去重：CheckFailure/CheckResult 以 shared/api.ts 为唯一源头，收紧 phase 联合类型
- es-toolkit 替换：isPlainObject/isNil/isEmptyObject/isEqual/isError/Semaphore/groupBy
- Bun 内置 API：Object.fromEntries 替代手写 headersToRecord
- bun:sqlite 规范：prepare() → query() 利用内置缓存，避免 N+1 查询
- 新增 getLatestChecksMap/allGetTargetStats 批量查询方法
- 新增 backend-code-quality/api-route-separation/batch-data-queries 规范
- 补充 openspec/config.yaml 后端开发规范与 DEVELOPMENT.md 后端开发指引
 2026-05-12 15:15:36 +08:00
lanyuanxiaoyao
3fa1b3957e refactor: 项目更名为 DiAL（统一拨测平台） 
将 gateway-checker/Gateway Checker 统一替换为 dial-server/DiAL
- 包名、可执行文件名、API service 标识改为 dial-server
- UI 标题改为 DiAL，副标题改为统一拨测平台
- 同步更新测试断言、构建脚本、示例配置和文档
 2026-05-11 22:23:17 +08:00
lanyuanxiaoyao
0ee10b47c9 fix: 安全性与代码质量加固（异常保护、外键级联、竞态修复、优雅关机） 2026-05-11 14:24:12 +08:00
lanyuanxiaoyao
35ba56888b refactor: 移除 success 字段，简化为 matched 单层判定模型 2026-05-11 14:23:13 +08:00
lanyuanxiaoyao
548b44d28e feat: 重构 Dashboard 为卡片式分组布局 
表格布局替换为按分组展示的卡片式布局，新增 group 字段配置和 TargetBoard/TargetCard 等组件。模态框详情页支持时间范围筛选和分页，SummaryCards 减为 3 个。API 端点变更：trend/history 改用 from/to 参数，history 支持分页。recentSampleCount 硬编码为 30。
 2026-05-11 08:54:21 +08:00
lanyuanxiaoyao
b8810f1182 feat: 重构为多类型 checker 通用框架，支持 HTTP 与命令检查 
- 引入 typed target 判别联合，支持 http 与 command 两种 checker
- expect 重构为有序规则数组，按配置顺序快速失败并生成结构化 failure
- 新增 command runner，支持 exec + args 本地命令执行
- 引入全局并发限制 maxConcurrentChecks 和 size 解析 (KB/MB/GB)
- HTTP/command 各自独立 expect pipeline，应用领域默认成功语义
- SQLite schema、API、Dashboard 全链路调整为 checker 通用契约
- 补充完整测试覆盖（192 tests），更新 README 与示例配置
 2026-05-10 22:25:21 +08:00
lanyuanxiaoyao
599d973cbd feat: 增强 expect 规则系统，支持多种 body 校验方法和操作符 
- 新增 body 分组校验：contains、regex、json（JSONPath）、css（CSS选择器）、xpath
- 新增操作符系统：equals、contains、match、empty、exists、gte、lte、gt、lt
- 新增 headers 响应头校验
- 引入 cheerio、xpath、@xmldom/xmldom 依赖
- BREAKING: expect.bodyContains 迁移至 expect.body.contains
 2026-05-10 00:10:42 +08:00
lanyuanxiaoyao
57d3a5cfb4 feat: 将 demo 项目转化为 HTTP 拨测监控工具 
新增 YAML 配置解析（Bun 内置 YAML）、SQLite 数据存储（bun:sqlite）、按 interval 分组并发拨测引擎、REST API（/api/summary、/api/targets、/api/targets/:id/history、/api/targets/:id/trend）、React 前端 Dashboard（统计卡片、目标表格、可展开详情面板、recharts 趋势图）。CLI 简化为仅接受配置文件路径。移除 /api/demo 路由和相关 demo 代码。保留 /health、静态资源服务和 SPA fallback。
 2026-05-09 17:04:25 +08:00
lanyuanxiaoyao
3f477d1b57 feat: 完善全栈打包质量门禁 
在业务开发前补齐 lint、format、verify 与生产运行时契约，确保开发联调和 executable 打包链路可重复验证。
 2026-05-09 14:48:49 +08:00
lanyuanxiaoyao
5b412c624d feat: 搭建前后端可执行程序示例 2026-05-09 12:25:39 +08:00