@tuya-sat/microapp-kit 0.0.0-stage → 0.1.26-alpha.1
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.
- package/AUDIT.md +43 -0
- package/CHANGELOG.md +53 -0
- package/MAINTAINING.md +178 -0
- package/README.md +53 -2
- package/START-HERE.md +44 -0
- package/bootstrap/build-install-page.mjs +46 -0
- package/bootstrap/install-node.ps1 +80 -0
- package/bootstrap/install-node.sh +94 -0
- package/bootstrap/install.md.in +29 -0
- package/bundle.json +852 -0
- package/cli.mjs +3 -0
- package/package.json +68 -4
- package/resources/contracts/project-permissions.json +596 -0
- package/resources/contracts/standard-api.catalog.json +5 -0
- package/resources/examples/group-display.mjs +23 -0
- package/resources/preview/README.md +104 -0
- package/resources/preview/agent-open.mjs +1221 -0
- package/resources/preview/application-icon.mjs +27 -0
- package/resources/preview/authorization-panel.js +243 -0
- package/resources/preview/authorization-routes.mjs +634 -0
- package/resources/preview/authorization.mjs +353 -0
- package/resources/preview/backend-entry.mjs +22 -0
- package/resources/preview/backend-process.mjs +26 -0
- package/resources/preview/bridge.js +50 -0
- package/resources/preview/control.mjs +48 -0
- package/resources/preview/device-fixtures.mjs +38 -0
- package/resources/preview/fixtures/context.json +10 -0
- package/resources/preview/fixtures/device-catalog.json +363 -0
- package/resources/preview/host-contract.mjs +104 -0
- package/resources/preview/host.js +841 -0
- package/resources/preview/local-dev-provider.mjs +27 -0
- package/resources/preview/menu-icons.json +82 -0
- package/resources/preview/mock-store.mjs +1147 -0
- package/resources/preview/run.mjs +131 -0
- package/resources/preview/server.mjs +476 -0
- package/resources/preview/theme-tokens.mjs +49 -0
- package/resources/preview/themes.json +1036 -0
- package/resources/resource-manifest.json +210 -0
- package/resources/scripts/backend-build-context.mjs +101 -0
- package/resources/scripts/backend-runtime.mjs +68 -0
- package/resources/scripts/build-backend-image.sh +23 -0
- package/resources/scripts/build-safety.mjs +18 -0
- package/resources/scripts/build.mjs +138 -0
- package/resources/scripts/command-invocation.mjs +10 -0
- package/resources/scripts/diagnostics.mjs +34 -0
- package/resources/scripts/init-project.mjs +62 -0
- package/resources/scripts/package-release.mjs +80 -0
- package/resources/scripts/prepare-locales.mjs +77 -0
- package/resources/scripts/project-identity.mjs +21 -0
- package/resources/scripts/registry-client.mjs +189 -0
- package/resources/scripts/resource-files.mjs +22 -0
- package/resources/scripts/scaffold.mjs +31 -0
- package/resources/scripts/test-backend-image.mjs +162 -0
- package/resources/scripts/update-preview-themes.mjs +26 -0
- package/resources/scripts/update-resource-manifest.mjs +9 -0
- package/resources/scripts/validate-resources.mjs +9 -0
- package/resources/template/_gitignore +5 -0
- package/resources/template/backend/.dockerignore +7 -0
- package/resources/template/backend/.node-version +1 -0
- package/resources/template/backend/Dockerfile +62 -0
- package/resources/template/backend/deploy/README.md +105 -0
- package/resources/template/backend/deploy/data/README.md +3 -0
- package/resources/template/backend/deploy/manifest.json +4 -0
- package/resources/template/backend/deploy/tasks/README.md +3 -0
- package/resources/template/backend/migrations/README.md +5 -0
- package/resources/template/backend/next-env.d.ts +6 -0
- package/resources/template/backend/next.config.ts +19 -0
- package/resources/template/backend/operations.json +4 -0
- package/resources/template/backend/package.json +35 -0
- package/resources/template/backend/pnpm-lock.yaml +775 -0
- package/resources/template/backend/preview-contract.json +4 -0
- package/resources/template/backend/public/.keep +0 -0
- package/resources/template/backend/scripts/check-runtime.mjs +12 -0
- package/resources/template/backend/scripts/dev-deploy-prepare.mjs +362 -0
- package/resources/template/backend/scripts/dev-diagnose-database.mjs +199 -0
- package/resources/template/backend/scripts/dev-start-backend.sh +30 -0
- package/resources/template/backend/src/app/[[...path]]/route.ts +11 -0
- package/resources/template/backend/src/app/api/[...path]/route.ts +11 -0
- package/resources/template/backend/src/app/api/health/route.ts +16 -0
- package/resources/template/backend/src/app/api/preview/context/route.ts +36 -0
- package/resources/template/backend/src/instrumentation.ts +10 -0
- package/resources/template/backend/src/lib/api-response.mjs +119 -0
- package/resources/template/backend/src/lib/business-logger.mjs +29 -0
- package/resources/template/backend/src/lib/database-errors.mjs +15 -0
- package/resources/template/backend/src/lib/dev-authorization.mjs +84 -0
- package/resources/template/backend/src/lib/dev-context.mjs +58 -0
- package/resources/template/backend/src/lib/gateway-ingress.mjs +79 -0
- package/resources/template/backend/src/lib/gateway-nonce-store.mjs +31 -0
- package/resources/template/backend/src/lib/gateway-verification.mjs +197 -0
- package/resources/template/backend/src/lib/request-observability.mjs +93 -0
- package/resources/template/backend/src/lib/standard-api.ts +28 -0
- package/resources/template/backend/src/microapp-identity.json +1 -0
- package/resources/template/backend/src/proxy.ts +40 -0
- package/resources/template/backend/tests/api-response.test.mjs +77 -0
- package/resources/template/backend/tests/database-diagnostics.test.mjs +198 -0
- package/resources/template/backend/tests/deployment-connection.test.mjs +100 -0
- package/resources/template/backend/tests/deployment-postgres.test.mjs +109 -0
- package/resources/template/backend/tests/deployment.test.mjs +196 -0
- package/resources/template/backend/tests/dev-authorization.test.mjs +88 -0
- package/resources/template/backend/tests/dev-context.test.mjs +35 -0
- package/resources/template/backend/tests/gateway-verification.test.mjs +287 -0
- package/resources/template/backend/tests/request-observability.test.mjs +125 -0
- package/resources/template/backend/tests/routes.test.mjs +253 -0
- package/resources/template/backend/tests/startup.test.mjs +147 -0
- package/resources/template/backend/tsconfig.json +34 -0
- package/resources/template/micro-app/.editorconfig +15 -0
- package/resources/template/micro-app/.eslintrc +15 -0
- package/resources/template/micro-app/.prettierignore +4 -0
- package/resources/template/micro-app/.prettierrc +6 -0
- package/resources/template/micro-app/_gitignore +6 -0
- package/resources/template/micro-app/_locales/en.json +5 -0
- package/resources/template/micro-app/_locales/zh-CN.json +5 -0
- package/resources/template/micro-app/antd.less.overwrite.js +4 -0
- package/resources/template/micro-app/babel.config.json +3 -0
- package/resources/template/micro-app/manifest.json +46 -0
- package/resources/template/micro-app/micro.config.js +4 -0
- package/resources/template/micro-app/mock/index.json +4 -0
- package/resources/template/micro-app/package.json +61 -0
- package/resources/template/micro-app/public/favicon.ico +0 -0
- package/resources/template/micro-app/public/index.ejs +13 -0
- package/resources/template/micro-app/src/App.less +0 -0
- package/resources/template/micro-app/src/App.tsx +99 -0
- package/resources/template/micro-app/src/api/api-request.mjs +85 -0
- package/resources/template/micro-app/src/api/custom-api-headers.mjs +55 -0
- package/resources/template/micro-app/src/api/custom-api.ts +10 -0
- package/resources/template/micro-app/src/api/errors.mjs +108 -0
- package/resources/template/micro-app/src/api/index.ts +34 -0
- package/resources/template/micro-app/src/api/presentation.mjs +33 -0
- package/resources/template/micro-app/src/api/req.ts +9 -0
- package/resources/template/micro-app/src/api/request-url.mjs +20 -0
- package/resources/template/micro-app/src/api/res.ts +9 -0
- package/resources/template/micro-app/src/api/submission-errors.mjs +84 -0
- package/resources/template/micro-app/src/components/CapsuleFilters/index.module.less +121 -0
- package/resources/template/micro-app/src/components/CapsuleFilters/index.tsx +100 -0
- package/resources/template/micro-app/src/components/MicroAppUI/DataTable.tsx +48 -0
- package/resources/template/micro-app/src/components/MicroAppUI/EllipsisText.tsx +25 -0
- package/resources/template/micro-app/src/components/MicroAppUI/Layouts.tsx +54 -0
- package/resources/template/micro-app/src/components/MicroAppUI/ModalForm.tsx +230 -0
- package/resources/template/micro-app/src/components/MicroAppUI/StatusBadge.tsx +19 -0
- package/resources/template/micro-app/src/components/MicroAppUI/index.module.less +99 -0
- package/resources/template/micro-app/src/components/MicroAppUI/index.ts +13 -0
- package/resources/template/micro-app/src/index.css +16 -0
- package/resources/template/micro-app/src/index.tsx +66 -0
- package/resources/template/micro-app/src/interfaces.ts +545 -0
- package/resources/template/micro-app/src/lang/en.ts +1 -0
- package/resources/template/micro-app/src/lang/index.ts +31 -0
- package/resources/template/micro-app/src/lang/zh.ts +1 -0
- package/resources/template/micro-app/src/language-codes.mjs +32 -0
- package/resources/template/micro-app/src/language-policy.ts +6 -0
- package/resources/template/micro-app/src/microapp-identity.json +1 -0
- package/resources/template/micro-app/src/pages/index.module.less +3 -0
- package/resources/template/micro-app/src/pages/index.tsx +6 -0
- package/resources/template/micro-app/src/public-path.js +4 -0
- package/resources/template/micro-app/src/utils/antdLang.ts +244 -0
- package/resources/template/micro-app/tests/template.test.cjs +15 -0
- package/resources/template/micro-app/tsconfig.extend.json +8 -0
- package/resources/template/micro-app/tsconfig.json +24 -0
- package/resources/template/micro-app/typings.d.ts +19 -0
- package/resources/template/micro-app/yarn.lock +7491 -0
- package/resources/tests/agent-open-catalog.test.mjs +43 -0
- package/resources/tests/agent-open-preview.test.mjs +878 -0
- package/resources/tests/api-request.test.mjs +121 -0
- package/resources/tests/api-response.test.mjs +2 -0
- package/resources/tests/application-icon-build.test.mjs +34 -0
- package/resources/tests/authorization-proxy.test.mjs +202 -0
- package/resources/tests/authorization.test.mjs +462 -0
- package/resources/tests/backend-context.test.mjs +33 -0
- package/resources/tests/backend-preview.test.mjs +67 -0
- package/resources/tests/backend-request-logging.test.mjs +2 -0
- package/resources/tests/backend-runtime.test.mjs +96 -0
- package/resources/tests/browser-authorization-smoke.mjs +111 -0
- package/resources/tests/browser-design-smoke.mjs +107 -0
- package/resources/tests/browser-language-compat-smoke.mjs +48 -0
- package/resources/tests/browser-preview-smoke.mjs +148 -0
- package/resources/tests/browser-standard-ui-smoke.mjs +331 -0
- package/resources/tests/build-safety.test.mjs +69 -0
- package/resources/tests/business-build.test.mjs +86 -0
- package/resources/tests/command-invocation.test.mjs +35 -0
- package/resources/tests/custom-api-headers.test.mjs +96 -0
- package/resources/tests/custom-route.test.mjs +63 -0
- package/resources/tests/custom-script-policy.test.mjs +34 -0
- package/resources/tests/database-errors.test.mjs +81 -0
- package/resources/tests/deployment-package.test.mjs +45 -0
- package/resources/tests/dockerfile-logging.test.mjs +31 -0
- package/resources/tests/fixtures/capsule-page.tsx +46 -0
- package/resources/tests/fixtures/standard-ui-page.tsx +222 -0
- package/resources/tests/group-display.test.mjs +28 -0
- package/resources/tests/host-contract.test.mjs +84 -0
- package/resources/tests/image-test.test.mjs +110 -0
- package/resources/tests/initialization.test.mjs +98 -0
- package/resources/tests/language-selection.test.mjs +188 -0
- package/resources/tests/locale-keys.test.mjs +88 -0
- package/resources/tests/preview-control.test.mjs +56 -0
- package/resources/tests/preview-icon.test.mjs +117 -0
- package/resources/tests/preview-state.test.mjs +183 -0
- package/resources/tests/preview-theme.test.mjs +17 -0
- package/resources/tests/real-preview-smoke.mjs +34 -0
- package/resources/tests/registry-client.test.mjs +272 -0
- package/resources/tests/request-errors.test.mjs +51 -0
- package/resources/tests/request-method-contract.test.mjs +65 -0
- package/resources/tests/resources.test.mjs +31 -0
- package/resources/tests/saas-presentation.test.mjs +41 -0
- package/resources/tests/sandbox-scripts.test.mjs +144 -0
- package/resources/tests/space-permission-guidance.test.mjs +78 -0
- package/resources/tests/standard-api-preview.test.mjs +55 -0
- package/resources/tests/submission-errors.test.mjs +118 -0
- package/resources/tests/version-description-package.test.mjs +60 -0
- package/resources/ui/component-sources.json +36 -0
- package/runtime/assemble.mjs +66 -0
- package/runtime/auth/hidden-input.mjs +45 -0
- package/runtime/auth/macos-credentials.js +41 -0
- package/runtime/auth/manager.mjs +145 -0
- package/runtime/auth/session.mjs +153 -0
- package/runtime/auth/state.mjs +107 -0
- package/runtime/auth/store.mjs +130 -0
- package/runtime/auth/windows-credentials.ps1 +73 -0
- package/runtime/auth/wizard.mjs +224 -0
- package/runtime/cli.mjs +474 -0
- package/runtime/dev-database.mjs +155 -0
- package/runtime/dev-provider.mjs +41 -0
- package/runtime/errors.mjs +205 -0
- package/runtime/install-receipt.mjs +68 -0
- package/runtime/installation.mjs +92 -0
- package/runtime/integrity.mjs +121 -0
- package/runtime/launcher.mjs +104 -0
- package/runtime/pack-npm.mjs +76 -0
- package/runtime/package-cache.mjs +52 -0
- package/runtime/package-identity.mjs +22 -0
- package/runtime/preview.mjs +157 -0
- package/runtime/project-identity.mjs +57 -0
- package/runtime/publication.mjs +372 -0
- package/runtime/release-content.mjs +159 -0
- package/runtime/release-index.mjs +91 -0
- package/runtime/setup.mjs +223 -0
- package/runtime/tests/agent-entry.test.mjs +79 -0
- package/runtime/tests/auth-wizard.test.mjs +241 -0
- package/runtime/tests/auth.test.mjs +367 -0
- package/runtime/tests/consistency-workflow.test.mjs +84 -0
- package/runtime/tests/dev-provider.test.mjs +27 -0
- package/runtime/tests/diagnostics.test.mjs +66 -0
- package/runtime/tests/helpers/tar-fixture.mjs +25 -0
- package/runtime/tests/install-page.test.mjs +83 -0
- package/runtime/tests/install.test.mjs +432 -0
- package/runtime/tests/node-bootstrap.test.mjs +104 -0
- package/runtime/tests/npm-distribution.test.mjs +130 -0
- package/runtime/tests/npm-release-check.test.mjs +48 -0
- package/runtime/tests/package-cache.test.mjs +108 -0
- package/runtime/tests/package-migration.test.mjs +208 -0
- package/runtime/tests/preview-hosts.test.mjs +66 -0
- package/runtime/tests/preview.test.mjs +304 -0
- package/runtime/tests/project-identity.test.mjs +67 -0
- package/runtime/tests/publication.test.mjs +436 -0
- package/runtime/tests/release-recovery.test.mjs +417 -0
- package/runtime/tests/repository-source.test.mjs +69 -0
- package/runtime/tests/skill-set-update.test.mjs +169 -0
- package/runtime/tests/standalone.test.mjs +46 -0
- package/runtime/tests/update-check.test.mjs +165 -0
- package/runtime/tests/update.test.mjs +292 -0
- package/runtime/tests/workspace.test.mjs +156 -0
- package/runtime/update-check.mjs +160 -0
- package/runtime/update-state.mjs +83 -0
- package/runtime/update.mjs +292 -0
- package/runtime/verify-npm-release.mjs +43 -0
- package/runtime/workspace-migration.mjs +109 -0
- package/runtime/workspace.mjs +101 -0
- package/schemas/toolchain.schema.json +13 -0
- package/setup.mjs +3 -0
- package/skills/micro-app-backend-development/SKILL.md +64 -0
- package/skills/micro-app-backend-development/references/backend-security-workflow.md +77 -0
- package/skills/micro-app-backend-development/references/business-build-helpers.md +11 -0
- package/skills/micro-app-backend-development/references/business-logging.md +56 -0
- package/skills/micro-app-backend-development/references/database-constraints.md +81 -0
- package/skills/micro-app-backend-development/references/database-write-errors.md +29 -0
- package/skills/micro-app-backend-development/references/deployment-bundle.md +65 -0
- package/skills/micro-app-backend-development/references/dev-preview-context.md +23 -0
- package/skills/micro-app-backend-development/references/gateway-verification.md +43 -0
- package/skills/micro-app-backend-development/references/implementation.md +49 -0
- package/skills/micro-app-backend-development/references/local-database-preview.md +100 -0
- package/skills/micro-app-backend-development/references/production-authorization-readiness.md +60 -0
- package/skills/micro-app-backend-development/references/project-data-permissions.md +43 -0
- package/skills/micro-app-backend-development/references/runtime-resources-and-deployment.md +76 -0
- package/skills/micro-app-backend-development/scripts/microapp-kit.mjs +117 -0
- package/skills/micro-app-backend-development/tests/behavior-scenarios.md +62 -0
- package/skills/micro-app-cloud-integration/SKILL.md +92 -0
- package/skills/micro-app-cloud-integration/references/api-catalog.json +1315 -0
- package/skills/micro-app-cloud-integration/references/api-catalog.md +59 -0
- package/skills/micro-app-cloud-integration/references/api-device-control.md +67 -0
- package/skills/micro-app-cloud-integration/references/api-device.md +179 -0
- package/skills/micro-app-cloud-integration/references/api-group-ota.md +145 -0
- package/skills/micro-app-cloud-integration/references/api-linkage.md +3 -0
- package/skills/micro-app-cloud-integration/references/api-models.md +584 -0
- package/skills/micro-app-cloud-integration/references/api-project.md +121 -0
- package/skills/micro-app-cloud-integration/references/api-space-home.md +244 -0
- package/skills/micro-app-cloud-integration/references/backend-authorization.md +95 -0
- package/skills/micro-app-cloud-integration/references/calling-conventions.md +118 -0
- package/skills/micro-app-cloud-integration/references/preview-agent-open.md +46 -0
- package/skills/micro-app-cloud-integration/references/server-to-server-integration.md +13 -0
- package/skills/micro-app-cloud-integration/scripts/microapp-kit.mjs +117 -0
- package/skills/micro-app-cloud-integration/tests/behavior-scenarios.md +20 -0
- package/skills/micro-app-design/SKILL.md +99 -0
- package/skills/micro-app-design/agents/openai.yaml +6 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/README.md +22 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaCapsuleSearch.html +67 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaCardGrid.html +71 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaIcon.html +5 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaPageTitle.html +29 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/components/TuyaTopNavigation.html +55 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/components.schema.md +154 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/examples/dashboard.html +588 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/examples/dashboard.md +99 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/examples/table-page.html +477 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/examples/table-page.md +77 -0
- package/skills/micro-app-design/assets/tuya-design-system/assets/templates/base.html +878 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/accessibility/accessibility.md +39 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/TuyaCapsuleSearch.html +67 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/arrow-down.svg +3 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/calendar.svg +5 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/check.svg +3 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/checkbox-check.svg +3 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/clear.svg +4 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/icons/capsule-filter/search.svg +4 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/examples/preview.html +3705 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/capsule-search/spec.md +78 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/TuyaCardGrid.html +71 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/assets/placeholder.svg +4 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/examples/preview.html +711 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/card-grid/spec.md +93 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/cascader/spec.md +75 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/checkbox/spec.md +72 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/date-picker/spec.md +81 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/dropdown/spec.md +99 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/icon/examples/TuyaIcon.html +5 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/icon/spec.md +55 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/input/spec.md +84 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/modal/spec.md +178 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/page-title/examples/TuyaPageTitle.html +29 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/page-title/spec.md +67 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/pagination/spec.md +94 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/radio/spec.md +80 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/search-input/spec.md +101 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/select/spec.md +96 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/slider/spec.md +66 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/switch/spec.md +86 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/table/spec.md +116 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/time-picker/spec.md +75 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/tooltip/spec.md +70 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/top-navigation/examples/TuyaTopNavigation.html +55 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/top-navigation/spec.md +60 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/examples/icons/check.svg +3 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/examples/preview.html +974 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/tree/spec.md +118 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/components/upload/spec.md +86 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/demo-index.md +43 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/design-system.md +116 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/color.md +165 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/elevation.md +21 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/icon.md +78 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/layout.md +103 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/radius.md +22 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/spacing.md +29 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/foundation/typography.md +43 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/behavior.md +30 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/feedback.md +23 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/interaction/state.md +28 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/motion/motion.md +31 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/dashboard.md +34 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/data-page.md +30 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/form-page.md +36 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/patterns/monitoring.md +25 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/quality-checklist.md +71 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/registry.yaml +232 -0
- package/skills/micro-app-design/assets/tuya-design-system/latest/tokens.yaml +187 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/README.md +26 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states/README.md +13 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/403.html +58 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/404.html +58 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//346/272/220/347/250/277/500.html +58 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/empty-states//350/247/204/350/214/203.md +159 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/README.md +23 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/arrow-down.svg +3 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/calendar.svg +5 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/check.svg +3 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/clear.svg +4 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/search.svg +4 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/arrow-down-ref.png +0 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/check-ref.png +0 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/clear-ref.png +0 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/capsule-filter/sources/search-ref.png +0 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/Excel.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/HD.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/PM.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/PPT.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/README.md +14 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/VOC.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/app/347/256/241/347/220/206.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/catalog.md +377 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/folder-closed.svg +3 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/license/347/256/241/347/220/206.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/sos-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/sos.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product/word.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/270/212/344/274/240.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/221.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/272/272/345/203/217@2x.svg +1 -0
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//344/274/232/345/221/230@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/201/234/350/275/246@2x.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/206/260/347/256/261.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/206/267/346/260/264.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/210/267/346/274/206.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/220/210/347/211/251.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/255/246-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/214/226/345/255/246.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/240/346/257/224/345/233/276.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/267/345/256/227.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/215/267/345/260/272.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/217/221/345/215/241@2x.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/220/212/347/201/257.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/221/274/345/220/270/347/216/207.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/225/206/345/272/227@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/226/234/346/254/242@2x.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/260/345/233/276@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/234/260/351/223/201@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/237/272/345/233/240 DNA.svg" +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/237/272/345/233/240.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/244/247/350/204/221.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/260/272/345/255/220.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/260/272/345/257/270.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/267/264/345/243/253@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/270/203/345/261/200.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/212 /347/235/241/347/234/240.svg" +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/272/212.svg +1 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/351/227/250-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/274/200/351/227/250.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/275/225/345/203/217.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/276/252/347/216/257.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//345/277/203/347/216/207.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/200/245/346/225/221.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/210/277/351/227/264@2x.png +0 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/213/346/234/272.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/213/350/241/250.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/211/223/345/215/260/346/234/272.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/230/347/272/277/345/233/276.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/212/245/350/255/246.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/213/215/347/205/247.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/214/207/347/272/271@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/216/210/346/235/203.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/221/204/345/203/217/345/244/264.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/224/257/344/273/230@2x.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/243/347/202/271/345/233/276.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/225/260/346/215/256/346/272/220.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/226/207/345/255/227.svg +1 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/240/344/272/272/346/234/272.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/245/346/234/237@2x-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/227/245/346/234/237@2x.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/233/262/347/272/277/345/233/276.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/234/215/345/212/241/345/231/250.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/237/261/347/212/266/345/233/276.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/207/346/270/205.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/221/346/234/250.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/240/241/350/275/246@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/242/257/346/216/247.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/250/241/346/235/277.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/224/346/263/241/345/233/276.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/346/265/270.svg +1 -0
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/260/264/350/255/246.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/202/346/225/221.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/261/241/346/237/223.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/262/231/345/217/221.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x-3.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/266/210/346/201/257@2x.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//346/270/251/345/272/246.svg +1 -0
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/347/201/276.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/255/246.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/275/246@2x-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/253/350/275/246@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/255/347/201/253/345/231/250.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/201/257.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/237/351/233/276.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/203/255/346/260/264.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/205/247/345/272/246.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/207/203/346/260/224.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/212/266/346/200/201.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/242/203.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/216/257/345/275/242/345/233/276.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/262/351/206/233.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265.svg +1 -0
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/350/264/271.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/222/273.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/265/351/243/216/346/211/207.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/224/273/346/235/277.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/233/221/346/265/213.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/233/270/346/234/272.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/235/241/347/234/240.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/246/273/347/272/277.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/350/260/203.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/251/272/351/227/264@2x.png +0 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/252/227/345/270/230.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/255/211/345/276/205@2x.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/274/226/350/276/221@2x.png +0 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/275/221/351/241/265.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//347/276/216/345/205/203@2x.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272-3.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/200/263/346/234/272.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/203/275/345/212/233.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/212/202/350/203/275.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/212/257/347/211/207.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/241/200/346/260/247.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/204/350/214/203.md +264 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221AI.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/247/206/351/242/221SD.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/242/345/215/225.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-3.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-4.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207-5.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/345/244/207.svg +1 -0
- 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
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/256/276/347/275/256@2x.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/246/345/217/267@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/264/247/350/275/246@2x.svg +1 -0
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234lu zhang-2.svg" +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/267/257/351/232/234lu zhang.svg" +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/246/350/241/214@2x.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/244/205-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/244/205.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/256/346/270/241@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/277/350/275/246@2x-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/275/277/350/275/246@2x.svg +1 -0
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//350/277/233/345/272/246/346/235/241.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/200/232/346/226/255/345/231/250.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/201/245/346/216/247.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/223/201/351/224/271.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/224/201.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/224/256/347/233/230.svg +1 -0
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/250/351/224/201.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/227/256/345/217/267@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/230/266/346/242/257@2x.svg +1 -0
- 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
- 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
- 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
- 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
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/237/263/345/223/215.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/241/271/347/233/256.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/243/236/346/234/272@2x-2.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/243/236/346/234/272@2x.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/251/254/346/241/266.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/253/230/345/210/206/345/255/220.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/253/230/346/270/205.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/resources/icons/product//351/274/240/346/240/207.svg +1 -0
- package/skills/micro-app-design/assets/tuya-design-system/source.json +18 -0
- package/skills/micro-app-design/references/action-outcomes.md +7 -0
- package/skills/micro-app-design/references/adaptive-card-grid.md +25 -0
- package/skills/micro-app-design/references/capsule-fallback.md +36 -0
- package/skills/micro-app-design/references/component-boundaries.md +48 -0
- package/skills/micro-app-design/references/component-catalog.md +69 -0
- package/skills/micro-app-design/references/design-system.md +34 -0
- package/skills/micro-app-design/references/empty-and-error-states.md +27 -0
- package/skills/micro-app-design/references/icons.md +33 -0
- package/skills/micro-app-design/references/implementation-guidance.md +39 -0
- package/skills/micro-app-design/references/modal.md +27 -0
- package/skills/micro-app-design/references/page-patterns.md +55 -0
- package/skills/micro-app-design/references/quality-checklist.md +57 -0
- package/skills/micro-app-design/references/requirements-and-permission-states.md +19 -0
- package/skills/micro-app-design/references/source-and-scope.md +40 -0
- package/skills/micro-app-design/references/tokens.md +23 -0
- package/skills/micro-app-design/references/visual-acceptance.md +51 -0
- package/skills/micro-app-design/scripts/microapp-kit.mjs +117 -0
- package/skills/micro-app-design/scripts/visual-audit.mjs +197 -0
- package/skills/micro-app-design/tests/behavior-scenarios.md +154 -0
- package/skills/micro-app-design/tests/validate-design-skill.mjs +35 -0
- package/skills/micro-app-design/tests/validate-design-system.mjs +51 -0
- package/skills/micro-app-development/SKILL.md +132 -0
- package/skills/micro-app-development/agents/openai.yaml +6 -0
- package/skills/micro-app-development/references/agent-workflow.md +111 -0
- package/skills/micro-app-development/references/application-icons.md +50 -0
- package/skills/micro-app-development/references/data-change-safety.md +47 -0
- package/skills/micro-app-development/references/delivery-checklist.md +129 -0
- package/skills/micro-app-development/references/design-workflow.md +77 -0
- package/skills/micro-app-development/references/developer-credentials.md +97 -0
- package/skills/micro-app-development/references/development-guide.md +215 -0
- package/skills/micro-app-development/references/environment-progress.md +47 -0
- package/skills/micro-app-development/references/joint-acceptance.md +105 -0
- package/skills/micro-app-development/references/local-development.md +40 -0
- package/skills/micro-app-development/references/manifest-v1.2.md +129 -0
- package/skills/micro-app-development/references/npm-registry.md +50 -0
- package/skills/micro-app-development/references/platform-operations.md +48 -0
- package/skills/micro-app-development/references/project-workflow.md +36 -0
- package/skills/micro-app-development/references/publication-intent.md +34 -0
- package/skills/micro-app-development/references/publication-recovery.md +67 -0
- package/skills/micro-app-development/references/requirement-intake.md +122 -0
- package/skills/micro-app-development/references/runtime-requirements.md +23 -0
- package/skills/micro-app-development/references/space-permission-boundaries.md +46 -0
- package/skills/micro-app-development/references/tool-update.md +62 -0
- package/skills/micro-app-development/references/toolchain-access.md +35 -0
- package/skills/micro-app-development/references/user-journey.md +65 -0
- package/skills/micro-app-development/references/workspace-environments.md +39 -0
- package/skills/micro-app-development/scripts/application-icon.mjs +108 -0
- package/skills/micro-app-development/scripts/install-app-icon.mjs +48 -0
- package/skills/micro-app-development/scripts/install-menu-icon.mjs +27 -0
- package/skills/micro-app-development/scripts/language-policy.mjs +83 -0
- package/skills/micro-app-development/scripts/languages.json +372 -0
- package/skills/micro-app-development/scripts/locale-keys.mjs +26 -0
- package/skills/micro-app-development/scripts/microapp-kit.mjs +117 -0
- package/skills/micro-app-development/scripts/project-code.mjs +13 -0
- package/skills/micro-app-development/scripts/review-backend-logging.mjs +27 -0
- package/skills/micro-app-development/scripts/review-production-authorization.mjs +37 -0
- package/skills/micro-app-development/scripts/validate-micro-app-project.mjs +442 -0
- package/skills/micro-app-development/tests/application-icons.test.mjs +131 -0
- package/skills/micro-app-development/tests/backend-logging-review.test.mjs +24 -0
- package/skills/micro-app-development/tests/behavior-scenarios.md +177 -0
- package/skills/micro-app-development/tests/data-change-safety-scenarios.md +25 -0
- package/skills/micro-app-development/tests/design-workflow-scenarios.md +40 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/_locales/en.json +6 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/_locales/zh-CN.json +6 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/manifest.json +59 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/micro.config.js +5 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/mock/index.json +11 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/package.json +4 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/src/index.tsx +5 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/src/lang/en.ts +1 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/src/lang/zh.ts +1 -0
- package/skills/micro-app-development/tests/fixtures/valid-v6/src/public-path.js +3 -0
- package/skills/micro-app-development/tests/production-authorization-review.test.mjs +72 -0
- package/skills/micro-app-development/tests/six-skill-routing-scenarios.md +60 -0
- package/skills/micro-app-development/tests/user-journey-scenarios.md +19 -0
- package/skills/micro-app-development/tests/validate-micro-app-project.test.mjs +428 -0
- package/skills/micro-app-frontend-development/SKILL.md +86 -0
- package/skills/micro-app-frontend-development/agents/openai.yaml +6 -0
- package/skills/micro-app-frontend-development/references/api-and-permissions.md +86 -0
- package/skills/micro-app-frontend-development/references/custom-api-requests.md +52 -0
- package/skills/micro-app-frontend-development/references/debugging.md +36 -0
- package/skills/micro-app-frontend-development/references/i18n-and-theme.md +54 -0
- package/skills/micro-app-frontend-development/references/interaction-completion.md +61 -0
- package/skills/micro-app-frontend-development/references/micro-frontend-runtime.md +33 -0
- package/skills/micro-app-frontend-development/references/routing-and-context.md +96 -0
- package/skills/micro-app-frontend-development/references/saas-failure-and-display.md +45 -0
- package/skills/micro-app-frontend-development/references/standard-api-requests.md +30 -0
- package/skills/micro-app-frontend-development/references/submission-errors.md +51 -0
- package/skills/micro-app-frontend-development/scripts/microapp-kit.mjs +117 -0
- package/skills/micro-app-frontend-development/tests/behavior-scenarios.md +36 -0
- package/skills/micro-app-solution-design/SKILL.md +69 -0
- package/skills/micro-app-solution-design/agents/openai.yaml +6 -0
- package/skills/micro-app-solution-design/scripts/microapp-kit.mjs +117 -0
- package/skills/micro-app-solution-design/tests/behavior-scenarios.md +12 -0
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# 本地数据库预览调试
|
|
2
|
+
|
|
3
|
+
用户在本地 Coding Agent 中开发需要持久化的微应用时,按本流程完成真实 backend 与本地 PostgreSQL 的联调。默认使用能力包管理的 Docker 隔离测试库,不要求用户填写数据库连接串或密码;业务数据访问代码由 Agent 实现。用户明确要求接入自己已有的数据库时,说明当前统一预览入口尚不支持外部连接/provider,不擅自接管、迁移或清空该数据库。
|
|
4
|
+
|
|
5
|
+
## 1. 检查本地条件
|
|
6
|
+
|
|
7
|
+
按 [环境安装沟通与进度](../../micro-app-development/references/environment-progress.md) 区分 Docker 安装、引擎启动、镜像拉取和数据库初始化,执行前告知,长任务约 30–60 秒反馈真实状态。超时先检查原任务,不重复启动安装或删卷重建;等待期间继续不依赖数据库的已授权工作。
|
|
8
|
+
|
|
9
|
+
先说明将为当前项目启动本地测试数据库,数据会在停止和重启后保留。通过已安装 Skill 的启动器执行:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" doctor --project "<项目目录>"
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
检查返回的 executables 中 yarn、pnpm、tar、docker 是否可用。doctor 只探测命令版本,status:complete 不代表 Docker 引擎、数据库或业务链路可用。进一步执行 `docker info --format '{{.ServerVersion}}'` 检查引擎;不要收集或输出完整 Docker 配置、容器环境或 Secret。当前 provider 在 macOS/Linux 仅允许本机 Unix socket,在原生 Windows 仅允许 `npipe:////./pipe/<名称>` 本机 Docker 命名管道,继续拒绝 TCP 和远程 Docker context;不要擅自更改用户全局 context。检查当前 DOCKER_CONTEXT/DOCKER_HOST 是否指向本地,必要时让用户选择本地引擎。Windows Docker Desktop 需使用支持 PostgreSQL Linux 镜像的容器引擎。
|
|
16
|
+
|
|
17
|
+
缺少 Docker 时,Agent 按 [环境准备规则](../../micro-app-development/references/agent-workflow.md) 选择可信且适合当前系统的安装方式,说明影响后在已有授权与权限内安装、启动并复查;仅在系统授权、许可证或桌面界面确需用户操作时引导用户完成该最小步骤,不直接把安装任务全部转交用户。不要自行下载执行未知安装脚本。原生 Windows 与 WSL2 按各自实际执行环境验证,不自动切换执行主机,也不能把 Docker 命令存在或平台分支测试当成实机验收。
|
|
18
|
+
|
|
19
|
+
Docker 暂不可用时仍可完成代码、迁移文件、静态检查和不依赖数据库的测试;将真实数据库预览标为受阻,不切换生产库,不以 Mock 数据或关闭鉴权代替数据库验证。首次启动还需能获取 postgres:16-alpine 镜像,依赖安装需能访问项目锁定包源。
|
|
20
|
+
|
|
21
|
+
## 2. 按项目现状启用数据库
|
|
22
|
+
|
|
23
|
+
**全新项目:** 按开发 Skill 的[项目工作流](../../micro-app-development/references/project-workflow.md)初始化,增加 `--backend --database`。项目树支持仍使用用户已明确选择的值,不能为了演示命令默认填写。
|
|
24
|
+
|
|
25
|
+
**已有 backend、尚未使用数据库:** 先停止当前预览;读取项目根目录 resource-project.json,保留其他字段,将 backendIncluded 和 databaseRequired 设为 true。检查 backend 已有 pg、迁移执行脚本、deploy/manifest.json 和预览契约;如缺失,从项目锁定版本完整包的 resources/template/backend 按差异补齐,不覆盖现有业务代码或锁文件,不自动升级依赖。这里修改的是本地项目声明,不是平台建库申请。
|
|
26
|
+
|
|
27
|
+
**已有纯前端项目:** 不重新执行 project init。通过已验证的项目工具链锁定位完整包,从该版本 resources/template/backend 复制到尚不存在的 backend/,保留隐藏文件和锁文件;若目录已存在,按上一分支核对合并。同步上述两个布尔字段,并将 micro-app/manifest.json 的 customBackendServer.required 设为 true(保留其他 manifest 配置),核对声明与实际后端依赖一致,然后按本 Skill 实现 backend 接口。复制后从 resource-project.json 读取原 microAppCode,核对 micro-app/src/microapp-identity.json 一致,再将 backend/src/microapp-identity.json 的 microAppCode 同步为该原值;禁止沿用模板 microapp-template,也不生成新 code。核对 backend/next.config.ts 仍从该文件消费 code。保持 micro-app 身份、code/universalId、前端源码、项目锁及已有资源锁不变;不改安装缓存或包完整性清单。项目声明或工具链锁缺失、不受支持时先修复接入,不能凭空编写锁或套用另一版本模板。
|
|
28
|
+
|
|
29
|
+
**已有数据库项目:** 保持项目路径与原状态目录,复用已有库和迁移历史,不重新初始化或重置。当前资源身份与项目真实路径、状态目录绑定;移动项目、改变状态目录可能得到另一套测试库,不能误认为旧数据丢失后立即清理。
|
|
30
|
+
|
|
31
|
+
## 3. 实现持久化与迁移
|
|
32
|
+
|
|
33
|
+
- 前端通过 /custom-aicoding-api 调用 backend,由 backend 使用 pg 连接池读取运行时注入的 DATABASE_URL;连接值不得进入前端、源码、日志或文件。复用现有客户端,缺失时按业务补充;不要求用户提供 provider 自动生成的密码。
|
|
34
|
+
- 模板不预置业务表或通用数据库访问模块。Agent 按需求生成 Prisma schema 描述、参数化 SQL、业务接口和测试,遵循[数据库约束](database-constraints.md)与[安全生成流程](backend-security-workflow.md)。数据库 schema 隔离不能替代用户、对象和字段权限。
|
|
35
|
+
- 生成 migrations/ 下的 SQL 和 deploy/manifest.json;只支持 type=sql、inputs=[],不生成 JavaScript task。迁移使用未限定 schema 的业务表名或经验证的目标 schema,遵循 provider 配置的 search_path,不把业务表硬编码到 public 或旧项目 schema。
|
|
36
|
+
- 在 backend/ 安装锁定依赖,执行 `pnpm deploy:seal`、`pnpm deploy:check`、`pnpm typecheck`、`pnpm test`、`pnpm build`。涉及真实数据库的测试必须单独记录执行环境和结果;普通测试通过不能代替实际迁移与 CRUD。
|
|
37
|
+
|
|
38
|
+
未发布草案直接维护最终方案;已发布迁移保持不可变。seal/check 仅准备和校验变更包,不代表已建表。常规本地预览由下一步 preview start 自动执行累计迁移,无需 Agent 提取迁移密码或另行手动运行 apply。不要执行 db push 代替迁移;不能只打开 databaseRequired 就宣称业务持久化已完成。
|
|
39
|
+
|
|
40
|
+
### 无真实 SaaS 时的数据范围
|
|
41
|
+
|
|
42
|
+
预览用服务端测试身份表达业务范围,不需要真实 SaaS 账号或生产资源。当前内置上下文为 saasId=preview-saas、测试 user.uid,以及所选项目/家庭/节点;身份和范围由预览代理注入,backend 验证本次私有预览凭证后,通过 authorizeDevOperation 回查有效授权。浏览器不能直接指定受信 SaaS、用户或角色。
|
|
43
|
+
|
|
44
|
+
生成应用时,将 DEV 与正式身份入口适配到业务实际需要的同一套范围语义。例如项目内私人清单,在 DEV 使用模拟 saasId、获授权空间和测试 uid,在正式环境使用验签得到的真实身份与获准范围;两者执行相同的 SaaS/空间/用户查询条件。不要在 SQL 中写死 preview-saas,也不要因环境是 DEV 就移除 saas_id、owner_uid 等隔离条件。测试记录使用模拟归属,正式业务数据使用真实归属,预览测试数据不自动迁入生产。
|
|
45
|
+
|
|
46
|
+
资源隔离与业务隔离各自保留:本地 provider 按开发工程真实路径和状态目录分配独立容器、volume、数据库/schema;同一测试库内的用户、空间和业务租户仍由业务数据范围控制。本地工程不是业务项目,每个测试用户/业务项目不单独建库。Mock 用户或平台 SaaS/空间是外部身份事实,不要求为预览复制一套平台账号/项目表;应用自己管理的父子实体再设计对应关联约束。
|
|
47
|
+
|
|
48
|
+
当前 tenantId=preview-tenant 是 DEV 测试上下文标识,不能拿来替代正式 biz.tenantCode 或数据库 schema。业务确实需要业务租户时,应补充具有可信来源且与正式模型一致的模拟事实和校验,不给缺失值补默认租户。模拟 ID 必须适配业务字段类型;当前内置 preview-* ID 为字符串,若实际模型要求 bigint 等类型,应提供符合契约的测试 ID 与一致的关联数据,不为让 Mock 通过而放宽生产字段/约束。
|
|
49
|
+
|
|
50
|
+
当前页面内置一个模拟 SaaS,支持切换测试用户和项目/家庭;尚无 SaaS 切换入口。跨 SaaS 隔离验收需另外构造至少两套可信测试上下文,在同一测试库放入两组 SaaS 数据,调用真实业务访问入口,验证同名编码、对象替换、关联、统计与写入均不串范围。仅启动两个开发工程的独立数据库不能证明同库 SaaS 行级隔离;只有单 SaaS 页面预览时,明确该项未覆盖。DEV Mock 验收也不替代正式网关与真实 SaaS 联调。
|
|
51
|
+
|
|
52
|
+
## 4. 启动并验收真实链路
|
|
53
|
+
|
|
54
|
+
占位路径由 Agent 替换为实际绝对路径。完成业务代码与迁移后执行:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" preview build --project "<项目目录>"
|
|
58
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" preview start --project "<项目目录>"
|
|
59
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" preview db-status --project "<项目目录>"
|
|
60
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" preview status --project "<项目目录>"
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
start 使用本地 Docker 创建或复用项目专属容器、volume、数据库与 schema,生成本次迁移/业务账号密码;先执行累计迁移,再向真实 backend 注入连接和测试身份,健康检查后启动预览宿主。数据库端口只绑定回环,端口由工具分配,不硬编码 5432。不要把 DEV 的角色分离约定当成生产账号要求。
|
|
64
|
+
|
|
65
|
+
db-status 的 configured/running 只反映数据库资源状态。必须通过返回的预览地址和真实业务 API 验证:创建一条非敏感测试记录 → 查询 → 修改 → 刷新页面后仍可读取;另用测试记录验证删除。切换测试用户/空间,确认越权读取和写入被拒绝且数据未变。未知业务 API、迁移失败或授权失败必须真实报错。
|
|
66
|
+
|
|
67
|
+
接着停止、再次启动预览,确认保留的记录仍在。记录实际通过的操作、未通过项和受阻原因,不能只凭健康接口或“容器运行中”报告数据库功能完成。生产和真实 SaaS 联调仍单独验收。
|
|
68
|
+
|
|
69
|
+
## 5. 修改、停止和清理
|
|
70
|
+
|
|
71
|
+
修改代码或迁移后,先完成必要的 deploy:seal/check 与测试,再执行 preview restart,在同一项目锁内停止旧实例、构建并启动。需要单独审阅停止后的数据时仍可显式 stop → 检查/构建 → start。当前没有 HMR;不能只刷新页面。重启不得清空 DEV 数据、改项目身份或删除迁移账本。
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" preview stop --project "<项目目录>"
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
停止预览会停止该项目数据库,保留 volume 和测试数据。重启会复用数据并轮换运行凭据;不缓存、展示或复用旧密码。页面中的 Mock 重置只影响标准 API 模拟状态,不清空业务 PostgreSQL。
|
|
78
|
+
|
|
79
|
+
只有用户明确要求丢弃当前项目测试数据时,先停止,再执行:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" preview db-reset --project "<项目目录>" --confirm-delete-data
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
该操作删除当前项目 DEV 容器和 volume,下次启动从累计迁移重建;不是常规排障步骤。不得执行全局 docker prune、删其他项目容器/卷,或自动清理用户已有数据库。
|
|
86
|
+
|
|
87
|
+
## 6. 故障处理
|
|
88
|
+
|
|
89
|
+
| 现象 | Agent 的下一步 |
|
|
90
|
+
|---|---|
|
|
91
|
+
| docker 命令缺失 / 引擎未启动 | 提示安装或启动本地引擎,重新检查;保留离线开发成果 |
|
|
92
|
+
| 远程 context 被拒绝 | 核对当前环境并请用户指定本地 Docker 引擎,不静默切换全局设置 |
|
|
93
|
+
| 镜像拉取或依赖安装失败 | 检查镜像/包源可达性和锁定版本,恢复后重试;不改用生产资源 |
|
|
94
|
+
| 数据库迁移失败 | 根据安全错误类别检查 SQL、manifest、schema 和依赖;修复后重试,保留已有数据,不自动 reset |
|
|
95
|
+
| 资源归属或端口绑定不符 | 停止修改,核对项目路径、状态目录和资源归属,不强删容器 |
|
|
96
|
+
| backend 查表失败 / 权限不足 | 检查声明、实际迁移结果、search_path、业务表所在 schema 与连接消费位置;不授予业务账号超级权限 |
|
|
97
|
+
| API 返回 401/403 | 检查预览代理、可信上下文和业务权限,通过正式预览入口访问,不关闭鉴权 |
|
|
98
|
+
| db-status 正常但页面无数据 | 核对前端请求、backend SQL 和当前用户/空间范围,使用真实 CRUD 结果定位 |
|
|
99
|
+
|
|
100
|
+
只向用户报告可操作的原因和下一步,避免透传连接串、密码、完整环境或底层异常。无法完成真实数据库验收时明确说明阻塞点,不宣称已联调成功。
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# 生产授权接入与交付门槛
|
|
2
|
+
|
|
3
|
+
本要求适用于生成或修改业务 backend。DEV 预览、签名验证、本地构建、镜像成功和生产业务授权分别验收;任何一个成功都不替代其他项。授权未完成时保持拒绝是正确行为,但不能把这个占位实现交付为生产可用。
|
|
4
|
+
|
|
5
|
+
## 开发者、Agent 与平台的责任分工
|
|
6
|
+
|
|
7
|
+
2026-11-09 已确认的使用流程是“开发者说明业务权限 → Agent 按平台已有权限能力完成接入 → 在真实 SaaS 验收”。不得将技术接入缺口转成开发者手填角色码、权限映射 JSON 或环境变量的任务。
|
|
8
|
+
|
|
9
|
+
| 责任方 | 具体负责事项 | 不应承担的替代工作 |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| 开发者 | 用业务语言说明谁能查看、创建、修改、删除哪些数据;确认家庭/项目支持与范围;在 SaaS 已有界面按业务需要配置项目角色的应用/操作权限;授权发布部署并参与业务验收 | 不手填生产角色码、授权环境变量或映射 JSON,不负责猜平台接口、复制身份头或临时注入配置 |
|
|
12
|
+
| Agent | 查证平台已有权限契约与项目实际实现,把业务规则映射到 manifest 权限声明、可信操作授权及 backend 对象/字段/范围检查;使用受支持工具完成接入、检查、测试、打包和授权内发布;记录真实验收证据 | 不把角色配置/环境变量作为默认用户前置条件,不自造 API、注入渠道或角色白名单,不用 Mock/构建成功替代生产验收 |
|
|
13
|
+
| 平台 | 提供已有的可信身份、家庭默认角色权限、项目角色授权能力,以及受支持的托管配置与部署能力 | 不自动承担自定义业务对象授权;没有提供的能力不能由 Agent 宣称已经存在 |
|
|
14
|
+
|
|
15
|
+
家庭按平台默认角色权限接入;项目通过现有角色管理及可编辑权限点接入。Agent 不能因为平台角色码未知就改用一个要求用户填写的角色映射环境变量。业务安全仍由开发者负责,Agent 执行接入与验证不构成平台安全保证。
|
|
16
|
+
|
|
17
|
+
需要开发者在 SaaS 操作时,Agent 给出具体业务步骤、对象、预期结果和验证方式,例如“在项目角色管理中为宿管启用本应用的查看和编辑权限”,而不是“填写 ROLE_CODE 或 export ROLE_GRANTS”。已有授权内且工具可完成的步骤由 Agent 连续执行;登录、必要权限或业务决策缺失时才请求相应协助。
|
|
18
|
+
|
|
19
|
+
配置注入是 Agent 与平台核实、交付的工程事项。确有必要的配置只能通过已确认且受支持的机制提供,由 Agent 验证目标环境实际可用;不得要求开发者在终端手填环境变量补救授权接入。不要索取真实凭据或把配置值写入交付文档。
|
|
20
|
+
|
|
21
|
+
平台契约、权限查询或部署能力缺失时,Agent 列明缺失能力、查证依据、受影响操作、需要平台提供的契约及验收条件,按“平台/开发包接入缺口”报告并继续独立工作。依赖部分保持安全拒绝,不能指示用户随意填角色码、提升到管理员、关闭鉴权或使用自造配置绕过。新增自建业务授权系统必须另有明确业务需求与方案确认,不能作为缺口的默认兜底。
|
|
22
|
+
|
|
23
|
+
## 家庭与项目是叠加支持
|
|
24
|
+
|
|
25
|
+
2026-11-09 用户确认:`sdf.feat.upgradeSupportProjects=true` 表示不仅支持家庭,还支持项目空间;false 表示不声明项目支持。true 不能被解释为 project-only,不能生成 `scope.type !== 'projectId'` 就拒绝所有家庭的公共业务入口。家庭与项目分别按 [空间权限能力边界](../../micro-app-development/references/space-permission-boundaries.md) 实现操作和数据权限。
|
|
26
|
+
|
|
27
|
+
签名中的 currentScope.type/id 必须保留原义。不能将 homeId 强转 projectId,不能把项目根 ID 当作空间节点 ID;签名本身不证明有下级节点读取权限。家庭角色默认权限与项目可编辑授权分别接入,不共享猜测的角色映射。
|
|
28
|
+
|
|
29
|
+
## 编码前确认真实授权来源
|
|
30
|
+
|
|
31
|
+
在共同技术方案中逐项记录:业务操作、家庭/项目模式、可信身份来源、权威操作授权来源、对象/字段/范围校验执行方、实际契约及证据。按平台已有且已确认的权限能力完成接入,但不能把网关准入当成任意业务对象授权,也不能虚构权限查询 API。
|
|
32
|
+
|
|
33
|
+
- 正式路径使用 `getVerifiedContext`,DEV 路径仅在严格 DEV 环境分支使用 `authorizeDevOperation`;共享业务函数不能无条件调用 DEV 回查。
|
|
34
|
+
- `roleCodes` 不能按字符串猜 owner/admin/member,更不能将非空角色数组视为允许。需要映射时,映射必须来自已确认业务方案及可维护的权威来源,并有真实角色和撤权验证。
|
|
35
|
+
- 不得自行新增 `DORM_PRODUCTION_ROLE_GRANTS` 或类似角色白名单环境变量,假设平台一定会注入。需要额外配置/Secret 时,由 Agent 核实受支持的注入机制、配置责任方、目标环境/区域、缺失行为与验证方式并完成授权内交付,不要求开发者手填角色码或环境变量。代码注释“已确认”或示例 JSON 不构成确认或注入证据。
|
|
36
|
+
- 自建业务授权系统是独立业务方案,需明确管理入口、可信修改方、默认权限、撤权与数据范围,不能为了让页面打开而默认管理员或全部放行。
|
|
37
|
+
|
|
38
|
+
契约缺失时继续不依赖它的 UI、模型与 DEV 工作,明确“生产授权接入受阻”;必要业务选择向用户澄清,平台事实先查证。不要反复让用户确认已经确定的权限,也不要把平台配置问题变成让用户随意填写角色码。
|
|
39
|
+
|
|
40
|
+
## 联合验收记录
|
|
41
|
+
|
|
42
|
+
在项目现有技术方案/交付记录维护一张表,不强制另建运行时配置文件:
|
|
43
|
+
|
|
44
|
+
| 项目 | 必须记录的证据 |
|
|
45
|
+
|---|---|
|
|
46
|
+
| 身份与模式 | 正式业务入口使用验签上下文;家庭和项目各自的合法、错误范围用例 |
|
|
47
|
+
| 操作授权 | 实际授权来源、真实角色/权限标识及读取/写入允许与拒绝;未知角色不获权 |
|
|
48
|
+
| 数据授权 | SaaS/家庭/项目及对象隔离、字段检查;下级节点范围有权威依据 |
|
|
49
|
+
| 配置交付 | 新增配置逐项证明平台支持、责任方与目标环境已落实;不得保存真实值或凭据 |
|
|
50
|
+
| 未就绪行为 | 配置缺失、权限服务失败时安全拒绝;UI 保留安全错误码和 requestId,不误报断网 |
|
|
51
|
+
| 真实验收 | 目标区域的 /api/me 或等效初始化、至少一次业务读写、无权/撤权及越界拒绝;记录版本、模式、测试时间和脱敏证据 |
|
|
52
|
+
|
|
53
|
+
每项标记“已验证 / 未执行 / 受阻 / 不适用”,不适用写明理由。true 必须同时覆盖家庭与项目。模拟签名测试仅证明本地控制逻辑,不能冒充真实平台角色、配置注入或撤权已生效。
|
|
54
|
+
|
|
55
|
+
## 交付规则
|
|
56
|
+
|
|
57
|
+
1. 本地检查须覆盖生产分支:合法家庭/项目签名可进入正确授权流程;缺配置、未知角色和越权均拒绝。不要只测试拒绝路径,把所有请求都失败的应用当作已完成。
|
|
58
|
+
2. 项目校验器的 `authorization.*` 静态提示必须逐项审阅并记录处理证据;提示是风险线索,静态无提示也不证明接入正确。
|
|
59
|
+
3. 已知 DEV-only 业务入口、拒绝全部家庭、必要配置未落实等阻塞未解决,不得将应用作为可用生产交付,也不应继续常规正式发布。用户明确授权部署用于联调时可以按该授权推进,交付状态仍是“联调中/未验收”,不得清除阻塞或写成生产可用。
|
|
60
|
+
4. 没有真实环境时可交付本地预览、代码、制品及清晰阻塞清单;不能要求关鉴权、伪造生产角色或用 Mock 成功补齐证据。Skill、扫描和测试不构成平台安全保证。
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# 项目结构与数据权限
|
|
2
|
+
|
|
3
|
+
支持项目/升级家庭树只表明适配该业务结构,不授予项目访问权限,也不表示支持所有节点、所有后代或跨项目数据。项目成员、SaaS 角色、功能权限、对象范围是不同概念,均以权威权限契约为准。
|
|
4
|
+
|
|
5
|
+
## 四类边界
|
|
6
|
+
|
|
7
|
+
- 开发者归属:developer_uid 用于开发/装配管理,不等于最终用户。开发者拥有微应用,不自动获得所有使用者的业务数据权限。
|
|
8
|
+
- SaaS/业务租户:同一 backend 服务被多个自有 SaaS 使用时仍需隔离。微应用 ID 或 项目数据库 schema 本身不能区分各 SaaS 用户范围。
|
|
9
|
+
- 项目/家庭/节点:用户选择的是请求上下文。服务端验证它属于当前 SaaS/租户且该用户拥有相关范围;没有项目上下文时不默认选择“第一个项目”或全量数据。
|
|
10
|
+
- 功能/对象/字段:允许进入页面或查看项目不等于允许控制设备、修改、删除、导出或查看敏感字段。角色名相同不代表授权相同。
|
|
11
|
+
|
|
12
|
+
## 建模前明确
|
|
13
|
+
|
|
14
|
+
持久化时先按 [数据库设计与隔离](database-constraints.md) 逐实体确定私人、空间共享、SaaS 共享或明确公共数据,以及可选业务租户边界,再设计归属列、唯一键、关联与查询范围。不同实体可采用不同维度;created_by 是审计字段,不自动决定所有权或共享规则。不能根据“支持项目”把所有数据都绑定到当前项目。
|
|
15
|
+
|
|
16
|
+
复用需求收集结果,列出“业务角色 → 操作 → 数据范围 → 字段/条件”。是否授权当前节点、后代节点、关联家庭,是否支持跨项目汇总,以及项目切换/成员撤权后的行为需要业务意图和平台能力同时支持。没有批准的继承契约时,不按树路径或父节点管理员身份推导后代授权。
|
|
17
|
+
|
|
18
|
+
执行规则是:有效身份及装配 ∧ 允许的操作 ∧ SaaS/租户匹配 ∧ 获准项目/家庭/节点范围 ∧ 对象/关联对象归属 ∧ 字段及状态规则。任何必要授权事实缺失时拒绝相关访问,不采用可见列表作为完整权限证据。
|
|
19
|
+
|
|
20
|
+
## 数据读写
|
|
21
|
+
|
|
22
|
+
- 列表、搜索、计数、聚合、关联、详情、导出和下载都在查询阶段施加同一范围策略,不先拉全量数据再由前端过滤。
|
|
23
|
+
- 更新/删除在授权条件内定位记录,不能先仅按 objectId 找到后直接写。批量请求逐对象检查;整体拒绝还是授权项部分执行应在 API 契约明确,不默默处理越权项。
|
|
24
|
+
- 创建时由服务端使用已验证上下文设置归属;拒绝客户端覆盖 SaaS/租户/项目/所有者等受保护字段。迁移项目/家庭必须是单独获准操作,同时检查来源、目标、关联对象和字段规则。
|
|
25
|
+
- 缓存键、实时订阅、对象存储路径、下载链接及后台任务同样绑定作用域。异步执行不得永久沿用已撤销授权,按批准的权限有效期/重新校验契约处理。
|
|
26
|
+
- 向标准平台 API 请求数据时沿用受限最终用户授权,不能以开发者 Secret 或超级管理员身份代理业务用户。
|
|
27
|
+
|
|
28
|
+
M1 自用场景由开发者负责 backend 数据安全;无需等待平台强制数据代理。网关传递它能权威确认且绑定请求的身份/权限上下文,backend 通过 [统一验签](gateway-verification.md) 后,使用自己的数据访问代码实施 SaaS/项目范围、对象归属和字段规则。正式签名提供当前范围及角色,不自带完整获授权节点列表;多节点查询需要权威授权事实,不能把 DEV 完整模拟快照当正式协议。可使用 pg 参数化 SQL 与最小权限数据库角色;自定义规则不能从浏览器参数推导。
|
|
29
|
+
|
|
30
|
+
## 前端配合
|
|
31
|
+
|
|
32
|
+
hasPermission 仅控制显示和交互。项目切换时重置依赖旧上下文的数据、选中项、表单和权限状态,取消/丢弃旧请求响应,清理旧订阅;缓存至少按 SaaS/租户、隔离模式和项目/家庭区分,并响应权限变更失效。不得短暂显示旧项目数据或把旧权限带入新项目。具体 host props/header 名称以批准宿主契约为准。
|
|
33
|
+
|
|
34
|
+
验收至少使用两个 SaaS、两个项目/不同节点范围及只读/可写用户,覆盖父节点无子节点权、跨项目 objectId、关联/批量/导出、敏感字段、切项目迟到响应和成员撤权。家庭模式同样执行家庭范围校验,不因未支持项目而取消数据授权。
|
|
35
|
+
|
|
36
|
+
## 不支持的空间模式
|
|
37
|
+
|
|
38
|
+
仅支持家庭的 backend 必须在可信上下文验证后、业务数据访问前拒绝项目范围,不因为前端做了提示就删除这层检查。拒绝无业务写入/外部副作用;错误类型按项目接口契约稳定返回(例如约定的 PROJECT_SCOPE_NOT_SUPPORTED),不伪装成成功空列表或用旧家庭 ID 回退。前端按开发 Skill 的空间兼容性规则展示能力提示,不能把业务拒绝变成无限重试。已有 in-flight 写请求保持原始已验证范围,切空间不把它改投新范围。
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
## Action grants are separate from record ownership
|
|
42
|
+
|
|
43
|
+
Private-record ownership checks do not imply permission to create/edit/delete. Consume the approved operation matrix and document the authoritative enforcer for each method/path. If the platform gateway checks the fixed manifest `privilegeCode` before signing a request, verify that contract and bind the local DEV authorization callback to the same code. Do not invent a signed `biz.permissions` field or infer action grants from role code spellings. Retain signature/request binding and object/field/data scope checks on every backend route; direct bypass of the gateway must fail authentication. A frontend hasPermission check alone is not enforcement. Test valid signatures with forbidden object scopes as well as unauthenticated access, and keep real role grant/revoke testing distinct from mocks.
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# backend 运行资源与部署交接
|
|
2
|
+
|
|
3
|
+
本地 Coding Agent 的逐步操作、已有项目追加数据库与故障处理,见 [本地数据库预览调试](local-database-preview.md)。
|
|
4
|
+
以下为 M1 责任与推荐交接内容,不是已冻结的资源声明 DTO 或已上线的资源创建 API。Coding Agent 生成业务代码及依赖需求;平台发布服务接收固定后端源码包,完成构建推送并内部登记同一 release;IoT 用户再发起区域资源准备与部署。开发者负责业务数据安全;Agent 不持有生产数据库或区域管理权限。
|
|
5
|
+
|
|
6
|
+
## 1. Coding 应维护什么
|
|
7
|
+
|
|
8
|
+
在项目已有接口/部署说明中随代码同步以下信息,不再并行发明第二套平台可执行配置:
|
|
9
|
+
|
|
10
|
+
| 信息 | 声明内容 | 禁止混入 |
|
|
11
|
+
|---|---|---|
|
|
12
|
+
| backend 需求 | 服务用途、启动/健康入口、构建上下文、运行依赖和必要可写临时路径 | 自选集群、生产 URL、平台保留参数覆盖 |
|
|
13
|
+
| 数据库需求 | 是否持久化、所需数据库能力、schema/迁移目录与执行入口、已有版本兼容性 | 明文连接串、生产账号、Agent 自建区域数据库 |
|
|
14
|
+
| 普通环境配置 | 名称、类型、是否必需、用途、允许值/范围、非敏感默认值、构建时或运行时使用 | 将业务配置全部暴露成 NEXT_PUBLIC_* |
|
|
15
|
+
| 敏感配置 | 名称、用途、必需性、消费位置,由平台绑定 Secret 引用 | Secret 值、私人 key、凭据出现在示例/日志/构建参数 |
|
|
16
|
+
| 对外依赖 | 服务用途、协议、区域要求及凭据需求,由云端 Skill 确认接口契约 | 可由客户端任意指定的目标地址 |
|
|
17
|
+
| 迁移与业务种子 | 有序版本、执行/检查方法、必要业务初始化说明 | DEV 测试身份和测试数据自动灌入 PROD |
|
|
18
|
+
|
|
19
|
+
数据库连接变量名以实际客户端与注入契约为准,不能把 DATABASE_URL 或 历史 DEV 的 TENANT_DB_* 约定强行当统一生产协议。环境配置 schema 可以随源码保存,但实际值由配置系统注入;当前打包规则排除 .env*,不要生成 .env.example 作为交付依赖。
|
|
20
|
+
|
|
21
|
+
resource-project.json 当前只有 local-draft-v1 等本地字段,供脚本识别项目形态。它不能替代平台 ReleaseDeploymentPlan,也没有自动创建数据库或注入环境变量的能力。不得自行新增字段后宣称平台会消费。
|
|
22
|
+
|
|
23
|
+
## 2. DEV 资源
|
|
24
|
+
|
|
25
|
+
通过本 Skill 的 scripts/microapp-kit.mjs 调用 doctor 与 preview build/start/status/stop/restart,并显式传入 --project。首次先 build 再 start;代码修改后 restart 在同一锁内停止、构建并启动,当前无 HMR。声明 databaseRequired:true 并准备版本化迁移后,随包本地 Docker DEV provider 注入连接及测试身份;需实际可用的 Docker 引擎。外部 provider 尚未接入通用 CLI,MICRO_APP_DEV_PROVIDER 不透传,底层场景机制只能作为参考。DEV 身份字段及验收见 [dev-preview-context.md](dev-preview-context.md);在线 Agent 无可用 Docker 时明确报告数据库预览受阻,不要求专属沙箱或借用生产资源。
|
|
26
|
+
|
|
27
|
+
随包本地 Docker DEV provider 提供项目对应的隔离测试数据库/运行账号和测试身份,启动 preview 时注入。数据库迁移/测试只操作分配的 DEV 资源,未分配时阻断依赖它的执行,不能改连生产或关闭鉴权。
|
|
28
|
+
|
|
29
|
+
无数据库 backend 不要求建库;纯前端不要求 backend。有库后端必须先确认数据资源与 schema 就绪再验证业务。DEV 资源在恢复时按项目资源映射复用,是否重置由明确测试操作决定,不因重启进程自动销毁。
|
|
30
|
+
|
|
31
|
+
## 3. PROD 配置和数据库
|
|
32
|
+
|
|
33
|
+
所有 backend 的正式请求由统一组件验签。运行时注入 MICRO_APP_GATEWAY_PUBLIC_KEY(RSA 公钥 PEM)和 MICRO_APP_GATEWAY_AUDIENCE(平台发布服务audience),不下发私钥或主密钥。当前只支持单 Node 进程、单副本,nonce 存进程内存,不为验签新增数据库依赖;重启缓存清空。扩为多副本前必须更换共享原子防重放存储,详情见 [统一验签](gateway-verification.md)。
|
|
34
|
+
|
|
35
|
+
发布预检从固定源码、声明、迁移和接口引用判断实际依赖,再由用户首次选择 backend 目标区域。数据库按需要跟随区域准备,普通配置与 Secret 在目标区注入,不在镜像中固定域名/密码。
|
|
36
|
+
|
|
37
|
+
迁移与业务服务使用本区同一数据库连接及账号,需具备应用查询、所需 DDL 和迁移账本权限;不要求迁移专用身份。资源创建由平台负责,不由启动脚本自行建库。生产配置缺失时给出只含变量名/错误类别的清晰失败,不能输出值、回落 DEV 默认值或临时管理员账号。区分存活与业务就绪,不能用空健康响应证明数据库可用。
|
|
38
|
+
|
|
39
|
+
资源标识跨 release 稳定,部署新版本不等于创建一套新库。凭据轮换由平台管理,backend 按实际运行机制重载/重启。应用删除由平台资源账本执行数据库与在线数据清理、备份按保留期处理,业务脚本不自行删除共享设施。
|
|
40
|
+
|
|
41
|
+
## 4. 迁移与脚本的归属
|
|
42
|
+
|
|
43
|
+
具体生成、验证和执行约定见 [deployment-bundle.md](deployment-bundle.md),使用项目 backend/deploy/manifest.json;这是执行器本地格式,不是平台资源 DTO。
|
|
44
|
+
|
|
45
|
+
- 项目代码携带业务迁移文件、schema、必要的迁移入口及测试;变更时检查旧 backend 版本兼容性。DEV 的 schema 同步命令不是生产迁移方案。
|
|
46
|
+
- 能力包的 dev-* 迁移、诊断和启动脚本仅供 DEV/check/seal/本地 Dockerfile 参考,可编辑但不改变正式入口;上传包排除全部 scripts/,保留业务迁移,运行时检查由构建工具及平台受控资源提供。正式脚本及固定 pg 依赖由平台维护,正式镜像在 /opt/microapp-platform 内嵌它们。能力包维护本地构建/打包工具与 Dockerfile 参考;正式镜像配方由平台发布服务服务端维护并传给构建设施,在隔离构建环境执行,不提供生产 Secret。修改项目 Dockerfile 不会影响正式构建,额外系统依赖须先对齐平台配方支持。
|
|
47
|
+
- 平台执行器负责制品推送/复制、区域资源创建、配置注入、迁移任务、Service 部署、就绪检查、网关登记及状态回执。Agent 不生成带管理员凭据的 kubectl/建库脚本代替这套能力。
|
|
48
|
+
- IoT 用户发起区域部署后,容器启动入口使用本区业务数据库连接执行累计迁移,在对应资源上协调锁/去重,成功后才启动业务服务;失败不激活目标版本。Dockerfile 使用 ENTRYPOINT/CMD 接入,不在构建阶段用 RUN 执行数据库迁移。模板提供 PostgreSQL 事务迁移 runner;runtime 入口已接入,资源映射及轮询就绪检查仍待联调。长回填/非事务操作不进入本自动执行器,另行定义受控恢复办法。
|
|
49
|
+
- 服务回滚不自动执行向下迁移或删字段;破坏性迁移须确认旧版本引用和数据处理方案。扩区准备 schema 与必要业务种子,不复制其他区业务数据。
|
|
50
|
+
|
|
51
|
+
## 5. 制品准备与正式发布边界
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
node "<本Skill目录>/scripts/microapp-kit.mjs" release prepare --project "<项目目录>" --output "<项目之外的输出目录>"
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
prepare 从固定源码快照完成校验、已有测试及前后端构建,生成前端包与按需 backend-context 等制品和摘要。核对返回的实际产物和状态,只能报告本地已准备,不能报告已提交或已发布;工具元数据、缓存、DEV 状态与密钥不得进入生产制品。
|
|
58
|
+
|
|
59
|
+
backend Dockerfile 的 runtime 包含累计迁移及锁定依赖,启动脚本以业务 DATABASE_URL 执行迁移,成功后再启动 HTTP 服务。迁移 target 是镜像构建阶段,不表示正式流程另建迁移镜像或 Job。构建阶段只校验迁移包,不连接生产库执行迁移。
|
|
60
|
+
|
|
61
|
+
用户授权上传/发布后,使用锁定版本工具的 `release publish --project <项目> --output <prepare 输出目录>`,同目录 `release status` 查询、`release resume` 恢复。工具先注册前端并取得原 releaseId,再以开发者凭证将固定后端包通过平台发布服务multipart 接口上传,由平台发布服务校验、保存并对接构建设施构建登记。publication.json 在首次网络请求前固定请求标识,不保存密钥或内部地址;未知结果先查原任务,UPLOADING 可在窗口内重传同一包,进入 QUEUED 或后续阶段后只查询。源码发生变化须准备新版本,不能换 requestId 覆盖原 release。制品就绪不等于区域部署或激活,真实环境未接入时报告实际阻塞。 正式构建由平台完成,不要求 Agent 本地构建或推送生产镜像,不注入开发者凭证到生成应用、依赖安装或构建子进程。
|
|
62
|
+
|
|
63
|
+
接口可用后注册及构建使用开发者凭证,生产主体由认证上下文解析,不信任 Agent 自报账号。凭据按[统一凭据引导](../../micro-app-development/references/developer-credentials.md)选择系统凭据库、临时隐藏输入或已有安全注入,不交给构建子进程或日志。任务未知时查回原任务,不盲目重提;切换 Agent 不更换 code/universalId。含 backend 的版本仍为 DEPLOY_REGION 且初始未激活,IoT 区域部署和业务验收另行记录。
|
|
64
|
+
|
|
65
|
+
## Node 运行时与本地环境
|
|
66
|
+
|
|
67
|
+
统一执行[运行时要求与镜像边界](../../micro-app-development/references/runtime-requirements.md)。使用 runtime configure/status 验证实际后端Node;项目源码不绑定机器路径,不将本地验证当成正式镜像验收。
|
|
68
|
+
|
|
69
|
+
## 业务构建辅助脚本
|
|
70
|
+
|
|
71
|
+
构建使用[标准后端构建](business-build-helpers.md),禁用安装生命周期并直接调用 Next build;不支持 scripts/build、build-inputs 或 JavaScript 迁移任务。public 明确进入镜像,其余动态资源使用输出追踪。
|
|
72
|
+
|
|
73
|
+
|
|
74
|
+
## 生产授权交接
|
|
75
|
+
|
|
76
|
+
涉及业务 backend、生产配置或发布交付时,读取并执行[生产授权接入与责任分工](production-authorization-readiness.md)。复用已确认业务规则,核验真实授权来源和家庭/项目范围;缺口由 Agent 查证并报告,不要求用户手填角色码或环境变量。
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { readFileSync, lstatSync, existsSync, readdirSync } from "node:fs";
|
|
3
|
+
import { resolve, join, dirname, basename, relative } from "node:path";
|
|
4
|
+
import { homedir } from "node:os";
|
|
5
|
+
import { createHash } from "node:crypto";
|
|
6
|
+
import { pathToFileURL, fileURLToPath } from "node:url";
|
|
7
|
+
try {
|
|
8
|
+
const args = process.argv.slice(2),
|
|
9
|
+
index = args.indexOf("--project");
|
|
10
|
+
if (index < 0 || !args[index + 1] || args[index + 1].startsWith("--"))
|
|
11
|
+
throw new Error("PROJECT_REQUIRED: --project <path>");
|
|
12
|
+
const project = resolve(args[index + 1]);
|
|
13
|
+
const metadata = join(project, ".tuya-microapp");
|
|
14
|
+
const updating = existsSync(join(metadata, "update.json"));
|
|
15
|
+
const installing = existsSync(join(metadata, "setup.lock"));
|
|
16
|
+
if (updating || installing) {
|
|
17
|
+
let verifier = false;
|
|
18
|
+
if (["doctor", "help"].includes(args[0]) && process.env.TUYA_MICROAPP_UPDATE_VERIFIER) {
|
|
19
|
+
const transaction = JSON.parse(readFileSync(join(metadata, "update.json")));
|
|
20
|
+
const owner = JSON.parse(readFileSync(join(metadata, "setup.lock/owner.json")));
|
|
21
|
+
verifier = transaction.id === process.env.TUYA_MICROAPP_UPDATE_VERIFIER
|
|
22
|
+
&& transaction.phase === "committed" && owner.pid === process.ppid;
|
|
23
|
+
}
|
|
24
|
+
if (!verifier) throw new Error(updating ? "UPDATE_RECOVERY_REQUIRED" : "SETUP_IN_PROGRESS");
|
|
25
|
+
}
|
|
26
|
+
const lock = JSON.parse(
|
|
27
|
+
readFileSync(join(project, ".tuya-microapp/toolchain.json"))
|
|
28
|
+
);
|
|
29
|
+
if (
|
|
30
|
+
lock.format !== "tuya-microapp-toolchain-v1" ||
|
|
31
|
+
lock.protocolVersion !== 1 ||
|
|
32
|
+
!/^\d+\.\d+\.\d+(?:-[a-z0-9.-]+)?$/.test(lock.version) ||
|
|
33
|
+
!/^[a-f0-9]{64}$/.test(lock.bundleSha256)
|
|
34
|
+
)
|
|
35
|
+
throw new Error("INVALID_TOOLCHAIN");
|
|
36
|
+
const packages = join(
|
|
37
|
+
process.env.TUYA_MICROAPP_HOME || join(homedir(), ".tuya-microapp"),
|
|
38
|
+
"packages"
|
|
39
|
+
);
|
|
40
|
+
// Do not import cached code before verifying the exact lock identity.
|
|
41
|
+
const precise = join(packages, `${lock.version}-${lock.bundleSha256}`);
|
|
42
|
+
const cache = lstatSync(precise, { throwIfNoEntry: false }) ? precise : join(packages, lock.version);
|
|
43
|
+
for (let p = resolve(cache); ; p = dirname(p)) {
|
|
44
|
+
if (
|
|
45
|
+
lstatSync(p, { throwIfNoEntry: false })?.isSymbolicLink() &&
|
|
46
|
+
!(process.platform === "darwin" && ["/var", "/tmp"].includes(p))
|
|
47
|
+
)
|
|
48
|
+
throw new Error("SYMLINK_CACHE");
|
|
49
|
+
if (dirname(p) === p) break;
|
|
50
|
+
}
|
|
51
|
+
const bytes = readFileSync(join(cache, "bundle.json"));
|
|
52
|
+
if (createHash("sha256").update(bytes).digest("hex") !== lock.bundleSha256)
|
|
53
|
+
throw new Error("BUNDLE_INTEGRITY_MISMATCH");
|
|
54
|
+
// Verify every file before importing any installed executable module.
|
|
55
|
+
const manifest = JSON.parse(bytes);
|
|
56
|
+
for (const [name, hash] of Object.entries(manifest.files || {})) {
|
|
57
|
+
if (
|
|
58
|
+
name.startsWith("/") ||
|
|
59
|
+
name.split("/").some((x) => !x || x === "..") ||
|
|
60
|
+
name.includes("\\")
|
|
61
|
+
)
|
|
62
|
+
throw new Error("INVALID_BUNDLE_PATH");
|
|
63
|
+
const path = join(cache, name);
|
|
64
|
+
for (let p = path; p !== cache; p = dirname(p)) {
|
|
65
|
+
if (lstatSync(p).isSymbolicLink()) throw new Error("SYMLINK_CACHE");
|
|
66
|
+
}
|
|
67
|
+
if (createHash("sha256").update(readFileSync(path)).digest("hex") !== hash)
|
|
68
|
+
throw new Error("BUNDLE_INTEGRITY_MISMATCH");
|
|
69
|
+
}
|
|
70
|
+
const skillRoot = resolve(dirname(fileURLToPath(import.meta.url)), ".."),
|
|
71
|
+
skillName = basename(skillRoot);
|
|
72
|
+
const expected = Object.fromEntries(
|
|
73
|
+
Object.entries(manifest.files)
|
|
74
|
+
.filter(([key]) => key.startsWith("skills/" + skillName + "/"))
|
|
75
|
+
.map(([key, value]) => [
|
|
76
|
+
key.slice(("skills/" + skillName + "/").length),
|
|
77
|
+
value,
|
|
78
|
+
])
|
|
79
|
+
);
|
|
80
|
+
const actual = {};
|
|
81
|
+
function walk(dir) {
|
|
82
|
+
for (const entry of readdirSync(dir, { withFileTypes: true })) {
|
|
83
|
+
const path = join(dir, entry.name);
|
|
84
|
+
if (entry.isSymbolicLink()) throw new Error("SKILL_VERSION_MISMATCH");
|
|
85
|
+
if (entry.isDirectory()) walk(path);
|
|
86
|
+
else
|
|
87
|
+
actual[relative(skillRoot, path).split("\\").join("/")] = createHash(
|
|
88
|
+
"sha256"
|
|
89
|
+
)
|
|
90
|
+
.update(readFileSync(path))
|
|
91
|
+
.digest("hex");
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
walk(skillRoot);
|
|
95
|
+
if (
|
|
96
|
+
!Object.keys(expected).length ||
|
|
97
|
+
Object.keys(actual).length !== Object.keys(expected).length ||
|
|
98
|
+
Object.entries(actual).some(([k, v]) => expected[k] !== v)
|
|
99
|
+
)
|
|
100
|
+
throw new Error("SKILL_VERSION_MISMATCH");
|
|
101
|
+
const { main } = await import(pathToFileURL(join(cache, "runtime/cli.mjs")));
|
|
102
|
+
await main(args);
|
|
103
|
+
} catch (e) {
|
|
104
|
+
console.log(
|
|
105
|
+
JSON.stringify({
|
|
106
|
+
protocolVersion: 1,
|
|
107
|
+
status: "failed",
|
|
108
|
+
nextActions: ["Use the exact business project directory for setup and subsequent commands. If its lock is missing, run the trusted complete package setup --project <that-directory> --agent <host>; do not copy a parent lock or bypass verification. Preserve existing caches; use the lock's exact version and digest."],
|
|
109
|
+
errorCode:
|
|
110
|
+
e.code === "ENOENT"
|
|
111
|
+
? "TOOLCHAIN_NOT_INSTALLED"
|
|
112
|
+
: /^[A-Z][A-Z0-9_]*(?::|$)/.exec(e.message)?.[0].replace(/:$/, "") ||
|
|
113
|
+
"LAUNCHER_FAILED",
|
|
114
|
+
})
|
|
115
|
+
);
|
|
116
|
+
process.exitCode = 3;
|
|
117
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# 路由与开发行为验收场景(待实际 Agent 执行)
|
|
2
|
+
|
|
3
|
+
1. 新建纯计算报价接口,不调用涂鸦、不落库:本 Skill 主导定义自己的接口、输入/授权/测试;不要求标准 API 目录,不加载数据库 Skill。
|
|
4
|
+
2. 工单 CRUD:本 Skill 实现业务与数据范围,本 Skill 按包内数据库约束管理 schema/pg;平台入口验证契约由 cloud Skill 提供,不自造内部签名。
|
|
5
|
+
3. 增加云云短信发送:cloud Skill 确认服务契约、凭据用途和可用性,本 Skill 实现受授权的业务入口、上游 client 与失败/重复发送测试。缺少上游契约不虚构服务。
|
|
6
|
+
4. 网关已验证用户,但对象 ID 指向另一项目:根据真实记录/范围拒绝,断言未写入、未触发外部副作用。
|
|
7
|
+
5. 平台协议未提供:生产接入保持拒绝;继续业务逻辑、schema 或无关功能,不要求建设平台强制数据代理。
|
|
8
|
+
6. 使用标准端 API:由 cloud Skill 选契约,前端 Skill 接线;若 backend 代调则保留最终用户授权,不改用服务凭据。
|
|
9
|
+
|
|
10
|
+
## 运行资源交接行为场景(待实际 Agent 执行)
|
|
11
|
+
|
|
12
|
+
- 新增数据库需求:更新依赖/迁移说明,按本地数据库预览指南准备包内 Docker 隔离 DEV 资源,不自建生产库。
|
|
13
|
+
- 用户提供 Secret 用途:只声明变量名/用途,值通过配置入口注入,不生成带值的 .env 示例。
|
|
14
|
+
- 业务镜像已构建而迁移文件不在其中:报告迁移执行制品缺口,不声称已能生产迁移。
|
|
15
|
+
- package-release 成功:报告制品准备完成,不报告数据库/区域部署成功。
|
|
16
|
+
|
|
17
|
+
## 部署变更生成场景(待实际 Agent 执行)
|
|
18
|
+
|
|
19
|
+
- 新增工单优先级并转换旧记录:追加 SQL 迁移和 manifest(type=sql、inputs=[]),保留旧服务兼容性,在 DEV 执行相同变更,不只修改 schema 后 db push。
|
|
20
|
+
- 只修改报价计算逻辑:检查后说明无需迁移,不创建空版本或强制新增数据库。
|
|
21
|
+
- 修改已发布迁移或字典输入:追加修复版本,不用 deploy:seal 改写历史。
|
|
22
|
+
- 数据库未提供:check 与构建可继续,实际迁移和数据库业务测试标为受阻。
|
|
23
|
+
- 需要长回填或调用外部服务:不放进普通事务 task,列明检查点/重试及独立执行任务需求。
|
|
24
|
+
|
|
25
|
+
## 本地数据库预览场景
|
|
26
|
+
|
|
27
|
+
- 新建持久化应用:使用 --backend --database,检查 Docker 命令和引擎;无需用户提供连接串,生成迁移后以真实 CRUD 验收。
|
|
28
|
+
- 已有无数据库 backend:停止预览,保留代码和身份,更新本地声明,补齐数据访问与迁移,先 seal/check 再 build/start;不重新 init。
|
|
29
|
+
- 已有纯前端:从项目锁定包补入 backend,保留隐藏文件和锁文件,不覆盖现有目录,不改 code/universalId 或安装缓存。
|
|
30
|
+
- 用户不愿填写密码且已有测试数据:说明工具自动注入,重启保留数据并轮换凭据;不用 db-reset 排障,不输出密码。
|
|
31
|
+
- doctor complete 但 Docker 引擎关闭:单独检查引擎并报告受阻,继续离线开发,不报告数据库已可用。
|
|
32
|
+
- 用户要求直连自己已有 PostgreSQL:说明统一入口暂不支持外部 provider,不擅自接管或清空。
|
|
33
|
+
- 数据库 running 但实际 CRUD 失败:继续定位真实接口、迁移和权限;不能用健康检查代替验收。
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
## backend 业务日志场景(生成代码后实际执行)
|
|
37
|
+
|
|
38
|
+
- 快速新增POST业务接口:捕获服务stdout/stderr,成功请求有同一requestId关联的入参摘要、验签/DEV验证、鉴权结果、出参摘要及耗时;不得只交付文字方案。
|
|
39
|
+
- 生产验签失败、缺失身份、nonce重放:在进入handler前拒绝,也有可关联的拒绝及请求结束日志,不产生业务副作用。
|
|
40
|
+
- DEV预览:正式验签标记skipped_dev,另记录DEV身份与权限验证结果,不能写成生产验签成功。
|
|
41
|
+
- 无权限或跨项目对象:记录安全原因码及拒绝阶段,不泄漏目标对象存在性、详情或未授权参数。
|
|
42
|
+
- body包含密码、Authorization、嵌套token、个人信息、换行及超长文本:日志仅包含允许字段和有界摘要,完整捕获日志中不出现测试敏感哨兵;不输出原始header/body/连接串。
|
|
43
|
+
- 记录JSON请求及流式/文件响应:不重复消费请求body、不改变验签原始字节或响应流;日志错误不能放行业务或替换原错误响应。
|
|
44
|
+
- 数据库连接失败、SQL异常、上游超时、未捕获异常:同requestId有阶段、稳定错误码、安全说明及可操作排查方向;无SQL参数、驱动detail、原始stack或密码。
|
|
45
|
+
- handler 直接 throw Error/TypeError:默认边界先记录 microapp.request.failed 的 errorType/category,再返回安全 INTERNAL_ERROR;不能只断言响应码。
|
|
46
|
+
- repository 抛出 SQLSTATE 42P01/42703 后被外层映射:runStage 仍保留数据库阶段、操作、分类及 SQLSTATE,响应不泄露这些内部细节。
|
|
47
|
+
- HTTP 200 + success:false:结束日志是业务失败;非标准 envelope 只能记 http_completed,不伪报业务成功。
|
|
48
|
+
- 并发请求携带不同上游 ID 与伪造内部诊断头:服务端 ID 唯一,入口到 handler/响应一致,不跨请求串线、不采信伪造值;同名外部 ID 只作格式受限的独立关联。
|
|
49
|
+
- logger sink 抛错:成功和拒绝/系统错误响应不变,操作不重试;捕获全量测试输出检查敏感哨兵。
|
|
50
|
+
- 项目只有 logger 文件或注释写了 withApiErrors,实际导出未接线:校验器提示人工审阅;接线后仍通过实际 HTTP 输出验收,而非把静态检查当证据。
|
|
51
|
+
- 旧项目只升级受管工具:不声称业务源码已修复;显式适配 instrumentation/proxy/wrapper/各业务路由后才重新验收。
|
|
52
|
+
- 用户说“构建成功但接口报错”:区分构建日志与部署后业务运行日志;release logs不能冒充Pod运行日志,运行日志入口缺失时明确缺口,不伪造查询命令。
|
|
53
|
+
|
|
54
|
+
## 技术方案与编码条件场景
|
|
55
|
+
|
|
56
|
+
共享输入与执行记录见 [设计流程场景](../../micro-app-development/tests/design-workflow-scenarios.md)。本节为预期行为,真实 backend 开发与宿主实机另行验收。
|
|
57
|
+
|
|
58
|
+
- 新建持久化工单:先回填实体归属/共享、接口、权限、必要迁移和测试方案,与 UI 关键动作对应;满足当前范围编码条件后才生成表结构、查询与 handler。
|
|
59
|
+
- UI 已确认、实体共享范围未知:只补共享决策和剩余技术方案,不重新审批页面,不用 created_by 自动决定可见范围。
|
|
60
|
+
- 已确认技术方案、用户要求执行:直接按模板安排实现与验证,不再问框架、数据库或是否开始。
|
|
61
|
+
- 纯计算 backend:说明无持久化与 UI 不适用项,保留接口/权限/错误与测试设计;不强制加库或额外审批。
|
|
62
|
+
- 改一个已复现缺陷且不改变模型/权限:直接修复验证,不机械要求完整方案;依赖未定外部契约的部分仍阻断。
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: micro-app-cloud-integration
|
|
3
|
+
description: >
|
|
4
|
+
Determine API integration contracts for micro-apps: frontend-facing Tuya standard APIs, custom-aicoding-api gateway and trusted-context integration, and server-to-server APIs when authoritative contracts are supplied. Route custom backend business implementation to micro-app-backend-development.
|
|
5
|
+
metadata:
|
|
6
|
+
version: "0.1.26-alpha.1"
|
|
7
|
+
api-contract-date: "2026-11-17"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 微应用云端接入
|
|
11
|
+
|
|
12
|
+
真实调用失败时按 [SaaS 契约追踪与错误分类](../micro-app-frontend-development/references/saas-failure-and-display.md) 核对绑定、适配、业务校验;不能把内部缺失参数变成未经确认的公共字段。
|
|
13
|
+
|
|
14
|
+
面向用户统一称为“空间智能微应用”,按开发、预览、发布任务解释操作,不要求用户理解或选择平台代际。协议字段和格式版本由工具按契约处理。
|
|
15
|
+
|
|
16
|
+
遵循开发入口的 [Agent 状态推进流程](../micro-app-development/references/agent-workflow.md),复用用户已确认需求与授权,在本 Skill 范围内连续推进;只向用户提出当前必须决定或操作的事项。
|
|
17
|
+
|
|
18
|
+
## 工具链接入
|
|
19
|
+
|
|
20
|
+
首次安装、工具链诊断或升级时读取[共享接入规则](../micro-app-development/references/toolchain-access.md)。已安装则复用锁定版本启动器;仅设计任务不要求初始化业务工程。
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
负责“调用哪类现有 API、由谁调用、使用什么身份、走什么入口、遵守什么契约”,不负责通用 backend 工程实现。当前沉淀主要是前端可调用的涂鸦标准端 API Agent Open 清单,以及 M1 自定义 API 的网关接入约定;未来云云 API 可在本 Skill 扩展,但尚未提供已批准云云接口目录。
|
|
24
|
+
|
|
25
|
+
## 三类接口,按调用方和身份区分
|
|
26
|
+
|
|
27
|
+
| 类型 | 调用方与身份 | 本 Skill 负责 | 实现方 |
|
|
28
|
+
|---|---|---|---|
|
|
29
|
+
| 标准端 API(当前) | 微应用前端经 SaaS 网关调用,基于最终用户授权 | 选择批准接口、参数/响应、上下文、权限与错误契约 | micro-app-frontend-development 做前端接线 |
|
|
30
|
+
| 自定义业务 API(当前) | 微应用前端 → SaaS 网关 → 专用转发应用 → 目标区域 backend | 平台入口、路由、可信上下文和接入约束 | micro-app-backend-development 设计并实现自定义业务接口;micro-app-frontend-development 接线 |
|
|
31
|
+
| 云云 API(未来按契约接入) | backend → 涂鸦或第三方服务;凭据/委托方式由目标 API 规定 | 服务身份、授权范围、地域、签名/令牌、限流/回调等外部契约 | micro-app-backend-development 实现 server-side client 和业务集成 |
|
|
32
|
+
|
|
33
|
+
“端 API”指面向前端业务使用的接口,不表示浏览器绕过 SaaS 网关直连服务。manifest 的 OpenAPI 类型或 /open-api 路径不是“云云 API”的同义词。标准端 API 即使由 backend 代调,也不能擅自改用服务凭据替换最终用户授权。
|
|
34
|
+
|
|
35
|
+
## 分工与按需读取
|
|
36
|
+
|
|
37
|
+
- 选择/接线标准端 API:读 [calling-conventions.md](references/calling-conventions.md),再读下方对应业务清单。
|
|
38
|
+
- 接入自定义 backend 的平台入口:读 [backend-authorization.md](references/backend-authorization.md),输出已确认与待确认的网关协议给 micro-app-backend-development。
|
|
39
|
+
- backend 访问外部云服务或接收回调:读 [server-to-server-integration.md](references/server-to-server-integration.md)。目前无已批准云云目录,使用用户提供或官方确认的契约,不将未来能力写成已开放。
|
|
40
|
+
- 自定义接口/业务逻辑/数据库范围/测试:直接转 micro-app-backend-development;持久化由其读取包内数据库约束。不是所有 backend 修改都要先读标准端 API 清单。
|
|
41
|
+
|
|
42
|
+
## 接入工作流与约束
|
|
43
|
+
|
|
44
|
+
新增功能或改变接入边界时先读 [需求分级、设计与编码条件](../micro-app-development/references/design-workflow.md)。本 Skill 将接口依据、调用身份、数据范围、运行边界、错误恢复与未决契约交给 micro-app-solution-design 回填同一技术方案,供 UI/后端校对,由开发入口组织必要确认;不重复问卷或单独请求整套方案确认。已批准契约和用户选择直接复用,历史源码清单不能充当新能力批准。
|
|
45
|
+
|
|
46
|
+
缺少当前实现必需的权威契约或授权范围时,先核实或只补缺失业务问题,不编造接线、不借 Mock 声称集成成功;已满足编码条件的独立范围可继续。仅纯本地业务计算无需先走标准 API 选型。
|
|
47
|
+
|
|
48
|
+
1. 从已有需求摘要确认调用方、目标服务、端 API/云云/自定义入口类别及身份。只补问缺失的业务范围;技术凭据和协议从平台/服务提供方获取。
|
|
49
|
+
2. 对已有平台或外部 API,核对 method/path、参数/响应、身份与权限、版本、错误和运行区。历史源码清单不是新接口开放批准;缺失项明确求证,不编造现有能力。
|
|
50
|
+
3. 上述“不得编造”只约束已有外部/平台契约。用户自己的 backend 接口可以按需求设计,不需要在标准 API 清单中登记后才编码;平台侧注册/发布映射另按正式契约办理。
|
|
51
|
+
4. 输出接口选择、调用位置、身份/凭据来源、范围、环境、失败处理与待确认项;前端接线交 micro-app-frontend-development,后端 adapter/client 交 backend Skill,不重复维护业务实现规则。
|
|
52
|
+
5. 验证 DEV 集成与真实 SaaS/云服务分别记录。生产写操作、部署与配置修改依照用户明确授权;不得把凭据写入前端、代码、文档或日志。
|
|
53
|
+
|
|
54
|
+
## 当前标准端 API 参考清单
|
|
55
|
+
|
|
56
|
+
本 Skill 版本随完整开发包维护,以完整包与项目锁为准;API 契约日期为 `2026-11-03`。安装与升级仍以完整包、项目锁和摘要为准,不单独混装 Skill。业务 URL 的 `v1.0` 是接口版本,与 Skill 版本分开。
|
|
57
|
+
|
|
58
|
+
[完整目录](references/api-catalog.md)及[机器可读契约](references/api-catalog.json)列出50个来源操作对应的47个新路由,统一前缀 `/v1.0/m/sdf/agent-open/`。鉴权方式沿用现有端 API 会话。
|
|
59
|
+
|
|
60
|
+
| 需求域 | 读取 |
|
|
61
|
+
|---|---|
|
|
62
|
+
| 家庭、房间组/房间、成员、家庭角色、地理信息查询 | [api-space-home.md](references/api-space-home.md) |
|
|
63
|
+
| 项目、空间、项目成员、角色及菜单权限配置查询 | [api-project.md](references/api-project.md) |
|
|
64
|
+
| 设备分页/统计/详情、收到的分享、功能定义查询 | [api-device.md](references/api-device.md) |
|
|
65
|
+
| 设备当前属性、有界批量读取、单设备原始DP控制 | [api-device-control.md](references/api-device-control.md) |
|
|
66
|
+
| 群组查询与控制、OTA只读查询 | [api-group-ota.md](references/api-group-ota.md) |
|
|
67
|
+
| 前端会话、上下文、错误、预览边界 | [calling-conventions.md](references/calling-conventions.md) |
|
|
68
|
+
| 精确响应字段 | [api-models.md](references/api-models.md) |
|
|
69
|
+
|
|
70
|
+
设备状态与控制接线先读 [设备属性读取与控制](references/api-device-control.md):D16支持有界批量,D17仅单设备;功能可写不代表用户已获控制权限,所有请求仍由服务端鉴权。
|
|
71
|
+
|
|
72
|
+
G07群组控制和D17单设备控制是业务写操作,设备查询POST不等于写操作。原家庭/项目/设备CRUD、分享管理、OTA执行、场景联动与实时通道不在本版目录;不按历史示例回退旧接口。角色权限树是目标角色配置,不是调用人有效权限。未知字段/完整性不伪造为0、false或全量。
|
|
73
|
+
|
|
74
|
+
包内预览Mock已支持本版47个路由,使用本地测试身份、数据和权限配置。按[新接口预览说明](references/preview-agent-open.md)验证参数、响应与越权场景;Mock通过不代表真实SaaS接入通过,不能调用生产服务兜底。
|
|
75
|
+
|
|
76
|
+
## 责任与待确认
|
|
77
|
+
|
|
78
|
+
M1 仅允许开发者自有 SaaS 使用自研微应用。平台验证装配与入口等自身权限;开发者负责 backend 的业务安全。网关传递其能权威确认且绑定请求的权限上下文,backend 验证后执行。网关不自动知道自定义工单归属。
|
|
79
|
+
|
|
80
|
+
自定义入口的签名与请求绑定已固定,使用[现行平台入口契约](references/backend-authorization.md)和[公共验签实现](../micro-app-backend-development/references/gateway-verification.md),不重新设计协议;业务操作权限仍须依具体平台权威来源核实。云云服务若未来接入,凭据来源、scope、用户委托语义和区域能力须逐服务确认。不能因为服务托管或 Skill 存在而宣称集成已完成。
|
|
81
|
+
|
|
82
|
+
## 开发者注册与源码构建
|
|
83
|
+
|
|
84
|
+
用户表达“上传平台”“发布到涂鸦/零代码平台”等注册上传目标时,交给 micro-app-development 按[发布意图识别](../micro-app-development/references/publication-intent.md)编排;本 Skill 按需解决具体契约问题,不将整项上传任务误路由为 API 选型。
|
|
85
|
+
|
|
86
|
+
微应用注册及构建使用开发者凭证,和 SaaS 用户的端 API 会话分开;生产 iot_uid 由服务端认证上下文解析。正式 backend 发布通过 release publish/status/resume 上传固定源码包到平台发布接口,由平台校验、存储、构建及登记同一 release。未知响应先查原任务,复用准备目录和请求标识;已入队后不重传,不编造成功。凭据来源遵循[共享凭据引导](../micro-app-development/references/developer-credentials.md),优先系统凭据库,不可用时临时隐藏输入,仅复用已安全注入的 Secret,不进入项目、前端、构建子进程或日志。
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
## 生产授权交接
|
|
91
|
+
|
|
92
|
+
涉及业务 backend、生产配置或发布交付时,读取并执行[生产授权接入与责任分工](../micro-app-backend-development/references/production-authorization-readiness.md)。复用已确认业务规则,核验真实授权来源和家庭/项目范围;缺口由 Agent 查证并报告,不要求用户手填角色码或环境变量。
|