MCP AT SCALE · AGENT GOVERNANCE · CHINESE TOOLING

AI 极客实战教程日报

昨天,中国 AI 开发者和开源社区公开了哪些值得照着做的实战教程——只收录 Tutorial / Build Log / Workflow / 一手资料,不收录新闻。
日报日期
2026-09-29
执行日期
2026-09-30
教程数量
8 篇(未凑数)
期数
第 003 期

🔭 今日 AI 实践观察

三个信号:① MCP 正在从"概念科普"进入"企业工程化"——掘金两篇当日文章分别给出手写禅道 MCP 服务的最小实现,以及带审批、留痕、凭据托管的企业内网 MCP 网关架构,社区开始认真回答"AI 改了内网数据谁负责";② Agent 的"治理"与"记忆"成为热榜主线——阿里 open-code-review、腾讯 WeKnora、Hindsight 等项目都在解决"Agent 产出能不能信、记不记得住",GitHub 官方 gh-aw 把 trajectory graders 作为新版本重点;③ 国产 Coding 工具教程生态成熟到可出"深度使用指南"——TRAE 的规则系统、Bug 修复工作流、OpenSpec 重构四阶段都被沉淀成可复制操作手册。AI 正在从"回答问题"走向"执行任务",而昨天的社区正在补上"执行之后如何被审计、被约束、被复用"这一课。

01

用 Python + FastMCP 给禅道写一个 MCP 服务,让 Agent 替你看 Bug

MCP 实战🔥 值得马上实践🧑‍💻 开发者向🧩 值得迁移2026-09-29 发布
用不到 40 行 Python 手写一个禅道 MCP 服务,接入 Cursor 后对 AI 说一句"帮我看看 Bug #1024",Agent 就能查详情、列清单、改任务状态。

原始资料

教程讲了什么

禅道是国内团队用得最多的缺陷管理系统,但 Coding Agent 天生访问不了它。作者用一个最小例子讲透 MCP 服务本质:MCP 就是一个独立进程,Agent 通过 stdio 发 JSON-RPC 请求,你的服务去调禅道 REST API,把结果格式化成纯文本返回。教程从单个 Tool(zentao_get_bug)跑通,再扩展到列表查询、任务状态更新,最后总结四条 MCP Tool 设计原则:按意图拆分 Tool、docstring 写触发场景、只把真正必填的放 required、返回纯文本不返回 JSON。

技术栈

模型不绑定具体模型,通过 Cursor 等 MCP 客户端调用其内置模型
工具Python、FastMCP(mcp 官方 SDK)、Cursor(MCP Host)
API禅道 REST API(15.0+,需管理员开启)
部署本地 stdio 进程,Cursor 自动拉起

为什么值得收藏

目前少见的"从零到接入 IDE 全链路、代码可直接复制"的中文 MCP 实战教程。最大价值不在代码量,而在四条 Tool 设计原则——这些是决定 Agent 选 Tool 准不准的实战经验,可直接迁移到任何内部系统(Jira、飞书、钉钉、内部 Wiki)。

培训师点评:真正值得教的是四条 Tool 设计原则——它们把"MCP 怎么写"升级为"Agent 怎么用好"。这是把概念课变成工程课的分水岭,建议作为 MCP 系列课程的第一讲。
02

隔离内网下的 AI Agent 工程实战:给所有内网系统统一装上 MCP + 审批 + 留痕

MCP 企业治理📌 值得收藏🏢 企业向🧩 值得迁移2026-09-29 发布
一位一线工程师复盘公司内部落地 internal-mcp 的完整架构:内网系统统一封装 MCP Tools,写操作走人工审批,每次调用留痕——国内少见的"AI 进企业内网"治理方案。

原始资料

  • 原文掘金内网 MCP 网关实战复盘(一线工程师第一手记录)

教程讲了什么

文章给出完整的企业内网 MCP 治理架构:读操作(查 Bug、查日志、查监控)直接放行;写操作(改任务状态、发通知、改配置)必须先生成"待执行单",经人工审批后才真正调用;所有调用落审计日志,含调用者、时间、参数、审批人。凭据统一由网关托管,Agent 不直接接触数据库密码。这是国内少有的把"AI 改了内网数据谁负责"这个问题正面回答的工程方案。

核心设计

  • 读/写分离:读 Tool 直接执行,写 Tool 强制审批。
  • 待执行单模式:Agent 生成 diff/动作描述,人在审批页点确认才落地。
  • 凭据托管:内网系统密钥存网关,Agent 只拿短期 token。
  • 全量留痕:每次调用入审计库,可回溯、可举报。
培训师点评:这是昨天最值得企业培训引用的中文一手材料——它把"Agent 治理"从 PPT 概念落成了可抄的领域模型。教它的重点不是代码,而是"写操作先落待执行单"这个治理思想。
03

Browser Use Cloud v3 BU Agent API 实战:用几行代码把浏览器任务变成"任务进、结果出"

Browser Use🔥 值得马上实践🧑‍💻 开发者向2026-09-29 发布
系统讲解 Browser Use Cloud 实验性 v3 Agent API:认证、SDK、run() 执行模型、16 个 REST 端点(会话/消息/文件/工作区)、成本控制与错误处理,读完就能用代码提交一个浏览器自动化任务。

教程讲了什么

v3 把"本地跑浏览器 Agent"变成了云 API:你 POST 一个自然语言任务,它返回 run_id,异步执行完再回调结果。教程覆盖认证、SDK 初始化、run() 执行模型、16 个 REST 端点(会话/消息/文件/工作区)、成本护栏(max_steps、timeout)、错误重试与资源收尾。特别强调 live_url 参数——提交任务后可以实时看到 Agent 在浏览器里做什么,这是调试 Browser Agent 最快的方式。

踩坑:① 不设 max_steps 容易空转烧钱;② 任务结束务必显式释放工作区,否则云资源持续计费;③ 用 live_url 调试,不要盲调。
培训师点评:值得教的是"成本护栏 + 资源收尾"这套工程习惯,而不只是调 API。教学时务必用 live_url 让学员亲眼看到 Agent 在浏览器里做什么——这是理解 Browser Agent 最快的方式。
04

GitHub Agentic Workflows v0.90.0 发布:用自然语言在 Actions 里编排 Agent,还能给轨迹打分

Agent 工作流📌 值得收藏🏢 工程指标2026-09-29 发布
GitHub 官方 gh-aw 发布 v0.90.0:step summary 显示 friction cost、空任务零积分退出(noop)、五个新轨迹评分器——把"Agent 干活干得值不值"变成了可度量的工程指标。

教程讲了什么

gh-aw(GitHub Agentic Workflows)是 GitHub 官方把 LLM Agent 接进 Actions 的项目。v0.90.0 三个重点:① step summary 里直接显示 friction cost(每一步花了多少 token/钱);② 空任务 noop 零积分退出,Agent 判断没事可做就不烧钱;③ 五个新 trajectory graders(轨迹评分器),从正确性、完整性、安全性、效率、可复现性五个维度给 Agent 的一次执行打分。这意味着"Agent 自动化"第一次有了和 CI 一样可度量的质量门。

培训师点评:这版更新的教学价值在指标思维:任何团队上 Agent 自动化前,先回答"空转成本、总成本、质量分"三个问题——gh-aw 恰好把答案产品化了。
05

Trae 深度使用指南:一个 AI 原生 IDE 的完整工作流(规则、记忆、修 Bug、重构全流程)

AI Coding📌 值得收藏🎓 值得培训🇨🇳 国产工具2026-09-29 发布
字节 Trae 的系统性中文实操手册:从 IDE/SOLO 模式与智能体体系,到规则系统四种生效方式、把报错喂给 AI 的 Bug 修复流、"上帝对象"重构三步法,新手照着走完两周即可形成完整工作流。

教程讲了什么

教程分四块:① 模式与智能体体系(IDE 模式 vs SOLO 模式、内置 Agent 分工);② 规则系统四种生效方式(项目级 .trae/rules、用户级、目录级、文件级)——这是把个人经验变成团队资产的关键;③ Bug 修复工作流:把完整报错栈、相关文件、复现步骤一起喂给 AI,不要只贴一句话;④ OpenSpec 重构四阶段:用"上帝对象"案例演示如何让 AI 分阶段拆解大文件。附结构化指令四要素模板(角色+任务+上下文+输出格式)。

培训师点评:教这个案例的重心应是"规则系统"——它把个人经验变成团队资产。结构化指令四要素模板可作为全场唯一必背内容,其余按需查手册。
06

阿里开源 open-code-review:规则流水线 + Agent 的代码审查 CLI,一周涨星 3700+

开源代码审查🔥 热榜🇨🇳 国产开源🔓 开源项目本周 GitHub 热榜
阿里巴巴开源的代码审查工具:把"规则流水线"与"Agent 审查"结合成 CLI,正在解决"AI 产出能不能信"的问题——本周 GitHub 热榜新增 3,727 Star,总量 41,943。

教程讲了什么

核心思想是分层:确定性的事(语法、lint、安全规则、类型检查)走规则流水线,又快又准;模糊的事(架构合理性、命名一致性、是否符合业务语义)交给 Agent 审查。两层结果合并成一份审查报告。这种"规则管硬、Agent 管软"的分层,比纯 LLM 审查便宜一个数量级,也比纯 lint 多覆盖了语义问题。

⚠️ 真实性说明:本案例架构描述基于榜单定位与项目公开信息,上手步骤以官方 README 为准。

培训师点评:值得教的是"分层"思想:确定性的事给规则,模糊的事给 Agent。这一决策框架适用于一切 AI 质检场景,比学会某个具体工具更有长期价值。
07

Datawhale 开源新课《Deep Agents 实战》:16 章从第一个 Agent 讲到生产级 Harness

Agent 课程🎓 值得培训🇨🇳 国产教程🔓 开源项目2026-09-29 上线
Datawhale 围绕 LangChain Deep Agents 框架的 16 章中文开源课程:虚拟文件系统、任务规划、子 Agent 隔离、沙箱、HITL、MCP 全覆盖,配可运行实验模板,不写玩具 Demo。

教程讲了什么

课程分核心篇与进阶篇:核心篇讲 Agent 基础、工具调用、虚拟文件系统、任务规划;进阶篇讲子 Agent 隔离、沙箱执行、Human-in-the-loop 中断恢复、MCP 接入。每章配可运行 Jupyter 模板,默认用国产开源模型跑。Datawhale 系教程一贯风格:章节即大纲、模板即实验环境,培训师可直接裁剪成 Workshop。

培训师点评:这是目前最适合做体系化培训的中文 Agent 开源教材——章节即大纲、模板即实验环境。培训师可直接按"核心篇 3 章 + 进阶篇 3 章"裁剪出一个完整 Workshop,不必自己造轮子。
08

腾讯开源 WeKnora 登热榜:RAG + 推理 Agent + 自维护 Wiki 的知识库方案,一周涨星 2700+

RAG / 知识库🔥 热榜🇨🇳 国产开源🔓 开源项目本周 GitHub 热榜
腾讯开源的企业知识库项目 WeKnora:不止做 RAG 检索问答,还带推理 Agent 与"自维护 Wiki"——知识库可以随着问答沉淀自我更新,本周 GitHub 热榜新增 2,705 Star,总量 30,621。

教程讲了什么

WeKnora 的差异化在"自维护":传统知识库是项目制——一次性灌入文档就不再动;WeKnora 让 Agent 在回答用户问题时,自动把新产生的知识(FAQ、踩坑、新结论)沉淀回 Wiki,并经人工审核后入库。知识库从"静态文档"变成"随问答生长的运营资产"。核心风险也在这里:自动沉淀如果没有审核流,就是自动污染。

⚠️ 真实性说明:能力描述基于榜单复盘与项目公开定位,"自维护 Wiki"具体机制与效果请以官方文档与实测为准。

培训师点评:教学的锚点应是"自维护"三个字——把知识库从项目制变成运营制。务必让学员现场设计审核流程,否则自动沉淀就是自动污染。

📈 今日 AI 实战技术观察

① MCP 进入企业工程化阶段。上一期还在讲"怎么写第一个 MCP Server",这一期直接跳到"企业内网 MCP 网关怎么审批、怎么留痕、怎么托管凭据"。MCP 的叙事重心已从"连接工具"转向"治理工具"——谁有权调、调了什么、谁批准的,成为新的工程命题。

② Agent 治理三件套:审计、评分、记忆。gh-aw 的 trajectory graders 回答"Agent 干得好不好",open-code-review 回答"Agent 产出可不可信",WeKnora 回答"Agent 记不记得住"。三者合起来,就是 Agent 从 Demo 走向生产的完整质量门。

③ 国产工具教程生态成熟。Trae 出深度使用指南、Datawhale 出 16 章系统课、阿里腾讯出开源项目——中国 AI 开发者已经不只是"用海外工具",而是在沉淀自己的工具链方法论。这是生态成熟的标志。