跳转至

Demos:仓库内可运行的代码与 Notebook

本仓库是知识库,但散落着 12 处可运行的代码——它们是各篇文章观点的「可运行证据」。本页是唯一的总索引:每项标注依赖要求、对应文章与验证状态。使用前请先读验证状态说明。

维护约定:新增 demo 时在本页登记一行;验证过就在「验证状态」列更新日期。发现跑不通,欢迎提 issue 或 PR。

一、AI Agent 与 MCP

Demo 主题 依赖 对应文章 验证状态
08_agentic_system/mcp/mcp_demo MCP 客户端/服务端三模式(stdio/SSE/Streamable HTTP)+ Parallel 免匿名网页搜索 CLI Python 3.11+,mcp、httpx(独立 venv) 目录 README 自含教程 ✅ 2026-10-12(7/7 测试 + 真实端点调用)
08_agentic_system/multi_agent/multi_agent_system 多 Agent 系统(分组对话、监控、工作流) Python + requirements.txt,支持 docker-compose Multi-Agent 课程 §2/§4/§5 ✅ 2026-10-12 修复后实测 24/24 通过。修复内容:requirements 两处依赖冲突(langchain-langgraph、pytest-pytest-asyncio,已升至最新兼容组合);MessageQueue.put 自锁死锁(Condition 复用 _lock 不可重入);订阅回调从未被调用的死代码补全;测试重写对齐真实 API(初版 27 个测试按未落地的 API 设计稿编写,提交时即全部失败)
08_agentic_system/agent_design/coref-dialogue-system 指代消解对话系统(实体识别、状态管理、多模态指代) Python + requirements.txt 指代消解与对话系统设计 ✅ 2026-10-12 实测(tests/run_tests.py 4/4 通过,含性能测试 93s)
08_agentic_system/memory/langchain/code LangChain 记忆机制(基础示例 + LangGraph 记忆) Python + requirements.txt + LLM API key(config.example.py) LangChain 记忆机制 ✅ 2026-10-12 实测(24/24 单文件测试过;注:unittest discover 全量模式与测试 patch 写法不兼容会报 12 errors,请按单文件跑)

二、推理与显存规划

Demo 主题 依赖 对应文章 验证状态
09_inference_system/memory_calc 模型显存与 KV Cache 计算器(Qwen3/DeepSeek-V4,含 GQA 分析) 纯 Python 标准库,无三方依赖 KV Cache 原理 · B300 部署与 KV Cache ✅ 2026-10-11(纯标准库直跑)

三、RAG 与知识图谱

Demo 主题 依赖 对应文章 验证状态
07_rag_and_tools/synergized_llms_kgs/demo LLM × 知识图谱协同(ETL 管道、Agent、API,docker-compose 编排) Python + requirements.txt + docker-compose(Neo4j) Neo4j 实战指南 ✅ 2026-10-12 实测(依赖可装 + api/agent import ✓ + compose 语法 ✓;未起 Neo4j 全栈实测。运行:在 synergized_llms_kgs/ 目录下以 PYTHONPATH=. 跑)
07_rag_and_tools/rag_basics/notebooks RAG 基础教程 Notebook Python + notebook 内声明的依赖 目录内教程 ⚠️ 2026-05-15

四、训练与微调

Demo 主题 依赖 对应文章 验证状态
05_model_training_and_fine_tuning/sft_example 垂域模型 SFT 微调(Qwen2)Notebook Python + GPU + notebook 内依赖 一文入门垂域模型 SFT 微调 ⚠️ 2026-05-15
98_llm_programming/langgraph LangGraph 入门 Notebook Python + notebook 内依赖 LangGraph 介绍 ⚠️ 2026-03-23

五、GPU 编程(CUDA)

Demo 主题 依赖 对应文章 验证状态
02_gpu_programming/02_cuda/code CUDA 基础系列(NUMA、Stream 并发、Graphs、Tensor Core GEMM、Bank Conflict 等 8+ 个 .cu 基准) nvcc + NVIDIA GPU 目录 README 自含编译运行说明 ✅ 入库前已在真实 GPU 环境验证
02_gpu_programming/04_profiling/code PCIe/HBM 带宽与传输效率基准 nvcc + NVIDIA GPU NCCL 基准系列 引用 ✅ 入库前已在真实 GPU 环境验证

六、昇腾教程配套脚本

02_npu_programming 的编号教程(01 环境 → 14 量化)各配 Python 脚本,另有 07_rag_on_npu 的 RAG on NPU 示例(4 py)。依赖 MindSpore/CANN 等昇腾软件栈。| ✅ 入库前已验证 · 教程随系列文章维护

验证状态说明

  • ✅ = 已验证可运行:标注复跑日期的为本轮在维护者机器上实测,标注「入库前已验证」的为入库时的真实验证;
  • ⚠️ = 入库前已验证、入库后未再复跑,最后提交日期仅供参考——遇到依赖漂移请以目录内 README 为准,或提 issue;