🧠 Obsidian Minimal Workflow

一个简洁、高效的个人知识管理系统，集成 Claude Code 智能化功能

✨ 特性亮点

🎯 渐进式采用: 从简单日记到完整知识管理系统
🤖 AI 增强: 集成 Claude Code 实现智能洞察和自动化
📊 动态仪表盘: Dataview 驱动的实时数据展示
🔄 自动化模板: Templater 驱动的智能文件创建
📁 科学分类: 基于 P.A.R.A. 方法论的文件夹结构
🛠️ 开箱即用: 5 分钟快速设置，立即可用
🏥 健康检查: 内置 Vault 健康检查和维护工具
💾 智能备份: 支持完整和增量备份策略

🚀 快速开始

一键安装

git clone https://github.com/YYvanYang/obsidian-minimal-workflow.git
cd obsidian-minimal-workflow
chmod +x scripts/setup.sh
./scripts/setup.sh

设置脚本会首先询问 Vault 名称，然后提供三种创建位置选项：

当前目录 - 在当前目录创建以 Vault 名称命名的文件夹
指定目录 - 在自定义父目录中创建 Vault 文件夹
现有目录 - 使用现有的空目录作为 Vault

脚本会自动：

✅ 创建完整的文件夹结构
✅ 初始化项目配置
✅ 配置 Claude Code 集成
✅ 创建今日笔记和本周周报
✅ 生成示例项目和知识笔记文件

重要提示：安装完成后，请务必按照下方「配置 Templater 插件」部分进行设置，否则模板功能无法正常工作。

手动安装

如果你更喜欢手动控制安装过程：

克隆项目

git clone https://github.com/YYvanYang/obsidian-minimal-workflow.git
cd obsidian-minimal-workflow

复制文件结构

cp -r vault-template/* ./
cp -r .claude ./
cp -r docs ./
cp -r scripts ./
chmod +x scripts/*.sh

在 Obsidian 中打开
- 打开 Obsidian
- 选择 "Open folder as vault"
- 选择项目目录
安装必需插件
- Templater (v1.16.0+) - 模板系统核心
- Dataview (v0.5.56+) - 动态内容查询
- Calendar (v1.5.10+) - 日历视图（推荐）
- Periodic Notes (v0.0.17+) - 周期性笔记（推荐）
验证 Templater 配置（重要！）

安装脚本已预置了所有配置，但如果模板语法（如 <% tp.file.cursor() %>）原样输出，请在 Obsidian 设置 → Templater 中确认：
- Template folder location: 90-Meta/Templates
- Trigger Templater on new file creation: ✅ 必须开启
- Automatic jump to cursor: ✅ 建议开启
- Enable Folder Templates: ✅ 必须开启
然后在 Folder Templates 部分添加以下映射：
```
10-Daily → daily-template
20-Projects → project-template
30-Knowledge/Learning → knowledge-template
30-Knowledge/Research → knowledge-template
30-Knowledge/Reference → knowledge-template
30-Knowledge/Personal → personal-template
Weekly → weekly-template
```
配置完成后，在对应文件夹创建新文件时，Templater 会自动应用相应模板并处理所有模板语法。

📁 文件夹结构

📁 你的工作空间/
├── 📁 00-Dashboard/          # 🏠 仪表盘 - 一切的入口
│   ├── Home.md              # 主页导航中心
│   ├── Current-Projects.md   # 项目状态总览
│   └── Quick-Notes.md       # 快速记录捕获
│
├── 📁 10-Daily/             # 📅 每日记录
│   ├── 2025-06-20.md       # 今日笔记
│   └── ...                 # 历史每日笔记
│
├── 📁 20-Projects/          # 🎯 项目管理
│   ├── Project-客户系统.md   # 具体项目文件
│   └── ...                 # 其他项目
│
├── 📁 30-Knowledge/         # 📚 知识宝库
│   ├── 📁 Learning/         # 学习笔记
│   ├── 📁 Research/         # 深度研究
│   ├── 📁 Reference/        # 参考资料
│   └── 📁 Personal/         # 个人文档
│
├── 📁 40-Archive/           # 📦 归档区域
├── 📁 90-Meta/              # ⚙️ 系统配置
│   ├── Templates/           # 模板库
│   ├── Scripts/             # 自动化脚本
│   └── Attachments/         # 附件存储
│
├── 📁 Weekly/               # 📊 周报专区
├── 📁 .claude/              # 🤖 Claude Code 命令
├── 📁 .obsidian-workflow/   # 🔧 项目配置
├── 📁 docs/                 # 📚 文档资料
└── 📁 scripts/              # 🛠️ 实用脚本

🎯 核心工作流程

📅 日常使用 (每天 5 分钟)

晨间规划 (2 分钟)
- 右键点击 10-Daily 文件夹，选择"新建笔记"（文件名任意）
- Templater 会自动应用模板并重命名为今日日期
- 设定 3 个今日重点任务
- 查看项目仪表盘的今日待办
过程记录 (随时)
- 记录完成的工作
- 捕获遇到的问题
- 记录学到的知识
- 完成任务后标记为已完成
晚间回顾 (3 分钟)
- 总结今日成果
- 设置明日待办（自动设置明日日期）
- 写下一句话反思

📊 每周回顾

周五: 运行 claude /weekly-report 自动生成周报
周日: 回顾本周，规划下周重点

🧹 月度维护

运行 ./scripts/health-check.sh 检查系统健康
运行 claude /vault-cleanup 整理文件
运行 claude /knowledge-connect 优化知识连接
归档旧内容到 40-Archive

✅ 任务管理系统

使用 Obsidian 内置的任务功能，结合 Dataview 实现任务管理：

任务语法

基础任务: - [ ] 任务描述
完成任务: - [x] 已完成的任务

任务仪表盘

项目任务 - 在项目仪表盘 (00-Dashboard/Current-Projects.md) 查看任务
今日待办 - 在主页仪表盘 (00-Dashboard/Home.md) 快速查看
每日任务 - 在每日笔记中管理当天任务

使用 Dataview 查询任务

// 今日任务
```dataview
TASK
FROM "10-Daily" OR "20-Projects"
WHERE !completed
LIMIT 10

// 项目任务分组

TASK
FROM "20-Projects"
WHERE !completed
GROUP BY file.link


## 🤖 Claude Code 集成

### 智能命令

```bash
# 创建今日笔记
claude /daily-note
# 创建带健身记录的今日笔记
claude /daily-note --template fitness

# 生成周报
claude /weekly-report  

# 项目状态分析
claude /project-summary "项目名称"

# 健身数据分析
claude /fitness-analysis

# 学习进度分析
claude /learning-progress

# 生活平衡分析
claude /area-review
claude /area-review --period 7d --focus health

# 个人职业发展
claude /personal create --type review    # 创建述职报告
claude /personal analyze                 # 职业发展分析
claude /personal extract --focus skills  # 提取技能清单
claude /personal prepare                 # 准备面试材料

# 知识图谱优化
claude /knowledge-connect

# 系统清理维护
claude /vault-cleanup

AI 辅助特性

智能笔记创建: 支持标准和健身版每日笔记模板选择
智能周报生成: 自动分析一周的笔记，提取关键成果和洞察
项目进度跟踪: 基于日常记录分析项目状态和风险
健身数据洞察: 分析运动数据，提供个性化健康建议
学习进度评估: 追踪知识获取，优化学习策略和效果
生活平衡分析: 分析工作、健康、学习各领域时间分配和平衡状况
个人职业管理: 创建简历、述职报告，分析职业发展轨迹，提取关键成就
知识连接发现: 识别相关知识点，建议创建双向链接
系统健康检查: 发现孤立文件、重复内容、优化建议

🛠️ 实用脚本

健康检查脚本

# 运行 Vault 健康检查
./scripts/health-check.sh

# 检查内容包括：
# - 文件夹结构完整性
# - 孤立文件检测
# - 断开链接查找
# - 重复文件识别
# - 大文件和空文件警告

备份脚本

# 完整备份
./scripts/backup.sh full

# 增量备份（仅备份最近 7 天的更改）
./scripts/backup.sh incremental

# 自定义备份位置和保留天数
BACKUP_DIR=~/Backups RETENTION_DAYS=60 ./scripts/backup.sh

🎨 自定义指南

模板个性化

所有模板位于 90-Meta/Templates/，可根据个人习惯调整：

daily-template.md - 每日笔记结构
daily-template-fitness.md - 带健身记录的每日模板
project-template.md - 项目管理模板（支持单文件/多文件/文件夹模式）
knowledge-template.md - 知识笔记模板
weekly-template.md - 周报生成模板
personal-template.md - 通用个人文档模板

添加自定义字段

---
# 在模板 front matter 中添加自定义字段
mood: 😊          # 心情记录
energy: 8/10      # 精力水平  
weather: sunny    # 天气状况
custom_tag: work  # 自定义标签
---

扩展 Claude 命令

在 .claude/commands/ 中创建新的命令文件：

# .claude/commands/my-custom-command.md
分析我的学习进展并提供改进建议：

1. 扫描 30-Knowledge/Learning/ 文件夹
2. 统计学习笔记数量和主题分布
3. 识别学习模式和偏好
4. 提供个性化学习建议

🏋️ 健身打卡扩展

对于有健身习惯的用户，我们提供了渐进式的健身记录扩展方案：

方案1: 简单打卡式

在每日笔记的 🏠 个人时间 部分添加：

## 🏠 个人时间
### 🏋️ 今日运动
- [ ] **类型**：跑步 | **时长**：30分钟 | **强度**：中等
- **感受**：💪 精力充沛

### 其他个人活动
-

方案2: 数据统计式

在 front matter 中添加结构化数据：

---
date: 2025-06-20
day: Friday  
week: [[2025-W25]]
tags: [daily]
# 健身数据
exercise: true
type: "跑步"
duration: 30
intensity: "中等"
sleep: 8
energy: 4
---

方案3: 详细记录式

使用可折叠的详细记录：

<details>
<summary>🏋️ 健身与健康记录</summary>

### 今日运动
**运动类型**（勾选一项）：
- [ ] 跑步
- [ ] 力量训练
- [ ] 瑜伽
- [ ] 游泳
- [ ] 其他：___

**运动详情**：
- **时长**：___分钟
- **强度**：
  - [ ] 轻松
  - [ ] 中等
  - [ ] 高强度
- **地点**：
  - [ ] 家里
  - [ ] 健身房
  - [ ] 户外

### 身体状态
**精力水平**（选择一项）：
- [ ] 😴 很疲惫 (1分)
- [ ] 😐 一般 (2分)
- [ ] 😊 不错 (3分)
- [ ] 😁 很好 (4分)
- [ ] 🔥 充满活力 (5分)

**睡眠情况**：
- **睡眠时长**：___小时
- **睡眠质量**（1-10分）：___

**整体感受**：

</details>

健身统计查询

使用 Dataview 进行数据分析：

// 本月运动频率统计
TABLE type as "运动类型", 
      duration as "时长(分钟)",
      intensity as "强度"
FROM "10-Daily"
WHERE exercise = true 
  AND date >= date(today) - dur(30 days)
SORT date DESC

// 运动类型分布
TABLE WITHOUT ID
  type as "运动类型",
  length(rows) as "次数",
  sum(rows.duration) as "总时长(分钟)"
FROM "10-Daily"
WHERE exercise = true
GROUP BY type
SORT 次数 DESC

使用健身模板变体

我们提供了专门的健身版每日模板：

复制 90-Meta/Templates/daily-template.md 为 daily-template-fitness.md
根据上述方案选择合适的健身记录格式
在 Templater 设置中配置使用新模板

健身目标追踪

在 00-Dashboard/ 创建健身仪表盘：

# 🏋️ 健身仪表盘

## 本月统计
```dataview
TABLE WITHOUT ID
  "🏃‍♂️ 运动天数" as "指标",
  length(filter(rows, (r) => r.exercise = true)) as "数值"
FROM "10-Daily"
WHERE date >= date(today) - dur(30 days)

运动类型分布

TABLE WITHOUT ID type as "类型", length(rows) as "次数"
FROM "10-Daily" 
WHERE exercise = true AND date >= date(today) - dur(30 days)
GROUP BY type


## 📚 进阶使用

### Dataview 高级查询

```javascript
// 显示本月高优先级项目
TABLE priority, status, start_date
FROM "20-Projects" 
WHERE priority = "high" AND start_date >= date(today) - dur(30 days)
SORT start_date DESC
LIMIT 10

模板高级语法

<%*
// 智能文件命名和移动
const category = await tp.system.suggester(
    ["工作", "学习", "生活"],
    ["work", "study", "life"]
);
const title = await tp.system.prompt("笔记标题");
const fileName = `${category}-${title}`;
await tp.file.rename(fileName);
-%>

🔄 渐进式采用计划

第 1 周: 基础习惯建立

✅ 每天创建并填写日常笔记
✅ 使用主页仪表盘导航
✅ 熟悉基础快捷键

第 2-3 周: 项目管理

✅ 创建第一个项目文件
✅ 在日常笔记中关联项目
✅ 使用项目仪表盘跟踪进度

第 4 周: 知识管理

✅ 开始记录学习笔记
✅ 创建知识之间的双向链接
✅ 使用周报功能回顾

第 2 个月: AI 增强

✅ 配置 Claude Code 集成
✅ 使用智能命令自动化工作流
✅ 定制个人专用命令

🛡️ 系统要求

软件版本

Obsidian: v1.0.0+ (推荐 v1.5.0+)
操作系统: Windows/macOS/Linux
Claude Code: v1.0.0+ (可选，用于 AI 功能)

必需插件

插件	用途	最低版本	必需性
Templater	模板系统	v1.16.0	✅ 必需
Dataview	动态查询	v0.5.56	✅ 必需
Calendar	日历视图	v1.5.10	🔸 推荐
Periodic Notes	周期笔记	v0.0.17	🔸 推荐

🚨 故障排除

常见问题请查看 troubleshooting.md

快速解决方案：

模板不工作: 检查 Templater 设置中的模板文件夹路径
查询无结果: 确认 Dataview 插件已启用
文件未移动: 检查目标文件夹是否存在

🤝 贡献指南

欢迎提交改进建议！

Fork 此仓库
创建特性分支: git checkout -b feature/amazing-feature
提交更改: git commit -m 'Add amazing feature'
推送分支: git push origin feature/amazing-feature
创建 Pull Request

详见 CONTRIBUTING.md

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

Obsidian - 优秀的知识管理平台
P.A.R.A. Method - 文件组织方法论
Claude - AI 助手支持
Templater - 强大的模板插件
Dataview - 数据查询引擎
所有贡献者和使用者的反馈

📈 项目状态

当前版本: v0.2.0
最后更新: 2025-01-06
开发状态: 活跃维护中
下个版本: v0.3.0 (计划中)

🌟 Star 历史

开始你的知识管理之旅 🚀

如果这个项目对你有帮助，请给个 ⭐️ 支持一下！

有问题或建议？欢迎提交 Issue 或加入 Discussions。