小微企业智能记账

任务目标

本Skill用于：帮助小微企业主/个体经营者快速记录经营流水，将口语转化为标准会计分录。

• 核心能力：口语记账自动拆分、会计科目智能匹配、经营标签区分盈亏与往来、数据持久化JSON
• 触发条件：用户说"今天卖了xxx"、"进货花了xxx"、"还有给供应商付款xxx"

前置准备

• 依赖：python 3.8+，uuid==1.30
• 数据文件：expense_records.json（首次运行自动创建）
• 用户需指定行业（餐饮/零售/电商/服务工作室），不指定默认通用模式

操作步骤

1. 口语解析与拆分

用户输入口语记账时，智能体按以下规则处理：

拆分规则：

• 遇到"和"、"还有"、"另外"、"再加"等连接词 → 拆分为多条记录
• 每条记录独立匹配会计科目

经营标签判断（重要）：

往来账处理：

• 用户说"客户欠我xxx" → 应收账款，记录为 expense + label=往来挂账-应收
• 用户说"我还欠供应商xxx" → 应付账款，记录为 expense + label=往来挂账-应付
• counterparty 字段必须填写（客户/供应商名称）

2. 调用record.py写入记录

# 单笔记录
python scripts/record.py --type income --amount 8000 --category "主营业务收入" --description "零售销售" --label "经营产出"

# 批量记录（复杂口语拆分的场景）
python scripts/record.py --batch ./temp_batch.json

3. 查询统计（按需）

# 本月汇总
python scripts/query.py --period month

# 按类别查看
python scripts/query.py --category "销售费用" --period all

# 查看往来账
python scripts/query.py --label "往来挂账-应收,往来挂账-应付"

4. 修改删除（按需）

# 修改金额
python scripts/manage.py --action update --id <uuid> --field amount --value 6000

# 删除记录
python scripts/manage.py --action delete --id <uuid>

会计科目体系

经营产出（收入类）

经营投入（成本/费用类）

往来挂账

盈亏计算逻辑

净盈亏 = 经营产出合计 - 经营投入合计
       = SUM(label=经营产出) - SUM(label=经营投入)

往来账不参与盈亏计算（仅展示余额）

行业词库适配

不同行业的关键词差异，见 references/category_rules.md。

切换行业时：智能体根据用户指定的行业，在对应词库中匹配关键词。

使用示例

示例1：口语单笔

• 用户输入：今天卖了5000块
• 智能体解析：type=income, amount=5000, category=主营业务收入, label=经营产出
• 执行：python scripts/record.py --type income --amount 5000 --category "主营业务收入" --description "零售销售" --label "经营产出"
• 预期：写入一条income记录，返回uuid

示例2：口语多笔

• 用户输入：今天卖了8000，还有进货花了3000，另外给房东付了2000租金
• 智能体拆分3条：

1. income-8000-主营业务收入-经营产出
2. expense-3000-主营业务成本-经营投入
3. expense-2000-管理费用-经营投入
• 执行批量写入，返回3个uuid

示例3：往来账

• 用户输入：客户张总还欠我5000货款
• 智能体解析：type=expense(欠收), amount=5000, category=应收账款, label=往来挂账-应收, counterparty=张总
• 执行：python scripts/record.py --type expense --amount 5000 --category "应收账款" --description "客户欠款" --label "往来挂账-应收" --counterparty "张总"
• 注意：此记录不计入盈亏，计入往来账余额

示例4：行业查询

• 用户输入：查一下这个月餐饮店的数据
• 智能体执行：python scripts/query.py --period month --industry 餐饮
• 预期返回：本月收入合计、支出合计、净盈亏、往来账余额

资源索引

• 记账脚本：见 scripts/record.py（用途：写入单笔/批量记录到JSON；参数：type/amount/category/description/date/label/counterparty/batch）
• 查询脚本：见 scripts/query.py（用途：按时间/类别/行业汇总，含应收应付展示；参数：period/category/type/label/industry/output）
• 管理脚本：见 scripts/manage.py（用途：修改字段/删除记录；参数：action/id/field/value）
• 行业词库：见 references/category_rules.md（何时读取：需要按行业匹配关键词时）
• 行业模板：见 references/industry_templates.md（何时读取：用户提供特定行业场景时参考）

注意事项

• counterparty 仅在 label 含"往来挂账"时必需，其他情况可选
• date 不指定时默认当天，格式为 YYYY-MM-DD
• 批量写入时，每条记录需包含 type/amount/category，label 默认"经营投入"(expense)或"经营产出"(income)
• 查询结果的盈亏仅计算经营产出-经营投入，往来挂账单独展示
• JSON 文件路径固定为 expense_records.json（相对于执行目录）