@microi.net/cli 5.7.8 → 5.8.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 (189) 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 +6 -6
  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 +113 -112
  15. package/scripts/microi-cli.js +57 -57
  16. package/scripts/microi-codex-broker.js +450 -450
  17. package/scripts/microi-codex-router.js +0 -0
  18. package/scripts/microi-skills.meta.json +364 -364
  19. package/skills/.microi-skills-version.json +2 -2
  20. package/skills/README.md +286 -286
  21. package/skills/ai-engine/SKILL.md +265 -265
  22. package/skills/ai-engine/agents/openai.yaml +4 -4
  23. package/skills/ai-platform-governance/SKILL.md +177 -177
  24. package/skills/ai-platform-governance/references/progressive-01-/345/212/237/350/203/275/345/274/200/345/205/263.md +190 -190
  25. package/skills/app-store/SKILL.md +396 -396
  26. package/skills/app-store/agents/openai.yaml +4 -4
  27. package/skills/business-blueprint/SKILL.md +193 -193
  28. package/skills/datasource-engine/SKILL.md +90 -90
  29. package/skills/datasource-engine/agents/openai.yaml +4 -4
  30. package/skills/dos-orm/references/api-reference.md +229 -229
  31. package/skills/email-engine/SKILL.md +78 -78
  32. package/skills/email-engine/references/v8-email.md +34 -34
  33. package/skills/job-engine/SKILL.md +172 -172
  34. package/skills/job-engine/agents/openai.yaml +4 -4
  35. package/skills/message-notification/SKILL.md +156 -156
  36. package/skills/message-notification/agents/openai.yaml +5 -5
  37. package/skills/message-notification/references/contracts.md +102 -102
  38. package/skills/microi-ai-app-auth.js +652 -652
  39. package/skills/microi-ai-application/SKILL.md +106 -106
  40. package/skills/microi-ai-application/agents/openai.yaml +4 -4
  41. package/skills/microi-ai-application/references/frontend-baseline.md +164 -164
  42. package/skills/microi-client-frontend/SKILL.md +237 -237
  43. 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
  44. 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
  45. 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
  46. package/skills/microi-codex/SKILL.md +72 -70
  47. package/skills/microi-codex-installer/SKILL.md +225 -223
  48. package/skills/microi-codex-installer/agents/openai.yaml +7 -7
  49. package/skills/microi-datasource-mapping/SKILL.md +108 -108
  50. package/skills/microi-db-schema/SKILL.md +175 -175
  51. package/skills/microi-db-schema/agents/openai.yaml +4 -4
  52. package/skills/microi-db-schema/references/core-tables.md +695 -695
  53. package/skills/microi-db-schema/references/form-component-options.md +256 -256
  54. package/skills/microi-db-schema/references/schema-overview.md +202 -202
  55. package/skills/microi-db-schema/references/schema.md +646 -646
  56. package/skills/microi-db-schema/references/table-catalog.md +1599 -1599
  57. package/skills/microi-deployment/references/deployment-matrix.md +101 -101
  58. package/skills/microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs +894 -894
  59. package/skills/microi-form-engine/SKILL.md +226 -226
  60. package/skills/microi-form-engine/references/component-catalog.md +216 -216
  61. package/skills/microi-form-engine/references/data-source-events.md +124 -124
  62. package/skills/microi-form-layout/SKILL.md +205 -205
  63. 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
  64. package/skills/microi-frontend-sdk/SKILL.md +188 -188
  65. 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
  66. package/skills/microi-left-right-layout/SKILL.md +141 -141
  67. package/skills/microi-microservice/SKILL.md +323 -323
  68. package/skills/microi-microservice/references/runtime-delivery.md +278 -278
  69. package/skills/microi-mobile-app-quality/SKILL.md +181 -181
  70. 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
  71. 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
  72. package/skills/microi-solution-quotation/SKILL.md +78 -78
  73. package/skills/microi-solution-quotation/agents/openai.yaml +4 -4
  74. package/skills/microi-solution-quotation/scripts/build_solution_quote.py +296 -296
  75. package/skills/microi-sso/references/acceptance.md +49 -49
  76. package/skills/microi-sso/references/configuration-and-security.md +53 -53
  77. package/skills/microi-sso/references/inbound.md +53 -53
  78. package/skills/microi-sso/references/outbound.md +39 -39
  79. package/skills/microi-system-delivery/SKILL.md +134 -134
  80. 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
  81. 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 +189 -189
  82. package/skills/microi-ui/SKILL.md +174 -174
  83. 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
  84. package/skills/microi-uniapp-frontend/SKILL.md +193 -193
  85. 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
  86. 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
  87. package/skills/microi.v8.js +1921 -1921
  88. package/skills/module-engine/SKILL.md +250 -250
  89. package/skills/module-engine/references/module-config.md +204 -204
  90. package/skills/ocr-engine/SKILL.md +113 -113
  91. package/skills/ocr-engine/agents/openai.yaml +4 -4
  92. package/skills/page-engine/SKILL.md +182 -182
  93. 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
  94. 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
  95. package/skills/performance-testing/SKILL.md +221 -221
  96. package/skills/playwright-e2e/SKILL.md +197 -197
  97. 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
  98. 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
  99. package/skills/playwright-e2e/references/progressive-03-microi-helper-/346/250/241/346/235/277.md +221 -221
  100. package/skills/playwright-e2e/references/progressive-04-ci-/345/273/272/350/256/256.md +115 -115
  101. package/skills/print-engine/SKILL.md +259 -259
  102. package/skills/production-readonly-audit/SKILL.md +41 -41
  103. package/skills/report-engine/SKILL.md +71 -71
  104. package/skills/report-engine/agents/openai.yaml +4 -4
  105. package/skills/scripts/optimize-progressive-disclosure.mjs +204 -204
  106. package/skills/scripts/refresh-progressive-disclosure.mjs +64 -64
  107. package/skills/search-engine/SKILL.md +75 -75
  108. package/skills/search-engine/agents/openai.yaml +4 -4
  109. package/skills/spider-engine/SKILL.md +190 -190
  110. package/skills/system-observability/SKILL.md +238 -238
  111. package/skills/system-observability/references/memory-incident-triage.md +70 -70
  112. package/skills/translate-engine/SKILL.md +140 -140
  113. package/skills/translate-engine/agents/openai.yaml +4 -4
  114. package/skills/ui-design/SKILL.md +191 -191
  115. package/skills/ui-design/assets/templates/MCI-DESIGN.md +198 -198
  116. package/skills/ui-design/references/design-pattern-library.md +184 -184
  117. package/skills/ui-design/references/mci-design-contract.md +163 -163
  118. 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
  119. package/skills/ui-design/references/progressive-02-/345/255/227/344/275/223.md +137 -137
  120. 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
  121. 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
  122. 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
  123. 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
  124. 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
  125. 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 +117 -117
  126. package/skills/uniapp-mall-assets/SKILL.md +176 -176
  127. package/skills/unity-integration/SKILL.md +155 -155
  128. package/skills/unity-integration/agents/openai.yaml +4 -4
  129. package/skills/unity-integration/references/ai-app-delivery.md +103 -103
  130. package/skills/unity-integration/references/sdk-api.md +82 -82
  131. package/skills/unity-integration/references/toolbox-migration.md +66 -66
  132. package/skills/unity-integration/references/webgl-hosting.md +57 -57
  133. package/skills/v8-cache-pattern/SKILL.md +306 -306
  134. package/skills/v8-crud-api/SKILL.md +175 -175
  135. 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
  136. 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
  137. package/skills/v8-debugging/SKILL.md +284 -284
  138. package/skills/v8-explorer-tree/SKILL.md +228 -228
  139. package/skills/v8-export-import/SKILL.md +209 -209
  140. 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
  141. package/skills/v8-export-import/references/progressive-02-powerpoint-/345/257/274/345/207/272.md +202 -202
  142. 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
  143. package/skills/v8-file-upload/SKILL.md +263 -263
  144. 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 +101 -101
  145. 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 +150 -150
  146. package/skills/v8-formengine-http/SKILL.md +219 -219
  147. package/skills/v8-frontend-events/SKILL.md +178 -178
  148. package/skills/v8-frontend-events/references/bluetooth-print-api.md +135 -135
  149. package/skills/v8-frontend-events/references/bluetooth-print.md +246 -246
  150. package/skills/v8-frontend-events/references/progressive-01-/345/210/227/350/241/250/344/272/213/344/273/266.md +219 -219
  151. package/skills/v8-http-integration/SKILL.md +182 -182
  152. package/skills/v8-http-integration/references/progressive-01-get-/350/257/267/346/261/202.md +220 -220
  153. 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
  154. package/skills/v8-image-processing/SKILL.md +190 -190
  155. package/skills/v8-image-processing/agents/openai.yaml +4 -4
  156. package/skills/v8-image-processing/references/api-reference.md +623 -623
  157. package/skills/v8-menu-buttons/SKILL.md +180 -180
  158. 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
  159. 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
  160. 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
  161. package/skills/v8-mongodb/SKILL.md +192 -192
  162. package/skills/v8-mq-mqtt/SKILL.md +176 -176
  163. package/skills/v8-mq-mqtt/references/mqtt-production.md +342 -342
  164. package/skills/v8-mq-mqtt/references/progressive-01-v8-mqtt-iot-/347/211/251/350/201/224/347/275/221.md +181 -181
  165. package/skills/v8-mq-mqtt/scripts/check-mqtt-skill-coverage.mjs +203 -203
  166. package/skills/v8-saas-multi-tenant/SKILL.md +219 -219
  167. package/skills/v8-security/SKILL.md +168 -168
  168. package/skills/v8-security/references/progressive-01-2-/346/235/203/351/231/220/346/240/241/351/252/214.md +198 -198
  169. package/skills/v8-security/references/progressive-02-7-/346/227/245/345/277/227/350/256/260/345/275/225.md +158 -158
  170. package/skills/v8-sql-query/SKILL.md +302 -302
  171. package/skills/v8-table-event/SKILL.md +144 -144
  172. 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 +197 -197
  173. 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
  174. package/skills/v8-tcp-integration/SKILL.md +147 -147
  175. package/skills/v8-tcp-integration/agents/openai.yaml +4 -4
  176. package/skills/v8-template-engine/SKILL.md +167 -167
  177. package/skills/v8-utilities/SKILL.md +90 -90
  178. package/skills/v8-utilities/references/client-api-index.md +143 -143
  179. package/skills/v8-utilities/references/platform-http-routes.md +83 -83
  180. package/skills/v8-utilities/references/server-api-index.md +188 -188
  181. package/skills/v8-workflow/SKILL.md +243 -243
  182. 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
  183. package/skills/vision-engine/SKILL.md +159 -159
  184. package/skills/vision-engine/agents/openai.yaml +4 -4
  185. package/skills/vision-engine/references/architecture-and-acceptance.md +194 -194
  186. package/skills/workspace-conventions/SKILL.md +261 -261
  187. 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 +208 -208
  188. 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 +216 -216
  189. 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,222 +1,222 @@
1
- # v8-menu-buttons 详细参考 1
2
-
3
- > 按需读取;本文件由 SKILL.md 的原章节无损拆分。
4
-
5
- <!-- microi-progressive:chunk id=v8-menu-buttons-004 sha256=c936a3246ce8148f77f98dfb5d8d0f0be4b87de63310dfd7ac84c2725707d3ea -->
6
- ## 2. 按钮对象 Schema
7
-
8
- ```jsonc
9
- {
10
- "Id": "01K...", // ULID 或 GUID,必填且唯一
11
- "Sort": 0, // 排序
12
- "Name": "指派", // 中文按钮名
13
- "Icon": "fas fa-user", // 可选,FontAwesome 类名
14
- "BtnStyle": "primary", // primary | success | warning | danger | (空)
15
- "IsVisible": true, // 是否参与渲染(false 则完全隐藏)
16
- "ShowRow": true, // MoreBtns 必填:true 显示在行内,false 收进"更多"
17
- "V8CodeShow": "...", // 显隐表达式 JS:return true/false 或赋值 V8.Result=true/false
18
- "V8Code": "...", // 点击执行的 JS(前端 V8 上下文)
19
- "Url": "", // 可选:直接跳转 URL(不与 V8Code 同用)
20
- "TargetSysMenuId": "", // 仅 PageTabs:关联另一个 sys_menu.Id,替换路由并完整加载目标模块
21
- "RunBackground": false, // 可选:true 时以后台任务执行接口引擎
22
- "BackgroundTask": false, // 可选:兼容别名
23
- "IsBackgroundTask": false, // 可选:兼容别名
24
- "ApiEngineKey": "", // 可选:后台任务要执行的接口引擎 Key
25
- "BadgeEnabled": true, // 可选:显示统计角标
26
- "BadgeApiEngineKey": "button_counts",
27
- "BadgeValuePath": "", // 可选:如 Data.Rows.{RowId}.button-id
28
- "BadgeField": "", // 行按钮读当前行;PageTab/页面按钮读模块 StatisticsFields,不请求接口
29
- "BadgeTone": "primary", // primary/success/warning/danger/info
30
- "BadgeMax": 99,
31
- "BadgeShowZero": false,
32
- "BadgeRefreshSeconds": 60
33
- }
34
- ```
35
-
36
- ### 统计角标接口契约
37
-
38
- 角标适用于附件数、日志数、未处理子记录等“点击按钮后有明确行动”的数量。
39
- `PageTabs/MoreBtns/PageBtns/BatchSelectMoreBtns/ExportMoreBtns/FormBtns` 都可配置。前端按不同
40
- `BadgeApiEngineKey` 分组,每个接口仅调用一次,并传入 `Ids`(当前页行 Id)、
41
- `ButtonKeys`、`SysMenuId/_SysMenuId`、`DiyTableId` 和筛选上下文。
42
-
43
- 推荐一次返回页面级与逐行结果:
44
-
45
- ```js
46
- return {
47
- Code: 1,
48
- Data: {
49
- Buttons: { 'button-id': 12 },
50
- Rows: {
51
- 'row-id-1': { 'button-id': 2 },
52
- 'row-id-2': { 'button-id': 0 }
53
- }
54
- }
55
- };
56
- ```
57
-
58
- 按钮和 PageTab 必须有稳定 `Id`,否则只能回退用 `Name` 匹配。`Data.Buttons` 同时用于页面按钮和 PageTabs;页签可通过 `BadgeValuePath=Data.Buttons.{TabId}` 显式取值。PageTabs/页面按钮若使用 `BadgeField`,必须同时把该字段加入模块 `StatisticsFields`,读取页面汇总值。不要在按钮 V8、Tab V8、模板引擎或每行
59
- 生命周期里单独查数量;后端应按 `Ids` 批量 `GROUP BY`,并继续应用租户、菜单和数据权限。
60
- 统计失败只隐藏角标,不能阻断按钮本身或 PageTab 切换。
61
-
62
- ### JsonTable 内嵌选择器的数据源代理
63
-
64
- `PageTabs/MoreBtns/PageBtns/BatchSelectMoreBtns/ExportMoreBtns/FormBtns` 都是 `JsonTable` 字段,
65
- 其中的列对象不是独立 `diy_field`。内嵌 `Select/Radio/Checkbox/Autocomplete/Cascader/SelectTree`
66
- 一旦使用 `Sql/DataSource/ApiEngine` 服务端数据源,必须在列的 `Config.DataSourceFieldId` 中填写
67
- 同租户、同表内一个真实且权限等价的 `diy_field.Id`。禁止把内嵌列的 `Key` 或列 `Id` 当成
68
- 字段 Id,否则打开“模块设计-按钮”时会触发“DiyField 数据不存在”,并使同批字段数据加载失败。
69
-
70
- 远程 SQL 搜索还应同时设置 `DataSourceSqlRemote=true`,使用 `$Keyword$` 参数并限制返回条数;
71
- 应用包回归测试必须逐个校验所有按钮集合的代理字段真实存在、保存字段/显示字段一致。
72
-
73
- ### PageTabs 关联模块
74
-
75
- - 列表页固定顺序为“模块 Hero(标题/副标题/动态指标)→ PageTabs → 查询与表格”;PageTabs 不能渲染到 Hero 上方,也不能重复承担模块标题。
76
- - `TargetSysMenuId` 为空时,页签仍在当前模块执行 `V8Code` 和重新查询。
77
- - `TargetSysMenuId` 指向其它模块时,点击会在当前 `diy-table` 实例内加载目标模块自己的表单引擎、字段、查询接口替换、按钮和分页配置;入口路由、面包屑、顶部访问标签和宿主 Hero 不变,URL 只更新 `Tab` 查询参数。
78
- - 目标模块可以设置 `Display=0、AppDisplay=0` 隐藏左侧菜单,但必须给使用角色分配菜单权限,否则动态路由中找不到目标模块。
79
- - 一组 PageTabs 只保存在入口模块;隐藏目标模块设置 `ParentId=入口菜单Id、HasChild=0、PageTabs=[]`,不得复制同一套 PageTabs。入口菜单保持 `HasChild=0`,仍然直接打开业务页面。
80
- - 模块设计器的 PageTabs 必须显示【关联模块】可搜索菜单树,展示模块名称并保存 `TargetSysMenuId`,不能让该协议只能手工改 JSON。
81
- - 禁止在 `diy-table` 或 mixin 中按模块名、Url、表名写死页签数据源。
82
-
83
- ### V8CodeShow(显隐控制)—— 支持 `return` 和 `V8.Result`
84
-
85
- 未配置 `V8CodeShow`,或代码执行后既没有 `return true/false`、也没有设置
86
- `V8.Result = true/false` 时,显示条件默认按“显示”处理;只有明确
87
- `return false` 或 `V8.Result = false` 才由显示条件隐藏按钮。角色按钮权限仍是
88
- 独立约束,不应通过省略显示条件绕过。
89
-
90
- 推荐写法:直接返回布尔值。
91
-
92
- ```js
93
- // 仅当状态为"待指派"且无负责人时显示
94
- return V8.Form.Status == '待指派' && !V8.Form.AssigneeId;
95
- ```
96
-
97
- 兼容旧写法:给 `V8.Result` 赋布尔值。
98
-
99
- ```js
100
- // 仅当状态为"待指派"且无负责人时显示
101
- if (V8.Form.Status == '待指派' && !V8.Form.AssigneeId) {
102
- V8.Result = true;
103
- } else {
104
- V8.Result = false;
105
- }
106
- ```
107
-
108
- ### V8Code 上下文常用变量
109
- | 变量 | 说明 |
110
- |------|------|
111
- | `V8.Form` | 当前行/表单数据 |
112
- | `V8.FormMode` | `Add` / `Edit` / `View` |
113
- | `V8.TableId` | 当前 diy_table 的 Id |
114
- | `V8.TableRowSelected` | 批量按钮里勾选的行数组 |
115
- | `V8.CurrentUser` | 登录用户 |
116
- | `V8.ClientType` | `PC` / `IOS` / `Android` / `H5` / `WeChat` |
117
- | `V8.Tips(msg, ok?)` | 浮层提示 |
118
- | `V8.ConfirmTips(msg, cb)` | 确认弹窗 |
119
- | `V8.RefreshTable({_PageIndex:1})` | 刷新列表 |
120
- | `V8.SearchSet({Field:value})` | 设置/重置筛选条件(PageTabs 常用)|
121
- | `V8.OpenAnyForm({...})` | 弹出任意表单(核心:可替换提交事件)|
122
- | `V8.OpenAppDialog({...})` | 按 AppKey 打开已发布在线微服务定制页 |
123
- | `V8.FormSubmit({...})` | 提交当前表单 |
124
- | `V8.FormSet(field, val)` | 普通表单触发目标字段 V8;列表上下文只更新当前行/模板 |
125
- | `V8.ApiEngine.Run({...})` | 调用接口引擎(业务逻辑必走)|
126
- | `V8.ApiEngine.RunBackground(...)` | 启动后台任务(用于安装、导入、初始化等长任务)|
127
-
128
- ### V8Code 格式化强制要求
129
- - AI、MCP、VS Code 插件或脚本生成 `V8Code` / `V8CodeShow` 时,必须保存为可读的多行 JavaScript,包含换行和缩进;禁止把完整逻辑压成一整行。
130
- - 写入 `sys_menu.MoreBtns/FormBtns/PageTabs/BatchSelectMoreBtns` 等 JSON 字符串时,也要先按 `.js` 文件格式组织代码,再通过 `JSON.stringify` 或等价方式转义保存。
131
- - `V8.OpenAnyTable`、`V8.OpenAnyForm`、`V8.ApiEngine.Run`、确认弹窗、回调函数等嵌套结构必须分行,回调内部逻辑至少缩进一级。
132
- - 只允许极短的单表达式显隐代码写成一行,例如 `V8.Result = true;`;一旦包含 `if`、`return`、`function`、`async`、数组/对象字面量或接口调用,就必须多行格式化。
133
-
134
- 格式化示例:
135
- ```js
136
- var projectId = V8.Form && V8.Form.Id ? V8.Form.Id : "";
137
- if (!projectId) {
138
- V8.Tips("缺少项目Id,无法打开关联清单。", false);
139
- return;
140
- }
141
-
142
- V8.OpenAnyTable({
143
- SysMenuId: "01K...",
144
- DialogType: "Drawer",
145
- Width: "80vw",
146
- MultipleSelect: false,
147
- PropsWhere: [
148
- ["XiangmuID", "=", projectId]
149
- ],
150
- SubmitEvent: async function(selectData, callback) {
151
- callback({
152
- Code: 1,
153
- Data: selectData
154
- });
155
- }
156
- });
157
- ```
158
-
159
- ---
160
-
161
- <!-- /microi-progressive:chunk -->
162
- <!-- microi-progressive:chunk id=v8-menu-buttons-005 sha256=ca6d6eb9f75e80f2f0a420ed4b959ed2da879d44b8eedb2bc7a013e13561e1a2 -->
163
- ## 5. 模式 C:状态机推进(无需弹窗)
164
-
165
- ```js
166
- var next = '';
167
- switch (V8.Form.Status) {
168
- case '待完成': next = '待验收'; break;
169
- case '待验收': next = '待评价'; break;
170
- }
171
- if (next) {
172
- var result = await V8.ApiEngine.Run('order_advance_status', {
173
- Id: V8.Form.Id,
174
- ExpectedStatus: V8.Form.Status,
175
- NextStatus: next
176
- });
177
- V8.Tips(result.Code == 1 ? '状态已更新' : result.Msg, result.Code == 1);
178
- if (result.Code == 1) V8.RefreshTable({ _PageIndex: -1 });
179
- }
180
- ```
181
-
182
- 状态机必须由接口引擎校验当前状态、目标状态、权限和并发版本;不要在前端直接更新状态字段。
183
-
184
- <!-- /microi-progressive:chunk -->
185
- <!-- microi-progressive:chunk id=v8-menu-buttons-006 sha256=661e9eda504167d3eaca091ae759d49b8ddae64f5b1b3b7aab20ed31da33750a -->
186
- ## 6. 模式 D:批量操作(BatchSelectMoreBtns)
187
-
188
- ```js
189
- var rows = V8.TableRowSelected;
190
- if (!rows || rows.length == 0) { V8.Tips('请先勾选数据'); return; }
191
- var ids = rows.map(function (r) { return r.Id; });
192
- V8.ConfirmTips('确认删除选中的 ' + ids.length + ' 条?', function () {
193
- V8.ApiEngine.Run('order_batch_delete', {
194
- Ids: ids
195
- }, function (r) {
196
- if (r.Code == 1) { V8.Tips('删除成功'); V8.RefreshTable({ _PageIndex: 1 }); }
197
- else V8.Tips(r.Msg, false);
198
- });
199
- });
200
- ```
201
-
202
- <!-- /microi-progressive:chunk -->
203
- <!-- microi-progressive:chunk id=v8-menu-buttons-007 sha256=03346fa906eccc815f6f5be4ed9c5c0ef8c1cdce22e8aba47576ea258c6113a1 -->
204
- ## 7. 模式 E:PageTabs 切换筛选
205
-
206
- ```js
207
- // PageTab:"待办"
208
- V8.SearchSet({ Status: '待办' });
209
-
210
- // PageTab:"全部"
211
- V8.SearchSet({ Status: '' });
212
- ```
213
-
214
- `V8CodeShow` 控制此 Tab 在哪种端显示:
215
- ```js
216
- // 只在 App 端显示
217
- return V8.ClientType != 'PC';
218
- ```
219
-
220
- ---
221
-
222
- <!-- /microi-progressive:chunk -->
1
+ # v8-menu-buttons 详细参考 1
2
+
3
+ > 按需读取;本文件由 SKILL.md 的原章节无损拆分。
4
+
5
+ <!-- microi-progressive:chunk id=v8-menu-buttons-004 sha256=c936a3246ce8148f77f98dfb5d8d0f0be4b87de63310dfd7ac84c2725707d3ea -->
6
+ ## 2. 按钮对象 Schema
7
+
8
+ ```jsonc
9
+ {
10
+ "Id": "01K...", // ULID 或 GUID,必填且唯一
11
+ "Sort": 0, // 排序
12
+ "Name": "指派", // 中文按钮名
13
+ "Icon": "fas fa-user", // 可选,FontAwesome 类名
14
+ "BtnStyle": "primary", // primary | success | warning | danger | (空)
15
+ "IsVisible": true, // 是否参与渲染(false 则完全隐藏)
16
+ "ShowRow": true, // MoreBtns 必填:true 显示在行内,false 收进"更多"
17
+ "V8CodeShow": "...", // 显隐表达式 JS:return true/false 或赋值 V8.Result=true/false
18
+ "V8Code": "...", // 点击执行的 JS(前端 V8 上下文)
19
+ "Url": "", // 可选:直接跳转 URL(不与 V8Code 同用)
20
+ "TargetSysMenuId": "", // 仅 PageTabs:关联另一个 sys_menu.Id,替换路由并完整加载目标模块
21
+ "RunBackground": false, // 可选:true 时以后台任务执行接口引擎
22
+ "BackgroundTask": false, // 可选:兼容别名
23
+ "IsBackgroundTask": false, // 可选:兼容别名
24
+ "ApiEngineKey": "", // 可选:后台任务要执行的接口引擎 Key
25
+ "BadgeEnabled": true, // 可选:显示统计角标
26
+ "BadgeApiEngineKey": "button_counts",
27
+ "BadgeValuePath": "", // 可选:如 Data.Rows.{RowId}.button-id
28
+ "BadgeField": "", // 行按钮读当前行;PageTab/页面按钮读模块 StatisticsFields,不请求接口
29
+ "BadgeTone": "primary", // primary/success/warning/danger/info
30
+ "BadgeMax": 99,
31
+ "BadgeShowZero": false,
32
+ "BadgeRefreshSeconds": 60
33
+ }
34
+ ```
35
+
36
+ ### 统计角标接口契约
37
+
38
+ 角标适用于附件数、日志数、未处理子记录等“点击按钮后有明确行动”的数量。
39
+ `PageTabs/MoreBtns/PageBtns/BatchSelectMoreBtns/ExportMoreBtns/FormBtns` 都可配置。前端按不同
40
+ `BadgeApiEngineKey` 分组,每个接口仅调用一次,并传入 `Ids`(当前页行 Id)、
41
+ `ButtonKeys`、`SysMenuId/_SysMenuId`、`DiyTableId` 和筛选上下文。
42
+
43
+ 推荐一次返回页面级与逐行结果:
44
+
45
+ ```js
46
+ return {
47
+ Code: 1,
48
+ Data: {
49
+ Buttons: { 'button-id': 12 },
50
+ Rows: {
51
+ 'row-id-1': { 'button-id': 2 },
52
+ 'row-id-2': { 'button-id': 0 }
53
+ }
54
+ }
55
+ };
56
+ ```
57
+
58
+ 按钮和 PageTab 必须有稳定 `Id`,否则只能回退用 `Name` 匹配。`Data.Buttons` 同时用于页面按钮和 PageTabs;页签可通过 `BadgeValuePath=Data.Buttons.{TabId}` 显式取值。PageTabs/页面按钮若使用 `BadgeField`,必须同时把该字段加入模块 `StatisticsFields`,读取页面汇总值。不要在按钮 V8、Tab V8、模板引擎或每行
59
+ 生命周期里单独查数量;后端应按 `Ids` 批量 `GROUP BY`,并继续应用租户、菜单和数据权限。
60
+ 统计失败只隐藏角标,不能阻断按钮本身或 PageTab 切换。
61
+
62
+ ### JsonTable 内嵌选择器的数据源代理
63
+
64
+ `PageTabs/MoreBtns/PageBtns/BatchSelectMoreBtns/ExportMoreBtns/FormBtns` 都是 `JsonTable` 字段,
65
+ 其中的列对象不是独立 `diy_field`。内嵌 `Select/Radio/Checkbox/Autocomplete/Cascader/SelectTree`
66
+ 一旦使用 `Sql/DataSource/ApiEngine` 服务端数据源,必须在列的 `Config.DataSourceFieldId` 中填写
67
+ 同租户、同表内一个真实且权限等价的 `diy_field.Id`。禁止把内嵌列的 `Key` 或列 `Id` 当成
68
+ 字段 Id,否则打开“模块设计-按钮”时会触发“DiyField 数据不存在”,并使同批字段数据加载失败。
69
+
70
+ 远程 SQL 搜索还应同时设置 `DataSourceSqlRemote=true`,使用 `$Keyword$` 参数并限制返回条数;
71
+ 应用包回归测试必须逐个校验所有按钮集合的代理字段真实存在、保存字段/显示字段一致。
72
+
73
+ ### PageTabs 关联模块
74
+
75
+ - 列表页固定顺序为“模块 Hero(标题/副标题/动态指标)→ PageTabs → 查询与表格”;PageTabs 不能渲染到 Hero 上方,也不能重复承担模块标题。
76
+ - `TargetSysMenuId` 为空时,页签仍在当前模块执行 `V8Code` 和重新查询。
77
+ - `TargetSysMenuId` 指向其它模块时,点击会在当前 `diy-table` 实例内加载目标模块自己的表单引擎、字段、查询接口替换、按钮和分页配置;入口路由、面包屑、顶部访问标签和宿主 Hero 不变,URL 只更新 `Tab` 查询参数。
78
+ - 目标模块可以设置 `Display=0、AppDisplay=0` 隐藏左侧菜单,但必须给使用角色分配菜单权限,否则动态路由中找不到目标模块。
79
+ - 一组 PageTabs 只保存在入口模块;隐藏目标模块设置 `ParentId=入口菜单Id、HasChild=0、PageTabs=[]`,不得复制同一套 PageTabs。入口菜单保持 `HasChild=0`,仍然直接打开业务页面。
80
+ - 模块设计器的 PageTabs 必须显示【关联模块】可搜索菜单树,展示模块名称并保存 `TargetSysMenuId`,不能让该协议只能手工改 JSON。
81
+ - 禁止在 `diy-table` 或 mixin 中按模块名、Url、表名写死页签数据源。
82
+
83
+ ### V8CodeShow(显隐控制)—— 支持 `return` 和 `V8.Result`
84
+
85
+ 未配置 `V8CodeShow`,或代码执行后既没有 `return true/false`、也没有设置
86
+ `V8.Result = true/false` 时,显示条件默认按“显示”处理;只有明确
87
+ `return false` 或 `V8.Result = false` 才由显示条件隐藏按钮。角色按钮权限仍是
88
+ 独立约束,不应通过省略显示条件绕过。
89
+
90
+ 推荐写法:直接返回布尔值。
91
+
92
+ ```js
93
+ // 仅当状态为"待指派"且无负责人时显示
94
+ return V8.Form.Status == '待指派' && !V8.Form.AssigneeId;
95
+ ```
96
+
97
+ 兼容旧写法:给 `V8.Result` 赋布尔值。
98
+
99
+ ```js
100
+ // 仅当状态为"待指派"且无负责人时显示
101
+ if (V8.Form.Status == '待指派' && !V8.Form.AssigneeId) {
102
+ V8.Result = true;
103
+ } else {
104
+ V8.Result = false;
105
+ }
106
+ ```
107
+
108
+ ### V8Code 上下文常用变量
109
+ | 变量 | 说明 |
110
+ |------|------|
111
+ | `V8.Form` | 当前行/表单数据 |
112
+ | `V8.FormMode` | `Add` / `Edit` / `View` |
113
+ | `V8.TableId` | 当前 diy_table 的 Id |
114
+ | `V8.TableRowSelected` | 批量按钮里勾选的行数组 |
115
+ | `V8.CurrentUser` | 登录用户 |
116
+ | `V8.ClientType` | `PC` / `IOS` / `Android` / `H5` / `WeChat` |
117
+ | `V8.Tips(msg, ok?)` | 浮层提示 |
118
+ | `V8.ConfirmTips(msg, cb)` | 确认弹窗 |
119
+ | `V8.RefreshTable({_PageIndex:1})` | 刷新列表 |
120
+ | `V8.SearchSet({Field:value})` | 设置/重置筛选条件(PageTabs 常用)|
121
+ | `V8.OpenAnyForm({...})` | 弹出任意表单(核心:可替换提交事件)|
122
+ | `V8.OpenAppDialog({...})` | 按 AppKey 打开已发布在线微服务定制页 |
123
+ | `V8.FormSubmit({...})` | 提交当前表单 |
124
+ | `V8.FormSet(field, val)` | 普通表单触发目标字段 V8;列表上下文只更新当前行/模板 |
125
+ | `V8.ApiEngine.Run({...})` | 调用接口引擎(业务逻辑必走)|
126
+ | `V8.ApiEngine.RunBackground(...)` | 启动后台任务(用于安装、导入、初始化等长任务)|
127
+
128
+ ### V8Code 格式化强制要求
129
+ - AI、MCP、VS Code 插件或脚本生成 `V8Code` / `V8CodeShow` 时,必须保存为可读的多行 JavaScript,包含换行和缩进;禁止把完整逻辑压成一整行。
130
+ - 写入 `sys_menu.MoreBtns/FormBtns/PageTabs/BatchSelectMoreBtns` 等 JSON 字符串时,也要先按 `.js` 文件格式组织代码,再通过 `JSON.stringify` 或等价方式转义保存。
131
+ - `V8.OpenAnyTable`、`V8.OpenAnyForm`、`V8.ApiEngine.Run`、确认弹窗、回调函数等嵌套结构必须分行,回调内部逻辑至少缩进一级。
132
+ - 只允许极短的单表达式显隐代码写成一行,例如 `V8.Result = true;`;一旦包含 `if`、`return`、`function`、`async`、数组/对象字面量或接口调用,就必须多行格式化。
133
+
134
+ 格式化示例:
135
+ ```js
136
+ var projectId = V8.Form && V8.Form.Id ? V8.Form.Id : "";
137
+ if (!projectId) {
138
+ V8.Tips("缺少项目Id,无法打开关联清单。", false);
139
+ return;
140
+ }
141
+
142
+ V8.OpenAnyTable({
143
+ SysMenuId: "01K...",
144
+ DialogType: "Drawer",
145
+ Width: "80vw",
146
+ MultipleSelect: false,
147
+ PropsWhere: [
148
+ ["XiangmuID", "=", projectId]
149
+ ],
150
+ SubmitEvent: async function(selectData, callback) {
151
+ callback({
152
+ Code: 1,
153
+ Data: selectData
154
+ });
155
+ }
156
+ });
157
+ ```
158
+
159
+ ---
160
+
161
+ <!-- /microi-progressive:chunk -->
162
+ <!-- microi-progressive:chunk id=v8-menu-buttons-005 sha256=ca6d6eb9f75e80f2f0a420ed4b959ed2da879d44b8eedb2bc7a013e13561e1a2 -->
163
+ ## 5. 模式 C:状态机推进(无需弹窗)
164
+
165
+ ```js
166
+ var next = '';
167
+ switch (V8.Form.Status) {
168
+ case '待完成': next = '待验收'; break;
169
+ case '待验收': next = '待评价'; break;
170
+ }
171
+ if (next) {
172
+ var result = await V8.ApiEngine.Run('order_advance_status', {
173
+ Id: V8.Form.Id,
174
+ ExpectedStatus: V8.Form.Status,
175
+ NextStatus: next
176
+ });
177
+ V8.Tips(result.Code == 1 ? '状态已更新' : result.Msg, result.Code == 1);
178
+ if (result.Code == 1) V8.RefreshTable({ _PageIndex: -1 });
179
+ }
180
+ ```
181
+
182
+ 状态机必须由接口引擎校验当前状态、目标状态、权限和并发版本;不要在前端直接更新状态字段。
183
+
184
+ <!-- /microi-progressive:chunk -->
185
+ <!-- microi-progressive:chunk id=v8-menu-buttons-006 sha256=661e9eda504167d3eaca091ae759d49b8ddae64f5b1b3b7aab20ed31da33750a -->
186
+ ## 6. 模式 D:批量操作(BatchSelectMoreBtns)
187
+
188
+ ```js
189
+ var rows = V8.TableRowSelected;
190
+ if (!rows || rows.length == 0) { V8.Tips('请先勾选数据'); return; }
191
+ var ids = rows.map(function (r) { return r.Id; });
192
+ V8.ConfirmTips('确认删除选中的 ' + ids.length + ' 条?', function () {
193
+ V8.ApiEngine.Run('order_batch_delete', {
194
+ Ids: ids
195
+ }, function (r) {
196
+ if (r.Code == 1) { V8.Tips('删除成功'); V8.RefreshTable({ _PageIndex: 1 }); }
197
+ else V8.Tips(r.Msg, false);
198
+ });
199
+ });
200
+ ```
201
+
202
+ <!-- /microi-progressive:chunk -->
203
+ <!-- microi-progressive:chunk id=v8-menu-buttons-007 sha256=03346fa906eccc815f6f5be4ed9c5c0ef8c1cdce22e8aba47576ea258c6113a1 -->
204
+ ## 7. 模式 E:PageTabs 切换筛选
205
+
206
+ ```js
207
+ // PageTab:"待办"
208
+ V8.SearchSet({ Status: '待办' });
209
+
210
+ // PageTab:"全部"
211
+ V8.SearchSet({ Status: '' });
212
+ ```
213
+
214
+ `V8CodeShow` 控制此 Tab 在哪种端显示:
215
+ ```js
216
+ // 只在 App 端显示
217
+ return V8.ClientType != 'PC';
218
+ ```
219
+
220
+ ---
221
+
222
+ <!-- /microi-progressive:chunk -->