domainCheck Workspace

这个仓库是 domainCheck 项目的本地工作区，包含：

• 旧版桌面端源码 domainCheck/
• 新版后端服务 domain-api/
• 新版 Web 管理后台 domain-web/
• 全套交付与部署文档 docs/
• Windows / Linux 启动、打包、验包脚本

如果你是第一次打开这个仓库，建议先看：

• docs/12_domainCheck_导航索引.md
• docs/04_domainCheck_WebLinux改造总体方案.md

如果你当前已经进入“海外单脑控制面 / 多机联调 / 准备上线”阶段，建议直接从下面 4 份开始：

1. docs/25_domainCheck_海外单脑控制面上线收口总表.md
2. docs/23_domainCheck_终局运维架构设计_海外单脑控制面.md
3. docs/24_domainCheck_NodeAgent协议与ReleaseHub设计.md
4. docs/schemas/ops_driver_contract.md

如果已经接近正式发布，建议再补一份：

• docs/26_domainCheck_发布前运行验证与交付模板.md

目录结构

.
├─ docs/                文档、验收、部署、交付说明
├─ domainCheck/         旧版 Windows 桌面端源码
├─ domain-api/          新版 FastAPI 后端
├─ domain-web/          新版 Vue Web 管理后台
├─ release/             打包产物目录（通常不提交 git）
├─ start_*.ps1          Windows 启动脚本
├─ stop_*.ps1           Windows 停止脚本
├─ smoke_test_stack.ps1 本地整栈自测
├─ package_domain_release.ps1   Windows 交付打包
├─ verify_domain_release.ps1    Windows 交付包校验
├─ prepare_final_release.ps1    Windows 最终发布准备
├─ show_latest_release.ps1      Windows 查看最新交付包
├─ package_domain_release.sh    Linux / 海外主机交付打包
├─ verify_domain_release.sh     Linux / 海外主机交付包校验
├─ prepare_final_release.sh     Linux / 海外主机最终发布准备
└─ show_latest_release.sh       Linux / 海外主机查看最新交付包

各目录用途

domainCheck/

旧版桌面工具项目，主要用于：

• 历史功能保留
• 旧版桌面端运行
• 检测逻辑来源与兼容

domain-api/

新版后端服务，负责：

• 配置中心
• 检测控制
• 域名筛选与批量更新
• 导入与导出
• 日志诊断
• 运行中心
• Linux 部署与联调

关键入口：

• domain-api/README.md
• domain-api/deploy/linux/README.md

domain-web/

新版 Web 管理后台，负责：

• 登录
• 概览
• 系统设置
• 域名导入
• 检测控制
• 域名筛选
• 导出中心
• 日志诊断
• 运行中心

关键入口：

• domain-web/README.md

docs/

这个目录是项目的总文档区，包含：

• 验收清单
• 优化清单
• 外包整改清单
• Web/Linux 改造方案
• Linux 部署说明
• 发布验收清单
• 交付说明
• 打包说明
• 最终交付结论
• Linux 联调输入清单
• 总导航索引

最推荐的阅读顺序：

1. docs/04_domainCheck_WebLinux改造总体方案.md
2. docs/08_domainCheck_交付说明.md
3. docs/05_domainCheck_Linux部署清单.md
4. docs/07_domainCheck_WebLinux发布验收清单.md
5. docs/12_domainCheck_导航索引.md

Windows 本地常用脚本

启动与停止

• start_domain_stack.ps1
• stop_domain_stack.ps1
• start_domain_api.ps1
• stop_domain_api.ps1
• start_domain_web.ps1
• stop_domain_web.ps1

自测与交付

• smoke_test_stack.ps1
• package_domain_release.ps1
• verify_domain_release.ps1
• prepare_final_release.ps1
• show_latest_release.ps1
• package_domain_release.sh
• verify_domain_release.sh
• prepare_final_release.sh
• show_latest_release.sh

补充说明：

• show_latest_release.ps1 / .sh 现在会校验 final_release_report.json 是否真的对应当前 latest_release.*
• 不是“目录里有 final report 就算已经完成最终签收”

当前状态

当前这套工作区已经完成：

• 本地开发
• Web/API 落地
• Windows 本地联调
• 自检与自测
• 配置迁移与备份
• 打包与验包
• 发布准备

剩余工作主要在真实 Linux 环境：

• 部署
• 联调
• 灰度上线

Linux 阶段建议先看：

• docs/11_domainCheck_Linux联调输入清单.md
• docs/12_domainCheck_导航索引.md

如果当前已经切到“海外单脑控制面 + 大陆托管节点 + 发布 / Rollout / 驾驶舱首屏”阶段，建议改为：

1. docs/25_domainCheck_海外单脑控制面上线收口总表.md
2. docs/22_domainCheck_海外Codex驾驶员与OpsCenter落地路线.md
3. docs/23_domainCheck_终局运维架构设计_海外单脑控制面.md
4. docs/24_domainCheck_NodeAgent协议与ReleaseHub设计.md
5. docs/schemas/ops_stack_diagnosis_contract.md
6. docs/schemas/ops_driver_contract.md

如果当前已经进入“海外主机集中运维 / 多机联调 / Release Hub”阶段，最直接的统一入口是：

• domain-api/deploy/multi-region/drive_ops_center.sh
• domain-api/deploy/multi-region/drive_release_hub.sh
• domain-api/deploy/multi-region/drive_ops_action.sh
• domain-api/deploy/multi-region/init_ops_center_config.sh

其中：

• drive_ops_center.sh 用于海外控制面统一调度检查、Release Hub 和 Driver 动作
• drive_release_hub.sh 用于直接从命令行走 Release / Rollout 标准接口
• drive_ops_action.sh 用于直接从命令行走 ops/driver-actions/execute
• init_ops_center_config.sh 用于初始化 /etc/default/domaincheck-ops-center

现在 drive_ops_center.sh 还额外收进了本机发布链：

• release-package
• release-verify
• release-show
• release-launchpad
• release-prepare
• release-preview
• release-preview-smart

当前如果要用一条最短路径判断“现在能不能继续收口、能不能继续发布”，推荐先跑：

cd /www/wwwroot/getDomain
bash domain-api/deploy/multi-region/drive_ops_center.sh go-live-check http://127.0.0.1:8100 http://127.0.0.1:8100 summary

然后再按：

bash domain-api/deploy/multi-region/drive_ops_center.sh stack-diagnosis
bash domain-api/deploy/multi-region/drive_ops_center.sh driver-feed
bash domain-api/deploy/multi-region/drive_ops_center.sh codex-brief

继续下钻。

如果要把这轮检查直接导出成一整包上线证据，也可以直接执行：

bash domain-api/deploy/multi-region/drive_ops_center.sh go-live-export

它会把 go-live / stack-diagnosis / driver-feed / codex-brief / release-launchpad / doctor-* 统一导出到 domain-api/runtime/ops-center-reports/go-live-bundles/ 下，并生成一份 manifest.json。

Git 提交建议

建议提交：

• docs/
• domain-api/
• domain-web/
• domainCheck/ 中需要保留的源码
• 根目录 .ps1 脚本

不建议提交：

• release/
• 真实 .env
• 日志
• runtime/
• node_modules/
• dist/
• .venv/
• 其他运行生成文件