@tbox.cn/app-module-customer-service 0.1.1

package/AGENTS.md

@@ -0,0 +1,16 @@
+# module-customer-service —— 集成指引（AI 助手用）
+
+本模块为商圈业务模块，声明消费以下服务槽（Port 接口定义见 `src/server/ports/`）：
+
+- 服务槽清单：见 `tbox.module.json` 的 `contributes.services`（demand 侧，含 title/description meta）。
+
+## 自定义 API 对接（AI 集成）
+
+用户为本模块服务槽配置「自定义 API」后，adapter 实施落点 = `packages/provider-custom/`
+（客服：客服会话能力）。实施步骤与完成判据见 `packages/provider-custom/AGENTS.md`；
+本模块 Port 接口为 adapter 的实现契约（输入 `ServiceAdapterInput`：config/instanceId/credentialRef）。
+
+## 真实厂商接入
+
+官方 provider 包形态（manifest 槽声明 + 独立包发布）参照 `modules/provider-mock` 结构样例与
+docs/reference/providers.md；厂商中立措辞纪律见该参考（本文件受 vendor-neutrality 门禁扫描）。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tbox.cn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# module-customer-service · 客服承接业务组件
+
+商圈客服域承接组件（`@tbox.cn/app-module-customer-service`，componentId
+`customer-service`）。2026-08-31 自 module-shopping-guide 拆分迁入（FAQ 工具/卡/
+preTool/本地知识库域）。极简形态：1 工具 + 1 卡 + 1 silent preTool + 常本地知识库
+装配；**客服域零出卡**（2026-09-02 联系客服引导卡下线，转人工由正文话术承接）。
+
+## 业务职责
+
+| 能力域 | 承接 |
+|---|---|
+| FAQ 检索 | 商场常见问题知识（服务政策/会员积分/停车/设施/办事指引）|
+| 知识检索 | SDK KnowledgeClient 检索，恒本地装配（与 provider 远程检索面正交）|
+| 联系通路 | contactPhone 数据面（mall-directory 服务注入）|
+
+## 架构分层
+
+    src/
+      server/
+        index.ts       模块注册（1 卡 + 1 工具 + faqPreTool；无 handler）
+        tools/index.ts customerServiceFaq
+        ports/         resolveCustomerServicePorts + local-adapters + currentContactPhone
+        projections/   faqSummary / projectCustomerServiceFaq
+        cards/customer-service-faq/meta.ts
+      client/          卡组件（存量；工具零出卡后仅作直连渲染面保留）
+
+## 领域模型（契约真源）
+
+- contracts-mall customer-service 分节：CustomerServiceQueryPort（searchFaq /
+  searchKnowledge）、FaqEntry、KnowledgeEntry、customerServiceFaqCardDataSchema。
+- FAQ 卡数据形状（query/faqs[]/contactPhone?/noResultsReason?）仍由 projection 组装，
+  但仅作 summary 载体，不再出卡。
+
+## 工具清单（tools/index.ts）
+
+| 工具 | oneLiner | carding | 门禁 |
+|---|---|---|---|
+| customerServiceFaq（tools/index.ts:56）| FAQ 检索：命中返回知识条目作答素材；未命中返回 summary 如实说明 | **零出卡**（不挂 withCardEmissionHint，description 不预告出卡——tools/index.ts:82-85 注释铁律）| 无（FAQ 域无主体语义，不查 mall，用 mallScopeOrEmpty 宽松上下文）|
+
+入参面：query（string）+ topK（string 1-5，缺省 3；D11 字符串化 schema——仅
+string/map<string,string>）；入参合法才 clamp，缺省由 adapter cfg.topK ?? 3 兜底。
+
+**零出卡的 Shapes**（tools/index.ts:75-78 注释）：FAQ 召回结果 JSON 单行进 summary
+供模型流式回复；noResultsReason 仍进 summary 供模型转述；contactPhone 保留为数据面。
+
+## silent preTool（index.ts:71-90）
+
+faqPreTool = definePreTool(customerServiceFaq, mode always, silent)：
+- 2026-09-03 v3 裁决：routing always（词表召回面追不上语言——「电影院能带外食吗」类
+  FAQ 价值问句词面永远缺；FAQ 检索轻量 + 空返无害，宁多勿漏）。
+- decide 三层：POLICY_TERMS（规则/政策/怎么收费/封顶/每小时/流程/材料…）优先 run；
+  OPERATIONAL_TERMS（缴费/支付/余额/有哪些店…）skip——操作/实时面由业务组件确定性
+  承接，FAQ 不干扰业务执行；默认 run（宁多勿漏）。
+- 政策词优先的裁决样本：「停车缴费规则」含「缴费」子串但语义是规则问（用户裁定）。
+
+## Port 与配置（ports/）
+
+- 恒本地知识库装配：KnowledgeSearchAdapter implements CustomerServiceQueryPort
+  （ports/local-adapters.ts:22-68）——SDK knowledge.search(datasetId, query, topK,
+  scoreThreshold?）；FAQ 文档 {question,answer} JSON 解析，非 JSON 走 320 字符摘要；
+  knowledge 资源同构。构造失败/未配置 TBOX_API_KEY → EmptyCustomerServiceAdapter
+  空降级（ports/index.ts:74-80）。
+- 配置链（ports/index.ts:47-65）：app-config 服务按资源键取 per-mall 配置；
+  **资源级合并**——客服侧 components/customer-service.json 覆盖、导购侧遗留
+  components/shopping-guide.json 同资源键做底（拆分过渡期兼容：真实 ref/datasetId
+  在导购侧遗留配置中不被客服占位遮蔽）；无服务/缺键 → 占位等值回退（datasetId
+  'faq' / 'mall-knowledge'，召回必然为空 + warn 日志）。
+- 资源键 = `customer-service-faq-kb` / `knowledge-assistance-kb`（manifest contributes.resources
+  声明；`ref` 经同目录 `knowledge.json` 台账展开，datasetId 直填免台账）；无服务/缺键时占位
+  datasetId 等值回退（召回必然为空，离线零行为变化）。
+- contactPhone：currentContactPhone（ports/index.ts:32-36）= mall scope mallId →
+  ctx.services 'mall-directory' 服务目录（模板注册，deployment.malls 单一来源）。
+
+## 卡片清单（1 张）
+
+customer-service-faq（meta.ts；schemaVersion 1；工具零出卡，meta 注册保留作
+schema 真源与样例数据锚）。
+
+## 跨模块协作
+
+- ← shopping-guide：FAQ 域迁入来源；其遗留配置做资源级合并的底。
+- ← member：无门禁（FAQ 公开面）；member 知识条目由知识库内容承载。
+
+## 铁律摘要
+
+- register 只注册不解析（resolveCustomerServicePorts 仅 execute 内调用）。
+- fail-visible 统一包装：execute 异常返回 { found:false, message:'暂时无法查询，请稍后再试' }
+  （tools/index.ts:44-53 统一）。
+- 工具契约与预告知一致：description 不预告出卡，工具不产 cards 字段。
+
+## 已知限制与文档漂移
+
+- contracts-mall 的 customerServiceFaqCardDataSchema 仍在 shopping-guide 分节（:330），
+  随拆分整理时迁驻或标注 deprecated。
+- knowledge client 每次调用构造（无热路径缓存诉求——FAQ 检索频次低）。
+
+## 用法
+
+在生成应用中：
+
+```sh
+tbox-app module add @tbox.cn/app-module-customer-service
+```

package/dist/chunk-PN4SPFWE.js

@@ -0,0 +1,277 @@
+// src/server/index.ts
+import { definePreTool, loadModuleSkills } from "@tbox.cn/app-sdk/server";
+
+// src/server/cards/customer-service-faq/meta.ts
+import { customerServiceFaqCardDataSchema } from "@tbox.cn/app-contracts-mall";
+var meta = {
+  cardType: "customer-service-faq",
+  dataSchema: customerServiceFaqCardDataSchema,
+  displayName: "\u5BA2\u670DFAQ",
+  description: "\u5E38\u89C1\u95EE\u9898\u7B54\u6848\uFF08\u9000\u6362\u8D27/\u79EF\u5206/\u505C\u8F66\u653F\u7B56\uFF09",
+  sampleData: {
+    query: "\u5982\u4F55\u9000\u6362\u8D27",
+    faqs: [{ question: "\u5982\u4F55\u9000\u6362\u8D27", answer: "\u51ED\u5C0F\u7968 7 \u5929\u5185\u53EF\u9000\u6362\u3002", relevanceScore: 0.9 }]
+  },
+  schemaVersion: 1
+};
+var meta_default = meta;
+
+// src/server/tools/index.ts
+import { createTool, requireToolRequestContext } from "@tbox.cn/app-sdk/server";
+import { z } from "zod";
+import { mallScopeOrEmpty } from "@tbox.cn/app-contracts-mall";
+
+// src/server/ports/index.ts
+import { parseMallScope } from "@tbox.cn/app-contracts-mall";
+import { createKnowledgeClient, KNOWLEDGE_PLACEHOLDER_DATASET_IDS } from "@tbox.cn/app-sdk/server";
+
+// src/server/ports/local-adapters.ts
+var KnowledgeSearchAdapter = class {
+  constructor(knowledge, cfg) {
+    this.knowledge = knowledge;
+    this.cfg = cfg;
+  }
+  knowledge;
+  cfg;
+  async searchFaq(_ctx, query, topK) {
+    const results = await this.knowledge.search({
+      // cfg 来源（resolver 展开直填 / 模块占位常量）恒有 datasetId（ResolvedResource 必填字段）
+      datasetId: this.cfg.faq.datasetId,
+      query,
+      topK: topK ?? this.cfg.faq.topK ?? 3,
+      ...this.cfg.faq.scoreThreshold !== void 0 ? { scoreThreshold: this.cfg.faq.scoreThreshold } : {}
+    });
+    return results.map((hit) => {
+      const parsed = tryParseJsonFaqDoc(hit.content);
+      return {
+        question: parsed?.question ?? query,
+        answer: parsed?.answer ?? summarize(hit.content),
+        ...hit.originFileName ? { category: hit.originFileName } : {},
+        relevanceScore: hit.score
+      };
+    });
+  }
+  async searchKnowledge(_ctx, query, topK) {
+    const results = await this.knowledge.search({
+      datasetId: this.cfg.knowledge.datasetId,
+      query,
+      topK: topK ?? this.cfg.knowledge.topK ?? 3,
+      ...this.cfg.knowledge.scoreThreshold !== void 0 ? { scoreThreshold: this.cfg.knowledge.scoreThreshold } : {}
+    });
+    return results.map((hit) => ({
+      content: hit.content,
+      score: hit.score,
+      ...hit.originFileName ? { title: hit.originFileName } : {}
+    }));
+  }
+};
+var EmptyCustomerServiceAdapter = class {
+  async searchFaq() {
+    return [];
+  }
+  async searchKnowledge() {
+    return [];
+  }
+};
+function tryParseJsonFaqDoc(content) {
+  try {
+    const parsed = JSON.parse(content);
+    if (typeof parsed === "object" && parsed !== null && typeof parsed.answer === "string") {
+      const doc = parsed;
+      return {
+        question: typeof doc.question === "string" ? doc.question : "",
+        answer: doc.answer
+      };
+    }
+  } catch {
+  }
+  return void 0;
+}
+function summarize(content) {
+  return content.replace(/^#+\s+/gm, "").replace(/\s+/g, " ").trim().slice(0, 320);
+}
+
+// src/server/ports/index.ts
+function resolveMallDirectory(ctx) {
+  return ctx.services.resolve?.("mall-directory");
+}
+function currentContactPhone(reqCtx, ctx) {
+  const mallId = parseMallScope(reqCtx?.attributes)?.mallId;
+  if (!mallId) return void 0;
+  return resolveMallDirectory(ctx)?.contactPhone(mallId);
+}
+var MODULE_ID = "module-customer-service";
+var DEFAULT_FAQ_RESOURCE = { type: "knowledge", datasetId: KNOWLEDGE_PLACEHOLDER_DATASET_IDS[0] };
+var DEFAULT_KB_RESOURCE = { type: "knowledge", datasetId: KNOWLEDGE_PLACEHOLDER_DATASET_IDS[1] };
+function resolveAssistanceConfig(ctx, mallId) {
+  const resolver = ctx.services.resolve?.("app-config");
+  const resources = resolver ? resolver(MODULE_ID) : {};
+  if (!resolver) {
+    console.warn(`[customer-service] app-config \u670D\u52A1\u672A\u6CE8\u5165 mallId=${mallId ?? "none"}\uFF0C\u77E5\u8BC6\u5E93\u4F7F\u7528\u5360\u4F4D datasetId\uFF08\u53EC\u56DE\u5FC5\u7136\u4E3A\u7A7A\uFF09`);
+  } else if (!resources["customer-service-faq-kb"]) {
+    console.warn(`[customer-service] app-config \u65E0 customer-service-faq-kb \u8D44\u6E90 mallId=${mallId ?? "none"}\uFF0C\u77E5\u8BC6\u5E93\u4F7F\u7528\u5360\u4F4D datasetId`);
+  }
+  return {
+    faq: resources["customer-service-faq-kb"] ?? DEFAULT_FAQ_RESOURCE,
+    knowledge: resources["knowledge-assistance-kb"] ?? DEFAULT_KB_RESOURCE
+  };
+}
+function resolveCustomerServicePorts(reqCtx, ctx) {
+  const mallId = parseMallScope(reqCtx?.attributes)?.mallId;
+  const cfg = resolveAssistanceConfig(ctx, mallId);
+  try {
+    return { customerService: new KnowledgeSearchAdapter(createKnowledgeClient(), cfg) };
+  } catch (e) {
+    ctx.logger?.debug(`knowledge \u672A\u914D\u7F6E\u6216\u6784\u9020\u5931\u8D25\uFF0CFAQ \u7A7A\u964D\u7EA7\uFF1Aerr=${e.message}`);
+    return { customerService: new EmptyCustomerServiceAdapter() };
+  }
+}
+
+// src/server/projections/index.ts
+function faqSummary(data) {
+  return JSON.stringify(data);
+}
+function projectCustomerServiceFaq(query, faqs, noResultsReason, contactPhone) {
+  return {
+    query,
+    faqs: faqs.map((f) => ({
+      question: f.question,
+      answer: f.answer,
+      ...f.category ? { category: f.category } : {},
+      relevanceScore: f.relevanceScore
+    })),
+    ...contactPhone ? { contactPhone } : {},
+    ...noResultsReason ? { noResultsReason } : {}
+  };
+}
+
+// src/server/tools/index.ts
+var str = (desc) => z.string().describe(desc);
+var optionalStr = (desc) => z.string().optional().describe(desc);
+function reqCtxOf(execCtx) {
+  return requireToolRequestContext(execCtx);
+}
+function toLooseContext(reqCtx) {
+  return {
+    scope: mallScopeOrEmpty(reqCtx),
+    requestContext: reqCtx
+  };
+}
+function createCustomerServiceTools(_opts) {
+  const exec = (fn) => {
+    return async (args, execCtx) => {
+      const ctx = _opts.getCtx();
+      try {
+        return await fn(resolveCustomerServicePorts(reqCtxOf(execCtx), ctx), ctx, args, execCtx);
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn(`[customer-service] tool exec error: ${message}`);
+        return { found: false, message: "\u6682\u65F6\u65E0\u6CD5\u67E5\u8BE2\uFF0C\u8BF7\u7A0D\u540E\u518D\u8BD5" };
+      }
+    };
+  };
+  const customerServiceFaq = createTool({
+    id: "customer-service-faq",
+    description: "\u5BA2\u670DFAQ\uFF1A\u641C\u7D22\u5546\u573A\u5E38\u89C1\u95EE\u9898\u77E5\u8BC6\uFF08\u670D\u52A1\u653F\u7B56\u3001\u4F1A\u5458\u79EF\u5206\u3001\u505C\u8F66\u3001\u8BBE\u65BD\u3001\u529E\u4E8B\u6307\u5F15\u7B49\uFF09\u3002\u547D\u4E2D\u8FD4\u56DE\u77E5\u8BC6\u6761\u76EE\uFF08\u4F5C\u7B54\u7D20\u6750\u2014\u2014\u636E\u6B64\u76F4\u63A5\u4F5C\u7B54\uFF0C\u91CD\u70B9\u4FE1\u606F\u7528 **\u52A0\u7C97**\uFF0C\u6B65\u9AA4\u7C7B\u5185\u5BB9\u5206\u70B9\u5217\u51FA\uFF09\uFF1B\u65E0\u7ED3\u679C\u8FD4\u56DE summary \u672A\u547D\u4E2D\u8BF4\u660E\uFF08\u6B63\u6587\u5982\u5B9E\u544A\u77E5\uFF0C\u4E0D\u51FA\u5361\uFF09\u3002",
+    inputSchema: z.object({
+      query: str("\u7528\u6237\u95EE\u9898"),
+      topK: optionalStr("\u8FD4\u56DE\u6761\u6570\uFF08\u5B57\u7B26\u4E32\uFF0C1-5\uFF0C\u7F3A\u7701 3\uFF09")
+    }),
+    execute: exec(async (ports, _ctx, args, execCtx) => {
+      const n = Number(args.topK);
+      const topK = Number.isFinite(n) && n >= 1 ? Math.min(5, n) : void 0;
+      const faqs = await ports.customerService.searchFaq(toLooseContext(reqCtxOf(execCtx)), String(args.query), topK);
+      const data = projectCustomerServiceFaq(
+        String(args.query),
+        faqs,
+        faqs.length === 0 ? "\u672A\u627E\u5230\u76F8\u5173\u5E38\u89C1\u95EE\u9898\uFF0C\u8BF7\u5C1D\u8BD5\u4EBA\u5DE5\u5BA2\u670D\u3002" : void 0,
+        currentContactPhone(reqCtxOf(execCtx), _opts.getCtx())
+      );
+      return { summary: faqSummary(data) };
+    })
+  });
+  return {
+    customerServiceFaq
+  };
+}
+
+// src/server/index.ts
+var moduleCtx;
+var tools = createCustomerServiceTools({ getCtx: () => moduleCtx });
+var OPERATIONAL_TERMS = [
+  "\u7F34\u8D39",
+  "\u7F34\u7EB3",
+  "\u652F\u4ED8",
+  "\u4ED8\u6B3E",
+  "\u6263\u6B3E",
+  "\u67E5\u8D39",
+  "\u8D39\u7528\u591A\u5C11",
+  "\u6B20\u8D39",
+  "\u6211\u7684",
+  "\u4F59\u989D",
+  "\u8FDB\u5EA6",
+  "\u6709\u54EA\u4E9B\u5E97",
+  "\u6709\u4EC0\u4E48\u5E97"
+];
+var POLICY_TERMS = [
+  "\u89C4\u5219",
+  "\u653F\u7B56",
+  "\u6807\u51C6",
+  "\u600E\u4E48\u7B97",
+  "\u5982\u4F55\u8BA1\u7B97",
+  "\u600E\u4E48\u6536\u8D39",
+  "\u5982\u4F55\u6536\u8D39",
+  "\u514D\u8D39",
+  "\u5C01\u9876",
+  "\u6BCF\u5C0F\u65F6",
+  "\u6D41\u7A0B",
+  "\u6750\u6599",
+  "\u6761\u4EF6"
+];
+var faqPreTool = definePreTool(tools.customerServiceFaq, {
+  routing: { mode: "always" },
+  decide: ({ text }) => {
+    const t = text?.trim() ?? "";
+    if (!t) return { decision: "skip", reason: "\u7A7A\u6587\u672C" };
+    if (POLICY_TERMS.some((w) => t.includes(w))) {
+      return { decision: "run", args: { query: text, topK: "3" } };
+    }
+    if (OPERATIONAL_TERMS.some((w) => t.includes(w))) {
+      return { decision: "skip", reason: "\u64CD\u4F5C\u578B\u8BC9\u6C42\u2014\u2014\u4E1A\u52A1\u5DE5\u5177\u5B9E\u65F6\u6570\u636E\u9762\uFF0CFAQ \u4E0D\u9884\u6267\u884C" };
+    }
+    return { decision: "run", args: { query: text, topK: "3" } };
+  },
+  silent: true
+});
+var preTools = {
+  "customer-service-faq": faqPreTool
+};
+var skills = Object.fromEntries(
+  (await loadModuleSkills("@tbox.cn/app-module-customer-service", import.meta.url)).map((s) => [s.name, s])
+);
+var serverModule = {
+  declaration: {
+    moduleId: "customer-service"
+  },
+  cards: {
+    "customer-service-faq": meta_default
+  },
+  skills,
+  preTools,
+  register(ctx) {
+    moduleCtx = ctx;
+    ctx.cards.registerMap(serverModule.cards);
+    for (const tool of Object.values(tools)) {
+      ctx.tools.register(tool);
+    }
+  }
+};
+var server_default = serverModule;
+
+export {
+  currentContactPhone,
+  resolveCustomerServicePorts,
+  createCustomerServiceTools,
+  serverModule,
+  server_default
+};

package/dist/client/index.d.ts

@@ -0,0 +1,15 @@
+import { CardComponent } from '@tbox.cn/app-contracts';
+import { ClientContext } from '@tbox.cn/app-sdk/client';
+
+/**
+ * module-customer-service 客户端入口（与服务端 serverModule 对称）。
+ */
+
+declare const clientModule: {
+    cards: {
+        readonly 'customer-service-faq': CardComponent;
+    };
+    register(ctx: ClientContext): void;
+};
+
+export { clientModule, clientModule as default };

package/dist/client/index.js

@@ -0,0 +1,86 @@
+// src/client/index.ts
+import "../customer-service-UTQ5AVTL.css";
+
+// src/client/cards/customer-service-faq/index.tsx
+import { useState } from "react";
+import { CaretDown, Phone, ArrowSquareOut } from "@phosphor-icons/react";
+import { sendCardAction } from "@tbox.cn/app-sdk/client";
+import { jsx, jsxs } from "react/jsx-runtime";
+function CustomerServiceFaqCard(props) {
+  const { data, cardId } = props;
+  const [openIndex, setOpenIndex] = useState(
+    data.faqs.length > 0 ? 0 : null
+  );
+  if (data.faqs.length === 0) {
+    return /* @__PURE__ */ jsx("section", { className: "cs-card", children: /* @__PURE__ */ jsx("div", { className: "cs-empty", children: data.noResultsReason ?? "\u672A\u627E\u5230\u76F8\u5173\u5E38\u89C1\u95EE\u9898" }) });
+  }
+  return /* @__PURE__ */ jsxs("section", { className: "cs-card cs-faq", children: [
+    /* @__PURE__ */ jsx("div", { className: "cs-card-title", children: "\u76F8\u5173\u5E38\u89C1\u95EE\u9898" }),
+    /* @__PURE__ */ jsx("ul", { className: "cs-faq-list", children: data.faqs.map((f, i) => {
+      const open = openIndex === i;
+      return /* @__PURE__ */ jsxs("li", { className: "cs-faq-item", children: [
+        /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            className: "cs-faq-item__q",
+            "aria-expanded": open,
+            onClick: () => setOpenIndex(open ? null : i),
+            children: [
+              /* @__PURE__ */ jsx("span", { children: f.question }),
+              /* @__PURE__ */ jsx(CaretDown, { size: 16, className: "cs-faq-item__chevron", "data-rotated": open || void 0 })
+            ]
+          }
+        ),
+        open && /* @__PURE__ */ jsxs("div", { className: "cs-faq-item__a", children: [
+          /* @__PURE__ */ jsx("p", { children: f.answer }),
+          f.referenceUrl && /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              className: "cs-link-btn cs-faq-item__ref",
+              onClick: () => {
+                sendCardAction(cardId, { type: "openLink", url: f.referenceUrl });
+              },
+              children: [
+                "\u67E5\u770B\u6765\u6E90",
+                /* @__PURE__ */ jsx(ArrowSquareOut, { size: 13 })
+              ]
+            }
+          )
+        ] })
+      ] }, i);
+    }) }),
+    data.contactPhone && /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        className: "cs-contact-btn",
+        onClick: () => {
+          sendCardAction(cardId, { type: "openLink", url: `tel:${data.contactPhone}` });
+        },
+        children: [
+          /* @__PURE__ */ jsx(Phone, { size: 16 }),
+          "\u62E8\u6253\u5BA2\u670D ",
+          data.contactPhone
+        ]
+      }
+    )
+  ] });
+}
+
+// src/client/index.ts
+var cards = {
+  "customer-service-faq": CustomerServiceFaqCard
+};
+var clientModule = {
+  cards,
+  register(ctx) {
+    ctx.cards.registerMap(cards);
+  }
+};
+var client_default = clientModule;
+export {
+  clientModule,
+  client_default as default
+};

package/dist/customer-service-UTQ5AVTL.css

@@ -0,0 +1,141 @@
+/* ============================================================
+ * module-customer-service 客户端域样式（自 module-shopping-guide 迁入，
+ * 2026-08-31 客服模块拆分；类名 sg- → cs-，模块自持 CSS 零跨模块共享）。
+ * 视觉源：mall-vis 导购蓝系延续（FAQ 卡原 sg-faq 视觉 1:1 迁移）。
+ * 机械规则：大写 PX 不转；rgba() 传统语法；禁 color-mix / !important；直引 --tbox-* 恒带 fallback；域专属视觉走域变量。
+ * ============================================================ */
+
+/* ===== 域变量 ===== */
+.cs-card {
+  --cs-accent: #096bfa;
+  --cs-surface: #f7faff;
+  --cs-accent-border: #cfe0f7;
+  --cs-text-2: var(--tbox-text-secondary, #888);
+  --cs-text-3: var(--tbox-muted, #aaa);
+  --cs-border: var(--tbox-border, #ececec);
+  --cs-bg-subtle: var(--tbox-bg-subtle, #f7f7f7);
+}
+
+/* ===== 卡根 ===== */
+.cs-card {
+  box-sizing: border-box;
+  padding: 40px;
+  color: var(--tbox-text-primary, #202124);
+  font: inherit;
+}
+.cs-card *,
+.cs-card *::before,
+.cs-card *::after {
+  box-sizing: border-box;
+}
+.cs-card button {
+  cursor: pointer;
+}
+.cs-card button:disabled {
+  cursor: not-allowed;
+  opacity: 0.5;
+}
+.cs-card ul,
+.cs-card ol,
+.cs-card dl,
+.cs-card dd,
+.cs-card dt,
+.cs-card p {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+/* ===== 布局 ===== */
+.cs-card-title {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+  font-size: 34px;
+  font-weight: 700;
+  line-height: 48px;
+  margin-bottom: 16px;
+  color: var(--tbox-text-primary, #202124);
+}
+.cs-card-title::before {
+  content: '';
+  flex: 0 0 8px;
+  width: 8px;
+  height: 32px;
+  border-radius: 4px;
+  background: var(--cs-accent);
+}
+.cs-empty {
+  padding: 48px 0;
+  margin-top: 16px;
+  font-size: 22px;
+  color: var(--cs-text-3);
+}
+.cs-link-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  color: var(--cs-accent);
+  font-size: 26px;
+  text-decoration: underline;
+  text-underline-offset: 4px;
+}
+
+/* ===== customer-service-faq ===== */
+.cs-faq-item {
+  border: 1px solid var(--cs-border);
+  border-radius: 20px;
+  margin-top: 16px;
+  overflow: hidden;
+}
+.cs-faq-item__q {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  width: 100%;
+  padding: 24px;
+  border: 0;
+  background: var(--tbox-bg-card, #fff);
+  color: var(--tbox-text-primary, #202124);
+  font-size: 28px;
+  font-weight: 500;
+  text-align: left;
+}
+.cs-faq-item__chevron[data-rotated] {
+  transform: rotate(180deg);
+  transition: transform 0.15s ease;
+}
+.cs-faq-item__a {
+  padding: 0 24px 24px;
+  border-top: 1px solid var(--cs-border);
+  background: var(--cs-bg-subtle);
+}
+.cs-faq-item__a p {
+  padding: 20px 0 8px;
+  font-size: 26px;
+  line-height: 40px;
+  color: var(--tbox-text-primary, #202124);
+}
+.cs-faq-item__ref {
+  margin-top: 8px;
+  font-size: 24px;
+}
+.cs-contact-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 12px;
+  width: 100%;
+  margin-top: 24px;
+  height: 80px;
+  border-radius: 18px;
+  border: 2px solid var(--cs-accent-border);
+  color: var(--cs-accent);
+  background: var(--cs-surface);
+  font-size: 28px;
+  font-weight: 500;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { CustomerServicePorts, CustomerServiceToolIds, CustomerServiceTools, MallDirectoryService, createCustomerServiceTools, currentContactPhone, resolveCustomerServicePorts, default as serverModule } from './server/index.js';
+import '@mastra/core/tools';
+import '@tbox.cn/app-sdk/server';
+import '@tbox.cn/app-contracts';
+import 'zod';
+import '@tbox.cn/app-contracts-mall';

package/dist/index.js

@@ -0,0 +1,12 @@
+import {
+  createCustomerServiceTools,
+  currentContactPhone,
+  resolveCustomerServicePorts,
+  serverModule
+} from "./chunk-PN4SPFWE.js";
+export {
+  createCustomerServiceTools,
+  currentContactPhone,
+  resolveCustomerServicePorts,
+  serverModule
+};