打牌记账-使用手册

版本: v1.3.0
更新日期: 2026-02-28
适用对象: 所有用户

目录

1. 项目概述
2. 快速开始
3. 功能详解
4. 使用场景示例
5. 常见问题解答
6. 故障排除

一、项目概述

1.1 什么是打牌记账应用？

打牌记账应用是一款专为牌友设计的实时多人记账工具。无论您是在打麻将、斗地主还是其他棋牌游戏，都可以通过这款应用轻松记录每局的输赢情况，自动计算每个人的盈亏，让结账变得简单透明。

1.2 核心功能

1.3 适用场景

• 🀄 麻将馆记账
• 🃏 扑克牌记账
• 🎲 其他棋牌游戏记账
• 💵 朋友间借款还款记录

1.4 技术优势

• 无需下载安装：直接通过浏览器访问，手机电脑都能用
• 无需注册账号：输入昵称即可使用，简单快捷
• 数据实时保存：所有记录自动保存，不用担心丢失
• 跨平台支持：支持手机、平板、电脑等各种设备

二、快速开始

2.1 环境准备

系统要求

推荐浏览器

为了获得最佳使用体验，建议使用以下浏览器：

• ✅ Google Chrome（推荐）
• ✅ Apple Safari
• ✅ Mozilla Firefox
• ✅ Microsoft Edge

2.2 访问应用

方式一：直接访问网址

1. 打开浏览器
2. 在地址栏输入：https://www.hqxiaozou.top/puke
3. 按回车键进入应用

方式二：扫描二维码（如有提供）

1. 打开手机相机或微信扫一扫
2. 扫描应用二维码
3. 自动跳转到应用页面

2.3 首次使用流程

┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   打开应用   │ →  │   创建房间   │ →  │   输入昵称   │
└─────────────┘    └─────────────┘    └─────────────┘
                                            ↓
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│   开始记账   │ ←  │   邀请好友   │ ←  │   进入房间   │
└─────────────┘    └─────────────┘    └─────────────┘

三、功能详解

3.1 首页功能

界面介绍

打开应用后，您会看到以下界面：

┌─────────────────────────────────────┐
│                 🎴                  │
│              打牌记账                │
│       简单、实时的多人记账工具        │
├─────────────────────────────────────┤
│                                     │
│     ┌───────────┐  ┌───────────┐    │
│     │  创建房间  │  │  加入房间  │    │
│     └───────────┘  └───────────┘    │
│                                     │
│     ┌───────────────────────────┐   │
│     │    我加入的房间（新增）    │   │
│     └───────────────────────────┘   │
│                                     │
└─────────────────────────────────────┘

功能按钮说明

3.2 创建房间

操作步骤

步骤1：点击"创建房间"按钮

在首页点击蓝色的"创建房间"大按钮。

步骤2：输入您的昵称

┌─────────────────────────────────────┐
│  创建房间                    [×]   │
├─────────────────────────────────────┤
│                                     │
│  请输入您的昵称                      │
│                                     │
│  ┌─────────────────────────────┐   │
│  │  输入昵称（2-10个字符）      │   │
│  └─────────────────────────────┘   │
│                                     │
│    ┌──────────┐  ┌──────────┐      │
│    │   取消   │  │   创建   │      │
│    └──────────┘  └──────────┘      │
│                                     │
└─────────────────────────────────────┘

昵称规则：

• 长度：2-10个字符
• 支持：中文、英文、数字
• 示例："张三"、"小明"、"Player1"

步骤3：点击"创建"按钮

系统会自动创建房间并跳转到房间页面。

创建成功后的界面

┌─────────────────────────────────────┐
│  房间号：ABCD1234              [≡] │
├─────────────────────────────────────┤
│  房主：张三                          │
│  创建时间：2026-02-28 10:30:00      │
├─────────────────────────────────────┤
│                                     │
│    ┌─────┐ ┌─────┐ ┌─────┐        │
│    │ 张三 │ │     │ │     │        │
│    │ 👑  │ │  +  │ │  +  │        │
│    └─────┘ └─────┘ └─────┘        │
│                                     │
│    （等待其他玩家加入...）           │
│                                     │
├─────────────────────────────────────┤
│  暂无记账记录                        │
├─────────────────────────────────────┤
│  [复制链接]  [结算房间]              │
└─────────────────────────────────────┘

界面元素说明：

3.3 加入房间

操作步骤

步骤1：获取房间号

向房主索要8位房间号，如"ABCD1234"。

步骤2：点击"加入房间"按钮

在首页点击灰色的"加入房间"按钮。

步骤3：输入房间号

┌─────────────────────────────────────┐
│                                     │
│  房间号                              │
│  ┌───────────────────┐ ┌──────┐    │
│  │   ABCD1234        │ │ 进入 │    │
│  └───────────────────┘ └──────┘    │
│                                     │
└─────────────────────────────────────┘

步骤4：点击"进入"按钮

步骤5：输入昵称

如果是首次加入该房间，需要输入昵称：

┌─────────────────────────────────────┐
│  加入房间                    [×]   │
├─────────────────────────────────────┤
│                                     │
│  请输入您的昵称                      │
│                                     │
│  ┌─────────────────────────────┐   │
│  │  输入昵称（2-10个字符）      │   │
│  └─────────────────────────────┘   │
│                                     │
│         ┌──────────┐               │
│         │   确认   │               │
│         └──────────┘               │
│                                     │
└─────────────────────────────────────┘

注意：

• 同一个房间内不能有重复的昵称
• 如果提示"用户名已存在"，请更换其他昵称

3.4 房间界面详解

3.4.1 顶部信息栏

┌─────────────────────────────────────┐
│  房间号：ABCD1234              [≡] │  ← 点击可复制房间号
├─────────────────────────────────────┤
│  房主：张三                          │  ← 显示房主昵称
│  创建时间：2026-02-28 10:30:00      │  ← 房间创建时间
└─────────────────────────────────────┘

3.4.2 用户列表区域

┌─────────────────────────────────────┐
│                                     │
│  ┌─────┐  ┌─────┐  ┌─────┐        │
│  │ 张三 │  │ 李四 │  │ 王五 │        │
│  │ 👑  │  │     │  │     │        │
│  │+120 │  │ -50 │  │ -70 │        │
│  └─────┘  └─────┘  └─────┘        │
│                                     │
│  ┌─────┐  ┌─────┐  ┌─────┐        │
│  │ 赵六 │  │     │  │     │        │
│  │     │  │  +  │  │  +  │        │
│  │     │  │     │  │     │        │
│  └─────┘  └─────┘  └─────┘        │
│                                     │
└─────────────────────────────────────┘

用户卡片说明：

3.4.3 记账操作

如何记账：

1. 点击要付款的用户（输钱的人）
2. 在弹窗中选择收款人（赢钱的人）
3. 输入金额
4. 点击确认

示例：张三输给李四50元

步骤1：点击"张三"的卡片
         ↓
步骤2：在弹窗中选择"李四"
         ↓
步骤3：输入金额 50
         ↓
步骤4：点击"确认记账"

记账弹窗界面：

┌─────────────────────────────────────┐
│  记账：张三 → 李四           [×]   │
├─────────────────────────────────────┤
│                                     │
│  付款人：张三                        │
│  收款人：李四                        │
│                                     │
│  金额（元）                          │
│  ┌─────────────────────────────┐   │
│  │           50                │   │
│  └─────────────────────────────┘   │
│                                     │
│    ┌──────────┐  ┌──────────┐      │
│    │   取消   │  │ 确认记账 │      │
│    └──────────┘  └──────────┘      │
│                                     │
└─────────────────────────────────────┘

记账规则：

• 金额必须是正整数
• 最小金额：1元
• 最大金额：无限制（但请合理记账）

3.4.4 记账记录列表

┌─────────────────────────────────────┐
│  记账记录                            │
├─────────────────────────────────────┤
│                                     │
│  2月28日 10:35                      │
│  张三向李四记账50元                  │
│                                     │
│  2月28日 10:32                      │
│  王五向张三记账30元                  │
│                                     │
│  2月28日 10:30                      │
│  李四向王五记账20元                  │
│                                     │
└─────────────────────────────────────┘

记录说明：

• 按时间倒序排列，最新的记录在最上面
• 显示完整的时间和金额
• 所有玩家都能看到相同的记录

3.4.5 底部操作栏

┌─────────────────────────────────────┐
│                                     │
│  [📋 复制链接]    [💰 结算房间]      │
│                                     │
└─────────────────────────────────────┘

按钮说明：

3.5 邀请好友（二维码）

功能说明

当房间内人数少于8人时，系统会在用户列表中显示一个"+"加号卡片。点击该卡片可以：

• 生成房间二维码
• 显示房间链接
• 一键复制链接分享给好友

操作步骤

步骤1：点击"+"加号卡片

在用户列表中找到带有"+"号的虚线边框卡片，点击它。

步骤2：查看二维码

┌─────────────────────────┐
│  邀请好友            [×] │
├─────────────────────────┤
│                         │
│    ┌─────────────┐      │
│    │   二维码     │      │
│    │             │      │
│    └─────────────┘      │
│                         │
│  [房间URL...] [复制]     │
│                         │
│  扫描二维码或复制链接邀请 │
└─────────────────────────┘

步骤3：分享房间

• 方式一：让好友扫描二维码
• 方式二：点击"复制"按钮，将链接发送给好友

注意事项：

• 房间满8人后，加号卡片会自动消失
• 房间结算后，加号卡片也会消失
• 二维码有效期与房间有效期一致

3.6 修改昵称

操作步骤

步骤1：点击自己的头像

在房间界面，点击带有蓝色背景的自己头像。

步骤2：输入新昵称

┌─────────────────────────────────────┐
│  修改昵称                    [×]   │
├─────────────────────────────────────┤
│                                     │
│  ┌─────────────────────────────┐   │
│  │         张三                │   │
│  └─────────────────────────────┘   │
│                                     │
│    ┌──────────┐  ┌──────────┐      │
│    │   取消   │  │   确认   │      │
│    └──────────┘  └──────────┘      │
│                                     │
└─────────────────────────────────────┘

步骤3：点击"确认"

修改效果：

• 用户列表中的昵称立即更新
• 所有历史记账记录中的昵称同步更新
• 其他玩家实时看到新昵称

注意事项：

• 不能与其他玩家重名
• 修改后所有相关记录都会更新

3.6 房间结算

结算功能说明

当牌局结束，需要结账时，房主可以使用"结算房间"功能：

1. 系统自动计算每个人的最终盈亏
2. 显示谁应该给谁多少钱
3. 关闭房间，禁止新的记账操作

操作步骤（仅房主）

步骤1：点击"结算房间"按钮

步骤2：确认结算

┌─────────────────────────────────────┐
│  ⚠️ 确认结算                 [×]   │
├─────────────────────────────────────┤
│                                     │
│         ┌──────────┐               │
│         │    ⚠️    │               │
│         └──────────┘               │
│                                     │
│      确定要结算并关闭房间吗？        │
│                                     │
│    结算后房间将关闭，无法继续记账    │
│                                     │
│    ┌──────────┐  ┌──────────┐      │
│    │   取消   │  │   确认   │      │
│    └──────────┘  └──────────┘      │
│                                     │
└─────────────────────────────────────┘

步骤3：查看结算结果

┌─────────────────────────────────────┐
│  📊 结算结果                 [×]   │
├─────────────────────────────────────┤
│                                     │
│  ┌─────────────────────────────┐   │
│  │  张三  👑                   │   │
│  │  应收：120元                │   │
│  └─────────────────────────────┘   │
│                                     │
│  ┌─────────────────────────────┐   │
│  │  李四                       │   │
│  │  应付：50元                 │   │
│  └─────────────────────────────┘   │
│                                     │
│  ┌─────────────────────────────┐   │
│  │  王五                       │   │
│  │  应付：70元                 │   │
│  └─────────────────────────────┘   │
│                                     │
│      ┌──────────────────┐          │
│      │     返回首页      │          │
│      └──────────────────┘          │
│                                     │
└─────────────────────────────────────┘

结算结果说明：

结算后的房间状态

• 🔒 房间已锁定，禁止新用户加入
• 🚫 禁止新的记账操作
• 👀 可以查看历史结算结果

3.7 "我加入的房间"功能

功能说明

这个功能可以查看您之前加入过的所有房间，包括：

• 正在进行的房间（未结算）
• 已经结束的房间（已结算）

操作步骤

步骤1：点击"我加入的房间"按钮

在首页点击"我加入的房间"按钮。

步骤2：查看房间列表

┌─────────────────────────────────────┐
│  我加入的房间                [×]   │
├─────────────────────────────────────┤
│                                     │
│  ┌──────────┐  ┌──────────┐        │
│  │  未结算  │  │  已结算  │        │  ← 筛选按钮
│  │    ●     │  │          │        │
│  └──────────┘  └──────────┘        │
├─────────────────────────────────────┤
│                                     │
│  ┌─────────────────────────────┐   │
│  │ ● 未结算                     │   │
│  │ 张三的房间                   │   │
│  │ ABCD1234                    │   │
│  │                    [加入]   │   │
│  └─────────────────────────────┘   │
│                                     │
│  ┌─────────────────────────────┐   │
│  │ ✓ 已结算                     │   │
│  │ 李四的房间                   │   │
│  │ EFGH5678                    │   │
│  │                    [查看]   │   │
│  └─────────────────────────────┘   │
│                                     │
└─────────────────────────────────────┘

筛选功能

切换筛选：

• 点击"未结算"按钮：只显示进行中的房间
• 点击"已结算"按钮：只显示已结束的房间
• 默认显示"未结算"房间

房间卡片信息

每个房间卡片显示：

• 状态标识（●未结算 / ✓已结算）
• 房间名称（房主昵称+"的房间"）
• 房间号（8位字母数字）
• 操作按钮（加入/查看）

四、使用场景示例

场景1：四人麻将记账

参与人员： 张三（房主）、李四、王五、赵六

牌局过程：

结算结果：

• 张三：应收 50元
• 李四：应付 50元
• 王五：应收 30元
• 赵六：应付 30元

实际转账：

• 李四给张三 50元
• 赵六给王五 30元

场景2：修改昵称

情况： 张三想把自己的昵称从"张三"改成"阿三"

操作步骤：

1. 在房间中点击自己的头像（蓝色背景的卡片）
2. 在弹窗中输入"阿三"
3. 点击"确认"
4. 所有玩家看到昵称已更新
5. 所有历史记录中的"张三"都变成了"阿三"

场景3：查看历史房间

情况： 昨天打牌的房间已经结算，今天想查看昨天的输赢

操作步骤：

1. 在首页点击"我加入的房间"
2. 点击"已结算"筛选按钮
3. 找到昨天的房间
4. 点击"查看"按钮
5. 查看结算结果

五、常见问题解答

Q1：房间号是什么？在哪里看？

A： 房间号是8位字母数字组合（如"ABCD1234"），在房间页面顶部显示。房主可以复制分享给好友。

Q2：一个房间最多多少人？

A： 最多支持8人同时在线。

Q3：昵称可以重复吗？

A： 同一个房间内不能有重复的昵称，但不同房间可以重复使用相同昵称。

Q4：我可以同时加入多个房间吗？

A： 可以，您可以在不同的房间使用不同的昵称。

Q5：房间数据会保存多久？

A： 房间数据会永久保存，您可以通过"我加入的房间"随时查看历史房间。

Q6：房主离线了怎么办？

A： 房主离线不影响其他玩家记账，只有结算操作需要房主在线。

Q7：可以删除记账记录吗？

A： 目前不支持删除记账记录，请谨慎操作。

Q8：金额输错了怎么办？

A： 可以记一笔反向的账来抵消。例如：误记了A给B 50元，可以再记一笔B给A 50元。

Q9：为什么我无法结算房间？

A： 只有房主可以结算房间。如果您不是房主，需要联系房主进行结算。

Q10：结算后还能继续记账吗？

A： 不能。结算后房间会关闭，禁止新的记账操作。

Q11：为什么我加入房间时提示"房间已满"？

A： 房间已达到8人上限，需要等有人退出或房主创建新房间。

Q12：为什么我加入房间时提示"用户名已存在"？

A： 该房间内已有相同的昵称，请更换其他昵称。

Q13：如何退出房间？

A： 直接关闭浏览器或返回首页即可。您的数据会自动保存。

Q14：手机可以使用吗？

A： 可以，本应用支持手机浏览器访问，界面已针对手机优化。

Q15：需要注册账号吗？

A： 不需要，输入昵称即可使用，简单快捷。

Q16：如何邀请好友加入房间？

A： 有两种方式：

1. 二维码邀请：点击用户列表中的"+"加号卡片，让好友扫描二维码
2. 链接分享：点击"+"加号卡片，复制房间链接发送给好友

Q17：为什么看不到"+"加号卡片？

A： 以下情况不会显示加号卡片：

• 房间已满8人
• 房间已结算
• 网络连接异常（刷新页面重试）

Q18：二维码有效期多久？

A： 二维码有效期与房间有效期一致，房间存在期间二维码一直有效。

六、故障排除

问题1：页面打不开

可能原因及解决方法：

问题2：无法创建房间

可能原因及解决方法：

1. 昵称格式错误

   • 检查：昵称是否为2-10个字符
   • 解决：修改昵称长度

2. 网络连接失败

   • 检查：网络是否正常
   • 解决：检查网络后重试

问题3：无法加入房间

可能原因及解决方法：

问题4：记账失败

可能原因及解决方法：

1. 房间已结算

   • 现象：提示"房间已结算，无法记账"
   • 解决：房间已关闭，无法继续记账

2. 网络断开

   • 现象：提示"网络错误"
   • 解决：检查网络，系统会自动重连

3. 金额输入错误

   • 现象：提示"请输入正确的金额"
   • 解决：输入正整数金额

问题5：WebSocket连接失败

现象： 页面提示"连接失败"或无法实时同步

解决方法：

1. 刷新页面重新连接
2. 检查网络是否稳定
3. 更换浏览器尝试
4. 清除浏览器缓存

问题6：数据显示不正确

现象： 余额显示错误或记录缺失

解决方法：

1. 刷新页面重新加载数据
2. 检查网络连接
3. 退出房间重新进入

问题7：界面显示异常

现象： 按钮错位、文字重叠等

解决方法：

1. 刷新页面
2. 清除浏览器缓存
3. 更换浏览器
4. 调整浏览器缩放比例（设置为100%）

联系支持

如果遇到无法解决的问题，请联系技术支持：

• 邮箱：1565453341@qq.com
• 微信：15795197338

附录

快捷键说明

浏览器设置建议

推荐设置：

1. 允许JavaScript运行（必须）
2. 允许Cookie（推荐）
3. 不要开启"阻止第三方Cookie"（可能影响功能）

手机使用技巧

1. 添加到主屏幕：可以将应用添加到手机桌面，像App一样使用

   • iOS：Safari分享按钮 → "添加到主屏幕"
   • Android：Chrome菜单 → "添加到主屏幕"

2. 横屏使用：手机横屏可以获得更好的视觉体验

祝您使用愉快！ 🎉