精斗云记账助手

要解决的问题

把发票导出、银行流水、工资表、余额表整理成精斗云能导入的凭证，看起来只是抄数，真正卡人的地方通常有三类：

• 每条分录要决定业务口径：销项是否已收讫、进项能否抵扣、成本是否该结转、跨期费用归属哪一期。
• 导入模板有硬约束：科目必须是末级、辅助核算要填编码而不是名称、币别 要为 RMB、银行流水里的千分位逗号要先去掉。
• 结账是不可逆动作。一旦导入报错或金额不平，后续查找非常费力，所以最好在生成阶段就跑一套可重复的硬检查。

精斗云没有开放 API 可直接拉取账套数据，所以凭证生成、结账前审核、结账后经营分析都必须在本地完成，再由用户在网页端完成导入、结转损益和期末结账。

工作方式

核心流程是：本地单据 -> 凭证定义 -> 导入模板字典 -> 生成 xlsx -> 自动审核 -> 用户导入结账。

• 准备基础资料与模板：在精斗云里维护本期需要引用的客户、供应商、职员等辅助核算对象；从【凭证管理→导入→下载模板】导出最新模板。脚本通过模板里的 辅助核算项目数据 sheet 把名称反查成编码。云端改动不会自动同步到本地 xlsx，因此模板过期是常见失败原因。
• 集中放置单据：建议按固定命名放文件，例如 *开具*发票*.xlsx、*取得*发票*.xlsx、*工资*.xlsx、*农商*流水*.xls、*邮储*明细*.xls。文件名不匹配时用参数指定路径。
• 构造凭证定义：在 scripts/gen_voucher.py 的 V 列表中写每张凭证的凭证号、日期、摘要和分录。业务判断在这里落定，例如农产品自产自销是否免税、普通发票是否抵扣。
• 生成与自查：脚本读取科目和辅助核算字典，校验科目末级、补辅助核算编码、检查借贷平衡。引用了未建对象的凭证会被拆到 待补 sheet，并导出 待建基础资料清单。
• 结账前审核：scripts/audit.py 执行 13 项硬检查，并输出人工判断清单和 结账前审核报告.md。存在 ❌ 时不建议结账，应改凭证后重跑审核。
• 导入与结账：用户在精斗云【凭证管理→导入】选择文件，再做结转损益和期末结账。若仍报错，把错误信息回传并按提示修改 V 列表或基础资料。
• 沉淀经验：scripts/update_skill.py 用于升版本、写 CHANGELOG.md 并重新打包升级包，把本月新出现的供应商类型、发票解析差异或更好的判断口径固化下来。
• 结账后报告：scripts/report.py 读取利润表和科目余额表，生成月报或季报。由于不能直接用 API 从云端拉取数据，需要用户先导出报表文件。若余额表勾选了辅助核算明细，收入可按产品或客户拆分；否则报告会退化为按科目汇总并提示。

适用边界

适合由财务会计在本地准备凭证、由 AI 负责识别单据、生成文件和执行审核的流程。基础资料维护、导入、结转损益、期末结账由用户操作。

需要人工拍板的问题不应由脚本自动决定：跨期发票与工资归属、已收销项究竟挂在 银行存款 还是代收往来、无出库单时的成本结转时点、极小额验证款是否补记。经营报告中的税务提示依赖企业纳税身份和农产品政策，默认值只能作为配置项，不能替代当地口径。每月归档利润表与科目余额表后，环比、同比和季度累计才有意义。