# 安装、升级与卸载

实际开发与验证环境：macOS，Node.js 22.22.3／26.0.0，Google Chrome，Playwright 1.58.2。Node.js最低22.20，依赖以package-lock.json锁定。Windows安装命令已提供，尚未在真实Windows实测；Linux商家自动化需要可用图形会话和Chrome，尚未实测；官网服务可独立运行，不需要Chrome。

## 从真实发行包安装

核对ZIP旁的SHA-256后解压。macOS/Linux可用 `shasum -a 256 文件.zip`；Windows PowerShell可用 `Get-FileHash 文件.zip -Algorithm SHA256`。

```sh
cd openlx-meituan-hotel-ops
node scripts/install.mjs install
```

默认安装到用户目录 `.codex/skills/openlx-meituan-hotel-ops`。其他宿主使用 `--target /path/to/skills/openlx-meituan-hotel-ops`。安装器先在暂存目录安装锁定依赖并执行doctor，成功后替换目标，旧版可恢复。不复制浏览器Profile、经营数据库或密钥。

```sh
cd ~/.codex/skills/openlx-meituan-hotel-ops
node runtime/cli.mjs doctor
node runtime/cli.mjs serve --workspace /path/to/your-hotel-work
```

启动后返回本地地址和私密启动文件路径。在本机打开工作区的 `workbench.html` 并点击一次性登录链接。链接仅用于本机，不能分享；服务重启会生成新链接。工作台默认仅监听127.0.0.1:1987。若端口被占用可加 `--port 1988`。

首次在工作台填实际门店ID、名称和账号标识。也可使用命令：

```sh
node runtime/cli.mjs init --workspace /path/to/your-hotel-work --property REAL_PROPERTY_ID --account REAL_ACCOUNT_ID --name 酒店名称
node runtime/cli.mjs login --workspace /path/to/your-hotel-work
```

在专属Chrome手动完成登录与安全验证后关闭窗口。有效会话保存在本机专属Profile，不复制日常Chrome Cookie。登录成功不代表已完成字段适配；按ADAPTER.md补齐真实映射后执行read。

## 离线示例

以下为明确标注的合成测试数据，不能作为实际经营样本或后台执行证据：

```sh
node runtime/cli.mjs init --workspace /path/to/demo-work --property test-hotel --account test-account --name 示例客栈（非真实酒店）
node runtime/cli.mjs import --workspace /path/to/demo-work --file config/example-snapshot.json
node runtime/cli.mjs report --workspace /path/to/demo-work
```

## 升级、回退、卸载

从新发行包解压目录运行：

```sh
node scripts/install.mjs upgrade
node scripts/install.mjs rollback
node scripts/install.mjs uninstall
```

可添加同一 `--target`。卸载将技能目录移动到同级恢复备份，经营工作区及账号Profile保留。只有在用户明确要求删除经营数据或登录态时才另行处理。`logout` 将专属Profile移出运行位置并保留私密可恢复备份，不删除酒店数据。

## 持续运行

```sh
node runtime/cli.mjs daemon --workspace /path/to/your-hotel-work
```

保持设备在线、有效登录与可用图形会话；Ctrl+C停止运行器。`pause`立即暂停写入，读取和报告可继续；`resume`恢复时拒绝过期提案。没有自动安装系统级常驻服务或假定关机仍在线。订单任务独立优先，长页面任务串行受导航与字段超时限制；高时效订单优先使用平台原生通知／自动确认。

有图形桌面的常驻主机可运行同一命令。付费设备经官网登记后，执行器会申请并在提交前续约门店写租约；服务器互斥已模拟验证，真实双主机商家写入未实测。免费运行器仍仅提供本机互斥。

## 官网与统一会员

`npm run build`生成官网，`npm run site:start`启动独立服务（默认127.0.0.1:1988）。配置见.env.example，生产密钥在外部data目录生成；SMTP、身份和支付直接复用wx-api。详情见[统一会员](MEMBERSHIP.md)。官网不含商家登录资料，本地工作台默认1987不可公网代理。

从会员中心下载许可证后，在对应门店工作区执行`node runtime/cli.mjs activate --file /path/to/license.json`，日常通过`refresh-license`更新。须核对本机device_id与会员中心登记一致。发行公钥由产品发行者注入，不从许可证里信任任意公钥。
