@microi.net/cli 6.1.4 → 6.1.6

package/skills/v8-template-engine/SKILL.md

@@ -1,167 +1,167 @@
----
-name: v8-template-engine
-description: Microi V8 模板引擎指南。用于编写表格/表单模板渲染、V8.Result HTML/text 输出、行格式化、徽章、图片和自定义显示逻辑。
----
-
-> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
-
-# Microi V8 模板引擎（表格/表单 V8 模板）
-
-你正在为 Microi 吾码平台编写 **表格 V8 模板引擎**、**表单 V8 模板引擎** 代码。模板引擎用于在数据渲染后自定义最终展示效果（颜色、徽章、图片、HTML），是表单引擎的高级特性。
-
-## 核心规则
-
-- 模板引擎绑定在【表单属性】的【表格 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;');
-};
-```
-
-## 状态徽章（Bootstrap 样式）
-
-```javascript
-var value = V8.Form.Zhuangtai;
-if (V8.IsNull(value)) {
-  V8.Result = '';
-} else {
-  var classStr = 'badge-primary';
-  if (value === '禁用')      classStr = 'badge-danger';
-  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>';
-}
-```
-
-可用 Bootstrap 徽章类：`badge-primary`, `badge-secondary`, `badge-success`, `badge-danger`, `badge-warning`, `badge-info`, `badge-light`, `badge-dark`
-
-## 内联样式（颜色高亮）
-
-```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);
-}
-```
-
-## 单图列渲染
-
-```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;" />';
-}
-V8.Result = html;
-```
-
-## 多图列渲染（带点击放大）
-
-```javascript
-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>';
-  });
-}
-V8.Result = html;
-```
-
-## 进度条渲染
-
-```javascript
-var percent = V8.Form.Progress || 0;
-var color = '#67C23A';
-if (percent < 30) color = '#F56C6C';
-else if (percent < 70) color = '#E6A23C';
-
-V8.Result =
-  '<div style="width:100%;background:#eee;border-radius:4px;height:16px;position:relative;">'
-  + '<div style="width:' + percent + '%;background:' + color + ';height:100%;border-radius:4px;"></div>'
-  + '<span style="position:absolute;left:50%;top:0;transform:translateX(-50%);color:#333;font-size:12px;line-height:16px;">' + percent + '%</span>'
-  + '</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` 中。
-
-## 条件性图标
-
-```javascript
-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;
-```
-
-## 与字段值变更事件配合（动态计算）
-
-```javascript
-// 表格模板中根据多个字段计算
-var price = parseFloat(V8.Form.Price) || 0;
-var discount = parseFloat(V8.Form.Discount) || 1;
-var total = (price * discount).toFixed(2);
-var color = total > 1000 ? '#F56C6C' : '#67C23A';
-V8.Result = '<span style="color:' + color + ';font-weight:bold;">¥' + total + '</span>';
-```
-
-## 常见错误
-
-❌ 不要在模板中调用 `V8.FormEngine`（每行都查 → N+1 性能问题）；需要关联数据时在查询列、接口引擎或后端 `DataFilterV8` 预取，只有 `DataFilterV8` 才提供 `V8.CacheData`
-❌ 不要依赖对象/数组的隐式字符串化；`V8.Result` 建议显式输出字符串
-❌ 模板中 `V8.Form` 默认只有【查询列】字段；缺字段就要去模块引擎补查询列  
-❌ 不要在模板里写复杂业务逻辑（应放到接口引擎或 DataFilterV8）  
-❌ 不要输出 `onclick/onerror`、`script/iframe` 或 `javascript:` URL；DOMPurify 会剥离这些内容
-
-## 与 DataFilterV8 的区别
-
-| | DataFilterV8（后端） | 模板引擎（前端） |
-|---|---|---|
-| 运行端 | 服务器 | 浏览器 |
-| 用途 | 加工数据、脱敏、补字段 | 渲染 HTML 样式 |
-| 输出 | `V8.Form.字段 = ...` | `V8.Result = '<html>...</html>'` |
-| 字段范围 | 全部数据 | 仅查询列 |
-| 性能 | 每行执行（可用 `V8.CacheData`） | 浏览器渲染时执行 |
+---
+name: v8-template-engine
+description: Microi V8 模板引擎指南。用于编写表格/表单模板渲染、V8.Result HTML/text 输出、行格式化、徽章、图片和自定义显示逻辑。
+---
+
+> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
+
+# Microi V8 模板引擎（表格/表单 V8 模板）
+
+你正在为 Microi 吾码平台编写 **表格 V8 模板引擎**、**表单 V8 模板引擎** 代码。模板引擎用于在数据渲染后自定义最终展示效果（颜色、徽章、图片、HTML），是表单引擎的高级特性。
+
+## 核心规则
+
+- 模板引擎绑定在【表单属性】的【表格 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, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+};
+```
+
+## 状态徽章（Bootstrap 样式）
+
+```javascript
+var value = V8.Form.Zhuangtai;
+if (V8.IsNull(value)) {
+  V8.Result = '';
+} else {
+  var classStr = 'badge-primary';
+  if (value === '禁用')      classStr = 'badge-danger';
+  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>';
+}
+```
+
+可用 Bootstrap 徽章类：`badge-primary`, `badge-secondary`, `badge-success`, `badge-danger`, `badge-warning`, `badge-info`, `badge-light`, `badge-dark`
+
+## 内联样式（颜色高亮）
+
+```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);
+}
+```
+
+## 单图列渲染
+
+```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;" />';
+}
+V8.Result = html;
+```
+
+## 多图列渲染（带点击放大）
+
+```javascript
+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>';
+  });
+}
+V8.Result = html;
+```
+
+## 进度条渲染
+
+```javascript
+var percent = V8.Form.Progress || 0;
+var color = '#67C23A';
+if (percent < 30) color = '#F56C6C';
+else if (percent < 70) color = '#E6A23C';
+
+V8.Result =
+  '<div style="width:100%;background:#eee;border-radius:4px;height:16px;position:relative;">'
+  + '<div style="width:' + percent + '%;background:' + color + ';height:100%;border-radius:4px;"></div>'
+  + '<span style="position:absolute;left:50%;top:0;transform:translateX(-50%);color:#333;font-size:12px;line-height:16px;">' + percent + '%</span>'
+  + '</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` 中。
+
+## 条件性图标
+
+```javascript
+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;
+```
+
+## 与字段值变更事件配合（动态计算）
+
+```javascript
+// 表格模板中根据多个字段计算
+var price = parseFloat(V8.Form.Price) || 0;
+var discount = parseFloat(V8.Form.Discount) || 1;
+var total = (price * discount).toFixed(2);
+var color = total > 1000 ? '#F56C6C' : '#67C23A';
+V8.Result = '<span style="color:' + color + ';font-weight:bold;">¥' + total + '</span>';
+```
+
+## 常见错误
+
+❌ 不要在模板中调用 `V8.FormEngine`（每行都查 → N+1 性能问题）；需要关联数据时在查询列、接口引擎或后端 `DataFilterV8` 预取，只有 `DataFilterV8` 才提供 `V8.CacheData`
+❌ 不要依赖对象/数组的隐式字符串化；`V8.Result` 建议显式输出字符串
+❌ 模板中 `V8.Form` 默认只有【查询列】字段；缺字段就要去模块引擎补查询列  
+❌ 不要在模板里写复杂业务逻辑（应放到接口引擎或 DataFilterV8）  
+❌ 不要输出 `onclick/onerror`、`script/iframe` 或 `javascript:` URL；DOMPurify 会剥离这些内容
+
+## 与 DataFilterV8 的区别
+
+| | DataFilterV8（后端） | 模板引擎（前端） |
+|---|---|---|
+| 运行端 | 服务器 | 浏览器 |
+| 用途 | 加工数据、脱敏、补字段 | 渲染 HTML 样式 |
+| 输出 | `V8.Form.字段 = ...` | `V8.Result = '<html>...</html>'` |
+| 字段范围 | 全部数据 | 仅查询列 |
+| 性能 | 每行执行（可用 `V8.CacheData`） | 浏览器渲染时执行 |

package/skills/v8-utilities/references/platform-http-routes.md

@@ -1,83 +1,83 @@
-# Microi 平台 HTTP 路由索引
-
-本索引用于识别中文官网示例中的平台路由。路由可用不等于当前用户有权限；始终
-传当前租户 `OsClient`，使用受支持的 Token/访问密钥，并让服务端重新做菜单、
-表单、字段和数据范围校验。
-
-## 接口引擎
-
-| 路由 | 用途 |
-|---|---|
-| `POST /apiengine/{ApiEngineKey}` | 推荐的稳定接口引擎入口 |
-| `POST /api/ApiEngine/Run` | 仅旧客户端兼容，Body 传 `ApiEngineKey`；新增固定业务禁止使用 |
-| `/apiengine/{ApiEngineKey}--OsClient--{OsClient}--` | 仅用于确实无法设置 Header/Form/Query 的 GET/HEAD 场景 |
-
-普通请求优先在唯一 `osclient` Header 传租户，也可在 Query/Form/JSON 中冗余；
-固定业务必须使用真实引擎动态地址或唯一 `ApiAddress`，使日志、流量、审计和限流
-直接按引擎归因；旧通用入口只能由显式 `RunLegacy` 调用。
-不要无脑把特殊租户后缀加到每条 URL。官网中的
-`/apiengine/test1`、`/apiengine/get-product-list`、打印、支付和 Excel demo
-都是业务 `ApiEngineKey` 示例，不是固定平台接口。
-
-## FormEngine
-
-标准 Controller 路由：
-
-| 路由 | 用途 |
-|---|---|
-| `POST /api/formengine/GetTableData` | 查询列表 |
-| `POST /api/formengine/GetFormData` | 查询单条 |
-| `POST /api/formengine/AddFormData` | 新增 |
-| `POST /api/formengine/UptFormData` | 更新 |
-| `POST /api/formengine/DelFormData` | 删除 |
-| `POST /api/formengine/UptFormDataByWhere` | 按条件更新 |
-| `POST /api/formengine/DelFormDataByWhere` | 按条件删除 |
-| `POST /api/formengine/GetTableDataAnonymous` | 表配置允许时匿名查列表 |
-| `POST /api/formengine/GetFormDataAnonymous` | 表配置允许时匿名查单条 |
-| `POST /api/formengine/AddFormDataAnonymous` | 表配置允许时匿名新增 |
-
-动态路由还支持
-`/api/formengine/{operation}-{FormEngineKey}`（兼容无连字符操作名与连字符操作名）。
-访问密钥只需获得相应表/页面和 `form:read` 等作用域，不应把每个动态 URL 加入
-无条件白名单。完整调用模型见 `v8-formengine-http`。
-
-## 文件、消息、验证码与诊断
-
-| 路由 | 用途与边界 |
-|---|---|
-| `GET /api/Captcha/getCaptcha` | 获取验证码图片；同时保存响应 `captchaid` |
-| `POST /api/Captcha/Recognize` | 受控验证码识别，主要供采集引擎 |
-| `POST /api/HDFS/Upload` | 受限文件上传；优先用平台 SDK/V8 Upload |
-| `POST /apiengine/platform-private-file-url` | 获取当前租户短期私有文件地址；必须携带权威资源上下文 |
-| `GET /api/HDFS/OpenPrivateFile` | 受权打开私有文件/Office 代理 |
-| `POST /api/DiyChat/SendSystemMessage` | 发送站内消息；前端优先 `V8.SendSystemMessage` |
-| `POST /apiengine/platform-mq` | MQ 管理入口；Body 使用 `Action=Send`，仅当前租户超级管理员 |
-| `GET /apiengine/platform-service-health?OsClient={OsClient}` | 新版客户端固定匿名健康契约；返回 `Data.Status=Healthy`，新二进制同时返回真实后端版本；应用包先发布时版本可暂时为空，但健康结论不失败；不查询业务表 |
-| `GET /api/Diagnostics/health` | 旧节点滚动升级兼容健康路由；新版客户端不以它作为主要契约 |
-| `GET /api/Diagnostics/liveness` | 进程存活检查，不代表已就绪接流量 |
-
-`/api/example`、`/api/example/1` 仅用于说明 `V8.Http` 的普通 Controller 地址，
-不属于 Microi 固定接口。
-
-## 管理与内部交付接口
-
-下列路由不是普通业务 SDK：
-
-| 路由 | 限制 |
-|---|---|
-| `POST /api/DiyField/UptDiyFieldList` | 开发设计字段批量保存；需设计权限 |
-| `POST /api/FormEngine/ImportDiyTableRow` | 表格/子表导入；后端复核字段、外键和权限 |
-| `POST /api/SysUser/GetSysUserPassword` | 仅存量 DES 密码的超级管理员兼容查看；必须审计，访问密钥/普通角色拒绝 |
-| `POST /api/V8Engine/UploadApplicationAssetStream` | 管理员应用文件分片流式上传 |
-| `POST /api/V8Engine/FinalizeApplicationStreamPublish` | 校验清单并原子切换应用版本 |
-
-应用流式发布必须使用 MCP/平台发布流程：文件逐个校验 SHA-256，版本目录不可变，
-同一应用用跨节点锁串行，入口文件最后切换。不得把这两个内部路由包装成匿名上传。
-
-## 安全检查
-
-- URL 不携带长期 Token、密码、连接串、私钥或 Redis 凭据。
-- 动态表名、ApiEngineKey、文件路径和 redirect 都先走白名单/授权。
-- 匿名路由只对明确开启的表或接口生效，仍要限流、限大小并做业务校验。
-- 管理接口必须核验当前租户与管理员身份，写后回读；超时先回读，不能盲目重试。
-- 示例 URL 中的租户、表 Key、接口 Key 和 Id 都是占位值，不复制为生产常量。
+# Microi 平台 HTTP 路由索引
+
+本索引用于识别中文官网示例中的平台路由。路由可用不等于当前用户有权限；始终
+传当前租户 `OsClient`，使用受支持的 Token/访问密钥，并让服务端重新做菜单、
+表单、字段和数据范围校验。
+
+## 接口引擎
+
+| 路由 | 用途 |
+|---|---|
+| `POST /apiengine/{ApiEngineKey}` | 推荐的稳定接口引擎入口 |
+| `POST /api/ApiEngine/Run` | 仅旧客户端兼容，Body 传 `ApiEngineKey`；新增固定业务禁止使用 |
+| `/apiengine/{ApiEngineKey}--OsClient--{OsClient}--` | 仅用于确实无法设置 Header/Form/Query 的 GET/HEAD 场景 |
+
+普通请求优先在唯一 `osclient` Header 传租户，也可在 Query/Form/JSON 中冗余；
+固定业务必须使用真实引擎动态地址或唯一 `ApiAddress`，使日志、流量、审计和限流
+直接按引擎归因；旧通用入口只能由显式 `RunLegacy` 调用。
+不要无脑把特殊租户后缀加到每条 URL。官网中的
+`/apiengine/test1`、`/apiengine/get-product-list`、打印、支付和 Excel demo
+都是业务 `ApiEngineKey` 示例，不是固定平台接口。
+
+## FormEngine
+
+标准 Controller 路由：
+
+| 路由 | 用途 |
+|---|---|
+| `POST /api/formengine/GetTableData` | 查询列表 |
+| `POST /api/formengine/GetFormData` | 查询单条 |
+| `POST /api/formengine/AddFormData` | 新增 |
+| `POST /api/formengine/UptFormData` | 更新 |
+| `POST /api/formengine/DelFormData` | 删除 |
+| `POST /api/formengine/UptFormDataByWhere` | 按条件更新 |
+| `POST /api/formengine/DelFormDataByWhere` | 按条件删除 |
+| `POST /api/formengine/GetTableDataAnonymous` | 表配置允许时匿名查列表 |
+| `POST /api/formengine/GetFormDataAnonymous` | 表配置允许时匿名查单条 |
+| `POST /api/formengine/AddFormDataAnonymous` | 表配置允许时匿名新增 |
+
+动态路由还支持
+`/api/formengine/{operation}-{FormEngineKey}`（兼容无连字符操作名与连字符操作名）。
+访问密钥只需获得相应表/页面和 `form:read` 等作用域，不应把每个动态 URL 加入
+无条件白名单。完整调用模型见 `v8-formengine-http`。
+
+## 文件、消息、验证码与诊断
+
+| 路由 | 用途与边界 |
+|---|---|
+| `GET /api/Captcha/getCaptcha` | 获取验证码图片；同时保存响应 `captchaid` |
+| `POST /api/Captcha/Recognize` | 受控验证码识别，主要供采集引擎 |
+| `POST /api/HDFS/Upload` | 受限文件上传；优先用平台 SDK/V8 Upload |
+| `POST /apiengine/platform-private-file-url` | 获取当前租户短期私有文件地址；必须携带权威资源上下文 |
+| `GET /api/HDFS/OpenPrivateFile` | 受权打开私有文件/Office 代理 |
+| `POST /api/DiyChat/SendSystemMessage` | 发送站内消息；前端优先 `V8.SendSystemMessage` |
+| `POST /apiengine/platform-mq` | MQ 管理入口；Body 使用 `Action=Send`，仅当前租户超级管理员 |
+| `GET /apiengine/platform-service-health?OsClient={OsClient}` | 新版客户端固定匿名健康契约；返回 `Data.Status=Healthy`，新二进制同时返回真实后端版本；应用包先发布时版本可暂时为空，但健康结论不失败；不查询业务表 |
+| `GET /api/Diagnostics/health` | 旧节点滚动升级兼容健康路由；新版客户端不以它作为主要契约 |
+| `GET /api/Diagnostics/liveness` | 进程存活检查，不代表已就绪接流量 |
+
+`/api/example`、`/api/example/1` 仅用于说明 `V8.Http` 的普通 Controller 地址，
+不属于 Microi 固定接口。
+
+## 管理与内部交付接口
+
+下列路由不是普通业务 SDK：
+
+| 路由 | 限制 |
+|---|---|
+| `POST /api/DiyField/UptDiyFieldList` | 开发设计字段批量保存；需设计权限 |
+| `POST /api/FormEngine/ImportDiyTableRow` | 表格/子表导入；后端复核字段、外键和权限 |
+| `POST /api/SysUser/GetSysUserPassword` | 仅存量 DES 密码的超级管理员兼容查看；必须审计，访问密钥/普通角色拒绝 |
+| `POST /api/V8Engine/UploadApplicationAssetStream` | 管理员应用文件分片流式上传 |
+| `POST /api/V8Engine/FinalizeApplicationStreamPublish` | 校验清单并原子切换应用版本 |
+
+应用流式发布必须使用 MCP/平台发布流程：文件逐个校验 SHA-256，版本目录不可变，
+同一应用用跨节点锁串行，入口文件最后切换。不得把这两个内部路由包装成匿名上传。
+
+## 安全检查
+
+- URL 不携带长期 Token、密码、连接串、私钥或 Redis 凭据。
+- 动态表名、ApiEngineKey、文件路径和 redirect 都先走白名单/授权。
+- 匿名路由只对明确开启的表或接口生效，仍要限流、限大小并做业务校验。
+- 管理接口必须核验当前租户与管理员身份，写后回读；超时先回读，不能盲目重试。
+- 示例 URL 中的租户、表 Key、接口 Key 和 Id 都是占位值，不复制为生产常量。

package/skills/v8-workflow/references/workflow-configuration.md

@@ -1,49 +1,49 @@
-# 工作流引擎配置清单
-
-事实源：当前租户 `microi_get_db_schema`、`Microi.Core/Param/WFParam.cs`、
-`Microi.WorkFlow` 运行时、PC `views/workflow/component`。下表只描述审批工作流。
-
-## 定义、节点、连线
-
-| 资源 | 可配置字段 | 用途与注意 |
-|---|---|---|
-| `wf_flowdesign` | `FlowName, Category, Description, Remark, Sort, Preview, JsonData` | 名称、分类、说明、排序、预览与画布数据；画布最终按 `wf_node/wf_line` 渲染。 |
-| `wf_flowdesign` | `TableId, IsEnable, Roles, StartV8, EndV8` | 关联业务 `diy_table.Id`、启用、允许发起角色、流程开始/结束事件。模块流程只选已启用项。 |
-| `wf_node` | `Id, NodeName, NodeType, Icon, Description, Remark, PositionLeft, PositionTop` | 稳定节点身份、类型和画布位置。坐标写为 CSS 像素；缺失时 MCP 自动布局。 |
-| `wf_node` | `Users, Roles, Depts, BindJobs, SameDeptApprove` | 前四者是 `[{Id,Name}]` JSON 审批人来源；`SameDeptApprove` 只进一步筛选同部门候选人，不能单独提供接收人。不能伪造跨租户 Id。 |
-| `wf_node` | `AllowSelectUsers, AllowAddUsers, AllowRecall, AllowHandOver, HideHandOverSelect, BackNodes, Timeout` | 上游手选下节点人员、加签、撤回、移交、隐藏移交选择、可退回节点、超时。`BackNodes` 保存 `[{Id,NodeName}]`；会签通常不启用手选。 |
-| `wf_node` | `CopyUsers, DisplayFields, HideFields, EditFields, FieldsConfig, FieldsConfigComponent, TableId` | 抄送 `IdName` 列表、节点表单字段权限、配置组件与业务表。字段配置应从当前表真实字段建模。 |
-| `wf_node` | `StartV8, StartV8Server, EndV8, EndV8Server, LineValueV8, AllowAddUserV8Code` | 前后端节点开始/结束事件、多出线选择与加签过滤代码。条件写在当前节点，不要误放在 `wf_line.V8Code`。 |
-| `wf_line` | `Id, FromNodeId, ToNodeId, LineName, LineValue, V8Code` | 稳定线身份、端点、展示标题、条件值与兼容线代码。标题用“起点 到 终点”；分支由源节点 `LineValueV8` 指定 `V8.NextNodeId` 或 `V8.LineValue`。 |
-
-`NodeType`：`Start` 发起；`Auto` 自动；`Business` 业务提交；
-`Approve` 审批；`Countersign` 会签；`End` 人工结束；`AutoEnd` 自动结束。
-人工节点必须有真实接收人策略，否则流程可能创建实例却无待办。
-
-## 实例与操作
-
-| 资源/动作 | 功能 |
-|---|---|
-| `wf_flow` | 流程实例、业务表/行、发起人、状态、最近表单 JSON、经办人与抄送汇总。`FormData` 会变化，不是原始快照。 |
-| `wf_work` | 每个接收人的待办/已办；按 `ReceiverId + WorkState` 确定可处理工作。 |
-| `wf_history` | 每一步的起止节点、连线、处理人、意见、表单与抄送历史。 |
-| `StartWork / StartWorkWithForm` | 发起流程；新业务行建议使用合并表单提交接口。 |
-| `SendWork / SendWorkWithForm` | 处理审批、业务节点、会签及后续自动节点。 |
-| `GetStartWFNode / GetWFNodeModel / GetNextNodeConfirmUsers` | 查询开始节点、节点属性及下一节点接收人。 |
-| `RecallWork / CancelFlow / HandOverWork` | 撤回、取消、移交。取消独立事务且可改写实例 `FormData`，须按业务终态复核。 |
-| `GetWFWork / GetWFFlow / GetWFHistory / GetWFStats / MarkCopyRead` | 待办、实例、历史、统计与抄送已读。普通用户须走身份与菜单/工作权限边界。 |
-
-## MCP 到模块的生成顺序
-
-1. 查询当前租户业务表、角色、用户、部门、岗位和现有流程；不要复制其它租户 Id。
-2. Manifest 写入 `workflows[]` 的 `FlowDesign/Nodes/Lines`；人工节点设置人员策略，
-   所有连线指向同包节点，分支节点写 `LineValueV8`。
-3. 模块设置 `openType:"WorkFlow"`、`table:"业务表名"`，同包流程传
-   `flowName:"流程名称"`；现有流程传 `flowDesignId:"真实 Id"`。
-4. 执行 `microi_plan_system`、`microi_check_workflow_package`，分支调用
-   `microi_test_workflow_condition`；写入后回读三张定义表与 `sys_menu`，
-   用实际账号发起、处理、查看历史与流程图。
-
-`microi_check_workflow_package` 是本地结构检查；MCP 保存前还会核对当前租户的
-用户、角色、部门和岗位 Id。账号是否仍有效、审批人是否有业务权限以及实际到达待办，
-仍必须通过运行时与真实业务回读。
+# 工作流引擎配置清单
+
+事实源：当前租户 `microi_get_db_schema`、`Microi.Core/Param/WFParam.cs`、
+`Microi.WorkFlow` 运行时、PC `views/workflow/component`。下表只描述审批工作流。
+
+## 定义、节点、连线
+
+| 资源 | 可配置字段 | 用途与注意 |
+|---|---|---|
+| `wf_flowdesign` | `FlowName, Category, Description, Remark, Sort, Preview, JsonData` | 名称、分类、说明、排序、预览与画布数据；画布最终按 `wf_node/wf_line` 渲染。 |
+| `wf_flowdesign` | `TableId, IsEnable, Roles, StartV8, EndV8` | 关联业务 `diy_table.Id`、启用、允许发起角色、流程开始/结束事件。模块流程只选已启用项。 |
+| `wf_node` | `Id, NodeName, NodeType, Icon, Description, Remark, PositionLeft, PositionTop` | 稳定节点身份、类型和画布位置。坐标写为 CSS 像素；缺失时 MCP 自动布局。 |
+| `wf_node` | `Users, Roles, Depts, BindJobs, SameDeptApprove` | 前四者是 `[{Id,Name}]` JSON 审批人来源；`SameDeptApprove` 只进一步筛选同部门候选人，不能单独提供接收人。不能伪造跨租户 Id。 |
+| `wf_node` | `AllowSelectUsers, AllowAddUsers, AllowRecall, AllowHandOver, HideHandOverSelect, BackNodes, Timeout` | 上游手选下节点人员、加签、撤回、移交、隐藏移交选择、可退回节点、超时。`BackNodes` 保存 `[{Id,NodeName}]`；会签通常不启用手选。 |
+| `wf_node` | `CopyUsers, DisplayFields, HideFields, EditFields, FieldsConfig, FieldsConfigComponent, TableId` | 抄送 `IdName` 列表、节点表单字段权限、配置组件与业务表。字段配置应从当前表真实字段建模。 |
+| `wf_node` | `StartV8, StartV8Server, EndV8, EndV8Server, LineValueV8, AllowAddUserV8Code` | 前后端节点开始/结束事件、多出线选择与加签过滤代码。条件写在当前节点，不要误放在 `wf_line.V8Code`。 |
+| `wf_line` | `Id, FromNodeId, ToNodeId, LineName, LineValue, V8Code` | 稳定线身份、端点、展示标题、条件值与兼容线代码。标题用“起点 到 终点”；分支由源节点 `LineValueV8` 指定 `V8.NextNodeId` 或 `V8.LineValue`。 |
+
+`NodeType`：`Start` 发起；`Auto` 自动；`Business` 业务提交；
+`Approve` 审批；`Countersign` 会签；`End` 人工结束；`AutoEnd` 自动结束。
+人工节点必须有真实接收人策略，否则流程可能创建实例却无待办。
+
+## 实例与操作
+
+| 资源/动作 | 功能 |
+|---|---|
+| `wf_flow` | 流程实例、业务表/行、发起人、状态、最近表单 JSON、经办人与抄送汇总。`FormData` 会变化，不是原始快照。 |
+| `wf_work` | 每个接收人的待办/已办；按 `ReceiverId + WorkState` 确定可处理工作。 |
+| `wf_history` | 每一步的起止节点、连线、处理人、意见、表单与抄送历史。 |
+| `StartWork / StartWorkWithForm` | 发起流程；新业务行建议使用合并表单提交接口。 |
+| `SendWork / SendWorkWithForm` | 处理审批、业务节点、会签及后续自动节点。 |
+| `GetStartWFNode / GetWFNodeModel / GetNextNodeConfirmUsers` | 查询开始节点、节点属性及下一节点接收人。 |
+| `RecallWork / CancelFlow / HandOverWork` | 撤回、取消、移交。取消独立事务且可改写实例 `FormData`，须按业务终态复核。 |
+| `GetWFWork / GetWFFlow / GetWFHistory / GetWFStats / MarkCopyRead` | 待办、实例、历史、统计与抄送已读。普通用户须走身份与菜单/工作权限边界。 |
+
+## MCP 到模块的生成顺序
+
+1. 查询当前租户业务表、角色、用户、部门、岗位和现有流程；不要复制其它租户 Id。
+2. Manifest 写入 `workflows[]` 的 `FlowDesign/Nodes/Lines`；人工节点设置人员策略，
+   所有连线指向同包节点，分支节点写 `LineValueV8`。
+3. 模块设置 `openType:"WorkFlow"`、`table:"业务表名"`，同包流程传
+   `flowName:"流程名称"`；现有流程传 `flowDesignId:"真实 Id"`。
+4. 执行 `microi_plan_system`、`microi_check_workflow_package`，分支调用
+   `microi_test_workflow_condition`；写入后回读三张定义表与 `sys_menu`，
+   用实际账号发起、处理、查看历史与流程图。
+
+`microi_check_workflow_package` 是本地结构检查；MCP 保存前还会核对当前租户的
+用户、角色、部门和岗位 Id。账号是否仍有效、审批人是否有业务权限以及实际到达待办，
+仍必须通过运行时与真实业务回读。