diff --git a/CLAUDE.md b/CLAUDE.md
index 6644e42..0689918 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -5,3 +5,9 @@
 vConsole 仅在当前用户有 `SYS_CAN_SUDO` tag 时显示。判断逻辑在 `src/App.vue:updateVConsoleVisibility()`。
 
 Tags 通过 `get_all_tags_of_the_user` API 异步加载（`src/store/user.ts:getTags()`），在 `setCurrentUser()` 之后执行。vConsole 的 watch 需要 `{ deep: true }` 以及独立的 `store.current.tags` watch 来覆盖异步加载完成后的触发。
+
+## 版本号 debug 日志
+
+`src/App.vue:onMounted()` 中有一条 `console.debug('[App.vue] deploy_ver=YYYYMMDD')`。
+
+**每次部署前必须更新这个版本号**（格式 `YYYYMMDD` 或 `YYYYMMDD.N`）。这样在 vConsole 中就能直观确认小程序加载的是哪个版本的 JS，彻底避免缓存问题的猜测。
diff --git a/src/App.vue b/src/App.vue
index 302c3e7..301270a 100644
--- a/src/App.vue
+++ b/src/App.vue
@@ -70,6 +70,7 @@ export default defineComponent({
     const badge_props: Partial<BadgeProps> = { showZero: false, max: 99 }
 
     onMounted(() => {
+      console.debug('[App.vue] deploy_ver=20260503');
       let vconsole = document.getElementById("__vconsole");
       if (vconsole) {
         vconsole.hidden = true;