Commit Graph
8 Commits
Author SHA1 Message Date
funjia a049492864 docs: 补上虚线边框的判定规则(边框 = 这一格纸上有东西) 2026-10-04 01:14:25 +08:00
funjia b78d104728 fix: 虚线边框改为「纸上有东西才画」(原 Web 版 + 插件版都改)
用户口径:**没内容时不要打印虚线,有内容时要打印**。
原来只有「空格」满足这条,另有两种状态违反:

- 双击「隐藏(不打印)」的格子:纸上什么都没有,虚线照印;
- 模板选了但内容全空(最典型是 CustomTag 把所有行的文字都清空):
  纸上什么都没有,虚线照印 —— 在纸上看它和空格一模一样。

改成把规则统一成一句话:**边框 = 这一格纸上真的会印出东西**。

- 空格 / 双击隐藏:由格子状态直接判定(LabelCell 新增 blank-on-paper
  类,由页面算好传进来 —— 只有页面知道模板的内容规则);
- 模板内容全空:交给模板自己判。两块代码各自在模板注册表里声明
  `hasContent`(插件在 templates/registry.ts,原 Web 版在 Main.vue 的
  templates 数组里)。

为什么不能让模板「什么都不声明」靠通用扫描:CustomTag 的行是
`{ text, size, bold, color }`,通用扫描扫到 `color: '#000000'` 就认为有内容了,
于是文字全清空的标签仍被判定成有内容。所以 Error / CustomTag 显式声明
hasContent;未声明的模板退回通用兜底 —— 兜底刻意偏「宽松」:多印一个空框
看得见、好排查;把有内容的标签判成空的,用户会以为东西丢了。

另外规格类模板标记 `alwaysPrints`:它们带左侧固定信息区(店铺名 / 电话 /
内置二维码图片),那部分不来自 config,所以「字段被清空」的规格标签仍有内容、
边框必须留 —— 否则用户清空字段后会发现边框莫名其妙没了。

验证(Playwright + 本机 Edge,真实打印管线):
- 插件版 5 项边框断言 + 上一轮的 13 项打印断言,全过;
- 原 Web 版 5 项边框断言全过;
- 两版都生成 PDF 用浏览器 PDF 视图渲染确认纸面:只有真正有内容的格子
  留下边框与内容,隐藏格 / 内容全空格在纸上是空白。
- 插件产物已升版本发布为 funjia.print-tag@1.0.2。
2026-10-04 01:14:04 +08:00
funjia b8842d5947 docs: 打印行为说明对齐(@page 边距为 0 的原因、Firefox 需手动关页眉、Ctrl+P 同样生效) 2026-10-04 00:32:23 +08:00
funjia 85f7f9abb4 fix: 打印不再输出浏览器页眉与序号(原 Web 版 + 插件版都修)
用户反馈:打印时页眉带日期时间,序号 1–44 也被印出来。两处根因如下。

1. 浏览器页眉(左上角日期时间 + 标题)
   @page 边距非 0 时,浏览器会在「页边距那块空白」里画它自己的页眉页脚。
   CSS 里没有关掉它的开关 —— 把边距清零、让那块空白消失,是 Chromium/Edge 上
   唯一可靠的做法(Firefox 的页眉页脚是打印对话框里的独立选项,CSS 管不了)。
   代价:标签纸在纸上的位置不能再靠 @page margin 给,改由 .page / .pt-paper 的
   left / top 控制 —— 物理结果与之前完全一致,顶栏「上下/左右边距」的含义
   变成「标签纸离纸边的距离」。

2. 序号角标与空格虚线引导照样打印
   visibility 是**可被子元素覆盖的继承属性**。原来只隐 `.id` / `.pt-cell__idx`,
   父元素确实隐了,但下面那条让标签纸整体可见的 `.page * { visibility: visible }`
   会**直接命中里面的 <span>1</span>** 把它又显出来 —— 序号照样印在纸上,
   而这条规则看上去毫无问题。现在所有「打印时不该出现」的选择器一律写成
   `.x, .x *` 两段;插件版还要求它们排在 `.pt-paper *` 之后
   (同特异性 + 同 !important 时后写的赢,写前面等于没写、还不报错)。
   顺带修掉双击「隐藏(不打印)」的格子内容仍被打印的问题。

顺带加固:
- Ctrl+P 也走同一套样式 —— 加 beforeprint 监听(原来只有点插件按钮才注入)。
- 撤销样式改用 node.remove():对已脱离的节点调 removeChild 会抛 NotFoundError,
  把整段注入打断在半路,症状是「这次打印什么都没生效」。

验证(Playwright + 本机 Edge,走真实打印管线):
- 插件版 13 项断言通过;原 Web 版 12 项断言通过。
- 两版都生成 PDF(displayHeaderFooter: true)并用浏览器 PDF 视图渲染确认:
  页眉无日期时间、无序号、双击隐藏的格子留白、有内容的格子正常打印。
- 插件产物已升版本发布为 funjia.print-tag@1.0.1。
2026-10-04 00:32:03 +08:00
funjia d95ec56e32 docs(plugin): README 对齐——mock 的 SN 校验位算法已镜像真后端,补 source 字段说明 2026-10-04 00:01:45 +08:00
funjia 0cbff3ccd5 feat(plugin): 发放 SN 带 source;插件 id 收敛到 src/meta.ts
- 新增 src/meta.ts 作为 PLUGIN_ID 的唯一字面量来源(index.ts 与页面共用)。
  这个 id 同时出现在 config、自注册 manifest、菜单/路由/命令 id 前缀、
  发放请求的 source 四处,任何一处抄错都是难查的静默故障。
- 发放请求加 source: funjia.print-tag(页面与 print-tag:issue-sn 命令都加)。
  后端 callerMeta 明确建议插件填自己的 ID,否则 SN 台账里一律记成 pc,
  分不清是插件发的还是别的入口发的。已在预览里验证落到台账。
- preview/mock-api.ts 的 SN 部分改为逐位镜像真后端(库存管理系统
  backend/src/api/sn-code/):校验位算法与字符表照抄,SN 形状/正则/补位口径一致。
  实测 mock 产出的 SN 全部能通过真后端校验位算法 —— 本地调通的码切到真后端不会失效。

最终验收:typecheck 通过;插件自检 0 error;仓库 verify-repository 32 passed / 0 failed;
repo-doctor 0 error 0 warning;源码模式与产物模式预览均跑通且无控制台报错。
2026-10-04 00:01:26 +08:00
funjia 7c986fd5c5 perf(plugin): 条码/二维码 SVG 加参数指纹缓存
页面每次重渲染都会重新构造标签上下文对象,TagShell 的 computed 随之失效 ——
44 格的二维码每次都要重拼 2 万多个 <rect>,点一下格子就可能卡半秒。
按「参数指纹」缓存字符串即可(同一个 SN + 同一套参数,SVG 必然一模一样),
FIFO 上限 400 条避免无限增长。顺带把缓存块挪到文件前部(原在声明之后,读起来别扭)。

已用真实模块做过端到端验证(esbuild 打包 src/codes.ts 后跑 node):
- qrSvg 的真实 SVG 反解回矩阵 → jsQR 解码,6/6 与原串一致;
- code128Svg 的真实 rect 还原成游程序列 → 与 code128Bits 逐段一致(A / 16 位 SN / 12 位 SN);
- 缓存:同参数命中、换参数/换文本不串味、显式默认值与省略命中同一份。

产物已重新发布到插件仓库(同版本 1.0.0 覆盖,该版本尚未交付)。
2026-10-03 23:53:56 +08:00
funjia ef41d98838 feat: 新增 plugin/ 插件化形态(funjia.print-tag)+ 可选 SN 条码/二维码
把本工程的标签排版能力改造成 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
2026-10-03 23:48:32 +08:00