@whyour/qinglong 2.22.0 → 2.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (553) hide show
  1. package/.env.example +3 -0
  2. package/README-NODE.md +10 -0
  3. package/back/protos/api.proto +10 -0
  4. package/cli/README.en.md +156 -0
  5. package/cli/README.md +156 -0
  6. package/cli/src/internal/maintenance/nodeRuntime.cjs +18 -0
  7. package/cli/src/internal/maintenance/panelUpgrade.cjs +577 -0
  8. package/cli/src/internal/maintenance/platformBundle.cjs +582 -0
  9. package/cli/src/internal/maintenance/upgradeArtifacts.cjs +979 -0
  10. package/cli/src/internal/maintenance/upgradePrestart.cjs +396 -0
  11. package/ecosystem.config.js +3 -0
  12. package/package.json +59 -15
  13. package/sample/notify.js +308 -135
  14. package/sample/notify.py +174 -27
  15. package/shell/api.sh +71 -74
  16. package/shell/install-bundle.cjs +320 -0
  17. package/shell/install-package.cjs +74 -0
  18. package/shell/lang/en.sh +38 -0
  19. package/shell/node-runtime-probe.cjs +62 -0
  20. package/shell/node_path_cache.sh +10 -2
  21. package/shell/otask.sh +41 -41
  22. package/shell/preload/client.js +1 -0
  23. package/shell/preload/notificationAudit.js +51 -0
  24. package/shell/preload/sitecustomize.js +9 -5
  25. package/shell/preload/sitecustomize.py +9 -7
  26. package/shell/rmlog.sh +21 -16
  27. package/shell/share.sh +62 -45
  28. package/shell/start-simplify.sh +90 -0
  29. package/shell/start.sh +48 -71
  30. package/shell/task-timeout.sh +75 -0
  31. package/shell/task.sh +14 -12
  32. package/shell/update.sh +92 -133
  33. package/shell/upgrade-lock.yaml +16122 -0
  34. package/shell/upgrade.cjs +8 -0
  35. package/static/build/api/clientIp.js +2 -1
  36. package/static/build/api/clientIp.js.map +1 -0
  37. package/static/build/api/config.js +2 -6
  38. package/static/build/api/config.js.map +1 -0
  39. package/static/build/api/cron.js.map +1 -0
  40. package/static/build/api/dashboard.js.map +1 -0
  41. package/static/build/api/dependence.js.map +1 -0
  42. package/static/build/api/env.js +15 -14
  43. package/static/build/api/env.js.map +1 -0
  44. package/static/build/api/health.js.map +1 -0
  45. package/static/build/api/index.js.map +1 -0
  46. package/static/build/api/log.js.map +1 -0
  47. package/static/build/api/open.js +2 -1
  48. package/static/build/api/open.js.map +1 -0
  49. package/static/build/api/retention.js.map +1 -0
  50. package/static/build/api/script.js +155 -9
  51. package/static/build/api/script.js.map +1 -0
  52. package/static/build/api/subscription.js +3 -6
  53. package/static/build/api/subscription.js.map +1 -0
  54. package/static/build/api/system.js +53 -3
  55. package/static/build/api/system.js.map +1 -0
  56. package/static/build/api/update.js.map +1 -0
  57. package/static/build/api/user.js.map +1 -0
  58. package/static/build/app.js +10 -23
  59. package/static/build/app.js.map +1 -0
  60. package/static/build/bootstrap/database.js.map +1 -0
  61. package/static/build/bootstrap/upgradeProbe.js +154 -0
  62. package/static/build/bootstrap/upgradeProbe.js.map +1 -0
  63. package/static/build/config/const.js +2 -1
  64. package/static/build/config/const.js.map +1 -0
  65. package/static/build/config/container.js.map +1 -0
  66. package/static/build/config/grpcCerts.js +89 -40
  67. package/static/build/config/grpcCerts.js.map +1 -0
  68. package/static/build/config/http.js.map +1 -0
  69. package/static/build/config/index.js.map +1 -0
  70. package/static/build/config/serverEnv.js.map +1 -0
  71. package/static/build/config/share.js.map +1 -0
  72. package/static/build/config/subscription.js +19 -11
  73. package/static/build/config/subscription.js.map +1 -0
  74. package/static/build/config/util.js +178 -77
  75. package/static/build/config/util.js.map +1 -0
  76. package/static/build/data/cron.js.map +1 -0
  77. package/static/build/data/cronStats.js.map +1 -0
  78. package/static/build/data/cronView.js.map +1 -0
  79. package/static/build/data/dependence.js.map +1 -0
  80. package/static/build/data/env.js.map +1 -0
  81. package/static/build/data/index.js.map +1 -0
  82. package/static/build/data/notify.js.map +1 -0
  83. package/static/build/data/open.js.map +1 -0
  84. package/static/build/data/runningInstance.js.map +1 -0
  85. package/static/build/data/sock.js.map +1 -0
  86. package/static/build/data/subscription.js.map +1 -0
  87. package/static/build/data/system.js +3 -1
  88. package/static/build/data/system.js.map +1 -0
  89. package/static/build/interface/schedule.js.map +1 -0
  90. package/static/build/loaders/app.js.map +1 -0
  91. package/static/build/loaders/bootAfter.js.map +1 -0
  92. package/static/build/loaders/db.js.map +1 -0
  93. package/static/build/loaders/depInjector.js.map +1 -0
  94. package/static/build/loaders/deps.js.map +1 -0
  95. package/static/build/loaders/express.js +10 -3
  96. package/static/build/loaders/express.js.map +1 -0
  97. package/static/build/loaders/httpApplication.js +55 -0
  98. package/static/build/loaders/httpApplication.js.map +1 -0
  99. package/static/build/loaders/initData.js +20 -30
  100. package/static/build/loaders/initData.js.map +1 -0
  101. package/static/build/loaders/initFile.js.map +1 -0
  102. package/static/build/loaders/initTask.js +11 -1
  103. package/static/build/loaders/initTask.js.map +1 -0
  104. package/static/build/loaders/logger.js.map +1 -0
  105. package/static/build/loaders/server.js.map +1 -0
  106. package/static/build/loaders/sock.js.map +1 -0
  107. package/static/build/middlewares/monitoring.js.map +1 -0
  108. package/static/build/middlewares/protectedPathCase.js.map +1 -0
  109. package/static/build/middlewares/uniqueConstraintError.js +15 -0
  110. package/static/build/middlewares/uniqueConstraintError.js.map +1 -0
  111. package/static/build/middlewares/validationErrors.js +17 -0
  112. package/static/build/middlewares/validationErrors.js.map +1 -0
  113. package/static/build/protos/api.js +140 -2
  114. package/static/build/protos/api.js.map +1 -0
  115. package/static/build/protos/cron.js +63 -2
  116. package/static/build/protos/cron.js.map +1 -0
  117. package/static/build/protos/health.js.map +1 -0
  118. package/static/build/schedule/addCron.js +45 -63
  119. package/static/build/schedule/addCron.js.map +1 -0
  120. package/static/build/schedule/api.js +21 -2
  121. package/static/build/schedule/api.js.map +1 -0
  122. package/static/build/schedule/client.js +19 -1
  123. package/static/build/schedule/client.js.map +1 -0
  124. package/static/build/schedule/data.js.map +1 -0
  125. package/static/build/schedule/delCron.js +6 -4
  126. package/static/build/schedule/delCron.js.map +1 -0
  127. package/static/build/schedule/health.js.map +1 -0
  128. package/static/build/schedule/setConcurrency.js +27 -0
  129. package/static/build/schedule/setConcurrency.js.map +1 -0
  130. package/static/build/services/config.js +2 -3
  131. package/static/build/services/config.js.map +1 -0
  132. package/static/build/services/cron.js +43 -17
  133. package/static/build/services/cron.js.map +1 -0
  134. package/static/build/services/cronView.js.map +1 -0
  135. package/static/build/services/dependence.js +48 -13
  136. package/static/build/services/dependence.js.map +1 -0
  137. package/static/build/services/env.js +1 -1
  138. package/static/build/services/env.js.map +1 -0
  139. package/static/build/services/grpc.js +4 -3
  140. package/static/build/services/grpc.js.map +1 -0
  141. package/static/build/services/health.js +2 -0
  142. package/static/build/services/health.js.map +1 -0
  143. package/static/build/services/http.js.map +1 -0
  144. package/static/build/services/log.js +1 -1
  145. package/static/build/services/log.js.map +1 -0
  146. package/static/build/services/metrics.js +2 -1
  147. package/static/build/services/metrics.js.map +1 -0
  148. package/static/build/services/notify.js +45 -24
  149. package/static/build/services/notify.js.map +1 -0
  150. package/static/build/services/open.js +106 -31
  151. package/static/build/services/open.js.map +1 -0
  152. package/static/build/services/retention.js.map +1 -0
  153. package/static/build/services/schedule.js +32 -21
  154. package/static/build/services/schedule.js.map +1 -0
  155. package/static/build/services/script.js +1 -1
  156. package/static/build/services/script.js.map +1 -0
  157. package/static/build/services/scriptHistory.js +30 -0
  158. package/static/build/services/scriptHistory.js.map +1 -0
  159. package/static/build/services/sock.js.map +1 -0
  160. package/static/build/services/sshKey.js +45 -17
  161. package/static/build/services/sshKey.js.map +1 -0
  162. package/static/build/services/subscription.js +104 -53
  163. package/static/build/services/subscription.js.map +1 -0
  164. package/static/build/services/system.js +139 -74
  165. package/static/build/services/system.js.map +1 -0
  166. package/static/build/services/user.js +17 -12
  167. package/static/build/services/user.js.map +1 -0
  168. package/static/build/shared/auth.js.map +1 -0
  169. package/static/build/shared/authMutation.js.map +1 -0
  170. package/static/build/shared/childProcess.js.map +1 -0
  171. package/static/build/shared/clientIp.js.map +1 -0
  172. package/static/build/shared/cronCommand.js +17 -0
  173. package/static/build/shared/cronCommand.js.map +1 -0
  174. package/static/build/shared/cronSchedule.js +157 -0
  175. package/static/build/shared/cronSchedule.js.map +1 -0
  176. package/static/build/shared/cronScheduler.js +74 -0
  177. package/static/build/shared/cronScheduler.js.map +1 -0
  178. package/static/build/shared/errors.js.map +1 -0
  179. package/static/build/shared/fileAccess.js.map +1 -0
  180. package/static/build/shared/i18n.js +167 -87
  181. package/static/build/shared/i18n.js.map +1 -0
  182. package/static/build/shared/interface.js.map +1 -0
  183. package/static/build/shared/languageSync.js +61 -0
  184. package/static/build/shared/languageSync.js.map +1 -0
  185. package/static/build/shared/linuxMirror.js +96 -0
  186. package/static/build/shared/linuxMirror.js.map +1 -0
  187. package/static/build/shared/logPath.js +15 -0
  188. package/static/build/shared/logPath.js.map +1 -0
  189. package/static/build/shared/logReader.js.map +1 -0
  190. package/static/build/shared/logStreamManager.js.map +1 -0
  191. package/static/build/shared/loginThrottle.js +45 -0
  192. package/static/build/shared/loginThrottle.js.map +1 -0
  193. package/static/build/shared/notificationAudit.js +46 -0
  194. package/static/build/shared/notificationAudit.js.map +1 -0
  195. package/static/build/shared/pLimit.js +27 -14
  196. package/static/build/shared/pLimit.js.map +1 -0
  197. package/static/build/shared/password.js.map +1 -0
  198. package/static/build/shared/retention.js.map +1 -0
  199. package/static/build/shared/runCron.js +81 -29
  200. package/static/build/shared/runCron.js.map +1 -0
  201. package/static/build/shared/runtimeBuild.js +44 -0
  202. package/static/build/shared/runtimeBuild.js.map +1 -0
  203. package/static/build/shared/schedulerMutationLock.js.map +1 -0
  204. package/static/build/shared/schedulerReadiness.js.map +1 -0
  205. package/static/build/shared/schemaMigrations.js.map +1 -0
  206. package/static/build/shared/scriptHistory.js +445 -0
  207. package/static/build/shared/scriptHistory.js.map +1 -0
  208. package/static/build/shared/shellQuote.js +11 -0
  209. package/static/build/shared/shellQuote.js.map +1 -0
  210. package/static/build/shared/startupProcess.js.map +1 -0
  211. package/static/build/shared/store.js.map +1 -0
  212. package/static/build/shared/subscriptionMutationLock.js +34 -0
  213. package/static/build/shared/subscriptionMutationLock.js.map +1 -0
  214. package/static/build/shared/subscriptionPath.js +41 -0
  215. package/static/build/shared/subscriptionPath.js.map +1 -0
  216. package/static/build/shared/subscriptionStorage.js +98 -0
  217. package/static/build/shared/subscriptionStorage.js.map +1 -0
  218. package/static/build/shared/trustProxy.js +5 -4
  219. package/static/build/shared/trustProxy.js.map +1 -0
  220. package/static/build/shared/utils.js +2 -1
  221. package/static/build/shared/utils.js.map +1 -0
  222. package/static/build/token.js +3 -14
  223. package/static/build/token.js.map +1 -0
  224. package/static/build/validation/schedule.js +22 -19
  225. package/static/build/validation/schedule.js.map +1 -0
  226. package/static/build-info.json +754 -0
  227. package/static/dist/1089.0ecc5383.async.js.gz +0 -0
  228. package/static/dist/1174.41a43fee.async.js.gz +0 -0
  229. package/static/dist/119.89e2d610.async.js.gz +0 -0
  230. package/static/dist/1212.f87fd07a.async.js.gz +0 -0
  231. package/static/dist/1352.96a77e1d.async.js.gz +0 -0
  232. package/static/dist/1379.f91563a1.async.js.gz +0 -0
  233. package/static/dist/1571.94ddca13.async.js.gz +0 -0
  234. package/static/dist/1706.ac98cb3f.async.js.gz +0 -0
  235. package/static/dist/1765.5ac01a93.async.js.gz +0 -0
  236. package/static/dist/1836.f0b74cf1.async.js.gz +0 -0
  237. package/static/dist/1883.675b6a18.chunk.css.gz +0 -0
  238. package/static/dist/1885.b8f427bf.async.js.gz +0 -0
  239. package/static/dist/1887.9e0d3da8.async.js.gz +0 -0
  240. package/static/dist/1967.3f3945d0.async.js.gz +0 -0
  241. package/static/dist/198.db47fc1a.async.js.gz +0 -0
  242. package/static/dist/2325.dfa32834.async.js.gz +0 -0
  243. package/static/dist/2338.d678967d.async.js.gz +0 -0
  244. package/static/dist/2372.b5a50ee7.async.js +1 -0
  245. package/static/dist/2372.b5a50ee7.async.js.gz +0 -0
  246. package/static/dist/2476.4e9b0992.async.js.gz +0 -0
  247. package/static/dist/2537.2b262ee0.async.js.gz +0 -0
  248. package/static/dist/2577.aa8fe709.async.js.gz +0 -0
  249. package/static/dist/2635.d4c59d23.async.js.gz +0 -0
  250. package/static/dist/2664.e69530fb.async.js +1 -0
  251. package/static/dist/2664.e69530fb.async.js.gz +0 -0
  252. package/static/dist/2693.51c2636b.async.js.gz +0 -0
  253. package/static/dist/2808.cdc0995c.async.js.gz +0 -0
  254. package/static/dist/2821.651f31e5.async.js.gz +0 -0
  255. package/static/dist/2890.add55e85.async.js.gz +0 -0
  256. package/static/dist/2901.6d0de54e.async.js +1 -0
  257. package/static/dist/2901.6d0de54e.async.js.gz +0 -0
  258. package/static/dist/292.1b962b29.chunk.css.gz +0 -0
  259. package/static/dist/292.27ce781f.async.js +1 -0
  260. package/static/dist/292.27ce781f.async.js.gz +0 -0
  261. package/static/dist/300.08ac9875.async.js.gz +0 -0
  262. package/static/dist/3191.3b7e4b42.async.js +1 -0
  263. package/static/dist/3191.3b7e4b42.async.js.gz +0 -0
  264. package/static/dist/3382.a584a111.async.js.gz +0 -0
  265. package/static/dist/3383.041eee73.async.js.gz +0 -0
  266. package/static/dist/3512.95e41255.async.js +1 -0
  267. package/static/dist/3512.95e41255.async.js.gz +0 -0
  268. package/static/dist/3714.8d6dba9e.async.js.gz +0 -0
  269. package/static/dist/3906.a5eee612.async.js.gz +0 -0
  270. package/static/dist/3948.4fe809fd.async.js.gz +0 -0
  271. package/static/dist/4324.5a5887d1.async.js.gz +0 -0
  272. package/static/dist/4559.faab3673.async.js.gz +0 -0
  273. package/static/dist/4573.16f19278.async.js.gz +0 -0
  274. package/static/dist/{4736.1d2b5cb6.async.js → 4736.7c4c489b.async.js} +1 -1
  275. package/static/dist/4736.7c4c489b.async.js.gz +0 -0
  276. package/static/dist/4887.8e3ae573.async.js.gz +0 -0
  277. package/static/dist/4934.f3539d08.async.js.gz +0 -0
  278. package/static/dist/5077.cbd111cd.async.js.gz +0 -0
  279. package/static/dist/{5481.624d0e07.async.js → 5481.e2945a63.async.js} +1 -1
  280. package/static/dist/5481.e2945a63.async.js.gz +0 -0
  281. package/static/dist/5662.678b0cfb.async.js.gz +0 -0
  282. package/static/dist/5970.5862e59e.async.js +1 -0
  283. package/static/dist/5970.5862e59e.async.js.gz +0 -0
  284. package/static/dist/6013.db535339.async.js.gz +0 -0
  285. package/static/dist/6035.32ebfad9.async.js.gz +0 -0
  286. package/static/dist/6212.30a9c190.async.js +1 -0
  287. package/static/dist/6212.30a9c190.async.js.gz +0 -0
  288. package/static/dist/6341.673fb65c.async.js.gz +0 -0
  289. package/static/dist/6367.8b0e838c.async.js.gz +0 -0
  290. package/static/dist/6431.c50479be.async.js +1 -0
  291. package/static/dist/6569.55177f6a.async.js.gz +0 -0
  292. package/static/dist/6610.c111af7e.async.js.gz +0 -0
  293. package/static/dist/6638.87a163d2.async.js.gz +0 -0
  294. package/static/dist/6646.95e92533.async.js.gz +0 -0
  295. package/static/dist/{6872.a503ef55.async.js → 6872.fcc9ce17.async.js} +1 -1
  296. package/static/dist/6872.fcc9ce17.async.js.gz +0 -0
  297. package/static/dist/691.187a388c.async.js.gz +0 -0
  298. package/static/dist/7146.4dc150b1.async.js +1 -0
  299. package/static/dist/7146.4dc150b1.async.js.gz +0 -0
  300. package/static/dist/7231.f7e5b668.async.js.gz +0 -0
  301. package/static/dist/7253.4b9bf133.async.js.gz +0 -0
  302. package/static/dist/7278.96bf439f.async.js.gz +0 -0
  303. package/static/dist/7355.fca746f5.async.js.gz +0 -0
  304. package/static/dist/7384.1bb449d5.async.js.gz +0 -0
  305. package/static/dist/7508.3fffed15.chunk.css.gz +0 -0
  306. package/static/dist/7508.d90eac63.async.js.gz +0 -0
  307. package/static/dist/7802.34255805.async.js.gz +0 -0
  308. package/static/dist/7984.eaac7402.async.js.gz +0 -0
  309. package/static/dist/8033.5cb31493.async.js.gz +0 -0
  310. package/static/dist/8078.8586c875.async.js.gz +0 -0
  311. package/static/dist/8147.2fb55202.async.js.gz +0 -0
  312. package/static/dist/8187.48c130d6.async.js.gz +0 -0
  313. package/static/dist/8495.d53e15ca.async.js.gz +0 -0
  314. package/static/dist/8844.a0fef08e.async.js.gz +0 -0
  315. package/static/dist/9308.3202ac13.async.js.gz +0 -0
  316. package/static/dist/9323.a33f47da.async.js.gz +0 -0
  317. package/static/dist/965.8d9b1fbd.async.js +1 -0
  318. package/static/dist/965.8d9b1fbd.async.js.gz +0 -0
  319. package/static/dist/9761.360a19d8.async.js.gz +0 -0
  320. package/static/dist/index.html +2 -2
  321. package/static/dist/layouts__index.86b6bcbe.chunk.css +1 -0
  322. package/static/dist/layouts__index.86b6bcbe.chunk.css.gz +0 -0
  323. package/static/dist/layouts__index.c8e9788e.async.js +1 -0
  324. package/static/dist/layouts__index.c8e9788e.async.js.gz +0 -0
  325. package/static/dist/monaco-editor/min/vs/base/worker/workerMain.js.gz +0 -0
  326. package/static/dist/monaco-editor/min/vs/basic-languages/abap/abap.js.gz +0 -0
  327. package/static/dist/monaco-editor/min/vs/basic-languages/clojure/clojure.js.gz +0 -0
  328. package/static/dist/monaco-editor/min/vs/basic-languages/elixir/elixir.js.gz +0 -0
  329. package/static/dist/monaco-editor/min/vs/basic-languages/freemarker2/freemarker2.js.gz +0 -0
  330. package/static/dist/monaco-editor/min/vs/basic-languages/mysql/mysql.js.gz +0 -0
  331. package/static/dist/monaco-editor/min/vs/basic-languages/pgsql/pgsql.js.gz +0 -0
  332. package/static/dist/monaco-editor/min/vs/basic-languages/powerquery/powerquery.js.gz +0 -0
  333. package/static/dist/monaco-editor/min/vs/basic-languages/redshift/redshift.js.gz +0 -0
  334. package/static/dist/monaco-editor/min/vs/basic-languages/solidity/solidity.js.gz +0 -0
  335. package/static/dist/monaco-editor/min/vs/basic-languages/sql/sql.js.gz +0 -0
  336. package/static/dist/monaco-editor/min/vs/editor/editor.main.css.gz +0 -0
  337. package/static/dist/monaco-editor/min/vs/editor/editor.main.js.gz +0 -0
  338. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.de.js.gz +0 -0
  339. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.es.js.gz +0 -0
  340. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.fr.js.gz +0 -0
  341. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.it.js.gz +0 -0
  342. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.ja.js.gz +0 -0
  343. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.js.gz +0 -0
  344. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.ko.js.gz +0 -0
  345. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.ru.js.gz +0 -0
  346. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.zh-cn.js.gz +0 -0
  347. package/static/dist/monaco-editor/min/vs/editor/editor.main.nls.zh-tw.js.gz +0 -0
  348. package/static/dist/monaco-editor/min/vs/language/css/cssMode.js.gz +0 -0
  349. package/static/dist/monaco-editor/min/vs/language/css/cssWorker.js.gz +0 -0
  350. package/static/dist/monaco-editor/min/vs/language/html/htmlMode.js.gz +0 -0
  351. package/static/dist/monaco-editor/min/vs/language/html/htmlWorker.js.gz +0 -0
  352. package/static/dist/monaco-editor/min/vs/language/json/jsonMode.js.gz +0 -0
  353. package/static/dist/monaco-editor/min/vs/language/json/jsonWorker.js.gz +0 -0
  354. package/static/dist/monaco-editor/min/vs/language/typescript/tsMode.js.gz +0 -0
  355. package/static/dist/monaco-editor/min/vs/language/typescript/tsWorker.js.gz +0 -0
  356. package/static/dist/monaco-editor/min/vs/loader.js.gz +0 -0
  357. package/static/dist/preload_helper.8b8f6581.js +1 -0
  358. package/static/dist/src__pages__404.3fd8332e.async.js +1 -0
  359. package/static/dist/src__pages__config__index.d18d8f95.async.js +1 -0
  360. package/static/dist/src__pages__crontab__detail.88729e8f.async.js +1 -0
  361. package/static/dist/src__pages__crontab__detail.88729e8f.async.js.gz +0 -0
  362. package/static/dist/src__pages__crontab__index.8aa9d297.async.js +1 -0
  363. package/static/dist/src__pages__crontab__index.8aa9d297.async.js.gz +0 -0
  364. package/static/dist/src__pages__crontab__logModal.930535e2.async.js.gz +0 -0
  365. package/static/dist/src__pages__crontab__modal.a2c8fdcc.async.js.gz +0 -0
  366. package/static/dist/src__pages__crontab__viewCreateModal.7b4f9cbe.async.js.gz +0 -0
  367. package/static/dist/src__pages__crontab__viewManageModal.cd454ea0.async.js.gz +0 -0
  368. package/static/dist/src__pages__dashboard__index.c05ce904.async.js +1 -0
  369. package/static/dist/src__pages__dashboard__index.c05ce904.async.js.gz +0 -0
  370. package/static/dist/src__pages__dependence__index.5b7fd97d.async.js +1 -0
  371. package/static/dist/src__pages__dependence__index.5b7fd97d.async.js.gz +0 -0
  372. package/static/dist/{src__pages__dependence__logModal.154efe7a.async.js → src__pages__dependence__logModal.01729f63.async.js} +1 -1
  373. package/static/dist/src__pages__dependence__logModal.01729f63.async.js.gz +0 -0
  374. package/static/dist/src__pages__dependence__modal.ef7ae53b.async.js +1 -0
  375. package/static/dist/src__pages__dependence__modal.ef7ae53b.async.js.gz +0 -0
  376. package/static/dist/src__pages__diff__index.4233ea93.async.js +1 -0
  377. package/static/dist/src__pages__diff__index.4233ea93.async.js.gz +0 -0
  378. package/static/dist/src__pages__env__index.eddb35bf.async.js +1 -0
  379. package/static/dist/src__pages__env__index.eddb35bf.async.js.gz +0 -0
  380. package/static/dist/src__pages__env__modal.4d71adb3.async.js.gz +0 -0
  381. package/static/dist/src__pages__error__index.66605c72.async.js +1 -0
  382. package/static/dist/src__pages__initialization__index.9c1c5b76.async.js +1 -0
  383. package/static/dist/src__pages__initialization__index.9c1c5b76.async.js.gz +0 -0
  384. package/static/dist/src__pages__log__index.71250e0d.async.js.gz +0 -0
  385. package/static/dist/src__pages__login__index.58bb4b38.async.js +1 -0
  386. package/static/dist/src__pages__login__index.58bb4b38.async.js.gz +0 -0
  387. package/static/dist/src__pages__script__components__UnsupportedFilePreview__index.c347a13a.async.js.gz +0 -0
  388. package/static/dist/src__pages__script__editModal.d15f8d78.async.js +1 -0
  389. package/static/dist/src__pages__script__editModal.d15f8d78.async.js.gz +0 -0
  390. package/static/dist/src__pages__script__editNameModal.789ad87b.async.js +1 -0
  391. package/static/dist/src__pages__script__editNameModal.789ad87b.async.js.gz +0 -0
  392. package/static/dist/src__pages__script__historyDrawer.8c58d958.async.js +1 -0
  393. package/static/dist/src__pages__script__historyDrawer.8c58d958.async.js.gz +0 -0
  394. package/static/dist/src__pages__script__historyDrawer.a449193a.chunk.css +1 -0
  395. package/static/dist/src__pages__script__index.96a6d30f.async.js +1 -0
  396. package/static/dist/src__pages__script__index.96a6d30f.async.js.gz +0 -0
  397. package/static/dist/src__pages__script__index.ab360776.chunk.css +1 -0
  398. package/static/dist/src__pages__script__saveModal.8fca1a22.async.js +1 -0
  399. package/static/dist/src__pages__script__saveWithHistory.99ece830.async.js +1 -0
  400. package/static/dist/{src__pages__setting__about.e6db5090.chunk.css → src__pages__setting__about.0d6ea255.chunk.css} +1 -1
  401. package/static/dist/src__pages__setting__about.3d3c019f.async.js.gz +0 -0
  402. package/static/dist/src__pages__setting__checkUpdate.429a42f3.async.js +1 -0
  403. package/static/dist/src__pages__setting__checkUpdate.429a42f3.async.js.gz +0 -0
  404. package/static/dist/src__pages__setting__clientIp.3a8711ed.async.js.gz +0 -0
  405. package/static/dist/{src__pages__setting__dependence.28ecea01.chunk.css → src__pages__setting__dependence.80b183a5.chunk.css} +1 -1
  406. package/static/dist/src__pages__setting__dependence.c227c0f5.async.js +1 -0
  407. package/static/dist/src__pages__setting__dependence.c227c0f5.async.js.gz +0 -0
  408. package/static/dist/src__pages__setting__index.274ad415.async.js +1 -0
  409. package/static/dist/src__pages__setting__index.274ad415.async.js.gz +0 -0
  410. package/static/dist/{src__pages__setting__index.7cf46d4a.chunk.css → src__pages__setting__index.46315660.chunk.css} +1 -1
  411. package/static/dist/src__pages__setting__loginLog.ef135f19.async.js +1 -0
  412. package/static/dist/src__pages__setting__loginLog.ef135f19.async.js.gz +0 -0
  413. package/static/dist/src__pages__setting__notifyLog.5ef5b578.async.js +1 -0
  414. package/static/dist/src__pages__setting__notifyLog.5ef5b578.async.js.gz +0 -0
  415. package/static/dist/{src__pages__setting__other.28ecea01.chunk.css → src__pages__setting__notifyLog.80b183a5.chunk.css} +1 -1
  416. package/static/dist/src__pages__setting__other.80b183a5.chunk.css +1 -0
  417. package/static/dist/src__pages__setting__other.e744c0d1.async.js +1 -0
  418. package/static/dist/src__pages__setting__other.e744c0d1.async.js.gz +0 -0
  419. package/static/dist/src__pages__setting__security.e2d71ebb.async.js.gz +0 -0
  420. package/static/dist/src__pages__setting__systemLog.000bcb5e.async.js +1 -0
  421. package/static/dist/src__pages__setting__systemLog.000bcb5e.async.js.gz +0 -0
  422. package/static/dist/src__pages__subscription__index.f556ae4c.async.js +1 -0
  423. package/static/dist/src__pages__subscription__index.f556ae4c.async.js.gz +0 -0
  424. package/static/dist/src__pages__subscription__logModal.cdba5139.async.js.gz +0 -0
  425. package/static/dist/src__pages__subscription__modal.8f04f506.async.js +1 -0
  426. package/static/dist/umi.73936e34.js +1 -0
  427. package/static/dist/umi.73936e34.js.gz +0 -0
  428. package/static/dist/umi.a4d14b92.css.gz +0 -0
  429. package/version.yaml +11 -19
  430. package/.dockerignore +0 -13
  431. package/AGENTS.md +0 -43
  432. package/SECURITY.md +0 -5
  433. package/back/protos/cron.proto +0 -29
  434. package/back/protos/health.proto +0 -22
  435. package/deploy/kubernetes/README.md +0 -81
  436. package/deploy/kubernetes/base/kustomization.yaml +0 -5
  437. package/deploy/kubernetes/base/qinglong.yaml +0 -95
  438. package/deploy/kubernetes/overlays/example/kustomization.yaml +0 -10
  439. package/docker/Dockerfile +0 -113
  440. package/docker/Dockerfile.310 +0 -113
  441. package/docker/Dockerfile.debian +0 -128
  442. package/docker/Dockerfile.debian310 +0 -130
  443. package/docker/build-manifest.cjs +0 -28
  444. package/docker/docker-compose.yml +0 -10
  445. package/docker/docker-entrypoint.sh +0 -147
  446. package/docker/verify-build.cjs +0 -49
  447. package/docs/PROJECT_ARCHITECTURE.md +0 -550
  448. package/docs/releases/2.22.0-validation.md +0 -49
  449. package/docs/releases/2.22.0.md +0 -54
  450. package/sample/tool.ts +0 -40
  451. package/scripts/benchmark-execution.cjs +0 -96
  452. package/scripts/write-build-info.cjs +0 -27
  453. package/shell/pub.sh +0 -28
  454. package/static/dist/2096.6d98fd12.async.js +0 -1
  455. package/static/dist/255.8a80b983.async.js +0 -1
  456. package/static/dist/2901.2ca95295.async.js +0 -1
  457. package/static/dist/3600.7637c822.async.js +0 -1
  458. package/static/dist/445.a65ff63b.async.js +0 -1
  459. package/static/dist/4859.97d6653c.async.js +0 -1
  460. package/static/dist/5970.d3a6e7bd.async.js +0 -1
  461. package/static/dist/6212.9e6d9913.async.js +0 -1
  462. package/static/dist/6431.4603ad0e.async.js +0 -1
  463. package/static/dist/6707.801b886b.async.js +0 -1
  464. package/static/dist/9066.605168f8.async.js +0 -1
  465. package/static/dist/9313.37acaf13.async.js +0 -1
  466. package/static/dist/layouts__index.633d3553.async.js +0 -1
  467. package/static/dist/layouts__index.adf0692f.chunk.css +0 -1
  468. package/static/dist/preload_helper.cf7de3fa.js +0 -1
  469. package/static/dist/src__pages__404.771168fc.async.js +0 -1
  470. package/static/dist/src__pages__config__index.9aba4054.async.js +0 -1
  471. package/static/dist/src__pages__crontab__detail.86b2eebb.async.js +0 -1
  472. package/static/dist/src__pages__crontab__index.ae4e06f2.async.js +0 -1
  473. package/static/dist/src__pages__dashboard__index.243c5a35.async.js +0 -1
  474. package/static/dist/src__pages__dependence__index.874d501f.async.js +0 -1
  475. package/static/dist/src__pages__dependence__modal.a29c1a0f.async.js +0 -1
  476. package/static/dist/src__pages__diff__index.1714b941.async.js +0 -1
  477. package/static/dist/src__pages__env__index.fd6fd2b0.async.js +0 -1
  478. package/static/dist/src__pages__error__index.aae50c94.async.js +0 -1
  479. package/static/dist/src__pages__initialization__index.82a2e967.async.js +0 -1
  480. package/static/dist/src__pages__login__index.a0fd5ed8.async.js +0 -1
  481. package/static/dist/src__pages__script__editModal.22acdf7c.async.js +0 -1
  482. package/static/dist/src__pages__script__editNameModal.1a521cc0.async.js +0 -1
  483. package/static/dist/src__pages__script__index.60b6f827.chunk.css +0 -1
  484. package/static/dist/src__pages__script__index.a18b2692.async.js +0 -1
  485. package/static/dist/src__pages__script__saveModal.8965b74c.async.js +0 -1
  486. package/static/dist/src__pages__setting__checkUpdate.d175b154.async.js +0 -1
  487. package/static/dist/src__pages__setting__dependence.9c0f749b.async.js +0 -1
  488. package/static/dist/src__pages__setting__index.cb397741.async.js +0 -1
  489. package/static/dist/src__pages__setting__loginLog.e0a1f54d.async.js +0 -1
  490. package/static/dist/src__pages__setting__other.3d0b8492.async.js +0 -1
  491. package/static/dist/src__pages__setting__systemLog.b3046955.async.js +0 -1
  492. package/static/dist/src__pages__subscription__index.43086a06.async.js +0 -1
  493. package/static/dist/src__pages__subscription__modal.38991e1e.async.js +0 -1
  494. package/static/dist/umi.fc019050.js +0 -1
  495. package/test/back/auth-security.test.cjs +0 -74
  496. package/test/back/build-provenance.test.cjs +0 -150
  497. package/test/back/cron-log-name.test.cjs +0 -110
  498. package/test/back/cron-validation.test.cjs +0 -45
  499. package/test/back/dashboard-failures.test.cjs +0 -173
  500. package/test/back/database-bootstrap.test.cjs +0 -193
  501. package/test/back/dependence-cache-status.test.cjs +0 -125
  502. package/test/back/deprecated-file-routes.test.cjs +0 -82
  503. package/test/back/ecosystem.test.cjs +0 -28
  504. package/test/back/env-name-parsing.test.cjs +0 -96
  505. package/test/back/execution-lifecycle.test.cjs +0 -236
  506. package/test/back/file-access-security.test.cjs +0 -47
  507. package/test/back/fileTreeListing.test.cjs +0 -57
  508. package/test/back/grpc-cron-response.test.cjs +0 -60
  509. package/test/back/http-exclusive-listen.test.cjs +0 -31
  510. package/test/back/http-security.test.cjs +0 -213
  511. package/test/back/listen-security.test.cjs +0 -67
  512. package/test/back/log-path-security.test.cjs +0 -158
  513. package/test/back/logReader.test.cjs +0 -72
  514. package/test/back/manual-execution.test.cjs +0 -85
  515. package/test/back/manual-stop-claim.test.cjs +0 -220
  516. package/test/back/metrics.test.cjs +0 -34
  517. package/test/back/monitoring.test.cjs +0 -73
  518. package/test/back/node-path-cache.test.cjs +0 -173
  519. package/test/back/node-path-lock.test.cjs +0 -178
  520. package/test/back/npm-publication.test.cjs +0 -70
  521. package/test/back/primary-apm.test.cjs +0 -24
  522. package/test/back/process-exit-state.test.cjs +0 -81
  523. package/test/back/process-stop-signal.test.cjs +0 -77
  524. package/test/back/protected-path-case.test.cjs +0 -58
  525. package/test/back/qlServiceLogCommand.test.cjs +0 -128
  526. package/test/back/retention.test.cjs +0 -131
  527. package/test/back/role-loading.test.cjs +0 -118
  528. package/test/back/schedule-health.test.cjs +0 -86
  529. package/test/back/scheduler-file-lock.test.cjs +0 -51
  530. package/test/back/scheduler-mutation.test.cjs +0 -312
  531. package/test/back/scheduler-readiness.test.cjs +0 -85
  532. package/test/back/scheduler-reconciliation.test.cjs +0 -152
  533. package/test/back/scheduler-rpc-timeout.test.cjs +0 -49
  534. package/test/back/schema-migrations.test.cjs +0 -127
  535. package/test/back/shell-api-parsing.test.cjs +0 -184
  536. package/test/back/sock-polling.test.cjs +0 -297
  537. package/test/back/sock-security.test.cjs +0 -72
  538. package/test/back/start-env-preservation.test.cjs +0 -53
  539. package/test/back/stop-failure-feedback.test.cjs +0 -158
  540. package/test/back/stop-race.test.cjs +0 -167
  541. package/test/back/subscription-cleanup.test.cjs +0 -53
  542. package/test/back/subscription-stop-state.test.cjs +0 -66
  543. package/test/back/system-dependence-cache.test.cjs +0 -126
  544. package/test/back/task-time.test.cjs +0 -116
  545. package/test/back/user-api.test.cjs +0 -99
  546. package/test/back/user-security.test.cjs +0 -248
  547. package/test/back/worker-apm.test.cjs +0 -84
  548. package/test/back/wpush-grpc.test.cjs +0 -115
  549. package/test/front/cron-log-pagination.test.cjs +0 -214
  550. package/test/front/http-auth.test.cjs +0 -152
  551. package/test/front/http-error.test.cjs +0 -29
  552. package/test/helpers/load-security-module.cjs +0 -42
  553. /package/static/dist/{4859.1b962b29.chunk.css → 292.1b962b29.chunk.css} +0 -0
@@ -1,550 +0,0 @@
1
- # Project Architecture Guide
2
-
3
- This document is written for AI coding agents and maintainers who need to understand and modify this project safely. It focuses on where behavior lives, how the application starts, and which files are usually involved for common changes.
4
-
5
- ## Project Summary
6
-
7
- Qinglong is a timed task management platform. It provides a web admin panel for managing cron jobs, scripts, environment variables, subscriptions, dependencies, logs, configuration files, and system settings.
8
-
9
- The repository is organized as a full-stack TypeScript application:
10
-
11
- - `src/`: frontend admin panel, built with Umi Max, React, Ant Design, and Ant Design Pro Layout.
12
- - `back/`: backend application, built with Express, TypeScript, typedi, Sequelize, SQLite, gRPC, and worker processes.
13
- - `shell/`: runtime shell scripts used to execute tasks and preload task environments.
14
- - `data/`: local runtime data, including scripts, logs, configs, SQLite database, uploaded files, and cloned repositories.
15
- - `static/`: built frontend and backend artifacts.
16
- - `docker/`: Docker images, compose file, and entrypoint.
17
- - `sample/`: sample scripts and default config templates.
18
-
19
- ## High-Level Runtime Flow
20
-
21
- ```text
22
- Browser
23
- -> src/pages/*
24
- -> src/utils/http.tsx
25
- -> /api/*
26
- -> back/api/*
27
- -> back/services/*
28
- -> back/data/* Sequelize models
29
- -> data/db/database.sqlite
30
-
31
- Cron/task execution
32
- -> back/services/cron.ts
33
- -> shell/task.sh or shell/otask.sh
34
- -> data/scripts/*
35
- -> data/log/*
36
-
37
- Frontend assets in production
38
- -> static/dist/*
39
- -> served by back/loaders/express.ts
40
- ```
41
-
42
- ## Main Startup Path
43
-
44
- Development starts from `package.json`:
45
-
46
- ```bash
47
- pnpm start
48
- ```
49
-
50
- This runs:
51
-
52
- - `start:back`: `nodemon ./back/app.ts`
53
- - `start:front`: `max dev`
54
-
55
- Backend startup begins in `back/app.ts`.
56
-
57
- Important details:
58
-
59
- - The backend uses Node `cluster`.
60
- - The primary process initializes the database first.
61
- - A gRPC worker starts before the HTTP worker.
62
- - The HTTP worker starts Express and serves API routes plus frontend static files.
63
- - If the gRPC worker restarts, the HTTP worker is asked to re-register cron jobs.
64
-
65
- Production-style backend output is generated by:
66
-
67
- ```bash
68
- pnpm run build:back
69
- ```
70
-
71
- The compiled backend is placed under `static/build`.
72
-
73
- Frontend output is generated by:
74
-
75
- ```bash
76
- pnpm run build:front
77
- ```
78
-
79
- The compiled frontend is placed under `static/dist`.
80
-
81
- ## Backend Architecture
82
-
83
- ### Entry Point
84
-
85
- - `back/app.ts`
86
-
87
- Responsibilities:
88
-
89
- - Creates the Express application.
90
- - Starts primary/worker process logic.
91
- - Initializes database in the primary process.
92
- - Starts gRPC and HTTP workers.
93
- - Handles graceful shutdown.
94
- - Re-registers cron jobs after gRPC worker recovery.
95
-
96
- ### Loaders
97
-
98
- - `back/loaders/app.ts`
99
- - `back/loaders/express.ts`
100
- - `back/loaders/db.ts`
101
- - `back/loaders/depInjector.ts`
102
- - `back/loaders/initData.ts`
103
- - `back/loaders/initFile.ts`
104
- - `back/loaders/initTask.ts`
105
- - `back/loaders/server.ts`
106
- - `back/loaders/sock.ts`
107
-
108
- Loader responsibilities:
109
-
110
- - Register dependency injection bindings.
111
- - Sync Sequelize models.
112
- - Initialize files and default data.
113
- - Initialize scheduled tasks.
114
- - Configure Express middleware.
115
- - Register routes.
116
- - Attach socket/server behavior.
117
-
118
- `back/loaders/express.ts` is the main HTTP middleware and routing setup. It handles:
119
-
120
- - CORS.
121
- - Helmet.
122
- - body parser.
123
- - static frontend serving.
124
- - JWT validation.
125
- - token validation against shared auth state.
126
- - `/open/*` rewrite to `/api/*`.
127
- - route mounting through `back/api/index.ts`.
128
- - frontend fallback to `static/dist/index.html`.
129
- - API error handling.
130
-
131
- ### API Routes
132
-
133
- - `back/api/index.ts`
134
-
135
- This file registers all API modules:
136
-
137
- - `user.ts`: login, initialization, authentication-related user endpoints.
138
- - `env.ts`: environment variable endpoints.
139
- - `config.ts`: config file endpoints.
140
- - `log.ts`: log endpoints.
141
- - `cron.ts`: cron/task endpoints.
142
- - `script.ts`: script file endpoints.
143
- - `open.ts`: open API/app token endpoints.
144
- - `dependence.ts`: dependency management endpoints.
145
- - `system.ts`: system information/settings endpoints.
146
- - `subscription.ts`: subscription endpoints.
147
- - `update.ts`: update/check endpoints.
148
- - `health.ts`: health check endpoints.
149
-
150
- Route files should stay thin. They should validate input, get a service from `typedi`'s `Container`, call the service, and return `{ code, data, message }` style responses.
151
-
152
- ### Services
153
-
154
- - `back/services/*`
155
-
156
- Services contain most business logic. Common examples:
157
-
158
- - `cron.ts`: create/update/delete/run cron jobs, generate crontab data, manage logs, call scheduler client.
159
- - `env.ts`: manage environment variables.
160
- - `config.ts`: read/write config files.
161
- - `script.ts`: manage script files.
162
- - `subscription.ts`: manage script subscriptions and repository pulls.
163
- - `dependence.ts`: install/manage runtime dependencies.
164
- - `system.ts`: system info and settings.
165
- - `notify.ts`: notification behavior.
166
- - `sock.ts`: socket/log stream behavior.
167
- - `grpc.ts`: gRPC server lifecycle.
168
- - `http.ts`: HTTP server lifecycle.
169
-
170
- When changing backend behavior, first find the API route, then follow it into the matching service. In most cases, the service is the right place for behavioral changes.
171
-
172
- ### Data Models
173
-
174
- - `back/data/index.ts`
175
- - `back/data/*.ts`
176
-
177
- The backend uses Sequelize with SQLite. Database storage is configured in `back/data/index.ts`:
178
-
179
- ```text
180
- data/db/database.sqlite
181
- ```
182
-
183
- Common model files:
184
-
185
- - `cron.ts`: cron job model.
186
- - `cronView.ts`: saved cron table views.
187
- - `env.ts`: environment variable model.
188
- - `dependence.ts`: dependency model.
189
- - `open.ts`: open API app/token model.
190
- - `subscription.ts`: subscription model.
191
- - `system.ts`: system settings model.
192
- - `notify.ts`: notification-related data.
193
-
194
- Model sync and simple column migrations are currently handled in `back/loaders/db.ts`.
195
-
196
- ### Configuration
197
-
198
- - `back/config/index.ts`
199
-
200
- This is the central runtime config file. It reads `.env`, establishes `QL_DIR`, and defines important paths:
201
-
202
- - `dataPath`: runtime data root.
203
- - `configPath`: config files.
204
- - `scriptPath`: user scripts.
205
- - `repoPath`: subscription repositories.
206
- - `logPath`: task logs.
207
- - `dbPath`: SQLite database location.
208
- - `uploadPath`: uploaded files.
209
- - `shellPath`: shell runtime scripts.
210
- - `preloadPath`: JS/Python/Shell preload files.
211
-
212
- Before hardcoding paths, check `back/config/index.ts`.
213
-
214
- ### Scheduling And gRPC
215
-
216
- - `back/schedule/*`
217
- - `back/protos/*`
218
- - `back/services/grpc.ts`
219
-
220
- The project has two scheduling paths:
221
-
222
- - Standard crontab-style tasks are persisted and written through backend cron logic.
223
- - Node/gRPC scheduler logic handles cases such as second-level cron expressions or additional schedules.
224
-
225
- `back/services/cron.ts` decides whether a task needs the Node scheduler using schedule shape and `extra_schedules`.
226
-
227
- ### Shared Backend Utilities
228
-
229
- - `back/shared/*`
230
- - `back/config/util.ts`
231
- - `back/config/share.ts`
232
- - `back/config/http.ts`
233
-
234
- Use these before adding new global helpers. Existing shared code includes:
235
-
236
- - auth helpers.
237
- - shared store.
238
- - log stream manager.
239
- - task runner helpers.
240
- - concurrency limits.
241
- - file locking utilities.
242
- - HTTP/proxy helpers.
243
-
244
- ## Frontend Architecture
245
-
246
- ### Umi Config
247
-
248
- - `.umirc.ts`
249
-
250
- Important behavior:
251
-
252
- - Dev server proxies API requests to `http://127.0.0.1:5700/`.
253
- - Frontend build output is `static/dist`.
254
- - Runtime env script is loaded from `./api/env.js`.
255
- - `QlBaseUrl` affects frontend public path and routing base.
256
-
257
- ### App Initialization
258
-
259
- - `src/app.ts`
260
-
261
- Responsibilities:
262
-
263
- - Load Chinese and English locale JSON.
264
- - Determine locale from URL/cookie/localStorage.
265
- - Set Umi locale.
266
- - Apply `QlBaseUrl` as public path and router basename.
267
-
268
- ### Layout And Routes
269
-
270
- - `src/layouts/defaultProps.tsx`
271
- - `src/layouts/index.tsx`
272
-
273
- `defaultProps.tsx` defines the main route/menu list. If adding a new page visible in the sidebar, update this file.
274
-
275
- Current major pages:
276
-
277
- - `src/pages/crontab`: timed task management.
278
- - `src/pages/subscription`: subscription management.
279
- - `src/pages/env`: environment variables.
280
- - `src/pages/config`: config files.
281
- - `src/pages/script`: script management.
282
- - `src/pages/dependence`: dependency management.
283
- - `src/pages/log`: log management.
284
- - `src/pages/diff`: diff tool.
285
- - `src/pages/setting`: system settings.
286
- - `src/pages/login`: login.
287
- - `src/pages/initialization`: first-run initialization.
288
- - `src/pages/error`: error page.
289
-
290
- ### Frontend Utilities
291
-
292
- - `src/utils/http.tsx`: API request helper.
293
- - `src/utils/websocket.ts`: socket connection behavior.
294
- - `src/utils/config.ts`: frontend config helpers.
295
- - `src/utils/const.ts`: constants.
296
- - `src/utils/date.ts`: date formatting helpers.
297
- - `src/utils/init.ts`: initialization helpers.
298
- - `src/utils/codemirror/*`: CodeMirror integration.
299
- - `src/utils/monaco/*`: Monaco integration.
300
-
301
- When changing a page's API behavior, inspect both the page file and `src/utils/http.tsx`.
302
-
303
- ### Components And Styling
304
-
305
- - `src/components/*`: reusable UI components.
306
- - `src/pages/**/index.less`: page-level styles.
307
- - `src/pages/script/index.module.less` and `src/pages/log/index.module.less`: CSS module styles.
308
- - `src/assets/fonts/*`: bundled fonts.
309
- - `src/locales/*.json`: i18n text.
310
-
311
- Follow the existing Ant Design and Ant Design Pro patterns when modifying UI.
312
-
313
- ## Shell Runtime
314
-
315
- - `shell/task.sh`: task execution path.
316
- - `shell/otask.sh`: alternate/manual task execution path.
317
- - `shell/api.sh`: shell-side API helpers.
318
- - `shell/env.sh`: environment setup.
319
- - `shell/check.sh`: runtime check helpers.
320
- - `shell/update.sh`: update helpers.
321
- - `shell/rmlog.sh`: log cleanup.
322
- - `shell/share.sh`: shared shell helpers.
323
- - `shell/preload/*`: preload files injected into JS/Python/Shell task environments.
324
-
325
- The backend often coordinates task execution, but the actual user script process environment is shaped by files in `shell/`.
326
-
327
- ## Runtime Data Directory
328
-
329
- - `data/`
330
-
331
- This directory is runtime state, not just source code. Be careful when modifying or deleting files here.
332
-
333
- Important subdirectories:
334
-
335
- - `data/db`: SQLite database.
336
- - `data/config`: generated and user-edited config files.
337
- - `data/scripts`: user scripts.
338
- - `data/repo`: cloned subscription repositories.
339
- - `data/log`: task logs.
340
- - `data/upload`: uploaded files.
341
- - `data/syslog`: system logs.
342
- - `data/ssh.d`: SSH-related runtime data.
343
- - `data/dep_cache`: dependency cache, when present.
344
-
345
- Many bugs that appear as "backend logic" may involve state stored under `data/`.
346
-
347
- ## Docker And Release Files
348
-
349
- - `docker/Dockerfile`
350
- - `docker/310.Dockerfile`
351
- - `docker/docker-compose.yml`
352
- - `docker/docker-entrypoint.sh`
353
- - `ecosystem.config.js`
354
- - `version.yaml`
355
-
356
- Use these when changing deployment, container startup, PM2 behavior, or release metadata.
357
-
358
- ## Common Modification Map
359
-
360
- ### Add Or Modify A Backend API
361
-
362
- Typical files:
363
-
364
- 1. Add or update route in `back/api/<module>.ts`.
365
- 2. Add or update service logic in `back/services/<module>.ts`.
366
- 3. Add or update model in `back/data/<module>.ts` if persistence changes.
367
- 4. Add validation with `celebrate`/`Joi` near the route.
368
- 5. Update frontend caller in `src/pages/**` or `src/utils/**`.
369
-
370
- ### Add A New Frontend Page
371
-
372
- Typical files:
373
-
374
- 1. Create `src/pages/<page>/index.tsx`.
375
- 2. Add styles in `src/pages/<page>/index.less` if needed.
376
- 3. Register route/menu in `src/layouts/defaultProps.tsx`.
377
- 4. Add locale strings in `src/locales/zh-CN.json` and `src/locales/en-US.json`.
378
- 5. Add API calls through the existing request helper.
379
-
380
- ### Change Cron/Task Behavior
381
-
382
- Start with:
383
-
384
- - `back/api/cron.ts`
385
- - `back/services/cron.ts`
386
- - `back/schedule/*`
387
- - `shell/task.sh`
388
- - `shell/otask.sh`
389
- - `shell/preload/*`
390
-
391
- Also inspect:
392
-
393
- - `back/data/cron.ts`
394
- - `back/validation/schedule.ts`
395
- - `data/config/crontab.list`
396
- - `data/log/*`
397
-
398
- ### Change Environment Variable Behavior
399
-
400
- Start with:
401
-
402
- - `back/api/env.ts`
403
- - `back/services/env.ts`
404
- - `back/data/env.ts`
405
- - `src/pages/env/index.tsx`
406
-
407
- Also inspect:
408
-
409
- - `shell/preload/env.sh`
410
- - `shell/preload/env.js`
411
- - `shell/preload/env.py`
412
-
413
- ### Change Script Management
414
-
415
- Start with:
416
-
417
- - `back/api/script.ts`
418
- - `back/services/script.ts`
419
- - `src/pages/script/index.tsx`
420
- - `data/scripts/*`
421
-
422
- ### Change Login/Auth/Security
423
-
424
- Start with:
425
-
426
- - `back/api/user.ts`
427
- - `back/services/user.ts`
428
- - `back/shared/auth.ts`
429
- - `back/shared/store.ts`
430
- - `back/loaders/express.ts`
431
- - `back/token.ts`
432
- - `src/pages/login/index.tsx`
433
- - `src/pages/initialization/index.tsx`
434
-
435
- Be careful with:
436
-
437
- - JWT behavior.
438
- - open API token behavior.
439
- - first-run initialization.
440
- - platform-specific session limits.
441
-
442
- ### Change Subscription Behavior
443
-
444
- Start with:
445
-
446
- - `back/api/subscription.ts`
447
- - `back/services/subscription.ts`
448
- - `back/data/subscription.ts`
449
- - `src/pages/subscription/index.tsx`
450
- - `data/repo/*`
451
-
452
- ### Change Dependency Management
453
-
454
- Start with:
455
-
456
- - `back/api/dependence.ts`
457
- - `back/services/dependence.ts`
458
- - `back/data/dependence.ts`
459
- - `src/pages/dependence/index.tsx`
460
- - `data/deps`
461
- - `data/dep_cache`
462
-
463
- ### Change Logs Or Live Log Streaming
464
-
465
- Start with:
466
-
467
- - `back/api/log.ts`
468
- - `back/services/log.ts`
469
- - `back/services/sock.ts`
470
- - `back/shared/logStreamManager.ts`
471
- - `src/pages/log/index.tsx`
472
- - `src/components/terminal.tsx`
473
- - `data/log/*`
474
-
475
- ## Coding Conventions
476
-
477
- Backend:
478
-
479
- - Prefer adding business logic to services, not route files.
480
- - Use `typedi` services consistently.
481
- - Use existing config paths from `back/config/index.ts`.
482
- - Return API responses in the existing `{ code, data, message }` shape.
483
- - Use existing utilities before adding new helpers.
484
- - Preserve current SQLite/Sequelize style unless doing a larger data-layer refactor.
485
-
486
- Frontend:
487
-
488
- - Follow existing Umi/React/Ant Design patterns.
489
- - Keep route/menu changes in `src/layouts/defaultProps.tsx`.
490
- - Use existing request/WebSocket helpers.
491
- - Add or update locale strings for visible UI text.
492
- - Keep page-specific styles near the page.
493
-
494
- Shell/runtime:
495
-
496
- - Treat `shell/` as part of production behavior.
497
- - Test task execution changes with realistic scripts when possible.
498
- - Be careful with path quoting and environment variable propagation.
499
-
500
- Data:
501
-
502
- - Treat `data/` as mutable runtime state.
503
- - Do not delete runtime state unless explicitly requested.
504
- - Schema changes should account for existing SQLite databases.
505
-
506
- ## Suggested First Steps For AI Agents
507
-
508
- When asked to modify behavior:
509
-
510
- 1. Identify whether the change is frontend, backend, shell runtime, data model, or deployment.
511
- 2. Search by feature name in `src/pages`, `back/api`, and `back/services`.
512
- 3. Read the route file and matching service before editing.
513
- 4. If persistence is involved, read the matching `back/data` model and `back/loaders/db.ts`.
514
- 5. If task execution is involved, inspect `shell/` and `back/services/cron.ts`.
515
- 6. Make the smallest scoped change that matches existing patterns.
516
- 7. Run the most relevant check:
517
- - `pnpm run build:back` for backend TypeScript changes.
518
- - `pnpm run build:front` for frontend build changes.
519
- - targeted manual task/API checks for shell and scheduler changes.
520
-
521
- ## Quick Directory Reference
522
-
523
- ```text
524
- .
525
- ├── back/ Backend TypeScript application
526
- │ ├── api/ Express route modules
527
- │ ├── config/ Runtime config, paths, constants, helpers
528
- │ ├── data/ Sequelize models and SQLite connection
529
- │ ├── loaders/ Startup initialization and Express setup
530
- │ ├── middlewares/ Express middlewares
531
- │ ├── protos/ gRPC proto files and generated TS
532
- │ ├── schedule/ Scheduler/gRPC client helpers
533
- │ ├── services/ Business logic services
534
- │ ├── shared/ Shared backend utilities
535
- │ └── validation/ Joi validation schemas
536
- ├── src/ Frontend Umi/React application
537
- │ ├── assets/ Fonts and static frontend assets
538
- │ ├── components/ Shared UI components
539
- │ ├── hooks/ Frontend hooks
540
- │ ├── layouts/ Main layout and menu route config
541
- │ ├── locales/ i18n JSON
542
- │ ├── pages/ Feature pages
543
- │ └── utils/ HTTP, WebSocket, editor, date, and config utilities
544
- ├── shell/ Task runtime shell scripts and preload files
545
- ├── data/ Runtime state: db, logs, scripts, repos, configs
546
- ├── docker/ Docker build and compose files
547
- ├── sample/ Sample scripts and default config templates
548
- ├── static/ Built frontend/backend artifacts
549
- └── docs/ Project documentation
550
- ```
@@ -1,49 +0,0 @@
1
- # 2.22.0 发布准备验收
2
-
3
- 日期:2026-09-26。候选代码基于 `origin/develop@801a71d7402f5d4b582318ed88ad00633357a531`,主包和面板版本统一为 `2.22.0`。本文件记录验收证据,不代表已经发布。
4
-
5
- ## 自动化与构建
6
-
7
- - 新增 5 项日志弹窗回归:大日志结束后读完分页、尾部截取不重复取历史、运行中空日志继续轮询、关闭取消定时器/丢弃在途响应、旧响应和不前进偏移不死循环。
8
- - 用真实日志读取器写入 600 KiB 后结束任务:原 develop 在新增回归中失败,修复后 5 项全通过。
9
- - macOS arm64、Node 20、按冻结锁文件独立安装依赖:228 项测试,225 通过、3 项平台相关跳过、0 失败。后端 TypeScript 与前端生产构建通过;前端有已有的大包体提示。
10
- - `npm pack --dry-run` 成功,包含前后端产物,主包版本为 2.22.0;npm registry 查询该版本返回 E404(尚未占用,发布时仍需重新核实)。
11
- - 上游基线 Linux CI 为 223 项回归全部通过;CLI Node 22.12/24 流水线通过,Node 24 的 291 项测试全部通过。该结果属于上游提交,不冒充本分支新的 CI 结果。
12
- - GitNexus 对 `getCronLog` 修改前影响分析:LOW,直接调用者 `CronLogModal`,1 条流程。最终差异分析涉及日志弹窗流程;行号移动也将 `autoScroll` 列出,但该函数实现未修改。
13
-
14
- ## 容器升级与回退
15
-
16
- 测试仅使用新建账号、新建任务和隔离容器数据,不接触真实用户数据。
17
-
18
- - 已发布旧版镜像 `whyour/qinglong:2.21.0` digest:`sha256:e72f77d855a86cfabf774de76b030731c38540b251a0c888038810fbcf256c48`。镜像内源码为 `9b37f064d815baf49b1869445bbd60e4209bacc9`,与当前 master 提交不同;这是已发布镜像到候选版的实际升级验收。
19
- - 候选运行环境为 `whyour/qinglong:develop` digest:`sha256:35c5b9f2d0666ab7fcde954f175087c097e93fa852306360aa07b8aa0a5d0481`,revision 标签对应 `801a71d7402f5d4b582318ed88ad00633357a531`。装入本分支本地构建的前后端及版本文件。因此验证了候选代码的容器运行,不等同于最终发行镜像的完整构建验收。
20
- - 旧版创建账号及真实 Shell 脚本任务并验证独立输出,停机复制完整 `/ql/data` 作为一致的升级前备份。
21
- - 候选版读取该备份后原密码可登录、原任务仍存在并能真实执行,数据库已增加迁移表,测试账号密码已转为 scrypt(仅检查布尔值,未记录凭据)。
22
- - 长运行脚本启动后确认实际 PID;停止后确认该进程不存在;立即重跑并再次停止成功。状态字段恢复为空闲;不把历史 PID 字段当作进程存活判断。
23
- - 两步验证启用、密码阶段返回挑战、OTP 登录、同一验证码重放拒绝、关闭两步验证及重新登录均通过。
24
- - 每 5 秒调度的测试脚本产生持续输出;本容器 HTTP 夹具订阅下载 V1 文件成功。
25
- - 订阅夹具更新为 V2 后再次同步,落盘内容已变为 V2。
26
- - 容器重启前调度标记 34 行,重启后 41 行,HTTP/gRPC 健康且可重新登录,确认定时注册恢复。
27
- - 将升级前完整备份恢复到全新的 2.21.0 容器,原密码登录、原任务保留及真实脚本输出均通过。
28
-
29
- ## 生产依赖审计:仍需处理
30
-
31
- 在无共享 node_modules 的临时目录,使用候选 `package.json` 和 `pnpm-lock.yaml` 执行 `pnpm audit --prod --json`:414 个依赖,报告 3 Critical、38 High、49 Moderate、9 Low。数量是扫描公告命中,不等于独立漏洞数量或均能在面板中利用。审计时间与数据库变化会影响结果。
32
-
33
- | Critical 命中 | 生产依赖路径 | 初步适用性与处理 |
34
- | --- | --- | --- |
35
- | protobufjs 7.5.4 | `@grpc/proto-loader → protobufjs` | 公告要求攻击者能控制加载的 schema/descriptor;当前主要使用仓库内生成的协议,尚未证实外部可控 schema 入口。仍应升级到修复版本并验证 gRPC。 |
36
- | websocket-driver 0.7.4 | `sockjs → websocket-driver` / `faye-websocket` | 处理网络协议帧,不能用面板业务鉴权替代协议层修复;应升级到至少 0.7.5 并回归 WebSocket。 |
37
- | tar 6.2.1 | `@whyour/sqlite3 → tar`、`@mapbox/node-pre-gyp → tar` | 主要涉及安装/构建解压链,不能直接等同于面板上传接口漏洞。修复跨 tar 主版本,需验证 SQLite 预编译下载和源码编译路径;另有 tar 7.5.20 的后续公告。 |
38
-
39
- 参考:[protobufjs 公告](https://github.com/advisories/GHSA-xq3m-2v4x-88gg)、[websocket-driver 公告](https://github.com/advisories/GHSA-xv26-6w52-cph6)、[tar 公告](https://github.com/advisories/GHSA-23hp-3jrh-7fpw)。
40
-
41
- High 命中还涉及 gRPC、multer、js-yaml、JWT 的 jws、undici 等运行时依赖。当前准备改动没有批量升级依赖;不能宣称安全扫描通过。正式发布仍需完成依赖升级与可达性评估、回归,或由维护者明确记录接受的风险。
42
-
43
- ## 尚未放行的发布步骤
44
-
45
- - 本分支新的 Linux CI 尚待执行。
46
- - Python 3.10 镜像和全部架构的最终候选构建尚未验证;上游 develop 工作流跳过这些发布专用任务。
47
- - 主包及 CLI 的 npm Trusted Publisher 设置属于 npm 账户配置,未通过代码或只读公开 registry 验证;不得把 `id-token: write` 视作已完成授权。
48
- - 最终发版时确认 `publishTime` 与实际发布时间一致,并重新核对版本是否可发布。
49
- - 完成上述事项前不合并到 master、不打正式 tag、不执行 `shell/pub.sh`。
@@ -1,54 +0,0 @@
1
- # 青龙 2.22.0
2
-
3
- ## 新增功能
4
-
5
- - 独立远程命令行包 `@whyour/qinglong-cli`:覆盖任务、订阅、环境变量、配置、脚本、日志、依赖、应用、系统等 OpenAPI,支持认证、JSON 输出和中英文帮助。
6
- - 可选面板内部 TypeScript 工具:任务执行、订阅同步、启动检查、升级重载和账号恢复。默认继续使用原 Shell 入口。
7
- - 仪表盘支持点击今日成功、今日失败查看任务明细。
8
- - 客户端 IP 和代理链诊断、可信代理配置、登录 IP 黑名单。
9
- - 历史运行实例和统计数据的保留参数、清理预览、手动清理、依赖缓存清理和数据库压缩。保存保留参数不等于开启自动清理。
10
- - WPUSH 通知,支持面板、JavaScript、Python 和 gRPC。
11
- - `ql log [--lines <n>] [--nostream]` 查看服务日志。
12
-
13
- ## 修复与优化
14
-
15
- - 修复任务生命周期、调度锁、调度器就绪和恢复、排队与停止竞争、订阅清理,以及停止失败的反馈。
16
- - 日志改为分块读取;任务结束后继续读完剩余分页,确保最后的输出和退出信息可见。修复中文任务日志名。
17
- - 加固密码存储、JWT 有效性校验、两步验证、认证状态变更和文件路径访问。
18
- - 修复过期登录令牌引起的页面刷新循环,完善任务字段校验提示。
19
- - 减少常驻依赖和重复 WebSocket 鉴权,限制指标缓存和日志显示量,优化大目录枚举。
20
- - 优化 Node 路径缓存与 Alpine 并发缓存锁,修正依赖缓存清理后的安装状态。
21
- - 启动时保留 `.env` 配置;保留容器启动错误诊断;数据库迁移失败时中止启动。
22
- - 镜像增加 provenance、SBOM、源码/静态产物/依赖锁文件一致性校验,改进多架构构建。
23
-
24
- ## 升级兼容性
25
-
26
- ### 数据备份与回退
27
-
28
- 升级前停止面板和任务,备份完整持久化数据目录,并记录当前镜像的不可变 digest、启动参数、挂载和环境配置。不要只复制正在写入的 SQLite 主文件;必须保留完整离线数据备份。
29
-
30
- 新版兼容旧密码;首次成功登录或修改密码后,密码会迁移为 scrypt 哈希。旧版不识别这种格式,因此**不能只回退镜像并继续使用升级后的数据**。
31
-
32
- 需要回退时:停止新版,另外保存升级后的数据,恢复升级前的完整备份,再使用原镜像 digest 和原启动配置启动旧版。恢复备份会丢弃备份后产生的任务、配置和日志变更。如必须保留升级后数据,应单独验证旧版兼容性,并通过可信终端使用旧版账号恢复功能重新设置密码;不要手工把哈希当作密码使用。
33
-
34
- 数据库迁移新增 `SchemaMigrations` 和任务排队标识;迁移异常会阻止启动。应检查启动日志并修复数据或恢复备份,不要通过删除数据库来绕过错误。
35
-
36
- ### API 与日志
37
-
38
- 旧文件读取路由 `/configs/:file`、`/scripts/:file`、`/logs/:file` 返回业务码 `410`,请改用对应的 `/detail` 接口(适用于 `/api` 和 `/open` 前缀)。
39
-
40
- 日志接口默认返回尾部片段。客户端需要使用 `offset`、`nextOffset`、`total` 读取后续数据;任务已结束不代表所有日志已经读取完毕。面板仅保留有限长度的日志显示,完整文件仍在日志目录中。
41
-
42
- 修改账号或两步验证配置会使旧会话失效;客户端应重新登录。IP 黑名单针对登录;反向代理场景应先在客户端 IP 页面确认识别结果再配置黑名单。
43
-
44
- ### CLI
45
-
46
- 远程 npm CLI 要求 Node >=22.12,推荐 Node 24。它与面板内置工具均使用 `ql` 名称;已有面板的机器应使用独立 npm prefix 或 `npm exec --package=@whyour/qinglong-cli -- ql ...`,避免覆盖内置命令。
47
-
48
- 远程 npm 包不包含本机执行器、升级、重载和账号恢复实现,也不会自动切换面板入口。使用内部工具需单独构建完整 `cli/dist`,在满足 Node 版本要求的环境中显式设置 `QL_CLI_ROOT`;清除该变量并重启恢复 Shell 入口。标准面板镜像并未默认启用内部 TypeScript 工具。
49
-
50
- ## 发布验收
51
-
52
- 正式发布前应完成:旧版离线数据升级、登录与两步验证、定时/手动任务、停止后立即重跑、订阅更新、容器重启调度恢复和备份回退。发布者还需检查 Python 3.10 镜像矩阵,以及主包和 CLI 的 npm Trusted Publisher 配置。
53
-
54
- 依赖审计与执行证据见同目录的 `2.22.0-validation.md`。通过单元测试或构建不代表完成所有平台和真实升级场景的验收。
package/sample/tool.ts DELETED
@@ -1,40 +0,0 @@
1
- import * as qiniu from 'qiniu';
2
- import dotenv from 'dotenv';
3
- const envFound = dotenv.config();
4
-
5
- const accessKey = process.env.QINIU_AK;
6
- const secretKey = process.env.QINIU_SK;
7
- const mac = new qiniu.auth.digest.Mac(accessKey, secretKey);
8
- const key = 'version.yaml';
9
- const options = {
10
- scope: `${process.env.QINIU_SCOPE}:${key}`,
11
- };
12
- const putPolicy = new qiniu.rs.PutPolicy(options);
13
- const uploadToken = putPolicy.uploadToken(mac);
14
-
15
- const localFile = 'version.yaml';
16
- const config = new qiniu.conf.Config({ zone: qiniu.zone.Zone_z1 });
17
- const formUploader = new qiniu.form_up.FormUploader(config);
18
- const putExtra = new qiniu.form_up.PutExtra(
19
- '',
20
- {},
21
- 'text/plain; charset=utf-8',
22
- );
23
- // 文件上传
24
- formUploader.putFile(
25
- uploadToken,
26
- key,
27
- localFile,
28
- putExtra,
29
- function (respErr, respBody, respInfo) {
30
- if (respErr) {
31
- throw respErr;
32
- }
33
- if (respInfo.statusCode == 200) {
34
- console.log(respBody);
35
- } else {
36
- console.log(respInfo.statusCode);
37
- console.log(respBody);
38
- }
39
- },
40
- );