@microi.net/cli 5.5.9 → 5.6.1

package/skills/microi-deployment/references/deployment-matrix.md

@@ -1,101 +1,101 @@
-# 部署矩阵与验收
-
-## 中文官网路由
-
-| 文档 | 主要用途 |
-|---|---|
-| `microi.doc/docs/doc/getting-started/docker-run.md` | Docker、Compose、离线包、依赖编排 |
-| `microi.doc/docs/doc/getting-started/win-install-microi.md` | Windows/IIS 安装 |
-| `microi.doc/docs/doc/getting-started/local-run.md` | 后端/前端源码运行、测试与构建 |
-| `microi.doc/docs/doc/getting-started/start-use.md` | 部署后创建表、表单、菜单的首条业务链路 |
-
-英文目录由中文生成，不作为本轮人工单独维护源。
-
-## 服务依赖
-
-| 依赖 | 作用 | 生产要求 |
-|---|---|---|
-| API/Worker | 后端、V8、任务与接口 | 至少双节点关键场景验证 |
-| Web/Nginx/IIS | 前端与反向代理 | HTTPS、上传体积、超时、静态缓存 |
-| MySQL/兼容业务库 | 平台与业务数据 | 备份、字符集、连接池、慢查询 |
-| Redis | 会话、缓存、租约、进度 | 持久化/高可用、按租户 Key |
-| MongoDB | 日志等文档数据 | 持久卷、容量与重放验收 |
-| MinIO/HDFS | 上传和应用资源 | 公私桶、持久卷、备份、CORS |
-
-可选依赖如翻译服务、Ollama、Qdrant 只在相应能力启用时部署，不把演示编排无条件
-带入生产。
-
-## 配置归类
-
-| 配置 | 原则 |
-|---|---|
-| 数据库连接 | 密钥管理/环境注入，不入库明文示例 |
-| Redis/Mongo/对象存储 | 全节点一致、网络可达、租户隔离 |
-| AuthSecret/JWT | 集群一致；变更会影响已有登录态 |
-| ApiBase/FileServer | 与反向代理外部地址一致 |
-| 上传上限 | API、代理、租户配置三层一致 |
-| 日志 spool | 每节点持久卷；Mongo 恢复后幂等重放 |
-| 容器内存 | 多服务共机时给每容器合理 limit |
-
-## Docker/Compose
-
-执行前：
-
-1. 固定目标目录和 compose 文件，解析所有 volume 的绝对宿主路径。
-2. 校验镜像 tag/digest、端口、网络、重启策略、healthcheck 和 secrets。
-3. 备份数据库、对象存储与配置，并验证备份可读。
-4. `docker compose config` 只作静态校验，不代表服务可运行。
-
-发布时一次只替换部分 API 节点；readiness 正常后再替换下一节点。数据库和对象存储
-卷不随应用容器重建删除。Watchtower/自动更新若启用，必须保证 AuthSecret、配置卷和
-健康检查不因容器替换漂移。
-
-离线安装包要包含精确镜像、校验和、compose、配置模板和安装说明；目标机导入后复核
-镜像 digest，不能只看文件解压成功。
-
-## Windows/IIS
-
-至少核对：
-
-- .NET Hosting Bundle 与应用目标框架匹配；
-- Application Pool 使用无托管代码并具备目录权限；
-- API 和 Web 站点绑定、HTTPS、反向代理与 WebSocket 配置；
-- 应用数据、上传、日志和 spool 目录不放临时发布目录；
-- Windows 服务/计划任务不会与 IIS 节点重复执行同一后台任务；
-- MySQL、Redis、MongoDB、MinIO 服务开机启动和恢复策略。
-
-IIS 进程启动不代表 API 可用，仍要检查 readiness 和真实登录路径。
-
-## 本地源码运行
-
-后端：
-
-- 使用当前仓库规定的 .NET SDK；
-- 配置开发专用数据库/Redis/Mongo/对象存储；
-- 先跑定向测试，再按资源允许程度执行更大构建；
-- 不让本地调试连接生产写库。
-
-前端：
-
-- 使用仓库规定的 Node/npm/pnpm 版本；
-- 复用已有 Vite 服务，不重复启动；
-- `src/config.json` 的 `ApiBaseDev` 是默认值；本地 URL 可在 `#` 前用
-  `?OsClient=...&ApiBase=...` 以最高优先级覆盖 ApiBase 与租户；
-- 多组 `ApiBase + OsClient` 并行时按组创建独立浏览器 Profile/进程或 Playwright context，不能在
-  同一同源 context 的多个 Page 中混测；
-- 人工第二组至少使用无痕窗口，但多个 Chrome 无痕窗口可能共享临时会话，不能承担多组强隔离；
-- 从线上页面读取 `window.__MICROI_RUNTIME_ENDPOINT__`；旧版无该对象时按 URL、window 全局、
-  同源状态、域名解析/成功请求逐级确认，禁止猜测；
-- 本地页面成功不替代宿主 Token、OsClient、菜单权限和生产构建验收。
-
-## 最小上线验收
-
-- API liveness 200，readiness 200；依赖降级能在 readiness/日志中体现。
-- Web 首屏、登录、退出、Token 刷新正常。
-- 管理员与普通角色各验证一个菜单和数据权限。
-- FormEngine 新增/编辑/查询，ApiEngine 调用正常。
-- 公有/私有文件各上传、预览/下载一次，Range/HEAD 按需验证。
-- Redis/Mongo/对象存储短暂不可用后可恢复，无永久死锁或静默丢失。
-- 双节点同时触发同一 Job/消息，业务副作用仅一次。
-- 发布中终止一个节点，其余节点继续服务；恢复节点不重复初始化。
-- 回滚步骤和恢复点已实际验证或明确标记未验证。
+# 部署矩阵与验收
+
+## 中文官网路由
+
+| 文档 | 主要用途 |
+|---|---|
+| `microi.doc/docs/doc/getting-started/docker-run.md` | Docker、Compose、离线包、依赖编排 |
+| `microi.doc/docs/doc/getting-started/win-install-microi.md` | Windows/IIS 安装 |
+| `microi.doc/docs/doc/getting-started/local-run.md` | 后端/前端源码运行、测试与构建 |
+| `microi.doc/docs/doc/getting-started/start-use.md` | 部署后创建表、表单、菜单的首条业务链路 |
+
+英文目录由中文生成，不作为本轮人工单独维护源。
+
+## 服务依赖
+
+| 依赖 | 作用 | 生产要求 |
+|---|---|---|
+| API/Worker | 后端、V8、任务与接口 | 至少双节点关键场景验证 |
+| Web/Nginx/IIS | 前端与反向代理 | HTTPS、上传体积、超时、静态缓存 |
+| MySQL/兼容业务库 | 平台与业务数据 | 备份、字符集、连接池、慢查询 |
+| Redis | 会话、缓存、租约、进度 | 持久化/高可用、按租户 Key |
+| MongoDB | 日志等文档数据 | 持久卷、容量与重放验收 |
+| MinIO/HDFS | 上传和应用资源 | 公私桶、持久卷、备份、CORS |
+
+可选依赖如翻译服务、Ollama、Qdrant 只在相应能力启用时部署，不把演示编排无条件
+带入生产。
+
+## 配置归类
+
+| 配置 | 原则 |
+|---|---|
+| 数据库连接 | 密钥管理/环境注入，不入库明文示例 |
+| Redis/Mongo/对象存储 | 全节点一致、网络可达、租户隔离 |
+| AuthSecret/JWT | 集群一致；变更会影响已有登录态 |
+| ApiBase/FileServer | 与反向代理外部地址一致 |
+| 上传上限 | API、代理、租户配置三层一致 |
+| 日志 spool | 每节点持久卷；Mongo 恢复后幂等重放 |
+| 容器内存 | 多服务共机时给每容器合理 limit |
+
+## Docker/Compose
+
+执行前：
+
+1. 固定目标目录和 compose 文件，解析所有 volume 的绝对宿主路径。
+2. 校验镜像 tag/digest、端口、网络、重启策略、healthcheck 和 secrets。
+3. 备份数据库、对象存储与配置，并验证备份可读。
+4. `docker compose config` 只作静态校验，不代表服务可运行。
+
+发布时一次只替换部分 API 节点；readiness 正常后再替换下一节点。数据库和对象存储
+卷不随应用容器重建删除。Watchtower/自动更新若启用，必须保证 AuthSecret、配置卷和
+健康检查不因容器替换漂移。
+
+离线安装包要包含精确镜像、校验和、compose、配置模板和安装说明；目标机导入后复核
+镜像 digest，不能只看文件解压成功。
+
+## Windows/IIS
+
+至少核对：
+
+- .NET Hosting Bundle 与应用目标框架匹配；
+- Application Pool 使用无托管代码并具备目录权限；
+- API 和 Web 站点绑定、HTTPS、反向代理与 WebSocket 配置；
+- 应用数据、上传、日志和 spool 目录不放临时发布目录；
+- Windows 服务/计划任务不会与 IIS 节点重复执行同一后台任务；
+- MySQL、Redis、MongoDB、MinIO 服务开机启动和恢复策略。
+
+IIS 进程启动不代表 API 可用，仍要检查 readiness 和真实登录路径。
+
+## 本地源码运行
+
+后端：
+
+- 使用当前仓库规定的 .NET SDK；
+- 配置开发专用数据库/Redis/Mongo/对象存储；
+- 先跑定向测试，再按资源允许程度执行更大构建；
+- 不让本地调试连接生产写库。
+
+前端：
+
+- 使用仓库规定的 Node/npm/pnpm 版本；
+- 复用已有 Vite 服务，不重复启动；
+- `src/config.json` 的 `ApiBaseDev` 是默认值；本地 URL 可在 `#` 前用
+  `?OsClient=...&ApiBase=...` 以最高优先级覆盖 ApiBase 与租户；
+- 多组 `ApiBase + OsClient` 并行时按组创建独立浏览器 Profile/进程或 Playwright context，不能在
+  同一同源 context 的多个 Page 中混测；
+- 人工第二组至少使用无痕窗口，但多个 Chrome 无痕窗口可能共享临时会话，不能承担多组强隔离；
+- 从线上页面读取 `window.__MICROI_RUNTIME_ENDPOINT__`；旧版无该对象时按 URL、window 全局、
+  同源状态、域名解析/成功请求逐级确认，禁止猜测；
+- 本地页面成功不替代宿主 Token、OsClient、菜单权限和生产构建验收。
+
+## 最小上线验收
+
+- API liveness 200，readiness 200；依赖降级能在 readiness/日志中体现。
+- Web 首屏、登录、退出、Token 刷新正常。
+- 管理员与普通角色各验证一个菜单和数据权限。
+- FormEngine 新增/编辑/查询，ApiEngine 调用正常。
+- 公有/私有文件各上传、预览/下载一次，Range/HEAD 按需验证。
+- Redis/Mongo/对象存储短暂不可用后可恢复，无永久死锁或静默丢失。
+- 双节点同时触发同一 Job/消息，业务副作用仅一次。
+- 发布中终止一个节点，其余节点继续服务；恢复节点不重复初始化。
+- 回滚步骤和恢复点已实际验证或明确标记未验证。

package/skills/microi-docs-coverage/SKILL.md

@@ -10,6 +10,10 @@ description: Microi 中文官网文档与 Skills 能力覆盖审计。用于全
 当任务涉及“官网有但 AI 不知道”“全面同步官方文档到 Skills”“核对所有
 V8 函数”或新增、调整官方中文文档时，使用本 Skill。
 
+创始人源码工作区中的平台功能还必须执行 [工作区基础规范](../workspace-conventions/SKILL.md)
+的“平台功能四项同步检查”：本 Skill 负责文档与 AI 知识覆盖，不能替代官方应用包发布
+或 MCP 能力验收。既有页面、Skill 或 MCP 已完整覆盖时记录依据，不重复创建同义内容。
+
 ## 范围与事实源
 
 - 能力映射扫描 `microi.doc/docs/doc/**/*.md`，但排除受发版规则保护的
@@ -44,6 +48,12 @@ V8 函数”或新增、调整官方中文文档时，使用本 Skill。
 5. 更新 `references/capability-map.md`，重新运行审计，直到严格检查通过。
 6. 对每个新增或改动的 Skill 运行 `skill-creator` 的 `quick_validate.py`，
    再执行 `git diff --check` 和相对链接检查。
+7. 修改已注册的后端内嵌知识时，运行
+   `node microi.skills/scripts/sync-embedded-skills.mjs <skill-name...>`，再带 `--check`
+   回读一致性；它只更新已在 `Microi.AI.csproj` 注册的快照，正文仍来自 canonical Skills。
+   修改渐进内容后先显式刷新本次 Skill 的校验清单，再按名称验证；全库检查发现历史漂移时
+   单独记录，禁止修改无关 Skill 的哈希来掩盖漏项。插件/CLI 使用现有构建器同步分发副本，
+   打包成功不等于已发布到用户安装渠道。
 
 ## 中文文档视觉与可读性契约（强制）
 

package/skills/microi-docs-coverage/references/capability-map.md

@@ -17,6 +17,7 @@ Markdown。第一列是相对 `microi.doc/docs/doc/` 的路径；第二列 Skill
 | `form-engine/form-field-info.md` | microi-form-engine, v8-table-event | 表单/字段属性与事件 |
 | `form-engine/model-engine.md` | v8-template-engine | 表格/表单模板 |
 | `getting-started/docker-run.md` | microi-deployment | Docker 部署与验收 |
+| `server-panel/overview.md` | microi-deployment, microi-ui | 独立服务器面板、Docker 插件版本、Nginx/SSL、冷备份恢复、共存与 Ops 迁移 |
 | `getting-started/local-run.md` | microi-deployment, microi-client-frontend, playwright-e2e | 源码本地运行、URL 切换 ApiBase/OsClient 与并行浏览器隔离 |
 | `getting-started/source-code-architecture.md` | workspace-conventions, microi-system-delivery | 多仓源码边界、模块地图和修改路由 |
 | `getting-started/start-use.md` | microi-system-delivery, module-engine | 快速使用和首个模块 |
@@ -48,7 +49,7 @@ Markdown。第一列是相对 `microi.doc/docs/doc/` 的路径；第二列 Skill
 | `system-engine/micro-app.md` | microi-microservice, microi-ai-application | 微服务/AI 前端应用的工程架构与交付 |
 | `system-engine/multi-end-client.md` | microi-client-frontend, microi-mobile-app-quality, microi-uniapp-frontend | PC、WebOS、移动自适应、UniApp 与 App 边界 |
 | `system-engine/microi-ui.md` | microi-ui | Microi.UI 组件和主题 |
-| `system-engine/message-notification.md` | message-notification | 平台内部消息、SignalR 与多通道通知 |
+| `system-engine/message-notification.md` | message-notification | 统一消息通知微服务、原 mic_msgset 多通道配置、MCP/Skills、租户/产品版本与帐号范围、后端重启领取、居中弹窗与 SignalR/轮询恢复 |
 | `system-engine/module-engine.md` | module-engine, v8-menu-buttons, v8-template-engine, microi-mobile-app-quality | 菜单统计、模块指标、复合列、移动卡片、按钮角标和页面入口 |
 | `system-engine/mq.md` | v8-mq-mqtt | RabbitMQ 租户连接、队列规范化、事务发布、消费确认、有限重试、幂等与多节点运行 |
 | `system-engine/mqtt-engine.md` | v8-mq-mqtt | MQTT Broker、SaaS 认证、Topic ACL、V8 事件、设备路由、下行与生产部署 |
@@ -69,7 +70,7 @@ Markdown。第一列是相对 `microi.doc/docs/doc/` 的路径；第二列 Skill
 | `v8-engine/ai-apiengine.md` | ai-engine, v8-api-config | AI 辅助接口引擎开发 |
 | `v8-engine/api-engine.md` | v8-api-config, v8-utilities | 接口上下文、配置、分布式锁续租和调用 |
 | `v8-engine/apiengine-index.md` | v8-crud-api, v8-api-config | 接口引擎实战和规范 |
-| `v8-engine/form-engine.md` | v8-crud-api, v8-formengine-http | FormEngine API 与 HTTP |
+| `v8-engine/form-engine.md` | v8-crud-api, v8-formengine-http, module-engine, microi-form-engine | FormEngine API、HTTP、原生查询身份/统计范围与按表主库策略 |
 | `v8-engine/mcp-server.md` | microi-system-delivery, microi-codex-installer, v8-security | MCP 工具、确认、审计、文件、日志、备份与访问密钥 |
 | `v8-engine/v8-client.md` | v8-utilities, v8-frontend-events, v8-http-integration, v8-security, ai-engine, print-engine | 全部前端 V8、平台 AI、强身份验证、扫码和蓝牙打印 |
 | `v8-engine/v8-server.md` | v8-utilities, v8-api-config, v8-http-integration, v8-security, ai-engine | 全部后端 V8、强身份票据、平台 AI 和专项路由 |