2026-04-30 变更日志¶

摄取 claude-desktop-buddy vs sentino-iot-sample 架构对比¶

来源：raw/notes/2026-04-30-claude-desktop-buddy-vs-sentino-iot-sample-architecture.md（基于本地两份代码的逐文件对比；buddy = Anthropic 2026-04-20 开源 anthropics/claude-desktop-buddy，公开；sentino-iot-sample = sentino-jp/sentino-iot-sample，private，本地路径 ~/local/Conversational-AI-IOT-Sample/ 保留旧名因 fork 自 Shengwang-Community/Conversational-AI-IOT-Sample）

新建页面¶

• concepts/claude-desktop-buddy — 核心新概念。Anthropic BLE 协议参考实现的独立知识节点：定位（协议是产品 / 固件是示例 / "best contribution is a fork"）+ 七项关键事实（NUS 标准 UUID + newline JSON + LE Secure Connections + Heartbeat snapshot 协议消息 + folder push 内容无关传输 + 1265 行单文件代码组织 + ASCII / GIF 双字符模式 + CONTRIBUTING.md 反贡献姿态）+ 与 sentino-iot-sample 完整对比表（11 行维度对照）+ 协议优先 vs 平台优先设计哲学升华 + 5 条 take-away（Anthropic MCP+buddy 同一套路复刻 / NUS 选型反发明 UUID / 加密委托 OS 协议栈更省力 / 设备身份是云存在性的直接函数 / CONTRIBUTING 反贡献降低 maintenance 成本）

关键知识提取¶

1. Anthropic 两次执行"协议优先"路线，buddy 是第二次复刻 — 第一次是 mcp-protocol 软件协议层（开放协议 + 自家 Claude Code 是最佳实现），buddy 是硬件协议层的同一套路（开放 BLE 协议 + M5StickC Plus 是参考固件）。这升级了 mcp-protocol "标准开放，最佳实现封闭"判断的证据级——从单一案例升到两次独立执行的同一方法论，是结构性而非个案性的 Anthropic 策略 → 与 mcp-protocol 的连接：在"与 Harness Engineering 的关系"段后新增"buddy 是同一方法论在硬件场景的复刻（2026-04-30）"段（含 MCP / buddy 套路对照表 + Anthropic 协议优先派双案例证据 + 与 platform-layer-collapse 模型公司吞应用层趋势的关系）

2. buddy 用 Nordic UART Service 是"反发明 UUID"姿态的具体形态 — 代码注释明说："every BLE serial example uses these, so existing tools (nRF Connect, bluefy, Web Bluetooth examples) can talk to us without custom UUIDs"。这是"用别人已用的名字而不是发明新名字"的反向应用——很多硬件厂商出于"差异化 / 平台锁定"会发明新 UUID（比如 sentino-iot-sample 用 0x1910 + 0xA101），buddy 选业界事实标准是明确的反向选择，让 maker 用业界工具能直接 talk → 与 naming-shapes-thinking 的连接：是"命名塑造思维"的反面应用——选别人已用的名字降低认知负担也降低生态门槛；buddy 是该原则在硬件 UUID 选型上的具体形态

3. buddy 加密委托 OS BLE 协议栈是工程上更省力的方案 — LE Secure Connections + MITM + Bond 模式让 OS 协议栈帮做了所有事（密钥协商 / 防重放 / 抗 MITM / Bond 持久化 / AES-CCM 链路加密），应用层只需 mark 特征 ENCRYPTED + 选 SC_MITM_BOND 模式 + 显示 6 位 passkey。对比之下 sentino-iot-sample 的"应用层声称 AES-ECB 但实际工具走 plaintext"反而更复杂且实际不安全——web-app/js/app.js:370 注释明说 "Skip encryption, send plaintext"。Sentino 生产固件如果要启用 BLE 加密，应当评估直接走 LE Secure Connections + Bond 路线 → 与 ble-provisioning 的连接：在"相关概念"前新增"另一种 BLE 协议设计参考"整段（含 5 行维度对比表 + NUS vs V1 帧的适用场景判断 + 加密姿态对照）；为 Sentino 生产固件加密路线决策提供工程上的反向参照

4. 设备身份的有/无是云存在性的直接函数 — buddy 没云所以不需要身份（OS BLE bond 即够），sentino-iot-sample 有云所以必须三元组 + HMAC（云端要鉴权设备）。这不是工程选择对错，是云存在性的结构性后果。任何想做"开放硬件协议但又有云能力"的厂商需要回答的关键问题：身份系统怎么设计才不绑死客户。Anthropic 的答案是"不做云，所以不用回答"——回避问题；Sentino 必须回答（三元组 / HMAC / 自家账号体系全打 Sentino 烙印），平台中立性弱 → 与 sentino-iot 的连接：本判断的具体含义放在新增的"对照样本"小节里（不在 sentino-iot 主架构段插入）；与 iot-platform-fundamentals 的连接：buddy 因为没云所以不在该体系内，是"反例对照"——可以作为 IoT 平台 vs 无平台 BLE 设备的边界判断

5. buddy 的 CONTRIBUTING.md "反贡献"姿态降低 maintenance 成本 — 31 行明说"best contribution is a fork"，明确拒收新功能 / 新板移植 / refactor / 依赖升级。开源项目最大的成本通常不是写代码，是审 PR + 拒绝功能 + 兼容老用户。buddy 直接说"fork it"，把这部分成本完全推开。Anthropic 知道自己不想长期维护一个固件项目的清醒判断 → 这是 Anthropic 的 maintenance 成本管理策略，单独不构成 wiki 节点（是工程 ops 经验），但放在 buddy 概念页 take-away 中

6. 两种"BLE + 设备"哲学没有谁对谁错——商业模式决定 — 协议优先派（buddy / MCP）省固件复杂度但需要协议本身有商业价值（Anthropic 模型才是赚钱来源）；平台优先派（sentino-iot / Tuya）省客户决策但必然需要厂商持续维护整链路（FAE / 售后 / 多客户配置）。Sentino 选平台优先并非反 best-practice——是商业模式决定的。但 web-app 配网工具可以学 buddy "REFERENCE.md 是契约"姿态，把 BLE V1 帧明确写成对外协议文档（已部分做到 raw/snippets/iot-docs/ref-ble.md），让客户能自己 fork 配网工具 → 与 sentino-iot 的连接：在"经验教训"段后新增"对照样本：claude-desktop-buddy（协议优先派）"整段（含 7 行维度对照表 + 商业模式决定哲学的判断 + 对 Sentino web-app 配网文档对外开放的具体启示）

更新页面¶

• projects/sentino-iot — 新增"对照样本：claude-desktop-buddy（协议优先派）"整段（7 行对比表 + 商业模式决定的哲学判断 + 对 Sentino web-app 配网文档对外的具体启示）+ 新增"关于 sentino-iot-sample 命名"小节明确正式名 vs 本地路径别名 vs fork 来源；相关概念加 claude-desktop-buddy；sources 加新 raw；updated → 2026-04-30
• concepts/ble-provisioning — "相关概念"前新增"另一种 BLE 协议设计参考：claude-desktop-buddy"整段（5 行维度对比表 + NUS vs V1 帧的适用场景判断 + 加密姿态对照）；相关概念加 claude-desktop-buddy；sources 加新 raw；updated → 2026-04-30
• wiki/index.md — Sentino 平台与基础分区追加 claude-desktop-buddy 条目（突出"协议优先 vs 平台优先反向对照样本"的对比价值）；最近更新追加 2026-04-30 单行

事实核查记录¶

• WebSearch "claude desktop buddy github anthropics M5StickC repository launch date" → 完全核实
• 仓库 anthropics/claude-desktop-buddy 公开，Apache-2.0
• 开源时间 = 2026-04-20（UTC+8，KuCoin / 36Kr 类等多源中文媒体一致）
• 描述："Reference and an example for the Bluetooth API for makers in Claude Cowork & Claude Code Desktop"
• 参考硬件 = M5StickC Plus（ESP32 + 135x240 TFT + AXP192 PMU + MPU6886 IMU + 两按键 + LED）
• 已有第三方 fork（如 vthinkxie/claude-desktop-buddy-esp32-s3-touch-amoled-1.8）—— 印证"fork it and make it yours"姿态被社区接受

• 主要来源：GitHub anthropics/claude-desktop-buddy / DeepWiki anthropics/claude-desktop-buddy / Medium - Anthropic Just Open-Sourced the Claude Hardware Buddy / KuCoin 公告快讯

• 代码内核查（不通过 WebSearch，直接 Read 本地文件）：

• NUS UUID 定义：src/ble_bridge.cpp:13-15 三个 UUID + 注释明说选业界标准的动机
• 加密 mark：src/ble_bridge.cpp:106-125 完整 LE Secure Connections + DisplayOnly + Bond + ENCRYPTED 特征
• 1265 行 main.cpp：wc -l src/main.cpp = 1265 实测
• REFERENCE.md 行数：225 行（225 vs 226 取实测 225）
• CONTRIBUTING.md 行数：31 行
• sentino V1 帧定义：web-app/js/packet.js:1-7 注释 "V1 BLE Framing Protocol (ref-ble.md Section 4)"
• sentino "Skip encryption, send plaintext"：web-app/js/app.js:370-376 注释明说

• sentino 三元组 / HMAC：CLAUDE.md "平台身份模型"段明说

• 客户文档陷阱检查：本素材是两份代码的对比 + 用户提供的设计哲学升华，不是客户向 PRD/RFP/提案/合同，不触发该专项检查。涉及的第三方品牌名（M5StickC Plus / ESP32 / Arduino / Nordic UART Service / Agora / Tuya / 腾讯云 IoT Explorer）都是事实陈述（实际产品 / 实际框架 / 实际协议名 / 实际平台名），不是"客户已选型"问题

与同期 wiki 的时点关系¶

• 2026-04 是 Anthropic 两次执行"协议优先"方法论的紧凑窗口 — 4-23 Anthropic 官方博客《Building agents that reach production systems with MCP》（mcp-protocol 的 SDK 月下载 1 亿→3 亿、Tool Search、Programmatic Tool Calling、Cloudflare 2 工具覆盖 2500 端点），4-20 buddy 开源（硬件协议层）。两次发布相隔 3 天，是同一方法论在两个层面的紧凑执行。本次摄取把这两个事件放到"Anthropic 协议优先派双案例"框架下，升级了 wiki 对 Anthropic 战略一致性的判断
• 本次是 wiki 第一次摄取"代码对比"类素材 — 之前 30+ 篇 raw 主要是访谈 / 文档 / 政策评论 / 架构分析。代码对比是稀缺类型——它的事实密度极高（每个论点都可以指到具体文件路径采证），适合做"两种方案的设计哲学对照"。这种摄取的连接产物（buddy 概念页 + 11 行对照表）信息密度比文字摄取高
• buddy 摄取的间接价值：升级 sentino-iot 的"商业模式自洽性"判断 — sentino-iot-sample 的"平台中立性弱、协议 / URL / 三元组都打 Sentino 烙印"原本可能被读为"工程不够好"。本次对比明确：这不是工程选择对错，是商业模式决定的结构性后果。Sentino 卖云服务 / 卖整体方案，必然要整链路一体；Anthropic 卖模型 / 拉硬件生态，必然要协议优先。两种姿态不可互换。这是 sentino-iot 项目页"经验教训"段的隐含升级——增强了"为什么我们这样做"的自洽叙事

元观察¶

• Anthropic 用同一方法论复刻两次，是结构性证据而不是单一观察 — 4-23 MCP 战略反击文 + 4-20 buddy 开源是 2026-04 同一周内两个独立验证点。如果只看 MCP 一个案例可能被读为"Anthropic 在 software 协议层赌生态"，加上 buddy 后升到"Anthropic 把'开放协议 + 自家最佳实现'作为通用方法论复用"。两次独立执行支持的方法论判断比单一执行强 3-5 倍
• 代码对比类摄取的连接密度可控 — 本次产生 1 个新建页 + 2 个更新页 + index 1 行 + journal 1 节 = 5 处变更，连接密度适中。与最近 4-29 的两次大型摄取（Kim Graves 11 个变更 / Manus 案 9 个变更）相比明显小，但每个变更的事实密度高（每条断言都可以指到具体代码行）。下次摄取代码对比类时不必强求扩散——有 3-5 个高密度连接比 10 个稀疏连接更有价值
• "协议优先 vs 平台优先"是个可独立成 concept 的判断 — 本次没有为它建独立 concept 页（避免过度概念化），但放在 buddy 概念页"设计哲学升华"段。如果未来再摄取 1-2 个新的"协议优先派"或"平台优先派"案例（比如 OpenAI Realtime API / Google ADK 协议层 / Tuya 完整方案），可以考虑抽出独立 concept 页（命名候选 protocol-first-vs-platform-first 或类似）。当前不抽，等 N=3 再判断——避免单点抽象
• 本次摄取打开了"对照样本"作为页面类型的实验 — buddy 概念页明确定位为"sentino-iot-sample 的对照样本"，而不是中立技术页。这是 wiki 第一次有页面以"对照样本"身份存在（之前的对照通常是同一概念页里的"vs"段落，比如 sentino-memex vs mem0 vs google-memory-bank）。这种独立页面 + 显式对照定位的形态，未来可以考虑用在其他"我方方案有强对照样本"的场景（比如如果未来要对比 Sentino Standalone Agent 与 OpenAI Assistants API / Google ADK，可能也走"独立对照样本页"路线）

待办¶

• 跟踪 buddy 仓库后续更新——Anthropic 自己说"not actively maintained"但社区 fork 在快速增长，观察"协议是否会被反向修订"（如果协议被改将印证或反驳"协议是产品"判断的稳定性）
• 评估 Sentino 生产固件启用 BLE 链路加密的工程路径——如果选 LE Secure Connections + Bond 模式，需要：(a) BK7258 BLE 协议栈是否支持 SC + Bond（待 firmware 同事确认） (b) Web Bluetooth API 在配对 prompt 上的体验如何 (c) bond 持久化与 Sentino factory_reset 语义的兼容
• Sentino web-app 配网协议文档是否提到对外开放级别——raw/snippets/iot-docs/ref-ble.md 已存在但是内部文档，buddy REFERENCE.md 模式给的启示是"如果想让客户自己 fork 配网工具，应当把 V1 帧 + 状态码 + bind 双信号确认明确写成 stable surface"。这是销售姿态决策，不是工程决策——待 Lawrence / Donnie 评估
• 是否摄取 Anthropic 4-20 当天的官方 launch 推文 / 博客作为补充事实源——本次只做了 WebSearch 一手核实，如果 Anthropic 有官方 launch post 解释设计动机，值得二次摄取作为"协议优先方法论"的 Anthropic 自述证据
• 关注是否有第三方做"buddy 协议接 Sentino 设备"的实验——如果 maker 社区里有人把 buddy 协议跑在 BK7258 上，将是"协议优先 vs 平台优先"两种风格能否同设备共存的实证