 主打 **零成本、纯本地运行、隐私安全、开箱即用**。

---
## 📦 一、场景定义
**输入**：用户随手记下的口语化消费描述  
> 例：`“今天打车花了35，中午吃麻辣烫28，晚上买了杯瑞幸22，还交了100话费，昨天买书花了45.5”`

**AI 处理**：
1. 自动拆分多条记录
2. 提取金额、分类、商户、备注、日期
3. 统一格式化（默认今天、补全缺失字段）
4. 输出严格 JSON 数组 → 存入本地轻量数据库

**输出**：结构化账单列表 → 可对接小程序/桌面端/Telegram Bot  
**定位**：个人记账、家庭开销流水、自由职业者收支记录

---
## 🏗️ 二、轻量化技术栈
| 模块 | 选型 | 说明 |
|------|------|------|
| 后端 | Java 17 + Spring Boot 3.2 | 轻量、依赖少 |
| AI 框架 | `LangChain4j 0.36+` | 声明式调用、内置结构化输出 |
| 本地大模型 | `Ollama` + `qwen2.5:3b` 或 `phi3` | 离线运行、显存 2G 即可、零 API 费用 |
| 存储 | `H2` 或 `SQLite` + `Spring Data JPA` | 单文件数据库，无需安装 MySQL |
| 部署 | 本地 Jar 包 / Docker 单容器 | 个人电脑/树莓派/NAS 均可跑 |

---
## 💻 三、核心实现代码

### 1. Maven 依赖
```xml
<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-spring-boot-starter</artifactId>
    <version>0.36.0</version>
</dependency>
<dependency>
    <groupId>dev.langchain4j</groupId>
    <artifactId>langchain4j-ollama</artifactId>
    <version>0.36.0</version>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <scope>runtime</scope>
</dependency>
```

### 2. `application.yml`（直连本地 Ollama）
```yaml
langchain4j:
  ollama:
    chat-model:
      base-url: http://localhost:11434
      model-name: qwen2.5:3b
      temperature: 0.1
      timeout: PT10S
      response-format: JSON_OBJECT  # 强制 JSON 模式
spring:
  datasource:
    url: jdbc:h2:file:./data/expense.db;AUTO_SERVER=TRUE
    driver-class-name: org.h2.Driver
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: false
```

### 3. 结构化 DTO
```java
import com.fasterxml.jackson.annotation.JsonProperty;

public record ExpenseItem(
    @JsonProperty("amount") double amount,
    @JsonProperty("category") String category, // 餐饮/交通/购物/居住/娱乐/医疗/教育/其他
    @JsonProperty("merchant") String merchant,
    @JsonProperty("note") String note,
    @JsonProperty("date") String date // YYYY-MM-DD
) {}
```

### 4. AI 服务接口（LangChain4j 声明式）
```java
import dev.langchain4j.service.AiService;
import dev.langchain4j.service.SystemMessage;
import dev.langchain4j.service.UserMessage;
import dev.langchain4j.service.V;
import java.util.List;

@AiService
public interface ExpenseAI {
    @SystemMessage("""
        你是个人记账助手。请严格从用户输入中提取所有消费记录。
        【规则】
        1. 金额必须为数字，未写单位默认是元
        2. 分类仅限：餐饮/交通/购物/居住/娱乐/医疗/教育/其他
        3. 日期格式 YYYY-MM-DD，未提及则使用今天日期
        4. 必须输出合法 JSON 数组，禁止 Markdown、禁止额外解释
        5. 若无消费，返回 []
        """)
    @UserMessage("记账内容：{{rawText}}")
    List<ExpenseItem> extract(@V("rawText") String rawText);
}
```

### 5. 业务层（容错解析 + 落库）
```java
@Service
@RequiredArgsConstructor
@Slf4j
public class ExpenseService {

    private final ExpenseAI ai;
    private final ExpenseRepository repo; // extends JpaRepository<ExpenseRecord, Long>
    private final ObjectMapper mapper = new ObjectMapper();

    public List<ExpenseItem> processAndSave(String rawText) {
        // 1. 调用 AI（LangChain4j 自动处理 JSON 反序列化）
        List<ExpenseItem> items = ai.extract(rawText);
        if (items.isEmpty()) return List.of();

        // 2. 数据清洗 & 校验
        String today = LocalDate.now().toString();
        for (ExpenseItem item : items) {
            if (item.amount() <= 0) throw new IllegalArgumentException("金额必须大于0");
            if (!Set.of("餐饮","交通","购物","居住","娱乐","医疗","教育","其他").contains(item.category())) {
                item = new ExpenseItem(item.amount(), "其他", item.merchant(), item.note(), item.date());
            }
            if (StringUtils.isBlank(item.date())) item = new ExpenseItem(item.amount(), item.category(), item.merchant(), item.note(), today);
        }

        // 3. 批量落库
        repo.saveAll(items.stream().map(ExpenseRecord::from).toList());
        log.info("成功解析并保存 {} 条账单", items.size());
        return items;
    }
}
```

### 6. 简单 REST 入口
```java
@RestController
@RequestMapping("/api/expense")
@RequiredArgsConstructor
public class ExpenseController {
    private final ExpenseService service;

    @PostMapping("/add")
    public ResponseEntity<List<ExpenseItem>> add(@RequestBody String rawText) {
        return ResponseEntity.ok(service.processAndSave(rawText));
    }
}
```

---
## 🛡️ 四、个人级关键设计（避坑指南）

| 风险点 | 轻量化解决方案 |
|--------|----------------|
| **模型输出带 Markdown** | Ollama 开启 `response-format: JSON_OBJECT` + LangChain4j 内置清理器 |
| **本地模型响应慢** | 使用 `qwen2.5:3b` / `phi3-mini`，启动时加 `--keep-alive 5m` 避免频繁加载 |
| **金额识别幻觉** | 后置 `amount > 0` 校验 + 正则拦截中文数字（如“三十”→提示用户改用阿拉伯数字） |
| **无网络环境** | Ollama 首次 pull 模型后完全离线运行，适合地铁/出差/隐私敏感场景 |
| **数据丢失** | H2 文件默认存 `./data/expense.db`，定期 `cp` 备份或开启 Spring `spring.jpa.hibernate.ddl-auto=validate` |

---
## 🐛 五、常见问题与对策

| 问题 | 对策 |
|------|------|
| `qwen2.5:3b` 偶尔漏记条目 | Prompt 增加 Few-shot 示例：`输入: "打车30，咖啡25" → 输出: [{"amount":30,...}, {"amount":25,...}]` |
| 分类不准确 | 维护本地 `同义词映射表`（如“外卖/火锅/奶茶”→餐饮，“滴滴/公交”→交通），在落库前替换 |
| 日期错乱（如“前天”识别失败） | AI 输出后调用 `RelativeDateParser` 转换，或 Prompt 明确写“未提及日期统一用今天” |
| 显存不足 OOM | 启动 Ollama 时限制上下文：`ollama run qwen2.5:3b --num-ctx 2048` |

---
## 📈 六、演进路线（个人向）
1. **V1.0**：命令行 / Postman 输入 → 本地 H2 落库 → 查 JSON
2. **V2.0**：接入 Telegram Bot / 微信小程序 → 语音转文字 → 实时记账
3. **V3.0**：每月自动生成 `AI 消费分析报告`（占比/趋势/异常提醒）→ 推送 PDF
4. **V4.0**：导出 CSV 对接 Excel / Notion / 钱迹 / 随手记，支持多账本切换

---
## 📎 附：5分钟快速验证清单
- [ ] 安装 Ollama：`curl -fsSL https://ollama.com/install.sh | sh`
- [ ] 拉取模型：`ollama pull qwen2.5:3b`
- [ ] 启动 Spring Boot：`mvn spring-boot:run`
- [ ] 测试接口：`curl -X POST http://localhost:8080/api/expense/add -H "Content-Type: text/plain" -d "今天买菜45，地铁8，晚上吃火锅210"`
- [ ] 验证输出：返回合法 JSON 数组，`expense.db` 新增记录
 

例：“今天打车花了35，中午吃麻辣烫28，晚上买了杯瑞幸22，还交了100话费，昨天买书花了45.5”

轻量级个人场景：AI 智能记账助手（自然语言转结构化账单）

人工智能

后端

零成本本地记账工具，支持口语化输入自动解析为结构化账单。采用Java+SpringBoot+LangChain4j技术栈，搭配Ollama本地大模型，无需联网即可运行。支持H2/SQLite单文件存储，隐私安全有保障。开箱即用，适合个人记账、家庭开销记录，显存仅需2G，树莓派/NAS均可部署。

数据清洗

数据丢失

代码解释

数据库

容器

SQLite

MySQL

JSON

2026上云采购 | AI焕新·智启新局

语音产品特惠新用户14.9元起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

轻量级个人场景：AI 智能记账助手（自然语言转结构化账单）-腾讯云开发者社区-腾讯云

轻量级个人场景：AI 智能记账助手（自然语言转结构化账单）

轻量级个人场景：AI 智能记账助手（自然语言转结构化账单）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐