diff --git a/plugin/README.md b/plugin/README.md index 4326204..9557425 100644 --- a/plugin/README.md +++ b/plugin/README.md @@ -8,6 +8,10 @@ - 上架位置:`funjia-plugin-repository` 插件仓库的 `repository/plugins/funjia.print-tag/<版本>/` (版本号在 `plugin.config.json` 里改,当前见该文件) +> **产物自带样式。** JS 里内联了那份 CSS 并会在加载时自动注入, +> 所以消费方**只取 `entry` 也能正常显示** —— 不依赖它记得读 `style` 并注入 ``。 +> 详见下面「产物形态」一节。 + 仓库根目录那份 `src/` 是**原独立 Web 版**,两者并存、互不影响。 --- @@ -121,6 +125,7 @@ POST /api/sn-codes/verify 校验 → { valid, reason, exists, record plugin/ ├── plugin.config.json ★ 元数据唯一真源(id / 版本 / 产物名 / 扩展点声明) ├── postcss.config.js 截断 PostCSS 查找链(否则会加载仓库根目录的 Tailwind 配置) +├── vite.config.ts 构建配置;含 selfInjectStyles() —— 让产物自带样式(见 §5) ├── src/ │ ├── index.ts ★ 插件入口:生命周期 + 注册菜单/路由/2 个命令 │ ├── codes.ts Code 128 与真 QR 的 SVG 生成(纯函数,单位 mm) @@ -150,7 +155,34 @@ PREVIEW_API_TARGET=http://127.0.0.1:1337 npm run dev --- -## 五、已知边界 +## 五、产物形态:为什么 JS 里带着一份 CSS + +仓库契约里 `style` 是**独立字段**:消费方要自己读它、注入 ``。 +文档写清楚了,官方参考消费方(宿主的 `public/repo-consumer.html`)也照做了 —— +但**第三方很容易只取 `entry`**,于是插件能跑、页面却是白板(布局全靠 CSS, +样式没了等于不可用)。实测过那种状态:文档里插件样式表数量 **0**, +`.pt-panel` 的宽度从 356px 变成撑满的 1368px。 + +一个交付物不该依赖消费方记得做第二步。所以 `vite.config.ts` 里有个 +`selfInjectStyles()` 插件,在 `generateBundle` 阶段把抽出的 CSS 内联进 JS, +脚本一加载就注入 `