摘要：很多记账工具「能记」，但入口重、步骤多，最后很难坚持。本文介绍开源项目 iMoney：把微信聊天窗口当成随身记账入口，配合 Spring Boot 服务端与 微信 iLink，实现「想到就记，发一句就记」。

一、为什么从「聊天」切入记账？

记账类产品的痛点往往不在「能不能记」，而在：

• 打开 App 的路径长，打断当前场景；
• 分类、标签、表单填完，心理成本高；
• 个人还能勉强坚持，家庭 / 小团队协同又缺轻量入口。

微信是多数用户最高频打开的应用之一。若能在不离开聊天习惯的前提下完成记账、查账、预算与导出，坚持成本会低很多。iMoney 的产品侧围绕这一点展开。

---

二、功能介绍 + 演示图占位

定位：iMoney 记账助手，通过 微信 iLink协议 作为通道，使微信客户端与后端记账逻辑进行交互，实现数据持久化。

2.1 能力一览

方向	说明
聊天式快捷记账	在微信里直接发结构化短句即可记账，例如 +100 工资、-18 午饭、-32 打车。
口语化 / 自然语言	如「今天中午吃饭花了 28」；启用大模型解析时效果更稳，未启用时以规则与指令为主。
语音一键记账	发语音 → 识别解析 → 入账，适合边走边记、不便打字。
微信即入口	缩短「想记 → 完成记」的路径，降低坚持成本。
轻量协作记账	家庭、情侣、小团队、室友等「一起记」：共享圈子与账本。
预算	按日 / 月 / 年等周期关注额度与支出节奏。
分析与复盘	按时间、分类、圈子等维度汇总收支。
导出	如 Excel 导出，便于存档与二次分析。

连接微信侧可发 「菜单」、「帮助」（以当前版本为准）。iLink 可参考：wechat-ilink-sdk-java。

2.2 演示图

菜单 / 帮助入口

语音快捷记账

口语化 / 自然语言

导出Excel

消费分析

轻量协作记账

设置预算

扫码登录页（浏览器 index.html）

这里功能就不一一演示了，更多有趣的功能大家就自己摸索体验吧
—**

三、技术栈与仓库职责

• 运行时：Spring Boot、MyBatis-Plus、Redis（按配置）、MySQL。
• 业务域：圈子与协作、记账流水、预算、指令路由、与 IM / 机器人链路对接；可选 智谱 等（IMAI_ZHIPU_* 环境变量）。
• 微信侧：内置扫码页，启动后访问 index.html 即可拉二维码（演示图见上一节最后一项）。

表结构见仓库 doc/sql/imoney-schema.sql；模块边界见仓库 README 的「服务端模块说明」。

---

四、本地快速跑通（最小步骤）

4.1 建库与导入表结构

CREATE DATABASE imoney DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

在同一库执行 doc/sql/imoney-schema.sql。

4.2 环境变量（勿把密钥写进仓库）

MySQL

变量	说明
MYSQL_URL	完整 JDBC URL；生产必填
MYSQL_USERNAME	用户名；dev 默认 root
MYSQL_PASSWORD	密码；dev 默认可为空

可选：AI

变量	说明
IMAI_ZHIPU_API_KEY	智谱等 API Key
IMAI_ZHIPU_MODEL	模型名，可选

4.3 构建与启动

mvn -DskipTests package
java -jar target/blade-api-exe.jar

默认端口一般为 8183；prod 须提前配置 MYSQL_*、REDIS_HOST 等。

4.4 连接微信

浏览器打开：http://localhost:8183/index.html（端口按你本地修改）。

---

五、后续规划（Roadmap 摘要）

方向	说明
多部署形态	容器化与编排示例等
AI 能力与模型抽象	如 Spring AI、多厂商路由等
图表与统计	聚合接口与可视化友好数据
指令体系细化	动词、参数、帮助与兼容性

排期以仓库 Issue / 里程碑 为准。

---

六、参与共建与交流

• PR：欢迎提交，建议附变更说明、影响范围与自测要点。
• Issue：需求与缺陷优先走 Issue。
• 微信群：加群见仓库 README。

仓库地址：https://github.com/lith0924/iMoney
SDK地址：https://github.com/lith0924/wechat-ilink-sdk-java

---

七、结语

把记账做成「像发消息一样自然」，是 iMoney 的长期产品方向；开源服务端希望和更多开发者一起把数据模型、指令体系、安全与可观测性做扎实。欢迎在评论区留下使用场景或踩坑，也欢迎直接到仓库提 Issue / PR。

---