「桥诊」诞生记:8 篇文章,从传统软件到 Hermes 原生智能体

用一座桥的故事，讲清楚 AI 智能体到底是什么

PART 01

一个场景

下午五点，桥梁检测员老张回到办公室，相机里 50 张照片。

今天检了一座 7 跨预应力 T 梁桥。第三跨主梁底板有纵向裂缝，最长那条 2 米 2、宽 0.18 毫米。第五跨腹板有竖向裂缝。箱室内顶板一大片渗水，大概一平米。墩顶支座垫石下方混凝土剥落。还有个支座橡胶老化了。

老张打开电脑：

新建 Excel → 填桥梁信息 → 填病害表 → 编号 → 填长宽 → 填位置
打开 CAD → 画裂缝展布图 → 标尺寸 → 标图例
打开 Word → 贴表 → 贴图 → 写描述 → 调格式

三小时。每一步都是重复的机械劳动。他心想：这软件就不能自己干吗？

PART 02

一个问题

传统软件帮他了吗？帮了，也没帮。

帮他的是：不用手画表格了，不用手写编号了。没帮的是：他还是得一项一项填、一个一个点、一步一步等。软件不会思考——你告诉它"主梁裂了"，它不认识"主梁"是什么。你告诉它"大概 2 米 2"，它说请输入数字。

软件执行的是你写死的指令，不是你的意图。

PART 03

一个想法

如果有一个"东西"，你跟它说人话：

"第三跨主梁底板有纵向裂缝，最长那条大概 2 米 2、宽 0.18"

它就能自己理解这是桥梁检测场景，自己判断信息够不够，自己决定下一步该干什么——追问、录入、出表、画图、告诉你结果。

这就是 AI 智能体。

PART 04

一条路线

下面 7 篇文章，我用「桥诊」这个真实案例，手把手带你走一遍"传统软件 → Hermes 原生智能体"的完整路线。

第 1 篇 ── 为什么传统软件让人越用越烦？↓第 2 篇 ── 传统软件 vs 原生智能体，到底差在哪↓第 3 篇 ── 动手搭第一个智能体「桥诊」↓第 4 篇 ── 给智能体造「手脚」——工具箱炼成记↓第 5 篇 ── 关键一跃：拆、包、接、教四步法↓第 6 篇 ── 从「桥诊_tool.py」看 Hermes 工具工作原理↓第 7 篇 ── 从「桥诊」到你的第一个 Hermes 智能体

每篇讲什么

篇	角度	你读完能回答的问题
1	痛点诊断	我的软件为什么越来越不够用？
2	认知刷新	智能体到底比传统软件多出了什么？
3	项目启动	从一个场景到一套代码框架，怎么起步？
4	代码阶段	给 LLM 造工具，代码长什么样？
5	改造方法论	怎么把我的旧代码变成 LLM 能调用的工具？
6	技术解剖	JSON-in/JSON-out、terminal 与原生 Tool 怎么选？
7	总结展望	这个方法论能复制到哪些场景？

贯穿始终的实战案例：桥诊

项目	值
名称	桥诊（QiaoZhen）
场景	桥梁裂缝检测——拍照/描述→自动生成病害表+展布图
框架	Hermes Agent（Nous Research 开源）
真实数据	机荷高速、耒水河大桥、株洲湘江大桥

每一篇都有模拟代码、输出文件、完整的对话示例。

PART 05

一个承诺

读完这 7 篇，你能把自己手头的任何一个传统软件——不管它有多老、多破、多耦合——按照拆、包、接、教四步法，改造成 Hermes 能调用的 AI 智能体。

而你只需要会三件事：

能写 Python
能装一个开源软件（Hermes）
能把你的业务逻辑描述清楚

下一篇：我们先用一个最真实的场景，把传统软件的问题扒开看看。