AccountingOnFeishu

描述

帮用户快速记录日常支出和收入到飞书多维表格。支持文字记账和图片小票 OCR 解析（每个项目单独生成一条记录）。

核心特性：

• 首次使用时，先询问用户是否有现成记账本
• 如有：读取并学习其字段结构、分类习惯，后续按用户习惯记账
• 如无：引导用户新建记账本（支持自定义分类体系）
• 所有配置持久化到本地 config.json

使用场景

用户说以下类似的话时触发：

• "记账 吃饭 50"
• "记一笔 200 支出 购物"
• "收入 5000 工资"
• 发送图片小票说"记账"
• "这个月花了多少"
• "我要记账"（首次使用触发初始化）

Skill 名称

AccountingOnFeishu

配置文件

文件路径：~/.openclaw/workspace/skills/AccountingOnFeishu/config.json

首次使用时如果不存在，进入初始化流程。

初始化流程（首次使用）

步骤 1：检查配置

检查 config.json 是否存在。

• 存在 → 直接读取配置，进入记账流程
• 不存在 → 进入步骤 2

步骤 2：询问用户

用自然语言问用户：

还没有配置记账本，你有现成的飞书多维表格记账本吗？

1. 有 → 请提供多维表格链接或 app_token + table_id，我来学习你的记账习惯
2. 没有 → 我来帮你新建一个记账本

分支 A：用户有现成记账本

A1. 获取用户提供的链接或 token

用户可能提供：

• 飞书多维表格链接（如 https://xxx.feishu.cn/base/APP_TOKEN）
• 或直接说 app_token 和 table_id

从链接中提取 app_token。

A2. 学习记账本结构

获取表结构：

feishu_bitable_app_table_field > list
- app_token: \x3C用户提供>
- table_id: \x3C用户提供>

获取记录样本（学习分类习惯）：

feishu_bitable_app_table_record > list
- app_token: \x3C用户提供>
- table_id: \x3C用户提供>
- page_size: 20

A3. 分析并保存配置

从表结构中提取关键信息：

保存到 config.json：

{
  "app_token": "xxx",
  "table_id": "xxx",
  "table_name": "用户记账本",
  "fields": {
    "amount": "金额",
    "note": "备注",
    "type": "收支",
    "date": "日期",
    "category": "分类",
    "sub_category": "二级分类"
  },
  "type_options": {
    "income": "收入",
    "expense": "支出"
  },
  "category_options": ["餐饮", "交通", "购物", ...],
  "sub_category_options": ["早餐", "午餐", "晚餐", ...]
}

A4. 向用户确认

告诉用户已学习到的结构：

已学习你的记账习惯！

• 金额字段：「金额」
• 备注字段：「备注」
• 分类字段：「分类」（有 15 个选项）
• 收支字段：「收支」

以后直接说"记账 吃饭 50"就能按你的习惯记录了 ✅

分支 B：用户没有记账本（新建）

B1. 询问分类需求

我来帮你新建一个记账本，需要几个分类字段？

1. 简单版：备注、金额、收支、日期（4个字段）
2. 标准版：+ 一级分类（餐饮/交通/购物等）
3. 完整版：+ 一级分类 + 二级分类

根据用户选择，调用建表流程。

B2. 创建多维表格

feishu_bitable_app > create
- name: "个人记账本"

返回 app_token。

B3. 创建数据表（带字段）

feishu_bitable_app_table > create
- app_token: \x3C上一步返回的>
- name: "记账明细"
- fields: [
    {"field_name": "备注", "type": 1},
    {"field_name": "金额", "type": 2, "property": {"formatter": "0.00"}},
    {"field_name": "收支", "type": 3, "property": {"options": [
      {"name": "收入", "color": 0},
      {"name": "支出", "color": 1}
    ]}},
    {"field_name": "日期", "type": 5, "property": {"auto_fill": true, "date_formatter": "yyyy-MM-dd"}},
    {"field_name": "分类", "type": 3, "property": {"options": [
      {"name": "餐饮", "color": 0},
      {"name": "交通", "color": 1},
      {"name": "购物", "color": 2},
      {"name": "娱乐", "color": 3},
      {"name": "住房", "color": 4},
      {"name": "医疗", "color": 5},
      {"name": "教育", "color": 6},
      {"name": "通讯", "color": 7},
      {"name": "服装", "color": 8},
      {"name": "社交", "color": 9},
      {"name": "旅行", "color": 10},
      {"name": "数码", "color": 11},
      {"name": "日用", "color": 12},
      {"name": "其他", "color": 13}
    ]}}
  ]

注意：

• 如果用户选择"完整版"，再添加 二级分类 字段
• 二级分类可以选项根据~/.openclaw/workspace/skills/AccountingOnFeishu/config.json.example来预设，或者也可以先留空让用户自己添加
• 日期 字段设置 auto_fill: true，自动填充创建日期

B4. 保存配置

将新建的信息写入 config.json，格式同分支 A。

B5. 返回确认

记账本已创建！✅

📋 查看记账表格

以后直接说"记账 吃饭 50"就能记了

工作流程

流程 1：文字记账

前提：config.json 已存在。

1. 解析用户输入

   • 提取备注描述
   • 提取金额（数字或数学表达式）
     • 如果金额是表达式（如 50-41.83、100*0.8、60+30），先计算结果
     • 支持 + - * / 和括号
     • 计算后取绝对值（避免负数）
   • 判断收支类型：
     • 有"收入"/"进账"/"到账"等关键词 → 收支 = config.type_options.income
     • 其他情况 → 收支 = config.type_options.expense
   • 备注 = 用户描述中的消费内容

2. 智能分类（可选）

   • 如果配置中有 category_field，尝试根据备注关键词匹配分类：
     • 关键词包含 "饭"/"餐"/"吃"/"外卖" → 餐饮
     • 关键词包含 "车"/"地铁"/"公交"/"打车"/"油" → 交通
     • 关键词包含 "买"/"购"/"淘宝"/"京东" → 购物
     • 关键词包含 "电影"/"游戏"/"唱" → 娱乐
     • ...（其他关键词匹配）
   • 如果无法匹配，分类字段留空

3. 写入多维表格 使用 config.json 中学习到的字段名：

   feishu_bitable_app_table_record > create
   - app_token: \x3Cconfig.app_token>
   - table_id: \x3Cconfig.table_id>
   - fields:
       \x3Cconfig.fields.note>: \x3C备注>
       \x3Cconfig.fields.amount>: \x3C金额>
       \x3Cconfig.fields.type>: \x3C收入/支出>
       \x3Cconfig.fields.category>: \x3C智能分类结果>（如果有）
   

   • 日期字段如果设置了 auto_fill，无需手动写入

4. 返回确认

   • 简要告诉用户已记录
   • 附上多维表格链接：https://my.feishu.cn/base/\x3Cconfig.app_token>

流程 2：图片小票记账

1. 下载并分析图片

   • 如果图片在消息中，先用 feishu_im_bot_image 或 feishu_im_user_fetch_resource 下载
   • 用 image 工具（Kimi vision）分析图片内容

2. OCR 解析每个项目

   • 提示词应要求：列出小票上每个商品/项目，单独一行
   • 格式：\x3C价格> \x3C项目描述>
   • 忽略店名、总计、找零等无关信息

3. 批量写入多维表格 使用 config.json 中学习到的字段名：

   feishu_bitable_app_table_record > batch_create
   - app_token: \x3Cconfig.app_token>
   - table_id: \x3Cconfig.table_id>
   - records: [
       { fields: { \x3Cnote_field>: "项目描述1", \x3Camount_field>: \x3C价格>, \x3Ctype_field>: \x3Cexpense_value> } },
       { fields: { \x3Cnote_field>: "项目描述2", \x3Camount_field>: \x3C价格>, \x3Ctype_field>: \x3Cexpense_value> } },
       ...
     ]
   

4. 返回确认

   • 告诉用户共解析出 N 个项目
   • 总金额是多少
   • 附上多维表格链接

字段格式参考

重要：

• 所有字段名都从 config.json 中读取，不要假设固定名称
• 金额只写数字，不带 ¥ 或 元
• 日期字段如设置了 auto_fill，无需手动写入

智能分类关键词映射

如果用户记账本有分类字段，可尝试按关键词匹配：

匹配失败时分类留空，不强制填写。

财务建议生成（可选）

记录完成后，可以根据以下情况给出简短建议：

原则：建议要简短、自然、不啰嗦，可以偶尔调皮一下。

注意事项

• config.json 是核心配置文件，所有字段映射和 token 都在这里
• 金额需要是数字类型，不是字符串
• 单次批量创建最多 500 条（图片小票一般不会超）
• 图片下载后保存在 /tmp/openclaw/ 下
• 解析图片时，prompt 要明确要求输出每个项目的价格和描述
• 学习现有记账本时，如果字段类型不匹配（如金额字段是文本而非数字），向用户说明并询问是否需要调整