@microi.net/cli 5.9.5 → 5.9.6

package/skills/unity-integration/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Microi Unity 集成"
-  short_description: "交付 Unity UPM、WebGL、V8 与可安装 AI 应用"
-  default_prompt: "使用 $unity-integration 设计、实现并分层验收完整的 Microi Unity WebGL 应用。"
+interface:
+  display_name: "Microi Unity 集成"
+  short_description: "交付 Unity UPM、WebGL、V8 与可安装 AI 应用"
+  default_prompt: "使用 $unity-integration 设计、实现并分层验收完整的 Microi Unity WebGL 应用。"

package/skills/v8-image-processing/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "V8 图像处理"
-  short_description: "编写安全、可验证的 V8.Image 图像处理与合并代码"
-  default_prompt: "使用 $v8-image-processing 编写一个将水印按指定位置叠加到主图并返回图片的 V8 接口引擎。"
+interface:
+  display_name: "V8 图像处理"
+  short_description: "编写安全、可验证的 V8.Image 图像处理与合并代码"
+  default_prompt: "使用 $v8-image-processing 编写一个将水印按指定位置叠加到主图并返回图片的 V8 接口引擎。"

package/skills/v8-mq-mqtt/scripts/check-mqtt-skill-coverage.mjs

@@ -1,203 +1,203 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const scriptDir = path.dirname(fileURLToPath(import.meta.url));
-const workspaceRoot = path.resolve(scriptDir, '..', '..', '..');
-
-const files = {
-  skill: 'microi.skills/v8-mq-mqtt/SKILL.md',
-  reference: 'microi.skills/v8-mq-mqtt/references/mqtt-production.md',
-  mqttDoc: 'microi.doc/docs/doc/system-engine/mqtt-engine.md',
-  v8Doc: 'microi.doc/docs/doc/v8-engine/v8-server.md',
-  runtime: 'Microi.Server/Microi.MQTT/MicroiMQTT.cs',
-  model: 'Microi.Server/Microi.Core/Model/MqttParam.cs',
-  mqttInterface: 'Microi.Server/Microi.Core/Interface/IMicroiMQTT.cs',
-  tenantSecurity: 'Microi.Server/Microi.Core/SaaSEngine/TenantConfigurationSecurity.cs',
-  platformRuntime: 'Microi.Server/Microi.Core/V8Engine/Runtime/V8Method.PlatformPluginRuntimes.cs',
-  platformApiEngine: 'Microi.Server/OfficialApplications/Resource/platform-mqtt.js'
-};
-
-const content = {};
-const failures = [];
-
-for (const [name, relativePath] of Object.entries(files)) {
-  const absolutePath = path.join(workspaceRoot, relativePath);
-  if (!fs.existsSync(absolutePath)) {
-    failures.push(`${name}: 文件不存在 ${relativePath}`);
-    content[name] = '';
-    continue;
-  }
-  content[name] = fs.readFileSync(absolutePath, 'utf8');
-}
-
-function collectMatches(text, regex) {
-  const values = [];
-  for (const match of text.matchAll(regex)) values.push(match[1]);
-  return values;
-}
-
-function requireTokens(targetName, tokens) {
-  const text = content[targetName] || '';
-  for (const token of tokens) {
-    if (!text.includes(token)) failures.push(`${targetName}: 缺少 ${token}`);
-  }
-}
-
-function requireAny(targetName, alternatives, label) {
-  const text = content[targetName] || '';
-  if (!alternatives.some((token) => text.includes(token))) {
-    failures.push(`${targetName}: 缺少 ${label}`);
-  }
-}
-
-const runtimeEvents = new Set([
-  ...collectMatches(
-    content.runtime,
-    /RunMqttV8EngineAsync\([^,\r\n]+,\s*"([A-Za-z]+)"/g
-  ),
-  ...collectMatches(
-    content.runtime,
-    /FireV8EventForAllTenantsAsync\(\s*"([A-Za-z]+)"/g
-  )
-]);
-
-const expectedEvents = [
-  'StartServer',
-  'Connected',
-  'Disconnected',
-  'Subscribing',
-  'MessageReceived',
-  'MessageChanged',
-  'StopServer'
-];
-
-for (const eventName of expectedEvents) {
-  if (!runtimeEvents.has(eventName)) failures.push(`runtime: 未提取到事件 ${eventName}`);
-}
-
-const mqttProperties = new Set(collectMatches(
-  content.model,
-  /public\s+[A-Za-z0-9_<>,.\s]+\s+([A-Za-z0-9_]+)\s*\{\s*get;\s*set;\s*\}/g
-));
-
-const expectedProperties = [
-  'ClientId',
-  'Payload',
-  'PayloadRaw',
-  'Topic',
-  'OsClient',
-  'UserName',
-  'Qos',
-  'Retain',
-  'UserProperties'
-];
-
-for (const propertyName of expectedProperties) {
-  if (!mqttProperties.has(propertyName)) failures.push(`model: 未提取到属性 ${propertyName}`);
-}
-
-const sourceEvents = [...runtimeEvents].sort();
-const sourceProperties = [...mqttProperties].sort();
-for (const targetName of ['reference', 'mqttDoc', 'v8Doc']) {
-  requireTokens(targetName, sourceEvents);
-  requireTokens(targetName, sourceProperties);
-}
-
-const configurationTokens = [
-  'MqttEnable',
-  'MqttPort',
-  'MqttUseTls',
-  'MqttTlsPort',
-  'MqttCertPath',
-  'MqttCertPassword',
-  'MqttFallbackPort',
-  'MqttWsPort',
-  'MqttAccount',
-  'MqttPwd',
-  'MqttApiEngine',
-  'MqttAllowAnonymous',
-  'MqttTopicIsolation'
-];
-
-const securityTokens = [
-  'tenant/{lowerOsClient}',
-  '$SYS',
-  '$share',
-  'ResponseTopic',
-  'Code != 1',
-  'StaleDisconnectIgnored'
-];
-
-const operationsTokens = [
-  'mci_mqtt_client',
-  'mci_mqtt_log',
-  'ApiEngineId',
-  'IMicroiMQTT.PublishAsync',
-  'ConnectedClients',
-  'GetConnectedClients',
-  '外部 Broker',
-  '独立 MQTT 节点'
-];
-
-requireTokens('platformRuntime', [
-  'ManageMqtt',
-  'RequireCurrentTenantSuperAdmin',
-  'IMicroiMQTT',
-  'GetConnectedClients',
-  'PublishAsync'
-]);
-requireTokens('platformApiEngine', ['V8.Method.ManageMqtt']);
-
-requireTokens('skill', ['references/mqtt-production.md', 'platform-mqtt']);
-requireTokens('reference', configurationTokens);
-
-requireTokens('reference', securityTokens);
-requireTokens('reference', operationsTokens);
-
-requireTokens(
-  'mqttDoc',
-  configurationTokens.filter((token) => token !== 'MqttAllowAnonymous')
-);
-requireAny(
-  'mqttDoc',
-  ['MqttAllowAnonymous', '匿名连接只可能由主租户显式开启'],
-  '主租户匿名连接边界'
-);
-requireTokens(
-  'mqttDoc',
-  securityTokens.filter(
-    (token) => token !== 'StaleDisconnectIgnored' && token !== 'tenant/{lowerOsClient}'
-  )
-);
-requireAny(
-  'mqttDoc',
-  ['tenant/{lowerOsClient}', 'tenant/<lowerOsClient>'],
-  '标准租户 Topic 模板'
-);
-requireTokens('v8Doc', ['## V8.MQTT', 'IMicroiMQTT.PublishAsync', 'Code != 1']);
-
-requireTokens('runtime', [
-  'NormalizeTopic',
-  'ResponseTopic',
-  'StaleDisconnectIgnored',
-  '$share/',
-  '$SYS/',
-  'mci_mqtt_client',
-  'mci_mqtt_log',
-  'PublishRejectedByV8'
-]);
-requireTokens('mqttInterface', ['PublishAsync(string osClient', 'GetConnectedClients(string osClient)']);
-requireTokens('tenantSecurity', ['NormalizeMqttTopic', 'HasTenantServiceCredentialCollision']);
-
-if (failures.length > 0) {
-  console.error('MQTT Skill 覆盖检查失败：');
-  for (const failure of failures) console.error(`- ${failure}`);
-  process.exitCode = 1;
-} else {
-  console.log(
-    `MQTT Skill 覆盖检查通过：${sourceEvents.length} 个事件、` +
-    `${sourceProperties.length} 个 V8.MQTT 字段、` +
-    `${configurationTokens.length} 个配置项及生产安全/部署契约均已覆盖。`
-  );
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const workspaceRoot = path.resolve(scriptDir, '..', '..', '..');
+
+const files = {
+  skill: 'microi.skills/v8-mq-mqtt/SKILL.md',
+  reference: 'microi.skills/v8-mq-mqtt/references/mqtt-production.md',
+  mqttDoc: 'microi.doc/docs/doc/system-engine/mqtt-engine.md',
+  v8Doc: 'microi.doc/docs/doc/v8-engine/v8-server.md',
+  runtime: 'Microi.Server/Microi.MQTT/MicroiMQTT.cs',
+  model: 'Microi.Server/Microi.Core/Model/MqttParam.cs',
+  mqttInterface: 'Microi.Server/Microi.Core/Interface/IMicroiMQTT.cs',
+  tenantSecurity: 'Microi.Server/Microi.Core/SaaSEngine/TenantConfigurationSecurity.cs',
+  platformRuntime: 'Microi.Server/Microi.Core/V8Engine/Runtime/V8Method.PlatformPluginRuntimes.cs',
+  platformApiEngine: 'Microi.Server/OfficialApplications/Resource/platform-mqtt.js'
+};
+
+const content = {};
+const failures = [];
+
+for (const [name, relativePath] of Object.entries(files)) {
+  const absolutePath = path.join(workspaceRoot, relativePath);
+  if (!fs.existsSync(absolutePath)) {
+    failures.push(`${name}: 文件不存在 ${relativePath}`);
+    content[name] = '';
+    continue;
+  }
+  content[name] = fs.readFileSync(absolutePath, 'utf8');
+}
+
+function collectMatches(text, regex) {
+  const values = [];
+  for (const match of text.matchAll(regex)) values.push(match[1]);
+  return values;
+}
+
+function requireTokens(targetName, tokens) {
+  const text = content[targetName] || '';
+  for (const token of tokens) {
+    if (!text.includes(token)) failures.push(`${targetName}: 缺少 ${token}`);
+  }
+}
+
+function requireAny(targetName, alternatives, label) {
+  const text = content[targetName] || '';
+  if (!alternatives.some((token) => text.includes(token))) {
+    failures.push(`${targetName}: 缺少 ${label}`);
+  }
+}
+
+const runtimeEvents = new Set([
+  ...collectMatches(
+    content.runtime,
+    /RunMqttV8EngineAsync\([^,\r\n]+,\s*"([A-Za-z]+)"/g
+  ),
+  ...collectMatches(
+    content.runtime,
+    /FireV8EventForAllTenantsAsync\(\s*"([A-Za-z]+)"/g
+  )
+]);
+
+const expectedEvents = [
+  'StartServer',
+  'Connected',
+  'Disconnected',
+  'Subscribing',
+  'MessageReceived',
+  'MessageChanged',
+  'StopServer'
+];
+
+for (const eventName of expectedEvents) {
+  if (!runtimeEvents.has(eventName)) failures.push(`runtime: 未提取到事件 ${eventName}`);
+}
+
+const mqttProperties = new Set(collectMatches(
+  content.model,
+  /public\s+[A-Za-z0-9_<>,.\s]+\s+([A-Za-z0-9_]+)\s*\{\s*get;\s*set;\s*\}/g
+));
+
+const expectedProperties = [
+  'ClientId',
+  'Payload',
+  'PayloadRaw',
+  'Topic',
+  'OsClient',
+  'UserName',
+  'Qos',
+  'Retain',
+  'UserProperties'
+];
+
+for (const propertyName of expectedProperties) {
+  if (!mqttProperties.has(propertyName)) failures.push(`model: 未提取到属性 ${propertyName}`);
+}
+
+const sourceEvents = [...runtimeEvents].sort();
+const sourceProperties = [...mqttProperties].sort();
+for (const targetName of ['reference', 'mqttDoc', 'v8Doc']) {
+  requireTokens(targetName, sourceEvents);
+  requireTokens(targetName, sourceProperties);
+}
+
+const configurationTokens = [
+  'MqttEnable',
+  'MqttPort',
+  'MqttUseTls',
+  'MqttTlsPort',
+  'MqttCertPath',
+  'MqttCertPassword',
+  'MqttFallbackPort',
+  'MqttWsPort',
+  'MqttAccount',
+  'MqttPwd',
+  'MqttApiEngine',
+  'MqttAllowAnonymous',
+  'MqttTopicIsolation'
+];
+
+const securityTokens = [
+  'tenant/{lowerOsClient}',
+  '$SYS',
+  '$share',
+  'ResponseTopic',
+  'Code != 1',
+  'StaleDisconnectIgnored'
+];
+
+const operationsTokens = [
+  'mci_mqtt_client',
+  'mci_mqtt_log',
+  'ApiEngineId',
+  'IMicroiMQTT.PublishAsync',
+  'ConnectedClients',
+  'GetConnectedClients',
+  '外部 Broker',
+  '独立 MQTT 节点'
+];
+
+requireTokens('platformRuntime', [
+  'ManageMqtt',
+  'RequireCurrentTenantSuperAdmin',
+  'IMicroiMQTT',
+  'GetConnectedClients',
+  'PublishAsync'
+]);
+requireTokens('platformApiEngine', ['V8.Method.ManageMqtt']);
+
+requireTokens('skill', ['references/mqtt-production.md', 'platform-mqtt']);
+requireTokens('reference', configurationTokens);
+
+requireTokens('reference', securityTokens);
+requireTokens('reference', operationsTokens);
+
+requireTokens(
+  'mqttDoc',
+  configurationTokens.filter((token) => token !== 'MqttAllowAnonymous')
+);
+requireAny(
+  'mqttDoc',
+  ['MqttAllowAnonymous', '匿名连接只可能由主租户显式开启'],
+  '主租户匿名连接边界'
+);
+requireTokens(
+  'mqttDoc',
+  securityTokens.filter(
+    (token) => token !== 'StaleDisconnectIgnored' && token !== 'tenant/{lowerOsClient}'
+  )
+);
+requireAny(
+  'mqttDoc',
+  ['tenant/{lowerOsClient}', 'tenant/<lowerOsClient>'],
+  '标准租户 Topic 模板'
+);
+requireTokens('v8Doc', ['## V8.MQTT', 'IMicroiMQTT.PublishAsync', 'Code != 1']);
+
+requireTokens('runtime', [
+  'NormalizeTopic',
+  'ResponseTopic',
+  'StaleDisconnectIgnored',
+  '$share/',
+  '$SYS/',
+  'mci_mqtt_client',
+  'mci_mqtt_log',
+  'PublishRejectedByV8'
+]);
+requireTokens('mqttInterface', ['PublishAsync(string osClient', 'GetConnectedClients(string osClient)']);
+requireTokens('tenantSecurity', ['NormalizeMqttTopic', 'HasTenantServiceCredentialCollision']);
+
+if (failures.length > 0) {
+  console.error('MQTT Skill 覆盖检查失败：');
+  for (const failure of failures) console.error(`- ${failure}`);
+  process.exitCode = 1;
+} else {
+  console.log(
+    `MQTT Skill 覆盖检查通过：${sourceEvents.length} 个事件、` +
+    `${sourceProperties.length} 个 V8.MQTT 字段、` +
+    `${configurationTokens.length} 个配置项及生产安全/部署契约均已覆盖。`
+  );
+}

package/skills/v8-tcp-integration/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "V8 TCP 原始字节"
-  short_description: "通过后端 V8 安全发送和接收 TCP 原始字节数据"
-  default_prompt: "使用 $v8-tcp-integration 编写一个安全、可验证的 Microi 后端 V8 TCP 设备集成。"
+interface:
+  display_name: "V8 TCP 原始字节"
+  short_description: "通过后端 V8 安全发送和接收 TCP 原始字节数据"
+  default_prompt: "使用 $v8-tcp-integration 编写一个安全、可验证的 Microi 后端 V8 TCP 设备集成。"

package/skills/vision-engine/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "视觉引擎"
-  short_description: "构建与验收数据库优先、AI回退的通用视觉识别"
-  default_prompt: "Use $vision-engine to build and validate tenant-isolated Microi.Vision workflows."
+interface:
+  display_name: "视觉引擎"
+  short_description: "构建与验收数据库优先、AI回退的通用视觉识别"
+  default_prompt: "Use $vision-engine to build and validate tenant-isolated Microi.Vision workflows."

package/skills/workspace-conventions/SKILL.md

@@ -6,7 +6,7 @@ description: 每次 Microi 任务开始前必读的基础规范。用于识别
 # Microi 工作区全局约定
 
 <!-- microi-progressive:begin -->
-<!-- microi-progressive:chunk id=workspace-conventions-000 sha256=09810cd14d0b03a9b52469a851f851bb18f41aa8aad4ccdb4a59a97b006aa128 -->
+<!-- microi-progressive:chunk id=workspace-conventions-000 sha256=164c8870cc7e7ffa37c8889372c8962760aa04bb386fcf9368be7c4d231fdca6 -->
 ## 任务启动前 Skill 读取规则（强制）
 
 AI 处理任何 Microi 低代码、V8、MCP、OpenClaw、采集引擎、前端、后端、UniApp、文档、测试或交付任务前，必须先按任务类型读取相关 `microi.skills/**/SKILL.md`。不能等到写代码或出问题后才补读。
@@ -22,7 +22,7 @@ AI 处理任何 Microi 低代码、V8、MCP、OpenClaw、采集引擎、前端
 - 任何吾码开发任务必须读取总控中的[完整系统开发默认交付清单（原推荐提示词 1–8）](../microi-system-delivery/references/progressive-01-标准工作流.md#完整系统开发默认交付清单原推荐提示词-18)，并按总控的相关 Skill 表继续读取表单、模块、数据源、V8、页面、报表及验收等实际涉及的专项规范。不得仅凭 Skill 名称、摘要或聊天记忆执行，也不把全部 Skills 全文拼进一个提示词。
 - 按用户意图确定执行范围：完整系统开发逐项执行八项清单；局部修改只执行相关条目，保留已有业务资源和无关配置；只读分析只读取规范和事实，不创建资源、验收数据或执行发布。需求明确表示新建完整系统时，不因省略“完整”二字就降为方案或样例。
 - 默认读取规则不额外授权生产数据写入、客户部署或全库重建。连接可由当前项目和唯一已登录 Profile 自动确定；多个目标无法唯一匹配时只澄清必要的连接信息，不要求用户选择或记住 Skill。明显属于其它平台或与吾码无关的任务按实际项目规范执行。
-- 生成的 `AGENTS.md`、`CLAUDE.md`、Copilot/Cursor 指令及可移植吾码 Skill 只保留默认入口指针和读取顺序；详细八项清单仍由总控参考文件唯一维护。工作区未初始化或必要 Skill 缺失时先按现有安装/初始化规范恢复，并准确说明实际可读取状态，不能声称 AI 已自动加载不存在的规则。
+- 生成的 `AGENTS.md`、`CLAUDE.md`、Copilot/Cursor 指令及可移植吾码 Skill 只保留默认入口指针和读取顺序；详细八项清单仍由总控参考文件唯一维护。工作区未初始化或必要 Skill 缺失时先按现有安装/初始化规范恢复，并准确说明实际可读取状态，不能声称 AI 已自动加载不存在的规则。默认路由不代表任意模型 100% 遵循；开工说明须列出实际读取的基础入口、总控、完整清单参考及本次专项 Skills，并映射到交付计划，不能只凭路径存在、MCP 连通或文件摘要声称已读。原八项及报表、菜单先行增补的详细要求统一读取总控参考文件。
 
 ### 吾码创建人身份识别（强制）