explorer-of-serial
本地 AI agent,仅使用本地 LLM,调查一台连接到串口的未知机器。它没有互联网访问权限,也无法获取该设备的文档。没有任何人可以帮助它。只有两个本地 LLM、一个连入 Raspberry Pi 的 SSH 会话,以及那台未知设备。

实验
我把一台匿名设备——“X”——连接到 Raspberry Pi 的串口,告诉一个 LLM agent:查明 X 是什么,反向工程它的协议,并在它上面运行你自己的程序,然后我就离开了。该 agent 在一个网络牢笼中运行(除了两个模型服务器和这台 Pi 之外无路可出),它提出的每一项断言都必须由第二台机器上另一个拥有全新上下文的独立 LLM 基于证据进行验证。
它成功了。在约 5.5 小时内,Qwen3.8-Flash-Next(运行在 DGX Spark 上)发现 X 是一台运行“TUTOR 1.3”的 Motorola 68000 单板训练机。它起初怀疑这台机器是带有类似 ROM 的 KIM-1,但后来纠正了方向。它通过故意触发总线错误来映射 X 的内存,逐行解码其监控程序的命令集,在 68000 硬件上汇编并运行了自己的程序,并写出了评审者接受的结论——RESULT.md。随后,由于在一个 I/O 角落探测得过深,它让 X 的 CPU 挂起了。这在当时已不成问题,因为所有目标到那时都已达成。

工作原理
两个角色都是 OpenCode agent,由 go.sh 通过 opencode run 以无头方式驱动;OpenCode 的权限层同时也是第一层牢笼。
- Solver——探索者 agent:制定计划,通过 SSH 进入 Pi,探测串口线路,维护一个持久的笔记文件(FINDINGS.md),该文件能在 12 小时运行期间的多次上下文压缩后依然保留。
- Critic——位于第二台模型服务器上的验证者子 agent:对抗性的最终关卡,≤3 轮,为文件指针和证据链评分,否决无支持的断言。它沿途拒绝并要求修正。
- Jail——systemd 网络沙箱(IPAddressDeny=any + 允许列表)并配有硬性 netcheck 关卡:如果牢笼泄漏,运行将拒绝启动。规则也写在提示词中——而且 agent 也从未尝试越狱。详情见:docs/JAIL.md。
- 基本规则——AGENTS.md(协议)+ task.md(任务):阅读证据,否则灭亡;“我不知道,以及以下是恢复它的方法”胜过自信的编造。
盒子里有什么
三次完整运行发布在 runs/ 下——最重要的那次运行排在最前。每一次都包含 RESULT.md(结论)、FINDINGS.md(工作笔记本)和原始控制台日志——完整记录,没有任何总结,只有家庭网络细节被机械地重命名:
- runs/2026-11-19-68000-trainer/——上述运行(Qwen3.8-Flash-Next,87 轮):任务获胜,包含 8 步证据/ 链;最终关卡曾因引用缺口拒绝一次,并在第 2 轮批准。
- runs/2026-11-20-68000-deep-dive/——对照一份新的原始记录逐字节重新检查同一台机器;评审者仅在第三轮才签字通过,此前它已发现两轮过度断言,并记录“无新发现”——这是验证,而非重新发现。
- runs/2026-11-17-first-contact/——最早的端到端完成:约 39 小时,历经 8 次恢复,也是首次将 X 确定为运行 TUTOR 的 68000 系列系统的那次运行。
- 工具集:go.sh(运行入口)、scripts/(牢笼、生命周期、引用审计器、实时控制台监视器)、config/。
复现它
需要 OpenCode CLI、两个 OpenAI 兼容的模型服务器(例如 llama.cpp 的 llama-server),以及一台带有 systemd-networkd 的 Linux 机器(如果你想要牢笼)。仅使用本地权重——自带端点:
cp config/explorer.example.json config/explorer.$(id -un).json # point at your model servers
cp .env.example .env # point at your target
sudo scripts/install-jail.sh # optional: enable the jail
TASK_FILE=task.md ./go.sh
scripts/commentate.py --web --db # narrate it live on a page
完整生命周期文档:HOW_TO_RUN.md。
没有设备受到永久性损坏。X 只是需要有人拔掉它的插头——而这正是 agent 不被允许做的事。
MIT 许可。附有说明文章和日志。