@wukongcrm/mcp-server 0.2.0 → 0.2.1

package/README.md

@@ -198,6 +198,12 @@ wukong-mcp
 - 打印与消息：`nocode_query_printing`、`nocode_write_printing`、`nocode_query_messages`、`nocode_write_message`
 - 开放能力与应用市场：`nocode_query_integrations`、`nocode_write_integration`、`nocode_query_marketplace`、`nocode_write_marketplace`
 
+常见保存动作必须使用旧前端对应的聚合 BO，而不是把单个字段或单个值直接作为 `payload`：
+
+- 字段保存：`ModuleFieldSaveBO`，至少包含 `moduleId`、实际 `version`、`mainFieldId`/`tempMainFieldId` 和非空 `moduleFieldList`。
+- 记录保存：`ModuleFieldDataSaveBO`，至少包含 `moduleId`、实际 `version` 和非空 `fieldDataList`；字段值使用 `fieldId`、`fieldName`、`name`、`type`、`value`，修改时增加 `dataId`。
+- 新建模块的实际版本通常从 `0` 开始，应先用 `nocode_get_module` 读取并显式传入，不能根据已发布老模块猜测为 `1`。
+
 文件流仍有意不经 MCP 代理，因此应用导入/导出、Excel 导入/导出、跟进导出、打印 PDF/Word 下载不在工具中；打印内容生成和预览 JSON 接口仍可使用。内部测试接口 `/moduleMQ/send` 也不会暴露。
 
 ### CRM、OA、HRM、财务、进销存与工单工具

package/dist/nocode.js

@@ -62,7 +62,7 @@ export const nocodeToolDefinitions = [
     },
     {
         name: "nocode_get_module_schema",
-        description: "一次获取无代码模块字段、表单布局、列表头、页面布局、选项、公式、标签和序列号规则；写入记录前应先调用；只读。",
+        description: "一次获取无代码模块字段、表单布局、列表头、页面布局、选项、公式、标签和序列号规则；写入记录前应先调用，并优先使用 nocode_get_module 返回的实际 version（新建模块通常为 0）；只读。",
         schema: z.object({ ...moduleContextShape, includeExtended: z.boolean().optional() }),
         access: "read"
     },
@@ -243,7 +243,7 @@ export const nocodeToolDefinitions = [
     },
     {
         name: "nocode_write_module",
-        description: "保存、启停、复制、发布、丢弃草稿、删除模块、保存页面布局或维护 BI Dashboard 模块；必须 confirm=true。",
+        description: "保存、启停、复制、发布、丢弃草稿、删除模块、保存页面布局或维护 BI Dashboard 模块；action=save 的 payload 使用旧 CRM ModuleSaveBO（常见普通模块包含 applicationId、name、moduleType=1、icon）；必须 confirm=true。",
         schema: z.object({
             action: z.enum(["save", "status", "copy", "publish", "discardDraft", "delete", "layout", "deleteCancelledCompanyData", "dashboardSave", "dashboardRemove"]),
             moduleId: idSchema.optional(),
@@ -257,14 +257,14 @@ export const nocodeToolDefinitions = [
     },
     {
         name: "nocode_write_field",
-        description: "保存字段，或修改普通/固定模块列表字段排序和样式；必须 confirm=true，否则只返回固定接口和请求预览。",
+        description: "保存字段，或修改普通/固定模块列表字段排序和样式；action=save 的 payload 必须是聚合 ModuleFieldSaveBO，包含 moduleId、实际 version、mainFieldId 或 tempMainFieldId、moduleFieldList，不能直接传单个字段；必须 confirm=true，否则只返回固定接口和请求预览。",
         schema: z.object({ action: z.enum(["save", "sort", "style", "fixedSort", "fixedStyle"]), ...payloadWriteShape }),
         access: "write",
         destructive: true
     },
     {
         name: "nocode_write_record",
-        description: "新增/修改、删除、转移负责人或设置分组；payload 使用对应旧 CRM BO；必须 confirm=true，否则只返回预览。",
+        description: "新增/修改、删除、转移负责人或设置分组；action=save 的 payload 必须是 ModuleFieldDataSaveBO，包含 moduleId、实际 version、fieldDataList；每个字段值应包含 fieldId、fieldName、name、type、value，修改时再带 dataId；必须 confirm=true，否则只返回预览。",
         schema: z.object({ action: z.enum(["save", "delete", "transfer", "setCategory"]), ...payloadWriteShape }),
         access: "write",
         destructive: true
@@ -430,9 +430,11 @@ export function createNocodeToolHandlers(config = {}) {
             const moduleId = requiredId(args.moduleId, "moduleId");
             const version = requiredVersion(args.version);
             const query = cleanObject({ moduleId: numericValue(moduleId), version, categoryId: args.categoryId });
+            // 旧后端会直接拆箱 filterHidden；显式传 false 与无代码前端的字段配置请求保持一致，避免空值触发 500。
+            const formQuery = { ...query, filterHidden: false };
             const [fields, form, listHead, layout, unionModules] = await Promise.all([
                 client.post("/moduleField/queryList", query),
-                client.post("/moduleField/formList", query),
+                client.post("/moduleField/formList", formQuery),
                 client.post("/moduleField/queryListHead", query),
                 client.post(`/moduleM/pageLayout/${moduleId}/${version}`),
                 client.post(`/moduleM/unionModules/${moduleId}/${version}`)
@@ -517,14 +519,14 @@ export function createNocodeToolHandlers(config = {}) {
         nocode_query_marketplace: async (args) => executeNocodeRead(client, queryMarketplaceRoute(args)),
         nocode_write_application: async (args) => executeApplicationWrite(client, args),
         nocode_write_module: async (args) => executeModuleWrite(client, args),
-        nocode_write_field: async (args) => executePayloadWrite(client, args, {
+        nocode_write_field: async (args) => executeFieldWrite(client, args, {
             save: "/moduleField/save",
             sort: "/moduleField/setFieldSort",
             style: "/moduleField/setFieldStyle",
             fixedSort: "/moduleField/fixed/setFieldSort",
             fixedStyle: "/moduleField/fixed/setFieldStyle"
         }),
-        nocode_write_record: async (args) => executePayloadWrite(client, args, {
+        nocode_write_record: async (args) => executeRecordWrite(client, args, {
             save: "/moduleFieldData/save",
             delete: "/moduleFieldData/delete",
             transfer: "/moduleFieldData/transfer",
@@ -874,11 +876,11 @@ async function executeApplicationWrite(client, args) {
     switch (action) {
         case "create":
             targetPath = "/moduleMetadata/save";
-            body = safePayload(args.payload);
+            body = applicationPayload(args.payload, action);
             break;
         case "update":
             targetPath = "/moduleMetadata/update";
-            body = safePayload(args.payload);
+            body = applicationPayload(args.payload, action);
             break;
         case "status":
             targetPath = `/moduleMetadata/updateStatus/${requiredId(args.applicationId, "applicationId")}`;
@@ -954,6 +956,20 @@ async function executePayloadWrite(client, args, paths) {
     }
     return confirmedPost(client, args, action, targetPath, safePayload(args.payload));
 }
+async function executeFieldWrite(client, args, paths) {
+    const action = String(args.action);
+    if (action === "save") {
+        validateAggregateSavePayload(args.payload, "ModuleFieldSaveBO", "moduleFieldList");
+    }
+    return executePayloadWrite(client, args, paths);
+}
+async function executeRecordWrite(client, args, paths) {
+    const action = String(args.action);
+    if (action === "save") {
+        validateAggregateSavePayload(args.payload, "ModuleFieldDataSaveBO", "fieldDataList");
+    }
+    return executePayloadWrite(client, args, paths);
+}
 async function executeSceneWrite(client, args) {
     const action = String(args.action);
     const targetPath = action === "delete" || action === "default"
@@ -1075,6 +1091,40 @@ function safePayload(value) {
     }
     return value;
 }
+function applicationPayload(value, action) {
+    const payload = safePayload(value);
+    const name = typeof payload.name === "string" ? payload.name.trim() : "";
+    if (!name) {
+        throw new Error("无代码应用名称不能为空。");
+    }
+    if (Array.from(name).length > 20) {
+        throw new Error("无代码应用名称不能超过 20 个字符。");
+    }
+    const description = payload.description;
+    if (description !== undefined && (typeof description !== "string" || Array.from(description).length > 50)) {
+        throw new Error("无代码应用描述必须是字符串且不能超过 50 个字符。");
+    }
+    const icon = typeof payload.icon === "string" ? payload.icon.trim() : "";
+    if (!icon) {
+        throw new Error("无代码应用图标不能为空。");
+    }
+    // 创建时补齐旧前端提交的非业务默认值；更新仍保留调用方提供的完整应用配置。
+    return action === "create"
+        ? { ...payload, name, icon, description: description ?? "", iconColor: payload.iconColor ?? "#EBECF0", manageUserIds: payload.manageUserIds ?? [] }
+        : { ...payload, name, icon };
+}
+function validateAggregateSavePayload(value, boName, listField) {
+    const payload = safePayload(value);
+    requiredId(payload.moduleId, "payload.moduleId");
+    // 新建模块的有效版本通常为 0；不能用 requiredVersion 的默认值掩盖调用方漏传版本。
+    if (payload.version === undefined) {
+        throw new Error(`${boName} 必须包含实际 version；请先读取模块详情。`);
+    }
+    requiredVersion(payload.version);
+    if (!Array.isArray(payload[listField]) || payload[listField].length === 0) {
+        throw new Error(`${boName} 必须包含非空 ${listField}。`);
+    }
+}
 function cleanObject(input) {
     const output = {};
     for (const [key, value] of Object.entries(input)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wukongcrm/mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Local and remote MCP server for fixed 72CRM API access.",
   "type": "module",
   "main": "./dist/index.js",