涅槃系统·台账转化 v1.2.0

将「定义生活」Excel 文件转化为标准「人生台账」工作簿。

v1.2.0 改进：模板 xlsx 以 base64 嵌入 Python 脚本，运行时解码到内存加载，零外部文件依赖，兼容 SkillHub 分发。

工作流程

第一步：格式预检（必须执行，不可跳过）

在调用转化脚本之前，必须对用户提供的文件进行三项检查。有任何一项不通过，禁止转化，先让用户修正。

检查1：文件名是否含日期

• 正确格式：{YYYY}{MM}定义生活（阴·阳）.xlsx
• 判断标准：文件名中能否提取 YYYYMM 格式的 6 位数字（年份 2020~2030，月份 01~12）
• 不通过处理：
• 完全无日期 → 回复：「文件名缺少日期，请重命名为「{YYYYMM}定义生活_xxx.xlsx」格式，或者告诉我这份数据对应的是哪年哪月？」
• 能判断大概日期但格式不对 → 提示正确格式并请给出具体年月

检查2：工作表命名是否正确

• 正确格式：工作表名应为 定义生活·阳·板块名 或 定义生活·阴·板块名
• 判断标准：工作表名是否包含 定义生活 关键词。不含「定义生活」的工作表（如「未定义生活」「未雨绸缪」等）直接跳过
• 异常情况处理：
• 工作表名是 Excel 默认名（Sheet1、Sheet2、工作表1 等）→ 读取每个工作表的 A1 单元格，如果 A1 包含 定义生活 关键词，则以其作为板块标识继续转化，并提醒用户：「检测到工作表使用了默认名称，但已从 A1 读取到正确的板块标题（xxx），本次继续转化。建议下次重命名工作表。」
• 工作表名和 A1 都不含 定义生活、·阳·、·阴· → 禁止转化，回复：「无法识别有效的「定义生活」工作表。请检查工作表名和 A1 单元格。」

检查3：活动积分格式

• 只检查含「定义生活·阳」或「定义生活·阴」的工作表
• 逐行检查（定义工作表结构：Row1=板块标题、Row2=说明、Row3=表头"活动｜得分"、Row4 起为活动行）。从 Row4 开始，对每个 A 列非空的活动行，B 列必须包含 分/（如 写作/10分/篇）。任何一个活动缺失积分规则即阻断。
• 其他任何工作表统统跳过——不管是「未定义生活」「未雨绸缪」「积分商铺」还是其他自定义名称，都不检查
• 不通过处理：列出缺失积分规则的具体活动名，提示用户：「「{板块名}」中以下活动缺少积分规则：xxx、xxx。请补充（格式：活动名/分数/单位）。」如果整个板块 B 列完全没有 分/，提示：「「{板块名}」没有任何积分规则，请补充。」

第二步：执行转化

三项检查全部通过后，告知用户：「✅ 格式检查通过，正在执行转化脚本…」

然后执行 scripts/generate_ledger_v6.py：

python "scripts/generate_ledger_v6.py" "{定义生活文件的绝对路径}"

注意：

• 使用 Bash 工具执行，脚本在 Skill 的 scripts/ 目录中
• 脚本会自动在同目录生成 {YYYYMM}人生台账.xlsx
• 如果报错 openpyxl 缺失：先运行 pip install openpyxl，然后重试
• 如果脚本执行失败：分析错误信息，可能是文件格式或模板问题，参考第一步检查项排查

第三步：验证交付

转化完成后：

1. 确认生成的文件存在（{YYYYMM}人生台账.xlsx，与定义生活文件同目录）
2. 告知用户输出文件位置和基本统计（板块数、活动数）

技术说明

• scripts/generate_ledger_v6.py：主转化脚本 v1.2.0（~74 KB），模板 xlsx 以 base64 内嵌，运行时从内存加载
• 输出结构（10 个工作表）：备注 → 原始数据 → 已清洗数据 → 月基本指标 → 月基本指标折线图 → 月板块与活动积分明细 → 月板块饼状图 → 月阳板块饼状图 → 年基本指标 → 年板块饼状图
• 依赖：仅需 openpyxl