From ef41d988387ac17208e46eb1500ca51c74ce8922 Mon Sep 17 00:00:00 2001 From: funjia <13429193897@163.com> Date: Sat, 3 Oct 2026 23:48:32 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20plugin/=20?= =?UTF-8?q?=E6=8F=92=E4=BB=B6=E5=8C=96=E5=BD=A2=E6=80=81=EF=BC=88funjia.pr?= =?UTF-8?q?int-tag=EF=BC=89+=20=E5=8F=AF=E9=80=89=20SN=20=E6=9D=A1?= =?UTF-8?q?=E7=A0=81/=E4=BA=8C=E7=BB=B4=E7=A0=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 把本工程的标签排版能力改造成 FunjiaUI 远端插件,放进 plugin/ 子目录, 与原独立 Web 版并存(两者功能一致,模板/版面/打印行为逐项对齐)。 - 入口从 createApp().mount() 改为 activate(ctx) + ctx.addRoute,注册 1 菜单 / 1 路由 / 2 命令 - 11 个模板的渲染收敛成 SpecTag,差异集中到 templates/registry.ts(字段/选项/默认值原样保留) - 店铺名 / 电话从写死改为可配置,记忆在插件私有存储 - 内置二维码图片改为打包 data URL —— 远端插件没有自己的 public/ - 去掉 @headlessui/vue(换原生 select)与 Tailwind,样式类名统一 pt- 前缀避免污染宿主 - 可选接入宿主 api::sn-code:按 SN 生成真 Code 128 条码与可扫二维码; 关闭时(默认)完全保持原静态二维码行为。领码优先贴到已排版的格子,不够才新建 - 新增 commands: print-tag:issue-sn / print-tag:render-svg(后者纯本地出图,供其它插件复用) - code128.ts 实现真 Code 128 Set B(含校验位);二维码走 qrcode-generator(真 QR) - 自带本地预览器(preview/mock-api.ts 补了 /api/sn-codes mock)与 deploy / verify 脚本 - verify.mjs 修掉一处误报:源码边界判据改为「解析后是否逃出工程根」, 而不是「说明符是否以 .. 开头」(后者会把 src/components/X.vue → ../codes 误判为越界) 已发布到插件仓库:funjia.print-tag@1.0.0 --- README.md | 13 + plugin/.gitignore | 11 + plugin/README.md | 146 ++++ plugin/env.d.ts | 17 + plugin/package-lock.json | 702 +++++++++++++++ plugin/package.json | 28 + plugin/plugin.config.json | 41 + plugin/postcss.config.js | 17 + plugin/preview/App.vue | 689 +++++++++++++++ plugin/preview/api-contract.ts | 117 +++ plugin/preview/artifact.html | 26 + plugin/preview/contract.ts | 96 +++ plugin/preview/host.ts | 891 +++++++++++++++++++ plugin/preview/index.html | 35 + plugin/preview/loaders.ts | 195 +++++ plugin/preview/main-artifact.ts | 21 + plugin/preview/main-source.ts | 22 + plugin/preview/mock-api.ts | 498 +++++++++++ plugin/preview/mount.ts | 59 ++ plugin/preview/runtime.ts | 27 + plugin/preview/shims/funjiaui.ts | 164 ++++ plugin/preview/style.css | 534 ++++++++++++ plugin/scripts/deploy.mjs | 187 ++++ plugin/scripts/verify-preview.sh | 312 +++++++ plugin/scripts/verify.mjs | 597 +++++++++++++ plugin/src/assets/default-qr.ts | 2 + plugin/src/codes.ts | 303 +++++++ plugin/src/components/DynamicForm.vue | 329 +++++++ plugin/src/components/Input.vue | 82 ++ plugin/src/components/LabelCell.vue | 153 ++++ plugin/src/components/Select.vue | 84 ++ plugin/src/components/TagShell.vue | 167 ++++ plugin/src/index.ts | 169 ++++ plugin/src/pages/PrintTagPage.vue | 1130 +++++++++++++++++++++++++ plugin/src/runtime.ts | 27 + plugin/src/sdk.ts | 210 +++++ plugin/src/templates/CustomTag.vue | 68 ++ plugin/src/templates/ErrorTag.vue | 54 ++ plugin/src/templates/SpecTag.vue | 38 + plugin/src/templates/registry.ts | 281 ++++++ plugin/tsconfig.json | 25 + plugin/vite.config.ts | 96 +++ plugin/vite.preview.config.ts | 172 ++++ 43 files changed, 8835 insertions(+) create mode 100644 plugin/.gitignore create mode 100644 plugin/README.md create mode 100644 plugin/env.d.ts create mode 100644 plugin/package-lock.json create mode 100644 plugin/package.json create mode 100644 plugin/plugin.config.json create mode 100644 plugin/postcss.config.js create mode 100644 plugin/preview/App.vue create mode 100644 plugin/preview/api-contract.ts create mode 100644 plugin/preview/artifact.html create mode 100644 plugin/preview/contract.ts create mode 100644 plugin/preview/host.ts create mode 100644 plugin/preview/index.html create mode 100644 plugin/preview/loaders.ts create mode 100644 plugin/preview/main-artifact.ts create mode 100644 plugin/preview/main-source.ts create mode 100644 plugin/preview/mock-api.ts create mode 100644 plugin/preview/mount.ts create mode 100644 plugin/preview/runtime.ts create mode 100644 plugin/preview/shims/funjiaui.ts create mode 100644 plugin/preview/style.css create mode 100644 plugin/scripts/deploy.mjs create mode 100644 plugin/scripts/verify-preview.sh create mode 100644 plugin/scripts/verify.mjs create mode 100644 plugin/src/assets/default-qr.ts create mode 100644 plugin/src/codes.ts create mode 100644 plugin/src/components/DynamicForm.vue create mode 100644 plugin/src/components/Input.vue create mode 100644 plugin/src/components/LabelCell.vue create mode 100644 plugin/src/components/Select.vue create mode 100644 plugin/src/components/TagShell.vue create mode 100644 plugin/src/index.ts create mode 100644 plugin/src/pages/PrintTagPage.vue create mode 100644 plugin/src/runtime.ts create mode 100644 plugin/src/sdk.ts create mode 100644 plugin/src/templates/CustomTag.vue create mode 100644 plugin/src/templates/ErrorTag.vue create mode 100644 plugin/src/templates/SpecTag.vue create mode 100644 plugin/src/templates/registry.ts create mode 100644 plugin/tsconfig.json create mode 100644 plugin/vite.config.ts create mode 100644 plugin/vite.preview.config.ts diff --git a/README.md b/README.md index f8bdb83..56dd10f 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,19 @@ --- +## 两种形态 + +| 位置 | 形态 | 用途 | +| --- | --- | --- | +| 仓库根目录(本 README 描述的部分) | 独立 Web 应用 | `npm run dev` 直接跑,适合快速改模板 / 试排版 | +| [`plugin/`](./plugin/README.md) | **FunjiaUI 远端插件** `funjia.print-tag` | 装进宿主(设备管理 → 标签打印),并支持**可选**接入 SN 码接口生成真条码 / 二维码 | + +两个形态功能一致:44 格版面、11 个内置模板、批量填充、逐格编辑、打印边距全部保持原样。 +插件形态额外把「店铺名 / 电话」做成可配置,并加了可选的 SN 码能力。 +插件工程里也有一个自带 mock 后端的本地预览器,改代码不必每次都装进宿主。 + +--- + ## 功能简介 ### 标签版面 diff --git a/plugin/.gitignore b/plugin/.gitignore new file mode 100644 index 0000000..45d249d --- /dev/null +++ b/plugin/.gitignore @@ -0,0 +1,11 @@ +# 依赖 +node_modules/ + +# 构建产物(产物通过 scripts/deploy.mjs 交付给仓库,不进版本库) +dist/ + +# 日志与系统文件 +*.log +.logs/ +.DS_Store +Thumbs.db diff --git a/plugin/README.md b/plugin/README.md new file mode 100644 index 0000000..6605e6e --- /dev/null +++ b/plugin/README.md @@ -0,0 +1,146 @@ +# 标签打印插件(`funjia.print-tag`) + +本目录是 `print-tag-system` 的**插件化形态**:同一套标签排版 / 打印能力, +改造成可被 FunjiaUI 宿主装载的远端插件,并加了**可选的 SN 码 → 条码 / 二维码**能力。 + +- 插件 id:`funjia.print-tag` +- 产物:`dist/PrintTagBundle.iife.js` + `dist/PrintTagBundle.css`(IIFE,自注册) +- 上架位置:`funjia-plugin-repository` 插件仓库的 `repository/plugins/funjia.print-tag/1.0.0/` + +仓库根目录那份 `src/` 是**原独立 Web 版**,两者并存、互不影响。 + +--- + +## 一、和原 Web 版的关系 + +| 能力 | 原 Web 版 | 本插件 | +| --- | --- | --- | +| 启动方式 | `createApp(App).mount('#app')`,自己起 Vite 服务 | 宿主装载 → `activate(ctx)` → `ctx.addRoute` 挂页面 | +| 路由 / 菜单 | 无(单页) | 注册到宿主侧边栏(设备管理 → 标签打印) | +| 内置模板 | 11 个 `.vue` 文件 | 11 个模板,渲染收敛成 `SpecTag`,差异集中在 `templates/registry.ts` | +| 二维码图片 | 站点根目录 `/qrcode.png` | 打包成 data URL 内置(远端插件没有自己的 `public/`) | +| 下拉选择 | `@headlessui/vue` Listbox | 原生 `