作者：痴者工良 作者博客地址： https://www.whuanle.cn https://www.cnblogs.com/whuanle 教程地址：https://docs.whuanle.cn/zh/maomi_framework 框架源码地址： https://github.com/whuanle/maomi 目录： http 客户端开发 HttpClient 基础 请求参数 请求凭证 异常处理 IHttpClientFactory IHttpClientFactory 基础 请求策略 Refit 框架的使…

多语言框架的设计 作者博客地址： https://www.whuanle.cn https://www.cnblogs.com/whuanle 教程地址：https://docs.whuanle.cn/zh/maomi_framework 框架源码地址：https://github.com/whuanle/moai 随着业务的国际化，为了满足不同客户群体的需要，软件产品需要支持多种语言，根据用户选择的语言呈现不同语言的界面。ASP.NET Core 或 ABP 等框架都提供了多语言解决方案，尽管配置方法各不相同，但…

.NET 中的序列化和反序列化 在 ASP.NET Core 应用中，框架会屏蔽了很多实现序列化和反序列化的细节，我们只需要定义参数模型，ASP.NET Core 会自动将 http 请求的 Body 反序列化为模型对象。但是日常开发中我们会对序列化和反序列化做许多定制配置，比如忽略值为 null 的字段、时间格式处理、忽略大小写、字段类型转换等各种情况。因此笔者单独使用一章讲解序列化框架的使用以及如何进行定制，深入了解 .NET 中序列化和反序列化机制。 System.Text.Json 是 .NET 框架自带的…

配置和选项 ASP.NET Core 模板项目下会有 appsettings.json、appsettings.Development.json 两个配置文件，我们可以通过这两个文件配置 Web 应用的启动端口、是否使用 https 等，大多数第三方框架也都支持在这两个 json 文件中配置。ASP.NET Core 程序默认支持从 json 文件、xml 文件、环境变量等多种配置源注入到内存中，微服务应用一般会使用远程配置中心存储配置以便动态更新到程序中，不管是什么类型的配置源，只需要提供 IConfigurat…

系列教程地址：https://docs.whuanle.cn/ 开发 .NET 诊断工具 System.Diagnostics、Microsoft.Diagnostics 在 System.Diagnostics Microsoft.Diagnostics 命名空间中的接口用于诊断 .NET 程序，里面涉及到很多诊断技术，由于个人技术水平限制以及篇幅原因，笔者只介绍比较常用的几种诊断方法，不深入探讨原理。 Debug、Trace 在 System.Diagnostics 命名空间中有 Debug、Trace 两个类…

日志还有使用技巧？直接写不就行了？这还需要学？ 实际上，据笔者观察，很多 .NET 开发者都有不良习惯，例如： 日志里面大量使用中文编写 日志没统一格式，到处拼接参数、数据 日志没有输出统一格式，导致采集、分析困难 日志喜欢在各类中间件、模块中定义自定义拦截日志，导致性能消耗严重 不知道 .NET 中日志有上下文和作用域，导致多条日志没有串联起来，查找日志困难 不了解日志系统，导致生成、采集的日志价值不大，分析问题低效 根据笔者的带队经验，基于很多 .NET 开发者的习惯，所以写了本文。 本文目录： 在 ASP.N…

Maomi 框架地址 https://docs.whuanle.cn/zh/maomi 学习开发 .NET 框架教程地址： https://docs.whuanle.cn/zh/maomi_framework 故障排查和日志 .NET 程序进行故障排查的方式有很多，笔者个人总结常用的有以下方式： IDE 调试、Visual Studio 中的诊断工具、性能探测器 一般来说，使用 IDE 进行断点调试和诊断只适合在本地开发环境，我们可以借助 IDE 中的工具断点调试以及收集程序详细的运行信息，IDE 是功能最全、最有…

Maomi.I18n 随着业务的国际化，为了满足不同客户群体的需要，软件产品需要支持多种语言，根据用户选择的语言呈现不同语言的界面。ASP.NET Core 或 ABP 等框架都提供了多语言解决方案，尽管配置方法各不相同，但都是通过键值对的方式使用的，开发者需要为每个 key 提供对应语言的值，框架会根据请求上下文自动区配 key 在对应语言下的值。 Maomi.I18n 是一个简单易用的 i18n 多语言框架，注册控制台、ASP.NET Core、WPF 等项目，开发者还可以很简单地扩展和定制自己的多语言解决方案…

项目地址：https://github.com/whuanle/maomi 文档地址：https://docs.whuanle.cn/zh/maomi_framework/start/1.module Maomi.Core Maomi.Core 是一个模块化和自动服务注册包，以简单和便捷的方式实现项目模块化和注册服务配置。Maomi.Core 是一个很简洁的包，可以在控制台、Web 项目、WPF 项目等项目中使用，在 WPF 项目中结合 MVVM 可以大量减少代码复杂度，让代码更加清晰明朗。 基于 ASP.NET …

作者：痴者工良 作者博客地址： https://www.whuanle.cn https://www.cnblogs.com/whuanle 教程地址： https://docs.whuanle.cn/zh/maomi_mq 项目开源地址： https://github.com/whuanle/Maomi.MQ 快速开始 在本篇教程中，将介绍 Maomi.MQ.RabbitMQ 的使用方法，以便读者能够快速了解该框架的使用方式和特点。 Maomi.MQ.RabbitMQ 是一个基于 RabbitMQ 的消息队列封装…

EasyTouch (et) 跨平台系统自动化操作工具，支持 Windows、Linux、macOS。提供 CLI 命令行和 MCP 服务器两种使用方式，支持鼠标键盘控制、屏幕截图、窗口管理、系统信息查询、浏览器操作等功能。 目前： Windows Linux MAC（目前缺少设备验证功能） 大家平时使用各类 AI 编程工具，写页面是不是经常碰到 AI 写的页面怎么也不满意，写出来跟设计稿差异很大，这是因为 AI 只能通过读写代码来改进代码，它看不到界面，不像人类有感官。 所以 EasyTouch 是给 AI 装上…

前段时间写了 《万字长文讲解：团队落地 AI 辅助编程和 AI Specs 实战》，核心内容是讨论公司落地 AI 辅助编程的一些常见问题，通过使用 Kiro 引入 Spec 实现规范驱动开发，也讲解了实践过程。 不过这篇文章太长了，而且强依赖了 Kiro，对使用 Clauda Code、Cursor、OpenCode 的小伙伴来说，迁移成本太大了。 文章地址：https://www.cnblogs.com/whuanle/p/19469026 基于这个背景，所以找时间写这篇基于 OpenSpec + OpenCod…

快速配置 OpenClaw 购买服务器后，环境配置是使用 OpenClaw 的首要步骤。由于 OpenClaw 依赖 NodeJS、Swift、Kotlin 等多语言及相关依赖库，手动配置过程繁琐且易出现版本兼容问题，因此建议优先使用腾讯云应用模板——该模板已预置全套运行环境及 OpenClaw 核心程序，可直接跳过依赖安装环节，大幅提升配置效率。 需要注意的是，即便通过应用模板完成系统安装，也是无法直接使用 OpenClaw 的，所有后续配置需通过终端命令行完成，配置好了之后才能用上 OpenClaw。 所以请务…

opencode 配置自定义模型挺曲折的，官方文档虽然很齐全，但是没有很好的 demo 指明怎么配置自定义模型，即使使用 AI 和 agent 帮助生成配置，最后还是不可用。经历大量手动测试后，终于完成了自定义第三方模型的配置。 opencode 有三个目录需要注意： {用户目录}\.config\opencode\opencode.json 配置全局设置。 {用户目录}\.cache\opencode\models.json 配置缓存，一般不需要动。 {用户目录}\.local\share\opencode\au…

AI Programming Team Collaboration Historical Background The speed of AI development has accelerated remarkably. In the era when GPT-3 emerged, interaction was limited to a question-and-answer format in a dialogue box. Now, various technologies like RAG, AI Wor…

AI 编程团队协作 历史背景 AI 发展的速度实在太快了，在 GPT-3 横空出世的阶段，那个时候只能使用对话框一问一答，到现在各种 RAG、AI Workflow、AI Agent 等各类技术，使得 AI 可以做更多的事情，实现更加强大的功能。在 cursor、trae 等 AI IDE 出现后，很多人便彻底迷上了这项足以颠覆传统工作模式的技术，尤其在编程领域，这场变革的浪潮来得尤为迅猛 —— 最初，当我们面对复杂的业务功能、晦涩的语法实现或是陌生的框架调用时，无需再耗费大量时间翻阅文档、调试代码，只需通过自然语…

Background A 32G + 1T R7-8745H host has been set up at home to deploy various database services for daily development. As demands have increased, there is a need for observability components. Therefore, I am researching deployment solutions that are cost-effec…

背景 家里放置了一个 32G+1T 的 R7-8745H 主机，部署一些数据库等服务以便日常开发，后续需求越来越多，需要用到可观察性组件，所以研究一些在中小公司中实现性价比高、简单易用、吞吐量大的部署方案。 本问主要部署环境是 Docker，不涉及 Kubernetes 部署，但是涉及的组件可以根据实际需求放在 Kubernetes 中进行分布式扩展，以及收集集群信息。 如需了解集群部署原理等相关知识，可参考笔者以前的文章： Kubernetes 集群日志 和 EFK 架构日志方案： https://www.cnb…

作者：whuanle 博客地址：https://www.whuanle.cn/ 示例项目地址：https://github.com/whuanle/mcpdemo Recently, the MCP protocol has gained immense popularity, with many developers diving into the development of MCP Server/Client. Various large companies have also launched their …

作者：痴者工良 博客地址：https://www.whuanle.cn/ 示例项目地址：https://github.com/whuanle/mcpdemo 近期 MCP 协议越来越爆火，很多开发者都投身参与 MCP Server/Client 的开发，各个大厂也纷纷推出自己的 MCP 集成平台或开放 MCP 接口。也有一些朋友读者在技术群讨论 MCP 技术，很多人对 MCP 的机制不清楚，也有一些文章讲解 MCP 时不够清晰甚至误导了读者，所以笔者在这个周末在学习 MCP 时，写下该笔记，尽可能提供更多的示例和讲…