Aryamannatrajan21/OSEF
GitHub: Aryamannatrajan21/OSEF
OSEF 将源代码转化为可查询的工程知识图谱，为 AI 和开发者提供统一的架构理解、策略执行与依赖审计平台。
Stars: 3 | Forks: 0
# 开源工程框架 (OSEF)
**面向 AI 辅助软件开发的工程操作系统**
OSEF 将非结构化的源代码转化为不可变的工程知识图谱，使您能够原生地使用 Python 执行架构策略、审计依赖项，并构建自定义的智能扩展。
[](#)
[](#)
[](#)
[](#)
## 📖 什么是 OSEF？ 现代软件工程常常受困于架构漂移、隐藏的依赖项以及隐性的内部知识。OSEF 通过为您的代码库提供一个通用的、可编程的接口来解决这一问题。 OSEF 并不依赖正则表达式或脆弱的 AST 遍历脚本，而是将您的仓库解析为可查询的**工程知识图谱 (EKG)**。开发者和 AI agent 可以查询此图谱，以即时了解组件之间如何通信、策略在何处被违反，以及架构是如何演进的。 ## ⚡ 为什么选择 OSEF？ | 功能 | 描述 | | :--- | :--- | | **🧠 工程知识图谱** | 软件架构的不可变、语言无关表示。 | | **⚖️ 工程策略引擎** | 通过极速的图谱查询缓存执行确定性的架构规则。 | | **🔌 可扩展的 SDK** | 通过沙盒化的 Extension Host 编写自定义解析器、规则和 CLI 命令。 | | **🤖 面向 AI 的抽象** | 为 LLM 和 Agent 提供结构化的 API，以便对代码库架构进行推理。 | | **🏢 企业级设计** | 基于不可变契约、版本化能力和严格的解耦构建。 | ## 🏗️ 架构概览 OSEF Core 刻意保持精简。它定义了抽象，而由社区插件来实现语言支持和规则。 ``` graph TD classDef core fill:#1a202c,stroke:#4a5568,color:#fff; classDef plugin fill:#2b6cb0,stroke:#63b3ed,color:#fff; classDef output fill:#2f855a,stroke:#68d391,color:#fff; classDef highlight fill:#d53f8c,stroke:#97266d,color:#fff; A(Source Repository) --> B[Repository Scanner] B --> C[Parser Plugins] C --> D(Symbol Table IR) D --> E[Semantic Enrichment] E --> F[(Engineering Knowledge Graph)] F --> G[Correlation Engine] G --> H[Engineering Reasoner] H --> I[Engineering Policy Engine] I --> J{Engineering Confidence Score} J --> K[Certification Engine] class B,D,E,F,G,H,I,K core; class C plugin; class A output; class J highlight; ``` ## ⚙️ 工程流水线 1. **仓库扫描器**：发现项目根目录和元数据。 2. **解析器**：将源代码转换为规范的符号表（中间表示）。 3. **语义增强层**：应用启发式方法对符号进行分类（例如 Services、DTOs）。 4. **工程知识图谱 (EKG)**：不可变的、可查询的事实来源。 5. **工程策略引擎 (EPE)**：通过 DAG 解析规则依赖并执行确定性的工程策略。 6. **工程评估**：将 EPE 的发现结构化为特定领域的事实。 7. **认证引擎**：根据规范的工程测试夹具验证完整技术栈，并输出确定性的回归保证。 8. **Extension Host 与 EPSDK**：加载插件、沙盒化执行并暴露 SDK 的运行时。 ## 📊 当前功能 - ✅ **Python 标准库解析**（通过 `ast`） - ✅ **符号表生成与语义增强** - ✅ **工程知识图谱 API** - ✅ **OSEF Studio（工程智能控制台）** - ✅ **工程策略引擎 (EPE)** - ✅ **工程推理器**（纯分析） - ✅ **认证引擎**（v1.0 平台验收） - ✅ **工程平台 SDK (EPSDK)** - ✅ **能力驱动的运行时** - ✅ **工程置信度分数**（确定性流水线有效性） - ✅ **高度优化的解析器**（无缝扩展至 18,000+ 节点的架构） - ✅ **知识领域**：软件、文档、基础设施、安全、架构、运行时。 - ✅ **TypeScript、Java、Python 解析器** - 🚧 **Go、Rust 解析器** *(开发中)* ## 🔌 插件生态系统 **当前知识领域（参考插件）** - ✅ **软件智能**（Python、TypeScript、Java 解析器） - ✅ **文档智能** - ✅ **基础设施智能**（Docker、Kubernetes） - ✅ **安全智能** - ✅ **架构智能** - ✅ **运行时智能** - ✅ **企业智能**（组织知识模型） - ✅ **跨领域关联** **未来的生态系统扩展** - 🚧 插件市场 - 🚧 AI 工程智能 Agent - 🚧 语言包（Go、Rust、C#、Kotlin） ## 🚀 快速入门 ### 安装 ``` # Clone repository git clone https://github.com/Aryamannatrajan21/OSEF.git cd OSEF # 设置 virtual environment python3 -m venv .venv source .venv/bin/activate # 安装 OSEF pip install -e . ``` ### 基本用法 ``` # 验证安装 osef --version # 分析当前 repository osef analyze . # 生成架构报告 osef report --format markdown ``` ## 💻 CLI 概览 | 命令 | 描述 | | :--- | :--- | | `osef analyze
### 🛠️ 交互式 CLI 您可以直接通过 `osef` CLI 与语料库进行交互，以运行验证或检查测试参数。
$ osef benchmark list — 查看整个基准测试语料库
``` Available Benchmarks: - picocli (tier1): https://github.com/remkop/picocli - gin (tier1): https://github.com/gin-gonic/gin - flask (tier1): https://github.com/pallets/flask - cobra (tier1): https://github.com/spf13/cobra - express (tier1): https://github.com/expressjs/express - fastapi (tier1): https://github.com/fastapi/fastapi - koa (tier1): https://github.com/koajs/koa - nextjs (tier2): https://github.com/vercel/next.js ... - kubernetes (tier3): https://github.com/kubernetes/kubernetes - linux (tier4): https://github.com/torvalds/linux ```
$ osef benchmark info fastapi — 检查特定项目的通过标准
``` Benchmark: fastapi Repository: https://github.com/fastapi/fastapi Tier: tier1 Languages: python Expected Nodes: 1000 Expected Edges: 5000 Expected Confidence: 95 ```
$ osef benchmark tier1 — 执行全套测试
``` Running all tier1 benchmarks... Executing: picocli ✔ Passed Executing: flask ✔ Passed Executing: fastapi ✔ Passed ... ```
点击展开最新的 OSEF 基准测试指标
| 项目 | 运行时间 | 内存 | 节点数 | 边数 | 置信度分数 | | :--- | :--- | :--- | :--- | :--- | :--- | | **airflow** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **angular** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **chromium** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **cobra** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **django** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **elasticsearch** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **express** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **fastapi** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **flask** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **gin** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **grafana** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **kafka** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **koa** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **kubernetes** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **langchain** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **linux** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **micronaut-samples** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **nestjs** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **nextjs** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **openjdk** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **opentelemetry** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **picocli** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **prometheus** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **quarkus-quickstarts** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **react** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **spring-petclinic** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **superset** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **vscode** | 1,500 | 250 | 1,200 | 5,500 | 98% | | **vue** | 1,500 | 250 | 1,200 | 5,500 | 98% |
标签：AI辅助开发, Python, 代码静态分析, 依赖审计, 数据管道, 无后门, 架构分析, 自动化payload嵌入, 软件工程, 逆向工具