kece-skill-mcp 0.0.0-stage → 1.2.0

package/dist/auth.d.ts

@@ -0,0 +1,5 @@
+import type { Config } from "./config.js";
+export declare function md5(content: string): string;
+export declare function aesEncrypt(plainText: string, appSecret: string): string;
+export type AuthHeaders = Record<string, string>;
+export declare function buildAuthHeaders(body: string, config: Config): AuthHeaders;

package/dist/auth.js

@@ -0,0 +1,27 @@
+import { createHash, createCipheriv } from "crypto";
+export function md5(content) {
+    return createHash("md5").update(content, "utf-8").digest("hex");
+}
+function deriveAesKey(appSecret) {
+    const sha1Pass1 = createHash("sha1").update(appSecret, "utf-8").digest();
+    const sha1Pass2 = createHash("sha1").update(sha1Pass1).digest();
+    return sha1Pass2.subarray(0, 16);
+}
+export function aesEncrypt(plainText, appSecret) {
+    const keyBuffer = deriveAesKey(appSecret);
+    const cipher = createCipheriv("aes-128-ecb", keyBuffer, null);
+    cipher.setAutoPadding(true);
+    return cipher.update(plainText, "utf-8", "hex") + cipher.final("hex");
+}
+export function buildAuthHeaders(body, config) {
+    const sign = md5(body);
+    const curtime = Math.floor(Date.now() / 1000).toString();
+    const checksum = aesEncrypt(config.appKey + sign + curtime, config.appSecret);
+    return {
+        "ur-appkey": config.appKey,
+        "ur-sign": sign,
+        "ur-curtime": curtime,
+        "ur-checksum": checksum,
+        "Content-Type": "application/json;charset=utf-8",
+    };
+}

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from "./config.js";
+export declare class KeceClient {
+    private config;
+    constructor(config: Config);
+    request<T = any>(path: string, body: Record<string, any>): Promise<T>;
+}

package/dist/client.js

@@ -0,0 +1,25 @@
+import { buildAuthHeaders } from "./auth.js";
+export class KeceClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async request(path, body) {
+        const bodyStr = JSON.stringify(body);
+        const headers = buildAuthHeaders(bodyStr, this.config);
+        const url = `${this.config.baseUrl}${path}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: bodyStr,
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${await response.text()}`);
+        }
+        const result = await response.json();
+        if (result.code && String(result.code) !== "200") {
+            throw new Error(`API错误 [${result.code}]: ${result.msg || "未知错误"}`);
+        }
+        return result;
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export interface Config {
+    appKey: string;
+    appSecret: string;
+    baseUrl: string;
+}
+export declare function getConfig(): Config;

package/dist/config.js

@@ -0,0 +1,30 @@
+import { readFileSync } from "fs";
+import { resolve } from "path";
+function loadEnv() {
+    const envVars = {};
+    try {
+        const envPath = resolve(import.meta.dirname, "../.env");
+        const content = readFileSync(envPath, "utf-8");
+        for (const line of content.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eqIdx = trimmed.indexOf("=");
+            if (eqIdx === -1)
+                continue;
+            envVars[trimmed.slice(0, eqIdx)] = trimmed.slice(eqIdx + 1);
+        }
+    }
+    catch { }
+    return envVars;
+}
+export function getConfig() {
+    const env = { ...loadEnv(), ...process.env };
+    const appKey = env.KECE_APP_KEY;
+    const appSecret = env.KECE_APP_SECRET;
+    const baseUrl = env.KECE_BASE_URL || "https://huke.163.com";
+    if (!appKey || !appSecret) {
+        throw new Error("缺少 KECE_APP_KEY 或 KECE_APP_SECRET 配置");
+    }
+    return { appKey, appSecret, baseUrl };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { getConfig } from "./config.js";
+import { KeceClient } from "./client.js";
+import { queryCustomerSchema, queryCustomer } from "./tools/customer-query.js";
+import { searchCustomersSchema, searchCustomers } from "./tools/customer-search.js";
+import { updateCustomerTagSchema, updateCustomerTag, batchUpdateTagSchema, batchUpdateCustomerTag } from "./tools/customer-tag.js";
+import { createMassSendSchema, createMassSend } from "./tools/mass-send.js";
+import { getCustomerFieldsSchema, getCustomerFields, listStaffSchema, listStaff, listSegmentsSchema, listSegments, createSegmentSchema, createSegment, importSegmentSchema, importSegment, listMassSendTasksSchema, listMassSendTasks, } from "./tools/helpers.js";
+import { resolveIdsSchema, resolveIds } from "./tools/resolve-ids.js";
+import { listCustomersSchema, listCustomers } from "./tools/customer-list.js";
+import { accountHealthCheckSchema, accountHealthCheck } from "./tools/health-check.js";
+let client;
+try {
+    client = new KeceClient(getConfig());
+}
+catch (err) {
+    console.error(`[kece-skill-mcp] 启动失败：${err?.message || err}`);
+    console.error("[kece-skill-mcp] 请在 WorkBuddy 连接器设置中填写 AppKey 与 AppSecret。");
+    process.exit(1);
+}
+const server = new McpServer({
+    name: "kece-scrm-skill",
+    version: "1.2.0",
+});
+function safeTool(fn) {
+    return async (params) => {
+        try {
+            const result = await fn(params);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            const msg = err?.message || String(err);
+            let hint = "";
+            if (msg.includes("1014") || msg.includes("认证失败")) {
+                hint = "\n\n请检查 AppKey 和 AppSecret 是否正确。获取路径：科策后台 → 设置 → 系统对接 → API对接";
+            }
+            else if (msg.includes("1003") || msg.includes("无权限")) {
+                hint = "\n\n当前 API 账号无此操作权限，请联系管理员。";
+            }
+            else if (msg.includes("1009") || msg.includes("缺少参数")) {
+                hint = "\n\n请补充必要参数后重试。";
+            }
+            else if (msg.includes("fetch") || msg.includes("ECONNREFUSED") || msg.includes("ETIMEDOUT")) {
+                hint = "\n\n无法连接科策服务器，请检查网络或稍后重试。";
+            }
+            return { content: [{ type: "text", text: `调用失败：${msg}${hint}` }] };
+        }
+    };
+}
+// ===== Skill 1: 查客户 =====
+server.tool("query_customer", "查询客户详情。支持通过手机号、姓名、微信号、邮箱、CID、公司名称查询客户信息。", queryCustomerSchema.shape, safeTool((params) => queryCustomer(client, params)));
+// ===== Skill 3: 圈人 =====
+server.tool("search_customers", "条件筛选客户（圈人）。支持按标签、手机号、客层等条件筛选客户，返回符合条件的客户列表和总数。用于人群圈选。", searchCustomersSchema.shape, safeTool((params) => searchCustomers(client, params)));
+// ===== Skill 2: 打标签 =====
+server.tool("update_customer_tag", "为单个客户添加或移除标签。需要先通过 get_customer_fields 获取标签组ID和标签ID。", updateCustomerTagSchema.shape, safeTool((params) => updateCustomerTag(client, params)));
+server.tool("batch_update_tag", "批量为多个客户添加或移除标签。传入客户ID列表，并发执行。超过10人时建议先确认。", batchUpdateTagSchema.shape, safeTool((params) => batchUpdateCustomerTag(client, params)));
+// ===== Skill 4: 群发 =====
+server.tool("create_mass_send", "创建企微客户群发任务。基于筛选条件圈选目标客户并发送消息。所有群发操作必须经用户确认后执行。", createMassSendSchema.shape, safeTool((params) => createMassSend(client, params)));
+// ===== 辅助工具 =====
+server.tool("get_customer_fields", "获取所有客户字段定义，包括标签组及选项。用于将标签名称转换为标签ID，是打标签和圈人的前置查询。", getCustomerFieldsSchema.shape, safeTool(() => getCustomerFields(client)));
+server.tool("list_staff", "查询企业员工列表，返回 accid、姓名、角色、部门。用于群发时获取发送人 accid 列表。", listStaffSchema.shape, safeTool((params) => listStaff(client, params)));
+server.tool("list_segments", "查询人群包列表。支持按关键词搜索。用于查看已有人群包或获取人群包ID。", listSegmentsSchema.shape, safeTool((params) => listSegments(client, params)));
+server.tool("create_segment", "创建一个新的导入型人群包。创建后可通过 import_segment 导入用户。", createSegmentSchema.shape, safeTool((params) => createSegment(client, params)));
+server.tool("import_segment", "将客户ID列表导入到指定人群包。配合 search_customers 获取的 cid 和 create_segment 创建的人群包使用。", importSegmentSchema.shape, safeTool((params) => importSegment(client, params)));
+server.tool("list_mass_send_tasks", "查询群发任务列表，了解最近群发的执行状态。", listMassSendTasksSchema.shape, safeTool((params) => listMassSendTasks(client, params)));
+// ===== 全量客户检索 =====
+server.tool("list_customers", "查询全量客户。不带任何筛选条件时返回客户总数（回答「我们一共多少客户」）；可按时间范围、跟进人筛选，或分页拉取客户明细。与 search_customers 的区别：本工具面向全量客户池，不依赖人群包或标签圈选。", listCustomersSchema.shape, safeTool((params) => listCustomers(client, params)));
+// ===== 账号体检 =====
+server.tool("account_health_check", "生成账号体检报告：客户资产、员工维度、社群维度、获客资产、运营动作、转化六个维度的统计报表。一次调用返回 Markdown 报表，适合回答「账号体检」「私域盘点」「最近整体运营情况如何」。", accountHealthCheckSchema.shape, safeTool((params) => accountHealthCheck(client, params)));
+// ===== ID 映射（科策 × 数数打通） =====
+server.tool("resolve_ids", "双向转换游戏账号ID(数数#account_id)与科策客户ID(cid)。用于科策与数数ThinkingData之间的用户身份打通。需要先通过 get_customer_fields 确认存储游戏账号ID的字段。", resolveIdsSchema.shape, safeTool((params) => resolveIds(client, params)));
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/dist/tools/customer-list.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import type { KeceClient } from "../client.js";
+export declare const listCustomersSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["count", "list"]>>>;
+    days: z.ZodOptional<z.ZodNumber>;
+    startTime: z.ZodOptional<z.ZodNumber>;
+    endTime: z.ZodOptional<z.ZodNumber>;
+    follower: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    pageSize: number;
+    mode: "count" | "list";
+    days?: number | undefined;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+    follower?: string[] | undefined;
+}, {
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    mode?: "count" | "list" | undefined;
+    days?: number | undefined;
+    startTime?: number | undefined;
+    endTime?: number | undefined;
+    follower?: string[] | undefined;
+}>;
+export declare function listCustomers(client: KeceClient, params: z.infer<typeof listCustomersSchema>): Promise<{
+    mode: string;
+    period: string;
+    total: any;
+} | {
+    page: number;
+    pageSize: number;
+    customers: any;
+    mode: "count" | "list";
+    period: string;
+    total: any;
+}>;

package/dist/tools/customer-list.js

@@ -0,0 +1,138 @@
+import { z } from "zod";
+export const listCustomersSchema = z.object({
+    mode: z
+        .enum(["count", "list"])
+        .optional()
+        .default("count")
+        .describe("count=只返回客户总数；list=返回分页客户明细"),
+    days: z
+        .number()
+        .int()
+        .min(1)
+        .max(3650)
+        .optional()
+        .describe("统计最近 N 天内进入客户池的客户，与 startTime/endTime 二选一"),
+    startTime: z.number().optional().describe("起始时间，毫秒时间戳"),
+    endTime: z.number().optional().describe("结束时间，毫秒时间戳，默认当前时间"),
+    follower: z.array(z.string()).optional().describe("按跟进人 accid 过滤"),
+    page: z.number().int().min(1).optional().default(1).describe("页码（mode=list 时生效）"),
+    pageSize: z.number().int().min(1).max(100).optional().default(20).describe("每页数量，最大 100"),
+});
+// customer/list 在 startTime=0 时会返回 1010 error param，必须给一个非零起点
+const EARLIEST = 946684800000; // 2000-01-01
+export async function listCustomers(client, params) {
+    const now = Date.now();
+    const hasFilter = params.days !== undefined ||
+        params.startTime !== undefined ||
+        params.endTime !== undefined ||
+        (params.follower && params.follower.length > 0);
+    // 无任何筛选条件的全量总数走 customer/search，最快（实测与 customer/list 结果一致）
+    if (params.mode === "count" && !hasFilter) {
+        const result = await client.request("/openapi/customer/search", {
+            customerType: 1,
+            page: 1,
+            pageSize: 1,
+        });
+        const data = unwrap(result);
+        return {
+            mode: "count",
+            period: "全部",
+            total: data.total || 0,
+        };
+    }
+    const { startTime, endTime, period } = resolveRange(params, now);
+    const body = {
+        startTime,
+        endTime,
+        page: params.mode === "list" ? params.page : 1,
+        pageSize: params.mode === "list" ? params.pageSize : 1,
+    };
+    if (params.follower && params.follower.length > 0)
+        body.follower = params.follower;
+    const result = await client.request("/openapi/customer/list", body);
+    const data = unwrap(result);
+    const base = {
+        mode: params.mode,
+        period,
+        total: data.total || 0,
+    };
+    if (params.mode === "count")
+        return base;
+    const list = data.customerList || [];
+    return {
+        ...base,
+        page: params.page,
+        pageSize: params.pageSize,
+        customers: list.map((c) => {
+            const name = findField(c.customFields, -2);
+            const mobile = findField(c.customFields, -3);
+            return {
+                cid: c.cid,
+                name: name || "未填写",
+                mobile: maskPhone(mobile),
+                follower: c.follower || "",
+                status: formatStatus(c.status),
+                entryTime: fmtTime(c.entryTime),
+            };
+        }),
+    };
+}
+function unwrap(result) {
+    if (result?.data && typeof result.data === "object" && result.data.total !== undefined) {
+        return result.data;
+    }
+    return result || {};
+}
+function resolveRange(params, now) {
+    const endTime = params.endTime ?? now;
+    let startTime;
+    if (params.startTime !== undefined) {
+        startTime = params.startTime;
+    }
+    else if (params.days !== undefined) {
+        startTime = endTime - params.days * 86400000;
+    }
+    else {
+        startTime = EARLIEST;
+    }
+    if (startTime < EARLIEST)
+        startTime = EARLIEST;
+    const label = params.days !== undefined
+        ? `近 ${params.days} 天`
+        : `${fmtTime(startTime)} ~ ${fmtTime(endTime)}`;
+    return { startTime, endTime, period: label };
+}
+function findField(fields, id) {
+    if (!Array.isArray(fields))
+        return "";
+    const hit = fields.find((f) => Number(f.id) === id);
+    return hit?.fieldValue ?? "";
+}
+function maskPhone(phone) {
+    if (!phone)
+        return "";
+    if (phone.length < 7)
+        return phone;
+    return phone.slice(0, 3) + "****" + phone.slice(-4);
+}
+function fmtTime(ms) {
+    if (!ms)
+        return "";
+    const d = new Date(ms);
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+function formatStatus(status) {
+    const map = {
+        0: "未入池",
+        4: "待分配潜客",
+        8: "跟进中潜客",
+        9: "公海潜客",
+        5: "待分配",
+        6: "跟进中",
+        7: "公海",
+        2: "已删除",
+        3: "已合并",
+    };
+    return map[status] || `状态${status}`;
+}

package/dist/tools/customer-query.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import type { KeceClient } from "../client.js";
+export declare const queryCustomerSchema: z.ZodObject<{
+    type: z.ZodEnum<["phone", "wechat", "email", "cid", "name", "company"]>;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "phone" | "wechat" | "email" | "cid" | "name" | "company";
+    value: string;
+}, {
+    type: "phone" | "wechat" | "email" | "cid" | "name" | "company";
+    value: string;
+}>;
+export declare function queryCustomer(client: KeceClient, params: z.infer<typeof queryCustomerSchema>): Promise<{
+    found: boolean;
+    message: string;
+    total?: undefined;
+    customers?: undefined;
+} | {
+    found: boolean;
+    total: any;
+    customers: any;
+    message?: undefined;
+}>;

package/dist/tools/customer-query.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+export const queryCustomerSchema = z.object({
+    type: z
+        .enum(["phone", "wechat", "email", "cid", "name", "company"])
+        .describe("查询类型：phone=手机号, wechat=微信号, email=邮箱, cid=客户ID, name=姓名, company=公司名称"),
+    value: z.string().describe("查询值，如手机号、姓名等"),
+});
+const TYPE_MAP = {
+    phone: 0,
+    wechat: 1,
+    email: 2,
+    cid: 3,
+    name: 5,
+    company: 6,
+};
+export async function queryCustomer(client, params) {
+    const result = await client.request("/openapi/customer/query", {
+        type: TYPE_MAP[params.type],
+        targets: [params.value],
+    });
+    const customers = result.data || [];
+    if (customers.length === 0) {
+        return { found: false, message: "未找到匹配的客户，请确认信息是否正确" };
+    }
+    const formatted = customers.map((c) => ({
+        cid: c.cid,
+        name: getFieldValue(c.customFields, -2),
+        phone: maskPhone(getFieldValue(c.customFields, -3)),
+        wechatNick: getFieldValue(c.customFields, -6),
+        email: getFieldValue(c.customFields, -4),
+        follower: c.followerNick || c.follower,
+        status: formatStatus(c.status),
+        tags: c.customFields
+            ?.filter((f) => f.type === 4 || f.type === 5 || f.type === 11)
+            .map((f) => ({ name: f.name, value: f.fieldValue })) || [],
+        createTime: formatTime(c.createTime),
+        entryTime: formatTime(c.entryTime),
+        lastActivity: formatTime(c.updateTime),
+    }));
+    return {
+        found: true,
+        total: customers.length,
+        customers: formatted,
+    };
+}
+function getFieldValue(fields, id) {
+    return fields?.find((f) => f.id === id)?.fieldValue || "";
+}
+function maskPhone(phone) {
+    if (!phone || phone.length < 7)
+        return phone || "无";
+    return phone.slice(0, 3) + "****" + phone.slice(-4);
+}
+function formatStatus(status) {
+    const map = {
+        4: "待分配潜客",
+        5: "待分配",
+        6: "跟进中",
+        7: "公海",
+        8: "跟进中潜客",
+        9: "公海潜客",
+    };
+    return map[status] || `状态${status}`;
+}
+function formatTime(ts) {
+    if (!ts)
+        return "无";
+    return new Date(ts).toISOString().slice(0, 10);
+}

package/dist/tools/customer-search.d.ts

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import type { KeceClient } from "../client.js";
+export declare const searchCustomersSchema: z.ZodObject<{
+    filterType: z.ZodEnum<["quick", "advanced", "segment"]>;
+    filterFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        fieldId: z.ZodString;
+        filterType: z.ZodNumber;
+        filterValue: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        fieldId: string;
+        filterType: number;
+        filterValue?: string | undefined;
+    }, {
+        fieldId: string;
+        filterType: number;
+        filterValue?: string | undefined;
+    }>, "many">>;
+    segmentIds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    keyword: z.ZodOptional<z.ZodString>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    filterType: "quick" | "advanced" | "segment";
+    page: number;
+    pageSize: number;
+    filterFields?: {
+        fieldId: string;
+        filterType: number;
+        filterValue?: string | undefined;
+    }[] | undefined;
+    segmentIds?: number[] | undefined;
+    keyword?: string | undefined;
+}, {
+    filterType: "quick" | "advanced" | "segment";
+    filterFields?: {
+        fieldId: string;
+        filterType: number;
+        filterValue?: string | undefined;
+    }[] | undefined;
+    segmentIds?: number[] | undefined;
+    keyword?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+}>;
+export declare function searchCustomers(client: KeceClient, params: z.infer<typeof searchCustomersSchema>): Promise<{
+    total: any;
+    page: number;
+    pageSize: number;
+    customers: any;
+}>;

package/dist/tools/customer-search.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+const filterFieldSchema = z.object({
+    fieldId: z.string().describe("筛选字段ID，如 label(标签)、mobile(手机号)"),
+    filterType: z.number().describe("筛选条件：1=满足/包含, 2=不为空, 3=包含所有, 4=不包含, 5=等于, 6=不等于, 7=介于, 8=大于, 9=小于"),
+    filterValue: z.string().optional().describe("筛选值"),
+});
+export const searchCustomersSchema = z.object({
+    filterType: z
+        .enum(["quick", "advanced", "segment"])
+        .describe("筛选模式：quick=快捷筛选(标签), advanced=高级筛选(多条件), segment=客层筛选"),
+    filterFields: z
+        .array(filterFieldSchema)
+        .optional()
+        .describe("筛选字段列表（quick/advanced 模式使用）"),
+    segmentIds: z
+        .array(z.number())
+        .optional()
+        .describe("客层ID列表（segment 模式使用）"),
+    keyword: z.string().optional().describe("搜索关键词（至少2个字符）"),
+    page: z.number().optional().default(1).describe("页码"),
+    pageSize: z.number().optional().default(50).describe("每页数量，1~200"),
+});
+const FILTER_TYPE_MAP = {
+    quick: 1,
+    advanced: 3,
+    segment: 2,
+};
+export async function searchCustomers(client, params) {
+    const body = {
+        customerType: 1,
+        page: params.page,
+        pageSize: params.pageSize,
+    };
+    if (params.keyword) {
+        body.keyword = params.keyword;
+        body.filterId = "-1";
+        body.queryFromType = 2;
+    }
+    else {
+        const queryFilter = { type: FILTER_TYPE_MAP[params.filterType] };
+        if (params.filterType === "segment") {
+            queryFilter.segmentIds = params.segmentIds || [];
+        }
+        else {
+            queryFilter.filterContent = {
+                filterFields: (params.filterFields || []).map((f) => ({
+                    fieldId: f.fieldId,
+                    filterType: f.filterType,
+                    filterValue: f.filterValue || "",
+                })),
+            };
+        }
+        body.queryFilter = queryFilter;
+    }
+    const result = await client.request("/openapi/customer/search", body);
+    return {
+        total: result.total || 0,
+        page: params.page,
+        pageSize: params.pageSize,
+        customers: (result.customerList || []).map((c) => ({
+            cid: c.cid,
+            name: c.name,
+            phone: maskPhone(c.mobile),
+            follower: c.follower,
+            labels: c.labels || [],
+            createTime: c.createTime ? new Date(c.createTime).toISOString().slice(0, 10) : "",
+            entryTime: c.entryTime ? new Date(c.entryTime).toISOString().slice(0, 10) : "",
+        })),
+    };
+}
+function maskPhone(phone) {
+    if (!phone || phone.length < 7)
+        return phone || "无";
+    return phone.slice(0, 3) + "****" + phone.slice(-4);
+}

package/dist/tools/customer-tag.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import type { KeceClient } from "../client.js";
+export declare const updateCustomerTagSchema: z.ZodObject<{
+    cid: z.ZodOptional<z.ZodNumber>;
+    externalUserid: z.ZodOptional<z.ZodString>;
+    tagGroupId: z.ZodNumber;
+    addTag: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    removeTag: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    syncQiWei: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    tagGroupId: number;
+    syncQiWei: boolean;
+    cid?: number | undefined;
+    externalUserid?: string | undefined;
+    addTag?: number[] | undefined;
+    removeTag?: number[] | undefined;
+}, {
+    tagGroupId: number;
+    cid?: number | undefined;
+    externalUserid?: string | undefined;
+    addTag?: number[] | undefined;
+    removeTag?: number[] | undefined;
+    syncQiWei?: boolean | undefined;
+}>;
+export declare function updateCustomerTag(client: KeceClient, params: z.infer<typeof updateCustomerTagSchema>): Promise<{
+    success: boolean;
+    message: string;
+    syncQiWei?: undefined;
+} | {
+    success: boolean;
+    message: string;
+    syncQiWei: boolean;
+}>;
+export declare const batchUpdateTagSchema: z.ZodObject<{
+    cidList: z.ZodArray<z.ZodNumber, "many">;
+    tagGroupId: z.ZodNumber;
+    addTag: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    removeTag: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    syncQiWei: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    tagGroupId: number;
+    syncQiWei: boolean;
+    cidList: number[];
+    addTag?: number[] | undefined;
+    removeTag?: number[] | undefined;
+}, {
+    tagGroupId: number;
+    cidList: number[];
+    addTag?: number[] | undefined;
+    removeTag?: number[] | undefined;
+    syncQiWei?: boolean | undefined;
+}>;
+export declare function batchUpdateCustomerTag(client: KeceClient, params: z.infer<typeof batchUpdateTagSchema>): Promise<{
+    message: string;
+    successCount: number;
+    failCount: number;
+    failList: number[];
+}>;