docs: annotate all shared frontend modules in Chinese

app/lib/navigation-state.js

@@ -1,3 +1,4 @@
+/** 按 auth store 实例共享导航加载状态，切换身份立即丢弃旧菜单及旧请求结果。 */
 import { watch } from "vue";
 import { ref } from "vue";
 import { effectScope } from "vue";
@@ -28,6 +29,7 @@ function a(a, o) {
       },
     ),
   );
+  // e 为强制刷新；并发请求复用 p，已加载的菜单默认不重复请求。
   function m(e = !1) {
     if (!a.isLoggedIn) return Promise.resolve();
     if (p) return p;
@@ -68,6 +70,7 @@ function a(a, o) {
     load: m,
   };
 }
+// WeakMap 不延长 store 生命周期；同一应用内多个导航消费者共享同一份响应式状态。
 var o = new WeakMap();
 function s(e, t) {
   let n = o.get(e);