@microi.net/cli 5.8.5 → 5.8.7

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 (208) hide show
  1. package/.codebuddy-plugin/marketplace.json +2 -2
  2. package/.codebuddy-plugin/plugin.json +1 -1
  3. package/.codex-plugin/plugin.json +1 -1
  4. package/.workbuddy-plugin/marketplace.json +2 -2
  5. package/.workbuddy-plugin/plugin.json +1 -1
  6. package/LICENSE +21 -21
  7. package/README.md +71 -71
  8. package/assets/build-meta.json +7 -7
  9. package/assets/feature-matrix.json +138 -138
  10. package/assets/logo.svg +4 -4
  11. package/cordis.patch.yml +1 -1
  12. package/package.json +1 -1
  13. package/scripts/mcp-codex-stdio-adapter.js +0 -0
  14. package/scripts/mcp-server.js +1 -1
  15. package/scripts/microi-cli.js +66 -65
  16. package/scripts/microi-codex-broker.js +450 -450
  17. package/scripts/microi-codex-router.js +618 -618
  18. package/scripts/microi-skills.meta.json +384 -384
  19. package/skills/.microi-skills-version.json +2 -2
  20. package/skills/.progressive-disclosure-manifest.json +21 -21
  21. package/skills/README.md +287 -287
  22. package/skills/ai-engine/SKILL.md +269 -265
  23. package/skills/ai-engine/agents/openai.yaml +4 -4
  24. package/skills/ai-engine/references/ai-employees.md +48 -48
  25. package/skills/ai-engine/references/self-hosted-digital-human.md +59 -59
  26. package/skills/ai-platform-governance/SKILL.md +177 -177
  27. package/skills/ai-platform-governance/references/progressive-01-/345/212/237/350/203/275/345/274/200/345/205/263.md +190 -190
  28. package/skills/app-store/SKILL.md +525 -525
  29. package/skills/app-store/agents/openai.yaml +4 -4
  30. package/skills/business-blueprint/SKILL.md +193 -193
  31. package/skills/datasource-engine/SKILL.md +93 -93
  32. package/skills/datasource-engine/agents/openai.yaml +4 -4
  33. package/skills/dos-orm/SKILL.md +97 -95
  34. package/skills/dos-orm/references/api-reference.md +229 -229
  35. package/skills/email-engine/SKILL.md +81 -81
  36. package/skills/email-engine/references/v8-email.md +34 -34
  37. package/skills/job-engine/SKILL.md +176 -176
  38. package/skills/job-engine/agents/openai.yaml +4 -4
  39. package/skills/message-notification/SKILL.md +156 -156
  40. package/skills/message-notification/agents/openai.yaml +5 -5
  41. package/skills/message-notification/references/contracts.md +102 -102
  42. package/skills/microi/SKILL.md +14 -14
  43. package/skills/microi-ai-app-auth.js +652 -652
  44. package/skills/microi-ai-application/SKILL.md +115 -115
  45. package/skills/microi-ai-application/agents/openai.yaml +4 -4
  46. package/skills/microi-ai-application/references/frontend-baseline.md +164 -164
  47. package/skills/microi-client-frontend/SKILL.md +246 -244
  48. package/skills/microi-client-frontend/references/progressive-01-3-/345/212/250/346/200/201/346/214/211/351/222/256/347/263/273/347/273/237.md +144 -144
  49. package/skills/microi-client-frontend/references/progressive-02-8-/350/277/220/350/241/214/346/227/266/351/253/230/351/242/221/345/235/221/345/244/215/347/233/230.md +196 -196
  50. package/skills/microi-client-frontend/references/progressive-03-vue3-/345/211/215/347/253/257/345/276/256/346/234/215/345/212/241/345/256/277/344/270/273/350/247/204/345/210/231.md +167 -167
  51. package/skills/microi-codex/SKILL.md +102 -100
  52. package/skills/microi-codex-installer/SKILL.md +231 -231
  53. package/skills/microi-codex-installer/agents/openai.yaml +7 -7
  54. package/skills/microi-datasource-mapping/SKILL.md +122 -122
  55. package/skills/microi-db-schema/SKILL.md +175 -175
  56. package/skills/microi-db-schema/agents/openai.yaml +4 -4
  57. package/skills/microi-db-schema/references/core-tables.md +695 -695
  58. package/skills/microi-db-schema/references/form-component-options.md +256 -256
  59. package/skills/microi-db-schema/references/schema-overview.md +202 -202
  60. package/skills/microi-db-schema/references/schema.md +646 -646
  61. package/skills/microi-db-schema/references/table-catalog.md +1599 -1599
  62. package/skills/microi-deployment/SKILL.md +222 -220
  63. package/skills/microi-deployment/references/deployment-matrix.md +109 -109
  64. package/skills/microi-docs-coverage/SKILL.md +133 -133
  65. package/skills/microi-docs-coverage/references/capability-map.md +91 -91
  66. package/skills/microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs +894 -894
  67. package/skills/microi-form-engine/SKILL.md +333 -333
  68. package/skills/microi-form-engine/references/component-catalog.md +218 -218
  69. package/skills/microi-form-engine/references/data-source-events.md +124 -124
  70. package/skills/microi-form-layout/SKILL.md +205 -205
  71. package/skills/microi-form-layout/references/progressive-01-3-/344/270/211/347/247/215/345/210/206/347/273/204/347/232/204/345/255/230/345/202/250/344/270/216/351/205/215/347/275/256.md +235 -235
  72. package/skills/microi-frontend-sdk/SKILL.md +194 -194
  73. package/skills/microi-frontend-sdk/references/progressive-01-token-/345/275/223/345/211/215/347/231/273/345/275/225/347/224/250/346/210/267/344/270/216/345/275/223/345/211/215/347/273/210/347/253/257/347/231/273/345/275/225/345/215/217/350/256/256.md +176 -176
  74. package/skills/microi-left-right-layout/SKILL.md +141 -141
  75. package/skills/microi-microservice/SKILL.md +328 -326
  76. package/skills/microi-microservice/references/runtime-delivery.md +278 -278
  77. package/skills/microi-mobile-app-quality/SKILL.md +185 -185
  78. package/skills/microi-mobile-app-quality/references/progressive-01-4-/351/207/215/350/246/201/346/214/211/351/222/256/345/277/205/351/241/273/345/270/246/345/233/276/346/240/207.md +213 -213
  79. package/skills/microi-mobile-app-quality/references/progressive-02-9-/344/270/273/351/242/230/345/210/207/346/215/242/345/277/205/351/241/273/347/234/237/345/256/236/344/270/224/345/205/250/345/261/200/347/224/237/346/225/210.md +128 -128
  80. package/skills/microi-solution-quotation/SKILL.md +78 -78
  81. package/skills/microi-solution-quotation/agents/openai.yaml +4 -4
  82. package/skills/microi-solution-quotation/scripts/build_solution_quote.py +296 -296
  83. package/skills/microi-sso/SKILL.md +96 -90
  84. package/skills/microi-sso/references/acceptance.md +49 -49
  85. package/skills/microi-sso/references/configuration-and-security.md +53 -53
  86. package/skills/microi-sso/references/inbound.md +53 -53
  87. package/skills/microi-sso/references/outbound.md +39 -39
  88. package/skills/microi-system-delivery/SKILL.md +137 -137
  89. package/skills/microi-system-delivery/references/progressive-01-/346/240/207/345/207/206/345/267/245/344/275/234/346/265/201.md +193 -193
  90. package/skills/microi-system-delivery/references/progressive-02-/350/207/252/345/212/250/345/214/226/346/265/213/350/257/225/345/277/205/351/241/273/350/246/206/347/233/226/347/232/204/345/235/221.md +217 -217
  91. package/skills/microi-ui/SKILL.md +192 -192
  92. package/skills/microi-ui/references/progressive-01-/347/247/273/345/212/250/347/253/257/345/234/272/346/231/257/350/223/235/345/233/276.md +183 -183
  93. package/skills/microi-uniapp-frontend/SKILL.md +193 -193
  94. package/skills/microi-uniapp-frontend/references/progressive-01-/347/247/273/345/212/250/347/253/257/345/210/206/347/261/273-/345/217/214/346/240/217/345/210/227/350/241/250/347/213/254/347/253/213/346/273/232/345/212/250.md +225 -225
  95. package/skills/microi-uniapp-frontend/references/progressive-02-/345/205/263/351/224/256/344/270/232/345/212/241/350/265/204/344/272/247/344/270/215/345/276/227/351/273/230/350/256/244/351/200/211/344/270/255.md +154 -154
  96. package/skills/microi.v8.js +1921 -1921
  97. package/skills/module-engine/SKILL.md +255 -255
  98. package/skills/module-engine/references/module-config.md +204 -204
  99. package/skills/ocr-engine/SKILL.md +113 -113
  100. package/skills/ocr-engine/agents/openai.yaml +4 -4
  101. package/skills/page-engine/SKILL.md +206 -206
  102. package/skills/page-engine/examples/compact-dashboard.json +1444 -1444
  103. package/skills/page-engine/references/progressive-01-/346/211/200/346/234/211/347/273/204/344/273/266/347/261/273/345/236/213.md +234 -234
  104. package/skills/page-engine/references/progressive-02-/347/211/210/346/234/254/345/216/206/345/217/262-/345/271/266/345/217/221/344/277/235/345/255/230/344/270/216/345/233/236/346/273/232.md +60 -60
  105. package/skills/performance-testing/SKILL.md +221 -221
  106. package/skills/playwright-e2e/SKILL.md +196 -196
  107. package/skills/playwright-e2e/references/progressive-01-/345/205/250/350/207/252/345/212/250/347/231/273/345/275/225-/345/205/215/351/252/214/350/257/201/347/240/201-/344/275/206/344/270/215/345/205/215/345/257/206/347/240/201-/345/277/205/350/257/273.md +173 -173
  108. package/skills/playwright-e2e/references/progressive-02-/346/226/207/345/255/227/345/257/271/346/257/224/345/272/246/344/270/216/345/217/257/350/257/273/346/200/247/350/207/252/345/212/250/345/214/226/346/243/200/346/237/245-/345/277/205/345/201/232.md +183 -183
  109. package/skills/playwright-e2e/references/progressive-03-microi-helper-/346/250/241/346/235/277.md +221 -221
  110. package/skills/playwright-e2e/references/progressive-04-ci-/345/273/272/350/256/256.md +115 -115
  111. package/skills/print-engine/SKILL.md +259 -259
  112. package/skills/production-readonly-audit/SKILL.md +41 -41
  113. package/skills/report-engine/SKILL.md +71 -71
  114. package/skills/report-engine/agents/openai.yaml +4 -4
  115. package/skills/scripts/optimize-progressive-disclosure.mjs +204 -204
  116. package/skills/scripts/refresh-progressive-disclosure.mjs +64 -64
  117. package/skills/scripts/sync-embedded-skills.mjs +46 -46
  118. package/skills/scripts/validate-progressive-disclosure.mjs +57 -57
  119. package/skills/search-engine/SKILL.md +75 -75
  120. package/skills/search-engine/agents/openai.yaml +4 -4
  121. package/skills/spider-engine/SKILL.md +190 -190
  122. package/skills/system-observability/SKILL.md +249 -246
  123. package/skills/system-observability/references/memory-incident-triage.md +77 -77
  124. package/skills/translate-engine/SKILL.md +140 -140
  125. package/skills/translate-engine/agents/openai.yaml +4 -4
  126. package/skills/ui-design/SKILL.md +223 -223
  127. package/skills/ui-design/assets/pattern-showcase/app.js +54 -54
  128. package/skills/ui-design/assets/pattern-showcase/index.html +163 -163
  129. package/skills/ui-design/assets/pattern-showcase/styles.css +311 -311
  130. package/skills/ui-design/assets/templates/MCI-DESIGN.md +206 -206
  131. package/skills/ui-design/references/design-pattern-library.md +184 -184
  132. package/skills/ui-design/references/mci-design-contract.md +163 -163
  133. package/skills/ui-design/references/motion-and-media.md +78 -78
  134. package/skills/ui-design/references/product-flow-recipes.md +94 -94
  135. package/skills/ui-design/references/progressive-01-/351/242/234/350/211/262/344/275/223/347/263/273-css-variables-/346/224/257/346/214/201/344/270/273/351/242/230/345/210/207/346/215/242.md +218 -218
  136. package/skills/ui-design/references/progressive-02-/345/255/227/344/275/223.md +164 -164
  137. package/skills/ui-design/references/progressive-03-/345/212/250/346/225/210/350/247/204/350/214/203-/344/270/260/345/257/214/344/275/206/344/270/215/345/215/241.md +235 -235
  138. package/skills/ui-design/references/progressive-04-/347/273/204/344/273/266/351/243/216/346/240/274/351/200/237/346/237/245.md +152 -152
  139. package/skills/ui-design/references/progressive-05-/347/247/273/345/212/250/347/253/257/344/270/223/347/224/250/350/247/204/350/214/203.md +238 -238
  140. package/skills/ui-design/references/progressive-06-/344/270/273/351/242/230/345/210/207/346/215/242/345/256/236/347/216/260.md +194 -194
  141. package/skills/ui-design/references/progressive-07-/351/200/237/346/237/245-/344/273/216/345/244/264/346/220/255/345/273/272/344/270/200/344/270/252/347/247/273/345/212/250/347/253/257/351/241/265/351/235/242.md +207 -207
  142. package/skills/ui-design/references/progressive-08-/350/241/250/345/215/225/345/210/206/347/273/204/350/247/204/350/214/203-tabs-vs-collapsegroup-/345/274/272/345/210/266.md +142 -142
  143. package/skills/uniapp-mall-assets/SKILL.md +176 -176
  144. package/skills/unity-integration/SKILL.md +171 -171
  145. package/skills/unity-integration/agents/openai.yaml +4 -4
  146. package/skills/unity-integration/references/ai-app-delivery.md +119 -119
  147. package/skills/unity-integration/references/sdk-api.md +82 -82
  148. package/skills/unity-integration/references/toolbox-migration.md +66 -66
  149. package/skills/unity-integration/references/webgl-hosting.md +57 -57
  150. package/skills/v8-api-config/SKILL.md +388 -388
  151. package/skills/v8-cache-pattern/SKILL.md +312 -312
  152. package/skills/v8-crud-api/SKILL.md +178 -178
  153. package/skills/v8-crud-api/references/progressive-01-/346/237/245/350/257/242/345/210/227/350/241/250-/345/210/206/351/241/265.md +226 -226
  154. package/skills/v8-crud-api/references/progressive-02-where-/346/235/241/344/273/266/350/257/255/346/263/225/351/200/237/346/237/245.md +49 -49
  155. package/skills/v8-debugging/SKILL.md +284 -284
  156. package/skills/v8-explorer-tree/SKILL.md +228 -228
  157. package/skills/v8-export-import/SKILL.md +219 -219
  158. package/skills/v8-export-import/references/progressive-01-excellayout-/351/253/230/347/272/247/350/207/252/347/224/261/345/270/203/345/261/200.md +211 -211
  159. package/skills/v8-export-import/references/progressive-02-powerpoint-/345/257/274/345/207/272.md +202 -202
  160. package/skills/v8-export-import/references/progressive-03-/345/256/211/345/205/250-/346/200/247/350/203/275/346/263/250/346/204/217.md +42 -42
  161. package/skills/v8-file-upload/SKILL.md +284 -284
  162. package/skills/v8-file-upload/references/progressive-01-/345/205/254/346/234/211/346/241/266-vs-/347/247/201/346/234/211/346/241/266.md +263 -263
  163. package/skills/v8-file-upload/references/progressive-02-office-/346/226/207/344/273/266/345/234/250/347/272/277/347/274/226/350/276/221/347/211/210/346/234/254/345/217/267/350/247/204/345/210/231.md +161 -161
  164. package/skills/v8-formengine-http/SKILL.md +238 -238
  165. package/skills/v8-frontend-events/SKILL.md +180 -180
  166. package/skills/v8-frontend-events/references/bluetooth-print-api.md +135 -135
  167. package/skills/v8-frontend-events/references/bluetooth-print.md +258 -258
  168. package/skills/v8-frontend-events/references/progressive-01-/345/210/227/350/241/250/344/272/213/344/273/266.md +219 -219
  169. package/skills/v8-http-integration/SKILL.md +182 -182
  170. package/skills/v8-http-integration/references/progressive-01-get-/350/257/267/346/261/202.md +220 -220
  171. package/skills/v8-http-integration/references/progressive-02-/351/224/231/350/257/257/345/244/204/347/220/206/346/250/241/345/274/217.md +44 -44
  172. package/skills/v8-image-processing/SKILL.md +190 -190
  173. package/skills/v8-image-processing/agents/openai.yaml +4 -4
  174. package/skills/v8-image-processing/references/api-reference.md +623 -623
  175. package/skills/v8-menu-buttons/SKILL.md +186 -186
  176. package/skills/v8-menu-buttons/references/progressive-01-2-/346/214/211/351/222/256/345/257/271/350/261/241-schema.md +222 -222
  177. package/skills/v8-menu-buttons/references/progressive-02-8-/346/250/241/345/274/217-f-/345/220/216/345/217/260/344/273/273/345/212/241/346/214/211/351/222/256-/351/225/277/344/273/273/345/212/241.md +228 -228
  178. package/skills/v8-menu-buttons/references/progressive-03-10-/345/217/215/346/250/241/345/274/217-/351/201/277/345/205/215.md +104 -104
  179. package/skills/v8-mongodb/SKILL.md +200 -200
  180. package/skills/v8-mq-mqtt/SKILL.md +176 -176
  181. package/skills/v8-mq-mqtt/references/mqtt-production.md +342 -342
  182. package/skills/v8-mq-mqtt/references/progressive-01-v8-mqtt-iot-/347/211/251/350/201/224/347/275/221.md +181 -181
  183. package/skills/v8-mq-mqtt/scripts/check-mqtt-skill-coverage.mjs +203 -203
  184. package/skills/v8-saas-multi-tenant/SKILL.md +305 -305
  185. package/skills/v8-security/SKILL.md +210 -210
  186. package/skills/v8-security/references/progressive-01-2-/346/235/203/351/231/220/346/240/241/351/252/214.md +200 -200
  187. package/skills/v8-security/references/progressive-02-7-/346/227/245/345/277/227/350/256/260/345/275/225.md +160 -160
  188. package/skills/v8-sql-query/SKILL.md +302 -302
  189. package/skills/v8-table-event/SKILL.md +176 -176
  190. package/skills/v8-table-event/references/progressive-01-informv8-js-/350/241/250/345/215/225/346/211/223/345/274/200/344/272/213/344/273/266.md +216 -216
  191. package/skills/v8-table-event/references/progressive-02-/345/211/215/347/253/257/344/272/213/344/273/266/345/220/215-v8-eventname-/345/217/257/350/203/275/347/232/204/345/200/274.md +46 -46
  192. package/skills/v8-tcp-integration/SKILL.md +147 -147
  193. package/skills/v8-tcp-integration/agents/openai.yaml +4 -4
  194. package/skills/v8-template-engine/SKILL.md +167 -167
  195. package/skills/v8-utilities/SKILL.md +104 -104
  196. package/skills/v8-utilities/references/client-api-index.md +143 -143
  197. package/skills/v8-utilities/references/platform-http-routes.md +83 -83
  198. package/skills/v8-utilities/references/server-api-index.md +188 -188
  199. package/skills/v8-workflow/SKILL.md +252 -252
  200. package/skills/v8-workflow/references/progressive-01-/350/212/202/347/202/271/345/274/200/345/247/213-v8-/344/272/213/344/273/266.md +180 -180
  201. package/skills/v8-workflow/references/workflow-configuration.md +49 -49
  202. package/skills/vision-engine/SKILL.md +160 -160
  203. package/skills/vision-engine/agents/openai.yaml +4 -4
  204. package/skills/vision-engine/references/architecture-and-acceptance.md +194 -194
  205. package/skills/workspace-conventions/SKILL.md +273 -273
  206. package/skills/workspace-conventions/references/progressive-01-/347/211/210/346/234/254/346/233/264/346/226/260/346/227/245/345/277/227/344/277/235/346/212/244/350/247/204/345/210/231-/345/274/272/345/210/266.md +209 -209
  207. package/skills/workspace-conventions/references/progressive-02-microi-net-api-/346/234/254/345/234/260/345/220/257/345/212/250/347/272/246/345/256/232.md +217 -217
  208. package/skills/workspace-conventions/references/progressive-03-cli-/344/270/216-ide-/346/217/222/344/273/266/351/224/231/347/211/210/345/205/261/345/255/230/347/272/246/345/256/232.md +27 -27
@@ -1,226 +1,226 @@
1
- # v8-crud-api 详细参考 1
2
-
3
- > 按需读取;本文件由 SKILL.md 的原章节无损拆分。
4
-
5
- <!-- microi-progressive:chunk id=v8-crud-api-007 sha256=66648d1a9ca67cc9cb1cdc0dd231f73c61723fbc48fc197cbd74ba6a2cde4319 -->
6
- ## 查询列表(分页)
7
-
8
- ```javascript
9
- var result = V8.FormEngine.GetTableData('SysUser', {
10
- _Where: [
11
- ['Status', '=', 1],
12
- ['AND', 'Name', 'Like', V8.Param.keyword || '']
13
- ],
14
- _SelectFields: ['Id', 'Account', 'Name', 'Phone', 'CreateTime'],
15
- _OrderBy: 'CreateTime',
16
- _OrderByType: 'DESC',
17
- _PageIndex: V8.Param.pageIndex || 1,
18
- _PageSize: V8.Param.pageSize || 20
19
- });
20
-
21
- return { Code: 1, Data: result.Data, DataCount: result.DataCount, Msg: '成功' };
22
- ```
23
-
24
- ### 请求内异步查询
25
-
26
- 后端接口引擎可在本次请求内使用真实异步查询;前端 V8 不使用这个方法名:
27
-
28
- ```javascript
29
- var result = await V8.FormEngine.GetTableDataAsync('SysUser', {
30
- _Where: [['Status', '=', 1]],
31
- _SelectFields: ['Id', 'Account', 'Name'],
32
- _PageIndex: 1,
33
- _PageSize: 20
34
- });
35
-
36
- return { Code: 1, Data: result.Data, DataCount: result.DataCount };
37
- ```
38
-
39
- 必须 `await` 结果。需要接口先返回、后续再批量处理时,应改用平台后台任务、Job、MQ 或 outbox,而不是丢弃 Promise。
40
-
41
- ### 多字段排序
42
-
43
- ```javascript
44
- var result = V8.FormEngine.GetTableData('SysUser', {
45
- _Where: [['Status', '=', 1]],
46
- _OrderBys: { 'CreateTime': 'desc', 'Name': 'asc' }
47
- });
48
- ```
49
-
50
- ### 匿名查询(无需登录)
51
-
52
- ```javascript
53
- var result = V8.FormEngine.GetTableDataAnonymous('Article', {
54
- _Where: [['IsPublished', '=', 1]],
55
- _PageSize: 10
56
- });
57
- ```
58
-
59
- 匿名新增的公开入口是
60
- `POST /api/formengine/AddFormDataAnonymous`,且目标表必须显式允许匿名新增。
61
- 当前后端 `V8.FormEngine` 接口不公开
62
- `V8.FormEngine.AddFormDataAnonymous`;接口引擎内部仍使用
63
- `V8.FormEngine.AddFormData(...)` 并遵守可信执行身份。不要仅因为历史文档出现
64
- 该名称就为匿名业务接口关闭服务端校验。
65
-
66
- ### 获取树形数据
67
-
68
- ```javascript
69
- // 表单属性需开启【树形结构】
70
- var result = V8.FormEngine.GetTableDataTree('Department', {});
71
- ```
72
-
73
- ### 仅获取数据条数
74
-
75
- ```javascript
76
- var result = V8.FormEngine.GetTableDataCount('SysUser', {
77
- _Where: [['Status', '=', 1]]
78
- });
79
- // result.DataCount 为总数
80
- ```
81
-
82
- <!-- /microi-progressive:chunk -->
83
- <!-- microi-progressive:chunk id=v8-crud-api-008 sha256=3ac0bc88bec40eb1a24e0d4829fae58094760efd3a5b77d1cc52d87c5931a58b -->
84
- ## 更新
85
-
86
- ```javascript
87
- if (!V8.Param.Id) {
88
- return { Code: 0, Msg: 'Id 不能为空' };
89
- }
90
-
91
- var result = V8.FormEngine.UptFormData('SysUser', {
92
- Id: V8.Param.Id, // 必传
93
- Name: V8.Param.Name,
94
- Phone: V8.Param.Phone,
95
- _NotSaveField: ['Account'], // 可选:忽略这些字段不更新
96
- _NoLineForAdd: true, // 可选:数据不存在时自动插入
97
- _ForceUpt: true // 可选:强制修改自动编号字段
98
- });
99
-
100
- return { Code: result.Code, Msg: result.Code === 1 ? '更新成功' : result.Msg };
101
- ```
102
-
103
- ### 批量更新
104
-
105
- ```javascript
106
- var uptList = [];
107
- for (var i = 0; i < V8.Param.items.length; i++) {
108
- uptList.push({
109
- FormEngineKey: 'SysUser',
110
- Id: V8.Param.items[i].Id,
111
- Status: V8.Param.items[i].Status
112
- });
113
- }
114
- V8.FormEngine.UptTableData(uptList);
115
- ```
116
-
117
- <!-- /microi-progressive:chunk -->
118
- <!-- microi-progressive:chunk id=v8-crud-api-009 sha256=70e57be16e8676712be6910bfe9d50b87482d02cbbe0ab18a397a58f70916dae -->
119
- ## 删除
120
-
121
- ```javascript
122
- // 删除单条
123
- var result = V8.FormEngine.DelFormData('SysUser', { Id: V8.Param.Id });
124
-
125
- // 批量删除(传 Ids 数组)
126
- var result = V8.FormEngine.DelFormData('SysUser', { Ids: V8.Param.Ids });
127
-
128
- return { Code: result.Code, Msg: result.Code === 1 ? '删除成功' : result.Msg };
129
- ```
130
-
131
- ### 批量删除(跨表)
132
-
133
- ```javascript
134
- var delList = [];
135
- delList.push({ FormEngineKey: 'OrderDetail', Id: V8.Param.detailId });
136
- delList.push({ FormEngineKey: 'OrderHeader', Id: V8.Param.orderId });
137
- V8.FormEngine.DelTableData(delList);
138
- ```
139
-
140
- <!-- /microi-progressive:chunk -->
141
- <!-- microi-progressive:chunk id=v8-crud-api-010 sha256=620f7edf12046f4cc4f7142b9e8dbae4495d826b38efb97abdf36fde4206e7d4 -->
142
- ## 按条件批量操作
143
-
144
- ```javascript
145
- // 按条件更新
146
- V8.FormEngine.UptFormDataByWhere('SysUser', {
147
- _Where: [['DeptId', '=', V8.Param.deptId]],
148
- Status: 0,
149
- _NoLineForAdd: true // 可选:不存在时插入
150
- });
151
-
152
- // 按条件删除(不支持 _Where 以外的删除方式)
153
- V8.FormEngine.DelFormDataByWhere('SysUser', {
154
- _Where: [['Status', '=', 0], ['AND', 'CreateTime', '<', '2024-01-01']]
155
- });
156
- ```
157
-
158
- <!-- /microi-progressive:chunk -->
159
- <!-- microi-progressive:chunk id=v8-crud-api-011 sha256=8bfaf89705627a0c0dd1a7723c09832cb00a1206910e3ed70ebdbde7ffa832f4 -->
160
- ## 事务处理
161
-
162
- ```javascript
163
- // 接口引擎中 V8.Db 自动开启事务:
164
- // 返回DosResult/带Code对象:仅Code=1提交,其他值回滚
165
- // 返回对象但没有Code:回滚
166
- // 返回字符串/数字/数组/布尔/null且未异常:提交
167
- // 手动调用 V8.DbTrans.Commit() 或 Rollback() 无效,由平台统一管理
168
-
169
- // FormEngine 可传入事务对象(第三个参数)
170
- V8.FormEngine.AddFormData('Table1', { Name: '测试' }, V8.DbTrans);
171
- V8.FormEngine.UptFormData('Table2', { Id: 'xxx', Status: 1 }, V8.DbTrans);
172
-
173
- // 调用其他接口引擎也可共享事务
174
- V8.ApiEngine.Run('other-engine-key', { Id: 'xxx' }, V8.DbTrans);
175
- ```
176
-
177
- <!-- /microi-progressive:chunk -->
178
- <!-- microi-progressive:chunk id=v8-crud-api-012 sha256=9ddaf59ae87f41e640674a98efe47cee9d9a614b68e32003d229e16d48056609 -->
179
- ## 请求内异步与后台处理
180
-
181
- ```javascript
182
- // 本次请求必须拿到结果时,使用真实Async API并await
183
- var resp = await V8.Http.PostResponseAsync({
184
- Url: 'https://other.com/notify',
185
- PostParam: { Id: V8.Param.id },
186
- Timeout: 10
187
- });
188
- return resp.StatusCode >= 200 && resp.StatusCode < 300
189
- ? { Code: 1 }
190
- : { Code: 0, Msg: '通知失败' };
191
- ```
192
-
193
- 禁止用 `setTimeout` / `Task.Run` 实现“立即返回、后台继续”:接口返回后 Jint Engine、租户上下文、事务和执行租约会释放。脱离请求的任务使用后台任务、Job、MQ 或 outbox,并按 `EventId` 幂等处理与恢复。
194
-
195
- <!-- /microi-progressive:chunk -->
196
- <!-- microi-progressive:chunk id=v8-crud-api-013 sha256=6af864eb1b50594c3c0dcae5e550e51bd65e58b5cd1cb792e2dc7cda39432e5f -->
197
- ## 动态加字段(运行时改表结构)
198
-
199
- ```javascript
200
- V8.FormEngine.AddField({
201
- TableName: 'diy_test',
202
- Name: 'Age',
203
- Type: 'int', // 仅使用平台允许的varchar(N)/mediumtext/longtext/int/bigint/decimal(18,N)
204
- Label: '年龄',
205
- Component: 'NumberText',
206
- TableWidth: '100',
207
- Visible: 1
208
- });
209
- ```
210
-
211
- > 风险:会执行 DDL(ALTER TABLE)。仅在低代码自定义配置场景使用,业务运行时**不要**频繁调用。
212
-
213
- 日期时间字段统一使用 `varchar(25)` 保存 `yyyy-MM-dd HH:mm:ss`,组件使用 `DateTime`。禁止 `datetime/date/timestamp/float/double/boolean/string/text/nvarchar` 等平台不允许的物理类型。动态表/字段属于控制面能力,只允许 `Level >= 9999` 的可信管理脚本使用。
214
-
215
- <!-- /microi-progressive:chunk -->
216
- <!-- microi-progressive:chunk id=v8-crud-api-014 sha256=c2d308a122ce6bb284fef1cecc98aabb861cafcd7b2f6c8e12cfda664fdb359f -->
217
- ## 旧版 _Where 兼容
218
-
219
- ```javascript
220
- // 老版本前端 / 老接口可能传旧格式 _Where:[{ Name, Value, Type, AndOr, Group }, ...]
221
- // 转换成新格式:
222
- var newWhere = V8.Method.ParseWhere(V8.Param._Where);
223
- V8.FormEngine.GetTableData('Table', { _Where: newWhere });
224
- ```
225
-
226
- <!-- /microi-progressive:chunk -->
1
+ # v8-crud-api 详细参考 1
2
+
3
+ > 按需读取;本文件由 SKILL.md 的原章节无损拆分。
4
+
5
+ <!-- microi-progressive:chunk id=v8-crud-api-007 sha256=66648d1a9ca67cc9cb1cdc0dd231f73c61723fbc48fc197cbd74ba6a2cde4319 -->
6
+ ## 查询列表(分页)
7
+
8
+ ```javascript
9
+ var result = V8.FormEngine.GetTableData('SysUser', {
10
+ _Where: [
11
+ ['Status', '=', 1],
12
+ ['AND', 'Name', 'Like', V8.Param.keyword || '']
13
+ ],
14
+ _SelectFields: ['Id', 'Account', 'Name', 'Phone', 'CreateTime'],
15
+ _OrderBy: 'CreateTime',
16
+ _OrderByType: 'DESC',
17
+ _PageIndex: V8.Param.pageIndex || 1,
18
+ _PageSize: V8.Param.pageSize || 20
19
+ });
20
+
21
+ return { Code: 1, Data: result.Data, DataCount: result.DataCount, Msg: '成功' };
22
+ ```
23
+
24
+ ### 请求内异步查询
25
+
26
+ 后端接口引擎可在本次请求内使用真实异步查询;前端 V8 不使用这个方法名:
27
+
28
+ ```javascript
29
+ var result = await V8.FormEngine.GetTableDataAsync('SysUser', {
30
+ _Where: [['Status', '=', 1]],
31
+ _SelectFields: ['Id', 'Account', 'Name'],
32
+ _PageIndex: 1,
33
+ _PageSize: 20
34
+ });
35
+
36
+ return { Code: 1, Data: result.Data, DataCount: result.DataCount };
37
+ ```
38
+
39
+ 必须 `await` 结果。需要接口先返回、后续再批量处理时,应改用平台后台任务、Job、MQ 或 outbox,而不是丢弃 Promise。
40
+
41
+ ### 多字段排序
42
+
43
+ ```javascript
44
+ var result = V8.FormEngine.GetTableData('SysUser', {
45
+ _Where: [['Status', '=', 1]],
46
+ _OrderBys: { 'CreateTime': 'desc', 'Name': 'asc' }
47
+ });
48
+ ```
49
+
50
+ ### 匿名查询(无需登录)
51
+
52
+ ```javascript
53
+ var result = V8.FormEngine.GetTableDataAnonymous('Article', {
54
+ _Where: [['IsPublished', '=', 1]],
55
+ _PageSize: 10
56
+ });
57
+ ```
58
+
59
+ 匿名新增的公开入口是
60
+ `POST /api/formengine/AddFormDataAnonymous`,且目标表必须显式允许匿名新增。
61
+ 当前后端 `V8.FormEngine` 接口不公开
62
+ `V8.FormEngine.AddFormDataAnonymous`;接口引擎内部仍使用
63
+ `V8.FormEngine.AddFormData(...)` 并遵守可信执行身份。不要仅因为历史文档出现
64
+ 该名称就为匿名业务接口关闭服务端校验。
65
+
66
+ ### 获取树形数据
67
+
68
+ ```javascript
69
+ // 表单属性需开启【树形结构】
70
+ var result = V8.FormEngine.GetTableDataTree('Department', {});
71
+ ```
72
+
73
+ ### 仅获取数据条数
74
+
75
+ ```javascript
76
+ var result = V8.FormEngine.GetTableDataCount('SysUser', {
77
+ _Where: [['Status', '=', 1]]
78
+ });
79
+ // result.DataCount 为总数
80
+ ```
81
+
82
+ <!-- /microi-progressive:chunk -->
83
+ <!-- microi-progressive:chunk id=v8-crud-api-008 sha256=3ac0bc88bec40eb1a24e0d4829fae58094760efd3a5b77d1cc52d87c5931a58b -->
84
+ ## 更新
85
+
86
+ ```javascript
87
+ if (!V8.Param.Id) {
88
+ return { Code: 0, Msg: 'Id 不能为空' };
89
+ }
90
+
91
+ var result = V8.FormEngine.UptFormData('SysUser', {
92
+ Id: V8.Param.Id, // 必传
93
+ Name: V8.Param.Name,
94
+ Phone: V8.Param.Phone,
95
+ _NotSaveField: ['Account'], // 可选:忽略这些字段不更新
96
+ _NoLineForAdd: true, // 可选:数据不存在时自动插入
97
+ _ForceUpt: true // 可选:强制修改自动编号字段
98
+ });
99
+
100
+ return { Code: result.Code, Msg: result.Code === 1 ? '更新成功' : result.Msg };
101
+ ```
102
+
103
+ ### 批量更新
104
+
105
+ ```javascript
106
+ var uptList = [];
107
+ for (var i = 0; i < V8.Param.items.length; i++) {
108
+ uptList.push({
109
+ FormEngineKey: 'SysUser',
110
+ Id: V8.Param.items[i].Id,
111
+ Status: V8.Param.items[i].Status
112
+ });
113
+ }
114
+ V8.FormEngine.UptTableData(uptList);
115
+ ```
116
+
117
+ <!-- /microi-progressive:chunk -->
118
+ <!-- microi-progressive:chunk id=v8-crud-api-009 sha256=70e57be16e8676712be6910bfe9d50b87482d02cbbe0ab18a397a58f70916dae -->
119
+ ## 删除
120
+
121
+ ```javascript
122
+ // 删除单条
123
+ var result = V8.FormEngine.DelFormData('SysUser', { Id: V8.Param.Id });
124
+
125
+ // 批量删除(传 Ids 数组)
126
+ var result = V8.FormEngine.DelFormData('SysUser', { Ids: V8.Param.Ids });
127
+
128
+ return { Code: result.Code, Msg: result.Code === 1 ? '删除成功' : result.Msg };
129
+ ```
130
+
131
+ ### 批量删除(跨表)
132
+
133
+ ```javascript
134
+ var delList = [];
135
+ delList.push({ FormEngineKey: 'OrderDetail', Id: V8.Param.detailId });
136
+ delList.push({ FormEngineKey: 'OrderHeader', Id: V8.Param.orderId });
137
+ V8.FormEngine.DelTableData(delList);
138
+ ```
139
+
140
+ <!-- /microi-progressive:chunk -->
141
+ <!-- microi-progressive:chunk id=v8-crud-api-010 sha256=620f7edf12046f4cc4f7142b9e8dbae4495d826b38efb97abdf36fde4206e7d4 -->
142
+ ## 按条件批量操作
143
+
144
+ ```javascript
145
+ // 按条件更新
146
+ V8.FormEngine.UptFormDataByWhere('SysUser', {
147
+ _Where: [['DeptId', '=', V8.Param.deptId]],
148
+ Status: 0,
149
+ _NoLineForAdd: true // 可选:不存在时插入
150
+ });
151
+
152
+ // 按条件删除(不支持 _Where 以外的删除方式)
153
+ V8.FormEngine.DelFormDataByWhere('SysUser', {
154
+ _Where: [['Status', '=', 0], ['AND', 'CreateTime', '<', '2024-01-01']]
155
+ });
156
+ ```
157
+
158
+ <!-- /microi-progressive:chunk -->
159
+ <!-- microi-progressive:chunk id=v8-crud-api-011 sha256=8bfaf89705627a0c0dd1a7723c09832cb00a1206910e3ed70ebdbde7ffa832f4 -->
160
+ ## 事务处理
161
+
162
+ ```javascript
163
+ // 接口引擎中 V8.Db 自动开启事务:
164
+ // 返回DosResult/带Code对象:仅Code=1提交,其他值回滚
165
+ // 返回对象但没有Code:回滚
166
+ // 返回字符串/数字/数组/布尔/null且未异常:提交
167
+ // 手动调用 V8.DbTrans.Commit() 或 Rollback() 无效,由平台统一管理
168
+
169
+ // FormEngine 可传入事务对象(第三个参数)
170
+ V8.FormEngine.AddFormData('Table1', { Name: '测试' }, V8.DbTrans);
171
+ V8.FormEngine.UptFormData('Table2', { Id: 'xxx', Status: 1 }, V8.DbTrans);
172
+
173
+ // 调用其他接口引擎也可共享事务
174
+ V8.ApiEngine.Run('other-engine-key', { Id: 'xxx' }, V8.DbTrans);
175
+ ```
176
+
177
+ <!-- /microi-progressive:chunk -->
178
+ <!-- microi-progressive:chunk id=v8-crud-api-012 sha256=9ddaf59ae87f41e640674a98efe47cee9d9a614b68e32003d229e16d48056609 -->
179
+ ## 请求内异步与后台处理
180
+
181
+ ```javascript
182
+ // 本次请求必须拿到结果时,使用真实Async API并await
183
+ var resp = await V8.Http.PostResponseAsync({
184
+ Url: 'https://other.com/notify',
185
+ PostParam: { Id: V8.Param.id },
186
+ Timeout: 10
187
+ });
188
+ return resp.StatusCode >= 200 && resp.StatusCode < 300
189
+ ? { Code: 1 }
190
+ : { Code: 0, Msg: '通知失败' };
191
+ ```
192
+
193
+ 禁止用 `setTimeout` / `Task.Run` 实现“立即返回、后台继续”:接口返回后 Jint Engine、租户上下文、事务和执行租约会释放。脱离请求的任务使用后台任务、Job、MQ 或 outbox,并按 `EventId` 幂等处理与恢复。
194
+
195
+ <!-- /microi-progressive:chunk -->
196
+ <!-- microi-progressive:chunk id=v8-crud-api-013 sha256=6af864eb1b50594c3c0dcae5e550e51bd65e58b5cd1cb792e2dc7cda39432e5f -->
197
+ ## 动态加字段(运行时改表结构)
198
+
199
+ ```javascript
200
+ V8.FormEngine.AddField({
201
+ TableName: 'diy_test',
202
+ Name: 'Age',
203
+ Type: 'int', // 仅使用平台允许的varchar(N)/mediumtext/longtext/int/bigint/decimal(18,N)
204
+ Label: '年龄',
205
+ Component: 'NumberText',
206
+ TableWidth: '100',
207
+ Visible: 1
208
+ });
209
+ ```
210
+
211
+ > 风险:会执行 DDL(ALTER TABLE)。仅在低代码自定义配置场景使用,业务运行时**不要**频繁调用。
212
+
213
+ 日期时间字段统一使用 `varchar(25)` 保存 `yyyy-MM-dd HH:mm:ss`,组件使用 `DateTime`。禁止 `datetime/date/timestamp/float/double/boolean/string/text/nvarchar` 等平台不允许的物理类型。动态表/字段属于控制面能力,只允许 `Level >= 9999` 的可信管理脚本使用。
214
+
215
+ <!-- /microi-progressive:chunk -->
216
+ <!-- microi-progressive:chunk id=v8-crud-api-014 sha256=c2d308a122ce6bb284fef1cecc98aabb861cafcd7b2f6c8e12cfda664fdb359f -->
217
+ ## 旧版 _Where 兼容
218
+
219
+ ```javascript
220
+ // 老版本前端 / 老接口可能传旧格式 _Where:[{ Name, Value, Type, AndOr, Group }, ...]
221
+ // 转换成新格式:
222
+ var newWhere = V8.Method.ParseWhere(V8.Param._Where);
223
+ V8.FormEngine.GetTableData('Table', { _Where: newWhere });
224
+ ```
225
+
226
+ <!-- /microi-progressive:chunk -->
@@ -1,49 +1,49 @@
1
- # v8-crud-api 详细参考 2
2
-
3
- > 按需读取;本文件由 SKILL.md 的原章节无损拆分。
4
-
5
- <!-- microi-progressive:chunk id=v8-crud-api-015 sha256=75eb96d81537ac44c7bca1a97a557c427baa198434cfab003e91982b8b81c419 -->
6
- ## _Where 条件语法速查
7
-
8
- ```javascript
9
- // 等于
10
- [['Field', '=', value]]
11
-
12
- // 模糊查询
13
- [['Name', 'Like', '张']] // %张%
14
- [['Name', 'StartLike', '张']] // 张%
15
- [['Name', 'EndLike', '三']] // %三
16
-
17
- // AND / OR
18
- [['A', '=', 1], ['AND', 'B', '>', 10]]
19
- [['A', '=', 1], ['OR', 'B', '=', 2]]
20
-
21
- // IN / NotIn
22
- [['Id', 'In', ['id1', 'id2', 'id3']]]
23
- [['Status', 'NotIn', [0, -1]]]
24
-
25
- // NULL
26
- [['Field', '=', null]] // IS NULL
27
- [['Field', '<>', null]] // IS NOT NULL
28
-
29
- // 分组(括号)
30
- [['Name', 'Like', '张'], ['AND', '(', 'Age', '>', 18], ['OR', 'Status', '=', 1, ')']]
31
-
32
- // 日期范围
33
- [['CreateTime', '>=', '2024-01-01'], ['AND', 'CreateTime', '<', '2024-02-01']]
34
- ```
35
-
36
- **支持的操作符:** `=`, `==`, `<>`, `!=`, `>`, `>=`, `<`, `<=`, `Like`, `NotLike`, `StartLike`, `EndLike`, `In`, `NotIn`
37
-
38
- <!-- /microi-progressive:chunk -->
39
- <!-- microi-progressive:chunk id=v8-crud-api-016 sha256=820f49da26c6be5baa52520152780fc155ed84e747e89a1f50b954d3112fa202 -->
40
- ## 注意事项
41
-
42
- - `_Where` 是参数化查询,自动防 SQL 注入,**不要拼接 SQL 字符串**
43
- - `AddFormData` 不需要传 `Id`,后端自动生成 GUID
44
- - `UptFormData` 必须包含 `Id` 字段
45
- - 如需触发表单 V8 事件,在参数中加 `_InvokeType: 'Client'`
46
- - 返回值中 `Code: 1` 表示成功,`Code: 0` 表示失败,`Code: 2` 表示数据不存在
47
- - 分页参数使用 `_PageIndex` 和 `_PageSize`(带下划线前缀)
48
- - 列表返回总数字段为 `result.DataCount`(非 Total)
49
- <!-- /microi-progressive:chunk -->
1
+ # v8-crud-api 详细参考 2
2
+
3
+ > 按需读取;本文件由 SKILL.md 的原章节无损拆分。
4
+
5
+ <!-- microi-progressive:chunk id=v8-crud-api-015 sha256=75eb96d81537ac44c7bca1a97a557c427baa198434cfab003e91982b8b81c419 -->
6
+ ## _Where 条件语法速查
7
+
8
+ ```javascript
9
+ // 等于
10
+ [['Field', '=', value]]
11
+
12
+ // 模糊查询
13
+ [['Name', 'Like', '张']] // %张%
14
+ [['Name', 'StartLike', '张']] // 张%
15
+ [['Name', 'EndLike', '三']] // %三
16
+
17
+ // AND / OR
18
+ [['A', '=', 1], ['AND', 'B', '>', 10]]
19
+ [['A', '=', 1], ['OR', 'B', '=', 2]]
20
+
21
+ // IN / NotIn
22
+ [['Id', 'In', ['id1', 'id2', 'id3']]]
23
+ [['Status', 'NotIn', [0, -1]]]
24
+
25
+ // NULL
26
+ [['Field', '=', null]] // IS NULL
27
+ [['Field', '<>', null]] // IS NOT NULL
28
+
29
+ // 分组(括号)
30
+ [['Name', 'Like', '张'], ['AND', '(', 'Age', '>', 18], ['OR', 'Status', '=', 1, ')']]
31
+
32
+ // 日期范围
33
+ [['CreateTime', '>=', '2024-01-01'], ['AND', 'CreateTime', '<', '2024-02-01']]
34
+ ```
35
+
36
+ **支持的操作符:** `=`, `==`, `<>`, `!=`, `>`, `>=`, `<`, `<=`, `Like`, `NotLike`, `StartLike`, `EndLike`, `In`, `NotIn`
37
+
38
+ <!-- /microi-progressive:chunk -->
39
+ <!-- microi-progressive:chunk id=v8-crud-api-016 sha256=820f49da26c6be5baa52520152780fc155ed84e747e89a1f50b954d3112fa202 -->
40
+ ## 注意事项
41
+
42
+ - `_Where` 是参数化查询,自动防 SQL 注入,**不要拼接 SQL 字符串**
43
+ - `AddFormData` 不需要传 `Id`,后端自动生成 GUID
44
+ - `UptFormData` 必须包含 `Id` 字段
45
+ - 如需触发表单 V8 事件,在参数中加 `_InvokeType: 'Client'`
46
+ - 返回值中 `Code: 1` 表示成功,`Code: 0` 表示失败,`Code: 2` 表示数据不存在
47
+ - 分页参数使用 `_PageIndex` 和 `_PageSize`(带下划线前缀)
48
+ - 列表返回总数字段为 `result.DataCount`(非 Total)
49
+ <!-- /microi-progressive:chunk -->