@microi.net/cli 5.7.7 → 5.7.9

package/skills/v8-utilities/SKILL.md

@@ -1,96 +1,96 @@
----
-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);
-```
-
+---
+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`，不得升级覆盖客户已改源码。
+
+- 日期基础函数由新版后端运行时自举，不能要求租户先配置 DateNow 才能安装应用。全局函数管理使用系统设置子表 `mci_global_function`，按 `SysConfigId + Runtime(Client/Server) + FunctionName` 隔离，一行一个同名 function 声明；用 `V8.Method.ValidateGlobalFunction` 只解析验证，不执行源码。
+- 原有前后端全局 V8 必须保留，合并顺序为内置日期、函数库、租户原有代码；同名原有函数优先。不得用官方全局脚本整段覆盖客户脚本。函数库种子 `InsertIfMissing`，不得升级覆盖客户已改源码。
 - 列表和合并代码走 L1/Redis，表单引擎真实提交后更新租户版本并通知其它节点；回滚不变更版本。禁止通过直接 SQL 修改函数库规避失效。前端已打开页面需要刷新。
 
 ## 平台兼容入口索引
 
 下列旧 HTTP 地址仍由受控兼容链路识别，不能据此绕过 DiyToken、租户或权限校验：`/api/FormEngine/GetSysConfig`、`/api/Os/GetDateTimeNow`、`/api/SysLog/AddSysLog`、`/api/SysUser/`。畅捷通 V2 回调在接口引擎中编排，可信后端只提供当前租户绑定的 `V8.Method.DecodeChanjetCallbackV2` 原子。
-
-| 需求 | 专项 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` 不能承担请求返回后的可靠后台执行。
-- 前端值只可用于交互；权限、事务和最终业务校验必须在可信后端执行。
+
+| 需求 | 专项 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` 不能承担请求返回后的可靠后台执行。
+- 前端值只可用于交互；权限、事务和最终业务校验必须在可信后端执行。

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

@@ -1,143 +1,143 @@
-# 前端 V8 API 索引
-
-本索引对应 `microi.doc/docs/doc/v8-engine/v8-client.md` 和当前
-`Microi.Client` V8 定义。业务表字段如 `V8.Form.OrderNo` 不属于平台函数，
-应按实际表结构理解。
-
-## 上下文与状态
-
-| API/变量 | 说明 |
-|---|---|
-| `V8.Form`、`V8.OldForm` | 当前表单与已加载旧值 |
-| `V8.FormMode` | `Add`、`Edit`、`View` |
-| `V8.FormSubmitAction` | 提交动作 |
-| `V8.FormOutAction`、`V8.FormOutAfterAction` | 表单关闭/保存后的动作状态 |
-| `V8.LoadMode` | `Design` 或真实运行模式 |
-| `V8.EventName`、`V8.Event`、`V8.KeyCode` | 当前事件、原生事件和键码 |
-| `V8.ThisValue`、`V8.OldValue` | 当前字段值；`OldValue` 主要用于表格行内事件 |
-| `V8.TableId`、`V8.TableName`、`V8.TableModel` | 当前表/表单元数据 |
-| `V8.Row`、`V8.Rows`、`V8.RowIndex`、`V8.TableRowId` | 行事件上下文 |
-| `V8.TableRowSelected`、`V8.SelectedData` | 批量选中行，兼容别名 |
-| `V8.CurrentTableData` | 当前页表格数据 |
-| `V8.SearchParam` | 当前搜索快照 |
-| `V8.SysMenuId`、`V8.SysMenuModel` | 当前授权菜单 |
-| `V8.CurrentUser`、`V8.CurrentToken` | 当前用户和 Token；不得输出到日志/URL |
-| `V8.OsClient`、`V8.SysConfig`、`V8.ClientType` | 租户、客户端配置和终端类型 |
-| `V8.DataAppend` | 打开表单、列表或弹窗时传入的附加数据 |
-| `V8.ParentV8`、`V8.ParentForm` | 子表/弹窗访问父上下文 |
-| `V8.ParentV8.Form` | 读取父级表单数据 |
-| `V8.ParentV8.FormSet(field,value)` | 从子表调用父表字段赋值与联动 |
-| `V8.ApiReplace` | 当前表单/列表接口替换配置，只读使用 |
-| `V8.Result` | 模板或事件输出槽 |
-
-## 表单与字段
-
-| API | 说明 |
-|---|---|
-| `V8.FormSet(field,value)` | 设置字段值并触发相应联动 |
-| `V8.Field` | 当前字段模型集合 |
-| `V8.FieldSet(field,prop,value)` | 修改 `Visible/Required/Readonly/Data` 等属性 |
-| `V8.FormSubmit(options)` | 提交表单；SubmitFormV8 内不得再次调用 |
-| `V8.FormClose()` | 强制关闭表单 |
-| `V8.CloseThisDialog()` | 关闭当前宿主弹窗/微应用弹窗 |
-| `V8.ReloadForm()` | 重新加载当前表单 |
-| `V8.HideFormBtn(...)` | 隐藏表单按钮 |
-| `V8.HideFormTab(name)`、`V8.ShowFormTab(name)`、`V8.ClickFormTab(name)` | 页签显隐与切换 |
-| `V8.GetFormTabs()` | 获取当前表单页签 |
-| `V8.ShowTableChildHideField(child,fields)` | 强制显示子表隐藏列并刷新 |
-| `V8.GetChildTableData(fieldName)` | 获取指定子表数据 |
-| `V8.RefreshChildTable(field,row?)` | 刷新子表 |
-
-## 列表与搜索
-
-| API | 说明 |
-|---|---|
-| `V8.RefreshTable({_PageIndex})` | 刷新当前列表 |
-| `V8.SearchSet(value)` | 替换当前模块搜索条件 |
-| `V8.SearchAppend(value)` | 追加当前模块搜索条件 |
-| `V8.OpenTableSetWhere(field,where)` | 设置弹出表格不可被临时搜索覆盖的固定范围 |
-| `V8.AppendSearchChildTable(field,value)` | 历史兼容；新代码优先 `OpenTableSetWhere` |
-| `V8.TableSearchSet(field,value)` | 替换指定子表/表格搜索 |
-| `V8.TableSearchAppend(field,value)` | 追加指定子表/表格搜索 |
-| `V8.TableRefresh(field,param)` | 刷新指定子表/表格 |
-| `V8.ClearTableSelection()` | 清空当前列表勾选 |
-
-## 交互与导航
-
-| API | 说明 |
-|---|---|
-| `V8.Tips(msg,ok?)` | 消息提示 |
-| `V8.ConfirmTips(content,callback,options?)` | HTML 模式确认框，只传可信/转义内容 |
-| `V8.Router.Push(...)` | 站内路由 |
-| `V8.Window.Open(...)` | 打开窗口 |
-| `V8.OpenForm(...)`、`V8.OpenFormWF(...)` | 历史表单/工作流打开入口 |
-| `V8.OpenAnyForm(options)` | 打开任意表单 |
-| `V8.OpenAnyTable(options)` | 打开任意列表 |
-| `V8.OpenDialog(options)` | 打开主前端已注册 Vue 组件 |
-| `V8.OpenAppDialog(options)` | 打开已发布 MicroService 页面 |
-| `V8.WF.StartWork(...)`、`V8.FormWF` | 前端工作流入口/当前工作流数据 |
-
-三个以上输入、上传、表格、步骤条、Tab 或代码编辑器使用
-`V8.OpenAppDialog`，不要在 V8 代码中拼大段 HTML。
-
-## 网络与引擎
-
-| API | 说明 |
-|---|---|
-| `V8.Http.Get(options)`、`V8.Http.Post(options)`、`V8.Http.PatchResponse(options)` | 推荐前端 HTTP Promise API |
-| `V8.Post(...)`、`V8.Get(...)` | 历史回调 API，兼容保留 |
-| `V8.ApiEngine.Run(...)` | 调用接口引擎，支持 Promise/回调 |
-| `V8.ApiEngine.RunBackground(...)` | 提交持久后台任务 |
-| `V8.DataSourceEngine` | 前端数据源引擎对象 |
-| `V8.DataSourceEngine.Run(...)` | 运行数据源引擎；旧 `GetData` 已弃用 |
-| `V8.FormEngine.GetTableData(...)` | 查询列表 |
-| `V8.FormEngine.GetFormData(...)` | 查询单条 |
-| `V8.FormEngine.DelFormData(...)` | 删除；权限仍由服务端校验 |
-
-前端 `V8.FormEngine` 真实方法以当前客户端定义为准，均可按 Promise 使用；
-不要给前端方法虚构后端专用的 `GetTableDataAsync` 名称。标准前端运行时没有公开
-`V8.ModuleEngine`，模块关联查询使用接口引擎、数据源引擎或受控 FormEngine。
-
-## 工具能力
-
-| API | 说明 |
-|---|---|
-| `V8.IsNull(value)` | 兼容判断 `null/undefined/''/'null'/'undefined'` |
-| `V8.ChineseToPinyin(text,fullPyLen,type)` | 中文转拼音 |
-| `V8.NewGuid()` | 前端生成 GUID |
-| `await V8.NewServerGuid()` | 请求服务端生成 GUID |
-| `V8.Base64.encode(value)` | 前端 Base64 编码 |
-| `V8.Base64.decode(value)` | 前端 Base64 解码 |
-| `V8.Base64.isValid(value)` | 判断字符串是否为有效 Base64 |
-| `V8._` | Underscore 实例，如 `V8._.where(...)` |
-| `V8.Action.GetDateTimeNow()` | 兼容的前端全局时间函数 |
-| `V8.AddSysLog(...)` | 前端发起系统日志记录；不得含秘密 |
-| `V8.SendSystemMessage(...)` | 发送站内系统消息 |
-| `await V8.Method.ScanCode()` | 扫码；成功值同时写入 `V8.ScanCodeRes` |
-| `V8.Print.*` | TSPL/CPCL/ESC-POS 蓝牙标签与小票打印，兼容 GP-M322、CC4，见蓝牙打印参考 |
-| `V8.Identity.GetCapabilities()` | 读取当前租户强身份能力和本人登记状态 |
-| `V8.Identity.CreateActionHash(value)` | 为稳定业务命令生成 SHA-256 摘要 |
-| `V8.Identity.RegisterPasskey(options?)` | 登记当前用户 Passkey |
-| `V8.Identity.Verify({Purpose,ActionHash,Method,Code?})` | 完成 Passkey、Authenticator TOTP 或严格人脸验证并取得一次性后端票据；Totp 需 6 位 Code |
-
-扫码应优先接收 Promise 返回值；兼容代码可在调用后读取 `V8.ScanCodeRes`。
-`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)。
-
-## 主前端源码帮助对象
-
-`DiyCommon.GetApiBase()` 是 `Microi.Client` 主前端源码内部取得 API 根地址的帮助
-方法，不属于租户前端 V8 的稳定公开对象。V8 代码优先使用受控 `V8.Http` 和
-`V8.SysConfig.ApiBase`；MicroService 从宿主数据读取 `apiBase`，不要假设子应用
-全局存在 `DiyCommon`。
+# 前端 V8 API 索引
+
+本索引对应 `microi.doc/docs/doc/v8-engine/v8-client.md` 和当前
+`Microi.Client` V8 定义。业务表字段如 `V8.Form.OrderNo` 不属于平台函数，
+应按实际表结构理解。
+
+## 上下文与状态
+
+| API/变量 | 说明 |
+|---|---|
+| `V8.Form`、`V8.OldForm` | 当前表单与已加载旧值 |
+| `V8.FormMode` | `Add`、`Edit`、`View` |
+| `V8.FormSubmitAction` | 提交动作 |
+| `V8.FormOutAction`、`V8.FormOutAfterAction` | 表单关闭/保存后的动作状态 |
+| `V8.LoadMode` | `Design` 或真实运行模式 |
+| `V8.EventName`、`V8.Event`、`V8.KeyCode` | 当前事件、原生事件和键码 |
+| `V8.ThisValue`、`V8.OldValue` | 当前字段值；`OldValue` 主要用于表格行内事件 |
+| `V8.TableId`、`V8.TableName`、`V8.TableModel` | 当前表/表单元数据 |
+| `V8.Row`、`V8.Rows`、`V8.RowIndex`、`V8.TableRowId` | 行事件上下文 |
+| `V8.TableRowSelected`、`V8.SelectedData` | 批量选中行，兼容别名 |
+| `V8.CurrentTableData` | 当前页表格数据 |
+| `V8.SearchParam` | 当前搜索快照 |
+| `V8.SysMenuId`、`V8.SysMenuModel` | 当前授权菜单 |
+| `V8.CurrentUser`、`V8.CurrentToken` | 当前用户和 Token；不得输出到日志/URL |
+| `V8.OsClient`、`V8.SysConfig`、`V8.ClientType` | 租户、客户端配置和终端类型 |
+| `V8.DataAppend` | 打开表单、列表或弹窗时传入的附加数据 |
+| `V8.ParentV8`、`V8.ParentForm` | 子表/弹窗访问父上下文 |
+| `V8.ParentV8.Form` | 读取父级表单数据 |
+| `V8.ParentV8.FormSet(field,value)` | 从子表调用父表字段赋值与联动 |
+| `V8.ApiReplace` | 当前表单/列表接口替换配置，只读使用 |
+| `V8.Result` | 模板或事件输出槽 |
+
+## 表单与字段
+
+| API | 说明 |
+|---|---|
+| `V8.FormSet(field,value)` | 设置字段值并触发相应联动 |
+| `V8.Field` | 当前字段模型集合 |
+| `V8.FieldSet(field,prop,value)` | 修改 `Visible/Required/Readonly/Data` 等属性 |
+| `V8.FormSubmit(options)` | 提交表单；SubmitFormV8 内不得再次调用 |
+| `V8.FormClose()` | 强制关闭表单 |
+| `V8.CloseThisDialog()` | 关闭当前宿主弹窗/微应用弹窗 |
+| `V8.ReloadForm()` | 重新加载当前表单 |
+| `V8.HideFormBtn(...)` | 隐藏表单按钮 |
+| `V8.HideFormTab(name)`、`V8.ShowFormTab(name)`、`V8.ClickFormTab(name)` | 页签显隐与切换 |
+| `V8.GetFormTabs()` | 获取当前表单页签 |
+| `V8.ShowTableChildHideField(child,fields)` | 强制显示子表隐藏列并刷新 |
+| `V8.GetChildTableData(fieldName)` | 获取指定子表数据 |
+| `V8.RefreshChildTable(field,row?)` | 刷新子表 |
+
+## 列表与搜索
+
+| API | 说明 |
+|---|---|
+| `V8.RefreshTable({_PageIndex})` | 刷新当前列表 |
+| `V8.SearchSet(value)` | 替换当前模块搜索条件 |
+| `V8.SearchAppend(value)` | 追加当前模块搜索条件 |
+| `V8.OpenTableSetWhere(field,where)` | 设置弹出表格不可被临时搜索覆盖的固定范围 |
+| `V8.AppendSearchChildTable(field,value)` | 历史兼容；新代码优先 `OpenTableSetWhere` |
+| `V8.TableSearchSet(field,value)` | 替换指定子表/表格搜索 |
+| `V8.TableSearchAppend(field,value)` | 追加指定子表/表格搜索 |
+| `V8.TableRefresh(field,param)` | 刷新指定子表/表格 |
+| `V8.ClearTableSelection()` | 清空当前列表勾选 |
+
+## 交互与导航
+
+| API | 说明 |
+|---|---|
+| `V8.Tips(msg,ok?)` | 消息提示 |
+| `V8.ConfirmTips(content,callback,options?)` | HTML 模式确认框，只传可信/转义内容 |
+| `V8.Router.Push(...)` | 站内路由 |
+| `V8.Window.Open(...)` | 打开窗口 |
+| `V8.OpenForm(...)`、`V8.OpenFormWF(...)` | 历史表单/工作流打开入口 |
+| `V8.OpenAnyForm(options)` | 打开任意表单 |
+| `V8.OpenAnyTable(options)` | 打开任意列表 |
+| `V8.OpenDialog(options)` | 打开主前端已注册 Vue 组件 |
+| `V8.OpenAppDialog(options)` | 打开已发布 MicroService 页面 |
+| `V8.WF.StartWork(...)`、`V8.FormWF` | 前端工作流入口/当前工作流数据 |
+
+三个以上输入、上传、表格、步骤条、Tab 或代码编辑器使用
+`V8.OpenAppDialog`，不要在 V8 代码中拼大段 HTML。
+
+## 网络与引擎
+
+| API | 说明 |
+|---|---|
+| `V8.Http.Get(options)`、`V8.Http.Post(options)`、`V8.Http.PatchResponse(options)` | 推荐前端 HTTP Promise API |
+| `V8.Post(...)`、`V8.Get(...)` | 历史回调 API，兼容保留 |
+| `V8.ApiEngine.Run(...)` | 调用接口引擎，支持 Promise/回调 |
+| `V8.ApiEngine.RunBackground(...)` | 提交持久后台任务 |
+| `V8.DataSourceEngine` | 前端数据源引擎对象 |
+| `V8.DataSourceEngine.Run(...)` | 运行数据源引擎；旧 `GetData` 已弃用 |
+| `V8.FormEngine.GetTableData(...)` | 查询列表 |
+| `V8.FormEngine.GetFormData(...)` | 查询单条 |
+| `V8.FormEngine.DelFormData(...)` | 删除；权限仍由服务端校验 |
+
+前端 `V8.FormEngine` 真实方法以当前客户端定义为准，均可按 Promise 使用；
+不要给前端方法虚构后端专用的 `GetTableDataAsync` 名称。标准前端运行时没有公开
+`V8.ModuleEngine`，模块关联查询使用接口引擎、数据源引擎或受控 FormEngine。
+
+## 工具能力
+
+| API | 说明 |
+|---|---|
+| `V8.IsNull(value)` | 兼容判断 `null/undefined/''/'null'/'undefined'` |
+| `V8.ChineseToPinyin(text,fullPyLen,type)` | 中文转拼音 |
+| `V8.NewGuid()` | 前端生成 GUID |
+| `await V8.NewServerGuid()` | 请求服务端生成 GUID |
+| `V8.Base64.encode(value)` | 前端 Base64 编码 |
+| `V8.Base64.decode(value)` | 前端 Base64 解码 |
+| `V8.Base64.isValid(value)` | 判断字符串是否为有效 Base64 |
+| `V8._` | Underscore 实例，如 `V8._.where(...)` |
+| `V8.Action.GetDateTimeNow()` | 兼容的前端全局时间函数 |
+| `V8.AddSysLog(...)` | 前端发起系统日志记录；不得含秘密 |
+| `V8.SendSystemMessage(...)` | 发送站内系统消息 |
+| `await V8.Method.ScanCode()` | 扫码；成功值同时写入 `V8.ScanCodeRes` |
+| `V8.Print.*` | TSPL/CPCL/ESC-POS 蓝牙标签与小票打印，兼容 GP-M322、CC4，见蓝牙打印参考 |
+| `V8.Identity.GetCapabilities()` | 读取当前租户强身份能力和本人登记状态 |
+| `V8.Identity.CreateActionHash(value)` | 为稳定业务命令生成 SHA-256 摘要 |
+| `V8.Identity.RegisterPasskey(options?)` | 登记当前用户 Passkey |
+| `V8.Identity.Verify({Purpose,ActionHash,Method,Code?})` | 完成 Passkey、Authenticator TOTP 或严格人脸验证并取得一次性后端票据；Totp 需 6 位 Code |
+
+扫码应优先接收 Promise 返回值；兼容代码可在调用后读取 `V8.ScanCodeRes`。
+`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)。
+
+## 主前端源码帮助对象
+
+`DiyCommon.GetApiBase()` 是 `Microi.Client` 主前端源码内部取得 API 根地址的帮助
+方法，不属于租户前端 V8 的稳定公开对象。V8 代码优先使用受控 `V8.Http` 和
+`V8.SysConfig.ApiBase`；MicroService 从宿主数据读取 `apiBase`，不要假设子应用
+全局存在 `DiyCommon`。