善
善·爱 ShanYi·AI
系统架构 · 开源造物
OPEN-SOURCE CREATIONS · 善意开源造物工坊

把繁复的工程留给底座，
把纯粹的创造还给开发者。

这里汇总了我独立架构并持续维护的工业级开源造物。聚焦高可用生产架构的两大核心命题——「分布式确定性容错（ElecCloud 电子云）」与「极轻量无感可观测（LightPulse 轻脉 APM）」，每一行代码均源于真实工业与高并发场景的千锤百炼。

⚡ 01 · ElecCloud 分布式重试 ▊ 02 · LightPulse 极轻量监控 ⚖️ 双旗舰技术选型对照 ◈ 03 · 智擎运筹与内容底座
01 / TWIN FLAGSHIPS · 双星并列核心造物

一手筑牢「容错底线」，一手洞察「系统脉搏」

Apache-2.0 开源许可 · 原生支持 Spring Boot 2.7 & 3.x
RETRY
⚡ FLAGSHIP 01 · DISTRIBUTED RESILIENCE 云
ElecCloud 电子云 · 轻量分布式重试框架
“给每一次失败一个确定的归宿 —— 瞬态抖动就地快消，极端崩溃异步自愈。”

面向单向网络隔离与进程崩溃防护设计的两级协同重试引擎。本地毫秒级快重试消化 90% 网络偶发闪断，超限平滑升级为 Redis / RabbitMQ 延时慢重试，彻底解决传统同步重试阻塞业务线程池与中心回调打不通内网的顽疾。

● 本地 200ms 快消
两级协同架构，主线程 0ms 阻塞释放
● 单向网络去中心化
零反向 HTTP 回调，跨 VPC/K8s 即插即用
● PRE_SUBMIT 防崩溃
执行前原子持久化，OOM / 断电不丢任务
● 一行注解零侵入
@RetryableTask · 已发布 Maven Central
⚡ 在线真实演练 🎛️ Admin 控制台 📖 设计长卷
⭐ GitHub
PULSE
▊ FLAGSHIP 02 · LIGHTWEIGHT OBSERVABILITY 脉
LightPulse 轻脉 · 极轻量监控与拨测套件
“听见脉搏，而不惊动它 —— 纯单向出站零监听端口，微秒级无感观测。”

专为私有化交付内网、混合云与中微型架构打造的极轻量监控探针与状态机拨测系统。支持 Java Agent / Spring Boot Starter 双形态接入，以低于 25MB 的极致内存开销提供全链路追踪、主机全分区预警与动态 Token 业务巡检。

● 内存开销 < 25MB
CPU < 0.1%，纯 Java 零原生 C 依赖
● 只出不进 · 零监听端口
Zero-Inbound 单向出站，严防扫描渗透
● Token 状态机拨测
动态登录自动续期，真实业务链路巡检
● 60s 热同步 & 提前预警
磁盘/内存水位预判 + 企微/钉钉/飞书降噪
▊ 在线真实体验 架构工作台 ↓ 📖 设计长卷
⭐ GitHub
02-A / ARCHITECTURE DEEP DIVE · 旗舰一架构工作台

ElecCloud · 轻量级分布式两级协同重试框架

点击左侧四大核心子系统切换架构图解
云 ElecCloud · 分布式重试与崩溃自愈引擎 Apache-2.0 · Maven Central v1.0.1
Java 17 / 21 Spring Boot 2.7 & 3.x 两级协同重试 单向网络去中心化 PRE_SUBMIT 防崩溃 ⭐ GitHub 仓库
ELECCLOUD ARCHITECTURE · 核心架构深潜

两级协同重试机制（本地快重试 + 分布式慢兜底）

针对 50ms 网络瞬断，SDK 优先在当前线程本地快速重试（2 次 / 200ms），毫秒级自愈且零 DB/Redis/MQ 开销。本地耗尽后平滑升级至分布式持久化慢重试，主线程 0ms 阻塞释放。

毫秒级本地快重试

吸收 90% 瞬态网络偶发抖动与慢连接，直接返回业务结果，杜绝写放大。

持久化平滑升级

本地用尽后自动入库并投递延时队列，由后台引擎接管削峰与指数退避重试。

主线程即刻释放

彻底摆脱 Spring Retry 长时间 sleep 耗尽 Tomcat 业务线程池的雪崩风险。

一行注解零侵入

@RetryableTask(sceneType = 1001, localRetryTimes = 2, localIntervalMs = 200)。

QUICK START · 快速接入与部署
# 1. 克隆 ElecCloud 并一键启动服务端
$ git clone https://github.com/chaoking320/eleccloud.git
$ cd eleccloud && docker compose up -d
# 2. 引入 Maven Central 客户端 SDK
<artifactId>retry-client-sdk</artifactId>
<version>1.0.1</version>
配套深度架构长卷《给每一次失败一个确定的归宿：ElecCloud 两级重试设计》已刊印。
● 协议：Apache-2.0 ● Maven Central v1.0.1
02-B / ARCHITECTURE DEEP DIVE · 旗舰二架构工作台

LightPulse · 极轻量级主机监控与状态机拨测系统

点击左侧四大核心子系统切换架构图解
脉 LightPulse · 极轻量无感探针与主动拨测套件 Apache-2.0 · 内存 < 25MB
Zero-Inbound 零监听端口 Spring Boot 2.x & 3.x Starter 动态 Token 状态机拨测 VictoriaMetrics / MySQL 分区 ⭐ GitHub 仓库
LIGHTPULSE ARCHITECTURE · 核心架构深潜

只出不进通信拓扑（Zero-Inbound 零入站端口安全架构）

传统监控（如 Prometheus Exporter）要求在每台被控主机开启 HTTP 监听端口，极易在客户私有化内网与等保测评中成为渗透靶标。LightPulse Agent 采用纯单向出站上报 + 60s 增量拉取热配置，目标机零监听端口。

零入站端口 (Zero-Inbound)

Agent 不开启任何本地 Socket 监听，彻底杜绝机房端口扫描与横向渗透风险。

Nginx 借道伪装穿透

支持复用生产现有 Nginx 80/443 业务子路径转发，绕过不可控外层网关，无需新开防火墙策略。

60s 控制台无感热更新

在 Web 控制台修改拨测规则或阈值后，各节点 60 秒内自动增量同步生效，免登录重启。

systemd 5s 崩溃自愈守护

内置进程级防死复活与 60s/5次 熔断保护，即使遭遇 kill -9 误杀也能在 5 秒内自动拉起。

QUICK START · 探针启动与 Starter 集成
# 1. 极轻量启动主机与拨测 Agent (<25MB)
$ java -Xms32m -Xmx64m -jar \
monitor-agent.jar -c config.json
# 2. 或在 Spring Boot 2.x/3.x 引入 Starter
<artifactId>monitor-spring-boot3-starter</artifactId>
配套深度架构长卷《听见脉搏，而不惊动它：LightPulse APM 极轻量监控系统设计》已刊印。
● 协议：Apache-2.0 ● 生产就绪 v1.8
03 / TECHNICAL BENCHMARK · 架构选型横向对照
⚖️ 为什么要造 ElecCloud 与 LightPulse？
技术维度 Spring Retry 传统定时调度 (XXL-JOB) 中心化回调型平台 ElecCloud 电子云
核心定位 单机进程内即时重试 批量定时 Cron 作业调度 中心式任务调度与回调 两级协同异步方法级重试引擎
进程崩溃防护 ❌ 进程退出即丢失 ✅ 具备数据库记录 ✅ 具备中心库记录 ✅ PRE_SUBMIT 预提交原子防丢
网络拓扑约束 本地单机 需双向连通 / Agent 通道 必须双向互通 (Server→业务) 仅需单向连通 (业务→Server)
两级协同重试 ❌ 仅本地阻塞 sleep ❌ 仅慢周期扫描 ❌ 每次微抖动均写放大 ✅ 本地 200ms 快消 + 分布式慢兜底
业务接入成本 极低 高 (每个方法需维护 Handler) 中等 (需配鉴权与反向 IP) 极低 (一行 @RetryableTask 注解)
技术维度 Prometheus + Exporter 重型 APM / ELK 全家桶 传统定时脚本巡检 LightPulse 轻脉 APM
客户端内存开销 中等 (多个 Exporter 进程) 极高 (数百 MB 至数 GB) 低 < 25MB (CPU < 0.1%，零感运行)
网络安全与端口暴露 ❌ 目标机需开 9100 等入站端口 单向或双向不一，组件繁杂 常需 SSH 免密通道 ✅ Zero-Inbound 纯出站，零监听端口
受保护业务接口拨测 ❌ Blackbox 难以处理动态登录态 ❌ 被动依赖流量，无流量不触发 维护复杂，Token 过期易误报 ✅ 内置动态 Token 自动续期状态机
配置变更与运维成本 需改各节点配置或搭 Consul 运维极重，中小团队难以驾驭 逐台机器 SSH 改脚本 ✅ 控制台统一维护，60s 自动热同步
时序存储压缩效率 高 (TSDB) 低 (ES 倒排索引膨胀 10 倍) 无历史时序留存 ✅ VictoriaMetrics (1.5B/点) + MySQL 分区
◈ 04 / SELF-DEVELOPED PLATFORM · 自研数字化与运筹底座 OptaPlanner 约束求解 多租户暗场 SSR 静态快照高可用降级

智擎平台 (ZhiQing) · 工业排产运筹算法与多租户内容引擎

融合 OptaPlanner 运筹求解引擎的高级计划排产系统（APS）与多租户内容管理系统（CMS）。在产能、模具、换线损耗与交期等多重硬软约束下求解全局排程方案；同时作为本站（shanyiai.site）的底层驱动引擎，原生支持暗场微光 SSR 渲染、自动 SEO 结构化图谱与静态快照秒级容灾降级。