From c10e6a45e75493771bd94f5a5b36004f651f312a Mon Sep 17 00:00:00 2001 From: OoO Date: Wed, 13 May 2026 18:47:36 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A8=98=E9=8C=84=E8=A7=80=E6=B8=AC=E5=8F=B0?= =?UTF-8?q?=E8=A6=96=E8=A6=BA=E5=A5=91=E7=B4=84=E5=AE=88=E9=96=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/memory/observability_ui_qa_guardrails_20260505.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/memory/observability_ui_qa_guardrails_20260505.md b/docs/memory/observability_ui_qa_guardrails_20260505.md index b0e9f4e..0696324 100644 --- a/docs/memory/observability_ui_qa_guardrails_20260505.md +++ b/docs/memory/observability_ui_qa_guardrails_20260505.md @@ -19,6 +19,7 @@ Claude Code Phase 38→55 完成 AI 觀測台 10 頁，但前端曾出現以下 - Production smoke：`scripts/check_observability_pages.py` - 一鍵 QA：`scripts/check_observability_suite.sh` - CSS mirror sync：`scripts/sync_observability_css.py` +- 渲染後視覺契約：`scripts/check_observability_visual_contract.sh` ## 必跑指令 @@ -30,12 +31,13 @@ Claude Code Phase 38→55 完成 AI 觀測台 10 頁，但前端曾出現以下 ./scripts/quick_review.sh --observability-qa ``` -指定環境或只跑靜態 guard： +指定環境、渲染後視覺契約或只跑靜態 guard： ```bash ./scripts/quick_review.sh --observability-smoke --base-url https://mo.wooo.work --timeout 12 ./scripts/quick_review.sh --observability-qa --base-url https://mo.wooo.work ./scripts/quick_review.sh --observability-qa --skip-production +./scripts/quick_review.sh --observability-visual --base-url http://127.0.0.1:5016 --timeout 20 ./scripts/quick_review.sh --observability-help ``` @@ -45,6 +47,7 @@ Claude Code Phase 38→55 完成 AI 觀測台 10 頁，但前端曾出現以下 python3 scripts/sync_observability_css.py python3 scripts/sync_observability_css.py --check bash scripts/check_observability_suite.sh +bash scripts/check_observability_visual_contract.sh --base-url http://127.0.0.1:5016 --timeout 20 ``` ## 重要陷阱 @@ -55,6 +58,7 @@ bash scripts/check_observability_suite.sh - Production smoke 必須看到 `觀測台 CSS: HTTP 200, markers=ok`。 - 觀測台頁面清單、URL、`active_page`、內容 marker 不要分散維護，先改 `scripts/observability_contract.py`。 - `quick_review.sh --observability-qa` 預設打 production `https://mo.wooo.work`；測 staging/localhost 時要明確帶 `--base-url`。 +- `quick_review.sh --observability-visual` 也預設打 production；驗證尚未部署的本機變更時，必須先啟 Flask local server 並明確帶 `--base-url http://127.0.0.1:`。若打 production 失敗，先確認正式端是否已部署該版，不要把舊版正式站結果誤判成本機 diff 失敗。 - Gitea CD 會偵測觀測台 template/CSS/route/QA script/guide 變更：deploy 前跑 CSS mirror check + static QA，deploy 後跑 production smoke。QA script 範圍包含 `quick_review.sh`、`check_observability_*`、`observability_contract.py`、`sync_observability_css.py`。CD 不會偷偷修 mirror；若 check fail，先本地跑 sync 後提交。 - CD 觸發判斷集中在 `scripts/check_observability_deploy_gate.py`；不要在 `.gitea/workflows/cd.yaml` 另維護一份長 regex。 - `check_observability_suite.sh` 會跑 deploy gate self-test，確認觀測台相關檔案會觸發 QA、一般 backend/docs 檔案不會誤觸發。