mudtools-优快云博客

原创开源一套.NET平台的Office COM 组件二次封装库

MudTools.OfficeInterop是一套简化Office COM组件调用的.NET封装库，支持Excel、Word、PowerPoint等应用程序。它通过提供简洁统一的API接口，显著降低了原生COM调用的复杂性，并自动管理资源释放。主要优势包括：简化Office自动化、提高开发效率、增强代码可维护性及更好的资源管理。库包含Excel、Word、PowerPoint和VBE模块，支持.NET Framework 4.6+及.NET Standard 2.0。适用于企业报表生成、批量文档处理、Off

2025-08-27 13:59:06 1189 2

原创从自由生成到受约束声明：微信生态 .NET SDK 中用源生成器压制 AI 编码幻觉的工程实践

Mud.Wechat 通过声明式编程与源生成器，将企业微信等七条微信产品线的 2000+ 接口实现自动化。核心机制为“写声明、由生成器产实现”，将可写面缩小至方法签名与特性，使错误在编译期、AOT 或契约守卫中暴露。四条生成链分别处理接口、序列化、回调与 AI 工具，消灭事实、契约与结构错误。人工审查聚焦于声明层语义正确性，而非实现细节，显著降低维护成本。该体系在规模与复杂度下仍保持高可靠性，关键在于工程结构对“幻觉”的可观测性设计。

2026-11-05 09:36:51 320

原创可能是最现代化的微信生态 .NET 服务端 SDK

本文介绍了一套现代化的微信生态 .NET 服务端 SDK，涵盖企业微信、公众号、小程序等七条产品线，共 18 个 NuGet 包、2200+ 官方端点。核心亮点包括：源生成零反射实现 Native AOT 兼容，一线一包按需引用，契约守卫测试确保接口正确性，以及内置 OpenTelemetry 和 AI/MCP 就绪支持。通过结构化取证与自动化生成，高效落地大规模接口，并以断言式测试防止契约漂移，显著提升开发可靠性与可维护性。

2026-11-02 11:38:43 336

原创在飞书 SDK 上用 Microsoft Agent Framework 搭一个能干活的工作搭子

本文探讨了构建真正“能干活”的飞书AI Agent的核心挑战：从演示级对话到真实任务执行，需解决会话记忆、工具调度、安全管控、多租户隔离与可观测性等关键问题。作者选择以Microsoft Agent Framework（MAF）为通用运行时底座，飞书SDK负责产品特有逻辑，实现分层解耦。对比官方CLI，强调服务端嵌入场景下进程内集成在身份管理、治理深度与可观测性上的不可替代性。通过五步装配代码，实现令牌托管、工具注册、模型接入与流式通道集成，最终打造可信赖、可审计、可扩展的“工作搭子”级Agent系统。

2026-10-28 15:25:24 245

原创一份声明，多份产物：飞书 SDK 的 AI 工具面是怎么生成的

飞书 SDK 1228 个方法中，仅通过 351 个接口声明生成 AI 工具链。利用 Roslyn 源生成器在编译期产出参数类、Schema、注册器与契约测试，实现可评审、可回滚的工具产物。工具声明基于接口，分离契约与执行，确保变更可控；通过 Source 引用精准锚定方法，编译期校验避免运行时错误。风险分级由方法名自动识别，剖面配置集中管理命名规范。64 个契约测试保障生成一致性，构建出安全、透明、可追溯的 AI 工具体系。

2026-10-25 20:21:04 284

原创 MAF + 飞书：让大模型干活，但别让它乱干

Mud.Feishu.AI 作为独立运行时包，专为大模型设计，将原1200+飞书SDK接口重构为331个可被模型理解、约束与审计的工具。通过编译期固定工具面、调用链安全校验、写操作默认禁用等机制，实现“可解释、可控制、可审计”的AI交互。依托Microsoft.Agents.AI基座，构建六层调用栈，确保每次调用走统一安全链路，兼顾灵活性与生产级安全。

2026-10-23 21:47:28 192

原创反射是 AOT 的敌人：飞书 .NET SDK 的源生成改造记

飞书 SDK 3.0 通过全链路源生成实现 .NET 8 Native AOT 兼容：将上千个 DTO 的序列化元数据在编译期固化，构建“源生成上下文 + 自定义解析器链”架构，彻底消除反射依赖。核心突破在于将运行时类型发现转为编译期显式登记，结合条件编译与严格告警管控，实现冷启动降至 50ms、内存仅 20MB 的极致优化，同时保障多 TFM 兼容与 AOT 安全性。

2026-09-28 14:25:48 319

原创 HttpUtils：一个编译时生成的声明式 HTTP 客户端框架

Mud.HttpUtils是一个面向.NET 6+的HTTP客户端工具库，旨在简化HTTP接口调用。它通过声明式接口和特性标注自动生成实现代码，提供了弹性策略、令牌管理、加密等生产级功能。与Refit/RestEase相比，Mud.HttpUtils更注重生产环境需求，内置了重试、熔断、链路追踪等能力，避免重复编写样板代码。该库采用模块化设计，可按需引用功能组件，适合需要统一管理HTTP调用一致性的中大型项目。

2026-07-11 23:03:06 401

原创 Microsoft Agent Framework (MAF) 框架使用指南

Microsoft Agent Framework (MAF) 是微软推出的新一代AI Agent框架，作为Semantic Kernel和AutoGen的继任者。它提供统一API支持多平台LLM（如OpenAI、Azure OpenAI、Gemini等），具备单/多Agent协作、工作流编排、工具调用等企业级特性。框架包含核心接口AIAgent、ChatClientAgent等组件，支持结构化输出、会话管理、中间件拦截等功能，并通过NuGet包提供模块化集成（如Azure AI Foundry、Anthr

2026-05-29 17:57:37 669

原创存储那么贵，何不白嫖飞书云文件空间

摘要：利用飞书云盘实现免费企业级存储方案文章分享了如何巧妙利用飞书企业版提供的免费云存储空间解决服务器硬盘不足的问题。作者发现飞书企业版每个用户享有100G免费空间（50人团队即5T），相比自建NAS或阿里云OSS每年可节省700+元成本。文章详细介绍了实现方案：通过开发独立文件管理系统，利用分片上传技术突破单文件500MB限制，并提供了前后端核心代码示例。该系统支持文件上传下载、版本管理和权限控制，成功将飞书云盘转化为免费企业网盘。

2026-03-24 08:53:47 690

原创搭建一套.net下能落地的飞书考勤系统

企业HR系统选型中，飞书考勤虽功能强大但难以满足个性化业务需求。本文分享了搭建中间层的实践经验，通过系统架构设计实现飞书与内部系统的解耦，包括数据转换、统一认证等功能。详细介绍了飞书开放平台配置要点（权限设置、事件订阅）、项目搭建步骤及服务注册方式，提供了多应用配置示例和三种服务注册方案。该中间层方案有效解决了飞书API与内部系统的兼容性问题，为企业定制化HR系统提供了技术参考。

2026-02-26 20:25:33 743

原创飞书多应用开发：如何实现企业多应用的“系统集成引擎“

摘要： MudFeishu是一个企业级飞书多应用集成框架，采用微服务架构思想解决多系统协同问题。该方案通过统一配置中心、自动令牌管理和智能事件路由三大核心技术，显著提升开发效率并降低维护成本。框架提供模块化组件（HTTP API、WebSocket、Webhook等），支持多应用并行管理，并内置日志、遥测等拦截器。开发者可通过JSON配置快速定义各应用参数，利用DI容器注册服务组件，实现企业级飞书应用的标准化开发与集中管理，技术架构兼顾专业性与扩展性。

2026-01-27 18:39:44 801

原创 C#中基于Word COM组件的数学公式排版实践

本文介绍了基于Word COM组件和MudTools.OfficeInterop.Word项目的数学公式自动化排版技术。通过分析Word COM对象模型中的公式相关对象层次结构，包括IWordApplication、IWordDocument、IWordRange等核心接口，详细阐述了数学公式的构建和排版方法。项目提供了完整的公式操作体系，支持22种数学函数类型，涵盖分数、矩阵、上下标等复杂结构。文章还通过类图和流程图直观展示了对象间的层次关系和交互方式，为开发高效、专业的数学公式排版工具提供了技术参考。

2026-01-24 15:04:30 843 1

原创深入理解飞书 Webhook 签名验证：一次踩坑到填坑的完整记录

摘要：作者在对接飞书开放平台时遭遇签名验证失败问题，经过排查发现四个常见错误：1）误用HMAC-SHA256而非纯SHA-256算法；2）签名字符串格式错误，缺少加密密钥；3）混淆验证令牌与加密密钥的使用场景；4）错误地将哈希结果转为Base64而非十六进制。文章详细对比了正确与错误实现方式，并形象地将飞书安全机制比喻为"门牌号"和"钥匙"的双重验证体系，为开发者提供了实用的调试建议。

2026-01-16 16:44:10 1302

原创飞书 .NET SDK 事件处理的幂等性与去重机制

飞书应用事件处理的三层防护机制可有效避免重复操作：1）协议层通过消息序列号过滤网络重复；2）分发层基于事件ID实现24小时窗口期去重；3）应用层采用业务主键确保逻辑唯一性。该方案结合内存与Redis双重存储，支持处理状态跟踪（待处理/处理中/已完成）和异常回滚，能应对网络波动、服务重启等场景，防止数据重复和状态混乱。核心设计包含分布式锁、TTL自动清理和超时重试机制，既保障可靠性又维持系统简洁性。

2026-01-11 21:05:47 1019

原创基于.NET操作Excel COM组件生成数据透视报表

本文介绍了使用C#和MudTools.OfficeInterop.Excel组件自动化创建Excel数据透视表的方法。首先讲解了环境配置要求，包括.NET框架和Excel版本兼容性。然后详细说明了Excel COM组件的基础操作，如工作簿创建、数据写入和格式设置。重点介绍了数据透视表的实现步骤，包括数据准备、结构设计和核心创建流程。文章通过实际代码示例展示了如何利用编程方式高效生成数据透视表，帮助开发者提高报表自动化处理能力。

2026-01-07 10:40:54 1099 1

原创 .NET 传统信息系统无缝集成飞书审批流

摘要：本文探讨传统.NET系统与飞书审批移动化协同的解决方案。针对.NET系统在移动办公中的痛点（如审批流程封闭、通知滞后等），提出渐进式改造方案：以.NET为业务核心，飞书审批为移动门户，通过API实现双向数据同步。文章详细解析了飞书审批的三大核心概念（审批定义、实例和身份映射），并给出分层架构设计和技术选型建议，包含可复用的C#代码实践。该方案既能保留现有系统价值，又能实现移动化升级，提升企业协同效率。

2026-01-05 22:35:49 912

原创如何设计易维护、低学习成本的飞书.NET SDK组件

本文探讨了一种基于特性驱动架构和编译时代码生成的.NET HTTP API封装方案。通过HttpClientApi特性体系实现契约优先设计，结合Source Generator自动生成强类型客户端代码。该方案采用三层接口设计模式，支持完整的HTTP方法语义和参数自动绑定，集成令牌管理等企业级特性。相比传统方案，具有编译时安全、减少样板代码、提升开发效率等优势，在强大功能与简洁体验间取得平衡，为构建易维护、低学习成本的企业级组件提供了实践参考。

2025-12-31 13:49:22 532 1

原创当传统工单遇见飞书：.NET系统的协作升级之旅

在数字化转型的浪潮中，我们不仅要让系统"能用"，更要让团队"好用"。飞书就像是协作世界的"超级英雄"，它能让原本各自为战的业务系统手拉手，让信息像流水一样顺畅流动。今天，就让我们一起踏上一段奇妙的旅程——借助Mud.Feishu这个强大的开源工具，为我们的.NET业务系统装上"协作翅膀"，实现从传统的工单处理到现代化的全链路任务协同的华丽转身。还记得那个尴尬的下午吗？客户在电话那头焦急地询问：“我的问题解决得怎么样了？” 而你却在三个不同的系统之间来回切换，试图拼凑出完整的答案。随着企业越来越大，业务越来越

2025-12-29 13:49:42 997 1

原创一分钟实现.NET与飞书长连接的WebSocket架构

摘要：本文介绍了针对.NET生态缺乏飞书官方SDK的问题，提出基于WebSocket长连接的解决方案Mud.Feishu。该框架采用分层设计，包含抽象层(Mud.Feishu.Abstractions)和核心实现层(Mud.Feishu.WebSocket)，通过策略模式处理多样化事件，支持用户管理、消息接收等场景。系统具备组件化、高可靠、高性能等特点，相比传统Webhook模式大幅降低接入成本，开发周期从1周缩短至5分钟，为.NET开发者提供了便捷的飞书集成方案。

2025-12-08 11:00:35 1404

原创强的飞起的 Roslyn 编译时代码生成，实现抽象类继承与依赖注入的自动化配置

本文介绍了基于Roslyn编译器的代码生成技术，重点分析了HttpInvokeClassSourceGenerator组件如何实现抽象类继承与依赖注入的自动化配置。该技术通过编译时代码生成，自动创建HTTP客户端实现类，支持多种HTTP方法、参数处理和错误处理机制。系统采用模块化设计，包含接口分析、代码模板引擎和依赖注入自动分析三大核心模块，能显著减少重复代码量（如认证代码减少80%+），提升开发效率和代码质量。文章详细阐述了其技术架构、功能特性及在业务系统中的实际应用场景，展示了编译时代码生成在现代软件开

2025-12-03 10:22:28 715

原创 .NET 8+ 飞书API实战：自动化群组管理与消息推送

本文基于Mud.Feishu 1.0.3，介绍企业级飞书群组自动化管理方案。内容涵盖：飞书服务端API认证机制（Tenant Access Token获取与缓存）群组CRUD操作（创建、查询、更新、解散）成员批量管理（添加、移除、权限控制）消息推送（文本、富文本等格式）完整的错误处理和重试策略该方案已在实际生产环境中验证，可显著提升企业项目群组管理效率，适用于项目启动、系统告警、员工入职离职等自动化场景。

2025-11-27 09:59:08 1019

原创使用.NET 8+ 与飞书API构建组织架构同步服务

本文探讨了.NET生态下飞书API集成的技术挑战与解决方案。文章首先分析了.NET企业应用场景中员工信息同步的核心价值，包括统一身份认证、自动化运维和数据一致性。随后详细介绍了技术选型，推荐使用.NET 8和Mud.Feishu SDK简化API集成，并提供了完整的项目配置示例。在架构设计部分，提出了领域模型设计思路，包括部门实体和用户实体的数据库映射关系，以及EF Core的DbContext配置。最后阐述了两种同步模式，重点介绍了基于BackgroundService的全量同步方案，适用于系统初始化和夜

2025-11-22 10:09:09 1251

原创 .NET如何快速集成飞书API的最佳实践

本文介绍了基于.NET平台集成飞书API的最佳实践，重点解析了Mud.Feishu框架在组织管理系统开发中的应用。Mud.Feishu是一个专为.NET开发者设计的飞书API集成组件库，封装了飞书开放平台的各种接口，提供强类型支持、自动令牌管理等现代化开发体验。文章详细对比了Mud.Feishu与原生SDK在开发效率、类型安全、异常处理等方面的优势，并展示了其分层架构设计。此外，还提供了快速入门指南，包括组件安装、飞书应用配置和服务注册等基础操作步骤，帮助.NET开发者快速上手飞书API集成。

2025-11-20 10:23:03 980

原创 .NET驾驭Excel之力：工作簿与工作表操作基础

Excel自动化开发基础：工作簿与工作表操作摘要：本文介绍了使用MudTools.OfficeInterop.Excel库进行Excel自动化开发的核心操作，重点讲解了工作簿的基础功能实现。内容包括：1）创建空白工作簿并设置属性；2）基于模板生成工作簿；3）打开和修改现有工作簿；4）批量创建工作簿实例。通过代码示例展示了工作表命名、数据填充、格式设置等典型操作流程，为开发高效Excel自动化应用提供了实用参考。

2025-11-13 15:31:13 564 1

原创 .NET驾驭Excel之力：单元格与区域操作详解

本文介绍了Excel中单元格和区域操作的核心技巧。主要内容包括：1）单元格的4种引用方式（Range方法、字符串索引器、行列号索引器和Cells属性）及其适用场景；2）相对引用和绝对引用的实现方法；3）单元格格式设置和属性访问；4）区域操作技术，包括批量数据处理和格式设置。通过代码示例演示了如何高效操作Excel数据，如使用Offset方法实现相对引用、循环设置单元格属性等。掌握这些技巧可以显著提升Excel数据处理效率，适用于数据分析、报表生成等场景。文章提供了完整的C#代码示例，便于读者快速上手实践。

2025-11-13 15:28:58 657

原创 .NET驾驭Excel之力：Excel应用程序的创建与管理

摘要：本文详细介绍了MudTools.OfficeInterop.Excel库中ExcelFactory类的三种核心方法，用于创建和管理Excel应用程序实例。BlankWorkbook方法提供简单快捷的创建工作簿方式，CreateInstance方法支持创建特定版本Excel实例，CreateFrom方法则基于模板创建新工作簿。文中包含完整代码示例，演示了每种方法的实际应用场景和异常处理策略，并分析了各自的优缺点。这些方法为Excel自动化开发提供了灵活的选择，确保程序稳定性和资源有效管理。（150字）

2025-11-12 14:18:18 1080

原创 .NET驾驭Excel之力：自动化数据处理 - 开篇概述与环境准备

MudTools.OfficeInterop.Excel库是专为Excel自动化开发的.NET封装工具，通过简化COM组件操作提升开发效率。该库支持企业日报系统、数据导出、批量处理和模板报表等典型应用场景，相比原生COM接口和第三方库，提供了更简洁易用的API，同时保持了完整的Excel功能。开发者可专注于业务逻辑实现，而无需处理底层技术细节，显著提升开发效率和代码可维护性，是企业级Excel自动化开发的理想选择。

2025-11-12 14:09:51 1148

原创解放双手！Mud 服务代码生成器让你的 HTTP 客户端开发变得如此简单

Mud服务代码生成器利用Roslyn技术简化HTTP客户端开发，包含HttpClientApiSourceGenerator和HttpClientApiRegisterSourceGenerator两个核心组件。它能自动为标记特性的接口生成完整HttpClient实现类，支持RESTful API调用，处理各种HTTP方法和参数类型。关键功能：自动生成服务接口和实现类支持GET/POST/PUT/DELETE等HTTP方法智能处理路径、查询、请求体和

2025-11-06 17:54:31 663

原创打造.NET平台的Lombok：实现构造函数注入、日志注入、构造者模式代码生成等功能

本文介绍了如何在.NET平台构建类似Java Lombok的代码生成工具Mud，通过Roslyn源代码生成器实现自动化代码生成。Mud包含实体和服务代码生成器，提供多种特性如构造函数注入、日志注入、缓存管理等，能显著减少样板代码编写。核心功能包括通过特性标记自动生成依赖注入代码、日志记录器注入、缓存管理器注入等，支持多种注入方式的组合使用。该工具简化了.NET开发中的重复性工作，提高了代码质量和开发效率。

2025-10-10 16:33:13 865

原创 .NET驾驭Word之力：基于规则自动生成及排版Word文档

.NET自动化Word文档生成与排版技术摘要：MudTools.OfficeInterop.Word是一个基于.NET的Office COM组件封装库，专门用于自动化操作Microsoft Word文档。该库采用工厂模式设计，支持创建空白文档、基于模板生成文档以及打开现有文档等操作。文章重点介绍了如何利用该库实现合同条款的自动化生成，通过预定义JSON格式的合同规则模板，结合输入的业务数据，自动填充生成符合要求的合同文档内容。这种基于规则的文档生成方法在人力资源、法务等需要大量标准化文档的业务场景中具有显

2025-10-09 11:53:29 1469 1

空空如也

TA创建的收藏夹 TA关注的收藏夹

TA关注的人

最新版本的docfx win64位版本，用于构建和发布.NET项目的API文档的工具

EXT 中文手册(学习EXT的必备手册)

extjs实用开发指南

Paint.NET_src_3_20

开源的.net矢量图、流程图绘制软件Netron2009 1

开源的.net矢量图、流程图绘制软件Netron 2009 2

开源的.net矢量图、流程图绘制软件Netron V3

开源的.net矢量图、流程图绘制软件Netron2009 4

开源的.net矢量图、流程图绘制软件Netron2009 3

空空如也