玄同765-CSDN博客

原创【开源发布】MCP Document Reader：让你的 AI 助手真正读懂需求文档！

在使用 Claude 或 Trae IDE 时，你是否遇到过这样的尴尬：你想让 AI 分析一个复杂的 Excel 报表或一份长达百页的 PDF，结果它要么提示“文件太大”，要么读取出来的格式乱七八糟。为了解决这个问题，我开发了 MCP Document Reader。今天，我正式将其发布到了 MCP 官方 Server 列表！这意味着现在全球的开发者都可以通过简单的配置，让他们的 AI 助手获得“阅读大师”般的超能力。

2026-03-11 15:13:59 7512 5

原创【开源发布】MCP Document Converter：让你的 AI 助手精通 25 种文档转换神技！

大家好，我是玄同765（xt765）。作为一名开发者，我一直想让 AI 更好地帮助我们处理日常工作。最近我遇到了一个痛点：如何让 AI 直接处理不同格式的文档？比如，我想让 AI 读取一个 PDF 文件并总结内容，或者把 Markdown 转成 Word 文档发给同事。但 AI 往往只能输出文本，不能直接操作文件格式。这让我萌生了一个想法：开发一个能让 AI 直接调用的文档转换工具。

2026-03-03 20:13:30 6306 38

原创 AI 对话发错指令只能重开重敲？开源用户消息原位编辑与分支重发插件实战

本文深入拆解开源用户消息原位编辑与分支重发插件 dsh-message-edit 的设计与实现，涵盖客户端插槽优先级覆盖（Slot Shadowing）、气泡下方铅笔图标与圆角内联编辑卡片切换、上一轮末尾事件序号（prevTurnEndSeq）分叉求解算法以及跨会话乐观回显与图片附件重发。

2026-10-19 10:25:13 13

原创改上下文窗口总要手翻 YAML 还压缩失败？开源可视化窗口配置与自适应压缩守卫插件实战

深度拆解单纯改小大模型 contextWindow 引发自动压缩预算倒挂（TargetPressureConfigError）的数学根源，实战开源 dsh-context-window 插件：通过单选插槽无损扩展第三行【上下文窗口】与 64K~2M/自定义输入面板，内置自适应压缩预算缩放与「高切低先压缩」三层防失败守卫。

2026-10-18 12:11:54 117

原创【RAG 架构与评测实战 #05】Agent 评测体系（下）：证据感知的澄清判分与防假通过契约

《企业级 RAG 架构与全链路评测实战》第05篇收官之作。解决return_direct终止型澄清工具被误判0分的冤案，构建证据感知的澄清判分Rubric与非对称期望门禁，并用零隐式转换契约彻底消灭bool("false")假通过漏洞。

2026-10-18 00:36:53 266

原创【RAG 架构与评测实战 #03】数据表与 SQL 检索：防泄密结构提取、双表征索引与重排五重门禁

《企业级 RAG 架构与全链路评测实战》第03篇。针对多租户数据视图与SQL资产检索，实现基于sqlglot AST的无源码公开结构事实提取与底表名自动掩码、Schema与用法画像双表征独立向量化折叠召回，以及重排器五重契约门禁。

2026-10-18 00:36:42 198

原创 AI Agent 流式工具调用总报 terminated 与签名丢失？深度拆解 SSE 静默超时与协议适配陷阱

深度拆解 AI Coding Agent 在通过本地 OpenAI 兼容协议网关调用深度思考模型时，大体积工具调用触发 180 秒分片静默超时报 terminated (TRANSPORT) 以及热重启网关丢失内存 thought_signature 报 400 的底层原理，并提供全链路根治方案。

2026-10-18 00:24:01 219

原创 AI 长回复没法逐段批注？开源划词引用与行内评论胶囊插件实战（已获官方收录）

本文深入拆解 DeepSeek Harness 划词引用与行内批注汇总插件 dsh-selection-quote 的架构设计与工程实现，涵盖会话级插槽挂载、DOM 选区边界隔离、视口自适应翻转算法及 SessionInputShell 乐观并发草稿写入闭环。

2026-10-18 00:10:31 111

原创【RAG 架构与评测实战 #04】Agent 评测体系（上）：三轴结果模型、基建故障归因与三态门禁

《企业级 RAG 架构与全链路评测实战》第04篇。针对评测准确率常被环境抖动污染的痛点，构建交互模式×故障责任方×单题状态正交三轴模型，精准区分连接超时与烂SQL查询超时，并通过样本覆盖率三态门禁杜绝幸存者偏差。

2026-10-17 16:29:26 349

原创【RAG 架构与评测实战 #02】双路混合召回：自适应 RRF 平滑常量、文档级聚合与三态降级

《企业级 RAG 架构与全链路评测实战》第02篇。揭秘教科书RRF(k=60)在小窗口下导致双路末位弱命中反超主路第一名的数学根源，实现候选窗口自适应平滑常量effective_k、文档级聚合、引号锚点提权与三态可用性降级契约。

2026-10-17 16:29:00 106

原创【RAG 架构与评测实战 #01】确定性文档切分、受控 LLM 摘要增强与防注入预览输出

《企业级 RAG 架构与全链路评测实战》第01篇。剖析为何让LLM直接切分文档会导致正文篡改与偏移量丢失，手把手实现基于标题树与空行的确定性切分器、只补摘要不改边界的受控LLM增强、双代际Epoch原子索引切换与防注入预览卡片。

2026-10-17 16:27:50 100

原创【Agent Harness 架构手册 #05】AI Agent 自进化经验蒸馏飞轮与 SSE 游标断点重连实战

《Agent Harness 架构手册：构建高可靠 AI 智能体运行时》连载第05篇收官之作。本文拆解两大生产级高阶能力：受控的正负向三模经验蒸馏飞轮（单次交付锁+14步查重上限）与基于asyncio.Condition内存游标缓冲池的SSE断点重连（ReplayableEventBus）及运行中实时控向（Steer）。

2026-10-17 01:23:21 86

原创【Agent Harness 架构手册 #04】企业级 Agent 零信任权限审计与 AST 行级安全注入：防止长对话中途撤权泄密

《Agent Harness 架构手册：构建高可靠 AI 智能体运行时》连载第04篇。本文构建企业级AI Agent零信任安全防线：实现模型调用前、工具执行前、结果发布前的三重实时权限核验、跨权限代次（Grant Epoch）旧数据遮罩以及基于sqlglot AST语法树的行级安全强制注入。

2026-10-17 01:23:05 277

原创【Agent Harness 架构手册 #03】多轮对话上下文引擎实战：L1~L4 四级预算投影与无损回放

《Agent Harness 架构手册：构建高可靠 AI 智能体运行时》连载第03篇。本文剖析多轮工具调用下的追问失忆难题，手把手实现四级无损历史投影引擎：原始消息不可变，按Token预算实时计算L1预览、L2结果卡片、L3结构化台账与L4折叠提问，削减85%开销且100%保留SQL筛选条件。

2026-10-17 01:22:47 244

原创【Agent Harness 架构手册 #02】AI Agent 实时动态流（Action Feed）与阶段性结论合成引擎实战

《Agent Harness 架构手册：构建高可靠 AI 智能体运行时》连载第02篇。本文详解如何告别满屏生硬JSON，从零构建双轨制可观测交互引擎：涵盖声明式工具元数据挂载、Running/Done双态语义转换器、每3步滑动窗口阶段性结论合成器（含嵌套流Tag静默隔离与确定性规则兜底）。

2026-10-17 01:21:41 298

原创【Agent Harness 架构手册 #01】LangGraph 动态工具配额守卫实战：根治无限探索与 return_direct 报错不自愈

《Agent Harness 架构手册：构建高可靠 AI 智能体运行时》连载第01篇。本文深入拆解生产级AI Agent工具调用配额控制核心难题，手把手教你实现支持四维探索配额、验证后锁定、return_direct结束工具报错自愈（Command回跳重试）与阶段性进展自动合成的动态工具配额守卫中间件。

2026-10-17 01:21:26 278

原创多智能体协同（Agent Teams）工程实战：Fresh/Fork 上下文隔离、共享任务板 CAS 锁与文件并发防覆盖设计

本文深入拆解多智能体协同（Multi-Agent / Agent Teams）生产级工程架构：对比Subagent、Fork与Team模式的选型边界，手把手实现Fresh/Fork双模上下文分流器（100%复用Prefix Cache）、带expected_revision CAS乐观锁与Write Scopes写范围预警的共享任务板，以及基于FS_STALE_VERSION的并发文件防覆盖自愈闭环。

2026-10-17 00:03:57 201

原创 AI Agent 工具执行引擎与安全护栏实战：从「先读后写」门禁、超时无缝转后台 Job 到死循环熔断

本文深入剖析AI Agent工具执行引擎（Tool Execution Engine）与安全护栏设计，手把手带你实现生产级Agent必备的三大核心机制：文件先读后写观测门禁（Read-Before-Write Guard）、长耗时命令超时无缝转后台任务（Sync-to-Async Job Promotion）以及双模式工具指纹死循环熔断器（Doom-Loop Breaker）。

2026-10-17 00:00:46 224

原创 AI Agent 上下文工程（Context Engineering）与 Prompt Cache 实战：如何让 50 步工具调用不爆窗口、成本直降 80%？

本文深入拆解AI Agent长链路上下文工程（Context Engineering）与Prompt Cache优化实战：剖析动态时间戳与工具顺序抖动导致KV Cache失效的根因，手把手实现100%保护前缀缓存的消息组装器、大体积工具输出落盘分流器与协议安全的检查点压缩器（Compaction），让Agent连续执行50步不爆窗口、推理成本直降80%。

2026-10-16 23:57:38 147

原创 Cursor Agent 连续调工具不汇报进展？阶段性结论守卫插件接入实战

本文手把手教你在Cursor中移植并实现「阶段性结论守卫」插件（Milestone Progress Reporting Guard）。通过全局Personal Context与本地Agent运行时请求出口（NZe）的双层无状态拦截，在system常驻注入之外，对漏发结论的工具调用步自动在末尾tool消息内联追加提醒，彻底根治推理模型在长链路执行中闷头调工具不说话与中途纯文本停机难题。

2026-10-16 23:29:05 334

原创 AI Agent 连续调工具闷头当哑巴？开源阶段性结论守卫插件实战（已获官方收录）

本文深入拆解 AI Coding Agent 在长链路执行中「闷头调工具不说话」与「中途单独发纯文本导致回合中断」的底层机制，并手把手带你使用与剖析 DeepSeek Harness 原生插件 dsh-milestone-guard（支持 System Prompt 常驻注入、tools/post-execute 软强制提醒与 Web GUI 热更新配置）。

2026-10-16 23:02:57 1259

原创 Cursor 自定义大模型 API 保姆级教程：从第三方接口接入到本地 Agent 直连与思考强度配置

很多刚开始用 Cursor 的朋友都会遇到同一个困惑：明明自己手里有现成的大模型 API Key，或者已经在电脑上用 Ollama、vLLM 跑起了本地大模型，可一旦填进 Cursor 的设置页，点下 Verify 不是报连接失败，就是在 Agent 模式下读不了文件、调不动终端工具。更让人头疼的是，像 DeepSeek-R1、Qwen3、Gemini 等支持深度思考（Reasoning）的模型，接进 Cursor 后往往只能按默认参数跑，左下角根本找不到调节「思考强度（Reasoning Effort

2026-10-16 01:00:52 192

原创从神经元到神经网络：深度学习的本质

这篇文章将带你从零开始理解神经网络。我们会从生物神经元讲起，一步步推导到人工神经网络，理解前向传播、反向传播的原理，最后用PyTorch实现你的第一个神经网络。

2026-03-25 01:47:13 386

原创 KNN到随机森林：常用机器学习算法的直观理解与实战

今天，让我们深入理解每种算法的"脾性"，学会在不同场景下选择最合适的武器。我会用大量的图解和代码示例，让你不仅"知道"这些算法是什么，更要"理解"它们为什么有效。

2026-03-25 01:35:32 381

原创从猜数游戏到模型训练：机器学习核心概念的无痛入门

今天，让我们从零开始，用最通俗的语言和最直观的图解，系统性地理解机器学习最核心的概念。无论你是计算机专业的学生，还是其他领域想要入门AI的从业者，这一篇文章将为你打下坚实的基础。

2026-03-24 23:48:48 231

原创大模型推理成本优化指南：在生产环境中如何兼顾质量与效率

根据业界的研究数据，大模型推理成本可以占到整体运营成本的60%以上。这个比例在某些高流量场景下甚至更高。这意味着，如果不能有效地控制推理成本，即使模型效果再好，也可能成为一个商业上不可持续的项目。这篇文章将深入探讨生产环境中大模型推理成本优化的完整图景。我们会从为什么推理如此昂贵开始，一步步拆解各种优化技术的原理、权衡取舍，以及如何在实际项目中选择合适的优化策略。

2026-03-24 23:33:34 292

原创大模型幻觉量化评估指南：用什么指标来衡量“一本正经地胡说八道“？

当你问一个大模型"秦始皇统一六国是在哪一年？“，它回答"公元前221年”——这是正确的。当你问它"秦始皇最喜欢吃什么水果？“，它回答"秦始皇最爱吃荔枝，因为据说荔枝最早在秦朝就有记载”——这听起来很有道理，但实际上是在一本正经地胡说八道。这种现象，就是大模型领域常说的"幻觉"（Hallucination）。大模型为什么会产生幻觉？产生了多少幻觉？怎么量化评估这些幻觉？这些问题，是每一个在实际项目中使用大模型的人必须面对的。本文将系统性地介绍大模型幻觉的成因、分类，以及业界主流的量化评估指标和基准测

2026-03-24 22:56:55 981

原创【论文解读】注意力机制的几何贝叶斯：揭开Transformer推理的神秘面纱

但这里有一个困扰了研究者多年的问题：当我们问ChatGPT一道数学题或者一个逻辑谜题时，它给出的回答究竟是真正的"推理"——像人一样逐步计算概率、权衡证据——还是只是在"背诵"它训练数据中见过的类似答案？

2026-03-24 22:47:31 461

原创 AI项目验收完全指南：从需求到上线的系统化方法论

如果你做过传统软件项目，可能会觉得验收这件事没什么大不了的——写好功能清单，逐项测试，通过就上线呗。但AI项目的验收完全是另一回事。在AI项目实践中，团队往往在验收阶段才发现根本没有准备好。这篇文章，我会从最基础的概念讲起，一步一步带你理解AI项目验收的每个环节。我会告诉你为什么AI验收这么难、难在哪里、怎么应对。无论你是产品经理、项目经理还是技术人员，读完都应该能掌握一套可以落地的方法。

2026-03-24 22:40:38 688

原创题库特征工程与智能质量保障体系：基于多维答题数据的AI驱动题库健康管理

如果你是在线教育平台的运营或技术负责人，我相信你一定也遇到过类似的情况。这三个简单的问题背后，隐藏着一个复杂的系统工程问题：**如何让系统自动发现并修正问题题目？**本文将深入探讨这个问题，从特征工程、异常检测、AI干预、三级监察四个维度，详细介绍如何构建完整的题库质量闭环。我会一步步解释，确保零基础读者也能完全理解。

2026-03-24 21:38:47 560

原创多模态情感计算与交互编排：音文本端到端情绪解析与智能交互系统

在人工智能日益渗透各行各业的今天，情感计算作为人机交互的"最后一公里"，正在成为 AI 落地应用的关键突破口。传统的情感分析方案往往依赖于单一模态——要么只看文本，要么只听语音——而忽视了人类情感表达的多模态本质。本文将深入探讨如何基于多模态大模型实现语音与文本的统一情绪解析，如何通过三层防御体系对抗 LLM 结构化输出的幻觉问题，如何利用离线聚类挖掘长尾情绪画像，以及如何通过拟物化伴学设计实现即时反馈。

2026-03-24 21:32:34 2990

原创大模型结构化输出实战：JSON解析防崩溃三层防御体系设计

在大模型应用落地过程中，有一个问题几乎所有工程师都会遇到，但大多数人一开始都低估了它的难度：如何让大模型稳定地输出结构化JSON数据？本文将深入剖析这个问题背后的本质，详细讲解一套经过生产环境验证的"三层防御体系"，并从架构决策的角度分析为什么选择这种方案而非其他替代品。无论你是刚入门LLM开发的新手，还是已经在项目中踩过坑的工程师，读完本文后，你都能对这个问题有更系统的理解。

2026-03-24 21:28:02 835

原创长尾数据挖掘闭环：利用 Embedding 聚类与 Label Studio 构建智能情绪标注体系

每个做情绪分类的团队都遇到过这样的困境：你的模型在"正面"、"负面"、"中性"这三大类上表现完美，但当用户开始使用时，各种"奇怪"的情绪出现了——"焦虑"、"期待"、"困惑"、"讽刺"、"无奈"......这些长尾情绪在训练数据中几乎不存在，但在真实场景中却频繁出现。更糟糕的是，你根本不知道这些长尾情绪有哪些。你无法预先定义它们，因为它们"隐藏"在大量未标注数据中。这就是典型的**开放世界半监督学习（Open-World SSL）**问题——模型不仅要识别已知类别，还要发现并学习未知的新类别。

2026-03-17 23:16:38 884 1

原创 vLLM 部署 Qwen 系列模型完全指南：从 Qwen2.5-Omni 到 QwQ 再到 Qwen2.5-72B

在大模型落地应用的时代，如何高效部署和推理成为了每个开发者必须面对的挑战。vLLM 作为当前最流行的大模型推理框架之一，以其卓越的吞吐量和内存效率，成为了部署 Qwen 系列模型的首选方案。本文将深入讲解 vLLM 的核心原理、架构设计，以及如何部署 Qwen 系列模型，并详细介绍如何让大模型输出结构化 JSON 数据。

2026-03-17 23:14:09 805

原创从零构建企业级 Agent 编排框架：基于 FastAPI 的 LangGraph 风格框架设计与实现

在这篇文章中，我将手把手教你如何基于 FastAPI 从零构建一个企业级的 Agent 编排框架——我们称之为 **AgentFlow**。这个框架会借鉴 LangGraph 的核心设计理念（节点、边、状态机），但在此基础上进行深度定制，以满足真实业务场景的需求。更重要的是，我们会详细讲解如何集成 **Milvus（向量存储）**、**Neo4j（图数据库）** 和 **PostgreSQL（关系型存储）** 来构建一个完整的记忆系统。这不是简单地把三个数据库拼在一起，而是一个有设计层次、有业务逻辑的记

2026-03-15 02:59:08 274

原创 Neo4j 在教育领域知识图谱的深度实践：从知识点建模到智能学习路径

如何让学习变得更高效、更个性化？在这个探索过程中，我逐渐意识到一个关键洞察：教育的本质是一个关于"关系"的领域。知识点之间存在着千丝万缕的联系——有些知识点是其他知识点的前置条件，有些知识点之间存在包含与被包含的关系，还有些知识点因为过于相似而容易混淆。这些复杂的关系网络，恰恰是关系型数据库和文档数据库难以优雅处理的领域。这正是 Neo4j —— 这一专注于图数据管理的数据库系统——大放异彩的地方。在本文中，我将结合教育领域的真实场景，手把手教你如何利用 Neo4j 构建知识图谱，并将其应用于智能学

2026-03-14 23:51:58 495

空空如也

空空如也