From 77c8e863a676e2b6fd3e35d3ffab30f72586bae6 Mon Sep 17 00:00:00 2001
From: yanyu <aibayanyu@qq.com>
Date: Wed, 8 Jul 2026 15:02:14 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E7=94=A8=E6=88=B7=E8=90=BD=E5=9C=B0?=
 =?UTF-8?q?=E9=A1=B5=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 45 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7a4dc7e..2284063 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,44 @@
-# releases
+# 翎羽笔记 · 自托管组件发布仓
 
-构建产物发布仓(install.sh 下载源)— 只放二进制包,无源码
\ No newline at end of file
+本仓库只存放**构建产物**(tar.gz + SHA256SUMS),供一键安装脚本下载,不含源码。
+
+## 一键安装 / 升级
+
+在目标 Linux 机器上执行(重复执行即为升级,配置与数据保留,失败自动回滚):
+
+### miiot — 小米 IoT MCP(设备/场景)
+
+```bash
+curl -fsSL https://git.lingyu.org.cn/lingyu-note/releases/raw/branch/main/miiot/install.sh | sudo bash
+```
+- 架构:amd64 / arm64,Go 静态二进制,零依赖
+- 端口 8677;配置 `/opt/miiot/.env`(安装时自动生成随机 token)
+
+### cloud-mcp — 聚合 MCP 网关(browser 代理 / weather / train / maps)
+
+```bash
+curl -fsSL https://git.lingyu.org.cn/lingyu-note/releases/raw/branch/main/cloud-mcp/install.sh | sudo bash
+```
+- 架构:amd64 / arm64,Go 静态二进制,零依赖
+- 端口 8550;配置 `/opt/cloud-mcp/.env`
+
+### sandbox-worker — 沙箱执行器
+
+```bash
+curl -fsSL https://git.lingyu.org.cn/lingyu-note/releases/raw/branch/main/sandbox-worker/install.sh | sudo bash
+```
+- 前置:Node ≥ 22、Docker(worker 通过 docker API 启动沙箱容器)
+- 端口 8443;配置 `/opt/sandbox-worker/.env`
+
+## 常用操作
+
+```bash
+VERSION=0.1.0 bash install.sh      # 安装指定版本(默认最新)
+bash install.sh --uninstall        # 卸载(保留数据与 .env)
+journalctl -u <服务名> -f          # 看日志(服务名 = miiot / cloud-mcp / sandbox-worker)
+```
+
+## 版本与校验
+
+- Release tag 格式:`<组件>-v<semver>`(如 `miiot-v0.1.0`),各组件独立演进
+- 每个 release 附 `SHA256SUMS`,安装脚本自动校验;手动下载请自行 `sha256sum -c`