@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,244 @@
1
+ # 家庭、成员、家庭角色与地理查询
2
+
3
+ 契约日期:2026-11-03。完整目录共47条路由,仅目录列出的能力可用于本版标准端API选型。
4
+
5
+
6
+ 通用身份、错误、示例与状态见[调用约定](calling-conventions.md);返回模型见[api-models.md](api-models.md)。下表类型是网关输入类型,query数值/布尔值按URL编码传递,body保持JSON类型。
7
+
8
+ ## H01 · 家庭分页列表
9
+
10
+ `GET /v1.0/m/sdf/agent-open/home-space/home/page`
11
+
12
+ `result`:`HomeResponses.Page<HomeResponses.Home>`。
13
+
14
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
15
+ |---|---|---|---|---|
16
+ | `page` | QUERY | INTEGER | 否 | `1` |
17
+ | `pageSize` | QUERY | INTEGER | 否 | `20` |
18
+ | `name` | QUERY | STRING | 否 | `` |
19
+
20
+ 权限、语义与限制:按原个人排序分页,包含WAITING/ACCEPT关系;membershipState用于区分,不在分页后过滤并伪造total。page≥1,pageSize为1–100,name≤100字符。
21
+
22
+ ## H02 · 家庭详情
23
+
24
+ `GET /v1.0/m/sdf/agent-open/home-space/home/get`
25
+
26
+ `result`:`HomeResponses.Home`。
27
+
28
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
29
+ |---|---|---|---|---|
30
+ | 无业务入参 | — | — | — | 当前上下文由宿主会话提供 |
31
+
32
+ 权限、语义与限制:只读取当前HOME上下文,无homeId入参;PROJECT模式返回UNSUPPORTED_CONTEXT。统计unknown可能为null。
33
+
34
+ ## H08 · 房间组列表
35
+
36
+ `GET /v1.0/m/sdf/agent-open/home-space/room-group/list`
37
+
38
+ `result`:`HomeResponses.Collection<HomeResponses.RoomGroup>`。
39
+
40
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
41
+ |---|---|---|---|---|
42
+ | `homeId` | QUERY | STRING | 否 | `` |
43
+
44
+ 权限、语义与限制:HOME仅查询当前家庭:省略homeId或传当前家庭ID;其他ID返回HOME_CONTEXT_MISMATCH。仍校验当前家庭有效成员。PROJECT需指定目标homeId并明确通过空间READ校验。返回全部房间组元数据,不表示设备控制权限。
45
+
46
+ ## H13 · 推荐房间名称
47
+
48
+ `GET /v1.0/m/sdf/agent-open/home-space/room/default-list`
49
+
50
+ `result`:`HomeResponses.Collection<HomeResponses.RoomTemplate>`。
51
+
52
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
53
+ |---|---|---|---|---|
54
+ | `homeId` | QUERY | STRING | 否 | `` |
55
+
56
+ 权限、语义与限制:HOME省略homeId或传当前家庭ID;其他ID返回HOME_CONTEXT_MISMATCH。PROJECT指定目标homeId并通过空间READ校验。返回推荐名称与默认选中状态。
57
+
58
+ ## H14,H15 · 基础房间列表
59
+
60
+ `GET /v1.0/m/sdf/agent-open/home-space/room/list`
61
+
62
+ `result`:`HomeResponses.Collection<HomeResponses.Room>`。
63
+
64
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
65
+ |---|---|---|---|---|
66
+ | `homeId` | QUERY | STRING | 否 | `` |
67
+ | `roomGroupId` | QUERY | STRING | 否 | `` |
68
+ | `includeDeviceCounts` | QUERY | BOOLEAN | 否 | `false` |
69
+
70
+ 权限、语义与限制:HOME省略homeId或传当前家庭ID;其他ID返回HOME_CONTEXT_MISMATCH。PROJECT指定目标homeId并通过空间READ校验。includeDeviceCounts=false取基础房间列表,true带原统计;roomGroupId为组内筛选。家庭可读后返回全部房间元数据。
71
+
72
+ ## R01 · 家庭可分配角色列表
73
+
74
+ `GET /v1.0/m/sdf/agent-open/home-role/role/list`
75
+
76
+ `result`:`Collection<RoleResponses.Role>`。
77
+
78
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
79
+ |---|---|---|---|---|
80
+ | 无业务入参 | — | — | — | 当前上下文由宿主会话提供 |
81
+
82
+ 权限、语义与限制:家庭可分配角色列表,仅当前HOME且ADMIN(含OWNER)。OWNER可选admin/member,ADMIN可选member;均包含家庭自定义角色。系统id/code为admin/member,自定义id为数字字符串、code为null。
83
+
84
+ ## R03 · 家庭自定义角色列表
85
+
86
+ `GET /v1.0/m/sdf/agent-open/home-role/custom-role/list`
87
+
88
+ `result`:`Collection<RoleResponses.Role>`。
89
+
90
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
91
+ |---|---|---|---|---|
92
+ | 无业务入参 | — | — | — | 当前上下文由宿主会话提供 |
93
+
94
+ 权限、语义与限制:家庭自定义角色列表,沿用OWNER门槛。
95
+
96
+ ## R05 · 家庭自定义角色详情
97
+
98
+ `GET /v1.0/m/sdf/agent-open/home-role/custom-role/get`
99
+
100
+ `result`:`RoleResponses.Detail`。
101
+
102
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
103
+ |---|---|---|---|---|
104
+ | `roleId` | QUERY | LONG | 是 | `` |
105
+
106
+ 权限、语义与限制:家庭自定义角色详情,沿用OWNER及目标角色家庭归属检查。deviceIds是原角色资源配置。
107
+
108
+ ## M01 · 家庭成员列表
109
+
110
+ `GET /v1.0/m/sdf/agent-open/home-user/member/list`
111
+
112
+ `result`:`Collection<MemberResponse>`。
113
+
114
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
115
+ |---|---|---|---|---|
116
+ | 无业务入参 | — | — | — | 当前上下文由宿主会话提供 |
117
+
118
+ 权限、语义与限制:HOME当前家庭成员查询,无目标homeId入参;项目模式拒绝。memberId为家庭成员关系标识。
119
+
120
+ ## H03,S01,S02 · 按家庭查询空间树
121
+
122
+ `GET /v1.0/m/sdf/agent-open/space/trees`
123
+
124
+ `result`:`SpaceResponses.Tree`。
125
+
126
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
127
+ |---|---|---|---|---|
128
+ | `rootId` | QUERY | STRING | 否 | `` |
129
+ | `projectId` | QUERY | STRING | 否 | `` |
130
+ | `includeDeviceCounts` | QUERY | BOOLEAN | 否 | `false` |
131
+
132
+ 权限、语义与限制:HOME省略rootId或传当前家庭ID;其他ID返回HOME_CONTEXT_MISMATCH。PROJECT指定rootId需通过目标家庭空间READ校验,不指定则按原可见节点过滤。家庭树不支持includeDeviceCounts=true。
133
+
134
+ ## B03 · Agent Open 时区列表
135
+
136
+ `GET /v1.0/m/sdf/agent-open/time-zones`
137
+
138
+ `result`:`GeographyResponse.TimeZones`。
139
+
140
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
141
+ |---|---|---|---|---|
142
+ | 无业务入参 | — | — | — | 当前上下文由宿主会话提供 |
143
+
144
+ 权限、语义与限制:时区列表,offsetText是显示文本,勿当实时偏移计算依据。
145
+
146
+ ## B04 · Agent Open 坐标查询时区
147
+
148
+ `GET /v1.0/m/sdf/agent-open/time-zones/query`
149
+
150
+ `result`:`GeographyResponse.TimeZone`。
151
+
152
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
153
+ |---|---|---|---|---|
154
+ | `latitude` | QUERY | DOUBLE | 是 | `` |
155
+ | `longitude` | QUERY | DOUBLE | 是 | `` |
156
+
157
+ 权限、语义与限制:按合法经纬度查询时区;longitude范围[-180,180],latitude范围[-90,90]。
158
+
159
+ ## B05 · Agent Open 坐标查询邮编
160
+
161
+ `GET /v1.0/m/sdf/agent-open/post-code/query`
162
+
163
+ `result`:`GeographyResponse.PostalCode`。
164
+
165
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
166
+ |---|---|---|---|---|
167
+ | `latitude` | QUERY | DOUBLE | 是 | `` |
168
+ | `longitude` | QUERY | DOUBLE | 是 | `` |
169
+
170
+ 权限、语义与限制:按服务端实际部署区域限制:中国区返回success=false、UNSUPPORTED_REGION,不调用邮编查询下游;海外区保留原查询。部署区域不由经纬度、语言、所选国家或客户端region字段决定。海外返回能力依原设施,不能编造邮编。
171
+
172
+ 中国区的合法请求返回HTTP200业务拒绝,`errorCode=UNSUPPORTED_REGION`;界面应提示当前部署区域不支持自动查询并允许手工填写,不自动重试,也不把不支持当作查询成功但邮编为空。海外部署查询中国坐标仍走原查询;错误/空结果不承诺真实命中,保持已有值并由用户手工补充。时区和行政区查询不受此邮编区域限制影响。
173
+
174
+ ## B06 · Agent Open 坐标查询地区
175
+
176
+ `GET /v1.0/m/sdf/agent-open/ad-region/query`
177
+
178
+ `result`:`GeographyResponse.Region`。
179
+
180
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
181
+ |---|---|---|---|---|
182
+ | `latitude` | QUERY | DOUBLE | 是 | `` |
183
+ | `longitude` | QUERY | DOUBLE | 是 | `` |
184
+
185
+ 权限、语义与限制:按经纬度查询行政区,缺失字段可能为null,不保证全球同级行政区。
186
+
187
+ ## R02 · 家庭角色管理列表
188
+
189
+ `GET /v1.0/m/sdf/agent-open/roles/home-role/list`
190
+
191
+ `result`:`AgentOpenCollection<RoleSummary>`。
192
+
193
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
194
+ |---|---|---|---|---|
195
+ | 无业务入参 | — | — | — | 当前上下文由宿主会话提供 |
196
+
197
+ 权限、语义与限制:家庭角色管理列表,要求有效成员且具备OWNER角色,返回包含OWNER在内的系统角色及家庭自定义角色;R01用于查询当前操作者可分配的角色候选,两者不能直接替代。
198
+
199
+ ## B01 · 国家地区字典
200
+
201
+ `GET /v1.0/m/sdf/agent-open/countries`
202
+
203
+ `result`:`AgentOpenCollection<Country>`。
204
+
205
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
206
+ |---|---|---|---|---|
207
+ | 无业务入参 | — | — | — | 当前上下文由宿主会话提供 |
208
+
209
+ 权限、语义与限制:国家列表沿用原SaaS/语言上下文;从`result.items[].regionCode`取得国家行政区编码,作为B02首次查询的`parentCode`。不要使用电话区号`dialingCode`或可能为空的`iso3`代替;`regionCode`也不是服务部署区域。iso3等缺失事实为null。
210
+
211
+ ## B02 · 下级行政区
212
+
213
+ `GET /v1.0/m/sdf/agent-open/administrative-division/list`
214
+
215
+ `result`:`AgentOpenCollection<AdministrativeDivision>`。
216
+
217
+ | 参数 | 位置 | 类型 | 必填 | 默认值 |
218
+ |---|---|---|---|---|
219
+ | `parentCode` | QUERY | STRING | 是 | 无默认值;首次取B01的`regionCode`,后续取B02的`code` |
220
+
221
+ 权限、语义与限制:`parentCode`必填且不能为空,不会自动补`CHN`。中国及海外行政区均可查询,当前接口未按服务部署区域禁止查询;返回范围以原字典服务为准。不是按坐标查询地区的接口,也不套用B05邮编的部署区域限制。`hasChildren`/`level`无来源可为null。
222
+
223
+ ### 国家码与行政区逐级查询
224
+
225
+ 1. 调用B01,取得`result.items`中的国家列表,选中国家后读取其`regionCode`。
226
+ 2. 将该值作为B02的`parentCode`,取得该国家下一层行政区。
227
+ 3. 每次选中一项,将它的`code`作为下一次B02的`parentCode`,逐级加载。`parentCode`字段是当前项的父编码,不是继续下钻的编码。
228
+
229
+ 例如查中国省级行政区时显式传`CHN`;海外国家同样从B01响应取值,不自行拼国家码:
230
+
231
+ ```http
232
+ GET /v1.0/m/sdf/agent-open/countries
233
+ GET /v1.0/m/sdf/agent-open/administrative-division/list?parentCode=CHN
234
+ ```
235
+
236
+ 如果上一步实际返回并选中的行政区`code`为`310000`,继续查询其下一层:
237
+
238
+ ```http
239
+ GET /v1.0/m/sdf/agent-open/administrative-division/list?parentCode=310000
240
+ ```
241
+
242
+ `310000`仅作请求参数示例,不保证各环境实际字典使用这一编码;始终原样使用上级响应的字符串,不按名称、邮编或编码位数推算,不把编码转成数字。不同国家层级不一定是省/市/区三级。`hasChildren=false`可作为叶节点;`null`表示未知,不能当作false,查询返回空`items`时停止本次下钻。
243
+
244
+ 上述只展示业务路径和query;真实请求仍使用宿主SDK与现有登录/SaaS上下文。旧接口中国区可省略参数默认查中国省份的行为,不适用于这个新接口。本地Mock只有有限国家与一级行政区夹具,详见[预览说明](preview-agent-open.md),不能用其空结果判断线上字典范围。
@@ -0,0 +1,95 @@
1
+ # 自定义 API 链路与 backend 权限
2
+
3
+ 更新:2026-10-16。已确认采用内部转发应用直接访问 backend 的方案;接口契约和真实联调就绪后启用生产入口,不允许关闭鉴权兜底。
4
+
5
+ ## 共用入口与上下文
6
+
7
+ 浏览器同源 `/custom-aicoding-api/{microAppCode}/{businessPath}` → sdf网关 → 内部前端环境的专用转发应用。sdf只调用该内部应用,不直接调用backend或区域分发网关。标准端API继续走既有通道。
8
+
9
+ ### Browser CSRF contract
10
+
11
+ For same-origin requests inside the real SaaS host, reuse the host request interceptor:
12
+ `sdf-main-sdk` supplies the current session token as `csrf-token`. The custom API
13
+ entry in `sdf-gw-next` validates this header against the CSRF cookie before forwarding
14
+ Cookie-authenticated writes. `x-csrf-token` is accepted only when `csrf-token` is absent;
15
+ an invalid or empty canonical header must not fall back to another token.
16
+
17
+ Do not hardcode a token, copy a token from a browser extension, read the `_csrf`
18
+ cookie as if it were a request token, or add an independent token cache to each
19
+ micro-app. Preserve same-origin credentials and the host interceptor. Do not send
20
+ tokens in query strings or business JSON. An approved browser integration outside
21
+ the host must use the verified session-token contract; local Mock does not prove it.
22
+
23
+ `MAP_CSRF_REJECTED` is an ingress security failure, not a family/project role denial.
24
+ Classify it before generic HTTP 403: preserve form input and request ID, show a
25
+ localized security-check failure with a refresh/retry action, and do not automatically
26
+ replay writes. Log neither token values nor raw Cookie/headers. GET success does not
27
+ prove that POST/PUT/PATCH/DELETE are integrated correctly.
28
+
29
+ CSRF validation belongs to the browser-facing gateway. The business backend continues
30
+ to validate signed context, replay protection and operation/object/scope permissions;
31
+ it must not require the browser's CSRF header as a replacement for those checks.
32
+
33
+ Real SaaS acceptance must include a successful write with the host-provided header,
34
+ rejection of missing/invalid tokens and cross-origin writes, plus no database change
35
+ on rejected writes. Never disable gateway CSRF or replace authorization to pass a test.
36
+ The host-header gateway fix requires deployment; package guidance alone does not
37
+ change an already running gateway.
38
+
39
+ ### 路径生成与验收
40
+
41
+ - code 使用当前项目 `resource-project.json.microAppCode`,不是 appName、显示名称、universalId 或 SaaS 装配 ID。初始化器将同一 code 写入前后端 `src/microapp-identity.json`;已有项目按已登记身份核对同步,不生成新 code,不改已安装缓存。
42
+ - 复用前端模板 `src/api/custom-api.ts` 的 `customApiPath`。若 handler 为 `backend/src/app/api/devices/route.ts`,业务路径就是 `/api/devices`,浏览器使用 `/custom-aicoding-api/{code}/api/devices`。列表、详情、增删改统一走此封装;动态 ID 单独 encodeURIComponent,query 保留原义。
43
+ - manifest CustomAPI 必须声明完整浏览器路径 `/custom-aicoding-api/{code}/api/devices` 或 `/custom-aicoding-api/{code}/api/devices/{id}`;mock 与请求使用相同完整路径,code 替换为当前项目实际值。网关按声明路径匹配,不负责补充或剥离业务前缀来适配声明。不要登记 `/api/devices` 短路径,也不要重复添加入口前缀。
44
+ - 转发应用只移除一次 `/custom-aicoding-api`,签名 target 和 backend 入站路径均为 `/{code}/api/devices` 加原始 query。backend 先验签,再由 next.config 的 afterFiles 对自身 code 做内部映射到 `/api/devices`;不能在验签前改写 target 或关闭鉴权。
45
+ - 新版本地代理使用相同路径规则,不自动补 `/api`,不接受缺少/错误 code。旧锁定工具需通过完整包 update 流程升级后重启预览;仅改项目源码不会升级代理,不修改历史缓存或手写锁。
46
+ - 回归覆盖完整路径、缺失 code、其他 code、动态 ID、query 编码、GET/写方法以及正式签名绑定。DEV 验收与真实 SaaS 验收分开;404 不能用 Mock 成功解释为集成通过。
47
+
48
+ sdf核验SaaS、用户、当前家庭/项目及对应角色,解析lang。业务上下文为biz.saasId/uid/lang/currentScope.id/type/roleCodes,均必需;tenantCode按业务模型提供。当前选择与角色必须属于本次请求,不能信任浏览器原始身份头或默认admin。微应用ID/版本/范围参数均须核验,客户端不指定backend地址。
49
+
50
+ ## 已确认的转发与验证
51
+
52
+ 平台验证微应用自用归属、固定装配和就绪状态后,通过 HTTPS 将签名请求转发到 backend 统一验签入口。backend 仅接收部署注入的公钥和预期 audience,不接收私钥或主密钥。
53
+
54
+ 2026-10-19 已确认:compact JWS,固定 PS256(RSA-PSS/SHA-256,saltLength 32)、X-Aicoding-Request-Context、typ=micro-app-request+jws,无 kid;签名绑定 aud/iat/nonce/request/biz,30 秒有效期、最多未来 5 秒。backend 所有业务路由必须经过模板公共组件验证实际请求及防重放,再进行操作/范围/对象/字段权限校验;handler 使用 getVerifiedContext,不自行解码或重复手写验签。具体字段与接入见 micro-app-backend-development 的 references/gateway-verification.md。本期每个 backend 单进程单副本,进程内 TTL nonce 缓存,无数据库依赖;进程重启缓存清空,扩副本前更换共享原子存储。预览跳过正式验签,保留 DEV 测试身份与业务权限。协议与模板实现不代表真实网关联调完成。
55
+
56
+ ## 接口交接与生成要求
57
+
58
+ 缺失必需可信上下文、来源不能确认或过期时拒绝,不用浏览器参数补足。Skill和测试通过不构成平台安全保证,平台检测应覆盖实际发布镜像;不得把历史双签名原型当作生产实现。业务权限实现读取micro-app-backend-development的references/backend-security-workflow.md与references/project-data-permissions.md。权限数据不得无限缓存,签名窗口不能独自保证撤权时限,不以平台强制数据代理为前提。
59
+
60
+ ## 自用责任边界
61
+
62
+ 平台保证自有 SaaS 装配与可信入口等平台能力;开发者负责 backend 业务安全。网关只能传递它能够权威确认的身份和权限事实,不能自动得知自定义工单归属、本人记录限制或字段规则。这些由 backend 根据开发者的数据模型执行,具体生成与测试方法由 micro-app-backend-development 维护。
63
+ # 本地 DEV 与正式协议的区分
64
+
65
+ 场景内置预览的身份字段及验收流程以 `micro-app-backend-development/references/dev-preview-context.md` 为准。DEV host 提供明确的 user.uid/user.role;生成 backend 前须核对该契约和实际代理输出,不自行假定字段存在或把缺失身份默认为管理员。这个约定不冻结生产网关协议,也不替代业务授权。
66
+
67
+
68
+ ## 自定义接口响应契约
69
+
70
+ 微应用 backend 自己生成的 `/custom-aicoding-api` 响应统一使用 HTTP 200(成功或业务拒绝)和 HTTP 500(系统故障),Content-Type 为 `application/json`(允许 charset 参数),响应体为可解析 JSON。业务拒绝必须带 `success:false` 与稳定业务码,不能只看 HTTP 200 判断成功。这是开发包输出规范,不推断网关只允许这两种状态。
71
+
72
+ - 创建、更新、删除、异步任务受理均使用 200 + JSON;异步任务在 JSON 中表达 taskId/status。不得使用 201/202/204、空响应或 3xx 跳转。
73
+ - 参数错误、权限拒绝、资源不存在、版本/唯一性冲突、方法不支持及确认未提交的数据库只读/写权限受限,均返回 HTTP 200 + `success:false` + 安全 `code`、`requestId`、`retryable:false`;不使用 4xx 或 503 表达这些业务拒绝。HTTP 200 不放行鉴权、不执行被拒绝的业务,也不计作业务成功。
74
+ - 数据库连接失败、配置缺失、依赖故障及未知异常返回 HTTP 500 + `success:false` + 安全错误码/请求标识,不主动返回 502/503/504。基础设施自身可能仍产生非 JSON 失败,前端保留链路兜底,不能凭 HTML 或状态码猜数据库只读。
75
+ - HEAD按HTTP语义无响应体,核对状态与Content-Type;其余业务响应禁止 HTML 错误页、纯文本、文件流和 SSE;捕获自身框架/路由错误以返回 JSON。保留参数、权限和事务拒绝逻辑,未知提交结果继续明确未知,不自动重试。
76
+ - 此规范适用于开发者微应用 backend,不更改平台标准 OpenAPI、平台发布服务注册上传接口、DEV Mock 权威服务或网关自身的状态码协议。系统 500 是否保留 JSON 仍须经过真实网关验收,不能承诺仅换状态即可消除所有错误页。
77
+ - 网关过滤 `Set-Cookie`、`Refresh`、CORS 等响应控制头。应用不得依赖它们建立登录态、刷新、跳转或开放跨域,也不通过 `Location` 驱动导航;所需业务结果通过 JSON 交给前端处理。此处不是网关完整头白名单。
78
+ - `{ success, code, result }` 是模板/前端适配器的业务约定,不代表网关强制校验这些字段;应用自定义 envelope 时必须同步前端适配器。
79
+ - 响应约束与请求头契约分别验收;2026-11-06 用户确认自定义通道的 `Accept` 必须为单一 `application/json`,详见下节。
80
+
81
+ 后端生成与实际路由验收见后端 Skill 的 implementation.md。Mock、辅助函数或静态扫描通过不代表线上网关验收通过。
82
+
83
+
84
+ ## 自定义接口 Accept 请求头(2026-11-06 已确认)
85
+
86
+ 浏览器调用 `/custom-aicoding-api/{code}/...` 时必须显式发送 `Accept: application/json`。这是平台入口的已确认限制;Axios 默认 `application/json, text/plain, */*`、fetch 默认 `*/*` 均不能作为该通道的请求值。不要混入多个 Accept 或逗号分隔值。
87
+
88
+ 前端按[实际请求封装与验收](../../micro-app-frontend-development/references/custom-api-requests.md)接线。模板 Axios 拦截器使用完整 config 识别最终 URL,清理顶层和分组默认 Accept;fetch 优先使用统一 `fetchInHost`,内部复用 `customApiFetchInit`,不能期待 Axios 拦截器处理它。使用同源完整路径,只约束自定义通道,不改变标准 OpenAPI 或其他外部请求。保留宿主的身份、范围和 CSRF 注入,不把 Accept 当鉴权。
89
+
90
+ 已有项目更新工具链不会自动修改业务源码。Agent 需检查项目实际请求封装并同步此规则,再在真实 SaaS Network 中核对最终发出的头;覆盖 GET 与写请求。请求通过仍不代表后端响应、签名和业务授权通过,不保证改此头能消除所有 MAP_INVALID_REQUEST。
91
+
92
+
93
+ ## 生产授权完成条件
94
+
95
+ 生成/修改业务 backend、设计生产配置或交付发布前,必须读取 [生产授权接入与交付门槛](../../micro-app-backend-development/references/production-authorization-readiness.md)。`upgradeSupportProjects=true` 表示家庭与项目同时支持,不是 project-only。不得自行发明角色白名单配置并假设平台注入;必须落实可信授权来源、配置交付和两种空间的实际验收。生产业务仍走 DEV 授权器、必要配置未落实等已知阻塞,不能以构建成功或 Mock 通过宣称生产可用。用户明确授权联调部署时如实保留未验收状态。
@@ -0,0 +1,118 @@
1
+ # 标准端 API 调用约定
2
+
3
+ 契约日期:2026-11-17;[47个路由目录](api-catalog.md)和[响应模型](api-models.md)以本版实现为准。
4
+
5
+ ## 入口与身份
6
+
7
+ 浏览器通过同源 `/open-api` 访问 SaaS 标准端 API。业务路径统一 `/v1.0/m/sdf/agent-open/`,只添加一次 `/open-api`。沿用原最终用户登录会话、SaaS上下文和目标服务权限校验。前端不提供开发者Key/Secret,不签云云请求,不直连内部应用。
8
+
9
+ 目录和 manifest.apis[].path 保留不带前缀的业务路径;浏览器地址由模板统一入口处理。Axios 复用模板实例的 `apiRequestConfig`,fetch 使用 `fetchInHost`,具体规则与升级见[标准请求地址](../../micro-app-frontend-development/references/standard-api-requests.md)。不依赖预览或正式宿主自动补前缀,不给自定义 backend、外部请求或静态资源加 `/open-api`。
10
+
11
+ 当前隔离上下文由宿主提供:`isolation-type` 为 `homeId` 或 `projectId`,`project-id` 为当前家庭/项目ID。复用宿主已验证的请求封装和切换流程,不能随意选ID代替切换会话。浏览器props/header/localStorage只是请求上下文,不是授权凭证;服务端认证、归属与对象权限判定才是依据。用户身份、namespace等不作为新业务body参数传入。
12
+
13
+ H02家庭详情、M01家庭成员、M05项目成员读取当前上下文,不增加homeId/projectId目标参数。其他接口仅传目录规定的业务参数。所有接口复用宿主现有会话和请求封装。
14
+
15
+ ## 家庭目标与宿主上下文
16
+
17
+ HOME 模式绑定宿主当前家庭。H08/H13/H14 的 `homeId`、H03 的 `rootId` 和 G01 的 `homeId` 应省略;显式传值只能等于当前家庭 ID。其他值返回 `HOME_CONTEXT_MISMATCH`,提示用户先在宿主切换家庭;不得自动改请求头、静默覆盖参数或自动重试。
18
+
19
+ PROJECT 模式允许指定目标家庭,必须通过当前项目内目标家庭的归属与空间读取权限校验;家庭列表可见(含待接受邀请)不代表可读取该家庭资源。家庭查询成功也不代表拥有设备控制权限。跨家庭汇总不属于这些当前家庭接口的能力。
20
+
21
+ 生成微应用时保持页面家庭、宿主上下文与请求目标一致。切换家庭后取消旧请求并清理旧家庭数据。权限拒绝仍走既有权限错误;`HOME_CONTEXT_MISMATCH` 仅表示上下文不一致,不证明目标家庭存在或用户有权访问。
22
+
23
+ ## 参数与响应
24
+
25
+ 核对条件必填规则,不能仅根据参数表中的“可选”决定省略。例如历史 `POST /v1.0/m/sdf/device/pag/source-query` 在家庭模型下传入 `space_id` 且没有 `room_ids` 时,后端同时要求 `space_type`;应从所选树节点取得 `home`/`room`/`room_group` 等实际类型,不固定猜 home,不移除 space_id 扩大范围。此规则用于维护既有接口项目;新 Agent Open 接口有独立 DTO 与节点解析规则,不照搬旧 snake_case 参数,也不因旧接口错误擅自切换接口版本。验收应覆盖家庭根节点、房间、房间组及缺失类型,缺失时本地拒绝并提示检查空间信息。
26
+
27
+ - 业务query/body及返回DTO采用camelCase,不全局转换snake_case。
28
+ - 路径占位名为`{group_id}`、`{project_id}`、`{device_id}`、`{space_id}`、`{role_code}`;这是网关占位标识。真实ID用encodeURIComponent替换;query/body仍按目录使用camelCase,不能同步改成下划线。
29
+ - GET参数放query或路径;POST查询及群组commands放JSON body。参数、必填、默认值以各域表为准;无默认值表示未声明,不能自动补0/false。
30
+ - `result`为白名单DTO,字段见响应模型;不能继续使用旧device_id/home_id/pid等返回字段。分页类型不统一,不能假定都有hasMore;列表范围以各接口权限和分页契约为准,null不能当作零。
31
+ - 响应包使用`success`、`result`、`errorCode`、`errorMsg`。成功时错误字段可能为空/省略;没有本版新增的requestId字段。目标网关是否再封装或客户端拦截器是否已解包,需在真实环境核实,只解包一次。
32
+
33
+ 成功结构示意(非实际数据):
34
+
35
+ ```json
36
+ {"success":true,"result":{"items":[],"page":1,"pageSize":20,"total":0,"hasMore":false}}
37
+ ```
38
+
39
+ 失败结构示意:
40
+
41
+ ```json
42
+ {"success":false,"errorCode":"13890012","errorMsg":"page: must be a valid integer"}
43
+ ```
44
+
45
+ 以上失败消息只演示字段定位,不承诺固定文本。请求层同时处理非2xx与success=false,不能仅依赖HTTP200或旧code/msg字段。
46
+
47
+ ## 浏览器调用示例
48
+
49
+ 复用项目的标准端API封装优先;以下fetch示例用于说明原始包结构。contextHeaders由宿主现有集成提供,不由最终用户手填账号或身份。
50
+
51
+ ### HTTP 方法与宿主 API 匹配
52
+
53
+ 所有经宿主的 fetch 请求必须在进入宿主拦截器前提供显式大写 method,包括 GET。浏览器默认 GET 发生在宿主匹配之后,不能代替调用侧声明。公共封装在展开 options 后设置 `method: (options.method ?? 'GET').toUpperCase()`,避免显式 undefined 覆盖默认值;保留 POST/PUT/PATCH/DELETE、body、headers 和 AbortSignal。Axios 项目优先复用现有封装,不必改成 fetch。
54
+
55
+ ```js
56
+ import { fetchInHost } from './api-request.mjs'; // Located in src/api; use the delivered implementation.
57
+ ```
58
+
59
+ 该入口同时处理标准端地址前缀及自定义 backend 的单一 `Accept: application/json`,标准端请求保留原头。不要复制只有 method 默认值的另一套封装。接线、baseURL、原生 Headers 和实际发包验证见[自定义请求封装](../../micro-app-frontend-development/references/custom-api-requests.md)。
60
+
61
+ 宿主按 method/path 匹配 manifest API;匹配失败可能将请求标为 `main-app`,后端返回参数错误。不要通过硬编码其他微应用 ID、修改权限或添加猜测参数绕过。排查时核对实际方法、路径、API 清单及 Micro-App-Id,不记录 Cookie、Token 等凭据。
62
+
63
+ ```ts
64
+ async function listHomes(contextHeaders: Record<string, string>) {
65
+ const query = new URLSearchParams({ page: '1', pageSize: '20' });
66
+ const response = await fetchInHost(
67
+ `/v1.0/m/sdf/agent-open/home-space/home/page?${query}`,
68
+ { method: 'GET', credentials: 'same-origin', headers: contextHeaders }
69
+ );
70
+ const body = await response.json().catch(() => null);
71
+ if (!response.ok || body?.success !== true) {
72
+ throw new Error(body?.errorMsg || 'Unable to load homes.');
73
+ }
74
+ return body.result;
75
+ }
76
+ ```
77
+
78
+ 前端实际封装还需保留errorCode供业务分流,统一处理登录失效和国际化提示,避免重复toast;日志不输出会话、业务数据或请求原文。
79
+
80
+ ## 错误与恢复
81
+
82
+ 已知业务错误尽量保留原业务码和国际化说明;异步调用失败同样保留可识别的业务错误,不一律转换为系统失败。前端以errorCode分流,不依赖内部异常类型。
83
+
84
+ 除R02、R09、R13、B01、B02、D16、D17外,参数绑定/类型/校验错误返回HTTP400、`13890012`,信息定位query或DTO字段;缺失/非法JSON定位requestBody,不回显错误值或解析器内部信息。未知系统异常使用`13890011`及安全说明。控制器显式返回的INVALID_ARGUMENT、UNSUPPORTED_CONTEXT、UNSUPPORTED_CAPABILITY、COMMAND_RESULT_UNKNOWN等适配层码保留,不宣称全部失败只有一种数字码。R02、R09、R13、B01、B02沿用现有错误格式,不承诺上述字段定位格式;实际网关HTTP映射仍待真实验收。
85
+
86
+ - 权限/归属失败:停止当前动作,刷新可信上下文或提示无权限,不枚举其他ID重试。
87
+ - 参数错误:定位字段修正;不吞成空列表。
88
+ - 能力不支持:按目录限制提示,不能回退旧接口或使用生产数据兜底。
89
+ - 查询的短暂失败可按项目约定有界重试;G07群组控制和D17单设备控制不自动重试未知结果。accepted=true只表示受理,不能显示设备已达到目标状态。
90
+ - R13授权树是目标角色配置;不能作为客户端或自定义backend放行依据。读家庭/房间元数据也不代表所有设备可控。
91
+
92
+ ## 预览和验收
93
+
94
+ 请求封装回归必须模拟宿主在 native fetch 默认行为之前严格匹配 method/path:省略 method 的原实现应失败,修复后显式 GET 应通过;同时覆盖 undefined、小写方法规范化、写方法/body/headers/signal 保留、HOME/PROJECT 上下文。不能只断言 URL,也不能自行规定业务参数后用同一假设编写 Mock。真实 SaaS 验收另外核对 API 身份和业务响应;Mock 通过不代表真实集成通过。
95
+
96
+ 包内预览已实现本版47个Agent Open路由,并使用新响应包、参数绑定和权限检查,详见[新接口预览说明](preview-agent-open.md)。旧路由保留用于既有预览,但新路由不会转换到旧请求处理器。页面明确标注本地Mock;不得关闭鉴权、连生产服务或静默改用旧路径。
97
+
98
+ 真实验收分别检查原用户会话、HOME/PROJECT上下文切换、允许/拒绝角色、跨家庭/项目对象、字段错误、下游异步错误、未知/空字段,以及写操作G07/D17的结果未知边界。记录环境、部署版本、请求类型与脱敏证据。
99
+
100
+ 自定义业务请求仍走同源`/custom-aicoding-api`,可信上下文与业务权限见[backend-authorization.md](backend-authorization.md)。云云接入见[server-to-server-integration.md](server-to-server-integration.md),本目录不提供云云凭据或调用身份替代方案。
101
+
102
+ D16/D17参数错误为6001006(字段级提示),权限拒绝沿原错误链(控制入口6001003),系统错误6001001。新增接口返回success/result/errorCode/errorMsg;COMMAND_RESULT_UNKNOWN不自动重试。
103
+
104
+
105
+ ## Host CSRF for custom backend writes
106
+
107
+ Host request interception supplies `csrf-token` for same-origin calls. Custom backend
108
+ writes follow the [Browser CSRF contract](backend-authorization.md#browser-csrf-contract).
109
+ Keep CSRF rejection distinct from business authorization, preserve inputs, and do not
110
+ use a successful GET/Mock result as write-path acceptance. Do not hand-enter tokens
111
+ or change CSRF enforcement to work around an integration mismatch.
112
+
113
+
114
+ ## Empty pages and function option codes
115
+
116
+ A paginated response keeps the validated request's `page` and `pageSize`, including zero matches and pages beyond the last item. `items.length` is the returned count, not `pageSize`; an empty page must not reset `page` to 1 or `pageSize` to 0. Preserve the actual filtered `total` even when the requested page is empty. Test default pagination, non-default sizes, zero matches and out-of-range pages for both D01 and D02.
117
+
118
+ D14/G06 expose normalized function definitions. `spec.values` for ENUM and `spec.labels` for BITMAP are ordered string codes. The platform adapter extracts `code` from upstream localized `{code, name}` options; translated `name` is not a command value. Generated clients consume the public strings, do not parse vendor schemas or guess missing codes. BITMAP/RAW and incomplete schemas remain subject to the existing control restrictions; returning a definition does not grant control permission. Test different display languages without changing submitted codes, and reject malformed options rather than substituting names or coercing numbers.
@@ -0,0 +1,46 @@
1
+ # 新接口的本地预览
2
+
3
+ 本版预览实现[清单](api-catalog.md)中的47个路由,HTTP入口必须为`/open-api/v1.0/m/sdf/agent-open/...`。缺少或重复前缀明确拒绝,不修复地址或执行Mock操作;只有直接调用Mock store的单元测试使用不带`/open-api`的业务路径。身份、数据和授权均来自本地DEV状态,不访问生产或其他上游。
4
+
5
+ ## 使用与数据
6
+
7
+ 沿用开发入口的预览启动流程,在预览面板切换家庭/项目及测试用户。标准端接口从当前微应用的manifest声明读取method/path及privilegeCode;业务对象权限仍会单独检查。请求中自报userId、角色或权限不能替换当前测试身份。
8
+
9
+ 默认数据包括`preview-home`、`preview-home-2`、`preview-project`及其A/B区、家庭设备`preview-light`和项目设备`preview-project-light`、`preview-area-light`。群组`1001`属于当前家庭,`2001`属于另一个家庭,`3001`属于项目A区。不会默认授予分享关系。
10
+
11
+ - `preview-user`:所有者。
12
+ - `preview-admin`:全范围管理员。
13
+ - `preview-limited`:项目A区管理员。
14
+ - `preview-member`:普通成员,项目中仅A区单节点授权。
15
+ - `preview-custom`:自定义角色,不能通过标准家庭成员群组控制门槛。
16
+ - `preview-outsider`:无成员关系;待接受/过期身份同样没有自动授权。
17
+
18
+ 家庭可读后返回整家庭房间元数据,设备列表和详情仍按对象授权过滤/校验。项目树省略不可读节点,把可读后代提升到可见父节点,不泄露被隐藏节点的ID。角色菜单树展示被查询角色的配置,不能据此授予当前调用人业务权限。
19
+
20
+ ## 请求与结果
21
+
22
+ GET按query/path绑定;设备POST查询、单设备控制和群组控制只从JSON body绑定业务字段,不能用query补齐body必填字段。布尔query正确识别`false`,列表支持重复query或逗号分隔。错误响应使用`success=false/errorCode/errorMsg/result`;类型错误定位字段,不返回原始非法值。
23
+
24
+ 返回字段为camelCase,分页、Collection、树和nullable字段与公开模型对应;不会自动把未知字段改成0/false或合成设备统计等式。查询POST不修改持久化状态。
25
+
26
+ 群组控制检查当前家庭标准成员、群组归属/有效分享、协议能力、DP可写及值范围。所有命令校验完成后才更新本地群组值;`accepted=true`只表示模拟受理,详情仍按接口契约返回`values=null`。OTA接口只查询,不改变固件或触发升级。
27
+
28
+ D16属性读取和D17单设备控制的夹具、边界及权限场景见[设备属性读取与控制](api-device-control.md#预览与验收)。单设备控制仅记录受理请求,不改写已上报属性;模拟后续上报需修改deviceProperties,不能把accepted当作设备执行完成。
29
+
30
+ 地理查询使用固定测试坐标`latitude=31.2304&longitude=121.4737`;其他合法坐标返回未知字段,不能把模拟坐标结果用于真实地址判断。目录和设备型号均为有限测试数据,空结果不表示线上没有该类资源。
31
+
32
+ B01/B02的调用顺序见[国家码与行政区逐级查询](api-space-home.md#国家码与行政区逐级查询):先取国家`regionCode`,后续取所选行政区`code`作为`parentCode`。当前本地Mock仅返回国家`CHN`以及`parentCode=CHN`时的上海测试项`code=310000`,其他父编码返回空列表;这不是全量字典或完整多级查询验收。Mock中的`iso3`示例不能代替`regionCode`,线上`iso3`可能为null。真实中国与海外字典及逐级下钻需另做集成验证。
33
+
34
+ B05邮编查询额外按部署区域模拟:默认中国区返回HTTP200、`success=false`、`UNSUPPORTED_REGION`;时区和行政区查询保持原行为。测试海外场景时,停止预览后在本地`state.json`设置`agentOpen.deploymentRegion`为`us/eu/in/ueaz/weaz/sg`之一,再启动预览;海外场景下上述固定坐标返回测试邮编,其他合法坐标返回未知。请求query/Header和普通context.region不能改变该夹具中的部署区域。此字段仅用于本地测试,不能作为生产部署区域来源。
35
+
36
+ ## 扩展测试夹具
37
+
38
+ 高级权限场景在独立测试目录的`state.json`中配置,修改前停止该预览实例;不修改用户生产配置。保留既有`authorization`状态结构,新增`agentOpen`承载群组、产品功能、分享、角色资源与OTA夹具。现有本地会话首次读取新工具时补充缺失夹具,保留业务状态;重置预览会重新生成测试数据。
39
+
40
+ - `groupShares`/`deviceShares`:`uid/resourceId/relationId/mode`;临时分享`mode=1`必须满足`startTime < now < endTime`,时间为毫秒。删除关系或更改时间后,下次请求重新判断。
41
+ - `productFunctions`:按productId配置公开功能定义。`writable`缺失或false拒绝控制;RAW/BITMAP/UNKNOWN不支持下发。
42
+ - `groups[].commandOutcome`:`ACCEPTED`、`REJECTED`或`UNKNOWN`。UNKNOWN返回`COMMAND_RESULT_UNKNOWN`且不自动重试;其真实设备是否已执行不能由Mock证明。
43
+ - `ota[deviceId]`:固件、进度、历史、自动升级开关及`groupDeviceIds`;群升查询逐项验证关联设备管理权。
44
+ - R13的其他模型:可信预览context设置`dataModel=basic/smart_space/v6_enterprise_management`、`currentNamespace`;通过`menuConfigurations`配置`namespace/roleCode/platform/menus`。HOME/PROJECT仍按自身权限规则执行。客户端传入同名query不会更改可信模型或namespace。配置模拟不代表远端菜单安装、分配或500条目录已完整同步。
45
+
46
+ 夹具只模拟确定的本地授权事实。远端登录过期、跨SaaS/区域、缓存撤销时延、真实异步下发、设备在线状态与升级进度,必须在真实SaaS环境另行验收。不得以Mock测试通过宣称平台安全保证。
@@ -0,0 +1,13 @@
1
+ # 云云 API 接入边界(扩展约定)
2
+
3
+ 当前尚无已批准云云 API 目录,本文件定义未来接入的收集与交接方式,不定义新接口或可用服务。云云指 backend 调用另一个服务;凭据可能是服务账号、应用凭据或用户委托 token,以目标服务契约为准,不一律等同于开发者管理员权限。
4
+
5
+ 接入前收集:提供方和官方/用户提供的契约、版本、调用地域、method/path/schema、认证与凭据安全注入方式、scope、用户/租户映射、错误/超时/限流、幂等和回调验签(如有)。接口或凭据未开通时只实现不依赖它的业务逻辑,不造默认 key、URL 或角色。
6
+
7
+ 前端只调用自己的业务 API。backend 先验证本次用户操作与对象范围,再使用批准服务身份完成对应外部动作;高权限上游凭据不能使所有前端用户获得同等权限,也不能接受任意 URL/operation 作为代理目标。上游返回数据仍需按当前用户允许范围和字段收窄。
8
+
9
+ 调用涂鸦标准端 API 的 backend 必须保留契约要求的最终用户授权;未经批准不得改成云云调用。外部回调不是普通浏览器会话请求,应按提供方协议验证来源/签名、防重放、幂等和对象映射,不因“没有会话”而放开匿名写入。
10
+
11
+ micro-app-cloud-integration 输出上述外部契约,micro-app-backend-development 实现 client/adapter、业务授权、超时/错误映射和测试。有对应能力 Skill 时先核对其身份/环境适配,不直接复制 App 登录或管理员密钥流程。
12
+
13
+ 后续新增具体服务时单独增加参考文档和能力状态,从入口按需路由;不把全部云云文档塞进标准端 API 清单。云云凭据与 M1 网关传给 backend 的入站权限上下文是两种用途,不能混用。