# viewers/assets/vendor —— 内置的第三方前端库（Vue 3 + Element Plus）
## 为什么是"内置文件"而不是 npm 依赖 / 构建产物
这一版的查看器用 **Vue 3 + Element Plus** 重构（2026-10-10），但**不引入构建步骤**。原因不是
"省事"，而是这个仓库里三条已经成立的事实：
1. **部署靠内容哈希逐文件同步**。`memory/viewers/deploy.ts` 扫 `viewers/` 下每个文件、算 sha256、
写进 `{profile}/memoryDB/viewers/`，版本号 = `包版本+内容哈希前 8 位`。只要库文件是**仓库里的
普通文件**，它就自动被这套机制带上，`/api/viewer-status` 的漂移检测也自动覆盖它们 ——
不需要给部署器加"要不要拷贝 node_modules/dist"这类分支。
2. **页面是 classic script，没有打包器**。`file://` 下浏览器禁止 ES module 与 fetch，但允许
`
```
样式表顺序：`element-plus/index.css` → `element-plus/dark.css` → `viewer-theme.css`（最后一份覆盖前两份）。
## 升级步骤
1. 从 unpkg 下载新版本到临时目录（按上表同样的路径），确认两个全局仍在：
`node -e "const s=require('fs').readFileSync('index.full.min.js','utf8'); console.log(/ElementPlus/.test(s))"`。
2. `sha256sum` 更新上表（**表要与文件同步改**，否则这张表本身就是新的错误来源）。
3. 覆盖到本目录，然后在**浏览器里真开一次五个页面**（`scripts/verify-viewer-deploy.ts` 只能证明
引用存在，证明不了新版组件还能正常渲染）。
4. 跑 `npm run verify:viewer` 与 `verify:viewer-quality`，再按 `README.md` 的"界面约定"看一遍
主题令牌是否仍然生效（EP 大版本会重命名 `--el-*` 变量，主题桥会静默失效 —— 这是升级最容易漏的一环）。