flycode-mcp 1.9.2 → 1.11.0

package/README.md

@@ -10,8 +10,8 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for the
 
 - 基于官方 `@modelcontextprotocol/sdk` 实现，使用标准 `stdio` 传输协议。
 - 启动即完成 APaaS IDE 平台鉴权链路：账号登录 → 获取租户信息 → 获取 IDE Token。
-- 内置统一请求层 `request`，自动按请求类型（`center` / `tenant`）切换中心服务地址与当前租户连接地址，并自动注入鉴权 Token。
-- 当前提供工具：业务逻辑类 `page_model_logic_list`（分页查询业务逻辑列表）、`get_model_logic`（查询单个业务逻辑详情）、`save_model_logic`（保存 / 更新业务逻辑完整 JSON）、`simple_save_flycode_model_logic`（轻量保存 flycode 业务逻辑，只传 `modelLogicCode` / `flycode` / 可选 `input` / `output`）；实体类 `page_entity_list`（分页查询实体列表）、`get_entity`（查询实体详情）；表单 / 页面类 `page_form_list`（分页查询表单 / 页面列表）、`get_form`（查询表单 / 页面详情）；函数类 `page_function_list`（分页查询 flycode 函数列表）、`get_function`（查询 flycode 函数详情，含 `confjson` 函数代码内容）；数据库函数类 `page_database_function_list`（分页查询 PostgreSQL 自定义数据库函数列表，列表结果随行返回函数体 `functionscript`）；SQL 执行类 `run_sql`（在业务库中执行一条 SELECT 查询，返回查询结果数据与结果总数）；通用类 `generate_unique_code`（生成唯一编码，用于新建实体 / 领域 / 表单时生成 JSON 中的 `code` 字段）。
+- 内置统一请求层 `request`，自动按请求类型（`center` / `tenant` / `business`）切换中心服务地址、当前租户连接地址或当前租户业务地址，并自动注入鉴权 Token：`business` 类型主要用于 H5 表单查询（需以特定预览账号 token 发起）。
+- 当前提供工具：业务逻辑类 `page_model_logic_list`（分页查询业务逻辑列表）、`get_model_logic`（查询单个业务逻辑详情）、`save_model_logic`（保存 / 更新业务逻辑完整 JSON）、`simple_save_flycode_model_logic`（轻量保存 flycode 业务逻辑，只传 `modelLogicCode` / `flycode` / 可选 `input` / `output`）；实体类 `page_entity_list`（分页查询实体列表）、`get_entity`（查询实体详情）；表单 / 页面类 `page_form_list`（分页查询表单 / 页面列表）、`get_form`（查询表单 / 页面详情）；H5 表单类 `page_h5_form`（分页查询 H5 表单列表）、`get_h5_form`（查询 H5 表单详情，含 `confjson` 内容 JSON）；函数类 `page_function_list`（分页查询 flycode 函数列表）、`get_function`（查询 flycode 函数详情，含 `confjson` 函数代码内容）；数据库函数类 `page_database_function_list`（分页查询 PostgreSQL 自定义数据库函数列表，列表结果随行返回函数体 `functionscript`）；SQL 执行类 `run_sql`（在业务库中执行一条 SELECT 查询，返回查询结果数据与结果总数）；通用类 `generate_unique_code`（生成唯一编码，用于新建实体 / 领域 / 表单时生成 JSON 中的 `code` 字段）。
 
 ---
 
@@ -28,14 +28,17 @@ A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for the
 # 安装依赖
 npm install
 
-# 编译 TypeScript 到 dist/
+# 类型校验(tsc -p tsconfig.json，tsconfig 设 noEmit) + esbuild 经 scripts/build.mjs 打包压缩为单文件 dist/flycode-mcp.min.js
 npm run build
 
-# 或者直接用 ts-node 启动开发模式（自动监听编译）
+# 仅做类型校验（不产出）
+npm run typecheck
+
+# 开发模式：esbuild --watch 持续重建产物
 npm run dev
 ```
 
-构建产物位于 `dist/`，入口为 `dist/index.js`（已在 `package.json` 的 `bin` 中注册为 `flycode-mcp`）。
+构建产物为单个压缩文件 `dist/flycode-mcp.min.js`（已在 `package.json` 的 `bin` 中注册为 `flycode-mcp`；minify 后折叠为单行以减小体积，运行时依赖 `@modelcontextprotocol/sdk` / `axios` / `zod` 保持外置）。
 
 ---
 
@@ -283,7 +286,128 @@ username=<账号>&password=<密码>&tenantCode=<租户号>&envName=<环境名>
 - `pageswitch`：仅 switchpage 类型才有的页面切换配置（`mode` / `menu` / `pagerefs` / `eventlist`）
 - `message`：每次保存填写的提交信息（类似 git 提交信息）
 
-> 注：工具的 `description` 中附有「字段速查」，列出了各顶层对象的关键字段与编码枚举含义（如 `pageinfo.type` 页面类型、`marktype` 创建标记、`clientcategorycode` 用户端等），便于理解返回 JSON。详情类型的字段定义见 `src/clients/formClient.ts`（`FormResult` / `FormPageInfo` / `FormViewNode` / `FormControl` 等接口）。
+> 注：工具的 `description` 中附有「字段速查」，列出了各顶层对象的关键字段与编码枚举含义（如 `pageinfo.type` 页面类型、`marktype` 创建标记、`clientcategorycode` 用户端等），便于理解返回 JSON。详情类型的字段定义见 `src/clients/form.ts`（`FormResult` / `FormPageInfo` / `FormViewNode` / `FormControl` 等接口）。
+
+### `get_form_outline` — 查询表单 / 页面骨架
+
+获取表单 / 页面的轻量骨架（地址簿 / 决策依据），约 2–4KB，避免为日常改动拉取完整 88KB 的表单 JSON（只读、幂等）。底层调用 `service/form.ts` 的 `getFormOutline`。
+
+**输入参数：**
+
+| 参数   | 类型   | 必填 | 说明                             |
+| ------ | ------ | ---- | -------------------------------- |
+| `code` | string | 是   | 要查骨架的表单 / 页面的唯一编码 |
+
+**返回：** `pageinfo` 关键字段、`viewTree`（递归骨架，仅 `code` / `type` / `title` + `children`）、`handlers` 与 `interfaces` 清单、`businessModels`（仅逻辑名，不回内容）。
+
+> 用途：在不知道全量内容时先拿到所有可改对象的 `code`，避免 `NODE_NOT_FOUND` 盲猜；随后用 `get_form_fragment` 看局部真实属性名，再用 `patch_form` 修改。
+
+### `get_form_fragment` — 查询表单 / 页面局部内容
+
+按 `code` 取表单的局部内容（几 KB），避免为改一处而拉完整 88KB 表单 JSON（只读、幂等）。三种寻址方式三选一，可组合。底层调用 `service/form.ts` 的 `getFormFragment`。
+
+**输入参数：**
+
+| 参数          | 类型   | 必填 | 说明                                                                            |
+| ------------- | ------ | ---- | ------------------------------------------------------------------------------- |
+| `code`        | string | 是   | 表单 / 页面的唯一编码                                                           |
+| `nodeCode`    | string | 否   | 目标控件 / 节点编码，返回其完整子树                                             |
+| `handlerCode` | string | 否   | 目标 presenter 处理器编码，返回其完整定义与 `actionIndex` 清单                  |
+| `section`     | string | 否   | 整段 `pageinfo` / `view` / `presenter` / `controls` / `pageswitch` / `businessmodel` |
+
+**返回：** 命中的 `node` / `handler` / `section`，以及 `actionIndex`（每个 action 的 `code` / `type` 与 `script` / `condition` / `expression` 长度），便于精确构造 `patch_form` 的 `replace_script`。
+
+### `patch_form` — 局部补丁修改表单 / 页面
+
+以结构化补丁（delta ops）局部修改表单 / 页面，**无需回传完整 88KB 的表单 JSON**（非只读、有事务性保护）。底层调用 `service/form.ts` 的 `patchForm`：先拉取最新完整对象 → 在内存副本上按 `ops` 顺序合并 → 一次性保存到 `POST /biserv/bizpage/saveNewPage`。
+
+**输入参数：**
+
+| 参数            | 类型    | 必填 | 说明                                                      |
+| --------------- | ------- | ---- | --------------------------------------------------------- |
+| `code`          | string  | 是   | 目标表单 / 页面的唯一编码                                 |
+| `ops`           | array   | 是   | 补丁操作数组，至少一个元素；9 类见下表，按数组顺序依次作用 |
+| `commitMessage` | object  | 是   | 提交信息，结构与 `save_model_logic` 的 `commitMessage` 一致 |
+| `dryRun`        | boolean | 否   | 只预演输出 diff、不落库，默认 `false`                      |
+| `verify`        | boolean | 否   | 保存后回读校验改动是否生效，默认 `true`                    |
+
+**9 类 ops：**
+
+| op                     | 关键参数                                                                | 说明                                                                        |
+| ---------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `set_pageinfo`         | `patch`                                                                 | 浅合并进 pageinfo（如改标题 / 状态）                                        |
+| `set_attrs`            | `code`、`patch`                                                         | 按 `code` 定位节点，浅合并属性（如 `hidden` / `required`）                  |
+| `insert_node`          | `parentCode`、`node`、`position?`                                       | 在父节点下插入新节点                                                        |
+| `remove_node`          | `code`、`checkRefs?`                                                    | 按 `code` 删除节点，默认校验引用                                            |
+| `move_node`            | `code`、`newParentCode`、`position?`                                    | 移动节点到新父节点下                                                        |
+| `set_section`          | `section`、`value`                                                      | 整段替换 `view` / `presenter` / `controls` / `pageswitch`                   |
+| `replace_script`       | `handlerCode`、`actionIndex?` / `actionCode?`、`field?`、`replacement?` / `ops?` | 改 action 的 `script` / `condition` / `expression`，支持整段覆盖或 old→new 局部替换 |
+| `add_businessmodel`    | `modellogiccode`、`overwrite?`                                          | 仅给逻辑编码，MCP 自动拉取其完整 JSON 追加到 `businessmodel`                |
+| `remove_businessmodel` | `modellogiccode`、`checkRefs?`                                          | 从 `businessmodel` 移除指定逻辑                                             |
+
+**事务性：** 全部 `op` 预演成功才会落库，任一 `op` 失败（`NODE_NOT_FOUND` / `DUP_CODE` / `REF_VIOLATION` / `FETCH_FAILED`）则整批中止、零写入回滚；整批只发起一次保存请求，不存在写一半的中间态。
+
+**返回：** `ok` / `applied` / `verified` / `errorCode` / `message` / `diff` / `ops[]`，其中 `ops[].suggestions` 在 `NOT_FOUND` 时给出相似候选。
+
+> 错误码：`OK` / `DRY_RUN` / `EMPTY_OPS` / `FETCH_FAILED` / `NODE_NOT_FOUND` / `DUP_CODE` / `REF_VIOLATION` / `OPS_FAILED` / `SAVE_FAILED` / `VERIFY_FAILED`。
+
+### `save_form` — 全量保存表单 / 页面
+
+整页重构（重排布局、模板迁移等）时没有其他表达方式，才用本工具：把从 `get_form` 查询到的完整 `FormResult` 对象按需修改后整份回传保存（非只读）。底层调用 `service/form.ts` 的 `saveForm` → `POST /biserv/bizpage/saveNewPage`。日常局部改动请优先用 `patch_form`。
+
+**输入参数：**
+
+| 参数            | 类型   | 必填 | 说明                                                           |
+| --------------- | ------ | ---- | -------------------------------------------------------------- |
+| `form`          | object | 是   | 完整的 `FormResult` 对象，通常来自 `get_form` 的返回，改后回传  |
+| `commitMessage` | object | 是   | 提交信息，结构与 `save_model_logic` 的 `commitMessage` 一致      |
+
+**返回：** `ok` / `code` / `message`。
+
+> 注：保存接口 `conf` / `ui` 要求传入完整对象，故 `businessmodel`（完整 `LogicResult[]`）**原样透传、不剥离**；`message` 作为顶层提交参数传入，不是 `FormResult` 内部的 `message` 字段。服务端按 `overwrite: false` 保存（不覆盖他人最新版本），`clearuserconfig` 默认 `true`。
+
+### `page_h5_form` — 分页查询 H5 表单列表
+
+根据查询条件分页查询智慧100 H5 引擎配置的 H5 表单列表（只读、幂等）。底层调用 `h5Client.pageH5List`（接口 `POST /api/masterserv/hpage/listH5Page`）。
+
+> 说明：列表结果**不包含** `confjson` 字段（该字段为 H5 表单的内容 JSON，体积较大）；如需获取表单的 `confjson`（含 Vue 代码与元数据配置），请调用 `get_h5_form` 获取详情。
+
+**输入参数：**
+
+| 参数            | 类型   | 必填 | 说明                                                                       |
+| --------------- | ------ | ---- | -------------------------------------------------------------------------- |
+| `keywords`      | string | 否   | H5 表单代码及其元数据中包含的关键字，模糊匹配                              |
+| `pagecode`      | string | 否   | H5 表单的唯一编码，模糊匹配                                               |
+| `status`        | string | 否   | 状态，整数：1-启用；2-停用。示例传 `"1"`                                  |
+| `title`         | string | 否   | H5 表单的标题，模糊匹配                                                   |
+| `updateopname`  | string | 否   | 最近修改人姓名，模糊匹配                                                   |
+| `page`          | string | 否   | 当前页，从 1 开始，默认 1                                                  |
+| `rows`          | string | 否   | 每页记录数，默认 20                                                        |
+
+**返回：** H5 表单列表的 JSON（`resp_data`），包含分页信封 `pageCount` / `pageIndex` / `pageSize` / `resultCount`，以及 `data` 数组中每个 H5 表单的基本信息：`pagecode`（唯一编码）/ `title`（标题）/ `status`（状态：1-启用；2-停用）/ `pagedescr`（描述）/ `platstatus`（平台状态）/ `platcreateop` / `platcreatetime` / `platupdateop` / `platupdatetime` 等。字段值可能为 `null`，且 `status` 以字符串或数字两种形态返回。
+
+> 注：当接口返回数据包含 `HTTP 404 Not Found` 时，说明此租户未安装 H5 引擎。该工具以宽松结构（`catchall`）透传服务端返回的额外字段，确保任意列表结果均可正常返回。字段定义见 `src/clients/h5.ts`（`H5PageResult` 接口）。
+
+### `get_h5_form` — 查询 H5 表单详情
+
+根据 H5 表单的唯一编码 `pagecode` 获取其完整详情（只读、幂等），核心内容 `confjson` 为 H5 表单的内容 JSON（含 Vue 代码与元数据配置）。底层调用 `h5Client.getH5`（接口 `POST /api/masterserv/hpage/listH5PageByOne`）。
+
+**输入参数：**
+
+| 参数       | 类型   | 必填 | 说明                       |
+| ---------- | ------ | ---- | -------------------------- |
+| `pagecode` | string | 是   | 要查详情的 H5 表单的唯一编码 |
+
+**返回：** H5 表单详情的 JSON（`resp_data`），主要字段：
+
+- `pagecode` / `title` / `pagedescr`：H5 表单唯一编码、标题、描述
+- `status`：状态（1-启用；2-停用），以字符串或数字返回
+- `confjson`：H5 表单的内容 JSON 字符串，包含 H5 表单的 Vue 代码与元数据配置（核心内容）
+- `platcreateop` / `platcreatetime`：创建人 / 创建时间
+- `platupdateop` / `platupdatetime`：最近更新人 / 最近更新时间
+- `platstatus`：平台状态
+
+> 注：当接口返回数据包含 `HTTP 404 Not Found` 时，说明此租户未安装 H5 引擎。详情类型的字段定义见 `src/clients/h5.ts`（`H5PageResult` 接口）。H5 查询接口需要以特定预览账号（职位为 `SFA系统管理员`）的 token 发起，该鉴权细节由 `service/h5.ts` 自动解析，调用方无需关心。
 
 ### `page_function_list` — 分页查询 flycode 函数列表
 
@@ -322,7 +446,7 @@ username=<账号>&password=<密码>&tenantCode=<租户号>&envName=<环境名>
 - `tablename` / `createtime` / `updatetime` / `createaccountname` / `updateaccountname`：数据库表名（函数一般无对应表，通常为空）、时间戳与创建 / 更新人
 - `confjson`：flycode 函数代码内容，是函数实现体的核心字段
 
-> 注：详情接口返回结构不稳定（部分字段调用时可能缺省），工具以宽松结构（`z.looseObject`）透传服务端返回的额外字段，确保任意详情均可正常返回。字段定义见 `src/clients/functionClient.ts`（`FunctionResult` / `FunctionPageResult` 接口）。
+> 注：详情接口返回结构不稳定（部分字段调用时可能缺省），工具以宽松结构（`z.looseObject`）透传服务端返回的额外字段，确保任意详情均可正常返回。字段定义见 `src/clients/function.ts`（`FunctionResult` / `FunctionPageResult` 接口）。
 
 ### `page_database_function_list` — 分页查询数据库函数列表
 
@@ -341,7 +465,7 @@ username=<账号>&password=<密码>&tenantCode=<租户号>&envName=<环境名>
 
 **返回：** 数据库函数列表的 JSON（`resp_data`），包含分页信封 `pageCount` / `pageIndex` / `pageSize` / `resultCount`，以及 `data` 数组中每个数据库函数的基本信息：`dbfunctionname`（数据库函数名）/ `functionname`（函数中文名）/ `functioncode`（函数唯一编码）/ `functionscript`（数据库函数内容，PostgreSQL 函数体，列表随行返回）/ `metamodelcode`（领域模型编码）/ `marktype`（创建标记：0-平台；1-产品；2-租户）/ `publishstatus`（发布状态：1-已发布；2-未发布）/ `status`（状态：1-启用；2-停用）/ `creator` / `updator` / `createtime` / `updatetime` / `remark` 等。字段值可能为 `null`，且 `marktype` / `publishstatus` / `status` 等部分字段以数字或字符串两种形态返回。
 
-> 注：返回的 `data` 为服务端实际结构透传，工具以宽松结构（`catchall`）保留服务端返回的额外字段，确保任意列表结果均可正常返回。字段定义见 `src/clients/databaseFunctionClient.ts`（`DatabaseFunctionPageParams` / `DatabaseFunctionPageResult` 接口）。
+> 注：返回的 `data` 为服务端实际结构透传，工具以宽松结构（`catchall`）保留服务端返回的额外字段，确保任意列表结果均可正常返回。字段定义见 `src/clients/database-function.ts`（`DatabaseFunctionPageParams` / `DatabaseFunctionPageResult` 接口）。
 
 ### `run_sql` — 执行 SQL 查询
 
@@ -384,17 +508,22 @@ username=<账号>&password=<密码>&tenantCode=<租户号>&envName=<环境名>
 flycode-mcp/
 ├── src/
 │   ├── index.ts                 # 入口：启动鉴权、注册工具、启动 stdio 服务
+│   ├── types.ts                 # 跨模块共用的通用类型（如提交信息 CommitMessage）
 │   ├── service/                 # 业务封装
 │   │   ├── auth.ts              # 登录 → 获取租户信息 → 获取 IDE Token
-│   │   └── logic.ts             # 保存业务逻辑（saveModelLogic / simpleSaveFlyCodeModelLogic / replaceFlyCodeSegments）：提交信息处理 + 局部替换 + 异常兜底
+│   │   ├── logic.ts             # 保存业务逻辑（saveModelLogic / simpleSaveFlyCodeModelLogic / replaceFlyCodeSegments）：提交信息处理 + 局部替换 + 异常兜底
+│   │   ├── form.ts              # 表单骨架 getFormOutline / 局部读取 getFormFragment / 补丁合并引擎 patchForm（9 类 ops，事务性）/ 全量保存 saveForm
+│   │   └── h5.ts                # H5 表单查询鉴权（解析 SFA系统管理员预览账号 token） + 列表/详情查询 service 封装
 │   ├── clients/                 # 平台接口封装
-│   │   ├── authClient.ts        # 登录 / 获取租户信息 / 获取 IDE Token 请求
-│   │   ├── logicClient.ts       # 业务逻辑分页/详情查询、保存请求
-│   │   ├── entityClient.ts      # 实体列表 pageEntityList / 详情 getEntity 请求
-│   │   ├── functionClient.ts    # flycode 函数列表 pageFunctionList、详情 getFunction 请求；FunctionResult 等类型定义
-│   │   ├── databaseFunctionClient.ts # 数据库函数（PostgreSQL 自定义函数）列表 pageDatabaseFunctionList 请求；DatabaseFunctionPageResult 等类型定义
-│   │   ├── formClient.ts        # 表单 / 页面列表 pageFormList、详情 getForm 请求；FormResult 等详情类型定义
-│   │   ├── runClient.ts         # SQL 查询 sqlRun 请求（POST /api/biz/sqlrun）
+│   │   ├── auth.ts              # 登录 / 获取租户信息 / 获取 IDE Token 请求
+│   │   ├── logic.ts             # 业务逻辑分页/详情查询、保存请求；LogicResult 等类型定义
+│   │   ├── entity.ts            # 实体列表 pageEntityList / 详情 getEntity 请求；EntityResult 等类型定义
+│   │   ├── function.ts          # flycode 函数列表 pageFunctionList、详情 getFunction 请求；FunctionResult 等类型定义
+│   │   ├── database-function.ts # 数据库函数（PostgreSQL 自定义函数）列表 pageDatabaseFunctionList 请求；DatabaseFunctionPageResult 等类型定义
+│   │   ├── form.ts              # 表单 / 页面列表 pageFormList、详情 getForm、保存 saveForm（POST /biserv/bizpage/saveNewPage）请求；FormResult 等详情类型定义
+│   │   ├── h5.ts                # H5 表单列表 listH5Page、详情 listH5PageByOne 请求；H5PageResult 等类型定义
+│   │   ├── run.ts               # SQL 查询 sqlRun 请求（POST /api/biz/sqlrun）
+│   │   ├── test-case.ts         # 预览账号列表 getPreviewAccounts 请求（H5 查询鉴权所需的 SFA系统管理员 token 来源）
 │   │   └── types.ts             # 公共响应信封类型（DataResponse / PageResponse / CommonResponse）
 │   ├── store/                   # 运行时内存存储
 │   │   ├── token.ts             # 鉴权 Token 存储器
@@ -409,7 +538,10 @@ flycode-mcp/
 │   │   │   ├── read.ts          # 只读类工具（page_entity_list / get_entity）
 │   │   │   └── schemas.ts       # 实体共享 zod schema（EntityResult / EntityProperty，宽松透传结构）
 │   │   ├── form/
-│   │   │   └── read.ts          # 只读类工具（page_form_list / get_form）
+│   │   │   ├── read.ts          # 只读类工具（page_form_list / get_form / get_form_outline / get_form_fragment）
+│   │   │   └── write.ts         # 写入类工具（patch_form / save_form）
+│   │   ├── h5/
+│   │   │   └── read.ts          # 只读类工具（page_h5_form / get_h5_form）
 │   │   ├── function/
 │   │   │   └── read.ts          # 只读类工具（page_function_list / get_function）
 │   │   ├── database-function/
@@ -438,8 +570,8 @@ flycode-mcp/
 2. **登录**：`service/auth.ts` 中的 `authenticate()` 调用 `/api/multiplat/auth/login` 获取 Token，存入内存。
 3. **定位租户与环境**：`authenticate()` 调用 `/api/multiplat/auth/getTenantInfo`，依据 `tenantCode + envName` 匹配出目标租户，保存其连接信息（`conn.config`）到内存。
 4. **获取 IDE Token**：`authenticate()` 调用 `/api/multiplat/auth/getIdeToken` 换取 IDE 专用 Token 并覆盖内存中的 Token。
-5. **注册并启动**：创建 `McpServer`，注册 `page_model_logic_list`、`get_model_logic`、`save_model_logic`、`simple_save_flycode_model_logic`、`str_replace_flycode`、`page_entity_list`、`get_entity`、`page_form_list`、`get_form`、`page_function_list`、`get_function`、`page_database_function_list`、`run_sql`、`generate_unique_code` 等工具，通过 `StdioServerTransport` 监听请求。
-6. **业务请求**：工具被调用时，`logicClient` / `entityClient` / `formClient` / `functionClient` / `runClient` 通过 `request({ type: "tenant" })` 自动切换到当前租户连接地址，并携带已注入的 Token 发起查询。
+5. **注册并启动**：创建 `McpServer`，注册 `page_model_logic_list`、`get_model_logic`、`save_model_logic`、`simple_save_flycode_model_logic`、`str_replace_flycode`、`page_entity_list`、`get_entity`、`page_form_list`、`get_form`、`get_form_outline`、`get_form_fragment`、`patch_form`、`save_form`、`page_h5_form`、`get_h5_form`、`page_function_list`、`get_function`、`page_database_function_list`、`run_sql`、`generate_unique_code` 等工具，通过 `StdioServerTransport` 监听请求。
+6. **业务请求**：工具被调用时，`logicClient` / `entityClient` / `formClient` / `functionClient` / `runClient` / `h5Client` 通过 `request({ type: "tenant" })` 或 `request({ type: "business" })` 自动切换到当前租户连接地址或业务地址。`h5Client` 的 H5 表单查询需以特定预览账号（职位为 `SFA系统管理员`）的 token 发起，该 token 由 `service/h5.ts` 通过 `test-case.ts` 的预览账号列表接口解析后，以 `request({ type: "business", token })` 显式传入。`request` 在请求头统一注入 Token：若调用方在配置里显式传入 `token`（如 `request({ url, method, type: "business", token: "xxxx" })`），则优先使用该传入 Token；否则回退到内存中的 Token（由 `authenticate()` 写入或通过 `setToken` 设置）。注入后自定义 `token` 字段会被剔除，不会泄漏给后端。
 
 ---