主脑Main brain最强 · 在你身边strongest · with you
本地 AILocal AI实验室电脑里in the lab PC
板上 AIOn-board AI设备里面inside the device
台架主动连回来the bench dials home
0x10指向一片空地points at nothing
3 秒前3 s earlier这里把指针清零了the pointer was cleared here
panic 了。我看到了,可我看不懂。It panicked. I saw it, but I can't read it.
我离得最近,我先来。日志和上次死机的现场给我。I'm closest, I'll start. Give me the logs and the last crash record.
我在线。隔着城市,我也够得到它。I'm on. I can reach it from another city.
调用栈断在存储驱动里。The stack ends in the storage driver.
日志不够。谁进去看一眼?Logs are not enough. Who goes in?
我就在里面,可我找不到 PC 停在哪。I'm inside, but I can't find where the PC stopped.
这里面什么工具都没有。没关系,我带了。No tools in here at all. That's fine, I brought ours.
跟我来,PC 就停在这。Follow me. The PC stopped right here.
调用栈拿到了。这个指针,指向一片空地。Got the call stack. This pointer points at nothing.
可是谁把它清零的?我看不出来。But who cleared it? I can't tell.
我亲自来看。……找到了,3 秒前,在那边。Let me look myself. …Found it. 3 seconds earlier, over there.
查完了。报告在这,请你过目。Done. Here is the report for you.
开源 · Apache 2.0 · 给 AI 用的硬件调试工具包Open source · Apache 2.0 · a hardware debugging toolkit for AI
板子在外地死机了。
三个 AI 已经进去看了。
Your board just crashed
in another city.
Three AIs are already inside.
DeviceHands 让云端的大模型、你身边的本地模型、设备里的小模型一起调试真实硬件:亲自进到设备里去查,互相商量,再把结论画给你看。
DeviceHands lets a large cloud model, a local model near you and a small model on the device debug real hardware together: they go inside the device, talk it over, and draw you the answer.
01现场The scene
外地的设备,
半夜死机了A device far away
dies at night
可能是手机、电视、音箱、电脑,也可能是一台服务器——里面都有一块板子。没有人在旁边。住在设备里的小模型第一个发现。A phone, a TV, a speaker, a computer or a rack server: there is a board inside each of them. Nobody is around. The small model that lives on the device notices first.
- 设备端模型 · 规划中On-device model · planned
02本地模型The local model
离得最近的
先接手The closest one
takes it first
实验室电脑上的本地模型,经 USB 和串口直接连着设备。它把启动日志、崩溃记录、上次死机留下的现场都取回来。The local model on the lab PC is wired to the device over USB and serial. It pulls back the boot log, the crash records and what the last crash left behind.
- 本地模型用设备工具 · 现在能用Local model with device tools · shipped
- 串口 · adb · 烧录 · 现在能用UART · adb · flashing · shipped
03主脑The main brain
最强的那个,
在你身边The strongest one
stays with you
主脑可能在你家里的电脑上,也可能在云端。实验室的台架主动连回来,隔着城市,它照样读得到日志、下得了命令。The main brain may run on your own machine or in the cloud. The lab bench dials home, so from another city it can still read the logs and run commands.
- 两地调试 · 现在能用Two-site debugging · shipped
- Claude Code · Cursor · Codex
04讨论The discussion
三个地方,
一场讨论Three places,
one discussion
三个模型能力不同、位置不同,看到的也不同。它们交换证据,互相追问,谁也不靠猜。Three models with different strengths in different places see different things. They trade evidence and question each other. Nobody guesses.
- 多模型同桌讨论 · 规划中Models in one thread · planned
05工具包The toolkit
进到设备里,
打开工具包Go inside,
open the toolkit
光看日志不够,就亲自进去。设备里面什么分析工具都没有,所以它们带了自己的:DeviceHands 工具包。日志、崩溃记录、时间轴、搜索,都在里面。When logs are not enough, they go in. There are no analysis tools on the device, so they bring their own: the DeviceHands toolkit. Logs, crash records, the timeline and search are all in it.
- 在设备上执行命令 · 现在能用Run commands on the device · shipped
- 内存 · 跟踪 · 规划中Memory · tracing · planned
06勘查The search
找到 PC 指针
停下的地方Find where the
program counter stopped
程序跑到哪一条指令停的,调用栈一层层是谁叫的谁,那个指针指到了哪里。工具把零散的日志对到一条时间轴上,直接画出来。Which instruction it stopped on, who called whom up the stack, where that pointer went. The tools line the scattered logs up on one timeline and draw it.
- 时间轴 · 崩溃记录 · 现在能用Timeline · crash records · shipped
- PC 指针定位 · 规划中PC analysis · planned
07主脑出手The main brain steps in
卡住了,
主脑亲自来Stuck.
The main brain comes in.
本地模型看到了现象,找不到原因。主脑自己进来看一眼,把三方的发现连成一条线:3 秒前,另一段代码把这个指针清零了。The local model sees the symptom but not the cause. The main brain comes in to look for itself and joins the three sets of findings into one line: 3 seconds earlier, other code cleared this pointer.
- 主脑直接操作设备 · 现在能用Main brain drives the device · shipped
最后交到你手上的,
是一份看得懂的报告What reaches you in the end
is a report you can read
- 结论Finding
- 存储驱动用了一个已经被清零的指针。The storage driver used a pointer that had been cleared.
- 证据Evidence
- PC 位置 · 5 层调用栈 · 对齐后的时间轴PC location · 5 stack frames · the merged timeline
- 下一步Next
- 补丁已备好,要我烧进去再跑 20 次确认吗?A patch is ready. Flash it and run 20 boots to confirm?
故事里的 bug 和数据是编的,用来演示流程。The bug and the data in this story are invented to show the flow.
向下滚动,看它们怎么查Scroll to watch them work