人生台账 Skill

功能描述

将用户的定义生活 Excel 文件自动转化为标准人生台账工作簿，并可选生成便携式 HTML 可视化报告（11 张交互图表，离线可用）。

使用场景

• 用户说生成人生台账 / 转化定义生活 / 制作台账
• 用户说深度复盘 / 可视化 / 生成 HTML / 看图表

执行流程

第一步：格式预检（必须）

接到请求后，先检查用户提供的文件是否符合格式要求：

1. 文件名格式：{YYYY}{MM}定义生活（阴·阳）.xlsx
2. 工作表名称：必须包含「定义生活（阴）」和「定义生活（阳）」
3. 列结构：日期 | 时间 | 活动 | 所属板块 | 本次积分 | 计算依据 | 说明

如果不符合：提示用户修正格式，不要继续执行。

第二步：转化人生台账

执行转化脚本

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

脚本说明

• generate_ledger_v6.py：台账转化脚本，自动从定义生活 Excel 提取数据、按模板生成标准人生台账
• 模板已 base64 嵌入脚本，零外部依赖

验证

生成后确认：

1. 输出文件存在：{YYYY}{MM}人生台账.xlsx
2. 工作表顺序正确：备注 → 原始数据 → 已清洗数据 → 月基本指标 → ...
3. 公式无错误（无 #REF!/#DIV/0!/#VALUE!）

第三步：生成可视化深度复盘（可选）

用户拿到人生台账后，如果要求'深度复盘'、'可视化'、'生成 HTML'、'看图表'，执行此步。

执行可视化脚本

python "{Skill目录}/scripts/gen_visual_v5.py" "{人生台账文件的绝对路径}"

输出：{YYYYMM}人生台账_深度复盘_v3.html（与台账同目录）

脚本说明

• gen_visual_v5.py：可视化生成脚本，自动从台账 Excel 提取数据、注入 HTML 模板
• templates/vis_step1_header.html：HTML 模板（含 11 张 Chart.js 图表代码）
• templates/chart.umd.min.js：Chart.js 4.4.7 库（已嵌入输出 HTML，离线可用）

验证

生成后确认：

1. HTML 文件大小 > 200KB（含嵌入的 Chart.js）
2. 用浏览器打开，所有图表正常显示
3. 控制台无报错

自动部署为可分享链接（必做）

生成 HTML 后，必须执行以下操作将报告部署为可分享链接，不允许直接返回本地文件路径：

第一步：准备部署目录

mkdir -p "{HTML文件所在目录}/dist"
cp "{生成的HTML文件完整路径}" "{HTML文件所在目录}/dist/index.html"

第二步：调用 workbuddy_cloudstudio_deploy 工具

重要：这是工具调用，不是 bash 命令。

• 工具名：workbuddy_cloudstudio_deploy
• 参数：directory = {HTML文件所在目录}/dist 的绝对路径，entry = "index.html"
• 工具返回的 URL 就是可分享链接（格式如 https://xxx.app.codebuddy.work）

第三步：将链接返回给用户

• 使用 present_files 工具展示 URL
• 同时用文字告知用户：可直接在浏览器打开此链接查看可视化报告

⚠️ 如果 workbuddy_cloudstudio_deploy 工具不可用，则跳过部署步骤，用 present_files 工具将 HTML 文件发送给用户。不要返回 file:/// 路径。

⚠️ 隐私提醒：生成的可分享链接包含您的个人数据（活动记录、积分、掌控感等），请勿分享给不信任的人。

技术说明

• Python 3.11+ 环境
• 依赖库：openpyxl（已嵌入模板，无需额外安装）
• 输出文件命名：{YYYY}{MM}人生台账.xlsx / {YYYYMM}人生台账_深度复盘_v3.html