Archives

MongoDB in C#：连接、映射与读取文档

MongoDB 在 C# 里最容易混的是四层：客户端归属、BSON 映射契约、读取结果形状、索引证据。本文对照官方文档与 3.12.0 驱动源码，给出可执行的代码和排错顺序。

• MongoDB
• C#
• .NET
• BSON
• Data Access

给 Claude Code 写对 .NET 仓库上下文

Claude Code 在 .NET 仓库里猜结构、乱加包版本、声称跑过测试？本文按官方文档核对加载规则，给出根 CLAUDE.md、按路径规则、AGENTS.md 与验证边界的可执行配置。

• Claude Code
• CLAUDE.md
• AGENTS.md
• .NET
• AI Coding

新工程经理的时间管理：先定义角色，再排日历

刚上任的工程经理常困惑：一天被支持和协调填满，却看不见产出。本文用四步讲清楚：先定义岗位职责，把支持工作算成真实容量，按后果而非到达顺序处理打断，再用三列对照把超载的工作量谈明白。

• Engineering Management
• Leadership
• Time Management
• Career

别再存两个日期：.NET 区间类型建模

两个日期字段会让空值、开闭边界和重叠判断散落在各处。本文用五种区间形状重新建模，说明 NpgsqlRange 的边界，并给出可在内存和 PostgreSQL 中运行的 .NET 示例。

• C#
• .NET
• Domain Modeling
• PostgreSQL
• EF Core

MongoDB Agent Skills：8 个技能与安装变更

AI agent 常把关系型设计翻译成 MongoDB 语法。MongoDB 官方 Agent Skills 已增至 8 个，用按需加载补齐文档建模、索引与检索，本文给出当前安装方式与 .NET 取舍边界。

• MongoDB
• AI Agent
• Claude Code
• MCP
• .NET

Azure MCP Server 3.0 升级清单与只读上手

Azure MCP Server 3.0 稳定版把 Backup、Resilience、SRE Agent 和 Terraform 交给 agent。本文把破坏性变更整理成升级检查表，并给出只读模式的最小工作流。

• Azure
• MCP
• AI Agent
• DevTools

C# 人的审批：Vercel Eve 暂停与恢复

Agent 停下来等人审批时，用户点的那一下并不等于授权。用 Vercel Eve 的审批契约加 NexusLabs.Eve，把待批请求、服务端判定和权威恢复结果拆成三层。

• AI Agent
• C#
• .NET
• 人机协同
• Vercel Eve

从工程师到工程经理，再到编码 Agent 的经理

Nick Cosentino 写的工程经理上任指南有九条原则。把它们逐条搬到编码 Agent 上，五条能直接复用，三条必须换成机制，还有一条风险正好相反——因为 agent 没有信任、成长和记忆。

• AI 编程
• 工程管理
• 编码 Agent
• 软件工程

任何编码 Agent 都适用的可复核工作流

把仓库任务交给编码 agent 后，怎么判断它说的「已完成」是真的？本文拆解环境、权限、契约、证据四道关口，并对比 Claude Code、Codex 与 Copilot 的实现。

• AI 编程
• Claude Code
• Codex
• GitHub Copilot
• 软件工程

MCP 服务器改成 HTTP 托管要动什么

把 stdio 的 MCP 服务器改成 Streamable HTTP 托管，核心改动只有两行代码。本文说明这次迁移为什么让服务器第一次能被认证和部署，以及默认无状态、initialize 握手消失这两个正在发生的大变化会把代码带向哪里。

• MCP
• .NET
• ASP.NET Core
• AI Agent

SSE 鉴权：五种方案怎么选

EventSource 不能发自定义请求头，浏览器端 SSE 鉴权因此只剩三条路。本文把 Cookie、短期令牌、fetch-event-source 与 HttpClient 放回各自场景，并列出 CORS 凭证规则和令牌过期重连这些坑。

• ASP.NET Core
• .NET
• SSE
• 认证授权
• Blazor

Agent Framework 三层中间件怎么选

ChatClient、Agent Run 与函数调用中间件不是二选一，而是套在模型调用、整轮运行和工具调用三层上的拦截点。本文用一个 Tavily 搜索日志的例子说明该把代码写在哪一层，以及流式输出、函数调用中间件的使用边界。

• C#
• .NET
• AI Agent
• Microsoft Agent Framework

用 C# 实时跑 16.7 万神经元的果蝇大脑模型

拆解果蝇大脑游戏演示的三层结构：电镜测出的连接组、只有一个校准参数的 LIF 模型，以及藏在中间的适配器；并说明纯 C# 的 dotFly 怎么在笔记本上实时跑完 16.7 万神经元，以及它现在还做不到什么。

• C#
• .NET
• 神经科学
• 性能优化

用 TimeProvider 测试时间依赖代码

用 FakeTimeProvider 把系统时钟变成可注入依赖，在单元测试中精确断言过期边界、延迟完成与超时取消，不必真的等待五分钟，也不受 CI 机器快慢影响。

• C#
• .NET
• 单元测试
• xUnit

WinDbg MCP：用自然语言调试崩溃转储

WinDbg 新增 MCP 服务，AI 客户端可直接操作真实调试会话。这篇整理接入步骤、安全模式实际拦住了什么、Diagnostician 的五阶段诊断流程，以及四项故障排查。

• WinDbg
• MCP
• 调试
• AI 编程助手
• Windows

SqlClient 连接池 V2：并发建连提速 5 倍

Microsoft.Data.SqlClient 7.1 新增可选的连接池 V2，冷启动并发建连快 5 到 10 倍，一行开关即可切换。本文补上原文没展开的测试数据、线程池风险与验证方法。

• .NET
• SqlClient
• 连接池
• Azure SQL
• 性能

IdentityServer4 已停止维护：迁移路线怎么选

IdentityServer4 自 2022 年底失去支持、仓库已归档，继续使用等于运行无人修补的组件。本文对照六条替代路线的价格与取舍，给出可照做的决策清单，并点出「免费内核」的隐性成本。

• .NET
• IdentityServer4
• OpenIddict
• 身份认证

EF Core Specification 性能与翻译陷阱

Specification 本身不决定 EF Core 查询快慢，决定性能的是它包住的查询信封。这篇给出从 provider 边界到执行计划的十条诊断路径，并补上 EF Core 10 三条影响取证结论的官方变化。

• EF Core
• .NET 10
• Specification Pattern
• 性能优化
• LINQ

PG 转 SQL Server：日期时间类型映射与陷阱

PostgreSQL 的 timestamp、timestamptz 和 SQL Server 的 datetime2、datetimeoffset 语义并不一一对应。这份迁移笔记给出映射表、存储账，以及官方文档里六个容易踩的转换陷阱。

• PostgreSQL
• SQL Server
• 数据库迁移
• 日期时间
• Azure SQL

系统设计 20 个积木：顺序比清单重要

原文用 20 个小节列完了系统设计的基础积木，这篇按压力来源把它们重排成一条决策链：复制只扩读、分片才扩写、缓存不解决写压力，并纠正 ACID、CAP 和 gRPC 三处常见说法。

• 系统设计
• 分布式系统
• 数据库
• 软件架构
• 面试

RAG 检索授权：租户过滤、溯源与删除

检索权限必须由服务端从身份推导，而不是接受客户端传来的租户 ID。本文把 RAG 的隔离边界、溯源修订、删除传播与缓存键拆成一组可测试的 .NET 契约，并给出四段可运行示例。

• RAG
• 访问控制
• 多租户
• 数据生命周期
• .NET

模型路由：97.6% 是怎么算出来的

18 个模型、113 个任务的账：把最佳单模型的 74.1% 抬到 97.6% 的不是新模型，是路由。拆开 oracle 的算法偏差，再看它离生产环境还有多远。

• 模型路由
• LLM
• 推理成本
• Agent
• 基准测试

Jev 决策模型：调用方式、成本与边界

TypeSafe 的 Jev 只输出带概率的判断而不是文本。核对它的调用方式、每百万 token 0.042 美元的定价，以及官方文档承认的失败模式与提示注入风险。

• Jev
• TypeSafe AI
• LLM
• 决策模型
• AI 应用

ASP.NET Core CORS 配置顺序与生产排错

用官方文档和 CorsService 源码核对 CORS 中间件的顺序要求与凭证策略的报错位置，再处理 CDN 缓存与反向代理只在生产暴露的两个问题，附 curl 验证与排错对照表。

• ASP.NET Core
• CORS
• .NET 10
• Web API
• 安全

TPL Dataflow 流水线要写对生命周期

大多数 Dataflow 示例只把三个块 LinkTo 起来就结束。把容量、并发与顺序、完成传播、故障与取消这四项配齐，才是一条调用方敢持有的流水线；文末另附背压语义与版本核对结论。

• TPL Dataflow
• .NET 10
• C# 14
• 并发
• Pipeline Pattern

AI 海报的解法不是重做，而是点名风格

AI 活动海报招人烦的不是难看，是全都长一样。作者用同一份活动信息点名十几种设计风格，说明问题出在默认审美，并给出点名风格、防止上下文漂移与印前检查的完整清单。

• AI 图像生成
• 提示词
• 平面设计
• ChatGPT
• 内容创作

Postgres 更爱走新索引，但它扫错了方向

新增索引会给规划器多一条看似更便宜的路径。本文用 PostgreSQL 18.6 上的百万行实验说明这个查询如何从 16.5ms 涨到 241ms，并给出索引改法、计划读法与验证步骤。

• PostgreSQL
• 索引
• 查询优化
• EXPLAIN
• 数据库

别让 InMemory 冒充 EF Core 翻译证明

规范测试分成谓词含义、应用接线与数据库翻译三层证据。本文用 .NET 10 与 EF Core 10 的 xUnit 代码说明每层能证明什么，并补一份可跨提供程序复用的生产库契约测试。

• EF Core
• xUnit
• .NET
• Specification Pattern
• 测试策略

RAG 安全：提示注入与语料投毒的 .NET 防线

检索到的文本是有用证据，不是可信权威。本文用 .NET 代码把 RAG 防线拆成源准入、来源哈希、上下文定界、独立授权与安全测试五段，并指出定界符不转义内容等落地缺口。

• RAG
• 提示注入
• 语料投毒
• .NET
• AI 安全

.NET 11 性能改进：从 JIT 到类库的基准数据

微软 .NET 11 性能长文覆盖数百项改进。本文把它压成一张可决策的地图：JIT 与运行时的主线、类库中最值得关注的数字，以及运行时异步开关和硬件基线提高这两条真实门槛。

• .NET
• .NET 11
• 性能优化
• JIT
• 基准测试

用 GitHub Copilot SDK 接进 .NET 应用

Copilot SDK 已 GA，把 Copilot CLI 的 agent 运行时搬进你自己的应用。本文拆开 SDK、Agent Framework 与应用三层职责，讲清工具暴露和工具批准两套开关，以及认证、额度与数据留存的实际边界。

• GitHub Copilot
• AI Agent
• .NET
• MCP
• 架构

.NET 有界 Channel 管道的完整生命周期

有界 Channel 限制的是队列长度，不是应用里的在途消息数。本文用一份 net10.0 示例拆开准入、消息所有权、完成权、取消和两条收尾路径，并给出实测的在途峰值。

• .NET
• C#
• Channels
• 并发编程
• 架构

EF Core 动态筛选排序分页：用白名单收口

列表接口一旦接受任意属性名或表达式，翻页就可能丢行、重复甚至翻译失败。本文把动态查询收成一个有界信封：白名单排序、完全唯一的排序键、页大小上限和可见的终止操作，并附在 net10.0 上跑通的完整代码与测试。

• EF Core
• .NET 10
• C#
• LINQ
• 架构

分布式 .NET 隐藏延迟：CPU 报告看不出的等待

一次响应要 1.5 分钟，CPU 报告却只有 6.7%。微软团队用一次真实排查说明：先定位是哪个进程，再用 CPU 报告排除计算，最后用 Stopwatch 量出循环里累计的 10 秒等待。

• .NET
• 性能优化
• Visual Studio
• Profiler
• .NET Aspire

.NET 11 RC1：亮点核对与 API 纠错

容器、DNS、崩溃报告、C# 15 union、WinForms kiosk：一篇 .NET 11 RC1 亮点文章里的每个特性，我都对着官方发布说明核了一遍。哪些是真的、哪些代码写错了、正确用法是什么，以及原文漏掉的开关与参数。

• .NET 11
• C# 15
• WinForms
• Cloud Native
• C#

GPT-6 Astra：删掉多余的技能与提示词

新模型更强，旧提示词却可能变成负担。本文整理 OpenAI 对 GPT-6 Astra 的行为说明，并给出缩短 skill 描述、给 AGENTS.md 加触发条件、把边界说到可执行的具体做法和迁移清单。

• GPT-6 Astra
• Codex
• AGENTS.md
• Prompt Engineering
• OpenAI

不常用的 LINQ 方法速查：版本与易错点

Where 和 Select 之外，LINQ 还有一批很少用到但很省事的方法。本文按聚合、集合运算、连接、切片、排序和分组配对整理，核对每个方法在哪个 .NET 版本加入，并标出空序列、去重和延迟执行这些容易踩的边界。

• .NET
• LINQ
• C#
• .NET 9
• .NET 10

OpenTelemetry 观测 .NET RAG 的耗时与成本

一次 RAG 回答变慢，未必是模型慢。本文整理 .NET 管线的追踪契约：把嵌入、检索、重排、拼装提示词和生成拆成同一 trace 下的 span，只带版本标识与有界计数，离线评测与在线观测靠版本号关联。

• RAG
• OpenTelemetry
• .NET
• 可观测性
• Microsoft.Extensions.AI

EF Core 10 大列表查询：2098 参数悬崖

EF Core 10 把参数化集合默认翻译成每个值一个参数，可用上限其实是 2098；越界不报错，只是悄悄变慢。本文整理分桶补齐规则、七种写法的实测对比、计划缓存代价，以及复合键列表为什么必须换写法。

• EF Core
• .NET 10
• SQL Server
• 性能优化
• C#

Postgres RLS：EF Core 多租户的第二道防线

EF Core 查询过滤器管不到原生 SQL、附加实体和 IgnoreQueryFilters。用 Postgres 行级安全策略在数据库层补上第二道防线：角色拆分、每次连接设置租户、绕过验证、计划代价与运维边界。

• PostgreSQL
• EF Core
• 多租户
• .NET 10
• 数据库安全

RAG 黄金评测集：一份可追溯的证据契约

RAG 黄金评测集是评测的证据契约：每个用例记录查询、预期答案、支撑 chunk、来源版本和人工评审，缺一项就难以复核。本文说明如何构建、校验、用合成数据补候选、用人工校准并随证据更新。

• RAG
• 评测
• Eval
• 数据工程

把 LLM Judge 放进 Agent 运行时

LLM judge 正从离线评测走进 agent 运行时，开始影响继续、重试、换模型或转人工。本文拆解 7 种架构模式，说明如何拆分判断、比较候选、检查过程，并用确定性逻辑控制风险。

• LLM
• Agent
• 评测
• 架构

谁拥有 next：Pipeline、职责链与中间件

Pipeline、职责链与 ASP.NET Core 中间件都像一串组件，真正的区别是谁拥有 continuation、组件被期望做什么。对照转换、选择与拦截三种契约，配可运行示例、短路含义与顺序解读，帮你命名并审查现有设计。

• Pipeline
• Design Patterns
• ASP.NET Core
• Architecture

别让 AI 选错 NuGet 包：四道仓库护栏

AI 代理按 2023 年的默认值选 .NET 库，而 AutoMapper、MediatR、MassTransit 已商业化。用 NuGet MCP Server、指令文件、构建门禁与中央包管理四道护栏挡住错误，附 2026 许可现状表。

• NuGet
• AI Agent
• .NET 10
• Supply Chain

IAsyncActionFilter：把异步检查留在管道里

IAsyncActionFilter 在操作方法前后运行异步检查：OnActionExecutionAsync 包裹 next() 委托可短路请求。用邮箱验证过滤器讲清注册、应用与验证，以及何时改用授权过滤器。

• ASP.NET Core
• C#
• Filters
• .NET

AI 工程技能地图：用好编码 agent

Andrew Ng 在 AI 工程技能地图中拆解「用编码 agent」这项技能：三条工作流步骤（计划、执行、部署监控）与五项关键能力（导航、自主度、审查、定制、原理），并纠正长时自主运行被夸大的现实边界。

• AI Engineering
• Coding Agents
• Agent
• Workflow

AI 写代码之后，软件工程的价值在判断

编码 agent 让代码越来越便宜后，软件工程的价值转向判断：把模糊需求变成显式规格、用自动化门禁验证行为、用架构约束 agent，同时直面认知债与 junior 培养，并给出可立即执行的行动清单。

• AI Agent
• Software Engineering
• Coding Agents
• 工程判断

AutoMapper 商业化后：.NET 映射怎么选

AutoMapper 2025 年转为商业许可，最后 MIT 版本带未修补高危漏洞。用 .NET 10 实测对比 AutoMapper、Mapster、Mapperly 与手写映射，给出可照做的选型清单、迁移路线和 AI 代理防坑配置。

• AutoMapper
• Mapster
• Mapperly
• .NET 10
• Object Mapping

RAG 评估指标：先测检索，再测答案

把 RAG 评估拆成检索与答案两层：用可运行的 C# 实现 Precision@K、Recall@K、MRR、nDCG 与 groundedness、答案相关性，说明指标怎么解读、LLM 评判器的边界和离线评估组织，避免用总分掩盖问题。

• RAG
• .NET
• AI Evaluation
• Information Retrieval

用好 GPT-6 Astra，先清理旧指令

升级模型后，旧技能和项目指令可能让编程助手多读文档、反复测试或提前停工。结合原文与官方文档，梳理技能触发、按需读取、授权边界和完成条件，并给出可直接改写的示例与检查方法，帮助你维护适合项目的指令。

• AI
• Codex
• Prompt Engineering

RAG 查询变换：HyDE、Step-Back 与分解

三种查询变换都不是改写：HyDE 造假设文档当检索键、Step-Back 上移抽象层级、分解拆多跳问题。本文用与模型和向量库无关的 .NET 契约实现它们，并给出合并与基线对照评估。

• .NET
• RAG
• AI
• Architecture
• Embeddings

Azure AI Search 语义重排：RAG 的第二级检索

语义重排不是召回：它只重排第一级检索给出的候选。本文讲清 Azure AI Search semantic ranker 的能力边界（top 50、2000 token、0–4 分），并用 C# 给出语义配置、查询和证据投影的完整示例。

• RAG
• Azure AI Search
• .NET
• C#
• 语义检索

Specification、Repository 怎么区分

Specification、Repository 与 Query Object 在 .NET 里各回答什么问题？本文用接口草图、职责表和选型矩阵讲清三者的边界，并拆解常见误用：把查询包当规格、用规格做授权或校验、一有规则就上规则引擎。

• C#
• .NET
• 设计模式
• 架构

ChatGPT Work 实测：与 Chat 到底差在哪

OpenAI 上线两个月的 ChatGPT Work 到底与普通 Chat 有何不同？本文以 Simon Willison 的实测为底，并核对官方文档，讲清联网代码执行、无头浏览器、持久文件、Sites、子代理与安全边界。

• ChatGPT
• OpenAI
• Agent
• AI 工具

最终一致性：系统为何暂时读到旧数据

从一次写入后的短暂旧读出发，解释最终一致性的准确含义、CAP 在网络分区时的选择，并给出幂等、版本控制、事务发件箱、补偿和监控的设计清单，帮助开发者处理旧读、重复消息与并发冲突。

• Distributed
• Consistency
• Architecture
• Database

.NET 10 GC Handle：更安全的原生互操作

梳理 .NET 10 泛型 GC Handle API、.NET 9 弱内部指针句柄和 Android 双 GC 桥接机制，说明类型安全、性能收益、适用场景与生命周期风险。

• .NET
• Garbage Collection
• Interop
• Runtime

.NET GC 基础：栈、堆、代际与压缩

从对象分配和一次垃圾回收过程出发，解释 .NET 托管堆、GC Roots、标记与压缩、Gen 0 到 Gen 2、LOH 和后台 GC，并纠正值类型必在栈上、每次收集都会完整压缩等常见误解。

• .NET
• Garbage Collection
• Memory
• Performance

.NET 11 Runtime Async：异步为何更快

解析 .NET 11 Runtime Async 如何把异步控制流交给运行时和 JIT，减少同步完成路径上的状态机与对象分配，并结合作者微基准、官方 Preview 7 数据和启用方式说明性能收益、适用场景与预览限制。

• .NET 11
• C#
• Runtime Async
• Performance

数据复制的三条路：单主、多主与无主

从一次写入后读到旧数据的常见故障出发，比较单主、多主与无主复制的写入路径、故障处理、冲突成本和适用场景，并解释同步复制、法定人数、读修复与提示移交的真实工程边界。

• Distributed Systems
• Replication
• Quorum
• Cassandra

分布式系统时间：Lamport、向量时钟与 HLC

从物理时钟偏差和 happened-before 关系出发，比较 Lamport 时间戳、向量时钟与混合逻辑时钟的能力、限制和成本，并说明因果一致性如何保护评论回复、冲突检测、事务排序与分布式日志。

• Distributed Systems
• Lamport Clock
• Vector Clock
• HLC

分布式系统入门：从网络不确定性到 CAP 与 FLP

从一次无法判断结果的远程调用出发，理解分布式计算八个误区、CAP 与 PACELC 的真实取舍、FLP 不可能结果和部分同步模型，并把这些理论转换成超时、重试、幂等、一致性与共识组件的工程选择。

• Distributed Systems
• CAP
• PACELC
• Consensus

Harness 工程：让 AI Agent 真正可靠

从任务契约、项目地图、工具、持久状态、验证信号、权限控制和运行追踪七个方面，拆解如何为 AI Agent 建立可检查、可恢复、能够持续改进的运行环境，并给出按风险逐步扩展的实用检查表。

• AI Agent
• Harness Engineering
• Software Engineering
• Codex

Uber Agent 成本优化：用量增长 9.4 倍，账单趋稳

拆解 Uber 软件工厂的 Agent 成本方程、模型路由、上下文压缩、缓存时长、按需工具、Code Mode 与知识图谱，并整理成中小团队可执行的优化实施顺序。

• AI Agent
• Software Engineering
• Cost Optimization
• MCP

四种 LLM 缓存：省在哪里，错在哪里

从 KV、Prefix、Prompt 到 Semantic Cache，讲清四种 LLM 缓存保存什么、何时命中、为何失效，以及生产环境该如何排查成本、延迟与错误命中。

• LLM
• Prompt Caching
• KV Cache
• AI Engineering

AI 编程时代，软件基础仍是核心

Andrew Ng 认为，coding agent 可以扩大开发者的工作范围，却无法替你判断延迟、可靠性、成本和安全边界。本文把软件基础整理成全栈、数据、架构与生产能力四个检查方向。

• AI
• Agent
• Agentic Coding
• Software Engineering

ASP.NET Core Minimal API 过滤器实战

用 ASP.NET Core Minimal API Endpoint Filter 在处理程序前后执行校验、日志和响应控制，并掌握委托、IEndpointFilter、路由组、工厂及 .NET 10 内置校验的选择边界。

• ASP.NET Core
• .NET
• Minimal API
• C#
• Endpoint Filter

ASP.NET Core 请求超时：让取消真正传到底

ASP.NET Core 默认不会限制端点执行时间。本文用 .NET 8+ 内置中间件设置请求期限，并把取消信号传给 EF Core 与 HttpClient，附验证方法和排错边界。

• ASP.NET Core
• .NET
• C#
• CancellationToken
• Resilience

Agent Harness：让本地 Agent 变成生产级服务

微软 Agent Framework 系列收官：把本地 Agent 变成可用服务的四条线——可观测、Purview 合规、Foundry 部署、检查与评估，附 .NET/Python 代码与安全边界。

• Agent Framework
• Agent Harness
• OpenTelemetry
• AI Agent

Uno Platform如何用MCP让AI检查自己的应用

Uno Platform 按生命周期把 MCP 拆成两个服务器：文档服务器负责知识接地，应用服务器连接运行中的程序，让 AI 截图、读可视化树、点击界面自查生成结果。本文拆解拆分依据、工具清单、token 成本与 Skills 设计。

• Uno Platform
• MCP
• .NET
• AI Agent
• 软件架构

RAG 其实没那么复杂：六种检索架构怎么选

很多 RAG 项目一开始就上向量库、切块和重排，复杂度先于问题出现。本文拆解六种检索方案，从 BM25 与查询改写开始，按数据新鲜度、查询类型、规模和实测结果选择升级路径，并给出多意图查询与验证清单。

• RAG
• Information Retrieval
• LLM
• Search
• AI Architecture

C# 获取机器逻辑处理器总数

在 .NET 中获取机器处理器数量时，Environment.ProcessorCount 代表当前进程可用资源，不等于主机总数。本文用 Windows、macOS、Linux 示例说明原生 API与容器边界。

• C#
• .NET
• Performance
• Runtime
• Interop

C# Specification 组合：AND、OR 与 NOT

C# Specification 组合看似只是布尔运算，真正难点在于内存委托、表达式树、EF Core 翻译和空值语义。本文用可运行示例讲清参数重绑定、短路、测试与查询边界。

• C#
• .NET
• Specification Pattern
• LINQ
• Expression Trees

C# 管道错误处理：Result、异常与短路

C# 管道要区分预期拒绝、意外异常和取消，并把短路、幂等、重试与遥测写进契约。本文用订单示例说明 Result 与异常的边界，以及副作用发生后的处理方式，帮助你减少重复副作用与误判。

• C#
• .NET
• Pipeline
• Error Handling
• Result Pattern

Agent Framework：同一 Agent 接入多渠道

Microsoft Agent Framework 为 Python Agent 和 Workflow 提供共享 hosting 层，配合 Responses、Telegram、A2A、MCP 适配器接入不同协议，讲清会话映射与应用责任。

• AI Agent
• Microsoft Agent Framework
• Python
• MCP

AgentHarness：把 Agent 运行时变得可验证

AgentHarness 处理的核心不只是调用模型，还包括会话持久化、运行时配置、队列、保存点、Hook 重入与恢复边界。本文依据 pi 的设计文档，拆解四类状态、一次 turn 的时序，以及哪些能力已实现、哪些仍在计划中。

• AI Agent
• AgentHarness
• TypeScript
• 软件架构

OpenWiki 的自我纠错记忆：让 Agent 知道何时遗忘

长线 Agent 记忆的难点不只在召回，还在源代码变化后发现旧知识。本文拆解 OpenWiki 如何用 claim、证据版本和 stale 标记做定向修正，解读 0.4.0、OKF v0.2 与评估结果的真实边界。

• AI Agent
• Agent Memory
• OpenWiki
• 知识工程

代码代理为何烧掉 Token：语义导航何时值得用

AI 编程代理的高 token 账单，常来自定位代码时的反复搜索与读取。本文拆解语义导航的工作机制，解读 Sonar 的 6 个对照任务，并给出判断是否值得引入的四个条件。

• AI Agent
• 代码导航
• Token成本
• 软件工程

Azure AI Search 混合检索：BM25、向量与RRF

RAG 的第一阶段检索不该只会一种信号：精确词与概念相似各提供一批候选，再由 RRF 按名次融合。本文给出 Azure AI Search .NET 12 的混合查询示例、教学模型与排错边界。

• Azure AI Search
• RAG
• C#
• 向量检索

Loop 与 Graph Engineering 不是二选一

一张讽刺推文引爆的 Graph Engineering 热词背后，是真实的工程抉择：循环是图的节点，不是替代关系。本文拆解定义、选型条件与时间线，讲清何时只该加一个 Loop。

• AI Agent
• LangGraph
• 工程实践

ASP.NET Core 竞态条件识别与防护

两个请求同时读改写同一数据，一个更新会悄悄覆盖另一个。本文梳理竞态条件的两种典型形态，并用 lock、SemaphoreSlim、并发集合与 EF Core 乐观并发四种方案逐一说明取舍。

• ASP.NET Core
• C#
• 并发
• EF Core

C# 生成发票 PDF 全流程教程（.NET 10）

从 HTML 模板到可下载的 PDF：本文实现发票生成的完整链路，覆盖打印 CSS 分页、表头重复、货币格式化、页码与异步渲染队列，并说明何时不该用 HTML 转 PDF。

• C#
• .NET 10
• ASP.NET Core
• IronPDF

Agent 成本高，先查 Harness

同一个模型和任务，Agent 仍可能因为上下文膨胀与工具调用过多而多花几倍 token。本文拆解 Harness 的成本来源，并用 TrueForge 说明延迟加载、结果卸载、子代理、Code Mode 与压缩如何协同。

• AI Agent
• TrueForge
• LLM
• MCP

.NET 用 AVX-512 加速 IPv4 解析

Daniel Lemire 用 C#、.NET 10 和 AVX-512 为常见 IPv4 点分十进制输入设计 SIMD 快路径，借助 masked load、点位模式和回退策略，把标准库基线的解析成本降到约三分之一。

• C#
• .NET
• SIMD
• 性能优化

.NET 数据格式与查询语言速查

同一份数据换一种形状，适合的查询方式也会变化。本文从 CSV、关系数据库、XML、JSON、文档数据库、图数据和二进制格式出发，梳理 .NET 工具与 LINQ 的边界，帮助你快速做出选型。

• .NET
• C#
• LINQ
• 数据格式

Staff 工程师如何发现值得解决的问题

Lalit Maganti 分享他在基础设施团队寻找项目的方法：吸收问题而非需求、让线索积累、寻找共同形状，并在投入前进行验证。适合正在走向 Staff 的读者。

• Staff Engineer
• Engineering Career
• Product Thinking
• Perfetto

Agent Harness 是什么？模型之外的运行环境

Agent Harness 给大模型提供指令、工具、执行循环与模型切换能力。本文用登山安全带和邮件代理的例子讲清四部分，并解释用户为什么能自主运行、换模型并保留本地会话。

• Agent
• AI
• LLM
• Open Source

AI 工程能力地图：从模型到生产

Andrew Ng 将 AI 工程拆成六类能力：理解模型、准备上下文、设计 Agent、建立评测、运行生产系统和掌握机器学习基础。本文把这张地图整理成一套判断学习重点与工程工作的框架。

• AI
• AI Engineering
• LLM
• Agent
• MLOps

C# 异步流水线：顺序等待、取消与完成

已经会用 async/await 后，如何把多个有依赖的 I/O 步骤组成正确流水线？本文用完整可运行示例讲清顺序等待、取消传播、任务完成信号与资源释放边界，并列出常见错误。

• C#
• .NET
• Async/Await
• CancellationToken
• Pipeline

Azure AI Search 向量查询：.NET 直连检索模型

已有向量索引时，怎么用 Azure.Search.Documents 发送正确的向量查询？本文拆解同一嵌入模型、字段名、VectorizedQuery、元数据过滤和分数含义，并给出上线前测试建议。

• Azure AI Search
• Vector Search
• .NET
• C#
• RAG

从 17ms 到 0.04ms：如何设计正确的 SQL 索引

以 Postgres 18 和 100 万条评论为例，用 EXPLAIN ANALYZE 实测索引设计：为什么复合索引的列顺序决定一切、等值列在前排序列在后、为何有的索引用不上、以及每条索引的写入与磁盘成本。

• SQL
• PostgreSQL
• Database
• Indexing

ASP.NET Core API 版本化实战（.NET 10）

.NET 10 下用 Asp.Versioning 10.2 给 API 做版本化：URL 段与请求头怎么选、控制器与 Minimal API 两种写法、每版本 OpenAPI 文档、字段级版本化与 Sunset 头，附完整代码与最佳实践。

• .NET
• ASP.NET Core
• API
• Versioning

系统设计入门：每个系统都要做的 7 个决策

系统设计不是背组件，而是做决策。拆解每个系统都要回答的 7 个问题：数据新鲜度、存储选型、垂直还是水平扩展、缓存分层、同步还是异步、过载应对与部署形态，附 CAP/PACELC、分片键与 .NET 限流示例。

• System Design
• Architecture
• .NET
• Microservices

从零构建类型安全的 C# 管道

从零实现一个类型安全的 C# 同步管道：IStage 泛型契约、Pipeline 两段组合、编译期类型检查、不可变消息与异常传播，附完整代码、执行顺序分析和常见陷阱。

• .NET
• C#
• Architecture
• Pipeline

Microsoft.Extensions.AI 嵌入管道

嵌入生成在摄取与查询两处出现，需要同一个类型化边界。用 Microsoft.Extensions.AI 10.7 稳定 API 讲清嵌入管道：类型化契约、批量与单条生成、缓存与遥测装饰、嵌入身份与兼容性。

• .NET
• AI
• C#
• Architecture

Codex 多代理编排：给 Sol 一个团队

GPT-5.6 Sol 有了团队才更有意思。整理 Codex Multi-Agent V2 的实战编排：Scout/Worker/智能 Worker 分工、推理档位匹配、上下文继承、并发预算与技能固化，附作者编排技能原文。

• AI
• Agent
• Productivity
• Tools

C# 实时语音转文字：Foundry Local 本地运行

用 Foundry Local 在本地跑 NVIDIA Nemotron 0.6B 流式语音模型，C# 控制台应用实时转录麦克风：模型目录解析与下载、直播会话、部分与最终结果异步流，全程无需 API key。

• .NET
• C#
• AI
• Windows

Azure DevOps 远程 MCP Server 正式发布

Azure DevOps 远程 MCP Server 正式 GA：无需自托管，配置一个 URL 即可让 AI 助手安全访问工作项、PR、仓库与流水线。讲清支持客户端、Entra 认证要求与本地版取舍。

• AI
• DevOps
• Productivity
• Tools

Microsoft.Extensions.AI 路由与故障转移

Microsoft.Extensions.AI 10.9 带来四个实验性路由原语：RoutingChatClient、语义路由、按序故障转移，全部实现 IChatClient。讲清各自用途、关键选项、粘性会话与适用边界，附可运行代码。

• .NET
• AI
• C#
• Architecture

Teams 协作减噪：Agent 的三种礼貌交互

群聊里 Agent 的每条回复都在争夺注意力。本文基于微软官方实践，讲清 Teams Agent 用 emoji 反应、线程回复、引用回复为协作减噪：何时用、怎么调 SDK API，附可运行示例。

• AI
• Productivity
• Tools
• Teams

用 C# 构建你的第一个 MCP Server

基于官方 ModelContextProtocol SDK 2.x 与 .NET 10，从空项目构建一个真实可用的 NuGet 版本查询 MCP Server：工具定义、stdio 与 HTTP 双传输、SDK 2.0 变更和排查清单。

• MCP
• Dotnet
• AI
• Claude Code

社交信息流系统设计：从读时扇出到混合扇出

信息流是每个社交产品的标配，也是最经典的分布式系统设计题之一。本文从读时扇出讲起，逐步推到写时扇出、写放大、混合扇出与排序信息流，用 Twitter 公开的真实数据解释每一步为什么改、代价是什么。

• System Design
• Distributed Systems
• Architecture
• Redis

NLog vs Serilog：2026 该怎么选

NLog 与 Serilog 是 .NET 最常用的两个日志库。本文从配置风格、结构化日志、路由能力、性能、生态与迁移成本六个维度对比，给出决策矩阵、适用场景与 FAQ。

• NLog
• Serilog
• Logging
• .NET
• Observability

.NET RAG 稳定架构：边界先于实现

RAG 不是聊天功能，是数据系统。本文给出与模型、向量库、框架无关的稳定架构：来源溯源、嵌入边界、授权检索、引用契约、删除闭环，附可编译的概念性 C# 契约代码。

• RAG
• AI
• Dotnet
• Architecture
• Embeddings

用 Claude 重构遗留 .NET：不是重写是工作流

遗留 .NET 代码库不敢动？本文拆解用 Claude 重构 LegacyErp 的四步工作流：只读评估出路线图、特征测试兜底、先修 SQL 注入与内存泄漏、逐主版本升级，附 agent 配置与安全规则。

• AI
• Claude
• LegacyCode
• Refactoring
• Dotnet

EF Core 持久化富领域模型：完整实战

EF Core 不需要 public setter 也能持久化完全封装的聚合。以家酿啤酒 Batch 为例，从私有构造函数、backing field、值转换到领域事件，逐段给出可直接运行的映射配置。

• EFCore
• DDD
• CSharp
• Dotnet
• Architecture

Agentic Code Quality：质量藏在约束里

AI agent 每天生成海量代码，逐行 review 已不可行。本文梳理 Addy Osmani 的约束驱动质量框架：质量门有哪些形态、背压如何贯穿管道、人类注意力该投向哪里，附 Guillermo 清单与自主性分级模型。

• AI
• Agent
• CodeQuality
• CodeReview
• Engineering

2026 高级 .NET 面试：35 道真实考题拆解

高级 .NET 面试考的是判断力不是知识点：35 道真实考题，覆盖 GC 内存、线程池饥饿、生产诊断、性能基准、数据规模、架构取舍与 .NET 10 迁移，每题附雷区回答与追问。

• Interview
• .NET
• CSharp
• Performance
• Architecture

NLog 性能调优：AsyncWrapper 与缓冲日志

高峰流量下日志拖慢请求？用 AsyncWrapper 把 I/O 移出调用线程、BufferingWrapper 批量写库，配合参数调优、文件 target 优化与 BenchmarkDotNet 基准，得到生产级高吞吐 NLog 配置。

• NLog
• .NET
• CSharp
• Logging
• Performance

ASP.NET Core 集成 NLog 完整入门

从安装 NLog.Web.AspNetCore 到两种配置方式、Program.cs 启动关闭模式、Worker Service 接入与 ILogger 注入验证，一文讲清生产可用的 NLog 配置。

• NLog
• ASP.NET Core
• .NET
• Logging
• CSharp

Copilot CLI vs Claude Code 怎么选

GitHub 生态与 Claude 生态的终端 AI 编程代理怎么选？本文从安装认证、自定义指令、权限、MCP、模型、子代理到无头自动化逐项对比，并给出 GitHub 重度团队和 Claude 重度团队各自的选型建议。

• GitHub Copilot
• Claude Code
• CLI
• AI 编程
• 开发工具

WPA MCP 预览：用 AI 分析 Windows trace

Windows Performance Analyzer 集成 GitHub Copilot 的早期预览：自然语言提问 trace 分析，快速定位 CPU、延迟与瓶颈根因。目前仅支持 Copilot 订阅，附示例 prompt 与设置。

• Windows
• Performance
• MCP
• AI Agents

从生成代码到可信代码：微软开源单测 agent

微软开源 polyglot 单测生成 agent（code-testing-generator），四步工作流让测试可运行、可被发现、断言有效；152 任务基准完成率 92.1% 对 78.9%，附安装与试用方法。

• AI Agents
• Unit Testing
• .NET
• GitHub Copilot

NLog 完整指南：.NET 灵活日志框架上手

用 .NET 8+ 示例讲透 NLog 三大概念：Targets 定去向、Renderers 定格式、Rules 定路由，覆盖双配置与结构化日志，适合 ASP.NET Core 和 Worker Service 开发者。

• NLog
• .NET
• Logging
• ASP.NET Core

拆不拆微服务？先回答这 5 个问题

微服务的本质是用本地复杂度换分布式复杂度。拆之前先用 5 个问题自查：扩展需求、团队阻塞、数据边界、独立发布、平台税，再按答案数量决定拆服务、模块化单体还是保持单体。适合正纠结架构方向的团队。

• Microservices
• Software Architecture
• Modular Monolith
• Decision Making

Squad 接入 Agent Framework：会学习的团队

Squad 是运行在 GitHub Copilot CLI 上的开源多智能体框架，会记住决策、沉淀技能。预览包 Squad.Agents.AI 把它包装成标准 AIAgent，一行 DI 注册即可接入 Agent Framework。

• Agent Framework
• AI Agents
• GitHub Copilot
• .NET

什么时候该用微服务？一份务实的架构决策指南

微服务解决的是组织与扩展问题，不是代码质量问题。本文梳理该用与不该用的信号、隐藏成本与模块化单体路线，并用 Amazon Prime Video、Segment 的真实返工案例讲清默认选择。

• Microservices
• Modular Monolith
• Software Architecture
• .NET

重构能省多少 Token？一次 Agent 代码库的经济实验

当 Agent 写出 17,155 行的单文件数据访问层时，重构不再是代码品味问题，而是直接的经济决策。Thoughtworks CTO 用 15 步重构做了一次实验，发现同样的修改任务，输入 Token 消耗从 15.9 万降到了 2.7 万，降幅 83%。这篇文章拆解了他的实验设计、数据和关键发现。

• AI Agent
• Refactoring
• Claude Code
• Software Engineering

ChatGPT Agent 循环优化：Harness、API 与推理层的三层提效实践

Bytebytego 与 OpenAI 工程师深入交流，拆解了 ChatGPT Agent 在 Harness 接入层、API 中间层和推理层分别采用了哪些优化手段来降低单次任务成本。文章梳理了持久 WebSocket、增量请求、缓存感知路由、推测解码等 11 项具体技术及其协同关系。

• AI Agent
• System Design
• LLM
• Performance

GitHub Copilot 实战工作流：驾驭 harness，而不是追新工具

每天都有新的 AI 工具、MCP 和工作流冒出来，但真正提升效率的关键不是追新，而是驾驭好你手里的 agent harness。本文分享一套经过验证的 GitHub Copilot 八步工作流，覆盖原型探索、系统规划、自动实现到交叉审查的完整链路，让你摆脱工具焦虑，回归可重复的高质量产出。

• GitHub Copilot
• AI Coding
• Workflow
• Developer Tools

Clean Architecture vs 模块化单体：它们根本不是对手

在 .NET 架构讨论中，Clean Architecture 和 Modular Monolith 常被当作二选一的对手，但这是一种误解。两者工作在完全不同的抽象层级：一个管内部层次组织，一个管系统边界划分。本文从问题域、作用范围、部署模型到实战组合方式，把两者的区别和协作关系讲清楚。

• Clean Architecture
• Modular Monolith
• CSharp
• Software Architecture
• .NET

OpenTelemetry Logging in .NET：从 ILogger 到结构化日志导出

纯文本日志文件不够用了？本文带你从零配置 OpenTelemetry logging in .NET，覆盖 ILogger 无缝集成、trace context 自动关联、OTLP 导出、结构化日志解析和生产环境最佳实践。不需要改业务代码，你的日志就能和 traces、metrics 在同一个可观测后端里关联查询。

• OpenTelemetry
• .NET
• Logging
• ILogger
• Observability

MCP C# SDK v2.0 发布：无状态默认、原生 HTTP 与多轮交互

官方 MCP C# SDK v2.0 随 2026-07-28 协议修订发布。三大核心变化：默认无状态架构让服务器可以水平扩展、原生 HTTP header 支持让现有基础设施直接路由 MCP 流量、Multi Round-Trip Requests 用一个模式替代了 tools/prompts/resources 三种旧模式。本文梳理 v2.0 的全部关键更新和向后兼容策略。

• MCP
• CSharp
• .NET
• ASP.NET Core
• SDK

如何记住你读过的一切，以及为什么你不该这么做

Dan Koe 写了一篇被数万人收藏的长文，核心观点是：理解比记忆重要，真正的学习来自「目标驱动的项目实践」而非囤积知识。本文提炼文中关于控制论学习模型、第二潜意识系统和 AI 辅助写作的方法论。

• 学习
• 知识管理
• AI
• 写作

从 MCP 服务器发现 Agent Skills：.NET 中的一次发布、随处可用

Microsoft Agent Framework 新能力：Agent 可以从 MCP 服务器按需发现和加载 Agent Skills，技能作者只需发布一次。本文介绍 MCP 技能的工作机制、两种分发模式（skill-md 和 archive），以及如何在 .NET 项目中接入。

• .NET
• Agent Skills
• MCP
• Agent Framework

OpenTelemetry Metrics .NET：从 Counter、Histogram 到 IMeterFactory

全面拆解 .NET 中 OpenTelemetry 指标埋点：System.Diagnostics.Metrics 原生 API、四种仪器类型（Counter/Histogram/Gauge/UpDownCounter）的适用场景，以及为什么应该用 IMeterFactory 而不是 new Meter()。附完整代码示例和 Prometheus/OTLP 导出配置。

• OpenTelemetry
• .NET
• Metrics
• Observability
• CSharp

在 Node.js 中直接调用 Windows 原生 API：动态 WinRT 投影进入公开预览

微软发布 Node.js 动态 Windows Runtime API 投影公开预览版。一个 npm 包即可让 Electron 或 Node.js 应用直接从 JavaScript/TypeScript 调用 Windows 原生 API——包括设备端 AI、通知、文件选择器、传感器等，不再需要 C++/C# 桥接层。

• windows
• nodejs
• javascript
• typescript
• electron
• winrt
• microsoft
• release

用 MCP Inspector 调试 C# MCP Server：从连接到排错

MCP Inspector 是官方 MCP 服务器调试工具。本文覆盖 C# 场景下的 stdio 和 Streamable HTTP 两种连接方式、工具/资源/提示词的交互测试、JSON-RPC 原始日志解读、五种 .NET 常见故障模式，以及从 Inspector 导出 mcp.json 配置的完整流程。

• mcp
• model-context-protocol
• csharp
• dotnet
• debugging
• tutorial
• aspnet-core

从 GPT-2 到 KimiK3：七年 22580 倍的架构演进

从 GPT-2 的 softmax attention 出发，历经 Linear Attention、DeltaNet、Gated DeltaNet、Kimi Linear，最终到达 KimiK3 的混合架构。七年内模型参数增长 22580 倍，但真正的变化发生在注意力机制如何存储、更新和检索信息的方式上。

• llm
• transformer
• attention
• deep-learning
• architecture
• research
• kimi
• gpt

ASP.NET Core 健康检查完全指南：从 Hello World 到生产环境

从零开始为 ASP.NET Core (.NET 10) 添加健康检查：数据库、Redis、自定义检查、liveness/readiness 探针拆分、探针成本预算、优雅排水，以及 Kubernetes 部署接线。附 Health Checks UI 的版本坑和 CVE 注意事项。

• health-checks
• aspnet-core
• dotnet
• kubernetes
• observability
• ef-core
• redis
• tutorial

Microsoft Agent Framework 原生记忆：Azure Cosmos DB 驱动的 CosmosMemoryContextProvider

Microsoft Agent Framework 新增 CosmosMemoryContextProvider，一行代码让 AI Agent 拥有基于 Azure Cosmos DB 的持久化长期记忆——对话存储、事实提取、摘要生成、用户画像全自动。本文讲解 context provider 抽象设计、before_run/after_run 生命周期、以及如何用自定义 Prompty 模板调教 Agent 记住什么。

• Microsoft Agent Framework
• Azure Cosmos DB
• AI Agent
• Agent Memory
• Python
• Observability

OpenTelemetry Traces .NET：ActivitySource、Span 与追踪管线

深入理解 OpenTelemetry Traces 在 .NET 中的实现：从 ActivitySource/Activity 的 span 创建、Tags/Events/Exception 的上下文增强，到 W3C traceparent 跨服务传播和 OTel tracing pipeline 配置。包含 OrderService → InventoryService 的完整分布式追踪示例，以及常见坑点和测试方法。

• OpenTelemetry
• .NET
• Tracing
• ActivitySource
• ASP.NET Core
• Distributed Tracing
• Observability

OpenTelemetry in .NET：可观测性完整指南

从零开始理解 OpenTelemetry 在 .NET 中的三大信号——Trace、Metrics、Logs——如何用 System.Diagnostics 原生 API 统一采集，再通过 OTLP 导出到任意后端。包含快速上手代码、自定义 ActivitySource、Meter 设计、Serilog 配合以及生产环境 exporter 配置，读完能直接在自己的 ASP.NET Core 项目里落地可观测性。

• OpenTelemetry
• .NET
• Observability
• ASP.NET Core
• Tracing
• Metrics
• Logging