涅槃系统

要解决什么问题

很多人用 Excel 维护「定义生活」：按阴阳板块记录活动，并在 B 列写积分规则（如 写作/10分/篇）。手工再整理成带多工作表、图表的「人生台账」既重复又容易漏字段。本技能把格式校验和台账生成绑在一起：文件不过关就不跑脚本，避免生成半成品。

技能如何工作

整体分三步，前两步是硬门槛。

第一步：格式预检（不可跳过）

1. 文件名：须能解析出 YYYYMM（年份 2020–2030，月份 01–12），例如 {YYYYMM}定义生活（阴·阳）.xlsx。
2. 工作表：只处理名称含「定义生活」的表；未定义生活、未雨绸缪 等会跳过。若表名是 Sheet1 这类默认值，会读 A1 是否含「定义生活」再决定是否转化，并提示你下次改名。
3. 活动积分：仅检查含「定义生活·阳」或「定义生活·阴」的表。自第 4 行起，A 列有活动的行，B 列必须带 分/ 规则；缺一则列出活动名并阻断。

三项全通过后，执行 scripts/generate_ledger_v6.py，在同目录生成 {YYYYMM}人生台账.xlsx（数据来自你的定义生活文件，结构来自 assets/202601人生台账模板.xlsx）。

第三步：交付

确认输出文件存在，并说明板块数、活动数等简要统计。

适用边界与注意点

• 预检失败时不会调用转化脚本，需先按提示改文件名、工作表名或积分列。
• 非「定义生活·阳/阴」工作表不参与积分检查，也不会被当作定义生活板块转化。
• 脚本依赖 openpyxl；环境缺库时需先安装再重试。执行报错时，优先对照上述三项检查排查模板与单元格格式。