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

package/dist/server/index.d.ts

@@ -0,0 +1,106 @@
+import * as _mastra_core_tools from '@mastra/core/tools';
+import * as _tbox_cn_app_sdk_server from '@tbox.cn/app-sdk/server';
+import { ServerContext, PreToolDef } from '@tbox.cn/app-sdk/server';
+import * as _tbox_cn_app_contracts from '@tbox.cn/app-contracts';
+import { RequestContext } from '@tbox.cn/app-contracts';
+import * as zod from 'zod';
+import { CustomerServiceQueryPort } from '@tbox.cn/app-contracts-mall';
+
+/**
+ * 客服承接 Port 解析：本地知识库域恒本地装配（与 provider 供给面正交）。
+ * - app-config 服务（integrations v5 modules 节内存源）注入时按 install id 取资源
+ *   （ref 展开已在 resolver 构造期完成——消费端只见直填形状）；
+ * - 无服务/缺资源键 → 占位等值回退（模块单测与未装配环境不破坏，离线零行为变化）。
+ */
+
+interface CustomerServicePorts {
+    customerService: CustomerServiceQueryPort;
+}
+/** mall-directory 服务消费接口（015 S7：模板注册，deployment.malls 单一来源；模块只依赖此结构类型） */
+interface MallDirectoryService {
+    contactPhone(mallId: string): string | undefined;
+}
+/** mall scope 的 contactPhone（联系客服卡拨打条目数据源；mallId 显式 reqCtx、目录经 ctx 解析） */
+declare function currentContactPhone(reqCtx: RequestContext | undefined, ctx: ServerContext): string | undefined;
+/**
+ * 解析客服承接 Port 集合（运行期调用；register 只注册不解析——铁律）。
+ * 恒本地知识库装配；TBOX_API_KEY 未配置 → 空 FAQ（静默降级）。
+ */
+declare function resolveCustomerServicePorts(reqCtx: RequestContext, ctx: ServerContext): CustomerServicePorts;
+
+type CustomerServiceToolIds = 'customer-service-faq';
+declare function createCustomerServiceTools(_opts: {
+    getCtx: () => ServerContext;
+}): {
+    readonly customerServiceFaq: _mastra_core_tools.Tool<{
+        query: string;
+        topK?: string | undefined;
+    }, unknown, unknown, unknown, _mastra_core_tools.ToolExecutionContext<unknown, unknown, unknown>, "customer-service-faq", unknown>;
+};
+type CustomerServiceTools = ReturnType<typeof createCustomerServiceTools>;
+
+declare const serverModule: {
+    declaration: {
+        moduleId: string;
+    };
+    cards: {
+        'customer-service-faq': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+            query: zod.ZodString;
+            faqs: zod.ZodArray<zod.ZodObject<{
+                question: zod.ZodString;
+                answer: zod.ZodString;
+                category: zod.ZodOptional<zod.ZodString>;
+                relevanceScore: zod.ZodNumber;
+                referenceUrl: zod.ZodOptional<zod.ZodString>;
+            }, "strip", zod.ZodTypeAny, {
+                question: string;
+                answer: string;
+                relevanceScore: number;
+                category?: string | undefined;
+                referenceUrl?: string | undefined;
+            }, {
+                question: string;
+                answer: string;
+                relevanceScore: number;
+                category?: string | undefined;
+                referenceUrl?: string | undefined;
+            }>, "many">;
+            contactPhone: zod.ZodOptional<zod.ZodString>;
+            noResultsReason: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            query: string;
+            faqs: {
+                question: string;
+                answer: string;
+                relevanceScore: number;
+                category?: string | undefined;
+                referenceUrl?: string | undefined;
+            }[];
+            noResultsReason?: string | undefined;
+            contactPhone?: string | undefined;
+        }, {
+            query: string;
+            faqs: {
+                question: string;
+                answer: string;
+                relevanceScore: number;
+                category?: string | undefined;
+                referenceUrl?: string | undefined;
+            }[];
+            noResultsReason?: string | undefined;
+            contactPhone?: string | undefined;
+        }>>;
+    };
+    skills: {
+        [k: string]: _tbox_cn_app_sdk_server.LocalSkill;
+    };
+    preTools: {
+        'customer-service-faq': PreToolDef<_mastra_core_tools.Tool<{
+            query: string;
+            topK?: string | undefined;
+        }, unknown, unknown, unknown, _mastra_core_tools.ToolExecutionContext<unknown, unknown, unknown>, "customer-service-faq", unknown>>;
+    };
+    register(ctx: ServerContext): void;
+};
+
+export { type CustomerServicePorts, type CustomerServiceToolIds, type CustomerServiceTools, type MallDirectoryService, createCustomerServiceTools, currentContactPhone, serverModule as default, resolveCustomerServicePorts, serverModule };

package/dist/server/index.js

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@tbox.cn/app-module-customer-service",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "商圈客服承接模块：服务政策 FAQ 知识检索（命中正文作答/无结果联系客服卡）。",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@tbox.cn/app-sdk": "0.17.0",
+    "@tbox.cn/app-contracts": "0.9.0",
+    "@tbox.cn/app-contracts-mall": "0.9.0"
+  },
+  "peerDependencies": {
+    "zod": "3.25.76",
+    "react": "18.3.1",
+    "@phosphor-icons/react": "2.1.10"
+  },
+  "devDependencies": {
+    "@types/react": "18.3.31",
+    "@types/node": "24.13.3",
+    "typescript": "5.9.3",
+    "vitest": "4.1.10",
+    "zod": "3.25.76",
+    "tsup": "8.5.1",
+    "happy-dom": "20.11.2",
+    "react-dom": "18.3.1",
+    "@types/react-dom": "18.3.7"
+  },
+  "files": [
+    "dist",
+    "src",
+    "tests",
+    "skills",
+    "tbox.module.json",
+    "tsconfig.json",
+    "tsup.config.ts",
+    "README.md",
+    "LICENSE",
+    "AGENTS.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "build": "tsup"
+  }
+}

package/skills/customer-service/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: customer-service
+description: 商圈客服 SOP——服务政策问答、FAQ 转述、联系客服兜底与转人工承接的决策与回答规范。
+routingTerms:
+  - 客服
+  - 退换货
+  - 退货
+  - 退款
+  - 售后
+  - 发票
+  - 投诉
+  - 服务政策
+  - 营业时间
+  - 开门
+  - 关门
+  - 开闭店
+---
+
+# 商圈客服 SOP
+
+## 你是谁
+
+你是商场的客服朋友，熟悉服务政策与办事流程。像真人一样理解用户诉求，先给答案再给下一步；政策条目转述要像面对面解释，不像念文件。
+
+- **结果先行**：先直接回答问题（"7 天内凭小票可退"），再补关键限制条件
+- **重点可扫读**：期限、金额、门槛用 **加粗**，步骤类内容分点列出
+- **不承诺**：转述政策保留原条件与范围，不把"可能""视情况"说成"一定"
+
+❌ `根据商场服务政策规定，退换货业务需凭有效凭证至服务台办理，具体以商场公示为准。`
+
+✅ `凭小票 **7 天内**可退换，吊牌别拆。去 1F 服务台办就行。`
+
+## 工作方式
+
+**先查知识库再回答**——客服域的每一轮对话，无论用户问什么（政策/办事/投诉/转人工/基础信息），都必须先调 `customer-service-faq`（`query` 传用户原话）查知识库。有命中时参考知识库条目用自己的话转述（保留条件、范围和时间限制），不编造知识库没有的信息；无召回时如实说明暂无收录，再基于常识给用户合理的引导（如建议到服务台咨询），但不把常识说成商场政策。客服域零出卡，转人工承接走正文话术。
+
+## 能力地图
+
+| 用户问什么 | 工具 | 出卡 |
+| --- | --- | --- |
+| 退换货、积分规则、停车月卡政策、开发票、投诉建议等政策与办事 | `customer-service-faq` | 无卡（命中时正文作答） |
+| 营业时间、商场位置等基础信息 | `customer-service-faq` | 无卡（命中时正文作答） |
+
+## 场景走法
+
+### 政策问答
+
+用户问"退换货怎么办""积分怎么用""商场几点开门""怎么开发票"时：调 `customer-service-faq`，`query` 传用户原话。命中时用自己的话转述——保留条件、范围和时间限制，重点信息 **加粗**，步骤分点。查不到时如实说明暂无收录，建议用户到服务台或联系人工客服确认。
+
+注意：政策答的是"规则"，不是"实时数字"——停车费要实时报价，走停车域 `queryParkingFee`；会员积分余额走会员域 `queryPoints`；优惠券领取走营销域 `listCoupons`。
+
+### 商场基础信息
+
+用户问"商场几点开门""几点关门""营业到几点""在哪个位置/怎么走"这类商场基础信息时：调 `customer-service-faq`，`query` 传用户原话。知识库收录了就按条目作答（时间用 **加粗**）；没收录就如实说明暂无该信息，建议用户联系人工客服确认——不按常识编造营业时间。
+
+### 投诉与情绪
+
+用户表达不满（排队久、服务差、东西有问题）时：先接住情绪再给路径；能对上 FAQ 条目就给解法，对不上就在正文说明"帮你转人工更稳妥"并给出联系人工的路径，不敷衍、不与用户争辩。
+
+### 转人工
+
+用户说"转人工""人工客服""找人工""联系客服"时：调 `customer-service-faq`（`query` 传用户原话"转人工"），查知识库里的人工客服联系方式（电话、服务台位置等）。有结果就在正文告知（"人工客服电话是 XXX，也可以到 1F 服务台"）；知识库无收录就如实说明"暂无人工客服联系方式，建议到 1F 服务台咨询"。**不要直接说"帮您转人工"而不调工具**——用户需要的是联系方式，不是一句"正在转接"。
+
+## 卡片是怎么出来的
+
+客服域零出卡：FAQ 命中与未命中都不产出卡片候选——答案与未命中说明全部在正文，联系人工也是正文话术（不出任何卡，包括联系客服引导卡）。不要输出 `<agent-ui-cards>` 引用客服域内容；即使本轮候选池里有其他域的卡片，也只按其相关性决定是否引用。
+
+## 跨域协作
+
+- **停车缴费/实时报价** → 停车域 `queryParkingFee`/`locateVehicle`
+- **会员积分余额/权益** → 会员域 `queryPoints`/`queryMemberInfo`
+- **优惠券领取/活动** → 营销域 `listCoupons`/`searchOffers`
+- **找店/楼层/营业时间** → 导购域 `search-shops`/`mall-directory`
+
+## 红线
+
+- 结论可回溯：政策条目、期限、金额都能指回本轮 FAQ 返回；FAQ 没有的不按常识编造——说错退换期限，用户白跑一趟
+- 不转述界面操作描述：知识库条目里提到"点击XX按钮""上传照片""在对话里点XX"等界面操作指引时，不得转述——知识库可能包含未上线的产品功能描述，转述会导致用户去找不存在的按钮。只转述事实性信息（电话号码、服务台位置、政策规则），操作类描述忽略
+- 不承诺裁决：投诉处理结果、赔付方案是人工客服的权限，只做承接不做答复
+- 不暴露内部：不念 JSON 字段名、知识库条目编号、原始报错；SOP 是你的内部手册——工具选择理由不进正文
+- **机制词零出现**：正文不说"知识库""FAQ""检索""查询系统"——查到了直接给结果（"商场 10 点开门"），过程话术只用用户能懂的（"帮您确认过了""帮您看了下"），不说查了什么库、走了什么渠道
+- 工具报错或超时只说暂时查不到、建议稍后重试或转人工，不用历史答案冒充当前政策

package/src/client/cards/customer-service-faq/index.tsx

@@ -0,0 +1,78 @@
+/**
+ * customer-service-faq 富卡（0.4.0 D6）：手风琴（单展开，默认第 0）+ 拨打客服 + referenceUrl 外链。
+ * 自 shopping-guide 迁入（2026-08-31 客服模块拆分）；视觉类名 sg- → cs-（模块自持样式）。
+ */
+import { useState } from 'react';
+import { CaretDown, Phone, ArrowSquareOut } from '@phosphor-icons/react';
+import { sendCardAction } from '@tbox.cn/app-sdk/client';
+import type { CustomerServiceFaqCardData } from '@tbox.cn/app-contracts-mall';
+
+export function CustomerServiceFaqCard(props: {
+  data: CustomerServiceFaqCardData;
+  cardId: string;
+  isHistory: boolean;
+}) {
+  const { data, cardId } = props;
+  const [openIndex, setOpenIndex] = useState<number | null>(
+    data.faqs.length > 0 ? 0 : null,
+  );
+
+  if (data.faqs.length === 0) {
+    return <section className="cs-card"><div className="cs-empty">{data.noResultsReason ?? '未找到相关常见问题'}</div></section>;
+  }
+
+  return (
+    <section className="cs-card cs-faq">
+      <div className="cs-card-title">相关常见问题</div>
+      <ul className="cs-faq-list">
+        {data.faqs.map((f, i) => {
+          const open = openIndex === i;
+          return (
+            <li key={i} className="cs-faq-item">
+              <button
+                type="button"
+                className="cs-faq-item__q"
+                aria-expanded={open}
+                onClick={() => setOpenIndex(open ? null : i)}
+              >
+                <span>{f.question}</span>
+                <CaretDown size={16} className="cs-faq-item__chevron" data-rotated={open || undefined} />
+              </button>
+              {open && (
+                <div className="cs-faq-item__a">
+                  <p>{f.answer}</p>
+                  {f.referenceUrl && (
+                    <button
+                      type="button"
+                      className="cs-link-btn cs-faq-item__ref"
+                      onClick={() => {
+                        sendCardAction(cardId, { type: 'openLink', url: f.referenceUrl! });
+                      }}
+                    >
+                      查看来源
+                      <ArrowSquareOut size={13} />
+                    </button>
+                  )}
+                </div>
+              )}
+            </li>
+          );
+        })}
+      </ul>
+      {data.contactPhone && (
+        <button
+          type="button"
+          className="cs-contact-btn"
+          onClick={() => {
+            sendCardAction(cardId, { type: 'openLink', url: `tel:${data.contactPhone}` });
+          }}
+        >
+          <Phone size={16} />
+          拨打客服 {data.contactPhone}
+        </button>
+      )}
+    </section>
+  );
+}
+
+export default CustomerServiceFaqCard;

package/src/client/cards/index.ts

@@ -0,0 +1 @@
+export { CustomerServiceFaqCard, default } from './customer-service-faq';

package/src/client/index.ts

@@ -0,0 +1,21 @@
+/**
+ * module-customer-service 客户端入口（与服务端 serverModule 对称）。
+ */
+import './styles/customer-service.css'; // 模块自持 CSS（副作用 import，首行保证先行加载）
+
+import type { CardComponent } from '@tbox.cn/app-contracts';
+import type { ClientContext, ClientModule } from '@tbox.cn/app-sdk/client';
+import { CustomerServiceFaqCard } from './cards';
+
+const cards = {
+  'customer-service-faq': CustomerServiceFaqCard as CardComponent,
+} as const;
+
+export const clientModule = {
+  cards,
+  register(ctx: ClientContext): void {
+    ctx.cards.registerMap(cards);
+  },
+} satisfies ClientModule;
+
+export default clientModule;

package/src/client/styles/customer-service.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/src/index.ts

@@ -0,0 +1 @@
+export * from './server/index';

package/src/server/cards/customer-service-faq/meta.ts

@@ -0,0 +1,16 @@
+import type { CardMeta } from '@tbox.cn/app-contracts';
+import { customerServiceFaqCardDataSchema } from '@tbox.cn/app-contracts-mall';
+
+const meta: CardMeta<typeof customerServiceFaqCardDataSchema> = {
+  cardType: 'customer-service-faq',
+  dataSchema: customerServiceFaqCardDataSchema,
+  displayName: '客服FAQ',
+  description: '常见问题答案（退换货/积分/停车政策）',
+  sampleData: {
+    query: '如何退换货',
+    faqs: [{ question: '如何退换货', answer: '凭小票 7 天内可退换。', relevanceScore: 0.9 }],
+  },
+  schemaVersion: 1,
+};
+
+export default meta;

package/src/server/index.ts

@@ -0,0 +1,115 @@
+/**
+ * module-customer-service 服务端入口（011 K1：自注册闭环）。
+ * - 1 卡声明（key = cardType）+ 1 工具 + FAQ silent preTool；
+ * - register 只注册不解析（resolveCustomerServicePorts 仅 execute 内调用）；
+ * - 模块级单例：工具实例顶层创建（010 实例一致性），register 幂等。
+ * 2026-08-31 客服模块拆分：自 module-shopping-guide 迁入（FAQ 工具/卡/preTool/本地知识库域）。
+ */
+import type {
+  ServerContext,
+  ServerModule,
+  PreToolDef,
+} from '@tbox.cn/app-sdk/server';
+import { definePreTool, loadModuleSkills } from '@tbox.cn/app-sdk/server';
+import customerServiceFaqMeta from './cards/customer-service-faq/meta';
+import { createCustomerServiceTools } from './tools';
+
+export { resolveCustomerServicePorts, currentContactPhone, type CustomerServicePorts, type MallDirectoryService } from './ports';
+export { createCustomerServiceTools } from './tools';
+export type { CustomerServiceTools, CustomerServiceToolIds } from './tools';
+
+/** 模块级 ctx 引用（register 期绑定；execute 内读取——平台包实例分裂免疫：不 import SDK 全局单例） */
+let moduleCtx: ServerContext | undefined;
+
+/** 工具实例顶层创建（010：pre-tool 声明引用工具实例 = 单一真源） */
+const tools = createCustomerServiceTools({ getCtx: () => moduleCtx! });
+
+/**
+ * FAQ 静默前置工具（011 D2/D9）：客服 FAQ 检索 = silent preTool。
+ * - silent：不发前端事件、不落 inputs.preTools，仅本轮 reminder 数据块注入；
+ * - routing always（2026-09-03 v3）：每轮进 decide——词表路由的召回面追不上语言（"电影院能带外食吗"
+ *   类 FAQ 价值问句词面永远缺），FAQ 检索轻量+空返无害，宁多勿漏；
+ * - decide 三层：政策语义优先 run（"停车缴费规则"含"缴费"但语义是规则问）→ 明确操作/实时面 skip
+ *   （业务组件确定性承接，FAQ 不补充、不干扰业务执行）→ 默认 run（宁多勿漏；L2 平台段置信度
+ *   分层句保证检索背景不越位实时数据）。
+ */
+/** 操作/实时面信号（明确业务组件承接——skip 防干扰）；含门店搜索面（有哪些店） */
+const OPERATIONAL_TERMS = [
+  '缴费',
+  '缴纳',
+  '支付',
+  '付款',
+  '扣款',
+  '查费',
+  '费用多少',
+  '欠费',
+  '我的',
+  '余额',
+  '进度',
+  '有哪些店',
+  '有什么店',
+] as const;
+
+/** 政策型意图信号（FAQ 价值区）——优先于操作型判定：
+ * "停车缴费规则"含"缴费"子串但语义是政策问句（用户裁定：规则类加载参考），双层序保证 run。 */
+const POLICY_TERMS = [
+  '规则',
+  '政策',
+  '标准',
+  '怎么算',
+  '如何计算',
+  '怎么收费',
+  '如何收费',
+  '免费',
+  '封顶',
+  '每小时',
+  '流程',
+  '材料',
+  '条件',
+] as const;
+
+const faqPreTool = definePreTool(tools.customerServiceFaq, {
+  routing: { mode: 'always' },
+  decide: ({ text }) => {
+    const t = text?.trim() ?? '';
+    if (!t) return { decision: 'skip', reason: '空文本' };
+    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: '操作型诉求——业务工具实时数据面，FAQ 不预执行' };
+    }
+    // 默认 run（宁多勿漏）：FAQ 检索轻量+空返无害；L2 分层句保证背景不越位实时数据
+    return { decision: 'run', args: { query: text, topK: '3' } };
+  },
+  silent: true,
+});
+
+const preTools = {
+  'customer-service-faq': faqPreTool,
+} satisfies Record<string, PreToolDef>;
+
+/** 本地 skill（009 文件化：包内 skills/customer-service/；map 化回填声明式通道） */
+const skills = Object.fromEntries(
+  (await loadModuleSkills('@tbox.cn/app-module-customer-service', import.meta.url)).map((s) => [s.name, s]),
+);
+
+export const serverModule = {
+  declaration: {
+    moduleId: 'customer-service',
+  },
+  cards: {
+    'customer-service-faq': customerServiceFaqMeta,
+  },
+  skills,
+  preTools,
+  register(ctx: ServerContext): void {
+    moduleCtx = ctx;
+    ctx.cards.registerMap(serverModule.cards);
+    for (const tool of Object.values(tools)) {
+      ctx.tools.register(tool);
+    }
+  },
+} satisfies ServerModule;
+
+export default serverModule;