AccountingOnFeishu
描述
帮用户快速记录日常支出和收入到飞书多维表格。支持文字记账和图片小票 OCR 解析（每个项目单独生成一条记录）。
核心特性：
- 首次使用时，先询问用户是否有现成记账本
- 如有：读取并学习其字段结构、分类习惯，后续按用户习惯记账
- 如无：引导用户新建记账本（支持自定义分类体系）
- 所有配置持久化到本地
config.json
使用场景
用户说以下类似的话时触发：
- "记账 吃饭 50"
- "记一笔 200 支出 购物"
- "收入 5000 工资"
- 发送图片小票说"记账"
- "这个月花了多少"
- "我要记账"（首次使用触发初始化）
Skill 名称
AccountingOnFeishu
配置文件
文件路径：~/.openclaw/workspace/skills/AccountingOnFeishu/config.json
首次使用时如果不存在，进入初始化流程。
初始化流程（首次使用）
步骤 1：检查配置
检查 config.json 是否存在。
- 存在 → 直接读取配置，进入记账流程
- 不存在 → 进入步骤 2
步骤 2：询问用户
用自然语言问用户：
还没有配置记账本，你有现成的飞书多维表格记账本吗？
- 有 → 请提供多维表格链接或 app_token + table_id，我来学习你的记账习惯
- 没有 → 我来帮你新建一个记账本
分支 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: <用户提供>
- table_id: <用户提供>
获取记录样本（学习分类习惯）：
feishu_bitable_app_table_record > list
- app_token: <用户提供>
- table_id: <用户提供>
- page_size: 20
A3. 分析并保存配置
从表结构中提取关键信息：
| 学习项 | 说明 |
|---|
fields | 所有字段名和类型 |
amount_field | 金额字段名（通常是"金额"或"钱数"） |
note_field | 备注字段名（通常是"备注"、"说明"、"描述"） |
type_field | 收支类型字段名（通常是"收支"、"类型"、"收入/支出"） |
date_field | 日期字段名（如果有） |
category_field | 一级分类字段名（如果有） |
sub_category_field | 二级分类字段名（如果有） |
category_options | 一级分类的所有选项值（单选/多选字段的 options） |
sub_category_options | 二级分类的所有选项值 |
income_value | 收入类型的选项值（如"收入"、"进账"） |
expense_value | 支出类型的选项值（如"支出"、"出账"） |
保存到 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. 询问分类需求
我来帮你新建一个记账本，需要几个分类字段？
- 简单版：备注、金额、收支、日期（4个字段）
- 标准版：+ 一级分类（餐饮/交通/购物等）
- 完整版：+ 一级分类 + 二级分类
根据用户选择，调用建表流程。
B2. 创建多维表格
feishu_bitable_app > create
- name: "个人记账本"
返回 app_token。
B3. 创建数据表（带字段）
feishu_bitable_app_table > create
- app_token: <上一步返回的>
- 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 已存在。
-
解析用户输入
- 提取备注描述
- 提取金额（数字或数学表达式）
- 如果金额是表达式（如
50-41.83、100*0.8、60+30），先计算结果
- 支持 + - * / 和括号
- 计算后取绝对值（避免负数）
- 判断收支类型：
- 有"收入"/"进账"/"到账"等关键词 → 收支 =
config.type_options.income
- 其他情况 → 收支 =
config.type_options.expense
- 备注 = 用户描述中的消费内容
-
智能分类（可选）
- 如果配置中有
category_field，尝试根据备注关键词匹配分类：
- 关键词包含 "饭"/"餐"/"吃"/"外卖" → 餐饮
- 关键词包含 "车"/"地铁"/"公交"/"打车"/"油" → 交通
- 关键词包含 "买"/"购"/"淘宝"/"京东" → 购物
- 关键词包含 "电影"/"游戏"/"唱" → 娱乐
- ...（其他关键词匹配）
- 如果无法匹配，分类字段留空
-
写入多维表格
使用 config.json 中学习到的字段名：
feishu_bitable_app_table_record > create
- app_token: <config.app_token>
- table_id: <config.table_id>
- fields:
<config.fields.note>: <备注>
<config.fields.amount>: <金额>
<config.fields.type>: <收入/支出>
<config.fields.category>: <智能分类结果>（如果有）
- 日期字段如果设置了 auto_fill，无需手动写入
-
返回确认
- 简要告诉用户已记录
- 附上多维表格链接：
https://my.feishu.cn/base/<config.app_token>
流程 2：图片小票记账
-
下载并分析图片
- 如果图片在消息中，先用
feishu_im_bot_image 或 feishu_im_user_fetch_resource 下载
- 用
image 工具（Kimi vision）分析图片内容
-
OCR 解析每个项目
- 提示词应要求：列出小票上每个商品/项目，单独一行
- 格式：
<价格> <项目描述>
- 忽略店名、总计、找零等无关信息
-
批量写入多维表格
使用 config.json 中学习到的字段名：
feishu_bitable_app_table_record > batch_create
- app_token: <config.app_token>
- table_id: <config.table_id>
- records: [
{ fields: { <note_field>: "项目描述1", <amount_field>: <价格>, <type_field>: <expense_value> } },
{ fields: { <note_field>: "项目描述2", <amount_field>: <价格>, <type_field>: <expense_value> } },
...
]
-
返回确认
- 告诉用户共解析出 N 个项目
- 总金额是多少
- 附上多维表格链接
字段格式参考
| 字段名 | 类型 | 格式 | 示例 |
|---|
| 备注/描述 | 文本 (type=1) | 字符串 | "吃饭"、"小票-咖啡" |
| 金额 | 数字 (type=2) | 数字，不带货币符号 | 50 或 128.5 |
| 收支/类型 | 单选 (type=3) | 字符串，值从 config 读取 | "支出" 或 "收入" |
| 日期 | 日期 (type=5) | 毫秒时间戳 | 自动填充时可不写 |
| 分类 | 单选 (type=3) | 字符串，值从 config 读取 | "餐饮" |
| 二级分类 | 单选 (type=3) | 字符串，值从 config 读取 | "午餐" |
重要：
- 所有字段名都从
config.json 中读取，不要假设固定名称
- 金额只写数字，不带
¥ 或 元
- 日期字段如设置了 auto_fill，无需手动写入
智能分类关键词映射
如果用户记账本有分类字段，可尝试按关键词匹配：
| 关键词 | 分类 |
|---|
| 饭、餐、吃、外卖、食堂、火锅、烧烤 | 餐饮 |
| 车、地铁、公交、打车、滴滴、油费、停车、高速 | 交通 |
| 买、购、淘宝、京东、拼多多、天猫、商场 | 购物 |
| 电影、游戏、唱K、酒吧、剧本杀、游乐场 | 娱乐 |
| 房租、水电、物业、燃气、宽带 | 住房 |
| 药、医院、诊所、体检、医保 | 医疗 |
| 书、课、培训、考试、学费 | 教育 |
| 话费、流量、宽带、电话 | 通讯 |
| 衣服、鞋、包、化妆品、护肤品 | 服装 |
| 朋友、聚会、送礼、红包 | 社交 |
| 酒店、机票、火车票、景点、签证 | 旅行 |
| 手机、电脑、耳机、键盘、鼠标 | 数码 |
| 纸巾、洗发水、洗衣液、牙膏 | 日用 |
匹配失败时分类留空，不强制填写。
财务建议生成（可选）
记录完成后，可以根据以下情况给出简短建议：
| 情况 | 建议类型 |
|---|
| 单笔 > 500 元 | "这笔开支不小哦，考虑一下是否真的必要？" |
| 同一类别当天多笔 | "今天在[X分类]花了[N]次，要不要合并一下？" |
| 图片识别出多个项目 | "小票解析出[N]项，总共[X]元，平均每项[Y]元" |
| 金额异常（过大或过小） | "这个金额有点奇怪，确定没记错吗？" |
| 无特别情况 | 直接确认即可 |
原则：建议要简短、自然、不啰嗦，可以偶尔调皮一下。
注意事项
config.json 是核心配置文件，所有字段映射和 token 都在这里- 金额需要是数字类型，不是字符串
- 单次批量创建最多 500 条（图片小票一般不会超）
- 图片下载后保存在
/tmp/openclaw/ 下
- 解析图片时，prompt 要明确要求输出每个项目的价格和描述
- 学习现有记账本时，如果字段类型不匹配（如金额字段是文本而非数字），向用户说明并询问是否需要调整
