@microi.net/cli 5.5.9 → 5.6.0

package/skills/microi-db-schema/references/schema-overview.md

@@ -1,7 +1,7 @@
 # Microi DB Schema Overview
 
-- Source: generic reference snapshot; current tenant truth must come from `microi_get_db_schema`.
-- Tables: 74
+- Source: generic reference snapshot; current tenant truth must come from `microi_get_db_schema`.
+- Tables: 74
 - Configurable fields: 975
 
 ## Fixed Fields
@@ -42,11 +42,11 @@ DIY tables created by the platform include fixed fields even when they are not p
 | `sys_menu` | `EditCodeShowV8` | 前端 | [编辑]按钮显示条件。 |
 | `sys_menu` | `DelCodeShowV8` | 前端 | [删除]按钮显示条件。 |
 | `sys_menu` | `DetailPageV8` | 前端 | 详情按钮行为。 |
-| `sys_menu` | `DiyConfig` | 兼容字段 | 已废弃，只用于读取历史数据；禁止写入新配置。 |
-| `sys_menu` | `EnableViewSchema` | 前端/模块 | 是否启用跨端统一视图协议。 |
-| `sys_menu` | `ViewSchemaVersion` | 前端/模块 | 跨端统一视图协议版本。 |
-| `sys_menu` | `ViewConfigVersion` | 前端/模块 | 视图配置递增版本，用于缓存失效。 |
-| `sys_menu` | `ViewSchema` | 前端/模块 | Detail/Edit/List/Card 的版本化跨端视图 JSON。 |
+| `sys_menu` | `DiyConfig` | 兼容字段 | 已废弃，只用于读取历史数据；禁止写入新配置。 |
+| `sys_menu` | `EnableViewSchema` | 前端/模块 | 是否启用跨端统一视图协议。 |
+| `sys_menu` | `ViewSchemaVersion` | 前端/模块 | 跨端统一视图协议版本。 |
+| `sys_menu` | `ViewConfigVersion` | 前端/模块 | 视图配置递增版本，用于缓存失效。 |
+| `sys_menu` | `ViewSchema` | 前端/模块 | Detail/Edit/List/Card 的版本化跨端视图 JSON。 |
 | `sys_menu` | `SqlJoin` | 后端查询 | 列表查询 JOIN 片段。默认主表别名为 A。 |
 | `sys_menu` | `SqlWhere` | 后端查询 | 模块级 Where 片段，可使用 CurrentUser 变量。 |
 | `sys_menu` | `ImportV8` | 导入 | 导入处理扩展。 |
@@ -86,7 +86,7 @@ DIY tables created by the platform include fixed fields even when they are not p
 | 表名 | 字段数 | 说明 |
 |---|---:|---|
 | `Sys_Config` | 70 | 系统设置 |
-| `sys_osclients` | 98 | OsClients（含六个租户上传开关/限额字段） |
+| `sys_osclients` | 98 | OsClients（含六个租户上传开关/限额字段） |
 | `sys_user` | 37 | 员工信息 |
 | `sys_role` | 9 | Sys_Role |
 | `sys_rolelimit` | 5 | sys_rolelimit |
@@ -126,10 +126,10 @@ DIY tables created by the platform include fixed fields even when they are not p
 | `wx_mp` | 7 | 微信公众号配置 |
 | `wx_menu` | 3 | 微信公众号自定义菜单 |
 | `wx_mini_program` | 3 | 微信小程序 |
-| `wx_tpl_msg` | 12 | 公众号/服务号模板消息，可选跳转小程序 |
+| `wx_tpl_msg` | 12 | 公众号/服务号模板消息，可选跳转小程序 |
 | `mic_email_server` | 7 | 邮件配置 |
-| `mic_msgset` | 11 | 多通道消息通知设置 |
-| `mic_msg_event_log` | 13 | 按事件、渠道、接收人持久化的消息通知日志 |
+| `mic_msgset` | 11 | 多通道消息通知设置 |
+| `mic_msg_event_log` | 13 | 按事件、渠道、接收人持久化的消息通知日志 |
 
 ### 内容、运营与平台功能
 

package/skills/microi-db-schema/references/schema.md

@@ -1,6 +1,6 @@
 # Microi 平台标准数据库结构
 
-> 通用参考快照，不代表当前租户。实际字段以 `microi_get_db_schema` 实时回读为准；离线时仅使用当前 OsClient 目录的 `.microi-db-schema.md` 并标注快照时间。
+> 通用参考快照，不代表当前租户。实际字段以 `microi_get_db_schema` 实时回读为准；离线时仅使用当前 OsClient 目录的 `.microi-db-schema.md` 并标注快照时间。
 
 ---
 
@@ -15,35 +15,35 @@
 | `UpdateTime` | 更新时间 |
 | `UserId` | 创建人 Id |
 | `UserName` | 创建人姓名 |
-| `IsDeleted` | 软删除标记，原始 SQL 查询时需加 `IsDeleted != 1` |
-
----
-
-## 物理数据库索引协议
-
-索引不存放在 `diy_field`，真实状态必须从数据库系统目录读取。Microi MCP 将 MySQL、SQL Server、PostgreSQL、Oracle、达梦和人大金仓统一为以下结构：
-
-| 字段 | 说明 |
-|---|---|
-| `Key_name` / `Name` | 索引名 |
-| `Column_name` | 按顺序拼接的字段名，兼容旧前端 |
-| `Columns` | 有序字段数组，索引设计与验收以此为准 |
-| `Non_unique` / `IsUnique` | `Non_unique=0` 表示唯一；新代码优先读 `IsUnique` |
-| `Index_type` | 数据库索引类型 |
-| `Is_primary` / `IsPrimary` | 主键索引标识；主键禁止通过索引管理删除 |
-
-标准工具：
-
-- `microi_get_table_indexes(tableName)`：读取并聚合真实物理索引。
-- `microi_create_table_index(tableName, columns, indexName?, unique?, confirmExecution)`：校验物理字段、幂等创建并回读。
-- `microi_drop_table_index(tableName, indexName, confirmExecution)`：幂等删除非主键索引并回读。
-- Manifest 使用 `tables[].indexes[] = { name?, columns: string[], unique?: boolean, purpose?: string }`。
-
-索引字段顺序必须来自真实查询：等值租户/业务条件在前，范围或排序字段在后。当前租户在线 DDL 一律走 MCP 标准工具，不能在 V8 或原生 SQL 中绕过。
-
----
-
-## 核心关系
+| `IsDeleted` | 软删除标记，原始 SQL 查询时需加 `IsDeleted != 1` |
+
+---
+
+## 物理数据库索引协议
+
+索引不存放在 `diy_field`，真实状态必须从数据库系统目录读取。Microi MCP 将 MySQL、SQL Server、PostgreSQL、Oracle、达梦和人大金仓统一为以下结构：
+
+| 字段 | 说明 |
+|---|---|
+| `Key_name` / `Name` | 索引名 |
+| `Column_name` | 按顺序拼接的字段名，兼容旧前端 |
+| `Columns` | 有序字段数组，索引设计与验收以此为准 |
+| `Non_unique` / `IsUnique` | `Non_unique=0` 表示唯一；新代码优先读 `IsUnique` |
+| `Index_type` | 数据库索引类型 |
+| `Is_primary` / `IsPrimary` | 主键索引标识；主键禁止通过索引管理删除 |
+
+标准工具：
+
+- `microi_get_table_indexes(tableName)`：读取并聚合真实物理索引。
+- `microi_create_table_index(tableName, columns, indexName?, unique?, confirmExecution)`：校验物理字段、幂等创建并回读。
+- `microi_drop_table_index(tableName, indexName, confirmExecution)`：幂等删除非主键索引并回读。
+- Manifest 使用 `tables[].indexes[] = { name?, columns: string[], unique?: boolean, purpose?: string }`。
+
+索引字段顺序必须来自真实查询：等值租户/业务条件在前，范围或排序字段在后。当前租户在线 DDL 一律走 MCP 标准工具，不能在 V8 或原生 SQL 中绕过。
+
+---
+
+## 核心关系
 
 | 关联 | 含义 |
 |---|---|
@@ -79,11 +79,11 @@
 | `sys_menu` | `EditCodeShowV8` | 前端 | [编辑]按钮显示条件 |
 | `sys_menu` | `DelCodeShowV8` | 前端 | [删除]按钮显示条件 |
 | `sys_menu` | `DetailPageV8` | 前端 | 详情按钮行为 |
-| `sys_menu` | `DiyConfig` | 兼容字段 | 已废弃，只用于读取历史数据；禁止写入新配置 |
-| `sys_menu` | `EnableViewSchema` | 前端/模块 | 是否启用跨端统一视图协议 |
-| `sys_menu` | `ViewSchemaVersion` | 前端/模块 | 跨端统一视图协议版本 |
-| `sys_menu` | `ViewConfigVersion` | 前端/模块 | 视图配置递增版本，用于缓存失效 |
-| `sys_menu` | `ViewSchema` | 前端/模块 | Detail/Edit/List/Card 的版本化跨端视图 JSON |
+| `sys_menu` | `DiyConfig` | 兼容字段 | 已废弃，只用于读取历史数据；禁止写入新配置 |
+| `sys_menu` | `EnableViewSchema` | 前端/模块 | 是否启用跨端统一视图协议 |
+| `sys_menu` | `ViewSchemaVersion` | 前端/模块 | 跨端统一视图协议版本 |
+| `sys_menu` | `ViewConfigVersion` | 前端/模块 | 视图配置递增版本，用于缓存失效 |
+| `sys_menu` | `ViewSchema` | 前端/模块 | Detail/Edit/List/Card 的版本化跨端视图 JSON |
 | `sys_menu` | `SqlJoin` | 后端查询 | 列表查询 JOIN 片段（主表别名 A） |
 | `sys_menu` | `SqlWhere` | 后端查询 | 模块级 Where 片段，可用 CurrentUser 变量 |
 | `sys_menu` | `ImportV8` | 导入 | 导入处理扩展 |
@@ -125,9 +125,9 @@
 | 表名 | 字段数 | 说明 |
 |---|---:|---|
 | `Sys_Config` | 70 | 系统设置（全局 V8、主题、密码策略等） |
-| `sys_osclients` | 98 | SaaS 租户配置（DB、Redis、MQ、MQTT、存储、域名、租户上传限额等） |
+| `sys_osclients` | 98 | SaaS 租户配置（DB、Redis、MQ、MQTT、存储、域名、租户上传限额等） |
 | `sys_user` | 37 | 员工信息 |
-| `sys_role` | 9 | 角色（Level>=9999 为平台超级管理员） |
+| `sys_role` | 9 | 角色（Level>=9999 为平台超级管理员） |
 | `sys_rolelimit` | 5 | 角色-菜单权限关联 |
 | `sys_dept` | 9 | 组织机构 |
 | `diy_tenant` | 1 | 租户管理 |
@@ -165,10 +165,10 @@
 | `wx_mp` | 7 | 微信公众号配置 |
 | `wx_menu` | 3 | 微信公众号自定义菜单 |
 | `wx_mini_program` | 3 | 微信小程序 |
-| `wx_tpl_msg` | 12 | 公众号/服务号模板消息，可选跳转小程序 |
+| `wx_tpl_msg` | 12 | 公众号/服务号模板消息，可选跳转小程序 |
 | `mic_email_server` | 7 | 邮件配置 |
-| `mic_msgset` | 11 | 多通道消息通知设置 |
-| `mic_msg_event_log` | 13 | 按事件、渠道、接收人持久化的消息通知日志 |
+| `mic_msgset` | 11 | 多通道消息通知设置 |
+| `mic_msg_event_log` | 13 | 按事件、渠道、接收人持久化的消息通知日志 |
 
 ### 内容、运营与平台功能
 
@@ -365,11 +365,11 @@
 | `EditCodeShowV8` | `mediumtext` | `CodeEditor` | [编辑]按钮显示条件 |
 | `DelCodeShowV8` | `mediumtext` | `CodeEditor` | [删除]按钮显示条件 |
 | `DetailPageV8` | `mediumtext` | `CodeEditor` | 详情按钮 V8 |
-| `DiyConfig` | `mediumtext` | `CodeEditor` | 已废弃，仅兼容历史数据，禁止写入新配置 |
-| `EnableViewSchema` | `int` | `Switch` | 是否启用跨端统一视图协议 |
-| `ViewSchemaVersion` | `varchar(25)` | `Text` | 跨端统一视图协议版本 |
-| `ViewConfigVersion` | `int` | `NumberText` | 视图配置递增版本 |
-| `ViewSchema` | `mediumtext` | `DevComponent` | 模块展示设计器，保存 Detail/Edit/List/Card 的版本化跨端视图 JSON |
+| `DiyConfig` | `mediumtext` | `CodeEditor` | 已废弃，仅兼容历史数据，禁止写入新配置 |
+| `EnableViewSchema` | `int` | `Switch` | 是否启用跨端统一视图协议 |
+| `ViewSchemaVersion` | `varchar(25)` | `Text` | 跨端统一视图协议版本 |
+| `ViewConfigVersion` | `int` | `NumberText` | 视图配置递增版本 |
+| `ViewSchema` | `mediumtext` | `DevComponent` | 模块展示设计器，保存 Detail/Edit/List/Card 的版本化跨端视图 JSON |
 | `PageTemplate` | `varchar(255)` | `Text` | 界面模板 |
 | `ReportId` | `varchar(36)` | `Guid` | 报表 Id |
 | `ReportName` | `varchar(100)` | `Select` | 报表 |
@@ -479,7 +479,7 @@
 | 字段 | 类型 | 控件 | 说明 |
 |---|---|---|---|
 | `Name` | `varchar(500)` | `Text` | 角色名称 |
-| `Level` | `int(255)` | `NumberText` | 权限级别（Level >= 9999 为平台超级管理员） |
+| `Level` | `int(255)` | `NumberText` | 权限级别（Level >= 9999 为平台超级管理员） |
 | `Sort` | `int(11)` | `NumberText` | 排序 |
 | `Class` | `varchar(500)` | `Text` | 就是 Customer |
 | `BaseLimit` | `varchar(500)` | `Text` | 基础权限 |

package/skills/microi-db-schema/references/table-catalog.md

@@ -1,6 +1,6 @@
 # Microi Table Catalog
 
-Generic reference catalog. Load it only to understand common platform tables; never use it as the exact field authority for a tenant. Query `microi_get_db_schema` first.
+Generic reference catalog. Load it only to understand common platform tables; never use it as the exact field authority for a tenant. Query `microi_get_db_schema` first.
 
 ## All Tables
 
@@ -41,8 +41,8 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `mic_day_word` | 2 | 每日一言 |
 | `mic_email_server` | 7 | 邮件配置 |
 | `mic_memo` | 3 | 备忘录 |
-| `mic_msg_event_log` | 13 | 按事件、渠道、接收人持久化的消息通知日志 |
-| `mic_msgset` | 11 | 多通道消息通知设置 |
+| `mic_msg_event_log` | 13 | 按事件、渠道、接收人持久化的消息通知日志 |
+| `mic_msgset` | 11 | 多通道消息通知设置 |
 | `mic_page` | 6 | 界面引擎 |
 | `mic_print` | 6 | 打印引擎 |
 | `microi_calendar` | 6 | 日历 |
@@ -64,7 +64,7 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `sys_microistore` | 21 | 应用商城 |
 | `sys_microistoreversion` | 1 | 应用商城应用版本 |
 | `sys_microiuptlog` | 7 | 框架更新日志 |
-| `sys_osclients` | 98 | OsClients |
+| `sys_osclients` | 98 | OsClients |
 | `sys_role` | 9 | Sys_Role |
 | `sys_rolelimit` | 5 | sys_rolelimit |
 | `sys_servernode` | 6 | 服务器节点管理 |
@@ -79,7 +79,7 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `wx_menu` | 3 | 微信公众号自定义菜单 |
 | `wx_mini_program` | 3 | 微信小程序 |
 | `wx_mp` | 7 | 微信公众号配置 |
-| `wx_tpl_msg` | 12 | 公众号/服务号模板消息，可选跳转小程序 |
+| `wx_tpl_msg` | 12 | 公众号/服务号模板消息，可选跳转小程序 |
 
 ## Fields
 
@@ -353,7 +353,7 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 
 ### `diy_qiwei_app` - 企业微信应用
 
-字段数：13
+字段数：13
 
 | 字段 | 标签 | 类型 | 控件 | 说明 |
 |---|---|---|---|---|
@@ -573,21 +573,21 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `Type` | 类型 | `varchar(50)` | `Radio` | 类型 |
 | `MqttClientId` | MqttClientId | `varchar(36)` | `Guid` | MqttClientId |
 
-### `mic_ai` - AI模型管理
-
-字段数：20
-
-| 字段 | 标签 | 类型 | 控件 | 说明 |
-|---|---|---|---|---|
-| `EnableVectorDatabase` | 是否启用向量数据库 | `int` | `Switch` | 默认0；缺失、空值或0时仅使用Schema关键词索引，且不连接、初始化、同步或搜索Embedding/Ollama/Qdrant。 |
-| `EmbeddingApiUrl` | EmbeddingApiUrl | `varchar(50)` | `Text` | 仅启用向量数据库时使用；示例：http://embedding-host:11434/v1/embeddings |
-| `QdrantHost` | QdrantHost | `varchar(50)` | `Text` | 仅启用向量数据库时使用；示例：qdrant-host |
-| `QdrantPort` | QdrantPort | `varchar(50)` | `Text` | 仅启用向量数据库时使用；示例：6333 |
-| `QdrantApiKey` | QdrantApiKey | `varchar(50)` | `Text` | 仅服务端读取；未启用向量数据库时不得用于网络请求。 |
-| `TopTables` | TopTables | `int` | `NumberText` | 使用前N张授权相关表的准确字段生成Schema Prompt。 |
-| `VectorTopK` | VectorTopK | `int` | `NumberText` | 启用向量数据库时，向量通道返回的候选表数量。 |
-| `VectorScoreThreshold` | VectorScoreThreshold | `decimal(18, 2)` | `NumberText` | 启用向量数据库时的相似度阈值（0-1，越小越宽松，建议0.3-0.5）。 |
-| `AiTimeout` | AiTimeout | `int` | `NumberText` | AI响应超时秒数；按实际模型延迟设置，本地高延迟模型通常需要更长超时。 |
+### `mic_ai` - AI模型管理
+
+字段数：20
+
+| 字段 | 标签 | 类型 | 控件 | 说明 |
+|---|---|---|---|---|
+| `EnableVectorDatabase` | 是否启用向量数据库 | `int` | `Switch` | 默认0；缺失、空值或0时仅使用Schema关键词索引，且不连接、初始化、同步或搜索Embedding/Ollama/Qdrant。 |
+| `EmbeddingApiUrl` | EmbeddingApiUrl | `varchar(50)` | `Text` | 仅启用向量数据库时使用；示例：http://embedding-host:11434/v1/embeddings |
+| `QdrantHost` | QdrantHost | `varchar(50)` | `Text` | 仅启用向量数据库时使用；示例：qdrant-host |
+| `QdrantPort` | QdrantPort | `varchar(50)` | `Text` | 仅启用向量数据库时使用；示例：6333 |
+| `QdrantApiKey` | QdrantApiKey | `varchar(50)` | `Text` | 仅服务端读取；未启用向量数据库时不得用于网络请求。 |
+| `TopTables` | TopTables | `int` | `NumberText` | 使用前N张授权相关表的准确字段生成Schema Prompt。 |
+| `VectorTopK` | VectorTopK | `int` | `NumberText` | 启用向量数据库时，向量通道返回的候选表数量。 |
+| `VectorScoreThreshold` | VectorScoreThreshold | `decimal(18, 2)` | `NumberText` | 启用向量数据库时的相似度阈值（0-1，越小越宽松，建议0.3-0.5）。 |
+| `AiTimeout` | AiTimeout | `int` | `NumberText` | AI响应超时秒数；按实际模型延迟设置，本地高延迟模型通常需要更长超时。 |
 | `StreamDelay` | StreamDelay | `int` | `NumberText` | 流式输出每个字符延迟毫秒数（5=很快，10=适中，20=慢） |
 | `NL2SQLPrompt` | NL2SQLPrompt | `mediumtext` | `Textarea` | NL2SQLPrompt |
 | `Remark` | 备注 | `mediumtext` | `Textarea` | 备注 |
@@ -683,20 +683,20 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `IsSuccess` | 是否成功 | `bit` | `Switch` | 是否成功 |
 | `MsgContent` | 消息内容 | `mediumtext` | `Textarea` | 消息内容 |
 | `Receivers` | 接收人 | `mediumtext` | `Textarea` | 接收人 |
-| `MsgEventId` | 消息设置Id | `varchar(36)` | `Guid` | 关联 mic_msgset |
-| `MsgResult` | 消息结果 | `mediumtext` | `Textarea` | 消息结果 |
-| `EventId` | 事件Id | `varchar(100)` | `Text` | 调用方稳定幂等键 |
-| `ChannelType` | 通知方式 | `varchar(50)` | `Select` | 微信公众号模板消息、短信、邮件或平台内部 |
-| `ReceiverUserId` | 接收用户Id | `varchar(36)` | `Guid` | 单个接收用户，用于安全查询和唯一约束 |
-| `Title` | 通知标题 | `varchar(200)` | `Text` | 发送时标题快照 |
-| `LinkUrl` | 跳转链接 | `varchar(500)` | `Text` | 站内或 HTTP/HTTPS 安全链接 |
-| `Payload` | 扩展数据 | `mediumtext` | `Textarea` | 经过裁剪的 JSON 快照 |
-| `IsRead` | 是否已读 | `int` | `Switch` | 平台内部通知已读状态 |
-| `ReadTime` | 阅读时间 | `varchar(25)` | `DateTime` | 标记已读时间 |
+| `MsgEventId` | 消息设置Id | `varchar(36)` | `Guid` | 关联 mic_msgset |
+| `MsgResult` | 消息结果 | `mediumtext` | `Textarea` | 消息结果 |
+| `EventId` | 事件Id | `varchar(100)` | `Text` | 调用方稳定幂等键 |
+| `ChannelType` | 通知方式 | `varchar(50)` | `Select` | 微信公众号模板消息、短信、邮件或平台内部 |
+| `ReceiverUserId` | 接收用户Id | `varchar(36)` | `Guid` | 单个接收用户，用于安全查询和唯一约束 |
+| `Title` | 通知标题 | `varchar(200)` | `Text` | 发送时标题快照 |
+| `LinkUrl` | 跳转链接 | `varchar(500)` | `Text` | 站内或 HTTP/HTTPS 安全链接 |
+| `Payload` | 扩展数据 | `mediumtext` | `Textarea` | 经过裁剪的 JSON 快照 |
+| `IsRead` | 是否已读 | `int` | `Switch` | 平台内部通知已读状态 |
+| `ReadTime` | 阅读时间 | `varchar(25)` | `DateTime` | 标记已读时间 |
 
 ### `mic_msgset` - 消息通知设置
 
-字段数：11
+字段数：11
 
 | 字段 | 标签 | 类型 | 控件 | 说明 |
 |---|---|---|---|---|
@@ -709,8 +709,8 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `Title` | 通知标题 | `varchar(50)` | `Text` | 通知标题 |
 | `Type` | 通知方式 | `mediumtext` | `Checkbox` | 通知方式 |
 | `TableChild99` |  | `` | `TableChild` |  |
-| `ReceiversRoles` | 接收角色 | `mediumtext` | `MultipleSelect` | 接收角色 |
-| `ChannelApiEngineMap` | 渠道适配器映射 | `mediumtext` | `Textarea` | 短信、邮件或自定义渠道到接口引擎 Key 的 JSON 映射 |
+| `ReceiversRoles` | 接收角色 | `mediumtext` | `MultipleSelect` | 接收角色 |
+| `ChannelApiEngineMap` | 渠道适配器映射 | `mediumtext` | `Textarea` | 短信、邮件或自定义渠道到接口引擎 Key 的 JSON 映射 |
 
 ### `mic_page` - 界面引擎
 
@@ -1078,11 +1078,11 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `SelectFields` | 查询列 | `mediumtext` | `JsonTable` | 指定select哪些列，不指定则是select * |
 | `SortFieldIds` | 可排序字段 | `mediumtext` | `MultipleSelect` | 可排序字段 |
 | `DelCodeShowV8` | [删除]按钮显示条件 | `mediumtext` | `CodeEditor` | [删除]按钮显示条件 |
-| `DiyConfig` | 已废弃 | `mediumtext` | `CodeEditor` | 仅兼容历史数据，禁止写入新配置 |
-| `EnableViewSchema` | 启用跨端视图 | `int` | `Switch` | 1 表示启用 `ViewSchema` |
-| `ViewSchemaVersion` | 视图协议版本 | `varchar(25)` | `Text` | 当前协议语义版本 |
-| `ViewConfigVersion` | 视图配置版本 | `int` | `NumberText` | 每次发布配置时递增 |
-| `ViewSchema` | 模块展示设计器 | `mediumtext` | `DevComponent` | 可视化配置 List/Card，保存 Detail/Edit/List/Card 版本化 JSON |
+| `DiyConfig` | 已废弃 | `mediumtext` | `CodeEditor` | 仅兼容历史数据，禁止写入新配置 |
+| `EnableViewSchema` | 启用跨端视图 | `int` | `Switch` | 1 表示启用 `ViewSchema` |
+| `ViewSchemaVersion` | 视图协议版本 | `varchar(25)` | `Text` | 当前协议语义版本 |
+| `ViewConfigVersion` | 视图配置版本 | `int` | `NumberText` | 每次发布配置时递增 |
+| `ViewSchema` | 模块展示设计器 | `mediumtext` | `DevComponent` | 可视化配置 List/Card，保存 Detail/Edit/List/Card 版本化 JSON |
 | `Url` | Url地址 | `varchar(500)` | `Text` | Url地址 |
 | `IconClass` | 图标 | `varchar(500)` | `FontAwesome` | 图标 |
 | `EditCodeShowV8` | [编辑]按钮显示条件 | `mediumtext` | `CodeEditor` | [编辑]按钮显示条件 |
@@ -1198,17 +1198,17 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 
 ### `sys_osclients` - OsClients
 
-字段数：98
-
-| 字段 | 标签 | 类型 | 控件 | 说明 |
-|---|---|---|---|---|
-| `DisableFileUpload` | 关闭文件上传 | `int` | `Switch` | 默认关闭且允许上传；只有 `1/true` 才禁止当前租户交互式上传。旧 `FileUploadEnabled` 仅作未升级节点兼容并在新版表单隐藏。 |
-| `FileUploadMaxFileMB` | 单文件上限MB | `int` | `NumberText` | 租户业务值；留空依次使用环境变量、appsettings、代码默认值，最终受独立 Absolute/HTTP 上限保护。 |
-| `FileUploadMaxRequestMB` | 单次总量上限MB | `int` | `NumberText` | 租户一次上传全部文件的业务合计；留空按回退链取值，最终受独立 Absolute/HTTP 上限保护。 |
-| `FileUploadMaxCount` | 单次文件数上限 | `int` | `NumberText` | 租户业务值；必须为正整数，留空按回退链取值，最终受 AbsoluteMaxFileCount 保护。 |
-| `FileUploadDailyUserQuotaMB` | 账号日额度MB | `int` | `NumberText` | 留空使用平台默认额度；按 UTC 日期、当前租户和账号在共享 Redis 原子统计。 |
-| `FileUploadDailyTenantQuotaMB` | 租户日额度MB | `int` | `NumberText` | 留空使用平台默认额度；按 UTC 日期和当前租户在共享 Redis 原子统计。 |
-| `MqttEnable` | 启用MQTT | `int` | `Switch` | 注意只有主库对应的SaaS引擎这一条数据MQTT配置的【MQTT端口】才有效果，其它租户SaaS引擎中的MQTT配置中【启用MQTT、用户名、密码、接口引擎】有效。 |
+字段数：98
+
+| 字段 | 标签 | 类型 | 控件 | 说明 |
+|---|---|---|---|---|
+| `DisableFileUpload` | 关闭文件上传 | `int` | `Switch` | 默认关闭且允许上传；只有 `1/true` 才禁止当前租户交互式上传。旧 `FileUploadEnabled` 仅作未升级节点兼容并在新版表单隐藏。 |
+| `FileUploadMaxFileMB` | 单文件上限MB | `int` | `NumberText` | 租户业务值；留空依次使用环境变量、appsettings、代码默认值，最终受独立 Absolute/HTTP 上限保护。 |
+| `FileUploadMaxRequestMB` | 单次总量上限MB | `int` | `NumberText` | 租户一次上传全部文件的业务合计；留空按回退链取值，最终受独立 Absolute/HTTP 上限保护。 |
+| `FileUploadMaxCount` | 单次文件数上限 | `int` | `NumberText` | 租户业务值；必须为正整数，留空按回退链取值，最终受 AbsoluteMaxFileCount 保护。 |
+| `FileUploadDailyUserQuotaMB` | 账号日额度MB | `int` | `NumberText` | 留空使用平台默认额度；按 UTC 日期、当前租户和账号在共享 Redis 原子统计。 |
+| `FileUploadDailyTenantQuotaMB` | 租户日额度MB | `int` | `NumberText` | 留空使用平台默认额度；按 UTC 日期和当前租户在共享 Redis 原子统计。 |
+| `MqttEnable` | 启用MQTT | `int` | `Switch` | 注意只有主库对应的SaaS引擎这一条数据MQTT配置的【MQTT端口】才有效果，其它租户SaaS引擎中的MQTT配置中【启用MQTT、用户名、密码、接口引擎】有效。 |
 | `MqttApiEngine` | 接口引擎 | `varchar(100)` | `Select` | 服务器端启动时、客户端连接时/发送消息时/断开连接时均触发。EventName：StartServer、Connected、Disconnected、MessageReceived、StopServer |
 | `MqttPort` | MQTT端口 | `int` | `NumberText` | 默认1883，注意api的编排ports参数必须添加对应的如- "1883:1883"。<br>注意只有主库对应的SaaS引擎这一条数据MQTT配置的【MQTT端口】才有效果，其它租户SaaS引擎中的MQTT配置中【启用MQTT、用户名、密码、接口引擎】有效。 |
 | `MqttAccount` | 用户名 | `varchar(50)` | `Text` | 用户名 |
@@ -1248,12 +1248,12 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `OsClientType` | OsClientType | `varchar(50)` | `Text` | SaaS引擎软件环境，自定义值，示例：Product（正式环境））、Dev（测试环境）、WZ（外帐） |
 | `TencentAppId` | TencentAppId | `varchar(50)` | `Text` | TencentAppId |
 | `DbVersion` | 数据库版本 | `varchar(50)` | `Text` | 如：12c、11g |
-| `OsClient` | OsClient | `varchar(50)` | `Text` | SaaS引擎Key，自定义值，建议全小写字母。示例：tenant_a、tenant_demo、demo01 |
+| `OsClient` | OsClient | `varchar(50)` | `Text` | SaaS引擎Key，自定义值，建议全小写字母。示例：tenant_a、tenant_demo、demo01 |
 | `AliOssPrivateAccessKeyId` | 阿里云私有桶Key | `varchar(50)` | `Text` | 阿里云私有桶Key |
 | `ClientSecrets` | Token密钥 | `varchar(50)` | `Text` | 废弃字段 |
 | `MQVitrualHost` | VitrualHost | `varchar(50)` | `Text` | VitrualHost |
 | `DbReadConn` | 数据库连接字符串（读） | `varchar(500)` | `Text` | 为空则取DbConn |
-| `CorsAllowOrigins` | 跨域配置 | `mediumtext` | `Textarea` | 主租户此字段为空时默认允许任意来源；填写后按精确来源或通配符收紧，`CorsAllowAnyWhenUnconfigured` 可调整未配置时的兼容行为。示例：http://localhost:2009;https://os.itdos.com;https://*.microi.net。CORS 不是鉴权边界。 |
+| `CorsAllowOrigins` | 跨域配置 | `mediumtext` | `Textarea` | 主租户此字段为空时默认允许任意来源；填写后按精确来源或通配符收紧，`CorsAllowAnyWhenUnconfigured` 可调整未配置时的兼容行为。示例：http://localhost:2009;https://os.itdos.com;https://*.microi.net。CORS 不是鉴权边界。 |
 | `SessionAuthTimeout` | Token过期时间（PC） | `varchar(50)` | `Text` | 单位：分钟，默认20分钟 |
 | `MQUserName` | 用户名 | `varchar(50)` | `Text` | 用户名 |
 | `DomainName` | 域名 | `mediumtext` | `Text` | 多个域名使用英文分号分割，移动端建议使用m-开头。 |
@@ -1579,9 +1579,9 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `AppSecret` | AppSecret | `varchar(255)` | `Text` | AppSecret |
 | `AppId` | AppId | `varchar(50)` | `Text` | AppId |
 
-### `wx_tpl_msg` - 公众号/服务号模板消息
+### `wx_tpl_msg` - 公众号/服务号模板消息
 
-字段数：12
+字段数：12
 
 | 字段 | 标签 | 类型 | 控件 | 说明 |
 |---|---|---|---|---|
@@ -1594,6 +1594,6 @@ Generic reference catalog. Load it only to understand common platform tables; ne
 | `Remark` | 备注 | `mediumtext` | `Textarea` | 备注 |
 | `TemplateId` | 模板ID | `varchar(50)` | `Text` | 模板ID |
 | `MiniProgramPagePath` | 小程序页面 | `varchar(50)` | `Text` | 小程序页面 |
-| `MiniProgramId` | 小程序Id | `varchar(36)` | `Guid` | 小程序Id |
-| `WxMpName` | 公众号/服务号 | `varchar(100)` | `Select` | 发送模板消息的公众号或服务号 |
-| `WxMpId` | 公众号/服务号Id | `varchar(36)` | `Guid` | 关联 wx_mp；与小程序跳转配置分离 |
+| `MiniProgramId` | 小程序Id | `varchar(36)` | `Guid` | 小程序Id |
+| `WxMpName` | 公众号/服务号 | `varchar(100)` | `Select` | 发送模板消息的公众号或服务号 |
+| `WxMpId` | 公众号/服务号Id | `varchar(36)` | `Guid` | 关联 wx_mp；与小程序跳转配置分离 |

package/skills/microi-deployment/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: microi-deployment
-description: Microi 安装、部署、升级和本地运行指南。用于 Docker Compose、离线安装、Windows IIS、源码运行、本地 ApiBase/OsClient 切换与浏览器隔离、MySQL、Redis、MongoDB、MinIO、反向代理、滚动发布、健康检查、备份恢复和生产部署验收。
+description: Microi 安装、部署、升级和本地运行指南。用于吾码服务器运维面板 Microi.Panel、Docker Compose、离线安装、Windows IIS、源码运行、本地 ApiBase/OsClient 切换与浏览器隔离、数据库、MinIO、反向代理、滚动发布、健康检查、备份恢复和生产部署验收。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
@@ -22,6 +22,23 @@ description: Microi 安装、部署、升级和本地运行指南。用于 Docke
 
 ## 先确认部署类型
 
+### 吾码服务器运维面板 Microi.Panel
+
+- 项目由 `Microi.Ops` 更名为 `Microi.Panel`；独立 .NET + Vue + Microi.UI 宿主使用自己的管理员账号、SQLite 和 Docker 权限，业务 API/Web 停止时仍可操作。只安装面板时使用 `install-microi-panel.sh`，不要求先安装吾码业务平台、宝塔或 1Panel。具体命令与能力边界见中文官网 `server-panel/overview.md`。
+- 先确认主机内存、Docker Engine 身份、活动任务、已有 Ops/Panel 控制器、端口、编排和数据目录。每台 Docker 主机只运行一个吾码控制器。与宝塔/1Panel 共存时使用独立安装目录、容器名、卷、网络和端口；80/443 等监听端口不能被两个入口同时占用，不得重置 Docker 或接管第三方面板资源。
+- 插件市场只安装目录内明确版本与 SHA-256 的镜像；检查架构、许可、健康检查、持久卷和真实业务读写。Oracle 等原厂许可渠道不擅自镜像；MinIO 社区归档后的源码构建必须保留对应源码、许可与摘要。跨数据库大版本升级仍需专用迁移方案。
+- 网站和反向代理由受管 Docker Nginx 执行；配置先 `nginx -t`，再原子发布与回读。HTTP-01 需真实 DNS 和公网 80 端口的挑战路由，不能用跳过验证冒充签发成功；通配符使用外部 DNS 验证后导入证书。证书续期必须验证新的序列号/指纹、服务重启后的调度和暂停行为。
+- 网站文件仅管理受管卷；文本编辑使用内容哈希拒绝覆盖并发修改。冷备份须明确服务中断，检查正常退出与归档哈希；恢复写入新卷并保留原卷，重试继续原操作 Id。卸载保留业务卷，重新安装沿用记录的原镜像、凭据和数据卷。
+- 新面板默认独立 HTTPS 端口 61890，管理员密码与 PFX 密码存于服务器权限受限文件；不要把它们复制进业务 SaaS、V8、MCP 参数或日志。旧 Ops 保留原 `OPS_*`、目录、账号、端口、数据保护密钥及 `MicroiOpsUrl`，用原 Compose 替换为 Panel 镜像，不能重新初始化。
+- 业务 MCP 继续通过 `microi_get_administrative_capabilities`、`microi_admin_table_data`、`microi_update_module` 和应用发布工具维护平台入口；DiyToken 不授予主机 Docker 权限，不增加能从租户会话执行任意宿主机命令的工具。主机安装与恢复使用授权的 SSH/终端和独立面板会话。
+- 真实验收归入 `Microi.Tests/Panel` 专项，包含全部目录版本、数据库/对象存储写读与冷恢复、SSL/续期、文件、任务重启、独立安装升级回退，以及真实宝塔/1Panel 两种安装顺序。普通外部容器只能证明资源归属保护，不能替代第三方面板共存结论。
+
+### 依赖镜像统一镜像源
+
+- 安装器、Dockerfile、发布与测试夹具的依赖镜像统一使用 `Microi一键编译发布配置.json` 中 Region/Namespace 对应的阿里云仓库。源镜像清单维护在 `Microi.Server/tools/dependency-images.json`，禁止客户每次安装直接拉 Docker Hub/MCR。
+- 联网发行机执行 `Microi一键编译发布.sh --mirror-dependencies`，由 `dependency-images.mjs` 读取同一配置的账号密码并用 stdin 登录；禁止将凭据写进命令、日志、镜像或仓库。完成后用 `verify` 回读摘要和多架构清单。
+- 上游固定 SHA-256；国内加速只能作为传输通道，不能修改版本、替换不明镜像或丢失 CPU 架构。上游和阿里云目标摘要不一致立即停止。Oracle/达梦/金仓等受许可限制的镜像只在具备再分发权后镜像，不用无授权镜像代替。
+
 用户明确要求同版本仅发布 Docker 热修复时，运行 `Microi一键编译发布.sh --docker-only-hotfix` 并选择后端镜像方案。该入口保持当前版本，禁止 NuGet、文档和官方资源数据库发布，同时保留 Full、候选源码一致性、混淆后冒烟和镜像门禁。修复应进入本地源码及捆绑资源，由目标程序启动升级；不得通过直接改生产表结构代替源码修复。
 
 | 场景 | 推荐入口 |