• English
• 中文

BasePlugin is a comprehensive Excel add-in development template designed for building powerful Office extensions. Built on the DTI_Tool.AddIn hot-pluggable framework, it provides developers with a complete foundation for creating Excel/WPS plugins using C#, .NET Framework, VSTO, and modern development practices.

• Excel Plugin Development / Excel Add-in Development
• Office Add-ins / Office Extensions
• VSTO Add-ins / COM Add-ins
• Excel Automation / Office Automation
• WPS Office Plugins
• Microsoft 365 Add-ins

• 🔌 Hot-Pluggable Architecture - Dynamic loading/unloading without restarting Excel
• 🌐 Cross-Platform Support - Works with Microsoft Excel & WPS Office
• 🛠️ Complete Development Kit - Full-featured template with best practices
• 📦 Easy Deployment - Simple installation and distribution
• 🔄 Auto-Update System - Built-in update mechanism with SHA-256 verification
• 🎨 Modern UI Support - WinForms & WPF with MVVM pattern
• 📚 Comprehensive Documentation - Detailed guides in English & Chinese

• C# (.NET Framework 4.8.1)
• Excel Interop / Office Interop
• VSTO (Visual Studio Tools for Office)
• COM Add-ins
• WPF & WinForms
• DTI_Tool.AddIn Framework

• ✅ IPlugin Interface - Complete plugin lifecycle management
• ✅ Modular Architecture - Clean separation of concerns
• ✅ Error Handling - Robust exception handling and logging
• ✅ COM Object Management - Safe Excel COM interop

• ✅ WinForms Support - Simple dialogs and tool windows
• ✅ WPF + MVVM - Modern UI with data binding
• ✅ Office Icons - Native Office-style icons
• ✅ Custom Ribbon - Fluent UI ribbon customization
• ✅ Task Panes - Dockable task pane windows

• ✅ Auto-Update System - Automatic version checking and updates
• ✅ File Integrity - SHA-256 verification
• ✅ Hot Reload - Dynamic plugin loading/unloading
• ✅ Multi-language - i18n support ready
• ✅ Settings Management - Persistent configuration storage

• ✅ Complete Documentation - Step-by-step guides
• ✅ Sample Code - Real-world examples
• ✅ Best Practices - Performance optimization tips
• ✅ Deployment Guide - From development to production

• Windows 10/11
• Visual Studio 2019/2022
• .NET Framework 4.8.1
• Microsoft Excel 2016+ or WPS Office

# Clone the repository
git clone https://github.com/90le/Excel-Plugin-Template.git
cd Excel-Plugin-Template

# Open in Visual Studio
start BasePlugin.sln

# Build the project
msbuild BasePlugin.sln /p:Configuration=Release

1. Rename the project

// BasePlugin.cs → MyExcelPlugin.cs
public class MyExcelPlugin : IPlugin
{
    public string Name => "My Excel Plugin";
    public string Description => "Custom Excel automation tool";
    public string Author => "Your Name";
    public string Version => "1.0.0";
}

2. Add custom features

// Features/MyCustomFeatures.cs
public static class MyCustomFeatures
{
    public static void MyFeature(IRibbonControl control)
    {
        Excel.Application app = Globals.ExcelApp;
        Excel.Worksheet sheet = app.ActiveSheet;
        
        // Your custom logic here
        sheet.Range["A1"].Value = "Hello from my plugin!";
    }
}

3. Deploy to DTI_Tool.AddIn

Copy BasePlugin.dll → %AppData%\DTI_Tool\Plugins\

Plugin Manager Interface	Auto-Update System
Excel Integration	WPF Task Pane

BasePlugin/
├── Core/                       # Core framework components
│   ├── FeatureManager.cs      # Feature registration & management
│   ├── TaskPaneManager.cs     # Task pane lifecycle management
│   ├── PluginLogger.cs        # Logging infrastructure
│   └── MessageHelper.cs       # User notification system
├── Features/                  # Feature implementations
│   ├── BasicFeatures.cs       # Basic Excel operations
│   ├── DataProcessing.cs      # Data manipulation features
│   ├── Formatting.cs          # Cell formatting utilities
│   └── WindowDemo.cs          # UI demonstrations
├── Models/                    # Data models
│   └── PluginFeature.cs      # Feature definition model
├── WPF/                      # WPF components
│   ├── Views/                # XAML views
│   ├── ViewModels/           # MVVM view models
│   └── Controls/             # Custom controls
├── WinForms/                 # WinForms dialogs
├── Resources/                # Icons & resources
└── BasePlugin.cs            # Main plugin entry point

BasePlugin 是一个专业的 Excel 插件开发模板，为开发者提供完整的框架和最佳实践。无论您是初学者还是经验丰富的开发者，都可以基于此模板快速构建强大的 Excel/Office 扩展应用。

💡 AI 赋能开发 - DTI_Tool.AddIn 框架持续更新，集成最新 AI 功能。一句话描述需求，自动生成 Excel/WPS 个性化插件！

🏪 插件生态市场 - 即将推出的插件市场，让开发者轻松发布和分发插件。支持自动更新、版本管理、收益分成等完整生态。

🌟 社区驱动 - 活跃的开发者社区，定期举办技术分享和最佳实践交流。

💡 使用提示：将编译后的插件文件放到 %AppData%\DTI_Tool\Plugins\ 目录，插件将自动被识别和加载。

• 🎯 智能版本检测 - 后台自动检查，不干扰用户工作
• 🔒 安全文件校验 - SHA-256 + 数字签名双重保护
• ⚡ 高效增量更新 - 只下载变更部分，节省带宽90%
• 🌐 CDN 分发支持 - 全球加速，更新速度提升5倍
• 📊 更新统计分析 - 详细的使用数据和成功率监控

确保您的开发环境满足以下要求：

• ✅ Windows 10/11
• ✅ Visual Studio 2019/2022
• ✅ .NET Framework 4.8.1
• ✅ Microsoft Excel 2016+ 或 WPS Office

# 方式一：Git 克隆（推荐）
git clone https://github.com/90le/Excel-Plugin-Template.git
cd Excel-Plugin-Template

# 方式二：直接下载 ZIP 文件
# 访问 GitHub 页面点击 "Download ZIP"

# 重命名核心文件
ren BasePlugin.csproj MyAwesomePlugin.csproj
ren BasePlugin.cs MyAwesomePlugin.cs

# 在 Visual Studio 中批量替换命名空间
# 查找：BasePlugin
# 替换为：MyAwesomePlugin

// 在 MyAwesomePlugin.cs 中设置基本信息
public class MyAwesomePlugin : IPlugin
{
    public string Name => "我的超级Excel助手";          // 插件显示名称
    public string Description => "提升Excel工作效率的强大工具";  // 功能说明
    public string Author => "您的姓名";                 // 作者信息
    public string Version => "1.0.0";                 // 版本号
    public string Company => "您的公司";               // 公司信息
}

// 在 Features/ 目录下创建新功能文件
public static class MyCustomFeatures
{
    public static void SmartDataAnalysis(IRibbonControl control)
    {
        try
        {
            var excel = Globals.ExcelApp;
            var sheet = excel.ActiveSheet as Worksheet;
            
            // 获取选中的数据范围
            var selection = excel.Selection as Range;
            if (selection == null) return;
            
            // 执行数据分析逻辑
            AnalyzeAndFormatData(selection);
            
            MessageHelper.ShowSuccess("数据分析完成！");
        }
        catch (Exception ex)
        {
            PluginLogger.LogError(ex, "智能数据分析失败");
            MessageHelper.ShowError($"操作失败：{ex.Message}");
        }
    }
}

// 在 FeatureManager.cs 中注册新功能
FeatureManager.RegisterFeature(new PluginFeature
{
    Id = "smart_analysis",
    Name = "智能分析",
    Description = "一键分析数据并生成图表",
    Category = "数据处理",
    ImageMso = "ChartInsert",  // Office 内置图标
    Action = MyCustomFeatures.SmartDataAnalysis
});

# 在 Visual Studio 中构建项目
# 按 F5 或点击 "开始调试"
# Excel 将自动启动并加载您的插件

# 1. 构建 Release 版本
msbuild MyAwesomePlugin.sln /p:Configuration=Release

# 2. 复制到插件目录
copy "bin\Release\MyAwesomePlugin.dll" "%APPDATA%\DTI_Tool\Plugins\"

# 3. 重启 Excel，插件将自动加载

🎛️ 智能插件管理中心 统一管理所有插件，支持一键启用/禁用、版本更新、 性能监控等企业级管理功能	🔄 无感知自动更新系统 智能检测插件更新，支持增量下载、 版本回滚、更新日志查看等特性
⚡ 原生Excel集成体验 无缝融入Excel界面，支持自定义Ribbon、 快捷键、右键菜单等多种交互方式	🎨 现代化WPF交互界面 支持任务窗格、浮动窗口、模态对话框等 多种界面模式，完美适配高DPI显示器

// 批量数据清洗与格式化
public void SmartDataCleaner()
{
    var range = ExcelHelper.GetSelectedRange();
    
    // 智能识别数据类型
    var dataTypes = DataAnalyzer.AnalyzeDataTypes(range);
    
    // 自动清洗和格式化
    foreach (var cell in range.Cells)
    {
        switch (dataTypes[cell.Address])
        {
            case DataType.Date:
                cell.Value = DateTimeHelper.StandardizeDate(cell.Value);
                break;
            case DataType.Currency:
                cell.NumberFormat = "¥#,##0.00";
                break;
            case DataType.Phone:
                cell.Value = PhoneNumberHelper.Format(cell.Value);
                break;
        }
    }
}

// 基于数据特征自动推荐图表类型
public void AutoChartRecommendation()
{
    var data = ExcelHelper.GetSelectedData();
    var chartType = ChartAnalyzer.RecommendChartType(data);
    
    var chart = ChartBuilder.Create(chartType)
        .SetData(data)
        .SetTheme("Modern")
        .SetAnimation(true)
        .Build();
        
    ExcelHelper.InsertChart(chart);
}

1. 基础概念 → 了解插件架构和生命周期
2. Hello World → 创建第一个简单插件
3. 界面设计 → 学习WinForms和WPF基础
4. Excel交互 → 掌握基本的单元格操作

1. 高级特性 → 自定义Ribbon、任务窗格
2. 数据处理 → 大数据量的高效处理技巧
3. 错误处理 → 健壮的异常处理机制
4. 性能优化 → 内存管理和执行效率优化

1. 架构设计 → 企业级插件架构设计
2. 自动更新 → 完整的更新和部署系统
3. 多语言支持 → 国际化和本地化
4. 商业发布 → 代码签名、安全性、许可证管理

BasePlugin/
├── Core/                    # 核心功能模块
│   ├── FeatureManager.cs   # 功能管理器
│   ├── TaskPaneManager.cs  # 任务窗格管理器
│   ├── PluginLogger.cs     # 日志记录器
│   └── MessageHelper.cs    # 消息帮助类
├── Features/               # 功能实现模块
│   ├── BasicFeatures.cs    # 基础功能
│   ├── DataProcessingFeatures.cs  # 数据处理功能
│   ├── FormattingFeatures.cs      # 格式化功能
│   ├── WorksheetFeatures.cs       # 工作表管理功能
│   ├── UtilityFeatures.cs         # 实用工具功能
│   ├── WindowDemoFeatures.cs      # 窗口演示功能
│   └── LoggingDemoFeatures.cs     # 日志演示功能
├── Models/                 # 数据模型
│   └── PluginFeature.cs   # 功能模型
├── WPF/                   # WPF界面相关
│   ├── Views/            # 视图文件
│   ├── ViewModels/       # 视图模型
│   ├── Controls/         # 自定义控件
│   └── Common/           # 通用组件
└── BasePlugin.cs         # 插件主类

<!-- 在 .csproj 文件中的关键依赖 -->
<PackageReference Include="Microsoft.Office.Interop.Excel" Version="15.0.4795.1001" />
<PackageReference Include="ExcelDna.Integration" Version="1.6.0" />
<PackageReference Include="DTI_Tool.IPlugin" Version="2.0.0" />
<PackageReference Include="Microsoft.CSharp" Version="4.7.0" />

• 代码编辑器: Visual Studio 2022 + ReSharper
• 版本控制: Git + GitHub Desktop / SourceTree
• API测试: Excel Object Model Viewer
• 性能分析: JetBrains dotMemory + dotTrace
• UI设计: Visual Studio WPF Designer + Blend

• ✅ 完整插件框架 - IPlugin接口、生命周期管理
• ✅ 双UI技术栈 - WinForms + WPF/MVVM 完整支持
• ✅ 热插拔机制 - 无重启动态加载/卸载
• ✅ 自动更新系统 - SHA-256校验、增量更新
• ✅ 丰富示例代码 - 15+实用功能演示
• ✅ 双语文档 - 中英文完整开发文档

• 🔄 AI智能助手 - 集成GPT模型，智能代码生成
• 🔄 高级UI组件 - 现代化控件库、主题系统
• 🔄 单元测试框架 - 完整的测试覆盖和CI/CD
• 🔄 性能监控仪表板 - 实时性能指标和优化建议
• 🔄 插件脚手架工具 - 图形化项目创建向导
• 🔄 调试增强工具 - 可视化调试器、日志分析

• 📋 国际化支持 - 多语言界面、区域化设置
• 📋 企业插件市场 - 私有部署、权限管理、付费分发
• 📋 云端配置同步 - 跨设备设置同步、团队协作
• 📋 高级数据分析 - 机器学习集成、智能洞察
• 📋 企业级安全 - 代码签名、权限沙盒、审计日志
• 📋 API网关集成 - REST/GraphQL支持、微服务架构

• 🌟 零代码开发 - 可视化拖拽式插件构建器
• 🌟 跨平台支持 - 支持 macOS、Linux 上的办公套件
• 🌟 量子计算集成 - 大数据处理能力质的飞跃
• 🌟 区块链插件商店 - 去中心化分发、智能合约收益
• 🌟 VR/AR界面 - 沉浸式数据分析体验

Technology	Description	Version
	Primary Development Language	10.0
	Framework	4.8.1
	Visual Studio Tools for Office	Latest
	Windows Presentation Foundation	-
	Target Application	2016+

• 财务报表自动化 - Automate financial reporting
• 数据批量处理 - Batch data processing
• 自定义函数库 - Custom function libraries
• 报表生成器 - Report generators
• 数据验证工具 - Data validation tools

• 统计分析插件 - Statistical analysis plugins
• 数据可视化 - Data visualization tools
• 机器学习集成 - ML integration
• 实时数据连接 - Real-time data connections
• 自定义图表 - Custom charts

• 快捷操作面板 - Quick action panels
• 模板管理器 - Template managers
• 格式化工具 - Formatting tools
• 批量操作 - Bulk operations
• 工作流自动化 - Workflow automation

• Microsoft Office Add-ins Documentation
• Excel Object Model Reference
• VSTO Development Guide
• DTI_Tool Framework Docs

• Excel Plugin Development Series
• VSTO Add-in Tutorial
• WPF in Office Add-ins

• "Professional Excel Development" by Rob Bovey
• "Excel Programming with VBA Starter" by Robert Martin
• "VSTO 3.0 for Office 2007 Programming" by Vivek Thakur

"使用 BasePlugin 模板，我们在两周内完成了原本需要两个月的 Excel 插件开发项目。热插拔功能让我们的迭代速度提升了 300%。"

— 张经理，某金融科技公司

"BasePlugin 帮助我们将复杂的生产数据报表自动化，每月节省超过 100 小时的人工处理时间。"

— 李总监，某制造企业

• ExcelDna - Excel-DNA Excel Integration
• ClosedXML - .NET library for Excel
• EPPlus - Create Excel files with .NET
• NPOI - .NET library for Office documents

• Office-js - JavaScript API for Office
• Script Lab - Office Add-in playground
• Yeoman Office Generator - Scaffold Office projects

BasePlugin 是一个充满活力的开源项目，我们热忱欢迎每一位开发者的参与！无论您是资深专家还是初学者，都能在这里找到适合的贡献方式。

🔧 代码贡献 修复bug、添加新功能 优化性能、重构代码

📚 文档贡献 完善API文档、写教程 翻译内容、错误修正

🎨 设计贡献 UI设计、图标制作 用户体验、视觉优化

# 1. Fork 仓库到您的GitHub账号
git clone https://github.com/YOUR_USERNAME/Excel-Plugin-Template.git
cd Excel-Plugin-Template

# 2. 创建新的功能分支
git checkout -b feature/awesome-new-feature

# 3. 进行您的更改
# ... 编写代码、测试、文档 ...

# 4. 提交更改
git add .
git commit -m "✨ 添加令人惊艳的新功能"

# 5. 推送到您的仓库
git push origin feature/awesome-new-feature

# 6. 创建 Pull Request
# 访问 GitHub 页面，点击 "Create Pull Request"

• ✅ 代码规范 - 遵循项目的编码风格（见 编码规范）
• ✅ 测试覆盖 - 为新功能添加单元测试
• ✅ 文档同步 - 更新相关文档和API说明
• ✅ 兼容性检查 - 确保在不同Excel版本中正常工作

我们重视每一位贡献者的努力，并提供多样化的认可方式：

遇到困难？我们有多种方式为您提供帮助：

• 💬 实时聊天 - Discord社区 快速响应
• 📧 邮件咨询 - developer@90le.cn 详细指导
• 📞 视频答疑 - 每周五晚8点社区答疑会
• 📖 文档搜索 - 完整文档 涵盖常见问题

感谢这些优秀的开发者让 BasePlugin 变得更好！

想成为其中一员吗？ 立即开始贡献 🚀

我们非常重视安全性。如果您发现任何安全漏洞，请通过以下方式私下报告：

• 📧 安全邮箱：security@90le.cn
• 🔐 PGP Key: 下载公钥

请不要通过公开的 Issue 报告安全问题。

• 总下载量：
• 月下载量：

• Issues：
• Pull Requests：
• 讨论：

• 📖 查看文档
• 🐛 提交 Issue
• 💬 讨论区

• 📧 邮箱：767759678@qq.com
• 💬 微信：binStudy
• 🌐 博客：www.90le.cn

如果这个项目对您有帮助，请考虑赞助我们：

您的支持将帮助我们：

• 🚀 加速新功能开发
• 📚 改进文档质量
• 🐛 提供更好的技术支持
• ☕ 让开发者喝到更多咖啡

本项目采用 MIT 许可证。

excel-addin excel-plugin office-addin office-plugin vsto-addin com-addin excel-automation office-automation excel-development csharp-excel dotnet-excel excel-api excel-interop wps-plugin wps-office dti-framework hot-plugin excel-extension office-extension excel-tools productivity-tools microsoft-office microsoft-excel office-365 excel-vba-alternative excel-customization ribbon-customization task-pane wpf-excel winforms-excel excel-com-interop office-com-interop excel-programming office-programming visual-studio-tools-office excel-addin-template office-addin-template plugin-development add-in-development excel-sdk office-sdk excel-framework office-framework business-automation spreadsheet-automation data-processing report-automation excel-integration office-integration windows-desktop-development enterprise-excel-solutions