yo-moss-ai 0.0.1

package/README.md

@@ -0,0 +1,153 @@
+# yo-moss-ai
+
+MOSS 配置客户端：连接云通道、学习红外遥控器、配置 Onvif 摄像头。
+
+客户电脑安装好 Node.js 后，一条命令即可启动，并自动打开浏览器。
+
+```bash
+npx yo-moss-ai
+```
+
+指定版本（推荐，避免意外升到不兼容的版本）：
+
+```bash
+npx yo-moss-ai@0.1.0
+```
+
+首次运行会下载依赖（含摄像头预览用的 ffmpeg），可能需要一两分钟。之后再运行会快很多。
+
+启动成功后终端会打印类似：
+
+```text
+yo-moss-ai v0.1.0  http://127.0.0.1:3780
+```
+
+浏览器一般会自动打开。若没有，请手动访问上面的地址。用 `Ctrl + C` 结束。
+
+## 如何卸掉
+
+`npx yo-moss-ai` **不会**装成系统里的常驻软件。终端里 `Ctrl + C` 停掉后，命令本身就已经没在运行。
+
+若要清掉本机残留：
+
+1. **配置和账号**（云通道、摄像头密码等）在用户目录：
+
+```bash
+# macOS / Linux
+rm -rf ~/.moss-desktop
+
+# Windows（PowerShell）
+Remove-Item -Recurse -Force "$env:USERPROFILE\.moss-desktop"
+```
+
+2. **npx 下载缓存**（含 ffmpeg 等依赖，可腾出磁盘）：
+
+```bash
+npm cache clean --force
+```
+
+若曾经用过全局安装 `npm install -g yo-moss-ai`，再执行：
+
+```bash
+npm uninstall -g yo-moss-ai
+```
+
+## 需要的 Node.js 版本
+
+**必须安装 Node.js 20 或更高版本**（建议安装官网的 LTS 长期支持版，例如 20 或 22）。
+
+在终端检查：
+
+```bash
+node -v
+```
+
+应显示 `v20.x.x` 或更高。若提示 `command not found`，或版本低于 20，请先按下面步骤安装。
+
+## 如何安装 Node.js
+
+### 方法一：官网安装包（最简单）
+
+1. 打开 [https://nodejs.org/zh-cn](https://nodejs.org/zh-cn)
+2. 下载 **LTS** 版本（不要下 Current 测试版也行，但 LTS 更稳）
+3. 运行安装程序，一路下一步，保持默认选项（Windows 请勾选 “Add to PATH”）
+4. **关掉旧的终端窗口，重新打开一个新的**
+5. 再执行 `node -v` 和 `npm -v`，确认都能显示版本号
+
+### 方法二：macOS 用 Homebrew
+
+```bash
+brew install node@22
+```
+
+若 `node -v` 仍看不到，把 Homebrew 的 node 加入 PATH 后再开一个新终端。
+
+### 方法三：用 nvm 管理版本（适合需要多版本的人）
+
+**macOS / Linux：**
+
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+```
+
+关掉终端再打开，然后：
+
+```bash
+nvm install 22
+nvm use 22
+node -v
+```
+
+**Windows：** 可使用 [nvm-windows](https://github.com/coreybutler/nvm-windows/releases)，安装后同样执行 `nvm install 22`。
+
+### 装好后启动本工具
+
+```bash
+npx yo-moss-ai
+```
+
+`npx` 随 Node.js 一起安装，不用再装别的。若提示是否安装包，输入 `y` 回车。
+
+## 使用顺序
+
+1. 连接云通道
+2. 找到 MOSS（自动扫描或手填 IP）
+3. 需要时把云通道信息写入设备
+4. 添加电器并学习遥控器。学到信号后请先试发，确认电器有反应再保存
+5. 可选：扫描 Onvif 摄像头，查看画面并控制云台
+
+电脑、MOSS、摄像头需要在同一局域网。
+
+## 开发者
+
+本地开发：
+
+```bash
+pnpm install
+pnpm dev
+```
+
+浏览器打开 http://localhost:5173 ，接口在 `3780` 端口。
+
+打包（压缩并混淆前端与服务端代码）：
+
+```bash
+pnpm build
+```
+
+发布到 npm（每次自动升版本号，默认 +0.0.1）：
+
+```bash
+npm login
+npm whoami            # 能打印出用户名再发布
+pnpm release          # 0.1.0 -> 0.1.1
+pnpm release:minor    # 0.1.1 -> 0.2.0
+pnpm release:major    # 0.2.0 -> 1.0.0
+pnpm release 1.4.0    # 指定版本
+```
+
+若构建已成功、只是登录失败，不要再 `pnpm release`（会重复升版本），登录后执行：
+
+```bash
+npm publish --access public
+```

package/bin/yo-moss-ai.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const major = Number(process.versions.node.split('.')[0])
+if (major < 20) {
+  console.error(`yo-moss-ai 需要 Node.js 20 或更高版本，当前是 ${process.version}`)
+  console.error('请到 https://nodejs.org/zh-cn 下载并安装 LTS 版本后再运行：npx yo-moss-ai')
+  process.exit(1)
+}
+
+const root = path.join(path.dirname(fileURLToPath(import.meta.url)), '..')
+const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'))
+const server = path.join(root, 'dist-server', 'index.mjs')
+
+if (!fs.existsSync(server)) {
+  console.error('缺少构建产物，请先在项目里执行 pnpm build')
+  process.exit(1)
+}
+
+process.env.NODE_ENV = 'production'
+process.env.MOSS_OPEN_BROWSER = process.env.MOSS_OPEN_BROWSER || '1'
+process.env.MOSS_VERSION = pkg.version
+
+await import(pathToFileURL(server).href)