niuniu的博客

物联网设备控制小程序：从使用到设备接入

Mon, 08 Jun 2026 00:00:00 GMT

这个小程序是给 50 到 60 人规模的小团队使用的设备控制工具。它的目标不是做复杂的大平台，而是让团队成员能稳定地登录、绑定设备、查看状态、下发命令，并把常用操作沉淀成任务或模板。

<p> <a href="#完整设备示例" style="display:inline-flex;align-items:center;justify-content:center;padding:12px 18px;border-radius:10px;background:#007a6c;color:#fff;font-weight:700;text-decoration:none;">查看完整接入示例</a> </p>

小程序能做什么

微信一键登录，首次使用访问码绑定身份，后续直接登录。
管理员维护访问码、团队人数上限和允许名单。
用户手动绑定设备，可选择个人可见或团队共享。
查看设备在线状态、最近上报时间和状态数据。
下发设备命令，例如开关、模式切换、参数设置和请求链接。
创建手动任务、任务模板和自动任务。
自动任务支持两种触发表达：定时触发和钩子触发。

为什么不是只支持 ESP32

ESP32-S3 只是当前固件示例。真正的接入协议是 HTTP JSON，所以树莓派、Linux 网关、Windows 上位机、其他联网 MCU，甚至一段 Python 脚本都可以接入。

设备只要能完成三件事就行：

定期上报状态。
主动拉取待执行命令。
执行后回写成功或失败。

这种设计适合弱服务器，因为服务器不需要和每台设备保持长连接，小程序也不需要高频直连设备。

设备接入流程

1. 上报状态

设备定期请求：

POST https://api.niuhaoyu.xyz/api/device/{deviceId}/status

请求体示例：

{
  "online": true,
  "status": {
    "power": "on",
    "temperature": 26.5,
    "mode": "eco"
  }
}

2. 拉取命令

设备轮询：

GET https://api.niuhaoyu.xyz/api/device/{deviceId}/commands/next

如果有命令，服务器会返回类似数据：

{
  "id": "cmd-xxx",
  "command": {
    "type": "setPower",
    "payload": {
      "power": "off"
    }
  }
}

3. 回写结果

执行完成后请求：

POST https://api.niuhaoyu.xyz/api/device/{deviceId}/commands/{commandId}

成功示例：

{
  "status": "success",
  "result": {
    "power": "off"
  }
}

失败示例：

{
  "status": "failed",
  "message": "unsupported command"
}

任务系统怎么理解

小程序里只需要理解两类任务：

手动任务：用户点击后立即执行。
自动任务：保存成规则，由定时或钩子触发。

模板不是任务类型，它只是常用操作的保存方式。比如“打开电源 10 秒后关闭”可以保存成模板，需要时一键执行；“每天 08:00 打开设备”则应该保存成自动任务。

常用命令类型

类型	用途	Payload 示例
`setPower`	开关	`{"power":"on"}`
`setMode`	模式切换	`{"mode":"eco"}`
`setValue`	参数设置	`{"key":"threshold","value":50}`
`httpRequest`	让设备请求一个链接	`{"method":"GET","url":"https://example.com/action"}`

完整设备示例

下面示例可以在电脑、树莓派或普通 Linux 网关上运行。真实项目里不要把设备 token 写进公开仓库，应该从环境变量或本地安全配置读取。

import json
import os
import time
import urllib.request

API_BASE = os.getenv("IOT_API_BASE", "https://api.niuhaoyu.xyz/api")
DEVICE_ID = os.getenv("IOT_DEVICE_ID", "demo-python-001")
DEVICE_TOKEN = os.getenv("IOT_DEVICE_TOKEN", "replace-with-device-token")


def request_json(path, method="GET", payload=None):
    data = None
    if payload is not None:
        data = json.dumps(payload).encode("utf-8")
    req = urllib.request.Request(
        API_BASE + path,
        data=data,
        method=method,
        headers={
            "Content-Type": "application/json",
            "Authorization": "Bearer " + DEVICE_TOKEN,
        },
    )
    with urllib.request.urlopen(req, timeout=8) as resp:
        return json.loads(resp.read().decode("utf-8"))


def report_status(state):
    return request_json(
        "/device/%s/status" % DEVICE_ID,
        method="POST",
        payload={
            "online": True,
            "status": state,
        },
    )


def next_command():
    result = request_json("/device/%s/commands/next" % DEVICE_ID)
    return (result.get("data") or {}).get("command")


def finish_command(command_id, status, result=None, message=""):
    payload = {"status": status}
    if result is not None:
        payload["result"] = result
    if message:
        payload["message"] = message
    return request_json(
        "/device/%s/commands/%s" % (DEVICE_ID, command_id),
        method="POST",
        payload=payload,
    )


def execute(command, state):
    command_type = command.get("type")
    payload = command.get("payload") or {}

    if command_type == "setPower":
        state["power"] = payload.get("power", "off")
        return True, state, ""

    if command_type == "setMode":
        state["mode"] = payload.get("mode", "normal")
        return True, state, ""

    if command_type == "setValue":
        key = payload.get("key", "value")
        state[key] = payload.get("value")
        return True, state, ""

    return False, state, "unsupported command: %s" % command_type


def main():
    state = {
        "power": "off",
        "mode": "normal",
        "temperature": 26.5,
    }
    while True:
        report_status(state)
        item = next_command()
        if item:
            command_id = item.get("id")
            command = item.get("command") or {}
            ok, state, message = execute(command, state)
            if ok:
                finish_command(command_id, "success", result=state)
            else:
                finish_command(command_id, "failed", message=message)
        time.sleep(3)


if __name__ == "__main__":
    main()

小程序使用建议

首次使用时先完成微信登录和访问码绑定。添加设备时，如果只是自己调试，选择“个人可见”；如果团队都要用，选择“团队共享”。设备上线后，先在设备详情页确认状态能刷新，再创建任务。

手动任务适合立即控制。自动任务适合规则化场景，例如每天固定时间执行，或者后续由设备告警、传感器阈值、外部 HTTP 事件触发。

母亲节，我做了一个交互网页

Sun, 10 May 2026 00:00:00 GMT

今年母亲节，我想送妈妈一份不一样的礼物。

不是鲜花，不是蛋糕，而是一个打开就能感受到心意的交互网页。从构思到实现，我用了一个下午。但我觉得，这是今年母亲节我做的最值的一件事。

从一盏灯开始

故事的起点是一句很简单的想法：

"为她点一盏灯"

页面的前几秒是安静的——深紫色的夜空中，八十颗星星缓缓眨着眼。触碰屏幕，金色的萤火虫从指尖流淌而出，汇聚成一条光河，引向一盏若隐若现的灯笼。

那盏灯笼上写着：「为妈妈点一盏灯」

当指尖触碰灯笼

点击的瞬间——

整个画面被暖金色的光芒吞没，五彩纸屑从四面八方炸裂开来，带着⭐星星和✨光点。四层极光在背景中缓缓漂移，钢琴旋律从耳机里流淌而出。

然后，祝福的文字从模糊中渐渐清晰：

妈妈

谢谢你用一生的温柔，照亮了我所有的路

🌸 永远爱您 🌸

—— 你的孩子

花瓣、爱心、蝴蝶漫天飘落。整个过程大约 10 秒，但那种被爱包围的感觉，会一直留在心里。

这一切，只用了一个 HTML 文件。打开即用，无需安装，无需网络。

背后的设计细节

🎨 视觉

深暖紫基调，配金色萤火虫粒子，营造静谧温柔的氛围
80 颗闪烁星星散布背景，像童年的夏夜
四层极光漂移，鼠标移动时产生视差深度感
惊喜后淡入 复古花卉背景，母亲节快乐已在图中

🎵 听觉

用 Web Audio API 完全用代码合成了一首简短的钢琴摇篮曲：

C 大调五声音阶旋律，温暖柔和
暖音垫和弦铺垫，像妈妈的怀抱
点击瞬间还有 烟花爆炸音效——BOOM！CRACK！噼啪闪烁！

✨ 技术亮点

特性	实现
粒子系统	Canvas 自绘萤火虫光流，带渐变辉光和连线
五彩纸屑	canvas-confetti 库，5 波连爆 + 星星形状 + 金雨
背景音乐	Web Audio API 合成，零外部依赖
烟花音效	Web Audio API 合成（低频 boom + 噪声 crack + 高频 sparkle）
响应式	移动端优先，触摸事件完整支持
重放	可反复点击重新体验

体验一下

点击下面的按钮，打开这个小小的交互世界。建议戴上耳机，调大音量，然后 触碰屏幕，找到那盏灯笼 ✨

<a href="/games/Mather/index.html" target="_blank" style="display: inline-block; padding: 16px 36px; background: linear-gradient(135deg, #f43f5e, #ec4899); color: #fff; text-decoration: none; border-radius: 50px; font-size: 20px; font-weight: bold; letter-spacing: 4px; box-shadow: 0 4px 25px rgba(244,63,94,0.4); transition: all 0.3s ease;"> 🏮 为妈妈点一盏灯 </a>

一点想说的话

我们总说"爱要表达"，但有时候千言万语不如一个精心准备的瞬间。

这个网页只有几十 KB，但它承载的是我想对妈妈说的所有话：

谢谢你。我爱你。

如果你也想给妈妈做点什么，不妨从一个小小的网页开始——代码也可以很温暖。

Happy Mother's Day 💝

近期单曲循环：我的音乐推荐

Sun, 03 May 2026 00:00:00 GMT

近期单曲循环

最近整理了一份自己常听的歌单，风格跨度还挺大的——从 F1 电影原声到古惑仔经典，从英雄联盟虚拟乐团到 Beyond 不朽名曲。分享给你，希望也有你喜欢的！

🎵 歌单目录（直接播放）

快乐崇拜最近搞机器人一直在听，还挺好听，一会把视频发过来、

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=2076688961"}

1. Lose My Mind (feat. Doja Cat) [From F1® The Movie]

Don Toliver / Doja Cat

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=2700280437"}

F1 电影原声带，Don Toliver 联手 Doja Cat，节奏感炸裂，适合开车时听。

2. My Dilemma 2.0

Selena Gomez & The Scene

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=29747527"}

Selena 经典老歌的 2.0 版本，"One half of me wants ya, and the other half wants to forget"——太有共鸣了。

3. INDUSTRY BABY

Lil Nas X / Jack Harlow

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=1862710350"}

2021 年的神曲，到现在听还是那么带劲，Lil Nas X 的才华真的没话说。

4. My Love

Westlife

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=2080607"}

经典中的经典，"So I say a little prayer..." 前奏一响，青春就回来了。

5. GIANTS

True Damage / Becky G / Keke Palmer / (G)I-DLE 田小娟

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=1402845242"}

英雄联盟虚拟乐团 True Damage 的出道曲，2019 年全球总决赛现场首唱，炸裂全场！

6. Sweet but Psycho

Ava Max

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=1300528275"}

"She's sweet but a psycho"——又甜又疯的旋律，太上头了。

7. 乱世巨星

陈小春

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=4878122"}

"叱咤风云我任意闯万众仰望"——古惑仔的经典，男人味拉满。

8. 天下

张杰

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=1465225544"}

"烽烟起寻爱似浪淘沙"——张杰的武侠风代表作，大气磅礴。

9. 水手

郑智化

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=190381"}

"他说风雨中这点痛算什么，擦干泪不要怕，至少我们还有梦"——永远的励志经典。

10. 海阔天空

Beyond

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=1357375695"}

"原谅我这一生不羁放纵爱自由"——无需多言，华语乐坛最伟大的歌曲之一。

11. 红日

李克勤

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=115502"}

"命运就算颠沛流离，命运就算曲折离奇"——正能量满满，听了就有力量。

12. 烂泥

许志安

::music{meting="https://meting.spr-aachen.com/api?server=netease&type=song&id=411314656"}

"愿可做你脚下那堆烂泥"——林夕的词，卑微到骨子里的深情。

💬 写在最后

这 12 首歌是我最近反复在听的，有燃的、有柔的、有经典的、有新潮的。如果你也有好歌推荐，欢迎在评论区留言互相分享！🎧

洗脚城初体验：一个纯情少年的"足"迹之旅

Tue, 26 May 2026 00:00:00 GMT

一、缘起

活了二十多年，江湖上关于"洗脚城"的传说听了无数——

有人说那是谈生意的第二战场，有人说那是比家里沙发还舒服的地方，还有人说……咳，反正说什么的都有。

作为一个从未踏足过洗脚城的"纯情少年"，我终于在今天鼓起勇气，决定亲自去一探究竟。

毕竟，人生总要有很多第一次嘛。

想象中的洗脚城包厢，大概就是这样的吧？

二、进门：社恐人的地狱开局

推开那扇玻璃门的一瞬间，我差点转身就走。

为什么？

前台小姐姐笑脸相迎："先生您好！有预约吗？"
我："呃……没、没有……"
小姐姐笑得更灿烂了："没关系，这边请~"

然后我就被领到了一个宽敞的大厅，装修得金碧辉煌，空气中飘着淡淡的精油香气。

这氛围感，怎么说呢——比我预想的要正经一万倍。

大厅休息区，比我想象中豪华多了

三、选项目：选择困难症发作

接待的小姐姐递过来一本菜单……不，是项目单。

我看了一眼，好家伙：

💧 经典足浴（¥98）—— 基础款，适合小白
🌿 中药足浴（¥128）—— 养生党首选
💎 至尊豪华足疗套餐（¥298）—— 这是大佬的项目
🧖 全身SPA+足疗（¥398）—— ……我还没准备好

作为一个体面人，当然是选 经典足浴 啦。来都来了，先体验一下基础操作。

四、泡脚：比想象中舒服一万倍

换好拖鞋（那拖鞋还挺软乎），我被带进了一个灯光温暖的包间，两张按摩椅并排放着。一位技师大哥（幸好是大哥，不然我更紧张）走了进来，端着热气腾腾的木桶。

桶里飘着几片艾草和姜片，热水冒着氤氲的蒸汽。

"先生，水温合适吗？" "……合适合适。" （其实烫得脚趾头都在打架，但我不敢说😭）

就是这个感觉！泡进去的一瞬间，整个人都化了

过了一会儿脚适应了水温，那种温热从脚底蔓延到全身的感觉……怎么说呢，就像冬天钻进刚晒过的被窝，又像喝下第一口热汤，整个人一下子就松了。

五、按摩：笑与痛的边缘

泡了大概二十分钟，技师大哥开始上钟了。

他先是用毛巾把我的脚擦干，然后涂上按摩精油，开始按脚底的穴位。

我发誓，那一刻我差点叫出声。

不是舒服的——是痛！

"啊！轻点轻点！" "先生，这里是你的肝反射区，说明你肝火有点旺啊，平时熬夜吧？" "……你怎么知道的？"

他又按到另一个地方。 "啊！" "这里对应你的胃，吃饭不规律吧？" "…………"

原来洗脚城才是最好的体检中心。

你的身体哪里不好，技师一按就知道了，根本不用去医院。

专业足疗按摩，痛并快乐着

按着按着，痛感退去，取而代之的是一种难以言喻的酸爽。像是一个结被解开了，一股暖流从脚底往上窜。那一刻我终于理解了——

那些天天往洗脚城跑的中年男人，不是去洗脚的，是去续命的。

六、最后的最后

全程大概80分钟，从进门到出门。

走出洗脚城的时候，我感觉自己走路都轻了三斤，脚下像踩了棉花一样轻飘飘的。

回头看了一眼那闪闪发光的招牌，我心里默默说了一句： "对不起，以前是我太年轻了。下周我还来。"

以上就是本纯情少年的洗脚城初体验报告。结论：真香。

自动部署测试

Tue, 26 May 2026 00:00:00 GMT

🚀 自动部署测试

如果你能看到这篇文章，说明以下所有环节都正常工作：

graph TD
    A[本地 git push] --> B[GitHub 收到推送]
    B --> C[Webhook 通知服务器]
    C --> D[服务器 git pull]
    D --> E[pnpm build]
    E --> F[替换静态文件]
    F --> G[✅ 部署成功]

✅ 验证清单

步骤	说明	状态
📤 本地提交	`git add` + `git commit`	✅
☁️ 推送到 GitHub	`git push`	✅
🔔 Webhook 触发	GitHub → 服务器	✅
📥 拉取代码	`git pull`	✅
🔨 构建项目	`pnpm build`	✅
🚚 替换静态文件	`mv dist/*`	✅

🎉 自动部署管线测试通过！ 以后再也不用手动部署了。

520，送自己一个手柄

Wed, 20 May 2026 00:00:00 GMT

520，送自己一个手柄

今天是 520，满大街都是送花送礼物给别人的。但谁说 520 只能送给别人呢？

我决定——送自己一个手柄 🎮

开箱初印象

到手的第一感觉就是：这分量，值了！ 包装很扎实，打开之后手柄的质感比想象中还要好。握持手感很舒服，按键反馈清脆，摇杆顺滑度也不错。

这个价位的国产手柄，做工真的超出预期。接上电脑试了试，即插即用，延迟完全感觉不到。

为什么是今天？

其实手柄早就想买了，一直犹豫。正好赶上 520——谈什么恋爱，不如打游戏。

与其花钱请别人吃饭、送别人礼物，不如给自己添一套实实在在的装备。毕竟：

手柄是握在手里的快乐，谁也拿不走。

玩什么？

接下来准备用手柄通关几个吃灰已久的游戏：

动作类游戏终于不用键盘按到手抽筋了
赛车游戏扳机键手感拉满
有空再重温一遍《黑神话》

写在最后

520，有人送花，有人送包，我送自己一个手柄。

对自己好一点，不需要等别人来送。想要的快乐，自己给自己。

Happy 520 🎮

用ai做了个2048小游戏，来试试吧

Sun, 03 May 2026 00:00:00 GMT

在线直接玩

👇 点击下方按钮，打开独立页面玩游戏

<a href="http://162.211.183.142/games/game1/" target="_blank" style="display: inline-block; padding: 12px 28px; background: #2ecc71; color: #fff; text-decoration: none; border-radius: 10px; font-size: 18px; font-weight: bold; box-shadow: 0 4px 12px rgba(0,0,0,0.15); transition: all 0.3s ease;"> 🎮 点击开始游戏

</a>

游戏介绍

一个用 Deepseek-v4-Flash + Charry studio 智能体制作的智能2048游戏。支持手动模式和自动模式，内置 3 种智能算法，快来试试吧！

欢迎在评论区留下你的最高分数！

niuniu的博客

物联网设备控制小程序：从使用到设备接入

小程序能做什么

为什么不是只支持 ESP32

设备接入流程

1. 上报状态

2. 拉取命令

3. 回写结果

任务系统怎么理解

常用命令类型

完整设备示例

小程序使用建议

母亲节，我做了一个交互网页

从一盏灯开始

当指尖触碰灯笼

背后的设计细节

🎨 视觉

🎵 听觉

✨ 技术亮点

体验一下

一点想说的话

近期单曲循环：我的音乐推荐

近期单曲循环

🎵 歌单目录（直接播放）

快乐崇拜 最近搞机器人一直在听，还挺好听，一会把视频发过来、

1. Lose My Mind (feat. Doja Cat) [From F1® The Movie]

2. My Dilemma 2.0

3. INDUSTRY BABY

4. My Love

5. GIANTS

6. Sweet but Psycho

7. 乱世巨星

8. 天下

9. 水手

10. 海阔天空

11. 红日

12. 烂泥

💬 写在最后

洗脚城初体验：一个纯情少年的"足"迹之旅

一、缘起

二、进门：社恐人的地狱开局

三、选项目：选择困难症发作

四、泡脚：比想象中舒服一万倍

五、按摩：笑与痛的边缘

六、最后的最后

自动部署测试

🚀 自动部署测试

✅ 验证清单

520，送自己一个手柄

520，送自己一个手柄

开箱初印象

为什么是今天？

玩什么？

写在最后

用ai做了个2048小游戏，来试试吧

在线直接玩

游戏介绍

快乐崇拜最近搞机器人一直在听，还挺好听，一会把视频发过来、