@wukongcrm/mcp-server 0.2.5 → 0.2.6

package/dist/nocode.js

@@ -416,11 +416,11 @@ export const nocodeToolDefinitions = [
 export function createNocodeToolHandlers(config = {}, sharedClient) {
     const client = sharedClient ?? new CrmClient(config);
     return {
-        nocode_list_applications: async () => readonlyResult("/moduleMetadata/customAppList", await client.post("/moduleMetadata/customAppList")),
+        nocode_list_applications: async () => readonlyResult("/moduleMetadata/customAppList", await client.read("/moduleMetadata/customAppList")),
         nocode_get_application: async (args) => {
             const applicationId = requiredId(args.applicationId, "applicationId");
             const targetPath = `/moduleMetadata/queryById/${applicationId}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         },
         nocode_list_modules: async (args) => {
             const applicationId = requiredId(args.applicationId, "applicationId");
@@ -432,17 +432,17 @@ export function createNocodeToolHandlers(config = {}, sharedClient) {
                     : mode === "all"
                         ? `/moduleM/list/${applicationId}`
                         : `/moduleM/released/list/${applicationId}`;
-            return readonlyResult(targetPath, await client.post(targetPath), { mode });
+            return readonlyResult(targetPath, await client.read(targetPath), { mode });
         },
         nocode_get_module: async (args) => {
             const moduleId = requiredId(args.moduleId, "moduleId");
             if (args.version !== undefined) {
                 const version = requiredVersion(args.version);
                 const targetPath = `/moduleM/queryDetail/${moduleId}/${version}`;
-                return readonlyResult(targetPath, await client.post(targetPath));
+                return readonlyResult(targetPath, await client.read(targetPath));
             }
             const targetPath = `/moduleM/queryById/${moduleId}`;
-            return readonlyResult(targetPath, await client.post(targetPath, undefined, { isLatest: args.isLatest ?? true }));
+            return readonlyResult(targetPath, await client.read(targetPath, undefined, { isLatest: args.isLatest ?? true }));
         },
         nocode_get_module_schema: async (args) => {
             const moduleId = requiredId(args.moduleId, "moduleId");
@@ -451,9 +451,9 @@ export function createNocodeToolHandlers(config = {}, sharedClient) {
             // 旧后端会直接拆箱 filterHidden；显式传 false 与无代码前端的字段配置请求保持一致，避免空值触发 500。
             const formQuery = { ...query, filterHidden: false };
             const [fields, form, listHeadOutcome, layout, unionModules] = await Promise.all([
-                client.post("/moduleField/queryList", query),
-                client.post("/moduleField/formList", formQuery),
-                client.post("/moduleField/queryListHead", query)
+                client.read("/moduleField/queryList", query),
+                client.read("/moduleField/formList", formQuery),
+                client.read("/moduleField/queryListHead", query)
                     .then((data) => ({ data, warning: undefined }))
                     .catch((error) => {
                     // 旧端的列表头服务只读取“已发布激活”的模块。新建草稿在字段已经存在时仍会返回 4303，
@@ -466,16 +466,16 @@ export function createNocodeToolHandlers(config = {}, sharedClient) {
                     }
                     throw error;
                 }),
-                client.post(`/moduleM/pageLayout/${moduleId}/${version}`),
-                client.post(`/moduleM/unionModules/${moduleId}/${version}`)
+                client.read(`/moduleM/pageLayout/${moduleId}/${version}`),
+                client.read(`/moduleM/unionModules/${moduleId}/${version}`)
             ]);
             const extended = args.includeExtended === false
                 ? undefined
                 : {
-                    options: await client.post(`/moduleFieldOptions/list/${moduleId}/${version}`),
-                    formulas: await client.post(`/moduleFieldFormula/list/${moduleId}/${version}`),
-                    tags: await client.post(`/moduleFieldTags/list/${moduleId}/${version}`),
-                    serialNumberRules: await client.post(`/moduleFieldSerialNumberRules/list/${moduleId}/${version}`)
+                    options: await client.read(`/moduleFieldOptions/list/${moduleId}/${version}`),
+                    formulas: await client.read(`/moduleFieldFormula/list/${moduleId}/${version}`),
+                    tags: await client.read(`/moduleFieldTags/list/${moduleId}/${version}`),
+                    serialNumberRules: await client.read(`/moduleFieldSerialNumberRules/list/${moduleId}/${version}`)
                 };
             return {
                 readonly: true,
@@ -495,21 +495,21 @@ export function createNocodeToolHandlers(config = {}, sharedClient) {
             const targetPath = `/moduleData/queryPageList/${moduleId}`;
             // 分页上限由工具 schema 控制，不能让透传 payload 绕过顶层的 page/limit 约束。
             const body = cleanObject({ ...safePayload(args.payload), page: args.page ?? 1, limit: args.limit ?? 15 });
-            return readonlyResult(targetPath, await client.post(targetPath, body), { body });
+            return readonlyResult(targetPath, await client.read(targetPath, body), { body });
         },
         nocode_get_record: async (args) => {
             const dataId = requiredId(args.dataId, "dataId");
             const targetPath = `/moduleFieldData/query/${dataId}/${args.replaceMask ?? true}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         },
-        nocode_calculate_formula: async (args) => readonlyResult("/moduleFieldData/calculateFormula", await client.post("/moduleFieldData/calculateFormula", safePayload(args.payload))),
-        nocode_check_duplicate: async (args) => readonlyResult("/moduleFieldData/doubleCheck", await client.post("/moduleFieldData/doubleCheck", safePayload(args.payload))),
+        nocode_calculate_formula: async (args) => readonlyResult("/moduleFieldData/calculateFormula", await client.read("/moduleFieldData/calculateFormula", safePayload(args.payload))),
+        nocode_check_duplicate: async (args) => readonlyResult("/moduleFieldData/doubleCheck", await client.read("/moduleFieldData/doubleCheck", safePayload(args.payload))),
         nocode_list_team_members: async (args) => {
             const moduleId = requiredId(args.moduleId, "moduleId");
             const dataId = requiredId(args.dataId, "dataId");
             const [members, currentUser] = await Promise.all([
-                client.post(`/moduleFieldData/teamMember/${moduleId}/${dataId}`),
-                client.post(`/moduleFieldData/teamMemberInfo/${moduleId}/${dataId}`)
+                client.read(`/moduleFieldData/teamMember/${moduleId}/${dataId}`),
+                client.read(`/moduleFieldData/teamMemberInfo/${moduleId}/${dataId}`)
             ]);
             return { readonly: true, moduleId, dataId, members, currentUser };
         },
@@ -517,9 +517,9 @@ export function createNocodeToolHandlers(config = {}, sharedClient) {
         nocode_list_scenes: async (args) => {
             const moduleId = requiredId(args.moduleId, "moduleId");
             const targetPath = `/moduleScene/list/${moduleId}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         },
-        nocode_list_flows: async (args) => readonlyResult("/moduleFlow/queryFlow", await client.post("/moduleFlow/queryFlow", undefined, safePayload(args.payload))),
+        nocode_list_flows: async (args) => readonlyResult("/moduleFlow/queryFlow", await client.read("/moduleFlow/queryFlow", undefined, safePayload(args.payload))),
         nocode_list_stages: async (args) => {
             let targetPath;
             if (args.dataId !== undefined) {
@@ -528,17 +528,17 @@ export function createNocodeToolHandlers(config = {}, sharedClient) {
             else {
                 targetPath = `/moduleStageSetting/queryList/${requiredId(args.moduleId, "moduleId")}/${requiredVersion(args.version)}`;
             }
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         },
         nocode_list_custom_buttons: async (args) => {
             const targetPath = `/moduleCustomButton/queryList/${requiredId(args.moduleId, "moduleId")}/${requiredVersion(args.version)}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         },
         nocode_list_tabs: async (args) => {
             const targetPath = `/moduleTab/queryList/${requiredId(args.moduleId, "moduleId")}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         },
-        nocode_get_module_file: async (args) => readonlyResult("/moduleFile/query", await client.post("/moduleFile/query", safePayload(args.payload))),
+        nocode_get_module_file: async (args) => readonlyResult("/moduleFile/query", await client.read("/moduleFile/query", safePayload(args.payload))),
         nocode_query_fields: async (args) => executeNocodeRead(client, queryFieldRoute(args)),
         nocode_query_records: async (args) => executeNocodeRead(client, queryRecordRoute(args)),
         nocode_query_workflow: async (args) => executeNocodeRead(client, queryWorkflowRoute(args)),
@@ -596,7 +596,7 @@ export function createNocodeToolHandlers(config = {}, sharedClient) {
     };
 }
 async function executeNocodeRead(client, route) {
-    return readonlyResult(route.targetPath, await client.post(route.targetPath, route.body, route.query), cleanObject({ operation: route.operation, body: route.body, query: route.query }));
+    return readonlyResult(route.targetPath, await client.read(route.targetPath, route.body, route.query), cleanObject({ operation: route.operation, body: route.body, query: route.query }));
 }
 async function executePrintingRead(client, args) {
     const route = queryPrintingRoute(args);
@@ -903,34 +903,34 @@ function unsupportedRoute(domain, operation) {
 async function queryPermissions(client, args) {
     switch (args.kind) {
         case "auth":
-            return readonlyResult("/moduleRole/auth", await client.post("/moduleRole/auth"));
+            return readonlyResult("/moduleRole/auth", await client.read("/moduleRole/auth"));
         case "roles": {
             const applicationId = requiredId(args.applicationId, "applicationId");
             const targetPath = `/moduleRole/list/${applicationId}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         }
         case "rolesByIds":
-            return readonlyResult("/moduleRole/listByRoleId", await client.post("/moduleRole/listByRoleId", requiredIds(args.ids, "ids")));
+            return readonlyResult("/moduleRole/listByRoleId", await client.read("/moduleRole/listByRoleId", requiredIds(args.ids, "ids")));
         case "usersRoles":
-            return readonlyResult("/moduleRole/roles/users", await client.post("/moduleRole/roles/users", requiredIds(args.ids, "ids")));
+            return readonlyResult("/moduleRole/roles/users", await client.read("/moduleRole/roles/users", requiredIds(args.ids, "ids")));
         case "viewableUserIds": {
             const moduleId = requiredId(args.moduleId, "moduleId");
             const targetPath = `/moduleRole/queryViewableUserIds/${moduleId}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         }
         case "data": {
             const dataId = requiredId(args.dataId, "dataId");
             const targetPath = `/moduleRole/dataAuth/${dataId}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         }
         case "field": {
             const moduleId = requiredId(args.moduleId, "moduleId");
             const userId = requiredId(args.userId, "userId");
             const targetPath = `/moduleRole/fieldAuth/${moduleId}/${userId}`;
-            return readonlyResult(targetPath, await client.post(targetPath));
+            return readonlyResult(targetPath, await client.read(targetPath));
         }
         case "roleField":
-            return readonlyResult("/moduleRole/roleField", await client.post("/moduleRole/roleField", safePayload(args.payload)));
+            return readonlyResult("/moduleRole/roleField", await client.read("/moduleRole/roleField", safePayload(args.payload)));
         default:
             throw new Error(`不支持的无代码权限查询类型：${String(args.kind)}`);
     }
@@ -1019,7 +1019,7 @@ async function publishModuleDraft(client, args) {
     const moduleId = requiredId(args.moduleId, "moduleId");
     const version = requiredExplicitVersion(args.version, "version");
     const targetPath = `/moduleM/active/${moduleId}`;
-    const latest = requiredObject(await client.post(`/moduleM/queryById/${moduleId}`, undefined, { isLatest: true }), "无法读取待发布模块的最新版本。");
+    const latest = requiredObject(await client.read(`/moduleM/queryById/${moduleId}`, undefined, { isLatest: true }), "无法读取待发布模块的最新版本。");
     const latestVersion = requiredExplicitVersion(latest.version, "latest.version");
     // 发布接口本身不接收版本号；必须在调用前锁定调用方确认过的草稿版本，避免误发新草稿。
     if (latestVersion !== version) {
@@ -1038,7 +1038,7 @@ async function publishModuleDraft(client, args) {
             preflight: { latestVersion, status: latest.status, isActive: latest.isActive }
         };
     }
-    const published = requiredObject(await client.post(targetPath), "发布接口未返回模块信息，无法确认发布结果。");
+    const published = requiredObject(await client.write(targetPath), "发布接口未返回模块信息，无法确认发布结果。");
     const publishedVersion = requiredExplicitVersion(published.version, "published.version");
     const verified = publishedVersion === version && published.isActive === true && Number(published.status) === 1;
     return {
@@ -1058,7 +1058,7 @@ async function executeRelationFieldReplacement(client, args) {
     const targetModuleId = requiredId(args.targetModuleId, "targetModuleId");
     const baseVersion = requiredExplicitVersion(args.baseVersion, "baseVersion");
     const relationFieldName = requiredText(args.relationFieldName, "relationFieldName");
-    const moduleDetail = requiredObject(await client.post(`/moduleM/queryById/${moduleId}`, undefined, { isLatest: true }), "无法读取来源模块的最新版本。");
+    const moduleDetail = requiredObject(await client.read(`/moduleM/queryById/${moduleId}`, undefined, { isLatest: true }), "无法读取来源模块的最新版本。");
     const latestVersion = requiredExplicitVersion(moduleDetail.version, "module.version");
     if (latestVersion !== baseVersion) {
         throw new Error(`模块版本已变化：baseVersion=${baseVersion}，当前最新 version=${latestVersion}。请重新读取结构后再替换。`);
@@ -1070,7 +1070,7 @@ async function executeRelationFieldReplacement(client, args) {
         throw new Error("来源模块不是可编辑的已发布版本或草稿版本，已拒绝字段替换。");
     }
     const mainFieldId = requiredId(moduleDetail.mainFieldId, "module.mainFieldId");
-    const fields = requiredObjectArray(await client.post("/moduleField/queryList", { moduleId: numericValue(moduleId), version: baseVersion }), "模块字段列表");
+    const fields = requiredObjectArray(await client.read("/moduleField/queryList", { moduleId: numericValue(moduleId), version: baseVersion }), "模块字段列表");
     const sourceField = fields.find((field) => sameId(field.fieldId, sourceFieldId));
     if (!sourceField) {
         throw new Error(`sourceFieldId=${sourceFieldId} 不在模块 ${moduleId} 的 version=${baseVersion} 字段列表中。`);
@@ -1098,8 +1098,8 @@ async function executeRelationFieldReplacement(client, args) {
     if (fields.some((field) => Number(field.type) === 68)) {
         throw new Error("模块包含树字段；旧后端查询结果缺少聚合保存所需的临时展示字段 ID，已保守阻断替换。");
     }
-    const defaultValueConfigs = requiredObjectArray(await client.post(`/moduleFieldDefault/list/${moduleId}/${baseVersion}`), "字段默认值配置");
-    const fieldStatisticConfigs = requiredObjectArray(await client.post(`/moduleFieldStatistic/query/${moduleId}/${baseVersion}`), "字段统计配置");
+    const defaultValueConfigs = requiredObjectArray(await client.read(`/moduleFieldDefault/list/${moduleId}/${baseVersion}`), "字段默认值配置");
+    const fieldStatisticConfigs = requiredObjectArray(await client.read(`/moduleFieldStatistic/query/${moduleId}/${baseVersion}`), "字段统计配置");
     // /moduleField/save 会先清空再重建这两类配置；语义工具没有完整编辑上下文时宁可拒绝，也不能静默擦除。
     if (defaultValueConfigs.length > 0 || fieldStatisticConfigs.length > 0) {
         throw new Error(`模块包含 ${defaultValueConfigs.length} 条字段默认值配置和 ${fieldStatisticConfigs.length} 条字段统计配置，已保守阻断替换。`);
@@ -1118,11 +1118,11 @@ async function executeRelationFieldReplacement(client, args) {
                 groupId: 0
             }]
     };
-    const sourceDataPage = await client.post(`/moduleData/queryPageList/${moduleId}`, sourceDataQuery);
+    const sourceDataPage = await client.read(`/moduleData/queryPageList/${moduleId}`, sourceDataQuery);
     if (pageHasRows(sourceDataPage)) {
         throw new Error(`字段“${String(sourceField.name ?? sourceFieldName)}”存在非空数据，替换会在发布时丢失原值，已阻断。`);
     }
-    const deleteImpact = requiredObject(await client.post("/moduleField/checkFieldDelete", {
+    const deleteImpact = requiredObject(await client.read("/moduleField/checkFieldDelete", {
         moduleId: numericValue(moduleId),
         fieldId: numericValue(sourceFieldId),
         fieldName: sourceFieldName,
@@ -1133,7 +1133,7 @@ async function executeRelationFieldReplacement(client, args) {
     if (dependentFields.length > 0 || dependentFlows.length > 0) {
         throw new Error(`字段仍被 ${dependentFields.length} 个字段配置和 ${dependentFlows.length} 个流程配置引用，已阻断替换。`);
     }
-    const targetModule = requiredObject(await client.post(`/moduleM/queryById/${targetModuleId}`, undefined, { isLatest: false }), "无法读取关联目标模块的已发布版本。");
+    const targetModule = requiredObject(await client.read(`/moduleM/queryById/${targetModuleId}`, undefined, { isLatest: false }), "无法读取关联目标模块的已发布版本。");
     if (targetModule.isActive !== true || Number(targetModule.status) !== 1) {
         throw new Error("关联目标模块必须存在已发布激活版本。");
     }
@@ -1203,10 +1203,37 @@ async function executeRelationFieldReplacement(client, args) {
             body: saveBody
         };
     }
-    const savedModule = requiredObject(await client.post("/moduleField/save", saveBody), "字段保存接口未返回模块信息，无法回读验证。");
+    const savedModule = requiredObject(await client.write("/moduleField/save", saveBody), "字段保存接口未返回模块信息，无法回读验证。");
     const savedVersion = requiredExplicitVersion(savedModule.version, "savedModule.version");
     const expectedSavedVersion = moduleDetail.isActive === true ? baseVersion + 1 : baseVersion;
-    const readbackFields = requiredObjectArray(await client.post("/moduleField/queryList", { moduleId: numericValue(moduleId), version: savedVersion }), "保存后字段列表");
+    let readbackFields;
+    try {
+        readbackFields = requiredObjectArray(await client.read("/moduleField/queryList", { moduleId: numericValue(moduleId), version: savedVersion }), "保存后字段列表");
+    }
+    catch (error) {
+        // 草稿保存已经 code=0；回读失败时保留“已保存、验证未知”，并阻止后续发布。
+        return {
+            preview: false,
+            action: "replaceFieldWithRelation",
+            targetPath: "/moduleField/save",
+            moduleId,
+            baseVersion,
+            savedVersion,
+            saved: true,
+            verified: false,
+            publishReady: false,
+            message: "字段草稿已保存，但后续回读失败；请检查草稿，不要发布或直接重放保存请求。",
+            preflight,
+            verification: {
+                status: "unknown",
+                error: {
+                    name: error instanceof Error ? error.name : "Error",
+                    message: error instanceof Error ? error.message : String(error)
+                }
+            },
+            data: savedModule
+        };
+    }
     const retainedFieldIds = retainedFields.map((field) => requiredId(field.fieldId, "retainedField.fieldId"));
     const replacementMatches = readbackFields.filter((field) => {
         const optionsData = isObject(field.optionsData) ? field.optionsData : {};
@@ -1270,6 +1297,7 @@ async function executeRelationFieldReplacement(client, args) {
             : "字段草稿已保存，但回读验证未通过；请检查草稿，不要发布。",
         preflight,
         verification: {
+            status: verified ? "confirmed" : "mismatch",
             errors: verificationErrors,
             sourceRemoved: !readbackFields.some((field) => sameId(field.fieldId, sourceFieldId)),
             retainedFieldsPresent: missingRetainedIds.length === 0,
@@ -1366,7 +1394,7 @@ async function confirmedPost(client, args, action, targetPath, body, query) {
         targetPath,
         body,
         query,
-        data: await client.post(targetPath, body, query)
+        data: await client.write(targetPath, body, query)
     };
 }
 function readonlyResult(targetPath, data, extra = {}) {