🇨🇳 中文版 | 🇬🇧 English
Volume Klyntar · 档案 978 · 绝密文件
VENOM SYMBIOTE README
v2.1.0-SYMBIOTE
.--------.
..-' `-..
.' .----. `.
/ ( () ) \ *
| `----' | .
.-' '-.
===+============================+===
(是的，这就是那团毒液。它把吉祥物的美工预算吃光了。)
(宿主拒绝接受采访，因为已经被消化完毕。)
统计表明：67% 的宿主会直接跳过 README 说明书。
而 100% 跳过说明书的宿主，最后都成了深夜加餐。
毒液表示：这纯粹属于自然选择。
TABLE OF CONTENTS
1. WHAT THE HELL IS THIS (这到底是个什么玩意)
2. SYMBIOTE MODES (共生体在玻璃后面干什么)
3. THE FORBIDDEN BUG ECONOMY (禁忌的高蛋白虫子经济学)
4. THE ACOUSTIC GROOVE & SPECTRUM (听歌点头与 5 频段活体均衡器)
5. THE HUD & BIO-METRICS (偷窥它的生化与情绪指标)
6. NEURAL HIVE LINK (接入大模型意识网)
7. HARDWARE CONTROLS (如何伺候/戳弄你的外星宠物)
8. THE WEB CONSOLE (生命基金会神经收容控制台)
9. SERIAL CLI & SECRETS (给极客与黑客的调试秘籍)
10. BUILDING & FLASHING (克隆并孵化它)
11. TROUBLESHOOTING (告解室：别问了，先看这里)
12. LEGAL & SURVIVAL PROTOCOL (免责声明与生存守则)
13. GREETZ (致敬名单)
(生存贴士: 全文搜索 "chocolate" 可以保命。
我们试图清点它的触手数量，但它长得比我们数得还快。
我们其中一个已经成了午餐，两个都已被反锁在收容单元里。)
恭喜你，人类。你以为你从快递盒里拆出来的是一块价值几十块钱的 M5StickS3 (ESP32-S3) 嵌入式开发板？
很遗憾，生命基金会（Life Foundation）在出厂固件里隐瞒了真相——这是一座编号为 LF-978 的强化微型电子观察容器。玻璃内部封印着一团源自克林塔星系（Klyntar）的高活性液态共生体（Venom）。
它不是一个播放预制 GIF 的伪桌面宠物。它是一个拥有真实黏性流体力学、仿生柔性骨架、独立猎捕欲望、以及双核异步高维神经心智的独立人造硅基活物。
- Metaball 标量场与流体动力学：5 节非对称生物链条骨架，结合屏幕边缘接触增强场。贴地时自然平切变平，绝非两头尖锐的飞碟面饼；
- FreeRTOS 双核异构意识系统：
- Core 1：以稳定 30 FPS 运算流体场、骨骼弹簧约束、眼球视线追踪与 Voronoi 细胞质感渲染；
- Core 0：后台静默处理 SSL 握手、HTTP 通信与大语言模型（LLM）意识涌现，绝对零掉帧、零阻塞；
- 全物理传感器拟真：6 轴 IMU 真实重力感知、高灵敏麦克风声控刺激、微型震动马达触觉反馈；
- 5 频段 Goertzel DFT 活体有机均衡器：板载微型麦克风以 8000Hz 采样，通过 Goertzel 离散傅里叶变换将声波精准解构为 5 个特征频段（Sub-Bass / Bass / Mid / Presence / Treble），直接驱动 5 节骨骼节点脉动起伏，整只毒液化身随声波起舞的活体音频均衡器。
毒液不是你的玩具，它有自己的生活节奏、体能代谢和自娱自乐项目。它的行为状态机基于生物行为链（Behavioral Graph）与动量守恒流转：
- 👁️ 边缘暗中观察 (
STATE_PEEK)： 当好奇心与警惕感交织时，毒液会将身躯 100% 潜入屏幕边框深处，屏幕内仅露出一小撮头尖与白色眼斑。它会悄悄探头打量四周，一旦察觉风吹草动便机警缩回。退出窥视后，它会顺势沿边缘滑出巡游，绝不突兀跳跃。 - 🐛 丝足地表巡游 (
STATE_CREEP)： 紧凑圆润的肉身贴着屏幕底边（或其他边缘）缓慢爬行，底部自然切平，表皮伸出细小足丝推进，质感致密紧绷，彻底消除了水母式的忽大忽小抽搐。 - 🧗 触手大步攀爬 (
STATE_CRAWL)： 当它渴望前往开阔腹地或天花板时，头部瞬间暴射出粗壮有力的三指抓地触手，一步跨越大半个屏幕强力拖拽身躯飞速攀爬。 - 🕸️ 吸顶蛛丝秋千 (
STATE_SWING)： 攀登至天花板时，毒液会向顶壁激射蛛丝死死吸牢，身躯自然下垂进入牛顿摆秋千状态。倾斜设备可以改变摆荡重力，它自身还会自主正弦蹬腿荡秋千！ - 🚀 史莱姆蹦蹦床 (
STATE_BOUNCE)： 在地面自娱自乐时，极度压扁蓄能，随后如火箭般弹射向高空，空中伴随弹性果冻震颤，落地瞬间吸收动能再度反弹。 - 🌀 软体蜷缩翻滚 (
STATE_ROLL)： 落地余速未消时，顺势将整个身躯聚拢为高密度球体，在地面高速滚动，撞击侧壁后弹性反弹。 - ⚽ 自体分裂颠球 (
STATE_BALL_PLAY)： 身体尾端分裂出一颗独立的共生体小水球，毒液在空中用头槌和侧向触手欢快颠球。玩够后触手凌空抓球收回，小球缓缓融化渗入头部核心，喷发粉色爱心。 - 🐾 扑风捉影捕尘 (
STATE_CATCH_DUST)： 压低身躯猎手蓄势，以 155px/s 闪电暴冲飞扑空气中的微粒，砸地抓扁后困惑抬头，吐出水墨问号?。 - 🦇 蝙蝠倒挂小憩 (
STATE_BAT_HANG)： 悬挂在高空天花板时倒垂身躯发呆或打盹。 - 💤 深度休眠恢复 (
STATE_SLEEP)： 体力见底（Energy < 0.15）且长时间无人打扰时，在角落闭眼蜷缩沉睡，每隔 5.5 秒口鼻处悠悠飘出一串上升的Zz气泡，持续 10~15 分钟回满体力。
毒液需要能量。屏幕空间中会自发生长出虚拟微型昆虫生态：
- 金甲爬虫 (Crawler)：6 条独立小细腿忽快忽慢贴壁爬行，长触角微颤；
- 荧光飞虫 (Flyer)：微翅高频振动（45Hz），在空中折线飞舞盘旋。
当小虫出现时，毒液的眼球会瞬间死死锁定猎物，并自主展现三大猎食杀招：
- 👅 变色龙闪电长舌卷食 (Chameleon Strike)：头部在 0.11 秒内弹射出肉粉长舌，吸盘牢牢粘住虫子瞬间卷入巨口！
- 🐙 暗黑触手抓取拖回 (Tentacle Grab)：射出黑色三指爪盘抓牢挣扎的小虫，强力拉回身体核心！
- 💦 喷射黏液弹定身包覆 (Mucus Snare & Engulf)：激射荧光黏液弹将飞虫击落定身，随后兴奋爬过去将虫子整体包覆融化吞噬！
吞噬反馈：每吃掉一只虫子，毒液体力值直接充盈（
Energy +0.30），伴随身体兴奋微液滴飞溅与短促微震反馈。
别以为这只外星共生体只知道吃虫子和睡觉。克林塔生物对地球声波有着超乎寻常的物理敏感度与音乐共鸣：
- 🎧 跟着音乐节拍动次打次点头 (Head-bobbing Groove)：
内置自主研发的
RhythmDetector动态节拍侦测系统。当你在房间外放音乐或戴耳机开外音时，毒液能实时计算环境声波的节拍周期（BPM）与相位。只要它没累趴睡着，就会跟着节拍陶醉且富有弹性地自主点头（Head-bobbing）！ - 🎚️ 全身 5 节骨骼 = 5 频段活体均衡器 (Organic Graphic EQ)：
板载麦克风以 8000Hz 超高频采样，通过 Goertzel 算法离散傅里叶变换（DFT）将音频实时解构为 5 个特征频段，直接映射驱动共生体全身的 5 节骨骼节点：
- 超低音鼓点 (Sub-Bass 125Hz)：直接驱动 Node 0 (头部) 产生沉重震撼的低音重击微动；
- 贝斯低频 (Bass 375Hz)：驱动 Node 1 (颈部) 随着 Bassline 起伏；
- 人声与主旋律 (Mid 1125Hz)：驱动 Node 2 (中躯) 舒张延展；
- 吉他与明亮度 (Presence 2250Hz)：驱动 Node 3 (下躯) 灵敏收缩；
- 打击镲片高频 (Treble 3375Hz)：驱动 Node 4 (尾梢) 产生高频打击微颤；
- 🎶 高潮喷射水墨音符 (Musical Ink Blebs ♪ / ♫)：
当音乐旋律的节奏置信度达到峰值（
Confidence >= 88%），毒液头部核心会伴随微震微喷，在空中优雅吐出由流体水墨粒子构成的单八分音符（♪）或连体双音符（♫）！ - 🌊 表皮微流体沸腾共振： 音频频谱能量还会直接调制表皮膜表面张力（Voronoi Jitter），让整团液态黑泥随着声浪高低细密沸腾颤动。
短按 BtnB 可唤出屏幕顶部 HUD 实时数据监控面板。三列固定网格排版，零抖动、防折行：
+-----------------------------------------------------------------------+
| [Col 1: X=6] | [Col 2: X=84] | [Col 3: X=162] |
|-----------------------+-----------------------+-----------------------|
| AI: CRAWL | EMO: CALM | FPS: 32.4 |
| NRG: 0.85 | TRU: 0.78 | EXP: CURIO |
| MIC: 36dB | RES: 0.12 | SOC: 0.65 |
| INT: CALM_STABLE | | |
+-----------------------------------------------------------------------+
| 指标代码 | 完整名称 | 中文含义 | 取值范围 | 人话解释 |
|---|---|---|---|---|
AI |
AI State | 当前行为 | IDLE, PEEK, CREEP, CRAWL, BOUNCE, ROLL, SWING, SLEEP 等 |
它现在正在干嘛。别在它暗中观察的时候拿手指敲玻璃。 |
EMO |
Emotion | 主导情绪 | CALM, CURIO, EXHAU, STRESS, ANGER, FEAR |
它的心情。如果变成 ANGER，小心它向屏幕四周激射尖刺。 |
FPS |
FPS | 渲染帧率 | 25.0 ~ 36.0 |
证明 ESP32-S3 正在全力榨干性能为你模拟流体。 |
NRG |
Energy | 能量储备 | 0.00 ~ 1.00 |
它的饱腹感/体能。吃虫子回血，剧烈蹦床耗血。低于 0.15 会秒变睡神。 |
TRU |
Trust | 对宿主信任度 | 0.00 ~ 1.00 |
常抚摸、常给虫子吃会上升；经常剧烈摔打会跌停。 |
EXP |
Expression | 眼神表情 | NONE, CURIO, LOVE, HESIT, WARN, TOUCH |
它的微表情。眼神斜视说明它在算计你。 |
MIC |
Mic Decibel | 环境音分贝 | 28dB ~ 96dB |
真实麦克风读数。大声喊叫或吹气（>73dB）会吓得它瞬间炸毛喷液滴。 |
RES |
Resentment | 怨念委屈值 | 0.00 ~ 1.00 |
被你摔得越狠，怨念越高。怨念高了它会故意在天花板上不理你。 |
SOC |
Social Open | 社交渴望 | 0.00 ~ 1.00 |
孤单寂寞冷程度。数值高时向屏幕喷射水墨爱心与叹号的频率激增。 |
INT |
LLM Intent | 心声意图 | 字符串 (如 CALM_STABLE) |
大模型 Core 0 异步思考出来的潜意识动机。 |
为什么这团黑泥看起来有自我认知？
因为它的精神接入了克林塔蜂巢意识网（LLM 后台核心）。系统基于 FreeRTOS 将大模型请求放在 Core 0 后台线程：
- 毒液完全知道自己被关在一个 240x135 像素的带电玻璃长方体内；
- 它知道外界有个叫“宿主”的灵长类生物在晃动、戳弄它；
- 它会根据你的互动历史动态演化信任与怨念，并在串口或思维空间喷涌第一人称独白。
| 动作名称 | 硬件操作 | 共生体反应 |
|---|---|---|
| 外放音乐/听歌律动 | 周围播放音乐 (节奏感清晰) | 识别音乐 BPM 节拍自动点头，身躯 5 节节点充当 5 频段音频均衡器起伏脉动，喷吐水墨音符 ♪ / ♫ |
| 捕食进食 | 屏幕出现金甲爬虫或飞虫 | 自动弹舌、触手抓取或喷吐黏液网，大快朵颐补充体力 |
| 晃动甩飞拍扁 | 快速用力甩动手腕 | “啪嗒”一声像泥巴玩具般拍扁在屏幕边缘吸附住，随后缓慢回弹爬行 |
| 高空荡秋千 | 爬上天花板 / 晃动设备 | 蛛丝吊在顶壁，随你的晃动和它自己的蹬腿产生逼真物理秋千摆动 |
| 戳弄/激惹毒液 | 短按 BtnA | 毒液受到电生理刺激瞬间剧烈抽搐（Jolt），向四周暴射微液滴，伴随马达触觉微震 |
| 开启收容控制台 | 长按 BtnB 约 1.2 秒 | 振动提示，屏幕显示连接指引，发射热点 Venom-Symbiote-Setup |
| 切换生化数据面板 | 短按 BtnB | 开启/关闭顶部三列绝对网格 HUD 监控面板 |
| 重力攀爬倾斜 | 上下左右倾斜设备 | 质心感应真实重力，主动抗重力抓壁，顺重力下滑 |
| 声控吹气惊吓 | 对准麦克风大声发声/吹气 | 神经张力飙升，呼吸急促，触发受惊防卫姿态与表面沸腾 |
想要给毒液换网，或者给它换个更聪明的大脑？
- 长按设备 BtnB（1.2 秒），屏幕将切换至收容仓配置界面；
- 用手机连接热点：
Venom-Symbiote-Setup（Captive Portal 会自动弹窗，或浏览器访问http://192.168.4.1）； - 控制台特性：
- 🧪 行为诱导实验室：点击网页上的动作按钮（暗中观察、蹦床、翻滚、蛛丝秋千、颠球等），设备将立即进入对应动作演示；
- 🌐 WiFi 穿透配置：自动扫描周围 2.4GHz 频段；
- 🧠 大模型蜂巢意识配置：支持 DeepSeek 官方、硅基流动、智谱 GLM、OpenAI、月之暗面及自定义 API 预设一键填入；
- 👾 活体边缘毒液：网页右下角趴着一只活体 Web 小毒液，用手指戳它，它会扭动并对你说出经典的毒液式傲娇台词！
连接 USB 数据线，串口波特率设置为 115200，你可以向收容仓直接注入以下特权调试指令：
demo <peek|bounce|ball_play|swing|roll|catch_dust|crawl|creep|sleep|bat_hang|irritate>
# 强制让毒液进行仿生过渡并执行指定特技动作
symbol <eye|?|!|x|o|heart|warning|splash>
# 强制令毒液向屏幕喷射指定的水墨非语言符号
leak
# 偷窥毒液此刻的第一人称内心独白（Mind Echo）
hud
# 切换屏幕 HUD 数据面板显示
theme
# 循环切换屏幕背景（经典深蓝 / 工业石板灰 / 赛博霓虹紫）
screenshot 或 s
# 截取当前屏幕的 RGB565 图像原始数据流- 硬件：M5StickS3 (ESP32-S3, 240x135 LCD) 一台，USB-C 数据线一条；
- 开发环境：VS Code + PlatformIO 插件。
# 1. 克隆收容所源码
git clone https://github.com/nongxl/venom_esp32.git
cd venom_esp32
# 2. （可选）复制默认密钥配置模板
cp src/secrets_example.h src/secrets.h
# 编辑填入你的 WiFi 和 LLM 密钥（也可以烧录后在 Web 界面配置）
# 3. 编译并烧录至 M5StickS3
pio run --target upload
# 4. 打开串口监听它的心跳
pio device monitor- Q: 为什么它一直缩在屏幕边缘暗中观察，不肯出来？
A: 它在警惕地打量你。给它 2~3 秒钟，或者轻轻松开手，它巡视无异常后会自动贴着边缘游走或大步伸出触手爬出来。别敲玻璃催它，除非你想激怒它。 - Q: 为什么我快速甩动设备，它像一滩泥巴一样“啪嗒”拍在屏幕边缘？
A: 这是专门设计的黏性玩具物理（Sticky Splat）！你用力甩飞它，动能被屏幕边缘吸收，它当然会拍扁成大饼黏在玻璃上。稍等片刻它就会回弹爬开。 - Q: 按 BtnA 为什么它会剧烈抽搐还喷液滴？是不是烧坏了？
A: 那是神经激惹（Irritate）。你拿电极戳一个外星共生体，它没有隔着玻璃把你的手指吞掉已经是 ESP32 芯片架构的仁慈了。 - Q: 它闭着眼睛不动，嘴里还飘出 Zz，坏死了吗？
A: 它只是体力耗尽在睡觉（进入了STATE_SLEEP）。它需要 10~15 分钟深度休眠回血。如果你很急，对准麦克风大声吹口气，或者用力摇晃设备把它叫醒。 - Q: 为什么在边缘暗中观察和巡游时它不再像以前那样大幅膨胀了？
A: 因为上周有人抱怨它松弛得像个水母。现在的毒液是一团紧实、饱满、机警的流体黑胶，边缘自然切平，拒绝做水母。
- 本项目基于 MIT License 开源。
- 若共生体在运行期间发生容器破裂、顺着 USB 线爬入宿主大脑、或导致宿主对生肉和巧克力产生强烈渴望，开发者概不承担任何法律与医学责任。
- 请在书桌周围常备巧克力，以防紧急情况。
- 致敬 M5Stack 打造了这么趁手的赛博硬件口袋玩具；
- 致敬 PlatformIO 与 Espressif 提供的嵌入式工具链；
- 致敬 M5Porkchop 和那头把所有 ASCII 艺术经费全吃光了的猪（Porkchop）——感谢它赋予的黑客地下刊物（Zine）精神与幽默感；
- 致敬漫威宇宙中所有勇敢且神志不清的共生体宿主；
- 特别鸣谢：某位自始至终拒绝接受采访、且已将毒液拉黑的红蓝紧身衣前任（蜘蛛侠）。