feat(web): 添加示例页升级验证区块并发布 v1.3.7

CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## [v1.3.7] - 2026-09-28
+
+### 新增
+
+- **示例页面新增独立升级验证区块**：页面增加「本次升级验证」高亮区块，显示 `v1.3.7`，验证标识更新为 `v1.3.7-example-page`，用于直观确认升级后的前端资源已切换
+
+### 变更
+
+- 版本号提升到 1.3.7；`web/package.json` 与 `web/package-lock.json` 同步对齐
+- `AgentVersion` 保持 0.12.8
+
+### 测试
+
+- 前端类型检查、单元测试与生产构建
+
 ## [v1.3.6] - 2026-09-28
 
 ### 修复

VERSION

@@ -1 +1 @@
-1.3.6
+1.3.7

docs/README.md

@@ -1,7 +1,7 @@
 # Fonu 文档索引
 
 > 维护约定：新增方案 / 审查文档时在下方登记；方案落地后在「状态」列标注实施结果，并给已被推翻的描述加时效说明。
-> 最近更新：2026-09-28（v1.3.6）
+> 最近更新：2026-09-28（v1.3.7）
 
 ## 方案与设计（本目录）
 
@@ -9,7 +9,7 @@
 | --- | --- | --- |
 | `project-analysis-2026-09-27.md` | 全项目详细分析（v1.2.19）：架构、模块、数据、API、前端、链路、风险与改进路线 | 当前版本快照 |
 | `improvement-roadmap-2026-09-27.md` | P0-P3 改进路线实施方案：逐项改法、测试、验收、依赖、发布与回滚 | P0-1、P0-3 已完成，其余待实施 |
-| `system-upgrade.md` | Docker Compose 一键升级：sidecar 架构、首次部署、安全边界、回滚、故障排查与验证页 | 已实施（v1.3.6） |
+| `system-upgrade.md` | Docker Compose 一键升级：sidecar 架构、首次部署、安全边界、回滚、故障排查与验证页 | 已实施（v1.3.7） |
 | `project-audit-2026-09-24.md` | 全项目审查：P0/P1/P2 分级，含精确行号与逐条修法 | **进行中**——P0 已随 v1.2.7 完成，P1 实施中 |
 | `frp-server-list-merge-plan.md` | FRP 服务端列表并入「公网服务端」页（方案 A，四步） | 步 1/2 已完成（v1.2.6）；步 3 文案收尾、步 4 死样式清理未做 |
 | `agent-capability-plan.md` | fonu-agent 能力扩展（P0/P1/P2/P3） | 已实施（agent 0.11.0）；P3 三项不做 |

docs/system-upgrade.md

@@ -228,16 +228,17 @@ FONU_VERSION=<旧版本> docker compose up -d --no-deps --force-recreate fonu
 
 ## 10. 在线升级验证
 
-示例页面用于验证升级结果。v1.3.6 的验证流程：
+示例页面用于验证升级结果。v1.3.7 的验证流程：
 
 1. 确认当前线上实例为 v1.3.0，且 `fonu-updater` sidecar 已运行。
-2. 确认远端 `main` 分支的 `VERSION` 为 `1.3.6`。
+2. 确认远端 `main` 分支的 `VERSION` 为 `1.3.7`。
 3. 在侧栏看到「一键升级」后点击并确认。
 4. 等待升级弹窗显示成功，页面自动刷新。
 5. 打开侧栏「示例页面」，确认：
    - 页面路由为 `/example`；
-   - 页面显示的版本为 `1.3.6`；
-   - 页面显示验证标识 `v1.3.6-example-page`；
+   - 页面显示的版本为 `1.3.7`；
+   - 页面显示验证标识 `v1.3.7-example-page`；
+   - 页面显示独立的「本次升级验证」区块；
    - 「升级验证」显示为「通过」。
 
 如果示例页面可见且版本正确，说明镜像构建、容器重建、后端版本注入和前端静态资源更新均已生效。

web/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "fonu-web",
-  "version": "1.3.6",
+  "version": "1.3.7",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "fonu-web",
-      "version": "1.3.6",
+      "version": "1.3.7",
       "dependencies": {
         "@codemirror/commands": "^6.11.1",
         "@codemirror/lang-javascript": "^6.2.5",

web/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fonu-web",
   "private": true,
-  "version": "1.3.6",
+  "version": "1.3.7",
   "packageManager": "npm@10.9.4",
   "type": "module",
   "scripts": {

web/src/views/ExampleView.vue

@@ -8,11 +8,21 @@
     </template>
   </PageHeader>
 
-  <n-alert type="success" :bordered="false" class="example-alert" title="v1.3.6 示例页面验证标识已生效">
+  <n-alert type="success" :bordered="false" class="example-alert" title="v1.3.7 示例页面验证标识已生效">
     当前页面由 v{{ version }} 提供，验证标识为 <span class="mono">{{ verificationMarker }}</span>。
     如果你是在升级后首次看到这行内容，说明前端构建、镜像重建和服务重启均已成功。
   </n-alert>
 
+  <div class="example-proof">
+    <div>
+      <span class="example-proof__label">本次升级验证</span>
+      <strong class="example-proof__value">{{ verificationRound }}</strong>
+    </div>
+    <div class="example-proof__hint">
+      看到这个新区块，说明前端资源已经从旧版本切换到 v1.3.7。
+    </div>
+  </div>
+
   <div class="stats-row">
     <StatCard label="当前版本" :value="`v${version}`" sub="来自 /api/version" tone="brand">
       <template #icon><n-icon :component="CloudOutline" /></template>
@@ -30,9 +40,9 @@
 
   <FonuCard title="本次示例页变化" subtitle="用于确认升级后的页面内容确实发生变化">
     <ul class="example-changes">
-      <li>页面版本提示更新为 v1.3.5。</li>
-      <li>新增「页面状态」统计卡，显示 v1.3.5 前端资源已加载。</li>
-      <li>验证标识更新为 <span class="mono">v1.3.5-example-page</span>。</li>
+      <li>页面版本提示更新为 v1.3.7。</li>
+      <li>新增独立的「本次升级验证」区块，用于直观确认新页面已经加载。</li>
+      <li>验证标识更新为 <span class="mono">v1.3.7-example-page</span>。</li>
     </ul>
   </FonuCard>
 
@@ -77,7 +87,8 @@ const message = useMessage()
 const version = ref(__APP_VERSION__)
 const checkedAt = ref('')
 const refreshing = ref(false)
-const verificationMarker = 'v1.3.6-example-page'
+const verificationRound = 'v1.3.7'
+const verificationMarker = 'v1.3.7-example-page'
 
 async function refreshVersion() {
   refreshing.value = true
@@ -102,6 +113,39 @@ onMounted(() => {
   margin-bottom: var(--fonu-space-5);
 }
 
+.example-proof {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--fonu-space-5);
+  margin-bottom: var(--fonu-space-5);
+  padding: var(--fonu-space-4) var(--fonu-space-5);
+  border: 1px solid var(--fonu-brand-soft);
+  border-radius: var(--fonu-radius);
+  background: var(--fonu-brand-soft);
+}
+
+.example-proof__label {
+  display: block;
+  font-size: 12px;
+  color: var(--fonu-text-secondary);
+}
+
+.example-proof__value {
+  display: block;
+  margin-top: 2px;
+  font-size: 28px;
+  line-height: 1.2;
+  color: var(--fonu-brand-text);
+}
+
+.example-proof__hint {
+  max-width: 360px;
+  font-size: 13px;
+  line-height: 1.6;
+  color: var(--fonu-text-secondary);
+}
+
 .stats-row {
   display: grid;
   grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
@@ -148,6 +192,12 @@ onMounted(() => {
 }
 
 @media (max-width: 640px) {
+  .example-proof {
+    align-items: flex-start;
+    flex-direction: column;
+    gap: 8px;
+  }
+
   .example-result {
     grid-template-columns: 1fr;
   }