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 | 原生 `