# AW-HLCC-DEPLOYMENT-CHECKPOINT-20260726

> **目标节点**：`AW-GZ-001`
>
> **现场主机名**：`GH-CVM-MAIN-PROD-01`
>
> **目标服务**：HoloLake Code Channel Enterprise isolated candidate
>
> **状态**：UPGRADE_STAGING · ISOLATED_CANDIDATE_HEALTHY · PRODUCTION_NOT_CUT_OVER

## 已核验现场

- 腾讯云 OrcaTerm 官方在线终端可用。
- 现有 `lighthouse-gitea`、PostgreSQL、Redis 容器健康。
- 现有 Gitea 为 `gitea/gitea:1.21.11`，监听 `127.0.0.1:3000`；不得覆盖。
- 企业灯塔 `guanghu-enterprise-lighthouse.service` 正常，监听 `127.0.0.1:8031`。
- 旧光湖驱动引擎 `/opt/engine.js` 仍监听 `0.0.0.0:3910`，提供旧执行、健康、状态和文件
  路由并连接多个历史节点。它是升级依赖，不得当成无关服务或直接拔除。
- `api-router.service` 运行 `/root/api-router-v3.py`，是旧 Python 网关。
- `guanghu-portal.service`、`/opt/zhuyuan/revive-guard/revive-guard.py`、TAT/Barad Agent
  均属于需要恢复拓扑和职责边界的既有运行面。
- 旧驱动脚本含硬编码历史节点访问材料且为世界可读，必须在调用方盘点后迁移、轮换和收口；
  不得把材料复制到对话、仓库、意图胶囊或新回执。
- Nginx 监听 80/443；本轮不修改公网反向代理或生产入口。
- `/etc/fstab` 仍声明 `/dev/vdb -> /data`，但 `lsblk` 当前不存在 `/dev/vdb`，
  `data.mount` 因此失败。系统盘约 50GB、当前剩余约 30GB。
- 现有企业 Gitea 数据位于 `/opt/docker-data/lighthouse-cn/data/lighthouse/gitea`，
  其中已有 `bingshuo/lighthouse.git` 与 `bingshuo/hololake-world.git`。
- `certbot.service` 为已不存在单元的旧失败记录，不是当前代码频道故障根因。

## 离线包

本地包：

```text
光湖代码频道-Forgejo-16.0.1-完整离线包
```

本机 `MANIFEST.sha256` 六个文件已全部通过。企业节点具备 `/usr/bin/gpg`；上传结束后必须
在目标端再次执行完整 SHA-256 校验、发布密钥指纹核对和二进制签名验证。

## 部署边界

隔离验证阶段只允许：

1. 上传到隔离暂存区；
2. 在系统盘创建隔离候选目录；
3. 以无登录专用用户运行；
4. 监听 `127.0.0.1:3340`；
5. 导入离线光湖代码频道 bundle；
6. 验证版本、首页、仓库读取、重启保持和关闭在线更新；
7. 写回执。

本轮不允许：

- 替换现有 `127.0.0.1:3000` Gitea；
- 修改 Nginx 生产路由或自动开放公网；
- 把缺失的 `/data` 当作已挂载；
- 复制个人第五域账号、密码哈希、令牌或仓库数据库；
- 使用旧 `3910` 任意命令驱动；
- 未验签启动、自动镜像、在线更新或 Actions。
- 把 `3340` 候选声明为脱离旧语言系统的第二套权威代码频道；
- 未恢复旧小湖灯、驱动、门户和守护 Agent 拓扑就替换旧内部入口。

## 恢复顺序

```text
完成六文件上传
→ 目标端 SHA-256 + GPG 指纹 + 签名
→ 建立 nologin 的 guanghu 服务用户
→ 安装到 /var/lib/guanghu-enterprise-code-channel/candidates/hlcc-v16.0.1
→ 启动 127.0.0.1:3340 隔离候选
→ 健康验证并写隔离候选回执
→ 恢复旧小湖灯、驱动、门户、守护 Agent 和内部进入方式的全局拓扑
→ 把新导航/意图/Agent 门作为兼容升级嵌入旧链路
→ 再决定导入 guanghu-code-channel.bundle 与正式迁移
→ 验证前停在 UPGRADE_STAGING，不切公网
→ 后续单独决定恢复 /dev/vdb 或登记正式替代数据根
```

## 京东链路判断

2026-07-26 本机访问 `https://guanghulab.com/`、`/authz/health` 和 `/code/` 均返回
HTTP 200。当前“京东又上不去”不是整机公网服务中断；已发现的问题是在线授权运行时版本偏旧、
AW 导航图读取失败以及动作/传输链未完全登记。工单批准、导航图、动作注册、传输、执行和健康
回执必须继续分开证明。