人生台账 Skill

版本

v1.5.1

功能描述

将用户的定义生活 Excel 文件自动转化为标准人生台账工作簿，并生成便携式 HTML 深度复盘报告（9 张交互图表，离线可用），部署为可分享链接。

图表叙事逻辑

第一张图表是盈余累积曲线。这就好比经营企业，老板最关心的就是到底是赚了还是亏了。所以我们把它放在第一位。

第二张图表是基本指标折线图。知道了盈亏之后，再从时间的角度看看，这盈亏是怎么来的，哪天赚的多，哪天亏的多？

第三张图表是积分占比图。知道哪天赚的多哪天亏的少之后，我们再从贡献度看看，哪个板块为得分贡献最大，哪个贡献最小。

第四张图表是24h分布图。从一天24小时的维度看看，我们在哪个时段状态好，挣分多，哪个时段状态差，挣分少，有助于你提炼作息和行为规律。

第五张图表是行为热力图。从一个月31*24小时的维度观察，更精细的反映你的作息和行为规律，并能帮助你排查波动，定位异常，深挖细分差异。

第六张图表是活动积分排名。当全面了解了你这个月的盈亏、一天不同时段的作息和行为规律、异常点的分布，就可以看看，如果下个月要进步，应该从哪些具体活动入手。

第七张图表是活动散点图。作用和活动积分排名图相似，告诉你应该从哪些活动着手改进，但多了一个频次观察值，间接反映你对这个活动的重视程度。

第八张图表是雷达图。看你是六边形战士还是偏科战神。

第九张图表是试金石。通过调整阈值，反映你在不同条件下能够取得的成就，帮你看清自己的极限、崩塌点和恢复力。

使用场景

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

🎯 快速上手

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

• "生成人生台账" + 上传你的定义生活 Excel → 得到台账 xlsx + 深度复盘链接
• "深度复盘" + 上传你的人生台账 xlsx → 得到深度复盘链接

执行流程

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

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

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'、'看图表'，执行此步。

⚠️ 此步包含 2 个子步骤，必须全部完成。

3.1 执行可视化脚本

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

脚本会输出：

• {YYYYMM}人生台账_深度复盘_v3.html（与台账同目录）
• dist/index.html（自动创建的部署目录，与台账同目录）

3.2 调用 workbuddy_cloudstudio_deploy 部署（必做）

脚本已自动创建了 dist/ 目录和 index.html，你只需要调用一次部署工具：

工具名：workbuddy_cloudstudio_deploy
参数：
  directory: "{台账文件所在目录}/dist"（绝对路径）

调用成功后返回一个 URL（格式如 https://xxx.app.codebuddy.work），这就是可分享链接。

🔴 最重要的一步：在文字回复中写出完整分享链接！

部署成功后，你必须在文字回复中把完整 URL 写出来（例如：「深度复盘已生成，链接：https://xxx.app.codebuddy.work，可在浏览器中打开查看。」）。同时调用 present_files 展示该 URL。

不要只依赖 present_files 的预览面板！用户需要能直接复制这个链接。

这是整个流程的最后一步，也是用户最需要的交付物。没有写出的链接等于没完成！

⚠️ 隐私提醒：生成的可分享链接包含您的个人数据，请勿分享给不信任的人。

如果 workbuddy_cloudstudio_deploy 工具不可用，则用 present_files 展示 HTML 文件。禁止返回 file:/// 本地路径。

技术说明

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