# LingFrame

**Repository Path**: cnt-code/lingframe

## Basic Information

- **Project Name**: LingFrame
- **Description**: 灵珑（LingFrame）：面向长期运行系统的 JVM 运行时安全治理解决方案。通过模块化隔离和零信任权限控制，实现自动方法级全链路追踪，安全审计，不停机灰度发布等特性。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 5
- **Created**: 2026-02-26
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">灵珑 · LingFrame</h1>

<p align="center">
  <strong>面向长期运行系统的 JVM 运行时治理框架</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/Status-Resilience_Governance-brightgreen" alt="Status">
  <img src="https://img.shields.io/badge/License-Apache_2.0-blue" alt="License">
  <img src="https://img.shields.io/badge/Java-17-orange" alt="Java">
  <img src="https://img.shields.io/badge/Java-8-orange" alt="Java">
  <img src="https://img.shields.io/badge/Spring_Boot-3.5.6-brightgreen" alt="Spring Boot">
  <img src="https://img.shields.io/badge/Spring_Boot-2.7.18-brightgreen" alt="Spring Boot">
</p>

<p align="center">
  <a href="https://gitee.com/LingFrame/LingFrame">
    <img src="https://img.shields.io/badge/Gitee-Repository-red?logo=gitee&logoColor=white" alt="Gitee">
  </a>
  <a href="https://atomgit.com/lingframe/LingFrame">
    <img src="https://img.shields.io/badge/AtomGit-G--Star_孵化项目-silver?logo=git&logoColor=white" alt="AtomGit">
  </a>
  <a href="https://github.com/LingFrame/LingFrame">
    <img src="https://img.shields.io/badge/GitHub-Repository-black?logo=github&logoColor=white" alt="GitHub">
  </a>
  <a href="../../pulls">
    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs Welcome">
  </a>
  <a href="https://deepwiki.com/LingFrame/LingFrame">
    <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
  </a>
</p>

<p align="center">
  <a href="./README.md">English</a> | <strong>中文</strong>
</p>

灵珑是一个面向长期运行系统的 **JVM 运行时治理框架**。

> 灵珑不只负责把灵元加载进 JVM，  
> 更负责让它们在长期运行中可治理、可收敛、可被干净地卸载出去。

---

## ✨ 灵珑是什么？

- 一个面向单进程长期运行系统的运行时治理框架
- 一个帮助老系统重新恢复边界感和控制感的结构化工具
- 一个允许灵元存在，但不接受灵元失控的治理体系

---

## 🎯 它适合什么，不适合什么

### 更适合

- 已经运行多年、不能轻易停机或重写的单体系统
- 希望逐步引入灵元隔离、灰度、限流、熔断、权限与审计能力的团队
- 想在不彻底推翻现有系统的前提下，先把运行时秩序建立起来的场景

### 不适合

- 把它当成微服务替代品
- 把它当成纯前端插件市场或低代码装配平台
- 希望接入一个框架就自动消除业务复杂性

---

## 🧩 它真正想解决的问题

> 系统在长期运行中，如何不失控。

---

## ⚙️ 技术边界

- JVM：JDK 17 / JDK 8
- Spring Boot：3.x / 2.x
- 当前公开架构仍然是单进程内的灵元隔离与治理
- `Shared API` 是进程级公共契约边界：新共享包可以热加载，但已加载契约不支持热更新或热卸载；契约变更需要重启进程
- 原生支持灰度、熔断、限流、审计、权限、模拟与治理观测
- 可与外部注册中心、配置中心等基础设施做非侵入集成

---

## 💬 如果你准备继续往下看

- 想先快速跑通：看 [QUICK_START.zh-CN.md](./QUICK_START.zh-CN.md)
- 想正式入门：看 [getting-started.md](docs/zh-CN/getting-started.md)
- 想从源码实现理解当前公开能力：看 [technical-entry.md](docs/zh-CN/technical-entry.md)
- 想看 Dashboard 在当前版本里扮演什么角色：看 [dashboard.md](docs/zh-CN/dashboard.md)
- 想了解术语：看 [glossary.md](docs/zh-CN/glossary.md)

如果你现在只读到这里，也完全没关系。

---

## 🙏 致谢

**特别鸣谢 Gitee 官方与开源社区的推荐与支持！** 

感谢 [Gitee](https://gitee.com) 平台以及红薯老师为本土开源生态提供的优质土壤，让底层的轮子也能被看见。
👉 [访问 Gitee 官方主仓库](https://gitee.com/LingFrame/LingFrame)


[![AtomGit](docs/images/AtomGit.svg)](https://atomgit.com/lingframe/LingFrame)

本项目是 **AtomGit G-Star Incubated Project**。  
感谢 [AtomGit](https://atomgit.com) 平台对开源项目的支持与推广。