val-blog/org/cases/val_blog/docs/03-content-pipeline.md

每日梦幻旅程记录 - 内容流水线设计

1. 内容流水线概览

┌─────────────────────────────────────────────────────────────────────┐
│                     内容创作流水线                                   │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐      │
│  │ 灵感捕捉  │ → │ 草稿创作  │ → │ 审核润色  │ → │ 发布归档  │      │
│  │ Capture  │    │ Draft    │    │ Review   │    │ Publish  │      │
│  └──────────┘    └──────────┘    └──────────┘    └──────────┘      │
│       ↓               ↓               ↓               ↓             │
│  Obsidian/      VS Code +      Self/Peer      Hugo Build +        │
│  备忘录          Markdown       Review          Git Push           │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘

---

2. 内容类型与发布节奏

2.1 发布节奏表

内容类型	频率	最佳发布时间	字数范围	准备周期
速记 (Sketch)	每周 2-3 篇	晚间 21:00-23:00	300-800	即时-1天
旅程记录 (Journey)	每周 1-2 篇	周末上午 10:00	1500-3000	2-3天
图志 (Gallery)	每两周 1 篇	周末下午 15:00	图文为主	3-5天
深度文 (Essay)	每月 1-2 篇	月初/月中 20:00	3000-5000	1-2周

2.2 内容日历模板

# content-calendar.yaml
weekly_quota:
  minimum: 2  # 每周最少发布
  target: 4   # 每周目标发布
  maximum: 6  # 每周最多发布（避免过度）

publishing_windows:
  weekday_evening:
    time: "21:00-23:00"
    types: [sketch]
    description: "适合轻松的速记、灵感片段"
  
  weekend_morning:
    time: "10:00-12:00"
    types: [journey]
    description: "适合完整的旅程叙事"
  
  weekend_afternoon:
    time: "15:00-17:00"
    types: [gallery]
    description: "适合视觉为主的内容"
  
  special_slot:
    time: "每月第一个周日 20:00"
    types: [essay]
    description: "深度长文的专属时段"

content_buffer:
  target: 4  # 保持4篇待发缓冲
  minimum: 2 # 低于此数量时预警

---

3. 内容模板库

3.1 速记模板 (Sketch)

---
title: "标题 - 简短有力，捕捉瞬间"
date: 2026-03-09T21:00:00+08:00
categories: ["sketch"]
tags: ["标签1", "标签2"]
mood: "平静|兴奋| melancholic | 神秘"
weather: "雾|雨|晴|雪|未知"
time_of_day: "黎明|正午|黄昏|深夜"
location: "地点名称"
world: "世界观名称"
description: "一句话描述"
---

<!-- 
速记写作指南：
- 首句必须是感官描写或场景建立
- 控制在3-5个段落
- 不要解释，只呈现
- 结尾留白，让读者自行想象
-->

首句建立场景...

中间段落展开...

结尾留白...

3.2 旅程记录模板 (Journey)

---
title: "旅程标题"
date: 2026-03-09T10:00:00+08:00
categories: ["journey"]
tags: ["标签1", "标签2", "标签3"]
series: "系列名称（如适用）"
series_order: 1
location: "具体地点"
world: "世界观名称"
cover:
  image: "/images/covers/xxx.jpg"
  alt: "图片替代文字"
  caption: "图片说明"
description: "旅程简介，用于列表展示"
toc: true
reading_time: true
---

## 旅程起点

描述出发的地点、时间、初始状态。建立读者对旅程的期待。

## 路线与见闻

### 第一段路程

详细记录沿途的发现。使用感官描写：
- **视觉**：颜色、形状、光影
- **听觉**：声音、寂静、回声
- **触觉**：温度、质地、湿度
- **嗅觉/味觉**：如有

### 关键地点名称

深入描写重要地点...

## 关键发现

旅程中的重要发现、遇见的人或事物、特殊事件。

## 感悟与反思

旅程带来的思考、情绪变化、对未来的影响。

## 实用信息

- **位置坐标**: 
- **建议路线**: 
- **注意事项**: 
- **最佳时间**: 

3.3 图志模板 (Gallery)

---
title: "图志标题"
date: 2026-03-09T15:00:00+08:00
categories: ["gallery"]
tags: ["标签1", "标签2"]
location: "拍摄地点"
world: "世界观"
description: "图志简介"
---

图志的开篇文字，交代背景、氛围、拍摄动机。

{{< gallery >}}
  {{< image 
    src="/images/gallery/xxx-01.jpg" 
    alt="图片描述" 
    caption="详细说明，可包含地点、时间、感受"
  >}}
  {{< image 
    src="/images/gallery/xxx-02.jpg" 
    alt="图片描述" 
    caption="说明文字"
  >}}
{{< /gallery >}}

图志结尾，总结或留下思考。

3.4 深度文模板 (Essay)

---
title: "文章标题"
date: 2026-03-09T20:00:00+08:00
categories: ["essay"]
tags: ["标签1", "标签2", "标签3", "标签4"]
series: "系列名称（如适用）"
series_order: 1
abstract: "摘要，200字以内概括核心观点"
description: "文章简介"
toc: true
reading_time: true
---

## 引言

引人入胜的开篇。可以是一个场景、一个问题、一个观察。

## 正文第一部分

展开论述...

### 子主题

深入分析...

## 正文第二部分

继续展开...

## 案例/故事

具体的例子来支撑观点...

## 结论

总结核心观点，留下余韵。

## 参考与延伸

- 相关阅读链接
- 推荐资源
- 延伸阅读

---

4. 灵感收集系统

4.1 灵感来源矩阵

来源类型	示例	收集方式	转化周期
真实旅行	城市漫步、自然风光、建筑	手机速记+照片	1-3天
阅读观影	小说、纪录片、独立游戏	摘录+感想	即时记录
梦境	夜间梦境片段	醒来立即记录	当天整理
随机联想	两个概念的意外连接	闪念笔记	适时扩展
他人对话	有趣的谈话、观点	简要记录	评估后使用

4.2 灵感收集工具链

灵感捕捉流程：

1. 移动端 (随时)
   └── Apple Notes / Obsidian Mobile
       ├── 语音速记
       ├── 拍照+备注
       └── 链接收藏

2. 桌面端 (整理)
   └── Obsidian Vault
       ├── Daily Notes (每日灵感)
       ├── Maps of Content (主题索引)
       └── Literature Notes (阅读笔记)

3. 转化 (创作)
   └── VS Code + Markdown
       ├── 从灵感笔记扩展
       ├── 套用内容模板
       └── 使用 hugo new 命令创建

---

5. 发布流程

5.1 发布检查清单

## 发布前检查

### 内容检查
- [ ] 标题简洁有力，无错别字
- [ ] 摘要/description 已填写
- [ ] 标签选择恰当（2-5个）
- [ ] 分类正确
- [ ] 日期时间正确

### 格式检查
- [ ] Markdown 语法正确
- [ ] 图片已压缩优化
- [ ] 图片 alt 文字已填写
- [ ] 链接可正常访问

### 元数据检查
- [ ] location 字段（如适用）
- [ ] world 字段（如适用）
- [ ] series 信息完整（如适用）

### 技术检查
- [ ] hugo server 本地预览正常
- [ ] 暗色模式显示正常
- [ ] 移动端显示正常
- [ ] 无控制台报错

5.2 自动化发布脚本

#!/bin/bash
# scripts/publish.sh

set -e

echo "🚀 开始发布流程..."

# 1. 拉取最新更改
echo "📥 同步远程仓库..."
git pull origin main

# 2. 构建站点
echo "🔨 构建站点..."
hugo --minify

# 3. 本地预览检查（可选）
if [ "$1" = "preview" ]; then
  echo "👁️  启动预览服务器..."
  hugo server -D
  exit 0
fi

# 4. 提交更改
echo "💾 提交更改..."
git add .
git commit -m "publish: $(date '+%Y-%m-%d %H:%M') 发布新内容"

# 5. 推送到远程
echo "📤 推送到远程仓库..."
git push origin main

echo "✅ 发布完成！GitHub Actions 将自动部署。"

---

6. 内容存档与版本控制

6.1 Git工作流

main 分支 (受保护)
    │
    ├── 所有已发布内容
    ├── 触发 GitHub Actions 自动部署
    └── 仅通过 PR 或本地合并更新

content/drafts 分支 (可选)
    │
    ├── 未完成草稿
    ├── 待审核内容
    └── 完成后合并到 main

6.2 提交信息规范

格式: <type>: <subject>

类型:
- content: 新内容发布
- edit: 内容修改
- fix: 错误修复
- style: 样式调整
- chore: 配置/工具更新

示例:
content: 2026-03-09 水晶洞穴探险记
edit: 修正旅程记录中的日期错误
style: 调整暗色模式下代码块颜色

---

7. 变更记录

版本	日期	变更内容	作者
v0.1.0	2026-03-09	初稿创建	Val