@microi.net/cli 5.5.8 → 5.6.0

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

@@ -1,15 +1,15 @@
 ---
 name: v8-http-integration
-description: Microi V8 HTTP 集成指南。用于通过 V8.Http.Get/Post/Patch、对应 Response 方法及后端 Async 方法调用接口，处理请求头、JSON/form/XML 载荷、超时、文件和响应解析，并兼容前后端 V8。
+description: Microi V8 HTTP 集成指南。用于通过 V8.Http.Get/Post/Patch、对应 Response 方法及后端 Async 方法调用接口，处理请求头、JSON/form/XML 载荷、超时、文件和响应解析，并兼容前后端 V8。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi V8 HTTP 外部接口集成
 
-你正在开发 Microi 吾码平台的 V8 引擎代码，需要调用外部 HTTP API（微信、支付宝、短信、ERP 等第三方系统）。
-
-文档维护时，前端用法更新现有 `microi.doc/docs/doc/v8-engine/v8-client.md`，后端用法更新现有 `microi.doc/docs/doc/v8-engine/v8-server.md`；不要新建重复的 V8.Http 文档页面或路由。只维护中文 `docs/doc/`，英文 `docs/en/` 由官网统一翻译生成。
+你正在开发 Microi 吾码平台的 V8 引擎代码，需要调用外部 HTTP API（微信、支付宝、短信、ERP 等第三方系统）。
+
+文档维护时，前端用法更新现有 `microi.doc/docs/doc/v8-engine/v8-client.md`，后端用法更新现有 `microi.doc/docs/doc/v8-engine/v8-server.md`；不要新建重复的 V8.Http 文档页面或路由。只维护中文 `docs/doc/`，英文 `docs/en/` 由官网统一翻译生成。
 
 <!-- microi-progressive:begin -->
 <!-- microi-progressive:chunk id=v8-http-integration-000 sha256=c5600510764ba7a160557ef9acd34719d1ab8c65acf635f3d4183ed5ab2e2e1f -->
@@ -17,87 +17,87 @@ description: Microi V8 HTTP 集成指南。用于通过 V8.Http.Get/Post/Patch
 
 | 方法 | 说明 | 返回值 |
 |------|------|--------|
-| `V8.Http.Get({...})` | GET 请求 | 字符串（响应体） |
-| `V8.Http.Post({...})` | POST 请求 | 字符串（响应体） |
-| `V8.Http.Patch({...})` | PATCH 请求 | 字符串（响应体） |
-| `V8.Http.GetResponse({...})` | GET（完整响应） | `{ Content, Headers, StatusCode }` |
-| `V8.Http.PostResponse({...})` | POST（完整响应） | `{ Content, Headers, StatusCode }` |
-| `V8.Http.PatchResponse({...})` | PATCH（完整响应） | `{ Content, Headers, StatusCode }` |
-
-后端接口引擎还提供真实异步方法：
-
-| 方法 | 说明 |
-|------|------|
-| `await V8.Http.GetAsync({...})` | 异步 GET，返回响应字符串 |
-| `await V8.Http.PostAsync({...})` | 异步 POST，返回响应字符串 |
-| `await V8.Http.PatchAsync({...})` | 异步 PATCH，返回响应字符串 |
-| `await V8.Http.GetResponseAsync({...})` | 异步 GET，返回完整响应 |
-| `await V8.Http.PostResponseAsync({...})` | 异步 POST，返回完整响应 |
-| `await V8.Http.PatchResponseAsync({...})` | 异步 PATCH，返回完整响应 |
-| `await V8.Http.GetStreamAsync({...})` | 异步获取响应流，供当前请求内继续处理 |
-
-前端与后端统一使用 PascalCase 对象参数格式。执行模型不同：后端既可调用同步方法，也可在本次请求内调用显式 `*Async` 方法并 `await`；前端浏览器调用无 `Async` 后缀的方法，但必须 `await` 其 `Promise`。旧版前端 `V8.Post/Get` 继续兼容，不得删除。
-
-```javascript
-// 后端接口引擎：请求内异步 I/O
-var resp = await V8.Http.PostResponseAsync({
-  Url: 'https://api.example.com/orders',
-  PostParam: { OrderNo: V8.Param.orderNo },
-  ParamType: 'json',
-  Timeout: 10
-});
-if (resp.StatusCode < 200 || resp.StatusCode >= 300) {
-  return { Code: 0, Msg: '上游接口调用失败' };
-}
-```
-
-异步方法只保证当前请求内等待完成，不能替代 Job、MQ、outbox 或平台后台任务。不得用未等待的 Promise、`setTimeout` 或 `Task.Run` 实现“响应后继续处理”。
-
-通用参数：
-
-| 参数 | 说明 |
-|---|---|
-| `Url` | 必传。后端通常使用绝对地址；前端支持相对当前 `ApiBase` 的地址和绝对地址。 |
-| `GetParam` | URL 查询参数；GET、POST、PATCH 均可使用。 |
-| `PostParam` / `PatchParam` | POST / PATCH 对象请求体。 |
-| `PostParamString` / `PatchParamString` | 已序列化的 JSON 或 XML 请求体，嵌套 JSON 优先使用。 |
-| `ParamType` | `form`（默认）、`json`、`xml`、`binary`。 |
-| `Timeout` / `TimeOut` | 超时秒数；默认 `600` 秒（10 分钟）。 |
-| `Headers` / `Header` | 请求头对象，两种参数名兼容。 |
-| `FilesByteBase64` / `FilesByteString` | 文件字段对象，键同时作为字段名和文件名。 |
-
-`GetResponse/PostResponse/PatchResponse` 返回 `Content`、`Headers`、`RawBytes`、`StatusCode`、`ErrorMessage`。后端 `RawBytes` 是 `.NET byte[]`，前端是 `Uint8Array`。
-
+| `V8.Http.Get({...})` | GET 请求 | 字符串（响应体） |
+| `V8.Http.Post({...})` | POST 请求 | 字符串（响应体） |
+| `V8.Http.Patch({...})` | PATCH 请求 | 字符串（响应体） |
+| `V8.Http.GetResponse({...})` | GET（完整响应） | `{ Content, Headers, StatusCode }` |
+| `V8.Http.PostResponse({...})` | POST（完整响应） | `{ Content, Headers, StatusCode }` |
+| `V8.Http.PatchResponse({...})` | PATCH（完整响应） | `{ Content, Headers, StatusCode }` |
+
+后端接口引擎还提供真实异步方法：
+
+| 方法 | 说明 |
+|------|------|
+| `await V8.Http.GetAsync({...})` | 异步 GET，返回响应字符串 |
+| `await V8.Http.PostAsync({...})` | 异步 POST，返回响应字符串 |
+| `await V8.Http.PatchAsync({...})` | 异步 PATCH，返回响应字符串 |
+| `await V8.Http.GetResponseAsync({...})` | 异步 GET，返回完整响应 |
+| `await V8.Http.PostResponseAsync({...})` | 异步 POST，返回完整响应 |
+| `await V8.Http.PatchResponseAsync({...})` | 异步 PATCH，返回完整响应 |
+| `await V8.Http.GetStreamAsync({...})` | 异步获取响应流，供当前请求内继续处理 |
+
+前端与后端统一使用 PascalCase 对象参数格式。执行模型不同：后端既可调用同步方法，也可在本次请求内调用显式 `*Async` 方法并 `await`；前端浏览器调用无 `Async` 后缀的方法，但必须 `await` 其 `Promise`。旧版前端 `V8.Post/Get` 继续兼容，不得删除。
+
+```javascript
+// 后端接口引擎：请求内异步 I/O
+var resp = await V8.Http.PostResponseAsync({
+  Url: 'https://api.example.com/orders',
+  PostParam: { OrderNo: V8.Param.orderNo },
+  ParamType: 'json',
+  Timeout: 10
+});
+if (resp.StatusCode < 200 || resp.StatusCode >= 300) {
+  return { Code: 0, Msg: '上游接口调用失败' };
+}
+```
+
+异步方法只保证当前请求内等待完成，不能替代 Job、MQ、outbox 或平台后台任务。不得用未等待的 Promise、`setTimeout` 或 `Task.Run` 实现“响应后继续处理”。
+
+通用参数：
+
+| 参数 | 说明 |
+|---|---|
+| `Url` | 必传。后端通常使用绝对地址；前端支持相对当前 `ApiBase` 的地址和绝对地址。 |
+| `GetParam` | URL 查询参数；GET、POST、PATCH 均可使用。 |
+| `PostParam` / `PatchParam` | POST / PATCH 对象请求体。 |
+| `PostParamString` / `PatchParamString` | 已序列化的 JSON 或 XML 请求体，嵌套 JSON 优先使用。 |
+| `ParamType` | `form`（默认）、`json`、`xml`、`binary`。 |
+| `Timeout` / `TimeOut` | 超时秒数；默认 `600` 秒（10 分钟）。 |
+| `Headers` / `Header` | 请求头对象，两种参数名兼容。 |
+| `FilesByteBase64` / `FilesByteString` | 文件字段对象，键同时作为字段名和文件名。 |
+
+`GetResponse/PostResponse/PatchResponse` 返回 `Content`、`Headers`、`RawBytes`、`StatusCode`、`ErrorMessage`。后端 `RawBytes` 是 `.NET byte[]`，前端是 `Uint8Array`。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-http-integration-001 sha256=4cbbdd385e24d19413b7534665333c07f2516067e9f34aa40e6adabe9e0506f4 -->
-## V8.AI 与底层 HTTP
-
-- 前端 V8 的平台 AI 普通调用优先 `await V8.AI.Chat(...)`。它自动使用当前 ApiBase 和平台登录头、接收响应 Token 轮换，并清除调用参数中的租户、身份、Endpoint、ApiKey 和认证头覆盖；只有确认问题适合进入 URL 日志时才用 `V8.AI.ChatGet(...)`。
-- 浏览器打字机效果使用 `await V8.AI.ChatStream(param, onChunk, { Signal })`。它解析 `message/result/error/done` SSE，`onChunk` 接收真实增量；页面关闭时通过 `AbortController` 取消读取。
-- 后端 V8 直接使用 `await V8.AI.Chat(...)`、`ChatStream(...)`、`NL2SQL(...)` 或管理员限定的 `NL2V8(...)`。对象在服务端绑定当前 `OsClient` 与认证用户，匿名上下文拒绝；禁止退回到自请求当前 API、转发 Token 或接受用户指定 Endpoint/ApiKey 的包装方式。
-- MCP 使用专用 `microi_chat`，由 MCP 连接提供 Token 与租户，只接受对话白名单参数并返回最终 `DosResult`。它不是逐 token MCP 流；其它平台写操作继续使用对应写 Tool 的确认与回读规则。
-- `Chat/ChatStream` 虽兼容 GET/POST，含问题、附件和会话上下文时一律优先 POST，避免敏感内容进入 URL、代理日志和浏览器历史。`V8.Http` 继续用于通用第三方 HTTP 集成，不要重复实现平台 AI 的认证或 SSE 解析器。
-
-```javascript
-// 前端或后端 V8：普通 AI 对话
-var result = await V8.AI.Chat({
-  UserChatMsg: '归纳当前工单',
-  AiModel: 'MiniMax-M3',
-  AiModelId: '当前租户启用的 mic_ai 记录Id'
-});
-if (result.Code != 1) V8.Tips(result.Msg || 'AI调用失败', false);
-else V8.Result = result.Data;
-```
-
-完整授权矩阵、SSE、后端安全边界与 MCP 示例维护在官网现有 `system-engine/ai-engine.md`，不要新建重复文档。
-
+## V8.AI 与底层 HTTP
+
+- 前端 V8 的平台 AI 普通调用优先 `await V8.AI.Chat(...)`。它自动使用当前 ApiBase 和平台登录头、接收响应 Token 轮换，并清除调用参数中的租户、身份、Endpoint、ApiKey 和认证头覆盖；只有确认问题适合进入 URL 日志时才用 `V8.AI.ChatGet(...)`。
+- 浏览器打字机效果使用 `await V8.AI.ChatStream(param, onChunk, { Signal })`。它解析 `message/result/error/done` SSE，`onChunk` 接收真实增量；页面关闭时通过 `AbortController` 取消读取。
+- 后端 V8 直接使用 `await V8.AI.Chat(...)`、`ChatStream(...)`、`NL2SQL(...)` 或管理员限定的 `NL2V8(...)`。对象在服务端绑定当前 `OsClient` 与认证用户，匿名上下文拒绝；禁止退回到自请求当前 API、转发 Token 或接受用户指定 Endpoint/ApiKey 的包装方式。
+- MCP 使用专用 `microi_chat`，由 MCP 连接提供 Token 与租户，只接受对话白名单参数并返回最终 `DosResult`。它不是逐 token MCP 流；其它平台写操作继续使用对应写 Tool 的确认与回读规则。
+- `Chat/ChatStream` 虽兼容 GET/POST，含问题、附件和会话上下文时一律优先 POST，避免敏感内容进入 URL、代理日志和浏览器历史。`V8.Http` 继续用于通用第三方 HTTP 集成，不要重复实现平台 AI 的认证或 SSE 解析器。
+
+```javascript
+// 前端或后端 V8：普通 AI 对话
+var result = await V8.AI.Chat({
+  UserChatMsg: '归纳当前工单',
+  AiModel: 'MiniMax-M3',
+  AiModelId: '当前租户启用的 mic_ai 记录Id'
+});
+if (result.Code != 1) V8.Tips(result.Msg || 'AI调用失败', false);
+else V8.Result = result.Data;
+```
+
+完整授权矩阵、SSE、后端安全边界与 MCP 示例维护在官网现有 `system-engine/ai-engine.md`，不要新建重复文档。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-http-integration-002 sha256=14439c586d3379c6976513df7b3c0b2f9d586ceb4d845d6f6a1abdcb1d58705a -->
-## POST 请求（对象参数格式）
+## POST 请求（对象参数格式）
+
+> V8 接口引擎中必须使用对象参数格式。尤其禁止 `V8.Http.Get(url)`：当前 .NET 同名重载包含 `Task<string> Get(string)`，Jint 可能把字符串调用解析为异步重载，脚本最终拿到 `[object Promise]`。GET 必须写成 `V8.Http.Get({ Url: url })`；第三方登录、微信 `jscode2session`、AccessToken 等链路保存后必须用无效 code 烟测，确认返回的是第三方明确错误而不是 Promise。
 
-> V8 接口引擎中必须使用对象参数格式。尤其禁止 `V8.Http.Get(url)`：当前 .NET 同名重载包含 `Task<string> Get(string)`，Jint 可能把字符串调用解析为异步重载，脚本最终拿到 `[object Promise]`。GET 必须写成 `V8.Http.Get({ Url: url })`；第三方登录、微信 `jscode2session`、AccessToken 等链路保存后必须用无效 code 烟测，确认返回的是第三方明确错误而不是 Promise。
-
-第三方授权链路还必须把身份交换、AccessToken、用户资料/手机号交换拆成独立阶段。每阶段分别捕获 HTTP 异常和第三方业务 `errcode/errmsg`，失败时写带追踪号的脱敏系统日志并把明确原因返回前端；禁止只在最外层返回固定“登录失败”。
+第三方授权链路还必须把身份交换、AccessToken、用户资料/手机号交换拆成独立阶段。每阶段分别捕获 HTTP 异常和第三方业务 `errcode/errmsg`，失败时写带追踪号的脱敏系统日志并把明确原因返回前端；禁止只在最外层返回固定“登录失败”。
 
 ```javascript
 // POST JSON（推荐使用对象参数格式）
@@ -105,36 +105,36 @@ var result = V8.Http.Post({
   Url: 'https://api.example.com/users',          // 必传
   PostParam: { name: '张三', phone: '13800001234' }, // form 参数（不支持多级嵌套）
   ParamType: 'json',           // 请求类型：默认 form，可选 json / xml
-  Timeout: 600,                // 超时秒数，默认 600 秒（10 分钟）
+  Timeout: 600,                // 超时秒数，默认 600 秒（10 分钟）
   Headers: { Authorization: 'Bearer ' + token }  // 请求头
 });
-var data = JSON.parse(result);
-```
-
+var data = JSON.parse(result);
+```
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-http-integration-003 sha256=4c7c1346ea1e17b2c2ff096f1cc9b6502ae95b73087f62bc6b3531d01297eddf -->
-## PATCH 请求
-
-PATCH 与 POST 的参数完全对称，只需把请求体参数改为 `PatchParam` / `PatchParamString`：
-
-```javascript
-// 后端接口引擎：同步返回字符串
-var result = V8.Http.Patch({
-  Url: 'https://api.example.com/users/123',
-  PatchParamString: JSON.stringify({ profile: { name: '新名字' } }),
-  ParamType: 'json',
-  Timeout: 10,
-  Headers: { Authorization: 'Bearer ' + token }
-});
-var data = JSON.parse(result);
-
-// 前端 V8：参数相同，但浏览器请求必须 await
-var result = await V8.Http.Patch({
-  Url: '/api/users/123',
-  PatchParam: { Status: 1 },
-  ParamType: 'json'
-});
-```
+## PATCH 请求
+
+PATCH 与 POST 的参数完全对称，只需把请求体参数改为 `PatchParam` / `PatchParamString`：
+
+```javascript
+// 后端接口引擎：同步返回字符串
+var result = V8.Http.Patch({
+  Url: 'https://api.example.com/users/123',
+  PatchParamString: JSON.stringify({ profile: { name: '新名字' } }),
+  ParamType: 'json',
+  Timeout: 10,
+  Headers: { Authorization: 'Bearer ' + token }
+});
+var data = JSON.parse(result);
+
+// 前端 V8：参数相同，但浏览器请求必须 await
+var result = await V8.Http.Patch({
+  Url: '/api/users/123',
+  PatchParam: { Status: 1 },
+  ParamType: 'json'
+});
+```
 
 ### POST 嵌套 JSON 对象
 

package/skills/v8-http-integration/references/progressive-01-get-/350/257/267/346/261/202.md

@@ -21,7 +21,7 @@ var data = JSON.parse(result);
 ## 获取完整响应（含状态码和响应头）
 
 ```javascript
-var resp = V8.Http.PostResponse({
+var resp = V8.Http.PostResponse({
   Url: 'https://api.example.com/submit',
   PostParamString: JSON.stringify({ orderId: V8.Param.orderId }),
   ParamType: 'json'
@@ -34,38 +34,38 @@ if (resp.StatusCode !== 200) {
 // resp.Headers — 响应头数组 [{ Name: '', Value: '' }]
 // resp.StatusCode — HTTP 状态码
 
-var data = JSON.parse(resp.Content);
-```
-
-PATCH 完整响应写法相同：
-
-```javascript
-var resp = V8.Http.PatchResponse({
-  Url: 'https://api.example.com/users/123',
-  PatchParam: { status: 'enabled' },
-  ParamType: 'json'
-});
-```
-
-前端调用时写为 `await V8.Http.PostResponse(...)` 或 `await V8.Http.PatchResponse(...)`。
-
-### 后端 SSRF 与重定向边界
-
-- 严格 SSRF 防护默认关闭；未配置时完全保留历史行为，不限制协议、URL 内嵌凭据、回环、私网、链路本地或云元数据地址，并继续自动处理重定向。
-- 只有在 SaaS 引擎主租户启用 `SsrfProtectionEnabled` 后，后端才只允许 HTTP(S)，拒绝 URL 内嵌凭据、回环、私网、链路本地、云元数据和其它特殊地址，并禁止自动跟随 3xx。
-- 严格模式需要跳转时读取完整响应的 `StatusCode` / `Headers`，经业务判断后显式发起下一次调用，使每一跳重新校验。
-- 严格模式的 SaaS 字段 `SsrfAllowedHosts` 只能加入受控且固定的精确主机，不接受用户输入，不要配置通配。
-- DNS 校验不能代替网络层出站 ACL。生产环境还应在容器、主机或网关阻断云元数据和非必要私网段。
-
+var data = JSON.parse(resp.Content);
+```
+
+PATCH 完整响应写法相同：
+
+```javascript
+var resp = V8.Http.PatchResponse({
+  Url: 'https://api.example.com/users/123',
+  PatchParam: { status: 'enabled' },
+  ParamType: 'json'
+});
+```
+
+前端调用时写为 `await V8.Http.PostResponse(...)` 或 `await V8.Http.PatchResponse(...)`。
+
+### 后端 SSRF 与重定向边界
+
+- 严格 SSRF 防护默认关闭；未配置时完全保留历史行为，不限制协议、URL 内嵌凭据、回环、私网、链路本地或云元数据地址，并继续自动处理重定向。
+- 只有在 SaaS 引擎主租户启用 `SsrfProtectionEnabled` 后，后端才只允许 HTTP(S)，拒绝 URL 内嵌凭据、回环、私网、链路本地、云元数据和其它特殊地址，并禁止自动跟随 3xx。
+- 严格模式需要跳转时读取完整响应的 `StatusCode` / `Headers`，经业务判断后显式发起下一次调用，使每一跳重新校验。
+- 严格模式的 SaaS 字段 `SsrfAllowedHosts` 只能加入受控且固定的精确主机，不接受用户输入，不要配置通配。
+- DNS 校验不能代替网络层出站 ACL。生产环境还应在容器、主机或网关阻断云元数据和非必要私网段。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-http-integration-006 sha256=b5e8b317857ac4d81818ba230dadd927d12ef9cddb989921bdbeffe8e96527a3 -->
-## 前端 V8 行为与兼容性
-
-- 前端新代码应优先使用 `await V8.Http.Get/Post/Patch`，参数与后端一致；不要再把 `V8.Post/Get` 作为新功能首选。旧 `V8.Post/Get` 仅作为兼容 API 保留，其回调和 Promise 写法保持不变。
-- 相对地址或当前 `ApiBase` 地址会沿用吾码登录头，并接收响应中的新 `authorization`；第三方绝对地址不会自动携带吾码 Token，避免凭据泄漏。
-- 浏览器请求第三方地址受 CORS 限制；这是浏览器安全策略，后端 `V8.Http` 不受浏览器 CORS 限制。
-- 前端字符串方法同后端一样返回原始响应文本，不会自动 `JSON.parse`；需要对象时显式解析。
-- 浏览器端不支持后端的 `FilesStream`，可使用 `FilesByteBase64`、`FilesByteString` 或 `FilesByte`。
+## 前端 V8 行为与兼容性
+
+- 前端新代码应优先使用 `await V8.Http.Get/Post/Patch`，参数与后端一致；不要再把 `V8.Post/Get` 作为新功能首选。旧 `V8.Post/Get` 仅作为兼容 API 保留，其回调和 Promise 写法保持不变。
+- 相对地址或当前 `ApiBase` 地址会沿用吾码登录头，并接收响应中的新 `authorization`；第三方绝对地址不会自动携带吾码 Token，避免凭据泄漏。
+- 浏览器请求第三方地址受 CORS 限制；这是浏览器安全策略，后端 `V8.Http` 不受浏览器 CORS 限制。
+- 前端字符串方法同后端一样返回原始响应文本，不会自动 `JSON.parse`；需要对象时显式解析。
+- 浏览器端不支持后端的 `FilesStream`，可使用 `FilesByteBase64`、`FilesByteString` 或 `FilesByte`。
 
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-http-integration-007 sha256=92a9eea0bf36292444a9aae6cc73c91eda6e9b5d8d8ce78f6b8ca50cc47c28f8 -->

package/skills/v8-http-integration/references/progressive-02-/351/224/231/350/257/257/345/244/204/347/220/206/346/250/241/345/274/217.md

@@ -31,11 +31,11 @@ try {
 <!-- microi-progressive:chunk id=v8-http-integration-012 sha256=5be87e89ec429dd9b79e89014485b7745c2a400f2066d0d989f71c9779de32fc -->
 ## 注意事项
 
-- `V8.Http.Post` 的 `PostParam` 不支持多级嵌套对象，嵌套需用 `PostParamString`
-- `V8.Http.Patch` 的 `PatchParam` 不支持多级嵌套对象，嵌套需用 `PatchParamString`
-- `Headers` 参数也可以写成 `Header`（两者等效）
-- 前端 `V8.Http` 必须使用 `await`；后端接口引擎无需 `await`
-- 旧版前端 `V8.Post/Get` 是兼容 API，不能删除；但新代码必须优先使用 `V8.Http`
+- `V8.Http.Post` 的 `PostParam` 不支持多级嵌套对象，嵌套需用 `PostParamString`
+- `V8.Http.Patch` 的 `PatchParam` 不支持多级嵌套对象，嵌套需用 `PatchParamString`
+- `Headers` 参数也可以写成 `Header`（两者等效）
+- 前端 `V8.Http` 必须使用 `await`；后端接口引擎无需 `await`
+- 旧版前端 `V8.Post/Get` 是兼容 API，不能删除；但新代码必须优先使用 `V8.Http`
 - 第三方 API 密钥建议存在 `V8.OsClientModel`（SaaS 引擎）中，不要硬编码
 - 调用外部接口应加 try-catch，第三方服务不可控
 - 对于需要缓存的 token（如微信 access_token），使用 `V8.Cache` 避免频繁请求