page2pdf_server 1.0.2 → 1.1.0

package/README.md

@@ -42,12 +42,17 @@ chrome-remote-interface不会为您启动Chrome。本来想用chrome-remote-inte
   注意，动态网页在Chrome浏览器直接打印预览的效果应该和本软件转换输出的pdf一致效果，为打印设置的css必须在应用层中自己去添加的。
 纯粹静态html的打印转换pdf，且是标准纸张大小的横竖纸张方向掺杂的这种情况：考虑一次提取一部分pageRanges[]吗，分解多个的files[url,out]独立生成之后做合并。
 
-## Prerequisites
+## Prerequisites 必须配置的
 
-- [Node.js](https://nodejs.org) (`>= 18.0.0`)
+- [Node.js](https://nodejs.org) (`>= 20.0.0`)
 - [Yarn](https://yarnpkg.com/en/docs/install) or [NPM](https://docs.npmjs.com/getting-started/installing-node)
-- 谷歌浏览器，要配置端口号，启动命令设置 C:\Users\herzhang\AppData\Local\Google\Chrome\Application\chrome.exe --remote-debugging-port=9872
-
+- 客户电脑必须有Chrome浏览器；
+- 要点击谷歌浏览器的链接，要配置端口号，启动命令设置：目标修改： C:\Users\herzhang\AppData\Local\Google\Chrome\Application\chrome.exe --remote-debugging-port=9872
+ 比如： "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9872
+- 之后服务期间，需要首先就该点击该链接开启Chrome浏览器。
+- 特别注意：windows用户若非管理员账户的：桌面上的Chrome快捷方式右键点属性在“兼容性”设置中：必须勾选“管理员身份运行”；
+ 注意浏览器的管理员和普通身份运行的效果进入显示都不同的。目标URL网站需要登陆处理的，登陆点击后浏览器没有反馈，需直接关闭该TAB页面。
+-报错Error: connect ECONNREFUSED 127.0.0.1:9872 【解决】先在windows任务管理器把chrome.exe的进程全部关闭后重来。
 ## Install
 
 - Fork or Use [this](https://github.com/filoscoder/tenstack-starter/generate) template repository.
@@ -57,8 +62,10 @@ chrome-remote-interface不会为您启动Chrome。本来想用chrome-remote-inte
 > Make sure you already have [`node.js`](https://github.com/filoscoder/tenstack-starter#prerequisites) and [`npm`](https://github.com/filoscoder/tenstack-starter#prerequisites) or [`yarn`](https://github.com/filoscoder/tenstack-starter#prerequisites) installed in your system.
 
 - Set your `git remote add origin` path
-- 用户端电脑地安装:
-  只需要本工程 /config, /dist, 文书打印转换器.bat, 已经node.js,nodemon; 
+- 用户电脑也需要做些安装的:
+  只需要本工程目录的 /config, /dist, 文书打印转换器.bat，新/pdfs目录, 并且页已经node.js, nodemon; 
+  还必须要安装工程目录/package.json; /module-alias/的目录全部依赖包的。
+- 
 ```bash
  git remote add origin ${forked-and-cloned-path}
 ```
@@ -82,7 +89,9 @@ chrome-remote-interface不会为您启动Chrome。本来想用chrome-remote-inte
 <br>
 <br>
 
-## Alias @
+## Alias 其它，对比 @
+  Puppeteer 是一个基于Chrome调试协议CDP 构建的额外高层 API，除其他功能外，它可以启动并使用捆绑版本的 Chromium，而非系统上安装的版本。
+  我这个工具目前使用CDP协议构建的,而不是利用Puppeteer做的。
 
 To make paths clean and ease to access `@` is setup up for `/src` path
 
@@ -203,25 +212,31 @@ If you have any question or suggestion, don't hesitate to contact me:
 
   注意，如果发送post请求的body底下的内容实际为空的话，本转换器默认执行：把工作目录的所有pdf文件按照修改时间顺序进行合并，默认输出文件名=配置好的名字。
   假若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
+# 调试 "start": "NODE_ENV=development run-s prettify lint & nodemon" 用Debug，异步执行，打断块点有点毛病
 
 # 页眉页脚配置html脚本转为json后
 例子,用https://uutool.cn/html2json/ 工具可转换,转换才能通过api/pdf发送命令的。
-"lay": {
-  "head": [
-    "<div style=\\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\\"></span>",
-    "<div style=\\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\\"><span class=title></div>",
-    "<div style=\\\"position: absolute; text-align: right; bottom: 5px;right: 20px;\\\">version: 1.0</div>",
-    "</div>"
-  ] ,
-  "foot": [
-    "<div style=\\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\\">",
-    "<div style=\\\"position: absolute; text-align: left; top: 5px;left: 60px;\\\">YYYY-MM-DD</div>",
-    "<div style=\\\"position: absolute; width: 100%; text-align: center; top: 5px;\\\">&copy;2022 ABCD</div>",
-    "<div style=\\\"position: absolute; text-align: right;top: 5px;right: 20px;\\\"> <span class=pageNumber></span> / <span class=totalPages></span></div>",
-    "</div>"
-  ]
-}
-
+ { name: (original ? "记录" : "报告") + rep?.isp?.no,
+  singleTab: true,
+  lay: {
+  head: [
+    '<div style=\\"position: relative; width:100%; text-align:center; border-bottom: 1pt solid #eeeeee; margin: 3.5mm 0px 10px; font-size: 10pt\\">',
+    `<div style=\\"position: absolute; width:100%; text-align:left; bottom: 5px; left: 50px;\\">报告No: ${rep?.isp?.no}</div></div>`
+  ],
+  foot: [
+    '<div style=\\"position: relative; width: 100%; text-align: left; border-top: 1pt solid #eeeeee; margin:  10px 0px 1.5mm; font-size: 8pt;\\">',
+    '<div style=\\"position: absolute; width: 100%; text-align: center; top: 5px;\\">共<span>~pageNumber~</span>页 / 第<span>~totalPages~</span>页</div></div>'
+    ],
+  },
+  files: [
+    {
+      url,
+      out: `tmp-${rep?.isp?.no}` + (original ? "-O" : ""),
+      headFrom: 3,
+      frNo: 3,
+    },
+  ] }
+其中 -NOT_DISPLAY- 指示若没有页码的就不显示相关局部部分。
 # 注意适用性
   本文书打印转换器只能适用单用户在客户本机用，每次执行一个打印指令，不要并行发出指令，本机工作目录也是临时文件，针对当前指令适用的，不能存放无关文件。
   本转换器console命令输出窗口可实时观察到当前打印转换指令的执行过程输出提示，同时目标浏览器也会新开启浏览窗口，这些由本转换器自动开启的浏览窗口实际上
@@ -237,3 +252,19 @@ If you have any question or suggestion, don't hesitate to contact me:
      {"name":"D4", "css": "10.4in 12.6in","w": 10.4,"h": 12.6}
    ]
  }
+# 拒绝连接的 
+对Chrome 右键 点选 以管理员身份运行；
+# 动态布局问题
+  只用css做动态的组件和用了js脚本做动态布局的组件在打印时刻不同，比如"customize-easy-ui-component"库的LineColumnFlex和LineColumn的差别即使这样，
+  前者在打印时刻需要约束浏览器窗口的宽度为纸张输出的宽度差不多的大小，后者可打印页数就可能和内容页数不一致，后者只用css的就不会有这个麻烦。
+  就算同一个组件有可能出现：同一次打印出现两种布局状态。比如这样的：<LineColumnFlex 1> {useMediaQuery({query: 'print'}) && <LineColumnFlex 2>}的，
+  前面一个是js按照浏览器打印触发之前的div宽度来布局的有5列，然而后面哪一个是按照最终纸张输出宽度来做布局的才2列，完全不一样了！但是后面第二个组件可能输出不完整的，
+  因为打印纸张的输出页数实际在useMediaQuery({query: 'print'})逻辑条件成立以前就敲定了可打印纸张数量！！所以有很大问题。js动态代码简单，css动态写代码麻烦。
+  就接着这个例子讲：用{useMediaQuery({query: 'print'})&&逻辑嵌套的哪些内容，就算我约束了浏览器宽度为纸张宽度以后，实际上在打印敲定输出页数时间这些逻辑嵌套的
+  需要打印内容实际上也并没有计算在立刻敲定输出页数之内的，因此也必然导致打印页数丢失或不够的问题的，这个情况必须用css,除非不打印比打印语境内容占用高度还少的话。
+  <div css={{"@media not print": {display: 'none'}}}>
+       <LineColumnFlex  column={7}>
+  </div>
+  如上代码会有严重毛病：打印输出实际上只有一次机会render；useMeasure(ref还是空的)div宽度=0导致实际只有输出一列的布局，打印没机会修正了，屏幕情况可以不限次数render，
+  可是打印就不行了，上面这情况太特殊了。
+

package/ecosystem.config.js

@@ -1,41 +1,41 @@
-module.exports = {
-  apps: [
-    {
-      name: '<app-name>',
-      script: 'dist/src/index.js',
-      // Options reference: https://pm2.keymetrics.io/docs/usage/application-declaration/
-      exec_mode: 'cluster',
-      instances: 2,
-      kill_timeout: 5000,
-      autorestart: true,
-      max_restarts: 10,
-      watch: true,
-      watch_options: {
-        followSymlinks: false,
-      },
-      max_memory_restart: '1G',
-      env: {
-        NODE_ENV: 'development',
-      },
-      env_production: {
-        NODE_ENV: 'production',
-        port: 8080,
-      },
-      merge_logs: true,
-      log_date_format: 'YYYY-MM-DDTHH:mm:ss.sssZ',
-    },
-  ],
-  // https://pm2.keymetrics.io/docs/usage/deployment/
-  deploy: {
-    production: {
-      key: process.env.EC2_PEM_PATH,
-      host: process.env.EC2_HOST,
-      user: 'ubuntu',
-      ref: 'origin/main',
-      repo: 'git@github.com:<username>/<repo-name>.git',
-      path: '/home/ubuntu',
-      'post-deploy':
-        'yarn && yarn clean && yarn build && pm2 startOrRestart ecosystem.config.js --env production && pm2 set pm2:autodump true && pm2 save',
-    },
-  },
-};
+module.exports = {
+  apps: [
+    {
+      name: '<app-name>',
+      script: 'dist/src/index.js',
+      // Options reference: https://pm2.keymetrics.io/docs/usage/application-declaration/
+      exec_mode: 'cluster',
+      instances: 2,
+      kill_timeout: 5000,
+      autorestart: true,
+      max_restarts: 10,
+      watch: true,
+      watch_options: {
+        followSymlinks: false,
+      },
+      max_memory_restart: '1G',
+      env: {
+        NODE_ENV: 'development',
+      },
+      env_production: {
+        NODE_ENV: 'production',
+        port: 8080,
+      },
+      merge_logs: true,
+      log_date_format: 'YYYY-MM-DDTHH:mm:ss.sssZ',
+    },
+  ],
+  // https://pm2.keymetrics.io/docs/usage/deployment/
+  deploy: {
+    production: {
+      key: process.env.EC2_PEM_PATH,
+      host: process.env.EC2_HOST,
+      user: 'ubuntu',
+      ref: 'origin/main',
+      repo: 'git@github.com:<username>/<repo-name>.git',
+      path: '/home/ubuntu',
+      'post-deploy':
+        'yarn && yarn clean && yarn build && pm2 startOrRestart ecosystem.config.js --env production && pm2 set pm2:autodump true && pm2 save',
+    },
+  },
+};

package/jest.config.js

@@ -1,35 +1,35 @@
-const { defaults: tsjPreset } = require("ts-jest/presets");
-
-module.exports = {
-  preset: "ts-jest",
-  moduleFileExtensions: ["ts", "js", "json"],
-  transform: {
-    "^.+\\.(ts|tsx)$": [
-      "ts-jest",
-      {
-        tsconfig: "tsconfig.json",
-        diagnostics: false,
-      },
-    ],
-    ...tsjPreset.transform,
-  },
-  testPathIgnorePatterns: ["dist"],
-  testMatch: ["**/__tests__/**/*.test.(ts|js)"],
-  testEnvironment: "node",
-  moduleNameMapper: {
-    "@/(.*)": "<rootDir>/src/$1",
-  },
-  watchPlugins: [
-    "jest-watch-typeahead/filename",
-    "jest-watch-typeahead/testname",
-  ],
-  coverageThreshold: {
-    global: {
-      branches: 1,
-      functions: 1,
-      lines: 1,
-      statements: 1,
-    },
-  },
-  coverageReporters: ["json", "lcov", "text", "clover"],
-};
+const { defaults: tsjPreset } = require("ts-jest/presets");
+
+module.exports = {
+  preset: "ts-jest",
+  moduleFileExtensions: ["ts", "js", "json"],
+  transform: {
+    "^.+\\.(ts|tsx)$": [
+      "ts-jest",
+      {
+        tsconfig: "tsconfig.json",
+        diagnostics: false,
+      },
+    ],
+    ...tsjPreset.transform,
+  },
+  testPathIgnorePatterns: ["dist"],
+  testMatch: ["**/__tests__/**/*.test.(ts|js)"],
+  testEnvironment: "node",
+  moduleNameMapper: {
+    "@/(.*)": "<rootDir>/src/$1",
+  },
+  watchPlugins: [
+    "jest-watch-typeahead/filename",
+    "jest-watch-typeahead/testname",
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 1,
+      functions: 1,
+      lines: 1,
+      statements: 1,
+    },
+  },
+  coverageReporters: ["json", "lcov", "text", "clover"],
+};

package/nodemon.json

@@ -1,6 +1,6 @@
-{
-  "watch": ["src/**/*.ts", ".env"],
-  "ext": "ts,js,.env",
-  "verbose": false,
-  "exec": "ts-node -r tsconfig-paths/register --files src/index.ts"
-}
+{
+  "watch": ["src/**/*.ts", ".env"],
+  "ext": "ts,js,.env",
+  "verbose": false,
+  "exec": "ts-node -r tsconfig-paths/register --files src/index.ts"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page2pdf_server",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "文书打印转换器",
   "private": false,
   "authors": "herzhang",
@@ -46,6 +46,7 @@
     "chrome-remote-interface": "^0.32.2",
     "config": "^3.3.9",
     "connect-timeout": "^1.9.0",
+    "@types/cors": "^2.8.13",
     "cors": "^2.8.5",
     "cross-env": "^7.0.3",
     "dotenv": "^16.3.1",
@@ -61,22 +62,20 @@
     "pino-http": "^8.3.3",
     "pino-pretty": "^10.0.0",
     "rimraf": "^5.0.1",
+    "@types/node": "^20.3.1",
+    "@types/jsonwebtoken": "^9.0.2",
+    "@types/express": "^4.17.17",
+    "@types/express-pino-logger": "^4.0.3",
+    "@types/bcrypt": "^5.0.0",
     "save-dev": "^0.0.1-security"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.22.5",
     "@babel/preset-typescript": "^7.22.5",
-    "@types/bcrypt": "^5.0.0",
     "@types/connect-timeout": "^0.0.37",
-    "@types/cors": "^2.8.13",
-    "@types/express": "^4.17.17",
-    "@types/express-pino-logger": "^4.0.3",
     "@types/jest": "^29.5.2",
-    "@types/jsonwebtoken": "^9.0.2",
     "@types/lodash-es": "^4.17.7",
-    "@types/module-alias": "^2.0.1",
     "@types/morgan": "^1.9.4",
-    "@types/node": "^20.3.1",
     "@types/supertest": "^2.0.12",
     "@typescript-eslint/eslint-plugin": "^5.59.11",
     "@typescript-eslint/parser": "^5.59.11",
@@ -87,7 +86,6 @@
     "husky": "^8.0.3",
     "jest": "^29.5.0",
     "jest-watch-typeahead": "^2.2.2",
-    "module-alias": "^2.2.3",
     "nodemon": "^3.0.1",
     "npm-run-all": "^4.1.5",
     "pm2": "^5.3.0",
@@ -99,6 +97,6 @@
     "typescript": "^5.1.6"
   },
   "engines": {
-    "node": ">= 18.0.0"
+    "node": ">= 20.0.0"
   }
 }

package/src/CSS/345/205/274/345/256/271/346/200/247.txt

@@ -54,3 +54,72 @@ Chrome浏览器已经 可支持的有这些：
     CDP({})前后两次CDP打开新的Page若前面没有close(),那么旧Page.printToPDF也会被后面新Page.navigate所覆盖的，浏览器不支持合并打印的！
     Page.printToPDF({}）实际也只能类似Chrome打印预览菜单一致，只能打印当前页面，动态内容页面也是随着鼠标用户操作有可能不一样的打印结果。
 
+【精准控制打印位置思路】
+ 简单直接做法<span  position: absolute; bottom: -1200vh;">尾巴</span>但须知道整个文档打印几张纸的，然后在作为参数优化css的计算再来决定做控制，可能会有重叠paint需强制断开页。
+ 中间区域<div style="position: relative; page-break-before: always;">￥..<span style="position: absolute;top: calc(200vh - 3rem);">尾巴</span>
+ 必须知道该区域有几张纸；可能会有重叠paint需强制断开页。
+ 浮动布局<div style="display: flex; flex-direction: column; align-content: flex-end; height: 1300vh;"><div height: 100%;>￥</div><div display: inline-flex;>尾巴</div>必须知道该区域有几张纸，不用担心会有重叠paint。
+ 后面一定有强制页断开的情景，把紧邻前面的元素定位到纸张的底部位置？【关键】是强制分页能确保独立性。
+ <div css={{"@media print": {pageBreakBefore: 'always'}}}><span style="position: absolute;top: -3rem;">尾巴</span><Text>紧跟的新页</Text></div>不需要算区域有几张，不用担心会有重叠paint。
+ 最后一页情况乱特例<div style="height: 0vh; position: relative; page-break-before: always;"><span style="display: block; position:absolute; bottom:0;">尾巴</span></div>最后多个尾随的空白页！多出一个空白页情况的不打印？
+2023/11/23：验证这下的代码还是无法正常打印页码 位置的。每一个重复div标签计数一次，只显示一次。
+                <div css={{"@media print": {pageBreakBefore: 'always'}}}>
+                    <div
+                          css={{
+                              position: 'absolute',
+                                top: '-2rem',
+                              "@media print": {
+                                  ":after": {
+                                      content: 'counter(page)',
+                                  },
+                                  counterIncrement: 'page',
+                                  // position: 'absolute',
+                                  // bottom: '8rem',
+                                  right: '-1rem',
+                                  fontSize: '12px',
+                                  color: '#777',
+                                  padding: '5px',
+                                  backgroundColor: '#f7f7f7',
+                                  border: '1px solid #ddd',
+                                  borderRadius: '2px',
+                                  // pageBreakAfter: 'always',
+                              }
+                          }}
+                    >
+                        尾巴
+                    </div>
+                    <Text>紧跟的新页</Text>
+                </div>
+【动态内容遇到的打印问题】末尾插入方式“只能支持页面启动就明确打印页数的才有效；用副作用中间纯动态变更的就不行了，打印页数早就被限制死了，后面无法再改了。
+    const [vtpage, setVtpage] = React.useState(Math.ceil((yBdv0?.top!-yHolw?.bottom!)/yHolw?.width!) || 0);
+    React.useEffect(() => {
+        if((yBdv0?.top!-yHolw?.bottom!)>0 && (yHolw?.width!)<yBdv0?.width! && (yHolw?.bottom!)>0)
+        {
+            console.log(`撞见该是却也显示了情形：`, yHolw,"虚拟断开",yBdv0, "系数有=", (yBdv0?.top!-yHolw?.bottom!)/yHolw?.width!);
+            //没处理【报错】Too many re-renders. React limits the number of renders to prevent an infinite loop.
+            setVtpage(Math.ceil((yBdv0?.top!-yHolw?.bottom!)/yHolw?.width!) || 0);
+        }
+    }, [yBdv0, yHolw, setVtpage]);
+ return     <div ref={refBdv0} css={{"@media print": {pageBreakBefore:'always'}}}/>
+          { (new Array(vtpage)).fill(null).map((_, i:number) => {
+              console.log(`该是却也显示了情形加虚拟纸张数=`, vtpage,"断页i=",i);
+              return <div key={i} css={{"@media print": {pageBreakBefore:'always'}}}/>;
+          }) }
+foot: [
+'<div style=\\"position: relative; width: 100%; text-align: left; margin:  10px 0px 1.5mm; font-size: 8pt;\\">',
+'<div style=\\"position: absolute; text-align: left; top: 5px;left: 60px;\\"></div>',
+'<div style=\\"position: absolute; width: 100%; text-align: center; top: 5px;\\"></div>',
+'<div style=\\"-NOT_DISPLAY- position: absolute; text-align: right;top: 5px;right: 20px;\\">共 <span>~totalPages~</span> 页 / 第 <span>~pageNumber~</span> 页</div>',
+"</div>",
+],
+不同版本的Chrome可能对CSS样式、字体渲染或布局引擎存在差异，导致生成的PDF不一致。若网页使用的字体在目标电脑上未安装，Chrome可能自动替换为默认字体,网络延迟资源加载失败,所以用Puppeteer替代浏览器原生打印。
+
+失败，Error: 开启窗口尝试2次失败: 【因为】浏览器启动参数要配置特定端口号的。
+
+[功能按钮]
+  打印预览{非检验员也能用}，
+  本地转Pdf{非检验员也能用，未盖章，安装node等},
+后端转Pdf{未盖章，立刻下载，用户需排队}，
+上传Pdf盖章,
+代理转Pdf{异步的，不能提前获得结果，独立服务器},
+下载盖章后Pdf{假如有存储Pdf};

package/src/app.ts

@@ -1,3 +1,4 @@
+import { EventEmitter } from "events";
 import cors from "cors";
 import express from "express";
 import helmet from "helmet";
@@ -5,8 +6,12 @@ import morgan from "morgan";
 import timeout from "connect-timeout";
 import CONFIG from "./configEnv";
 import { expressPinoLogger } from "./helpers";
-import * as errorHandler from "@/middlewares/errorHandler";
-import routes from "@/routes";
+import * as errorHandler from "./middlewares/errorHandler";
+import routes from "./routes";
+
+/**打印不全，太多页数情形：
+ * */
+EventEmitter.defaultMaxListeners = 100;
 
 export const createApp = (): express.Application => {
   const app = express();

package/src/components/home/controller.ts

@@ -1,7 +1,7 @@
 import { OK } from "http-status/lib";
 import { HomeServices } from "./services";
-import { getAppInfoQuery } from "@/types/request/home";
-import { apiResponse } from "@/helpers/apiResponse";
+import { getAppInfoQuery } from "../../types/request/home";
+import { apiResponse } from "../../helpers/apiResponse";
 
 /**
  * 为何为了保证单步模式调试运行"test:watchAll": "cross-env NODE_ENV=development jest --watchAll --runInBand --detectOpenHandles",

package/src/components/home/pdfController.ts

@@ -1,8 +1,12 @@
 import { OK } from "http-status/lib";
-import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/config";
-import { apiResponse } from "@/helpers/apiResponse";
-import { RenderPDF } from "@/utils/pdfgen";
-import CONFIG from "@/configEnv";
+import {
+  ConfigRoot,
+  FileTransform,
+  HeadFooter,
+} from "../../types/request/config";
+import { apiResponse } from "../../helpers/apiResponse";
+import { RenderPDF } from "../../utils/pdfgen";
+import CONFIG from "../../configEnv";
 
 export class PdfController {
   /** node.js对比前端App 太严格了，一点小毛病页不行啊。
@@ -14,7 +18,7 @@ export class PdfController {
    */
   static postMakePdf = async (req: Req, res: Res, next: NextFn) => {
     try {
-      // const appInfoKey1 = req.query.key as getAppInfoQuery;
+      // const appInfoKey1 = req.query.key as getAppInfoQuery; 所有打印都走ConfigRoot配置包=task：可能有多个URL合并输出的。
       const task = req.body as ConfigRoot<FileTransform>;
       task.lay as HeadFooter;
       //预处理汇总输出的pdf页眉页脚, 转换页眉页脚的html存储

package/src/components/home/services.ts

@@ -1,6 +1,6 @@
-import AppInformation from "@/types/response/AppInformation";
-import { HomeDAO } from "@/db/home";
-import { getAppInfoQuery } from "@/types/request/home";
+import AppInformation from "../../types/response/AppInformation";
+import { HomeDAO } from "../../db/home";
+import { getAppInfoQuery } from "../../types/request/home";
 
 export class HomeServices {
   homeDAO!: HomeDAO;

package/src/components/home/splitController.ts

@@ -1,11 +1,15 @@
 import fs from "fs";
 import { OK } from "http-status/lib";
-import { ConfigRoot, FileTransform, HeadFooter } from "@/types/request/config";
-import { apiResponse } from "@/helpers/apiResponse";
+import {
+  ConfigRoot,
+  FileTransform,
+  HeadFooter,
+} from "../../types/request/config";
+import { apiResponse } from "../../helpers/apiResponse";
 
-import { RenderPDF } from "@/utils/pdfgen";
-import CONFIG from "@/configEnv";
-import { SplitConfig, SplitPdfFile } from "@/types/request/split";
+import { RenderPDF } from "../../utils/pdfgen";
+import CONFIG from "../../configEnv";
+import { SplitConfig, SplitPdfFile } from "../../types/request/split";
 // import CONFIG from "@/configEnv";
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const { PDFDocument } = require("pdf-lib");

package/src/components/home/validators.ts

@@ -1,5 +1,5 @@
 import { query } from "express-validator";
-import CONFIG from "@/configEnv";
+import CONFIG from "../../configEnv";
 
 const appKeys = Object.keys(CONFIG.APP).map((key) => key.toLocaleLowerCase());
 

package/src/db/home.ts

@@ -1,6 +1,6 @@
-import AppInformation from "@/types/response/AppInformation";
-import CONFIG from "@/configEnv";
-import { getAppInfoQuery } from "@/types/request/home";
+import AppInformation from "../types/response/AppInformation";
+import CONFIG from "../configEnv";
+import { getAppInfoQuery } from "../types/request/home";
 
 export class HomeDAO {
   get = (key?: getAppInfoQuery): Promise<AppInformation | any> => {

package/src/helpers/apiResponse.ts

@@ -1,5 +1,5 @@
 import HttpStatus, { OK } from "http-status/lib";
-import { ApiSuccessResponse } from "@/types/response";
+import { ApiSuccessResponse } from "../types/response";
 
 export const apiResponse = <T>(data?: T): ApiSuccessResponse<T> => {
   return {

package/src/helpers/error/TimeOutError.ts

@@ -1,5 +1,5 @@
 import httpStatus, { REQUEST_TIMEOUT } from "http-status/lib";
-import CONFIG from "@/configEnv";
+import CONFIG from "../../configEnv";
 
 class TimeOutError {
   readonly status: number;

package/src/helpers/loggers.ts

@@ -1,6 +1,6 @@
 import httpStatus from "http-status/lib";
 import expressPino from "express-pino-logger";
-import { hidePassword } from "@/utils/auth";
+import { hidePassword } from "../utils/auth";
 
 const { OK, BAD_REQUEST, SERVER_ERROR } = httpStatus;
 

package/src/index.ts

@@ -1,6 +1,8 @@
 // ! Don't convert require into import
 // eslint-disable-next-line @typescript-eslint/no-var-requires
-require("module-alias").addAlias("@", __dirname);
+//去掉这个了    离开开发环境无法 独立运行服务端，报错module-alias找不到
+//去掉这个了   require("module-alias").addAlias("@", __dirname);
+//去掉这个了
 
 import { createApp } from "./app";
 import { startServer } from "./server";
@@ -11,3 +13,4 @@ if (process.env.NODE_ENV !== "test") {
 }
 
 //关键文档Chrome DevTools Protocol资料， https://chromedevtools.github.io/devtools-protocol/tot/Page
+export * from "./types/request/config";

package/src/middlewares/errorHandler.ts

@@ -5,7 +5,7 @@ import HttpStatus, {
   INTERNAL_SERVER_ERROR,
   REQUEST_TIMEOUT,
 } from "http-status/lib";
-import { TimeOutError } from "@/helpers/error";
+import { TimeOutError } from "../helpers/error";
 
 /**
  * @description Error response middleware for 404 not found. This middleware function should be at the very bottom of the stack.

package/src/routes/index.ts

@@ -4,8 +4,8 @@ import {
   appKeyValidator,
   PdfController,
   SplitController,
-} from "@/components/home";
-import { sanitizer } from "@/helpers";
+} from "../components/home";
+import { sanitizer } from "../helpers";
 
 const router = Router();
 

package/src/types/request/config.ts

@@ -86,6 +86,9 @@ export interface FileTransform {
   footerTemplate?: string;
   headerTemplateL?: string;
   footerTemplateL?: string;
+  //这针对：可能由于动态布局导致的浏览器打印预览和实际URL纯粹js网页动态布局的真实内容页数不一致的毛病。
+  //开启的浏览器窗口宽度。默认最大化的。
+  brwidth?: number;
   //第一阶段Url转pdf的浏览器执行窗口的targetId,不可配置。
   CDPtab?: string;
 }
@@ -99,7 +102,8 @@ export interface FileTransform {
   For example, <span class=title></span> would generate span containing the title.
 */
 
-/**页眉页脚声明；前提条件是页眉页脚htm描述里面：不应该把-NOT_DISPLAY- ${pageNumber} ${totalPages}这三个保留字字符串当作普通文字输出的。
+/**页眉页脚声明；前提条件是页眉页脚htm描述里面： 上一个版本保留字 ${pageNumber} ${totalPages}
+ * 不应该把 -NOT_DISPLAY-  ~pageNumber~  ~totalPages~  这三个 保留字字符串当作普通文字输出的。
  * 前端发送数据包时刻，页眉页脚的脚本需要在 HTML转JSON 工具网站 进行转换处理后的；网站地址  https://uutool.cn/html2json/ 转换htm模板后是数组[string]
  * 实际上也就进行拆分多行字符串拼接数组，还有把html语法中的 ""引号 进行转义 style="position: 变成 style=\\\"position: 处置的。
  * */
@@ -112,10 +116,11 @@ export interface HeadFooter {
   //双面打印：右手边位置的,或单面打印使用
   foot?: string | string[] | null; //实际前端发过来却是[string]的也可以啊。
   /**可注入3个参数"特殊标记字符串"如下： 服务端依据参数来对注入的html进行修改的。
-   * ${pageNumber}
-   * ${totalPages}
-   * -NOT_DISPLAY-
-   * 这三个分别代表 页码 总页数 以及页码<div style=""></div>中的可替代占位位置。-NOT_DISPLAY-在后端要直接替代成display:none;的CSS标记字符串！其它2个替换成数字号码。
+   * ~pageNumber~
+   * ~totalPages~
+   * -NOT_DISPLAY- 有页码才能显示，无页码就隐藏的标记。
+   * 这三个分别代表 页码 总页数 以及页码<div style=""></div>中的可替代占位位置。
+   * 其它2个替换成数字号码。
    * */
   //双面打印：左手边位置的
   headL?: string | string[] | null;

package/src/types/request/home.ts

@@ -1,3 +1,3 @@
-import CONFIG from "@/configEnv";
+import CONFIG from "../../configEnv";
 
 export type getAppInfoQuery = `${Lowercase<keyof typeof CONFIG.APP>}`;