diff --git a/public/index.html b/public/index.html
new file mode 100644
index 0000000..b670fa2
--- /dev/null
+++ b/public/index.html
@@ -0,0 +1,45 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>CI/CD 接入自检 · knowledge-governance</title>
+<style>
+  :root{--fg:#12151c;--muted:#6b7280;--bg:#f7f8fb;--card:#fff;--line:#e5e7eb;--ok:#16a34a;--accent:#2563eb}
+  *{box-sizing:border-box}
+  body{margin:0;padding:32px 20px;background:var(--bg);color:var(--fg);
+       font:15px/1.7 -apple-system,"Segoe UI","Noto Sans CJK SC",system-ui,sans-serif}
+  .wrap{max-width:760px;margin:0 auto}
+  h1{font-size:22px;margin:0 0 4px}
+  .sub{color:var(--muted);margin-bottom:24px}
+  .card{background:var(--card);border:1px solid var(--line);border-radius:12px;padding:20px 22px;margin-bottom:16px}
+  .badge{display:inline-block;padding:2px 10px;border-radius:999px;font-size:13px;font-weight:600}
+  .ok{background:#dcfce7;color:var(--ok)}
+  ol{padding-left:20px;margin:8px 0}
+  code{background:#f1f3f7;padding:2px 6px;border-radius:5px;font-size:13px}
+  .foot{color:var(--muted);font-size:13px;margin-top:8px}
+</style>
+</head>
+<body>
+<div class="wrap">
+  <h1>Gitea CI/CD 接入自检页 <span class="badge ok">链路正常</span></h1>
+  <div class="sub">仓库 <code>Weknora/knowledge-governance</code> · 本页由提交触发的本机编译自动发布</div>
+
+  <div class="card">
+    <strong>这一页证明什么</strong>
+    <ol>
+      <li>提交推送到 Gitea 后，<b>本机 Runner</b> 自动拉起编译</li>
+      <li>编译成功把静态产物打包上报给主机侧 ci-bridge</li>
+      <li>ci-bridge 托管产物并回一个<b>可访问链接</b>（就是当前地址）</li>
+      <li>同一条流水线还会把结果<b>推送微信</b>（含这个链接）</li>
+    </ol>
+  </div>
+
+  <div class="card">
+    <strong>替换本页</strong>
+    <div class="foot">这是占位页（<code>public/index.html</code>），用于验证预览链路。放入真实前端产物后，
+    把构建输出目录设为 <code>dist</code> / <code>public</code> / <code>web/dist</code> 之一即可自动替换。</div>
+  </div>
+</div>
+</body>
+</html>
\ No newline at end of file