vants.org 重构项目日志

站点后台登录

请输入管理员 token 后进入站点后台。token 只保存在当前浏览器，并通过请求头发送。

管理员 token

2026-05-31：Wireshark Wiki 中文专题库接入

• 任务目标：把本地 wireshark wiki中文 的 Wireshark Wiki 中文翻译资料按专题库方式融入 vants.org /wiki/，同时保持现有 vants.org 知识体系概念层不被外部资料直接污染。
• 改动范围：新增 scripts/import-wireshark-wiki.cjs，以 wireshark wiki/manifest.json 为事实源导入 795 个中文页面；新增 /wiki/wireshark/ 专题首页、分类页和 archive 全量归档页；更新 scripts/wiki.cjs，让 /wiki/ 首页、/wiki/wireshark-analysis 和 sidebar 自动保留 Wireshark 专题入口；更新 package.json 增加 wiki:wireshark:import；调整 config.mjs 忽略 Wireshark 原始资料中的 ./index 残留相对链接；生成 docs/.vitepress/data/wireshark-wiki.json 和导入报告。
• 验证方式：运行 npm run wiki:wireshark:import，结果 manifest=795 imported=795 missing=0；运行 npm run wiki:compile 成功，仍为 207 sources、23 concepts、207 source summaries；运行 npm run wiki:lint，问题数 0；运行 npm run sitemap，生成 1085 个 URL；运行 npm run build，VitePress 构建成功，耗时约 65 秒。生产发布 dry-run 显示 total_count=5839、non_ascii_path_count=666；真实发布上传 uploaded_count=5839、failed_count=0，未删除线上文件，未触碰 /www/vantscn 和 /www/comments-api；线上手工核对 /wiki/wireshark/、/wiki/wireshark/filters、/wiki/wireshark/protocols、/wiki/wireshark/archive/protocol-reference、/wiki/wireshark/archive/display-filters、/wiki/wireshark-analysis 均为 200 且包含 canonical 与 Wireshark 专题内容。
• 遗留风险：本次未生产发布；Wireshark Wiki 翻译资料未逐页人工审校；全量 archive 进入 sitemap 后 URL 数从约 282 增至 1085，可能带来搜索索引体量、重复翻译内容和构建 chunk 体积风险；构建中出现少量代码块语言 소 fallback 警告和 chunk 大小警告，但不阻断构建；版权和许可边界已在页面中声明，正式大规模推广前仍建议确认 Wireshark Wiki 原始许可。

2026-05-25：生产首页静态资源缓存异常修复

• 异常现象：http://www.vants.org/ 首页返回 200，但浏览器只呈现无样式基础 HTML 和大 logo，疑似 CSS/JS 未加载。
• 根因判断：首页引用的 /assets/style.CbADTMta.css 与 /assets/chunks/theme.CBbfAzLR.js 在 HTTP 层命中旧 404 HTML 缓存；FTP 只读查询确认文件实际存在，带 cache-bust 参数访问也能返回正确 CSS/JS。
• 修复动作：使用 vants-rewritten/docs/.vitepress/dist-admin-dashboard 当前完整产物重新生产上传到 /www，上传 3430 个文件，failed_count=0，未删除线上文件，未触碰 /www/comments-api 和 /www/vantscn。
• 验证方式：线上首页已切换到 /assets/style.7qAmwbOB.css、/assets/chunks/theme.UPeR9t8x.js、/assets/app.BOxShIzL.js；HTTP 验证 CSS/JS 均返回正确 MIME；浏览器实测首页恢复 VitePress 新站样式，console 无 warning/error；截图留存 vants-fix-20260525-home.png。
• 遗留风险：历史旧 hash 资源裸 URL 可能仍被边缘缓存为 404 HTML，但当前首页不再引用；后续部署应先上传资源再上传 HTML，或部署后检查首页引用资源的 MIME，避免缓存 404。

2026-05-31：生产首页静态资源缓存异常再次修复

• 任务目标：处理 http://www.vants.org/ 首页再次出现无样式基础 HTML 与大 logo 的生产异常，并参考 2026-05-25 缓存 404 复盘恢复首页。
• 改动范围：只做生产静态资源与主页面最小修复；新增并上传 /assets/style.CgOJmV4Y.css 作为可访问 CSS 副本；将 /www/index.html、/www/about.html、/www/articles/index.html、/www/wiki/index.html 的 CSS 引用切换到 /assets/style.CgOJmV4Y.css；未触碰 /www/vantscn、/www/comments-api、评论数据库和配置文件。
• 验证方式：复现时确认首页 HTML 引用 /assets/style.CgOJmV4X.css，但该 CSS 裸 URL 返回 text/html 首页内容，/assets/chunks/theme.DpqN6wbe.js 一度返回 500；上传新 CSS 后确认 /assets/style.CgOJmV4Y.css 返回 200、Content-Type: text/css、大小 168835；最终线上验证首页、关于、文章、知识体系均返回 200 且 HTML 引用新 CSS；浏览器实测首页加载 /assets/style.CgOJmV4Y.css 并读取 1374 条 CSS 规则，app.D3Vu1SWA.js、framework.DVa4o9Pv.js、theme.DpqN6wbe.js 与首页 lean chunk 均加载成功。
• 遗留风险：HTTPS/TLS 仍异常，https://vants.org/ 浏览器报 ERR_SSL_PROTOCOL_ERROR，需在 CDN/证书控制台修复；旧 CSS /assets/style.CgOJmV4X.css 仍可能在 CDN 边缘缓存为 HTML；修复过程中一次全量 HTML 上传因 FTP 超时中断，曾造成 /www/index.html 0 字节且被锁，已通过 index-recover.html 验证后重命名与重新上传恢复为 94645 字节；大量中文文章页未全部切换到新 CSS，若访问文章页仍命中旧 CSS 缓存，需要按同一策略做分批 GBK/FTP 补传或重新构建发布新 hash。

2026-05-31：Wireshark 专题全量 CSS 引用修复

• 任务目标：全面修复 /wiki/wireshark/ 下页面仍引用坏 CSS 导致无样式、大 logo 的生产异常。
• 改动范围：仅修改本地 vants-rewritten/docs/.vitepress/dist/wiki/wireshark/**/*.html 与对应生产 /www/wiki/wireshark/**/*.html；将 803 个 Wireshark 专题 HTML 的 CSS 引用统一切换到 /assets/style.CgOJmV4Y.css；未触碰 /www/vantscn、/www/comments-api、评论数据库、后台 token 或生产配置。
• 验证方式：本地扫描确认总 HTML 803、坏 CSS 引用 0、新 CSS 引用 803；小批量 FTP 上传 803 个文件，uploaded_count=803、failed_count=0，记录文件 ftp-cleanup-vants-org-20260523/vants-wireshark-css-fix-production-20260531235539.json；线上抽样验证 /wiki/wireshark/、/wiki/wireshark/start.html、/wiki/wireshark/capture.html、/wiki/wireshark/tools.html、/wiki/wireshark/archive.html、/wiki/wireshark/archive/arp.html、/wiki/wireshark/archive/display-filters.html、/wiki/wireshark/archive/transmission-control-protocol.html 等均为 200，HTML 引用新 CSS 且不含旧坏 CSS；/assets/style.CgOJmV4Y.css 返回 200、Content-Type: text/css；浏览器实测专题首页与 archive 代表页均加载新 CSS，document.styleSheets 读取 1374 条规则，页面 chunk、app、theme、framework 资源加载成功。
• 遗留风险：旧坏 CSS URL 仍可能在 CDN 边缘缓存为 HTML，但 Wireshark 专题已不再引用；HTTPS/TLS 仍需独立修复；本次直接修补 dist 产物，未来重新构建若生成新的 hash 或恢复旧 CSS 引用，需按“资源先行、HTML 后行、检查 MIME 与首字节”的发布纪律重新验证。

2026-06-02：SampleCaptures 页面可读性与附件状态修复

• 任务目标：修复 /wiki/wireshark/archive/sample-captures 页面顶部卡片无跳转、说明表格缺少清晰线框、无附件条目排版突兀且状态不明确的问题。
• 改动范围：更新 docs/wiki/wireshark/archive/sample-captures.md，将顶部分类卡片改为 14 个页面内锚点导航，为主要章节补充稳定 id，并把 160 条裸文本抓包条目转换为 wireshark-missing-capture 状态卡片；更新 docs/.vitepress/theme/custom.css，新增 Wireshark 样例抓包库专用锚点卡片、表格边框/间距、可下载条目和缺附件条目样式；删除临时修复脚本，未引入依赖，未修改生产配置。
• 验证方式：运行 npm run build 成功，sitemap 仍生成 1085 个 URL，构建仅保留既有代码块语言 소 fallback 和 chunk 体积警告；本地 npm run preview -- --host 127.0.0.1 --port 4173 启动后，用 Playwright 访问 /wiki/wireshark/archive/sample-captures，确认 14 个顶部锚点均有目标章节，点击 #general 后 URL hash 更新且标题进入视口；运行时样式确认 table 匹配 .wireshark-archive-page table，th/td 有边框和 11px 14px padding；缺附件条目显示为 grid 卡片，左侧橙色边框，并包含“未提供可识别的下载附件”提示；截图留存 sample-captures-verified.png。
• 遗留风险：本次只做本地构建和本地预览验证，尚未生产发布；160 条缺附件条目基于现有页面文本自动标注，仍需后续结合 Wireshark Wiki 原始附件逐条复核；当前页面条目数量大，构建 chunk 体积警告仍存在。

2026-06-03：SampleCaptures 页面生产发布与缓存兜底

• 任务目标：将 /wiki/wireshark/archive/sample-captures 可读性修复发布到 vants.org 生产环境，并确认线上页面锚点、表格和缺附件状态卡片生效。
• 改动范围：先执行完整生产构建和 FTP 全量上传，上传 docs/.vitepress/dist 到 /www，未删除远端文件，未触碰 /www/vantscn 和 /www/comments-api；发现 CDN 对 /assets/chunks/theme.B75oPedZ.js 裸 URL 返回 text/html 后，采用最小补传方式为 SampleCaptures 页面改用带查询参数的资源引用，上传 /www/assets/app.D31cA8Io.js、/www/assets/chunks/theme.B75oPedY.js、/www/assets/chunks/VPLocalSearchBox.qBBpQD_F.js 和 /www/wiki/wireshark/archive/sample-captures.html；相关临时脚本已删除。
• 验证方式：生产构建成功，sitemap 生成 1085 个 URL；dry-run 显示 total_count=5839、non_ascii_path_count=666、受保护前缀为 /www/vantscn,/www/comments-api；首次生产上传 uploaded_count=5839、failed_count=0，记录 ftp-cleanup-vants-org-20260523/vants-deploy-production-20260603002846.json；最小缓存兜底补传两次均为 uploaded_count=4、failed_count=0，记录 vants-min-cache-bust-upload-20260603070027.json 和 vants-sample-captures-query-bust-upload-20260603070323.json；Playwright 线上访问 http://www.vants.org/wiki/wireshark/archive/sample-captures?cb=verify-query-bust-20260603，确认控制台 0 error/0 warning、14 个锚点均有目标、table 匹配 .wireshark-archive-page table 且 th/td 有边框与 11px 14px padding、缺附件条目为 grid 卡片并包含“未提供可识别的下载附件”提示。
• 遗留风险：npm run verify:vants 全量验证在历史中文文章页检查时出现远端连接中断 RemoteDisconnected，不是 SampleCaptures 页面本身失败；全站 HTML query-bust 补传曾尝试但因 FTP 连接被远端重置而中止，未纳入本次完成范围；旧裸 JS URL 仍可能被 CDN 缓存为错误 MIME，后续应作为独立的全站缓存治理任务分批处理。