Skip to content

Commit 75a00e7

Browse files
committed
docs: drop ASCII architecture diagrams in favor of arch.png
ASCII renders unevenly outside monospace contexts (mobile reddit, weibo, zhihu, twitter). The PNG was already next to each ASCII block; keeping both was redundant and the ASCII added noise on mobile. SPEC.md keeps its ASCII frame layout (intended for technical reference in monospace contexts). twitter.md em-dashes are inline punctuation, not diagrams; left untouched.
1 parent 26dc1a7 commit 75a00e7

3 files changed

Lines changed: 14 additions & 26 deletions

File tree

.github/announce/reddit_localllama.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -56,13 +56,12 @@ local LLM, cheap hardware, no cloud, MCP-compatible.
5656
5757
## What's on the wire
5858
59-
```
60-
LLM ── MCP ──▶ Bridge (asyncio) ── 19B wire frame ──▶ ESP32
61-
62-
├─ capability token (HMAC-SHA256, scoped, expiring)
63-
├─ range / type / unit check from manifest
64-
└─ dry-run as a wire-format bit (kind=0x81)
65-
```
59+
![DCP architecture: LLM ↔ MCP ↔ Bridge ↔ DCP wire ↔ Device](https://raw.githubusercontent.com/device-context-protocol/dcp/main/docs/paper/figures/arch.png)
60+
61+
The Bridge is the sole trust boundary. On every call it verifies the
62+
capability token (HMAC-SHA256, scoped, expiring), checks range/type/unit
63+
against the manifest, and supports dry-run as a wire-format bit
64+
(kind=0x81). Devices never see a byte that hasn't been screened.
6665
6766
Wire frame: 6-byte fixed header + CBOR map + optional 16-byte HMAC.
6867
A `set_brightness(50)` call is 19 bytes. MCP JSON-RPC equivalent

.github/announce/zhihu.md

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,15 +33,9 @@ DCP 把 LLM 安全相关的几件事直接做进了**协议层**,不是 applicat
3333

3434
### 架构
3535

36-
```
37-
LLM ── MCP ──▶ Bridge(唯一可信边界)── DCP wire ──▶ Device
38-
39-
├─ 容量 token 校验
40-
├─ 范围/类型检查
41-
└─ dry-run 预演
42-
```
36+
![DCP 架构图](https://raw.githubusercontent.com/device-context-protocol/dcp/main/docs/paper/figures/arch.png)
4337

44-
Bridge 是个 Python 进程,你的 LLM(Claude/本地模型/其他)说 MCP,Bridge 翻译成 DCP 喊设备。**设备永远收不到 LLM 直发的命令**
38+
Bridge 是个 Python 进程,你的 LLM(Claude / 本地模型 / 其他)说 MCP,Bridge 翻译成 DCP 喊设备。Bridge 在每次调用前校验 capability token、范围/类型/单位、支持 dry-run 预演**设备永远收不到 LLM 直发的命令**
4539

4640
### 现在能做什么
4741

README.md

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -56,17 +56,12 @@ out of the box. DCP is the last mile to physical hardware.
5656

5757
![DCP architecture](docs/paper/figures/arch.png)
5858

59-
```
60-
LLM ── MCP ──▶ Bridge ── DCP wire ──▶ Device(s)
61-
62-
├─ issues capability tokens
63-
├─ enforces rate limits, ranges
64-
└─ logs, dry-runs, undo
65-
```
66-
67-
The Bridge is the sole trust boundary. Devices remain simple enough to
68-
fit on commodity microcontrollers; everything the LLM is allowed to do
69-
is enforced before any byte traverses the device boundary.
59+
The Bridge is the sole trust boundary. On every call it issues and
60+
verifies capability tokens, enforces range/type/unit checks from the
61+
manifest, and supports dry-run as a wire-format primitive. Devices
62+
remain simple enough to fit on commodity microcontrollers; everything
63+
the LLM is allowed to do is enforced before any byte traverses the
64+
device boundary.
7065

7166
## Validated on real hardware
7267

0 commit comments

Comments
 (0)