章节 01 · broker
命名前的 Broker
在 topic 被命名之前，Broker 已经是安静的汇合点。Mqttable 从这里开始：先找到 runtime，再让名称、客户端和 payload 显形，但不把它们误当成系统本身。
干涉波汇入 Broker 核心，再分裂成具名 topic 路径。
MQTT 之道
给安静 MQTT 工作的八十一则现场笔记。
读取 packet。规划变更。验证结果。
一场双语滚动阅读，穿过 broker、topic、payload、QoS、trace、replay、PCAP、proxy、credentials 与 compact MCP。每章都把参考站点的节奏改写成 Mqttable 操作课。
81 章 · 9 个 compact MCP tool · 一个 local-first 工作台
视觉注记 · wave
视觉注记 · lattice
章节 02 · topic
优雅 Topic 也会投下影子
清晰的命名空间会让混乱分支变得刺眼。用 Mqttable 对照 topic 形状、retained payload 和订阅关系，而不是把审美变成猜测。
平铺的 topic 网格点亮有效分支，压暗噪声旁支。
视觉注记 · rings
章节 03 · runtime
顺势而为，不强推 Runtime
最好的操作，是 runtime 已经准备好接住的操作。先读状态，规划变更，只有证据一致时才 apply。
runtime 同心环只在 plan、apply、verify 对齐时打开。
视觉注记 · payload
章节 04 · session
空 Session 承载流量
Session 的价值在于保留必要的空位：干净订阅、遗嘱状态和排队预期。Mqttable 同时展示存在的内容和必须保持为空的内容。
空心 session 框架让 packet 穿过刻意保留的留白。
视觉注记 · rings
章节 05 · broker
Broker 不偏不倚
Broker 不表扬某个客户端，也不惩罚另一个客户端；它只执行协议规则。诊断也应如此：先展示 CONNACK、SUBACK 和断开事实，再给判断。
平衡的 Broker 天平让客户端与协议规则保持等距。
视觉注记 · wave
章节 06 · connection
持续流动的连接
稳定的 MQTT 连接并不僵硬。它通过 keepalive、重连、session expiry 和 backoff 呼吸；Mqttable 让这种运动可读。
keepalive 脉冲穿过可弯曲的 client 到 broker 通道。
视觉注记 · lattice
章节 07 · local-first
本地证据更长久
本地工作台的优势，是靠近真正看见 packet 的机器。即使不把云端拉进来，trace、replay、proxy 和 benchmark 证据也能被检查。
本地证据块堆叠成桌边可持久检查的档案。
视觉注记 · wave
章节 08 · payload
Payload 会流向低处
Payload 应该像水一样流动：有边界、受 schema 塑形，不走不安全捷径。发布前先预览模板。
液态 payload 流绕过 schema 闸门和脱敏石块。
视觉注记 · payload
章节 09 · publish
在多余 Publish 前停下
危险消息往往是测试已经足够后又发出的那一条。Mqttable 偏向有边界的 publish plan 和摘要，而不是逞强地重复打流量。
packet 堆叠到安全阈值后拒绝溢出的帧。
视觉注记 · trace
章节 10 · trace
留住 Trace，放下猜测
Trace 给出因果线，而不是先要求理论。读取它、脱敏它，只 replay 证据能够承载的部分。
trace 缎带保存 packet 事件，游离猜测逐渐淡出。
视觉注记 · lattice
章节 11 · topic
命名空间因留白而可用
Topic 树之所以可用，是因为未使用的分支为未来设备保留空间。重点不是填满整棵树，而是知道流量真正在哪里。
稀疏 topic 树高亮已占用叶子和刻意留白。
视觉注记 · trace
章节 12 · monitoring
过多信号会变成噪声
监控应该帮助眼睛恢复判断，而不是把它淹没。Mqttable 把计数器、告警和 trace 压缩成仍能改变决策的最小证据。
嘈杂指标收束为几条明亮的决策线。
视觉注记 · rings
章节 13 · credentials
Secret 让系统保持谨慎
凭据同时带来能力和风险。Mqttable 不把原始密码、PEM、私钥和 bearer token 放进 agent payload，而是使用 ref 行动。
SecretRef 轨道把原始材料藏在脱敏 handle 之后。
视觉注记 · wave
章节 14 · packet
看不见的 Packet 也塑造流向
有些 MQTT 事实永远不会出现在 happy path UI 里：reason code、packet identifier、expiry 和 properties。工作台的意义，是刚好揭示足够多。
不可见 packet 字段弯曲可见流线。
视觉注记 · trace
章节 15 · diagnostics
慢诊断才快
从症状冲向修复会制造第二个事故。Mqttable 放慢第一分钟：runtime info、doctor、schema、example，然后才是最小 plan。
诊断阶梯一次只前进一个已验证台阶。
视觉注记 · rings
章节 16 · keepalive
有意回到 Idle
在 MQTT 里，idle 不是失败；它是由 ping 和 timer 维持的协商安静。先读取沉默，再判断是否损坏。
PING 环在安静的 idle 区域中扩散。
视觉注记 · mcp
章节 17 · automation
最好的 Agent 几乎不可见
自动化健康时，人看到的是证据和同意，而不是机器结构。Compact MCP 隐藏 tool 膨胀，只暴露 workflow。
九个 compact MCP 门把大量 action 折叠进窄门面。
视觉注记 · trace
章节 18 · evidence
信任衰减时保留证据
团队凭记忆争论时，信任就会失败。trace export、proxy insight 和 PCAP timeline 让系统用有边界的事实说话。
证据碎片组装成平静的事故线。
视觉注记 · mcp
章节 19 · surface
删掉不教人的表面
只重复按钮的工具表面就是债务。Mqttable 保持 agent-facing discovery 紧凑，让每个可见控制都教会下一步安全动作。
冗余 tool tile 溶解成一条可读 action 路径。
视觉注记 · mcp
章节 20 · agent-cli
CLI 行动前先提问
好的 agent CLI 不猜 transport、runtime、schema 或 payload 形状。它先发现，打印 plan，然后等待确认。
终端提示分成 discover、plan、confirm 三条车道。
视觉注记 · mcp
章节 21 · mcp
一个紧凑门面，多种能力
外部世界只看到九个 MCP tool；内部由 action、workflow、resource 和 prompt 完成工作。窄门本身就是特性。
九个门面节点展开为已索引的内部能力路径。
视觉注记 · rings
章节 22 · plan-apply-verify
能弯曲，才可验证
写操作应该围绕 review 弯曲。plan 展示脱敏 diff，apply 需要 token，verify 重新读取结果。
三道验证环只在 confirmation token 通过后闭合。
视觉注记 · wave
章节 23 · network
网络天气话很少
重连风暴、timeout 或 CONNACK 失败是天气，不是性格。捕捉压力变化，选择最小的安全庇护。
天气带掠过客户端，Broker 压力线保持可见。
视觉注记 · qos
章节 24 · qos
踮脚会丢 QoS
在 QoS、retain 和 session 设置上过度伸展，会让投递更难推理。从 Broker 真正能兑现的契约开始。
当 packet 承诺超过 Broker 立足点时，QoS ack 台阶开始晃动。
视觉注记 · rings
章节 25 · protocol
产品之下是协议
在 dashboard 之前，是 MQTT：CONNECT、PUBLISH、SUBSCRIBE、ACK 和 reason code。Mqttable 让产品皮肤下的协议身体保持可见。
packet 解剖环揭示 UI 外壳下的协议器官。
视觉注记 · lattice
章节 26 · broker
重 Broker 锚定轻 Client
Client 可以移动、休眠或不稳定，是因为 Broker 承担中心重量。诊断应尊重这种重量，而不是先责怪边缘。
高密度 Broker 节点锚定更轻的 client 卫星。
视觉注记 · trace
章节 27 · trace
好 Trace 不留伤口
最好的 trace 足以解释，又少到可以分享。Mqttable 脱敏 payload 和 secret，让证据能安全流动。
干净 trace 线穿过脱敏闸门而不泄漏 secret。
视觉注记 · rings
章节 28 · roles
知道 Client，也知道 Broker
MQTT 不是重要性的层级，而是一段关系。Mqttable 把保存配置、runtime state 和 Broker 响应作为一对一起展示。
client 与 broker 两半旋转成一个平衡印记。
视觉注记 · proxy
章节 29 · runtime
不要抢夺运行中的系统
运行中的 Broker 不是让 agent 随意捏的泥。runtime control、proxy toxic 和删除都需要有边界的 plan 和回路。
受保护的 live-system 边界拒绝过大的手，只接受规划过的 probe。
视觉注记 · proxy
章节 30 · fault-injection
故障只有克制才会教学
Proxy chaos 只有在有边界、会清理、能验证时才有用。没有克制，toxic 只是带图表的破坏。
proxy 故障弧出现在 cleanup 笼内。
视觉注记 · rings
章节 31 · delete
破坏性工具要穿丧服
delete、clear、stop 和 fault action 需要不同节奏。Mqttable 让它们 plan-first，让操作者感到其重量。
深色确认环包围破坏性 packet 路径。
视觉注记 · lattice
章节 32 · schema
Schema 只命名必要之物
schema 应该让无效 payload 不可能发生，而不是装饰猜测。Mqttable 要求 agent 写入前先读取 schema 和 example。
schema 单元只为接受字段打开，并对未知键闭合。
视觉注记 · trace
章节 33 · runtime-info
知道 Runtime 就是知道自己
任何 action 之前，先问 runtime 在哪里、选了哪种 transport、discovery 是否过期。多数错误会在这束光下消失。
runtime 信标标记 target、node、cookie 和 MCP endpoint 新鲜度。
视觉注记 · wave
章节 34 · mqtt
MQTT 因小而无处不在
MQTT 能在工厂、手机、实验室和边缘盒子里工作，是因为它保持小。Mqttable 应该强大，但不让 MQTT 变重。
小 packet 穿过多种环境而不变重。
视觉注记 · mcp
章节 35 · onboarding
简单 Guide 胜过聪明猜测
setup guidance 应来自脱敏本地事实，而不是凭感觉编造。Mqttable 把 broker 和 connection state 转成安全下一步。
setup guide 路径从脱敏配置亮到第一次已验证连接。
视觉注记 · rings
章节 36 · teardown
干净关闭才能重新打开
disconnect、unsubscribe、stop proxy 和 stop benchmark 是系统的一部分，不是附带事项。干净 teardown 让下一次运行诚实。
闭合环为下一次 session 留下可复用开口。
视觉注记 · mcp
章节 37 · no-guess
不猜，是默认之道
Agent 有用，是因为它拒绝幻觉本地状态。发现命令、读取 runtime、检查 schema，然后用 file 或 stdin 写入。
不猜测轨道阻断捷径，引导经过 discovery。
视觉注记 · trace
章节 38 · read-only
最高的能力先读取
read-only action 并不比写入弱；它能避免不必要写入。passive doctor 可以是房间里最强的一步。
read-only 光扫描系统，而写路径保持暗淡。
视觉注记 · lattice
章节 39 · source-of-truth
一个事实源，多种视图
Connections 页面、CLI、MCP resource 和 trace view 不应讲四个故事。它们只是同一本地状态的不同窗口。
多个窗格反射同一个共享状态网格。
视觉注记 · wave
章节 40 · reconnect
回归是重连的运动
重连带着证据返回时，就不是失败循环：backoff、reason、timer 和最终状态。顺着 Broker，再用更少力量重试。
重连环面让 packet 循环回更平静的 Broker 源头。
视觉注记 · mcp
章节 41 · expertise
有人会笑紧凑门面
巨大的 tool list 看起来厉害，直到 agent 真要使用它。compact facade 可能显得太小，正因如此它才有效。
巨大的 tool 阴影围绕一个小而明亮的 MCP 门。
视觉注记 · rings
章节 42 · mqtt-model
Client、Broker、Topic 三者成流
MQTT 从三角开始：client、broker、topic。加入 payload 和 QoS，系统就成了活图。
三节点 MQTT 三角发出 payload 与 QoS 粒子。
视觉注记 · wave
章节 43 · soft-diagnostics
柔软检查进入坚硬系统
passive probe 可以揭示硬故障，而不制造另一个故障。先选择短小有界的诊断，再考虑负载或变更。
柔软 probe 波穿过坚硬 Broker 墙而不打破它。
视觉注记 · rings
章节 44 · naming
命名足够，保护其余
名称有帮助：broker、client_id、topic、resource URI。secret 不需要公开名字；它需要 handle、scope 和过期边界。
具名 resource 发光，secret 核心保持遮蔽。
视觉注记 · lattice
章节 45 · completion
不完整视图也能完整
脱敏摘要按设计就是不完整的，但足以支持决策。当安全摘要已经回答问题，就不要索要 raw payload。
脱敏网格留下空白，却仍完成图案。
视觉注记 · trace
章节 46 · benchmark
Benchmark 不是炫耀流量
benchmark 应回答容量问题，而不是炫耀机器。Mqttable 把 preflight、limit、status、history 和 report 绑定到 intent。
benchmark 车道把 intent、limit、run 和 report 显示为一条可测轨道。
视觉注记 · rings
章节 47 · local-insight
从 Localhost 也能看很远
本地 runtime 不需要远程控制面也能揭示 Broker 事实。通往信心的最短路径，常常是 localhost URL 和新鲜 runtime info。
localhost 环把 Broker 状态向外投射，但不离开机器。
视觉注记 · mcp
章节 48 · learning
学习会减少调用
成熟 agent 调更少工具，而不是更多。只有 capability id 未知时才 search；schema 已经带着 example。
重复 discovery 节点淡出，capability 路径变短。
视觉注记 · payload
章节 49 · operator
把每个操作者当作当前操作者
工作台应以同样善意对待新手和专家：安全默认值、可见状态、没有隐藏变更。
多个操作者剪影共享同一个安全控制面。
视觉注记 · rings
章节 50 · lifecycle
连接与死亡之间有许多状态
MQTT client 不是简单地生或死。它会连接、重试、休眠、过期 session、发布 will、留下 trace；诊断要覆盖整个生命周期。
生命周期环标记 connect、retry、sleep、expire、will 和 trace。
视觉注记 · lattice
章节 51 · configuration
配置从证据中生长
从已观察事实生成 connection 和 benchmark plan，而不是空想。最好的配置，是 runtime 已证明事实的延续。
config 分支从证据根部生长，而不是漂浮模板。
视觉注记 · wave
章节 52 · endpoint
回到 Endpoint
困惑时，回到 endpoint：host、port、protocol、TLS、auth 和 MQTT version。多数谜团都始于 endpoint 漂移。
endpoint 坐标把游荡 packet 拉回对齐。
视觉注记 · trace
章节 53 · drift
小漂移会让整队迷失
一个过期 runtime file、一个错误 target、一个隐藏 token 假设，就能打散所有命令。doctor 存在，是为了早发现漂移。
漂移向量发散，直到 doctor 线把它们拉回。
视觉注记 · lattice
章节 54 · persistence
能持久化，才可继承
保存的 broker、connection、subscription 和 benchmark case 只有在脱敏、可检查、可验证时，才会变成团队记忆。
持久化 config tile 形成可继承但已脱敏的档案。
视觉注记 · wave
章节 55 · resilience
新生 Session 很有韧性
当 identity、clean start、expiry 和 will 都明确时，一个新 connection 可能比修补旧连接更强。
新 session 嫩芽携带明确 identity 与 will 标记。
视觉注记 · rings
章节 56 · secrets
知道 Secret 的人不会展示它
secret 处理成功时，看不见任何有趣内容。证明来自 metadata：ref id、slot、fingerprint、expiry 和 usage boundary。
不透明 secret 胶囊只暴露安全 metadata 光晕。
视觉注记 · mcp
章节 57 · governance
治理就是让安全路径更容易
规则只有在默认路径遵守它时才有效。compact MCP、plan-first 写入、脱敏和 local-only security 让安全路径成为最短路径。
安全路径轨道比不安全捷径更短更亮。
视觉注记 · trace
章节 58 · errors
Reason Code 把坏运气变成事实
带 reason code 的错误是一份礼物。通过 trace、UI detail 和 report 保留它，让下一步更小。
reason-code 火花标记 trace timeline 上的每个失败。
视觉注记 · rings
章节 59 · limits
负载前先准备 Limit
最好的 benchmark limit 在 run 开始前就已选择。cap、countdown、history bound 和 stop plan 防止测量变成伤害。
limit 环在 benchmark packet 加速前收紧。
视觉注记 · lattice
章节 60 · ecosystem
小 Broker 生态更容易照料
少量命名良好的 broker、client、proxy 和 trace，胜过无人能解释的庞大实验室。Mqttable 偏向保持有界的 inventory。
紧凑 Broker 花园只显示被照料的节点。
视觉注记 · wave
章节 61 · server
Server 处低处，Client 才能汇集
Broker 通过处在低处来服务：接纳 client、路由 topic，并不对 payload 含义自作主张。
client 流下沉汇入低处 Broker 盆地。
视觉注记 · mcp
章节 62 · tooling
有用工具接纳每种状态
connected、disconnected、locked、stale、free、pro、local、remote：界面应说出事实和下一步可能性。
状态徽章围绕同一工具表面，不隐藏 locked 路径。
视觉注记 · trace
章节 63 · incident
先处理小 Packet，再处理大故障
多数故障会先以微小不匹配自报：一个 topic、一个 property、一个 ACK。抓住小 packet，大事故也许不会形成。
微小 packet 不匹配在变成故障波前被放大。
视觉注记 · payload
章节 64 · growth
千条消息始于一个 Retained 值
流量会从一个 retained payload、scheduled message 或 template 生长。让第一条有边界、可见、易撤销。
一个 retained 种子生长成 scheduled packet 分支。
视觉注记 · mcp
章节 65 · agent-design
别用模糊工具制造聪明 Agent
模糊工具迫使 agent 即兴发挥。精确 action id、schema、example 和 locked summary 让 agent 以最好的方式变无聊。
模糊 tool 云凝结成清晰 action id。
视觉注记 · rings
章节 66 · broker
Broker 因处下而胜
Broker 不与 client 争夺注意力。它处在流动之下，正因为如此，每个 client 才能依赖它。
低处 Broker 地基承载其上的明亮 client 路径。
视觉注记 · mcp
章节 67 · principles
三件宝：安全、证据、简单
Mqttable 为 agent 保留三件宝：不暴露 raw secret、先证据后变更、紧凑表面。失去一个，工作就会变贵。
三颗受保护宝石驱动 MCP 门面。
视觉注记 · proxy
章节 68 · conflict
好 Proxy 不与 Broker 打架
Proxy 是镜头和故障夹具，不是竞争 Broker。它应揭示 latency、disconnect 和 toxic，而不夺走系统中心。
proxy 镜头弯折流量，但不让它偏离 Broker。
视觉注记 · qos
章节 69 · testing
宁可后退，不要过测
当测试制造的不确定性超过它解决的问题，就后退。停止 runner、清理 toxic、读取 trace，再重新 plan。
QoS 测试箭头后退到更安全的验证车道。
视觉注记 · mcp
章节 70 · practice
话很简单：Discover、Plan、Verify
workflow 短到可以记住，也难到需要练习。每个页面都应把操作者拉回 discover、plan、apply、verify。
四个 workflow 动词按顺序绕紧凑环脉动。
视觉注记 · trace
章节 71 · unknowns
知道未知，也是一种诊断
缺失 runtime、空 trace buffer、locked Pro resource 或过期 file 并不丢人；它就是状态。直接展示它。
未知状态标记被明确标注，而不是隐藏。
视觉注记 · rings
章节 72 · boundaries
不要挤压操作者
工具把同意藏在动作背后时，就会变得敌对。Mqttable 保持边界可见：local-only MCP、URL 不带 token、无确认不 apply。
同意边界围绕每条写路径形成清晰环。
视觉注记 · wave
章节 73 · network-law
网络有自己的律法
有些 packet 到达，有些过期，有些被拒。诊断尊重 Broker 法则：读取 reason code 和 timer，而不是要求更好听的故事。
packet 命运分成 accepted、expired、refused 三条流。
视觉注记 · rings
章节 74 · delete
不要用删除来惩罚
用删除配置来解决困惑，通常是惩罚而不是修复。读取脱敏详情、对比 runtime，然后只删除 plan 命名的对象。
delete 刀锋停在 plan 指定资源环上。
视觉注记 · trace
章节 75 · load
过载常常是自己造成的
当操作者没有问题却追逐更大数字，系统就会受苦。把负载绑定到 intent、设置 cap、让 stop 始终可见。
负载柱只在 intent 天花板和 stop handle 下上升。
视觉注记 · wave
章节 76 · flexibility
柔韧 Client 会活下来
僵硬 client 会被 latency、retry 和 Broker policy 打断。柔韧 client 暴露 backoff、session 设置和 will 行为，让失败可以弯曲。
柔韧 client 弧线绕过 latency 结。
视觉注记 · qos
章节 77 · balance
平衡流量
MQTT 流量是 publish rate、subscription demand、QoS 和 Broker capacity 的平衡。Mqttable 在失衡变成指责前让它可见。
publish 与 subscribe 重量在 QoS 横梁上平衡。
视觉注记 · wave
章节 78 · softness
柔软 Packet 磨平坚硬问题
小而成形良好的 probe，比喧闹测试更能解决问题。有界 publish、passive doctor 或安全 trace read 能穿透硬事故。
柔软 probe 水滴在坚硬故障块中切出路径。
视觉注记 · trace
章节 79 · incident-review
解决后，留下共识
图表变绿时，事故还没有结束。持久化脱敏 report、timeline 和 replay candidate，让记忆不要清零。
已解决 trace 编织成保存的 report 结。
视觉注记 · lattice
章节 80 · small-team
小团队和本地工具
小团队也能用 local-first 工作台、清晰文档和紧凑 agent workflow 做好 MQTT 运维。更多平台不自动等于更多智慧。
小工作区网格把 Broker、docs、agent 和证据放在近处。
视觉注记 · mcp
章节 81 · service
道是服务，不是竞争
Mqttable 不需要盖过 Broker、CLI 或 agent 的声音。它通过让 MQTT 证据更安全、更清晰、更易分享来服务。
服务粒子围绕 Broker 对齐，而不争夺中心。