# 翎羽笔记 · 自托管组件发布仓

本仓库只存放**构建产物**(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`