今年下半年-优快云博客

原创 AI智能体项目实战记录（37）：智能体动态绑定模型——一张配置表切换主管与子智能体的模型

本文实现智能体模型动态绑定，通过新增ai_base_model与ai_child_model两张表，将模型配置从代码中解耦。支持主管与子智能体按逻辑键独立绑定不同模型，运行时按“绑定→默认→环境变量”三级回退，实现多模型共存、本地模型接入与热切换。结合缓存机制，确保性能与灵活性，日志可追踪每轮调用的模型来源，显著提升系统可维护性与扩展性。

2026-11-09 17:32:44 71

原创 AI智能体项目实战记录（36）：从通用智能体到智行助手——子智能体、技能、专家与 MCP 的组合实践

本文实践了从通用智能体向“智行助手”场景化落地的转型，通过6个子智能体、6项技能、3位专家与高德地图MCP连接器的协同，构建低成本、可扩展的出行规划系统。核心设计遵循“能力最小单元化”原则，统一工具接口规范，实现参数清晰、失败可定位、可独立熔断；重点优化了假期连续性合并、补班识别、时区处理等细节，提升输出准确性与用户体验。整体架构支持低改造成本新增功能，验证了智能体组合在真实场景中的可行性与实用性。

2026-11-06 16:27:30 295

原创 AI智能体项目实战记录（35）：技能-专家-连接器的配置与应用

本文介绍了AI智能体项目中“技能-专家-连接器”三层配置体系的构建与应用。通过技能定义流程模板、专家设定角色规则与技能组合、连接器注册外部工具，实现能力解耦与有序调用。三者协同为主管智能体提供上下文约束，最终由主管统一规划执行路径。数据库设计支持多租户、版本管理与密钥隔离，兼顾灵活性与安全性。连接器作为代理接入，不参与决策，确保系统可控性。该架构有效应对能力爆炸式增长带来的管理难题，提升复杂任务处理效率。

2026-11-05 15:23:56 504

原创 AI智能体项目实战记录（34）：对话添加文件上传功能

本文实现智能体文件上传功能的升级：短文档（≤3000字）直注式处理，长文档采用RAG检索，结合Redis缓存元数据与本地/对象存储保存原文，通过切片、Embedding、Milvus向量库与Cross-Encoder重排实现精准溯源。全程不污染会话历史，支持多Worker、断线续传，兼顾性能与安全，解决旧版截断、重复消耗、无引用等痛点。

2026-11-05 11:50:21 441

原创 AI智能体项目实战记录（33）：无 GPU 环境下用 Docker 部署微调模型到 CentOS

在无GPU的CentOS 7上，通过Docker+FastAPI部署LoRA微调模型，实现OpenAI兼容接口。使用python:3.11-slim镜像打包运行环境，上传合并后的wm_merged模型，编写服务脚本加载模型并提供推理服务。经测试，固定话术命中率稳定，单条延迟约2.5秒（CPU推理），适合低资源场景下的轻量级服务部署。

2026-11-04 11:39:48 359

原创 AI智能体项目实战记录（32）：大模型微调——让每句回答都带固定话术的水印注入

本文通过LoRA微调0.6B模型，实现“无论提问内容如何，回答结尾必带固定话术”的功能。核心方法是构建包含技术问答与通用闲聊的训练数据，统一在答案末尾拼接水印句。实验表明，微调后模型在12个未见问题中83%命中固定话术，验证了行为泛化能力。该技术适用于输出一致性控制、私有化部署等场景，强调微调应聚焦于行为塑造而非知识注入，实践顺序为：prompt优化 → 后处理 → 微调。

2026-11-04 09:18:52 277

原创 AI智能体项目实战记录（31）：大模型微调初体验——用 LoRA 让 0.6B 模型抽取结构化数据

本文记录了在纯CPU环境下，使用LoRA微调Qwen3-0.6B模型实现技术文档结构化抽取的全流程：通过规则生成标注数据、按标题切片并处理代码块、划分训练/测试集，完成低资源下的轻量微调。项目验证了从数据构建、训练、推理到合并导出的完整链路，虽仅达基础效果，但成功打通了“改权重”而非“写提示词”的微调路径，为后续大模型适配提供可复用范式。

2026-11-03 15:00:05 130

原创 AI智能体项目实战记录（30）：token 消耗统计，并在每轮对话结束后展示给用户

本文修复了AI智能体项目中token统计的六大核心问题，实现每轮对话后向用户展示精确用量。通过引入contextvar确保异步与多线程环境下的上下文传递，采用“双写”机制（父级累加+作用域明细）保证总量与拆分数据一致，并解决并行工具记账丢失、CHILD_AGENT_ID_为空等关键bug。最终在finalize_run阶段返回完整用量信息，经前端渲染后以气泡或尾部提示形式呈现，实现“先落库、后推送”的可靠链路，支持按用户/天聚合统计，提升透明度与可追溯性。

2026-10-30 09:43:52 709

原创 AI智能体项目实战记录（29）：RAG 知识库优化（下）——用 Cross-Encoder 重排提升召回精度

本文实现RAG知识库的跨编码器（Cross-Encoder）重排优化，解决向量检索“只准不精”问题。通过双阶段流程：先扩大召回池（5→15），再用联合编码模型对查询与文档片段进行语义交互打分，提升相关性排序精度。支持开关控制、模型缺失自动降级，保障链路稳定性。实测表明，该方案有效缓解同义词漏检、长文本稀释、答非所问等问题，显著提升问答质量。

2026-10-30 08:00:00 539 1

原创 AI智能体项目实战记录（28）：RAG 知识库优化（中）——检索过滤、库路由与空结果兜底

本文聚焦RAG知识库优化中的检索过滤、库路由与空结果兜底。通过收敛检索入口，实现权限校验、kb_id过滤检索及旧集合降级；引入kb_codes参数支持多库指定，结合提示词注入可用库清单，使模型可自主选库；并设计空结果兜底机制，当指定库无结果时自动扩展至全部可见库重试，显著提升召回率与用户体验。最终实现安全、精准、鲁棒的智能检索闭环。

2026-10-29 10:35:07 194

原创 AI智能体项目实战记录（27）：RAG 知识库优化（上）——按业务拆分知识库：元数据建模与上传改造

本文记录RAG知识库优化第一阶段：通过建立ai_knowledge_base主数据表，实现知识库元数据管理。针对原有单集合全量存储导致检索无范围、运维困难等问题，引入kb_id字段实现文档按业务分库，支持上传时选择目标库、切片写入带kb_id。方案选型采用“一集合+标量字段”模式，兼顾灵活性与可演进性，避免集合爆炸。同步完成建表、种子数据初始化及列表/新建接口，为后续检索过滤、库路由与溯源奠定基础。

2026-10-29 09:51:01 357

原创 AI智能体项目实战记录（26）：智能体异常处理、工具重试与熔断

本文针对AI智能体项目中工具调用的稳定性问题，系统性地解决了四大缺陷：无全局异常处理、工具失败不重试、失败结果被误当正常输出、缺乏熔断机制。通过引入结构化异常捕获、幂等性重试策略（仅对只读接口）、熔断保护及统一错误响应格式，实现故障自动恢复与降级，显著提升系统鲁棒性。改造后，异常统一返回标准JSON，网络抖动自动指数退避重试2次，持续失败触发30秒熔断，避免雪崩。代码已模块化封装，可复用于其他服务。

2026-10-28 09:51:51 374

原创 AI智能体项目实战记录（25）：智能体添加限流，MCP Server 添加限流与鉴权

本文记录智能体项目限流与鉴权实战，针对成本失控、资源打满等风险，实现用户级并发限制（≤3）、每日token配额（20万）、API Key鉴权、MCP并发熔断（≤3）及每日额度控制。通过Redis原子计数+降级机制保障稳定性，双套配额互不干扰，确保服务在高负载下仍可安全运行。

2026-10-27 10:57:24 344 1

原创 AI智能体项目实战记录（24）：MCP 使用教程之把 MCP Server 接入 WorkBuddy 桌面 AI 工作台

本文演示如何将MCP Server接入WorkBuddy桌面AI工作台，实现知识库检索能力的跨平台复用。通过启动SSE模式的MCP Server，验证连通性后，在WorkBuddy中配置自定义连接器，即可在对话中调用search_knowledge_base工具。整个过程无需修改服务端代码，体现MCP协议的通用性与可扩展性，为团队共享智能体能力提供标准化路径。

2026-10-27 09:48:49 380

原创 AI智能体项目实战记录（23）：MCP 使用教程之创建 MCP Server，把知识库调用暴露成 MCP Tool

本文介绍如何将知识库检索能力 search_knowledge_base 暴露为 MCP Server，支持 stdio 与 SSE 两种传输方式。通过 FastMCP 构建服务，延迟加载模型并使用异步线程避免阻塞，确保工具调用高效稳定。配置安全边界，建议本地或网关防护，适用于 IDE、Claude Desktop 等客户端接入，实现跨系统知识调用。

2026-10-26 17:06:17 738

原创 AI智能体项目实战记录（22）：MCP 使用教程之 MCP 工具动态注册到 LangGraph 主管智能体

本文实现MCP工具动态注册至LangGraph主管智能体：通过_ensure_mcp_tools()懒加载，自动发现并注册远程/本地MCP工具，统一包装为MCPTool与MCPWorkspaceFileTool，注入_TOOL_INSTANCES、ALL_TOOLS和TOOL_MAP。主管节点调用前触发注册，支持read_text_file等工具透传参数，完成“读取工作目录文档”与“查询GitHub文档”链路闭环。

2026-10-25 09:52:57 475

原创 AI智能体项目实战记录（21）：MCP 使用教程之创建 MCP 客户端

本文介绍MCP客户端的两种实现方式：stdio（本地子进程）与Streamable HTTP（远程服务）。通过mcp==1.4.1和httpx构建兼容性良好的客户端，解决Windows下事件循环冲突问题，支持工具列表查询与调用。配置灵活，适配本地沙箱与远程MCP Server，为后续智能体动态注册奠定基础。

2026-10-25 08:00:00 806

原创 AI智能体项目实战记录（20）：项目鉴权优化：依赖注入 + Redis 登录态缓存

本文优化AI智能体项目鉴权链路：通过依赖注入与Redis缓存登录态，实现“一次查库、多次复用”。改造后，受保护接口不再重复解析Token或查询sys_user，正常请求数据库查询降为0。采用JWT+Redis方案，登录时写缓存，鉴权优先读Redis，缺失则回源查库并补缓存，支持退出登录即时踢下线。FastAPI使用Depends实现类似注解的统一鉴权，兼顾灵活性与性能，显著提升高并发下的系统稳定性。

2026-10-24 08:30:00 316

原创 AI智能体项目实战记录（19）：用户登录鉴权与调用日志切换到 PostgreSQL 实现

本文记录了将用户登录鉴权与调用日志从MySQL迁移至PostgreSQL的实战过程。为避免中间状态，同步迁移sys_user、ai_child_agent、ai_invoke_log、ai_tool_invoke_log四张表，统一通过db_service按DB_BACKEND切换数据库。重点解决大小写敏感问题，采用citext扩展保持用户名一致性；使用TIMESTAMP类型对齐时间字段；并通过索引优化查询性能。改造后实现一套连接池、一个开关控制，确保鉴权与日志数据一致落地，支持平滑切换与回滚验证。

2026-10-24 08:00:00 208

原创 AI智能体项目实战记录（18）：LangGraph 记忆、会话历史持久化之 LangGraph 适配 PostgreSQL

本文将LangGraph的检查点与会话历史持久化从SQLite迁移至PostgreSQL，通过配置CHECKPOINT_BACKEND和CONVERSATION_BACKEND实现三类后端（sqlite/postgres/memory）动态切换。改造仅涉及依赖、配置与初始化逻辑，保持图结构不变。采用psycopg3+连接池提升生产可用性，支持多实例部署；失败时立即抛异常，避免静默降级导致数据不一致。关键设计包括惰性初始化、进程内单例、安全连接串生成及回退策略，确保开发、测试与生产环境无缝适配。

2026-10-23 08:15:00 365

原创 AI智能体项目实战记录（17）：LangGraph 记忆、会话历史持久化之 PostgreSQL 选型说明及简单安装

本文记录了AI智能体项目中将LangGraph记忆与会话历史从SQLite迁移至PostgreSQL的选型与安装过程。针对多实例部署下记忆分裂、写锁竞争及备份困难等问题，选择官方支持的AsyncPostgresSaver，实现高并发、可靠持久化。通过docker-compose快速搭建PG环境，配置关键参数优化小内存场景性能，并强调生产环境下需加强安全与资源管理。最终目标是统一数据存储，提升系统可维护性与扩展性。

2026-10-23 08:00:00 399 1

原创 AI智能体项目实战记录（16）：进阶学习 —— 添加语音识别功能，实现快速提问

本项目为私有化部署的问答系统添加本地语音识别功能，选用 SenseVoiceSmall + sherpa-onnx 方案实现离线、安全、多语言（中/英/日/韩/粤）语音转文字。通过浏览器 MediaRecorder 录音，经 PyAV 解码为 16kHz 单声道 float32 PCM，由本地模型实时识别并输出带标点文本，自动填入输入框发送。依赖延迟加载，确保服务启动稳定；配置基于 .env 和相对路径，支持灵活部署。完整链路从录音到提问仅需数秒，显著提升移动端与场景化交互效率。

2026-10-22 08:15:00 577

原创 AI智能体项目实战记录（15）：日志记录 —— 在主管与子图添加日志切面，实现智能体调用记录查询、链路追踪及 token 统计

本文实现智能体调用日志系统，通过三层记录模型（请求层、子智能体层、工具明细层）与contextvar上下文管理，统一追踪用户请求的完整调用链。基于TASK_BATCH_ID串联日志，支持跨线程、跨子图的埋点记录，实现调用耗时、token统计、失败分析及敏感参数脱敏。优先使用模型返回的usage，缺失时按2字符/token估算，确保日志可查、可统计、不影响主流程。

2026-10-22 08:00:00 165

原创 AI智能体项目实战记录（14）：skill 技能接入，前端选择技能精确查询、快速响应

本文提出“技能（Skill）”机制，将用户明确意图前置，通过前端选择技能名（如rag、web-search），后端读取SKILL.md解析任务编排，强制主管按预设流程执行，避免多轮决策。相比自动模式，技能模式提升响应速度与稳定性，适用于意图清晰的场景。系统设计了Skill/SkillTask数据模型，支持文件与数据库双存储，实现可扩展的技能管理架构。

2026-10-21 08:30:00 404

原创 AI智能体项目实战记录（13）：LangGraph 子图模式 —— 把「有固定依赖顺序」的流程一次编译执行

本文介绍LangGraph子图模式在企业尽调场景中的应用：将固定依赖链流程（如查信用代码→工商信息→经营分析）封装为独立子图，实现一次编译执行。相比扁平化模式，子图模式减少LLM决策次数、避免提示词膨胀、提升顺序可靠性与可测试性。通过状态传递（如credit_code接力）、条件边路由与operator.add累积执行轨迹，确保流程严谨可复用。主管图仅负责调用时机，子图专注执行顺序，实现“职责分离”，适用于多步骤业务办理场景。

2026-10-21 08:00:00 363

原创 AI智能体项目实战记录（12）：LangGraph扁平化构图（决策 → 调工具 → 总结）

本文基于FastAPI多路由架构，引入LangGraph实现扁平化主管智能体，集成日历查询、互联网搜索与知识库检索（RAG）三大工具。通过构建单一主管智能体编排决策、调用与总结流程，实现“意图识别→工具调用→结果汇总”闭环。采用异步持久化会话状态，控制最大迭代次数防循环，并优化提示词以降低主管负担。后续将扩展子图机制支持复杂逻辑分支与独立统计。

2026-10-20 09:00:00 391

原创 AI智能体项目实战记录（11）：FastAPI 项目路由拆分「主入口 + 多个路由模块」

本文基于FastAPI实现类似Spring Boot的模块化路由设计，将AI问答助手项目拆分为chat、file、article等独立路由模块，通过APIRouter与include_router统一注册，实现接口分层管理。主入口main.py仅负责服务启动与路由装配，代码结构清晰、职责分明，便于后续扩展与维护。

2026-10-20 08:00:00 421

原创 AI智能体项目实战记录（10）：增加接口鉴权处理

本文实现接口安全鉴权：集成图形验证码（Redis缓存）、用户名密码登录（MySQL+BCrypt）、JWT签发与校验，统一保护流式接口。通过生成验证码、校验登录凭证并签发令牌，确保请求合法性，提升系统安全性。

2026-10-19 10:40:41 304

原创 AI智能体项目实战记录（09）：接口返回流式输出

本文改造RAG问答接口，实现流式输出功能。通过引入sse-starlette库，新增stream参数控制输出模式：stream=True时，使用EventSourceResponse实时推送大模型生成的文本片段，前端可逐字显示；stream=False时保持原有JSON返回。核心改造包括开启大模型流式生成、封装异步生成器，并通过SSE协议传输事件。最终实现类似ChatGPT的流畅交互体验，兼顾向后兼容性。

2026-10-19 08:46:24 285

原创 AI智能体项目实战记录（08）：RAG项目实战之向量知识库问答

本文实现RAG问答系统核心链路：问题向量化→向量检索→构建上下文→生成提示词→调用大模型生成回答，并基于FastAPI封装为可远程调用的HTTP接口。通过复用本地或远程嵌入服务，结合Milvus向量库检索相关文档，构造结构化提示词引导大模型精准作答，支持多语言、结构化输出与来源引用，提升回答准确性与可读性。

2026-10-18 10:00:00 479

原创 AI智能体项目实战记录（07）：RAG项目实战之文档内容向量化入库

本文为RAG项目第七篇，聚焦文档向量化入库流程：在解析文档后，按配置切割文本（chunk_size=500，overlap=50），使用RecursiveCharacterTextSplitter保持语义完整；调用本地BGE向量模型生成嵌入向量，最终批量写入Milvus向量数据库，构建可支持语义检索的知识库基础。

2026-10-18 09:00:00 295

原创 AI智能体项目实战记录（06）：RAG项目实战之文件上传及文档读取解析

本文实现RAG项目中文件上传与文档解析功能，支持md/txt/pdf/doc/docx五种格式。通过pymupdf、python-docx等库统一解析为纯文本，并按配置切分为文本块，为后续向量化入库做准备。接口基于FastAPI构建，具备类型校验与异常处理，确保数据完整性与可扩展性。

2026-10-17 10:30:00 249

原创 AI智能体项目实战记录（05）：RAG项目实战之向量知识库milvus部署

本文详细记录了基于 Docker Compose 的 Milvus 2.5 向量数据库部署流程，包含 etcd、MinIO 与 Milvus Standalone 三组件的编排配置。通过 docker compose up -d 启动服务后，使用 Attu 可视化工具验证连接，成功实现向量知识库的搭建。文中还提供了常见问题排查方案，为 RAG 项目中的向量存储与检索奠定了基础。

2026-10-17 09:00:00 365

原创 AI智能体项目实战记录（04）：RAG项目实战之RAG简介及向量化模型下载

RAG（检索增强生成）通过结合外部知识库的检索与大模型的生成能力，有效解决大模型的幻觉、知识滞后、可追溯性差等问题，提升回答准确性与时效性。其流程包括文本加载、分割、向量化及语义匹配，最终将相关上下文融入prompt生成答案。配合ModelScope可便捷下载中文向量模型如nlp_corom_sentence-embedding_chinese-base，实现高效本地部署。

2026-10-16 10:30:00 178

原创 AI智能体项目实战记录（03）：本地模型调用及 DeepSeek API 调用

本文实现AI智能体的问答能力，通过.env统一管理密钥与地址，使用Pydantic加载配置，封装DeepSeek与本地大模型客户端，并基于FastAPI提供/chat接口。支持同步/异步调用，灵活切换模型，为后续接入LangGraph多智能体与RAG检索奠定基础。

2026-10-16 09:30:00 309 1

原创 AI智能体项目实战记录（02）：初始化 Python 项目

本文详细记录了AI智能体项目的初始化过程：基于Conda创建Python 3.10虚拟环境，安装FastAPI、LangChain、OpenAI等核心依赖，配置IntelliJ IDEA开发环境，并成功运行Hello World应用。通过Uvicorn启动服务，验证了项目可访问性与Swagger文档自动生成功能，为后续大模型接口封装奠定基础。

2026-10-15 09:47:05 596

原创 AI智能体项目实战记录（01）：开发环境搭建之conda的安装与配置

conda 是强大的开源包与环境管理系统，支持跨平台、多版本 Python 管理及非 Python 依赖，有效解决项目间环境冲突与依赖地狱问题。相比 pip + virtualenv，其原生环境隔离、智能依赖解析和科学计算生态支持更优。通过创建独立环境、配置国内镜像源、结合 pip 扩展安装，可实现高效、一致的开发体验，尤其适合数据科学与机器学习场景。

2026-10-15 08:50:33 351

原创【前端】Vue2 项目 ECharts 统计图表组件封装与使用实践（附组件源码）

本文介绍在Vue2项目中基于ECharts 5.1.1封装可复用统计图表组件的实践。通过将数据请求与图表展示解耦，实现柱状图、折线图、饼图、雷达图、地图等9类图表组件化，统一遵循data结构、width/height、unit、colorList等契约。组件局部引入，依赖watch: { data: { deep: true } }实现数据更新重绘，并支持自适应。关键点包括渐变填充、图例联动、双轴组合及防重复绑定resize事件，提升代码复用性与维护性。

2026-10-15 08:15:00 344

原创【微前端】Vue2 项目整合 Wujie 微前端实践文档

本文介绍在Vue2项目中整合腾讯开源微前端框架Wujie的实践方案。相比传统iframe，Wujie通过Web Components实现DOM/CSS隔离，结合iframe沙箱保障JS安全，支持页面融合、路由同步与便捷通信。基座应用需安装wujie-vue2，注册全局事件总线，并通过setupApp预注册子应用及生命周期钩子，配合preloadApp实现资源预加载。子应用需适配__WUJIE_MOUNT等接口，且具备降级为iframe的能力，兼顾新老浏览器兼容性。整体方案提升融合体验，降低资源开销。

2026-10-11 09:00:00 488

空空如也

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

TA关注的人

windows虚拟机安装arm系统所需资源

智能问答平台前端项目源码

SNMPTester.rar

单点登录cas服务器demo及springboot客户端demo

es_head-0.1.5.zip

Spring boot +dubbo+zookeeper +Mybatis基础框架

zookeeper+dubbo-admin.zip

空空如也