春节期间，棋牌娱乐是不可或缺的传统项目。线下搓麻将、抓扑克带来的真实触感与社交温度，是任何线上平台都难以替代的。然而，线下娱乐也伴随着一个现实痛点：输赢与积分的统计。
传统方式多依赖筹码或纸笔——但普通家庭 seldom 备有专业筹码；而手写记录不仅繁琐，还易出错，最终结算时更缺乏直观性与可信度。于是，我决定用 CC（Claude Code）开发一款轻量级小程序，融合“小程序的便捷性 + AI 的智能分析”，实现高效、准确、有趣的记账体验。
项目启动后，我参考了多款同类小程序，却总觉得少了点“人味”：操作不够直觉、流程略显冗余、缺乏对真实牌局节奏的尊重。于是，我立刻与 AI 展开深度需求对齐，并基于过往开发经验，快速敲定技术栈：**uni-app（前端跨端兼容） + Python（后端逻辑与 AI 接口） + MySQL（数据持久化）**——不求一步登天，先做出可用的一版。
在 HBuilderX 中快速初始化 uni-app 模板后，我梳理出核心功能模块：
- 房间创建与管理
- 好友邀请机制
- 实时记账页面（支持增减分）
- 一键结算面板
- 历史记录查询
起初设想是全员进小程序同步操作，但很快发现：牌局节奏快、操作越少越好。于是新增「单人记账」模式——房主创建房间后，仅需录入成员姓名，即可开启记账；全程由房主一人完成所有积分操作，其他人专注打牌，零干扰。
但手动输入依然拖慢节奏。如果能在摸牌间隙说一句：“张三输5分，李四赢10分”，系统便自动完成记分，该有多好？
为此，我引入 LLM 大语言模型，构建语音驱动记账流程：
1. 小程序端调起录音 → 上传语音至后端
2. 后端交由大模型解析语义 → 输出标准记分 JSON（含人员、方向、数值）
3. 前端实时响应，动态更新积分面板
落地过程中遇到两个关键挑战：
🔹 小程序录音需用户授权，且部分机型兼容性差；
🔹 语音识别出的姓名需精准匹配房间成员，存在同音、昵称、口误等歧义风险。
面对问题，我选择「先跑通、再优化」策略：暂避原生录音，改用手机输入法自带的语音转文字能力——用户在文本框中语音输入一句话，点击「AI记分」按钮，后端即刻解析并执行。功能闭环先行，体验打磨后续迭代。
随后，将代码导入微信开发者工具调试，配置 HTTPS 后端域名、完成 SSL 证书部署。期间需申请微信小程序 AppID（个人主体），并在提交审核前明确说明：本小程序为**个人兴趣项目，非商业用途，不涉及支付与用户隐私收集**。初审电话沟通后迅速完成修改，当日即通过；目前正进入国家互联网信息办公室备案审核流程。
小程序正式命名为 **「AI乐牌记账」**——取“乐在牌中，智在记账”之意。图标则交由豆包 AI 生成：红底金字，融入麻将筒子与对话气泡元素，简洁不失年味。
一局牌未终，账已算清；一声指令，分已落定。
这不是替代人情的工具，而是为热络的牌桌，添一份恰到好处的聪明。
