convez.ai
MCP ServerDesenvolvimento WebAvançado
ZiYuCai1984

ZYC.Framework

ZiYuCai1984/ZYC.Framework

Framework WPF modular para automação desktop com Aspire e Blazor

Ver no GitHub
BomPluginScore · de 0 a 100

Framework modular e extensível para .NET 10 e WPF com integração nativa de .NET Aspire e Blazor/WebView2. Voltado para automação desktop de alta performance com arquitetura plugin-based e suporte a aplicações híbridas web-desktop.

Instalação

$npx convez-ai ZiYuCai1984/ZYC.Framework

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 3 dias
Versão
v1.6.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Desenvolvimento de aplicações de automação desktop complexas
  • Arquitetura de sistemas híbridos web-desktop com reutilização de componentes Blazor
  • Orquestração distribuída de serviços em aplicações desktop enterprise

Veredito

Framework robusto e bem-estruturado para cenários avançados de automação desktop com .NET moderno, mas requer expertise sólida em WPF, .NET Aspire e arquitetura modular. Ainda em fase alpha, exigindo monitoramento de estabilidade antes de projetos críticos.

README

A tradução para o português deste README ainda está na fila.

A high-performance, modular, and extensible desktop automation framework built with .NET 10 and WPF.


📖 Overview

ZYC.Framework is a modern desktop automation solution that combines the expressive UI capabilities of WPF with the latest features of .NET 10. It is designed to simplify the development of complex automation systems through a modular architecture.

The project deeply integrates .NET Aspire for distributed application orchestration, and supports a hybrid approach with Blazor and WebView2, so you can choose between a Web-based UI and a native desktop experience as needed.


✨ Key Features

  • Modular Architecture: Decoupled business logic with dynamic loading and independent development.
  • Modern UI Experience: Built on WPF with support for multi-workspace and multi-tab interactions.
  • Hybrid Development:
    • WebView2 integration for embedding modern Web applications.
    • Blazor integration to reuse Web components seamlessly in desktop scenarios.
  • Cloud-Native Ready: Built-in .NET Aspire support to simplify service discovery, governance, and deployment.
  • Batteries Included (Enterprise-Oriented):
    • Task Management: Task scheduling and lifecycle management.
    • Exception Handling: Robust global error capture and diagnostics.
    • Localization: Built-in multi-language support for global-ready apps.

🛠️ Tech Stack

  • Runtime: .NET 10 SDK
  • UI Framework: WPF (Windows Presentation Foundation)
  • Hybrid UI: WebView2 + Blazor
  • Orchestration: .NET Aspire
  • Architecture: Modular Monolith / Plugin-based

🚀 Quick Start

Please refer to the detailed guide:

👉 Quick Start (quick-start.md)

👉 Download Demo Installer

Create a Project

The recommended way to start is the global dotnet tool. Install or update the CLI, then create a host project with zyc new:

dotnet tool install --global ZYC.Framework.CLI --version 1.3.5
dotnet tool update --global ZYC.Framework.CLI --version 1.3.5
zyc new MyCompany.Tools --template minimal

For manual integration, the core package can still be added directly with NuGet:

dotnet add package ZYC.Framework.Alpha --version 1.3.5

Documentation

GuidePurpose
Quick StartCreate a project and understand the manual fallback setup.
ArchitectureUnderstand startup, module loading, configuration, navigation, and runtime services.
Navigation and WorkspaceWork with URI navigation, tabs, workspaces, and restore timing.
Extension PointsFind the public places where modules can extend the host.
Built-in ModulesReview the built-in modules and their main responsibilities.
Module DevelopmentBuild a runtime module with contracts, ModuleBase, menus, and tabs.
Project TemplatesChoose and understand the minimal and modular CLI templates.
TroubleshootingDiagnose CLI, module loading, routing, NuGet module, Aspire, and terminal issues.

Features

Core Framework

FeatureDescription
Modular ArchitectureOrganize features as modules with support for dynamic loading and extension.
Multi-Workspace LayoutSplit, merge, reorder, and change workspace layout directions.
Multi-Tab NavigationURI-based tab navigation with switching, restoration, and cross-workspace movement.
Extensible Menu SystemExtension points for main menu, hamburger menu, title bar, status bar, and taskbar menus.
Notification SystemBuilt-in Toast and Banner notifications for status and error feedback.
Interaction UtilitiesDesktop interaction helpers such as BusyWindow, overlays, and drag-and-drop.
Hybrid UI SupportEmbed web content using WebView2 and build hybrid UI with Blazor.
Configuration & StateLocal persistence for configuration, application state, and task history.
Single InstanceSupports single-instance application startup control.
MCP ExposureAutomatically expose public framework and module capabilities as MCP tools.

Built-in Modules

The README keeps only the high-level feature summary. See Built-in Modules for the current module list, loading notes, and module responsibilities.

Development & Delivery

FeatureDescription
CLI ToolsStandalone CLI entry with module command extension support.
Module ScaffoldingGenerate new modules and abstraction projects from templates.
Documentation GenerationGenerate README and documentation templates.
NuGet PackagingBuild NuGet packages for framework and modules.
Installer BuildBuild desktop installers for distribution.

📸 UI Preview


📄 License

This project is open-sourced under the MIT License.


💖 Acknowledgements

This project uses (and/or references parts of implementations from) the following open-source projects:

Licenses and copyrights belong to their respective authors. This repository uses or references them in compliance with each project's license terms.


🤝 Contributing

Issues and pull requests are welcome. If you have suggestions or found a bug, please open an issue or submit a PR.

Ver o original no GitHub

Bom para

Relacionados