@microi.net/cli 4.7.7 → 4.8.1

package/{dist → scripts}/microi-skills.meta.json

@@ -1,25 +1,25 @@
 {
-  "builtAt": "2026-08-07T19:42:03.087Z",
+  "builtAt": "2026-08-08T11:14:53.371Z",
   "source": "../microi.skills",
   "extension": {
     "name": "v8-engine",
-    "version": "4.7.7",
+    "version": "4.8.1",
     "publisher": "Microi"
   },
   "skills": {
-    "version": "4.7.7",
+    "version": "4.8.1",
     "versionRule": "Microi version uses three numeric parts. Each publish increments the last part; when a part exceeds 9 it carries to the previous part: 1.0.9 -> 1.1.0, 1.9.9 -> 2.0.0.",
     "managedBy": "Microi.VSCode/bump-version.js"
   },
   "output": {
     "dir": "dist/microi.skills",
-    "files": 105,
-    "skills": 58,
-    "bytes": 1635633
+    "files": 107,
+    "skills": 59,
+    "bytes": 1645573
   },
   "fileHashes": {
-    ".microi-skills-version.json": "d0b21627bd2a7a28fc03f4672ecfd66c95eebfa9cbb73775f17a0b8dda03c59e",
-    "README.md": "f88db8f5a0ad3788583b1a0787cb4c485f1027e50a5c21997da41334e2be3b82",
+    ".microi-skills-version.json": "bf5bf70fd74c7b63a634f0822283bbd22baf2a5c37a7357ac0336e017b8ca9a3",
+    "README.md": "0dfd14a1657650999948056d15edf4440abb2ac0c3147e3e65768937315a6611",
     "ai-engine/SKILL.md": "371b00ce9860d1516f6eb7eeaed001cbfa852c52e7c0cfccbedc4a71a113e568",
     "ai-engine/agents/openai.yaml": "40deb07801006a46b9a7f0020d13251955eeadd04c8e591160210479936f8b5b",
     "app-store/SKILL.md": "372243a3e8a9ed5163ca458e15eb1211474aef327ac553202884bfbb0321722a",
@@ -27,7 +27,7 @@
     "business-blueprint/SKILL.md": "ea379a85476d262f4fc72a5846a06354893065052ef64370bbc7e3a2753a498d",
     "datasource-engine/SKILL.md": "bfd0cab8318eef375ca49f27c0511fce7e939a1c795678e83cf2d3438e24915f",
     "datasource-engine/agents/openai.yaml": "f7cfd13ec721e0991af29b685cd00bb1aec6e5ffb5f198ad59b0eb6e39814725",
-    "dos-orm/SKILL.md": "ed4edb7db7c2b066729c228b28b5a5d7cd2c1cb3c3a5be3f10bd533c301318c3",
+    "dos-orm/SKILL.md": "c52577ef92e4efe2ca36a6bb69f990a9ca7ca6a66b0c657a3ec9c60c1ce9a550",
     "dos-orm/references/api-reference.md": "facc5e62cd6439a06263580dab9656271118d4bb5a91b5d9230a79136e6daa72",
     "job-engine/SKILL.md": "12f175f8de9610a6994bf11931810f4dce2cd0cdcd1f5b575dee4fd2b636658c",
     "job-engine/agents/openai.yaml": "65889ee39bc34caca9085539d8954a381aab93590c5635eea3bb6f4c001934af",
@@ -38,7 +38,9 @@
     "microi-ai-application/SKILL.md": "b267798bd59cedca874ccbefdd6fd3f9be48d383d2aacb151c3fa6e880905e30",
     "microi-ai-application/agents/openai.yaml": "d3dfc4d0f2fda3391e90e661ca9d8d051cb43824b011d1a88e99db135870454f",
     "microi-ai-application/references/frontend-baseline.md": "c21a2d38292fd8d445a7538afb45d609881f624f32d39c0fc4bbbb3c2fa64a74",
-    "microi-client-frontend/SKILL.md": "e634ce51f3e3a52fc1b3638e24cf7e7fa9065d2c16bbdeef0acfdd42851067ed",
+    "microi-client-frontend/SKILL.md": "8e9f3392bb94c74d43b252cc9238b6ea38742a3ee8403d241643e738edcac899",
+    "microi-codex-installer/SKILL.md": "9378c508a83e3623af296b879c6d0bc7b19b6a75c10cfb32dacb584a982001dc",
+    "microi-codex-installer/agents/openai.yaml": "9005e81cdf8102a296417277f71fd206fd19a4ff13d54044cff41efddee21577",
     "microi-datasource-mapping/SKILL.md": "1626bdf242038838028aa1235c5a6262e22680984583c47a8fc4e5fffb24b7df",
     "microi-db-schema/SKILL.md": "2e4dfd98d7e10bad0e8f68682725e88ebbaa5518bc548f8780685e2cd248defd",
     "microi-db-schema/agents/openai.yaml": "c725a2be4c904472f9e46dc4b49aa642c9f3a4437c91a28ba7cc27167497ede7",
@@ -58,7 +60,7 @@
     "microi-form-layout/SKILL.md": "48814c2c138e2c0fb6a11d39cf458df6a1cc28a3156c7540db1fa482a2ce6aec",
     "microi-frontend-sdk/SKILL.md": "0ff6e2df0dc01a42ca875bb6eeb92a4397c5dd4ecae0f808ccf36f1f549c58f0",
     "microi-left-right-layout/SKILL.md": "d8c482224846477b6c3068bdf94930cca6d699570f59b09f946601b0a65715f6",
-    "microi-microservice/SKILL.md": "e8edecf40b0b18ab0bf3d69b0d647e16e2d471b15ef7b149ca1f6dfb16484f67",
+    "microi-microservice/SKILL.md": "ed4292f6e741acaff07357e3a8e508e4ba0491488bc260ccd26804e4f81b55ed",
     "microi-microservice/references/runtime-delivery.md": "704ed30623d91c971bed359403caa1f848edd07528ecbf211fa3b619ccec117d",
     "microi-mobile-app-quality/SKILL.md": "810bc23f3cfd4ee47ff3a51917b9aaa46cad8d59d2e3a880ed5f4c41b70eb1d7",
     "microi-solution-quotation/SKILL.md": "1bd47bd019a62bdc904612a7d8e2501c76df66eed9ef247544dd7fe38eba02e4",
@@ -68,8 +70,8 @@
     "microi-ui/SKILL.md": "606a9cfc2e9cbcb41e9e26ef9c09bb2ca31c4edc24af00058aa059b54a01f2fe",
     "microi-uniapp-frontend/SKILL.md": "d031dca0ed4182954e383e9828263d46414330f0a014487867b628f655b5bb26",
     "microi.v8.js": "25ff9e9aca3ff5167a1f3f06e262e3389a6d732cb12b9a3ddb4f218fb331ef53",
-    "module-engine/SKILL.md": "ee19f0b8f7f960a274236c93cb9639c216004efdc9ea529df39e3ab5645ae340",
-    "module-engine/references/module-config.md": "99664bde53029bc3342bff8de820aab56ee94898df7dbc31f054e911871c46dc",
+    "module-engine/SKILL.md": "1dff1029df854cddc39d721cd2b91723d4c919662f493de7efbf9d0361f5424c",
+    "module-engine/references/module-config.md": "3b41b49c0b8568e56602d0ea136edd5aa509d623e91034d7335058616e90dda4",
     "ocr-engine/SKILL.md": "16f7ee8d3485f47d2cb524f0c3fdea609f7de5581ba46da9f34d32772422c050",
     "ocr-engine/agents/openai.yaml": "3a6cc9984a246c41332c5f53d1badef31b78f81324333ea0d6337cb20c7fc898",
     "page-engine/SKILL.md": "9ee0ff0e27ce39a45cea836a5d387c16b891b20f551163e0dd6878580c07696d",
@@ -122,114 +124,116 @@
     "v8-utilities/references/platform-http-routes.md": "87579eef4e89b4c80e1757ad34ec951e0ccadb6bd15aab4f3ab247f55d5f1cd5",
     "v8-utilities/references/server-api-index.md": "72655af1078b0c63ace253f6a6ab74847abffe38829fdcb55780861d8d4b0e9f",
     "v8-workflow/SKILL.md": "cd6738edd79f628948adfac898b6d58a81feb28d1ec6d1f83fc12758fb570819",
-    "workspace-conventions/SKILL.md": "1fb73d6ebfa6683d708d47cbc772505bbb2a9e90d9c7afad23007a166bd8cae5"
+    "workspace-conventions/SKILL.md": "051287e956466b2ebe6bb3c3fb30842ce8ac4bb470adcbb1212cc8d13087d9f1"
   },
   "fileVersions": {
-    ".microi-skills-version.json": "4.7.7",
-    "README.md": "4.7.7",
-    "ai-engine/SKILL.md": "4.7.7",
-    "ai-engine/agents/openai.yaml": "4.7.7",
-    "app-store/SKILL.md": "4.7.7",
-    "app-store/agents/openai.yaml": "4.7.7",
-    "business-blueprint/SKILL.md": "4.7.7",
-    "datasource-engine/SKILL.md": "4.7.7",
-    "datasource-engine/agents/openai.yaml": "4.7.7",
-    "dos-orm/SKILL.md": "4.7.7",
-    "dos-orm/references/api-reference.md": "4.7.7",
-    "job-engine/SKILL.md": "4.7.7",
-    "job-engine/agents/openai.yaml": "4.7.7",
-    "message-notification/SKILL.md": "4.7.7",
-    "message-notification/agents/openai.yaml": "4.7.7",
-    "message-notification/references/contracts.md": "4.7.7",
-    "microi-ai-app-auth.js": "4.7.7",
-    "microi-ai-application/SKILL.md": "4.7.7",
-    "microi-ai-application/agents/openai.yaml": "4.7.7",
-    "microi-ai-application/references/frontend-baseline.md": "4.7.7",
-    "microi-client-frontend/SKILL.md": "4.7.7",
-    "microi-datasource-mapping/SKILL.md": "4.7.7",
-    "microi-db-schema/SKILL.md": "4.7.7",
-    "microi-db-schema/agents/openai.yaml": "4.7.7",
-    "microi-db-schema/references/core-tables.md": "4.7.7",
-    "microi-db-schema/references/form-component-options.md": "4.7.7",
-    "microi-db-schema/references/schema-overview.md": "4.7.7",
-    "microi-db-schema/references/schema.md": "4.7.7",
-    "microi-db-schema/references/table-catalog.md": "4.7.7",
-    "microi-deployment/SKILL.md": "4.7.7",
-    "microi-deployment/references/deployment-matrix.md": "4.7.7",
-    "microi-docs-coverage/SKILL.md": "4.7.7",
-    "microi-docs-coverage/references/capability-map.md": "4.7.7",
-    "microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs": "4.7.7",
-    "microi-form-engine/SKILL.md": "4.7.7",
-    "microi-form-engine/references/component-catalog.md": "4.7.7",
-    "microi-form-engine/references/data-source-events.md": "4.7.7",
-    "microi-form-layout/SKILL.md": "4.7.7",
-    "microi-frontend-sdk/SKILL.md": "4.7.7",
-    "microi-left-right-layout/SKILL.md": "4.7.7",
-    "microi-microservice/SKILL.md": "4.7.7",
-    "microi-microservice/references/runtime-delivery.md": "4.7.7",
-    "microi-mobile-app-quality/SKILL.md": "4.7.7",
-    "microi-solution-quotation/SKILL.md": "4.7.7",
-    "microi-solution-quotation/agents/openai.yaml": "4.7.7",
-    "microi-solution-quotation/scripts/build_solution_quote.py": "4.7.7",
-    "microi-system-delivery/SKILL.md": "4.7.7",
-    "microi-ui/SKILL.md": "4.7.7",
-    "microi-uniapp-frontend/SKILL.md": "4.7.7",
-    "microi.v8.js": "4.7.7",
-    "module-engine/SKILL.md": "4.7.7",
-    "module-engine/references/module-config.md": "4.7.7",
-    "ocr-engine/SKILL.md": "4.7.7",
-    "ocr-engine/agents/openai.yaml": "4.7.7",
-    "page-engine/SKILL.md": "4.7.7",
-    "performance-testing/SKILL.md": "4.7.7",
-    "playwright-e2e/SKILL.md": "4.7.7",
-    "print-engine/SKILL.md": "4.7.7",
-    "production-readonly-audit/SKILL.md": "4.7.7",
-    "report-engine/SKILL.md": "4.7.7",
-    "report-engine/agents/openai.yaml": "4.7.7",
-    "search-engine/SKILL.md": "4.7.7",
-    "search-engine/agents/openai.yaml": "4.7.7",
-    "spider-engine/SKILL.md": "4.7.7",
-    "translate-engine/SKILL.md": "4.7.7",
-    "translate-engine/agents/openai.yaml": "4.7.7",
-    "ui-design/SKILL.md": "4.7.7",
-    "ui-design/assets/pattern-showcase/app.js": "4.7.7",
-    "ui-design/assets/pattern-showcase/index.html": "4.7.7",
-    "ui-design/assets/pattern-showcase/styles.css": "4.7.7",
-    "ui-design/assets/templates/MCI-DESIGN.md": "4.7.7",
-    "ui-design/references/design-pattern-library.md": "4.7.7",
-    "ui-design/references/mci-design-contract.md": "4.7.7",
-    "ui-design/references/motion-and-media.md": "4.7.7",
-    "ui-design/references/product-flow-recipes.md": "4.7.7",
-    "uniapp-mall-assets/SKILL.md": "4.7.7",
-    "v8-api-config/SKILL.md": "4.7.7",
-    "v8-cache-pattern/SKILL.md": "4.7.7",
-    "v8-crud-api/SKILL.md": "4.7.7",
-    "v8-debugging/SKILL.md": "4.7.7",
-    "v8-explorer-tree/SKILL.md": "4.7.7",
-    "v8-export-import/SKILL.md": "4.7.7",
-    "v8-file-upload/SKILL.md": "4.7.7",
-    "v8-formengine-http/SKILL.md": "4.7.7",
-    "v8-frontend-events/SKILL.md": "4.7.7",
-    "v8-frontend-events/references/bluetooth-print-api.md": "4.7.7",
-    "v8-frontend-events/references/bluetooth-print.md": "4.7.7",
-    "v8-http-integration/SKILL.md": "4.7.7",
-    "v8-image-processing/SKILL.md": "4.7.7",
-    "v8-image-processing/agents/openai.yaml": "4.7.7",
-    "v8-image-processing/references/api-reference.md": "4.7.7",
-    "v8-menu-buttons/SKILL.md": "4.7.7",
-    "v8-mongodb/SKILL.md": "4.7.7",
-    "v8-mq-mqtt/SKILL.md": "4.7.7",
-    "v8-saas-multi-tenant/SKILL.md": "4.7.7",
-    "v8-security/SKILL.md": "4.7.7",
-    "v8-sql-query/SKILL.md": "4.7.7",
-    "v8-table-event/SKILL.md": "4.7.7",
-    "v8-template-engine/SKILL.md": "4.7.7",
-    "v8-utilities/SKILL.md": "4.7.7",
-    "v8-utilities/references/client-api-index.md": "4.7.7",
-    "v8-utilities/references/platform-http-routes.md": "4.7.7",
-    "v8-utilities/references/server-api-index.md": "4.7.7",
-    "v8-workflow/SKILL.md": "4.7.7",
-    "workspace-conventions/SKILL.md": "4.7.7"
+    ".microi-skills-version.json": "4.8.1",
+    "README.md": "4.8.1",
+    "ai-engine/SKILL.md": "4.8.1",
+    "ai-engine/agents/openai.yaml": "4.8.1",
+    "app-store/SKILL.md": "4.8.1",
+    "app-store/agents/openai.yaml": "4.8.1",
+    "business-blueprint/SKILL.md": "4.8.1",
+    "datasource-engine/SKILL.md": "4.8.1",
+    "datasource-engine/agents/openai.yaml": "4.8.1",
+    "dos-orm/SKILL.md": "4.8.1",
+    "dos-orm/references/api-reference.md": "4.8.1",
+    "job-engine/SKILL.md": "4.8.1",
+    "job-engine/agents/openai.yaml": "4.8.1",
+    "message-notification/SKILL.md": "4.8.1",
+    "message-notification/agents/openai.yaml": "4.8.1",
+    "message-notification/references/contracts.md": "4.8.1",
+    "microi-ai-app-auth.js": "4.8.1",
+    "microi-ai-application/SKILL.md": "4.8.1",
+    "microi-ai-application/agents/openai.yaml": "4.8.1",
+    "microi-ai-application/references/frontend-baseline.md": "4.8.1",
+    "microi-client-frontend/SKILL.md": "4.8.1",
+    "microi-codex-installer/SKILL.md": "4.8.1",
+    "microi-codex-installer/agents/openai.yaml": "4.8.1",
+    "microi-datasource-mapping/SKILL.md": "4.8.1",
+    "microi-db-schema/SKILL.md": "4.8.1",
+    "microi-db-schema/agents/openai.yaml": "4.8.1",
+    "microi-db-schema/references/core-tables.md": "4.8.1",
+    "microi-db-schema/references/form-component-options.md": "4.8.1",
+    "microi-db-schema/references/schema-overview.md": "4.8.1",
+    "microi-db-schema/references/schema.md": "4.8.1",
+    "microi-db-schema/references/table-catalog.md": "4.8.1",
+    "microi-deployment/SKILL.md": "4.8.1",
+    "microi-deployment/references/deployment-matrix.md": "4.8.1",
+    "microi-docs-coverage/SKILL.md": "4.8.1",
+    "microi-docs-coverage/references/capability-map.md": "4.8.1",
+    "microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs": "4.8.1",
+    "microi-form-engine/SKILL.md": "4.8.1",
+    "microi-form-engine/references/component-catalog.md": "4.8.1",
+    "microi-form-engine/references/data-source-events.md": "4.8.1",
+    "microi-form-layout/SKILL.md": "4.8.1",
+    "microi-frontend-sdk/SKILL.md": "4.8.1",
+    "microi-left-right-layout/SKILL.md": "4.8.1",
+    "microi-microservice/SKILL.md": "4.8.1",
+    "microi-microservice/references/runtime-delivery.md": "4.8.1",
+    "microi-mobile-app-quality/SKILL.md": "4.8.1",
+    "microi-solution-quotation/SKILL.md": "4.8.1",
+    "microi-solution-quotation/agents/openai.yaml": "4.8.1",
+    "microi-solution-quotation/scripts/build_solution_quote.py": "4.8.1",
+    "microi-system-delivery/SKILL.md": "4.8.1",
+    "microi-ui/SKILL.md": "4.8.1",
+    "microi-uniapp-frontend/SKILL.md": "4.8.1",
+    "microi.v8.js": "4.8.1",
+    "module-engine/SKILL.md": "4.8.1",
+    "module-engine/references/module-config.md": "4.8.1",
+    "ocr-engine/SKILL.md": "4.8.1",
+    "ocr-engine/agents/openai.yaml": "4.8.1",
+    "page-engine/SKILL.md": "4.8.1",
+    "performance-testing/SKILL.md": "4.8.1",
+    "playwright-e2e/SKILL.md": "4.8.1",
+    "print-engine/SKILL.md": "4.8.1",
+    "production-readonly-audit/SKILL.md": "4.8.1",
+    "report-engine/SKILL.md": "4.8.1",
+    "report-engine/agents/openai.yaml": "4.8.1",
+    "search-engine/SKILL.md": "4.8.1",
+    "search-engine/agents/openai.yaml": "4.8.1",
+    "spider-engine/SKILL.md": "4.8.1",
+    "translate-engine/SKILL.md": "4.8.1",
+    "translate-engine/agents/openai.yaml": "4.8.1",
+    "ui-design/SKILL.md": "4.8.1",
+    "ui-design/assets/pattern-showcase/app.js": "4.8.1",
+    "ui-design/assets/pattern-showcase/index.html": "4.8.1",
+    "ui-design/assets/pattern-showcase/styles.css": "4.8.1",
+    "ui-design/assets/templates/MCI-DESIGN.md": "4.8.1",
+    "ui-design/references/design-pattern-library.md": "4.8.1",
+    "ui-design/references/mci-design-contract.md": "4.8.1",
+    "ui-design/references/motion-and-media.md": "4.8.1",
+    "ui-design/references/product-flow-recipes.md": "4.8.1",
+    "uniapp-mall-assets/SKILL.md": "4.8.1",
+    "v8-api-config/SKILL.md": "4.8.1",
+    "v8-cache-pattern/SKILL.md": "4.8.1",
+    "v8-crud-api/SKILL.md": "4.8.1",
+    "v8-debugging/SKILL.md": "4.8.1",
+    "v8-explorer-tree/SKILL.md": "4.8.1",
+    "v8-export-import/SKILL.md": "4.8.1",
+    "v8-file-upload/SKILL.md": "4.8.1",
+    "v8-formengine-http/SKILL.md": "4.8.1",
+    "v8-frontend-events/SKILL.md": "4.8.1",
+    "v8-frontend-events/references/bluetooth-print-api.md": "4.8.1",
+    "v8-frontend-events/references/bluetooth-print.md": "4.8.1",
+    "v8-http-integration/SKILL.md": "4.8.1",
+    "v8-image-processing/SKILL.md": "4.8.1",
+    "v8-image-processing/agents/openai.yaml": "4.8.1",
+    "v8-image-processing/references/api-reference.md": "4.8.1",
+    "v8-menu-buttons/SKILL.md": "4.8.1",
+    "v8-mongodb/SKILL.md": "4.8.1",
+    "v8-mq-mqtt/SKILL.md": "4.8.1",
+    "v8-saas-multi-tenant/SKILL.md": "4.8.1",
+    "v8-security/SKILL.md": "4.8.1",
+    "v8-sql-query/SKILL.md": "4.8.1",
+    "v8-table-event/SKILL.md": "4.8.1",
+    "v8-template-engine/SKILL.md": "4.8.1",
+    "v8-utilities/SKILL.md": "4.8.1",
+    "v8-utilities/references/client-api-index.md": "4.8.1",
+    "v8-utilities/references/platform-http-routes.md": "4.8.1",
+    "v8-utilities/references/server-api-index.md": "4.8.1",
+    "v8-workflow/SKILL.md": "4.8.1",
+    "workspace-conventions/SKILL.md": "4.8.1"
   },
   "files": [
     ".microi-skills-version.json",
@@ -253,6 +257,8 @@
     "microi-ai-application/agents/openai.yaml",
     "microi-ai-application/references/frontend-baseline.md",
     "microi-client-frontend/SKILL.md",
+    "microi-codex-installer/SKILL.md",
+    "microi-codex-installer/agents/openai.yaml",
     "microi-datasource-mapping/SKILL.md",
     "microi-db-schema/SKILL.md",
     "microi-db-schema/agents/openai.yaml",

package/{dist/microi.skills → skills}/.microi-skills-version.json

@@ -1,6 +1,6 @@
 {
-  "version": "4.7.7",
+  "version": "4.8.1",
   "versionRule": "Microi version uses three numeric parts. Each publish increments the last part; when a part exceeds 9 it carries to the previous part: 1.0.9 -> 1.1.0, 1.9.9 -> 2.0.0.",
   "managedBy": "Microi.VSCode/bump-version.js",
-  "updatedAt": "2026-08-07T19:41:49.950Z"
+  "updatedAt": "2026-08-08T11:14:40.488Z"
 }

package/{dist/microi.skills → skills}/README.md

@@ -8,7 +8,7 @@
 
 ## 包含的 Skills
 
-当前仓库包含 58 个 `SKILL.md`。以下清单按任务类型组织；AI 必须先完整读取与当前任务匹配的 Skill，再执行源码、MCP、文档或交付操作。
+当前仓库包含 59 个 `SKILL.md`。以下清单按任务类型组织；AI 必须先完整读取与当前任务匹配的 Skill，再执行源码、MCP、文档或交付操作。
 
 ### V8 引擎核心（后端）
 
@@ -82,7 +82,8 @@
 | **microi-datasource-mapping** | 数据源 Key/Value 映射、下拉枚举与前后端显示值一致性 | `microi-datasource-mapping/SKILL.md` |
 | **v8-formengine-http** | 移动端/外部系统直接调用 FormEngine HTTP 路由的约定 | `v8-formengine-http/SKILL.md` |
 | **v8-explorer-tree** | VS Code 插件 V8 资源管理器目录规范和本地文件归档 | `v8-explorer-tree/SKILL.md` |
-| **workspace-conventions** | 工作区文件放置、临时产物、项目专属目录和根目录污染防护 | `workspace-conventions/SKILL.md` |
+| **workspace-conventions** | 工作区文件放置、临时产物、项目专属目录和根目录污染防护 | `workspace-conventions/SKILL.md` |
+| **microi-codex-installer** | Codex 插件立即检测、授权安装、旧 marketplace 迁移与验收 | `microi-codex-installer/SKILL.md` |
 | **production-readonly-audit** | 正式环境只读巡检，不改动线上数据的业务核对流程 | `production-readonly-audit/SKILL.md` |
 | **uniapp-mall-assets** | UniApp/H5/商城上传资源、FileServer、私有临时 URL 与富文本安全 | `uniapp-mall-assets/SKILL.md` |
 
@@ -99,7 +100,7 @@
 
 ### 推荐：VS Code 插件零配置安装
 
-安装 Microi 吾码 VS Code 插件后，在工作区执行初始化/拉取。插件会安装当前版本的完整 `microi.skills`，并为 Codex、GitHub Copilot、Claude Code、Cursor 等生成 `AGENTS.md`、`.github/copilot-instructions.md`、`CLAUDE.md` 和 Cursor rules；不需要手工维护 56 条 Skill 引用。
+安装 Microi 吾码 VS Code 插件后，在工作区执行初始化/拉取。插件会安装当前版本的完整 `microi.skills`，并为 Codex、GitHub Copilot、Claude Code、Cursor 等生成 `AGENTS.md`、`.github/copilot-instructions.md`、`CLAUDE.md` 和 Cursor rules；不需要手工维护 59 条 Skill 引用。
 
 插件升级采用清单和内容哈希做差异更新：未被用户修改的官方 Skill 自动升级，用户已经修改的文件不被整文件覆盖，新增 Skill 自动补齐。发布插件时必须比对源 Skills、插件 `dist`、VSIX 和空工作区初始化产物的相对路径与 SHA-256，不能只检查文件数量。
 

package/{dist/microi.skills → skills}/dos-orm/SKILL.md

@@ -34,6 +34,9 @@ Dos.ORM 是 Microi.Server 底层 C# ORM。它不是接口引擎里的 `V8.Db`：
 - Upsert 幂等依赖数据库唯一键，不能只靠“先查再写”。
 - 租户业务表查询/写入必须包含真实 `OsClient` 范围。
 - 已明确需要的索引在 Microi 业务表上通过 Manifest/MCP 管理，不从临时 SQL 创建。
+- MySQL 用户名或密码包含分号时必须用连接字符串引号包裹，例如
+  `Password="a;b"`；平台统一兼容层只修复“无等号片段紧跟已明确凭据参数”的
+  历史串，其它结构错误继续失败关闭，禁止猜测用户名、密码或默认 `root`。
 
 ## 事务与异步
 

package/{dist/microi.skills → skills}/microi-client-frontend/SKILL.md

@@ -41,8 +41,8 @@ description: Microi.Client 源码架构指南。用于修改 Microi.Client Vue
 
 ### 模块级跨端视图
 
-- Detail/Edit/List/Card 视图属于 `sys_menu`，使用物理字段 `EnableViewSchema`、`ViewSchemaVersion`、`ViewConfigVersion`、`ViewSchema`。
-- 顶层 PC `diy-table` 即使未启用 ViewSchema，也默认显示约 40 至 52px 的紧凑模块标题；只在列表 mixin 生成该 fallback，禁止放宽全局 `selectModuleView()`，否则会误接管 Detail。
+- Detail/Edit/List/Card 视图属于 `sys_menu`，使用物理字段 `EnableViewSchema`、`ViewSchemaVersion`、`ViewConfigVersion`、`ViewSchema`。其中 `EnableViewSchema` 只控制 Detail/Edit 自定义表单视图，List/Card 有有效配置时始终生效；两个版本字段可空，默认按 `1.0/1` 处理。
+- 顶层 PC `diy-table` 即使没有 List ViewSchema，也默认显示约 40 至 52px 的紧凑模块标题。`selectModuleView()` 只能对 List/Card 绕过 `EnableViewSchema`；Detail/Edit 必须继续显式启用，不能被列表 fallback 误接管。
 - `diy_table.DiyConfig`、`diy_field.DiyConfig`、`sys_menu.DiyConfig` 均为废弃兼容字段；禁止向其中写入任何新功能配置。
 - Text、Select、ImgUpload、Map 等数据控件继续放在 `diy-field-component`。
 - EntityHero、MetricStrip、ActionGrid、ResponsiveSection 是独立展示区块，放在 `form-view-blocks`，禁止用虚拟字段或 DevComponent 模拟。
@@ -372,7 +372,7 @@ DiyCommon.FormEngine.AddFormData("table_name", { Field: "value" }, function (res
 - 官方文档：`microi.doc/docs/doc/v8-engine/v8-client.md`。
 - Skills：`v8-frontend-events`、`v8-table-event`、`v8-menu-buttons`、`v8-template-engine`、`v8-formengine-http` 和本 Skill。
 
-`sys_menu.ViewSchema` 使用 `DiyModulePresentationDesigner` 作为配置入口，聚合 `EnableViewSchema / ViewSchemaVersion / ViewConfigVersion / ViewSchema`。设计器可视化编辑默认 List-PC 与 Card-Mobile 视图，保留其它 Detail/Edit、角色视图和未知 JSON 字段；运行时的 EntityHero/MetricStrip 等仍是独立展示区块，不由 DevComponent 参与渲染。
+`sys_menu.ViewSchema` 使用 `DiyModulePresentationDesigner` 作为配置入口，聚合 `EnableViewSchema / ViewSchemaVersion / ViewConfigVersion / ViewSchema`。设计器可视化编辑默认 List-PC 与 Card-Mobile 视图，以独立的自定义表单视图 JSON 编辑 Detail/Edit，并由高级 JSON 保留完整协议、角色视图和未知字段；运行时的 EntityHero/MetricStrip 等仍是独立展示区块，不由 DevComponent 参与渲染。
 
 固定高度的 `diy-form-full` 弹窗只能有一个纵向滚动容器：由弹窗直属 `.el-dialog__body` 承载滚动，Element Plus 的 overlay 和表单顶层 `.el-tabs__content` 必须禁用独立滚动。禁止同时保留 overlay、dialog body、tabs content 三层纵向滚动条；切换表单 Tab 时弹窗外框高度不得变化。
 

package/skills/microi-codex/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: microi-codex
+description: 在 Codex 中完成 Microi吾码 VS Code 扩展的等价工作流，包括连接与登录、AI/MCP 初始化、V8/表单/模块/工作流同步、远程执行与诊断、性能测试、微应用、Playwright 和发布回读。用户提到吾码、Microi、V8引擎、Microi-V8-Engine 或要求使用吾码 Codex 插件时使用。
+---
+
+# Microi吾码 Codex Plugin
+
+本插件与 `Microi.VSCode`、`@microi.net/cli` 共用配置、Token、MCP Server 和 Microi Skills。不要另写原生 HTTP、SQL 或第二套认证实现。
+
+## 先确认工作区连接
+
+1. 调用 `microi_codex`，传 `{ "action": "profiles" }`。
+2. 只有一个已登录连接时，后续可以省略 `profile`；存在多个连接时，始终传 `profiles` 返回的稳定 `name`。
+3. 尚未初始化时，插件根目录是本文件向上两级；使用其中的 `scripts/microi-cli.js`：
+   - `node <plugin-root>/scripts/microi-cli.js init --workspace <workspace>`
+   - 多连接：`profile list|add|remove`
+   - 登录：`auth login|status|logout --profile <name>`
+   - 诊断：`doctor --json`
+4. 登录会在真实终端中隐式输入密码；不要把密码写入命令、日志、Skill、MCP 参数或工作区文件。Token 继续写入 `Microi-V8-Engine/.microi-mcp-tokens.json`，并按 API、OsClient、Type、Network 四段身份隔离。
+
+## 功能路由
+
+- 连接、登录、拉取、推送、差异和 AI 初始化：使用 bundled CLI 的 `profile`、`auth`、`pull`、`push`、`sync status`、`ai init`、`mcp init`、`doctor`。
+- 接口引擎、表单事件、模块、字段、工作流和数据库结构：先用 `action="list_tools"` / `describe_tool`，再调用对应原始 `microi_*` 工具。写工具必须保留确认口令、审计与回读。
+- 远程执行与调试：读取 `v8-debugging/SKILL.md`。Codex 用“获取源码 → 远程执行 → 定位堆栈/日志 → 最小补丁 → 再执行”的结构化循环代替 VS Code DAP 的可视化逐行面板；不得把未执行的源码检查称为真机调试成功。
+- 性能测试：读取 `performance-testing/SKILL.md`，限制并发并输出样本、P95/P99、错误率和停止条件。
+- 微应用：读取 `microi-microservice/SKILL.md`，使用 scaffold、source sync、stream publish 和发布回读原工具；本地构建前遵守内存保护。
+- Playwright：读取 `playwright-e2e/SKILL.md`，使用当前已登录浏览器或受控 Playwright；报告必须来自实际页面执行。
+- 其他领域：从本插件同级 Skills 里选择最小相关 Skill，并完整读取后执行。
+
+## 同步与安全边界
+
+- `Microi-V8-Engine/.microi-config.json` 是三端连接配置事实源；未知字段必须保留。
+- CLI/VS Code/Codex 可并存；较新 provider 版本优先，禁止旧入口回写降级。
+- 推送前先做远端差异检查。写请求超时只表示结果不确定，使用对应 get 工具短超时回读，禁止盲目重复创建或覆盖。
+- 配置和 Token 文件使用现有原子写与锁协议；不要手工拼接或清空用户已有 MCP 配置。
+- Codex Plugin 路由器只选择连接，业务行为必须继续走原 MCP bundle。
+
+完整 VS Code 命令覆盖关系见插件根目录 `assets/feature-matrix.json`。

package/skills/microi-codex-installer/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: microi-codex-installer
+description: 当用户说“帮我初始化/安装/升级/启用/诊断 Microi吾码插件或 Codex 插件”、要求在空白工作区添加吾码服务器与 MCP，或者 Codex 开始处理 Microi 平台任务但 `microi@microi-net` 插件能力缺失时使用。立即做只读检测；用户明确要求安装或初始化时可直接通过 @microi.net/cli 执行，普通对话中则先说明全局改动并取得一次明确授权，禁止静默安装。
+---
+
+# Microi吾码 Codex 插件安装
+
+本技能负责发现、安装、升级和迁移 Microi吾码 Codex 插件。正式 marketplace 名称固定为 `microi-net`，插件选择器固定为 `microi@microi-net`，唯一 npm 包为 `@microi.net/cli`；该包同时提供 `microi` CLI、Codex Plugin、Skills 与 MCP。
+
+只要本技能已经由 Microi.VSCode、工作区 `microi.skills` 或已安装插件提供，用户说“帮我初始化 Microi吾码插件”时就必须识别该意图，用户不需要再次说出 npm 包名。绝对空白且任何宿主都尚未提供本技能的 AI 会话无法依靠尚未加载的 Skill 自我发现包名；因此冷启动入口统一固化在 VS Code 初始化产物、`@microi.net/cli` 与 Codex Plugin 三处，而不是要求用户记忆第二个包。
+
+## 强制入口规则
+
+- Codex 开始处理 Microi吾码低代码、V8、MCP、表单/模块/流程、微应用或平台源码任务时，先判断当前任务是否已经提供 `microi` 插件的 Skills/MCP/CLI 能力。
+- 能力不明确时立即做只读检测，不得等到缺少工具或上下文后才检查。
+- 用户明确说“安装/升级/启用吾码 Codex 插件”时，该请求本身就是安装授权；可直接执行安装命令，不再重复询问。
+- 用户只是在进行普通 Microi 业务对话、尚未要求安装时，发现插件缺失后必须立即说明将修改 Codex 全局 marketplace、插件配置和本地缓存，并请求一次明确同意。未获同意不得安装、下载或改写全局配置。
+- 用户拒绝或暂不安装时，继续使用工作区现有 `microi.skills`、`@microi.net/cli` 或 MCP 完成可完成的工作，不得阻塞或反复提示。
+
+## 检测
+
+优先使用已经安装的 CLI：
+
+```bash
+microi codex status --json
+```
+
+如果 `microi` 命令不存在，只可先运行不会下载包的本机只读检查：
+
+```bash
+codex plugin marketplace list
+codex plugin list
+```
+
+成功状态必须同时满足：
+
+- marketplace 为 `microi-net`；
+- `microi@microi-net` 显示 `installed, enabled`；
+- 已安装版本等于 CLI 内置 marketplace 的目标版本。
+
+`microi-official` 和 `microi@microi-official` 仅是旧标识，不得写入新文档或新配置；安装器会在新版安装成功后迁移并清理旧标识。
+
+## 获得授权后安装
+
+已安装全局 CLI 时：
+
+```bash
+microi codex install --yes
+```
+
+没有全局 CLI，但用户已明确授权安装时：
+
+```bash
+npx --yes @microi.net/cli@latest codex install --yes
+```
+
+`--yes` 只表示当前用户已经授权这次全局修改，不得由 AI 在普通 Microi 对话中自行补上。只有版本不一致且普通安装不能升级、并确认目标 npm 包已经公开可读时，才使用：
+
+```bash
+microi codex install --yes --force
+```
+
+开发者从可信本地源码验收时，可以显式指定 marketplace 源：
+
+```bash
+microi codex install --yes --source <Microi.VSCode目录>
+```
+
+普通用户不得被引导到来历不明的 Git、本地目录或第三方 registry。不得通过 VPN、伪造地区/企业身份或共享账号绕过 OpenAI 地区与身份政策。
+
+## 空工作区初始化
+
+用户明确要求“初始化 Microi吾码插件/AI 配置”“添加吾码服务器并配置 MCP”时，该请求同时授权在其指定工作区生成吾码 AI 配置；如果还明确要求安装 Codex Plugin，则先按上一节完成全局插件安装。随后优先执行唯一包的初始化命令：
+
+```bash
+npx --yes @microi.net/cli@latest init --workspace <工作区>
+```
+
+用户还要求首次拉取全部 V8 与数据库结构时增加 `--pull`。用户已经全局安装 CLI 时改用：
+
+```bash
+microi init --workspace <工作区> --pull
+```
+
+`init` 必须能够在干净空目录中依次添加服务器连接、交互登录、生成 `microi.skills/`、`AGENTS.md`、`CLAUDE.md`、Copilot/Cursor 指令、typings、`jsconfig.json`，并配置 Codex、VS Code、Cursor、Trae、Claude MCP。密码只允许隐式输入，禁止放入命令参数、对话记录或生成文件。完成后运行 `microi doctor --workspace <工作区> --json`；若同时安装了 Codex Plugin，再运行 `microi codex status --json`。
+
+## 安装后验收
+
+再次执行：
+
+```bash
+microi codex status --json
+```
+
+只有返回 `ok: true` 且选择器、状态和版本全部正确，才报告安装完成。随后明确提示用户新建 Codex 任务或重载 Codex；当前已经打开的任务通常不会热加载新增 Skills/MCP。
+
+若 npm 返回 `E404`，说明 `@microi.net/cli` 的目标版本尚未公开或仍在传播。不得删除仍可用的旧插件、不得重复发布同一不可变版本，也不得声称安装成功。

package/skills/microi-codex-installer/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Microi吾码 Codex 插件安装"
+  short_description: "检测并安装或升级 Microi吾码 Codex 插件"
+  default_prompt: "使用 $microi-codex-installer 在取得用户授权后检测、安装或升级 Microi吾码 Codex 插件。"
+
+policy:
+  allow_implicit_invocation: true

package/{dist/microi.skills → skills}/microi-microservice/SKILL.md

@@ -138,6 +138,14 @@ AI 生成菜单微服务时，应优先封装一个 `callMicroiHost(action, data
 加载/协议/运行时异常只由宿主兜底显示；子应用业务错误标记 `handled=true` 后宿主不得重复提示。
 加载失败页至少显示 AppKey、PageKey、路由、版本、入口、HTTP 状态、发布状态、资产来源、挂载状态和安全原因码，并提供重试、返回与复制诊断。
 
+### 首次挂载、iframe 交互与接口契约
+
+- `/micro-app/:appKey/:microPath(.*)*` 是平台协议路由，不是租户菜单。它必须在首轮 URL 解析前作为宿主固定路由注册，且宿主组件要进入首屏主包；不能等登录后的菜单请求或异步路由注入，否则直接打开、书签或浏览器刷新会先命中空 `RouterView`，网络抖动时就表现为“刷新一次才出现”。页面是否存在仍由 `MicroApp/Resolve(RequirePage=true)` 和登录守卫校验，固定注册路由不授予菜单或数据权限。
+- `micro-app` 的 `mounted` 生命周期只表示容器和脚本执行流程完成，不能单独证明子框架已经在 `#app` 渲染出可见内容。宿主给每次解析和重挂载分别下发 `hostGeneration`、`hostMountAttempt`；子应用在 Vue/React 根节点挂载并完成 `nextTick + requestAnimationFrame` 后用 `forceDispatch` 回传 `micro-app:ready`。宿主只接受与当前解析世代、挂载尝试都一致的就绪事件，再复核 `micro-app-body`、`#app` 的非空内容、可见样式以及非零宽高；`micro-app-body` 尚未创建必须判为“仍未渲染”，绝不能当成未知但成功。超时只自动销毁重建一次，第二次失败显示稳定诊断，禁止让白屏永久停留在 `mounted` 状态。
+- iframe 内的 pointer/click 不会冒泡到宿主 document。子应用应在捕获阶段发送 `micro-app:interaction`，宿主再广播统一的“关闭全局浮层”事件。`@micro-zoe/micro-app` EventCenter 会去重内容相同的普通 dispatch，连续交互事件必须使用 `forceDispatch`；否则只能收到第一次点击。宿主的 Select/Popover 等浮层若 teleport 到 `body`，收到通知后还要显式执行组件的 click-outside/close 路径并清理搜索值和焦点，不能只依赖 `blur`。
+- 调接口时以真实 `DosResult.Data` DTO 为准，不能仅凭界面名称猜成数组。例如在线终端接口返回的是用户视图对象 `{ Terminals: [...] }`，前端应读取 `Data.Terminals`，只把 `Data` 直接数组作为旧版兼容；列表 key 优先使用 `ConnectionId`、`DeviceClientId` 等稳定标识。修复前先沿 Controller → Service → 序列化对象 → 子应用解析完整核对契约，避免为正确的后端响应另写一个平行接口。
+- 发布前统一更新 `package.json`、`package-lock.json` 根包版本、`.microi-micro-app.json`、应用 `CurrentVersion/BuildVersion`、微服务与页面 `BuildVersion`。应用商城候选包可以先嵌入待发布源码和构建产物，但 `.resource-sync-base` 只能在官方远端发布完成、逐文件内容哈希回读一致后由资源同步器推进，禁止把本地候选提前写成共同基线。
+
 ## 验收
 
 - 源码、构建文件、运行时、页面路由和菜单五层分别回读。

package/{dist/microi.skills → skills}/module-engine/SKILL.md

@@ -76,13 +76,13 @@ Iframe 不把长期 Token、密码或连接串放 URL。第三方单点登录使
 
 ## 跨端 ViewSchema
 
-顶层 PC 数据列表默认使用紧凑的新模块标题样式；即使未启用 ViewSchema，也不能退回无标题的旧外观。无指标头部固定 `44px`、含指标头部固定 `62px`，连同间距总纵向占用约 `50px / 68px`。子表、关联表、嵌入表不重复显示，移动端由固定导航栏承载标题。`ViewSchema` 只负责个性化标题、指标、复合列和卡片，不改变 Detail/Edit 的显式启用语义。
+顶层 PC 数据列表默认使用紧凑的新模块标题样式；即使未启用自定义表单视图，也不能退回无标题的旧外观。无指标头部固定 `44px`、含指标头部固定 `62px`，连同间距总纵向占用约 `50px / 68px`。子表、关联表、嵌入表不重复显示，移动端由固定导航栏承载标题。`Scene=List/Card` 的个性化标题、指标、复合列和卡片配置存在时必须直接生效；`EnableViewSchema` 只控制 Detail/Edit 自定义表单视图。
 
 PC 列表的固定结构顺序是“模块 Hero（标题/副标题/动态指标）→ PageTabs → 查询与表格”，Hero 必须渲染在页面多 Tab 上方。头部只使用一次性入场和一次性轻量光效，禁止持续循环动画；`prefers-reduced-motion: reduce` 必须关闭动画和过渡。
 
-`ViewSchema` 是模块级视图，不写入已废弃的通用 `DiyConfig`。优先通过 sys_menu“跨端视图”的 `DiyModulePresentationDesigner` 配置；需要角色视图或 Detail/Edit 高级布局时再使用设计器的高级 JSON。启用后仍须：
+`ViewSchema` 是模块级视图，不写入已废弃的通用 `DiyConfig`。优先通过 sys_menu“跨端视图”的 `DiyModulePresentationDesigner` 配置；Detail/Edit 使用独立的“自定义表单视图 JSON”，需要完整协议、角色优先级或未知扩展字段时再使用高级 JSON。启用自定义表单视图后仍须：
 
-- 配置 `EnableViewSchema`、语义版本和递增配置版本。
+- 配置 `EnableViewSchema=1`；`ViewSchemaVersion/ViewConfigVersion` 可为空，分别按 `1.0/1` 处理并在后续变更时递增配置版本。
 - 按 Scene、Device、RoleIds、Priority 选择视图。
 - 配置损坏或客户端不支持时回退标准 `sys_menu + diy_table + diy_field`，不能白屏。
 - 小程序只消费声明式动作，不执行 PC 的任意 `V8Code`。

package/{dist/microi.skills → skills}/module-engine/references/module-config.md

@@ -77,12 +77,12 @@
 
 | 字段 | 说明 |
 |---|---|
-| `EnableViewSchema` | 1 启用 |
-| `ViewSchemaVersion` | 协议语义版本 |
-| `ViewConfigVersion` | 每次发布递增，驱动缓存失效 |
+| `EnableViewSchema` | 1 启用 Detail/Edit 自定义表单视图；不控制 List/Card |
+| `ViewSchemaVersion` | 可选；为空默认 `1.0` |
+| `ViewConfigVersion` | 可选；为空默认 `1`，后续发布递增并驱动缓存失效 |
 | `ViewSchema` | Detail/Edit/List/Card JSON |
 
-顶层 PC 列表不依赖 `EnableViewSchema` 才采用新样式：平台始终显示紧凑模块标题。模块表单中的 `DiyModulePresentationDesigner` 负责可视化编辑默认 List-PC 与 Card-Mobile 视图，并保留 Detail/Edit、角色视图及未知 JSON 字段。
+顶层 PC 列表不依赖 `EnableViewSchema` 才采用新样式：平台始终显示紧凑模块标题；ViewSchema 中有效的 List-PC 与 Card-Mobile 配置也不受该开关限制。模块表单中的 `DiyModulePresentationDesigner` 负责可视化编辑这些展示配置，以独立 JSON 编辑 Detail/Edit，并通过高级 JSON 保留角色视图及未知字段。
 
 视图项常用字段：`Key`、`Scene`、`Device`、`RoleIds`、`Priority`、`Layout`。
 标准区块包括 `EntityHero`、`MetricStrip`、`ActionGrid`、