这个工具帮你从序时账自动生成"主营业务成本倒轧表"——就是审计底稿里那张从原材料一路倒轧到主营业务成本的表。你只需要上传文件、回答几个问题，剩下的交给它处理。
这是最关键的一条，必须先看懂！
🔍 什么是一借一贷？
一张凭证里，借方只有一行、贷方也只有一行，金额相等。比如：
借：主营业务成本 1000 元 ｜ 贷：库存商品 1000 元
这就是一借一贷。
🚫 什么是复合凭证（一借多贷 / 多借一贷）？
一张凭证里，借方有多行、或贷方有多行。比如：
借：主营业务成本 60 元 + 借：销售费用 40 元 ｜ 贷：库存商品 100 元
这是"两借一贷"，属于复合凭证。
📋 为什么要先拆？
本工具只会处理一借一贷的凭证。遇到复合凭证，它会直接扔进"未分配事项"清单，不猜、不拆、不算。
所以你上传序时账之前，必须先用其他工具（财务软件导出时的拆分功能、或者手工拆）把复合凭证拆成一借一贷的格式。
💡 怎么拆？
举个例子，上面那张"两借一贷"的复合凭证，拆成两张一借一贷：
- 借：主营业务成本 60 元 ｜ 贷：库存商品 60 元
- 借：销售费用 40 元 ｜ 贷：库存商品 40 元
拆完再上传。本工具不负责拆分，只负责分析拆好后的序时账。
- 🔍 自动识别你的序时账：支持用友、金蝶等常见财务软件导出的格式，包括中文编码的文本文件和真正的 Excel 文件。
- 🔗 梳理成本流转关系：自动找出"库存商品转主营业务成本""生产成本转库存商品""原材料转生产成本"等凭证级的对应关系。
- 📊 生成倒轧表：如果你提供了期初期末存货和在产品数据，会按标准公式计算，生成完整的倒轧表。
- 🪜 智能降级：如果资料不全，不会硬凑，而是明确告诉你缺什么，并生成"成本流转分析"（非完整倒轧）。
- ✂️ 自动增减行次：倒轧表会根据你实际提供的数据，自动跳过没有数据的行（比如没有原材料数据就不显示原材料段），只显示有内容的行。
| 东西 | 说明 |
|---|---|
| 📄 序时账文件 | 从财务软件导出的账务明细，必须是一借一贷拆分好的（见上方重要前提） |
| 📅 审计期间 | 比如"2025年1月到12月"，如果文件里能自动识别出来就不用你说 |
序时账文件里至少要有这些列（表头名字差不多就行，工具会自动匹配）：
- 📆 记账日期
- 📝 凭证编号
- 🔢 科目编号 或 科目名称
- 💰 借方金额
- 💰 贷方金额
如果你想要完整的倒轧表（而不只是成本流转分析），还需要提供：
- 🏭 产成品（库存商品）期初和期末余额
- 🔧 在产品期初和期末余额
- 📦 完工入库金额、外购产成品金额
- 👷 直接材料、直接人工、制造费用投入金额
- 其他调整项（非销售转出、盘盈盘亏等）
没有这些也没关系，工具会自动降级为"成本流转分析"，不会卡住。
把拆好一借一贷的序时账文件发给助手。可以是一个文件，也可以是多个。
助手会读取文件，自动识别：
- 文件真实格式（文本还是 Excel）
- 文字编码（中文编码还是通用编码）
- 表头列名
- 涉及哪些月份
- 候选的成本科目有哪些
如果发现缺少必需的列，会告诉你补什么。
根据你的数据情况，助手可能会问以下问题。只在必要时问，不会一股脑全问：
助手会把最终参数列给你看（公司名、期间、文件范围、科目分类、输出模式），你确认"没问题"后助手才开始运行。
运行完成后，你会得到一个 Excel 工作簿。打开就能用，所有金额都能追溯到源文件的具体行。
助手可能会问你这些问题，下面解释每个问题的意思和怎么回答：
| 助手问什么 | 什么时候问 | 你怎么回答 |
|---|---|---|
| 📅 "审计期间是哪段时间？" | 文件里看不出起止月份时 | 告诉助手"2025年1月到12月" |
| 🏢 "这次处理哪个公司？" | 文件里有多个公司时 | 告诉助手这次只处理哪个 |
| 📚 "用哪个账套？" | 文件里有多个账套时 | 告诉助手这次用哪个 |
| 🤔 "这个科目算什么类别？" | 某个科目名字同时像两个类别时（比如"生产成本-制造费用转入"既像生产成本又像制造费用） | 助手会列出候选，你选一个 |
| ❓ "这个科目认不出来，怎么办？" | 某个科目完全认不出类别时 | 告诉助手这个科目算什么类别 |
| 💰 "期初存货余额是多少？" | 你要完整倒轧但没给期初数时 | 提供金额，或说"没有，按成本流转分析做" |
| 💰 "期末存货余额是多少？" | 同上 | 同上 |
| 💰 "在产品余额是多少？" | 同上 | 同上 |
一个 Excel 工作簿，包含以下工作表：
这是核心，按标准审计底稿格式生成：
- 📋 顶部：被审计单位、编制人、复核人、日期、索引号
- 📊 表头：项目内容 ｜ 计算说明 ｜ 数据来源 ｜ 索引号 ｜ 未审数 ｜ 审计调整 ｜ 审定数 ｜ 上期数
- 🔢 倒轧公式链：从原材料 → 直接材料 → 产品生产成本 → 产成品成本 → 主营业务成本，逐层倒轧
- ✅ 审定数列自动带公式（审定数 = 未审数 + 审计调整）
- ✂️ 行次自动增减：只有你有数据的行才显示，没数据的行自动跳过
- 📝 底部：审计说明、审计结论（空白，留给你填）
列出所有一借一贷的凭证级流转关系，每条都带源文件、工作表、行号，可以追溯。
复合凭证（没拆成一借一贷的）会列在这里，告诉你哪些凭证没处理、为什么没处理。
每个金额对应源文件的哪一行，一目了然。
原始科目到标准角色的映射记录，谁确认的、怎么确认的都有记录。
每个文件的借贷合计、差额、行数，用来核对数据完整性。
- 🚫 不猜：复合凭证（没拆成一借一贷的）全部放进"未分配事项"，不按比例猜、不自动拆。
- 🚫 不偷偷归零：遇到"abc"这种非法金额会报错，不会偷偷当 0 处理。
- 🚫 不覆盖你的文件：输出文件如果已存在，会提醒你换名字，绝不直接覆盖。
- 🚫 不替你下结论：不会自动写"已检查""未发现异常"之类的话，审计说明和审计结论区域留给你填。
- 🚫 不硬凑倒轧：没有期初期末数据时，明确降级为"成本流转分析"，不生成假的完整倒轧。
- 🚫 不用合并单元格：表格用"跨列居中"和"独立行"实现，看起来和合并一样，但复制粘贴、筛选排序都不卡。
- 🚫 不拆分复合凭证：拆分是你的事，工具只分析拆好的一借一贷。
以下情况助手会停下来，等你处理后再继续：
- 📄 序时账缺必需的列，且你没法补充 → 停下
- 🔤 文件编码完全认不出 → 停下
- 💰 同一个文件金额解析错误超过 3 行 → 停下
- ⚖️ 借贷差额超过总额 1% 且你没核对 → 停下
- 📁 输出文件已存在且你没确认覆盖 → 停下
- 🚫 上传了复合凭证没拆分 → 助手会提醒你先拆，拆完再上传
❓ 我的序时账是 .xls 后缀，但其实是文本文件，能用吗？ ✅ 能。工具会通过文件内容识别真实格式，不看后缀名。中文编码的制表符分隔文本会自动识别。
❓ 复合凭证（比如借主营业务成本60+借销售费用40/贷库存商品100）会怎么处理？
❓ 跨月同号凭证会串单吗？ ✅ 不会。工具用"公司+账套+年度+月份+凭证类型+凭证号"组合作为凭证唯一标识，跨月同号不会合并。
❓ 括号负数和红字冲销能识别吗？ ✅ 能。"(1,234.56)"会被识别为负数 -1234.56，红字负号也能识别。
❓ 我没有期初期末存货数据，能生成倒轧表吗？
❓ 倒轧表的行次是固定的吗？ ✅ 不是。工具会根据你实际提供的数据自动增减行次，而且你在 Excel 里也能随便加行删行，公式不会坏。
为什么不会坏？
- ✅ 审定数列（G列）的公式只有
=本行未审数+本行审计调整，永远只引用同一行，你怎么加行删行都不影响 - ✅ 小计行（如"直接材料成本""产品生产成本"）的未审数列（E列）填的是算好的数值，不是跨行公式，所以加行删行不会让公式错乱
- ✅ 计算说明列（B列）保留了公式逻辑（如
⑹=⑴+⑵+⑶-⑷-⑸），你如果改了数据要重算小计，照着这个说明自己加公式就行
自动减行（跳过空行）：
- 有数据的行才显示
- 没数据的行自动跳过
- 小计行如果依赖的行全没数据，小计行也跳过
- "主营业务成本"行始终保留（即使没倒扎数据，也会填序时账里的实际发生额）
自动增行（明细展开）：
- 如果序时账里制造费用有明细科目（比如折旧费、水电费、修理费等），会自动在"制造费用"行下面展开多行明细
- 每个明细科目一行，显示明细名称和金额
- "制造费用"行的金额 = 明细行合计
手动加行：
- 你在 Excel 里随便加行（比如加一行"原材料和库存商品互转"、或者"领用半成品进生产成本"）
- 加完后把新行的未审数填上，审定数列会自动算（G=E+F）
- 如果新行影响小计，照着 B 列的计算说明手动加个小计公式就行
❓ 输出文件里有合并单元格吗？ ✅ 没有。标题用"跨列居中"实现（看起来和合并一样，但每个格子独立），多行信息拆成独立行。复制粘贴、筛选排序都不会卡。
❓ 能追溯每个金额的来源吗？ ✅ 能。"凭证追溯"工作表记录了每个金额对应的源文件、工作表、行号。
❓ 工具会自动写审计结论吗？ 🚫 不会。所有"审计说明""审计结论"区域默认空白，由项目人员人工填写。
❓ 贸易型企业（没有生产环节）能用吗？ ✅ 能。倒轧表会自动跳过原材料段、生产成本段（因为没有数据），只显示产成品段和主营业务成本。行次会自动减少。
这个工具的文件结构如下（你不需要改这些文件，了解一下就行）：
- 📄 技能指令文件：给助手看的，定义工具怎么工作
- 📄 本说明文件：给你看的（就是你现在读的这个）
- 📄 项目配置：工具的配置信息
- 📁 核心代码：工具的程序逻辑
- 📁 可执行脚本：工具的入口
- 📁 默认模板：空白倒轧表模板
- 📁 参考文档：科目映射指南、输入要求、模板设计
- 📁 测试：验证工具正确性的测试用例
- 📁 旧脚本：之前的旧版本，已弃用
工具运行需要以下环境（你不需要自己装，助手会处理）：
- 🐍 Python 3.11 以上版本
- 📊 openpyxl：读写 Excel 文件
- 📊 xlrd：读取老式 Excel 文件
- 📄 PyYAML：读取配置文件
不需要 pandas 等重型依赖，轻量够用。
直接跟助手说一句类似这样的话就行：
"帮我用成本倒轧技能处理我上传的序时账。公司是某某制造有限公司，期间是2025年1月到12月。序时账已经拆成一借一贷了。我目前没有期初期末在产品资料，你先按现有资料处理。"
助手会自动预检文件、问你缺的信息、确认参数、生成倒轧表。你不需要敲任何命令。