@microi.net/cli 5.5.8 → 5.6.0

package/skills/v8-crud-api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: v8-crud-api
-description: Microi V8 CRUD 接口引擎开发。用于编写服务端 JavaScript，涉及 V8.FormEngine Add/Upt/Del/GetTableData、DosResult 返回、事务和校验。
+description: Microi V8 CRUD 接口引擎开发。用于编写服务端 JavaScript，涉及 V8.FormEngine Add/Upt/Del/GetTableData、DosResult 返回、事务和校验。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
@@ -20,20 +20,20 @@ AI 本地开发接口引擎时，优先修改 `microi-v8-engine/<租户>/<项目
 ```javascript
 /*
  * V8 ApiEngine
- * ApiEngineKey: 示例接口引擎Key
+ * ApiEngineKey: 示例接口引擎Key
  * Version: v1.0.0
- * 功能说明：
+ * 功能说明：
  * - 完整说明该接口引擎负责的业务功能、输入参数、关键返回字段和重要副作用。
  */
 ```
 
-同步流程：`确认后端可达（不可达则自动启动 Microi.Server/Microi.net.Api/Microi.net.Api.csproj） -> 读取远端 -> 修改本地并递增语义版本头 -> JS 语法检查 -> 保存远端 -> 回读远端确认代码头 Version 与 sys_apiengine.Version 一致 -> 用 HTTP /apiengine/{key} + osclient Header 复测`。只用 MCP 保存成功不算完成，必须至少做回读或 HTTP 验证。普通 POST/PUT/PATCH/DELETE 禁止无脑追加 `--OsClient--...--`；该特殊路径仅保留给确实无法传 Header/Form/Query 的 GET/HEAD 或第三方回调场景。
+同步流程：`确认后端可达（不可达则自动启动 Microi.Server/Microi.net.Api/Microi.net.Api.csproj） -> 读取远端 -> 修改本地并递增语义版本头 -> JS 语法检查 -> 保存远端 -> 回读远端确认代码头 Version 与 sys_apiengine.Version 一致 -> 用 HTTP /apiengine/{key} + osclient Header 复测`。只用 MCP 保存成功不算完成，必须至少做回读或 HTTP 验证。普通 POST/PUT/PATCH/DELETE 禁止无脑追加 `--OsClient--...--`；该特殊路径仅保留给确实无法传 Header/Form/Query 的 GET/HEAD 或第三方回调场景。
 
-如果保存或回读时出现 `fetch failed`、`ECONNREFUSED`、`000 Failed to connect`、端口无人监听等服务不可达问题，不能提前中止。需要启动或重启本地 API 时，必须在 `Microi.Server/Microi.net.Api` 目录通过 VS Code 可见终端执行 `dotnet run --launch-profile Microi.net.Api`，让开发者能肉眼看到并手动停止；不要用隐藏后台 shell 启动长期占用端口的 API 进程。若工具当前无法打开可见终端，应先说明限制并让用户启动/重启后继续验证。涉及 PC 页面联调或 Playwright 时，`Microi.Client` 也必须使用可见终端执行：`npm run dev -- --host 0.0.0.0 --port 1988`。只有启动失败、依赖缺失、数据库连接失败或端口冲突无法处理时才报告阻塞。
-
-Microi.net.Api 普通本地启动不要额外设置 `ASPNETCORE_ENVIRONMENT` / `DOTNET_ENVIRONMENT`，让 `Program.cs` 读取 `Microi.Server/Microi.net.Api/.microi-local` 并加载对应的 `appsettings.{Env}.json`。
+如果保存或回读时出现 `fetch failed`、`ECONNREFUSED`、`000 Failed to connect`、端口无人监听等服务不可达问题，不能提前中止。需要启动或重启本地 API 时，必须在 `Microi.Server/Microi.net.Api` 目录通过 VS Code 可见终端执行 `dotnet run --launch-profile Microi.net.Api`，让开发者能肉眼看到并手动停止；不要用隐藏后台 shell 启动长期占用端口的 API 进程。若工具当前无法打开可见终端，应先说明限制并让用户启动/重启后继续验证。涉及 PC 页面联调或 Playwright 时，`Microi.Client` 也必须使用可见终端执行：`npm run dev -- --host 0.0.0.0 --port 1988`。只有启动失败、依赖缺失、数据库连接失败或端口冲突无法处理时才报告阻塞。
 
-版本与历史同步规则：通过 MCP 或 VS Code 插件保存接口引擎时，必须同步写入 `sys_apiengine.Version`；新版平台把每次修改说明作为独立记录写入 `mci_apiengine_change_history`，表单中的“修改历史”使用 `TableChild` 展示，不再让客户端拼接或覆盖 `sys_apiengine.ChangeHistory` 多行文本。写入必须携带版本号与简明说明，并使用幂等 `EntryKey` 防止网络重试产生重复记录。安装/升级表单引擎官方应用时，旧 `ChangeHistory` 按非空行迁入子表并保留旧物理列作滚动兼容；尚未安装该子表、旧库缺字段或迁移期间，后端应自动回退旧字段或仅更新 `ApiV8Code` 与 `UpdateTime`，不得因此阻断代码同步。
+Microi.net.Api 普通本地启动不要额外设置 `ASPNETCORE_ENVIRONMENT` / `DOTNET_ENVIRONMENT`，让 `Program.cs` 读取 `Microi.Server/Microi.net.Api/.microi-local` 并加载对应的 `appsettings.{Env}.json`。
+
+版本与历史同步规则：通过 MCP 或 VS Code 插件保存接口引擎时，必须同步写入 `sys_apiengine.Version`；新版平台把每次修改说明作为独立记录写入 `mci_apiengine_change_history`，表单中的“修改历史”使用 `TableChild` 展示，不再让客户端拼接或覆盖 `sys_apiengine.ChangeHistory` 多行文本。写入必须携带版本号与简明说明，并使用幂等 `EntryKey` 防止网络重试产生重复记录。安装/升级表单引擎官方应用时，旧 `ChangeHistory` 按非空行迁入子表并保留旧物理列作滚动兼容；尚未安装该子表、旧库缺字段或迁移期间，后端应自动回退旧字段或仅更新 `ApiV8Code` 与 `UpdateTime`，不得因此阻断代码同步。
 
 生成接口引擎代码时，代码内容本身（文件头、普通注释、`console.log`、返回 `Msg` 等）不要包含 `Microi`、`吾码` 等平台品牌文字，除非业务数据或字段值本身必须如此。生成代码要有可维护注释：每个 `function` 前写清用途、关键参数和返回值；跨表事务、权限校验、状态机、金额/库存计算、复杂 `_Where` 条件等代码段前写短注释说明业务原因；避免“给变量赋值”这类无信息量注释。
 
@@ -46,29 +46,29 @@ Microi.net.Api 普通本地启动不要额外设置 `ASPNETCORE_ENVIRONMENT` / `
 - 通过 `V8.Param` 获取前端传入的参数（URL参数 / form-data / payload-json）
 - 通过 `V8.CurrentUser` 获取当前登录用户信息
 - 返回结果统一格式：`{ Code: 1, Data: any, Msg: '成功' }`
-- 所有 FormEngine 方法在服务器端支持第三个参数传入 `V8.DbTrans`（事务对象）
-- 服务端调用 FormEngine 默认**不触发**表单 V8 事件，加 `_InvokeType: 'Client'` 才触发
-- 接口内 `return Code=1` 自动提交事务、`Code≠1` 自动回滚事务，**禁止**手动 Commit/Rollback
-
+- 所有 FormEngine 方法在服务器端支持第三个参数传入 `V8.DbTrans`（事务对象）
+- 服务端调用 FormEngine 默认**不触发**表单 V8 事件，加 `_InvokeType: 'Client'` 才触发
+- 接口内 `return Code=1` 自动提交事务、`Code≠1` 自动回滚事务，**禁止**手动 Commit/Rollback
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-crud-api-002 sha256=9f10ab278468f292b5e26679b7a7ab2ea91bb6d4094e2bff8adb7cb15e39adce -->
-## 性能底线（必须自检）
-
-- 写接口引擎前必须先做数据访问计划：需要哪些表、哪些字段、预计数据量、是否分页、是否需要缓存。
-- 禁止在 `for` / `while` / `forEach` / 嵌套循环中反复调用 `GetFormData`、`GetTableData`、`FromSql`、`ApiEngine.Run` 或外部 HTTP。先收集 Id/Key，用一次 `In` 查询或一条 JOIN/聚合 SQL 批量取回，再用对象字典映射。
-- 禁止用双重循环匹配两组列表。先把小表或关联表整理成 `{ id: row }`、`{ parentId: [] }` 这类 Map，再单循环组装结果。
-- 所有列表查询必须设置 `_SelectFields`，只取业务需要的字段；面向前端的列表必须分页或显式限制 `_PageSize`，不能一次拉全表。
-- 报表、统计、跨表汇总优先使用数据库聚合（`COUNT/SUM/GROUP BY/JOIN`）或一次批量查询后内存聚合，不能逐行查明细再累加。
-- 高频读取的系统配置、字典、菜单、字段、角色权限等静态数据要优先使用 `V8.Cache` 或平台已有缓存；写入后必须清理相关缓存。
-- 外部 HTTP、短信、翻译、文件处理等慢操作不要放在数据库事务内循环执行；能批量就批量，不能批量就拆成异步任务/队列。
-- 返回前做一次性能复核：数据库访问次数是否与数据量无关、是否避免 N+1 查询、是否有索引友好的 `_Where` 条件、是否不会因空参数导致全表扫描。
-
-### 计量流水与分页审计
-
-- Token、积分、余额等计量必须由服务端在真实成功结果后记录，失败请求不得扣减；能够取得供应商 `usage` 时禁止用完整 JSON 字符数代替真实输入/输出 Token。
-- 余额扣减与流水新增必须在同一事务内完成，并锁定当前账户行，避免并发请求透支或出现“余额已扣但流水未写”。
-- 面向个人中心的流水接口必须按 `V8.CurrentUser.Id` 强制隔离，并返回 `PageIndex`、`PageSize`、`TotalCount`；列表只取页面需要的审计字段。
-- 为便于用户核对，可以保存经过空白归一化的用户输入短摘要；摘要按 Unicode 文本元素截取，不能截断 emoji 或代理对，也不要把完整请求 JSON 当摘要。
+## 性能底线（必须自检）
+
+- 写接口引擎前必须先做数据访问计划：需要哪些表、哪些字段、预计数据量、是否分页、是否需要缓存。
+- 禁止在 `for` / `while` / `forEach` / 嵌套循环中反复调用 `GetFormData`、`GetTableData`、`FromSql`、`ApiEngine.Run` 或外部 HTTP。先收集 Id/Key，用一次 `In` 查询或一条 JOIN/聚合 SQL 批量取回，再用对象字典映射。
+- 禁止用双重循环匹配两组列表。先把小表或关联表整理成 `{ id: row }`、`{ parentId: [] }` 这类 Map，再单循环组装结果。
+- 所有列表查询必须设置 `_SelectFields`，只取业务需要的字段；面向前端的列表必须分页或显式限制 `_PageSize`，不能一次拉全表。
+- 报表、统计、跨表汇总优先使用数据库聚合（`COUNT/SUM/GROUP BY/JOIN`）或一次批量查询后内存聚合，不能逐行查明细再累加。
+- 高频读取的系统配置、字典、菜单、字段、角色权限等静态数据要优先使用 `V8.Cache` 或平台已有缓存；写入后必须清理相关缓存。
+- 外部 HTTP、短信、翻译、文件处理等慢操作不要放在数据库事务内循环执行；能批量就批量，不能批量就拆成异步任务/队列。
+- 返回前做一次性能复核：数据库访问次数是否与数据量无关、是否避免 N+1 查询、是否有索引友好的 `_Where` 条件、是否不会因空参数导致全表扫描。
+
+### 计量流水与分页审计
+
+- Token、积分、余额等计量必须由服务端在真实成功结果后记录，失败请求不得扣减；能够取得供应商 `usage` 时禁止用完整 JSON 字符数代替真实输入/输出 Token。
+- 余额扣减与流水新增必须在同一事务内完成，并锁定当前账户行，避免并发请求透支或出现“余额已扣但流水未写”。
+- 面向个人中心的流水接口必须按 `V8.CurrentUser.Id` 强制隔离，并返回 `PageIndex`、`PageSize`、`TotalCount`；列表只取页面需要的审计字段。
+- 为便于用户核对，可以保存经过空白归一化的用户输入短摘要；摘要按 Unicode 文本元素截取，不能截断 emoji 或代理对，也不要把完整请求 JSON 当摘要。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-crud-api-003 sha256=d46768bbaaf8b2ebfdd38e09d11e886b135cb65e78984dbfa67d75ec5f947175 -->

package/skills/v8-crud-api/references/progressive-01-/346/237/245/350/257/242/345/210/227/350/241/250-/345/210/206/351/241/265.md

@@ -18,27 +18,27 @@ var result = V8.FormEngine.GetTableData('SysUser', {
   _PageSize: V8.Param.pageSize || 20
 });
 
-return { Code: 1, Data: result.Data, DataCount: result.DataCount, Msg: '成功' };
-```
-
-### 请求内异步查询
-
-后端接口引擎可在本次请求内使用真实异步查询；前端 V8 不使用这个方法名：
-
-```javascript
-var result = await V8.FormEngine.GetTableDataAsync('SysUser', {
-  _Where: [['Status', '=', 1]],
-  _SelectFields: ['Id', 'Account', 'Name'],
-  _PageIndex: 1,
-  _PageSize: 20
-});
-
-return { Code: 1, Data: result.Data, DataCount: result.DataCount };
-```
-
-必须 `await` 结果。需要接口先返回、后续再批量处理时，应改用平台后台任务、Job、MQ 或 outbox，而不是丢弃 Promise。
-
-### 多字段排序
+return { Code: 1, Data: result.Data, DataCount: result.DataCount, Msg: '成功' };
+```
+
+### 请求内异步查询
+
+后端接口引擎可在本次请求内使用真实异步查询；前端 V8 不使用这个方法名：
+
+```javascript
+var result = await V8.FormEngine.GetTableDataAsync('SysUser', {
+  _Where: [['Status', '=', 1]],
+  _SelectFields: ['Id', 'Account', 'Name'],
+  _PageIndex: 1,
+  _PageSize: 20
+});
+
+return { Code: 1, Data: result.Data, DataCount: result.DataCount };
+```
+
+必须 `await` 结果。需要接口先返回、后续再批量处理时，应改用平台后台任务、Job、MQ 或 outbox，而不是丢弃 Promise。
+
+### 多字段排序
 
 ```javascript
 var result = V8.FormEngine.GetTableData('SysUser', {
@@ -47,21 +47,21 @@ var result = V8.FormEngine.GetTableData('SysUser', {
 });
 ```
 
-### 匿名查询（无需登录）
+### 匿名查询（无需登录）
 
 ```javascript
-var result = V8.FormEngine.GetTableDataAnonymous('Article', {
+var result = V8.FormEngine.GetTableDataAnonymous('Article', {
   _Where: [['IsPublished', '=', 1]],
   _PageSize: 10
-});
-```
-
-匿名新增的公开入口是
-`POST /api/formengine/AddFormDataAnonymous`，且目标表必须显式允许匿名新增。
-当前后端 `V8.FormEngine` 接口不公开
-`V8.FormEngine.AddFormDataAnonymous`；接口引擎内部仍使用
-`V8.FormEngine.AddFormData(...)` 并遵守可信执行身份。不要仅因为历史文档出现
-该名称就为匿名业务接口关闭服务端校验。
+});
+```
+
+匿名新增的公开入口是
+`POST /api/formengine/AddFormDataAnonymous`，且目标表必须显式允许匿名新增。
+当前后端 `V8.FormEngine` 接口不公开
+`V8.FormEngine.AddFormDataAnonymous`；接口引擎内部仍使用
+`V8.FormEngine.AddFormData(...)` 并遵守可信执行身份。不要仅因为历史文档出现
+该名称就为匿名业务接口关闭服务端校验。
 
 ### 获取树形数据
 
@@ -160,11 +160,11 @@ V8.FormEngine.DelFormDataByWhere('SysUser', {
 ## 事务处理
 
 ```javascript
-// 接口引擎中 V8.Db 自动开启事务：
-// 返回DosResult/带Code对象：仅Code=1提交，其他值回滚
-// 返回对象但没有Code：回滚
-// 返回字符串/数字/数组/布尔/null且未异常：提交
-// 手动调用 V8.DbTrans.Commit() 或 Rollback() 无效，由平台统一管理
+// 接口引擎中 V8.Db 自动开启事务：
+// 返回DosResult/带Code对象：仅Code=1提交，其他值回滚
+// 返回对象但没有Code：回滚
+// 返回字符串/数字/数组/布尔/null且未异常：提交
+// 手动调用 V8.DbTrans.Commit() 或 Rollback() 无效，由平台统一管理
 
 // FormEngine 可传入事务对象（第三个参数）
 V8.FormEngine.AddFormData('Table1', { Name: '测试' }, V8.DbTrans);
@@ -176,21 +176,21 @@ V8.ApiEngine.Run('other-engine-key', { Id: 'xxx' }, V8.DbTrans);
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-crud-api-012 sha256=ea59e9c92b84986701a412f53a907fb2243bc7698422c1361d82280d1e4a3e4f -->
-## 请求内异步与后台处理
-
-```javascript
-// 本次请求必须拿到结果时，使用真实Async API并await
-var resp = await V8.Http.PostResponseAsync({
-  Url: 'https://other.com/notify',
-  PostParam: { Id: V8.Param.id },
-  Timeout: 10
-});
-return resp.StatusCode >= 200 && resp.StatusCode < 300
-  ? { Code: 1 }
-  : { Code: 0, Msg: '通知失败' };
-```
-
-禁止用 `setTimeout` / `Task.Run` 实现“立即返回、后台继续”：接口返回后 Jint Engine、租户上下文、事务和执行租约会释放。脱离请求的任务使用后台任务、Job、MQ 或 outbox，并按 `EventId` 幂等处理与恢复。
+## 请求内异步与后台处理
+
+```javascript
+// 本次请求必须拿到结果时，使用真实Async API并await
+var resp = await V8.Http.PostResponseAsync({
+  Url: 'https://other.com/notify',
+  PostParam: { Id: V8.Param.id },
+  Timeout: 10
+});
+return resp.StatusCode >= 200 && resp.StatusCode < 300
+  ? { Code: 1 }
+  : { Code: 0, Msg: '通知失败' };
+```
+
+禁止用 `setTimeout` / `Task.Run` 实现“立即返回、后台继续”：接口返回后 Jint Engine、租户上下文、事务和执行租约会释放。脱离请求的任务使用后台任务、Job、MQ 或 outbox，并按 `EventId` 幂等处理与恢复。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-crud-api-013 sha256=d4d96c1d82d1fba71100919ff7b0d48441610fdef4602097723cffdcdaaeebf4 -->
@@ -200,7 +200,7 @@ return resp.StatusCode >= 200 && resp.StatusCode < 300
 V8.FormEngine.AddField({
   TableName: 'diy_test',
   Name: 'Age',
-  Type: 'int',          // 仅使用平台允许的varchar(N)/mediumtext/longtext/int/bigint/decimal(18,N)
+  Type: 'int',          // 仅使用平台允许的varchar(N)/mediumtext/longtext/int/bigint/decimal(18,N)
   Label: '年龄',
   Component: 'NumberText',
   TableWidth: '100',
@@ -208,9 +208,9 @@ V8.FormEngine.AddField({
 });
 ```
 
-> 风险：会执行 DDL（ALTER TABLE）。仅在低代码自定义配置场景使用，业务运行时**不要**频繁调用。
-
-日期时间字段统一使用 `varchar(25)` 保存 `yyyy-MM-dd HH:mm:ss`，组件使用 `DateTime`。禁止 `datetime/date/timestamp/float/double/boolean/string/text/nvarchar` 等平台不允许的物理类型。动态表/字段属于控制面能力，只允许 `Level >= 9999` 的可信管理脚本使用。
+> 风险：会执行 DDL（ALTER TABLE）。仅在低代码自定义配置场景使用，业务运行时**不要**频繁调用。
+
+日期时间字段统一使用 `varchar(25)` 保存 `yyyy-MM-dd HH:mm:ss`，组件使用 `DateTime`。禁止 `datetime/date/timestamp/float/double/boolean/string/text/nvarchar` 等平台不允许的物理类型。动态表/字段属于控制面能力，只允许 `Level >= 9999` 的可信管理脚本使用。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-crud-api-014 sha256=42b43027eb510916aed85a3a21ea8a1c1c7697581ac8c48863e8ba8d0c793784 -->

package/skills/v8-debugging/SKILL.md

@@ -1,34 +1,34 @@
 ---
 name: v8-debugging
-description: Microi V8 调试与日志指南。用于排查接口引擎、V8 事件、console.log、DataAppend.DebugLog、sys_log、异常处理和远程执行问题。
+description: Microi V8 调试与日志指南。用于排查接口引擎、V8 事件、console.log、DataAppend.DebugLog、sys_log、异常处理和远程执行问题。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
-# Microi V8 调试与日志
-
-你正在为 Microi 吾码平台编写 V8 引擎代码，需要在开发/测试/生产环境进行排错。本指南提供调试模式、异常捕获、系统日志、调试输出的标准做法。
-
-系统级排查优先读取 `../system-observability/SKILL.md` 并通过 `microi_query_system_observability` 查询统一日志、统计、详情、Trace、热点接口和运行数据；`microi_query_mongodb_logs` 仅保留给只需要旧 Mongo 日志列表的兼容场景。两者都必须限制租户、时间窗、页大小和返回字段，不在结果或回答中输出 Token、连接串、Secret 或完整敏感请求体。
+# Microi V8 调试与日志
+
+你正在为 Microi 吾码平台编写 V8 引擎代码，需要在开发/测试/生产环境进行排错。本指南提供调试模式、异常捕获、系统日志、调试输出的标准做法。
+
+系统级排查优先读取 `../system-observability/SKILL.md` 并通过 `microi_query_system_observability` 查询统一日志、统计、详情、Trace、热点接口和运行数据；`microi_query_mongodb_logs` 仅保留给只需要旧 Mongo 日志列表的兼容场景。两者都必须限制租户、时间窗、页大小和返回字段，不在结果或回答中输出 Token、连接串、Secret 或完整敏感请求体。
 
 ## 三种输出通道
 
 | 通道 | 何处看 | 用途 |
 |------|--------|------|
-| 后端 V8 的 `console.log` / `console.error` | 租户系统日志（MongoDB）；MCP/调试执行同时返回当次 `ConsoleOutput` | 临时诊断、性能日志 |
+| 后端 V8 的 `console.log` / `console.error` | 租户系统日志（MongoDB）；MCP/调试执行同时返回当次 `ConsoleOutput` | 临时诊断、性能日志 |
 | `DataAppend.DebugLog`（返回给前端） | 浏览器开发者工具 / Postman 响应 | 当次请求的关键节点、变量值 |
 | `V8.Method.AddSysLog({...})` | 系统日志页 / `sys_log` 表 | 业务操作审计、第三方回调记录 |
 
 ## 调试模式 isDebugLog
 
-调试开关必须同时满足“服务端允许调试 + 当前用户 `Level >= 9999`”。不能只相信 URL/query 的 `isDebugLog=1`，匿名或普通用户否则可获得内部数据与堆栈。
+调试开关必须同时满足“服务端允许调试 + 当前用户 `Level >= 9999`”。不能只相信 URL/query 的 `isDebugLog=1`，匿名或普通用户否则可获得内部数据与堆栈。
 
 ```javascript
-var isAdmin = V8.CurrentUser && Number(V8.CurrentUser.Level || 0) >= 9999;
-var isDebugLog = isAdmin &&
-  V8.SysConfig &&
-  V8.SysConfig.EnableV8Debug === 1 &&
-  (V8.Param.isDebugLog === '1' || V8.Param.isDebugLog === true);
+var isAdmin = V8.CurrentUser && Number(V8.CurrentUser.Level || 0) >= 9999;
+var isDebugLog = isAdmin &&
+  V8.SysConfig &&
+  V8.SysConfig.EnableV8Debug === 1 &&
+  (V8.Param.isDebugLog === '1' || V8.Param.isDebugLog === true);
 var debugLog = [];
 function dbg(msg, data) {
   if (!isDebugLog) return;
@@ -39,10 +39,10 @@ function dbg(msg, data) {
   });
 }
 
-dbg('开始查询参数', {
-  Keyword: String(V8.Param.Keyword || '').substring(0, 100),
-  PageIndex: V8.Param.PageIndex
-});
+dbg('开始查询参数', {
+  Keyword: String(V8.Param.Keyword || '').substring(0, 100),
+  PageIndex: V8.Param.PageIndex
+});
 
 var products = V8.FormEngine.GetTableData('Product', {
   _Where: [['Status', '=', 1]]
@@ -58,61 +58,61 @@ return {
 };
 ```
 
-管理员在服务端显式开启调试后，才可用 `?isDebugLog=1` 查看当次请求的脱敏节点日志。生产环境默认关闭，调试完成后立即关闭。
-
-## Jint 内存上限错误
-
-出现 `Script has allocated ... but is limited to ...` 时，不要把它解释为
-数据库返回数据的实际大小，也不要直接关闭内存限制。
-
-- Jint `LimitMemory` 使用当前执行线程的**累计托管分配字节数**，不是当前
-  存活堆或进程工作集；中间对象即使已经被 GC 回收，累计值也不会减少。
-- 平台必须在宿主对象、扩展和全局 V8 准备完成后调用
-  `engine.Constraints.Reset()`，让全局 V8 和当前接口 V8 各自获得完整预算；
-  用户脚本以及脚本调用的 CLR/FormEngine 逻辑仍受同一阶段预算限制。
-- 默认单次执行预算为 2048 MB，默认节点硬上限为 8192 MB；根调用树默认
-  8192 MB、节点硬上限 32768 MB。存量接口仅把仍等于
-  历史默认值 1024 MB 的记录迁移到 2048 MB；客户明确设置的其它值不覆盖。
-- 旧版嵌套接口会让子引擎的初始化、查询、JSON 和业务分配被每一层父引擎
-  重复计数，因此四层、少量数据也可能提前触发 2GB。新版默认启用父子单层
-  预算隔离，每层独立计数，同时由根调用树默认 8192MB 的总预算兜底。
-- `LimitRecursion` 只限制当前 JavaScript 函数递归，不限制
-  `V8.ApiEngine.Run` 层数；接口嵌套默认 32、节点硬上限默认 64。
-- 排查时记录 `ApiEngineKey`、实际 `LimitMemory`、返回行数、选择字段、
-  分页大小、`V8.Limits`、`DataAppend.V8Limit` 调用路径和重现脚本。若
-  2048 MB 仍触发，继续减少一次性对象图、流式或
-  分批处理；不得把上限无限提高或取消。
-- `V8_MEMORY_LIMIT` 表示单层预算，`V8_CALL_TREE_MEMORY_LIMIT` 表示整棵
-  调用树，`V8_STATEMENTS_LIMIT`、`V8_RECURSION_LIMIT`、`V8_TIMEOUT`、
-  `V8_NESTED_DEPTH_LIMIT` 和 `V8_EXECUTION_QUEUE_TIMEOUT` 必须分别处理。
-- 后台任务总时长可以超过 10/30 分钟，但单片仍受上述预算；使用
-  `HasMore + Checkpoint` 续跑，不要只提高单次超时或内存。
-- 接口引擎的正向开关是 `sys_apiengine.V8Limit`：默认关闭时
-  `V8.Limits.UnlimitedRuntime=true`，打开后才应用超时、语句、函数递归、
-  累计分配和 Promise 等待限制。表后端事件同样使用正向 `diy_table.V8Limit`：
-  缺失、`null`、`0/false` 不设置单次预算，只有 `1/true` 才启用限制；旧
-  `V8Unlimited` 仅在新字段不存在时反向兼容。
-  常驻内存保护、外部取消、并发、接口嵌套深度、权限沙箱与数据库限制始终
-  生效；两类开关都只能来自持久化可信元数据，不能从请求参数启用。
-- 服务端另有一个内置受信任特例：主租户中由持久队列恢复的
-  `import-microi-store-package`：必须同时具备可信用户快照、`Level >= 9999`
-  和 TaskId，才允许 `V8.Limits.MemoryAccounting=ResidentMemoryGuardOnly`。
-  此模式不是“无限内存”，而是改用容器优先的进程 RSS 防线：95% 拒绝新工作、
-  98% 有界停机；导入器仍必须按资产分片并可从 checkpoint 幂等恢复。前台调用、
-  子租户或其它 Key 看到该模式都属于安全缺陷。
-- 回归至少验证 Jint 包版本、约束重置、默认/硬上限，以及 400 行左右普通
-  FormEngine 查询与数据加工不会被平台准备阶段的累计分配误伤。
-
-## try/catch 异常捕获 + 详情上报
+管理员在服务端显式开启调试后，才可用 `?isDebugLog=1` 查看当次请求的脱敏节点日志。生产环境默认关闭，调试完成后立即关闭。
+
+## Jint 内存上限错误
+
+出现 `Script has allocated ... but is limited to ...` 时，不要把它解释为
+数据库返回数据的实际大小，也不要直接关闭内存限制。
+
+- Jint `LimitMemory` 使用当前执行线程的**累计托管分配字节数**，不是当前
+  存活堆或进程工作集；中间对象即使已经被 GC 回收，累计值也不会减少。
+- 平台必须在宿主对象、扩展和全局 V8 准备完成后调用
+  `engine.Constraints.Reset()`，让全局 V8 和当前接口 V8 各自获得完整预算；
+  用户脚本以及脚本调用的 CLR/FormEngine 逻辑仍受同一阶段预算限制。
+- 默认单次执行预算为 2048 MB，默认节点硬上限为 8192 MB；根调用树默认
+  8192 MB、节点硬上限 32768 MB。存量接口仅把仍等于
+  历史默认值 1024 MB 的记录迁移到 2048 MB；客户明确设置的其它值不覆盖。
+- 旧版嵌套接口会让子引擎的初始化、查询、JSON 和业务分配被每一层父引擎
+  重复计数，因此四层、少量数据也可能提前触发 2GB。新版默认启用父子单层
+  预算隔离，每层独立计数，同时由根调用树默认 8192MB 的总预算兜底。
+- `LimitRecursion` 只限制当前 JavaScript 函数递归，不限制
+  `V8.ApiEngine.Run` 层数；接口嵌套默认 32、节点硬上限默认 64。
+- 排查时记录 `ApiEngineKey`、实际 `LimitMemory`、返回行数、选择字段、
+  分页大小、`V8.Limits`、`DataAppend.V8Limit` 调用路径和重现脚本。若
+  2048 MB 仍触发，继续减少一次性对象图、流式或
+  分批处理；不得把上限无限提高或取消。
+- `V8_MEMORY_LIMIT` 表示单层预算，`V8_CALL_TREE_MEMORY_LIMIT` 表示整棵
+  调用树，`V8_STATEMENTS_LIMIT`、`V8_RECURSION_LIMIT`、`V8_TIMEOUT`、
+  `V8_NESTED_DEPTH_LIMIT` 和 `V8_EXECUTION_QUEUE_TIMEOUT` 必须分别处理。
+- 后台任务总时长可以超过 10/30 分钟，但单片仍受上述预算；使用
+  `HasMore + Checkpoint` 续跑，不要只提高单次超时或内存。
+- 接口引擎的正向开关是 `sys_apiengine.V8Limit`：默认关闭时
+  `V8.Limits.UnlimitedRuntime=true`，打开后才应用超时、语句、函数递归、
+  累计分配和 Promise 等待限制。表后端事件同样使用正向 `diy_table.V8Limit`：
+  缺失、`null`、`0/false` 不设置单次预算，只有 `1/true` 才启用限制；旧
+  `V8Unlimited` 仅在新字段不存在时反向兼容。
+  常驻内存保护、外部取消、并发、接口嵌套深度、权限沙箱与数据库限制始终
+  生效；两类开关都只能来自持久化可信元数据，不能从请求参数启用。
+- 服务端另有一个内置受信任特例：主租户中由持久队列恢复的
+  `import-microi-store-package`：必须同时具备可信用户快照、`Level >= 9999`
+  和 TaskId，才允许 `V8.Limits.MemoryAccounting=ResidentMemoryGuardOnly`。
+  此模式不是“无限内存”，而是改用容器优先的进程 RSS 防线：95% 拒绝新工作、
+  98% 有界停机；导入器仍必须按资产分片并可从 checkpoint 幂等恢复。前台调用、
+  子租户或其它 Key 看到该模式都属于安全缺陷。
+- 回归至少验证 Jint 包版本、约束重置、默认/硬上限，以及 400 行左右普通
+  FormEngine 查询与数据加工不会被平台准备阶段的累计分配误伤。
+
+## try/catch 异常捕获 + 详情上报
 
 ```javascript
 try {
   var r = V8.Http.Post({
     Url: 'https://api.partner.com/sync',
-    PostParam: {
-      Id: V8.Param.Id,
-      Action: V8.Param.Action
-    },
+    PostParam: {
+      Id: V8.Param.Id,
+      Action: V8.Param.Action
+    },
     ParamType: 'json',
     Timeout: 30
   });
@@ -120,11 +120,11 @@ try {
     throw new Error('合作方接口失败：' + r);
   }
   return { Code: 1, Data: JSON.parse(r) };
-} catch (ex) {
-  // 完整异常信息
-  var traceId = V8.Method.NewUlid();
-  var errorDetails = {
-    traceId: traceId,
+} catch (ex) {
+  // 完整异常信息
+  var traceId = V8.Method.NewUlid();
+  var errorDetails = {
+    traceId: traceId,
     message: ex.message,
     stack:   ex.stack,
     line:    ex.lineNumber,
@@ -143,8 +143,8 @@ try {
 
   return {
     Code: 0,
-    Msg: '同步失败，请按追踪号查询日志',
-    DataAppend: isDebugLog ? { TraceId: traceId } : null
+    Msg: '同步失败，请按追踪号查询日志',
+    DataAppend: isDebugLog ? { TraceId: traceId } : null
   };
 }
 ```
@@ -164,67 +164,67 @@ V8.Method.AddSysLog({
 });
 ```
 
-日志保存在按租户、月份拆分的 MongoDB 系统日志集合中，可在系统日志菜单查看并按 Type 过滤。所有 `AddSysLog` 调用统一进入后端异步队列，由后台批量写 MongoDB；批次先写本地 spool，MongoDB 故障和正常重启后自动幂等重放，因此业务请求不得自行启动线程或直接并发写 MongoDB。
-
-- 容器环境把固定目录 `logs/syslog-spool` 挂载到持久卷，不为路径增加环境变量。
-- 分布式部署的节点标识由平台自动生成；所有节点写同一 MongoDB 时仍按全局 `EventId` upsert。详情状态和私有文件票据存共享 Redis，本机内存只作故障兜底，不能依赖粘性会话。
-- 多节点可能同时观察到的菜单、详情关闭、附件分片和登录生命周期事件要使用确定性 `EventId`，不能只靠本机字典去重；服务正常停止会落盘排空，重启会自动重放。
-- 平台用户行为统一使用结构化字段 `Category`、`Action`、`Source`、`TargetType`、`TargetId`、`SessionId`、`DurationSeconds`、`Success`、`OccurredAt`。
-- 用户显示采用 `Name(Account)`；禁止记录密码、原始 Token、Authorization、Secret、ApiKey、连接字符串，内容还必须限长。
-- 前端只能上报纯 UI 行为信号；菜单访问、CRUD、导入导出、登录生命周期、私有文件实际访问等必须以后端真实执行点为事实源。
-
-### 匿名登录/第三方授权接口的追踪日志
-
-微信手机号、OAuth、短信快捷登录等匿名接口必须生成追踪号并按阶段记录失败。开发者工具成功不能替代体验版/真机验证。
-
-```javascript
-var traceId = V8.Method.NewGuid().replace(/-/g, '').substring(0, 16);
-
-function fail(stage, message, detail) {
-  V8.Method.AddSysLog({
-    Type: 'ThirdPartyLogin',
-    Title: '授权登录失败[' + stage + '][' + traceId + ']',
-    Content: JSON.stringify({
-      TraceId: traceId,
-      Stage: stage,
-      Message: message,
-      Detail: detail || {},
-      OsClient: V8.OsClient
-    }),
-    Remark: traceId,
-    Level: 3
-  });
-  return { Code: 0, Msg: '授权登录失败（' + stage + '）：' + message + '；追踪号：' + traceId };
-}
-```
-
-- 在身份交换、AccessToken、手机号/用户资料交换、账号匹配、注册/更新、Token 签发前维护明确阶段名，所有显式失败和顶层 `catch` 都走同一个 `fail`。
-- 日志保留第三方 `errcode/errmsg`，但先脱敏；禁止记录 Secret、AccessToken、授权 code、LoginCode、OpenId、完整手机号和用户 Token。
-- `V8.Method.AddSysLog` 写 MongoDB 系统日志，适合 `Code=0` 仍需保留的结构化失败记录；`console.error` 也按当前 `OsClient` 进入 MongoDB，但不替代带追踪号的业务审计日志。
-- 前端响应显示同一个追踪号，排查时先按追踪号查系统日志，再结合第三方错误码定位。
-
-## 后端 V8 console 的去向
-
-- 普通接口引擎和表单后端 V8 的 `console.log/info/warn/error` 按租户写入 MongoDB 系统日志，`Source/TargetType` 为 `V8`，可按接口 Key 或事件名定位。
-- MCP 远程执行和 V8 调试会通过请求级上下文捕获当次输出并返回 `ConsoleOutput`；不得用进程级 `Console.SetOut`，否则并发请求会互相截取日志。
-- Docker/服务器控制台只保留影响平台启动、主租户、日志管道或进程存活的关键日志，不再作为普通 V8 调试日志入口。
-- 前端 V8 的 `console.log` 仍在浏览器开发者工具中查看，与后端日志通道无关。
+日志保存在按租户、月份拆分的 MongoDB 系统日志集合中，可在系统日志菜单查看并按 Type 过滤。所有 `AddSysLog` 调用统一进入后端异步队列，由后台批量写 MongoDB；批次先写本地 spool，MongoDB 故障和正常重启后自动幂等重放，因此业务请求不得自行启动线程或直接并发写 MongoDB。
+
+- 容器环境把固定目录 `logs/syslog-spool` 挂载到持久卷，不为路径增加环境变量。
+- 分布式部署的节点标识由平台自动生成；所有节点写同一 MongoDB 时仍按全局 `EventId` upsert。详情状态和私有文件票据存共享 Redis，本机内存只作故障兜底，不能依赖粘性会话。
+- 多节点可能同时观察到的菜单、详情关闭、附件分片和登录生命周期事件要使用确定性 `EventId`，不能只靠本机字典去重；服务正常停止会落盘排空，重启会自动重放。
+- 平台用户行为统一使用结构化字段 `Category`、`Action`、`Source`、`TargetType`、`TargetId`、`SessionId`、`DurationSeconds`、`Success`、`OccurredAt`。
+- 用户显示采用 `Name(Account)`；禁止记录密码、原始 Token、Authorization、Secret、ApiKey、连接字符串，内容还必须限长。
+- 前端只能上报纯 UI 行为信号；菜单访问、CRUD、导入导出、登录生命周期、私有文件实际访问等必须以后端真实执行点为事实源。
+
+### 匿名登录/第三方授权接口的追踪日志
+
+微信手机号、OAuth、短信快捷登录等匿名接口必须生成追踪号并按阶段记录失败。开发者工具成功不能替代体验版/真机验证。
+
+```javascript
+var traceId = V8.Method.NewGuid().replace(/-/g, '').substring(0, 16);
+
+function fail(stage, message, detail) {
+  V8.Method.AddSysLog({
+    Type: 'ThirdPartyLogin',
+    Title: '授权登录失败[' + stage + '][' + traceId + ']',
+    Content: JSON.stringify({
+      TraceId: traceId,
+      Stage: stage,
+      Message: message,
+      Detail: detail || {},
+      OsClient: V8.OsClient
+    }),
+    Remark: traceId,
+    Level: 3
+  });
+  return { Code: 0, Msg: '授权登录失败（' + stage + '）：' + message + '；追踪号：' + traceId };
+}
+```
+
+- 在身份交换、AccessToken、手机号/用户资料交换、账号匹配、注册/更新、Token 签发前维护明确阶段名，所有显式失败和顶层 `catch` 都走同一个 `fail`。
+- 日志保留第三方 `errcode/errmsg`，但先脱敏；禁止记录 Secret、AccessToken、授权 code、LoginCode、OpenId、完整手机号和用户 Token。
+- `V8.Method.AddSysLog` 写 MongoDB 系统日志，适合 `Code=0` 仍需保留的结构化失败记录；`console.error` 也按当前 `OsClient` 进入 MongoDB，但不替代带追踪号的业务审计日志。
+- 前端响应显示同一个追踪号，排查时先按追踪号查系统日志，再结合第三方错误码定位。
+
+## 后端 V8 console 的去向
+
+- 普通接口引擎和表单后端 V8 的 `console.log/info/warn/error` 按租户写入 MongoDB 系统日志，`Source/TargetType` 为 `V8`，可按接口 Key 或事件名定位。
+- MCP 远程执行和 V8 调试会通过请求级上下文捕获当次输出并返回 `ConsoleOutput`；不得用进程级 `Console.SetOut`，否则并发请求会互相截取日志。
+- Docker/服务器控制台只保留影响平台启动、主租户、日志管道或进程存活的关键日志，不再作为普通 V8 调试日志入口。
+- 前端 V8 的 `console.log` 仍在浏览器开发者工具中查看，与后端日志通道无关。
 
 ## 性能跟踪（毫秒级耗时）
 
 ```javascript
-var t0 = Date.now();
+var t0 = Date.now();
 
 var step1 = V8.FormEngine.GetTableData('Big', { _PageSize: 5000 });
-var t1 = Date.now();
+var t1 = Date.now();
 
 var step2 = V8.Db.FromSql('SELECT COUNT(*) FROM Order').ToScalar();
-var t2 = Date.now();
+var t2 = Date.now();
 
 dbg('耗时', { step1Ms: t1 - t0, step2Ms: t2 - t1, totalMs: t2 - t0 });
 ```
 
-## 前端调试
+## 前端调试
 
 ```javascript
 // 前端 V8 事件中
@@ -234,31 +234,31 @@ console.error('校验失败', V8.Form);
 
 // 在浏览器开发者工具控制台查看
 // 或显式弹层：
-V8.Tips('调试: ' + JSON.stringify(V8.Form), true);
-```
-
-## VS Code 插件输出约定
-
-Microi VS Code 插件的右下角信息、警告和错误通知必须同步写入【输出 → Microi 吾码】，让构建、推送、拉取、登录、同步和调试结果在通知消失后仍可追溯。输出时间使用运行 VS Code 电脑的本地时区，格式统一为 `yyyy-MM-dd HH:mm:ss`，禁止直接使用 `toISOString()` 造成 UTC 时间偏差。
-
-- 后台 Token/会话维护等静默健康探测设置 `silent=true` 后，预期的网络不可达不得反复写成红色错误。
-- 用户主动执行拉取、推送或状态检查时，网络错误必须保留错误码、系统调用、地址、端口及聚合错误明细；禁止出现只有 `Error:`、没有原因的空日志。
-- 所有右下角通知统一经过通知封装写入输出；带操作按钮的通知还应记录用户选择，禁止业务模块直接调用 `vscode.window.showInformationMessage/showWarningMessage/showErrorMessage` 绕过持久日志。
-
-## 不要在生产泄漏敏感信息
+V8.Tips('调试: ' + JSON.stringify(V8.Form), true);
+```
+
+## VS Code 插件输出约定
+
+Microi VS Code 插件的右下角信息、警告和错误通知必须同步写入【输出 → Microi 吾码】，让构建、推送、拉取、登录、同步和调试结果在通知消失后仍可追溯。输出时间使用运行 VS Code 电脑的本地时区，格式统一为 `yyyy-MM-dd HH:mm:ss`，禁止直接使用 `toISOString()` 造成 UTC 时间偏差。
+
+- 后台 Token/会话维护等静默健康探测设置 `silent=true` 后，预期的网络不可达不得反复写成红色错误。
+- 用户主动执行拉取、推送或状态检查时，网络错误必须保留错误码、系统调用、地址、端口及聚合错误明细；禁止出现只有 `Error:`、没有原因的空日志。
+- 所有右下角通知统一经过通知封装写入输出；带操作按钮的通知还应记录用户选择，禁止业务模块直接调用 `vscode.window.showInformationMessage/showWarningMessage/showErrorMessage` 绕过持久日志。
+
+## 不要在生产泄漏敏感信息
 
 ```javascript
 // ❌ 危险：返回给前端
 return { Code: 0, Msg: ex.message, DataAppend: { Stack: ex.stack } };
 
-// ✅ 只返回关联ID；完整堆栈仅写内部日志
-var traceId = V8.Method.NewUlid();
-console.error('traceId=' + traceId + ' error=' + ex.message);
-return {
-  Code: 0,
-  Msg: '系统繁忙',
-  DataAppend: { TraceId: traceId }
-};
+// ✅ 只返回关联ID；完整堆栈仅写内部日志
+var traceId = V8.Method.NewUlid();
+console.error('traceId=' + traceId + ' error=' + ex.message);
+return {
+  Code: 0,
+  Msg: '系统繁忙',
+  DataAppend: { TraceId: traceId }
+};
 ```
 
 ## DosResult 状态码速查