@microi.net/cli 5.5.9 → 5.6.0

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

@@ -1,6 +1,6 @@
 ---
 name: v8-table-event
-description: Microi V8 表单事件开发。用于编写 InFormV8、SubmitFormV8、SubmitBeforeServerV8、SubmitAfterServerV8、OutFormV8、DataFilterV8 和事务感知事件。
+description: Microi V8 表单事件开发。用于编写 InFormV8、SubmitFormV8、SubmitBeforeServerV8、SubmitAfterServerV8、OutFormV8、DataFilterV8 和事务感知事件。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
@@ -13,29 +13,29 @@ description: Microi V8 表单事件开发。用于编写 InFormV8、SubmitFormV8
 <!-- microi-progressive:chunk id=v8-table-event-000 sha256=dd86294c8cf42f580b2eb806d981c239c0efc2934505c0716e804de2f8a9235c -->
 ## 本地优先与版本头（必做）
 
-AI 本地开发表单 V8 事件时，优先修改 `microi-v8-engine/<租户>/<项目>/表单引擎/.../<事件Label>（<EventType>）.js` 本地文件，再通过 MCP 或 VS Code 插件同步到数据库。文件中文名必须取 `diy_table` 对应 `diy_field.Label`，其中 `SubmitFormV8` 为 `前端表单提交前V8事件（SubmitFormV8）.js`，`OutFormV8` 为 `前端表单提交后V8事件（OutFormV8）.js`。若插件显示“本地和远端不一致”，先读取本地与远端并合并有效差异，不能直接覆盖。
+AI 本地开发表单 V8 事件时，优先修改 `microi-v8-engine/<租户>/<项目>/表单引擎/.../<事件Label>（<EventType>）.js` 本地文件，再通过 MCP 或 VS Code 插件同步到数据库。文件中文名必须取 `diy_table` 对应 `diy_field.Label`，其中 `SubmitFormV8` 为 `前端表单提交前V8事件（SubmitFormV8）.js`，`OutFormV8` 为 `前端表单提交后V8事件（OutFormV8）.js`。若插件显示“本地和远端不一致”，先读取本地与远端并合并有效差异，不能直接覆盖。
 
 每一次修改、上传、推送 `InFormV8.js`、`SubmitFormV8.js`、`SubmitBeforeServerV8.js`、`SubmitAfterServerV8.js`、`OutFormV8.js`、`DataFilterV8.js` 等事件文件，都必须维护顶部版本区域。版本号从 `v1.0.0` 开始；每次上传/推送/修改递增 1；补丁位和次版本位最大为 9 并向前进位（`v1.0.9 -> v1.1.0`、`v1.9.9 -> v2.0.0`、`v9.9.9 -> v10.0.0`）。代码头只写完整功能说明，不写修改历史、时间戳或 ChangeLog。
 
 ```javascript
 /*
  * V8 Event
- * TableKey: 示例表Key
+ * TableKey: 示例表Key
  * EventType: SubmitBeforeServerV8
  * Version: v1.0.0
- * 功能说明：
+ * 功能说明：
  * - 完整说明该事件的触发时机、校验/加工逻辑、读写字段和阻止提交条件。
  */
 ```
 
-同步流程：`读取远端 -> 修改本地并递增语义版本头 -> JS 语法检查 -> 保存远端 -> 回读远端确认版本头一致 -> 查询 mic_data_version 确认形成新版本 -> 执行触发该事件的最小表单操作验证`。表单设计器保存和 MCP 保存共用服务端代码版本链路；只有代码真实变化才新增版本，普通布局/字段属性保存不得产生代码版本。修改记录不得写进事件代码头。
-
-使用 MCP 时，先调用 `microi_list_events` 发现事件，再用
-`microi_get_event_code` 读取目标源码；修改后通过 `microi_save_event_code`
-保存并回读。不要把接口引擎的保存工具用于表单事件，也不要在未读取远端
-版本时直接覆盖。
-
-生成 V8 事件代码时，代码内容本身（文件头、普通注释、`console.log`、返回 `Msg` 等）不要包含 `Microi`、`吾码` 等平台品牌文字，除非业务数据或字段值本身必须如此。生成代码要有可维护注释：每个 `function` 前写清用途、关键参数和返回值；提交前校验、提交后联动、字段显隐、数据脱敏、跨表写入、复杂条件判断等代码段前写短注释说明业务原因；避免“给变量赋值”这类无信息量注释。
+同步流程：`读取远端 -> 修改本地并递增语义版本头 -> JS 语法检查 -> 保存远端 -> 回读远端确认版本头一致 -> 查询 mic_data_version 确认形成新版本 -> 执行触发该事件的最小表单操作验证`。表单设计器保存和 MCP 保存共用服务端代码版本链路；只有代码真实变化才新增版本，普通布局/字段属性保存不得产生代码版本。修改记录不得写进事件代码头。
+
+使用 MCP 时，先调用 `microi_list_events` 发现事件，再用
+`microi_get_event_code` 读取目标源码；修改后通过 `microi_save_event_code`
+保存并回读。不要把接口引擎的保存工具用于表单事件，也不要在未读取远端
+版本时直接覆盖。
+
+生成 V8 事件代码时，代码内容本身（文件头、普通注释、`console.log`、返回 `Msg` 等）不要包含 `Microi`、`吾码` 等平台品牌文字，除非业务数据或字段值本身必须如此。生成代码要有可维护注释：每个 `function` 前写清用途、关键参数和返回值；提交前校验、提交后联动、字段显隐、数据脱敏、跨表写入、复杂条件判断等代码段前写短注释说明业务原因；避免“给变量赋值”这类无信息量注释。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-table-event-001 sha256=7bad55ca6781e6ca458a0333a47c71a3bad30334d146e940496c45c4ffa7ddf5 -->
@@ -57,8 +57,8 @@ AI 本地开发表单 V8 事件时，优先修改 `microi-v8-engine/<租户>/<
 - 后端 V8 事件 / 接口引擎中调用 `V8.FormEngine` 增删改 → **不触发**表单 V8 事件
 - 传入 `_InvokeType: 'Client'` → **触发**表单 V8 事件
 - Postman 等直接调用接口 → 前端事件**不执行**，后端事件**仍执行**
-- 服务器端提交前/后 V8 事件在**同一事务**中执行
-- `diy_table.V8Limit` 是表后端提交前、提交后和数据处理 V8 的正向开关：缺失、`null`、`0/false` 均不设置 Jint 单次超时、语句、函数递归和累计分配预算，只有 `1/true` 才启用这些限制。旧 `V8Unlimited` 仅在新字段不存在时反向推断，新的 MCP、Manifest 和应用资源只写 `V8Limit`。进程常驻内存、取消、并发、接口嵌套深度、权限和数据库保护始终生效。
+- 服务器端提交前/后 V8 事件在**同一事务**中执行
+- `diy_table.V8Limit` 是表后端提交前、提交后和数据处理 V8 的正向开关：缺失、`null`、`0/false` 均不设置 Jint 单次超时、语句、函数递归和累计分配预算，只有 `1/true` 才启用这些限制。旧 `V8Unlimited` 仅在新字段不存在时反向推断，新的 MCP、Manifest 和应用资源只写 `V8Limit`。进程常驻内存、取消、并发、接口嵌套深度、权限和数据库保护始终生效。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-table-event-003 sha256=65a1e728982d4e534d06dc2440eac111fe53a08f0a3012c6a9f8b1de45b4b81f -->
@@ -75,7 +75,7 @@ if (V8.LoadMode === 'Design') return;
 
 - ❌ **禁止** 在 `SubmitFormV8.js` 中调 `V8.FormSubmit()` —— 无限递归
 - ❌ **禁止** 在 `FieldValueChange` 中 `V8.FormSet(同字段, ...)` —— 循环触发
-- ❌ **禁止** 在后端提交前/后事件中再次写当前表；即使默认 Server 调用不递归，也可能覆盖本次增量数据、引发死锁或重复副作用。确需跨表联动时使用同一 `V8.DbTrans`，且不要传 `_InvokeType:'Client'`
+- ❌ **禁止** 在后端提交前/后事件中再次写当前表；即使默认 Server 调用不递归，也可能覆盖本次增量数据、引发死锁或重复副作用。确需跨表联动时使用同一 `V8.DbTrans`，且不要传 `_InvokeType:'Client'`
 
 ### 3. 阻止提交（后端）
 
@@ -108,8 +108,8 @@ V8.ApiEngine.Run('other-engine', { Form: V8.Form }, V8.DbTrans);
 ## 前端事件特有 API
 
 ```javascript
-// 普通 diy-form 中设置字段值（触发目标字段值变更事件）
-// diy-table 列表上下文只更新当前行和模板，不递归触发目标字段 V8
+// 普通 diy-form 中设置字段值（触发目标字段值变更事件）
+// diy-table 列表上下文只更新当前行和模板，不递归触发目标字段 V8
 V8.FormSet('FieldName', 'value');
 V8.FormSet('DropdownField', { Id: 1, Name: '选项' }); // 下拉框
 
@@ -127,9 +127,9 @@ var isReadonly = V8.Field.UserName.Readonly;
 V8.Tips('操作成功', true);    // 成功提示（1秒消失）
 V8.Tips('操作失败', false);   // 错误提示（5秒消失）
 
-// 确认框
-V8.ConfirmTips('确定删除？', function() { /* 确定 */ }, function() { /* 取消 */ });
-// content 使用 HTML 模式渲染；只能传固定文案或已转义内容，复杂交互用 OpenAppDialog
+// 确认框
+V8.ConfirmTips('确定删除？', function() { /* 确定 */ }, function() { /* 取消 */ });
+// content 使用 HTML 模式渲染；只能传固定文案或已转义内容，复杂交互用 OpenAppDialog
 
 // 前端 HTTP 请求
 V8.Post('/api/xxx', { key: 'value' }, function(res) { });

package/skills/v8-table-event/references/progressive-01-informv8-js-/350/241/250/345/215/225/346/211/223/345/274/200/344/272/213/344/273/266.md

@@ -104,13 +104,13 @@ if (V8.FormSubmitAction === 'Insert' || V8.FormSubmitAction === 'Update') {
 // 此时数据已成功写入数据库（仍在事务中）
 // 返回 { Code: 0 } 仍可回滚事务
 
-// 新增后：自动创建关联数据。保持默认 Server 调用，不触发目标表事件
-if (V8.FormSubmitAction === 'Insert') {
-  V8.FormEngine.AddFormData('UserProfile', {
-    UserId: V8.Form.Id,
-    NickName: V8.Form.Name
-  }, V8.DbTrans);
-}
+// 新增后：自动创建关联数据。保持默认 Server 调用，不触发目标表事件
+if (V8.FormSubmitAction === 'Insert') {
+  V8.FormEngine.AddFormData('UserProfile', {
+    UserId: V8.Form.Id,
+    NickName: V8.Form.Name
+  }, V8.DbTrans);
+}
 
 // 更新后：同步更新其它表的冗余字段
 if (V8.FormSubmitAction === 'Update') {
@@ -129,14 +129,14 @@ V8.ApiEngine.Run('send-notification', {
 }, V8.DbTrans);
 
 // 记录操作日志
-V8.Method.AddSysLog({
+V8.Method.AddSysLog({
   Title: V8.FormSubmitAction + ' ' + V8.TableModel.Name,
   Content: JSON.stringify({ Id: V8.Form.Id }),
   Type: '业务日志'
-});
-```
-
-`SubmitAfterServerV8` 的“After”仍是“写入后、提交前”。需要在事务真正提交后才发布的缓存版本、跨节点通知等副作用，不能直接在事件中执行。平台为 `microi_database` 提供专用 `V8.Method.RefreshExtensionDatabases()`：事件调用时只登记提交后回调，提交成功才递增当前租户共享 Redis 版本，回滚时自动丢弃。普通业务的外部消息仍优先使用同事务 outbox，不能把任意不可撤销副作用都塞进内存回调。
+});
+```
+
+`SubmitAfterServerV8` 的“After”仍是“写入后、提交前”。需要在事务真正提交后才发布的缓存版本、跨节点通知等副作用，不能直接在事件中执行。平台为 `microi_database` 提供专用 `V8.Method.RefreshExtensionDatabases()`：事件调用时只登记提交后回调，提交成功才递增当前租户共享 Redis 版本，回滚时自动丢弃。普通业务的外部消息仍优先使用同事务 outbox，不能把任意不可撤销副作用都塞进内存回调。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-table-event-009 sha256=d415302a8108d9e11755a046bdbffe0c84a135ec6ed0e6b1dc3fc128a8ef38b6 -->
@@ -182,20 +182,20 @@ if (V8.Form.Phone) {
 | 变量 | 说明 | 可用事件 |
 |------|------|---------|
 | `V8.Form` | 当前表单数据（新增时也有 Id） | 全部 |
-| `V8.OldForm` | 已加载的修改前旧数据 | 普通表单；提交前/后 |
+| `V8.OldForm` | 已加载的修改前旧数据 | 普通表单；提交前/后 |
 | `V8.FormMode` | `'Add'` / `'Edit'` / `'View'` | 全部 |
 | `V8.FormOutAction` | `'Insert'`/`'Update'`/`'Close'`/`'Delete'` | FormOut |
 | `V8.FormSubmitAction` | `'Insert'` / `'Update'` / `'Delete'` | SubmitBefore |
 | `V8.EventName` | 当前事件名 | 全部 |
 | `V8.CurrentUser` | 当前用户 | 全部 |
 | `V8.TableId` / `V8.TableName` | 当前表 Id / Name | 全部 |
-| `V8.SelectedData` / `V8.TableRowSelected` | 选中的行数组 | 列表/批量按钮 |
+| `V8.SelectedData` / `V8.TableRowSelected` | 选中的行数组 | 列表/批量按钮 |
 | `V8.CurrentTableData` | 当前表当页数据 | 全部 |
 | `V8.ClientType` | `'PC'`/`'IOS'`/`'Android'`/`'H5'`/`'WeChat'` | 全部 |
-| `V8.ThisValue` | 当前字段新值：可能是对象、原始值或行内 `{New,Old}` | FieldValueChange |
-| `V8.OldValue` | 当前字段旧值，仅行内编辑可靠 | 表格行内 FieldValueChange |
-| `V8.KeyCode` | 键盘事件的键码 | FieldOnKeyup |
-| `V8.Event` | 原生事件；键盘事件目前不提供 | FieldSlotButtonClick 等显式事件 |
+| `V8.ThisValue` | 当前字段新值：可能是对象、原始值或行内 `{New,Old}` | FieldValueChange |
+| `V8.OldValue` | 当前字段旧值，仅行内编辑可靠 | 表格行内 FieldValueChange |
+| `V8.KeyCode` | 键盘事件的键码 | FieldOnKeyup |
+| `V8.Event` | 原生事件；键盘事件目前不提供 | FieldSlotButtonClick 等显式事件 |
 | `V8.ParentV8` | 子表中访问父表 V8 对象 | 子表事件 |
 
 ### 后端事件

package/skills/v8-table-event/references/progressive-02-/345/211/215/347/253/257/344/272/213/344/273/266/345/220/215-v8-eventname-/345/217/257/350/203/275/347/232/204/345/200/274.md

@@ -11,9 +11,9 @@
 | `FormSubmitBefore` | 提交前事件 |
 | `FormOut` | 离开表单事件 |
 | `FieldValueChange` | 字段值变更事件 |
-| `FieldOnKeyup` | 文本框键盘事件 |
-| `TableFieldOnKeyup` | 表格行内文本框键盘事件 |
-| `FieldSlotButtonClick` | 单行文本插槽按钮点击事件 |
+| `FieldOnKeyup` | 文本框键盘事件 |
+| `TableFieldOnKeyup` | 表格行内文本框键盘事件 |
+| `FieldSlotButtonClick` | 单行文本插槽按钮点击事件 |
 | `V8BtnRun` | V8 按钮执行事件 |
 | `V8BtnLimit` | V8 按钮是否显示事件 |
 | `BtnFormDetailRun` | 详情按钮 V8 按钮 |
@@ -26,21 +26,21 @@
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-table-event-012 sha256=db5bf410bc6babf14d3d91cc61b9875c81bc1be24b2c1b7c62334bc6819e4e55 -->
-## 注意事项
+## 注意事项
 
 - 前端事件可使用 `window` 对象和 `async/await`，后端事件不可以
 - 后端提交前/后事件返回 `{ Code: 0, Msg: '...' }` 可阻止数据写入并回滚事务
 - 直接修改 `V8.Form` 的字段值即可改变最终写入的数据
-- 后端事件中使用 `V8.FormEngine` 默认是 Server 调用，不触发目标表事件；`_InvokeType:'Client'` 恰好会触发目标表事件，不能用于“避免递归”
-- `_InvokeType:'Server'` 只表达事件调用语义，不是客户端授权开关；浏览器伪造它不会获得受信任权限
+- 后端事件中使用 `V8.FormEngine` 默认是 Server 调用，不触发目标表事件；`_InvokeType:'Client'` 恰好会触发目标表事件，不能用于“避免递归”
+- `_InvokeType:'Server'` 只表达事件调用语义，不是客户端授权开关；浏览器伪造它不会获得受信任权限
 - `V8.FormSubmitAction` 的值是 `'Insert'`/`'Update'`/`'Delete'`（非 Add/Upt/Del）
-- 在 DataFilterV8 中使用 `V8.CacheData` 缓存查询结果，避免每行执行 N+1 查询
-- 表事件调用下游接口时，表级正向 `diy_table.V8Limit` 不会改变下游接口；下游接口独立读取正向 `sys_apiengine.V8Limit`（两者均默认 0 表示不限 Jint 单次预算，1 表示启用限制）
-
-### 复盘：提交后事件误把增量表单当作完整记录
-
-- 触发场景：插件、MCP 或后端只更新代码等少数字段时，`SubmitAfterServerV8` 直接对 `V8.Form.Id`、业务 Key 调用 `toLowerCase()`，保存动作因字段未出现在增量参数中而异常。
-- 根因：事件假设 `V8.Form` 始终包含整行数据，没有兼容稀疏更新（sparse patch）。
-- 通用规则：提交后事件使用非本次必传字段前，必须从 `V8.OldForm` 合并兜底，或凭已有 `Id` 回查当前记录；调用字符串方法前先显式 `String(...)` 并校验空值。写缓存时应缓存合并后的完整模型，不能用稀疏对象覆盖整行缓存。
-- 自动化检查：分别只更新一个普通字段、只更新大文本代码字段并执行一次完整表单保存；事件均不得报错，按 Id、唯一 Key 和可选地址回读缓存都应得到完整记录。
+- 在 DataFilterV8 中使用 `V8.CacheData` 缓存查询结果，避免每行执行 N+1 查询
+- 表事件调用下游接口时，表级正向 `diy_table.V8Limit` 不会改变下游接口；下游接口独立读取正向 `sys_apiengine.V8Limit`（两者均默认 0 表示不限 Jint 单次预算，1 表示启用限制）
+
+### 复盘：提交后事件误把增量表单当作完整记录
+
+- 触发场景：插件、MCP 或后端只更新代码等少数字段时，`SubmitAfterServerV8` 直接对 `V8.Form.Id`、业务 Key 调用 `toLowerCase()`，保存动作因字段未出现在增量参数中而异常。
+- 根因：事件假设 `V8.Form` 始终包含整行数据，没有兼容稀疏更新（sparse patch）。
+- 通用规则：提交后事件使用非本次必传字段前，必须从 `V8.OldForm` 合并兜底，或凭已有 `Id` 回查当前记录；调用字符串方法前先显式 `String(...)` 并校验空值。写缓存时应缓存合并后的完整模型，不能用稀疏对象覆盖整行缓存。
+- 自动化检查：分别只更新一个普通字段、只更新大文本代码字段并执行一次完整表单保存；事件均不得报错，按 Id、唯一 Key 和可选地址回读缓存都应得到完整记录。
 <!-- /microi-progressive:chunk -->

package/skills/v8-tcp-integration/SKILL.md

@@ -144,4 +144,4 @@ var hex = result.Data.Hex;
 - 测试：真实 Jint 注入、Byte/Base64/Hex/Text、回环收发、超时/上限/非法参数。
 - 编辑器：`Microi.Client/.../v8-api-server-definitions.js` 与 `Microi.VSCode/src/editor/typingsManager.ts`。
 - 文档与知识：官网中文后端 V8 页面、`microi.skills/README.md`、`v8-utilities` 索引、`Microi.AI/Resource` 镜像和向量资源列表。
-- 验收：目标测试、后端构建、精确重启与健康检查、独立 TCP 回环；真实打印机出纸必须单独报告，不能用回环测试替代。
+- 验收：目标测试、后端构建、精确重启与健康检查、独立 TCP 回环；真实打印机出纸必须单独报告，不能用回环测试替代。

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/v8-template-engine/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: v8-template-engine
-description: Microi V8 模板引擎指南。用于编写表格/表单模板渲染、V8.Result HTML/text 输出、行格式化、徽章、图片和自定义显示逻辑。
+description: Microi V8 模板引擎指南。用于编写表格/表单模板渲染、V8.Result HTML/text 输出、行格式化、徽章、图片和自定义显示逻辑。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
@@ -12,27 +12,27 @@ description: Microi V8 模板引擎指南。用于编写表格/表单模板渲
 ## 核心规则
 
 - 模板引擎绑定在【表单属性】的【表格 V8 模板引擎】或【表单 V8 模板引擎】
-- 通过给 `V8.Result` 赋值字符串（HTML 或纯文本）来控制最终渲染结果
-- 在 **表格模板** 中：每行数据都会执行一次，`V8.Form` 是当前行数据
-- 注意：`V8.Form` 此时只能访问到【模块引擎】配置的【查询列】字段；若查询列为空则可访问全部字段
-- 支持 `bootstrap`、`element-ui` 样式类名
-- `V8.EventName` 可能为 `TableTemplateEngine` 或 `FormTemplateEngine`
-- 表格模板同步执行，输出优先级是 `V8.Result` → JavaScript `return` → 原字段值；表单模板异步执行并以 `V8.Result` 为输出
-- 模板结果通过 `v-safe-html`/DOMPurify 净化。`script`、`iframe`、`on*` 事件属性、`javascript:` 等危险内容会被剥离，禁止依赖内联点击事件
-- 业务文本必须 HTML 转义后再拼接；权限、校验、状态写入等业务逻辑必须放后端
-
-模板中需要拼 HTML 时，先定义安全转义函数：
-
-```javascript
-var escapeHtml = function (value) {
-  return String(value == null ? '' : value)
-    .replace(/&/g, '&')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&#39;');
-};
-```
+- 通过给 `V8.Result` 赋值字符串（HTML 或纯文本）来控制最终渲染结果
+- 在 **表格模板** 中：每行数据都会执行一次，`V8.Form` 是当前行数据
+- 注意：`V8.Form` 此时只能访问到【模块引擎】配置的【查询列】字段；若查询列为空则可访问全部字段
+- 支持 `bootstrap`、`element-ui` 样式类名
+- `V8.EventName` 可能为 `TableTemplateEngine` 或 `FormTemplateEngine`
+- 表格模板同步执行，输出优先级是 `V8.Result` → JavaScript `return` → 原字段值；表单模板异步执行并以 `V8.Result` 为输出
+- 模板结果通过 `v-safe-html`/DOMPurify 净化。`script`、`iframe`、`on*` 事件属性、`javascript:` 等危险内容会被剥离，禁止依赖内联点击事件
+- 业务文本必须 HTML 转义后再拼接；权限、校验、状态写入等业务逻辑必须放后端
+
+模板中需要拼 HTML 时，先定义安全转义函数：
+
+```javascript
+var escapeHtml = function (value) {
+  return String(value == null ? '' : value)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+};
+```
 
 ## 状态徽章（Bootstrap 样式）
 
@@ -46,7 +46,7 @@ if (V8.IsNull(value)) {
   else if (value === '未通过') classStr = 'badge-warning';
   else if (value === '待审核') classStr = 'badge-info';
   else if (value === '通过')   classStr = 'badge-success';
-  V8.Result = '<span class="badge badge-pill ' + classStr + '">' + escapeHtml(value) + '</span>';
+  V8.Result = '<span class="badge badge-pill ' + classStr + '">' + escapeHtml(value) + '</span>';
 }
 ```
 
@@ -57,12 +57,12 @@ if (V8.IsNull(value)) {
 ```javascript
 // 不同业务状态显示不同字体颜色
 if (V8.Form.XuqiuLX === '合并') {
-  V8.Result = '<span style="color:blue;">' + escapeHtml(V8.Form.XuqiuDDH) + '</span>';
-} else if (V8.Form.HebingID) {
-  V8.Result = '<span style="color:#999;">' + escapeHtml(V8.Form.XuqiuDDH) + '</span>';
-} else {
-  V8.Result = escapeHtml(V8.Form.XuqiuDDH);
-}
+  V8.Result = '<span style="color:blue;">' + escapeHtml(V8.Form.XuqiuDDH) + '</span>';
+} else if (V8.Form.HebingID) {
+  V8.Result = '<span style="color:#999;">' + escapeHtml(V8.Form.XuqiuDDH) + '</span>';
+} else {
+  V8.Result = escapeHtml(V8.Form.XuqiuDDH);
+}
 ```
 
 ## 单图列渲染
@@ -70,11 +70,11 @@ if (V8.Form.XuqiuLX === '合并') {
 ```javascript
 var html = '';
 var fileServer = V8.SysConfig.FileServer;
-if (!V8.IsNull(V8.Form.GongsiLOGO)) {
-  html = '<img src="' + escapeHtml(fileServer + V8.Form.GongsiLOGO) + '" '
-       + 'alt="公司Logo" '
-       + 'style="height:40px;width:40px;object-fit:cover;margin:5px 0;" />';
-}
+if (!V8.IsNull(V8.Form.GongsiLOGO)) {
+  html = '<img src="' + escapeHtml(fileServer + V8.Form.GongsiLOGO) + '" '
+       + 'alt="公司Logo" '
+       + 'style="height:40px;width:40px;object-fit:cover;margin:5px 0;" />';
+}
 V8.Result = html;
 ```
 
@@ -84,15 +84,15 @@ V8.Result = html;
 var html = '';
 var fileServer = V8.SysConfig.FileServer;
 if (!V8.IsNull(V8.Form.TupianMS) && V8.Form.TupianMS.indexOf('[') !== -1) {
-  var imgs = JSON.parse(V8.Form.TupianMS);
-  imgs.forEach(function(item) {
-    var url = escapeHtml(fileServer + item.Path);
-    html += '<a href="' + url + '" target="_blank" rel="noopener noreferrer">'
-         +  '<img src="' + url + '" alt="图片" '
-         +  'style="width:40px;height:40px;object-fit:cover;margin:5px 5px 5px 0;" />'
-         +  '</a>';
-  });
-}
+  var imgs = JSON.parse(V8.Form.TupianMS);
+  imgs.forEach(function(item) {
+    var url = escapeHtml(fileServer + item.Path);
+    html += '<a href="' + url + '" target="_blank" rel="noopener noreferrer">'
+         +  '<img src="' + url + '" alt="图片" '
+         +  'style="width:40px;height:40px;object-fit:cover;margin:5px 5px 5px 0;" />'
+         +  '</a>';
+  });
+}
 V8.Result = html;
 ```
 
@@ -111,27 +111,27 @@ V8.Result =
   + '</div>';
 ```
 
-## 多字段合并显示
+## 多字段合并显示
 
 ```javascript
 // 联系人姓名 + 电话脱敏
 var name = V8.Form.LianxiR || '';
 var phone = V8.Form.LianxiPhone || '';
 if (phone.length === 11) phone = phone.substring(0, 3) + '****' + phone.substring(7);
-V8.Result = '<div><b>' + escapeHtml(name) + '</b><br/><small style="color:#999;">'
-  + escapeHtml(phone) + '</small></div>';
-```
-
-模块引擎已有更轻量的声明式方案：`ViewSchema.Layout.List.Columns` 可用 `Field + Lines +
-TrailingFields` 组成多行列，`Layout.Card` 可配置移动端顶部、右侧、正文、元信息和底部字段。
-仅需要多字段排版、图标、`Tone/Color/Prefix/Suffix` 时优先使用声明式配置；需要复杂条件
-HTML 时再给被引用的 `diy_field` 配置 `V8TmpEngineTable`。两种方式都会复用净化后的模板
-结果，且所有引用字段仍必须在模块查询列或 `_SelectFields` 中。
+V8.Result = '<div><b>' + escapeHtml(name) + '</b><br/><small style="color:#999;">'
+  + escapeHtml(phone) + '</small></div>';
+```
+
+模块引擎已有更轻量的声明式方案：`ViewSchema.Layout.List.Columns` 可用 `Field + Lines +
+TrailingFields` 组成多行列，`Layout.Card` 可配置移动端顶部、右侧、正文、元信息和底部字段。
+仅需要多字段排版、图标、`Tone/Color/Prefix/Suffix` 时优先使用声明式配置；需要复杂条件
+HTML 时再给被引用的 `diy_field` 配置 `V8TmpEngineTable`。两种方式都会复用净化后的模板
+结果，且所有引用字段仍必须在模块查询列或 `_SelectFields` 中。
 
 ## 条件性图标
 
 ```javascript
-var html = escapeHtml(V8.Form.Title || '');
+var html = escapeHtml(V8.Form.Title || '');
 if (V8.Form.IsHot === 1) html += ' <i class="fas fa-fire" style="color:#F56C6C;"></i>';
 if (V8.Form.IsNew === 1) html += ' <span class="badge badge-danger">NEW</span>';
 V8.Result = html;
@@ -150,11 +150,11 @@ V8.Result = '<span style="color:' + color + ';font-weight:bold;">¥' + total + '
 
 ## 常见错误
 
-❌ 不要在模板中调用 `V8.FormEngine`（每行都查 → N+1 性能问题）；需要关联数据时在查询列、接口引擎或后端 `DataFilterV8` 预取，只有 `DataFilterV8` 才提供 `V8.CacheData`
-❌ 不要依赖对象/数组的隐式字符串化；`V8.Result` 建议显式输出字符串
-❌ 模板中 `V8.Form` 默认只有【查询列】字段；缺字段就要去模块引擎补查询列  
-❌ 不要在模板里写复杂业务逻辑（应放到接口引擎或 DataFilterV8）  
-❌ 不要输出 `onclick/onerror`、`script/iframe` 或 `javascript:` URL；DOMPurify 会剥离这些内容
+❌ 不要在模板中调用 `V8.FormEngine`（每行都查 → N+1 性能问题）；需要关联数据时在查询列、接口引擎或后端 `DataFilterV8` 预取，只有 `DataFilterV8` 才提供 `V8.CacheData`
+❌ 不要依赖对象/数组的隐式字符串化；`V8.Result` 建议显式输出字符串
+❌ 模板中 `V8.Form` 默认只有【查询列】字段；缺字段就要去模块引擎补查询列  
+❌ 不要在模板里写复杂业务逻辑（应放到接口引擎或 DataFilterV8）  
+❌ 不要输出 `onclick/onerror`、`script/iframe` 或 `javascript:` URL；DOMPurify 会剥离这些内容
 
 ## 与 DataFilterV8 的区别
 

package/skills/v8-utilities/SKILL.md

@@ -1,92 +1,92 @@
----
-name: v8-utilities
-description: Microi V8 全局对象、上下文变量和通用函数索引。用于查询某个 V8 函数是否存在、区分前端与后端 API，或使用 V8.Method、Base64、EncryptHelper、V8.WeChat、Action、CurrentUser、SysConfig、OsClient、扫码和客户端导航工具。
----
-
-> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
-
-# Microi V8 通用能力与函数索引
-
-本 Skill 是 V8 能力的路由入口，不替代 CRUD、HTTP、缓存、文件、图片、Office、
-工作流等专项 Skill。遇到“吾码有没有某个函数”“这个 API 在前端还是后端”
-或官网函数列表同步任务时，先在这里确定运行端和正式名称，再读取专项 Skill。
-
-## 先判断运行端
-
-| 运行端 | 典型位置 | API 特征 |
-|---|---|---|
-| 前端 | 字段事件、按钮、列表、InFormV8、SubmitFormV8、OutFormV8 | 浏览器 Promise/回调、弹窗、路由、`V8.Print`、扫码 |
-| 后端 | 接口引擎、SubmitBeforeServerV8、SubmitAfterServerV8、DataFilterV8 | `V8.Db`、事务、缓存、Office、加密、服务端 HTTP |
-
-同名对象不保证两端方法一致。例如前端 `V8.Base64.encode/decode` 与后端
-`V8.Base64.StringToBase64/Base64ToString` 不同；前端标准运行时没有公开
-`V8.ModuleEngine`，后端才有模块引擎对象。
-
-## 必读索引
-
-- 前端全部上下文、表单/列表、导航、网络、引擎和工具：
-  `references/client-api-index.md`
-- 后端上下文、`V8.Method`、Base64、加密、异步与扩展对象：
-  `references/server-api-index.md`
-- 平台 HTTP 路由、动态路由与管理接口边界：
-  `references/platform-http-routes.md`
-- 蓝牙标签/小票打印：
-  `../v8-frontend-events/references/bluetooth-print.md`
-
-若函数未出现在上述索引或当前源码定义中，不得按名字猜测。先搜索
-`Microi.Client/src/views/form-engine/diy-components/v8-api-definitions.js`、
-`v8-api-server-definitions.js`、V8 宿主接口和官网中文函数列表。
-
-邮箱相关能力读取 [email-engine](../email-engine/SKILL.md)：`V8.Email` 包含
-`ProtectCredential / TestConnection / ListFolders / Fetch / Inspect / GetMessage /
-GetAttachment / SetFlags / Move / Send / StoreSent`。
-业务使用 `mci-email` 接口引擎，MCP 使用 `microi_email_query / microi_email_manage / microi_email_send`。
-
-## 常用通用写法
-
-```javascript
-// 两端通用的租户/用户上下文，具体字段按当前上下文判空
-var osClient = V8.OsClient;
-var userId = V8.CurrentUser && V8.CurrentUser.Id;
-
-// 后端稳定标识与时间
-var id = V8.Method.NewUlid();
-var now = DateNow('yyyy-MM-dd HH:mm:ss');
-var timestamp = V8.Method.GetTimestamp();
-
-// 后端 Base64
-var encoded = V8.Base64.StringToBase64('吾码');
-var decoded = V8.Base64.Base64ToString(encoded);
-
-// 前端 Base64
-var clientEncoded = V8.Base64.encode('吾码');
-var clientDecoded = V8.Base64.decode(clientEncoded);
-```
-
-## 能力选择
-
-- 日期基础函数由新版后端运行时自举，不能要求租户先配置 DateNow 才能安装应用。全局函数管理使用系统设置子表 `mci_global_function`，按 `SysConfigId + Runtime(Client/Server) + FunctionName` 隔离，一行一个同名 function 声明；用 `V8.Method.ValidateGlobalFunction` 只解析验证，不执行源码。
-- 原有前后端全局 V8 必须保留，合并顺序为内置日期、函数库、租户原有代码；同名原有函数优先。不得用官方全局脚本整段覆盖客户脚本。函数库种子 `InsertIfMissing`，不得升级覆盖客户已改源码。
-- 列表和合并代码走 L1/Redis，表单引擎真实提交后更新租户版本并通知其它节点；回滚不变更版本。禁止通过直接 SQL 修改函数库规避失效。前端已打开页面需要刷新。
-
-| 需求 | 专项 Skill |
-|---|---|
-| 表单 CRUD、`_Where` | `v8-crud-api`、`v8-sql-query` |
-| HTTP/第三方接口 | `v8-http-integration` |
-| TCP 原始字节/网络小票机/设备 | `v8-tcp-integration` |
-| Redis/Hash | `v8-cache-pattern` |
-| 文件/HDFS | `v8-file-upload` |
-| 图片 | `v8-image-processing` |
-| Excel/Word/PPT/邮件 | `v8-export-import` |
-| 微信支付签名、授权头、API v3 AES-GCM 解密 | `references/server-api-index.md`；安全边界见 `v8-security` |
-| 前端事件/打印/扫码 | `v8-frontend-events` |
-| 后端表单事件 | `v8-table-event` |
-| 接口配置/流式响应/异步/后台任务 | `v8-api-config` |
-
-## 不可越过的边界
-
-- 平台能力优先使用 `V8.*`，不要假设全局 `System` 可访问任意 CLR 类型。
-- `V8.SysConfig`、`V8.OsClientModel`、`V8.ClientModel` 可能含连接串、密钥和供应商配置，不直接返回前端或写日志。
-- 摘要算法不是密码存储。新密码不使用 MD5/SHA1/SHA256 直接保存。
-- `setTimeout`、`Task.Run` 不能承担请求返回后的可靠后台执行。
-- 前端值只可用于交互；权限、事务和最终业务校验必须在可信后端执行。
+---
+name: v8-utilities
+description: Microi V8 全局对象、上下文变量和通用函数索引。用于查询某个 V8 函数是否存在、区分前端与后端 API，或使用 V8.Method、Base64、EncryptHelper、V8.WeChat、Action、CurrentUser、SysConfig、OsClient、扫码和客户端导航工具。
+---
+
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
+
+# Microi V8 通用能力与函数索引
+
+本 Skill 是 V8 能力的路由入口，不替代 CRUD、HTTP、缓存、文件、图片、Office、
+工作流等专项 Skill。遇到“吾码有没有某个函数”“这个 API 在前端还是后端”
+或官网函数列表同步任务时，先在这里确定运行端和正式名称，再读取专项 Skill。
+
+## 先判断运行端
+
+| 运行端 | 典型位置 | API 特征 |
+|---|---|---|
+| 前端 | 字段事件、按钮、列表、InFormV8、SubmitFormV8、OutFormV8 | 浏览器 Promise/回调、弹窗、路由、`V8.Print`、扫码 |
+| 后端 | 接口引擎、SubmitBeforeServerV8、SubmitAfterServerV8、DataFilterV8 | `V8.Db`、事务、缓存、Office、加密、服务端 HTTP |
+
+同名对象不保证两端方法一致。例如前端 `V8.Base64.encode/decode` 与后端
+`V8.Base64.StringToBase64/Base64ToString` 不同；前端标准运行时没有公开
+`V8.ModuleEngine`，后端才有模块引擎对象。
+
+## 必读索引
+
+- 前端全部上下文、表单/列表、导航、网络、引擎和工具：
+  `references/client-api-index.md`
+- 后端上下文、`V8.Method`、Base64、加密、异步与扩展对象：
+  `references/server-api-index.md`
+- 平台 HTTP 路由、动态路由与管理接口边界：
+  `references/platform-http-routes.md`
+- 蓝牙标签/小票打印：
+  `../v8-frontend-events/references/bluetooth-print.md`
+
+若函数未出现在上述索引或当前源码定义中，不得按名字猜测。先搜索
+`Microi.Client/src/views/form-engine/diy-components/v8-api-definitions.js`、
+`v8-api-server-definitions.js`、V8 宿主接口和官网中文函数列表。
+
+邮箱相关能力读取 [email-engine](../email-engine/SKILL.md)：`V8.Email` 包含
+`ProtectCredential / TestConnection / ListFolders / Fetch / Inspect / GetMessage /
+GetAttachment / SetFlags / Move / Send / StoreSent`。
+业务使用 `mci-email` 接口引擎，MCP 使用 `microi_email_query / microi_email_manage / microi_email_send`。
+
+## 常用通用写法
+
+```javascript
+// 两端通用的租户/用户上下文，具体字段按当前上下文判空
+var osClient = V8.OsClient;
+var userId = V8.CurrentUser && V8.CurrentUser.Id;
+
+// 后端稳定标识与时间
+var id = V8.Method.NewUlid();
+var now = DateNow('yyyy-MM-dd HH:mm:ss');
+var timestamp = V8.Method.GetTimestamp();
+
+// 后端 Base64
+var encoded = V8.Base64.StringToBase64('吾码');
+var decoded = V8.Base64.Base64ToString(encoded);
+
+// 前端 Base64
+var clientEncoded = V8.Base64.encode('吾码');
+var clientDecoded = V8.Base64.decode(clientEncoded);
+```
+
+## 能力选择
+
+- 日期基础函数由新版后端运行时自举，不能要求租户先配置 DateNow 才能安装应用。全局函数管理使用系统设置子表 `mci_global_function`，按 `SysConfigId + Runtime(Client/Server) + FunctionName` 隔离，一行一个同名 function 声明；用 `V8.Method.ValidateGlobalFunction` 只解析验证，不执行源码。
+- 原有前后端全局 V8 必须保留，合并顺序为内置日期、函数库、租户原有代码；同名原有函数优先。不得用官方全局脚本整段覆盖客户脚本。函数库种子 `InsertIfMissing`，不得升级覆盖客户已改源码。
+- 列表和合并代码走 L1/Redis，表单引擎真实提交后更新租户版本并通知其它节点；回滚不变更版本。禁止通过直接 SQL 修改函数库规避失效。前端已打开页面需要刷新。
+
+| 需求 | 专项 Skill |
+|---|---|
+| 表单 CRUD、`_Where` | `v8-crud-api`、`v8-sql-query` |
+| HTTP/第三方接口 | `v8-http-integration` |
+| TCP 原始字节/网络小票机/设备 | `v8-tcp-integration` |
+| Redis/Hash | `v8-cache-pattern` |
+| 文件/HDFS | `v8-file-upload` |
+| 图片 | `v8-image-processing` |
+| Excel/Word/PPT/邮件 | `v8-export-import` |
+| 微信支付签名、授权头、API v3 AES-GCM 解密 | `references/server-api-index.md`；安全边界见 `v8-security` |
+| 前端事件/打印/扫码 | `v8-frontend-events` |
+| 后端表单事件 | `v8-table-event` |
+| 接口配置/流式响应/异步/后台任务 | `v8-api-config` |
+
+## 不可越过的边界
+
+- 平台能力优先使用 `V8.*`，不要假设全局 `System` 可访问任意 CLR 类型。
+- `V8.SysConfig`、`V8.OsClientModel`、`V8.ClientModel` 可能含连接串、密钥和供应商配置，不直接返回前端或写日志。
+- 摘要算法不是密码存储。新密码不使用 MD5/SHA1/SHA256 直接保存。
+- `setTimeout`、`Task.Run` 不能承担请求返回后的可靠后台执行。
+- 前端值只可用于交互；权限、事务和最终业务校验必须在可信后端执行。