管家婆工贸-对账

概述

对账（销售客户对账）

工贸ERP销售客户对账。当用户要求对账、客户对账、看应收余额、本期销售收款汇总、与客户核对往来时触发。按客户汇总本期销售金额/收款金额/期末应收余额，只读查询。连接信息由config.json驱动，支持ERP_KIT_CONFIG环境变量切换环境。

数据库连接检测（每次使用必做）

1. 运行 python scripts/erp_kit.py --check（或 --setup 首次引导）。
2. 连接失败或 config.json 缺失时，输出连接信息提示，引导用户修改配置：
   • 编辑技能目录根目录 config.json 的 database 段（服务器/端口/数据库名/账号/密码/驱动）；
   • 或设置环境变量 ERP_KIT_CONFIG 指向其他配置文件，无需改动文件。
3. 确认配置后执行业务命令。

强制规则

1. 写操作必须二次确认：先以「字段|内容」两列表展示业务草稿（客户/商品加粗，不暴露原始字段名），

用户明确回复「确认」后才写入；未确认禁止执行。

1. 只读查询不受二次确认限制，可直接执行。
2. 回复一律用中文业务说法（如"执行数量"而非 toqty），单据编号等数据本身除外。

使用步骤

# 连接自检 / 首次配置
python scripts/erp_kit.py --check
python scripts/erp_kit.py --setup

# 业务命令
python scripts/erp_kit.py reconcile --help

详细业务逻辑见 references/functions.md，表结构速查见 references/schema.md，部署与配置手册见 README.md。

跨环境部署（新电脑）

1. 复制本技能目录到目标机 ~/.workbuddy/skills/（或解压 zip）。
2. 安装 Python 3.9+ 与 ODBC Driver 17 for SQL Server。
3. pip install -r requirements.txt，然后运行 --check 引导生成并校验 config.json。
4. 编辑 config.json 指向目标数据库 → --check 通过即可使用。