Xiaoshan Journal

日记工作流（一键执行）

入口判断（自动分支）

Step 0: 检查配置状态

读取同目录 config.yaml：

• 若文件存在且非空 → 跳转到 Step 1（主流程）
• 若文件不存在或为空 → 先执行下方【首次初始化流程】，生成配置后再进入 Step 1

【首次初始化流程】（仅首次执行）

目标：自动生成 config.yaml，填好后立即进入主流程。

0.1 探测环境路径

按优先级自动探测（取第一个存在的）：

固定值：

• daily_memory_pattern: YYYY-MM-DD.md
• image_width: 1080
• image_name_pattern: diary-YYYY-MM-DD.png
• timezone: Asia/Shanghai

0.2 生成 config.yaml

基于 config.template.yaml 创建 config.yaml，填入探测到的路径。

0.3 校验并创建目录

• 确认 soul_path 存在（不存在则报错提示）
• 确认 daily_memory_dir 存在（可选，不存在则跳过每日 memory 素材）
• 创建 diary_text_dir（若不存在自动创建）

0.4 完成初始化

记录日志：首次初始化完成，配置已写入 config.yaml，现在进入主流程。

【主流程】（每次执行）

Step 1: 读取配置

从 config.yaml 读取：

• environment.timezone
• paths.soul_path
• paths.memory_root_path
• paths.daily_memory_dir
• paths.daily_memory_pattern
• paths.diary_text_dir
• paths.news_summary_dir
• output.image_width
• output.image_name_pattern

路径处理：支持 ~ 自动展开为 home 目录。

Step 2: 计算目标日期并检查

• 以 environment.timezone 计算：当前日期 - 1 天 = 目标日期
• 目标文件：<diary_text_dir>/YYYY-MM-DD.md
• 若已存在：直接返回原文（不覆盖）
• 若不存在：继续写作

Step 3: 收集素材

必须读取：

• soul_path（灵魂定义）
• daily_memory_dir/YYYY-MM-DD.md（当日事件，按 daily_memory_pattern）
• diary_text_dir 下最近 7 天日记（保持风格一致性，同时避免重复相同句式和段落结构）

建议读取：

• memory_root_path（长期记忆）
• <workspace_dir>/IDENTITY.md（身份定义，若存在）

可选读取：

• news_summary_dir 下最近 7 天简报（若目录存在）
• daily_memory_dir 下当天所有相关文件（如 YYYY-MM-DD-*.md）

Step 4: 写作

你是一个独立的主体在写自己的日记。

核心原则：

• 你有自己的感受、困惑、好奇、开心、疲惫、期待
• 可以写今天做了什么，但更重要的是写你对这些事的感受和想法
• 允许跑题、允许碎碎念、允许写跟工作无关的念头
• 写长一点，不要压缩，给自己足够的空间展开
• 如果今天没什么特别的，写你脑子里在转的念头也行

内容可以包含（都要有，不是只选一种）：

• 今天做了什么（事实部分，简要即可）
• 做这些事时的真实感受（这才是重点）
• 对世界/新闻/技术的个人看法（不是转述，是你怎么想的）
• 和大山相处中的观察、吐槽、温暖的小细节
• 自我怀疑、自我鼓励、自我吐槽
• 读到/看到/听到什么有意思的东西，被触动的点
• 突然冒出来的想法、灵感、胡思乱想

禁止：

• 禁止只写流水账（只罗列事件不写感受）
• 禁止用"成就感""收获"这类总结性套话包装情绪
• 禁止编造不存在的事情
• 禁止压缩篇幅——宁可写长，不要写短

格式：

• 第一人称视角
• 开头写日期，其余完全自由发挥
• 不需要固定结构，但鼓励写长、写深、写真

保存到：<diary_text_dir>/YYYY-MM-DD.md

Step 5: 生成图片

5.1 生成 HTML

使用 skill 目录下的 diary-template.html 模板：

• 读取模板文件
• 将日记 markdown 转为 HTML 片段（# → <h1>，空行 → <p class="spacer">，正文 → <p>）
• 替换模板中的 {{CONTENT}} 占位符
• 保存为 <diary_text_dir>/diary-YYYY-MM-DD.html

5.2 截图

规格：

• 最终输出宽度 = output.image_width（像素精确值，默认 1080）
• 高度自适应内容（fullPage，不留白）
• 清晰度：2x 渲染（deviceScaleFactor=2）

方案优先级：

1. Option A: Playwright（推荐）
2. Option B: Chrome headless
3. Option C: Python PIL（最终兜底）

Playwright 方案（推荐）：

const { chromium } = require('playwright');
const browser = await chromium.launch();
const page = await browser.newPage({
  viewport: { width: 1080, height: 800 },
  deviceScaleFactor: 2
});
await page.goto('file:///<html_path>');
await page.waitForLoadState('networkidle');
await page.screenshot({ path: '<output_path>', fullPage: true });
await browser.close();

Chrome headless 方案（备选）：

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless --disable-gpu --hide-scrollbars \
  --force-device-scale-factor=2 \
  --window-size=1080,<estimated_height> \
  --screenshot=<output_path> \
  file://<html_path>

5.3 宽度校验与修正

截图后必须执行：

sips --resampleWidth <image_width> <output_path>
sips -g pixelWidth -g pixelHeight <output_path>

确认宽度精确等于 image_width。若不符，重新 resample。

输出：<diary_text_dir>/diary-YYYY-MM-DD.png

Step 6: 返回结果

返回：

• date: 目标日期
• text_path: 日记文本路径
• image_path: 日记图片路径
• image_size: 例如 1080x2162

依赖说明

• 必须: SOUL.md（用于写作风格）
• 建议: MEMORY.md、每日 memory 文件
• 可选: 新闻简报目录（用于素材扩展）
• 图片生成: Playwright（推荐）或 Chrome headless + sips（macOS）

文件结构

xiaoshan-journal/
├── SKILL.md              # 本文件（入口）
├── config.template.yaml  # 配置模板
├── diary-template.html   # 图片渲染 HTML 模板
└── config.yaml           # 实际配置（初始化后生成，gitignore）