@wukongcrm/mcp-server 0.1.3 → 0.2.0

package/dist/tools.js

@@ -1,5 +1,337 @@
+import { randomUUID } from "node:crypto";
 import { CrmClient } from "./client.js";
 import { CRM_MODULES, ensureWritableModule, getModuleByKey } from "./modules.js";
+const FINANCE_MODULES = [
+    {
+        key: "certificate",
+        name: "凭证",
+        basePath: "/financeCertificate",
+        supportedOperations: ["列表查询", "详情", "汇总", "新增", "编辑", "审核", "冲销", "删除", "凭证整理", "域内固定路径写入"],
+        unsupportedOperations: ["文件流下载", "multipart 文件上传代理"]
+    },
+    {
+        key: "ledger",
+        name: "账簿",
+        basePath: "/financeCertificate",
+        supportedOperations: ["明细账", "总账", "科目余额表", "多栏账", "核算项目账", "数量金额账"],
+        unsupportedOperations: ["导出", "打印"]
+    },
+    {
+        key: "report",
+        name: "报表",
+        basePath: "/financeReport",
+        supportedOperations: ["资产负债表", "利润表", "现金流量表", "平衡检查", "公式编辑", "扩展数据编辑", "域内固定路径写入"],
+        unsupportedOperations: ["文件流导出"]
+    },
+    {
+        key: "subject",
+        name: "科目",
+        basePath: "/financeSubject",
+        supportedOperations: ["列表查询", "新增", "编辑", "删除", "启用禁用", "域内固定路径写入"],
+        unsupportedOperations: ["文件流导入导出"]
+    },
+    {
+        key: "voucherWord",
+        name: "凭证字",
+        basePath: "/financeVoucher",
+        supportedOperations: ["列表查询", "新增", "编辑", "删除", "排序", "域内固定路径写入"],
+        unsupportedOperations: []
+    },
+    {
+        key: "currency",
+        name: "币别",
+        basePath: "/financeCurrency",
+        supportedOperations: ["列表查询", "新增", "编辑", "删除", "域内固定路径写入"],
+        unsupportedOperations: []
+    },
+    {
+        key: "dashboard",
+        name: "财务仪表盘",
+        basePath: "/financeDashboard",
+        supportedOperations: ["利润表统计", "配置查询", "指标列表", "指标统计", "配置修改", "域内固定路径写入"],
+        unsupportedOperations: []
+    }
+];
+const FINANCE_LEDGER_QUERIES = [
+    {
+        key: "detail",
+        name: "明细账",
+        targetPath: "/financeCertificate/queryDetailAccount",
+        aliases: ["detail", "subLedger", "detailedLedger", "明细账"]
+    },
+    {
+        key: "general",
+        name: "总账",
+        targetPath: "/financeCertificate/queryGeneralLedger",
+        aliases: ["general", "generalLedger", "allLedger", "总账"]
+    },
+    {
+        key: "balance",
+        name: "科目余额表",
+        targetPath: "/financeCertificate/queryDetailBalanceAccount",
+        aliases: ["balance", "accountBalance", "subjectBalance", "科目余额表", "余额表"]
+    },
+    {
+        key: "multiColumn",
+        name: "多栏账",
+        targetPath: "/financeCertificate/queryDiversification",
+        aliases: ["multiColumn", "diversification", "multi", "多栏账"]
+    },
+    {
+        key: "itemsDetail",
+        name: "核算项目明细账",
+        targetPath: "/financeCertificate/queryItemsDetailAccount",
+        aliases: ["itemsDetail", "auxiliaryDetail", "accountingProjectDetail", "核算项目明细账"]
+    },
+    {
+        key: "itemsBalance",
+        name: "核算项目余额表",
+        targetPath: "/financeCertificate/queryItemsDetailBalanceAccount",
+        aliases: ["itemsBalance", "auxiliaryBalance", "accountingProjectBalance", "核算项目余额表"]
+    },
+    {
+        key: "amountDetail",
+        name: "数量金额明细账",
+        targetPath: "/financeCertificate/queryAmountDetailAccount",
+        aliases: ["amountDetail", "numberMoney", "quantityAmountDetail", "数量金额明细账"]
+    },
+    {
+        key: "amountGeneral",
+        name: "数量金额总账",
+        targetPath: "/financeCertificate/queryAmountDetailUpAccount",
+        aliases: ["amountGeneral", "totalNumberMoney", "quantityAmountGeneral", "数量金额总账"]
+    }
+];
+const FINANCE_REPORT_QUERIES = [
+    {
+        key: "balanceSheet",
+        name: "资产负债表",
+        targetPath: "/financeReport/balanceSheetReport",
+        aliases: ["balanceSheet", "balance", "资产负债表"]
+    },
+    {
+        key: "incomeStatement",
+        name: "利润表",
+        targetPath: "/financeReport/incomeStatementReport",
+        aliases: ["incomeStatement", "profit", "income", "利润表"]
+    },
+    {
+        key: "cashFlow",
+        name: "现金流量表",
+        targetPath: "/financeReport/cashFlowStatementReport",
+        aliases: ["cashFlow", "cash", "现金流量表"]
+    }
+];
+const FINANCE_DASHBOARD_QUERIES = [
+    {
+        key: "incomeStatement",
+        name: "利润表统计",
+        targetPath: "/financeDashboard/incomeStatement",
+        aliases: ["incomeStatement", "income", "利润表统计"]
+    },
+    {
+        key: "config",
+        name: "仪表盘配置",
+        targetPath: "/financeDashboard/config",
+        aliases: ["config", "dashboardConfig", "配置"]
+    },
+    {
+        key: "indicator",
+        name: "指标列表",
+        targetPath: "/financeDashboard/indicator",
+        aliases: ["indicator", "indicators", "指标"]
+    },
+    {
+        key: "statistics",
+        name: "指标统计",
+        targetPath: "/financeDashboard/statistics",
+        aliases: ["statistics", "stat", "stats", "指标统计"]
+    },
+    {
+        key: "fieldLanguage",
+        name: "字段语言包",
+        targetPath: "/financeDashboard/getAllFieldLanguageRel",
+        aliases: ["fieldLanguage", "language", "fieldRel", "字段语言包"]
+    }
+];
+const JXC_MODULES = [
+    {
+        key: "product",
+        name: "产品",
+        label: 1,
+        basePath: "/jxcProduct",
+        primaryKey: "productId",
+        aliases: [1, "1", "product", "jxcProduct", "产品"]
+    },
+    {
+        key: "supplier",
+        name: "供应商",
+        label: 8,
+        basePath: "/jxcSupplier",
+        primaryKey: "supplierId",
+        aliases: [8, "8", "supplier", "jxcSupplier", "供应商"]
+    },
+    {
+        key: "warehouse",
+        name: "仓库",
+        label: 13,
+        basePath: "/jxcWarehouse",
+        primaryKey: "warehouseId",
+        aliases: [13, "13", "warehouse", "jxcWarehouse", "仓库"]
+    }
+];
+const OA_EXAMINE_LIST_ENDPOINTS = [
+    {
+        key: "upcomingTodo",
+        name: "待办-待我审批",
+        targetPath: "/examineSuperExamine/todo/me",
+        aliases: ["upcoming", "upcoming.todo", "upcoming0", "todo", "todoMe", "待办", "待我审批"]
+    },
+    {
+        key: "upcomingCopy",
+        name: "待办-抄送给我",
+        targetPath: "/examineSuperExamine/copy/me",
+        aliases: ["upcoming.copy", "upcoming1", "copy", "copyMe", "ccMe", "抄送给我"]
+    },
+    {
+        key: "trackMe",
+        name: "跟踪-我申请的",
+        targetPath: "/examineSuperExamine/track/me",
+        aliases: ["track", "track.me", "track0", "trackMe", "myApplication", "跟踪", "我申请的"]
+    },
+    {
+        key: "trackDo",
+        name: "跟踪-经我审批",
+        targetPath: "/examineSuperExamine/track/do",
+        aliases: ["track.do", "track1", "trackDo", "approvedByMe", "经我审批"]
+    },
+    {
+        key: "trackCopy",
+        name: "跟踪-抄送给我",
+        targetPath: "/examineSuperExamine/track/copy",
+        aliases: ["track.copy", "track2", "trackCopy", "trackCcMe", "跟踪抄送"]
+    },
+    {
+        key: "archiveMe",
+        name: "归档-我的申请",
+        targetPath: "/examineSuperExamine/end/me",
+        aliases: ["archive", "archive.me", "archive0", "end.me", "endMe", "归档", "归档我的申请"]
+    },
+    {
+        key: "archiveAudit",
+        name: "归档-经我审批",
+        targetPath: "/examineSuperExamine/end/audit",
+        aliases: ["archive.audit", "archive1", "end.audit", "endAudit", "归档经我审批"]
+    },
+    {
+        key: "archiveFollow",
+        name: "归档-我的关注",
+        targetPath: "/examineSuperExamine/end/follow",
+        aliases: ["archive.follow", "archive2", "end.follow", "endFollow", "我的关注"]
+    },
+    {
+        key: "archiveTovoid",
+        name: "归档-作废",
+        targetPath: "/examineSuperExamine/end/tovoid",
+        aliases: ["archive.tovoid", "archive3", "end.tovoid", "endTovoid", "void", "作废"]
+    },
+    {
+        key: "archiveCopy",
+        name: "归档-抄送给我",
+        targetPath: "/examineSuperExamine/end/copy",
+        aliases: ["archive.copy", "archive4", "end.copy", "endCopy", "归档抄送"]
+    },
+    {
+        key: "draft",
+        name: "草稿",
+        targetPath: "/oaSuperExamine/draft",
+        aliases: ["draft", "草稿"]
+    },
+    {
+        key: "all",
+        name: "全部审批",
+        targetPath: "/examine/examineSuperExamine/examine/queryAll",
+        aliases: ["all", "all0", "全部审批"]
+    },
+    {
+        key: "legacyWaiting",
+        name: "旧版 OA 待审列表",
+        targetPath: "/examineWaiting/queryOaExamineList",
+        aliases: ["legacyWaiting", "waiting", "oaWaiting", "oldWaiting", "旧版待办"]
+    },
+    {
+        key: "legacyRecord",
+        name: "旧版审批记录列表",
+        targetPath: "/examineRecord/queryExamineRecordList",
+        aliases: ["legacyRecord", "record", "records", "examineRecord", "oldRecord", "旧版记录"]
+    },
+    {
+        key: "myInitiate",
+        name: "我发起的审批",
+        targetPath: "/oaExamine/myInitiate",
+        aliases: ["myInitiate", "myCreate", "initiated", "我发起", "我发起的审批"]
+    },
+    {
+        key: "myOaExamine",
+        name: "我审批的",
+        targetPath: "/oaExamine/myOaExamine",
+        aliases: ["myOaExamine", "myExamine", "myAudit", "我审批", "我审批的"]
+    }
+];
+const CRM_DOCUMENT_WRITE_DEFINITIONS = [
+    {
+        key: "contract",
+        name: "合同",
+        basePath: "/crmContract",
+        primaryKey: "contractId",
+        requiresApprovalFlow: true
+    },
+    {
+        key: "receivables",
+        name: "回款",
+        basePath: "/crmReceivables",
+        primaryKey: "receivablesId",
+        requiresApprovalFlow: true
+    },
+    {
+        key: "receivablesPlan",
+        name: "回款计划",
+        basePath: "/crmReceivablesPlan",
+        primaryKey: "receivablesPlanId",
+        requiresApprovalFlow: false
+    },
+    {
+        key: "invoice",
+        name: "发票",
+        basePath: "/crmInvoice",
+        primaryKey: "invoiceId",
+        requiresApprovalFlow: true
+    },
+    {
+        key: "quotation",
+        name: "报价单",
+        basePath: "/crmQuotation",
+        primaryKey: "quotationId",
+        requiresApprovalFlow: true
+    }
+];
+const WRITE_DOMAINS = {
+    hrm: {
+        key: "hrm",
+        name: "人力资源 HRM",
+        allowedPrefixes: ["/hrm"]
+    },
+    jxc: {
+        key: "jxc",
+        name: "进销存 JXC",
+        allowedPrefixes: ["/jxc"]
+    },
+    finance: {
+        key: "finance",
+        name: "独立财务 FM",
+        allowedPrefixes: ["/finance"]
+    }
+};
 export function createToolHandlers(config = {}) {
     const client = new CrmClient(config);
     return {
@@ -37,7 +369,7 @@ export function createToolHandlers(config = {}) {
         crm_search_records: async (args) => {
             const moduleDefinition = getModuleByKey(args.module);
             const poolContext = isPoolModule(moduleDefinition) ? await resolvePoolContext(client, moduleDefinition, args) : undefined;
-            const searchList = buildSearchList(args, moduleDefinition);
+            const searchList = await buildResolvedSearchList(client, args, moduleDefinition);
             const body = {
                 page: args.page ?? 1,
                 limit: args.limit ?? 15,
@@ -121,6 +453,89 @@ export function createToolHandlers(config = {}) {
                 data: await client.post(`${fileModule.basePath}/queryFileList`, undefined, cleanQuery({ id: args.id, fileType: args.fileType }))
             };
         },
+        crm_search_products: async (args) => {
+            const targetPath = "/crmProduct/queryPageList";
+            return {
+                module: "product",
+                moduleName: "产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, await buildCrmProductSearchBody(client, args, false))
+            };
+        },
+        crm_search_sale_products: async (args) => {
+            const targetPath = "/crmProduct/querySaleProductPageList";
+            return {
+                module: "product",
+                moduleName: "上架产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, await buildCrmProductSearchBody(client, args, true))
+            };
+        },
+        crm_get_product: async (args) => {
+            const productId = requireCrmProductId(args, "查询 CRM 产品详情请提供 productId 或 id。");
+            const targetPath = `/crmProduct/queryById/${productId}`;
+            return {
+                module: "product",
+                moduleName: "产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_product_information: async (args) => {
+            const productId = requireCrmProductId(args, "查询 CRM 产品详情页字段请提供 productId 或 id。");
+            const targetPath = `/crmProduct/information/${productId}`;
+            return {
+                module: "product",
+                moduleName: "产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_product_schema: async (args) => {
+            const productId = args.productId ?? args.id;
+            const targetPath = productId ? `/crmProduct/field/${productId}` : "/crmProduct/field";
+            return {
+                module: "product",
+                moduleName: "产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ type: args.type }))
+            };
+        },
+        crm_list_product_files: async (args) => {
+            const targetPath = "/crmProduct/queryFileList";
+            return {
+                module: "product",
+                moduleName: "产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ id: requireCrmProductId(args, "查询 CRM 产品附件请提供 productId 或 id。"), fileType: args.fileType }))
+            };
+        },
+        crm_get_product_num: async (args) => {
+            const targetPath = "/crmProduct/num";
+            return {
+                module: "product",
+                moduleName: "产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ id: requireCrmProductId(args, "查询 CRM 产品数量请提供 productId 或 id。") }))
+            };
+        },
+        crm_get_simple_products: async (args) => {
+            const targetPath = "/crmProduct/querySimpleEntity";
+            return {
+                module: "product",
+                moduleName: "产品",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, requireIdArray(args.productIds ?? args.ids, "查询 CRM 简要产品请提供 productIds 或 ids 数组。"))
+            };
+        },
         crm_list_users: async (args) => ({
             data: await client.post("/adminUser/queryUserList", cleanObject({
                 page: args.page ?? 1,
@@ -134,10 +549,19 @@ export function createToolHandlers(config = {}) {
         }),
         crm_find_user_id: async (args) => {
             const mode = args.mode ?? "realname";
-            const path = mode === "username" ? "/adminUser/getIdByUserName" : "/adminUser/getIdByRealName";
+            const userName = args.userName ?? args.name;
+            if (isBlank(userName)) {
+                throw new Error("请提供 userName 或 name。");
+            }
+            if (mode === "realname") {
+                return {
+                    mode,
+                    data: await resolveUserIdByNickname(client, String(userName), new Map(), args.companyId)
+                };
+            }
             return {
                 mode,
-                data: await client.post(path, undefined, { userName: args.userName ?? args.name, companyId: args.companyId })
+                data: await client.post("/adminUser/getIdByUserName", undefined, { userName, companyId: args.companyId })
             };
         },
         crm_list_departments: async (args) => ({
@@ -146,656 +570,3589 @@ export function createToolHandlers(config = {}) {
         crm_find_dept_id: async (args) => ({
             data: await client.post("/adminDept/getIdByDeptName", undefined, { deptName: args.deptName ?? args.name, companyId: args.companyId })
         }),
-        crm_preview_write: (args) => previewWrite(args),
-        crm_update_customer: async (args) => {
-            const moduleDefinition = getModuleByKey("customer");
-            const targetPath = `${moduleDefinition.basePath}/updateInformation`;
-            const directId = args.customerId ?? args.id;
-            if (!args.confirm) {
-                return previewWrite({
-                    ...args,
-                    module: "customer",
-                    id: directId ?? "<需要通过客户查询唯一命中后填充>",
-                    operation: "updateInformation",
-                    targetPath
-                });
-            }
-            const resolvedRecord = directId ? undefined : await resolveUniqueRecord(client, moduleDefinition, args);
-            const id = directId ?? resolvedRecord?.[moduleDefinition.primaryKey] ?? resolvedRecord?.id;
-            const body = await buildUpdateInformationBody(client, moduleDefinition, { ...args, id });
-            const data = await client.post(targetPath, body);
-            const verification = args.verify === false ? undefined : await verifyInformationUpdate(client, moduleDefinition, body);
-            return cleanObject({
-                module: moduleDefinition.key,
+        crm_list_address_book_contacts: async (args) => {
+            const targetPath = "/adminUser/queryListName";
+            return {
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildAddressBookListBody(args))
+            };
+        },
+        crm_get_address_book_contact: async (args) => {
+            const targetPath = "/adminUser/queryUserInfo";
+            return {
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ userId: requireAddressBookUserId(args, "查询通讯录联系人详情请提供 userId 或 id。") }))
+            };
+        },
+        crm_list_address_book_departments: async (args) => {
+            const targetPath = "/adminDept/queryDeptTree";
+            return {
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildAddressBookDepartmentBody(args))
+            };
+        },
+        crm_list_address_book_auth_departments: async (args) => {
+            const targetPath = "/adminDept/queryDeptByAuth";
+            return {
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, cleanObject(args ?? {}))
+            };
+        },
+        crm_list_address_book_dept_user_ids: async (args) => {
+            const targetPath = "/adminUser/queryUserByDeptIds";
+            const body = addressBookDeptIds(args);
+            return {
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
                 targetPath,
-                resolvedRecord,
                 body,
-                data,
-                verification
-            });
+                data: await client.post(targetPath, body)
+            };
         },
-        crm_create_record: async (args) => {
-            const moduleDefinition = getModuleByKey(args.module);
-            ensureWritableModule(moduleDefinition);
-            const targetPath = `${moduleDefinition.basePath}/add`;
-            if (!args.confirm) {
-                return previewWrite({ ...args, operation: "create", targetPath });
-            }
+        crm_list_address_book_dept_users: async (args) => {
+            const targetPath = "/adminUser/queryListByDeptIds";
+            const body = addressBookDeptIds(args);
             return {
-                module: moduleDefinition.key,
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildModelSaveBody(args))
+                body,
+                data: await client.post(targetPath, body)
             };
         },
-        crm_update_record_fields: async (args) => {
-            const moduleDefinition = getModuleByKey(args.module);
-            ensureWritableModule(moduleDefinition);
-            const targetPath = `${moduleDefinition.basePath}/updateInformation`;
-            if (!args.confirm) {
-                return previewWrite({ ...args, operation: "updateInformation", targetPath });
-            }
-            const body = await buildUpdateInformationBody(client, moduleDefinition, args);
-            const data = await client.post(targetPath, body);
-            const verification = args.verify === false ? undefined : await verifyInformationUpdate(client, moduleDefinition, body);
+        crm_list_address_book_auth_users: async () => {
+            const targetPath = "/adminUser/queryAuthUserList";
             return {
-                module: moduleDefinition.key,
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_address_book_user_dept_role_info: async (args) => {
+            const targetPath = "/adminUser/queryUserDeptOrRoleInfo";
+            const body = buildAddressBookUserDeptRoleBody(args);
+            return {
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
                 targetPath,
                 body,
-                data,
-                verification
+                data: await client.post(targetPath, body)
             };
         },
-        crm_add_followup: async (args) => {
-            const targetPath = "/crmActivity/add";
-            if (!args.confirm) {
-                return previewWrite({ ...args, operation: "addFollowup", targetPath });
-            }
+        crm_get_address_book_organization: async (args) => {
+            const targetPath = "/adminUser/queryOrganizationInfo";
             return {
-                module: "activity",
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildFollowupSaveBody(args))
+                data: await client.post(targetPath, undefined, cleanQuery({ companyId: args.companyId }))
             };
         },
-        crm_update_followup: async (args) => {
-            const targetPath = args.useInformationUpdate ? "/crmActivity/updateInformation" : "/crmActivity/update";
+        crm_get_address_book_user_count: async (args) => {
+            const targetPath = "/adminUser/queryUserNumInfo";
+            return {
+                module: "addressBook",
+                moduleName: "通讯录",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ username: requireAddressBookUsername(args) }))
+            };
+        },
+        crm_toggle_address_book_attention: async (args) => {
+            const targetPath = "/adminUser/attention";
+            const body = buildAddressBookAttentionBody(args);
             if (!args.confirm) {
-                return previewWrite({ ...args, operation: "updateFollowup", targetPath });
+                return previewOaWrite("toggleAddressBookAttention", "addressBook", "通讯录", targetPath, body);
             }
-            const body = args.useInformationUpdate
-                ? cleanObject({ id: args.id, label: 19, list: args.list ?? args.fields ?? [], batchId: args.batchId })
-                : buildFollowupSaveBody(args);
             return {
-                module: "activity",
+                module: "addressBook",
+                moduleName: "通讯录",
                 targetPath,
-                data: await client.post(targetPath, body)
+                body,
+                data: await client.post(targetPath, undefined, cleanQuery(body))
             };
-        }
-    };
-}
-const FIELD_SEARCH_CONTAINS = 3;
-const QUICK_SEARCH_FIELDS = {
-    leads: [
-        { fieldName: "leadsName", formType: "text" },
-        { fieldName: "mobile", formType: "mobile" },
-        { fieldName: "telephone", formType: "text" }
-    ],
-    leadsPool: [
-        { fieldName: "leadsName", formType: "text" },
-        { fieldName: "mobile", formType: "mobile" },
-        { fieldName: "telephone", formType: "text" }
-    ],
-    customer: [
-        { fieldName: "customerName", formType: "text" },
-        { fieldName: "mobile", formType: "mobile" },
-        { fieldName: "telephone", formType: "text" }
-    ],
-    customerPool: [
-        { fieldName: "customerName", formType: "text" },
-        { fieldName: "mobile", formType: "mobile" },
-        { fieldName: "telephone", formType: "text" }
-    ],
-    contacts: [
-        { fieldName: "name", formType: "text" },
-        { fieldName: "mainFieldValue", formType: "text" },
-        { fieldName: "mobile", formType: "mobile" },
-        { fieldName: "telephone", formType: "text" },
-        { fieldName: "email", formType: "email" }
-    ],
-    business: [{ fieldName: "businessName", formType: "text" }],
-    product: [{ fieldName: "name", formType: "text" }],
-    contract: [
-        { fieldName: "num", formType: "text" },
-        { fieldName: "name", formType: "text" },
-        { fieldName: "customerName", formType: "text" }
-    ],
-    receivables: [
-        { fieldName: "number", formType: "text" },
-        { fieldName: "customerName", formType: "text" }
-    ],
-    receivablesPlan: [
-        { fieldName: "customerName", formType: "text" },
-        { fieldName: "contractNum", formType: "text" }
-    ],
-    invoice: [
-        { fieldName: "invoiceApplyNumber", formType: "text" },
-        { fieldName: "invoiceNumber", formType: "text" },
-        { fieldName: "customerName", formType: "text" }
-    ],
-    activity: [{ fieldName: "content", formType: "text" }],
-    quotation: [
-        { fieldName: "name", formType: "text" },
-        { fieldName: "num", formType: "text" },
-        { fieldName: "customerName", formType: "text" }
-    ],
-    returnVisit: [
-        { fieldName: "customerName", formType: "text" },
-        { fieldName: "contractNum", formType: "text" }
-    ],
-    visitPlan: [
-        { fieldName: "customerName", formType: "text" },
-        { fieldName: "contactsName", formType: "text" }
-    ]
-};
-const NAME_FIELD_BY_MODULE = {
-    leads: { fieldName: "leadsName", formType: "text" },
-    leadsPool: { fieldName: "leadsName", formType: "text" },
-    customer: { fieldName: "customerName", formType: "text" },
-    customerPool: { fieldName: "customerName", formType: "text" },
-    contacts: { fieldName: "name", formType: "text" },
-    business: { fieldName: "businessName", formType: "text" },
-    product: { fieldName: "name", formType: "text" },
-    contract: { fieldName: "name", formType: "text" },
-    quotation: { fieldName: "name", formType: "text" }
-};
-function buildSearchList(args, moduleDefinition) {
-    const explicitSearchList = toArray(args.filters ?? args.searchList);
-    const semanticSearchList = buildSemanticSearchList(args, moduleDefinition);
-    if (explicitSearchList.length > 0 && semanticSearchList.length > 0) {
-        return [...explicitSearchList, ...semanticSearchList];
-    }
-    if (explicitSearchList.length > 0) {
-        return explicitSearchList;
-    }
-    return semanticSearchList;
-}
-function buildSemanticSearchList(args, moduleDefinition) {
-    const keyword = firstTextValue(args.keyword, args.query, args.q, args.search, args.searchText, args.text, args.term);
-    if (keyword) {
-        return containsFilters(QUICK_SEARCH_FIELDS[moduleDefinition.key] ?? [], keyword, 1);
-    }
-    const phone = firstTextValue(args.phone, args.mobile, args.telephone);
-    if (phone) {
-        const fields = (QUICK_SEARCH_FIELDS[moduleDefinition.key] ?? []).filter((field) => ["mobile", "telephone", "phone"].includes(field.fieldName));
-        return containsFilters(fields, phone, 1);
-    }
-    const name = firstTextValue(args.name, args.customerName, args.leadsName, args.contactsName, args.businessName, args.productName, args.contractName, args.quotationName);
-    const nameField = NAME_FIELD_BY_MODULE[moduleDefinition.key];
-    if (name && nameField) {
-        return containsFilters([nameField], name, 0);
-    }
-    const email = firstTextValue(args.email);
-    if (email) {
-        return containsFilters([{ fieldName: "email", formType: "email" }], email, 0);
+        },
+        crm_list_hrm_employees: async (args) => {
+            const targetPath = "/hrmEmployee/queryPageList";
+            return {
+                module: "hrmEmployee",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildHrmEmployeeListBody(args))
+            };
+        },
+        crm_get_hrm_employee: async (args) => {
+            const employeeId = requireHrmEmployeeId(args);
+            const targetPath = `/hrmEmployee/queryById/${employeeId}`;
+            return {
+                module: "hrmEmployee",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_list_hrm_employee_fields: async () => {
+            const targetPath = "/hrmEmployeeField/queryListHeads";
+            return {
+                module: "hrmEmployee",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_list_hrm_departments: async (args) => {
+            const targetPath = "/hrmDept/queryTreeList";
+            return {
+                module: "hrmDept",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildHrmDepartmentListBody(args))
+            };
+        },
+        crm_get_hrm_department: async (args) => {
+            const deptId = requireHrmDeptId(args);
+            const targetPath = `/hrmDept/queryById/${deptId}`;
+            return {
+                module: "hrmDept",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_list_hrm_department_employees: async (args) => {
+            const targetPath = "/hrmDept/queryEmployeeByDeptId";
+            return {
+                module: "hrmDept",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildHrmDepartmentEmployeesBody(args))
+            };
+        },
+        crm_get_hrm_employee_post: async (args) => {
+            const employeeId = requireHrmEmployeeId(args);
+            const targetPath = `/hrmEmployeePost/postInformation/${employeeId}`;
+            return {
+                module: "hrmEmployeePost",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_list_hrm_attendance_month_records: async (args) => {
+            const targetPath = "/hrmAttendanceEmpMonthRecord/queryAttendanceEmpMonthRecordPageList";
+            return {
+                module: "hrmAttendance",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildHrmAttendanceMonthRecordBody(args))
+            };
+        },
+        crm_get_hrm_attendance_daily_detail: async (args) => {
+            const targetPath = "/hrmAttendanceClock/queryAttendanceDailyDetail";
+            return {
+                module: "hrmAttendance",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildHrmAttendanceDailyDetailBody(args))
+            };
+        },
+        crm_list_hrm_leave_records: async (args) => {
+            const targetPath = "/hrmEmployeeLeaveRecord/queryLeaveRecordPageList";
+            return {
+                module: "hrmLeaveRecord",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildHrmLeaveRecordBody(args))
+            };
+        },
+        crm_list_hrm_leave_types: async () => {
+            const targetPath = "/hrmEmployeeLeaveRecord/queryLeaveTypeList";
+            return {
+                module: "hrmLeaveRecord",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_list_finance_modules: () => ({
+            readonly: true,
+            modules: FINANCE_MODULES
+        }),
+        crm_search_finance_vouchers: async (args) => {
+            const targetPath = "/financeCertificate/queryPageList";
+            return {
+                module: "financeCertificate",
+                moduleName: "凭证",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildFinanceSearchBody(args, { page: args.page ?? 1, limit: args.limit ?? 15, pageType: args.pageType ?? 1 }))
+            };
+        },
+        crm_get_finance_voucher: async (args) => {
+            const targetPath = "/financeCertificate/queryById";
+            return {
+                module: "financeCertificate",
+                moduleName: "凭证",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, cleanObject({ certificateId: requireFinanceCertificateId(args), accountId: args.accountId }))
+            };
+        },
+        crm_summarize_finance_vouchers: async (args) => {
+            const targetPath = "/financeCertificate/summary";
+            return {
+                module: "financeCertificate",
+                moduleName: "凭证汇总",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildFinanceBody(args))
+            };
+        },
+        crm_query_finance_ledger: async (args) => {
+            const ledgerDefinition = getFinanceEndpointByKey(args.ledger ?? args.type ?? args.kind, FINANCE_LEDGER_QUERIES, "财务账簿");
+            return {
+                module: "financeLedger",
+                moduleName: ledgerDefinition.name,
+                ledger: ledgerDefinition.key,
+                readonly: true,
+                targetPath: ledgerDefinition.targetPath,
+                data: await client.post(ledgerDefinition.targetPath, buildFinanceBody(args, ["ledger", "type", "kind"]))
+            };
+        },
+        crm_query_finance_report: async (args) => {
+            const reportDefinition = getFinanceEndpointByKey(args.report ?? args.type ?? args.kind, FINANCE_REPORT_QUERIES, "财务报表");
+            const targetPath = args.checkBalance || args.balanceCheck ? `${reportDefinition.targetPath}/balanceCheck` : reportDefinition.targetPath;
+            return {
+                module: "financeReport",
+                moduleName: reportDefinition.name,
+                report: reportDefinition.key,
+                balanceCheck: Boolean(args.checkBalance || args.balanceCheck),
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildFinanceBody(args, ["report", "type", "kind", "checkBalance", "balanceCheck"]))
+            };
+        },
+        crm_list_finance_subjects: async (args) => {
+            const targetPath = "/financeSubject/list";
+            return {
+                module: "financeSubject",
+                moduleName: "科目",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildFinanceBody(args))
+            };
+        },
+        crm_list_finance_currencies: async (args) => {
+            const targetPath = args.accountId ? "/financeCurrency/queryListByAccountId" : "/financeCurrency/queryAllList";
+            return {
+                module: "financeCurrency",
+                moduleName: "币别",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildFinanceBody(args))
+            };
+        },
+        crm_list_finance_voucher_words: async (args) => {
+            const targetPath = "/financeVoucher/queryList";
+            return {
+                module: "financeVoucher",
+                moduleName: "凭证字",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildFinanceBody(args))
+            };
+        },
+        crm_query_finance_dashboard: async (args) => {
+            const dashboardDefinition = getFinanceEndpointByKey(args.query ?? args.type ?? args.kind, FINANCE_DASHBOARD_QUERIES, "财务仪表盘");
+            return {
+                module: "financeDashboard",
+                moduleName: dashboardDefinition.name,
+                query: dashboardDefinition.key,
+                readonly: true,
+                targetPath: dashboardDefinition.targetPath,
+                data: await client.post(dashboardDefinition.targetPath, buildFinanceBody(args, ["query", "type", "kind"]))
+            };
+        },
+        crm_write_hrm: async (args) => executeDomainWrite(client, WRITE_DOMAINS.hrm, args),
+        crm_create_hrm_record: async (args) => executeDomainWrite(client, WRITE_DOMAINS.hrm, {
+            targetPath: args.targetPath ?? args.path ?? args.endpoint ?? buildDomainTargetPath(args.module ?? "hrmEmployee", args.operation ?? args.action ?? "addEmployee"),
+            body: explicitWriteBody(args),
+            query: args.query,
+            confirm: args.confirm
+        }),
+        crm_update_hrm_record: async (args) => executeDomainWrite(client, WRITE_DOMAINS.hrm, {
+            targetPath: args.targetPath ?? args.path ?? args.endpoint ?? buildDomainTargetPath(args.module ?? "hrmEmployee", args.operation ?? args.action ?? "updateInformation"),
+            body: explicitWriteBody(args),
+            query: args.query,
+            confirm: args.confirm
+        }),
+        crm_list_jxc_modules: () => ({
+            readonly: true,
+            modules: JXC_MODULES.map(({ aliases: _aliases, ...moduleDefinition }) => moduleDefinition)
+        }),
+        crm_search_jxc_records: async (args) => {
+            const moduleDefinition = getJxcModuleByKey(args.module);
+            const targetPath = `${moduleDefinition.basePath}/queryPageList`;
+            return {
+                module: moduleDefinition.key,
+                moduleName: moduleDefinition.name,
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildJxcSearchBody(args, moduleDefinition))
+            };
+        },
+        crm_get_jxc_record: async (args) => {
+            const moduleDefinition = getJxcModuleByKey(args.module);
+            const id = requireJxcId(args, "查询 JXC 记录详情请提供 id。");
+            const targetPath = `${moduleDefinition.basePath}/queryById/${id}`;
+            return {
+                module: moduleDefinition.key,
+                moduleName: moduleDefinition.name,
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_jxc_record_information: async (args) => {
+            const moduleDefinition = getJxcModuleByKey(args.module);
+            const id = requireJxcId(args, "查询 JXC 详情页字段请提供 id。");
+            const targetPath = `${moduleDefinition.basePath}/information/${id}`;
+            return {
+                module: moduleDefinition.key,
+                moduleName: moduleDefinition.name,
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_jxc_module_schema: async (args) => {
+            const moduleDefinition = getJxcModuleByKey(args.module);
+            const id = args.id ?? args.recordId;
+            const targetPath = id ? `${moduleDefinition.basePath}/field/${id}` : `${moduleDefinition.basePath}/field`;
+            return {
+                module: moduleDefinition.key,
+                moduleName: moduleDefinition.name,
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ type: args.type }))
+            };
+        },
+        crm_list_jxc_files: async (args) => {
+            const moduleDefinition = getJxcModuleByKey(args.module);
+            const targetPath = `${moduleDefinition.basePath}/queryFileList`;
+            return {
+                module: moduleDefinition.key,
+                moduleName: moduleDefinition.name,
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ id: requireJxcId(args, "查询 JXC 附件请提供 id。"), fileType: args.fileType }))
+            };
+        },
+        crm_list_jxc_stock_products: async (args) => {
+            const targetPath = "/jxcWarehouseProduct/queryPageList";
+            return {
+                module: "warehouseProduct",
+                moduleName: "产品库存",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildJxcStockProductsBody(args))
+            };
+        },
+        crm_get_jxc_product_inventory: async (args) => {
+            const productId = requireJxcProductId(args);
+            const targetPath = `/jxcProduct/queryProductInventory/${productId}`;
+            return {
+                module: "productInventory",
+                moduleName: "产品库存",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, cleanQuery({ warehouseId: args.warehouseId }))
+            };
+        },
+        crm_list_jxc_stock_movements: async (args) => {
+            const targetPath = "/jxcDetailed/queryPageList";
+            return {
+                module: "detailed",
+                moduleName: "出入库明细",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildJxcStockMovementsBody(args))
+            };
+        },
+        crm_get_jxc_warehouse_product_stock: async (args) => {
+            const targetPath = "/jxcWarehouse/queryProductWarehouseNumBatch";
+            return {
+                module: "warehouseProductStock",
+                moduleName: "仓库产品库存数量",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, requireWarehouseProductIdsMap(args))
+            };
+        },
+        crm_get_jxc_warehouse_names: async (args) => {
+            const targetPath = "/jxcWarehouse/queryWarehouseNameByIds";
+            return {
+                module: "warehouse",
+                moduleName: "仓库",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, requireWarehouseIds(args))
+            };
+        },
+        crm_write_jxc: async (args) => executeDomainWrite(client, WRITE_DOMAINS.jxc, args),
+        crm_create_jxc_record: async (args) => {
+            const moduleDefinition = getJxcModuleByKey(args.module);
+            const targetPath = `${moduleDefinition.basePath}/add`;
+            const body = buildJxcRecordSaveBody(args, moduleDefinition, false);
+            if (!args.confirm) {
+                return previewDomainWrite(WRITE_DOMAINS.jxc, targetPath, body, args.query);
+            }
+            return {
+                module: moduleDefinition.key,
+                moduleName: moduleDefinition.name,
+                targetPath,
+                body,
+                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+            };
+        },
+        crm_update_jxc_record: async (args) => {
+            const moduleDefinition = getJxcModuleByKey(args.module);
+            const targetPath = args.useInformationUpdate ? `${moduleDefinition.basePath}/updateInformation` : `${moduleDefinition.basePath}/update`;
+            const body = args.useInformationUpdate
+                ? buildJxcUpdateInformationBody(args, moduleDefinition)
+                : buildJxcRecordSaveBody(args, moduleDefinition, true);
+            if (!args.confirm) {
+                return previewDomainWrite(WRITE_DOMAINS.jxc, targetPath, body, args.query);
+            }
+            return {
+                module: moduleDefinition.key,
+                moduleName: moduleDefinition.name,
+                targetPath,
+                body,
+                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+            };
+        },
+        crm_write_finance: async (args) => executeDomainWrite(client, WRITE_DOMAINS.finance, args),
+        crm_create_finance_voucher: async (args) => {
+            const targetPath = "/financeCertificate/add";
+            const body = buildFinanceVoucherWriteBody(args, false);
+            if (!args.confirm) {
+                return previewDomainWrite(WRITE_DOMAINS.finance, targetPath, body, args.query);
+            }
+            return {
+                module: "financeCertificate",
+                moduleName: "凭证",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+            };
+        },
+        crm_update_finance_voucher: async (args) => {
+            const targetPath = "/financeCertificate/update";
+            const body = buildFinanceVoucherWriteBody(args, true);
+            if (!args.confirm) {
+                return previewDomainWrite(WRITE_DOMAINS.finance, targetPath, body, args.query);
+            }
+            return {
+                module: "financeCertificate",
+                moduleName: "凭证",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+            };
+        },
+        crm_list_calendar_events: async (args) => ({
+            module: "calendarEvent",
+            targetPath: "/oaEvent/queryList",
+            data: await client.post("/oaEvent/queryList", buildCalendarListBody(args))
+        }),
+        crm_get_calendar_event: async (args) => ({
+            module: "calendarEvent",
+            targetPath: "/oaEvent/queryById",
+            data: await client.post("/oaEvent/queryById", buildCalendarDetailBody(args))
+        }),
+        crm_list_oa_announcements: async (args) => {
+            const targetPath = "/oaAnnouncement/queryList";
+            const query = buildOaAnnouncementListQuery(args);
+            return {
+                module: "oaAnnouncement",
+                moduleName: "公告",
+                readonly: true,
+                targetPath,
+                query,
+                data: await client.post(targetPath, undefined, query)
+            };
+        },
+        crm_get_oa_announcement: async (args) => {
+            const announcementId = requireOaAnnouncementId(args, "查询 OA 公告请提供 announcementId 或 id。");
+            const targetPath = `/oaAnnouncement/queryById/${announcementId}`;
+            return {
+                module: "oaAnnouncement",
+                moduleName: "公告",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_create_oa_announcement: async (args) => executeOaAnnouncementWrite(client, args, false),
+        crm_update_oa_announcement: async (args) => executeOaAnnouncementWrite(client, args, true),
+        crm_delete_oa_announcement: async (args) => {
+            const announcementId = requireOaAnnouncementId(args, "删除 OA 公告请提供 announcementId 或 id。");
+            const targetPath = `/oaAnnouncement/delete/${announcementId}`;
+            if (!args.confirm) {
+                return previewOaWrite("delete", "oaAnnouncement", "公告", targetPath, {});
+            }
+            return {
+                module: "oaAnnouncement",
+                moduleName: "公告",
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_mark_oa_announcement_read: async (args) => {
+            const targetPath = "/oaAnnouncement/readAnnouncement";
+            const body = buildOaAnnouncementReadBody(args);
+            if (!args.confirm) {
+                return previewOaWrite("read", "oaAnnouncement", "公告", targetPath, body);
+            }
+            return {
+                module: "oaAnnouncement",
+                moduleName: "公告",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_list_oa_logs: async (args) => {
+            const targetPath = "/oaLog/queryList";
+            return {
+                module: "oaLog",
+                moduleName: "日志",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaLogListBody(args))
+            };
+        },
+        crm_get_oa_log: async (args) => {
+            const targetPath = "/oaLog/queryById";
+            const query = { logId: requireOaLogId(args, "查询 OA 日志请提供 logId 或 id。") };
+            return {
+                module: "oaLog",
+                moduleName: "日志",
+                readonly: true,
+                targetPath,
+                query,
+                data: await client.post(targetPath, undefined, query)
+            };
+        },
+        crm_get_oa_log_information: async (args) => {
+            const logId = requireOaLogId(args, "查询 OA 日志详情页字段请提供 logId 或 id。");
+            const targetPath = `/oaLog/information/${logId}`;
+            return {
+                module: "oaLog",
+                moduleName: "日志",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_list_oa_log_templates: async (args) => {
+            const targetPath = "/oaLogTemplate/queryPartList";
+            return {
+                module: "oaLogTemplate",
+                moduleName: "日志模板",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaLogTemplateListBody(args))
+            };
+        },
+        crm_get_oa_log_fields: async (args) => {
+            const logId = args.logId ?? args.id;
+            const targetPath = logId ? `/oaLogTemplateField/field/${logId}` : "/oaLogTemplateField/field";
+            return {
+                module: "oaLog",
+                moduleName: "日志字段",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, undefined, buildOaLogFieldQuery(args))
+            };
+        },
+        crm_get_oa_log_welcome: async () => {
+            const targetPath = "/oaLog/getLogWelcomeSpeech";
+            return {
+                module: "oaLog",
+                moduleName: "日志欢迎语",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_oa_log_bulletin: async () => {
+            const targetPath = "/oaLog/queryLogBulletin";
+            return {
+                module: "oaLog",
+                moduleName: "日志概要",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_oa_log_complete_stats: async (args) => {
+            const targetPath = "/oaLog/queryCompleteStats";
+            const query = { configId: requireOaLogConfigId(args) };
+            return {
+                module: "oaLog",
+                moduleName: "日志完成统计",
+                readonly: true,
+                targetPath,
+                query,
+                data: await client.post(targetPath, undefined, query)
+            };
+        },
+        crm_list_oa_log_complete_records: async (args) => {
+            const targetPath = "/oaLog/queryCompleteOaLogList";
+            return {
+                module: "oaLog",
+                moduleName: "日志已完成列表",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaLogListBody(args))
+            };
+        },
+        crm_list_oa_log_incomplete_records: async (args) => {
+            const targetPath = "/oaLog/queryIncompleteOaLogList";
+            return {
+                module: "oaLog",
+                moduleName: "日志未完成列表",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaLogListBody(args))
+            };
+        },
+        crm_list_oa_examine_categories: async (args) => {
+            const targetPath = "/examines/queryPartList";
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaExamineCategoryBody(args))
+            };
+        },
+        crm_list_oa_examine_groups: async (args) => {
+            const targetPath = "/examineSuperExamines/queryExamineGroup";
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaExamineGroupBody(args))
+            };
+        },
+        crm_list_oa_examines: async (args) => {
+            const listDefinition = getOaExamineListDefinition(args);
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                readonly: true,
+                listType: listDefinition.key,
+                listName: listDefinition.name,
+                targetPath: listDefinition.targetPath,
+                data: await client.post(listDefinition.targetPath, buildOaExamineListBody(args))
+            };
+        },
+        crm_get_oa_examine: async (args) => {
+            const examineId = requireOaExamineId(args, "查询 OA 审批详情请提供 examineId 或 id。");
+            const targetPath = `/oaExamine/queryOaExamineInfo/${examineId}`;
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath)
+            };
+        },
+        crm_get_oa_examine_fields: async (args) => {
+            const categoryId = args.categoryId ?? args.examineIdForFields;
+            if (!isBlank(categoryId) && isBlank(args.examineId) && isBlank(args.id)) {
+                const useListEndpoint = args.useFieldList || args.fieldList || args.mode === "list";
+                const targetPath = useListEndpoint ? `/oaExamineField/queryFieldList/${categoryId}` : `/oaExamineField/queryField/${categoryId}`;
+                return {
+                    module: "oaExamine",
+                    moduleName: "办公审批",
+                    readonly: true,
+                    targetPath,
+                    data: await client.post(targetPath, useListEndpoint ? undefined : buildOaExamineCreateFieldQuery(args, categoryId))
+                };
+            }
+            const targetPath = "/oaExamine/getField";
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaExamineFieldBody(args))
+            };
+        },
+        crm_list_oa_examine_record_logs: async (args) => {
+            const targetPath = "/examineRecord/queryExamineRecordLog";
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaExamineRecordLogBody(args))
+            };
+        },
+        crm_list_oa_examine_flow_records: async (args) => {
+            const targetPath = "/examineSuperExamine/examine/record/list";
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                readonly: true,
+                targetPath,
+                data: await client.post(targetPath, buildOaExamineFlowRecordBody(args))
+            };
+        },
+        crm_list_oa_tasks: async (args) => ({
+            module: "oaTask",
+            targetPath: "/oaTask/queryTaskList",
+            data: await client.post("/oaTask/queryTaskList", buildOaTaskListBody(args))
+        }),
+        crm_list_related_oa_tasks: async (args) => ({
+            module: "oaTask",
+            targetPath: "/oaTask/queryTypeTaskList",
+            data: await client.post("/oaTask/queryTypeTaskList", undefined, buildRelatedOaTaskQuery(args))
+        }),
+        crm_preview_write: (args) => previewWrite(args),
+        crm_update_customer: async (args) => {
+            const moduleDefinition = getModuleByKey("customer");
+            const targetPath = `${moduleDefinition.basePath}/updateInformation`;
+            const directId = args.customerId ?? args.id;
+            if (!args.confirm) {
+                return previewWrite({
+                    ...args,
+                    module: "customer",
+                    id: directId ?? "<需要通过客户查询唯一命中后填充>",
+                    operation: "updateInformation",
+                    targetPath
+                });
+            }
+            const resolvedRecord = directId ? undefined : await resolveUniqueRecord(client, moduleDefinition, args);
+            const id = directId ?? resolvedRecord?.[moduleDefinition.primaryKey] ?? resolvedRecord?.id;
+            const body = await buildUpdateInformationBody(client, moduleDefinition, { ...args, id });
+            const data = await client.post(targetPath, body);
+            const verification = args.verify === false ? undefined : await verifyInformationUpdate(client, moduleDefinition, body);
+            return cleanObject({
+                module: moduleDefinition.key,
+                targetPath,
+                resolvedRecord,
+                body,
+                data,
+                verification
+            });
+        },
+        crm_create_record: async (args) => {
+            const moduleDefinition = getModuleByKey(args.module);
+            ensureWritableModule(moduleDefinition);
+            const targetPath = `${moduleDefinition.basePath}/add`;
+            if (!args.confirm) {
+                return previewWrite({ ...args, operation: "create", targetPath });
+            }
+            return {
+                module: moduleDefinition.key,
+                targetPath,
+                data: await client.post(targetPath, buildModelSaveBody(args))
+            };
+        },
+        crm_update_record_fields: async (args) => {
+            const moduleDefinition = getModuleByKey(args.module);
+            ensureWritableModule(moduleDefinition);
+            const targetPath = `${moduleDefinition.basePath}/updateInformation`;
+            if (!args.confirm) {
+                return previewWrite({ ...args, operation: "updateInformation", targetPath });
+            }
+            const body = await buildUpdateInformationBody(client, moduleDefinition, args);
+            const data = await client.post(targetPath, body);
+            const verification = args.verify === false ? undefined : await verifyInformationUpdate(client, moduleDefinition, body);
+            return {
+                module: moduleDefinition.key,
+                targetPath,
+                body,
+                data,
+                verification
+            };
+        },
+        crm_create_product: async (args) => executeCrmProductSave(client, args, false),
+        crm_update_product: async (args) => executeCrmProductSave(client, args, true),
+        crm_update_product_fields: async (args) => {
+            const moduleDefinition = getModuleByKey("product");
+            const id = args.productId ?? args.id;
+            const targetPath = "/crmProduct/updateInformation";
+            if (!args.confirm) {
+                return previewWrite({ ...args, module: "product", id, operation: "updateInformation", targetPath });
+            }
+            const body = await buildUpdateInformationBody(client, moduleDefinition, { ...args, id });
+            const data = await client.post(targetPath, body);
+            const verification = args.verify === false ? undefined : await verifyInformationUpdate(client, moduleDefinition, body);
+            return cleanObject({
+                module: "product",
+                moduleName: "产品",
+                targetPath,
+                body,
+                data,
+                verification
+            });
+        },
+        crm_update_product_status: async (args) => executeCrmProductSimpleWrite(client, args, "status", "/crmProduct/updateStatus", buildCrmProductStatusBody(args)),
+        crm_transfer_products_owner: async (args) => executeCrmProductSimpleWrite(client, args, "transferOwner", "/crmProduct/changeOwnerUser", buildCrmProductTransferBody(args)),
+        crm_delete_products: async (args) => executeCrmProductSimpleWrite(client, args, "delete", "/crmProduct/deleteByIds", requireIdArray(args.ids ?? args.productIds, "删除 CRM 产品请提供 ids 或 productIds 数组。")),
+        crm_create_contract: async (args) => executeCrmDocumentWrite(client, "contract", args, false),
+        crm_update_contract: async (args) => executeCrmDocumentWrite(client, "contract", args, true),
+        crm_create_receivables: async (args) => executeCrmDocumentWrite(client, "receivables", args, false),
+        crm_update_receivables: async (args) => executeCrmDocumentWrite(client, "receivables", args, true),
+        crm_create_receivables_plan: async (args) => executeCrmDocumentWrite(client, "receivablesPlan", args, false),
+        crm_update_receivables_plan: async (args) => executeCrmDocumentWrite(client, "receivablesPlan", args, true),
+        crm_create_invoice: async (args) => executeCrmDocumentWrite(client, "invoice", args, false),
+        crm_update_invoice: async (args) => executeCrmDocumentWrite(client, "invoice", args, true),
+        crm_create_quotation: async (args) => executeCrmDocumentWrite(client, "quotation", args, false),
+        crm_update_quotation: async (args) => executeCrmDocumentWrite(client, "quotation", args, true),
+        crm_create_calendar_event: async (args) => {
+            const targetPath = "/oaEvent/save";
+            const body = buildCalendarEventBody(args, false);
+            if (!args.confirm) {
+                return previewCalendarWrite("createCalendarEvent", targetPath, body);
+            }
+            return {
+                module: "calendarEvent",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_update_calendar_event: async (args) => {
+            const targetPath = "/oaEvent/update";
+            const body = buildCalendarEventBody(args, true);
+            if (!args.confirm) {
+                return previewCalendarWrite("updateCalendarEvent", targetPath, body);
+            }
+            return {
+                module: "calendarEvent",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_create_oa_log: async (args) => executeOaLogWrite(client, args, false),
+        crm_update_oa_log: async (args) => executeOaLogWrite(client, args, true),
+        crm_delete_oa_log: async (args) => {
+            const targetPath = "/oaLog/deleteById";
+            const query = { logId: requireOaLogId(args, "删除 OA 日志请提供 logId 或 id。") };
+            if (!args.confirm) {
+                return previewOaWrite("delete", "oaLog", "日志", targetPath, query);
+            }
+            return {
+                module: "oaLog",
+                moduleName: "日志",
+                targetPath,
+                query,
+                data: await client.post(targetPath, undefined, query)
+            };
+        },
+        crm_toggle_oa_log_favour: async (args) => {
+            const targetPath = "/oaLog/favourOrCancel";
+            const query = buildOaLogFavourQuery(args);
+            if (!args.confirm) {
+                return previewOaWrite("favourOrCancel", "oaLog", "日志", targetPath, query);
+            }
+            return {
+                module: "oaLog",
+                moduleName: "日志",
+                targetPath,
+                query,
+                data: await client.post(targetPath, undefined, query)
+            };
+        },
+        crm_create_oa_examine: async (args) => {
+            const targetPath = "/oaExamine/setOaExamine";
+            const body = await buildOaExamineWriteBody(client, args, false);
+            if (!args.confirm) {
+                return previewOaWrite("createOaExamine", "oaExamine", "办公审批", targetPath, body);
+            }
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_save_oa_examine_draft: async (args) => {
+            const targetPath = "/oaExamine/setOaExamineDraft";
+            const body = await buildOaExamineWriteBody(client, args, false);
+            if (!args.confirm) {
+                return previewOaWrite("saveOaExamineDraft", "oaExamine", "办公审批", targetPath, body);
+            }
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_audit_oa_examine: async (args) => {
+            const targetPath = "/examineRecord/auditExamine";
+            const body = buildOaExamineAuditBody(args, false);
+            if (!args.confirm) {
+                return previewOaWrite("auditOaExamine", "oaExamine", "办公审批", targetPath, body);
+            }
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_batch_audit_oa_examine: async (args) => {
+            const targetPath = "/examineRecord/batchAuditExamine";
+            const body = buildOaExamineAuditBody(args, true);
+            if (!args.confirm) {
+                return previewOaWrite("batchAuditOaExamine", "oaExamine", "办公审批", targetPath, body);
+            }
+            return {
+                module: "oaExamine",
+                moduleName: "办公审批",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_create_oa_task: async (args) => {
+            const targetPath = "/workTask/saveWorkTask";
+            const body = buildOaTaskBody(args);
+            if (!args.confirm) {
+                return previewOaTaskWrite("createOaTask", targetPath, body);
+            }
+            return {
+                module: "oaTask",
+                targetPath,
+                body,
+                data: await client.post(targetPath, body)
+            };
+        },
+        crm_update_oa_task_fields: async (args) => {
+            const calls = buildOaTaskUpdateCalls(args);
+            if (!args.confirm) {
+                return {
+                    preview: true,
+                    message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+                    module: "oaTask",
+                    moduleName: "OA任务",
+                    operation: "updateOaTaskFields",
+                    calls
+                };
+            }
+            const results = [];
+            for (const call of calls) {
+                results.push({
+                    targetPath: call.targetPath,
+                    data: await client.post(call.targetPath, call.body)
+                });
+            }
+            return {
+                module: "oaTask",
+                results
+            };
+        },
+        crm_add_followup: async (args) => {
+            const targetPath = "/crmActivity/add";
+            if (!args.confirm) {
+                return previewWrite({ ...args, operation: "addFollowup", targetPath });
+            }
+            return {
+                module: "activity",
+                targetPath,
+                data: await client.post(targetPath, buildFollowupSaveBody(args))
+            };
+        },
+        crm_update_followup: async (args) => {
+            const targetPath = args.useInformationUpdate ? "/crmActivity/updateInformation" : "/crmActivity/update";
+            if (!args.confirm) {
+                return previewWrite({ ...args, operation: "updateFollowup", targetPath });
+            }
+            const body = args.useInformationUpdate
+                ? cleanObject({ id: args.id, label: 19, list: args.list ?? args.fields ?? [], batchId: args.batchId })
+                : buildFollowupSaveBody(args);
+            return {
+                module: "activity",
+                targetPath,
+                data: await client.post(targetPath, body)
+            };
+        },
+        workorder_search_records: async (args) => searchWorkorders(client, args),
+        workorder_get_record: async (args) => getWorkorder(client, args),
+        workorder_get_schema: async (args) => getWorkorderSchema(client, args),
+        workorder_preview_write: async (args) => previewWorkorderWrite(args),
+        workorder_create_record: async (args) => saveWorkorder(client, args, false),
+        workorder_update_record: async (args) => saveWorkorder(client, args, true)
+    };
+}
+async function searchWorkorders(client, args) {
+    const scope = normalizeWorkorderScope(args.scope, true);
+    const body = cleanObject({
+        page: positiveInteger(args.page, 1),
+        limit: positiveInteger(args.limit, 15),
+        search: args.search ?? args.keyword ?? args.query,
+        statusId: args.statusId,
+        status: args.status,
+        templateId: args.templateId,
+        priority: args.priority,
+        sceneId: args.sceneId,
+        viewMode: args.viewMode,
+        startTime: args.startTime,
+        endTime: args.endTime,
+        isPool: scope === "pool" ? 1 : 0
+    });
+    const targetPath = scope === "offline" ? "/wkoOfflineWorkorder/queryPageList" : "/wkoWorkorder/queryPageList";
+    return {
+        module: "workorder",
+        scope,
+        readonly: true,
+        targetPath,
+        data: await client.post(targetPath, body)
+    };
+}
+async function getWorkorder(client, args) {
+    const scope = normalizeWorkorderScope(args.scope, false);
+    const id = requiredWorkorderId(args.id);
+    const prefix = scope === "offline" ? "/wkoOfflineWorkorder" : "/wkoWorkorder";
+    const [record, information] = await Promise.all([
+        client.post(`${prefix}/queryById/${id}`),
+        client.post(`${prefix}/information/${id}`)
+    ]);
+    return {
+        module: "workorder",
+        scope,
+        id,
+        record,
+        information
+    };
+}
+async function getWorkorderSchema(client, args) {
+    const scope = normalizeWorkorderScope(args.scope, false);
+    const prefix = scope === "offline" ? "/wkoOfflineWorkorder" : "/wkoWorkorder";
+    const id = args.id === undefined || args.id === null || args.id === "" ? "" : `/${requiredWorkorderId(args.id)}`;
+    return {
+        module: "workorder",
+        scope,
+        readonly: true,
+        targetPath: `${prefix}/field${id}`,
+        fields: await client.post(`${prefix}/field${id}`, cleanObject({ templateId: args.templateId }))
+    };
+}
+function previewWorkorderWrite(args) {
+    const update = Boolean(args.id ?? args.workorderId ?? args.offlineWorkorderId);
+    const prepared = prepareWorkorderWrite(args, update);
+    return {
+        preview: true,
+        message: "写入前预览：未传 confirm=true，MCP 不会调用工单写接口。",
+        ...prepared
+    };
+}
+async function saveWorkorder(client, args, update) {
+    const prepared = prepareWorkorderWrite(args, update);
+    if (args.confirm !== true) {
+        return {
+            preview: true,
+            message: "写入前预览：请核对字段并传 confirm=true 后再执行。",
+            ...prepared
+        };
+    }
+    const data = await client.post(prepared.targetPath, prepared.body);
+    const id = extractSavedWorkorderId(data, prepared);
+    const verification = id
+        ? await getWorkorder(client, { scope: prepared.scope, id })
+        : { ok: false, message: "服务端未返回工单 ID，请使用列表查询核对写入结果。" };
+    return {
+        preview: false,
+        scope: prepared.scope,
+        targetPath: prepared.targetPath,
+        data,
+        verification
+    };
+}
+function prepareWorkorderWrite(args, update) {
+    const scope = normalizeWorkorderScope(args.scope, false);
+    if (scope === "offline") {
+        const source = safeExtra(args.body ?? args.record ?? args.data);
+        const id = update ? requiredWorkorderId(args.id ?? args.offlineWorkorderId ?? source.offlineWorkorderId) : undefined;
+        const body = cleanObject({ ...source, ...(id ? { offlineWorkorderId: id } : {}) });
+        return { scope, targetPath: `/wkoOfflineWorkorder/${update ? "update" : "add"}`, body };
+    }
+    const sourceBody = safeExtra(args.body);
+    const sourceEntity = safeExtra(sourceBody.entity ?? args.entity ?? args.record ?? args.data);
+    const id = update ? requiredWorkorderId(args.id ?? args.workorderId ?? sourceEntity.workorderId) : undefined;
+    const entity = cleanObject({ ...sourceEntity, ...(id ? { workorderId: id } : {}) });
+    const body = Object.keys(sourceBody).length > 0
+        ? { ...sourceBody, entity }
+        : cleanObject({
+            entity,
+            field: args.field ?? args.fields ?? [],
+            ownerUserList: args.ownerUserList,
+            member: args.member,
+            saveType: args.saveType
+        });
+    return { scope, targetPath: `/wkoWorkorder/${update ? "update" : "add"}`, body };
+}
+function normalizeWorkorderScope(value, allowPool) {
+    const scope = String(value ?? "workorder").trim();
+    const allowed = allowPool ? ["workorder", "pool", "offline"] : ["workorder", "offline"];
+    if (!allowed.includes(scope)) {
+        throw new Error(`不支持的工单范围：${scope}。可选值：${allowed.join("、")}。`);
+    }
+    return scope;
+}
+function requiredWorkorderId(value) {
+    const id = String(value ?? "").trim();
+    if (!id) {
+        throw new Error("工单 ID 不能为空。");
+    }
+    return id;
+}
+function extractSavedWorkorderId(data, prepared) {
+    if (prepared.scope === "offline") {
+        return data?.offlineWorkorderId ?? prepared.body.offlineWorkorderId;
+    }
+    return data?.workorderId ?? prepared.body.entity?.workorderId;
+}
+const FIELD_SEARCH_CONTAINS = 3;
+const QUICK_SEARCH_FIELDS = {
+    leads: [
+        { fieldName: "leadsName", formType: "text" },
+        { fieldName: "mobile", formType: "mobile" },
+        { fieldName: "telephone", formType: "text" }
+    ],
+    leadsPool: [
+        { fieldName: "leadsName", formType: "text" },
+        { fieldName: "mobile", formType: "mobile" },
+        { fieldName: "telephone", formType: "text" }
+    ],
+    customer: [
+        { fieldName: "customerName", formType: "text" },
+        { fieldName: "mobile", formType: "mobile" },
+        { fieldName: "telephone", formType: "text" }
+    ],
+    customerPool: [
+        { fieldName: "customerName", formType: "text" },
+        { fieldName: "mobile", formType: "mobile" },
+        { fieldName: "telephone", formType: "text" }
+    ],
+    contacts: [
+        { fieldName: "name", formType: "text" },
+        { fieldName: "mainFieldValue", formType: "text" },
+        { fieldName: "mobile", formType: "mobile" },
+        { fieldName: "telephone", formType: "text" },
+        { fieldName: "email", formType: "email" }
+    ],
+    business: [{ fieldName: "businessName", formType: "text" }],
+    product: [{ fieldName: "name", formType: "text" }],
+    contract: [
+        { fieldName: "num", formType: "text" },
+        { fieldName: "name", formType: "text" },
+        { fieldName: "customerName", formType: "text" }
+    ],
+    receivables: [
+        { fieldName: "number", formType: "text" },
+        { fieldName: "customerName", formType: "text" }
+    ],
+    receivablesPlan: [
+        { fieldName: "customerName", formType: "text" },
+        { fieldName: "contractNum", formType: "text" }
+    ],
+    invoice: [
+        { fieldName: "invoiceApplyNumber", formType: "text" },
+        { fieldName: "invoiceNumber", formType: "text" },
+        { fieldName: "customerName", formType: "text" }
+    ],
+    activity: [{ fieldName: "content", formType: "text" }],
+    quotation: [
+        { fieldName: "name", formType: "text" },
+        { fieldName: "num", formType: "text" },
+        { fieldName: "customerName", formType: "text" }
+    ],
+    returnVisit: [
+        { fieldName: "customerName", formType: "text" },
+        { fieldName: "contractNum", formType: "text" }
+    ],
+    visitPlan: [
+        { fieldName: "customerName", formType: "text" },
+        { fieldName: "contactsName", formType: "text" }
+    ]
+};
+const NAME_FIELD_BY_MODULE = {
+    leads: { fieldName: "leadsName", formType: "text" },
+    leadsPool: { fieldName: "leadsName", formType: "text" },
+    customer: { fieldName: "customerName", formType: "text" },
+    customerPool: { fieldName: "customerName", formType: "text" },
+    contacts: { fieldName: "name", formType: "text" },
+    business: { fieldName: "businessName", formType: "text" },
+    product: { fieldName: "name", formType: "text" },
+    contract: { fieldName: "name", formType: "text" },
+    quotation: { fieldName: "name", formType: "text" }
+};
+const USER_FILTER_FORM_TYPES = new Set(["user", "single_user"]);
+const USER_FILTER_FIELD_NAMES = new Set(["ownerUserId", "createUserId"]);
+const USER_FILTER_ARGUMENTS = [
+    {
+        fieldName: "ownerUserId",
+        idKeys: ["ownerUserId", "ownerUserIds"],
+        nicknameKeys: ["ownerUserName", "ownerUserNames", "ownerName", "ownerNames"]
+    },
+    {
+        fieldName: "createUserId",
+        idKeys: ["createUserId", "createUserIds", "creatorUserId", "creatorUserIds"],
+        nicknameKeys: ["createUserName", "createUserNames", "creatorUserName", "creatorUserNames", "creatorName", "creatorNames"]
+    }
+];
+async function buildResolvedSearchList(client, args, moduleDefinition) {
+    const searchList = buildSearchList(args, moduleDefinition);
+    const userSearchList = buildConvenienceUserSearchList(args);
+    return resolveUserSearchFilters(client, combineSearchLists(searchList, userSearchList), args.companyId);
+}
+function buildSearchList(args, moduleDefinition) {
+    const explicitSearchList = toArray(args.filters ?? args.searchList);
+    const semanticSearchList = buildSemanticSearchList(args, moduleDefinition);
+    return combineSearchLists(explicitSearchList, semanticSearchList);
+}
+function buildConvenienceUserSearchList(args) {
+    return USER_FILTER_ARGUMENTS.flatMap(({ fieldName, idKeys, nicknameKeys }) => {
+        const values = [...argumentValues(args, idKeys), ...argumentValues(args, nicknameKeys)];
+        if (values.length === 0) {
+            return [];
+        }
+        return [{
+                fieldName,
+                formType: "user",
+                type: 1,
+                searchEnum: 1,
+                values
+            }];
+    });
+}
+function argumentValues(args, keys) {
+    return keys.flatMap((key) => valueArray(args[key]));
+}
+function valueArray(value) {
+    if (value === undefined || value === null) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+function combineSearchLists(left, right) {
+    if (left.length === 0) {
+        return right;
+    }
+    if (right.length === 0) {
+        return left;
+    }
+    const leftGroups = groupSearchFilters(left);
+    const rightGroups = groupSearchFilters(right);
+    const result = [];
+    let groupId = 0;
+    for (const leftGroup of leftGroups) {
+        for (const rightGroup of rightGroups) {
+            for (const filter of [...leftGroup, ...rightGroup]) {
+                result.push({ ...filter, groupId });
+            }
+            groupId += 1;
+        }
+    }
+    return result;
+}
+function groupSearchFilters(filters) {
+    const groups = new Map();
+    for (const filter of filters) {
+        const groupId = filter.groupId ?? 0;
+        const group = groups.get(groupId) ?? [];
+        group.push(filter);
+        groups.set(groupId, group);
+    }
+    return [...groups.values()];
+}
+async function resolveUserSearchFilters(client, searchList, companyId) {
+    const nicknameCache = new Map();
+    const resolvedFilters = [];
+    for (const filter of searchList) {
+        if (!isUserSearchFilter(filter)) {
+            resolvedFilters.push(filter);
+            continue;
+        }
+        const rawValues = valueArray(filter.values ?? filter.value);
+        const searchType = Number(filter.type ?? filter.searchEnum);
+        if (rawValues.length === 0 && (searchType === 5 || searchType === 6)) {
+            resolvedFilters.push({ ...filter, formType: filter.formType ?? "user" });
+            continue;
+        }
+        if (rawValues.length === 0) {
+            throw new Error(`用户类型筛选“${filter.fieldName ?? filter.name ?? "未知字段"}”请提供 values。`);
+        }
+        const values = [];
+        for (const value of rawValues) {
+            values.push(await resolveUserFilterValue(client, value, nicknameCache, companyId));
+        }
+        resolvedFilters.push({
+            ...filter,
+            formType: filter.formType ?? "user",
+            values: [...new Set(values)]
+        });
+    }
+    return resolvedFilters;
+}
+function isUserSearchFilter(filter) {
+    const formType = String(filter.formType ?? "").trim().toLowerCase();
+    return USER_FILTER_FORM_TYPES.has(formType) || USER_FILTER_FIELD_NAMES.has(String(filter.fieldName ?? filter.name ?? ""));
+}
+async function resolveUserFilterValue(client, value, nicknameCache, companyId) {
+    const objectValue = isPlainObject(value) ? value : undefined;
+    const idValue = objectValue ? objectValue.userId ?? objectValue.id : value;
+    const userId = normalizePositiveUserId(idValue);
+    if (userId) {
+        return userId;
+    }
+    const nicknameValue = objectValue
+        ? objectValue.realname ?? objectValue.nickname ?? objectValue.name
+        : value;
+    const nickname = firstTextValue(nicknameValue);
+    if (!nickname) {
+        throw new Error("用户类型筛选值必须是正整数用户 ID、昵称字符串，或包含 userId/realname 的对象。");
+    }
+    return resolveUserIdByNickname(client, nickname, nicknameCache, companyId);
+}
+function normalizePositiveUserId(value) {
+    if (typeof value === "number") {
+        return Number.isSafeInteger(value) && value > 0 ? String(value) : undefined;
+    }
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const text = value.trim();
+    return /^[1-9]\d*$/.test(text) ? text : undefined;
+}
+async function resolveUserIdByNickname(client, nickname, cache, companyId) {
+    const normalizedNickname = normalizeText(nickname);
+    const cached = cache.get(normalizedNickname);
+    if (cached) {
+        return cached;
+    }
+    const page = await client.post("/adminUser/queryUserList", {
+        page: 1,
+        limit: 100,
+        pageType: 1,
+        realname: nickname,
+        companyId
+    });
+    const users = Array.isArray(page.list)
+        ? page.list
+        : Array.isArray(page.records)
+            ? page.records
+            : [];
+    const exactMatches = users.filter((user) => normalizeText(user.realname ?? user.name) === normalizedNickname);
+    const validMatches = exactMatches.filter((user) => normalizePositiveUserId(user.userId ?? user.id));
+    if (validMatches.length === 1) {
+        const userId = normalizePositiveUserId(validMatches[0].userId ?? validMatches[0].id);
+        cache.set(normalizedNickname, userId);
+        return userId;
+    }
+    if (validMatches.length > 1) {
+        throw new Error(`昵称“${nickname}”匹配到多个用户：${formatUserCandidates(validMatches)}。请直接传入明确的用户 ID。`);
+    }
+    const suggestions = users.filter((user) => normalizePositiveUserId(user.userId ?? user.id)).slice(0, 5);
+    const suggestionText = suggestions.length > 0 ? ` 相近用户：${formatUserCandidates(suggestions)}。` : "";
+    throw new Error(`未找到昵称完全等于“${nickname}”的用户。${suggestionText}请先使用 crm_list_users 核对昵称，或直接传入用户 ID。`);
+}
+function formatUserCandidates(users) {
+    return users.map((user) => {
+        const userId = normalizePositiveUserId(user.userId ?? user.id);
+        const realname = firstTextValue(user.realname, user.name) ?? "未命名";
+        const deptName = firstTextValue(user.deptName);
+        return `${realname}(ID: ${userId}${deptName ? `, 部门: ${deptName}` : ""})`;
+    }).join("；");
+}
+function buildSemanticSearchList(args, moduleDefinition) {
+    const keyword = firstTextValue(args.keyword, args.query, args.q, args.search, args.searchText, args.text, args.term);
+    if (keyword) {
+        return containsFilters(QUICK_SEARCH_FIELDS[moduleDefinition.key] ?? [], keyword, 1);
+    }
+    const phone = firstTextValue(args.phone, args.mobile, args.telephone);
+    if (phone) {
+        const fields = (QUICK_SEARCH_FIELDS[moduleDefinition.key] ?? []).filter((field) => ["mobile", "telephone", "phone"].includes(field.fieldName));
+        return containsFilters(fields, phone, 1);
+    }
+    const name = firstTextValue(args.name, args.customerName, args.leadsName, args.contactsName, args.businessName, args.productName, args.contractName, args.quotationName);
+    const nameField = NAME_FIELD_BY_MODULE[moduleDefinition.key];
+    if (name && nameField) {
+        return containsFilters([nameField], name, 0);
+    }
+    const email = firstTextValue(args.email);
+    if (email) {
+        return containsFilters([{ fieldName: "email", formType: "email" }], email, 0);
+    }
+    return [];
+}
+function containsFilters(fields, value, startGroupId) {
+    return fields.map((field, index) => ({
+        fieldName: field.fieldName,
+        formType: field.formType,
+        type: FIELD_SEARCH_CONTAINS,
+        searchEnum: FIELD_SEARCH_CONTAINS,
+        values: [value],
+        groupId: fields.length > 1 ? startGroupId + index : startGroupId
+    }));
+}
+function firstTextValue(...values) {
+    for (const value of values) {
+        if (value === undefined || value === null) {
+            continue;
+        }
+        const text = String(value).trim();
+        if (text) {
+            return text;
+        }
+    }
+    return undefined;
+}
+function toArray(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (value && typeof value === "object") {
+        return [value];
+    }
+    return [];
+}
+async function resolveUniqueRecord(client, moduleDefinition, args) {
+    const searchList = await resolveUserSearchFilters(client, buildSearchList(args, moduleDefinition), args.companyId);
+    if (searchList.length === 0) {
+        throw new Error(`请提供可定位${moduleDefinition.name}的 customerId/id、phone/mobile、name/customerName 或 keyword。`);
+    }
+    const page = await client.post(`${moduleDefinition.basePath}/queryPageList`, cleanObject({
+        page: 1,
+        limit: 2,
+        pageType: 1,
+        label: moduleDefinition.label,
+        searchList
+    }));
+    const list = Array.isArray(page.list) ? page.list : [];
+    if (list.length !== 1) {
+        throw new Error(`需要唯一命中的${moduleDefinition.name}才能写入，当前命中 ${page.totalRow ?? list.length} 条，请先缩小查询条件或直接传入 ID。`);
+    }
+    return list[0];
+}
+async function buildUpdateInformationBody(client, moduleDefinition, args) {
+    const rawBody = buildUpdateInformationPreviewBody(moduleDefinition, args);
+    const fields = await fetchModuleFields(client, moduleDefinition, args);
+    const list = hydrateUpdateList(rawBody.list ?? [], fields);
+    const batchId = rawBody.batchId ?? await resolveUpdateBatchId(client, moduleDefinition, rawBody, list);
+    return {
+        ...rawBody,
+        batchId,
+        list
+    };
+}
+function buildUpdateInformationPreviewBody(moduleDefinition, args) {
+    return cleanObject({
+        id: args.id ?? args[moduleDefinition.primaryKey],
+        label: moduleDefinition.label,
+        list: rawUpdateList(args),
+        batchId: args.batchId,
+        idList: args.idList,
+        ownerUserSave: args.ownerUserSave
+    });
+}
+function rawUpdateList(args) {
+    const raw = args.list ?? args.fields ?? args.field;
+    const list = toArray(raw);
+    if (list.length > 0) {
+        return list;
+    }
+    const updates = args.updates;
+    if (!updates || typeof updates !== "object" || Array.isArray(updates)) {
+        return [];
+    }
+    return Object.entries(updates).map(([key, value]) => looksLikeFieldName(key) ? { fieldName: key, value } : { name: key, value });
+}
+function looksLikeFieldName(value) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(value);
+}
+async function fetchModuleFields(client, moduleDefinition, args) {
+    const id = args.id ?? args[moduleDefinition.primaryKey];
+    const path = id ? `${moduleDefinition.basePath}/field/${id}` : `${moduleDefinition.basePath}/field`;
+    const data = await client.post(path, undefined, cleanQuery({ type: args.type, poolId: args.poolId }));
+    return flattenFieldDefinitions(data);
+}
+function flattenFieldDefinitions(input) {
+    const output = [];
+    const seen = new Set();
+    const visit = (value) => {
+        if (!value || typeof value !== "object" || seen.has(value)) {
+            return;
+        }
+        seen.add(value);
+        if (Array.isArray(value)) {
+            value.forEach(visit);
+            return;
+        }
+        const record = value;
+        if (record.fieldName || record.fieldId || (record.name && (record.fieldType !== undefined || record.type !== undefined || record.formType))) {
+            output.push(record);
+        }
+        for (const child of Object.values(record)) {
+            if (child && typeof child === "object") {
+                visit(child);
+            }
+        }
+    };
+    visit(input);
+    return output;
+}
+function hydrateUpdateList(list, fields) {
+    return list.map((item) => hydrateUpdateItem(item, fields));
+}
+function hydrateUpdateItem(item, fields) {
+    const field = findFieldDefinition(item, fields);
+    if (!field && hasUpdateMetadata(item)) {
+        return normalizeUpdateItem(item);
+    }
+    if (!field) {
+        const fieldLabel = item.name ?? item.fieldName ?? item.fieldId ?? "<unknown>";
+        throw new Error(`未在字段 schema 中找到可写字段：${fieldLabel}。请先调用 crm_get_module_schema 确认字段名。`);
+    }
+    const merged = cleanObject({
+        fieldId: item.fieldId ?? field.fieldId ?? field.id,
+        fieldName: item.fieldName ?? field.fieldName,
+        name: item.name ?? field.name,
+        fieldType: item.fieldType ?? field.fieldType,
+        type: item.type ?? field.type,
+        formType: item.formType ?? field.formType,
+        value: normalizeOptionValue(item.value, field)
+    });
+    return normalizeUpdateItem(merged);
+}
+function hasUpdateMetadata(item) {
+    return Boolean(item.fieldName && item.fieldType !== undefined && item.type !== undefined);
+}
+function normalizeUpdateItem(item) {
+    return cleanObject({
+        fieldId: item.fieldId,
+        fieldName: item.fieldName,
+        name: item.name,
+        fieldType: item.fieldType,
+        type: item.type,
+        formType: item.formType,
+        value: item.value
+    });
+}
+async function resolveUpdateBatchId(client, moduleDefinition, body, list) {
+    if (body.batchId || !body.id || !updateNeedsBatchId(list)) {
+        return undefined;
+    }
+    const data = await client.post(`${moduleDefinition.basePath}/queryById/${body.id}`);
+    return findFirstValueByKey(data, "batchId");
+}
+function updateNeedsBatchId(list) {
+    return list.some((item) => {
+        const fieldType = Number(item.fieldType);
+        return fieldType === 0 || fieldType === 2;
+    });
+}
+function findFirstValueByKey(input, key) {
+    const seen = new Set();
+    const visit = (value) => {
+        if (!value || typeof value !== "object" || seen.has(value)) {
+            return undefined;
+        }
+        seen.add(value);
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                const found = visit(item);
+                if (found !== undefined && found !== null && found !== "") {
+                    return found;
+                }
+            }
+            return undefined;
+        }
+        const record = value;
+        if (record[key] !== undefined && record[key] !== null && record[key] !== "") {
+            return record[key];
+        }
+        for (const child of Object.values(record)) {
+            const found = visit(child);
+            if (found !== undefined && found !== null && found !== "") {
+                return found;
+            }
+        }
+        return undefined;
+    };
+    return visit(input);
+}
+function findFieldDefinition(item, fields) {
+    const fieldId = item.fieldId !== undefined ? String(item.fieldId) : undefined;
+    const fieldName = normalizeText(item.fieldName);
+    const name = normalizeText(item.name);
+    return fields.find((field) => {
+        if (fieldId && String(field.fieldId ?? field.id) === fieldId) {
+            return true;
+        }
+        if (fieldName && normalizeText(field.fieldName) === fieldName) {
+            return true;
+        }
+        return Boolean(name && normalizeText(field.name) === name);
+    });
+}
+function normalizeOptionValue(value, field) {
+    const options = parseFieldOptions(field.options ?? field.setting ?? field.optionsData);
+    if (options.length === 0 || value === undefined || value === null || value === "") {
+        return value;
+    }
+    const valueText = normalizeText(value);
+    const match = options.find((option) => [option.value, option.name, option.label].some((candidate) => normalizeText(candidate) === valueText));
+    if (!match) {
+        const available = options.map((option) => option.name ?? option.label ?? option.value).filter((option) => option !== undefined);
+        throw new Error(`字段“${field.name ?? field.fieldName}”的可选值不包含“${value}”。可选值：${available.join("、")}`);
+    }
+    return value;
+}
+function parseFieldOptions(input) {
+    if (!input) {
+        return [];
+    }
+    if (Array.isArray(input)) {
+        return input.map((option) => (typeof option === "object" && option ? option : { value: option, name: option }));
+    }
+    if (typeof input === "string") {
+        const text = input.trim();
+        if (!text) {
+            return [];
+        }
+        try {
+            return parseFieldOptions(JSON.parse(text));
+        }
+        catch {
+            return text.split(",").map((option) => option.trim()).filter(Boolean).map((option) => ({ value: option, name: option }));
+        }
+    }
+    if (typeof input === "object") {
+        const object = input;
+        return parseFieldOptions(object.options ?? object.list ?? object.data ?? []);
+    }
+    return [];
+}
+async function verifyInformationUpdate(client, moduleDefinition, body) {
+    const endpoint = `${moduleDefinition.basePath}/information/${body.id}`;
+    const data = await client.post(endpoint);
+    const checked = (body.list ?? []).map((item) => {
+        const actualValue = findInformationValue(data, item);
+        return {
+            fieldName: item.fieldName,
+            name: item.name,
+            expectedValue: item.value,
+            actualValue,
+            matched: valuesMatch(item.value, actualValue)
+        };
+    });
+    return {
+        endpoint,
+        ok: checked.every((item) => item.matched),
+        checked
+    };
+}
+function findInformationValue(data, field) {
+    const direct = findDirectInformationValue(data, field);
+    if (direct.found) {
+        return direct.value;
+    }
+    const seen = new Set();
+    const wantedFieldName = normalizeText(field.fieldName);
+    const wantedName = normalizeText(field.name);
+    const visit = (value) => {
+        if (!value || typeof value !== "object" || seen.has(value)) {
+            return { found: false };
+        }
+        seen.add(value);
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                const result = visit(item);
+                if (result.found) {
+                    return result;
+                }
+            }
+            return { found: false };
+        }
+        const record = value;
+        const recordFieldName = normalizeText(record.fieldName);
+        const recordName = normalizeText(record.name);
+        if ((wantedFieldName && recordFieldName === wantedFieldName) || (wantedName && recordName === wantedName)) {
+            return { found: true, value: extractInformationValue(record) };
+        }
+        for (const child of Object.values(record)) {
+            const result = visit(child);
+            if (result.found) {
+                return result;
+            }
+        }
+        return { found: false };
+    };
+    return visit(data).value;
+}
+function findDirectInformationValue(data, field) {
+    if (!data || typeof data !== "object" || Array.isArray(data)) {
+        return { found: false };
+    }
+    const record = data;
+    if (field.fieldName && Object.prototype.hasOwnProperty.call(record, field.fieldName)) {
+        return { found: true, value: record[field.fieldName] };
+    }
+    return { found: false };
+}
+function extractInformationValue(record) {
+    if (Object.prototype.hasOwnProperty.call(record, "value")) {
+        return record.value;
+    }
+    if (Object.prototype.hasOwnProperty.call(record, "valueDesc")) {
+        return record.valueDesc;
+    }
+    if (Object.prototype.hasOwnProperty.call(record, "fieldValue")) {
+        return record.fieldValue;
+    }
+    return undefined;
+}
+function valuesMatch(expected, actual) {
+    return normalizeComparableValue(expected) === normalizeComparableValue(actual);
+}
+function normalizeComparableValue(value) {
+    if (value === undefined || value === null) {
+        return "";
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value).trim();
+}
+function normalizeText(value) {
+    return value === undefined || value === null ? "" : String(value).trim().toLowerCase();
+}
+async function listCustomerPools(client, args) {
+    const pools = await client.post("/crmCustomerPool/queryPoolNameListByAuth");
+    const poolList = Array.isArray(pools) ? pools : [];
+    const includeSamples = Boolean(args.includeSamples);
+    const limit = includeSamples ? positiveInteger(args.sampleLimit ?? args.limit, 3) : 1;
+    const searchList = args.filters ?? args.searchList ?? [];
+    const poolSummaries = await Promise.all(poolList.map(async (pool) => {
+        const poolId = pool.poolId ?? pool.id;
+        if (!poolId) {
+            throw new Error("客户公海授权列表缺少 poolId，无法统计池内客户数量。");
+        }
+        const page = await client.post("/crmCustomerPool/queryPageList", cleanObject({
+            page: 1,
+            limit,
+            pageType: 1,
+            label: 9,
+            poolId,
+            searchList
+        }));
+        const summary = {
+            poolId,
+            poolName: pool.poolName ?? pool.name,
+            customerCount: page.totalRow ?? page.total ?? 0
+        };
+        if (includeSamples) {
+            const list = Array.isArray(page.list) ? page.list : [];
+            summary.samples = list.map((record) => ({
+                customerId: record.customerId ?? record.id,
+                customerName: record.customerName ?? record.name,
+                ownerUserName: record.ownerUserName,
+                createTime: record.createTime
+            }));
+        }
+        return summary;
+    }));
+    return {
+        module: "customerPool",
+        readonly: true,
+        poolCount: poolSummaries.length,
+        pools: poolSummaries
+    };
+}
+function positiveInteger(value, fallback) {
+    const numberValue = Number(value);
+    if (!Number.isInteger(numberValue) || numberValue < 1) {
+        return fallback;
+    }
+    return numberValue;
+}
+function isPoolModule(moduleDefinition) {
+    return moduleDefinition.key === "customerPool" || moduleDefinition.key === "leadsPool";
+}
+function getPoolRecordModule(moduleDefinition) {
+    return getModuleByKey(moduleDefinition.key === "customerPool" ? "customer" : "leads");
+}
+async function resolvePoolContext(client, moduleDefinition, args) {
+    if (!isPoolModule(moduleDefinition)) {
+        throw new Error(`Module ${moduleDefinition.key} is not a pool module.`);
+    }
+    if (args.poolId) {
+        return { poolId: args.poolId, pool: cleanObject({ poolId: args.poolId, poolName: args.poolName }) };
+    }
+    const pools = await client.post(`${moduleDefinition.basePath}/queryPoolNameListByAuth`);
+    const poolList = Array.isArray(pools) ? pools : [];
+    const selectedPool = args.poolName
+        ? poolList.find((pool) => String(pool.poolName ?? pool.name ?? "").trim() === String(args.poolName).trim())
+        : poolList[0];
+    if (!selectedPool) {
+        throw new Error(`当前账号没有可查询的${moduleDefinition.name}，请确认公海/线索池权限或传入 poolId。`);
+    }
+    const poolId = selectedPool.poolId ?? selectedPool.id;
+    if (!poolId) {
+        throw new Error(`${moduleDefinition.name}授权列表缺少 poolId，无法查询池内数据。`);
+    }
+    return { poolId, pool: selectedPool };
+}
+async function callRelatedRecords(client, moduleDefinition, args) {
+    const relation = String(args.relation ?? args.type ?? "").trim();
+    const pageBody = cleanObject({ page: args.page ?? 1, limit: args.limit ?? 15, pageType: 1, id: args.id, ...safeExtra(args.extra) });
+    if (moduleDefinition.key === "business" && relation === "product") {
+        return { module: moduleDefinition.key, relation, data: await client.post("/crmBusiness/queryProduct", pageBody) };
+    }
+    if (moduleDefinition.key === "business" && relation === "contacts") {
+        return { module: moduleDefinition.key, relation, data: await client.post("/crmBusiness/queryContacts", pageBody) };
+    }
+    if (moduleDefinition.key === "contacts" && relation === "business") {
+        return { module: moduleDefinition.key, relation, data: await client.post("/crmContacts/queryBusiness", pageBody) };
+    }
+    if (moduleDefinition.key === "contract" && relation === "product") {
+        return { module: moduleDefinition.key, relation, data: await client.post("/crmContract/queryProductListByContractId", pageBody) };
+    }
+    if (moduleDefinition.key === "contract" && relation === "receivablesPlan") {
+        return {
+            module: moduleDefinition.key,
+            relation,
+            data: await client.post("/crmContract/queryReceivablesPlansByContractId", undefined, {
+                contractId: args.id,
+                receivablesId: args.receivablesId,
+                productId: args.productId
+            })
+        };
     }
-    return [];
+    if (moduleDefinition.key === "receivables" && relation === "product") {
+        return { module: moduleDefinition.key, relation, data: await client.post(`/crmReceivables/queryProductList/${args.id}`) };
+    }
+    if (moduleDefinition.key === "quotation" && relation === "product") {
+        return { module: moduleDefinition.key, relation, data: await client.post("/crmQuotation/queryProductList", pageBody) };
+    }
+    if (moduleDefinition.key === "product" && relation === "saleProduct") {
+        return { module: moduleDefinition.key, relation, data: await client.post("/crmProduct/querySaleProductPageList", pageBody) };
+    }
+    if (moduleDefinition.key === "receivablesPlan" && relation === "contractCustomer") {
+        return { module: moduleDefinition.key, relation, data: await client.post("/crmReceivablesPlan/queryByContractAndCustomer", pageBody) };
+    }
+    throw new Error(`当前 MCP 未配置“${moduleDefinition.name} / ${relation}”关联查询白名单。`);
 }
-function containsFilters(fields, value, startGroupId) {
-    return fields.map((field, index) => ({
-        fieldName: field.fieldName,
-        formType: field.formType,
-        type: FIELD_SEARCH_CONTAINS,
-        searchEnum: FIELD_SEARCH_CONTAINS,
-        values: [value],
-        groupId: fields.length > 1 ? startGroupId + index : startGroupId
-    }));
+function buildHrmEmployeeListBody(args) {
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: args.pageType ?? 1,
+        employeeName: firstTextValue(args.employeeName, args.name, args.keyword, args.query, args.q, args.search),
+        mobile: args.mobile ?? args.phone,
+        sex: args.sex,
+        entryTime: args.entryTime,
+        jobNumber: args.jobNumber,
+        deptId: args.deptId,
+        post: args.post,
+        becomeTime: args.becomeTime,
+        workAddress: args.workAddress,
+        employmentForms: args.employmentForms,
+        status: args.status,
+        employeeSurvey: args.employeeSurvey,
+        toDoRemind: args.toDoRemind,
+        employeeIds: args.employeeIds,
+        sortField: args.sortField,
+        order: args.order
+    });
 }
-function firstTextValue(...values) {
-    for (const value of values) {
-        if (value === undefined || value === null) {
-            continue;
+function buildHrmDepartmentListBody(args) {
+    return cleanObject({
+        name: firstTextValue(args.name, args.deptName, args.keyword, args.query, args.q, args.search),
+        type: args.type ?? "tree",
+        id: args.id ?? args.parentId
+    });
+}
+function buildHrmDepartmentEmployeesBody(args) {
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: args.pageType ?? 1,
+        deptId: requireHrmDeptId(args),
+        search: firstTextValue(args.search, args.keyword, args.query, args.q, args.name, args.employeeName)
+    });
+}
+function buildHrmAttendanceMonthRecordBody(args) {
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: args.pageType ?? 1,
+        search: firstTextValue(args.search, args.keyword, args.query, args.q, args.employeeName, args.name),
+        deptIds: args.deptIds ?? args.deptId,
+        times: args.times ?? args.timeRange,
+        sortField: args.sortField,
+        order: args.order,
+        isFullAttendance: args.isFullAttendance,
+        employeeId: args.employeeId ?? args.id,
+        isResignation: args.isResignation
+    });
+}
+function buildHrmAttendanceDailyDetailBody(args) {
+    return cleanObject({
+        employeeId: requireHrmEmployeeId(args),
+        currentDate: args.currentDate ?? args.date ?? args.day,
+        hrmAttendanceGroup: args.hrmAttendanceGroup,
+        multi: args.multi,
+        companyId: args.companyId
+    });
+}
+function buildHrmLeaveRecordBody(args) {
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: args.pageType ?? 1,
+        search: firstTextValue(args.search, args.keyword, args.query, args.q, args.employeeName, args.name),
+        employeeId: args.employeeId ?? args.id,
+        times: args.times ?? args.timeRange,
+        deptIds: args.deptIds ?? args.deptId,
+        leaveTypes: args.leaveTypes ?? args.leaveType,
+        sortField: args.sortField,
+        order: args.order
+    });
+}
+function requireHrmEmployeeId(args) {
+    const employeeId = args.employeeId ?? args.id;
+    if (isBlank(employeeId)) {
+        throw new Error("请提供 employeeId 或 id。");
+    }
+    return employeeId;
+}
+function requireHrmDeptId(args) {
+    const deptId = args.deptId ?? args.id;
+    if (isBlank(deptId)) {
+        throw new Error("请提供 deptId 或 id。");
+    }
+    return deptId;
+}
+function getFinanceEndpointByKey(input, definitions, label) {
+    const value = String(input ?? "").trim().toLowerCase();
+    const definition = definitions.find((item) => item.aliases.some((alias) => alias.toLowerCase() === value));
+    if (!definition) {
+        throw new Error(`当前 MCP 仅支持这些${label}只读查询：${definitions.map((item) => item.key).join("、")}。`);
+    }
+    return definition;
+}
+function buildFinanceSearchBody(args, defaults = {}, omitKeys = []) {
+    const body = buildFinanceBody(args, ["keyword", "query", "q", ...omitKeys], defaults);
+    const search = firstTextValue(args.search, args.keyword, args.query, args.q);
+    if (search) {
+        body.search = search;
+    }
+    return cleanObject(body);
+}
+function buildFinanceBody(args, omitKeys = [], defaults = {}) {
+    const omit = new Set(omitKeys);
+    const body = { ...defaults };
+    for (const [key, value] of Object.entries(args ?? {})) {
+        if (!omit.has(key) && value !== undefined && value !== null) {
+            body[key] = value;
+        }
+    }
+    return cleanObject(body);
+}
+function requireFinanceCertificateId(args) {
+    const certificateId = args.certificateId ?? args.id;
+    if (isBlank(certificateId)) {
+        throw new Error("查询财务凭证详情请提供 certificateId 或 id。");
+    }
+    return certificateId;
+}
+function getJxcModuleByKey(input) {
+    const value = String(input ?? "").trim();
+    const moduleDefinition = JXC_MODULES.find((module) => module.aliases.some((alias) => String(alias) === value));
+    if (!moduleDefinition) {
+        throw new Error(`当前 MCP 仅内置这些 JXC 主数据模块：${JXC_MODULES.map((module) => module.key).join("、")}。其他 JXC 接口请使用 crm_write_jxc 指定固定路径。`);
+    }
+    return moduleDefinition;
+}
+function buildJxcSearchBody(args, moduleDefinition) {
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: args.pageType ?? 1,
+        label: moduleDefinition.label,
+        search: firstTextValue(args.search, args.keyword, args.query, args.q, args.name),
+        sceneId: args.sceneId,
+        sortField: args.sortField,
+        order: args.order,
+        searchList: args.searchList ?? args.filters,
+        ids: args.ids,
+        sortIds: args.sortIds,
+        mainFieldValues: args.mainFieldValues,
+        extraMap: args.extraMap,
+        validFieldAuth: args.validFieldAuth,
+        warehouseId: moduleDefinition.key === "product" ? args.warehouseId : undefined,
+        isRelateProductSearch: moduleDefinition.key === "product" ? args.isRelateProductSearch : undefined
+    });
+}
+function buildJxcStockProductsBody(args) {
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: args.pageType ?? 1,
+        label: 34,
+        search: firstTextValue(args.search, args.keyword, args.query, args.q, args.productName, args.name),
+        searchList: args.searchList ?? args.filters,
+        productName: args.productName,
+        productTypeId: args.productTypeId,
+        productCode: args.productCode,
+        warehouseId: args.warehouseId,
+        isWarehouseGroup: args.isWarehouseGroup,
+        stock: args.stock,
+        sortField: args.sortField,
+        order: args.order
+    });
+}
+function buildJxcStockMovementsBody(args) {
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: args.pageType ?? 1,
+        label: 35,
+        search: firstTextValue(args.search, args.keyword, args.query, args.q, args.productName, args.name),
+        sceneId: args.sceneId,
+        sortField: args.sortField,
+        order: args.order,
+        searchList: args.searchList ?? args.filters,
+        ids: args.ids,
+        sortIds: args.sortIds,
+        mainFieldValues: args.mainFieldValues,
+        extraMap: args.extraMap
+    });
+}
+function requireJxcId(args, message) {
+    const id = args.id ?? args.recordId ?? args[args.module ? `${String(args.module)}Id` : "id"];
+    if (isBlank(id)) {
+        throw new Error(message);
+    }
+    return id;
+}
+function requireJxcProductId(args) {
+    const productId = args.productId ?? args.id;
+    if (isBlank(productId)) {
+        throw new Error("查询 JXC 产品库存请提供 productId 或 id。");
+    }
+    return productId;
+}
+function requireWarehouseProductIdsMap(args) {
+    const value = args.warehouseProductIdsMap ?? args.map ?? args.data;
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("查询仓库产品库存数量请提供 warehouseProductIdsMap，例如 { \"8\": [100] }。");
+    }
+    return value;
+}
+function requireWarehouseIds(args) {
+    const value = args.warehouseIds ?? args.ids;
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new Error("查询仓库名称请提供 warehouseIds 数组。");
+    }
+    return value;
+}
+async function executeDomainWrite(client, domain, args) {
+    const targetPath = normalizeDomainTargetPath(domain, args);
+    const body = explicitWriteBody(args);
+    const query = cleanQuery(args.query ?? {});
+    if (!args.confirm) {
+        return previewDomainWrite(domain, targetPath, body, query);
+    }
+    return cleanObject({
+        domain: domain.key,
+        moduleName: domain.name,
+        targetPath,
+        body,
+        query: Object.keys(query).length > 0 ? query : undefined,
+        data: await client.post(targetPath, body, query)
+    });
+}
+function previewDomainWrite(domain, targetPath, body, query) {
+    return cleanObject({
+        preview: true,
+        message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+        domain: domain.key,
+        moduleName: domain.name,
+        targetPath,
+        body,
+        query: query && Object.keys(query).length > 0 ? query : undefined
+    });
+}
+function normalizeDomainTargetPath(domain, args) {
+    const explicitPath = args.targetPath ?? args.path ?? args.endpoint;
+    const targetPath = explicitPath
+        ? normalizeEndpointPath(explicitPath)
+        : buildDomainTargetPath(args.module ?? args.controller ?? args.basePath, args.operation ?? args.action);
+    if (!domain.allowedPrefixes.some((prefix) => targetPath.startsWith(prefix))) {
+        throw new Error(`${domain.name} 写入工具只能调用 ${domain.allowedPrefixes.join("、")} 开头的 72CRM 固定接口。`);
+    }
+    return targetPath;
+}
+function buildDomainTargetPath(moduleName, operation) {
+    const moduleSegment = normalizePathSegment(moduleName, "module");
+    const operationSegment = normalizePathSegment(operation, "operation");
+    return normalizeEndpointPath(`/${moduleSegment}/${operationSegment}`);
+}
+function normalizeEndpointPath(input) {
+    const raw = String(input ?? "").trim();
+    if (!raw) {
+        throw new Error("请提供 targetPath，或提供 module + operation 组合。");
+    }
+    if (raw.includes("://") || raw.startsWith("//") || raw.includes("..") || raw.includes("?") || raw.includes("#")) {
+        throw new Error("targetPath 只能是 72CRM 固定接口路径，不允许 URL、上级目录或查询串。");
+    }
+    return raw.startsWith("/") ? raw : `/${raw}`;
+}
+function normalizePathSegment(input, name) {
+    const value = String(input ?? "").trim().replace(/^\/+|\/+$/g, "");
+    if (!value || value.includes("://") || value.includes("..") || value.includes("?") || value.includes("#")) {
+        throw new Error(`请提供合法的 ${name}。`);
+    }
+    return value;
+}
+const DOMAIN_WRITE_CONTROL_KEYS = new Set([
+    "targetPath",
+    "path",
+    "endpoint",
+    "module",
+    "controller",
+    "basePath",
+    "operation",
+    "action",
+    "body",
+    "data",
+    "query",
+    "confirm"
+]);
+function explicitWriteBody(args) {
+    if (Object.prototype.hasOwnProperty.call(args, "body")) {
+        return args.body;
+    }
+    if (Object.prototype.hasOwnProperty.call(args, "data")) {
+        return args.data;
+    }
+    const body = {};
+    for (const [key, value] of Object.entries(args ?? {})) {
+        if (!DOMAIN_WRITE_CONTROL_KEYS.has(key) && value !== undefined && value !== null) {
+            body[key] = value;
+        }
+    }
+    return Object.keys(body).length > 0 ? body : undefined;
+}
+function buildJxcRecordSaveBody(args, moduleDefinition, requireId) {
+    const explicitPayload = Object.prototype.hasOwnProperty.call(args, "body")
+        ? args.body
+        : Object.prototype.hasOwnProperty.call(args, "data")
+            ? args.data
+            : undefined;
+    const body = explicitPayload && typeof explicitPayload === "object" && !Array.isArray(explicitPayload)
+        ? { ...explicitPayload }
+        : buildModelSaveBody(args);
+    if (!body.entity || typeof body.entity !== "object" || Array.isArray(body.entity)) {
+        body.entity = {};
+    }
+    else {
+        body.entity = { ...body.entity };
+    }
+    if (requireId) {
+        const id = args.id ?? args.recordId ?? args[moduleDefinition.primaryKey] ?? body.entity[moduleDefinition.primaryKey];
+        if (isBlank(id)) {
+            throw new Error(`修改 JXC ${moduleDefinition.name}请提供 id 或 ${moduleDefinition.primaryKey}。`);
+        }
+        if (isBlank(body.entity[moduleDefinition.primaryKey])) {
+            body.entity[moduleDefinition.primaryKey] = id;
+        }
+    }
+    return cleanObject(body);
+}
+function buildJxcUpdateInformationBody(args, moduleDefinition) {
+    const id = args.id ?? args.recordId ?? args[moduleDefinition.primaryKey];
+    if (isBlank(id)) {
+        throw new Error(`修改 JXC ${moduleDefinition.name}字段请提供 id 或 ${moduleDefinition.primaryKey}。`);
+    }
+    return cleanObject({
+        id,
+        label: moduleDefinition.label,
+        list: rawUpdateList(args),
+        batchId: args.batchId
+    });
+}
+function buildFinanceVoucherWriteBody(args, requireId) {
+    const explicitBody = explicitWriteBody(args);
+    const body = explicitBody && typeof explicitBody === "object" && !Array.isArray(explicitBody)
+        ? { ...explicitBody }
+        : {};
+    const certificateId = args.certificateId ?? args.id ?? body.certificateId;
+    if (requireId && isBlank(certificateId)) {
+        throw new Error("修改财务凭证请提供 certificateId 或 id。");
+    }
+    if (requireId && isBlank(body.certificateId)) {
+        body.certificateId = certificateId;
+    }
+    return cleanObject(body);
+}
+async function buildCrmProductSearchBody(client, args, saleOnly) {
+    const moduleDefinition = getModuleByKey("product");
+    let searchList = await buildResolvedSearchList(client, args, moduleDefinition);
+    const categoryId = args.categoryId ?? args.productCategoryId;
+    if (!isBlank(categoryId) && !searchList.some((item) => item.fieldName === "categoryId")) {
+        searchList = combineSearchLists(searchList, [{
+                type: 1,
+                values: [categoryId],
+                formType: "category",
+                fieldName: "categoryId"
+            }]);
+    }
+    return cleanObject({
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        pageType: saleOnly ? 0 : args.pageType ?? 1,
+        label: moduleDefinition.label,
+        status: saleOnly ? undefined : args.status,
+        sortIds: args.sortIds,
+        searchList: searchList.length > 0 ? searchList : undefined
+    });
+}
+async function executeCrmProductSave(client, args, requireId) {
+    const targetPath = requireId ? "/crmProduct/update" : "/crmProduct/add";
+    const body = buildCrmProductSaveBody(args, requireId);
+    if (!args.confirm) {
+        return {
+            preview: true,
+            message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+            module: "product",
+            moduleName: "产品",
+            operation: requireId ? "update" : "add",
+            targetPath,
+            body
+        };
+    }
+    return {
+        module: "product",
+        moduleName: "产品",
+        targetPath,
+        body,
+        data: await client.post(targetPath, body)
+    };
+}
+function buildCrmProductSaveBody(args, requireId) {
+    const explicitPayload = hasExplicitBody(args) ? objectWriteBody(args) : buildModelSaveBody(args);
+    const body = explicitPayload && typeof explicitPayload === "object" && !Array.isArray(explicitPayload)
+        ? { ...explicitPayload }
+        : {};
+    if (!isPlainObject(body.entity)) {
+        body.entity = {};
+    }
+    else {
+        body.entity = { ...body.entity };
+    }
+    const productId = args.productId ?? args.id ?? body.entity.productId;
+    if (requireId && isBlank(productId)) {
+        throw new Error("编辑 CRM 产品请提供 productId 或 id。");
+    }
+    if (!isBlank(productId) && isBlank(body.entity.productId)) {
+        body.entity.productId = productId;
+    }
+    if (!Array.isArray(body.field)) {
+        body.field = [];
+    }
+    return cleanObject(body);
+}
+async function executeCrmProductSimpleWrite(client, args, operation, targetPath, body) {
+    if (!args.confirm) {
+        return {
+            preview: true,
+            message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+            module: "product",
+            moduleName: "产品",
+            operation,
+            targetPath,
+            body
+        };
+    }
+    return {
+        module: "product",
+        moduleName: "产品",
+        targetPath,
+        body,
+        data: await client.post(targetPath, body)
+    };
+}
+function buildCrmProductStatusBody(args) {
+    if (hasExplicitBody(args)) {
+        return objectWriteBody(args);
+    }
+    if (isBlank(args.status)) {
+        throw new Error("修改 CRM 产品上下架状态请提供 status。");
+    }
+    return {
+        ids: requireIdArray(args.ids ?? args.productIds, "修改 CRM 产品状态请提供 ids 或 productIds 数组。"),
+        status: args.status
+    };
+}
+function buildCrmProductTransferBody(args) {
+    if (hasExplicitBody(args)) {
+        return objectWriteBody(args);
+    }
+    const ownerUserId = args.ownerUserId ?? args.userId;
+    if (isBlank(ownerUserId)) {
+        throw new Error("转移 CRM 产品负责人请提供 ownerUserId。");
+    }
+    return cleanObject({
+        ids: requireIdArray(args.ids ?? args.productIds, "转移 CRM 产品负责人请提供 ids 或 productIds 数组。"),
+        ownerUserId,
+        transferType: args.transferType,
+        power: args.power,
+        changeType: args.changeType,
+        expiresTime: args.expiresTime
+    });
+}
+function requireCrmProductId(args, message) {
+    const productId = args.productId ?? args.id;
+    if (isBlank(productId)) {
+        throw new Error(message);
+    }
+    return productId;
+}
+function requireIdArray(value, message) {
+    const ids = Array.isArray(value) ? value : isBlank(value) ? [] : [value];
+    if (ids.length === 0) {
+        throw new Error(message);
+    }
+    return ids;
+}
+function buildOaAnnouncementListQuery(args) {
+    return buildPassthroughBody(args, ["keyword", "query", "q", "search"], {
+        page: args.page ?? 1,
+        limit: args.limit ?? 15,
+        type: args.type
+    });
+}
+async function executeOaAnnouncementWrite(client, args, requireId) {
+    const targetPath = requireId ? "/oaAnnouncement/setAnnouncement" : "/oaAnnouncement/addAnnouncement";
+    const body = buildOaAnnouncementBody(args, requireId);
+    if (!args.confirm) {
+        return previewOaWrite(requireId ? "update" : "create", "oaAnnouncement", "公告", targetPath, body);
+    }
+    return {
+        module: "oaAnnouncement",
+        moduleName: "公告",
+        targetPath,
+        body,
+        data: await client.post(targetPath, body)
+    };
+}
+function buildOaAnnouncementBody(args, requireId) {
+    const body = hasExplicitBody(args) ? objectWriteBody(args) : buildPassthroughBody(args, ["id"]);
+    const announcementId = args.announcementId ?? args.id ?? body.announcementId;
+    if (requireId && isBlank(announcementId)) {
+        throw new Error("编辑 OA 公告请提供 announcementId 或 id。");
+    }
+    if (!isBlank(announcementId) && isBlank(body.announcementId)) {
+        body.announcementId = announcementId;
+    }
+    for (const key of ["deptIds", "ownerUserIds", "readUserIds"]) {
+        if (body[key] !== undefined) {
+            body[key] = toCommaSeparated(body[key]);
+        }
+    }
+    return cleanObject(body);
+}
+function buildOaAnnouncementReadBody(args) {
+    const body = hasExplicitBody(args) ? objectWriteBody(args) : {};
+    const announcementId = args.announcementId ?? args.id ?? body.announcementId;
+    if (isBlank(announcementId)) {
+        throw new Error("标记 OA 公告已读请提供 announcementId 或 id。");
+    }
+    if (isBlank(body.announcementId)) {
+        body.announcementId = announcementId;
+    }
+    return cleanObject(body);
+}
+function requireOaAnnouncementId(args, message) {
+    const announcementId = args.announcementId ?? args.id;
+    if (isBlank(announcementId)) {
+        throw new Error(message);
+    }
+    return announcementId;
+}
+function buildOaLogListBody(args) {
+    const body = buildPassthroughBody(args, ["keyword", "query", "q"], {
+        page: args.page ?? 1,
+        limit: args.limit ?? 15
+    });
+    const search = firstTextValue(args.search, args.keyword, args.query, args.q, args.title, args.content);
+    if (search && body.search === undefined) {
+        body.search = search;
+    }
+    return cleanObject(body);
+}
+function buildOaLogTemplateListBody(args) {
+    const body = buildPassthroughBody(args, ["keyword", "query", "q"], {
+        page: args.page ?? 1,
+        limit: args.limit ?? 15
+    });
+    const search = firstTextValue(args.search, args.keyword, args.query, args.q, args.name);
+    if (search && body.search === undefined) {
+        body.search = search;
+    }
+    return cleanObject(body);
+}
+function buildOaLogFieldQuery(args) {
+    return cleanQuery({
+        configId: requireOaLogConfigId(args),
+        type: args.type
+    });
+}
+async function executeOaLogWrite(client, args, requireId) {
+    const targetPath = "/oaLog/addOrUpdate";
+    const body = await buildOaLogWriteBody(client, args, requireId);
+    if (!args.confirm) {
+        return previewOaWrite(requireId ? "update" : "create", "oaLog", "日志", targetPath, body);
+    }
+    return {
+        module: "oaLog",
+        moduleName: "日志",
+        targetPath,
+        body,
+        data: await client.post(targetPath, body)
+    };
+}
+async function buildOaLogWriteBody(client, args, requireId) {
+    if (hasExplicitBody(args)) {
+        return finalizeOaLogWriteBody(objectWriteBody(args), args, requireId);
+    }
+    const body = buildOaLogBaseBody(args);
+    const fieldValuesInput = args.fieldValues ?? args.updates ?? args.fields ?? args.fieldForm;
+    const shouldBuildFields = !Array.isArray(args.field)
+        && !Array.isArray(args.fields)
+        && !isBlank(args.categoryId)
+        && fieldValuesInput
+        && typeof fieldValuesInput === "object";
+    if (shouldBuildFields) {
+        const logId = args.logId ?? args.id;
+        const targetPath = logId ? `/oaLogTemplateField/field/${logId}` : "/oaLogTemplateField/field";
+        const fieldMetadata = await client.post(targetPath, undefined, buildOaLogFieldQuery(args));
+        const fields = flattenOaExamineFields(fieldMetadata);
+        const fieldValues = normalizeFieldValues(fieldValuesInput);
+        for (const [rawKey, rawValue] of Object.entries(fieldValues)) {
+            const field = findOaExamineField(fields, rawKey);
+            if (!field) {
+                throw new Error(`OA 日志模板 ${args.categoryId} 未找到字段“${rawKey}”，请先用 crm_get_oa_log_fields 查询字段名。`);
+            }
+            appendOaLogFieldValue(body, field, rawValue);
+        }
+    }
+    else if (Array.isArray(args.field)) {
+        body.field = args.field;
+    }
+    else if (Array.isArray(args.fields)) {
+        body.field = args.fields;
+    }
+    return finalizeOaLogWriteBody(body, args, requireId);
+}
+function buildOaLogBaseBody(args) {
+    const body = buildPassthroughBody(args, [
+        "id",
+        "fields",
+        "fieldValues",
+        "updates",
+        "fieldForm",
+        "type"
+    ]);
+    for (const key of ["sendUserIds", "sendDeptIds", "readUserIds", "customerIds", "contactsIds", "businessIds", "contractIds", "receivablesIds", "quotationIds"]) {
+        if (body[key] !== undefined) {
+            body[key] = toCommaSeparated(body[key]);
+        }
+    }
+    if (!Array.isArray(body.field)) {
+        body.field = [];
+    }
+    return cleanObject(body);
+}
+function appendOaLogFieldValue(body, field, rawValue) {
+    const value = getOaExamineRealValue(field, rawValue);
+    if (Number(field.fieldType) === 1) {
+        body[field.fieldName] = isEmptyValue(value) ? "" : value;
+        return;
+    }
+    if (field.formType !== "desc_text") {
+        body.field.push({
+            fieldName: field.fieldName,
+            fieldType: field.fieldType,
+            name: field.name,
+            type: field.type,
+            fieldId: field.fieldId,
+            value
+        });
+    }
+}
+function finalizeOaLogWriteBody(body, args, requireId) {
+    const logId = args.logId ?? args.id ?? body.logId;
+    if (requireId && isBlank(logId)) {
+        throw new Error("编辑 OA 日志请提供 logId 或 id。");
+    }
+    if (!isBlank(logId) && isBlank(body.logId)) {
+        body.logId = logId;
+    }
+    if (!Array.isArray(body.field)) {
+        body.field = [];
+    }
+    return cleanObject(body);
+}
+function requireOaLogId(args, message) {
+    const logId = args.logId ?? args.id;
+    if (isBlank(logId)) {
+        throw new Error(message);
+    }
+    return logId;
+}
+function requireOaLogConfigId(args) {
+    const configId = args.configId ?? args.categoryId;
+    if (isBlank(configId)) {
+        throw new Error("查询 OA 日志模板字段或完成统计请提供 configId 或 categoryId。");
+    }
+    return configId;
+}
+function buildOaLogFavourQuery(args) {
+    return {
+        logId: requireOaLogId(args, "点赞或取消点赞 OA 日志请提供 logId 或 id。"),
+        isFavour: args.isFavour ?? args.favour ?? args.favorite ?? true
+    };
+}
+async function executeCrmDocumentWrite(client, moduleKey, args, requireId) {
+    const definition = getCrmDocumentWriteDefinition(moduleKey);
+    const operation = requireId ? "update" : "add";
+    const targetPath = `${definition.basePath}/${operation}`;
+    const body = await buildCrmDocumentWriteBody(client, definition, args, requireId);
+    const approvalNotice = getCrmDocumentApprovalNotice(definition, body);
+    if (!args.confirm) {
+        return previewCrmDocumentWrite(definition, operation, targetPath, body, approvalNotice);
+    }
+    return cleanObject({
+        module: definition.key,
+        moduleName: definition.name,
+        targetPath,
+        body,
+        approvalNotice,
+        data: await client.post(targetPath, body)
+    });
+}
+function getCrmDocumentWriteDefinition(moduleKey) {
+    const definition = CRM_DOCUMENT_WRITE_DEFINITIONS.find((item) => item.key === moduleKey);
+    if (!definition) {
+        throw new Error(`当前 MCP 未配置 ${moduleKey} 单据写入。`);
+    }
+    return definition;
+}
+async function buildCrmDocumentWriteBody(client, definition, args, requireId) {
+    if (hasExplicitBody(args)) {
+        return finalizeCrmDocumentBody(definition, objectWriteBody(args), args, requireId);
+    }
+    if (hasRawCrmDocumentShape(args)) {
+        return finalizeCrmDocumentBody(definition, buildRawCrmDocumentBody(args), args, requireId);
+    }
+    return buildStructuredCrmDocumentBody(client, definition, args, requireId);
+}
+function hasExplicitBody(args) {
+    return Object.prototype.hasOwnProperty.call(args, "body") || Object.prototype.hasOwnProperty.call(args, "data");
+}
+function hasRawCrmDocumentShape(args) {
+    return isPlainObject(args.entity)
+        || Array.isArray(args.field)
+        || Array.isArray(args.fields)
+        || Array.isArray(args.product)
+        || isPlainObject(args.product)
+        || Array.isArray(args.contract);
+}
+function buildRawCrmDocumentBody(args) {
+    return cleanObject({
+        entity: isPlainObject(args.entity) ? { ...args.entity } : {},
+        field: Array.isArray(args.field) ? args.field : Array.isArray(args.fields) ? args.fields : [],
+        product: args.product,
+        contract: args.contract,
+        examineFlowData: args.examineFlowData,
+        ...safeExtra(args.extra)
+    });
+}
+async function buildStructuredCrmDocumentBody(client, definition, args, requireId) {
+    const fieldValues = normalizeFieldValues(args.fieldValues ?? args.updates ?? args.fields ?? args.fieldForm);
+    if (Object.keys(fieldValues).length === 0 && !isPlainObject(args.entity)) {
+        throw new Error(`请提供 ${definition.name} 的 body/data 原始 payload，或提供 entity/field，或提供 fields/updates 让 MCP 自动组装。`);
+    }
+    const recordId = args[definition.primaryKey] ?? args.id ?? args.recordId;
+    const fieldPath = requireId && !isBlank(recordId) ? `${definition.basePath}/field/${recordId}` : `${definition.basePath}/field`;
+    const fieldMetadata = await client.post(fieldPath, undefined, cleanQuery({ type: args.type }));
+    const fields = flattenOaExamineFields(fieldMetadata);
+    if (fields.length === 0 && Object.keys(fieldValues).length > 0) {
+        throw new Error(`未从 ${fieldPath} 读取到 ${definition.name} 字段，无法自动组装单据字段。`);
+    }
+    const params = {
+        entity: isPlainObject(args.entity) ? { ...args.entity } : {},
+        field: []
+    };
+    for (const [rawKey, rawValue] of Object.entries(fieldValues)) {
+        const field = findOaExamineField(fields, rawKey);
+        if (!field) {
+            throw new Error(`${definition.name} 未找到字段“${rawKey}”，请先用 crm_get_module_schema 查询字段名。`);
+        }
+        appendCrmDocumentFieldValue(params, field, rawValue);
+    }
+    if (args.product !== undefined && params.product === undefined) {
+        params.product = args.product;
+    }
+    if (args.contract !== undefined && params.contract === undefined) {
+        params.contract = args.contract;
+    }
+    if (args.examineFlowData !== undefined) {
+        params.examineFlowData = args.examineFlowData;
+    }
+    return finalizeCrmDocumentBody(definition, params, args, requireId);
+}
+function appendCrmDocumentFieldValue(params, field, rawValue) {
+    if (field.formType === "product" && !field.isModuleSelect) {
+        appendCrmProductParams(params, rawValue, Array.isArray(field.productFields) ? field.productFields : []);
+        return;
+    }
+    if (field.formType === "map_address") {
+        appendCrmAddressParams(params.entity, rawValue);
+        return;
+    }
+    const value = getOaExamineRealValue(field, rawValue);
+    if (Number(field.fieldType) === 1) {
+        params.entity[field.fieldName] = isEmptyValue(value) ? "" : value;
+        return;
+    }
+    if (field.formType !== "desc_text") {
+        params.field.push({
+            fieldName: field.fieldName,
+            fieldType: field.fieldType,
+            name: field.name,
+            type: field.type,
+            fieldId: field.fieldId,
+            value
+        });
+    }
+}
+function appendCrmProductParams(params, rawValue, productFields) {
+    if (!rawValue) {
+        params.product = [];
+        params.entity.totalPrice = "";
+        params.entity.discountRate = "";
+        return;
+    }
+    const productValue = isPlainObject(rawValue) ? rawValue : { product: rawValue };
+    const products = Array.isArray(productValue.product) ? productValue.product : Array.isArray(rawValue) ? rawValue : [];
+    params.product = products.map((item) => {
+        if (!isPlainObject(item)) {
+            return item;
+        }
+        const product = { ...item };
+        for (const [key, value] of Object.entries(product)) {
+            const field = productFields.find((productField) => productField.fieldName === key);
+            if (field && Number(field.fieldType) === 0) {
+                product[key] = getOaExamineRealValue(field, value);
+            }
         }
-        const text = String(value).trim();
-        if (text) {
-            return text;
+        if (Array.isArray(product.name) && product.name.length > 0 && isPlainObject(product.name[0])) {
+            product.name = product.name[0].name ?? "";
         }
+        product.salesPrice = product.salesPrice === "" || product.salesPrice === undefined ? 0 : product.salesPrice;
+        product.num = product.num === "" || product.num === undefined ? 0 : product.num;
+        product.discount = product.discount === "" || product.discount === undefined ? 0 : product.discount;
+        return product;
+    });
+    params.entity.totalPrice = productValue.totalPrice ?? 0;
+    params.entity.discountRate = productValue.discountRate ?? 0;
+}
+function appendCrmAddressParams(entity, rawValue) {
+    if (!isPlainObject(rawValue)) {
+        entity.address = "";
+        entity.detailAddress = "";
+        entity.location = "";
+        entity.lng = "";
+        entity.lat = "";
+        return;
     }
-    return undefined;
+    const value = rawValue;
+    entity.address = Array.isArray(value.address) ? value.address.join(",") : value.address ?? "";
+    entity.detailAddress = value.detailAddress;
+    entity.location = value.location;
+    entity.lng = value.lng;
+    entity.lat = value.lat;
 }
-function toArray(value) {
-    if (Array.isArray(value)) {
-        return value;
+function finalizeCrmDocumentBody(definition, body, args, requireId) {
+    if (!isPlainObject(body.entity)) {
+        body.entity = {};
     }
-    if (value && typeof value === "object") {
-        return [value];
+    else {
+        body.entity = { ...body.entity };
     }
-    return [];
-}
-async function resolveUniqueRecord(client, moduleDefinition, args) {
-    const searchList = buildSearchList(args, moduleDefinition);
-    if (searchList.length === 0) {
-        throw new Error(`请提供可定位${moduleDefinition.name}的 customerId/id、phone/mobile、name/customerName 或 keyword。`);
+    const recordId = args[definition.primaryKey] ?? args.id ?? args.recordId ?? body.entity[definition.primaryKey];
+    if (requireId && isBlank(recordId)) {
+        throw new Error(`编辑${definition.name}请提供 ${definition.primaryKey} 或 id。`);
     }
-    const page = await client.post(`${moduleDefinition.basePath}/queryPageList`, cleanObject({
-        page: 1,
-        limit: 2,
-        pageType: 1,
-        label: moduleDefinition.label,
-        searchList
-    }));
-    const list = Array.isArray(page.list) ? page.list : [];
-    if (list.length !== 1) {
-        throw new Error(`需要唯一命中的${moduleDefinition.name}才能写入，当前命中 ${page.totalRow ?? list.length} 条，请先缩小查询条件或直接传入 ID。`);
+    if (!isBlank(recordId) && isBlank(body.entity[definition.primaryKey])) {
+        body.entity[definition.primaryKey] = recordId;
     }
-    return list[0];
+    if (requireId && !isBlank(args.batchId) && isBlank(body.entity.batchId)) {
+        body.entity.batchId = args.batchId;
+    }
+    if ((args.draft || args.isDraft) && isBlank(body.entity.checkStatus)) {
+        body.entity.checkStatus = 5;
+    }
+    if (!Array.isArray(body.field)) {
+        body.field = [];
+    }
+    return cleanObject(body);
 }
-async function buildUpdateInformationBody(client, moduleDefinition, args) {
-    const rawBody = buildUpdateInformationPreviewBody(moduleDefinition, args);
-    const fields = await fetchModuleFields(client, moduleDefinition, args);
-    const list = hydrateUpdateList(rawBody.list ?? [], fields);
-    const batchId = rawBody.batchId ?? await resolveUpdateBatchId(client, moduleDefinition, rawBody, list);
-    return {
-        ...rawBody,
-        batchId,
-        list
-    };
+function getCrmDocumentApprovalNotice(definition, body) {
+    if (!definition.requiresApprovalFlow || body.examineFlowData || body.entity?.checkStatus === 5) {
+        return undefined;
+    }
+    return `${definition.name}通常会走审批流；当前请求未包含 examineFlowData。如线上审批配置要求审批，请先补充审批流数据，或传 draft=true 保存草稿。`;
 }
-function buildUpdateInformationPreviewBody(moduleDefinition, args) {
+function previewCrmDocumentWrite(definition, operation, targetPath, body, approvalNotice) {
     return cleanObject({
-        id: args.id ?? args[moduleDefinition.primaryKey],
-        label: moduleDefinition.label,
-        list: rawUpdateList(args),
-        batchId: args.batchId,
-        idList: args.idList,
-        ownerUserSave: args.ownerUserSave
+        preview: true,
+        message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+        module: definition.key,
+        moduleName: definition.name,
+        operation,
+        targetPath,
+        approvalNotice,
+        body
     });
 }
-function rawUpdateList(args) {
-    const raw = args.list ?? args.fields ?? args.field;
-    const list = toArray(raw);
-    if (list.length > 0) {
-        return list;
+function buildAddressBookListBody(args) {
+    const body = buildPassthroughBody(args, ["keyword", "query", "q", "name"], {
+        page: args.page ?? 1,
+        limit: args.limit ?? 15
+    });
+    const search = firstTextValue(args.search, args.keyword, args.query, args.q, args.realname, args.name);
+    if (search && body.search === undefined && body.realname === undefined) {
+        body.search = search;
     }
-    const updates = args.updates;
-    if (!updates || typeof updates !== "object" || Array.isArray(updates)) {
-        return [];
+    const deptId = args.deptId ?? args.departmentId;
+    if (!isBlank(deptId) && body.deptId === undefined) {
+        body.deptId = deptId;
     }
-    return Object.entries(updates).map(([key, value]) => looksLikeFieldName(key) ? { fieldName: key, value } : { name: key, value });
+    return cleanObject(body);
 }
-function looksLikeFieldName(value) {
-    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(value);
+function buildAddressBookDepartmentBody(args) {
+    const body = buildPassthroughBody(args, ["keyword", "query", "q"], {
+        type: args.type ?? "tree"
+    });
+    const name = firstTextValue(args.name, args.deptName, args.keyword, args.query, args.q);
+    if (name && body.name === undefined && body.deptName === undefined) {
+        body.name = name;
+    }
+    return cleanObject(body);
 }
-async function fetchModuleFields(client, moduleDefinition, args) {
-    const id = args.id ?? args[moduleDefinition.primaryKey];
-    const path = id ? `${moduleDefinition.basePath}/field/${id}` : `${moduleDefinition.basePath}/field`;
-    const data = await client.post(path, undefined, cleanQuery({ type: args.type, poolId: args.poolId }));
-    return flattenFieldDefinitions(data);
+function addressBookDeptIds(args) {
+    return requireIdArray(args.deptIds ?? args.ids ?? args.deptId ?? args.id, "查询通讯录部门用户请提供 deptIds/ids 数组或 deptId/id。");
 }
-function flattenFieldDefinitions(input) {
-    const output = [];
-    const seen = new Set();
-    const visit = (value) => {
-        if (!value || typeof value !== "object" || seen.has(value)) {
-            return;
-        }
-        seen.add(value);
-        if (Array.isArray(value)) {
-            value.forEach(visit);
-            return;
-        }
-        const record = value;
-        if (record.fieldName || record.fieldId || (record.name && (record.fieldType !== undefined || record.type !== undefined || record.formType))) {
-            output.push(record);
-        }
-        for (const child of Object.values(record)) {
-            if (child && typeof child === "object") {
-                visit(child);
-            }
-        }
-    };
-    visit(input);
-    return output;
+function buildAddressBookUserDeptRoleBody(args) {
+    const body = cleanObject({
+        userIds: args.userIds,
+        deptIds: args.deptIds,
+        roleIds: args.roleIds
+    });
+    if (!Array.isArray(body.userIds) && !Array.isArray(body.deptIds) && !Array.isArray(body.roleIds)) {
+        throw new Error("查询通讯录用户、部门、角色聚合信息请至少提供 userIds、deptIds 或 roleIds。");
+    }
+    return body;
 }
-function hydrateUpdateList(list, fields) {
-    return list.map((item) => hydrateUpdateItem(item, fields));
+function requireAddressBookUserId(args, message) {
+    const userId = args.userId ?? args.id;
+    if (isBlank(userId)) {
+        throw new Error(message);
+    }
+    return userId;
 }
-function hydrateUpdateItem(item, fields) {
-    const field = findFieldDefinition(item, fields);
-    if (!field && hasUpdateMetadata(item)) {
-        return normalizeUpdateItem(item);
+function requireAddressBookUsername(args) {
+    const username = firstTextValue(args.username, args.userName, args.name);
+    if (!username) {
+        throw new Error("查询通讯录用户数量请提供 username 或 userName。");
     }
-    if (!field) {
-        const fieldLabel = item.name ?? item.fieldName ?? item.fieldId ?? "<unknown>";
-        throw new Error(`未在字段 schema 中找到可写字段：${fieldLabel}。请先调用 crm_get_module_schema 确认字段名。`);
+    return username;
+}
+function buildAddressBookAttentionBody(args) {
+    const body = objectWriteBody(args);
+    const userId = args.userId ?? args.id ?? body.userId;
+    if (isBlank(userId)) {
+        throw new Error("切换通讯录关注状态请提供 userId 或 id。");
     }
-    const merged = cleanObject({
-        fieldId: item.fieldId ?? field.fieldId ?? field.id,
-        fieldName: item.fieldName ?? field.fieldName,
-        name: item.name ?? field.name,
-        fieldType: item.fieldType ?? field.fieldType,
-        type: item.type ?? field.type,
-        formType: item.formType ?? field.formType,
-        value: normalizeOptionValue(item.value, field)
-    });
-    return normalizeUpdateItem(merged);
+    if (isBlank(body.userId)) {
+        body.userId = userId;
+    }
+    return cleanObject(body);
 }
-function hasUpdateMetadata(item) {
-    return Boolean(item.fieldName && item.fieldType !== undefined && item.type !== undefined);
+function buildOaExamineCategoryBody(args) {
+    const body = buildPassthroughBody(args, ["keyword", "query", "q"], {
+        pageType: args.pageType ?? 0,
+        label: args.label ?? 0
+    });
+    const search = firstTextValue(args.search, args.keyword, args.query, args.q, args.name);
+    if (search && body.search === undefined) {
+        body.search = search;
+    }
+    return cleanObject(body);
 }
-function normalizeUpdateItem(item) {
-    return cleanObject({
-        fieldId: item.fieldId,
-        fieldName: item.fieldName,
-        name: item.name,
-        fieldType: item.fieldType,
-        type: item.type,
-        formType: item.formType,
-        value: item.value
+function buildOaExamineGroupBody(args) {
+    return buildPassthroughBody(args, [], {
+        groupType: args.groupType ?? 0
     });
 }
-async function resolveUpdateBatchId(client, moduleDefinition, body, list) {
-    if (body.batchId || !body.id || !updateNeedsBatchId(list)) {
-        return undefined;
+function getOaExamineListDefinition(args) {
+    const listType = firstTextValue(args.listType, args.view, args.scene, args.kind, args.mode, "upcoming") ?? "upcoming";
+    const tab = firstTextValue(args.tab, args.scope);
+    const candidates = [
+        tab ? `${listType}.${tab}` : undefined,
+        tab ? `${listType}${tab}` : undefined,
+        listType
+    ]
+        .filter((value) => Boolean(value))
+        .map(normalizeOaExamineAlias);
+    const definition = candidates
+        .map((candidate) => OA_EXAMINE_LIST_ENDPOINTS.find((item) => item.aliases.some((alias) => normalizeOaExamineAlias(alias) === candidate)))
+        .find((item) => Boolean(item));
+    if (!definition) {
+        throw new Error(`当前 MCP 支持的 OA 审批列表类型：${OA_EXAMINE_LIST_ENDPOINTS.map((item) => item.key).join("、")}。`);
     }
-    const data = await client.post(`${moduleDefinition.basePath}/queryById/${body.id}`);
-    return findFirstValueByKey(data, "batchId");
+    return definition;
 }
-function updateNeedsBatchId(list) {
-    return list.some((item) => {
-        const fieldType = Number(item.fieldType);
-        return fieldType === 0 || fieldType === 2;
+function buildOaExamineListBody(args) {
+    const body = buildPassthroughBody(args, ["listType", "view", "scene", "kind", "mode", "tab", "scope", "keyword", "query", "q", "filters"], {
+        page: args.page ?? 1,
+        limit: args.limit ?? 15
     });
+    const search = firstTextValue(args.search, args.keyword, args.query, args.q, args.name, args.content);
+    if (search && body.search === undefined) {
+        body.search = search;
+    }
+    if (args.filters && body.searchBO === undefined) {
+        body.searchBO = { searchList: args.filters };
+    }
+    return cleanObject(body);
 }
-function findFirstValueByKey(input, key) {
-    const seen = new Set();
+function buildOaExamineFieldBody(args) {
+    return buildPassthroughBody(args, ["id", "examineIdForFields"], {
+        examineId: requireOaExamineId(args, "查询 OA 审批详情字段请提供 examineId 或 id。"),
+        isDetail: args.isDetail ?? 1,
+        type: args.type ?? 1
+    });
+}
+function buildOaExamineCreateFieldQuery(args, categoryId) {
+    return buildPassthroughBody(args, [
+        "id",
+        "examineIdForFields",
+        "mode",
+        "useFieldList",
+        "fieldList",
+        "fields",
+        "updates",
+        "fieldValues",
+        "fieldForm",
+        "entity",
+        "oaExamine",
+        "oaExamineRelation",
+        "oaExamineTravelList",
+        "examineFlowData",
+        "batchId",
+        "strictRequired",
+        "customerId",
+        "customerIds",
+        "contactsId",
+        "contactsIds",
+        "businessId",
+        "businessIds",
+        "contractId",
+        "contractIds",
+        "receivablesId",
+        "receivablesIds",
+        "quotationId",
+        "quotationIds"
+    ], {
+        categoryId,
+        needHidden: args.needHidden ?? true
+    });
+}
+function buildOaExamineRecordLogBody(args) {
+    const recordId = args.recordId ?? args.examineRecordId ?? args.id;
+    if (isBlank(recordId)) {
+        throw new Error("查询 OA 审批记录日志请提供 recordId、examineRecordId 或 id。");
+    }
+    return buildPassthroughBody(args, ["id", "examineRecordId"], { recordId });
+}
+function buildOaExamineFlowRecordBody(args) {
+    const recordId = args.recordId ?? args.examineRecordId ?? args.id;
+    if (isBlank(recordId)) {
+        throw new Error("查询 OA 审批流程节点请提供 recordId、examineRecordId 或 id。");
+    }
+    return buildPassthroughBody(args, ["id", "examineRecordId"], { recordId });
+}
+async function buildOaExamineWriteBody(client, args, requireId) {
+    const body = objectWriteBody(args);
+    const examineId = args.examineId ?? args.id ?? body.examineId;
+    if (requireId && isBlank(examineId)) {
+        throw new Error("修改 OA 审批请提供 examineId 或 id。");
+    }
+    if (shouldBuildStructuredOaExamineBody(args, body)) {
+        return buildStructuredOaExamineWriteBody(client, args, examineId);
+    }
+    if (!isBlank(examineId) && isBlank(body.examineId)) {
+        body.examineId = examineId;
+    }
+    return cleanObject(body);
+}
+function shouldBuildStructuredOaExamineBody(args, body) {
+    if (body.oaExamine || body.oaExamineRelation || body.oaExamineTravelList || Array.isArray(body.field)) {
+        return false;
+    }
+    const categoryId = args.categoryId ?? body.categoryId;
+    const fieldValues = args.fieldValues ?? args.fields ?? args.updates ?? args.fieldForm;
+    return !isBlank(categoryId) && fieldValues && typeof fieldValues === "object";
+}
+async function buildStructuredOaExamineWriteBody(client, args, examineId) {
+    const categoryId = args.categoryId;
+    if (isBlank(categoryId)) {
+        throw new Error("自动组装 OA 审批自定义字段请提供 categoryId。");
+    }
+    const targetPath = `/oaExamineField/queryField/${categoryId}`;
+    const fieldMetadata = await client.post(targetPath, buildOaExamineCreateFieldQuery(args, categoryId));
+    const fields = flattenOaExamineFields(fieldMetadata);
+    if (fields.length === 0) {
+        throw new Error(`未从 ${targetPath} 读取到 OA 审批字段，无法自动组装自定义字段。`);
+    }
+    const fieldValues = normalizeFieldValues(args.fieldValues ?? args.fields ?? args.updates ?? args.fieldForm);
+    const params = {
+        oaExamine: cleanObject({
+            ...(isPlainObject(args.oaExamine) ? args.oaExamine : {}),
+            ...(isPlainObject(args.entity) ? args.entity : {}),
+            categoryId,
+            examineId: isBlank(examineId) ? undefined : examineId,
+            batchId: args.batchId ?? args.oaExamine?.batchId ?? randomUUID()
+        }),
+        oaExamineRelation: buildOaExamineRelation(args),
+        field: [],
+        oaExamineTravelList: Array.isArray(args.oaExamineTravelList) ? [...args.oaExamineTravelList] : []
+    };
+    for (const [rawKey, rawValue] of Object.entries(fieldValues)) {
+        const field = findOaExamineField(fields, rawKey);
+        if (!field) {
+            throw new Error(`OA 审批类型 ${categoryId} 未找到字段“${rawKey}”，请先用 crm_get_oa_examine_fields 查询字段名。`);
+        }
+        appendOaExamineFieldValue(params, field, rawValue);
+    }
+    if (args.examineFlowData !== undefined) {
+        params.examineFlowData = args.examineFlowData;
+    }
+    if (args.strictRequired) {
+        const missing = findMissingRequiredOaFields(fields, fieldValues);
+        if (missing.length > 0) {
+            throw new Error(`OA 审批缺少必填字段：${missing.map((field) => field.name ?? field.fieldName).join("、")}。`);
+        }
+    }
+    return cleanObject(params);
+}
+function flattenOaExamineFields(input) {
+    const output = [];
     const visit = (value) => {
-        if (!value || typeof value !== "object" || seen.has(value)) {
-            return undefined;
+        if (!Array.isArray(value)) {
+            return;
         }
-        seen.add(value);
-        if (Array.isArray(value)) {
-            for (const item of value) {
-                const found = visit(item);
-                if (found !== undefined && found !== null && found !== "") {
-                    return found;
+        for (const item of value) {
+            if (Array.isArray(item)) {
+                visit(item);
+            }
+            else if (isPlainObject(item)) {
+                const record = item;
+                if (record.fieldName || record.fieldId) {
+                    output.push(record);
+                }
+                for (const key of ["list", "fieldList", "children"]) {
+                    if (Array.isArray(record[key])) {
+                        visit(record[key]);
+                    }
                 }
             }
-            return undefined;
         }
-        const record = value;
-        if (record[key] !== undefined && record[key] !== null && record[key] !== "") {
-            return record[key];
+    };
+    visit(input);
+    return output;
+}
+function normalizeFieldValues(input) {
+    if (Array.isArray(input)) {
+        const output = {};
+        for (const item of input) {
+            if (!isPlainObject(item)) {
+                continue;
+            }
+            const record = item;
+            const key = record.fieldName ?? record.name ?? record.field ?? record.fieldId;
+            if (!isBlank(key)) {
+                output[String(key)] = Object.prototype.hasOwnProperty.call(record, "value") ? record.value : record;
+            }
         }
-        for (const child of Object.values(record)) {
-            const found = visit(child);
-            if (found !== undefined && found !== null && found !== "") {
-                return found;
+        return output;
+    }
+    if (isPlainObject(input)) {
+        return input;
+    }
+    return {};
+}
+function findOaExamineField(fields, key) {
+    const target = normalizeFieldLookupKey(key);
+    return fields.find((field) => [field.fieldName, field.name, field.field, field.fieldId]
+        .some((value) => normalizeFieldLookupKey(value) === target));
+}
+function appendOaExamineFieldValue(params, field, rawValue) {
+    if (field.fieldName === "cause") {
+        appendOaExamineCauseValue(params, field, rawValue);
+        return;
+    }
+    const value = getOaExamineRealValue(field, rawValue);
+    if (Number(field.fieldType) === 1) {
+        params.oaExamine[field.fieldName] = isEmptyValue(value) ? "" : value;
+        return;
+    }
+    if (field.formType !== "desc_text") {
+        params.field.push({
+            fieldName: field.fieldName,
+            fieldType: field.fieldType,
+            name: field.name,
+            type: field.type,
+            fieldId: field.fieldId,
+            value
+        });
+    }
+}
+function appendOaExamineCauseValue(params, field, rawValue) {
+    const value = isPlainObject(rawValue) && Array.isArray(rawValue.list) ? rawValue : { list: rawValue };
+    const list = Array.isArray(value.list) ? value.list : [];
+    if (field.formType === "business_cause") {
+        params.oaExamineTravelList = list;
+        return;
+    }
+    if (field.formType === "examine_cause") {
+        for (const item of list) {
+            if (isPlainObject(item)) {
+                const copy = { ...item };
+                delete copy.imgList;
+                params.oaExamineTravelList.push(copy);
             }
         }
-        return undefined;
-    };
-    return visit(input);
+    }
 }
-function findFieldDefinition(item, fields) {
-    const fieldId = item.fieldId !== undefined ? String(item.fieldId) : undefined;
-    const fieldName = normalizeText(item.fieldName);
-    const name = normalizeText(item.name);
-    return fields.find((field) => {
-        if (fieldId && String(field.fieldId ?? field.id) === fieldId) {
-            return true;
+function getOaExamineRealValue(field, value) {
+    const formType = field.formType;
+    if (formType === "contract" && field.multiContract) {
+        if (field.multiType === "receivables") {
+            return value;
         }
-        if (fieldName && normalizeText(field.fieldName) === fieldName) {
-            return true;
+        if (field.multiType === "invoice" && Array.isArray(value)) {
+            return value.map((item) => {
+                if (!isPlainObject(item)) {
+                    return item;
+                }
+                const record = item;
+                return {
+                    contractId: record.contractId,
+                    receivablesIdList: Array.isArray(record.receivablesList)
+                        ? record.receivablesList.map((receivable) => receivable.receivablesId)
+                        : [],
+                    currInvoiceMoney: record.currInvoiceMoney,
+                    remark: record.remark
+                };
+            });
         }
-        return Boolean(name && normalizeText(field.name) === name);
-    });
+    }
+    if (isModuleSelectFormType(formType)) {
+        return getModuleSelectValue(field, value);
+    }
+    if (formType === "user" || formType === "single_user" || formType === "structure") {
+        return getUserOrStructureValue(formType, value);
+    }
+    if (formType === "file") {
+        return getFileBatchId(value);
+    }
+    if (formType === "category") {
+        return Array.isArray(value) ? value[value.length - 1] : value ?? "";
+    }
+    if (formType === "checkbox") {
+        return Array.isArray(value) ? value.join(",") : value;
+    }
+    if (formType === "detail_table") {
+        return getDetailTableValue(field, value);
+    }
+    if (formType === "number" || formType === "floatnumber") {
+        return typeof value === "number" ? (Number.isNaN(value) ? "" : String(value)) : value;
+    }
+    if (formType === "data_dictionary") {
+        return value ?? null;
+    }
+    return value;
 }
-function normalizeOptionValue(value, field) {
-    const options = parseFieldOptions(field.options ?? field.setting ?? field.optionsData);
-    if (options.length === 0 || value === undefined || value === null || value === "") {
-        return value;
+function isModuleSelectFormType(formType) {
+    return [
+        "leads",
+        "contacts",
+        "customer",
+        "contract",
+        "receivables",
+        "business",
+        "workorder",
+        "quotation",
+        "visitPlan",
+        "supplier",
+        "warehouse",
+        "invoice"
+    ].includes(String(formType));
+}
+function getModuleSelectValue(field, value) {
+    if (isEmptyValue(value)) {
+        return "";
     }
-    const valueText = normalizeText(value);
-    const match = options.find((option) => [option.value, option.name, option.label].some((candidate) => normalizeText(candidate) === valueText));
-    if (!match) {
-        const available = options.map((option) => option.name ?? option.label ?? option.value).filter((option) => option !== undefined);
-        throw new Error(`字段“${field.name ?? field.fieldName}”的可选值不包含“${value}”。可选值：${available.join("、")}`);
+    const formType = String(field.formType);
+    if (Array.isArray(value) && value.length > 0 && isPlainObject(value[0])) {
+        if (formType === "invoice" && field.isMulti == 1) {
+            return value.map((item) => item[`${formType}Id`]);
+        }
+        return value[0][`${formType}Id`] ?? value[0].id;
+    }
+    if (isPlainObject(value)) {
+        const record = value;
+        return record[`${formType}Id`] ?? record.id;
+    }
+    if (Array.isArray(value)) {
+        return value[value.length - 1];
     }
     return value;
 }
-function parseFieldOptions(input) {
-    if (!input) {
-        return [];
+function getUserOrStructureValue(formType, value) {
+    let normalized = value ?? [];
+    if (Array.isArray(value) && value.length > 0 && isPlainObject(value[0])) {
+        normalized = value.map((item) => {
+            const record = item;
+            return formType === "structure" ? record.id ?? record.deptId : record.userId ?? record.id;
+        });
+    }
+    else if (isPlainObject(value)) {
+        const record = value;
+        normalized = formType === "structure" ? record.id ?? record.deptId : record.userId ?? record.id;
     }
-    if (Array.isArray(input)) {
-        return input.map((option) => (typeof option === "object" && option ? option : { value: option, name: option }));
+    return Array.isArray(normalized) ? normalized.join(",") : normalized;
+}
+function getFileBatchId(value) {
+    if (Array.isArray(value) && value.length > 0 && isPlainObject(value[0])) {
+        return value[0].batchId ?? "";
     }
-    if (typeof input === "string") {
-        const text = input.trim();
-        if (!text) {
-            return [];
-        }
-        try {
-            return parseFieldOptions(JSON.parse(text));
+    if (isPlainObject(value)) {
+        return value.batchId ?? "";
+    }
+    return "";
+}
+function getDetailTableValue(field, value) {
+    const fieldExtendList = Array.isArray(field.fieldExtendList) ? field.fieldExtendList : [];
+    const rows = Array.isArray(value) ? value : [];
+    const result = [];
+    for (const row of rows) {
+        if (!isPlainObject(row) || isDetailRowEmpty(fieldExtendList, row)) {
+            continue;
         }
-        catch {
-            return text.split(",").map((option) => option.trim()).filter(Boolean).map((option) => ({ value: option, name: option }));
+        const rowRecord = row;
+        const batchId = rowRecord.batchId || randomUUID();
+        const rowFields = [];
+        for (const tableField of fieldExtendList) {
+            if (!isPlainObject(tableField)) {
+                continue;
+            }
+            const copy = { ...tableField };
+            delete copy.companyId;
+            copy.value = getOaExamineRealValue(copy, rowRecord[copy.fieldName]);
+            copy.batchId = batchId;
+            rowFields.push(copy);
         }
+        result.push(rowFields);
     }
-    if (typeof input === "object") {
-        const object = input;
-        return parseFieldOptions(object.options ?? object.list ?? object.data ?? []);
+    return result;
+}
+function isDetailRowEmpty(fields, row) {
+    return fields.every((field) => isEmptyValue(row[field.fieldName]));
+}
+function buildOaExamineRelation(args) {
+    if (isPlainObject(args.oaExamineRelation)) {
+        return { ...args.oaExamineRelation };
     }
-    return [];
+    return cleanObject({
+        customerIds: toCommaSeparated(args.customerIds ?? args.customerId),
+        contactsIds: toCommaSeparated(args.contactsIds ?? args.contactsId),
+        businessIds: toCommaSeparated(args.businessIds ?? args.businessId),
+        contractIds: toCommaSeparated(args.contractIds ?? args.contractId),
+        receivablesIds: toCommaSeparated(args.receivablesIds ?? args.receivablesId),
+        quotationIds: toCommaSeparated(args.quotationIds ?? args.quotationId)
+    });
 }
-async function verifyInformationUpdate(client, moduleDefinition, body) {
-    const endpoint = `${moduleDefinition.basePath}/information/${body.id}`;
-    const data = await client.post(endpoint);
-    const checked = (body.list ?? []).map((item) => {
-        const actualValue = findInformationValue(data, item);
-        return {
-            fieldName: item.fieldName,
-            name: item.name,
-            expectedValue: item.value,
-            actualValue,
-            matched: valuesMatch(item.value, actualValue)
-        };
+function findMissingRequiredOaFields(fields, values) {
+    return fields.filter((field) => {
+        if (Number(field.isNull) !== 1 || field.formType === "desc_text") {
+            return false;
+        }
+        const value = values[field.fieldName] ?? values[field.name] ?? values[field.fieldId];
+        return isEmptyValue(value);
     });
-    return {
-        endpoint,
-        ok: checked.every((item) => item.matched),
-        checked
-    };
 }
-function findInformationValue(data, field) {
-    const direct = findDirectInformationValue(data, field);
-    if (direct.found) {
-        return direct.value;
+function normalizeFieldLookupKey(value) {
+    return String(value ?? "").trim().toLowerCase();
+}
+function isPlainObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isEmptyValue(value) {
+    if (value === undefined || value === null || value === "") {
+        return true;
     }
-    const seen = new Set();
-    const wantedFieldName = normalizeText(field.fieldName);
-    const wantedName = normalizeText(field.name);
-    const visit = (value) => {
-        if (!value || typeof value !== "object" || seen.has(value)) {
-            return { found: false };
+    if (Array.isArray(value)) {
+        return value.length === 0;
+    }
+    if (isPlainObject(value)) {
+        return Object.keys(value).length === 0;
+    }
+    return false;
+}
+function buildOaExamineAuditBody(args, batch) {
+    const body = objectWriteBody(args);
+    const recordId = args.recordId ?? args.examineRecordId ?? args.id ?? body.recordId;
+    const recordIds = args.recordIds ?? args.examineRecordIds ?? args.ids ?? body.recordIds;
+    if (batch) {
+        if (!Array.isArray(recordIds) || recordIds.length === 0) {
+            throw new Error("批量审批 OA 审批请提供 recordIds、examineRecordIds 或 ids 数组。");
         }
-        seen.add(value);
-        if (Array.isArray(value)) {
-            for (const item of value) {
-                const result = visit(item);
-                if (result.found) {
-                    return result;
-                }
-            }
-            return { found: false };
+        if (body.recordIds === undefined) {
+            body.recordIds = recordIds;
         }
-        const record = value;
-        const recordFieldName = normalizeText(record.fieldName);
-        const recordName = normalizeText(record.name);
-        if ((wantedFieldName && recordFieldName === wantedFieldName) || (wantedName && recordName === wantedName)) {
-            return { found: true, value: extractInformationValue(record) };
+    }
+    else {
+        if (isBlank(recordId)) {
+            throw new Error("审批 OA 审批请提供 recordId、examineRecordId 或 id。");
         }
-        for (const child of Object.values(record)) {
-            const result = visit(child);
-            if (result.found) {
-                return result;
-            }
+        if (isBlank(body.recordId)) {
+            body.recordId = recordId;
         }
-        return { found: false };
-    };
-    return visit(data).value;
+    }
+    return cleanObject(body);
 }
-function findDirectInformationValue(data, field) {
-    if (!data || typeof data !== "object" || Array.isArray(data)) {
-        return { found: false };
+function requireOaExamineId(args, message) {
+    const examineId = args.examineId ?? args.id;
+    if (isBlank(examineId)) {
+        throw new Error(message);
     }
-    const record = data;
-    if (field.fieldName && Object.prototype.hasOwnProperty.call(record, field.fieldName)) {
-        return { found: true, value: record[field.fieldName] };
+    return examineId;
+}
+function buildPassthroughBody(args, omitKeys = [], defaults = {}) {
+    const omit = new Set(["confirm", ...omitKeys]);
+    const body = { ...defaults };
+    for (const [key, value] of Object.entries(args ?? {})) {
+        if (!omit.has(key) && value !== undefined && value !== null) {
+            body[key] = value;
+        }
     }
-    return { found: false };
+    return cleanObject(body);
 }
-function extractInformationValue(record) {
-    if (Object.prototype.hasOwnProperty.call(record, "value")) {
-        return record.value;
+function objectWriteBody(args) {
+    const explicitBody = explicitWriteBody(args);
+    return explicitBody && typeof explicitBody === "object" && !Array.isArray(explicitBody)
+        ? { ...explicitBody }
+        : {};
+}
+function normalizeOaExamineAlias(value) {
+    return String(value ?? "").trim().replace(/[\s._-]+/g, "").toLowerCase();
+}
+function previewOaWrite(operation, module, moduleName, targetPath, body) {
+    return {
+        preview: true,
+        message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+        module,
+        moduleName,
+        operation,
+        targetPath,
+        body
+    };
+}
+function buildCalendarListBody(args) {
+    return cleanObject({
+        startTime: args.startTime ?? args.start,
+        endTime: args.endTime ?? args.end,
+        typeIds: args.typeIds,
+        userId: args.userId
+    });
+}
+function buildCalendarDetailBody(args) {
+    return cleanObject({
+        eventId: requireCalendarEventId(args),
+        startTime: args.startTime ?? args.start,
+        endTime: args.endTime ?? args.end
+    });
+}
+function buildCalendarEventBody(args, requireEventId) {
+    const event = buildCalendarEvent(args);
+    if (requireEventId && isBlank(event.eventId)) {
+        throw new Error("修改日程请提供 eventId 或 id。");
     }
-    if (Object.prototype.hasOwnProperty.call(record, "valueDesc")) {
-        return record.valueDesc;
+    const relation = args.relation !== undefined ? args.relation : buildCalendarRelation(args);
+    const notice = args.notice ?? args.notices ?? [];
+    return cleanObject({
+        event,
+        relation,
+        notice,
+        type: args.type,
+        time: args.time
+    });
+}
+function buildCalendarEvent(args) {
+    const event = args.event && typeof args.event === "object" && !Array.isArray(args.event)
+        ? { ...args.event }
+        : cleanObject({
+            eventId: args.eventId ?? args.id,
+            title: args.title,
+            typeId: args.typeId,
+            startTime: args.startTime ?? args.start,
+            endTime: args.endTime ?? args.end,
+            ownerUserIds: args.ownerUserIds ?? args.ownerUserId ?? args.userIds,
+            repetitionType: args.repetitionType,
+            repeatRate: args.repeatRate,
+            repeatTime: args.repeatTime,
+            endType: args.endType,
+            endTypeConfig: args.endTypeConfig,
+            repeatStartTime: args.repeatStartTime,
+            repeatEndTime: args.repeatEndTime,
+            batchId: args.batchId,
+            status: args.status
+        });
+    const directEventId = args.eventId ?? args.id;
+    if (!isBlank(directEventId) && isBlank(event.eventId)) {
+        event.eventId = directEventId;
     }
-    if (Object.prototype.hasOwnProperty.call(record, "fieldValue")) {
-        return record.fieldValue;
+    if (event.ownerUserIds !== undefined) {
+        event.ownerUserIds = toCommaSeparated(event.ownerUserIds);
     }
-    return undefined;
-}
-function valuesMatch(expected, actual) {
-    return normalizeComparableValue(expected) === normalizeComparableValue(actual);
-}
-function normalizeComparableValue(value) {
-    if (value === undefined || value === null) {
-        return "";
+    if (event.repetitionType === undefined || event.repetitionType === null) {
+        event.repetitionType = 1;
     }
-    if (typeof value === "object") {
-        return JSON.stringify(value);
+    if (event.endType === undefined || event.endType === null) {
+        event.endType = 1;
     }
-    return String(value).trim();
+    return cleanObject(event);
 }
-function normalizeText(value) {
-    return value === undefined || value === null ? "" : String(value).trim().toLowerCase();
+function buildCalendarRelation(args) {
+    const relation = cleanObject({
+        customerIds: toCommaSeparated(args.customerIds ?? args.customerId),
+        leadsIds: toCommaSeparated(args.leadsIds ?? args.leadsId),
+        quotationIds: toCommaSeparated(args.quotationIds ?? args.quotationId),
+        receivablesIds: toCommaSeparated(args.receivablesIds ?? args.receivablesId),
+        contactsIds: toCommaSeparated(args.contactsIds ?? args.contactsId),
+        businessIds: toCommaSeparated(args.businessIds ?? args.businessId),
+        contractIds: toCommaSeparated(args.contractIds ?? args.contractId),
+        roomIds: toCommaSeparated(args.roomIds ?? args.roomId)
+    });
+    return Object.keys(relation).length > 0 ? relation : undefined;
 }
-async function listCustomerPools(client, args) {
-    const pools = await client.post("/crmCustomerPool/queryPoolNameListByAuth");
-    const poolList = Array.isArray(pools) ? pools : [];
-    const includeSamples = Boolean(args.includeSamples);
-    const limit = includeSamples ? positiveInteger(args.sampleLimit ?? args.limit, 3) : 1;
-    const searchList = args.filters ?? args.searchList ?? [];
-    const poolSummaries = await Promise.all(poolList.map(async (pool) => {
-        const poolId = pool.poolId ?? pool.id;
-        if (!poolId) {
-            throw new Error("客户公海授权列表缺少 poolId，无法统计池内客户数量。");
-        }
-        const page = await client.post("/crmCustomerPool/queryPageList", cleanObject({
-            page: 1,
-            limit,
-            pageType: 1,
-            label: 9,
-            poolId,
-            searchList
-        }));
-        const summary = {
-            poolId,
-            poolName: pool.poolName ?? pool.name,
-            customerCount: page.totalRow ?? page.total ?? 0
-        };
-        if (includeSamples) {
-            const list = Array.isArray(page.list) ? page.list : [];
-            summary.samples = list.map((record) => ({
-                customerId: record.customerId ?? record.id,
-                customerName: record.customerName ?? record.name,
-                ownerUserName: record.ownerUserName,
-                createTime: record.createTime
-            }));
-        }
-        return summary;
-    }));
+function requireCalendarEventId(args) {
+    const eventId = args.eventId ?? args.id;
+    if (isBlank(eventId)) {
+        throw new Error("查询日程详情请提供 eventId 或 id。");
+    }
+    return eventId;
+}
+function previewCalendarWrite(operation, targetPath, body) {
     return {
-        module: "customerPool",
-        readonly: true,
-        poolCount: poolSummaries.length,
-        pools: poolSummaries
+        preview: true,
+        message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+        module: "calendarEvent",
+        moduleName: "日程",
+        operation,
+        targetPath,
+        body
     };
 }
-function positiveInteger(value, fallback) {
-    const numberValue = Number(value);
-    if (!Number.isInteger(numberValue) || numberValue < 1) {
-        return fallback;
-    }
-    return numberValue;
-}
-function isPoolModule(moduleDefinition) {
-    return moduleDefinition.key === "customerPool" || moduleDefinition.key === "leadsPool";
+function buildOaTaskListBody(args) {
+    return cleanObject({
+        page: args.page,
+        limit: args.limit,
+        type: args.type,
+        status: args.status,
+        priority: args.priority,
+        dueDate: args.dueDate,
+        mold: args.mold,
+        userId: args.userId,
+        mainUserId: args.mainUserId,
+        mainUserIds: args.mainUserIds,
+        search: firstTextValue(args.search, args.keyword, args.query, args.q, args.name)
+    });
 }
-function getPoolRecordModule(moduleDefinition) {
-    return getModuleByKey(moduleDefinition.key === "customerPool" ? "customer" : "leads");
+function buildRelatedOaTaskQuery(args) {
+    return cleanQuery({
+        type: args.type,
+        typeId: args.typeId ?? args.id
+    });
 }
-async function resolvePoolContext(client, moduleDefinition, args) {
-    if (!isPoolModule(moduleDefinition)) {
-        throw new Error(`Module ${moduleDefinition.key} is not a pool module.`);
+function buildOaTaskBody(args) {
+    const task = args.task && typeof args.task === "object" && !Array.isArray(args.task)
+        ? { ...args.task }
+        : cleanObject({
+            taskId: args.taskId ?? args.id,
+            name: args.name ?? args.title,
+            createUserId: args.createUserId,
+            mainUserId: args.mainUserId,
+            ownerUserId: args.ownerUserId ?? args.ownerUserIds,
+            status: args.status,
+            classId: args.classId,
+            labelId: args.labelId ?? args.labelIds,
+            description: args.description,
+            pid: args.pid,
+            startTime: args.startTime ?? args.start,
+            stopTime: args.stopTime ?? args.endTime ?? args.end,
+            priority: args.priority,
+            workId: args.workId,
+            isTop: args.isTop,
+            isOpen: args.isOpen,
+            orderNum: args.orderNum,
+            topOrderNum: args.topOrderNum,
+            batchId: args.batchId,
+            isArchive: args.isArchive,
+            customerIds: args.customerIds ?? args.customerId,
+            contactsIds: args.contactsIds ?? args.contactsId,
+            businessIds: args.businessIds ?? args.businessId,
+            contractIds: args.contractIds ?? args.contractId
+        });
+    for (const key of ["ownerUserId", "labelId", "customerIds", "contactsIds", "businessIds", "contractIds"]) {
+        if (task[key] !== undefined) {
+            task[key] = toCommaSeparated(task[key]);
+        }
     }
-    if (args.poolId) {
-        return { poolId: args.poolId, pool: cleanObject({ poolId: args.poolId, poolName: args.poolName }) };
+    return cleanObject(task);
+}
+function buildOaTaskUpdateCalls(args) {
+    const taskId = requireOaTaskId(args);
+    const source = args.updates && typeof args.updates === "object" && !Array.isArray(args.updates) ? args.updates : args;
+    const calls = [];
+    const name = firstPresentValue(source.name, source.title);
+    if (name !== undefined) {
+        calls.push({ targetPath: "/workTask/setWorkTaskTitle", body: { taskId, name } });
     }
-    const pools = await client.post(`${moduleDefinition.basePath}/queryPoolNameListByAuth`);
-    const poolList = Array.isArray(pools) ? pools : [];
-    const selectedPool = args.poolName
-        ? poolList.find((pool) => String(pool.poolName ?? pool.name ?? "").trim() === String(args.poolName).trim())
-        : poolList[0];
-    if (!selectedPool) {
-        throw new Error(`当前账号没有可查询的${moduleDefinition.name}，请确认公海/线索池权限或传入 poolId。`);
+    const description = firstPresentValue(source.description);
+    if (description !== undefined) {
+        calls.push({ targetPath: "/workTask/setWorkTaskDescription", body: { taskId, description } });
     }
-    const poolId = selectedPool.poolId ?? selectedPool.id;
-    if (!poolId) {
-        throw new Error(`${moduleDefinition.name}授权列表缺少 poolId，无法查询池内数据。`);
+    const mainUserId = firstPresentValue(source.mainUserId, source.userId);
+    if (mainUserId !== undefined) {
+        calls.push({ targetPath: "/workTask/setWorkTaskMainUser", body: { taskId, userId: mainUserId } });
     }
-    return { poolId, pool: selectedPool };
-}
-async function callRelatedRecords(client, moduleDefinition, args) {
-    const relation = String(args.relation ?? args.type ?? "").trim();
-    const pageBody = cleanObject({ page: args.page ?? 1, limit: args.limit ?? 15, pageType: 1, id: args.id, ...safeExtra(args.extra) });
-    if (moduleDefinition.key === "business" && relation === "product") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmBusiness/queryProduct", pageBody) };
+    const ownerUserId = firstPresentValue(source.ownerUserId, source.ownerUserIds);
+    if (ownerUserId !== undefined) {
+        calls.push({ targetPath: "/workTask/setWorkTaskOwnerUser", body: { taskId, ownerUserId: toCommaSeparated(ownerUserId) } });
     }
-    if (moduleDefinition.key === "business" && relation === "contacts") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmBusiness/queryContacts", pageBody) };
+    const startTime = firstPresentValue(source.startTime, source.start);
+    const stopTime = firstPresentValue(source.stopTime, source.endTime, source.end);
+    if (startTime !== undefined || stopTime !== undefined) {
+        calls.push({
+            targetPath: "/workTask/setWorkTaskTime",
+            body: cleanObject({ taskId, startTime, stopTime })
+        });
     }
-    if (moduleDefinition.key === "contacts" && relation === "business") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmContacts/queryBusiness", pageBody) };
+    const labelId = firstPresentValue(source.labelId, source.labelIds);
+    if (labelId !== undefined) {
+        calls.push({ targetPath: "/workTask/setWorkTaskLabel", body: { taskId, labelId: toCommaSeparated(labelId) } });
     }
-    if (moduleDefinition.key === "contract" && relation === "product") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmContract/queryProductListByContractId", pageBody) };
+    const priority = firstPresentValue(source.priority);
+    if (priority !== undefined) {
+        calls.push({ targetPath: "/workTask/setWorkTaskPriority", body: { taskId, priority } });
     }
-    if (moduleDefinition.key === "contract" && relation === "receivablesPlan") {
-        return {
-            module: moduleDefinition.key,
-            relation,
-            data: await client.post("/crmContract/queryReceivablesPlansByContractId", undefined, {
-                contractId: args.id,
-                receivablesId: args.receivablesId,
-                productId: args.productId
-            })
-        };
+    const status = firstPresentValue(source.status);
+    if (status !== undefined) {
+        calls.push({ targetPath: "/workTask/setWorkTaskStatus", body: { taskId, status } });
     }
-    if (moduleDefinition.key === "receivables" && relation === "product") {
-        return { module: moduleDefinition.key, relation, data: await client.post(`/crmReceivables/queryProductList/${args.id}`) };
+    if (calls.length === 0) {
+        throw new Error("请提供要更新的 OA 任务字段：name、description、mainUserId、ownerUserId、startTime/stopTime、labelId、priority 或 status。");
     }
-    if (moduleDefinition.key === "quotation" && relation === "product") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmQuotation/queryProductList", pageBody) };
+    return calls;
+}
+function requireOaTaskId(args) {
+    const taskId = args.taskId ?? args.id;
+    if (isBlank(taskId)) {
+        throw new Error("更新 OA 任务请提供 taskId 或 id。");
     }
-    if (moduleDefinition.key === "product" && relation === "saleProduct") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmProduct/querySaleProductPageList", pageBody) };
+    return taskId;
+}
+function previewOaTaskWrite(operation, targetPath, body) {
+    return {
+        preview: true,
+        message: "写入前预览：未传 confirm=true，MCP 不会调用 72CRM 写接口。",
+        module: "oaTask",
+        moduleName: "OA任务",
+        operation,
+        targetPath,
+        body
+    };
+}
+function toCommaSeparated(value) {
+    if (Array.isArray(value)) {
+        return value.join(",");
     }
-    if (moduleDefinition.key === "receivablesPlan" && relation === "contractCustomer") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmReceivablesPlan/queryByContractAndCustomer", pageBody) };
+    return value;
+}
+function firstPresentValue(...values) {
+    for (const value of values) {
+        if (value !== undefined && value !== null) {
+            return value;
+        }
     }
-    throw new Error(`当前 MCP 未配置“${moduleDefinition.name} / ${relation}”关联查询白名单。`);
+    return undefined;
+}
+function isBlank(value) {
+    return value === undefined || value === null || String(value).trim() === "";
 }
 function previewWrite(args) {
     const moduleDefinition = args.module ? getModuleByKey(args.module) : undefined;