docs: explain navigation, search and content components

app/components/OsIcon.vue

@@ -1,4 +1,5 @@
 <script>
+// 操作系统图标依次尝试显式地址、图标地址和内置映射，加载失败后切换下一候选。
 import "~/assets/styles/OsIcon.CAi4Iz2S.css";
 import { watch } from "vue";
 import { createBlock } from "vue";
@@ -37,6 +38,7 @@ var f = [`src`, `width`, `height`],
               flush: `sync`,
             },
           );
+          // 仅接收站内绝对路径或无认证信息的 HTTP(S) 地址，拒绝控制字符和反斜杠。
           function m(e) {
             let t = String(e ?? ``).trim();
             if (!t || /[\u0000-\u0020\u007f\\]/.test(t)) return ``;
@@ -68,6 +70,7 @@ var f = [`src`, `width`, `height`],
                   ? `lucide:hard-drive`
                   : `lucide:terminal`,
             );
+          // 只记录当前候选的失败事件，避免前一张图片的迟到事件污染新图标。
           function v(e) {
             let t = e.target?.getAttribute(`src`);
             t && t === g.value && p.value.push(t);