diff --git a/README.md b/README.md
new file mode 100644
index 0000000..102eda4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# mvp-remote
+
+自研远程桌面控制软件（办公场景），技术路线参考网易 UU 远程逆向分析结论。
+
+## 架构
+
+| Crate | 角色 | 说明 |
+|---|---|---|
+| `common` | 协议库 | 控制消息 / 视频帧线格式，三端共享契约 |
+| `agent` | 被控端 | DXGI 屏幕采集 + openh264(H.264) 编码 + QUIC 服务 + SendInput 键鼠注入 |
+| `viewer` | 主控端 | QUIC 客户端 + openh264 解码 + minifb 渲染 + 键鼠采集 + 延迟 HUD |
+
+## 构建
+
+```bash
+cargo build --release
+```
+
+产物：`target/release/agent.exe`（被控端）、`viewer.exe`（主控端），需附带 3 个 mingw 运行库 DLL（libstdc++-6 / libgcc_s_seh-1 / libwinpthread-1）。
+
+## 运行
+
+```bash
+# 被控机
+agent.exe --port 47800 --code 123456
+# 主控机
+viewer.exe --addr <被控机IP> --port 47800 --code 123456
+```
+
+详见《构建运行手册.md》与《Git协作规范.md》。