涅槃系统·台账转化 Skill
==========================

将"定义生活"Excel 文件自动转化为标准化"人生台账"工作簿，包含阴阳积分汇总、掌控感趋势图、板块占比分析。

======================================================================
前置条件
======================================================================

  - WorkBuddy：已安装并登录
  - Python：3.9+（推荐 3.11 以上）
  - openpyxl：请在终端执行 pip install openpyxl

如果运行时报 "No module named 'openpyxl'"，在终端执行：

    pip install openpyxl

======================================================================
安装方法
======================================================================

1. 解压"人生台账.zip"
2. 将"人生台账/"整个文件夹放到 C:\Users\你的用户名\.workbuddy\skills\ 下
3. 重启 WorkBuddy（或刷新技能列表）

安装后，在 WorkBuddy 主对话中直接说：

    "帮我转化这份定义生活"

然后把你的定义生活 Excel 文件丢给它（拖拽或 @ 引用文件）。

======================================================================
定义生活文件格式要求
======================================================================

Skill 在转化前会自动进行三项格式预检，任何一项不通过就会拒绝转化并提示修正。

1. 文件名必须含日期
   - 正确：202606定义生活_自由创作者_小艺.xlsx
   - 错误：我的定义生活.xlsx（没有年月）
   - 格式：{YYYY}{MM}定义生活（阴·阳）.xlsx，年份 2020~2030，月份 01~12

2. 工作表命名
   - 正确：定义生活·阳·创作、定义生活·阴·罚款
   - 必须包含"定义生活·阳"或"定义生活·阴"
   - 不含"定义生活"的工作表（如"未定义生活""未雨绸缪"）会被跳过，不影响转化
   - 如果用 Excel 默认名（Sheet1），Skill 会尝试读取 A1 单元格的标题来补救——但建议直接改工作表名

3. 积分格式
   - 凡含"定义生活·阳"或"定义生活·阴"的工作表，B 列必须有 "分/" 格式的积分规则
   - 示例：写作/10分/篇、拖延/50分/次
   - 不会有"分/"的工作表将被拒绝

总结：阴 = 阳，一视同仁。含"定义生活·阳/阴" → 必须有积分规则。其他工作表一概不管。

======================================================================
输出内容
======================================================================

转化后会在定义生活文件同目录生成 {YYYYMM}人生台账.xlsx，包含：

  序号  工作表                  说明
  ─────────────────────────────────────────────────
  1.    备注                    公式说明
  2.    原始数据                从定义生活汇总的原始日志
  3.    已清洗数据              清洗后的标准化数据
  4.    月基本指标              阳得分/阴扣分/盈余/掌控感（按日）
  5.    月基本指标折线图        阳得分、阴扣分、盈余、掌控感趋势
  6.    月板块与活动分值明细    各板块活动积分明细
  7.    月板块饼状图            板块得分占比
  8.    月阳板块饼状图          仅阳板块占比
  9.    年基本指标              年度汇总（需手动填入月数据）
  10.   年板块饼状图            年度板块占比

======================================================================
常见问题
======================================================================

Q: 转化时卡住不动？
A: 先检查：
   1. 是否安装了 openpyxl（pip install openpyxl）
   2. 文件名是否有 YYYYMM 日期
   3. 工作表名是否含"定义生活·阳/阴"
   4. 阳/阴板块的 B 列是否有"分/"积分规则

Q: 生成的数据不对？
A: 检查原始定义生活文件：活动列格式是否正确、日期范围是否覆盖整个月、阴阳板块分类是否正确。

Q: 有了新版怎么更新？
A: 下载新版 zip → 解压 → 覆盖 ~\.workbuddy\skills\人生台账\ 目录 → 重启 WorkBuddy。旧版会被完全替换。

Q: 不想要这个 Skill 了？
A: 直接删除 ~\.workbuddy\skills\人生台账\ 整个文件夹即可。

======================================================================
版本历史
======================================================================

  v1.0  2026-06  首版发布，支持三项格式预检 + 便携模板内置

======================================================================

涅槃系统 | 陪你执行涅槃的落雨
