@microi.net/cli 4.9.4 → 4.9.6

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

@@ -0,0 +1,205 @@
+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',
+  controller: 'Microi.Server/Microi.net.Api/Controllers/MqttController.cs'
+};
+
+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 ['skill', '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('skill', [
+  'MqttEnable',
+  'MqttPort',
+  'MqttWsPort',
+  'MqttAccount',
+  'MqttPwd',
+  'MqttApiEngine',
+  'MqttAllowAnonymous',
+  'MqttTopicIsolation'
+]);
+requireTokens('reference', configurationTokens);
+
+for (const targetName of ['skill', 'reference']) {
+  requireTokens(targetName, securityTokens);
+  requireTokens(targetName, 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']);
+requireTokens('controller', ['[PlatformAdminOnly]', 'StatusScope = "CurrentNode"']);
+
+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-saas-multi-tenant/SKILL.md

@@ -3,7 +3,7 @@ name: v8-saas-multi-tenant
 description: Microi V8 SaaS 多租户指南。用于处理 OsClient、OsClientType、OsClientNetwork、租户配置、V8.OsClientModel、隔离和租户感知代码。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 SaaS 多租户引擎
 

package/skills/v8-security/SKILL.md

@@ -3,7 +3,7 @@ name: v8-security
 description: Microi V8 安全指南。用于审查 DiyToken 与权限、可逆业务秘密、Passkey/TOTP/人脸步进验证、接口引擎安全、密钥管理、SQL 注入、匿名端点、文件上传和租户隔离。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 安全最佳实践
 

package/skills/v8-sql-query/SKILL.md

@@ -3,7 +3,7 @@ name: v8-sql-query
 description: Microi V8 安全 SQL 查询指南。用于选择 V8.FormEngine _Where 或 V8.Db.FromSql，处理参数化查询、联表、聚合并避免 SQL 注入。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 安全 SQL 查询
 

package/skills/v8-table-event/SKILL.md

@@ -3,7 +3,7 @@ name: v8-table-event
 description: Microi V8 表单事件开发。用于编写 InFormV8、SubmitFormV8、SubmitBeforeServerV8、SubmitAfterServerV8、OutFormV8、DataFilterV8 和事务感知事件。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 表单事件开发
 

package/skills/v8-template-engine/SKILL.md

@@ -3,7 +3,7 @@ name: v8-template-engine
 description: Microi V8 模板引擎指南。用于编写表格/表单模板渲染、V8.Result HTML/text 输出、行格式化、徽章、图片和自定义显示逻辑。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 模板引擎（表格/表单 V8 模板）
 

package/skills/v8-utilities/SKILL.md

@@ -3,7 +3,7 @@ name: v8-utilities
 description: Microi V8 全局对象、上下文变量和通用函数索引。用于查询某个 V8 函数是否存在、区分前端与后端 API，或使用 V8.Method、Base64、EncryptHelper、Action、CurrentUser、SysConfig、OsClient、扫码和客户端导航工具。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 通用能力与函数索引
 

package/skills/v8-utilities/references/client-api-index.md

@@ -114,7 +114,7 @@
 | `V8.AddSysLog(...)` | 前端发起系统日志记录；不得含秘密 |
 | `V8.SendSystemMessage(...)` | 发送站内系统消息 |
 | `await V8.Method.ScanCode()` | 扫码；成功值同时写入 `V8.ScanCodeRes` |
-| `V8.Print.*` | BLE 标签/小票打印，见蓝牙打印参考 |
+| `V8.Print.*` | TSPL/CPCL/ESC-POS 蓝牙标签与小票打印，兼容 GP-M322、CC4，见蓝牙打印参考 |
 | `V8.Identity.GetCapabilities()` | 读取当前租户强身份能力和本人登记状态 |
 | `V8.Identity.CreateActionHash(value)` | 为稳定业务命令生成 SHA-256 摘要 |
 | `V8.Identity.RegisterPasskey(options?)` | 登记当前用户 Passkey |
@@ -124,11 +124,13 @@
 `V8.Identity` 是强身份验证模块。`V8.Identity.Verify` 的成功结果不能直接授权业务；后端必须重读权威数据、重算摘要并调用 `V8.Method.ConsumeIdentityVerificationTicket`。
 蓝牙打印完整 API 包含 `V8.Print.createNew`、`V8.Print.createNewESC`、
 `V8.Print.OpenBluetoothPage`、`V8.Print.isConnected`、
+`V8.Print.reconnect`、`V8.Print.getConnectionState`、`V8.Print.subscribeConnection`、
+`V8.Print.getPrinterProfile`、`V8.Print.setPrinterProfile`、
 `V8.Print.prepareSend`、`V8.Print.Send`、`V8.Print.setOneTimeData`、
 `V8.Print.setPrinterNum`、`V8.Print.disconnect` 和
 `V8.Print.BLEInformation`。其中 `Send` 依赖 `prepareSend` 设置的共享分包游标，
 只作内部状态机入口；业务代码必须调用并 `await prepareSend`。当前挂载范围、连接
-真实性和串行约束见
+真实性、佳博原 TSPL 回归、CC4 CPCL 适配、Android SPP 与串行约束见
 [`bluetooth-print.md`](../../v8-frontend-events/references/bluetooth-print.md)，TSC/ESC
 完整方法见
 [`bluetooth-print-api.md`](../../v8-frontend-events/references/bluetooth-print-api.md)。

package/skills/v8-workflow/SKILL.md

@@ -3,7 +3,7 @@ name: v8-workflow
 description: Microi V8 工作流事件指南。用于编写审批流条件、节点 V8 代码、wf_flowdesign/wf_node/wf_line 逻辑、V8.WF 变量和工作流路由。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 工作流事件开发
 

package/skills/workspace-conventions/SKILL.md

@@ -14,15 +14,14 @@ AI 处理任何 Microi 低代码、V8、MCP、OpenClaw、采集引擎、前端
 - 涉及 V8 CRUD、SQL、上传下载、导入导出、菜单按钮、表单事件、前端页面或自动化测试时，继续读取对应专项 Skill。
 - 最终交付说明必须能逐条对应用户编号需求；不得遗漏、合并或把仍可执行的需求写成“下一步继续”。
 
-### Codex 最新版与重新初始化门禁（强制）
-
-- Codex 在每个新建或已有对话中首次处理任一 Microi吾码任务时，只要当前会话能够读取任何吾码 Skill，就必须先完整读取 `microi-codex-installer`，并在业务分析、MCP 调用、源码修改、构建或发布前完成一次最新版门禁。不得因为上一个对话检查过、`microi codex status` 返回 `ok: true`，或 VS Code 已安装吾码插件而跳过。
-- 最新版只能以 npm 官方 registry 的在线结果为准：`npm view '@microi.net/cli' version --json --prefer-online --registry=https://registry.npmjs.org/`。`microi codex status` 只比较当前 CLI 内置快照与本机 Codex 插件，不能证明 npm 没有更新版本。
-- 门禁必须同时核对：官方最新版、当前 `microi` CLI 版本、`microi@microi-net` 的安装/启用/版本、当前工作区 AI bundle 版本，以及 MCP provider 的来源与版本。全局 CLI 已安装时不得保留旧版；Codex 插件、工作区 AI 配置或 MCP 低于官方最新版时也不得继续业务任务。
-- 只读查询不需要授权。需要安装或升级时，先向用户一次性说明将更新全局 `@microi.net/cli`、修改 Codex 全局 marketplace/插件、重新生成当前工作区 AI 配置并刷新 MCP；用户明确要求“安装、升级、更新、初始化吾码”时视为已经授权这些对应操作，否则必须取得一次明确同意。
-- 获得授权后必须使用最新版 CLI 完整执行：`npm install --global @microi.net/cli@latest`、`microi codex install --yes`、`microi ai init --workspace "<工作区绝对路径>" --json`、`microi doctor --workspace "<工作区绝对路径>" --json`、`microi codex status --json`。`ai init` 默认包含 MCP 更新，禁止在此流程使用 `--no-mcp`；若诊断仍显示旧版或 `legacy` provider，继续修复到版本一致后再验收。
-- Codex 插件发生安装或升级后，当前任务通常不能热加载新 Skills/MCP。必须提示并要求新建 Codex 任务或重载 Codex，重载后的新任务再次通过最新版门禁后才继续；不得在旧任务中声称新版能力已经生效。
-- npm 官方 registry 无法访问、版本无法解析、用户拒绝必要授权、安装失败或重载尚未完成时，必须明确报告门禁未通过；在能够证明最新版前，不得继续 Microi 远端写入、源码实现、构建或发布，也不得改用第三方 registry、缓存结果或旧 CLI 冒充最新版。
+### Microi吾码非阻塞自动更新（强制）
+
+- VS Code 扩展、`@microi.net/cli` 与 Codex 插件默认自动检查和安装更新。任一 Microi 任务开始时可后台投递 `microi update --background --workspace "<工作区绝对路径>" --json`，但不得等待它完成才开始业务分析、MCP 调用、源码修改、构建或发布。
+- CLI 最新版只从 npm 官方 registry 查询：`npm view '@microi.net/cli' version --json --prefer-online --registry=https://registry.npmjs.org/`；VS Code 扩展只使用官方扩展宿主的自动更新/安装命令。不得使用第三方 registry 或不明镜像冒充官方更新。
+- 后台更新完整闭环包含全局 CLI、`microi@microi-net`、`microi ai init`、`microi doctor` 与 `microi codex status`。`codex install --yes` 的 `--yes` 只兼容旧脚本，不是用户继续工作的授权开关。
+- 当前运行中的 VS Code Extension Host、CLI、Codex Router、MCP 和对话继续使用已加载版本。禁止为了更新终止进程、强制重载、要求立即新建任务或拒绝新工作；新版只在后续新进程或宿主自然重启时接管。
+- npm 官方 registry 无法访问、权限不足、文件被运行中进程占用、安装失败或宿主不能热更新时，必须写入可诊断状态并延后重试。可以非模态提示“立即重试/查看日志”，但用户忽略、关闭或暂不处理时，当前、正在进行和新建的 Microi 工作仍必须继续。
+- 只有任务明确依赖旧版本不存在的具体能力时，才准确说明该能力边界与可用降级方案；不得用“最新版未通过”“尚未授权升级”作为整项任务的失败理由。
 
 ## Microi吾码工作进度播报规范（强制）