想改一下小球的速度，却要等三分钟重新编译整个 C++ 工程——这是自己拿 C++ 写游戏时最劝退的一件事。这篇借一个真实的 SDL 打砖块项目（eliasdaler/sdl_breakout）讲清楚一种分层写法：C++ 只当"引擎"，负责窗口、渲染、音频、输入这些慢变的底层；游戏玩法整个搬到 Lua，改了存盘就生效。文章拆解 sol2 怎么把 C++ 的类和函数暴露给 Lua、GC 怎么接管 SDL 资源，最后附上我把它移植到 macOS 时踩的三个坑和改法。代码引用来自该项目 master 分支，移植改动在 macOS + Apple clang 上实测。

Lua 自己什么都不会——不会发网络请求，不会读数据库，连打开一个文件都得靠宿主给的库。它小得可怜，却长在魔兽世界、Nginx、Redis、FreeSWITCH 这些庞然大物里，靠的就是一件事：跟 C 无缝对接，借用整个 C/C++ 生态。这篇讲清楚 C 和 Lua 到底是怎么绑在一起的——从那个来回倒数据的栈，到注册 C 函数、包装 C 对象，再落到两种真实风格：FreeSWITCH 用 SWIG 预生成胶水，OpenResty 用 LuaJIT FFI 干脆不写胶水。代码引用来自 FreeSWITCH master 分支与 LuaJIT 官方文档。

AI 语音客服 demo 能跑,离敢上生产还隔着两道坎。一是延迟:用户对电话里的沉默极其敏感,超过一秒就觉得"卡了",得盯"首响应"而不是"总时长",靠流式和流水线把它压进一秒。二是可信度:LLM 会用完全自信的语气编造一个不存在的优惠、报错一个余额数字,在客服场景就是事故,得靠 RAG、工具调用、护栏这五道防线给它套缰绳。而且这两件事经常打架,工程上只有按场景权衡,没有免费的午餐。

FreeSWITCH + UniMRCP + LLM 的分工和架构有了,落到代码,XML dialplan 表达不了"调 HTTP、维护多轮上下文、按 LLM 结果分支"这种逻辑,得用 Lua。这里有一份能读懂的完整 voice_agent.lua 骨架——从接通、放欢迎语、开麦识别、调 LLM 网关、合成回复,到打断、超时、转人工、挂断的完整对话循环,关键处标清楚哪里要按你的环境改。顺带说清 mod_unimrcp 的 speak / play_and_detect_speech 怎么用,以及为什么 LLM 场景要用自由识别而不是固定语法。

MRCP 给通话加上了"听懂"和"会说"。再往下走一步:在 contact center 里,FreeSWITCH 管呼叫、UniMRCP 管 ASR/TTS,本来已经能做语音 IVR;但真正让它"活"起来的,是中间插进来的 LLM。传统 IVR 靠固定语法只能听懂预设的几句话,LLM 能听懂客户随口说的任何一句,还能带着上下文对答、调用工具查真实数据。三者怎么分工、一次对话在时序上怎么流转、延迟和打断这些工程难点怎么处理,连同一份能照着做的落地清单,都在这儿。

前面几篇讲 FreeSWITCH、OpenSIPS 都是在讲"怎么接通一路电话"。往上走一层:电话接通之后,想让机器听懂人说话(ASR)、让机器开口说话(TTS),媒体流已经在 RTP 上跑了,可谁来告诉引擎"现在开始识别""用这个语法""合成这段 SSML"?这就是 MRCP 干的活。它是什么、v1 和 v2 差在哪、一次识别在协议上到底怎么流转、UniMRCP 是怎么落地的、有哪些典型场景和踩坑点,这里一并说清。

读 FreeSWITCH 的 C 源码，层层封装，又臭又长，看完就忘。与其在源码里硬熬，不如用 Jupyter Notebook 造一个可运行、可视化的最小模型，把线程、阻塞、时序这些"看不见"的东西画出来。本文讲这套方法背后的认知原理、Jupyter Lab 的安装与用法、可视化手段清单，并以一个 audio_bridge_thread 的交互式 Notebook 为例。

FreeSWITCH 是一台优秀的媒体/B2BUA 引擎，但它没有原生集群能力，信令和媒体又和业务逻辑挤在同一个进程里。想把它扩到上万路，硬堆 FreeSWITCH 是最贵的一条路。这篇讲清 FreeSWITCH 架构的精华与包袱各在哪，为什么 OpenSIPS 和 rtpengine 恰好补在它最薄的两个地方——信令边缘和媒体传输——以及三件套怎么分工、容量能提到什么量级。

FreeSWITCH 的 session 是整个系统最核心的抽象——它是一路呼叫的容器，也是它的边界。这篇顺着源码，把一次呼叫从 SIP INVITE 进来、到 session 创建、媒体协商、桥接、挂断销毁的完整生命周期讲清楚：哪些数据是线程私有、哪些是共享，session 为什么和内存池、线程死死绑在一起，以及为什么"把会话从服务器 A 迁到服务器 B"这条路基本走不通——真要做会话漂移，让客户端 endpoint 重连新服务器，比在服务端桥接靠谱得多。

FreeSWITCH 用 switch_core 内核加模块插件的方式把一整套电话系统塞进一个进程，既不拆成微服务，也不是简单的单进程多线程。这篇从源码层面讲清它的状态边界划在哪、这种结构为什么快、又为什么脆，以及为什么这套二十年前为语音打磨的架构，做不成今天意义上的高性能 SFU。

我年轻时认路很厉害，看一眼地图就能从城东穿到城西；现在有了导航，方圆十几公里都得开着导航才敢上路。用进废退，脑子这块肌肉，你不用它，它就替你退休。AI 也一样——它拓展了我们的知识边界，却在悄悄把我们的判断力外包出去。这篇讲讲我怎么"逆流而上"，让 AI 帮我加速，而不是替我思考。

想用 AI 帮忙写一篇能投运动医学顶刊（如 BJSM）的临床论文，靠一句“帮我写篇论文”是过不了同行评审的。本文把 AI 拆进论文生产的每个环节——选题、检索、筛选、数据提取、写作、润色、查重——给出对应的工具清单和一条可复制的工作流；再横向对比 K-Dense、ARS、avoid-ai-writing 等开源 AI Skill，专门标出谁擅长搭骨架、谁擅长校对修改；最后把 BJSM 的字数红线和 ICMJE 的 AI 披露规则一次讲清楚。

十几年前我做过一个《A Glance of Lua》的分享，如今大半忘光了。这篇先用老程序员重拾旧语言的角度，把 Lua 最该记住的那几样东西——表即一切、元表、闭包、协程、C API——快速过一遍；再落到 FreeSWITCH：mod_lua 到底把脚本挂在哪几个位置（dialplan、XML handler、event hook、startup script），配一组能看懂的例子、几条最佳实践和最容易栽的坑。Lua 语法基于 5.x，FreeSWITCH 部分引用官方 scripting 文档。

很多人把 FreeSWITCH 的拨号计划当成一个"路由配置文件"，改完 reloadxml 就完事。可它其实是一台按呼叫上下文运行的状态机：一通电话进来，它一条条判断条件、往 channel 上贴变量、排一串要执行的动作，最后决定这通电话走哪条路。理解了这一点，IVR、排队、转接、录音这些呼叫中心功能才不再是黑盒。本文以 XML 拨号计划为主，配少量 Lua，讲清它是什么、能干什么、怎么写、有哪些最佳实践和常见坑，最后用几个真实呼叫中心场景演示排障技巧。

FreeSWITCH 那几篇讲的是"怎么接通一路电话",这篇换个角度:当你有成千上万路电话、要做注册、鉴权、路由、限流、防欺诈时,前面挡在最前线的往往是 OpenSIPS。它是什么、怎么编译、一次注册和一次呼叫在脚本里到底怎么流转、代码结构长什么样、有哪些best practice、又有哪些新手必踩的坑——一次讲清。

上一篇讲清了 SIP.js 怎么打进 FreeSWITCH,这次把它做成了一个完整项目——webrtc-to-freeswitch。这篇从整体架构、信令与媒体的完整流程、协议分层三个层面把它讲透:它是什么、有什么用、怎么用;浏览器到 FreeSWITCH 之间一次通话到底发生了什么;以及最容易被忽略、却最容易踩坑的 FreeSWITCH 侧配置——WSS binding、candidate ACL、ext-rtp-ip。

一篇写给自己的私人札记，已加密。

SIP.js 官方 demo 一键就能打通电话，但那是因为对端是一台匿名公共服务器。想让浏览器真正打进自己的 FreeSWITCH，绕不开三件 demo 帮你藏起来的事：注册、鉴权、还有一座 WSS 到 SIP 的桥。这篇拆掉 demo-1，把这三件事补齐。

给 FreeSWITCH 写测试有两条路：一条是自带的 FST 框架，起一个真 core、真 session，在进程内测 switch_* 函数；另一条是拉起整个服务、用 SIPp 打真呼叫、看 ESL 事件的集成测试。本文用我修的一个 mod_dialplan_xml use-after-free bug（PR #3151）串起前者，再讲清后者什么时候非用不可、怎么搭、坑在哪，最后给一张"这个 bug 该写哪种测试"的决策表和检查清单。

dlopen 只有四个函数，半小时能学完。难的是它没管的四件事——入口点怎么找、插件怎么回调宿主、ABI 怎么不崩、卸载怎么办。这篇把这四个问题的传统答案讲清楚，给一份可编译运行的完整参考实现（357 行），再用 10 个实测的崩溃现场说明常见错误。含 Linux/macOS 差异对照和一份可勾选的 checklist。