造物记录日期：2026-07-15
位置：[本地工程路径]
定位
微雪墨水屏的 Web Bluetooth 前端。浏览器里通过 BLE 直连 ESP32-S3，控制屏幕显示文字、日程、便签。竞赛项目的 Web 端。
架构
text
浏览器 (Chrome/Edge) ESP32-S3
┌──────────────┐ BLE ┌──────────┐
│ index.html │←────────→│ inkfeed │
│ + app.js │ JSON │ .ino │
│ + ble.js │ │ (Arduino)│
│ + ui.js │ └──────────┘
└──────────────┘
前端文件
| 文件 | 职责 |
|---|---|
index.html |
主页面，Web BT 入口 |
app.js |
UI 状态、事件绑定、JSON 校验 |
ble.js |
Web Bluetooth 连接、特征查找、读写 |
config.js |
BLE UUID 常量 |
state.js |
前端状态管理 |
ui.js |
DOM 渲染 |
lunar.js |
农历计算 |
storage.js |
localStorage 封装 |
styles.css |
界面样式 |
splash-bg.js |
启动页粒子背景 |
BLE 协议
text
设备名: INKFEED
Service: 19b10000-e8f2-537e-4f6c-d104768a1214
├── TEXT_PUSH 19b10001 ← 推送文字
├── SCHEDULE_PUSH 19b10002 ← 推送日程
├── NOTES_PUSH 19b10003 ← 推送便签
├── COMMAND 19b10004 ← 控制命令 (JSON)
└── STATUS 19b10005 ← 设备状态 (Notify)
本地调试
powershell
cd [本地工程路径]
.\serve_local.ps1 # http://localhost:8080
必须 HTTPS 或 localhost（Web Bluetooth 安全要求）。Chrome/Edge 桌面版支持。
页面功能
- 文字推送 — 打字实时发送到墨水屏
- 日程管理 — 课表/日程 JSON 格式推送到 BLE
- 便签 — 逐条追加，不超 MTU
- 农历 — 本地计算，不依赖网络
关键词
#WebBluetooth #BLE #墨水屏 #前端 #ESP32-S3 #竞赛项目
相关
所属索引 待补充 · 主页 待补充
归档索引 待补充
来源与关联索引
- 来源
- 个人知识库
- 原笔记
- 05-历史归档/旧项目/墨水屏网页控制台.md
- 资料性质
- 历史记录。原文的版本、来源与验证边界继续保留。