# GraphAgent **Repository Path**: Ljy_111/workflowprj ## Basic Information - **Project Name**: GraphAgent - **Description**: 基于 .NET 10.0 平台构建的企业级模块化软件开发框架 - **Primary Language**: C# - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2024-12-25 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: backend **Tags**: None ## README ## 项目场景 ### C# 主项目(MainProj.sln) - **构建**:`dotnet build "d:\Project\Program\WorkFlowPrj\CsharpPrj\MainProj.sln"` - **测试**:`dotnet test "d:\Project\Program\WorkFlowPrj\CsharpPrj\MainProj.sln"` - **层依赖**:基础层 → 模块层 → 共享层 → 操作层 → 应用层 ### FileDriven 项目 - **启动 GUI**:`EnableMent\交互启动.bat` - **启动 CLI**:`EnableMent\CLI启动.bat` - **配置目录**:`FileDriven/DrivenConfig/JsonConfig/`(UI 配置) - **启动入口**:`FileDriven/FileDriven.Launcher/Program.cs` ### Engine 项目(GameEditor) - **构建**:`dotnet build "d:\Project\Program\WorkFlowPrj\Engine\GameEditor.sln"` - **子项目**:Configuration / ECS / Graphics / Scene / Windowing 等 ### Agent 项目 - **构建**:`dotnet build "d:\Project\Program\WorkFlowPrj\Agent\Agent.sln"` - **测试**:`CentralTest/AgentTest/` ### TypeScript 项目 - **安装依赖**:`pnpm install` - **构建**:`pnpm --filter build` - **工作空间**:`TypeScriptPrj/TsWorkspace/` + `TypeScriptPrj/TsSln/` ### PowerShell 脚本 - **脚本根目录**:`PowerShellScript/` - **模块目录**:`PowerShellScript/BasicMethod/`(基础模块)、`PowerShellScript/Modules/`(扩展模块) - **脚本管理器**:`PowerShellScript/PScriptManager/` # WorkFlowPrj(工作流框架) 简体中文 | [English](README.en.md) ## 项目简介 **WorkFlowPrj(工作流框架)** 是一款基于 .NET 10.0 平台构建的企业级模块化软件开发框架,采用 C# 12 语言特性,融合 PowerShell 脚本自动化与 TypeScript 前端能力。框架以「万物皆函数,一切皆配置」为设计哲学,通过分层架构将复杂业务逻辑分解为独立可组合的模块,支持依赖注入、事件驱动、响应式编程等现代软件工程实践。 框架深度集成 AI 能力(Microsoft.SemanticKernel)、动态代码编译(Roslyn)、Docker 容器化部署与 MCP(Model Context Protocol)服务生态,为开发者提供从底层基础设施到上层业务逻辑的完整工具链。 ## 技术栈 | 领域 | 技术 | |------|------| | **后端** | .NET 10.0 + C# 12(可空引用类型、隐式 using) | | **脚本** | PowerShell 5.1+(模块化脚本框架) | | **前端** | TypeScript(Project References 统一构建) | | **AI** | Python 3.10+(DeepSeek 模型集成) | | **容器** | Docker + Docker Compose(MCP 服务集群) | | **协议** | MCP(Model Context Protocol)服务网格 | ## 项目结构 ``` WorkFlowPrj/ ├── CsharpPrj/ # C# 解决方案(MainProj.sln) │ ├── BasicMethod/ # 基础方法库(反射、算法、通用功能) │ ├── FileDriven/ # 文件驱动框架 │ ├── Modules/ # 模块化框架 │ ├── Operation/ # 操作层(工作流引擎、函数执行) │ ├── Plate/ # 平台层 │ ├── Protocol/ # 协议层(CSG 统一框架) │ └── Share/ # 共享层(WorkflowExecution 等) ├── PowerShellScript/ # PowerShell 脚本体系 │ ├── BasicMethod/ # 通用 PowerShell 模块(Core/FileOps/DevOps/Tooling) │ ├── AIDecisionFramework/ # AI 决策框架 │ ├── Build/ # 构建脚本 │ ├── Modules/Docker/ # Docker 管理模块 │ ├── Tools/Docker/ # Docker 工具脚本 │ └── PScriptManager/ # PowerShell 脚本管理框架 ├── TypeScriptPrj/ # TypeScript 解决方案(TypeScript.sln) │ ├── TsWorkspace/BasicMethod/ # 基础方法(TS 版) │ ├── TsWorkspace/MCPFramework/ # MCP 框架 │ ├── TsWorkspace/MCPBridge/ # MCP 桥接 │ └── TsWorkspace/CsprojContext/ # C# 项目上下文 MCP 服务 ├── PythonModel/ # Python AI 模型集成 │ ├── clients/ # AI 客户端 │ └── PythonModel.Bridge/ # Python 桥接 ├── DevEnvironment/ # 开发环境配置 │ └── Docker/ # Docker 配置(docker-compose、entrypoint) ├── EnableMent/ # 启动脚本 ├── DataStorage/ # 数据存储 ├── docs/ # 文档目录 ├── CentralTest/ # 集中测试 ├── Storage/ # 存储工具 └── vscode-plugin-framework/ # VS Code 插件框架 ``` ## 架构分层 | 层 | 编号 | 说明 | |----|------|------| | **协议层** | 0 | CSG 统一框架(Configuration-StateMachine-Graph 三投影) | | **基础层** | 1 | BasicMethod(反射、算法、通用功能) | | **模块层** | 2 | Modules(模块化框架、状态机) | | **共享层** | 3 | Share(WorkflowExecution 抽象、Pipeline) | | **操作层** | 4 | Operation(工作流引擎、函数执行引擎) | | **应用层** | 5 | FileDriven(文件驱动框架) | | **平台层** | 6 | Plate(平台服务) | ## 核心模块 ### C# 后端 | 模块 | 说明 | |------|------| | **BasicMethod** | 基础方法库:反射提取、数据处理流水线、图算法、函数注册与动态调用 | | **Protocol / CSG.Unified** | CSG 统一框架:C(配置)-> S(状态机)-> G(图)三投影变换引擎 | | **WorkflowExecution** | 工作流执行引擎:Pipeline 流水线、节点执行器、会话管理、状态机驱动 | | **FunctionExecution** | 函数执行引擎:表达式树编译、依赖注入、动态函数生成 | | **ParameterResolver** | 参数解析器:KeyMapping 映射框架、类型转换、多策略匹配 | | **FileDriven** | 文件驱动框架:配置驱动 UI 自动化、CLI 双模式运行 | | **StateMachine** | 通用状态机框架:条件状态机、状态机存储、会话管理 | ### PowerShell 脚本体系 | 模块 | 说明 | |------|------| | **BasicMethod** | 通用模块库:文件操作(FileUtils/FileDiff/FileBatch)、Docker 操作、包管理、工具桥接 | | **Docker 管理** | Docker 容器生命周期、MCP 服务安装、CLine 配置管理(配置驱动) | | **PScriptManager** | 脚本管理框架:自动扫描注册、函数名调用、模块清单生成 | | **AIDecisionFramework** | AI 决策框架:决策引擎、Token 核算、文件访问、工具桥接 | | **Build 脚本** | 全量编译脚本:C# + TypeScript 联合编译、清理、验证 | ### TypeScript 前端 | 模块 | 说明 | |------|------| | **BasicMethod** | 基础方法(TS 版):Pipeline、HealthChecker、RequestRouter | | **MCPFramework** | MCP 框架:服务器/客户端抽象、工具注册、SSE 传输 | | **MCPBridge** | MCP 桥接:Docker 容器内 MCP 服务代理、健康检查、请求路由 | | **CsprojContext** | C# 项目上下文 MCP 服务:9 个工具查询 .csproj 模块信息 | ### AI 集成 | 模块 | 说明 | |------|------| | **PythonModel** | DeepSeek 模型调用、AI 客户端封装 | | **PythonModel.Bridge** | C# <-> Python 桥接 | | **SemanticKernel** | 工作流引擎中的 AI 节点(提示词工程、函数调用、记忆管理) | ## Docker & MCP 生态 项目通过 Docker 容器化部署 MCP 服务集群,提供统一的开发环境: - **容器**:`workflow-mcp-env`(含 .NET SDK 10.0、Node.js、Python 3.10) - **MCP 服务**:8 个服务(端口 3100-3107),覆盖文件系统、代码搜索、文档查询、项目上下文等 - **管理脚本**:`Manage-Docker.ps1` 提供交互式菜单和命令行模式 - **配置驱动**:`DockerConfig.json` 集中管理所有常量,支持环境变量覆盖 ## 快速开始 ### 环境准备 1. 安装 .NET 10.0 SDK 2. 安装 PowerShell 5.1+(Windows 自带) 3. 安装 Node.js 18+ 和 pnpm 4. 安装 Docker Desktop(可选,用于 MCP 服务) 5. 安装 Python 3.10+(可选,用于 AI 集成) ### 编译项目 ```bash # 克隆项目 git clone https://github.com/3245489044/ZhiLianStorage.git cd ZhiLianStorage # 编译 C# 解决方案 dotnet restore CsharpPrj/MainProj.sln dotnet build CsharpPrj/MainProj.sln # 编译 TypeScript 解决方案 cd TypeScriptPrj npm install node build/TsSln/cli.js build # 或使用一键编译脚本 pwsh PowerShellScript/Build/Invoke-FullRebuild.ps1 ``` ### 启动方式 ```bash # GUI 模式(文件驱动框架配置选择器) EnableMent\UI启动.bat # 交互式脚本启动 EnableMent\交互启动.bat # CLI 模式 EnableMent\CLI启动.bat # Docker 管理 pwsh PowerShellScript/Tools/Docker/Manage-Docker.ps1 ``` ## 开发规范 ### 代码风格 - **命名**:类型/方法 PascalCase,私有字段 `_camelCase`,接口 `I` 前缀 - **格式**:Allman 大括号,4 空格缩进,120 字符行限制 - **注释**:公共 API 必须包含 XML 文档注释(中文) ### Git 工作流 - 主分支:`main` - 远程仓库:GitHub + Gitee 双平台同步 - 同步脚本:`sync-repos.sh "提交信息"` ### 测试要求 - 核心模块单元测试覆盖率 80%+ - 核心业务逻辑覆盖率 90%+ - 测试遵循 Arrange-Act-Assert 模式 ## 许可证 本项目采用 Apache License 2.0 开源许可证。详情请参阅 [LICENSE](LICENSE) 文件。 ## 联系方式 - **GitHub**:[3245489044/ZhiLianStorage](https://github.com/3245489044/ZhiLianStorage) - **Gitee**:即将支持 ## 更新日志 ### v1.0.0 (2025-05-11) - 初始版本发布,建立完整模块化项目结构 - 集成 Microsoft.SemanticKernel AI 能力 - 实现 Roslyn 动态代码编译引擎 - 开发工作流引擎与命令框架 - 整合 LiteDB、SQLite 等多种数据存储 - 提供 Windows 桌面 UI 组件库 --- **WorkFlowPrj** —— 让企业级应用开发更简单、更高效、更智能!