kernel v1.0.0 (2026-06-12)
12 子包初始稳定发布
| 子包 |
用途 |
lifecycx |
组件有序启动/逆序停止，失败自动回滚 |
errx |
结构化错误：ErrorKind/Severity/IsKind/AsError/ShouldRetry |
healthx |
健康检查状态与聚合（healthy/degraded/unhealthy） |
obsx |
可观测抽象接口：Logger/Metrics/Tracer/Span + Noop + SecretString |
retryx |
重试策略配置原语：指数退避 Delay/Jitter/Validate |
shutdownx |
优雅停机：LIFO Hook 管理 + OS 信号处理 |
syncx |
并发控制：SemaphoreLimiter + WorkerGroup |
timex |
时钟抽象：RealClock/FixedClock/FakeClock |
validx |
前置条件校验：Precondition/Invariant/RequireNonEmpty |
versionx |
版本信息：BuildInfo + Compatibility |
contextx |
类型安全上下文：Key[T]/WithValue/Value/DeadlineRemaining |
contracttest |
契约测试辅助：AssertJSONFields/AssertErrorKind/AssertHealthStatus |
关键指标
| 指标 |
值 |
| 依赖 |
stdlib-only，零外部依赖 |
| 覆盖率 |
100% 核心库（12/12 子包） |
| 测试 |
全部通过，-race 清零 |
| CI 门禁 |
15 项全部通过 |
| Go 版本 |
1.23（兼容 1.26） |
性能基准
| Benchmark |
结果 |
目标 |
| NewError |
~0.4 ns |
< 100ns ✅ |
| IsKind (5层) |
~35 ns |
< 1μs ✅ |
| Delay |
~3 ns |
< 100ns ✅ |
| Aggregate (10) |
~530 ns |
< 10μs ✅ |
安装
go get github.com/ZoneCNH/kernel@v1.0.0
按需引入单个子包：
import (
"github.com/ZoneCNH/kernel/errx"
"github.com/ZoneCNH/kernel/timex"
)v1.0.0 发布前 PR
| PR |
内容 |
| #14 |
v1.0.0 CHANGELOG + Benchmark 函数 |
| #15 |
CI benchmark 回归门禁 |
| #16 |
.editorconfig + CODING-STANDARDS |
| #17 |
benchmark lint fix |
| #18 |
release contract tests fix |
| #19 |
benchmark baseline update |
| #20 |
release evidence |
| #21 |
bench threshold → 25 |
🤖 Generated with Claude Code
