仓库财务一体化 · 出入库与电子码助手

让杂乱的出入库单据秒变规范台账，自动算结存、出报表，并为每个 SKU / 批次 / 单据生成二维码（电子码），输出带码电子单据（类似电子文档）。

适用人群

中小仓库、商贸公司、制造企业的进销存文员、财务助理、个体店主。

还在为月底手工用 Excel 核对几百行出入库、计算结存而加班到深夜吗？只需拖入文件，台账、对账单、利润表一键生成。

能做什么

出入库整理：丢给它文本 / Excel（图片需先经 OCR 转为文本）自动提取字段、入台账。
收发存台账：维护 台账.xlsx，自动算结存数量、金额、加权成本、毛利。
二维码（电子码）：为每个 SKU / 批次 / 单据生成二维码 PNG（离线生成，不依赖外部接口）。
电子单据：输出带二维码的入库单 / 出库单 / 盘点表（xlsx）。
财务报表：按月 / 按往来单位出对账单、收发存汇总、利润表。
数据校验与异常预警：按 config.json 的 risk 规则标红——负库存（结存<0，可配 allow_negative_stock）、金额缺失（warn_zero_amount）、单价异常（> max_unit_price 或 ≤0）、重复单号（同单号≥2 次）。

实际输出样例

台账 台账.xlsx（工作表「收发存」）列结构如下，结存由脚本按移动加权平均自动计算：

| 日期 | 单号 | 类型 | 往来单位 | SKU | 名称 | 数量 | 单价 | 金额 | 结存数量 | 结存金额 | 单位成本 | 备注 | |------|------|------|----------|-----|------|------|------|------|----------|----------|----------|------| | 2026-07-01 | RK-001 | 入 | 供应商A | A1001 | 螺丝 | 100 | 1.0 | 100 | 100 | 100 | 1.0000 | | | 2026-07-10 | CK-001 | 出 | 客户B | A1001 | 螺丝 | 30 | 1.0 | 30 | 70 | 70 | 1.0000 | |

入库后单位成本 = (期初金额+本次金额)/(期初数量+本次数量)；出库按当前单位成本结转。上例：出库 30 后结存 70、结存金额 70、单位成本保持 1.0。

报表 报表.xlsx 含三张表：收发存汇总（按 SKU）、对账单（按往来单位）、利润表（销售收入−销售成本=毛利）。

常见误用与反模式

图片直接录入：图片须经 OCR 转为文本/结构化数据后才能录入，技能本身不识别图片。
入库漏填单价：入库强制要求单价（用于算加权成本），忘填会报错——是预期校验，不是 bug。
手填与数量/单价矛盾的金额：脚本按 数量×单价 校验，金额不符会预警。
手动改历史行：不要把 台账.xlsx 当模板手改，会破坏结存一致；改历史请用红冲单或盘点单（类型=盘）。
密钥随台账外发：config.json / .env 等含密钥文件永不随台账走；台账外发前先脱敏。

离线功能 vs 联网功能（边界说明）

本技能默认全程离线、数据不出本机；联网仅在你主动配置后才发生。

✅ 离线即可用（无需联网）

出入库流水整理（文本 / Excel 输入）
收发存台账维护与结存计算（数量、金额、加权成本、毛利）
二维码（电子码）生成与电子单据导出
财务报表（对账单 / 收发存汇总 / 利润表）
数据校验与异常预警（负库存 / 金额缺失 / 单价异常 / 重复单号）

🌐 联网功能（可选，需显式配置）

对接 ERP / 钉钉：拉取或回写业务数据（需在 config.json 填写密钥，脱敏显示）
云端 OCR：图片单据自动识别（需配置云端 OCR API，图片会发往第三方）

不配置任何联网项时，全部在本地运行，台账与报表仅存于本机。

图片 OCR 技术路径（能力边界说明）

当前能力边界：本技能不含内置 OCR 引擎，不直接"识别"图片。图片需先转为文本，技能再负责结构化录入与台账。
本地路径（推荐）：本机安装本地 OCR（如 Tesseract / PaddleOCR），把图片识别为文本后粘贴或传入，再交由技能处理——完全离线，图片不出本机。
云端路径（可选）：在 config.json 的 ocr 段配置云端 OCR（如腾讯云 OCR）key/secret 后，可由外部脚本调用实现图片自动识别；此时图片会发往第三方，需你授权并自担数据出境风险，密钥仅显示前 8 位。
总结：OCR 属"前置 / 外部步骤"，技能专注"文本 → 台账 → 码 → 报表"的确定性工作流。

加权成本算法说明

采用移动加权平均法（企业会计准则常用）：

每次入库后：单位成本 = (期初结存金额 + 本次入库金额) / (期初结存数量 + 本次入库数量)
出库结转：按当前 单位成本 计算出库成本
结存金额 = 结存数量 × 单位成本

结存成本随每次入库平滑更新，避免手工 FIFO / 个别计价的繁琐，适合单价波动的中小贸易场景。

快速开始

前置：本机需 Python 3.10+（未安装可先装好；deploy.ps1 仅负责装 Python 依赖，不装 Python 本体）。

安装（Windows）：右键 deploy.ps1 → 用 PowerShell 运行；或 powershell -ExecutionPolicy Bypass -File deploy.ps1（自动装 qrcode / Pillow / openpyxl）。
配置（可选）：复制 config.example.json 为 config.json，填 ERP / 钉钉 / ocr 云端识别（密钥脱敏，仅显示前 8 位）。
核心操作由脚本确定性完成（不是 AI 临场推算）：
- 写入台账：python scripts/ledger.py --ledger 台账.xlsx --input 单据.xlsx
- 生成报表：python scripts/report.py --ledger 台账.xlsx --out 报表.xlsx --month 2026-07
- 自检：python scripts/ledger.py --ledger 台账.xlsx --self-check
- 生成电子码：python scripts/gen_qr.py "<内容>" qr_<SKU>.png
对话触发，例如：
- 「把 C:/data/出库单.xlsx 整理进台账，每个 SKU 生成二维码」
- 「出 2026-07 的收发存汇总和对账单」

平台支持范围

操作系统：Windows 10/11、WSL2、Linux（x86_64）
运行时：Python ≥ 3.10（依赖 qrcode / Pillow / openpyxl，由 deploy.ps1 自动安装）
宿主：WorkBuddy / 兼容 SkillHub 规范的智能体

交付物说明

| 文件 | 作用 | |------|------| | SKILL.md | 技能本体（智能体提示词） | | skill.json | 识别配置（上架用） | | README.md | 本文档 | | config.example.json | 配置模板（ERP / 钉钉 / 二维码 / OCR） | | errors.md | 故障排查 | | deploy.ps1 | Windows 一键部署 | | scripts/gen_qr.py | 二维码生成脚本 | | scripts/ledger.py | 出入库记账与结存重算（核心逻辑，含校验与自检） | | scripts/report.py | 收发存汇总 / 对账单 / 利润表生成 |

安全与合规

财务风险提示：本工具仅做整理辅助，不替代会计核决；报表须注明「仅供内部核对，非会计凭证」。
台账含商业数据，默认本地存储；外发前自动脱敏往来单位敏感信息。
对接第三方接口的密钥仅显示前 8 位，不写死在技能正文。

购买、试用与售后

当前定价：买断制 ¥69（全功能版）——含出入库整理 + 台账 + 报表 + 数据校验与异常预警 + 二维码电子码 + 电子单据 + 可选 ERP / 钉钉 / 云端 OCR 对接。一次付费，永久使用，无年费，无坐席限制。
规划中的分级（尚未拆分为独立商品）：基础台账版 ¥49（出入库整理 + 台账 + 报表 + 校验预警）为后续按模块授权的路线图；当前付费即获全部功能，不存在功能被阉割的"基础版"。
试用：提供 7 天免费试用，满意再买。
退款：买断制支持 7 天无理由退款（未超使用额度），联系作者处理。

常见问题

Q：二维码存在哪？ A：生成在技能目录 qr_<SKU>.png，并嵌入电子单据。
Q：不接 ERP 能用吗？ A：能。默认纯本地文件台账，ERP / 钉钉 / 云端 OCR 均为可选项。
Q：支持图片单据吗？ A：支持。推荐本机装本地 OCR 实现离线识别；或配置云端 OCR；也可直接粘贴文本 / 已识别内容。