@microi.net/cli 5.5.8 → 5.5.9

package/.codebuddy-plugin/marketplace.json

@@ -5,13 +5,13 @@
     "url": "https://microi.net"
   },
   "description": "Microi吾码官方 AI 插件市场",
-  "version": "5.5.8",
+  "version": "5.5.9",
   "plugins": [
     {
       "name": "microi",
       "source": ".",
       "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
-      "version": "5.5.8",
+      "version": "5.5.9",
       "strict": true
     }
   ]

package/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "microi",
-  "version": "5.5.8",
+  "version": "5.5.9",
   "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
   "author": {
     "name": "Microi.Net",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "microi",
-  "version": "5.5.8",
+  "version": "5.5.9",
   "description": "Microi吾码低代码平台的 Codex 开发插件，共享 VS Code/CLI 的连接、同步、MCP、V8 与交付能力。",
   "author": {
     "name": "Microi.Net",

package/.workbuddy-plugin/marketplace.json

@@ -5,13 +5,13 @@
     "url": "https://microi.net"
   },
   "description": "Microi吾码官方 AI 插件市场",
-  "version": "5.5.8",
+  "version": "5.5.9",
   "plugins": [
     {
       "name": "microi",
       "source": ".",
       "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
-      "version": "5.5.8",
+      "version": "5.5.9",
       "strict": true
     }
   ]

package/.workbuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "microi",
-  "version": "5.5.8",
+  "version": "5.5.9",
   "description": "Microi吾码 AI 开发插件：服务器连接、Skills、MCP、V8 全量同步与低代码交付",
   "author": {
     "name": "Microi.Net",

package/assets/build-meta.json

@@ -1,6 +1,6 @@
 {
-  "builtAt": "2026-09-07T21:23:25.619Z",
-  "version": "5.5.8",
+  "builtAt": "2026-09-08T15:03:09.827Z",
+  "version": "5.5.9",
   "sourceProducts": [
     "vscode-extension",
     "microi-cli",
@@ -13,6 +13,6 @@
     "cli": "616e4bdd794311ba577a00694de75e7604dc91d6b292f63261fbd83b96b2f5b4",
     "router": "ffc14787fc2d3d6173b7a779b77139b759eb1d482cea787f71283f4017a4e223",
     "broker": "caae2730cc411d11c20f33b367968f7538aae8f5b65a713fcc557deedaefcf70",
-    "dshBundle": "63e9aea9b47f2eb504d06bacd706a59acc576710d26fed3a1dc7317ec739b806"
+    "dshBundle": "844fff122987d522f923835df46700936774e85ef334b715a87a976b09cfd32a"
   }
 }

package/cordis.patch.yml

@@ -7,7 +7,7 @@
         serverName: microi
         transport: stdio
         command: !!js process.execPath
-        args: ["-e","/*\n * DeepSeek Harness 通过 profile bundle 加载此 `node -e` 引导脚本。\n * DSH 不保证 MCP 子进程 cwd 位于 npm 包根，因此按 DSH_HOME/profile 定位\n * 当前版本的 @microi.net/cli，再复用 Codex 同源适配器与多连接路由器。\n */\nconst fs = require('node:fs');\nconst os = require('node:os');\nconst path = require('node:path');\nconst packageName = '@microi.net/cli';\nconst expectedVersion = '5.5.8';\n\nfunction readJson(filePath) {\n  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }\n  catch { return undefined; }\n}\n\nfunction expandHome(value) {\n  if (value === '~') return os.homedir();\n  if (value.startsWith('~/') || value.startsWith('~\\\\')) return path.join(os.homedir(), value.slice(2));\n  return value;\n}\n\nfunction validRoot(value) {\n  const root = path.resolve(value);\n  const pkg = readJson(path.join(root, 'package.json'));\n  const patch = path.join(root, 'cordis.patch.yml');\n  const adapter = path.join(root, 'scripts', 'mcp-codex-stdio-adapter.js');\n  const router = path.join(root, 'scripts', 'microi-codex-router.js');\n  if (pkg?.name !== packageName || pkg?.version !== expectedVersion) return undefined;\n  if (pkg?.dsh?.bundle?.patch !== './cordis.patch.yml') return undefined;\n  if (![patch, adapter, router].every(filePath => fs.existsSync(filePath))) return undefined;\n  return { root: fs.realpathSync(root), adapter, router, modifiedAt: fs.statSync(router).mtimeMs };\n}\n\nfunction findPlugin() {\n  const explicit = String(process.env.MICROI_DSH_PLUGIN_ROOT || '').trim();\n  if (explicit) {\n    const plugin = validRoot(explicit);\n    if (!plugin) throw new Error(`MICROI_DSH_PLUGIN_ROOT 不是版本 ${expectedVersion} 的有效 Microi DSH bundle：${explicit}`);\n    return plugin;\n  }\n  const configuredHome = String(process.env.DSH_HOME || '').trim();\n  const dshHome = path.resolve(expandHome(configuredHome || path.join(os.homedir(), '.dsh')));\n  const profilesRoot = path.join(dshHome, 'profiles');\n  const candidates = [];\n  if (fs.existsSync(profilesRoot)) {\n    for (const entry of fs.readdirSync(profilesRoot, { withFileTypes: true })) {\n      if (!entry.isDirectory() || entry.name === 'node_modules') continue;\n      const root = path.join(profilesRoot, entry.name, 'node_modules', '@microi.net', 'cli');\n      const plugin = validRoot(root);\n      if (plugin) candidates.push(plugin);\n    }\n  }\n  candidates.sort((left, right) => right.modifiedAt - left.modifiedAt);\n  if (!candidates[0]) throw new Error(`未在 ${profilesRoot} 找到版本 ${expectedVersion} 的 ${packageName}`);\n  return candidates[0];\n}\n\ntry {\n  const plugin = findPlugin();\n  process.env.MICROI_DSH_PLUGIN_ROOT = plugin.root;\n  process.env.MICROI_CODEX_PLUGIN_ROOT = plugin.root;\n  process.env.MICROI_TOOL_SOURCE = 'dsh';\n  process.env.MICROI_TOOL_VERSION = expectedVersion;\n  process.env.MICROI_WORKSPACE_ROOT = process.env.MICROI_WORKSPACE_ROOT || process.cwd();\n  process.argv[2] = plugin.router;\n  require(plugin.adapter);\n} catch (error) {\n  console.error(`[microi-dsh-bootstrap] ${error instanceof Error ? error.message : String(error)}`);\n  process.exit(1);\n}\n"]
+        args: ["-e","/*\n * DeepSeek Harness 通过 profile bundle 加载此 `node -e` 引导脚本。\n * DSH 不保证 MCP 子进程 cwd 位于 npm 包根，因此按 DSH_HOME/profile 定位\n * 当前版本的 @microi.net/cli，再复用 Codex 同源适配器与多连接路由器。\n */\nconst fs = require('node:fs');\nconst os = require('node:os');\nconst path = require('node:path');\nconst packageName = '@microi.net/cli';\nconst expectedVersion = '5.5.9';\n\nfunction readJson(filePath) {\n  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }\n  catch { return undefined; }\n}\n\nfunction expandHome(value) {\n  if (value === '~') return os.homedir();\n  if (value.startsWith('~/') || value.startsWith('~\\\\')) return path.join(os.homedir(), value.slice(2));\n  return value;\n}\n\nfunction validRoot(value) {\n  const root = path.resolve(value);\n  const pkg = readJson(path.join(root, 'package.json'));\n  const patch = path.join(root, 'cordis.patch.yml');\n  const adapter = path.join(root, 'scripts', 'mcp-codex-stdio-adapter.js');\n  const router = path.join(root, 'scripts', 'microi-codex-router.js');\n  if (pkg?.name !== packageName || pkg?.version !== expectedVersion) return undefined;\n  if (pkg?.dsh?.bundle?.patch !== './cordis.patch.yml') return undefined;\n  if (![patch, adapter, router].every(filePath => fs.existsSync(filePath))) return undefined;\n  return { root: fs.realpathSync(root), adapter, router, modifiedAt: fs.statSync(router).mtimeMs };\n}\n\nfunction findPlugin() {\n  const explicit = String(process.env.MICROI_DSH_PLUGIN_ROOT || '').trim();\n  if (explicit) {\n    const plugin = validRoot(explicit);\n    if (!plugin) throw new Error(`MICROI_DSH_PLUGIN_ROOT 不是版本 ${expectedVersion} 的有效 Microi DSH bundle：${explicit}`);\n    return plugin;\n  }\n  const configuredHome = String(process.env.DSH_HOME || '').trim();\n  const dshHome = path.resolve(expandHome(configuredHome || path.join(os.homedir(), '.dsh')));\n  const profilesRoot = path.join(dshHome, 'profiles');\n  const candidates = [];\n  if (fs.existsSync(profilesRoot)) {\n    for (const entry of fs.readdirSync(profilesRoot, { withFileTypes: true })) {\n      if (!entry.isDirectory() || entry.name === 'node_modules') continue;\n      const root = path.join(profilesRoot, entry.name, 'node_modules', '@microi.net', 'cli');\n      const plugin = validRoot(root);\n      if (plugin) candidates.push(plugin);\n    }\n  }\n  candidates.sort((left, right) => right.modifiedAt - left.modifiedAt);\n  if (!candidates[0]) throw new Error(`未在 ${profilesRoot} 找到版本 ${expectedVersion} 的 ${packageName}`);\n  return candidates[0];\n}\n\ntry {\n  const plugin = findPlugin();\n  process.env.MICROI_DSH_PLUGIN_ROOT = plugin.root;\n  process.env.MICROI_CODEX_PLUGIN_ROOT = plugin.root;\n  process.env.MICROI_TOOL_SOURCE = 'dsh';\n  process.env.MICROI_TOOL_VERSION = expectedVersion;\n  process.env.MICROI_WORKSPACE_ROOT = process.env.MICROI_WORKSPACE_ROOT || process.cwd();\n  process.argv[2] = plugin.router;\n  require(plugin.adapter);\n} catch (error) {\n  console.error(`[microi-dsh-bootstrap] ${error instanceof Error ? error.message : String(error)}`);\n  process.exit(1);\n}\n"]
         env:
           MICROI_TOOL_SOURCE: dsh
         cwd: !!js process.cwd()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microi.net/cli",
-  "version": "5.5.8",
+  "version": "5.5.9",
   "description": "Microi吾码 AI 开发 CLI 与多宿主 Plugin：服务器连接、Skills、MCP、V8 同步和低代码交付",
   "license": "MIT",
   "homepage": "https://microi.net/doc/v8-engine/vs-code-plugin.html",

package/scripts/microi-skills.meta.json

@@ -1,13 +1,13 @@
 {
-  "builtAt": "2026-09-07T21:23:24.816Z",
+  "builtAt": "2026-09-08T15:03:08.890Z",
   "source": "../microi.skills",
   "extension": {
     "name": "v8-engine",
-    "version": "5.5.8",
+    "version": "5.5.9",
     "publisher": "Microi"
   },
   "skills": {
-    "version": "5.5.8",
+    "version": "5.5.9",
     "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"
   },
@@ -15,13 +15,13 @@
     "dir": "dist/microi.skills",
     "files": 184,
     "skills": 67,
-    "bytes": 2395426
+    "bytes": 2401211
   },
   "fileHashes": {
-    ".microi-skills-version.json": "6259bb9fa45f898769a0a55e5788d95a76451c153369002c4f900aa098ad764a",
+    ".microi-skills-version.json": "e7fe3b24f1d85d3cf8fe00df930ddae924f0d5706864c2ce152947a454307c0b",
     ".progressive-disclosure-manifest.json": "11c3cb160643398b48ed8f82e8848ffd086a549ce664b90d659660980d805ff4",
     "README.md": "bb09053c6ce4ce3fb4add46c62f4bc2ecd7fa5589e1c206c1aa59f655ca140ec",
-    "ai-engine/SKILL.md": "3a098b42f3f918104e825967c3b61fa3fac32d4f7a55fb5529650aa1c29c7baa",
+    "ai-engine/SKILL.md": "7f1c443e63c1e5334333180d9ad42dc2031ab3968c8c688ffeb0985bc7ed6ff1",
     "ai-engine/agents/openai.yaml": "40deb07801006a46b9a7f0020d13251955eeadd04c8e591160210479936f8b5b",
     "ai-platform-governance/SKILL.md": "84ca4bcacf15deecd0c04dc1a664b23041a6a5f020d3a5288c5458b5e7da4b8e",
     "ai-platform-governance/references/progressive-01-功能开关.md": "ea46fb02267e9e3ace3d9d72e67b02183c61e5c198f4b2f27e8196d6ee6d0bec",
@@ -34,13 +34,13 @@
     "dos-orm/references/api-reference.md": "facc5e62cd6439a06263580dab9656271118d4bb5a91b5d9230a79136e6daa72",
     "email-engine/SKILL.md": "5c1ae108b66a7b2dabb9e0637a90ab09d87c3cfd3d17f750c9caa479a23a0dba",
     "email-engine/references/v8-email.md": "6568533ea84f67206c5408a6e4627646a9967f71c2f5e37462409c9641a45771",
-    "job-engine/SKILL.md": "5d3322f183475bdb7acfa157112bcee3b859b740caeafb57a7afaba0efb58d0d",
+    "job-engine/SKILL.md": "506b9c2b2c4b589066299aa489511fdf730bdda15137d15602f14250b915b7e7",
     "job-engine/agents/openai.yaml": "65889ee39bc34caca9085539d8954a381aab93590c5635eea3bb6f4c001934af",
     "message-notification/SKILL.md": "09b6b9b8ba67627cb4603a69a3a6530db943ffec92adcb520a50da00fad00ee1",
     "message-notification/agents/openai.yaml": "d0e259921410e94caaf8b376d690a529842446e3f32c9523b7dfd1bda599f58c",
     "message-notification/references/contracts.md": "fd520821d533ead45ab6a476bd53cab79b19219cd46ef26120181dbd35dfcb0d",
     "microi-ai-app-auth.js": "e7f62522709eca196dea9c4170da8095cef69dfdf96e00dc470825a6cf4e2a01",
-    "microi-ai-application/SKILL.md": "de48dd57de350dcc3e605bc5075ff0d6cfa33e7f7e450e59cbdd6afe32e02e0b",
+    "microi-ai-application/SKILL.md": "773e957fa9de2017de03ea4ca69b082b34c4f3b68dd25fc7dca6b6f852b022a0",
     "microi-ai-application/agents/openai.yaml": "d3dfc4d0f2fda3391e90e661ca9d8d051cb43824b011d1a88e99db135870454f",
     "microi-ai-application/references/frontend-baseline.md": "c21a2d38292fd8d445a7538afb45d609881f624f32d39c0fc4bbbb3c2fa64a74",
     "microi-client-frontend/SKILL.md": "73c75058bf1158791433391b708295f70e30860612e49dcd03559f5f1cae5ed1",
@@ -71,7 +71,7 @@
     "microi-frontend-sdk/SKILL.md": "f05d35dc4427267582404e5e905654b240ffc0fdcd4c155516fa783eb38c5e14",
     "microi-frontend-sdk/references/progressive-01-token-当前登录用户与当前终端登录协议.md": "5dea28edec5a31b6e6e5e15fefc03df9d1ad9bd4b583388fc77bd2aa67a19165",
     "microi-left-right-layout/SKILL.md": "e2f051bce91e6b7cd103599ea526d543fd0f8caaa4c92c71e9e5d81b1a90cf7d",
-    "microi-microservice/SKILL.md": "6bf708ff1c9a30737fa35889fb62aff9770c822c4ac3398d8fc6d277c61423c5",
+    "microi-microservice/SKILL.md": "8ad8077a09259c3f56de473970c55b1882b4bdc73dc3c42dc7f79576eb07faa6",
     "microi-microservice/references/runtime-delivery.md": "0080c9a2611f4b41b490ab896e4dae9a9f086995c8dd608998adc8af81302506",
     "microi-mobile-app-quality/SKILL.md": "9b9cb03a51c586e789720b901a1d4ad8dc4a0abb5913d78ee4c1d2d6882f9837",
     "microi-mobile-app-quality/references/progressive-01-4-重要按钮必须带图标.md": "ec938bd1a64b9896ff5d3165ad217ee5c68a22a51ddb690d8a8a0c7a9365c512",
@@ -204,190 +204,190 @@
     "workspace-conventions/references/progressive-03-cli-与-ide-插件错版共存约定.md": "86db1f03700fd54dd824d28c553c678202e8f74b796fd0f9d91f63bf53a530b1"
   },
   "fileVersions": {
-    ".microi-skills-version.json": "5.5.8",
-    ".progressive-disclosure-manifest.json": "5.5.8",
-    "README.md": "5.5.8",
-    "ai-engine/SKILL.md": "5.5.8",
-    "ai-engine/agents/openai.yaml": "5.5.8",
-    "ai-platform-governance/SKILL.md": "5.5.8",
-    "ai-platform-governance/references/progressive-01-功能开关.md": "5.5.8",
-    "app-store/SKILL.md": "5.5.8",
-    "app-store/agents/openai.yaml": "5.5.8",
-    "business-blueprint/SKILL.md": "5.5.8",
-    "datasource-engine/SKILL.md": "5.5.8",
-    "datasource-engine/agents/openai.yaml": "5.5.8",
-    "dos-orm/SKILL.md": "5.5.8",
-    "dos-orm/references/api-reference.md": "5.5.8",
-    "email-engine/SKILL.md": "5.5.8",
-    "email-engine/references/v8-email.md": "5.5.8",
-    "job-engine/SKILL.md": "5.5.8",
-    "job-engine/agents/openai.yaml": "5.5.8",
-    "message-notification/SKILL.md": "5.5.8",
-    "message-notification/agents/openai.yaml": "5.5.8",
-    "message-notification/references/contracts.md": "5.5.8",
-    "microi-ai-app-auth.js": "5.5.8",
-    "microi-ai-application/SKILL.md": "5.5.8",
-    "microi-ai-application/agents/openai.yaml": "5.5.8",
-    "microi-ai-application/references/frontend-baseline.md": "5.5.8",
-    "microi-client-frontend/SKILL.md": "5.5.8",
-    "microi-client-frontend/references/progressive-01-3-动态按钮系统.md": "5.5.8",
-    "microi-client-frontend/references/progressive-02-8-运行时高频坑复盘.md": "5.5.8",
-    "microi-client-frontend/references/progressive-03-vue3-前端微服务宿主规则.md": "5.5.8",
-    "microi-codex-installer/SKILL.md": "5.5.8",
-    "microi-codex-installer/agents/openai.yaml": "5.5.8",
-    "microi-codex/SKILL.md": "5.5.8",
-    "microi-datasource-mapping/SKILL.md": "5.5.8",
-    "microi-db-schema/SKILL.md": "5.5.8",
-    "microi-db-schema/agents/openai.yaml": "5.5.8",
-    "microi-db-schema/references/core-tables.md": "5.5.8",
-    "microi-db-schema/references/form-component-options.md": "5.5.8",
-    "microi-db-schema/references/schema-overview.md": "5.5.8",
-    "microi-db-schema/references/schema.md": "5.5.8",
-    "microi-db-schema/references/table-catalog.md": "5.5.8",
-    "microi-deployment/SKILL.md": "5.5.8",
-    "microi-deployment/references/deployment-matrix.md": "5.5.8",
-    "microi-docs-coverage/SKILL.md": "5.5.8",
-    "microi-docs-coverage/references/capability-map.md": "5.5.8",
-    "microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs": "5.5.8",
-    "microi-form-engine/SKILL.md": "5.5.8",
-    "microi-form-engine/references/component-catalog.md": "5.5.8",
-    "microi-form-engine/references/data-source-events.md": "5.5.8",
-    "microi-form-layout/SKILL.md": "5.5.8",
-    "microi-form-layout/references/progressive-01-3-三种分组的存储与配置.md": "5.5.8",
-    "microi-frontend-sdk/SKILL.md": "5.5.8",
-    "microi-frontend-sdk/references/progressive-01-token-当前登录用户与当前终端登录协议.md": "5.5.8",
-    "microi-left-right-layout/SKILL.md": "5.5.8",
-    "microi-microservice/SKILL.md": "5.5.8",
-    "microi-microservice/references/runtime-delivery.md": "5.5.8",
-    "microi-mobile-app-quality/SKILL.md": "5.5.8",
-    "microi-mobile-app-quality/references/progressive-01-4-重要按钮必须带图标.md": "5.5.8",
-    "microi-mobile-app-quality/references/progressive-02-9-主题切换必须真实且全局生效.md": "5.5.8",
-    "microi-solution-quotation/SKILL.md": "5.5.8",
-    "microi-solution-quotation/agents/openai.yaml": "5.5.8",
-    "microi-solution-quotation/scripts/build_solution_quote.py": "5.5.8",
-    "microi-sso/SKILL.md": "5.5.8",
-    "microi-sso/references/acceptance.md": "5.5.8",
-    "microi-sso/references/configuration-and-security.md": "5.5.8",
-    "microi-sso/references/inbound.md": "5.5.8",
-    "microi-sso/references/outbound.md": "5.5.8",
-    "microi-system-delivery/SKILL.md": "5.5.8",
-    "microi-system-delivery/references/progressive-01-标准工作流.md": "5.5.8",
-    "microi-system-delivery/references/progressive-02-自动化测试必须覆盖的坑.md": "5.5.8",
-    "microi-ui/SKILL.md": "5.5.8",
-    "microi-ui/references/progressive-01-移动端场景蓝图.md": "5.5.8",
-    "microi-uniapp-frontend/SKILL.md": "5.5.8",
-    "microi-uniapp-frontend/references/progressive-01-移动端分类-双栏列表独立滚动.md": "5.5.8",
-    "microi-uniapp-frontend/references/progressive-02-关键业务资产不得默认选中.md": "5.5.8",
-    "microi.v8.js": "5.5.8",
-    "module-engine/SKILL.md": "5.5.8",
-    "module-engine/references/module-config.md": "5.5.8",
-    "ocr-engine/SKILL.md": "5.5.8",
-    "ocr-engine/agents/openai.yaml": "5.5.8",
-    "page-engine/SKILL.md": "5.5.8",
-    "page-engine/references/progressive-01-所有组件类型.md": "5.5.8",
-    "page-engine/references/progressive-02-版本历史-并发保存与回滚.md": "5.5.8",
-    "performance-testing/SKILL.md": "5.5.8",
-    "playwright-e2e/SKILL.md": "5.5.8",
-    "playwright-e2e/references/progressive-01-全自动登录-免验证码-但不免密码-必读.md": "5.5.8",
-    "playwright-e2e/references/progressive-02-文字对比度与可读性自动化检查-必做.md": "5.5.8",
-    "playwright-e2e/references/progressive-03-microi-helper-模板.md": "5.5.8",
-    "playwright-e2e/references/progressive-04-ci-建议.md": "5.5.8",
-    "print-engine/SKILL.md": "5.5.8",
-    "production-readonly-audit/SKILL.md": "5.5.8",
-    "report-engine/SKILL.md": "5.5.8",
-    "report-engine/agents/openai.yaml": "5.5.8",
-    "scripts/optimize-progressive-disclosure.mjs": "5.5.8",
-    "scripts/refresh-progressive-disclosure.mjs": "5.5.8",
-    "scripts/validate-progressive-disclosure.mjs": "5.5.8",
-    "search-engine/SKILL.md": "5.5.8",
-    "search-engine/agents/openai.yaml": "5.5.8",
-    "spider-engine/SKILL.md": "5.5.8",
-    "system-observability/SKILL.md": "5.5.8",
-    "system-observability/references/memory-incident-triage.md": "5.5.8",
-    "translate-engine/SKILL.md": "5.5.8",
-    "translate-engine/agents/openai.yaml": "5.5.8",
-    "ui-design/SKILL.md": "5.5.8",
-    "ui-design/assets/pattern-showcase/app.js": "5.5.8",
-    "ui-design/assets/pattern-showcase/index.html": "5.5.8",
-    "ui-design/assets/pattern-showcase/styles.css": "5.5.8",
-    "ui-design/assets/templates/MCI-DESIGN.md": "5.5.8",
-    "ui-design/references/design-pattern-library.md": "5.5.8",
-    "ui-design/references/mci-design-contract.md": "5.5.8",
-    "ui-design/references/motion-and-media.md": "5.5.8",
-    "ui-design/references/product-flow-recipes.md": "5.5.8",
-    "ui-design/references/progressive-01-颜色体系-css-variables-支持主题切换.md": "5.5.8",
-    "ui-design/references/progressive-02-字体.md": "5.5.8",
-    "ui-design/references/progressive-03-动效规范-丰富但不卡.md": "5.5.8",
-    "ui-design/references/progressive-04-组件风格速查.md": "5.5.8",
-    "ui-design/references/progressive-05-移动端专用规范.md": "5.5.8",
-    "ui-design/references/progressive-06-主题切换实现.md": "5.5.8",
-    "ui-design/references/progressive-07-速查-从头搭建一个移动端页面.md": "5.5.8",
-    "ui-design/references/progressive-08-表单分组规范-tabs-vs-collapsegroup-强制.md": "5.5.8",
-    "uniapp-mall-assets/SKILL.md": "5.5.8",
-    "unity-integration/SKILL.md": "5.5.8",
-    "unity-integration/agents/openai.yaml": "5.5.8",
-    "unity-integration/references/ai-app-delivery.md": "5.5.8",
-    "unity-integration/references/sdk-api.md": "5.5.8",
-    "unity-integration/references/toolbox-migration.md": "5.5.8",
-    "unity-integration/references/webgl-hosting.md": "5.5.8",
-    "v8-api-config/SKILL.md": "5.5.8",
-    "v8-cache-pattern/SKILL.md": "5.5.8",
-    "v8-crud-api/SKILL.md": "5.5.8",
-    "v8-crud-api/references/progressive-01-查询列表-分页.md": "5.5.8",
-    "v8-crud-api/references/progressive-02-where-条件语法速查.md": "5.5.8",
-    "v8-debugging/SKILL.md": "5.5.8",
-    "v8-explorer-tree/SKILL.md": "5.5.8",
-    "v8-export-import/SKILL.md": "5.5.8",
-    "v8-export-import/references/progressive-01-excellayout-高级自由布局.md": "5.5.8",
-    "v8-export-import/references/progressive-02-powerpoint-导出.md": "5.5.8",
-    "v8-export-import/references/progressive-03-安全-性能注意.md": "5.5.8",
-    "v8-file-upload/SKILL.md": "5.5.8",
-    "v8-file-upload/references/progressive-01-公有桶-vs-私有桶.md": "5.5.8",
-    "v8-file-upload/references/progressive-02-office-文件在线编辑版本号规则.md": "5.5.8",
-    "v8-formengine-http/SKILL.md": "5.5.8",
-    "v8-frontend-events/SKILL.md": "5.5.8",
-    "v8-frontend-events/references/bluetooth-print-api.md": "5.5.8",
-    "v8-frontend-events/references/bluetooth-print.md": "5.5.8",
-    "v8-frontend-events/references/progressive-01-列表事件.md": "5.5.8",
-    "v8-http-integration/SKILL.md": "5.5.8",
-    "v8-http-integration/references/progressive-01-get-请求.md": "5.5.8",
-    "v8-http-integration/references/progressive-02-错误处理模式.md": "5.5.8",
-    "v8-image-processing/SKILL.md": "5.5.8",
-    "v8-image-processing/agents/openai.yaml": "5.5.8",
-    "v8-image-processing/references/api-reference.md": "5.5.8",
-    "v8-menu-buttons/SKILL.md": "5.5.8",
-    "v8-menu-buttons/references/progressive-01-2-按钮对象-schema.md": "5.5.8",
-    "v8-menu-buttons/references/progressive-02-8-模式-f-后台任务按钮-长任务.md": "5.5.8",
-    "v8-menu-buttons/references/progressive-03-10-反模式-避免.md": "5.5.8",
-    "v8-mongodb/SKILL.md": "5.5.8",
-    "v8-mq-mqtt/SKILL.md": "5.5.8",
-    "v8-mq-mqtt/references/mqtt-production.md": "5.5.8",
-    "v8-mq-mqtt/references/progressive-01-v8-mqtt-iot-物联网.md": "5.5.8",
-    "v8-mq-mqtt/scripts/check-mqtt-skill-coverage.mjs": "5.5.8",
-    "v8-saas-multi-tenant/SKILL.md": "5.5.8",
-    "v8-security/SKILL.md": "5.5.8",
-    "v8-security/references/progressive-01-2-权限校验.md": "5.5.8",
-    "v8-security/references/progressive-02-7-日志记录.md": "5.5.8",
-    "v8-sql-query/SKILL.md": "5.5.8",
-    "v8-table-event/SKILL.md": "5.5.8",
-    "v8-table-event/references/progressive-01-informv8-js-表单打开事件.md": "5.5.8",
-    "v8-table-event/references/progressive-02-前端事件名-v8-eventname-可能的值.md": "5.5.8",
-    "v8-tcp-integration/SKILL.md": "5.5.8",
-    "v8-tcp-integration/agents/openai.yaml": "5.5.8",
-    "v8-template-engine/SKILL.md": "5.5.8",
-    "v8-utilities/SKILL.md": "5.5.8",
-    "v8-utilities/references/client-api-index.md": "5.5.8",
-    "v8-utilities/references/platform-http-routes.md": "5.5.8",
-    "v8-utilities/references/server-api-index.md": "5.5.8",
-    "v8-workflow/SKILL.md": "5.5.8",
-    "v8-workflow/references/progressive-01-节点开始-v8-事件.md": "5.5.8",
-    "vision-engine/SKILL.md": "5.5.8",
-    "vision-engine/agents/openai.yaml": "5.5.8",
-    "vision-engine/references/architecture-and-acceptance.md": "5.5.8",
-    "workspace-conventions/SKILL.md": "5.5.8",
-    "workspace-conventions/references/progressive-01-版本更新日志保护规则-强制.md": "5.5.8",
-    "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md": "5.5.8",
-    "workspace-conventions/references/progressive-03-cli-与-ide-插件错版共存约定.md": "5.5.8"
+    ".microi-skills-version.json": "5.5.9",
+    ".progressive-disclosure-manifest.json": "5.5.9",
+    "README.md": "5.5.9",
+    "ai-engine/SKILL.md": "5.5.9",
+    "ai-engine/agents/openai.yaml": "5.5.9",
+    "ai-platform-governance/SKILL.md": "5.5.9",
+    "ai-platform-governance/references/progressive-01-功能开关.md": "5.5.9",
+    "app-store/SKILL.md": "5.5.9",
+    "app-store/agents/openai.yaml": "5.5.9",
+    "business-blueprint/SKILL.md": "5.5.9",
+    "datasource-engine/SKILL.md": "5.5.9",
+    "datasource-engine/agents/openai.yaml": "5.5.9",
+    "dos-orm/SKILL.md": "5.5.9",
+    "dos-orm/references/api-reference.md": "5.5.9",
+    "email-engine/SKILL.md": "5.5.9",
+    "email-engine/references/v8-email.md": "5.5.9",
+    "job-engine/SKILL.md": "5.5.9",
+    "job-engine/agents/openai.yaml": "5.5.9",
+    "message-notification/SKILL.md": "5.5.9",
+    "message-notification/agents/openai.yaml": "5.5.9",
+    "message-notification/references/contracts.md": "5.5.9",
+    "microi-ai-app-auth.js": "5.5.9",
+    "microi-ai-application/SKILL.md": "5.5.9",
+    "microi-ai-application/agents/openai.yaml": "5.5.9",
+    "microi-ai-application/references/frontend-baseline.md": "5.5.9",
+    "microi-client-frontend/SKILL.md": "5.5.9",
+    "microi-client-frontend/references/progressive-01-3-动态按钮系统.md": "5.5.9",
+    "microi-client-frontend/references/progressive-02-8-运行时高频坑复盘.md": "5.5.9",
+    "microi-client-frontend/references/progressive-03-vue3-前端微服务宿主规则.md": "5.5.9",
+    "microi-codex-installer/SKILL.md": "5.5.9",
+    "microi-codex-installer/agents/openai.yaml": "5.5.9",
+    "microi-codex/SKILL.md": "5.5.9",
+    "microi-datasource-mapping/SKILL.md": "5.5.9",
+    "microi-db-schema/SKILL.md": "5.5.9",
+    "microi-db-schema/agents/openai.yaml": "5.5.9",
+    "microi-db-schema/references/core-tables.md": "5.5.9",
+    "microi-db-schema/references/form-component-options.md": "5.5.9",
+    "microi-db-schema/references/schema-overview.md": "5.5.9",
+    "microi-db-schema/references/schema.md": "5.5.9",
+    "microi-db-schema/references/table-catalog.md": "5.5.9",
+    "microi-deployment/SKILL.md": "5.5.9",
+    "microi-deployment/references/deployment-matrix.md": "5.5.9",
+    "microi-docs-coverage/SKILL.md": "5.5.9",
+    "microi-docs-coverage/references/capability-map.md": "5.5.9",
+    "microi-docs-coverage/scripts/audit-doc-skill-coverage.mjs": "5.5.9",
+    "microi-form-engine/SKILL.md": "5.5.9",
+    "microi-form-engine/references/component-catalog.md": "5.5.9",
+    "microi-form-engine/references/data-source-events.md": "5.5.9",
+    "microi-form-layout/SKILL.md": "5.5.9",
+    "microi-form-layout/references/progressive-01-3-三种分组的存储与配置.md": "5.5.9",
+    "microi-frontend-sdk/SKILL.md": "5.5.9",
+    "microi-frontend-sdk/references/progressive-01-token-当前登录用户与当前终端登录协议.md": "5.5.9",
+    "microi-left-right-layout/SKILL.md": "5.5.9",
+    "microi-microservice/SKILL.md": "5.5.9",
+    "microi-microservice/references/runtime-delivery.md": "5.5.9",
+    "microi-mobile-app-quality/SKILL.md": "5.5.9",
+    "microi-mobile-app-quality/references/progressive-01-4-重要按钮必须带图标.md": "5.5.9",
+    "microi-mobile-app-quality/references/progressive-02-9-主题切换必须真实且全局生效.md": "5.5.9",
+    "microi-solution-quotation/SKILL.md": "5.5.9",
+    "microi-solution-quotation/agents/openai.yaml": "5.5.9",
+    "microi-solution-quotation/scripts/build_solution_quote.py": "5.5.9",
+    "microi-sso/SKILL.md": "5.5.9",
+    "microi-sso/references/acceptance.md": "5.5.9",
+    "microi-sso/references/configuration-and-security.md": "5.5.9",
+    "microi-sso/references/inbound.md": "5.5.9",
+    "microi-sso/references/outbound.md": "5.5.9",
+    "microi-system-delivery/SKILL.md": "5.5.9",
+    "microi-system-delivery/references/progressive-01-标准工作流.md": "5.5.9",
+    "microi-system-delivery/references/progressive-02-自动化测试必须覆盖的坑.md": "5.5.9",
+    "microi-ui/SKILL.md": "5.5.9",
+    "microi-ui/references/progressive-01-移动端场景蓝图.md": "5.5.9",
+    "microi-uniapp-frontend/SKILL.md": "5.5.9",
+    "microi-uniapp-frontend/references/progressive-01-移动端分类-双栏列表独立滚动.md": "5.5.9",
+    "microi-uniapp-frontend/references/progressive-02-关键业务资产不得默认选中.md": "5.5.9",
+    "microi.v8.js": "5.5.9",
+    "module-engine/SKILL.md": "5.5.9",
+    "module-engine/references/module-config.md": "5.5.9",
+    "ocr-engine/SKILL.md": "5.5.9",
+    "ocr-engine/agents/openai.yaml": "5.5.9",
+    "page-engine/SKILL.md": "5.5.9",
+    "page-engine/references/progressive-01-所有组件类型.md": "5.5.9",
+    "page-engine/references/progressive-02-版本历史-并发保存与回滚.md": "5.5.9",
+    "performance-testing/SKILL.md": "5.5.9",
+    "playwright-e2e/SKILL.md": "5.5.9",
+    "playwright-e2e/references/progressive-01-全自动登录-免验证码-但不免密码-必读.md": "5.5.9",
+    "playwright-e2e/references/progressive-02-文字对比度与可读性自动化检查-必做.md": "5.5.9",
+    "playwright-e2e/references/progressive-03-microi-helper-模板.md": "5.5.9",
+    "playwright-e2e/references/progressive-04-ci-建议.md": "5.5.9",
+    "print-engine/SKILL.md": "5.5.9",
+    "production-readonly-audit/SKILL.md": "5.5.9",
+    "report-engine/SKILL.md": "5.5.9",
+    "report-engine/agents/openai.yaml": "5.5.9",
+    "scripts/optimize-progressive-disclosure.mjs": "5.5.9",
+    "scripts/refresh-progressive-disclosure.mjs": "5.5.9",
+    "scripts/validate-progressive-disclosure.mjs": "5.5.9",
+    "search-engine/SKILL.md": "5.5.9",
+    "search-engine/agents/openai.yaml": "5.5.9",
+    "spider-engine/SKILL.md": "5.5.9",
+    "system-observability/SKILL.md": "5.5.9",
+    "system-observability/references/memory-incident-triage.md": "5.5.9",
+    "translate-engine/SKILL.md": "5.5.9",
+    "translate-engine/agents/openai.yaml": "5.5.9",
+    "ui-design/SKILL.md": "5.5.9",
+    "ui-design/assets/pattern-showcase/app.js": "5.5.9",
+    "ui-design/assets/pattern-showcase/index.html": "5.5.9",
+    "ui-design/assets/pattern-showcase/styles.css": "5.5.9",
+    "ui-design/assets/templates/MCI-DESIGN.md": "5.5.9",
+    "ui-design/references/design-pattern-library.md": "5.5.9",
+    "ui-design/references/mci-design-contract.md": "5.5.9",
+    "ui-design/references/motion-and-media.md": "5.5.9",
+    "ui-design/references/product-flow-recipes.md": "5.5.9",
+    "ui-design/references/progressive-01-颜色体系-css-variables-支持主题切换.md": "5.5.9",
+    "ui-design/references/progressive-02-字体.md": "5.5.9",
+    "ui-design/references/progressive-03-动效规范-丰富但不卡.md": "5.5.9",
+    "ui-design/references/progressive-04-组件风格速查.md": "5.5.9",
+    "ui-design/references/progressive-05-移动端专用规范.md": "5.5.9",
+    "ui-design/references/progressive-06-主题切换实现.md": "5.5.9",
+    "ui-design/references/progressive-07-速查-从头搭建一个移动端页面.md": "5.5.9",
+    "ui-design/references/progressive-08-表单分组规范-tabs-vs-collapsegroup-强制.md": "5.5.9",
+    "uniapp-mall-assets/SKILL.md": "5.5.9",
+    "unity-integration/SKILL.md": "5.5.9",
+    "unity-integration/agents/openai.yaml": "5.5.9",
+    "unity-integration/references/ai-app-delivery.md": "5.5.9",
+    "unity-integration/references/sdk-api.md": "5.5.9",
+    "unity-integration/references/toolbox-migration.md": "5.5.9",
+    "unity-integration/references/webgl-hosting.md": "5.5.9",
+    "v8-api-config/SKILL.md": "5.5.9",
+    "v8-cache-pattern/SKILL.md": "5.5.9",
+    "v8-crud-api/SKILL.md": "5.5.9",
+    "v8-crud-api/references/progressive-01-查询列表-分页.md": "5.5.9",
+    "v8-crud-api/references/progressive-02-where-条件语法速查.md": "5.5.9",
+    "v8-debugging/SKILL.md": "5.5.9",
+    "v8-explorer-tree/SKILL.md": "5.5.9",
+    "v8-export-import/SKILL.md": "5.5.9",
+    "v8-export-import/references/progressive-01-excellayout-高级自由布局.md": "5.5.9",
+    "v8-export-import/references/progressive-02-powerpoint-导出.md": "5.5.9",
+    "v8-export-import/references/progressive-03-安全-性能注意.md": "5.5.9",
+    "v8-file-upload/SKILL.md": "5.5.9",
+    "v8-file-upload/references/progressive-01-公有桶-vs-私有桶.md": "5.5.9",
+    "v8-file-upload/references/progressive-02-office-文件在线编辑版本号规则.md": "5.5.9",
+    "v8-formengine-http/SKILL.md": "5.5.9",
+    "v8-frontend-events/SKILL.md": "5.5.9",
+    "v8-frontend-events/references/bluetooth-print-api.md": "5.5.9",
+    "v8-frontend-events/references/bluetooth-print.md": "5.5.9",
+    "v8-frontend-events/references/progressive-01-列表事件.md": "5.5.9",
+    "v8-http-integration/SKILL.md": "5.5.9",
+    "v8-http-integration/references/progressive-01-get-请求.md": "5.5.9",
+    "v8-http-integration/references/progressive-02-错误处理模式.md": "5.5.9",
+    "v8-image-processing/SKILL.md": "5.5.9",
+    "v8-image-processing/agents/openai.yaml": "5.5.9",
+    "v8-image-processing/references/api-reference.md": "5.5.9",
+    "v8-menu-buttons/SKILL.md": "5.5.9",
+    "v8-menu-buttons/references/progressive-01-2-按钮对象-schema.md": "5.5.9",
+    "v8-menu-buttons/references/progressive-02-8-模式-f-后台任务按钮-长任务.md": "5.5.9",
+    "v8-menu-buttons/references/progressive-03-10-反模式-避免.md": "5.5.9",
+    "v8-mongodb/SKILL.md": "5.5.9",
+    "v8-mq-mqtt/SKILL.md": "5.5.9",
+    "v8-mq-mqtt/references/mqtt-production.md": "5.5.9",
+    "v8-mq-mqtt/references/progressive-01-v8-mqtt-iot-物联网.md": "5.5.9",
+    "v8-mq-mqtt/scripts/check-mqtt-skill-coverage.mjs": "5.5.9",
+    "v8-saas-multi-tenant/SKILL.md": "5.5.9",
+    "v8-security/SKILL.md": "5.5.9",
+    "v8-security/references/progressive-01-2-权限校验.md": "5.5.9",
+    "v8-security/references/progressive-02-7-日志记录.md": "5.5.9",
+    "v8-sql-query/SKILL.md": "5.5.9",
+    "v8-table-event/SKILL.md": "5.5.9",
+    "v8-table-event/references/progressive-01-informv8-js-表单打开事件.md": "5.5.9",
+    "v8-table-event/references/progressive-02-前端事件名-v8-eventname-可能的值.md": "5.5.9",
+    "v8-tcp-integration/SKILL.md": "5.5.9",
+    "v8-tcp-integration/agents/openai.yaml": "5.5.9",
+    "v8-template-engine/SKILL.md": "5.5.9",
+    "v8-utilities/SKILL.md": "5.5.9",
+    "v8-utilities/references/client-api-index.md": "5.5.9",
+    "v8-utilities/references/platform-http-routes.md": "5.5.9",
+    "v8-utilities/references/server-api-index.md": "5.5.9",
+    "v8-workflow/SKILL.md": "5.5.9",
+    "v8-workflow/references/progressive-01-节点开始-v8-事件.md": "5.5.9",
+    "vision-engine/SKILL.md": "5.5.9",
+    "vision-engine/agents/openai.yaml": "5.5.9",
+    "vision-engine/references/architecture-and-acceptance.md": "5.5.9",
+    "workspace-conventions/SKILL.md": "5.5.9",
+    "workspace-conventions/references/progressive-01-版本更新日志保护规则-强制.md": "5.5.9",
+    "workspace-conventions/references/progressive-02-microi-net-api-本地启动约定.md": "5.5.9",
+    "workspace-conventions/references/progressive-03-cli-与-ide-插件错版共存约定.md": "5.5.9"
   },
   "files": [
     ".microi-skills-version.json",

package/skills/.microi-skills-version.json

@@ -1,6 +1,6 @@
 {
-  "version": "5.5.8",
+  "version": "5.5.9",
   "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-09-07T19:16:12.977Z"
+  "updatedAt": "2026-09-08T15:02:50.285Z"
 }

package/skills/ai-engine/SKILL.md

@@ -80,7 +80,9 @@ AI 业务统一实现在 `Microi.Server/Microi.AI`。`Microi.Server/Microi.net.A
 - MiniMax Code 媒体连接使用管理员独立 OAuth 授权，不读取或复用桌面客户端凭据。令牌在可信后端按租户及引擎记录绑定加密保存，刷新使用共享锁与旧值比较；明确 401 可刷新后重试一次，不确定生成请求不得重发。生成结果节点须先保存到共享存储；下载或 HDFS 失败且存在节点时，通过同一 TaskId 的 `RecoverMiniMaxImageTask` 或 `/v1/microi/image_tasks/{taskId}/recover` 恢复已有图片，不再次生成。目录只公开能力元数据。`MediaModels` 可扩展同协议模型；新的供应商协议仍需适配器、商城字段及真实中转验收，不能只填名称就宣称已接通。
 - 吾码节点之间的图片中转使用 `POST /v1/microi/image_tasks` 与 `GET /v1/microi/image_tasks/{taskId}`，服务端平台 API Key 鉴权，提交必须有稳定 `Idempotency-Key`。查询不占用生成额度；接收节点只能使用已启用且公布的供应商媒体模型，禁止自调用中转环路。MiniMax 官方适配器调用同步 `/v1/image_generation`，其它供应商由对应协议适配器处理。消费者、官方中转节点和前端必须更新到同一持久任务协议；应用包更新不能代替平台二进制与前端更新。
 - HTTP 524、连接取消或空响应仅说明传输状态不确定，不能断言提示词违规、Token Plan 不可用或已扣费。明确供应商拒绝保留 `UpstreamHttpStatus`、`UpstreamCode` 和错误消息；`Failed/Uncertain` 不能在回读时合并成“仍在生成”。MiniMax 同步接口没有本任务可用的结果查询号时，不得伪造回查成功或盲目重发；相同 RequestId 参数冲突必须拒绝。
-- 图片与音乐都使用稳定 `RequestId` 和共享幂等；相同参数回放、参数冲突拒绝，上游结果不确定时禁止换 Id 盲重试。音乐当前仅向平台管理员开放且固定无人声；托管结果为 MP3，开源回退为 32kHz 立体声 WAV、10～60 秒。成功内容由服务端校验后直接写入当前租户公有 HDFS。
+- 图片与音乐都使用稳定 `RequestId` 和共享幂等；相同参数回放、参数冲突拒绝，上游结果不确定时禁止换 Id 盲重试。音乐当前仅向平台管理员开放且固定无人声；托管结果为 MP3，开源回退为 WAV、10～60 秒；采样率、声道、码率和时长以实际文件头为准。成功内容由服务端校验后直接写入当前租户公有 HDFS。
+- `GenerateMiniMaxMusic`（HTTP 与 V8）持久入队后返回 `Code=2 + TaskId`；使用 `GET /api/Ai/GetMiniMaxMusicTask?taskId=...` 或 `V8.AI.GetMiniMaxMusicTask(taskId)` 查询，只有 `Code=1 + Permanent=true + FileUrl` 是成功。任务复用共享数据库唯一键、租约和原生音乐 Worker；HTTP 断连不取消生成，前端按当前 API、租户、用户保存原任务并恢复查询。图片与音乐的中转等待任务合并计算容量，必须为供应商执行任务保留槽位。
+- 音乐中转使用 `POST /v1/microi/music_tasks`、`GET /v1/microi/music_tasks/{taskId}` 和平台 API Key，提交携带稳定 `Idempotency-Key`；客户端节点和中转节点均需更新。官方 Music3 事件编号必须在读取 SSE 前写入共享 Redis，完成文件地址在下载前保存，整个事件流受总时限约束。存在有效原回执时才允许 `POST /api/Ai/RecoverMiniMaxMusicTask?taskId=...`（V8 同名方法）或中转 `/v1/microi/music_tasks/{taskId}/recover` 恢复；不得接受新提示词或再提交供应商生成。没有原回执的旧 `Uncertain` 不能自动修复为成功。应用包更新不替代前后端和中转二进制升级。
 - 聊天附件的公有媒体 URL 优先按当前运行租户 `FileServer + FilePath` 解析，禁止写死域名或沿用其它租户的前缀。图片使用 Element Plus `el-image` 的 `preview-src-list` 原页放大，不能套 `target="_blank"`；音乐使用 `<audio controls preload="metadata">` 在线播放。媒体是结构化附件，文本才走安全 Markdown 渲染，禁止拼接任意 HTML 绕过 URL/类型校验。
 - MiniMax 自 2026-08-20 起不再向新用户开放付费 Music/Lyrics API，并停止旧免费 Music 模型。既有 `music-3.0` 账号仍可优先直连；官方开源 `MiniMax-Music3` Space 可作为明确 410 后的回退，但公开 ZeroGPU 配额不是生产 SLA。需要专属额度时只在既有服务端 `mic_ai` 模型路由中保存官方 Space Endpoint 与受保护 Hugging Face Token，不新增 API `AppSettings`、环境变量或前端密钥。Provider/中转账号未开通、额度不足或上游停用时必须返回可诊断失败，不生成占位音频、不伪报成功。图片、音乐和视频的真实可用性都需用目标租户登录态调用及媒体 GET/播放回读证明，源码存在或接口 HTTP 200 不能替代生成成功。
 - MiniMax 视频生成属于可复用供应商原子能力，应实现在 `Microi.AI`，Controller 只读取可信用户/`OsClient`、绑定参数并传递取消信号。理由是上游密钥隔离、异步 `task_id → file_id → download_url` 协议、订阅额度和跨节点幂等都不是某个可编辑接口引擎应复制的业务逻辑；具体文章、提示词和分发编排仍可留在 Job/接口引擎/发布 Skill。

package/skills/job-engine/SKILL.md

@@ -24,6 +24,17 @@ Quartz 管理能力包含查询、添加、更新、暂停、恢复、删除任
 
 ## 多节点设计
 
+### 新旧平台共库过渡：停用新版调度
+
+- 系统设置“开发配置”的 `DisableTaskScheduling`（停用任务调度）默认 `0`，缺字段、空值也按正常调度处理；只有已实现此能力的新版后端识别它。字段由“系统设置”应用和 SaaS 空库基础包交付，不写租户配置值，不逐条 Pause/修改任务状态。
+- 开启时在 Quartz 领取触发器、处理 Misfire 之前按租户过滤；领取后、真正触发前重新读取系统设置缓存。禁止仅在 `IJob.Execute`、Listener veto 或业务 V8 入口 return：共享 Quartz 可能已经推进 NextFireTime，造成旧版漏执行。
+- 集群故障恢复也不得清理停用租户的在途记录或创建其补偿触发器。Quartz 以故障节点为单位清理记录，所以同一故障节点混有被停用租户时，新版推迟该故障节点整组恢复，交给旧节点或关闭开关后处理；其它健康节点仍正常领取。
+- 正常保存系统设置在事务提交后失效缓存，下一次调度检查生效，不用重启；不是强制中断，已经开始的任务允许完成。缓存/配置读取失败拒绝该租户的新领取，不影响其它健康租户；Redis/失效通知异常时不能承诺硬实时。
+- 停用期间只读观察周期计划，不推进共享触发器；每个“租户 + Job + Trigger + 计划时间”写一条 `diy_schedule_job_log`，包含 `Status=Skipped`、`Executed=false`、`Reason=SystemTaskSchedulingDisabled` 和中文说明。Redis 原子预留与数据库确定性主键共同防止多新版节点重复记录；日志说明仅代表新版未执行，旧版仍可能正常执行。不补跑业务、不补写进程停机历史；新增/修改计划的日志目录最多约 10 秒更新。
+- 普通接口调用、MQ 消费、升级/应用安装等持久后台任务不属于此开关的范围。手动触发 Quartz 任务仍经过门禁。
+- 交付顺序：先安装字段并打开开关，再让新版节点参与调度；确认旧版所有调度进程已停止且在途任务完成后，关闭开关交接。不同业务库分别设置，不能用一个租户的值控制全部租户。
+- 验收至少覆盖：默认兼容、开关实时读取、租户隔离、共享库旧节点继续领取、领取后开关变化不推进触发器、Misfire 不误推进、多节点日志去重；不得在真实生产任务上制造副作用做测试。
+
 每个任务必须同时具备：
 
 1. 分布式租约：Key 至少含 `OsClient + JobKey + 计划时间/业务分片`，有唯一持有者、TTL、续租和仅持有者释放。

package/skills/microi-ai-application/SKILL.md

@@ -64,6 +64,14 @@ UniApp 使用 Vue 3 + TypeScript 的官方 Vite 工具链，并同时遵守 `mic
 
 ## 存量迁移
 
+### Cocos/WebGL 清晰度和资源生命周期
+
+- 独立棋子/角色要求独立几何与身份，并不要求每个 glTF 重复上传整张纹理图集。同时核验磁盘资源和引擎实际 Texture2D/GFX bytes；主题切换时按自有 addRef/decRef 生命周期释放非活动模型和材质，迟到加载不得复活已销毁页面。
+- Cocos 3.8.8 普通 Material 资产的宏与 pipeline states 在 initialize/copy 时设置；不能调用仅对实例有效的 recompileShaders/overridePipelineStates 后就假定生效。实际浏览器要复核绑定的贴图、法线、透明混合和叠加照明，类型检查不替代像素检查。
+- 分开记录原生图片尺寸、局部材质密度、渲染缓冲分辨率、截图及真机画质。不得把放大、局部贴图或多图组合标为原生整幅 4K 母版；保留旧收藏与原始溯源。
+- 七类动作等视觉测试应采集连续变化的真实网格状态；暂停引擎定格截图仅用于画面复核。FPS 必须在不暂停、不截屏的连续渲染区间单独计量，记录分辨率、GPU/软件渲染器与后台负载。
+- 选中、起势、接触和吃子音效按时间轴独立触发。不得选棋就播放炮击或把每种兵种做成同一个音效的简单变调；新声音保留旧母版，削波/循环接缝通过不等于最终听感通过。
+
 采用绞杀式迁移，避免一次重写破坏已经验证的规则：
 
 1. 先把纯规则、API、音频和实时客户端固定为可测试模块。

package/skills/microi-microservice/SKILL.md

@@ -77,14 +77,16 @@ AppKey 稳定且只含安全字符。`microi.routes.json` 是页面事实源，
 ### 线上目标在本地 Microi.Client 复现（强制）
 
 - 先在一次性隔离 browser context 打开线上友好路由并读取
-  `window.__MICROI_RUNTIME_ENDPOINT__`；旧版回退读取页面全局、同源缓存和域名解析，禁止猜
-  ApiBase/OsClient。
+  `window.__MICROI_RUNTIME_ENDPOINT__`；旧版回退读取页面全局、同源缓存和域名解析，禁止猜
+  ApiBase/OsClient。
 - 在新的独立 context 打开
   `http://localhost:61500/?OsClient=<encoded>&ApiBase=<encoded>#/micro-app/{MsKey}/{RoutePath}`。
   两个 URL 参数是当前页面最高优先级；初始化后回读同一个运行时对象确认命中目标。
 - 同源普通窗口共享 Token、CurrentUser、ApiBase、OsClient。并行不同目标必须一组目标一个
   Playwright `browser.newContext()` 或独立浏览器 Profile；多个无痕窗口不保证彼此隔离。
-- 本地复现、主框架宿主验收、远端运行产物和生产部署分别报告；本地通过不能替代发布后回读。
+- 本地复现、主框架宿主验收、远端运行产物和生产部署分别报告；本地通过不能替代发布后回读。
+- 新租户或历史还原库可能没有 `SysConfig.ApiBase`。微服务安装不得依赖该字段才能写入运行 HTML：按目标 `OsClient` 注入上下文，运行时使用同租户宿主的 `microApp.getData()` 或绑定该租户的 API 稳定入口，保留代理路径；不得沿用发布端上下文、跨租户宿主或把 HDFS/CDN 域名当成 API。独立 Web/UniApp 仍需有效的目标 API 配置。
+- 登录用户的角色等历史字段可能返回数组、JSON 字符串或空值。列表运算前必须归一化类型，并优先使用当前接口给出的结构化字段；验收应使用真实旧格式数据验证页面渲染及导航，不能只断言接口成功或没有 `pageerror`，还应检查 Vue 捕获到的控制台异常。
 
 迁移 Vue2 定制页到独立 Vite 微服务时，不得假设宿主会提供 Tailwind/UnoCSS 等原子类；
 页面依赖的宽高、颜色、间距、响应式和打印/下载样式必须由组件自身的语义 class 明确声明，