@tuya-sat/microapp-kit 0.0.0-stage → 0.1.26-alpha.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 (819) hide show
  1. package/AUDIT.md +43 -0
  2. package/CHANGELOG.md +45 -0
  3. package/MAINTAINING.md +143 -0
  4. package/README.md +53 -2
  5. package/START-HERE.md +40 -0
  6. package/bootstrap/build-install-page.mjs +44 -0
  7. package/bootstrap/install-node.ps1 +80 -0
  8. package/bootstrap/install-node.sh +94 -0
  9. package/bootstrap/install.md.in +29 -0
  10. package/bundle.json +852 -0
  11. package/cli.mjs +3 -0
  12. package/package.json +64 -4
  13. package/resources/contracts/project-permissions.json +596 -0
  14. package/resources/contracts/standard-api.catalog.json +5 -0
  15. package/resources/examples/group-display.mjs +23 -0
  16. package/resources/preview/README.md +104 -0
  17. package/resources/preview/agent-open.mjs +1221 -0
  18. package/resources/preview/application-icon.mjs +27 -0
  19. package/resources/preview/authorization-panel.js +243 -0
  20. package/resources/preview/authorization-routes.mjs +634 -0
  21. package/resources/preview/authorization.mjs +353 -0
  22. package/resources/preview/backend-entry.mjs +22 -0
  23. package/resources/preview/backend-process.mjs +26 -0
  24. package/resources/preview/bridge.js +50 -0
  25. package/resources/preview/control.mjs +48 -0
  26. package/resources/preview/device-fixtures.mjs +38 -0
  27. package/resources/preview/fixtures/context.json +10 -0
  28. package/resources/preview/fixtures/device-catalog.json +363 -0
  29. package/resources/preview/host-contract.mjs +104 -0
  30. package/resources/preview/host.js +841 -0
  31. package/resources/preview/local-dev-provider.mjs +27 -0
  32. package/resources/preview/menu-icons.json +82 -0
  33. package/resources/preview/mock-store.mjs +1147 -0
  34. package/resources/preview/run.mjs +131 -0
  35. package/resources/preview/server.mjs +476 -0
  36. package/resources/preview/theme-tokens.mjs +49 -0
  37. package/resources/preview/themes.json +1036 -0
  38. package/resources/resource-manifest.json +210 -0
  39. package/resources/scripts/backend-build-context.mjs +101 -0
  40. package/resources/scripts/backend-runtime.mjs +68 -0
  41. package/resources/scripts/build-backend-image.sh +23 -0
  42. package/resources/scripts/build-safety.mjs +18 -0
  43. package/resources/scripts/build.mjs +138 -0
  44. package/resources/scripts/command-invocation.mjs +10 -0
  45. package/resources/scripts/diagnostics.mjs +34 -0
  46. package/resources/scripts/init-project.mjs +62 -0
  47. package/resources/scripts/package-release.mjs +80 -0
  48. package/resources/scripts/prepare-locales.mjs +77 -0
  49. package/resources/scripts/project-identity.mjs +21 -0
  50. package/resources/scripts/registry-client.mjs +189 -0
  51. package/resources/scripts/resource-files.mjs +22 -0
  52. package/resources/scripts/scaffold.mjs +31 -0
  53. package/resources/scripts/test-backend-image.mjs +162 -0
  54. package/resources/scripts/update-preview-themes.mjs +26 -0
  55. package/resources/scripts/update-resource-manifest.mjs +9 -0
  56. package/resources/scripts/validate-resources.mjs +9 -0
  57. package/resources/template/_gitignore +5 -0
  58. package/resources/template/backend/.dockerignore +7 -0
  59. package/resources/template/backend/.node-version +1 -0
  60. package/resources/template/backend/Dockerfile +62 -0
  61. package/resources/template/backend/deploy/README.md +105 -0
  62. package/resources/template/backend/deploy/data/README.md +3 -0
  63. package/resources/template/backend/deploy/manifest.json +4 -0
  64. package/resources/template/backend/deploy/tasks/README.md +3 -0
  65. package/resources/template/backend/migrations/README.md +5 -0
  66. package/resources/template/backend/next-env.d.ts +6 -0
  67. package/resources/template/backend/next.config.ts +19 -0
  68. package/resources/template/backend/operations.json +4 -0
  69. package/resources/template/backend/package.json +35 -0
  70. package/resources/template/backend/pnpm-lock.yaml +775 -0
  71. package/resources/template/backend/preview-contract.json +4 -0
  72. package/resources/template/backend/public/.keep +0 -0
  73. package/resources/template/backend/scripts/check-runtime.mjs +12 -0
  74. package/resources/template/backend/scripts/dev-deploy-prepare.mjs +362 -0
  75. package/resources/template/backend/scripts/dev-diagnose-database.mjs +199 -0
  76. package/resources/template/backend/scripts/dev-start-backend.sh +30 -0
  77. package/resources/template/backend/src/app/[[...path]]/route.ts +11 -0
  78. package/resources/template/backend/src/app/api/[...path]/route.ts +11 -0
  79. package/resources/template/backend/src/app/api/health/route.ts +16 -0
  80. package/resources/template/backend/src/app/api/preview/context/route.ts +36 -0
  81. package/resources/template/backend/src/instrumentation.ts +10 -0
  82. package/resources/template/backend/src/lib/api-response.mjs +119 -0
  83. package/resources/template/backend/src/lib/business-logger.mjs +29 -0
  84. package/resources/template/backend/src/lib/database-errors.mjs +15 -0
  85. package/resources/template/backend/src/lib/dev-authorization.mjs +84 -0
  86. package/resources/template/backend/src/lib/dev-context.mjs +58 -0
  87. package/resources/template/backend/src/lib/gateway-ingress.mjs +79 -0
  88. package/resources/template/backend/src/lib/gateway-nonce-store.mjs +31 -0
  89. package/resources/template/backend/src/lib/gateway-verification.mjs +197 -0
  90. package/resources/template/backend/src/lib/request-observability.mjs +93 -0
  91. package/resources/template/backend/src/lib/standard-api.ts +28 -0
  92. package/resources/template/backend/src/microapp-identity.json +1 -0
  93. package/resources/template/backend/src/proxy.ts +40 -0
  94. package/resources/template/backend/tests/api-response.test.mjs +77 -0
  95. package/resources/template/backend/tests/database-diagnostics.test.mjs +198 -0
  96. package/resources/template/backend/tests/deployment-connection.test.mjs +100 -0
  97. package/resources/template/backend/tests/deployment-postgres.test.mjs +109 -0
  98. package/resources/template/backend/tests/deployment.test.mjs +196 -0
  99. package/resources/template/backend/tests/dev-authorization.test.mjs +88 -0
  100. package/resources/template/backend/tests/dev-context.test.mjs +35 -0
  101. package/resources/template/backend/tests/gateway-verification.test.mjs +287 -0
  102. package/resources/template/backend/tests/request-observability.test.mjs +125 -0
  103. package/resources/template/backend/tests/routes.test.mjs +253 -0
  104. package/resources/template/backend/tests/startup.test.mjs +147 -0
  105. package/resources/template/backend/tsconfig.json +34 -0
  106. package/resources/template/micro-app/.editorconfig +15 -0
  107. package/resources/template/micro-app/.eslintrc +15 -0
  108. package/resources/template/micro-app/.prettierignore +4 -0
  109. package/resources/template/micro-app/.prettierrc +6 -0
  110. package/resources/template/micro-app/_gitignore +6 -0
  111. package/resources/template/micro-app/_locales/en.json +5 -0
  112. package/resources/template/micro-app/_locales/zh-CN.json +5 -0
  113. package/resources/template/micro-app/antd.less.overwrite.js +4 -0
  114. package/resources/template/micro-app/babel.config.json +3 -0
  115. package/resources/template/micro-app/manifest.json +46 -0
  116. package/resources/template/micro-app/micro.config.js +4 -0
  117. package/resources/template/micro-app/mock/index.json +4 -0
  118. package/resources/template/micro-app/package.json +61 -0
  119. package/resources/template/micro-app/public/favicon.ico +0 -0
  120. package/resources/template/micro-app/public/index.ejs +13 -0
  121. package/resources/template/micro-app/src/App.less +0 -0
  122. package/resources/template/micro-app/src/App.tsx +99 -0
  123. package/resources/template/micro-app/src/api/api-request.mjs +85 -0
  124. package/resources/template/micro-app/src/api/custom-api-headers.mjs +55 -0
  125. package/resources/template/micro-app/src/api/custom-api.ts +10 -0
  126. package/resources/template/micro-app/src/api/errors.mjs +108 -0
  127. package/resources/template/micro-app/src/api/index.ts +34 -0
  128. package/resources/template/micro-app/src/api/presentation.mjs +33 -0
  129. package/resources/template/micro-app/src/api/req.ts +9 -0
  130. package/resources/template/micro-app/src/api/request-url.mjs +20 -0
  131. package/resources/template/micro-app/src/api/res.ts +9 -0
  132. package/resources/template/micro-app/src/api/submission-errors.mjs +84 -0
  133. package/resources/template/micro-app/src/components/CapsuleFilters/index.module.less +121 -0
  134. package/resources/template/micro-app/src/components/CapsuleFilters/index.tsx +100 -0
  135. package/resources/template/micro-app/src/components/MicroAppUI/DataTable.tsx +48 -0
  136. package/resources/template/micro-app/src/components/MicroAppUI/EllipsisText.tsx +25 -0
  137. package/resources/template/micro-app/src/components/MicroAppUI/Layouts.tsx +54 -0
  138. package/resources/template/micro-app/src/components/MicroAppUI/ModalForm.tsx +230 -0
  139. package/resources/template/micro-app/src/components/MicroAppUI/StatusBadge.tsx +19 -0
  140. package/resources/template/micro-app/src/components/MicroAppUI/index.module.less +99 -0
  141. package/resources/template/micro-app/src/components/MicroAppUI/index.ts +13 -0
  142. package/resources/template/micro-app/src/index.css +16 -0
  143. package/resources/template/micro-app/src/index.tsx +66 -0
  144. package/resources/template/micro-app/src/interfaces.ts +545 -0
  145. package/resources/template/micro-app/src/lang/en.ts +1 -0
  146. package/resources/template/micro-app/src/lang/index.ts +31 -0
  147. package/resources/template/micro-app/src/lang/zh.ts +1 -0
  148. package/resources/template/micro-app/src/language-codes.mjs +32 -0
  149. package/resources/template/micro-app/src/language-policy.ts +6 -0
  150. package/resources/template/micro-app/src/microapp-identity.json +1 -0
  151. package/resources/template/micro-app/src/pages/index.module.less +3 -0
  152. package/resources/template/micro-app/src/pages/index.tsx +6 -0
  153. package/resources/template/micro-app/src/public-path.js +4 -0
  154. package/resources/template/micro-app/src/utils/antdLang.ts +244 -0
  155. package/resources/template/micro-app/tests/template.test.cjs +15 -0
  156. package/resources/template/micro-app/tsconfig.extend.json +8 -0
  157. package/resources/template/micro-app/tsconfig.json +24 -0
  158. package/resources/template/micro-app/typings.d.ts +19 -0
  159. package/resources/template/micro-app/yarn.lock +7491 -0
  160. package/resources/tests/agent-open-catalog.test.mjs +43 -0
  161. package/resources/tests/agent-open-preview.test.mjs +878 -0
  162. package/resources/tests/api-request.test.mjs +121 -0
  163. package/resources/tests/api-response.test.mjs +2 -0
  164. package/resources/tests/application-icon-build.test.mjs +34 -0
  165. package/resources/tests/authorization-proxy.test.mjs +202 -0
  166. package/resources/tests/authorization.test.mjs +462 -0
  167. package/resources/tests/backend-context.test.mjs +33 -0
  168. package/resources/tests/backend-preview.test.mjs +67 -0
  169. package/resources/tests/backend-request-logging.test.mjs +2 -0
  170. package/resources/tests/backend-runtime.test.mjs +96 -0
  171. package/resources/tests/browser-authorization-smoke.mjs +111 -0
  172. package/resources/tests/browser-design-smoke.mjs +107 -0
  173. package/resources/tests/browser-language-compat-smoke.mjs +48 -0
  174. package/resources/tests/browser-preview-smoke.mjs +148 -0
  175. package/resources/tests/browser-standard-ui-smoke.mjs +331 -0
  176. package/resources/tests/build-safety.test.mjs +69 -0
  177. package/resources/tests/business-build.test.mjs +86 -0
  178. package/resources/tests/command-invocation.test.mjs +35 -0
  179. package/resources/tests/custom-api-headers.test.mjs +96 -0
  180. package/resources/tests/custom-route.test.mjs +63 -0
  181. package/resources/tests/custom-script-policy.test.mjs +34 -0
  182. package/resources/tests/database-errors.test.mjs +81 -0
  183. package/resources/tests/deployment-package.test.mjs +45 -0
  184. package/resources/tests/dockerfile-logging.test.mjs +31 -0
  185. package/resources/tests/fixtures/capsule-page.tsx +46 -0
  186. package/resources/tests/fixtures/standard-ui-page.tsx +222 -0
  187. package/resources/tests/group-display.test.mjs +28 -0
  188. package/resources/tests/host-contract.test.mjs +84 -0
  189. package/resources/tests/image-test.test.mjs +110 -0
  190. package/resources/tests/initialization.test.mjs +98 -0
  191. package/resources/tests/language-selection.test.mjs +188 -0
  192. package/resources/tests/locale-keys.test.mjs +88 -0
  193. package/resources/tests/preview-control.test.mjs +56 -0
  194. package/resources/tests/preview-icon.test.mjs +117 -0
  195. package/resources/tests/preview-state.test.mjs +183 -0
  196. package/resources/tests/preview-theme.test.mjs +17 -0
  197. package/resources/tests/real-preview-smoke.mjs +34 -0
  198. package/resources/tests/registry-client.test.mjs +272 -0
  199. package/resources/tests/request-errors.test.mjs +51 -0
  200. package/resources/tests/request-method-contract.test.mjs +65 -0
  201. package/resources/tests/resources.test.mjs +31 -0
  202. package/resources/tests/saas-presentation.test.mjs +41 -0
  203. package/resources/tests/sandbox-scripts.test.mjs +144 -0
  204. package/resources/tests/space-permission-guidance.test.mjs +78 -0
  205. package/resources/tests/standard-api-preview.test.mjs +55 -0
  206. package/resources/tests/submission-errors.test.mjs +118 -0
  207. package/resources/tests/version-description-package.test.mjs +60 -0
  208. package/resources/ui/component-sources.json +36 -0
  209. package/runtime/assemble.mjs +66 -0
  210. package/runtime/auth/hidden-input.mjs +45 -0
  211. package/runtime/auth/macos-credentials.js +41 -0
  212. package/runtime/auth/manager.mjs +145 -0
  213. package/runtime/auth/session.mjs +153 -0
  214. package/runtime/auth/state.mjs +107 -0
  215. package/runtime/auth/store.mjs +130 -0
  216. package/runtime/auth/windows-credentials.ps1 +73 -0
  217. package/runtime/auth/wizard.mjs +224 -0
  218. package/runtime/cli.mjs +474 -0
  219. package/runtime/dev-database.mjs +155 -0
  220. package/runtime/dev-provider.mjs +41 -0
  221. package/runtime/errors.mjs +205 -0
  222. package/runtime/install-receipt.mjs +68 -0
  223. package/runtime/installation.mjs +92 -0
  224. package/runtime/integrity.mjs +110 -0
  225. package/runtime/launcher.mjs +104 -0
  226. package/runtime/pack-npm.mjs +76 -0
  227. package/runtime/package-cache.mjs +52 -0
  228. package/runtime/package-identity.mjs +22 -0
  229. package/runtime/preview.mjs +157 -0
  230. package/runtime/project-identity.mjs +57 -0
  231. package/runtime/publication.mjs +372 -0
  232. package/runtime/release-content.mjs +159 -0
  233. package/runtime/release-index.mjs +91 -0
  234. package/runtime/setup.mjs +223 -0
  235. package/runtime/tests/agent-entry.test.mjs +79 -0
  236. package/runtime/tests/auth-wizard.test.mjs +241 -0
  237. package/runtime/tests/auth.test.mjs +367 -0
  238. package/runtime/tests/consistency-workflow.test.mjs +84 -0
  239. package/runtime/tests/dev-provider.test.mjs +27 -0
  240. package/runtime/tests/diagnostics.test.mjs +66 -0
  241. package/runtime/tests/helpers/tar-fixture.mjs +25 -0
  242. package/runtime/tests/install-page.test.mjs +41 -0
  243. package/runtime/tests/install.test.mjs +432 -0
  244. package/runtime/tests/node-bootstrap.test.mjs +104 -0
  245. package/runtime/tests/npm-distribution.test.mjs +98 -0
  246. package/runtime/tests/package-cache.test.mjs +108 -0
  247. package/runtime/tests/package-migration.test.mjs +208 -0
  248. package/runtime/tests/preview-hosts.test.mjs +66 -0
  249. package/runtime/tests/preview.test.mjs +304 -0
  250. package/runtime/tests/project-identity.test.mjs +67 -0
  251. package/runtime/tests/publication.test.mjs +436 -0
  252. package/runtime/tests/release-recovery.test.mjs +417 -0
  253. package/runtime/tests/repository-source.test.mjs +38 -0
  254. package/runtime/tests/skill-set-update.test.mjs +169 -0
  255. package/runtime/tests/standalone.test.mjs +46 -0
  256. package/runtime/tests/update-check.test.mjs +165 -0
  257. package/runtime/tests/update.test.mjs +292 -0
  258. package/runtime/tests/workspace.test.mjs +156 -0
  259. package/runtime/update-check.mjs +160 -0
  260. package/runtime/update-state.mjs +83 -0
  261. package/runtime/update.mjs +292 -0
  262. package/runtime/workspace-migration.mjs +109 -0
  263. package/runtime/workspace.mjs +101 -0
  264. package/schemas/toolchain.schema.json +13 -0
  265. package/setup.mjs +3 -0
  266. package/skills/micro-app-backend-development/SKILL.md +64 -0
  267. package/skills/micro-app-backend-development/references/backend-security-workflow.md +77 -0
  268. package/skills/micro-app-backend-development/references/business-build-helpers.md +11 -0
  269. package/skills/micro-app-backend-development/references/business-logging.md +56 -0
  270. package/skills/micro-app-backend-development/references/database-constraints.md +81 -0
  271. package/skills/micro-app-backend-development/references/database-write-errors.md +29 -0
  272. package/skills/micro-app-backend-development/references/deployment-bundle.md +65 -0
  273. package/skills/micro-app-backend-development/references/dev-preview-context.md +23 -0
  274. package/skills/micro-app-backend-development/references/gateway-verification.md +43 -0
  275. package/skills/micro-app-backend-development/references/implementation.md +49 -0
  276. package/skills/micro-app-backend-development/references/local-database-preview.md +100 -0
  277. package/skills/micro-app-backend-development/references/production-authorization-readiness.md +60 -0
  278. package/skills/micro-app-backend-development/references/project-data-permissions.md +43 -0
  279. package/skills/micro-app-backend-development/references/runtime-resources-and-deployment.md +76 -0
  280. package/skills/micro-app-backend-development/scripts/microapp-kit.mjs +117 -0
  281. package/skills/micro-app-backend-development/tests/behavior-scenarios.md +62 -0
  282. package/skills/micro-app-cloud-integration/SKILL.md +92 -0
  283. package/skills/micro-app-cloud-integration/references/api-catalog.json +1315 -0
  284. package/skills/micro-app-cloud-integration/references/api-catalog.md +59 -0
  285. package/skills/micro-app-cloud-integration/references/api-device-control.md +67 -0
  286. package/skills/micro-app-cloud-integration/references/api-device.md +179 -0
  287. package/skills/micro-app-cloud-integration/references/api-group-ota.md +145 -0
  288. package/skills/micro-app-cloud-integration/references/api-linkage.md +3 -0
  289. package/skills/micro-app-cloud-integration/references/api-models.md +584 -0
  290. package/skills/micro-app-cloud-integration/references/api-project.md +121 -0
  291. package/skills/micro-app-cloud-integration/references/api-space-home.md +244 -0
  292. package/skills/micro-app-cloud-integration/references/backend-authorization.md +95 -0
  293. package/skills/micro-app-cloud-integration/references/calling-conventions.md +118 -0
  294. package/skills/micro-app-cloud-integration/references/preview-agent-open.md +46 -0
  295. package/skills/micro-app-cloud-integration/references/server-to-server-integration.md +13 -0
  296. package/skills/micro-app-cloud-integration/scripts/microapp-kit.mjs +117 -0
  297. package/skills/micro-app-cloud-integration/tests/behavior-scenarios.md +20 -0
  298. package/skills/micro-app-design/SKILL.md +99 -0
  299. package/skills/micro-app-design/agents/openai.yaml +6 -0
  300. package/skills/micro-app-design/assets/tuya-design-system/assets/README.md +22 -0
  301. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaCapsuleSearch.html +67 -0
  302. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaCardGrid.html +71 -0
  303. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaIcon.html +5 -0
  304. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaPageTitle.html +29 -0
  305. package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaTopNavigation.html +55 -0
  306. package/skills/micro-app-design/assets/tuya-design-system/assets/components.schema.md +154 -0
  307. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/dashboard.html +588 -0
  308. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/dashboard.md +99 -0
  309. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/table-page.html +477 -0
  310. package/skills/micro-app-design/assets/tuya-design-system/assets/examples/table-page.md +77 -0
  311. package/skills/micro-app-design/assets/tuya-design-system/assets/templates/base.html +878 -0
  312. package/skills/micro-app-design/assets/tuya-design-system/latest/accessibility/accessibility.md +39 -0
  313. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/TuyaCapsuleSearch.html +67 -0
  314. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/arrow-down.svg +3 -0
  315. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/calendar.svg +5 -0
  316. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/check.svg +3 -0
  317. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/checkbox-check.svg +3 -0
  318. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/clear.svg +4 -0
  319. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/search.svg +4 -0
  320. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/preview.html +3705 -0
  321. package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/spec.md +78 -0
  322. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/TuyaCardGrid.html +71 -0
  323. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/assets/placeholder.svg +4 -0
  324. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/preview.html +711 -0
  325. package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/spec.md +93 -0
  326. package/skills/micro-app-design/assets/tuya-design-system/latest/components/cascader/spec.md +75 -0
  327. package/skills/micro-app-design/assets/tuya-design-system/latest/components/checkbox/spec.md +72 -0
  328. package/skills/micro-app-design/assets/tuya-design-system/latest/components/date-picker/spec.md +81 -0
  329. package/skills/micro-app-design/assets/tuya-design-system/latest/components/dropdown/spec.md +99 -0
  330. package/skills/micro-app-design/assets/tuya-design-system/latest/components/icon/examples/TuyaIcon.html +5 -0
  331. package/skills/micro-app-design/assets/tuya-design-system/latest/components/icon/spec.md +55 -0
  332. package/skills/micro-app-design/assets/tuya-design-system/latest/components/input/spec.md +84 -0
  333. package/skills/micro-app-design/assets/tuya-design-system/latest/components/modal/spec.md +178 -0
  334. package/skills/micro-app-design/assets/tuya-design-system/latest/components/page-title/examples/TuyaPageTitle.html +29 -0
  335. package/skills/micro-app-design/assets/tuya-design-system/latest/components/page-title/spec.md +67 -0
  336. package/skills/micro-app-design/assets/tuya-design-system/latest/components/pagination/spec.md +94 -0
  337. package/skills/micro-app-design/assets/tuya-design-system/latest/components/radio/spec.md +80 -0
  338. package/skills/micro-app-design/assets/tuya-design-system/latest/components/search-input/spec.md +101 -0
  339. package/skills/micro-app-design/assets/tuya-design-system/latest/components/select/spec.md +96 -0
  340. package/skills/micro-app-design/assets/tuya-design-system/latest/components/slider/spec.md +66 -0
  341. package/skills/micro-app-design/assets/tuya-design-system/latest/components/switch/spec.md +86 -0
  342. package/skills/micro-app-design/assets/tuya-design-system/latest/components/table/spec.md +116 -0
  343. package/skills/micro-app-design/assets/tuya-design-system/latest/components/time-picker/spec.md +75 -0
  344. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tooltip/spec.md +70 -0
  345. package/skills/micro-app-design/assets/tuya-design-system/latest/components/top-navigation/examples/TuyaTopNavigation.html +55 -0
  346. package/skills/micro-app-design/assets/tuya-design-system/latest/components/top-navigation/spec.md +60 -0
  347. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/examples/icons/check.svg +3 -0
  348. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/examples/preview.html +974 -0
  349. package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/spec.md +118 -0
  350. package/skills/micro-app-design/assets/tuya-design-system/latest/components/upload/spec.md +86 -0
  351. package/skills/micro-app-design/assets/tuya-design-system/latest/demo-index.md +43 -0
  352. package/skills/micro-app-design/assets/tuya-design-system/latest/design-system.md +116 -0
  353. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/color.md +165 -0
  354. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/elevation.md +21 -0
  355. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/icon.md +78 -0
  356. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/layout.md +103 -0
  357. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/radius.md +22 -0
  358. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/spacing.md +29 -0
  359. package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/typography.md +43 -0
  360. package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/behavior.md +30 -0
  361. package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/feedback.md +23 -0
  362. package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/state.md +28 -0
  363. package/skills/micro-app-design/assets/tuya-design-system/latest/motion/motion.md +31 -0
  364. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/dashboard.md +34 -0
  365. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/data-page.md +30 -0
  366. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/form-page.md +36 -0
  367. package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/monitoring.md +25 -0
  368. package/skills/micro-app-design/assets/tuya-design-system/latest/quality-checklist.md +71 -0
  369. package/skills/micro-app-design/assets/tuya-design-system/latest/registry.yaml +232 -0
  370. package/skills/micro-app-design/assets/tuya-design-system/latest/tokens.yaml +187 -0
  371. package/skills/micro-app-design/assets/tuya-design-system/resources/README.md +26 -0
  372. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states/README.md +13 -0
  373. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/403.html +58 -0
  374. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/404.html +58 -0
  375. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/500.html +58 -0
  376. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//344/272/213/344/273/266/345/274/202/345/270/270.html +58 -0
  377. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/220/234/347/264/242/346/227/240/347/273/223/346/236/234.html +58 -0
  378. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/344/275/215/347/275/256/344/277/241/346/201/257.html +58 -0
  379. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/346/210/277/345/261/213.html +58 -0
  380. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/346/225/260/346/215/256.html +58 -0
  381. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/346/266/210/346/201/257.html +58 -0
  382. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/347/275/221/347/273/234.html +58 -0
  383. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/350/256/276/345/244/207.html +58 -0
  384. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277//346/232/202/346/227/240/351/241/271/347/233/256.html +58 -0
  385. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203.md +159 -0
  386. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/403.html +31 -0
  387. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/404.html +31 -0
  388. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/500.html +31 -0
  389. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/empty.css +106 -0
  390. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/empty.js +49 -0
  391. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210/index.html +69 -0
  392. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//344/272/213/344/273/266/345/274/202/345/270/270.html +31 -0
  393. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//345/233/276/347/211/207/345/212/240/350/275/275/345/244/261/350/264/245.html +31 -0
  394. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/220/234/347/264/242/346/227/240/347/273/223/346/236/234.html +31 -0
  395. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/344/275/215/347/275/256/344/277/241/346/201/257.html +31 -0
  396. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/346/210/277/345/261/213.html +31 -0
  397. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/346/225/260/346/215/256.html +31 -0
  398. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/346/266/210/346/201/257.html +31 -0
  399. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/347/275/221/347/273/234.html +31 -0
  400. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/350/256/276/345/244/207.html +31 -0
  401. package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203/347/211/210//346/232/202/346/227/240/351/241/271/347/233/256.html +31 -0
  402. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/README.md +23 -0
  403. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/arrow-down.svg +3 -0
  404. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/calendar.svg +5 -0
  405. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/check.svg +3 -0
  406. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/clear.svg +4 -0
  407. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/search.svg +4 -0
  408. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/arrow-down-ref.png +0 -0
  409. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/check-ref.png +0 -0
  410. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/clear-ref.png +0 -0
  411. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/search-ref.png +0 -0
  412. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/Excel.svg +1 -0
  413. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/HD.svg +1 -0
  414. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/PM.svg +1 -0
  415. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/PPT.svg +1 -0
  416. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/README.md +14 -0
  417. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/VOC.svg +1 -0
  418. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/app/347/256/241/347/220/206.svg +1 -0
  419. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/catalog.md +377 -0
  420. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/folder-closed.svg +3 -0
  421. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/license/347/256/241/347/220/206.svg +1 -0
  422. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/nps/351/207/217/350/241/250 /346/224/266/350/227/217.svg" +1 -0
  423. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/sos-2.svg +1 -0
  424. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/sos.svg +1 -0
  425. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/word.svg +1 -0
  426. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/270/200/346/260/247/345/214/226/347/242/263-2.svg +1 -0
  427. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/270/200/346/260/247/345/214/226/347/242/263.svg +1 -0
  428. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/270/212/344/274/240.svg +1 -0
  429. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/214/346/260/247/345/214/226/347/242/263.svg +1 -0
  430. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/221.svg +1 -0
  431. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/221/347/253/257 /344/270/213/350/275/275.svg" +1 -0
  432. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/256/345/272/246 /345/244/252/351/230/263 /346/227/245/351/227/264.svg" +1 -0
  433. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/344/275/223/344/274/240/346/204/237/345/231/250.svg +1 -0
  434. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/345/203/217@2x.svg +1 -0
  435. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/345/221/230/345/244/207/344/273/275@2x.svg +1 -0
  436. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/346/260/221/345/270/201@2x.svg +1 -0
  437. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/350/204/270/350/257/206/345/210/253/346/210/220/345/212/237@2x.svg +1 -0
  438. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/350/241/214/351/227/250/347/246/201.svg +1 -0
  439. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/274/230/346/203/240/345/210/270@2x.svg +1 -0
  440. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/274/232/345/221/230@2x.svg +1 -0
  441. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/201/234/350/275/246@2x.svg +1 -0
  442. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/205/205/347/224/265/346/241/251@2x.svg +1 -0
  443. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/205/245/344/276/265/345/221/212/350/255/246@2x.svg +1 -0
  444. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/205/250/347/220/203 /345/234/260/347/220/203 @2x.svg" +1 -0
  445. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/206/260/347/256/261.svg +1 -0
  446. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/206/267/346/260/264.svg +1 -0
  447. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/210/267/346/274/206.svg +1 -0
  448. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/212/240/346/262/271/347/253/231@2x.svg +1 -0
  449. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/220/210/347/211/251.svg +1 -0
  450. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/255/246-2.svg +1 -0
  451. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/255/246.svg +1 -0
  452. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/240/346/257/224/345/233/276.svg +1 -0
  453. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/267/345/256/227.svg +1 -0
  454. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/267/345/260/272.svg +1 -0
  455. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/216/237/345/255/220 /347/211/251/347/220/206 /346/227/213/350/275/254.svg" +1 -0
  456. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/217/221/345/215/241@2x.svg +1 -0
  457. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/217/260/345/274/217/347/224/265/350/204/221 /346/230/276/347/244/272/345/231/250 /345/261/217/345/271/225.svg" +1 -0
  458. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/220/212/347/201/257.svg +1 -0
  459. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/220/271/351/243/216/346/234/272 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  460. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/221/212/350/255/246/344/270/255/345/277/203.svg +1 -0
  461. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/221/274/345/220/270/347/216/207.svg +1 -0
  462. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/225/206/345/272/227@2x.svg +1 -0
  463. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/226/234/346/254/242@2x.svg +1 -0
  464. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/233/276/347/211/207-/346/255/243/345/270/270.svg +1 -0
  465. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/250/347/272/277/346/234/215/345/212/241/345/217/260@2x.svg +1 -0
  466. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/260/345/233/276@2x.svg +1 -0
  467. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/260/351/223/201@2x.svg +1 -0
  468. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/237/272/345/233/240 DNA.svg" +1 -0
  469. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/237/272/345/233/240.svg +1 -0
  470. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/240/206/345/217/240/346/237/261/347/212/266.svg +1 -0
  471. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/243/260/345/205/211/346/212/245/350/255/246.svg +1 -0
  472. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/244/232/347/275/221/351/241/265 web /345/244/232/347/252/227/345/217/243.svg" +1 -0
  473. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/244/247/350/204/221.svg +1 -0
  474. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/256/236/346/227/266/346/246/202/350/247/210 /351/245/274/345/233/276.svg" +1 -0
  475. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/256/244/345/244/226/346/270/251/345/272/246.svg +1 -0
  476. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/257/271/346/216/245 /344/272/244/346/215/242.svg" +1 -0
  477. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/260/272/345/255/220.svg +1 -0
  478. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/260/272/345/257/270.svg +1 -0
  479. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/267/264/345/243/253@2x.svg +1 -0
  480. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/270/203/345/261/200.svg +1 -0
  481. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/270/203/351/230/262/346/217/220/351/206/222.svg +1 -0
  482. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/212 /347/235/241/347/234/240.svg" +1 -0
  483. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/212.svg +1 -0
  484. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/224/347/224/250/351/205/215/347/275/256.svg +1 -0
  485. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/205/263 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  486. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 Bug@2x.svg" +1 -0
  487. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 Code@2x.svg" +1 -0
  488. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 js /344/273/243/347/240/201@2x.svg" +1 -0
  489. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 /344/273/243/347/240/201@2x.svg" +1 -0
  490. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/345/217/221 /344/273/243/347/240/201 /347/275/221/351/241/265 /344/273/243/347/240/201@2x.svg" +1 -0
  491. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/351/227/250-2.svg +1 -0
  492. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/351/227/250.svg +1 -0
  493. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/275/225/345/203/217.svg +1 -0
  494. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/276/252/347/216/257.svg +1 -0
  495. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/276/256/346/263/242/347/202/211 /347/203/244/347/256/261 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  496. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/347/216/207 /345/277/203/347/224/265/345/233/276.svg" +1 -0
  497. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/347/216/207.svg +1 -0
  498. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/347/224/265/345/233/276 /346/201/222/346/265/201/346/263/204/351/234/262/344/270/212/345/221/212.svg" +1 -0
  499. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/350/267/263/346/243/200/346/265/213.svg +1 -0
  500. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/200/235/350/200/203 /350/201/224/346/203/263.svg" +1 -0
  501. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/200/245/346/225/221.svg +1 -0
  502. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/210/277/351/227/264@2x.png +0 -0
  503. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/213/346/234/272.svg +1 -0
  504. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/213/350/241/250.svg +1 -0
  505. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/223/345/215/260/346/234/272.svg +1 -0
  506. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/225/345/275/261/344/273/252 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  507. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/230/347/272/277/345/233/276.svg +1 -0
  508. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/230/347/272/277/351/235/242/347/247/257/345/233/276.svg +1 -0
  509. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/245/350/255/246.svg +1 -0
  510. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/213/205/346/236/266/350/275/246@2x.svg +1 -0
  511. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/213/215/347/205/247.svg +1 -0
  512. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/214/207/347/272/271@2x.svg +1 -0
  513. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/216/210/346/235/203.svg +1 -0
  514. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/221/204/345/203/217/345/244/264.svg +1 -0
  515. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/224/257/344/273/230@2x.svg +1 -0
  516. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/224/266/350/227/217/346/266/210/346/201/257.svg +1 -0
  517. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/221/346/212/244/350/275/246@2x.svg +1 -0
  518. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/243/347/202/271/345/233/276.svg +1 -0
  519. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256 /345/210/206/346/236/220 /345/276/252/347/216/257.svg" +1 -0
  520. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256 /351/245/274/345/233/276.svg" +1 -0
  521. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256.svg +1 -0
  522. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256/346/272/220.svg +1 -0
  523. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/264/344/275/223/346/246/202/345/206/265-2.svg +1 -0
  524. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/264/344/275/223/346/246/202/345/206/265.svg +1 -0
  525. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/344/273/266/345/244/271/346/211/223/345/274/200.svg +1 -0
  526. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/345/255/227.svg +1 -0
  527. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 amr.svg" +1 -0
  528. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 ara.svg" +1 -0
  529. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 bmp.svg" +1 -0
  530. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 csv.svg" +1 -0
  531. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 doc.svg" +1 -0
  532. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 gif.svg" +1 -0
  533. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 jpeg.svg" +1 -0
  534. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 jpg.svg" +1 -0
  535. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 json.svg" +1 -0
  536. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 md.svg" +1 -0
  537. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 mp3.svg" +1 -0
  538. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 mp4.svg" +1 -0
  539. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 pdf.svg" +1 -0
  540. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 png.svg" +1 -0
  541. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 ppt.svg" +1 -0
  542. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 psd.svg" +1 -0
  543. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 svg.svg" +1 -0
  544. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 txt.svg" +1 -0
  545. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 wav.svg" +1 -0
  546. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 xls.svg" +1 -0
  547. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/346/241/243 /346/226/207/344/273/266 /346/240/274/345/274/217 zip.svg" +1 -0
  548. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/255/347/272/277 /346/226/255/347/275/221/351/207/215/350/257/225 /350/204/211/345/206/262.svg" +1 -0
  549. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/271/346/241/210/347/256/241/347/220/206@2x.png +0 -0
  550. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/275/345/267/245/345/221/230/347/256/241/347/220/206@2x.svg +1 -0
  551. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/240/344/272/272/346/234/272.svg +1 -0
  552. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/245/346/234/237@2x-2.svg +1 -0
  553. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/245/346/234/237@2x.svg +1 -0
  554. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/231/272/350/203/275/346/210/277/351/227/264.svg +1 -0
  555. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/231/272/350/203/275/347/233/221/346/216/247.svg +1 -0
  556. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/231/272/350/203/275/351/227/250/347/246/201.svg +1 -0
  557. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/233/262/347/272/277/345/233/276.svg +1 -0
  558. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/211/345/256/263-/346/214/245/345/217/221/346/200/247/346/234/211/346/234/272/347/211/251.svg +1 -0
  559. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/215/345/212/241/345/231/250-2.svg +1 -0
  560. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/215/345/212/241/345/231/250-3.svg +1 -0
  561. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/215/345/212/241/345/231/250.svg +1 -0
  562. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/254/345/234/260/350/247/206/351/242/221.svg +1 -0
  563. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/272/345/231/250/344/272/272 /344/272/272/345/267/245/346/231/272/350/203/275 .svg" +1 -0
  564. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/237/261/347/212/266/345/233/276-2.svg +1 -0
  565. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/237/261/347/212/266/345/233/276.svg +1 -0
  566. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/207/346/270/205.svg +1 -0
  567. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/207/347/255/276 /346/240/207/350/256/260@2x.svg" +1 -0
  568. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/221/346/234/250 /347/216/257/345/242/203.svg" +1 -0
  569. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/221/346/234/250.svg +1 -0
  570. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/241/350/275/246@2x.svg +1 -0
  571. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/242/257/346/216/247.svg +1 -0
  572. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/250/241/346/235/277.svg +1 -0
  573. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/224/346/263/241/345/233/276.svg +1 -0
  574. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/344/276/265/344/274/240/346/204/237.svg +1 -0
  575. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/346/265/270.svg +1 -0
  576. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/346/265/270/345/221/212/350/255/246.svg +1 -0
  577. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206-2.svg +1 -0
  578. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206-3.svg +1 -0
  579. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206.svg +1 -0
  580. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/347/224/265/347/256/241/347/220/206_/345/211/257/346/234/254.svg +1 -0
  581. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/350/255/246.svg +1 -0
  582. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/202/346/225/221.svg +1 -0
  583. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/241/346/237/223.svg +1 -0
  584. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/275/350/275/246 /350/277/220/350/276/223 @2x.svg" +1 -0
  585. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/262/231/345/217/221.svg +1 -0
  586. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/264/227/350/241/243/346/234/272 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  587. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/265/213/350/257/225 /347/247/222/350/241/250@2x.svg" +1 -0
  588. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/265/264/346/261/240 /346/265/264/347/274/270 .svg" +1 -0
  589. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x-2.svg +1 -0
  590. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x-3.svg +1 -0
  591. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x.svg +1 -0
  592. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/267/273/345/212/240/351/241/271/347/233/256-2.svg +1 -0
  593. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/267/273/345/212/240/351/241/271/347/233/256.svg +1 -0
  594. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246-2.svg +1 -0
  595. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246.svg +1 -0
  596. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246/350/277/207/344/275/216.svg +1 -0
  597. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246/350/277/207/351/253/230.svg +1 -0
  598. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/270/346/210/217/344/274/221/351/227/262/345/250/261/344/271/220.svg +1 -0
  599. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/271/277/345/272/246/350/277/207/344/275/216.svg +1 -0
  600. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/271/277/345/272/246/350/277/207/351/253/230.svg +1 -0
  601. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253.svg +1 -0
  602. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/347/201/276.svg +1 -0
  603. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/255/246.svg +1 -0
  604. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/275/246@2x-2.svg +1 -0
  605. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/275/246@2x.svg +1 -0
  606. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/255/347/201/253/345/231/250.svg +1 -0
  607. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/257.svg +1 -0
  608. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276-2.svg +1 -0
  609. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276.svg +1 -0
  610. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276/345/221/212/350/255/246.svg +1 -0
  611. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/255/346/260/264.svg +1 -0
  612. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/255/346/260/264/345/243/266 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  613. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/205/247/345/272/246.svg +1 -0
  614. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/207/203/346/260/224.svg +1 -0
  615. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/207/203/346/260/224_/345/211/257/346/234/254.svg +1 -0
  616. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/212/266/346/200/201.svg +1 -0
  617. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203 /346/240/221/345/217/266.svg" +1 -0
  618. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203 /346/240/221/346/234/250.svg" +1 -0
  619. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203.svg +1 -0
  620. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203/347/233/221/346/265/213-2.svg +1 -0
  621. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203/347/233/221/346/265/213.svg +1 -0
  622. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/275/242/345/233/276.svg +1 -0
  623. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/262/347/203/267/345/274/202/345/270/270.svg +1 -0
  624. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/262/351/206/233.svg +1 -0
  625. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265.svg +1 -0
  626. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/345/212/250/350/275/246@2x.svg +1 -0
  627. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/345/255/220/345/233/264/346/240/217 /346/241/206/351/200/211.svg" +1 -0
  628. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/346/272/220 /347/224/265/347/223/266.svg" +1 -0
  629. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/350/247/206 /347/233/264/346/222/255 .svg" +1 -0
  630. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/350/264/271.svg +1 -0
  631. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/222/273.svg +1 -0
  632. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/243/216/346/211/207.svg +1 -0
  633. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/245/255/351/224/205 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  634. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/273/346/235/277.svg +1 -0
  635. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/233/221/346/265/213.svg +1 -0
  636. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/233/270/346/234/272.svg +1 -0
  637. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/235/241/347/234/240.svg +1 -0
  638. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/244/276/345/214/272/346/231/272/350/203/275-2.svg +1 -0
  639. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/244/276/345/214/272/346/231/272/350/203/275.svg +1 -0
  640. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/246/273/347/272/277.svg +1 -0
  641. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/247/237/350/265/201/347/256/241/347/220/206.svg +1 -0
  642. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/247/257/345/210/206/350/277/220/350/220/245@2x.svg +1 -0
  643. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/346/260/224/345/207/200/345/214/226/345/231/250 /345/256/266/347/224/265 /347/224/265/345/231/250.svg" +1 -0
  644. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/350/260/203.svg +1 -0
  645. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/351/227/264@2x.png +0 -0
  646. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/252/227/345/270/230.svg +1 -0
  647. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/254/224/350/256/260/346/234/254/347/224/265/350/204/221-2.svg +1 -0
  648. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/254/224/350/256/260/346/234/254/347/224/265/350/204/221.svg +1 -0
  649. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/255/211/345/276/205 /345/200/222/350/256/260/346/227/266@2x.svg" +1 -0
  650. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/255/211/345/276/205@2x.svg +1 -0
  651. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/272/242/347/273/277/347/201/257@2x.svg +1 -0
  652. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/273/204/347/273/207/347/256/241/347/220/206@2x-2.png +0 -0
  653. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/273/204/347/273/207/347/256/241/347/220/206@2x.png +0 -0
  654. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/274/226/350/276/221@2x.png +0 -0
  655. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/275/221/351/241/265.svg +1 -0
  656. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/276/216/345/205/203@2x.svg +1 -0
  657. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/201/344/272/272 /350/200/201/345/271/264/344/272/272@2x.svg" +1 -0
  658. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272-2.svg +1 -0
  659. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272-3.svg +1 -0
  660. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272.svg +1 -0
  661. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/203/275/345/212/233.svg +1 -0
  662. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/207/252/350/241/214/350/275/246@2x.svg +1 -0
  663. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/212/202/350/203/275.svg +1 -0
  664. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/212/257/347/211/207.svg +1 -0
  665. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/241/200/345/216/213/345/274/202/345/270/270.svg +1 -0
  666. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/241/200/346/260/247.svg +1 -0
  667. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/204/350/214/203.md +264 -0
  668. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/345/233/276/346/250/241/345/274/217.svg +1 -0
  669. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221.svg +1 -0
  670. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221AI.svg +1 -0
  671. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221SD.svg +1 -0
  672. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/242/345/215/225.svg +1 -0
  673. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-2.svg +1 -0
  674. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-3.svg +1 -0
  675. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-4.svg +1 -0
  676. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-5.svg +1 -0
  677. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207.svg +1 -0
  678. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/344/272/244/344/273/230-2.svg +1 -0
  679. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/344/272/244/344/273/230.svg +1 -0
  680. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/350/277/220/347/273/264.svg +1 -0
  681. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/350/277/220/350/241/214/347/233/221/346/265/213.svg +1 -0
  682. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207/350/277/236/346/216/245.svg +1 -0
  683. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/347/275/256@2x.svg +1 -0
  684. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/347/275/256/350/260/203/350/257/225.svg +1 -0
  685. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/257/273/345/215/241/345/231/250 /344/277/241/345/217/267.svg" +1 -0
  686. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/246/345/217/267@2x.svg +1 -0
  687. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/247/350/275/246@2x.svg +1 -0
  688. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/255/347/211/251/350/275/246@2x-2.svg +1 -0
  689. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/255/347/211/251/350/275/246@2x.svg +1 -0
  690. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/265/204/344/272/247/344/270/255/345/277/203@2x.svg +1 -0
  691. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234.svg +1 -0
  692. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234lu zhang-2.svg" +1 -0
  693. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234lu zhang.svg" +1 -0
  694. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/246/350/241/214@2x.svg +1 -0
  695. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/254/344/272/244/346/235/203/351/231/220.svg +1 -0
  696. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/244/205-2.svg +1 -0
  697. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/244/205.svg +1 -0
  698. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/270/241@2x.svg +1 -0
  699. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/277/350/275/246@2x-2.svg +1 -0
  700. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/277/350/275/246@2x.svg +1 -0
  701. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/277/220/350/220/245/347/256/241/347/220/206.svg +1 -0
  702. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/277/220/350/276/223/350/275/246@2x.svg +1 -0
  703. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/277/233/345/272/246/346/235/241.svg +1 -0
  704. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/200/232/346/226/255/345/231/250.svg +1 -0
  705. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/201/245/346/216/247.svg +1 -0
  706. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/223/201/351/224/271.svg +1 -0
  707. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/224/201.svg +1 -0
  708. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/224/256/347/233/230.svg +1 -0
  709. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/250/347/243/201/345/221/212/350/255/246.svg +1 -0
  710. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/250/351/224/201.svg +1 -0
  711. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/256/345/217/267@2x.svg +1 -0
  712. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/230/266/346/242/257@2x.svg +1 -0
  713. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/233/252/350/212/261 /344/270/213/351/233/252 .svg" +1 -0
  714. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/233/252/350/212/261 /345/210/266/345/206/267.svg" +1 -0
  715. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/233/267/350/276/276 /346/211/253/346/217/217 /345/217/221/347/216/260 .svg" +1 -0
  716. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/235/231/350/204/211/346/263/250/345/260/204.svg +1 -0
  717. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/237/263/345/223/215.svg +1 -0
  718. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/241/271/347/233/256.svg +1 -0
  719. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/243/236/346/234/272@2x-2.svg +1 -0
  720. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/243/236/346/234/272@2x.svg +1 -0
  721. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/251/254/346/241/266.svg +1 -0
  722. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/253/230/345/210/206/345/255/220.svg +1 -0
  723. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/253/230/346/270/205.svg +1 -0
  724. package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/274/240/346/240/207.svg +1 -0
  725. package/skills/micro-app-design/assets/tuya-design-system/source.json +18 -0
  726. package/skills/micro-app-design/references/action-outcomes.md +7 -0
  727. package/skills/micro-app-design/references/adaptive-card-grid.md +25 -0
  728. package/skills/micro-app-design/references/capsule-fallback.md +36 -0
  729. package/skills/micro-app-design/references/component-boundaries.md +48 -0
  730. package/skills/micro-app-design/references/component-catalog.md +69 -0
  731. package/skills/micro-app-design/references/design-system.md +34 -0
  732. package/skills/micro-app-design/references/empty-and-error-states.md +27 -0
  733. package/skills/micro-app-design/references/icons.md +33 -0
  734. package/skills/micro-app-design/references/implementation-guidance.md +39 -0
  735. package/skills/micro-app-design/references/modal.md +27 -0
  736. package/skills/micro-app-design/references/page-patterns.md +55 -0
  737. package/skills/micro-app-design/references/quality-checklist.md +57 -0
  738. package/skills/micro-app-design/references/requirements-and-permission-states.md +19 -0
  739. package/skills/micro-app-design/references/source-and-scope.md +40 -0
  740. package/skills/micro-app-design/references/tokens.md +23 -0
  741. package/skills/micro-app-design/references/visual-acceptance.md +51 -0
  742. package/skills/micro-app-design/scripts/microapp-kit.mjs +117 -0
  743. package/skills/micro-app-design/scripts/visual-audit.mjs +197 -0
  744. package/skills/micro-app-design/tests/behavior-scenarios.md +154 -0
  745. package/skills/micro-app-design/tests/validate-design-skill.mjs +35 -0
  746. package/skills/micro-app-design/tests/validate-design-system.mjs +51 -0
  747. package/skills/micro-app-development/SKILL.md +132 -0
  748. package/skills/micro-app-development/agents/openai.yaml +6 -0
  749. package/skills/micro-app-development/references/agent-workflow.md +111 -0
  750. package/skills/micro-app-development/references/application-icons.md +50 -0
  751. package/skills/micro-app-development/references/data-change-safety.md +47 -0
  752. package/skills/micro-app-development/references/delivery-checklist.md +129 -0
  753. package/skills/micro-app-development/references/design-workflow.md +77 -0
  754. package/skills/micro-app-development/references/developer-credentials.md +97 -0
  755. package/skills/micro-app-development/references/development-guide.md +213 -0
  756. package/skills/micro-app-development/references/environment-progress.md +47 -0
  757. package/skills/micro-app-development/references/joint-acceptance.md +105 -0
  758. package/skills/micro-app-development/references/local-development.md +40 -0
  759. package/skills/micro-app-development/references/manifest-v1.2.md +129 -0
  760. package/skills/micro-app-development/references/npm-registry.md +48 -0
  761. package/skills/micro-app-development/references/platform-operations.md +48 -0
  762. package/skills/micro-app-development/references/project-workflow.md +36 -0
  763. package/skills/micro-app-development/references/publication-intent.md +34 -0
  764. package/skills/micro-app-development/references/publication-recovery.md +67 -0
  765. package/skills/micro-app-development/references/requirement-intake.md +122 -0
  766. package/skills/micro-app-development/references/runtime-requirements.md +23 -0
  767. package/skills/micro-app-development/references/space-permission-boundaries.md +46 -0
  768. package/skills/micro-app-development/references/tool-update.md +60 -0
  769. package/skills/micro-app-development/references/toolchain-access.md +33 -0
  770. package/skills/micro-app-development/references/user-journey.md +65 -0
  771. package/skills/micro-app-development/references/workspace-environments.md +39 -0
  772. package/skills/micro-app-development/scripts/application-icon.mjs +108 -0
  773. package/skills/micro-app-development/scripts/install-app-icon.mjs +48 -0
  774. package/skills/micro-app-development/scripts/install-menu-icon.mjs +27 -0
  775. package/skills/micro-app-development/scripts/language-policy.mjs +83 -0
  776. package/skills/micro-app-development/scripts/languages.json +372 -0
  777. package/skills/micro-app-development/scripts/locale-keys.mjs +26 -0
  778. package/skills/micro-app-development/scripts/microapp-kit.mjs +117 -0
  779. package/skills/micro-app-development/scripts/project-code.mjs +13 -0
  780. package/skills/micro-app-development/scripts/review-backend-logging.mjs +27 -0
  781. package/skills/micro-app-development/scripts/review-production-authorization.mjs +37 -0
  782. package/skills/micro-app-development/scripts/validate-micro-app-project.mjs +442 -0
  783. package/skills/micro-app-development/tests/application-icons.test.mjs +131 -0
  784. package/skills/micro-app-development/tests/backend-logging-review.test.mjs +24 -0
  785. package/skills/micro-app-development/tests/behavior-scenarios.md +177 -0
  786. package/skills/micro-app-development/tests/data-change-safety-scenarios.md +25 -0
  787. package/skills/micro-app-development/tests/design-workflow-scenarios.md +40 -0
  788. package/skills/micro-app-development/tests/fixtures/valid-v6/_locales/en.json +6 -0
  789. package/skills/micro-app-development/tests/fixtures/valid-v6/_locales/zh-CN.json +6 -0
  790. package/skills/micro-app-development/tests/fixtures/valid-v6/manifest.json +59 -0
  791. package/skills/micro-app-development/tests/fixtures/valid-v6/micro.config.js +5 -0
  792. package/skills/micro-app-development/tests/fixtures/valid-v6/mock/index.json +11 -0
  793. package/skills/micro-app-development/tests/fixtures/valid-v6/package.json +4 -0
  794. package/skills/micro-app-development/tests/fixtures/valid-v6/src/index.tsx +5 -0
  795. package/skills/micro-app-development/tests/fixtures/valid-v6/src/lang/en.ts +1 -0
  796. package/skills/micro-app-development/tests/fixtures/valid-v6/src/lang/zh.ts +1 -0
  797. package/skills/micro-app-development/tests/fixtures/valid-v6/src/public-path.js +3 -0
  798. package/skills/micro-app-development/tests/production-authorization-review.test.mjs +72 -0
  799. package/skills/micro-app-development/tests/six-skill-routing-scenarios.md +60 -0
  800. package/skills/micro-app-development/tests/user-journey-scenarios.md +19 -0
  801. package/skills/micro-app-development/tests/validate-micro-app-project.test.mjs +428 -0
  802. package/skills/micro-app-frontend-development/SKILL.md +86 -0
  803. package/skills/micro-app-frontend-development/agents/openai.yaml +6 -0
  804. package/skills/micro-app-frontend-development/references/api-and-permissions.md +86 -0
  805. package/skills/micro-app-frontend-development/references/custom-api-requests.md +52 -0
  806. package/skills/micro-app-frontend-development/references/debugging.md +36 -0
  807. package/skills/micro-app-frontend-development/references/i18n-and-theme.md +54 -0
  808. package/skills/micro-app-frontend-development/references/interaction-completion.md +61 -0
  809. package/skills/micro-app-frontend-development/references/micro-frontend-runtime.md +33 -0
  810. package/skills/micro-app-frontend-development/references/routing-and-context.md +96 -0
  811. package/skills/micro-app-frontend-development/references/saas-failure-and-display.md +45 -0
  812. package/skills/micro-app-frontend-development/references/standard-api-requests.md +30 -0
  813. package/skills/micro-app-frontend-development/references/submission-errors.md +51 -0
  814. package/skills/micro-app-frontend-development/scripts/microapp-kit.mjs +117 -0
  815. package/skills/micro-app-frontend-development/tests/behavior-scenarios.md +36 -0
  816. package/skills/micro-app-solution-design/SKILL.md +69 -0
  817. package/skills/micro-app-solution-design/agents/openai.yaml +6 -0
  818. package/skills/micro-app-solution-design/scripts/microapp-kit.mjs +117 -0
  819. package/skills/micro-app-solution-design/tests/behavior-scenarios.md +12 -0
@@ -0,0 +1,52 @@
1
+ # 自定义 API 请求封装与验收
2
+
3
+ 适用于浏览器调用同源 `/custom-aicoding-api/{code}/...`。平台请求头契约以[云端接入约定](../../micro-app-cloud-integration/references/backend-authorization.md#自定义接口-accept-请求头2026-11-06-已确认)为准。本节负责将它落实到实际客户端,不能把模板文件存在或辅助函数单测通过当作调用链已接入。
4
+
5
+ ## Axios
6
+
7
+ 业务接口复用模板 `src/api/index.ts` 导出的实例与 `customApiPath`,例如在 `src/api/students.ts`:
8
+
9
+ ```ts
10
+ import api from './index';
11
+ import { customApiPath } from './custom-api';
12
+
13
+ export const listStudents = (params: { page: number; pageSize: number }) =>
14
+ api.get(customApiPath('/api/students'), { params });
15
+ ```
16
+
17
+ 请求链为业务接口 → 模板实例 → `req.ts` → `apiRequestConfig` → `customApiRequestConfig`。统一入口也处理[标准请求前缀](standard-api-requests.md),不会给自定义通道添加 `/open-api`。检查新增的 `axios.create()`、直接 `axios.get/post` 或第三方客户端是否绕过了这条链;需要独立实例时给它安装同一个请求拦截器,不在页面逐接口补头。
18
+
19
+ Axios 的 `baseURL` 与 `url` 一起决定最终地址。拦截器必须接收完整 config;只将 `config.url` 交给字符串前缀判断,会漏掉 `baseURL='/custom-aicoding-api/{code}'`、`url='/api/students'`。同源绝对 URL 也应归一,外部域名和标准 `/open-api` 保留原约定。
20
+
21
+ 模板 helper 在最终同源自定义通道上清理大小写不同的顶层 Accept,以及 Axios 尚未展开的 `common/get/post/put/patch/delete/head/options` 分组里的 Accept,然后设置单一 `Accept: application/json`。不改变调用方默认头,不丢失宿主范围、CSRF、body 或取消信号。不要只配置 `axios.defaults.headers.common.Accept`:独立实例或按方法配置仍可能覆盖它。
22
+
23
+ ## fetch
24
+
25
+ fetch 不经过 Axios 拦截器。优先复用模板 `api-request.mjs` 的 `fetchInHost`(内部调用 `customApiFetchInit`),而不是复制只有默认 method 的通用示例:
26
+
27
+ ```ts
28
+ import { fetchInHost } from './api-request.mjs';
29
+ import { customApiPath } from './custom-api';
30
+
31
+ export function requestStudents(body: string, headers: Headers, signal: AbortSignal) {
32
+ const path = customApiPath('/api/students');
33
+ const requestHeaders = new Headers(headers);
34
+ requestHeaders.set('Content-Type', 'application/json;charset=utf-8');
35
+ return fetchInHost(path, {
36
+ method: 'POST', body, headers: requestHeaders, signal,
37
+ });
38
+ }
39
+ ```
40
+
41
+ 该 helper 在自定义通道设置显式大写 method 和单一 JSON Accept,支持普通 header 对象、`Headers`、键值对数组及 `Request` 的原头。JSON 写请求同时声明 Content-Type;helper 不替调用者序列化 body。不要用 `{ ...new Headers(...) }`,否则会丢失已有头。宿主身份、范围和 CSRF 继续通过原集成注入,不新增 token 获取或缓存逻辑。helper 不解析业务响应;沿用请求错误分类与页面交互。
42
+
43
+ ## 验收与排错
44
+
45
+ 写入时按[提交阶段与安全诊断](submission-errors.md)接线。`fetchJsonInHost` 在 `fetchInHost` 之上统一检查 HTTP 和 success envelope;原始 `fetchInHost` 仍返回 Response,不重复解包。参数转换/JSON.stringify 使用 `prepareSubmission` 包住发送前逻辑;不得把网络调用也包进去。Axios 缺少 response 不代表网络错误,沿用 `transportError`,保留准备阶段受控码。
46
+ 在所用客户端真正展开默认头、执行拦截器后,检查最终发出的 HTTP 请求:GET 和至少一个业务写操作均只有一个 Accept,值为 `application/json`。覆盖普通完整路径、实际使用的 baseURL 拼接、不同大小写/方法默认头;fetch 项目覆盖 `Headers` 输入、body、signal 和显式 method。标准端与外部请求不得被这个自定义规则改写。
47
+
48
+ 本地预览会拒绝缺失、通配、多值或重复的 Accept,返回 `MAP_INVALID_REQUEST`,且不联系 DEV backend;预览桥不会替业务代码修正它。先修实际请求封装,再从页面验收,不要放宽预览或网关规则。
49
+
50
+ `MAP_INVALID_REQUEST` 还有路径、重复头、封装等其他触发原因。必须结合真实 Request URL/请求头及关联日志判断,不凭错误码断言一定是 Accept,也不靠改业务权限或数据库配置处理它。
51
+
52
+ 更新开发包不会自动迁移已有业务源码。对已有项目明确同步 helper、`req.ts`、实际业务调用与测试,重新构建并按授权发布新版本;不修改已发布包、安装缓存或旧发布请求。
@@ -0,0 +1,36 @@
1
+ # 调试方法
2
+
3
+ 先定位故障所在边界,再修复根因。推荐顺序:
4
+
5
+ ```text
6
+ 依赖和 lockfile
7
+ → micro-script 启动/构建
8
+ → micro.config.js 代理和登录态
9
+ → qiankun 生命周期、容器和资源路径
10
+ → 主应用 props、主题、语言和业务上下文
11
+ → manifest 菜单、权限和 API 声明
12
+ → Axios 请求/响应封装
13
+ → 云端接口
14
+ ```
15
+
16
+ ## 证据清单
17
+
18
+ - 完整错误、状态码和失败命令。
19
+ - 问题只在独立运行、SaaS 内、某主题、某语言或某角色发生吗?
20
+ - 实际请求 method、URL、path、headers(敏感值必须脱敏)和响应 envelope。
21
+ - manifest 对应声明。
22
+ - 当前 target、构建环境和主应用传入的非敏感上下文。
23
+ - 最近相关改动和可复现步骤。
24
+
25
+ ## 常见定位
26
+
27
+ - 点击保存但 Network 无记录:先清空过滤与反转,再按[提交阶段](submission-errors.md)核对字段校验、参数准备、请求拦截、传输与响应;普通提交回调异常不能证明尚未发送。捕获安全码/阶段/关联编号,不把 `!response` 等同网络失败,不要求用户反复修改输入或直接排查数据库。
28
+ - 静态资源 404:检查 public-path 导入、qiankun 注入路径、构建 `publicPath`。
29
+ - 路由落错位置:检查 `base`、BrowserRouter basename、entry path。
30
+ - 弹层主题错误:检查 popup container、StyleProvider container、theme subscription,而不是先覆盖 CSS。
31
+ - 本地正常、部署接口不存在:比较真实请求与 manifest method/path/type。
32
+ - 权限行为不一致:比较 privileges、roleConfig、editConfig、API privilegeCode、hasPermission 和真实角色。
33
+ - 语言不更新:检查 langResource 合并、tyLang、AntD locale 和订阅时机。
34
+ - 云端返回或鉴权原因不明确:收集已脱敏证据后转 `micro-app-cloud-integration`。
35
+
36
+ 禁止通过硬编码账号、Token、绕过权限或指向生产环境来“验证”修复。
@@ -0,0 +1,54 @@
1
+ # 国际化与主题
2
+
3
+ ## 两套语言资源
4
+
5
+ | 目录 | 用途 |
6
+ | --- | --- |
7
+ | `_locales` | manifest 名称、描述、菜单、权限等平台元数据 |
8
+ | `src/lang` | React 页面运行时文案 |
9
+
10
+ manifest 中每个 `lang.*` key 必须在所有要求支持的 `_locales/*.json` 中存在。页面文案使用 `react-i18next`,不要直接硬编码展示字符串。
11
+
12
+ ## 项目支持语言
13
+
14
+ 中英默认必选;按用户已表达的需求选择额外语言,不为未提出额外语种的用户增加确认。code只从 `../../micro-app-development/scripts/languages.json` 的74项中取,不能猜ISO别名或自动放开SDK其他枚举。manifest使用 `supportedLanguages: ["zh", "en", "ja", "de", "zh_tw"]`;缺省中英,显式声明必须含中英,禁止重复、未知code或路径片段。繁体中文规范码为 `zh_tw`,与平台发布服务和SDK一致;区域语种保持 `en_GB`、`pt_BR`、`zh_Hant_HK`、`es_419`。
15
+
16
+ 兼容已有 `tw` 项目:工具接受旧声明、`_locales/tw.json`、`src/lang/tw.ts/js`,新构建产物和登记/查询归一为 `zh_tw`;不编辑用户源文件、已发布归档、缓存或既有翻译。`tw` 与 `zh_tw` 是同一种语言,不能同时声明;每套元数据/页面资源只能有一个对应文件(也不能同时有 .ts 和 .js),检测到重复直接提示修复,不猜哪个更新或静默覆盖。页面运行时同时识别宿主 `tw`、`zh_tw` 和 `zh-TW`;香港繁体 `zh_Hant_HK` 仍是独立语言,不合并。
17
+
18
+ 新项目只生成规范文件。已有项目若选择显式迁移,应一起修改 manifest、元数据和页面文件名,并同步 `language-codes.mjs`、`language-policy.ts`、`lang/index.ts`,再构建验收;仅升级工具不会自动重写业务源码。旧包的 mf/ui `tw.json` 继续可被平台读取并写入同一个繁体SDK语种,不需重建翻译桶或执行数据回填。
19
+
20
+ 为每个所选code创建 `src/lang/{code}.ts` 及 `_locales/{code}.json`;简体中文元数据继续用 `_locales/zh-CN.json`。中英定义相同key,额外语言可以缺词(运行时回退英文),但不能添加中英不存在的孤立key。缺翻译不编造已完成翻译;可明确记录剩余词条。字段名/词条key保持稳定,翻译内容保留原样,不自动转换繁体或把英文复制成完成的其他语种翻译。
21
+
22
+ 新模板动态注册manifest所选语言。已有项目升级工具不覆盖业务源码:检查其i18next注册、宿主语言归一和资源覆盖逻辑,再显式补齐;不能只添加语言文件或修改manifest。宿主/Rosetta/browser编码需要一致归一;不支持的宿主语种回退英文。验证业务文案、切换及英文fallback;AntD缺少对应locale时仅组件内置文案回退英文,不声称74种组件文案均已翻译。预览支持项目所选语种,真实SaaS是否启用该语言仍由SaaS语种管理控制。
23
+
24
+ ## 词条 key 命名
25
+
26
+ 生成的词条 key 必须非空,且不得包含任何空白字符,包括普通空格、制表符、换行、不换行空格及全角空格。使用稳定、语义明确的英文标识,推荐每段 lowerCamelCase,可用点分命名空间,例如 `homeRoles`、`home.roles`、`device.hideRoomCounts`;不要将整句展示文案作为 key。英文文案值如 `Home roles (owner access)` 仍可正常包含空格和标点。
27
+
28
+ 平台为页面词条加 `ui.` 前缀:在 `src/lang/en.ts`、`zh.ts` 的 `translation` 中定义 `homeRoles`,页面使用 `t('homeRoles')`,平台词条名即 `ui.homeRoles`;源码无需为了平台前缀再写一次 `ui.`。已有业务命名空间如 `micro.empty` 保持一致,不批量追加或移除前缀。manifest 元数据仍使用 `lang.homeRoles` 引用 `_locales` 的 `homeRoles`,遵守现有元数据单层 key 约束。
29
+
30
+ 中文和英文使用相同 key;改名时同步全部支持语言、`t(...)`/动态 key 生成处、manifest 引用和相关测试,检查是否与已有 key 冲突,再验证中英切换及宿主词条覆盖。项目校验检查元数据 key,词条打包检查所有语言的页面 key 和嵌套路径;无效 key 会阻断打包。不得静默去空格或自动生成别名。已有项目更新工具不会改写业务源码;需显式修复后重新构建、准备新包并按授权上传,保留已受理发布的固定包和请求。
31
+
32
+ 挂载时:
33
+
34
+ 1. 将主应用 `langResource` 合并到 i18next translation namespace。
35
+ 2. 按项目所选语种归一 `props.tyLang`(含 `tw`/`zh_tw`、浏览器区域编码)后调用 `changeLanguage`。
36
+ 3. 将当前语言映射为对应 AntD locale。
37
+
38
+ ## 主题
39
+
40
+ - 从 `themeSubscribe.getValue()` 初始化 AntD provider 配置。
41
+ - 订阅主题变化并在卸载时调用 unsubscribe。
42
+ - `ConfigProvider` 和 `StyleProvider` 使用微应用容器。
43
+ - AntD 静态 message/notification 通过 `holderRender` 或 App holder 获得同一主题上下文。
44
+ - 组件样式优先使用 AntD Token/CSS-in-JS;具体视觉 Token、布局和交互由 `micro-app-design` 决定。
45
+
46
+ ## 验证
47
+
48
+ 至少覆盖浅色、深色、中英文、弹窗/下拉/消息 Portal、主应用动态切换主题和语言。独立运行缺少宿主订阅对象时只能作为有限验证,不声称等同 SaaS 集成。
49
+
50
+ 页面视觉落地还须比较 `themeSubscribe` 实际配置和 computed style 与设计 Token;使用 Token 不代表其上游值正确。预览差异在能力包 `resources/preview/theme-tokens.mjs` 与主题生成脚本修复;真实宿主差异记录集成缺口,不在业务页另加整套品牌主题或全局 focus 覆盖。按设计 Skill 的 visual-acceptance.md 分开保留视觉与功能证据。
51
+
52
+ ## 本地预览的初始语言
53
+
54
+ Agent 根据用户自然语言对话选择首次预览语言(中文 zh、英文 en),用户明确指定或已手动选择的语言优先;不依据英文日志、代码或系统默认值推断。通过预览实际语言菜单设置,验证宿主和微应用显示一致;不硬编码生产语言,也不新增不存在的 CLI 参数。额外语种仅从当前项目所选列表切换,真实宿主已启用范围另行核对。详见[预览语言引导](../../micro-app-development/references/user-journey.md#预览语言按对话决定并验证实际显示)。
@@ -0,0 +1,61 @@
1
+ # 交互完成条件与验证
2
+
3
+ 适用于新增/修改带操作的页面、表单、弹窗、列表与详情。已有产品交互约定优先;没有明确约定时采用下列默认行为,不为关闭弹窗、刷新列表等常规行为反复询问用户。只覆盖实际存在及受影响的功能,不强制每个页面实现全部操作。
4
+
5
+ ## 1. 实现前列清操作结果
6
+
7
+ 在已有任务记录中维护简短的“控件/触发 → 输入/校验 → 请求或本地行为 → 成功后可见变化 → 失败/恢复”清单。设计 Skill 提供结果,前端 Skill 接线并验证;不另外创建冗长规格文档。
8
+
9
+ 每个可见且可用的按钮、链接、菜单项、表单提交、筛选器都须有符合标签语义的结果。不能保留空 onClick、只 console.log、仅弹成功提示或假成功响应。纯本地展开/切换不要求 API,但必须改变对应 UI。暂不可实现的操作隐藏或禁用并说明原因,不用 toast 冒充业务功能。
10
+
11
+ ## 2. 默认行为矩阵
12
+
13
+ | 操作 | 成功完成条件 | 失败、取消及边界 |
14
+ |---|---|---|
15
+ | 新增 | 校验通过后提交一次;确认业务成功后默认关闭弹窗/抽屉、清理新增表单,更新列表与相关总数/统计 | 校验/业务失败保持弹窗和输入;提交中显示状态并防重复提交;取消不写数据 |
16
+ | 编辑 | 打开时加载选中对象;成功关闭并更新列表行、已打开详情及相关统计 | 失败保留修改;切换对象不残留上一对象数据,不把迟到详情填到新对象表单 |
17
+ | 删除 | 明确目标并确认;成功后移除记录/重新查询,更新总数、统计与选中项 | 取消不发删除请求;失败保留记录;删掉最后一页最后一条时回到有效页并重新查询;目标详情关闭或转到有效页面 |
18
+ | 批量操作 | 仅处理当前有效且授权的选中项,展示成功/失败数量并同步数据 | 部分失败不提示全部成功;保留可重试失败项,清除失效选择,遵循明确的跨页选择规则 |
19
+ | 搜索 | 按钮与输入框 Enter 使用同一提交逻辑;将当前输入应用到查询并从第一页取结果 | 处理空值/无结果/失败;保留已提交条件;连续查询只展示最新结果;实时搜索另按既有约定处理,不追加无作用按钮 |
20
+ | 重置 | 清除搜索/筛选输入及已应用条件,页码归一,立即按默认条件查询 | 不只清空输入框;保留宿主项目/家庭安全边界,不能重置成跨项目查询 |
21
+ | 筛选、排序、分页 | 请求条件与 UI 一致;筛选或 pageSize 变化回到有效页,分页保留已应用的筛选与排序 | 不能只对服务端分页返回的当前页做过滤却声称搜索全量;空结果与请求失败区分 |
22
+ | 刷新 | 按当前上下文及已应用条件重新读取,结束后更新真实结果 | 刷新中可保留旧数据并标识;失败有错误与重试,不展示成空数据或永久 loading |
23
+ | 打开、取消、再打开弹窗 | 新增为干净初始值,编辑为当前对象值;取消无写入;关闭后焦点合理返回 | 有未保存修改时按产品约定提示;提交中禁止意外丢失状态或明确处理关闭后结果;不得跨对象/项目恢复旧表单 |
24
+ | 页面/详情跳转 | 进入正确对象和路径,返回后按约定保留列表条件 | 不存在/无权限有反馈,不出现空白页;不跳到错误项目的数据 |
25
+ | 导出、下载等长操作 | 显示任务状态;真正产生文件或可查询的后台任务结果 | 有超时、失败与重试路径;禁止仅显示“导出成功”却没有产物 |
26
+
27
+ 默认“保存成功即关闭”可被明确的“保存并继续新增”、分步流程或已有产品要求覆盖,但按钮文案和重置行为必须对应。不得在 finally 中统一关闭/重置表单,因为 finally 也在失败时执行。
28
+
29
+ 新增记录未满足当前筛选或落在其他分页时,列表不一定出现该条;仍需同步总数/统计并清楚说明已保存及当前筛选影响,可提供查看入口。不能为让测试通过而无提示清空用户筛选。
30
+
31
+ ## 3. 写入与界面同步
32
+
33
+ - 按[表单提交阶段](submission-errors.md)区分字段校验、发送前代码异常、网络错误和后端业务拒绝;复用模板安全诊断,不用一条“保存失败,请检查输入”覆盖所有分支。取消不报错,保存错误不重复出现在背景列表。
34
+ - 确认 HTTP 和约定业务结果成功,不能只凭 fetch resolve 或状态 200 提示成功。
35
+ - 复用项目已有查询/状态方案,统一请求条件和列表更新入口;不要在多个组件复制互不一致的数据副本。有 query cache 时按对象和上下文精确失效;没有时显式调用统一查询函数,不为此强制新增状态库。
36
+ - 写入成功后,必须同步受影响的列表、详情、总数/统计、选中项和分页。可使用返回的权威对象更新或重新查询;采用乐观更新时明确失败回滚,不用整页 window.location.reload() 掩盖状态问题。
37
+ - 写入成功、随后列表刷新失败是两个结果:提示“保存成功,列表更新失败,可重试刷新”,保留明确的已提交状态,不能诱导再次提交写入。取消、校验失败、请求失败、业务失败也分别处理。
38
+ - 所有请求都有 pending 结束和错误路径。防连续点击重复提交;写请求超时可能已生效,优先按已确认的幂等/查询契约核实,不能盲目自动重放。
39
+ - 搜索、详情加载和上下文切换处理乱序返回,可用取消、请求序号或既有查询库保证旧结果不覆盖新条件;不要用固定延时等候刷新。卸载后不继续更新 UI。
40
+ - 项目/家庭、用户或权限改变时清理不再有效的选择和详情;旧上下文请求结果不能写入新上下文。禁用按钮不能替代 backend 授权。
41
+
42
+ ## 4. 交付验证门槛
43
+
44
+ 错误状态与字段展示补充执行 [SaaS 错误与展示回归](saas-failure-and-display.md),包括跨页签迟到失败、恢复成功清错及保存成功但刷新失败。
45
+
46
+ 对受影响页面逐个盘点可用控件,并使用真实浏览器/预览操作关键路径。构建成功、静态代码搜索、API 返回成功、截图或 toast 都不能独立证明交互完成。
47
+
48
+ 有 CRUD 的页面至少验证实际存在的下列路径:
49
+
50
+ 1. 新增有效记录 → 只提交一次 → 弹窗关闭 → 列表/数量自动同步 → 重新进入仍可读到;空字段、业务失败时弹窗不关闭且输入保留。
51
+ 2. 编辑 → 重新打开同一对象看到新值;打开另一对象不残留旧值。
52
+ 3. 删除取消不发送写请求;确认成功自动更新列表;删除最后一条后页码有效;失败时记录仍在。
53
+ 4. 搜索按钮和 Enter 分别验证,检查请求参数与结果;无结果、重置恢复、分页保留筛选均验证。测试数据应使匹配/不匹配结果有区别,不能只断言请求发出。
54
+ 5. 慢请求、连点、网络/业务失败能结束 loading;乱序搜索或切换项目不回显旧结果;保存成功但刷新失败不会重复创建。
55
+ 6. 对其他可用控件至少观察一次与文案一致的效果,必要的破坏性操作仅在获准的隔离 DEV 测试数据中执行。
56
+
57
+ 复用已有测试工具,对新增或修复的交互补有意义的组件/浏览器回归用例,断言用户可见结果而非内部函数被调用或 state 变量名称。使用可控请求完成时机模拟失败/乱序,不依赖 sleep。表单校验、按钮禁用、弹窗关闭、列表内容、总数等以实际 DOM 和数据结果验证。
58
+
59
+ 平台标准 API 使用有状态 DEV Mock:新增后可查询、删除后消失,必要时测试内维护受控状态;不能用永远返回同一数组的静态响应声称列表同步通过。自定义 backend 使用真实 DEV 服务/隔离库;测试替身只能证明 UI 状态,不代表真实持久化/权限联调。
60
+
61
+ 没有浏览器能力或 DEV 资源时继续实现及可执行测试,明确列出未执行的交互验收;不得把静态检查计为浏览器已验证。复用联合验收记录写明操作、预期、实际、环境和证据。可用控件无作用、成功后数据不同步、失败时丢输入等问题未解决前,不得宣称该受影响功能已完成。
@@ -0,0 +1,33 @@
1
+ # 微前端运行时
2
+
3
+ ## public path
4
+
5
+ 保留 `src/public-path.js` 并在应用入口最先导入:
6
+
7
+ ```js
8
+ if (window.__POWERED_BY_QIANKUN__) {
9
+ __webpack_public_path__ = window.__INJECTED_PUBLIC_PATH_BY_QIANKUN__;
10
+ }
11
+ ```
12
+
13
+ 开发环境可使用 `/`,生产构建资源路径应为 `./`,避免子路径部署后静态资源指向站点根目录。
14
+
15
+ ## 生命周期
16
+
17
+ 入口导出 `bootstrap`、`mount`、`unmount`。通用职责:
18
+
19
+ - `mount(props)`:保存主应用 props、注入语言资源、切换语言、从 `props.container` 查找 `#root`、创建 React root。
20
+ - `unmount()`:销毁 AntD 全局 message/notification、卸载 React root、取消主题和全局状态订阅、移除事件监听和定时器。
21
+ - 非 qiankun 环境可以独立 render,但独立预览不代表主应用集成验证已经完成。
22
+
23
+ 不要把 root 固定为全局 `document.querySelector('#root')`;嵌入时优先从传入 container 查找。
24
+
25
+ ## 样式和弹层隔离
26
+
27
+ AntD 的 Portal、静态 message 和 notification 必须挂载到仍在 document 中的微应用容器。主应用切换主题或替换容器后,应重新解析容器,避免持有脱离文档的旧节点。
28
+
29
+ `StyleProvider` 的 container 与 popup container 保持在微应用样式边界内。卸载时清理自动注入的样式。
30
+
31
+ ## 不应机械复制的内容
32
+
33
+ 特定 store、业务 SDK、地图全局对象、面包屑 DOM 注入或项目切换方法是业务实现。只有目标需求确实依赖时才引入,并补充清理和类型定义。
@@ -0,0 +1,96 @@
1
+ # 路由与主应用上下文
2
+
3
+ ## 路由
4
+
5
+ qiankun 环境下使用主应用提供的 `base`:
6
+
7
+ ```tsx
8
+ <BrowserRouter basename={window.__POWERED_BY_QIANKUN__ ? base : '/'}>
9
+ <App {...props} />
10
+ </BrowserRouter>
11
+ ```
12
+
13
+ manifest `entries[].path`、React 路由和主应用菜单入口必须对应。动态入口的 `{id}` 与前端参数解析保持一致。
14
+
15
+ ## 常见主应用 props
16
+
17
+ 当前模板以 `create-micro-app@0.0.52-alpha.15` / `sdf-main-sdk@6.2.48` 为基线,完整类型维护在生成项目 `src/interfaces.ts`,从入口 re-export。不要在 typings.d.ts 或业务页面重复声明旧契约。
18
+
19
+ - `projectId` 表示当前家庭或业务项目 ID,配合 `isolationType` 区分。家庭模式不能再将 projectId 当作另一个业务项目 ID;不能与工具工作区标识混淆;通用能力包不要求额外开发平台的项目 ID。
20
+ - 使用 `getCurrentUser()` 及标准 `user_id/user_name/user_nick_name/roles` 字段;`user()` 是旧兼容入口。
21
+ - 权限使用 `hasPermission`;跨应用使用 `hasGPermission(appCodeOrUuid, permissionGroup)`,`permissionsCode(group)` 获取映射后的权限码。前端检查不代替 backend 可信身份和对象范围校验。
22
+ - `mainHistory` 支持 push/replace(path,state)、go/goBack/goForward。跨应用目标通过 state 的 universal_id/app_code 指定,真实宿主还支持 blank;单应用 Mock 对未加载目标和 blank 明确拒绝。
23
+ - `switchHome(id,autoRefresh)`;项目空间跳转使用 `await switchProjectToSpace(projectId,spaceId,autoReload)`,目标页面读取并清理 pending space。不要依赖非标准 `switchProject` 或预览的 homeId 别名。
24
+ - 布局使用 setLoading/setHeaderVisible/setSiderVisible/setSiderCollapsed/setLayoutNoPadding;面包屑使用 dynamicProps.setBreadcrumb。
25
+ - `themeSubscribe.getValue()` 返回完整 ConfigProvider 配置,直接透传,不强行替换宿主算法。SDK 6.2.48 通知为 `('CHANGE THEME', config)`,模板已修正蓝图的回调类型。订阅须在组件卸载时解除。
26
+ - region 的新加坡代码是 `sg`。配置读取 customConfig(原始字符串)/structConfig(解析后对象);不能在配置或日志写入密钥。
27
+ - 开发 Mock 尚不模拟 MQTT、顶部二级菜单和 TPM;相关调用明确失败。需要这些能力时先确认具体契约,再扩展预览与测试,不用生产连接作兜底。
28
+
29
+ ## 面包屑和跨应用导航
30
+
31
+ - 使用 `dynamicProps.setBreadcrumb`,不要直接操作主应用 DOM;只有缺乏正式接口且用户明确接受兼容方案时才使用 DOM 兜底。
32
+ - 默认面包屑在挂载或路由初始化时设置,避免主题重渲染覆盖子页面状态。
33
+ - 跨微应用导航使用主应用提供的 history/SDK,不拼接未知部署路径。
34
+
35
+ ## 上下文隔离
36
+
37
+ 请求需要项目、家庭或空间上下文时,以云端接口契约和主应用传值为准。统一在请求层添加经过确认的 header,禁止在各页面散落上下文拼装逻辑。
38
+
39
+ <a id="scope-result-freshness"></a>
40
+ ## 范围切换与查询结果时效
41
+
42
+ 此规则适用于受支持模式内的家庭、项目、空间节点及全部可读范围切换,不限于“不支持项目”场景。列表、统计、详情、选择项和错误均属于发起请求时的身份与查询范围,不能跨范围复用。
43
+
44
+ - 为每类查询建立完整查询键:当前可信身份/租户、isolationType、家庭或业务项目 ID、spaceId(区分省略与真实节点)、includeDescendants、dataset、该接口实际支持的来源/筛选条件,以及列表页码和 pageSize。统计与列表可以有不同 dataset,必须标注统计所属范围及统计口径,不能将 BASE 统计伪装为某来源的数量。
45
+ - 范围、身份或统计依赖条件变化时,先使旧结果失效并清理旧统计、总数、选择及相关详情,再请求新数据;列表重置第一页。自动查询显示加载中;手动查询也必须立即清空旧结果,显示“请查询当前范围统计”,不能一直显示旧数字等用户发现。尚未查询、加载中、查询失败与成功返回 0 必须区分,禁止把未知结果显示为 0。
46
+ - 每类请求维护单调递增的 requestGeneration,范围切换、重新查询及卸载都使旧代次失效。只有查询键及代次同时匹配当前请求才能写入状态;单独比较空间 ID 无法防止 A→B→A 时第一次 A 的旧响应回填。列表和统计独立管理代次,避免互相取消。
47
+ - AbortController 可用于停止旧请求,但不能作为唯一正确性保障。旧成功、旧错误及 finally 中的 loading 清理都必须经过相同有效性检查,取消请求不能生成网络错误提示;卸载后不能更新状态。上游可能已完成或不支持取消,仍需忽略其结果。
48
+ - 已发出的写请求不因取消而回滚,结果属于原范围,不在新范围自动重试;缓存键也必须区分身份与范围。此处前端状态隔离不代替后端权限检查。
49
+
50
+ ### 必须在生成项目实现的回归
51
+
52
+ 使用真实组件/请求适配层和可控制完成顺序的 deferred promise,断言渲染结果、错误、loading、分页及发出的参数;不要仅测试另写的演示状态机,也不要用任意 sleep 制造时序。
53
+
54
+ | 用例 | 操作与预期 |
55
+ | --- | --- |
56
+ | SCOPE-EMPTY-RETURN | 全范围统计 875 → 空子空间:旧统计立即消失,成功后为 0;手动查询模式先显示未查询;返回全范围重新显示对应数据,分页回到 1,选择清空。 |
57
+ | SCOPE-LATE-SUCCESS | A 慢请求 → B 快请求,先完成 B 再完成 A;页面只能保留 B 的列表及统计。 |
58
+ | SCOPE-LATE-ERROR | A 旧请求在 B 成功后失败,不得覆盖 B 或显示旧错误;A 的 finally 也不得提前关闭仍在加载的 B。 |
59
+ | SCOPE-ABA | A→B→A,最后一次 A 先完成,第一次 A 后完成;相同查询键也必须通过代次排除旧结果。 |
60
+ | SCOPE-IDENTITY | 同一节点下切换身份/项目/家庭、dataset 或有效筛选;旧数据不能复用;卸载及取消后不回填、不产生误报。 |
61
+
62
+ 本地组件回归与真实 SaaS 验收分别记录。真实环境至少完成“全范围→空子空间→返回全范围”,确认统计范围、列表页码及错误提示一致;只有文档检查或 Mock 通过不能声明生成项目已实现上述行为。
63
+
64
+ ## 不支持项目的微应用遇到项目空间
65
+
66
+ `manifest.annotations['sdf.feat.upgradeSupportProjects'] = false` 是应用能力声明,不保证宿主不会切换到项目上下文。首次进入、宿主切换/重挂载、恢复页面时都要判断“应用支持的模式 × 当前可信宿主上下文”,不能只在初始化时检查一次,也不能为了消除错误自动将声明改成 true。
67
+
68
+ 从已确认的宿主 props/SDK 契约读取 isolationType 及 projectId,按实际枚举识别家庭/项目;projectId 在家庭模式也可能是家庭 ID,不能以它非空、空间名称、树形外观或是否有 spaceId 猜测类型。未知枚举/尚未就绪的上下文单独处理,不默认为家庭。声明缺失时按历史工程契约核验能力,不擅自认为支持项目。
69
+
70
+ ### 前端状态与请求门控
71
+
72
+ 在统一上下文适配层派生至少四种状态:加载中、缺少/无法识别上下文、当前模式不支持、模式兼容。权限和网络错误再分别处理,不将“不支持项目”当作无数据或网络故障。
73
+
74
+ 1. 进入项目模式且应用仅支持家庭时,在依赖空间的内容区显示能力提示:“此微应用暂不支持项目空间,请在左上角切换到家庭空间后使用。”用户不需要联系管理员或反复重试。无关的、已确认不依赖空间的功能可以保留。
75
+ 2. 不发送该不支持范围下的列表、详情、搜索、统计、写入或导出请求;暂停对应轮询/订阅,隐藏或禁用新增/编辑/删除等操作。不能继续用上一个家庭 ID 查询,也不能去掉上下文参数、选择第一个家庭或改为全量查询。
76
+ 3. 宿主切换时清空旧记录、总数、选中项、打开的详情/编辑弹窗和旧表单,取消或使旧请求失效;后到响应不能重新填回页面。已发送的写请求不能假定取消就已回滚,其结果仍归原上下文;必要时说明结果待确认,不在新范围自动重试。
77
+ 4. 只有回到受支持且身份/范围就绪的家庭上下文,才重新验证权限并加载该家庭的数据;重置不适用的页码/选择,结束不支持状态。不能要求用户手动刷新整页才能恢复。
78
+ 5. 空间选择器属于宿主,微应用不得操作宿主 DOM、隐藏整个宿主入口或私自替用户切换。存在已确认的打开选择器能力时,才提供“切换空间”按钮并真实接线;否则只展示操作说明,禁止无作用按钮。无可选家庭时说明需使用受支持的家庭空间,不虚构创建/跳转入口。
79
+
80
+ 默认不展示“重试”按钮:改变空间模式才会改变该结果。仅真实网络错误提供重试,不做自动重试循环。文案走现有国际化机制,不在 UI 裸露内部错误码。
81
+
82
+ ### 服务端拒绝的兜底映射
83
+
84
+ 即使前端已门控,backend 仍须依据可信上下文拒绝不支持的范围。若已确认的自定义 API 契约返回如 `PROJECT_SCOPE_NOT_SUPPORTED`,请求适配层将它映射为上述“不支持当前空间”状态,而不是通用“加载失败,请稍后重试”。该错误码是业务契约示例,不是所有涂鸦标准 API 的统一错误码;先核对当前接口,其他错误仍按真实原因处理。
85
+
86
+ 处理响应前先检查它是否属于当前上下文/请求代次,旧项目请求的错误不得覆盖已切回家庭的新页面。不得吞掉拒绝并伪装为空列表,不关闭 backend 范围校验、不篡改签名上下文、不自动开启项目支持。
87
+
88
+ ### 验收
89
+
90
+ - 应用不支持项目:首次直接进入项目空间、家庭切项目两种入口均展示能力提示,没有该范围下的业务请求、写按钮或无效重试。
91
+ - 旧家庭有数据且请求在途:切项目后记录/统计/表单清空;旧成功响应或错误不回填;已发写操作不迁移到新范围。
92
+ - 项目切回家庭:自动恢复对应家庭数据和权限;旧项目拒绝不覆盖新的家庭结果。
93
+ - 后端返回约定的不支持错误:呈现同一能力状态;普通网络失败仍保留正常重试路径。
94
+ - 支持项目的应用、未选择空间、上下文加载中、无权访问分别验证,不能误拦截或混成一个错误提示。
95
+
96
+ 使用实际宿主契约和 DEV 空间切换操作验证;Mock 只能证明预览中的行为,真实 SaaS 宿主联调另行记录。
@@ -0,0 +1,45 @@
1
+ # Real SaaS errors and field presentation
2
+
3
+ Use when integrating standard APIs, rendering service fields, or fixing a request that works in Mock but fails in the assembled SaaS.
4
+
5
+ ## Trace before changing the public request
6
+
7
+ Capture exact method, public path, safe parameter shape, HTTP status, business code and requestId/tid. Never copy cookies, signatures, tokens, credential headers or raw business logs into reports. Compare the catalog, gateway binding, trusted context, adapter conversion and downstream validation before changing a public request. Do not invent fields or switch to an older API as a workaround.
8
+
9
+ D01/D02/D03 expose `spaceId`, not legacy internal `spaceType`. The service derives node type from trusted scope/readable space data. Test omitted root selection, home, room, room group, project root, readable child and denied child. Do not classify every node as a home.
10
+
11
+ Check each browser's environment route separately. Approved integration-only `envTag` rules belong in the integration environment, never hardcoded into generated production requests. Safari request overrides require Web Inspector to remain open.
12
+
13
+ ## Safe, actionable errors
14
+
15
+ Reuse the template's `src/api/errors.mjs` and provide localized messages. `GATEWAY_NOT_FOUND` is routing failure, not a missing business record. `13890012` is invalid parameters, not a permission denial or network outage. Classify `MAP_CSRF_REJECTED` before generic 403. Keep login, permission, conflict, unsupported capability, network, service and unknown write results distinct.
16
+
17
+ Use `errorReference` for safe code/correlation references. Never display raw exception messages, HTML, stack traces or server addresses. Read failure must not claim a write might have happened. Never automatically repeat commands or uncertain writes.
18
+
19
+ Keep errors local to device query, record query, save form and control submission. Clear a query's previous error on retry and success; guard late successes AND failures with generations/cancellation. Tab switching must not show unrelated errors. Failed save preserves input and shows its classified reason in the form. Save success followed by refresh failure is not failed creation; retry the read only.
20
+
21
+ ## Semantic fields and raw values
22
+
23
+ Use template `src/api/presentation.mjs`, explicitly passing the field key and current language. Business empty/null values show Not provided; booleans use localized Yes/No; supported function types use readable labels. Known timestamp fields render seconds/milliseconds/ISO values with a visible timezone. IDs and arbitrary names must never become dates or enum labels.
24
+
25
+ Raw DP `value` has separate semantics: retain 0, false and empty string (`""`) distinctly. Do not translate/coerce control values. Unknown type or missing constraints stays display-only; do not invent schema or enable controls merely because writable=true.
26
+
27
+ ## Regression cases
28
+
29
+ 1. HTTP 200 + numeric/string validation error; routing 404 vs business 404; CSRF vs permission; safe correlation and suppression of raw messages.
30
+ 2. Failed query → successful retry clears error. Device failure arriving while records succeed cannot pollute records. Older failures cannot overwrite newer success.
31
+ 3. Save denial/conflict/unknown result retains input and shows a specific message. Successful save + failed refresh cannot create a duplicate.
32
+ 4. Business empty/false/zero vs raw empty/false/zero; seconds/milliseconds/ISO and invalid dates; unknown type vs ordinary ID/name with enum-like text.
33
+ 5. Function fixtures must match the actual public response and include unknown/missing constraints. A platform adapter must normalize upstream schema envelopes (for example `obj` with `property.type`) before returning public types; generated clients must not guess vendor-internal types.
34
+ 6. Real minimal D01/D02/D03 in both supported models, plus child-node queries. Mock, build and registered route existence are not real API acceptance.
35
+ 7. Report passed/failed/blocked/not-tested separately. Real control needs an authorized target/action. Keep family default-role limits separate from project individual grants/revocation.
36
+
37
+
38
+ Pagination regression must include zero matches and a page beyond the end: keep the requested page size and the actual total, and never derive either from `items.length`. Function option tests must distinguish stable codes from localized labels; select and submit the public ENUM code. See cloud-integration `references/calling-conventions.md` for the empty-page and schema option contract.
39
+
40
+
41
+ ## Database write restrictions
42
+
43
+ For create/update/delete/import forms, read [database write errors](../../micro-app-backend-development/references/database-write-errors.md). Use `databaseErrorMessage(error, locale)` from the template after `requestError` classification. Read-only and database-role restrictions share a localized “database writes are restricted; contact the administrator” message without capacity claims; do not collapse them into HTTP 503 service failure, unknown-write or end-user permission denial. Preserve form input, show the reason and request reference locally, stop the spinner and never automatically resubmit. Unknown transactions remain unknown. Do not assert “input retained” unless implemented and tested; leave independent reads available.
44
+
45
+ Custom micro-app backends use HTTP 200 + success:false for business rejections and HTTP 500 + safe JSON for system failures. Keep the response interceptor checking success before returning a result. Both paths must reach localized form errors; do not clear inputs or show a success toast merely because HTTP status is 200. Standard platform APIs and infrastructure-generated failures retain their own status contracts, including HTML/503 fallback; never infer database restrictions without the structured code.
@@ -0,0 +1,30 @@
1
+ # 标准 API 网关地址与验收
2
+
3
+ 浏览器标准端请求必须是同源 `/open-api/v1.0/...`(其他已声明接口版本同理),只包含一次 `/open-api`。API 目录及 manifest.apis[].path 使用 `/v1.0/...` 业务路径,不把浏览器网关前缀写进声明。自定义 backend 使用 `/custom-aicoding-api/{code}/...`,backend 自身路由仍为 `/api/...`;它们都不增加 `/open-api`。不能给静态资源、外部服务或所有 URL 统一加前缀。
4
+
5
+ ## 同一套请求入口
6
+
7
+ 模板 `src/api/api-request.mjs` 提供 `standardApiPath`、`apiRequestConfig` 和 `fetchInHost`。Axios 通过 `src/api/index.ts` → `req.ts` → `apiRequestConfig`,fetch 直接使用 `fetchInHost`。两种方式共用标准地址归一和自定义通道 Accept 规则,不只在预览里修地址,不期待正式宿主自动补前缀。
8
+
9
+ ```ts
10
+ import api from './index';
11
+ import { fetchInHost } from './api-request.mjs';
12
+
13
+ const path = '/v1.0/m/sdf/agent-open/home-space/home/get';
14
+ export const getHome = () => api.get(path);
15
+ export const fetchHome = () => fetchInHost(path);
16
+ ```
17
+
18
+ 标准业务路径由公共入口加一次前缀;已带前缀时保持原样。Axios 按真实 baseURL 与 url 拼接后的同源目标判断,归一后不再次拼 baseURL。`baseURL='/open-api'` 配合业务路径可以保留,但不要再手工给 url 添加同一前缀;重复前缀返回 `STANDARD_API_PREFIX_INVALID`,应修复调用或默认配置。优先复用模板实例,不新建绕过拦截器的 Axios/fetch 客户端。
19
+
20
+ 查询参数、编码后的 ID、重复 query 参数、请求体、宿主身份/范围/CSRF 头与取消信号均保留。URL 归一不提供鉴权,不重试业务写入,不改变标准 API 的 Accept 约定;自定义 JSON Accept 继续按[自定义请求封装](custom-api-requests.md)处理。通用 fetch 入口在宿主拦截前显式设置大写 method,支持 `Request` 的方法、原头及 body;请求体消费和覆盖仍遵循原生 fetch 语义。
21
+
22
+ ## 预览严格检查
23
+
24
+ HTTP 预览入口拒绝缺少前缀的 `/v1.0/...`,返回 HTTP 400、`success:false`、`STANDARD_API_PREFIX_REQUIRED` 和安全修复说明;重复前缀返回 `STANDARD_API_PREFIX_INVALID`。不自动修复请求,也不读写 Mock 业务数据。浏览器 bridge 不为裸业务路径补地址或注入宿主上下文。直接调用 Mock store 的单元测试可以使用业务路径,不代表浏览器入口支持无前缀。
25
+
26
+ 排查时同时核对最终 Request URL、Axios baseURL、调用实例/拦截器、method 和 manifest 声明。GET 和一个实际写操作都应检查;补前缀不能替代身份、范围、权限或响应验收。既有标准接口、可信后端回调的 `/open-api` 地址保持原契约。
27
+
28
+ ## 既有项目升级
29
+
30
+ 工具升级不会自动修改业务源码。显式同步 `api-request.mjs`、`request-url.mjs`、自定义头 helper、`req.ts` 及实际业务调用,保留业务路径声明;重新构建并在严格预览中验收。真实 SaaS Network 另行核对最终地址只有一次前缀及真实响应,不能以 Mock 成功宣称正式接入通过。不修改已发布归档、用户缓存或原已受理请求。
@@ -0,0 +1,51 @@
1
+ # 表单提交阶段与安全诊断
2
+
3
+ 适用于有 backend 的新增、编辑、删除、导入和其他写入。页面错误不证明请求已发送;Network 空列表也不证明未发送,先清空过滤/反转并保留日志,再核对实际请求与 Console。只在明确证据下报告阶段,不凭 `!error.response` 判断网络故障。
4
+
5
+ | 阶段 | 判定与用户反馈 | 诊断与恢复 |
6
+ |---|---|---|
7
+ | 字段校验 | AntD `errorFields` 定位字段;不发请求,不显示服务保存失败 | `validation / FORM_VALIDATION_FAILED / notStarted`;保留输入并定位字段 |
8
+ | 校验器自身异常 | 与正常字段校验区分,提示联系开发者 | `validation / FORM_VALIDATION_EXCEPTION / notStarted`;不把异常原文或字段值写日志 |
9
+ | 请求准备 | 参数转换、序列化、URL/请求头检查明确在发送前失败 | `prepare / CLIENT_PREPARATION_FAILED` 或受控原码,`notStarted`;修复调用,不改权限或数据库 |
10
+ | 传输失败 | 已调用传输入口且无响应;不能保证服务器未收到 | `transport / network / attempted`;写入结果待核实,不自动重试,不宣称已回滚 |
11
+ | 后端业务拒绝 | 收到结构化 `success:false`,即使 HTTP 200 | `response`,保留安全业务码/状态/关联编号;提示对应业务条件,保留输入 |
12
+ | 系统或响应故障 | HTTP 500 或响应格式无法识别 | 分别为 `service` / `response`;写入可能已提交,先查询核实,不重放 |
13
+ | 未分类提交回调异常 | 可能发生在请求前,也可能发生在保存成功后的代码中 | `submit / CLIENT_SUBMISSION_FAILED / unknown`;不能标为“未发送”,先核对保存结果 |
14
+
15
+ 取消/过期校验不显示失败 Alert。以上是微应用请求和 UI 的分类,平台标准 API 和网关保持自己的 HTTP 契约;不修改接口状态以绕过分类。数据库写入限制继续按既有安全业务码提示,不推断容量超额。
16
+
17
+ ## 实际接线
18
+
19
+ Axios 复用模板实例,`req.ts` → `apiRequestConfig` 对准备失败标记阶段;`res.ts` → `responseEnvelope` / `transportError` 处理响应和传输。不能重新使用 `networkError: !error.response`,也不能将所有错误转成新的通用 Error。业务包只解包一次。
20
+
21
+ fetch 的 `fetchInHost` 返回原始 Response,只处理请求准备/传输;预期 JSON envelope 的业务调用优先使用 `fetchJsonInHost`,返回整个成功 envelope。两者都不自动重试、也不替调用者序列化 body。文件下载等非 envelope 接口继续使用原始 Response,并按自己的契约检查状态。
22
+
23
+ 例如在 `src/api/stories.ts`:
24
+
25
+ ```ts
26
+ import api from './index';
27
+ import { customApiPath } from './custom-api';
28
+ import { prepareSubmission } from './submission-errors.mjs';
29
+
30
+ async function save(values: { title: string }) {
31
+ const payload = await prepareSubmission(() => ({ title: values.title.trim() }));
32
+ const path = customApiPath('/api/stories');
33
+ return api.post(path, payload);
34
+ }
35
+ ```
36
+
37
+ `prepareSubmission` 只能包住确定发生在请求前的转换/校验。不要包住 API 调用、后端保存或保存后的刷新,否则会错误宣称“尚未发送”。fetch 的 `JSON.stringify` 同样放入准备阶段。普通字段必填规则仍放 AntD rules;业务后端必须重新校验。
38
+
39
+ `ModalForm` 继续支持既有 `failureMessage`,但它仅作为明确拒绝/普通业务错误的兜底,不覆盖客户端/网络/系统分类。传入当前界面 `language`;中英有内置安全文案,其他语种通过 `errorMessage(diagnostic)` 提供已审核词条,也可按已确认业务码细化原因。回调只收到安全元数据,没有原始异常。错误码和关联编号自动显示为可反馈的参考信息。
40
+
41
+ 通过 `onDiagnostic(diagnostic)` 接入项目现有开发诊断,仅记录 `stage/kind/code/dispatchState/method/status/requestId/writeResultUnknown`;不得传递原始 Error、stack、请求 URL/query/body/headers、表单值、Cookie、Token、签名或数据库信息。不以“用户不能看原始异常”为理由吞掉安全诊断,也不默认向远端上报。
42
+
43
+ 保存错误只归当前表单,列表查询错误归列表;取消、成功或新一轮提交按对应操作清理。保存成功后刷新失败提示“已保存,列表更新失败”,只重试查询,不向 ModalForm 抛成保存失败。取消/关闭只结束当前视图,不代表后台写入已撤销;旧会话迟到结果不能污染新弹窗。
44
+
45
+ ## 回归与排查
46
+
47
+ 实际浏览器覆盖:空字段点击和 Enter 均不发请求;准备阶段异常不发请求且显示受控码;合法提交发出一次;断网/超时与 HTTP 200 业务拒绝显示不同原因;HTTP 500、HTML/错误 envelope 保留结果未知;输入保持、loading 结束、不自动重试。验证取消、连点、切换对象和关闭后迟到异常;错误仅在当前表单出现,不向背景列表重复展示。
48
+
49
+ 记录请求次数和安全阶段证据,不只断言 toast 或 helper 存在。真实 DEV backend 的持久化/权限与 UI 测试替身分别验收;不能以本地 Mock/浏览器路由替身证明真实后端已保存。
50
+
51
+ 现有用户项目须显式同步相关请求封装和表单源码、重新构建验收;升级工具不会自动覆盖业务源码、旧缓存或已发布归档。
@@ -0,0 +1,117 @@
1
+ #!/usr/bin/env node
2
+ import { readFileSync, lstatSync, existsSync, readdirSync } from "node:fs";
3
+ import { resolve, join, dirname, basename, relative } from "node:path";
4
+ import { homedir } from "node:os";
5
+ import { createHash } from "node:crypto";
6
+ import { pathToFileURL, fileURLToPath } from "node:url";
7
+ try {
8
+ const args = process.argv.slice(2),
9
+ index = args.indexOf("--project");
10
+ if (index < 0 || !args[index + 1] || args[index + 1].startsWith("--"))
11
+ throw new Error("PROJECT_REQUIRED: --project <path>");
12
+ const project = resolve(args[index + 1]);
13
+ const metadata = join(project, ".tuya-microapp");
14
+ const updating = existsSync(join(metadata, "update.json"));
15
+ const installing = existsSync(join(metadata, "setup.lock"));
16
+ if (updating || installing) {
17
+ let verifier = false;
18
+ if (["doctor", "help"].includes(args[0]) && process.env.TUYA_MICROAPP_UPDATE_VERIFIER) {
19
+ const transaction = JSON.parse(readFileSync(join(metadata, "update.json")));
20
+ const owner = JSON.parse(readFileSync(join(metadata, "setup.lock/owner.json")));
21
+ verifier = transaction.id === process.env.TUYA_MICROAPP_UPDATE_VERIFIER
22
+ && transaction.phase === "committed" && owner.pid === process.ppid;
23
+ }
24
+ if (!verifier) throw new Error(updating ? "UPDATE_RECOVERY_REQUIRED" : "SETUP_IN_PROGRESS");
25
+ }
26
+ const lock = JSON.parse(
27
+ readFileSync(join(project, ".tuya-microapp/toolchain.json"))
28
+ );
29
+ if (
30
+ lock.format !== "tuya-microapp-toolchain-v1" ||
31
+ lock.protocolVersion !== 1 ||
32
+ !/^\d+\.\d+\.\d+(?:-[a-z0-9.-]+)?$/.test(lock.version) ||
33
+ !/^[a-f0-9]{64}$/.test(lock.bundleSha256)
34
+ )
35
+ throw new Error("INVALID_TOOLCHAIN");
36
+ const packages = join(
37
+ process.env.TUYA_MICROAPP_HOME || join(homedir(), ".tuya-microapp"),
38
+ "packages"
39
+ );
40
+ // Do not import cached code before verifying the exact lock identity.
41
+ const precise = join(packages, `${lock.version}-${lock.bundleSha256}`);
42
+ const cache = lstatSync(precise, { throwIfNoEntry: false }) ? precise : join(packages, lock.version);
43
+ for (let p = resolve(cache); ; p = dirname(p)) {
44
+ if (
45
+ lstatSync(p, { throwIfNoEntry: false })?.isSymbolicLink() &&
46
+ !(process.platform === "darwin" && ["/var", "/tmp"].includes(p))
47
+ )
48
+ throw new Error("SYMLINK_CACHE");
49
+ if (dirname(p) === p) break;
50
+ }
51
+ const bytes = readFileSync(join(cache, "bundle.json"));
52
+ if (createHash("sha256").update(bytes).digest("hex") !== lock.bundleSha256)
53
+ throw new Error("BUNDLE_INTEGRITY_MISMATCH");
54
+ // Verify every file before importing any installed executable module.
55
+ const manifest = JSON.parse(bytes);
56
+ for (const [name, hash] of Object.entries(manifest.files || {})) {
57
+ if (
58
+ name.startsWith("/") ||
59
+ name.split("/").some((x) => !x || x === "..") ||
60
+ name.includes("\\")
61
+ )
62
+ throw new Error("INVALID_BUNDLE_PATH");
63
+ const path = join(cache, name);
64
+ for (let p = path; p !== cache; p = dirname(p)) {
65
+ if (lstatSync(p).isSymbolicLink()) throw new Error("SYMLINK_CACHE");
66
+ }
67
+ if (createHash("sha256").update(readFileSync(path)).digest("hex") !== hash)
68
+ throw new Error("BUNDLE_INTEGRITY_MISMATCH");
69
+ }
70
+ const skillRoot = resolve(dirname(fileURLToPath(import.meta.url)), ".."),
71
+ skillName = basename(skillRoot);
72
+ const expected = Object.fromEntries(
73
+ Object.entries(manifest.files)
74
+ .filter(([key]) => key.startsWith("skills/" + skillName + "/"))
75
+ .map(([key, value]) => [
76
+ key.slice(("skills/" + skillName + "/").length),
77
+ value,
78
+ ])
79
+ );
80
+ const actual = {};
81
+ function walk(dir) {
82
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
83
+ const path = join(dir, entry.name);
84
+ if (entry.isSymbolicLink()) throw new Error("SKILL_VERSION_MISMATCH");
85
+ if (entry.isDirectory()) walk(path);
86
+ else
87
+ actual[relative(skillRoot, path).split("\\").join("/")] = createHash(
88
+ "sha256"
89
+ )
90
+ .update(readFileSync(path))
91
+ .digest("hex");
92
+ }
93
+ }
94
+ walk(skillRoot);
95
+ if (
96
+ !Object.keys(expected).length ||
97
+ Object.keys(actual).length !== Object.keys(expected).length ||
98
+ Object.entries(actual).some(([k, v]) => expected[k] !== v)
99
+ )
100
+ throw new Error("SKILL_VERSION_MISMATCH");
101
+ const { main } = await import(pathToFileURL(join(cache, "runtime/cli.mjs")));
102
+ await main(args);
103
+ } catch (e) {
104
+ console.log(
105
+ JSON.stringify({
106
+ protocolVersion: 1,
107
+ status: "failed",
108
+ nextActions: ["Use the exact business project directory for setup and subsequent commands. If its lock is missing, run the trusted complete package setup --project <that-directory> --agent <host>; do not copy a parent lock or bypass verification. Preserve existing caches; use the lock's exact version and digest."],
109
+ errorCode:
110
+ e.code === "ENOENT"
111
+ ? "TOOLCHAIN_NOT_INSTALLED"
112
+ : /^[A-Z][A-Z0-9_]*(?::|$)/.exec(e.message)?.[0].replace(/:$/, "") ||
113
+ "LAUNCHER_FAILED",
114
+ })
115
+ );
116
+ process.exitCode = 3;
117
+ }