@wukongcrm/mcp-server 0.2.5 → 0.2.6

package/dist/tools.js

@@ -345,24 +345,32 @@ export function createToolHandlers(config = {}, sharedClient) {
             if (isPoolModule(moduleDefinition)) {
                 const poolContext = await resolvePoolContext(client, moduleDefinition, args);
                 const [fields, listHead] = await Promise.all([
-                    client.post(`${moduleDefinition.basePath}/queryPoolField`, undefined, cleanQuery({ poolId: poolContext.poolId, isFlat: args.isFlat ?? args.flat })),
-                    client.post(`${moduleDefinition.basePath}/queryPoolListHead`, undefined, { poolId: poolContext.poolId })
+                    client.read(`${moduleDefinition.basePath}/queryPoolField`, undefined, cleanQuery({ poolId: poolContext.poolId, isFlat: args.isFlat ?? args.flat })),
+                    client.read(`${moduleDefinition.basePath}/queryPoolListHead`, undefined, { poolId: poolContext.poolId })
                 ]);
                 return { module: moduleDefinition.key, moduleName: moduleDefinition.name, pool: poolContext.pool, fields, listHead };
             }
             const id = args.id ?? args.recordId;
             const [fields, listHead] = await Promise.all([
                 id
-                    ? client.post(`${moduleDefinition.basePath}/field/${id}`, undefined, cleanQuery({ type: args.type, poolId: args.poolId }))
-                    : client.post(`${moduleDefinition.basePath}/field`, undefined, cleanQuery({ type: args.type })),
-                client.post(`/crmField/queryListHead/${moduleDefinition.label}`, undefined, cleanQuery({ isHide: args.isHide ?? 0 }))
+                    ? client.read(`${moduleDefinition.basePath}/field/${id}`, undefined, cleanQuery({ type: args.type, poolId: args.poolId }))
+                    : client.read(`${moduleDefinition.basePath}/field`, undefined, cleanQuery({ type: args.type })),
+                client.read(`/crmField/queryListHead/${moduleDefinition.label}`, undefined, cleanQuery({ isHide: args.isHide ?? 0 }))
             ]);
             return { module: moduleDefinition.key, moduleName: moduleDefinition.name, fields, listHead };
         },
+        crm_get_business_status_groups: async (args) => {
+            const targetPath = "/crmFlow/queryBusinessSetting";
+            return {
+                module: "business",
+                targetPath,
+                data: await client.read(targetPath, undefined, cleanQuery({ businessId: args.businessId }))
+            };
+        },
         crm_validate_field: async (args) => {
             const path = args.contactDuplicateCheck ? "/crmField/contactDuplicateCheck" : "/crmField/verify";
             return {
-                data: await client.post(path, args),
+                data: await client.read(path, args),
                 endpoint: path
             };
         },
@@ -384,7 +392,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleLabel: moduleDefinition.label,
                 pool: poolContext?.pool,
                 searchMode: searchList.length > 0 ? "advancedFilter" : "none",
-                data: await client.post(`${moduleDefinition.basePath}/queryPageList`, cleanObject(body))
+                data: await client.read(`${moduleDefinition.basePath}/queryPageList`, cleanObject(body))
             };
         },
         crm_get_record: async (args) => {
@@ -394,7 +402,7 @@ export function createToolHandlers(config = {}, sharedClient) {
             return {
                 module: moduleDefinition.key,
                 pool: poolContext?.pool,
-                data: await client.post(`${recordModule.basePath}/queryById/${args.id}`, undefined, cleanQuery({ poolId: poolContext?.poolId ?? args.poolId }))
+                data: await client.read(`${recordModule.basePath}/queryById/${args.id}`, undefined, cleanQuery({ poolId: poolContext?.poolId ?? args.poolId }))
             };
         },
         crm_get_record_information: async (args) => {
@@ -404,7 +412,7 @@ export function createToolHandlers(config = {}, sharedClient) {
             return {
                 module: moduleDefinition.key,
                 pool: poolContext?.pool,
-                data: await client.post(`${recordModule.basePath}/information/${args.id}`, undefined, cleanQuery({ poolId: poolContext?.poolId ?? args.poolId }))
+                data: await client.read(`${recordModule.basePath}/information/${args.id}`, undefined, cleanQuery({ poolId: poolContext?.poolId ?? args.poolId }))
             };
         },
         crm_get_related_records: async (args) => {
@@ -428,7 +436,7 @@ export function createToolHandlers(config = {}, sharedClient) {
             return {
                 module: moduleDefinition.key,
                 pool: poolContext?.pool,
-                data: await client.post("/crmActivity/queryActivityList", cleanObject(body))
+                data: await client.read("/crmActivity/queryActivityList", cleanObject(body))
             };
         },
         crm_get_action_records: async (args) => {
@@ -436,7 +444,7 @@ export function createToolHandlers(config = {}, sharedClient) {
             const actionModule = isPoolModule(moduleDefinition) ? getPoolRecordModule(moduleDefinition) : moduleDefinition;
             return {
                 module: moduleDefinition.key,
-                data: await client.post("/crmActionRecord/queryRecordList", undefined, {
+                data: await client.read("/crmActionRecord/queryRecordList", undefined, {
                     actionId: args.id,
                     types: args.types ?? actionModule.label
                 })
@@ -450,7 +458,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: moduleDefinition.key,
                 pool: poolContext?.pool,
                 readonly: true,
-                data: await client.post(`${fileModule.basePath}/queryFileList`, undefined, cleanQuery({ id: args.id, fileType: args.fileType }))
+                data: await client.read(`${fileModule.basePath}/queryFileList`, undefined, cleanQuery({ id: args.id, fileType: args.fileType }))
             };
         },
         crm_search_products: async (args) => {
@@ -460,7 +468,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, await buildCrmProductSearchBody(client, args, false))
+                data: await client.read(targetPath, await buildCrmProductSearchBody(client, args, false))
             };
         },
         crm_search_sale_products: async (args) => {
@@ -470,7 +478,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "上架产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, await buildCrmProductSearchBody(client, args, true))
+                data: await client.read(targetPath, await buildCrmProductSearchBody(client, args, true))
             };
         },
         crm_get_product: async (args) => {
@@ -481,7 +489,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_product_information: async (args) => {
@@ -492,7 +500,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_product_schema: async (args) => {
@@ -503,7 +511,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ type: args.type }))
+                data: await client.read(targetPath, undefined, cleanQuery({ type: args.type }))
             };
         },
         crm_list_product_files: async (args) => {
@@ -513,7 +521,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ id: requireCrmProductId(args, "查询 CRM 产品附件请提供 productId 或 id。"), fileType: args.fileType }))
+                data: await client.read(targetPath, undefined, cleanQuery({ id: requireCrmProductId(args, "查询 CRM 产品附件请提供 productId 或 id。"), fileType: args.fileType }))
             };
         },
         crm_get_product_num: async (args) => {
@@ -523,7 +531,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ id: requireCrmProductId(args, "查询 CRM 产品数量请提供 productId 或 id。") }))
+                data: await client.read(targetPath, undefined, cleanQuery({ id: requireCrmProductId(args, "查询 CRM 产品数量请提供 productId 或 id。") }))
             };
         },
         crm_get_simple_products: async (args) => {
@@ -533,11 +541,11 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, requireIdArray(args.productIds ?? args.ids, "查询 CRM 简要产品请提供 productIds 或 ids 数组。"))
+                data: await client.read(targetPath, requireIdArray(args.productIds ?? args.ids, "查询 CRM 简要产品请提供 productIds 或 ids 数组。"))
             };
         },
         crm_list_users: async (args) => ({
-            data: await client.post("/adminUser/queryUserList", cleanObject({
+            data: await client.read("/adminUser/queryUserList", cleanObject({
                 page: args.page ?? 1,
                 limit: args.limit ?? 15,
                 pageType: args.pageType ?? 1,
@@ -561,14 +569,14 @@ export function createToolHandlers(config = {}, sharedClient) {
             }
             return {
                 mode,
-                data: await client.post("/adminUser/getIdByUserName", undefined, { userName, companyId: args.companyId })
+                data: await client.read("/adminUser/getIdByUserName", undefined, { userName, companyId: args.companyId })
             };
         },
         crm_list_departments: async (args) => ({
-            data: await client.post("/adminDept/queryDeptTree", cleanObject(args ?? {}))
+            data: await client.read("/adminDept/queryDeptTree", cleanObject(args ?? {}))
         }),
         crm_find_dept_id: async (args) => ({
-            data: await client.post("/adminDept/getIdByDeptName", undefined, { deptName: args.deptName ?? args.name, companyId: args.companyId })
+            data: await client.read("/adminDept/getIdByDeptName", undefined, { deptName: args.deptName ?? args.name, companyId: args.companyId })
         }),
         crm_list_address_book_contacts: async (args) => {
             const targetPath = "/adminUser/queryListName";
@@ -577,7 +585,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildAddressBookListBody(args))
+                data: await client.read(targetPath, buildAddressBookListBody(args))
             };
         },
         crm_get_address_book_contact: async (args) => {
@@ -587,7 +595,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ userId: requireAddressBookUserId(args, "查询通讯录联系人详情请提供 userId 或 id。") }))
+                data: await client.read(targetPath, undefined, cleanQuery({ userId: requireAddressBookUserId(args, "查询通讯录联系人详情请提供 userId 或 id。") }))
             };
         },
         crm_list_address_book_departments: async (args) => {
@@ -597,7 +605,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildAddressBookDepartmentBody(args))
+                data: await client.read(targetPath, buildAddressBookDepartmentBody(args))
             };
         },
         crm_list_address_book_auth_departments: async (args) => {
@@ -607,7 +615,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, cleanObject(args ?? {}))
+                data: await client.read(targetPath, cleanObject(args ?? {}))
             };
         },
         crm_list_address_book_dept_user_ids: async (args) => {
@@ -619,7 +627,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 readonly: true,
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.read(targetPath, body)
             };
         },
         crm_list_address_book_dept_users: async (args) => {
@@ -631,7 +639,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 readonly: true,
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.read(targetPath, body)
             };
         },
         crm_list_address_book_auth_users: async () => {
@@ -641,7 +649,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_address_book_user_dept_role_info: async (args) => {
@@ -653,7 +661,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 readonly: true,
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.read(targetPath, body)
             };
         },
         crm_get_address_book_organization: async (args) => {
@@ -663,7 +671,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ companyId: args.companyId }))
+                data: await client.read(targetPath, undefined, cleanQuery({ companyId: args.companyId }))
             };
         },
         crm_get_address_book_user_count: async (args) => {
@@ -673,7 +681,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ username: requireAddressBookUsername(args) }))
+                data: await client.read(targetPath, undefined, cleanQuery({ username: requireAddressBookUsername(args) }))
             };
         },
         crm_toggle_address_book_attention: async (args) => {
@@ -687,7 +695,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "通讯录",
                 targetPath,
                 body,
-                data: await client.post(targetPath, undefined, cleanQuery(body))
+                data: await client.write(targetPath, undefined, cleanQuery(body))
             };
         },
         crm_list_hrm_employees: async (args) => {
@@ -696,7 +704,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmEmployee",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildHrmEmployeeListBody(args))
+                data: await client.read(targetPath, buildHrmEmployeeListBody(args))
             };
         },
         crm_get_hrm_employee: async (args) => {
@@ -706,7 +714,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmEmployee",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_list_hrm_employee_fields: async () => {
@@ -715,7 +723,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmEmployee",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_list_hrm_departments: async (args) => {
@@ -724,7 +732,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmDept",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildHrmDepartmentListBody(args))
+                data: await client.read(targetPath, buildHrmDepartmentListBody(args))
             };
         },
         crm_get_hrm_department: async (args) => {
@@ -734,7 +742,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmDept",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_list_hrm_department_employees: async (args) => {
@@ -743,7 +751,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmDept",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildHrmDepartmentEmployeesBody(args))
+                data: await client.read(targetPath, buildHrmDepartmentEmployeesBody(args))
             };
         },
         crm_get_hrm_employee_post: async (args) => {
@@ -753,7 +761,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmEmployeePost",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_list_hrm_attendance_month_records: async (args) => {
@@ -762,7 +770,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmAttendance",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildHrmAttendanceMonthRecordBody(args))
+                data: await client.read(targetPath, buildHrmAttendanceMonthRecordBody(args))
             };
         },
         crm_get_hrm_attendance_daily_detail: async (args) => {
@@ -771,7 +779,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmAttendance",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildHrmAttendanceDailyDetailBody(args))
+                data: await client.read(targetPath, buildHrmAttendanceDailyDetailBody(args))
             };
         },
         crm_list_hrm_leave_records: async (args) => {
@@ -780,7 +788,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmLeaveRecord",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildHrmLeaveRecordBody(args))
+                data: await client.read(targetPath, buildHrmLeaveRecordBody(args))
             };
         },
         crm_list_hrm_leave_types: async () => {
@@ -789,7 +797,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "hrmLeaveRecord",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_list_finance_modules: () => ({
@@ -803,7 +811,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "凭证",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildFinanceSearchBody(args, { page: args.page ?? 1, limit: args.limit ?? 15, pageType: args.pageType ?? 1 }))
+                data: await client.read(targetPath, buildFinanceSearchBody(args, { page: args.page ?? 1, limit: args.limit ?? 15, pageType: args.pageType ?? 1 }))
             };
         },
         crm_get_finance_voucher: async (args) => {
@@ -813,7 +821,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "凭证",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, cleanObject({ certificateId: requireFinanceCertificateId(args), accountId: args.accountId }))
+                data: await client.read(targetPath, cleanObject({ certificateId: requireFinanceCertificateId(args), accountId: args.accountId }))
             };
         },
         crm_summarize_finance_vouchers: async (args) => {
@@ -823,7 +831,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "凭证汇总",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildFinanceBody(args))
+                data: await client.read(targetPath, buildFinanceBody(args))
             };
         },
         crm_query_finance_ledger: async (args) => {
@@ -834,7 +842,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 ledger: ledgerDefinition.key,
                 readonly: true,
                 targetPath: ledgerDefinition.targetPath,
-                data: await client.post(ledgerDefinition.targetPath, buildFinanceBody(args, ["ledger", "type", "kind"]))
+                data: await client.read(ledgerDefinition.targetPath, buildFinanceBody(args, ["ledger", "type", "kind"]))
             };
         },
         crm_query_finance_report: async (args) => {
@@ -847,7 +855,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 balanceCheck: Boolean(args.checkBalance || args.balanceCheck),
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildFinanceBody(args, ["report", "type", "kind", "checkBalance", "balanceCheck"]))
+                data: await client.read(targetPath, buildFinanceBody(args, ["report", "type", "kind", "checkBalance", "balanceCheck"]))
             };
         },
         crm_list_finance_subjects: async (args) => {
@@ -857,7 +865,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "科目",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildFinanceBody(args))
+                data: await client.read(targetPath, buildFinanceBody(args))
             };
         },
         crm_list_finance_currencies: async (args) => {
@@ -867,7 +875,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "币别",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildFinanceBody(args))
+                data: await client.read(targetPath, buildFinanceBody(args))
             };
         },
         crm_list_finance_voucher_words: async (args) => {
@@ -877,7 +885,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "凭证字",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildFinanceBody(args))
+                data: await client.read(targetPath, buildFinanceBody(args))
             };
         },
         crm_query_finance_dashboard: async (args) => {
@@ -888,7 +896,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 query: dashboardDefinition.key,
                 readonly: true,
                 targetPath: dashboardDefinition.targetPath,
-                data: await client.post(dashboardDefinition.targetPath, buildFinanceBody(args, ["query", "type", "kind"]))
+                data: await client.read(dashboardDefinition.targetPath, buildFinanceBody(args, ["query", "type", "kind"]))
             };
         },
         crm_write_hrm: async (args) => executeDomainWrite(client, WRITE_DOMAINS.hrm, args),
@@ -916,7 +924,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: moduleDefinition.name,
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildJxcSearchBody(args, moduleDefinition))
+                data: await client.read(targetPath, buildJxcSearchBody(args, moduleDefinition))
             };
         },
         crm_get_jxc_record: async (args) => {
@@ -928,7 +936,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: moduleDefinition.name,
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_jxc_record_information: async (args) => {
@@ -940,7 +948,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: moduleDefinition.name,
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_jxc_module_schema: async (args) => {
@@ -952,7 +960,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: moduleDefinition.name,
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ type: args.type }))
+                data: await client.read(targetPath, undefined, cleanQuery({ type: args.type }))
             };
         },
         crm_list_jxc_files: async (args) => {
@@ -963,7 +971,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: moduleDefinition.name,
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ id: requireJxcId(args, "查询 JXC 附件请提供 id。"), fileType: args.fileType }))
+                data: await client.read(targetPath, undefined, cleanQuery({ id: requireJxcId(args, "查询 JXC 附件请提供 id。"), fileType: args.fileType }))
             };
         },
         crm_list_jxc_stock_products: async (args) => {
@@ -973,7 +981,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品库存",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildJxcStockProductsBody(args))
+                data: await client.read(targetPath, buildJxcStockProductsBody(args))
             };
         },
         crm_get_jxc_product_inventory: async (args) => {
@@ -984,7 +992,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "产品库存",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, cleanQuery({ warehouseId: args.warehouseId }))
+                data: await client.read(targetPath, undefined, cleanQuery({ warehouseId: args.warehouseId }))
             };
         },
         crm_list_jxc_stock_movements: async (args) => {
@@ -994,7 +1002,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "出入库明细",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildJxcStockMovementsBody(args))
+                data: await client.read(targetPath, buildJxcStockMovementsBody(args))
             };
         },
         crm_get_jxc_warehouse_product_stock: async (args) => {
@@ -1004,7 +1012,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "仓库产品库存数量",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, requireWarehouseProductIdsMap(args))
+                data: await client.read(targetPath, requireWarehouseProductIdsMap(args))
             };
         },
         crm_get_jxc_warehouse_names: async (args) => {
@@ -1014,7 +1022,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "仓库",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, requireWarehouseIds(args))
+                data: await client.read(targetPath, requireWarehouseIds(args))
             };
         },
         crm_write_jxc: async (args) => executeDomainWrite(client, WRITE_DOMAINS.jxc, args),
@@ -1030,7 +1038,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: moduleDefinition.name,
                 targetPath,
                 body,
-                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+                data: await client.write(targetPath, body, cleanQuery(args.query ?? {}))
             };
         },
         crm_update_jxc_record: async (args) => {
@@ -1047,7 +1055,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: moduleDefinition.name,
                 targetPath,
                 body,
-                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+                data: await client.write(targetPath, body, cleanQuery(args.query ?? {}))
             };
         },
         crm_write_finance: async (args) => executeDomainWrite(client, WRITE_DOMAINS.finance, args),
@@ -1062,7 +1070,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "凭证",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+                data: await client.write(targetPath, body, cleanQuery(args.query ?? {}))
             };
         },
         crm_update_finance_voucher: async (args) => {
@@ -1076,18 +1084,18 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "凭证",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body, cleanQuery(args.query ?? {}))
+                data: await client.write(targetPath, body, cleanQuery(args.query ?? {}))
             };
         },
         crm_list_calendar_events: async (args) => ({
             module: "calendarEvent",
             targetPath: "/oaEvent/queryList",
-            data: await client.post("/oaEvent/queryList", buildCalendarListBody(args))
+            data: await client.read("/oaEvent/queryList", buildCalendarListBody(args))
         }),
         crm_get_calendar_event: async (args) => ({
             module: "calendarEvent",
             targetPath: "/oaEvent/queryById",
-            data: await client.post("/oaEvent/queryById", buildCalendarDetailBody(args))
+            data: await client.read("/oaEvent/queryById", buildCalendarDetailBody(args))
         }),
         crm_list_oa_announcements: async (args) => {
             const targetPath = "/oaAnnouncement/queryList";
@@ -1098,7 +1106,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 readonly: true,
                 targetPath,
                 query,
-                data: await client.post(targetPath, undefined, query)
+                data: await client.read(targetPath, undefined, query)
             };
         },
         crm_get_oa_announcement: async (args) => {
@@ -1109,7 +1117,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "公告",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_create_oa_announcement: async (args) => executeOaAnnouncementWrite(client, args, false),
@@ -1124,7 +1132,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "oaAnnouncement",
                 moduleName: "公告",
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.write(targetPath)
             };
         },
         crm_mark_oa_announcement_read: async (args) => {
@@ -1138,7 +1146,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "公告",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_list_oa_logs: async (args) => {
@@ -1148,7 +1156,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaLogListBody(args))
+                data: await client.read(targetPath, buildOaLogListBody(args))
             };
         },
         crm_get_oa_log: async (args) => {
@@ -1160,7 +1168,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 readonly: true,
                 targetPath,
                 query,
-                data: await client.post(targetPath, undefined, query)
+                data: await client.read(targetPath, undefined, query)
             };
         },
         crm_get_oa_log_information: async (args) => {
@@ -1171,7 +1179,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_list_oa_log_templates: async (args) => {
@@ -1181,7 +1189,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志模板",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaLogTemplateListBody(args))
+                data: await client.read(targetPath, buildOaLogTemplateListBody(args))
             };
         },
         crm_get_oa_log_fields: async (args) => {
@@ -1192,7 +1200,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志字段",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, undefined, buildOaLogFieldQuery(args))
+                data: await client.read(targetPath, undefined, buildOaLogFieldQuery(args))
             };
         },
         crm_get_oa_log_welcome: async () => {
@@ -1202,7 +1210,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志欢迎语",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_oa_log_bulletin: async () => {
@@ -1212,7 +1220,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志概要",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_oa_log_complete_stats: async (args) => {
@@ -1224,7 +1232,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 readonly: true,
                 targetPath,
                 query,
-                data: await client.post(targetPath, undefined, query)
+                data: await client.read(targetPath, undefined, query)
             };
         },
         crm_list_oa_log_complete_records: async (args) => {
@@ -1234,7 +1242,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志已完成列表",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaLogListBody(args))
+                data: await client.read(targetPath, buildOaLogListBody(args))
             };
         },
         crm_list_oa_log_incomplete_records: async (args) => {
@@ -1244,7 +1252,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志未完成列表",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaLogListBody(args))
+                data: await client.read(targetPath, buildOaLogListBody(args))
             };
         },
         crm_list_oa_examine_categories: async (args) => {
@@ -1254,7 +1262,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaExamineCategoryBody(args))
+                data: await client.read(targetPath, buildOaExamineCategoryBody(args))
             };
         },
         crm_list_oa_examine_groups: async (args) => {
@@ -1264,7 +1272,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaExamineGroupBody(args))
+                data: await client.read(targetPath, buildOaExamineGroupBody(args))
             };
         },
         crm_list_oa_examines: async (args) => {
@@ -1276,7 +1284,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 listType: listDefinition.key,
                 listName: listDefinition.name,
                 targetPath: listDefinition.targetPath,
-                data: await client.post(listDefinition.targetPath, buildOaExamineListBody(args))
+                data: await client.read(listDefinition.targetPath, buildOaExamineListBody(args))
             };
         },
         crm_get_oa_examine: async (args) => {
@@ -1287,7 +1295,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath)
+                data: await client.read(targetPath)
             };
         },
         crm_get_oa_examine_fields: async (args) => {
@@ -1300,7 +1308,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                     moduleName: "办公审批",
                     readonly: true,
                     targetPath,
-                    data: await client.post(targetPath, useListEndpoint ? undefined : buildOaExamineCreateFieldQuery(args, categoryId))
+                    data: await client.read(targetPath, useListEndpoint ? undefined : buildOaExamineCreateFieldQuery(args, categoryId))
                 };
             }
             const targetPath = "/oaExamine/getField";
@@ -1309,7 +1317,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaExamineFieldBody(args))
+                data: await client.read(targetPath, buildOaExamineFieldBody(args))
             };
         },
         crm_list_oa_examine_record_logs: async (args) => {
@@ -1319,7 +1327,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaExamineRecordLogBody(args))
+                data: await client.read(targetPath, buildOaExamineRecordLogBody(args))
             };
         },
         crm_list_oa_examine_flow_records: async (args) => {
@@ -1329,18 +1337,18 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 readonly: true,
                 targetPath,
-                data: await client.post(targetPath, buildOaExamineFlowRecordBody(args))
+                data: await client.read(targetPath, buildOaExamineFlowRecordBody(args))
             };
         },
         crm_list_oa_tasks: async (args) => ({
             module: "oaTask",
             targetPath: "/oaTask/queryTaskList",
-            data: await client.post("/oaTask/queryTaskList", buildOaTaskListBody(args))
+            data: await client.read("/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))
+            data: await client.read("/oaTask/queryTypeTaskList", undefined, buildRelatedOaTaskQuery(args))
         }),
         crm_preview_write: (args) => previewWrite(args),
         crm_update_customer: async (args) => {
@@ -1359,8 +1367,8 @@ export function createToolHandlers(config = {}, sharedClient) {
             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);
+            const data = await client.write(targetPath, body);
+            const verification = args.verify === false ? undefined : await verifyInformationUpdateSafely(client, moduleDefinition, body);
             return cleanObject({
                 module: moduleDefinition.key,
                 targetPath,
@@ -1377,10 +1385,16 @@ export function createToolHandlers(config = {}, sharedClient) {
             if (!args.confirm) {
                 return previewWrite({ ...args, operation: "create", targetPath });
             }
+            const body = buildModelSaveBody(args);
+            const businessSelection = moduleDefinition.key === "business"
+                ? await validateBusinessCreate(client, body)
+                : undefined;
             return {
                 module: moduleDefinition.key,
                 targetPath,
-                data: await client.post(targetPath, buildModelSaveBody(args))
+                body,
+                ...(businessSelection ? { businessSelection } : {}),
+                data: await client.write(targetPath, body)
             };
         },
         crm_update_record_fields: async (args) => {
@@ -1391,8 +1405,8 @@ export function createToolHandlers(config = {}, sharedClient) {
                 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);
+            const data = await client.write(targetPath, body);
+            const verification = args.verify === false ? undefined : await verifyInformationUpdateSafely(client, moduleDefinition, body);
             return {
                 module: moduleDefinition.key,
                 targetPath,
@@ -1411,8 +1425,8 @@ export function createToolHandlers(config = {}, sharedClient) {
                 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);
+            const data = await client.write(targetPath, body);
+            const verification = args.verify === false ? undefined : await verifyInformationUpdateSafely(client, moduleDefinition, body);
             return cleanObject({
                 module: "product",
                 moduleName: "产品",
@@ -1445,7 +1459,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "calendarEvent",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_update_calendar_event: async (args) => {
@@ -1458,7 +1472,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "calendarEvent",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_create_oa_log: async (args) => executeOaLogWrite(client, args, false),
@@ -1474,7 +1488,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志",
                 targetPath,
                 query,
-                data: await client.post(targetPath, undefined, query)
+                data: await client.write(targetPath, undefined, query)
             };
         },
         crm_toggle_oa_log_favour: async (args) => {
@@ -1488,7 +1502,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "日志",
                 targetPath,
                 query,
-                data: await client.post(targetPath, undefined, query)
+                data: await client.write(targetPath, undefined, query)
             };
         },
         crm_create_oa_examine: async (args) => {
@@ -1502,7 +1516,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_save_oa_examine_draft: async (args) => {
@@ -1516,7 +1530,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_audit_oa_examine: async (args) => {
@@ -1530,7 +1544,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_batch_audit_oa_examine: async (args) => {
@@ -1544,7 +1558,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 moduleName: "办公审批",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_create_oa_task: async (args) => {
@@ -1557,7 +1571,7 @@ export function createToolHandlers(config = {}, sharedClient) {
                 module: "oaTask",
                 targetPath,
                 body,
-                data: await client.post(targetPath, body)
+                data: await client.write(targetPath, body)
             };
         },
         crm_update_oa_task_fields: async (args) => {
@@ -1576,7 +1590,7 @@ export function createToolHandlers(config = {}, sharedClient) {
             for (const call of calls) {
                 results.push({
                     targetPath: call.targetPath,
-                    data: await client.post(call.targetPath, call.body)
+                    data: await client.write(call.targetPath, call.body)
                 });
             }
             return {
@@ -1589,10 +1603,14 @@ export function createToolHandlers(config = {}, sharedClient) {
             if (!args.confirm) {
                 return previewWrite({ ...args, operation: "addFollowup", targetPath });
             }
+            const body = buildFollowupSaveBody(args);
+            const target = await validateAndReadFollowupTarget(client, body, false);
             return {
                 module: "activity",
                 targetPath,
-                data: await client.post(targetPath, buildFollowupSaveBody(args))
+                target,
+                body,
+                data: await client.write(targetPath, body)
             };
         },
         crm_update_followup: async (args) => {
@@ -1603,10 +1621,20 @@ export function createToolHandlers(config = {}, sharedClient) {
             const body = args.useInformationUpdate
                 ? cleanObject({ id: args.id, label: 19, list: args.list ?? args.fields ?? [], batchId: args.batchId })
                 : buildFollowupSaveBody(args);
+            if (args.useInformationUpdate) {
+                requireRecordId(args.id, "更新跟进记录字段必须提供 id。");
+                if (!Array.isArray(body.list) || body.list.length === 0) {
+                    throw new Error("更新跟进记录字段必须提供非空 list。");
+                }
+            }
+            else {
+                await validateAndReadFollowupTarget(client, body, true);
+            }
             return {
                 module: "activity",
                 targetPath,
-                data: await client.post(targetPath, body)
+                body,
+                data: await client.write(targetPath, body)
             };
         },
         workorder_search_records: async (args) => searchWorkorders(client, args),
@@ -1639,7 +1667,7 @@ async function searchWorkorders(client, args) {
         scope,
         readonly: true,
         targetPath,
-        data: await client.post(targetPath, body)
+        data: await client.read(targetPath, body)
     };
 }
 async function getWorkorder(client, args) {
@@ -1647,8 +1675,8 @@ async function getWorkorder(client, args) {
     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}`)
+        client.read(`${prefix}/queryById/${id}`),
+        client.read(`${prefix}/information/${id}`)
     ]);
     return {
         module: "workorder",
@@ -1667,7 +1695,7 @@ async function getWorkorderSchema(client, args) {
         scope,
         readonly: true,
         targetPath: `${prefix}/field${id}`,
-        fields: await client.post(`${prefix}/field${id}`, cleanObject({ templateId: args.templateId }))
+        fields: await client.read(`${prefix}/field${id}`, cleanObject({ templateId: args.templateId }))
     };
 }
 function previewWorkorderWrite(args) {
@@ -1688,11 +1716,14 @@ async function saveWorkorder(client, args, update) {
             ...prepared
         };
     }
-    const data = await client.post(prepared.targetPath, prepared.body);
+    const data = await client.write(prepared.targetPath, prepared.body);
     const id = extractSavedWorkorderId(data, prepared);
     const verification = id
-        ? await getWorkorder(client, { scope: prepared.scope, id })
-        : { ok: false, message: "服务端未返回工单 ID，请使用列表查询核对写入结果。" };
+        ? await verifyWorkorderWriteSafely(client, prepared.scope, id)
+        : {
+            status: "unknown",
+            message: "写入已成功，但服务端未返回工单 ID；请稍后使用只读列表查询确认记录。"
+        };
     return {
         preview: false,
         scope: prepared.scope,
@@ -1701,6 +1732,19 @@ async function saveWorkorder(client, args, update) {
         verification
     };
 }
+async function verifyWorkorderWriteSafely(client, scope, id) {
+    try {
+        return {
+            status: "confirmed",
+            ok: true,
+            ...await getWorkorder(client, { scope, id })
+        };
+    }
+    catch (error) {
+        // 写接口已经 code=0 后，回读异常只能说明验证状态未知，不能推翻服务端确认的写入结果。
+        return verificationUnavailable(`/${scope === "offline" ? "wkoOfflineWorkorder" : "wkoWorkorder"}/queryById/${id}`, error);
+    }
+}
 function prepareWorkorderWrite(args, update) {
     const scope = normalizeWorkorderScope(args.scope, false);
     if (scope === "offline") {
@@ -2267,7 +2311,7 @@ function looksLikeFieldName(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 }));
+    const data = await client.read(path, undefined, cleanQuery({ type: args.type, poolId: args.poolId }));
     return flattenFieldDefinitions(data);
 }
 function flattenFieldDefinitions(input) {
@@ -2336,7 +2380,7 @@ 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}`);
+    const data = await client.read(`${moduleDefinition.basePath}/queryById/${body.id}`);
     return findFirstValueByKey(data, "batchId");
 }
 function updateNeedsBatchId(list) {
@@ -2429,7 +2473,7 @@ function parseFieldOptions(input) {
 }
 async function verifyInformationUpdate(client, moduleDefinition, body) {
     const endpoint = `${moduleDefinition.basePath}/information/${body.id}`;
-    const data = await client.post(endpoint);
+    const data = await client.read(endpoint);
     const checked = (body.list ?? []).map((item) => {
         const actualValue = findInformationValue(data, item);
         return {
@@ -2440,12 +2484,34 @@ async function verifyInformationUpdate(client, moduleDefinition, body) {
             matched: valuesMatch(item.value, actualValue)
         };
     });
+    const ok = checked.every((item) => item.matched);
     return {
         endpoint,
-        ok: checked.every((item) => item.matched),
+        status: ok ? "confirmed" : "mismatch",
+        ok,
         checked
     };
 }
+async function verifyInformationUpdateSafely(client, moduleDefinition, body) {
+    try {
+        return await verifyInformationUpdate(client, moduleDefinition, body);
+    }
+    catch (error) {
+        // updateInformation 已被旧 CRM 以 code=0 接受；后续只读验证失败时禁止把成功写入改判为失败。
+        return verificationUnavailable(`${moduleDefinition.basePath}/information/${body.id}`, error);
+    }
+}
+function verificationUnavailable(endpoint, error) {
+    return {
+        endpoint,
+        status: "unknown",
+        message: "写入已成功，但后续回读失败；请稍后使用只读查询确认目标记录，禁止直接重放写请求。",
+        error: {
+            name: error instanceof Error ? error.name : "Error",
+            message: error instanceof Error ? error.message : String(error)
+        }
+    };
+}
 function findInformationValue(data, field) {
     const direct = findDirectInformationValue(data, field);
     if (direct.found) {
@@ -2522,7 +2588,7 @@ 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 pools = await client.read("/crmCustomerPool/queryPoolNameListByAuth");
     const poolList = Array.isArray(pools) ? pools : [];
     const includeSamples = Boolean(args.includeSamples);
     const limit = includeSamples ? positiveInteger(args.sampleLimit ?? args.limit, 3) : 1;
@@ -2583,7 +2649,7 @@ async function resolvePoolContext(client, moduleDefinition, args) {
     if (args.poolId) {
         return { poolId: args.poolId, pool: cleanObject({ poolId: args.poolId, poolName: args.poolName }) };
     }
-    const pools = await client.post(`${moduleDefinition.basePath}/queryPoolNameListByAuth`);
+    const pools = await client.read(`${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())
@@ -2601,22 +2667,22 @@ 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) };
+        return { module: moduleDefinition.key, relation, data: await client.read("/crmBusiness/queryProduct", pageBody) };
     }
     if (moduleDefinition.key === "business" && relation === "contacts") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmBusiness/queryContacts", pageBody) };
+        return { module: moduleDefinition.key, relation, data: await client.read("/crmBusiness/queryContacts", pageBody) };
     }
     if (moduleDefinition.key === "contacts" && relation === "business") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmContacts/queryBusiness", pageBody) };
+        return { module: moduleDefinition.key, relation, data: await client.read("/crmContacts/queryBusiness", pageBody) };
     }
     if (moduleDefinition.key === "contract" && relation === "product") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmContract/queryProductListByContractId", pageBody) };
+        return { module: moduleDefinition.key, relation, data: await client.read("/crmContract/queryProductListByContractId", pageBody) };
     }
     if (moduleDefinition.key === "contract" && relation === "receivablesPlan") {
         return {
             module: moduleDefinition.key,
             relation,
-            data: await client.post("/crmContract/queryReceivablesPlansByContractId", undefined, {
+            data: await client.read("/crmContract/queryReceivablesPlansByContractId", undefined, {
                 contractId: args.id,
                 receivablesId: args.receivablesId,
                 productId: args.productId
@@ -2624,16 +2690,16 @@ async function callRelatedRecords(client, moduleDefinition, args) {
         };
     }
     if (moduleDefinition.key === "receivables" && relation === "product") {
-        return { module: moduleDefinition.key, relation, data: await client.post(`/crmReceivables/queryProductList/${args.id}`) };
+        return { module: moduleDefinition.key, relation, data: await client.read(`/crmReceivables/queryProductList/${args.id}`) };
     }
     if (moduleDefinition.key === "quotation" && relation === "product") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmQuotation/queryProductList", pageBody) };
+        return { module: moduleDefinition.key, relation, data: await client.read("/crmQuotation/queryProductList", pageBody) };
     }
     if (moduleDefinition.key === "product" && relation === "saleProduct") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmProduct/querySaleProductPageList", pageBody) };
+        return { module: moduleDefinition.key, relation, data: await client.read("/crmProduct/querySaleProductPageList", pageBody) };
     }
     if (moduleDefinition.key === "receivablesPlan" && relation === "contractCustomer") {
-        return { module: moduleDefinition.key, relation, data: await client.post("/crmReceivablesPlan/queryByContractAndCustomer", pageBody) };
+        return { module: moduleDefinition.key, relation, data: await client.read("/crmReceivablesPlan/queryByContractAndCustomer", pageBody) };
     }
     throw new Error(`当前 MCP 未配置“${moduleDefinition.name} / ${relation}”关联查询白名单。`);
 }
@@ -2865,7 +2931,7 @@ async function executeDomainWrite(client, domain, args) {
         targetPath,
         body,
         query: Object.keys(query).length > 0 ? query : undefined,
-        data: await client.post(targetPath, body, query)
+        data: await client.write(targetPath, body, query)
     });
 }
 function previewDomainWrite(domain, targetPath, body, query) {
@@ -3033,7 +3099,7 @@ async function executeCrmProductSave(client, args, requireId) {
         moduleName: "产品",
         targetPath,
         body,
-        data: await client.post(targetPath, body)
+        data: await client.write(targetPath, body)
     };
 }
 function buildCrmProductSaveBody(args, requireId) {
@@ -3076,7 +3142,7 @@ async function executeCrmProductSimpleWrite(client, args, operation, targetPath,
         moduleName: "产品",
         targetPath,
         body,
-        data: await client.post(targetPath, body)
+        data: await client.write(targetPath, body)
     };
 }
 function buildCrmProductStatusBody(args) {
@@ -3140,7 +3206,7 @@ async function executeOaAnnouncementWrite(client, args, requireId) {
         moduleName: "公告",
         targetPath,
         body,
-        data: await client.post(targetPath, body)
+        data: await client.write(targetPath, body)
     };
 }
 function buildOaAnnouncementBody(args, requireId) {
@@ -3216,7 +3282,7 @@ async function executeOaLogWrite(client, args, requireId) {
         moduleName: "日志",
         targetPath,
         body,
-        data: await client.post(targetPath, body)
+        data: await client.write(targetPath, body)
     };
 }
 async function buildOaLogWriteBody(client, args, requireId) {
@@ -3233,7 +3299,7 @@ async function buildOaLogWriteBody(client, args, requireId) {
     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 fieldMetadata = await client.read(targetPath, undefined, buildOaLogFieldQuery(args));
         const fields = flattenOaExamineFields(fieldMetadata);
         const fieldValues = normalizeFieldValues(fieldValuesInput);
         for (const [rawKey, rawValue] of Object.entries(fieldValues)) {
@@ -3336,7 +3402,7 @@ async function executeCrmDocumentWrite(client, moduleKey, args, requireId) {
         targetPath,
         body,
         approvalNotice,
-        data: await client.post(targetPath, body)
+        data: await client.write(targetPath, body)
     });
 }
 function getCrmDocumentWriteDefinition(moduleKey) {
@@ -3383,7 +3449,7 @@ async function buildStructuredCrmDocumentBody(client, definition, args, requireI
     }
     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 fieldMetadata = await client.read(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} 字段，无法自动组装单据字段。`);
@@ -3721,7 +3787,7 @@ async function buildStructuredOaExamineWriteBody(client, args, examineId) {
         throw new Error("自动组装 OA 审批自定义字段请提供 categoryId。");
     }
     const targetPath = `/oaExamineField/queryField/${categoryId}`;
-    const fieldMetadata = await client.post(targetPath, buildOaExamineCreateFieldQuery(args, categoryId));
+    const fieldMetadata = await client.read(targetPath, buildOaExamineCreateFieldQuery(args, categoryId));
     const fields = flattenOaExamineFields(fieldMetadata);
     if (fields.length === 0) {
         throw new Error(`未从 ${targetPath} 读取到 OA 审批字段，无法自动组装自定义字段。`);
@@ -4341,7 +4407,13 @@ function buildModelSaveBody(args) {
         saveType: args.saveType,
         fileId: args.fileId,
         aiAnalysis: args.aiAnalysis,
-        member: args.member
+        member: args.member,
+        // 这些字段属于 CrmBusinessSaveBO 顶层，放进 entity 或静默丢弃都会让后端保存链路异常。
+        product: args.product,
+        contactsId: args.contactsId,
+        customerSuperior: args.customerSuperior,
+        contacts: args.contacts,
+        examineFlowData: args.examineFlowData
     });
 }
 function buildFollowupSaveBody(args) {
@@ -4350,6 +4422,9 @@ function buildFollowupSaveBody(args) {
         ? body.entity
         : {};
     const entity = { ...sourceEntity };
+    if (args.id !== undefined && entity.id === undefined) {
+        entity.id = args.id;
+    }
     if (!Array.isArray(entity.relateDataList)) {
         entity.relateDataList = [];
     }
@@ -4358,6 +4433,112 @@ function buildFollowupSaveBody(args) {
         entity
     };
 }
+async function validateBusinessCreate(client, body) {
+    const entity = objectValue(body.entity, "新增商机必须提供 entity 对象。");
+    requireNonBlankText(entity.businessName, "新增商机缺少 entity.businessName。请先补充商机名称。");
+    requireRecordId(entity.customerId, "新增商机缺少 entity.customerId。请先查询并唯一确定客户 ID。");
+    const groups = await loadBusinessStatusGroups(client);
+    const typeId = optionalRecordId(entity.typeId);
+    const statusId = optionalRecordId(entity.statusId);
+    if (!typeId || !statusId) {
+        throw new Error("新增商机缺少合法的 entity.typeId/statusId。请从 crm_get_business_status_groups 的同一状态组中选择，"
+            + `当前可选值：${formatBusinessStatusGroups(groups)}`);
+    }
+    const group = groups.find((item) => optionalRecordId(item.flowId) === typeId);
+    const setting = Array.isArray(group?.settingList)
+        ? group.settingList.find((item) => optionalRecordId(item?.settingId) === statusId)
+        : undefined;
+    if (!group || !setting) {
+        throw new Error(`商机阶段组合无效：typeId=${typeId}, statusId=${statusId}。`
+            + `typeId 必须是状态组 flowId，statusId 必须来自该组 settingList；当前可选值：${formatBusinessStatusGroups(groups)}`);
+    }
+    return cleanObject({
+        typeId,
+        statusId,
+        flowName: typeof group.flowName === "string" ? group.flowName : undefined,
+        settingName: typeof setting.settingName === "string" ? setting.settingName : undefined
+    });
+}
+async function loadBusinessStatusGroups(client) {
+    const data = await client.post("/crmFlow/queryBusinessSetting");
+    if (!Array.isArray(data) || data.length === 0) {
+        throw new Error("当前账号没有可用的商机状态组，无法创建商机；请先在 CRM 中启用状态组或检查数据权限。");
+    }
+    return data.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item));
+}
+function formatBusinessStatusGroups(groups) {
+    return groups.slice(0, 10).map((group) => {
+        const stages = Array.isArray(group.settingList)
+            ? group.settingList.slice(0, 10).map((item) => `${item?.settingName ?? "未命名阶段"}(statusId=${item?.settingId ?? "?"})`).join("、")
+            : "无阶段";
+        return `${group.flowName ?? "未命名状态组"}(typeId=${group.flowId ?? "?"})[${stages}]`;
+    }).join("；");
+}
+const FOLLOWUP_TARGETS = new Map([
+    [1, "leads"],
+    [2, "customer"],
+    [3, "contacts"],
+    [4, "product"],
+    [5, "business"],
+    [6, "contract"],
+    [7, "receivables"],
+    [14, "receivablesPlan"],
+    [17, "returnVisit"],
+    [18, "invoice"],
+    [22, "quotation"]
+]);
+async function validateAndReadFollowupTarget(client, body, requireActivityId) {
+    const entity = objectValue(body.entity, "跟进记录必须提供 entity 对象。");
+    if (requireActivityId) {
+        requireRecordId(entity.id, "更新跟进记录必须提供 id 或 entity.id。");
+    }
+    requireNonBlankText(entity.content, "跟进记录缺少 entity.content，内容不能为空。");
+    requireNonBlankText(entity.category, "跟进记录缺少 entity.category，跟进方式不能为空。");
+    const activityType = typeof entity.activityType === "number"
+        ? entity.activityType
+        : Number(entity.activityType);
+    const moduleKey = FOLLOWUP_TARGETS.get(activityType);
+    if (!moduleKey) {
+        throw new Error("跟进记录 entity.activityType 无效；支持 1线索、2客户、3联系人、4产品、5商机、6合同、"
+            + "7回款、14回款计划、17回访、18发票、22报价单。");
+    }
+    const targetId = requireRecordId(entity.activityTypeId, "跟进记录缺少 entity.activityTypeId，请先查询并唯一确定被跟进记录 ID。");
+    const definition = getModuleByKey(moduleKey);
+    // 先回读目标，避免无权限、已删除或类型与 ID 不匹配时落到后端空指针兜底。
+    await client.read(`${definition.basePath}/queryById/${targetId}`);
+    return { module: moduleKey, id: targetId, readbackVerified: true };
+}
+function objectValue(value, message) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(message);
+    }
+    return value;
+}
+function requireNonBlankText(value, message) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(message);
+    }
+    return value;
+}
+function optionalRecordId(value) {
+    if (typeof value === "bigint" && value > 0n) {
+        return value.toString();
+    }
+    if (typeof value === "number" && Number.isSafeInteger(value) && value > 0) {
+        return String(value);
+    }
+    if (typeof value === "string" && /^[1-9]\d*$/.test(value.trim())) {
+        return value.trim();
+    }
+    return undefined;
+}
+function requireRecordId(value, message) {
+    const id = optionalRecordId(value);
+    if (!id) {
+        throw new Error(message);
+    }
+    return id;
+}
 function cleanQuery(input) {
     return cleanObject(input);
 }