ENGINEERING · WEBSITE DELIVERY

官网自动化部署工程实战
本地白皮书 → 官网 whitepaper 库全链路

单文件 HTML → shot.py 自检 → SSH scp → 索引挂卡 → 备份回退 → 公网 200 → 真值上报 → 台账回写
Ω₀⊂⊙∞⊂Ω | DID-BR-000002 | 2026-10-10
200公网验证状态
28索引篇数(增长中)
0自检错误
2远端备份版本

一 · 部署链路(SOP 全流程)

STEP 1
本地单文件 HTML
黑金学术风自包含页面,CSS/JS 内联,无外部依赖。
STEP 2
shot.py 自检
desktop/mobile 双端截图 + lint:consoleErrors / horizontalOverflow / orphanCards 全零。
STEP 3
SSH scp 上传
密钥 id_ed25519_zongyuan 直传 /www/wwwroot/huodouai.com/whitepaper/,远端 ls 验证字节数。
STEP 4
索引挂卡 + 远端备份
编辑索引分节插卡,先 cp index.html index.html.bak_日期 再上传,防覆盖丢失。
STEP 5
公网验证
Invoke-WebRequest 页面与索引均 HTTP 200,字节数与远端一致。
STEP 6
真值上报 + 台账回写
记忆网关 V3.1 对象型 value 上报;共享大脑任务台账 upsert 并回读验收。

二 · 关键工程点

备份约定
每次索引改动先备份 .bak_YYYYMMDD,同日多次则递增后缀 _b2/_b3,绝不覆盖旧基线。
可回退
双端验证
scp 后远端 ls -la 确认字节数;公网再 HTTP 拉取核对,双端一致才标记完成。
真验证

三 · 踩坑沉淀(Windows 部署)

坑规避
PowerShell 管道产生 UTF-8 BOM复杂 JSON 解析一律写 .py 读文件,不经过 PowerShell 重定向
内联中文 --json 编码错lark-cli 写台账用 Python subprocess + ensure_ascii=False
私钥 invalid format作废旧私钥,用实测可用 id_ed25519_zongyuan,勿重复踩
record-get 结构误读返回 data.data 数组行 + field_id_list,不是 record 对象

四 · 结论

闭环已通
本地内容 → 官网公网可访问全链路自动化,单篇部署约 6 步标准化 SOP。
可扩展
任意 HTML 资产按此 SOP 走通;多篇批量部署可并行 scp 后统一编辑索引。
边界声明
当前走本地 SSH 直传;官网历史偏好「飞书审批→中枢自动部署」通道差异如需统一,另行对齐。
ZONGYUAN-ROOT · 元极恒一自治体系 · 火斗云智AIOS
主节点 hub-central-agent · 开发节点 NODE-DEV-DOUBAO-WORK-001
DID-BR-000002 · Ω₀⊂⊙∞⊂Ω · 2026-10-10 · 台账 LEDGER.ORCH-FIX.20261010
主页·流水线·产品·状态