# 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**: 0 - **Forks**: 4 - **Created**: 2026-02-26 - **Last Updated**: 2026-03-07 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # LingFrame · 灵珑 ![Status](https://img.shields.io/badge/Status-Resilience_Governance-brightgreen) ![License](https://img.shields.io/badge/License-Apache_2.0-blue) ![Java](https://img.shields.io/badge/Java-17-orange) ![Java](https://img.shields.io/badge/Java-8-orange) ![Spring Boot](https://img.shields.io/badge/Spring_Boot-3.5.6-brightgreen) ![Spring Boot](https://img.shields.io/badge/Spring_Boot-2.7.18-brightgreen) [![AtomGit G-Star](https://img.shields.io/badge/AtomGit-G--Star_Incubated-silver?logo=git&logoColor=white)](https://atomgit.com/lingframe/LingFrame) [![GitHub](https://img.shields.io/badge/GitHub-Repository-black?logo=github&logoColor=white)](https://github.com/LingFrame/LingFrame) [![Gitee](https://img.shields.io/badge/Gitee-Repository-red?logo=gitee&logoColor=white)](https://gitee.com/knight6236/lingframe) [![Help Wanted](https://img.shields.io/badge/PRs-welcome-brightgreen)](../../pulls) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/LingFrame/LingFrame) [![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/LingFrame/LingFrame?quickstart=1) [中文版 / Chinese](./README.zh-CN.md) ## Start From Here - **Technical Entry**: Dive into governance details and architecture 👉 [technical-entry.md](docs/technical-entry.md) - **Practical Entry**: Quick start and canary deployment 👉 [practical-entry.md](docs/practical-entry.md) - **Quick Trial**: 👉 [getting-started.md](docs/getting-started.md) - **Core Stance**: 👉 [MANIFESTO.md](MANIFESTO.md) - **Design Principles and Boundaries**: 👉 [WHY.md](WHY.md) You don't need to read everything at once. LingFrame allows you to pause at any stage. --- ![LingFrame Dashboard Example](./docs/images/dashboard.png) *Real-time ling governance dashboard: monitor status, canary traffic, and audit logs.* --- LingFrame (LingFrame) is a **JVM runtime governance framework for long-running systems**. It aims to keep legacy monolithic applications stable, controllable, and evolvable **without rewriting the system or forcing microservices splits**. Many systems aren't poorly designed— they've just lived too long and changed too hastily. --- ## Prologue It wasn't born for elegance initially. One day, people realized the system had grown too vast to comprehend, yet it couldn't stop. Every change felt like groping in the dark, every deployment came with a prayer. So, someone asked a seemingly conservative question: > If the system can't be rewritten for now, > can it still be **governed**? Not through more rules, but through **clearer boundaries**. Not making decisions for the system, but putting things back in their rightful place while it's still understandable. Thus, LingFrame was born. --- ## What LingFrame Focuses On Isn't "Adding Features" In many real-world systems, the issue isn't a lack of features, but: - The system is still running, but no one dares to change it - Unit boundaries fade, couplings become untraceable - After introducing Lings, isolation stays structural only - Restarts aren't unacceptable, but **unpredictable** LingFrame addresses one core problem: > **How to prevent systems from losing control in long-term operation.** --- ## Current Stage **v0.2.0 · Metamorphosis** This is a stage of breaking shackles and redefining boundaries: - Discarding the cognitive limits of "Plugin" to establish physical "Ling (Unit)" isolation - Resilience governance is no longer superficial, but deeply embedded as kernel-level circuit breakers - Confronting the deep waters of ClassLoader leaks, replacing compromise with absolute eviction - Verifying another thing: **Can monolithic hot-swapping truly withstand industrial-grade high availability challenges?** This is a phase that sheds immaturity and confronts brutal production realities. --- **v0.1.0 · First Cry (Historic)** This is a stage where the direction is frozen and boundaries are forming: - Not pursuing full features - No backward compatibility promises - Verifying one thing: **Does runtime governance hold in a single process?** This is a phase that rejects pandering and begins choices. --- ## What Is LingFrame - A **JVM runtime governance framework** - A **structural tool for legacy systems** - A **system that allows Lings but doesn't tolerate their chaos** - A **resilient hub** equipped with Circuit Breakers, Rate Limiters, and Ecosystem SPI extensions It's not a microservices replacement, nor a modularization silver bullet. LingFrame's purpose is to provide possibilities for **"retraction" and "reorganization"** when the system reaches a certain complexity. --- ## Technical Boundaries (Overview) - JVM: JDK 17 / JDK 8 - Spring Boot: 3.x / 2.x - Single-process ling isolation and governance - **Resilience & Ecosystem**: Native support for Canary releases, Circuit Breaking, Rate Limiting, and non-invasive external registry/config integration. - Clear distinction: **Interface stability ≠ Implementation stability** LingFrame doesn't hide complexity— it just refuses to dump it all on the user at once. --- ## Finally LingFrame won't make decisions for the system. She just helps put things back in place while the system is still willing to be understood. If you just stop here, that's perfectly fine. --- ## Acknowledgments [![AtomGit](docs/images/AtomGit.svg)](https://atomgit.com/lingframe/LingFrame) This project is an **AtomGit G-Star Incubated Project**. Thanks to [AtomGit](https://atomgit.com) for supporting and promoting open source projects.