功能使用说明 · 图文教程
从客服处获取最新版安装包，根据系统版本选择对应安装包（目前只支持windows系统）。
安装完成后，账号密码登录软件，使用授权码完成激活。
登录成功后，系统会自动进行环境检测，确保运行环境正常。
$ hez --activate YOUR_LICENSE_KEY
[INFO] 正在验证授权码...
[OK] 授权验证成功
[INFO] 设备指纹: xxxxxxxx
[INFO] 授权到期: 2027-03-28
[OK] 环境检测通过，欢迎使用 HEZ扫码登录微信
将机器人微信拉进需要记账的群聊
添加需要使用机器人记账的员工微信好友
员工微信在任意微信群发送/授权码，机器人微信会反馈员工微信id，然后去软件上员工列表开启管理员权限
有管理员权限的员工可以在群聊发送/开启收货群 /开启出货群 /开启内部群 指令 就可以记账和群发了
建议按业务分别开启收货/出货群聊 方便后台交易的数据分析
系统采用多级权限管理，确保操作安全可控：
拥有全部权限，可管理所有群和员工
管理指定群聊，可分配员工权限
仅可进行记账操作，无管理权限
仅可查看数据，无操作权限
员工微信使用需完成以下步骤：
员工发送授权码到群聊
员工在群聊中发送"授权码"，机器人自动反馈该员工的wxid
后台审核并开启授权
管理员在后台审核员工wxid，确认无误后开启授权
授权成功，员工可操作系统功能
根据分配的权限范围，员工可正常操作对应的功能
系统支持多种记账格式，灵活满足不同业务场景：
+600 # 收款600元
−600 # 付款600元+600*4 # 600×4 = 2400
−600*4+600*4 卡密 # 600×4 =2400 附带卡密信息
−600*4 卡密+500*5*5 # 500×5×5 = 12500
−500*5*5+800/4 # 800÷4 = 200
−600/4 +800/4+8 # 800÷4+8 = 208
−600/4+9 每个群聊拥有独立账本，数据互不干扰。
支持跨群汇总统计，方便全局把控。
支持按日/周/月导出账单，格式支持 Excel：
日账单
每日交易明细
周账单
每周汇总报表
月账单
每月财务报表
不同群类型对应不同的记账规则：
| 群类型 | 说明 | 记账规则 |
|---|---|---|
| 收卡群 | 用于回收卡密 | -金额 付款 |
| 出卡群 | 用于出售卡密 | +金额 收款 |
| 内部群 | 内部管理使用 | 双向记账，内部指令包括群发 |
支持按分组群发消息，可设置发送间隔防封：
指令格式：/群发 分组 间隔 内容
示例：
/群发 分组1 5s 今日汇率已更新
/群发 分组2 3s 新卡到货，欢迎选购
/群发 分组3 10s 系统维护通知| 指令 | 功能 | 示例 |
|---|---|---|
+金额 |
收款记账 | +500 |
-金额 |
付款记账 | -300 |
+面值*汇率 |
卡密信息可选，用于记录交易凭证 | +500*6 |
/撤回 |
撤回上条记录 | /撤回 |
/显示 |
显示当前账单 | /显示 |
/清账 |
清空当前账单 | /清账 确认 |
| 指令 | 功能 | 示例 |
|---|---|---|
/开启内部群 |
用于开启内部管理群聊，方便内部指令的发送 | /开启内部群 |
/开启收货群 |
用于开启收货的群聊记账权限 | /开启收货群 |
/开启出货群 |
用于开启出货的群聊记账权限 | /开启出货群 |
/群发 |
内部群使用，群发消息 | /群发 分组名 群发间隔(秒)建议3秒 内容 |
/停止 |
内部群使用，停止群发功能 | /export excel |
系统支持自动回复，可配置回复内容模板：
支持变量：
{nick} - 用户昵称
{amount} - 记账金额
{time} - 操作时间
{balance} - 当前余额
示例模板：
"✅ {nick} 您好！已收到 {amount} 元，记账成功！"
"📊 今日总收：{income} 元，总支：{expense} 元"卡密交易是核心业务，需要详细记录以下信息：
格式：+面值*汇率 卡密
示例：
+500*6 xxxxxxxx # 面值500，汇率6，卡密xxxxxxxx
+100*7.2 yyyyyyyy # 面值100，汇率7.2，卡密yyyyyyyy
+50*1.1 zzzzzzzz # 面值50，汇率1.1，卡密zzzzzzzz
说明：
- 面值：卡的原始金额
- 汇率：兑换人民币的汇率
- 卡密：卡密的标识或后四位多条汇率记录时的计算方式：
示例解析：
消息："+500*6.1*6.2 xxx eur"
→ 汇率取 6.2（最后一个）
→ 实际金额 = 500× 6.1× 6.2 = 18,910 元为用户提供以下功能：
系统提供多维度数据统计分析：
收入
总收入金额
支出
总支出金额
利润
收入-支出
笔数
交易总笔数
支持多种可视化图表：
支持多种格式的报表导出：
| 格式 | 适用场景 | 包含内容 |
|---|---|---|
.xlsx |
财务核对 | 完整交易明细 |
.csv（正在优化） |
数据导入 | 结构化数据 |
HEZ 内置多协议防封引擎，支持动态切换登录协议：
协议 A - 标准模式
稳定性高，适合日常使用
协议 B - 增强模式
更高兼容性，适合批量操作
新账号建议前3天仅用于日常聊天，不要立即开启记账功能，建立账号活跃度。
避免在短时间内大量添加好友或频繁加群，控制操作频率。
如果协议A被检测，下次登录可以手动切换协议B
定期检查账号状态，如收到安全提醒请及时联系客服处理。
| 指令 | 说明 | 示例 |
|---|---|---|
/today |
查看今日账单 | /today |
/week |
查看本周汇总 | /week |
/month |
查看本月汇总 | /month |
/export |
导出账单文件 | /export excel |
/help |
查看所有指令 | /help |
/status |
查看系统状态 | /status |
系统支持多种通知方式，确保重要信息不遗漏：
每日汇总、异常交易告警推送到指定微信
周报/月报自动发送到绑定邮箱
可视化数据面板，实时查看经营状况
群内实时播报交易记录和统计
授权码为一次性绑定，绑定后不可更换设备。如需更换设备，请联系客服处理：
建议定期导出账单：
请按以下步骤排查：
| 错误代码 | 说明 | 解决方案 |
|---|---|---|
ERR_001 |
授权码无效 | 联系客服重新获取授权码 |
ERR_002 |
设备绑定失败 | 当前设备已绑定其他账号 |
ERR_003 |
授权已过期 | 续费后重新激活 |
ERR_004 |
网络连接失败 | 检查网络或切换网络环境 |
ERR_005 |
协议连接异常 | 尝试切换其他协议 |
系统日志可以帮助定位问题：
# 查看最近100条日志
hez logs --lines 100
# 查看错误级别日志
hez logs --level error
# 实时查看日志
hez logs -f