@microi.net/cli 5.7.8 → 5.7.9

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 (191) 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 +102 -101
  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 +366 -366
  19. package/skills/.microi-skills-version.json +2 -2
  20. package/skills/.progressive-disclosure-manifest.json +27 -27
  21. package/skills/README.md +286 -286
  22. package/skills/ai-engine/SKILL.md +265 -265
  23. package/skills/ai-engine/agents/openai.yaml +4 -4
  24. package/skills/ai-platform-governance/SKILL.md +177 -177
  25. package/skills/ai-platform-governance/references/progressive-01-/345/212/237/350/203/275/345/274/200/345/205/263.md +190 -190
  26. package/skills/app-store/SKILL.md +392 -396
  27. package/skills/app-store/agents/openai.yaml +4 -4
  28. package/skills/business-blueprint/SKILL.md +193 -193
  29. package/skills/datasource-engine/SKILL.md +90 -90
  30. package/skills/datasource-engine/agents/openai.yaml +4 -4
  31. package/skills/dos-orm/references/api-reference.md +229 -229
  32. package/skills/email-engine/SKILL.md +78 -78
  33. package/skills/email-engine/references/v8-email.md +34 -34
  34. package/skills/job-engine/SKILL.md +171 -172
  35. package/skills/job-engine/agents/openai.yaml +4 -4
  36. package/skills/message-notification/SKILL.md +155 -156
  37. package/skills/message-notification/agents/openai.yaml +5 -5
  38. package/skills/message-notification/references/contracts.md +102 -102
  39. package/skills/microi-ai-app-auth.js +652 -652
  40. package/skills/microi-ai-application/SKILL.md +102 -106
  41. package/skills/microi-ai-application/agents/openai.yaml +4 -4
  42. package/skills/microi-ai-application/references/frontend-baseline.md +164 -164
  43. package/skills/microi-client-frontend/SKILL.md +235 -240
  44. 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
  45. 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
  46. 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
  47. package/skills/microi-codex/SKILL.md +72 -76
  48. package/skills/microi-codex-installer/SKILL.md +225 -223
  49. package/skills/microi-codex-installer/agents/openai.yaml +7 -7
  50. package/skills/microi-datasource-mapping/SKILL.md +107 -111
  51. package/skills/microi-db-schema/SKILL.md +175 -175
  52. package/skills/microi-db-schema/agents/openai.yaml +4 -4
  53. package/skills/microi-db-schema/references/core-tables.md +695 -695
  54. package/skills/microi-db-schema/references/form-component-options.md +256 -256
  55. package/skills/microi-db-schema/references/schema-overview.md +202 -202
  56. package/skills/microi-db-schema/references/schema.md +646 -646
  57. package/skills/microi-db-schema/references/table-catalog.md +1599 -1599
  58. package/skills/microi-deployment/references/deployment-matrix.md +101 -101
  59. package/skills/microi-docs-coverage/references/capability-map.md +0 -1
  60. package/skills/microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs +894 -894
  61. package/skills/microi-form-engine/SKILL.md +226 -226
  62. package/skills/microi-form-engine/references/component-catalog.md +216 -216
  63. package/skills/microi-form-engine/references/data-source-events.md +124 -124
  64. package/skills/microi-form-layout/SKILL.md +205 -205
  65. 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
  66. package/skills/microi-frontend-sdk/SKILL.md +188 -188
  67. 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
  68. package/skills/microi-left-right-layout/SKILL.md +141 -141
  69. package/skills/microi-microservice/SKILL.md +322 -323
  70. package/skills/microi-microservice/references/runtime-delivery.md +278 -278
  71. package/skills/microi-mobile-app-quality/SKILL.md +181 -181
  72. 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
  73. 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
  74. package/skills/microi-solution-quotation/SKILL.md +78 -78
  75. package/skills/microi-solution-quotation/agents/openai.yaml +4 -4
  76. package/skills/microi-solution-quotation/scripts/build_solution_quote.py +296 -296
  77. package/skills/microi-sso/references/acceptance.md +49 -49
  78. package/skills/microi-sso/references/configuration-and-security.md +53 -53
  79. package/skills/microi-sso/references/inbound.md +53 -53
  80. package/skills/microi-sso/references/outbound.md +39 -39
  81. package/skills/microi-system-delivery/SKILL.md +134 -134
  82. 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
  83. 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
  84. package/skills/microi-ui/SKILL.md +174 -174
  85. 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
  86. package/skills/microi-uniapp-frontend/SKILL.md +193 -193
  87. 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
  88. 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
  89. package/skills/microi.v8.js +1921 -1921
  90. package/skills/module-engine/SKILL.md +237 -250
  91. package/skills/module-engine/references/module-config.md +204 -204
  92. package/skills/ocr-engine/SKILL.md +113 -113
  93. package/skills/ocr-engine/agents/openai.yaml +4 -4
  94. package/skills/page-engine/SKILL.md +180 -191
  95. 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
  96. 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
  97. package/skills/performance-testing/SKILL.md +221 -221
  98. package/skills/playwright-e2e/SKILL.md +197 -197
  99. 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
  100. 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
  101. package/skills/playwright-e2e/references/progressive-03-microi-helper-/346/250/241/346/235/277.md +221 -221
  102. package/skills/playwright-e2e/references/progressive-04-ci-/345/273/272/350/256/256.md +115 -115
  103. package/skills/print-engine/SKILL.md +259 -259
  104. package/skills/production-readonly-audit/SKILL.md +41 -41
  105. package/skills/report-engine/SKILL.md +71 -71
  106. package/skills/report-engine/agents/openai.yaml +4 -4
  107. package/skills/scripts/optimize-progressive-disclosure.mjs +204 -204
  108. package/skills/scripts/refresh-progressive-disclosure.mjs +64 -64
  109. package/skills/search-engine/SKILL.md +75 -75
  110. package/skills/search-engine/agents/openai.yaml +4 -4
  111. package/skills/spider-engine/SKILL.md +190 -190
  112. package/skills/system-observability/SKILL.md +238 -238
  113. package/skills/system-observability/references/memory-incident-triage.md +70 -70
  114. package/skills/translate-engine/SKILL.md +140 -140
  115. package/skills/translate-engine/agents/openai.yaml +4 -4
  116. package/skills/ui-design/SKILL.md +191 -191
  117. package/skills/ui-design/assets/templates/MCI-DESIGN.md +198 -198
  118. package/skills/ui-design/references/design-pattern-library.md +184 -184
  119. package/skills/ui-design/references/mci-design-contract.md +163 -163
  120. 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
  121. package/skills/ui-design/references/progressive-02-/345/255/227/344/275/223.md +137 -137
  122. 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
  123. 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
  124. 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
  125. 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
  126. 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
  127. 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
  128. package/skills/uniapp-mall-assets/SKILL.md +176 -176
  129. package/skills/unity-integration/SKILL.md +155 -155
  130. package/skills/unity-integration/agents/openai.yaml +4 -4
  131. package/skills/unity-integration/references/ai-app-delivery.md +103 -103
  132. package/skills/unity-integration/references/sdk-api.md +82 -82
  133. package/skills/unity-integration/references/toolbox-migration.md +66 -66
  134. package/skills/unity-integration/references/webgl-hosting.md +57 -57
  135. package/skills/v8-cache-pattern/SKILL.md +306 -306
  136. package/skills/v8-crud-api/SKILL.md +175 -175
  137. 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
  138. 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
  139. package/skills/v8-debugging/SKILL.md +284 -284
  140. package/skills/v8-explorer-tree/SKILL.md +228 -228
  141. package/skills/v8-export-import/SKILL.md +209 -209
  142. 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
  143. package/skills/v8-export-import/references/progressive-02-powerpoint-/345/257/274/345/207/272.md +202 -202
  144. 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
  145. package/skills/v8-file-upload/SKILL.md +256 -263
  146. 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
  147. 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
  148. package/skills/v8-formengine-http/SKILL.md +219 -219
  149. package/skills/v8-frontend-events/SKILL.md +178 -178
  150. package/skills/v8-frontend-events/references/bluetooth-print-api.md +135 -135
  151. package/skills/v8-frontend-events/references/bluetooth-print.md +246 -246
  152. package/skills/v8-frontend-events/references/progressive-01-/345/210/227/350/241/250/344/272/213/344/273/266.md +219 -219
  153. package/skills/v8-http-integration/SKILL.md +182 -182
  154. package/skills/v8-http-integration/references/progressive-01-get-/350/257/267/346/261/202.md +220 -220
  155. 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
  156. package/skills/v8-image-processing/SKILL.md +190 -190
  157. package/skills/v8-image-processing/agents/openai.yaml +4 -4
  158. package/skills/v8-image-processing/references/api-reference.md +623 -623
  159. package/skills/v8-menu-buttons/SKILL.md +180 -180
  160. 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
  161. 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
  162. 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
  163. package/skills/v8-mongodb/SKILL.md +192 -192
  164. package/skills/v8-mq-mqtt/SKILL.md +175 -176
  165. package/skills/v8-mq-mqtt/references/mqtt-production.md +342 -342
  166. package/skills/v8-mq-mqtt/references/progressive-01-v8-mqtt-iot-/347/211/251/350/201/224/347/275/221.md +181 -181
  167. package/skills/v8-mq-mqtt/scripts/check-mqtt-skill-coverage.mjs +203 -203
  168. package/skills/v8-saas-multi-tenant/SKILL.md +219 -219
  169. package/skills/v8-security/SKILL.md +168 -168
  170. package/skills/v8-security/references/progressive-01-2-/346/235/203/351/231/220/346/240/241/351/252/214.md +198 -198
  171. package/skills/v8-security/references/progressive-02-7-/346/227/245/345/277/227/350/256/260/345/275/225.md +158 -158
  172. package/skills/v8-sql-query/SKILL.md +302 -302
  173. package/skills/v8-table-event/SKILL.md +144 -144
  174. 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
  175. 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
  176. package/skills/v8-tcp-integration/SKILL.md +147 -147
  177. package/skills/v8-tcp-integration/agents/openai.yaml +4 -4
  178. package/skills/v8-template-engine/SKILL.md +167 -167
  179. package/skills/v8-utilities/SKILL.md +90 -90
  180. package/skills/v8-utilities/references/client-api-index.md +143 -143
  181. package/skills/v8-utilities/references/platform-http-routes.md +83 -83
  182. package/skills/v8-utilities/references/server-api-index.md +188 -188
  183. package/skills/v8-workflow/SKILL.md +216 -243
  184. 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
  185. package/skills/vision-engine/SKILL.md +159 -159
  186. package/skills/vision-engine/agents/openai.yaml +4 -4
  187. package/skills/vision-engine/references/architecture-and-acceptance.md +194 -194
  188. package/skills/workspace-conventions/SKILL.md +261 -261
  189. 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
  190. 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
  191. 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 -->