目录

1. 概述
2. 功能设计
3. Kotlin 实现代码（KMP）
4. JavaScript 调用示例
5. ArkTS 页面集成与调用
6. 数据输入与交互体验
7. 编译与自动复制流程
8. 总结

---

概述

本案例在 Kotlin Multiplatform (KMP) 工程中实现了一个 客户服务工具 - 客户满意度调查分析工具：

• 输入：客户的满意度调查数据（产品质量、服务态度、交付速度、价格合理性、整体满意度），使用空格分隔，例如：85 90 78 88 92。
• 输出：
  • 满意度基本信息：各项满意度评分
  • 满意度分析：平均满意度、满意度等级、最满意项、最不满意项
  • 满意度趋势：满意度变化分析
  • 客户反馈：根据满意度的客户反馈分析
  • 改进建议：根据分析结果的服务改进建议
• 技术路径：Kotlin → Kotlin/JS → JavaScript 模块 → ArkTS 页面调用。

这个案例展示了 KMP 跨端开发在客户服务领域的应用：

把客户满意度分析逻辑写在 Kotlin 里，一次实现，多端复用；把分析界面写在 ArkTS 里，专注 UI 和体验。

Kotlin 侧负责解析满意度数据、计算满意度指标、评估满意度等级、生成改进建议；ArkTS 侧只需要把输入字符串传给 Kotlin 函数，并把返回结果原样展示出来即可。借助 KMP 的 Kotlin/JS 能力，这个客户满意度调查分析工具可以在 Node.js、Web 前端以及 OpenHarmony 中复用相同的代码逻辑。

---

功能设计

输入数据格式

客户满意度调查分析工具采用简单直观的输入格式：

• 使用 空格分隔 各个参数。
• 第一个参数是产品质量（整数或浮点数，范围 0-100）。
• 第二个参数是服务态度（整数或浮点数，范围 0-100）。
• 第三个参数是交付速度（整数或浮点数，范围 0-100）。
• 第四个参数是价格合理性（整数或浮点数，范围 0-100）。
• 第五个参数是整体满意度（整数或浮点数，范围 0-100）。
• 输入示例：

85 90 78 88 92

这可以理解为：

• 产品质量：85 分
• 服务态度：90 分
• 交付速度：78 分
• 价格合理性：88 分
• 整体满意度：92 分

工具会基于这些数据计算出：

• 平均满意度：所有满意度评分的平均值
• 满意度等级：根据平均满意度的等级评估
• 最满意项：满意度最高的方面
• 最不满意项：满意度最低的方面
• 满意度差距：最高和最低满意度的差异

输出信息结构

为了便于在 ArkTS 页面以及终端中直接展示，Kotlin 函数返回的是一段结构化的多行文本，划分为几个分区：

1. 标题区：例如"😊 客户满意度调查"，一眼看出工具用途。
2. 满意度基本信息：各项满意度评分。
3. 满意度分析：平均满意度、满意度等级、最满意项、最不满意项。
4. 满意度趋势：满意度变化分析。
5. 客户反馈：根据满意度的客户反馈分析。
6. 改进建议：根据分析结果的服务改进建议。

这样的输出结构使得：

• 在 ArkTS 中可以直接把整段文本绑定到 Text 组件，配合 monospace 字体，阅读体验类似终端报告。
• 如果将来想把结果保存到日志或者后端，直接保存字符串即可。
• 需要更精细的 UI 时，也可以在前端根据分隔符进行拆分，再按块展示。

---

Kotlin 实现代码（KMP）

核心代码在 src/jsMain/kotlin/App.kt 中，通过 @JsExport 导出。以下是完整的 Kotlin 实现：

@OptIn(ExperimentalJsExport::class)
@JsExport
fun customerSatisfactionAnalyzer(inputData: String = "85 90 78 88 92"): String {
    // 输入格式: 产品质量 服务态度 交付速度 价格合理性 整体满意度
    val parts = inputData.trim().split(" ").filter { it.isNotEmpty() }

    if (parts.size < 5) {
        return "❌ 错误: 请输入完整的信息，格式: 产品质量 服务态度 交付速度 价格合理性 整体满意度\n例如: 85 90 78 88 92"
    }

    val productQuality = parts[0].toDoubleOrNull() ?: return "❌ 错误: 产品质量必须是数字"
    val serviceAttitude = parts[1].toDoubleOrNull() ?: return "❌ 错误: 服务态度必须是数字"
    val deliverySpeed = parts[2].toDoubleOrNull() ?: return "❌ 错误: 交付速度必须是数字"
    val priceReasonability = parts[3].toDoubleOrNull() ?: return "❌ 错误: 价格合理性必须是数字"
    val overallSatisfaction = parts[4].toDoubleOrNull() ?: return "❌ 错误: 整体满意度必须是数字"

    if (productQuality < 0 || productQuality > 100) {
        return "❌ 错误: 产品质量必须在 0-100 之间"
    }

    if (serviceAttitude < 0 || serviceAttitude > 100) {
        return "❌ 错误: 服务态度必须在 0-100 之间"
    }

    if (deliverySpeed < 0 || deliverySpeed > 100) {
        return "❌ 错误: 交付速度必须在 0-100 之间"
    }

    if (priceReasonability < 0 || priceReasonability > 100) {
        return "❌ 错误: 价格合理性必须在 0-100 之间"
    }

    if (overallSatisfaction < 0 || overallSatisfaction > 100) {
        return "❌ 错误: 整体满意度必须在 0-100 之间"
    }

    // 计算平均满意度
    val averageSatisfaction = (productQuality + serviceAttitude + deliverySpeed + priceReasonability + overallSatisfaction) / 5

    // 判断满意度等级
    val satisfactionLevel = when {
        averageSatisfaction >= 90 -> "⭐⭐⭐⭐⭐ 非常满意"
        averageSatisfaction >= 80 -> "⭐⭐⭐⭐ 满意"
        averageSatisfaction >= 70 -> "⭐⭐⭐ 一般满意"
        averageSatisfaction >= 60 -> "⭐⭐ 基本满意"
        else -> "⭐ 不满意"
    }

    // 找出最满意和最不满意项
    val scores = mapOf(
        "产品质量" to productQuality,
        "服务态度" to serviceAttitude,
        "交付速度" to deliverySpeed,
        "价格合理性" to priceReasonability,
        "整体满意度" to overallSatisfaction
    )

    val mostSatisfied = scores.maxByOrNull { it.value }
    val leastSatisfied = scores.minByOrNull { it.value }

    // 判断各项等级
    val getSatisfactionGrade = { score: Double ->
        when {
            score >= 90 -> "非常满意"
            score >= 80 -> "满意"
            score >= 70 -> "一般满意"
            score >= 60 -> "基本满意"
            else -> "不满意"
        }
    }

    // 生成满意度分析
    val satisfactionAnalysis = StringBuilder()
    satisfactionAnalysis.append("• 产品质量: ${String.format("%.1f", productQuality)} 分 (${getSatisfactionGrade(productQuality)})\n")
    satisfactionAnalysis.append("• 服务态度: ${String.format("%.1f", serviceAttitude)} 分 (${getSatisfactionGrade(serviceAttitude)})\n")
    satisfactionAnalysis.append("• 交付速度: ${String.format("%.1f", deliverySpeed)} 分 (${getSatisfactionGrade(deliverySpeed)})\n")
    satisfactionAnalysis.append("• 价格合理性: ${String.format("%.1f", priceReasonability)} 分 (${getSatisfactionGrade(priceReasonability)})\n")
    satisfactionAnalysis.append("• 整体满意度: ${String.format("%.1f", overallSatisfaction)} 分 (${getSatisfactionGrade(overallSatisfaction)})\n")

    // 生成客户反馈
    val customerFeedback = StringBuilder()
    if (productQuality < 80) {
        customerFeedback.append("• 产品质量需要改进，建议加强质量控制\n")
    }
    if (serviceAttitude < 80) {
        customerFeedback.append("• 服务态度需要提升，建议加强员工培训\n")
    }
    if (deliverySpeed < 80) {
        customerFeedback.append("• 交付速度需要加快，建议优化物流流程\n")
    }
    if (priceReasonability < 80) {
        customerFeedback.append("• 价格合理性需要改善，建议评估定价策略\n")
    }
    if (customerFeedback.isEmpty()) {
        customerFeedback.append("• 客户对各方面都很满意，建议继续保持\n")
    }

    // 生成改进建议
    val improvementAdvice = when {
        averageSatisfaction >= 90 -> "客户满意度很高，建议继续保持当前的服务质量，并收集更多反馈以进一步改进。"
        averageSatisfaction >= 80 -> "客户满意度良好，建议针对薄弱项进行改进，进一步提升客户体验。"
        averageSatisfaction >= 70 -> "客户满意度一般，建议制定改进计划，重点关注满意度较低的方面。"
        averageSatisfaction >= 60 -> "客户满意度基本，建议进行全面改进，特别是在服务质量和产品质量方面。"
        else -> "客户满意度较低，建议立即采取行动，制定详细的改进方案。"
    }

    // 生成满意度趋势分析
    val trendAnalysis = when {
        (mostSatisfied?.value ?: 0.0) - (leastSatisfied?.value ?: 0.0) > 20 -> "满意度差异较大，建议重点改进满意度较低的方面"
        (mostSatisfied?.value ?: 0.0) - (leastSatisfied?.value ?: 0.0) > 10 -> "满意度差异中等，建议均衡改进各个方面"
        else -> "满意度分布均衡，建议全面提升服务质量"
    }

    // 构建输出文本
    val result = StringBuilder()
    result.append("😊 客户满意度调查\n")
    result.append("═".repeat(60)).append("\n\n")
    
    result.append("📊 满意度基本信息\n")
    result.append("─".repeat(60)).append("\n")
    result.append("产品质量: ${String.format("%.1f", productQuality)} 分\n")
    result.append("服务态度: ${String.format("%.1f", serviceAttitude)} 分\n")
    result.append("交付速度: ${String.format("%.1f", deliverySpeed)} 分\n")
    result.append("价格合理性: ${String.format("%.1f", priceReasonability)} 分\n")
    result.append("整体满意度: ${String.format("%.1f", overallSatisfaction)} 分\n\n")

    result.append("📈 满意度分析\n")
    result.append("─".repeat(60)).append("\n")
    result.append("平均满意度: ${String.format("%.1f", averageSatisfaction)}/100\n")
    result.append("满意度等级: ${satisfactionLevel}\n")
    result.append("最满意项: ${mostSatisfied?.key} (${String.format("%.1f", mostSatisfied?.value ?: 0.0)} 分)\n")
    result.append("最不满意项: ${leastSatisfied?.key} (${String.format("%.1f", leastSatisfied?.value ?: 0.0)} 分)\n")
    result.append("满意度差距: ${String.format("%.1f", (mostSatisfied?.value ?: 0.0) - (leastSatisfied?.value ?: 0.0))} 分\n\n")

    result.append("🔍 满意度详情\n")
    result.append("─".repeat(60)).append("\n")
    result.append(satisfactionAnalysis.toString()).append("\n")

    result.append("💬 客户反馈\n")
    result.append("─".repeat(60)).append("\n")
    result.append(customerFeedback.toString()).append("\n")

    result.append("📊 满意度趋势\n")
    result.append("─".repeat(60)).append("\n")
    result.append("${trendAnalysis}\n\n")

    result.append("🎯 改进建议\n")
    result.append("─".repeat(60)).append("\n")
    result.append("${improvementAdvice}\n\n")

    result.append("📋 客户服务建议\n")
    result.append("─".repeat(60)).append("\n")
    result.append("1. 定期进行客户满意度调查，了解客户需求\n")
    result.append("2. 建立客户反馈机制，及时收集和处理反馈\n")
    result.append("3. 加强员工培训，提升服务质量\n")
    result.append("4. 优化产品和服务，满足客户期望\n")
    result.append("5. 建立客户关系管理系统，提高客户满意度\n")
    result.append("6. 定期分析满意度数据，制定改进计划\n")
    result.append("7. 建立客户投诉处理机制，及时解决问题\n")
    result.append("8. 提供多渠道客户支持，方便客户联系\n")
    result.append("9. 建立客户忠诚度计划，提高客户保留率\n")
    result.append("10. 定期评估客户满意度改进效果\n\n")

    result.append("🔧 服务改进方法\n")
    result.append("─".repeat(60)).append("\n")
    result.append("• 提高产品质量: 加强质量控制，使用更好的材料\n")
    result.append("• 改进服务态度: 培训员工，提高服务意识\n")
    result.append("• 加快交付速度: 优化流程，提高效率\n")
    result.append("• 调整价格策略: 提供更好的价值，合理定价\n")
    result.append("• 建立反馈机制: 收集客户意见，持续改进\n")
    result.append("• 提供个性化服务: 了解客户需求，定制服务\n")
    result.append("• 建立长期关系: 维护客户关系，提高忠诚度\n")
    result.append("• 持续创新: 推出新产品和服务，满足市场需求\n\n")

    result.append("⚖️ 满意度等级标准\n")
    result.append("─".repeat(60)).append("\n")
    result.append("• 非常满意 (90-100分): 客户非常满意，会推荐给他人\n")
    result.append("• 满意 (80-89分): 客户满意，会继续购买\n")
    result.append("• 一般满意 (70-79分): 客户基本满意，但有改进空间\n")
    result.append("• 基本满意 (60-69分): 客户基本满意，但有较多不满意\n")
    result.append("• 不满意 (0-59分): 客户不满意，可能流失\n")

    return result.toString()
}

代码说明

这段 Kotlin 代码实现了完整的客户满意度分析和改进建议功能。让我详细解释关键部分：

数据验证：首先验证输入的各项满意度评分是否有效，确保数据在 0-100 范围内。

平均计算：计算所有满意度评分的平均值，这是评估整体客户满意度的关键指标。

等级评估：根据平均满意度给出相应的满意度等级，从非常满意到不满意。

项目分析：找出最满意项和最不满意项，计算两者的差距，帮助识别改进方向。

建议生成：根据各项指标生成个性化的客户反馈和改进建议。

---

JavaScript 调用示例

编译后的 JavaScript 代码可以在 Node.js 或浏览器中直接调用。以下是 JavaScript 的使用示例：

// 导入编译后的 Kotlin/JS 模块
const { customerSatisfactionAnalyzer } = require('./hellokjs.js');

// 示例 1：非常满意
const result1 = customerSatisfactionAnalyzer("85 90 78 88 92");
console.log("示例 1 - 非常满意:");
console.log(result1);
console.log("\n");

// 示例 2：满意
const result2 = customerSatisfactionAnalyzer("82 85 80 82 84");
console.log("示例 2 - 满意:");
console.log(result2);
console.log("\n");

// 示例 3：一般满意
const result3 = customerSatisfactionAnalyzer("75 72 70 75 73");
console.log("示例 3 - 一般满意:");
console.log(result3);
console.log("\n");

// 示例 4：基本满意
const result4 = customerSatisfactionAnalyzer("65 62 60 65 63");
console.log("示例 4 - 基本满意:");
console.log(result4);
console.log("\n");

// 示例 5：不满意
const result5 = customerSatisfactionAnalyzer("55 50 45 52 48");
console.log("示例 5 - 不满意:");
console.log(result5);
console.log("\n");

// 示例 6：使用默认参数
const result6 = customerSatisfactionAnalyzer();
console.log("示例 6 - 使用默认参数:");
console.log(result6);

// 实际应用场景：从用户输入获取数据
function analyzeSatisfaction(userInput) {
    try {
        const result = customerSatisfactionAnalyzer(userInput);
        return {
            success: true,
            data: result
        };
    } catch (error) {
        return {
            success: false,
            error: error.message
        };
    }
}

// 测试实际应用
const userInput = "88 92 82 85 87";
const analysis = analyzeSatisfaction(userInput);
if (analysis.success) {
    console.log("客户满意度分析结果:");
    console.log(analysis.data);
} else {
    console.log("分析失败:", analysis.error);
}

// 多个客户满意度对比
function compareSatisfaction(customers) {
    console.log("\n多个客户满意度对比:");
    console.log("═".repeat(60));
    
    const results = customers.map((customer, index) => {
        const analysis = customerSatisfactionAnalyzer(customer);
        return {
            number: index + 1,
            customer,
            analysis
        };
    });

    results.forEach(result => {
        console.log(`\n客户 ${result.number} (${result.customer}):`);
        console.log(result.analysis);
    });

    return results;
}

// 测试多个客户满意度对比
const customers = [
    "85 90 78 88 92",
    "82 85 80 82 84",
    "75 72 70 75 73",
    "65 62 60 65 63"
];

compareSatisfaction(customers);

// 客户满意度统计分析
function analyzeSatisfactionStats(customers) {
    const data = customers.map(customer => {
        const parts = customer.split(' ').map(Number);
        return {
            quality: parts[0],
            attitude: parts[1],
            speed: parts[2],
            price: parts[3],
            overall: parts[4]
        };
    });

    console.log("\n客户满意度统计分析:");
    console.log(`平均产品质量: ${(data.reduce((sum, d) => sum + d.quality, 0) / data.length).toFixed(1)}`);
    console.log(`平均服务态度: ${(data.reduce((sum, d) => sum + d.attitude, 0) / data.length).toFixed(1)}`);
    console.log(`平均交付速度: ${(data.reduce((sum, d) => sum + d.speed, 0) / data.length).toFixed(1)}`);
    console.log(`平均价格合理性: ${(data.reduce((sum, d) => sum + d.price, 0) / data.length).toFixed(1)}`);
    console.log(`平均整体满意度: ${(data.reduce((sum, d) => sum + d.overall, 0) / data.length).toFixed(1)}`);
}

analyzeSatisfactionStats(customers);

JavaScript 代码说明

这段 JavaScript 代码展示了如何在 Node.js 环境中调用编译后的 Kotlin 函数。关键点包括：

模块导入：使用 require 导入编译后的 JavaScript 模块，获取导出的 customerSatisfactionAnalyzer 函数。

多个示例：展示了不同满意度等级的调用方式，包括非常满意、满意、一般满意、基本满意、不满意等。

错误处理：在实际应用中，使用 try-catch 块来处理可能的错误。

多客户对比：compareSatisfaction 函数展示了如何对比多个客户的满意度。

统计分析：analyzeSatisfactionStats 函数演示了如何进行客户满意度统计分析。

---

ArkTS 页面集成与调用

在 OpenHarmony 的 ArkTS 页面中集成这个客户满意度调查分析工具。以下是完整的 ArkTS 实现代码：

import { customerSatisfactionAnalyzer } from './hellokjs';

@Entry
@Component
struct CustomerSatisfactionAnalyzerPage {
  @State productQuality: string = "85";
  @State serviceAttitude: string = "90";
  @State deliverySpeed: string = "78";
  @State priceReasonability: string = "88";
  @State overallSatisfaction: string = "92";
  @State analysisResult: string = "";
  @State isLoading: boolean = false;

  build() {
    Column() {
      // 顶部栏
      Row() {
        Text("😊 客户满意度调查")
          .fontSize(24)
          .fontWeight(FontWeight.Bold)
          .fontColor(Color.White)
      }
      .width("100%")
      .height(60)
      .backgroundColor("#6A1B9A")
      .justifyContent(FlexAlign.Center)
      .padding({ top: 10, bottom: 10 })

      // 主容器
      Scroll() {
        Column() {
          // 产品质量输入
          Text("产品质量 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ top: 20, left: 15 })

          TextInput({
            placeholder: "例如: 85",
            text: this.productQuality
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#F3E5F5")
            .border({ width: 1, color: "#6A1B9A" })
            .onChange((value: string) => {
              this.productQuality = value;
            })

          // 服务态度输入
          Text("服务态度 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 90",
            text: this.serviceAttitude
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#F3E5F5")
            .border({ width: 1, color: "#6A1B9A" })
            .onChange((value: string) => {
              this.serviceAttitude = value;
            })

          // 交付速度输入
          Text("交付速度 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 78",
            text: this.deliverySpeed
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#F3E5F5")
            .border({ width: 1, color: "#6A1B9A" })
            .onChange((value: string) => {
              this.deliverySpeed = value;
            })

          // 价格合理性输入
          Text("价格合理性 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 88",
            text: this.priceReasonability
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#F3E5F5")
            .border({ width: 1, color: "#6A1B9A" })
            .onChange((value: string) => {
              this.priceReasonability = value;
            })

          // 整体满意度输入
          Text("整体满意度 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 92",
            text: this.overallSatisfaction
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#F3E5F5")
            .border({ width: 1, color: "#6A1B9A" })
            .onChange((value: string) => {
              this.overallSatisfaction = value;
            })

          // 按钮区域
          Row() {
            Button("📊 分析满意度")
              .width("45%")
              .height(45)
              .backgroundColor("#6A1B9A")
              .fontColor(Color.White)
              .fontSize(16)
              .fontWeight(FontWeight.Bold)
              .onClick(() => {
                this.isLoading = true;
                setTimeout(() => {
                  const input = `${this.productQuality} ${this.serviceAttitude} ${this.deliverySpeed} ${this.priceReasonability} ${this.overallSatisfaction}`;
                  this.analysisResult = customerSatisfactionAnalyzer(input);
                  this.isLoading = false;
                }, 300);
              })

            Blank()

            Button("🔄 重置")
              .width("45%")
              .height(45)
              .backgroundColor("#2196F3")
              .fontColor(Color.White)
              .fontSize(16)
              .fontWeight(FontWeight.Bold)
              .onClick(() => {
                this.productQuality = "85";
                this.serviceAttitude = "90";
                this.deliverySpeed = "78";
                this.priceReasonability = "88";
                this.overallSatisfaction = "92";
                this.analysisResult = "";
                this.isLoading = false;
              })
          }
          .width("90%")
          .margin({ top: 10, bottom: 20, left: 15, right: 15 })
          .justifyContent(FlexAlign.SpaceBetween)

          // 加载指示器
          if (this.isLoading) {
            Row() {
              LoadingProgress()
                .width(40)
                .height(40)
                .color("#6A1B9A")
              Text("  正在分析中...")
                .fontSize(14)
                .fontColor("#666666")
            }
            .width("90%")
            .height(50)
            .margin({ bottom: 15, left: 15, right: 15 })
            .justifyContent(FlexAlign.Center)
            .backgroundColor("#F3E5F5")
            .borderRadius(8)
          }

          // 结果显示区域
          if (this.analysisResult.length > 0) {
            Column() {
              Text("📋 分析结果")
                .fontSize(16)
                .fontWeight(FontWeight.Bold)
                .fontColor("#6A1B9A")
                .margin({ bottom: 10 })

              Text(this.analysisResult)
                .width("100%")
                .fontSize(12)
                .fontFamily("monospace")
                .fontColor("#333333")
                .lineHeight(1.6)
                .padding(10)
                .backgroundColor("#FAFAFA")
                .border({ width: 1, color: "#E0E0E0" })
                .borderRadius(8)
            }
            .width("90%")
            .margin({ top: 20, bottom: 30, left: 15, right: 15 })
            .padding(15)
            .backgroundColor("#F3E5F5")
            .borderRadius(8)
            .border({ width: 1, color: "#6A1B9A" })
          }
        }
        .width("100%")
      }
      .layoutWeight(1)
      .backgroundColor("#FFFFFF")
    }
    .width("100%")
    .height("100%")
    .backgroundColor("#F5F5F5")
  }
}

ArkTS 代码说明

这段 ArkTS 代码实现了完整的用户界面和交互逻辑。关键点包括：

导入函数：从编译后的 JavaScript 模块中导入 customerSatisfactionAnalyzer 函数。

状态管理：使用 @State 装饰器管理七个状态：产品质量、服务态度、交付速度、价格合理性、整体满意度、分析结果和加载状态。

UI 布局：包含顶部栏、五个输入框、分析满意度和重置按钮、加载指示器和结果显示区域。

交互逻辑：用户输入满意度评分后，点击分析满意度按钮。应用会调用 Kotlin 函数进行分析，显示加载动画，最后展示详细的分析结果。

样式设计：使用紫色主题，与客户服务和满意度相关的主题相符。所有输入框、按钮和结果显示区域都有相应的样式设置。

---

数据输入与交互体验

输入数据格式规范

为了确保工具能够正确处理用户输入，用户应该遵循以下规范：

1. 产品质量：整数或浮点数，范围 0-100。
2. 服务态度：整数或浮点数，范围 0-100。
3. 交付速度：整数或浮点数，范围 0-100。
4. 价格合理性：整数或浮点数，范围 0-100。
5. 整体满意度：整数或浮点数，范围 0-100。
6. 分隔符：使用空格分隔各个参数。

示例输入

• 非常满意：85 90 78 88 92
• 满意：82 85 80 82 84
• 一般满意：75 72 70 75 73
• 基本满意：65 62 60 65 63
• 不满意：55 50 45 52 48

交互流程

1. 用户打开应用，看到输入框和默认数据
2. 用户输入五项满意度评分
3. 点击"分析满意度"按钮，应用调用 Kotlin 函数进行分析
4. 应用显示加载动画，表示正在处理
5. 分析完成后，显示详细的分析结果，包括平均满意度、等级、建议等
6. 用户可以点击"重置"按钮清空数据，重新开始

---

编译与自动复制流程

编译步骤

1. 编译 Kotlin 代码：

   ./gradlew build
   

2. 生成 JavaScript 文件：
   编译过程会自动生成 hellokjs.d.ts 和 hellokjs.js 文件。

3. 复制到 ArkTS 项目：
   使用提供的脚本自动复制生成的文件到 ArkTS 项目的 pages 目录：

   ./build-and-copy.bat
   

文件结构

编译完成后，项目结构如下：

kmp_openharmony/
├── src/
│   └── jsMain/
│       └── kotlin/
│           └── App.kt (包含 customerSatisfactionAnalyzer 函数)
├── build/
│   └── js/
│       └── packages/
│           └── hellokjs/
│               ├── hellokjs.d.ts
│               └── hellokjs.js
└── kmp_ceshiapp/
    └── entry/
        └── src/
            └── main/
                └── ets/
                    └── pages/
                        ├── hellokjs.d.ts (复制后)
                        ├── hellokjs.js (复制后)
                        └── Index.ets (ArkTS 页面)

---

总结

这个案例展示了如何使用 Kotlin Multiplatform 技术实现一个跨端的客户服务工具 - 客户满意度调查分析工具。通过将核心逻辑写在 Kotlin 中，然后编译为 JavaScript，最后在 ArkTS 中调用，我们实现了代码的一次编写、多端复用。

核心优势

1. 代码复用：Kotlin 代码可以在 JVM、JavaScript 和其他平台上运行，避免重复开发。
2. 类型安全：Kotlin 的类型系统确保了代码的安全性和可维护性。
3. 性能优化：Kotlin 编译为 JavaScript 后，性能与手写 JavaScript 相当。
4. 易于维护：集中管理业务逻辑，使得维护和更新变得更加容易。
5. 用户体验：通过 ArkTS 提供的丰富 UI 组件，可以创建美观、易用的用户界面。

扩展方向

1. 数据持久化：将客户满意度调查数据保存到本地存储或云端。
2. 数据可视化：使用图表库展示满意度趋势和对比。
3. 多客户管理：支持多个客户的满意度管理和对比。
4. 满意度预警：设置满意度预警阈值，及时提醒满意度下降。
5. 满意度报表：生成详细的满意度调查报表和分析报告。
6. 集成 CRM：与客户关系管理系统集成，获取客户信息。
7. AI 分析：使用机器学习进行满意度预测和优化建议。
8. 团队协作：支持客户服务团队的满意度管理和协作。

通过这个案例，开发者可以学到如何在 KMP 项目中实现复杂的客户满意度分析逻辑，以及如何在 OpenHarmony 平台上构建高效的跨端应用。这个客户满意度调查分析工具可以作为客户服务平台、客户关系管理系统或满意度管理工具的核心模块。