2026-04-19 02:35:43 +08:00
2026-04-16 22:41:13 +08:00
dev
2026-04-16 13:05:07 +08:00
dev
2026-04-16 13:05:07 +08:00
dev
2026-04-16 13:05:07 +08:00
dev
2026-04-16 13:05:07 +08:00
dev
2026-04-16 13:05:07 +08:00
dev
2026-04-16 13:05:07 +08:00
dev
2026-04-16 13:05:07 +08:00
dev
2026-04-16 13:05:07 +08:00

domainCheck Workspace

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

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

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

如果你当前已经进入“海外单脑控制面 / 多机联调 / 准备上线”阶段,建议直接从下面 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/                文档、验收、部署、交付说明
├─ 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-web/

新版 Web 管理后台,负责:

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

关键入口:

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 本地常用脚本

启动与停止

自测与交付

补充说明:

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

当前状态

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

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

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

  • 部署
  • 联调
  • 灰度上线

Linux 阶段建议先看:

如果当前已经切到“海外单脑控制面 + 大陆托管节点 + 发布 / 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”阶段最直接的统一入口是

其中:

  • 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/
  • 其他运行生成文件
Description
No description provided
Readme 31 MiB
Languages
Python 56%
JavaScript 21.9%
Vue 13.9%
Shell 7.7%
PowerShell 0.3%
Other 0.2%