焕杼 · 税务健康诊断
操作手册 · v0.1.1 · 本地计算，数据不出本机
先说三件事，很重要
- 这只是自查参考，不是税务意见。报告帮你看哪里可能有问题、该查什么，不帮你做筹划，也不预测会不会被查。
- 数据不出你的电脑。全程本机计算，不联网、不上传。报告生成在你自己电脑的
reports 文件夹里。
- 一项一机一个激活码。换电脑要重新拿码，这是正常的。
一、你拿到的是什么
| 文件 / 文件夹 | 干什么用的 |
|---|
start.bat | 双击这个就开始用，其他都不用管 |
runtime 文件夹 | 自带的运行环境，所以不用装 Python，别删 |
样例数据 文件夹 | 一份填好数字的样例表，先拿它试一遍 |
操作手册.html | 就是本文件 |
快速上手.txt | 30 秒版，忘了就翻它 |
检查环境.bat | 启动不了时先双击它，看缺什么 |
reports 文件夹 | 生成的报告都在这，第一次运行会自动建 |
二、九步上手（照着做，不用懂电脑）
第 1 步 · 解压
| 你做什么 | 看到什么 |
|---|
| 右键点压缩包 → 全部解压缩 → 选一个文件夹（建议放 D 盘，路径别有空格和中文符号） | 得到一个文件夹，里面能看到 start.bat |
不要在压缩包里直接双击，一定要先解压出来。否则会提示找不到运行环境。
第 2 步 · 第一次启动
| 你做什么 | 看到什么 |
|---|
双击 start.bat | 黑色窗口，显示「焕杼 · 税务健康诊断」和一行 本机指纹：XXXXXXXXXXXX（16 位字母数字） |
第 3 步 · 拿激活码
| 你做什么 | 看到什么 |
|---|
| 把 本机指纹 那 16 位发给您的购买渠道（复制粘贴即可） | 对方回你一条 HZ1. 开头的字符串，那就是激活码 |
第 4 步 · 粘贴激活码
| 你做什么 | 看到什么 |
|---|
| 在窗口里粘贴（右键即粘贴），回车 | 显示「激活成功，正在进入主程序…」，然后出现菜单 |
激活只做一次。以后每次直接双击 start.bat 就进菜单，不用再输码。
第 5 步 · 先拿样例试一遍
| 你做什么 | 看到什么 |
|---|
| 菜单选 1 → 路径直接回车（用样例） | 「识别到 22 个字段」→ 打印健康分和命中项 → 「报告已生成」 |
第 6 步 · 看报告
| 你做什么 | 看到什么 |
|---|
| 窗口问「现在用浏览器打开吗」，直接回车 | 浏览器打开一份报告：顶部是健康分，下面分「命中项 / 通过项 / 数据不足」三块 |
第 7 步 · 准备你自己的数据
| 你做什么 | 看到什么 |
|---|
用 Excel 打开 样例数据\样例-2025年度.xlsx，把「值」那一列换成你公司的数，另存为一个新文件 | 表就两个列：字段名 和 值。字段名别改，只改数值 |
第 8 步 · 跑自己的数据
| 你做什么 | 看到什么 |
|---|
| 菜单选 1 → 把文件路径粘进去（或把文件拖进窗口）→ 回车 | 同样的过程，生成一份属于你公司的报告 |
第 9 步 · 按报告去查
| 你做什么 | 看到什么 |
|---|
| 看「命中项」那一栏，每条都有 计算与证据 和 建议自查路径，按路径去核对你自己的账 | 每条都能追溯到数字怎么算出来的，不是一句「有风险」 |
三、数据怎么准备（字段表）
表头就两列：字段名、值。字段名照抄下面这张表，认不出的列会被忽略（不会报错）。
| 字段名 | 必填 | 说明 |
|---|
| 营业收入 | 是 | 年度营业收入（含主营与其他业务收入时请注明口径） |
| 营业成本 | 是 | 与收入配比的成本 |
| 销项金额 / 销项税额 | 是 | 全年开票销售额与销项税额 |
| 进项金额 / 进项税额 | 是 | 全年取得发票金额与进项税额 |
| 蓝字发票张数 / 红字发票张数 / 作废发票张数 | 是 | 全年开票张数统计 |
| 期间费用 | 是 | 销售+管理+财务费用合计 |
| 应交税费余额 | 是 | 期末应交税费余额 |
| 应纳增值税 / 应纳所得税 | 是 | 本年实际应纳金额 |
| 逾期申报次数 / 零申报月数 | 是 | 近 12 个月统计 |
| 顶额发票张数 | 选填 | 接近开票限额（如 9.9 万–10 万）的张数 |
| 对公流水收入 | 选填 | 对公账户全年收款合计 |
| 存货账面金额 | 选填 | 期末存货账面余额 |
| 其他应收单户最大余额 | 选填 | 单户最大挂账金额 |
| 上期毛利率 | 选填 | 去年毛利率，如 0.30 或 30% |
| 月均应纳税额 | 选填 | 平均每月应纳税额 |
选填的字段不填也没关系，对应的自查项会标成「数据不足，未评估」——不会瞎猜结论。
四、报告怎么看
| 看到什么 | 怎么理解 |
|---|
| 健康分（0–100） | 100 − 高风险项×8 − 中风险项×3。只用于横向对比（今年 vs 去年、你 vs 同行），不作合规结论 |
| 等级：健康 / 关注 / 需整改 / 高风险 | ≥85 健康 ｜ 70–84 关注 ｜ 55–69 需整改 ｜ <55 高风险 |
| 命中项 | 需要你去核对的地方，每条带计算过程 + 自查路径 + 口径来源 |
| 通过项 | 本次数据没触发，但同样列了计算过程 |
| 数据不足 | 缺字段，没法算。补上字段再跑一次就有了 |
五、故障对照表
| 你看到的 | 怎么办 |
|---|
| 窗口一闪就没了 | 先双击 检查环境.bat 看缺什么；确认是「全部解压缩」出来的文件夹 |
| 提示「没有找到可用的 Python」 | runtime 文件夹被删了或没解压全，重新解压整个包 |
| 提示「本机授权已被终止」 | 联系交付方核对授权状态 |
| 提示「激活码不对」 | 码要整行复制，含 HZ1. 开头那一段；换机要重新要码 |
| 提示「文件不存在」 | 路径里有中文空格没关系，但要把整个文件拖进窗口，别手打 |
| 提示「读不了这个文件」 | 只支持 .xlsx 和 .csv；老 .xls 请另存为 .xlsx |
| 「一个标准字段都没识别到」 | 表头必须是 字段名 / 值 两列，字段名照抄手册第三节 |
| 报告里很多「数据不足」 | 正常，补上对应字段（多为选填项）再跑 |
| 浏览器没自动打开报告 | 去 reports 文件夹里双击那个 .html 文件 |
| 数字跑出来明显不对 | 先核对表里单位（元 / 万元）与百分比写法（0.30 或 30%） |
六、边界与免责
- 不构成税务、法律或会计意见，不替代税务机关认定，不替代税务师/会计师事务所服务。
- 不做筹划、不做方案设计、不预测稽查概率——这是设计边界，不是功能缺失。
- 规则阈值是行业通用经验值，非官方预警线；请结合自身情况判断。
- 报告不含企业名称与税号，默认脱敏，便于内部传阅。
- 断网可用（吊销核验需联网，取不到时按可用处理）。
七、出问题了发什么给我
1. 报错窗口的原图截图（不要转述）
2. 你第几步出的问题（对应本手册第二节的编号）
3. 检查环境.bat 的运行结果（截图或复制文字）