feat(daily): add daily note creation workflow and documentation
Add comprehensive daily note system with multiple creation methods: - Add daily-note.js script for CLI-based daily note creation - Add daily-note npm command to package.json - Create DAILY_NOTE_GUIDE.md with complete workflow documentation - Three creation methods: CLI, Templater, QuickAdd - Step-by-step usage instructions - Recommended daily workflows - Troubleshooting guide Add new reference documentation: - GIT_WORKFLOW.md: Git workflow best practices - PARA_METHOD.md: PARA method explanation - TROUBLESHOOTING.md: Extended troubleshooting guide - AGENTS.md: Agent coding guidelines and commands - QUICK_REFERENCE.md: 1-page quick reference card - REFACTOR_SUMMARY.md: Refactoring summary Organize reference docs: - Move Templater guides to 06_Metadata/Reference/ - Move Obsidian plugins manual to 06_Metadata/Reference/
This commit is contained in:
windyboy
@@ -0,0 +1,445 @@
|
||||
---
|
||||
created: 2026-01-06
|
||||
type: reference
|
||||
tags: [reference, daily-workflow, tutorial]
|
||||
---
|
||||
|
||||
# 每日日记完整指南
|
||||
|
||||
**快速创建每日笔记的三种方式**
|
||||
|
||||
---
|
||||
|
||||
## 📋 方式一：命令行创建（最快）
|
||||
|
||||
### 基础用法
|
||||
|
||||
```bash
|
||||
# 创建今日普通日记（文件名：YYYY-MM-DD.md）
|
||||
pnpm daily-note
|
||||
|
||||
# 创建带主题的日记（文件名：YYYY-MM-DD - 主题.md）
|
||||
pnpm daily-note "学习 Claude Code"
|
||||
pnpm daily-note "项目会议"
|
||||
pnpm daily-note "阅读笔记"
|
||||
```
|
||||
|
||||
### 适用场景
|
||||
- ✅ 习惯使用命令行
|
||||
- ✅ 需要快速捕获想法
|
||||
- ✅ 在终端工作
|
||||
- ✅ 配合 Git 提交流程
|
||||
|
||||
### 示例
|
||||
|
||||
```bash
|
||||
# 早上启动时
|
||||
git pull
|
||||
pnpm daily-note "今日工作计划"
|
||||
# 编辑文件，开始工作...
|
||||
|
||||
# 晚上结束时
|
||||
pnpm daily-note "今日总结"
|
||||
# 编辑文件，总结当天
|
||||
git add .
|
||||
git commit -m "daily: $(date +%Y-%m-%d)"
|
||||
git push
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📱 方式二：Obsidian 插件（图形界面）
|
||||
|
||||
### Templater 插件 - 自动模板应用
|
||||
|
||||
**配置位置**：`.obsidian/plugins/templater-obsidian/data.json`
|
||||
|
||||
当前配置已启用：
|
||||
- 模板文件夹：`06_Metadata/Templates`
|
||||
- 在 `00_Inbox/` 创建文件时，自动应用 `Daily Note Template.md`
|
||||
- 在 `01_Projects/` 创建文件时，自动应用 `Project Template.md`
|
||||
|
||||
#### 使用步骤
|
||||
|
||||
1. **打开 Obsidian**
|
||||
2. **导航到 `00_Inbox/` 文件夹**
|
||||
3. **点击"创建笔记"图标**（或快捷键 `Ctrl+N`）
|
||||
4. **输入文件名**（建议格式：`YYYY-MM-DD - 主题`）
|
||||
5. **按 Enter 创建**
|
||||
6. **Templater 自动填充模板**
|
||||
|
||||
#### 模板对比
|
||||
|
||||
**英文模板**（自动应用）：
|
||||
```
|
||||
# 2026-01-06
|
||||
|
||||
## Capture
|
||||
-
|
||||
|
||||
## Questions
|
||||
-
|
||||
|
||||
## Insights
|
||||
-
|
||||
|
||||
## Connections
|
||||
-
|
||||
|
||||
## For Tomorrow
|
||||
-
|
||||
```
|
||||
|
||||
**中文模板**（手动应用）：
|
||||
```
|
||||
---
|
||||
date: 2026-01-06
|
||||
day: Monday
|
||||
week: 2026-W02
|
||||
type: daily-note
|
||||
---
|
||||
|
||||
# 2026年01月06日 星期一
|
||||
|
||||
## 📋 今日任务
|
||||
- [ ]
|
||||
|
||||
## 📝 工作笔记
|
||||
|
||||
|
||||
## 💡 想法与灵感
|
||||
|
||||
|
||||
## 📚 学习记录
|
||||
|
||||
|
||||
## 🎯 重点事项
|
||||
|
||||
|
||||
## 📊 总结
|
||||
|
||||
|
||||
---
|
||||
← [[2026-01-05]] | [[2026-01-07]] →
|
||||
```
|
||||
|
||||
#### 手动应用模板
|
||||
|
||||
如果不想使用自动模板，可以：
|
||||
|
||||
1. **快捷键 `Ctrl+E`**（打开 Templater 命令面板）
|
||||
2. **选择模板**
|
||||
- `daily-note.md`（中文版本，带日期链接）
|
||||
- `Daily Note Template.md`（英文简单版）
|
||||
3. **模板插入到当前文件**
|
||||
|
||||
#### 创建快捷键
|
||||
|
||||
**在 Obsidian 设置中**：
|
||||
1. `设置` → `快捷键` → 搜索 "Templater"
|
||||
2. 找到 "Open Insert Template modal"
|
||||
3. 设置快捷键（例如：`Ctrl+Shift+T`）
|
||||
|
||||
### QuickAdd 插件 - 高级自动化
|
||||
|
||||
**当前配置**：QuickAdd 已安装但未配置任何 Choice（需要手动设置）
|
||||
|
||||
#### 配置 QuickAdd 创建日记
|
||||
|
||||
**步骤 1：在 Obsidian 中打开 QuickAdd 设置**
|
||||
- `设置` → `社区插件` → `QuickAdd` → `Manage`
|
||||
|
||||
**步骤 2：创建新 Choice**
|
||||
- 点击 `+ Create Choice`
|
||||
- 名称：`Daily Note`
|
||||
- 类型：`Template`
|
||||
|
||||
**步骤 3：配置 Template 选项**
|
||||
- **Template Path**: `06_Metadata/Templates/daily-note.md`
|
||||
- **File Name Format**: `{{DATE:YYYY-MM-DD}}`
|
||||
- **File Location**: `00_Inbox`
|
||||
- **Open**: `Create new tab`
|
||||
|
||||
**步骤 4：添加变量（可选）**
|
||||
在 Template 中使用 QuickAdd 变量：
|
||||
```markdown
|
||||
# {{DATE:YYYY年MM月DD日 dddd}}
|
||||
|
||||
## 📋 今日任务
|
||||
- [ ] {{VALUE:今天的主要任务?}}
|
||||
```
|
||||
|
||||
**步骤 5：设置快捷键**
|
||||
- 在设置中找到 "Daily Note" choice
|
||||
- 设置快捷键（例如：`Ctrl+Shift+D`）
|
||||
|
||||
#### 使用 QuickAdd 创建日记
|
||||
|
||||
配置完成后，按快捷键 `Ctrl+Shift+D` 即可：
|
||||
- ✅ 自动创建日记
|
||||
- ✅ 自动命名（带日期）
|
||||
- ✅ 自动保存到指定文件夹
|
||||
- ✅ 应用模板
|
||||
- ✅ 可选择输入变量值
|
||||
|
||||
---
|
||||
|
||||
## 🤖 方式三：Claude Code 智能命令
|
||||
|
||||
### /daily-review 命令
|
||||
|
||||
**功能**：每日结束时的智能回顾，自动分析当天活动
|
||||
|
||||
**使用方法**：
|
||||
```bash
|
||||
# 在 Claude Code 中
|
||||
/daily-review
|
||||
```
|
||||
|
||||
**命令会自动**：
|
||||
1. 🔍 查找今天修改/创建的所有笔记
|
||||
2. 📊 分析项目进度
|
||||
3. 💡 提取关键见解
|
||||
4. 🔗 发现笔记之间的连接
|
||||
5. 📝 生成每日总结
|
||||
6. 🎯 设定明天的优先级
|
||||
|
||||
**输出格式**（更新到每日笔记）：
|
||||
```markdown
|
||||
## Accomplished
|
||||
- ✓ [Completed item 1]
|
||||
- ✓ [Completed item 2]
|
||||
|
||||
## Progress Made
|
||||
- [Project]: [What moved forward]
|
||||
|
||||
## Insights
|
||||
- [Key realization]
|
||||
|
||||
## Discovered Questions
|
||||
- [New question]
|
||||
|
||||
## Tomorrow's Focus
|
||||
1. [Priority 1]
|
||||
2. [Priority 2]
|
||||
3. [Priority 3]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 工作流推荐
|
||||
|
||||
### 每日例行流程
|
||||
|
||||
#### ☀️ 早晨（启动工作）
|
||||
|
||||
**命令行工作流**：
|
||||
```bash
|
||||
# 1. 同步代码
|
||||
git pull
|
||||
|
||||
# 2. 创建今日日记
|
||||
pnpm daily-note "今日工作"
|
||||
|
||||
# 3. 在编辑器中打开文件
|
||||
# 添加今日计划和任务
|
||||
```
|
||||
|
||||
**Obsidian 工作流**：
|
||||
```bash
|
||||
# 1. 打开 Obsidian
|
||||
# 2. 按 Ctrl+Shift+D（QuickAdd）
|
||||
# 3. 输入今日主题
|
||||
# 4. 开始记录
|
||||
```
|
||||
|
||||
#### 🌞 白天（工作过程）
|
||||
|
||||
**快速捕获**：
|
||||
- 命令行：`pnpm daily-note "快速想法"`
|
||||
- Obsidian：`00_Inbox/` 中创建临时笔记
|
||||
- Claude Code：`/thinking-partner` 记录对话
|
||||
|
||||
**关联笔记**：
|
||||
- 使用 `[[链接]]` 引用相关项目、资源
|
||||
- 标记重要发现到每日笔记
|
||||
|
||||
#### 🌙 晚上（结束工作）
|
||||
|
||||
**Claude Code 回顾**：
|
||||
```bash
|
||||
# 1. 运行每日回顾
|
||||
/daily-review
|
||||
|
||||
# 2. 审查生成的总结
|
||||
# 3. 补充遗漏的内容
|
||||
|
||||
# 4. 提交到 Git
|
||||
git add .
|
||||
git commit -m "daily: $(date +%Y-%m-%d)"
|
||||
git push
|
||||
```
|
||||
|
||||
**Obsidian 整理**：
|
||||
1. 检查 `00_Inbox/` 内容
|
||||
2. 移动笔记到正确的 PARA 位置
|
||||
3. 更新项目状态
|
||||
4. 链接相关笔记
|
||||
|
||||
---
|
||||
|
||||
## 📊 对比三种方式
|
||||
|
||||
| 特性 | 命令行 | Obsidian Templater | QuickAdd |
|
||||
|------|--------|-------------------|----------|
|
||||
| **速度** | ⚡ 最快 | 🚀 快 | ⚡ 快（配置后） |
|
||||
| **配置** | ✅ 无需配置 | ✅ 预配置 | ⚠️ 需手动配置 |
|
||||
| **灵活性** | ⚠️ 基础 | 🚀 高 | 🌟 极高 |
|
||||
| **自动化** | ⚠️ 有限 | 🚀 自动应用 | 🌟 高度自动化 |
|
||||
| **图形界面** | ❌ 无 | ✅ 有 | ✅ 有 |
|
||||
| **变量支持** | ❌ 无 | ✅ Templater 语法 | ✅ QuickAdd 语法 |
|
||||
| **适用场景** | 命令行爱好者 | Obsidian 用户 | 高级用户 |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 推荐组合
|
||||
|
||||
### 初学者
|
||||
- **主要方式**：Obsidian Templater（自动模板）
|
||||
- **辅助方式**：命令行 `pnpm daily-note`
|
||||
|
||||
### 进阶用户
|
||||
- **主要方式**：QuickAdd（快捷键 `Ctrl+Shift+D`）
|
||||
- **辅助方式**：Claude Code `/daily-review`
|
||||
|
||||
### 高级用户
|
||||
- **早晨**：QuickAdd 创建日记
|
||||
- **白天**：命令行快速捕获
|
||||
- **晚上**：Claude Code 智能回顾
|
||||
- **整理**：Obsidian 图形界面链接
|
||||
|
||||
---
|
||||
|
||||
## 💡 技巧与最佳实践
|
||||
|
||||
### 1. 命名规范
|
||||
|
||||
**推荐格式**：
|
||||
```
|
||||
YYYY-MM-DD # 纯日期，普通日记
|
||||
YYYY-MM-DD - [主题] # 带主题，特定活动
|
||||
Meeting - [主题] - [日期] # 会议记录
|
||||
Idea - [简短描述] # 想法记录
|
||||
```
|
||||
|
||||
### 2. 模板自定义
|
||||
|
||||
**在 `06_Metadata/Templates/` 中创建自定义模板**：
|
||||
|
||||
```markdown
|
||||
# {{date:YYYY-MM-DD}}
|
||||
|
||||
## 🎯 今日目标
|
||||
- [ ]
|
||||
|
||||
## 📈 进度跟踪
|
||||
|
||||
## 🔍 问题与挑战
|
||||
|
||||
## 💡 学到的东西
|
||||
|
||||
## 📝 待跟进
|
||||
```
|
||||
|
||||
### 3. 日期链接
|
||||
|
||||
**中文模板支持前一天/后一天链接**：
|
||||
```markdown
|
||||
---
|
||||
← [[2026-01-05]] | [[2026-01-07]] →
|
||||
---
|
||||
```
|
||||
|
||||
在 Obsidian 中点击日期即可跳转
|
||||
|
||||
### 4. Git 提交钩子（可选）
|
||||
|
||||
**自动化每日提交**（在 `.git/hooks/post-commit`）：
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# 自动提交到远程
|
||||
git push
|
||||
```
|
||||
|
||||
### 5. 每日提醒
|
||||
|
||||
**使用 Obsidian Calendar 插件**：
|
||||
- 安装 Calendar 插件（已安装）
|
||||
- 设置每日提醒创建日记
|
||||
- 可视化查看日记历史
|
||||
|
||||
---
|
||||
|
||||
## 🔧 故障排除
|
||||
|
||||
### 命令行方式失败
|
||||
|
||||
**问题**：`pnpm daily-note` 报错
|
||||
```
|
||||
'pnpm' is not recognized
|
||||
```
|
||||
|
||||
**解决**：
|
||||
```bash
|
||||
# 安装 pnpm
|
||||
npm install -g pnpm
|
||||
|
||||
# 或使用 npm
|
||||
npm run daily-note
|
||||
```
|
||||
|
||||
### Templater 模板不应用
|
||||
|
||||
**问题**：在 `00_Inbox/` 创建文件，模板未自动填充
|
||||
|
||||
**检查**：
|
||||
1. Templater 插件是否启用
|
||||
2. `trigger_on_file_creation` 是否为 `true`
|
||||
3. 文件夹模板配置是否正确
|
||||
4. 模板文件是否存在
|
||||
|
||||
### QuickAdd 无响应
|
||||
|
||||
**问题**：按快捷键没有反应
|
||||
|
||||
**解决**：
|
||||
1. 检查快捷键是否被其他插件占用
|
||||
2. 重新加载 Obsidian（禁用后启用 QuickAdd）
|
||||
3. 查看 Console 日志（`Ctrl+Shift+I`）
|
||||
|
||||
---
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
- [[QUICK_REFERENCE]] - 快速参考卡片
|
||||
- [[WEEKLY_REVIEW]] - 每周回顾流程
|
||||
- [[AGENTS]] - Claude Code 命令说明
|
||||
- [[README]] - 项目完整文档
|
||||
|
||||
---
|
||||
|
||||
## 🆘 需要帮助？
|
||||
|
||||
**获取即时帮助**：
|
||||
```bash
|
||||
# 在 Claude Code 中询问
|
||||
"如何自定义每日日记模板？"
|
||||
"如何设置 QuickAdd 自动创建日记？"
|
||||
"如何将日记链接到项目？"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-01-06
|
||||
**作者**：Claude Code Assistant
|
||||
**版本**：1.0
|
||||
@@ -0,0 +1,538 @@
|
||||
---
|
||||
created: 2026-01-06
|
||||
type: reference
|
||||
tags: [git, workflow, version-control]
|
||||
---
|
||||
|
||||
# Git Workflow Guide
|
||||
|
||||
Complete guide to Git version control for your Obsidian vault.
|
||||
|
||||
---
|
||||
|
||||
## Critical Rule
|
||||
|
||||
**ALWAYS start sessions with `git pull`** to sync latest changes from remote repository.
|
||||
|
||||
This prevents conflicts and ensures you're working with the latest version.
|
||||
|
||||
---
|
||||
|
||||
## Daily Workflow
|
||||
|
||||
### Morning (Session Start)
|
||||
|
||||
```bash
|
||||
cd D:\tmp\vault\my-vault
|
||||
git pull
|
||||
git status # Check for any conflicts
|
||||
```
|
||||
|
||||
**What this does**:
|
||||
- Changes to vault directory
|
||||
- Pulls latest changes from remote
|
||||
- Shows current status (conflicts, uncommitted changes)
|
||||
|
||||
### During Work
|
||||
|
||||
```bash
|
||||
git status # Periodically check changes
|
||||
```
|
||||
|
||||
**Optional**: Check what's been modified while working.
|
||||
|
||||
### Evening (Session End)
|
||||
|
||||
```bash
|
||||
git status # Review all changes
|
||||
git add . # Stage all changes
|
||||
git commit -m "vault backup: $(date +%Y-%m-%d\ %H:%M:%S)"
|
||||
git push # Sync to remote
|
||||
```
|
||||
|
||||
**What this does**:
|
||||
- Shows all modified/new/deleted files
|
||||
- Stages everything for commit
|
||||
- Creates commit with timestamp
|
||||
- Pushes to remote repository
|
||||
|
||||
---
|
||||
|
||||
## Commit Message Guidelines
|
||||
|
||||
### Format
|
||||
|
||||
```
|
||||
[type]: [brief description]
|
||||
|
||||
Examples:
|
||||
vault backup: 2026-01-06 20:30:15
|
||||
Add: Project planning notes for Q1 initiatives
|
||||
Update: Weekly review template with new sections
|
||||
Organize: Moved inbox items to appropriate folders
|
||||
Archive: Completed research project
|
||||
```
|
||||
|
||||
### Common Types
|
||||
|
||||
| Type | When to Use | Example |
|
||||
|------|-------------|---------|
|
||||
| `vault backup:` | Regular daily backup | `vault backup: 2026-01-06 20:00` |
|
||||
| `Add:` | New notes/projects | `Add: Machine learning project notes` |
|
||||
| `Update:` | Modify existing content | `Update: CLAUDE.md with new workflow` |
|
||||
| `Organize:` | File movements | `Organize: Processed inbox items` |
|
||||
| `Archive:` | Moving to archive | `Archive: Completed Q4 projects` |
|
||||
| `Fix:` | Bug fixes, broken links | `Fix: Broken attachment links` |
|
||||
|
||||
### When to Commit
|
||||
|
||||
- ✅ After organizing inbox
|
||||
- ✅ After creating new notes
|
||||
- ✅ After significant edits
|
||||
- ✅ Before ending session
|
||||
- ✅ After weekly review
|
||||
- ✅ After major reorganization
|
||||
|
||||
**Don't**: Commit every single edit. Batch related changes together.
|
||||
|
||||
---
|
||||
|
||||
## Common Git Commands
|
||||
|
||||
### Essential Commands
|
||||
|
||||
```bash
|
||||
git status # Check current state
|
||||
git pull # Sync from remote
|
||||
git add . # Stage all changes
|
||||
git commit -m "message" # Commit with message
|
||||
git push # Sync to remote
|
||||
git log --oneline -10 # View recent commits
|
||||
```
|
||||
|
||||
### Useful Commands
|
||||
|
||||
```bash
|
||||
# View what changed in a file
|
||||
git diff filename.md
|
||||
|
||||
# View all recent changes
|
||||
git diff
|
||||
|
||||
# View commit history
|
||||
git log --oneline
|
||||
|
||||
# View changes in last commit
|
||||
git show
|
||||
|
||||
# Unstage a file (before commit)
|
||||
git restore --staged filename.md
|
||||
|
||||
# Discard changes to a file (DANGER)
|
||||
git restore filename.md
|
||||
```
|
||||
|
||||
### File History
|
||||
|
||||
```bash
|
||||
# Find when a file was deleted/moved
|
||||
git log --all --full-history -- path/to/file.md
|
||||
|
||||
# View all commits that touched a file
|
||||
git log --follow -- path/to/file.md
|
||||
|
||||
# See file contents from specific commit
|
||||
git show <commit-hash>:path/to/file.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Handling Conflicts
|
||||
|
||||
### When Conflicts Happen
|
||||
|
||||
**Scenario**: You run `git pull` and see:
|
||||
|
||||
```
|
||||
CONFLICT (content): Merge conflict in filename.md
|
||||
Automatic merge failed; fix conflicts and then commit the result.
|
||||
```
|
||||
|
||||
### Resolution Steps
|
||||
|
||||
**1. Open conflicted file**
|
||||
|
||||
You'll see markers like this:
|
||||
|
||||
```markdown
|
||||
Normal content here...
|
||||
|
||||
<<<<<<< HEAD
|
||||
Your local changes
|
||||
=======
|
||||
Remote changes from other device
|
||||
>>>>>>> origin/main
|
||||
|
||||
More normal content...
|
||||
```
|
||||
|
||||
**2. Resolve manually**
|
||||
|
||||
Choose which version to keep (or combine both):
|
||||
|
||||
```markdown
|
||||
Normal content here...
|
||||
|
||||
Combined changes (best of both versions)
|
||||
|
||||
More normal content...
|
||||
```
|
||||
|
||||
Delete conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`).
|
||||
|
||||
**3. Stage and commit**
|
||||
|
||||
```bash
|
||||
git add .
|
||||
git commit -m "Resolve merge conflicts"
|
||||
git push
|
||||
```
|
||||
|
||||
### Preventing Conflicts
|
||||
|
||||
**Best Practices**:
|
||||
1. ✅ Always `git pull` before starting work
|
||||
2. ✅ Commit and push at end of each session
|
||||
3. ✅ Don't edit same file on multiple devices simultaneously
|
||||
4. ✅ Use descriptive commit messages to track changes
|
||||
|
||||
**If working on multiple devices**:
|
||||
- Device A: Edit → Commit → Push
|
||||
- Device B: Pull → Edit → Commit → Push
|
||||
- Device A: Pull (gets Device B's changes)
|
||||
|
||||
---
|
||||
|
||||
## Advanced Workflows
|
||||
|
||||
### Checking Changes Before Commit
|
||||
|
||||
```bash
|
||||
# See what will be committed
|
||||
git status
|
||||
|
||||
# See detailed changes
|
||||
git diff
|
||||
|
||||
# Review changes file by file
|
||||
git diff filename.md
|
||||
```
|
||||
|
||||
### Selective Staging
|
||||
|
||||
```bash
|
||||
# Stage specific files only
|
||||
git add path/to/file1.md path/to/file2.md
|
||||
|
||||
# Stage all markdown files
|
||||
git add "*.md"
|
||||
|
||||
# Stage entire folder
|
||||
git add 01_Projects/
|
||||
```
|
||||
|
||||
### Commit History
|
||||
|
||||
```bash
|
||||
# Last 10 commits (one line each)
|
||||
git log --oneline -10
|
||||
|
||||
# Detailed view
|
||||
git log -5
|
||||
|
||||
# With file changes
|
||||
git log --stat -5
|
||||
|
||||
# Search commits by message
|
||||
git log --grep="inbox"
|
||||
|
||||
# Commits from last week
|
||||
git log --since="1 week ago"
|
||||
```
|
||||
|
||||
### Undoing Changes
|
||||
|
||||
**Before Commit (Unstage)**:
|
||||
```bash
|
||||
# Unstage specific file
|
||||
git restore --staged filename.md
|
||||
|
||||
# Unstage everything
|
||||
git restore --staged .
|
||||
```
|
||||
|
||||
**Discard Local Changes** (⚠️ DANGER - Cannot undo):
|
||||
```bash
|
||||
# Discard changes to specific file
|
||||
git restore filename.md
|
||||
|
||||
# Discard ALL local changes
|
||||
git restore .
|
||||
```
|
||||
|
||||
**After Commit (Advanced)**:
|
||||
```bash
|
||||
# Undo last commit (keep changes)
|
||||
git reset --soft HEAD~1
|
||||
|
||||
# Undo last commit (discard changes) - DANGER
|
||||
git reset --hard HEAD~1
|
||||
```
|
||||
|
||||
⚠️ **Warning**: Only use `reset --hard` if you're certain. Changes are lost permanently.
|
||||
|
||||
---
|
||||
|
||||
## .gitignore
|
||||
|
||||
### What to Ignore
|
||||
|
||||
Your `.gitignore` file should exclude:
|
||||
|
||||
```gitignore
|
||||
# Obsidian workspace (device-specific)
|
||||
.obsidian/workspace.json
|
||||
.obsidian/workspace-mobile.json
|
||||
|
||||
# System files
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
desktop.ini
|
||||
|
||||
# Temporary files
|
||||
*.tmp
|
||||
~$*.md
|
||||
|
||||
# Sensitive files (if any)
|
||||
.env
|
||||
secrets/
|
||||
```
|
||||
|
||||
### What to Commit
|
||||
|
||||
✅ **Do commit**:
|
||||
- `.obsidian/` (most config)
|
||||
- All markdown files (`.md`)
|
||||
- Attachments in `05_Attachments/`
|
||||
- Templates, scripts, documentation
|
||||
|
||||
❌ **Don't commit**:
|
||||
- Workspace files (device-specific layout)
|
||||
- System files (`.DS_Store`)
|
||||
- Large binary files (videos) - use Git LFS
|
||||
- Sensitive information (API keys, passwords)
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### "Repository not found"
|
||||
|
||||
**Problem**: Can't push/pull from remote
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# Check remote URL
|
||||
git remote -v
|
||||
|
||||
# Fix remote URL if needed
|
||||
git remote set-url origin <correct-url>
|
||||
```
|
||||
|
||||
### "Your branch is ahead by N commits"
|
||||
|
||||
**Meaning**: You have local commits not pushed to remote
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
git push
|
||||
```
|
||||
|
||||
### "Your branch is behind by N commits"
|
||||
|
||||
**Meaning**: Remote has commits you don't have locally
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
git pull
|
||||
```
|
||||
|
||||
### "Diverged branches"
|
||||
|
||||
**Meaning**: You and remote both have different commits
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
git pull # May auto-merge
|
||||
# If conflicts, resolve manually
|
||||
git add .
|
||||
git commit -m "Resolve merge conflicts"
|
||||
git push
|
||||
```
|
||||
|
||||
### "Permission denied (publickey)"
|
||||
|
||||
**Problem**: SSH key not configured
|
||||
|
||||
**Solutions**:
|
||||
1. **Use HTTPS instead of SSH**:
|
||||
```bash
|
||||
git remote set-url origin https://github.com/username/repo.git
|
||||
```
|
||||
|
||||
2. **Or configure SSH key**:
|
||||
- Generate: `ssh-keygen -t ed25519 -C "your_email@example.com"`
|
||||
- Add to GitHub: Settings → SSH Keys → Add Key
|
||||
|
||||
### Accidentally Committed Sensitive File
|
||||
|
||||
**Immediate Action**:
|
||||
```bash
|
||||
# Remove from Git (keep local file)
|
||||
git rm --cached sensitive-file.txt
|
||||
|
||||
# Add to .gitignore
|
||||
echo "sensitive-file.txt" >> .gitignore
|
||||
|
||||
# Commit removal
|
||||
git add .gitignore
|
||||
git commit -m "Remove sensitive file from tracking"
|
||||
git push
|
||||
```
|
||||
|
||||
**⚠️ Note**: File still exists in Git history. For complete removal, use `git filter-branch` or BFG Repo-Cleaner (advanced).
|
||||
|
||||
---
|
||||
|
||||
## Best Practices
|
||||
|
||||
### DO ✅
|
||||
|
||||
- **Pull before starting work** (every session)
|
||||
- **Commit frequently** (daily minimum)
|
||||
- **Use descriptive messages** (understand changes later)
|
||||
- **Push at end of session** (backup to remote)
|
||||
- **Review `git status`** before committing
|
||||
- **Keep commits atomic** (one logical change per commit)
|
||||
|
||||
### DON'T ❌
|
||||
|
||||
- **Never force push** to main/master (`git push --force`)
|
||||
- **Don't commit secrets** (API keys, passwords)
|
||||
- **Don't commit huge files** (videos > 50MB - use Git LFS)
|
||||
- **Don't edit history** of pushed commits (causes conflicts)
|
||||
- **Don't ignore conflicts** (resolve immediately)
|
||||
|
||||
---
|
||||
|
||||
## Multi-Device Workflow
|
||||
|
||||
### Device A (Desktop)
|
||||
|
||||
```bash
|
||||
# Morning
|
||||
git pull
|
||||
|
||||
# Work throughout day...
|
||||
|
||||
# Evening
|
||||
git add .
|
||||
git commit -m "vault backup: $(date)"
|
||||
git push
|
||||
```
|
||||
|
||||
### Device B (Laptop)
|
||||
|
||||
```bash
|
||||
# Later that evening
|
||||
git pull # Gets Desktop's changes
|
||||
|
||||
# Work on laptop...
|
||||
|
||||
# Before sleep
|
||||
git add .
|
||||
git commit -m "vault backup: $(date)"
|
||||
git push
|
||||
```
|
||||
|
||||
### Device A (Next Day)
|
||||
|
||||
```bash
|
||||
# Next morning
|
||||
git pull # Gets Laptop's changes
|
||||
|
||||
# Continue working...
|
||||
```
|
||||
|
||||
**Key**: Always pull before starting, push when done.
|
||||
|
||||
---
|
||||
|
||||
## Quick Reference
|
||||
|
||||
### Most Used Commands
|
||||
|
||||
```bash
|
||||
# Daily workflow
|
||||
git pull # Start of session
|
||||
git status # Check changes
|
||||
git add . # Stage all
|
||||
git commit -m "vault backup: $(date)" # Commit
|
||||
git push # End of session
|
||||
|
||||
# Viewing history
|
||||
git log --oneline -10 # Recent commits
|
||||
git diff # See changes
|
||||
|
||||
# Fixing issues
|
||||
git restore --staged . # Unstage
|
||||
git restore filename.md # Discard changes
|
||||
```
|
||||
|
||||
### Emergency Commands
|
||||
|
||||
```bash
|
||||
# Conflicts during pull
|
||||
git status # See conflicted files
|
||||
# Edit files manually
|
||||
git add .
|
||||
git commit -m "Resolve conflicts"
|
||||
git push
|
||||
|
||||
# Undo last commit (keep changes)
|
||||
git reset --soft HEAD~1
|
||||
|
||||
# Completely reset to remote (DANGER - loses local changes)
|
||||
git fetch origin
|
||||
git reset --hard origin/main
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Further Reading
|
||||
|
||||
**Official Git Documentation**: https://git-scm.com/doc
|
||||
|
||||
**Recommended Learning**:
|
||||
- Git basics: https://git-scm.com/book/en/v2/Getting-Started-About-Version-Control
|
||||
- Branching (advanced): https://git-scm.com/book/en/v2/Git-Branching-Basic-Branching-and-Merging
|
||||
|
||||
**Visual Git Tools**:
|
||||
- GitKraken (GUI client)
|
||||
- GitHub Desktop (simple interface)
|
||||
- VS Code built-in Git (integrated)
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: 2026-01-06
|
||||
**See Also**: [[CLAUDE]], [[QUICK_REFERENCE]], [[TROUBLESHOOTING]]
|
||||
+106
-4
@@ -12,8 +12,8 @@ type: reference
|
||||
|
||||
# Obsidian 插件使用手册
|
||||
|
||||
> 📅 **更新时间**：2026年1月5日
|
||||
> 📊 **插件总数**：24个
|
||||
> 📅 **更新时间**：2026年1月6日
|
||||
> 📊 **插件总数**：26个
|
||||
> 📝 **文档来源**：插件 manifest、配置文件、官方文档
|
||||
|
||||
## 目录
|
||||
@@ -41,6 +41,7 @@ type: reference
|
||||
|---------|---------|---------|------|
|
||||
| [[#Claudian]] | AI 聊天助手 | ⭐⭐⭐⭐⭐ | 简单 |
|
||||
| [[#Templater]] | 动态模板系统 | ⭐⭐⭐⭐⭐ | 中等 |
|
||||
| [[#QuickAdd]] | 快速创建内容 | ⭐⭐⭐⭐⭐ | 简单 |
|
||||
| [[#Dataview]] | 数据查询视图 | ⭐⭐⭐⭐⭐ | 高级 |
|
||||
| [[#Git]] | 版本控制备份 | ⭐⭐⭐⭐⭐ | 简单 |
|
||||
| [[#Copilot]] | AI 写作助手 | ⭐⭐⭐⭐⭐ | 中等 |
|
||||
@@ -49,6 +50,7 @@ type: reference
|
||||
| [[#Easy Typing]] | 中文输入优化 | ⭐⭐⭐⭐ | 简单 |
|
||||
| [[#Omnisearch]] | 增强搜索 | ⭐⭐⭐⭐ | 简单 |
|
||||
| [[#Advanced Tables]] | 表格增强 | ⭐⭐⭐⭐ | 简单 |
|
||||
| [[#Memos Sync]] | Memos 同步 | ⭐⭐⭐ | 中等 |
|
||||
|
||||
---
|
||||
|
||||
@@ -74,6 +76,7 @@ type: reference
|
||||
|
||||
### 模板和自动化类
|
||||
- **Templater** - 动态模板系统（详见 [[Templater-User-Guide]]）
|
||||
- **QuickAdd** - 快速创建页面和内容
|
||||
|
||||
### 搜索和导航类
|
||||
- **Omnisearch** - 增强搜索
|
||||
@@ -95,6 +98,7 @@ type: reference
|
||||
### 集成和扩展类
|
||||
- **Local REST API** - REST API 接口
|
||||
- **Advanced URI** - 高级 URI 链接
|
||||
- **Memos Sync** - Memos 服务器同步
|
||||
|
||||
---
|
||||
|
||||
@@ -508,6 +512,58 @@ Obsidian 最强大的模板插件，创建和使用动态模板。
|
||||
|
||||
---
|
||||
|
||||
### QuickAdd
|
||||
|
||||
**版本**：2.9.4 | **官方文档**：https://quickadd.obsidian.guide/docs/
|
||||
**作者**：Christian B. B. Houmann
|
||||
|
||||
#### 插件描述
|
||||
快速添加新页面或内容到 vault，提供强大的快捷创建和自动化功能。
|
||||
|
||||
#### 主要功能
|
||||
- ⚡ 快速创建笔记和内容
|
||||
- 📋 选择器创建不同类型的笔记
|
||||
- 🤖 内置 AI 助手（支持 OpenAI 和 Gemini）
|
||||
- 📝 模板集成
|
||||
- 🔧 脚本和宏支持
|
||||
- 🔘 自定义操作和触发器
|
||||
- 📅 日期和时间变量
|
||||
- 🎯 模板变量替换
|
||||
|
||||
#### 关键设置项
|
||||
- **模板文件夹**：`06_Metadata/Templates`
|
||||
- **输入提示模式**：单行输入
|
||||
- **显示捕获通知**：已启用
|
||||
- **启用模板属性类型**：已启用
|
||||
- **禁用在线功能**：已启用（隐私模式）
|
||||
- **AI 助手**：已启用（支持 OpenAI 和 Gemini）
|
||||
|
||||
#### AI 功能
|
||||
QuickAdd 内置 AI 助手，支持：
|
||||
- OpenAI (GPT-4, GPT-3.5, GPT-4o 等)
|
||||
- Google Gemini (1.5 Pro, 1.5 Flash, 1.5 Flash 8B)
|
||||
- 自定义端点和 API Key
|
||||
- 提示词模板管理
|
||||
|
||||
#### 使用场景
|
||||
- 快速捕获灵感
|
||||
- 创建不同类型的笔记
|
||||
- 自动化笔记创建流程
|
||||
- AI 辅助内容生成
|
||||
- 自定义快捷操作
|
||||
|
||||
#### 与 Templater 的区别
|
||||
- **QuickAdd**：更简单，适合快速创建和自动化
|
||||
- **Templater**：更强大，支持复杂 JavaScript 脚本和动态模板
|
||||
|
||||
#### 使用方法
|
||||
1. 命令面板 → `QuickAdd: Capture`
|
||||
2. 选择预定义的捕获选项
|
||||
3. 输入内容快速创建笔记
|
||||
4. 可与 AI 助手结合使用
|
||||
|
||||
---
|
||||
|
||||
## 搜索和导航类
|
||||
|
||||
### Omnisearch
|
||||
@@ -923,6 +979,49 @@ obsidian://advanced-uri?vault=my-vault&filepath=note.md&data=content&mode=append
|
||||
|
||||
---
|
||||
|
||||
### Memos Sync
|
||||
|
||||
**版本**：0.5.2 | **类型**：桌面端专用 | **作者**：RyoJerryYu
|
||||
**官网**：https://github.com/usememos/memos
|
||||
|
||||
#### 插件描述
|
||||
将 Memos 服务器的备忘录同步到你的每日笔记，与 Daily Notes、Calendar 和 Periodic Notes 插件完全兼容。
|
||||
|
||||
#### 主要功能
|
||||
- 🔄 自动同步 Memos 到每日笔记
|
||||
- 📝 与每日笔记插件集成
|
||||
- 📅 Calendar 插件兼容
|
||||
- 🔌 RESTful API 连接
|
||||
- 🎯 自定义同步间隔
|
||||
- 📎 支持附件文件夹
|
||||
- 🔒 API Token 认证
|
||||
|
||||
#### 关键设置项
|
||||
- **Memos API URL**：`https://memos.windy.me`
|
||||
- **Memos API 版本**：v0.24.0
|
||||
- **每日 Memos 标题**：`Memos`
|
||||
- **附件文件夹**：`Attachments`
|
||||
|
||||
#### 使用场景
|
||||
- 在移动设备使用 Memos App 记录想法
|
||||
- 自动同步回 Obsidian vault
|
||||
- 集成到每日笔记工作流
|
||||
- 多设备笔记同步
|
||||
|
||||
#### 使用方法
|
||||
1. 配置 Memos 服务器地址和 API Token
|
||||
2. 启用自动同步
|
||||
3. 在每日笔记中自动显示 Memos 内容
|
||||
4. 可与 Calendar 插件结合使用
|
||||
|
||||
#### 与 Obsidian 的关系
|
||||
- Memos 是独立的备忘录应用
|
||||
- Obsidian 用于深度知识管理
|
||||
- Memos Sync 将两者连接起来
|
||||
- 适合快速记录和深度思考结合的场景
|
||||
|
||||
---
|
||||
|
||||
## 使用建议
|
||||
|
||||
### 新手推荐优先使用
|
||||
@@ -1048,13 +1147,16 @@ obsidian://advanced-uri?vault=my-vault&filepath=note.md&data=content&mode=append
|
||||
22. MCP Tools (0.2.27)
|
||||
23. Mind Map (1.1.0)
|
||||
24. CM CHS Patch (1.12.0)
|
||||
25. QuickAdd (2.9.4)
|
||||
26. Memos Sync (0.5.2)
|
||||
|
||||
### 版本信息
|
||||
|
||||
**文档版本**：1.0
|
||||
**文档版本**：1.1
|
||||
**创建日期**：2026年1月5日
|
||||
**最后更新**：2026年1月5日
|
||||
**最后更新**：2026年1月6日
|
||||
**维护者**：Claudian AI Assistant
|
||||
**更新内容**：新增 QuickAdd 和 Memos Sync 插件文档
|
||||
|
||||
---
|
||||
|
||||
@@ -0,0 +1,400 @@
|
||||
---
|
||||
created: 2026-01-06
|
||||
type: reference
|
||||
tags: [para, methodology, organization]
|
||||
---
|
||||
|
||||
# PARA Method Explained
|
||||
|
||||
**P.A.R.A.** = Projects, Areas, Resources, Archive
|
||||
|
||||
A universal system for organizing digital information based on **actionability**.
|
||||
|
||||
---
|
||||
|
||||
## Core Principle
|
||||
|
||||
**Organize by actionability, not by category**
|
||||
|
||||
Traditional filing (by topic) asks: "What is this about?"
|
||||
PARA asks: "How will I use this?"
|
||||
|
||||
---
|
||||
|
||||
## The Four Categories
|
||||
|
||||
### 1. Projects (01_Projects/)
|
||||
|
||||
**Definition**: Time-bound initiatives with clear completion criteria
|
||||
|
||||
**Characteristics**:
|
||||
- Has a specific end goal
|
||||
- Has a deadline or completion state
|
||||
- Contains discrete tasks and deliverables
|
||||
- Will eventually move to Archive
|
||||
|
||||
**Examples**:
|
||||
- Writing a research paper
|
||||
- Planning a presentation
|
||||
- Learning a specific skill
|
||||
- Organizing an event
|
||||
- Building a feature
|
||||
- Planning a trip
|
||||
|
||||
**Structure**:
|
||||
```
|
||||
01_Projects/[ProjectName]/
|
||||
├── README.md # Project overview, goals, timeline
|
||||
├── Research/ # Background materials
|
||||
├── Drafts/ # Work in progress
|
||||
├── References/ # Supporting documents
|
||||
└── Output/ # Final deliverables
|
||||
```
|
||||
|
||||
**When to Archive**:
|
||||
- Project objectives are met
|
||||
- Project is cancelled or abandoned
|
||||
- Project becomes inactive for 30+ days
|
||||
|
||||
---
|
||||
|
||||
### 2. Areas (02_Areas/)
|
||||
|
||||
**Definition**: Ongoing responsibilities without end dates
|
||||
|
||||
**Characteristics**:
|
||||
- Continuous maintenance required
|
||||
- Standards to uphold (not goals to achieve)
|
||||
- No completion date
|
||||
- Generates multiple projects over time
|
||||
|
||||
**Examples**:
|
||||
- Health & Fitness
|
||||
- Professional Development
|
||||
- Finances
|
||||
- Relationships
|
||||
- Home Management
|
||||
- Career
|
||||
- Personal Growth
|
||||
|
||||
**Structure**:
|
||||
```
|
||||
02_Areas/[AreaName]/
|
||||
├── Overview.md # Area definition and standards
|
||||
├── Projects.md # Related project links
|
||||
└── Resources.md # Helpful references
|
||||
```
|
||||
|
||||
**Key Insight**:
|
||||
Areas are **standards to maintain**, not goals to achieve.
|
||||
- ✅ "Maintain health" (Area)
|
||||
- ❌ "Lose 10 pounds" (Project)
|
||||
|
||||
**When to Archive**:
|
||||
- Area is no longer relevant to your life
|
||||
- Responsibility has been transferred
|
||||
- Area has been inactive for 6+ months
|
||||
|
||||
---
|
||||
|
||||
### 3. Resources (03_Resources/)
|
||||
|
||||
**Definition**: Topics of interest for reference and learning
|
||||
|
||||
**Characteristics**:
|
||||
- Not tied to current projects or areas
|
||||
- Reference material for future use
|
||||
- Long-term knowledge building
|
||||
- Curated information by topic
|
||||
|
||||
**Examples**:
|
||||
- Programming languages (Python, JavaScript)
|
||||
- Historical topics (World War II, Ancient Rome)
|
||||
- Philosophical concepts (Stoicism, Existentialism)
|
||||
- Technical documentation (Git, Docker, APIs)
|
||||
- Book notes and summaries
|
||||
- Research papers
|
||||
- How-to guides
|
||||
|
||||
**Structure**:
|
||||
```
|
||||
03_Resources/[TopicName]/
|
||||
├── Index.md # Topic overview
|
||||
├── Notes/ # Individual concept notes
|
||||
└── References/ # Source materials
|
||||
```
|
||||
|
||||
**Key Insight**:
|
||||
Resources are **interests, not responsibilities**.
|
||||
- If you're not actively using it → Resource
|
||||
- If you must maintain it → Area
|
||||
|
||||
**When to Archive**:
|
||||
- Information becomes outdated
|
||||
- Topic is no longer of interest
|
||||
- Superseded by better resources
|
||||
|
||||
---
|
||||
|
||||
### 4. Archive (04_Archive/)
|
||||
|
||||
**Definition**: Completed projects and inactive items
|
||||
|
||||
**Characteristics**:
|
||||
- Completed projects (for reference)
|
||||
- Inactive areas (no longer relevant)
|
||||
- Outdated resources (superseded)
|
||||
- Historical reference only
|
||||
|
||||
**Structure**:
|
||||
```
|
||||
04_Archive/
|
||||
├── Projects/ # Completed projects
|
||||
├── Areas/ # Inactive areas
|
||||
└── Resources/ # Outdated resources
|
||||
```
|
||||
|
||||
**When to Archive**:
|
||||
- **Projects**: When objectives are met or abandoned
|
||||
- **Areas**: When no longer relevant
|
||||
- **Resources**: When superseded or no longer useful
|
||||
|
||||
**Archive vs. Delete**:
|
||||
- Archive: May need for reference later
|
||||
- Delete: Clearly useless or duplicates
|
||||
|
||||
---
|
||||
|
||||
## Decision Flow
|
||||
|
||||
**Where should this file go?**
|
||||
|
||||
```
|
||||
┌─ Has a deadline or end goal?
|
||||
│ └─ YES → Projects
|
||||
│
|
||||
├─ Ongoing responsibility?
|
||||
│ └─ YES → Areas
|
||||
│
|
||||
├─ Just interesting information?
|
||||
│ └─ YES → Resources
|
||||
│
|
||||
├─ Completed or inactive?
|
||||
│ └─ YES → Archive
|
||||
│
|
||||
└─ Not sure?
|
||||
└─ → Inbox (process later)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Common Confusion
|
||||
|
||||
### Project vs. Area
|
||||
|
||||
| Question | Project | Area |
|
||||
|----------|---------|------|
|
||||
| Has deadline? | ✅ Yes | ❌ No |
|
||||
| Can be completed? | ✅ Yes | ❌ No |
|
||||
| Generates tasks? | ✅ Yes | ✅ Yes |
|
||||
| Standard to maintain? | ❌ No | ✅ Yes |
|
||||
|
||||
**Example**:
|
||||
- "Health" → Area (ongoing responsibility)
|
||||
- "Train for marathon" → Project (specific goal, deadline)
|
||||
|
||||
### Area vs. Resource
|
||||
|
||||
| Question | Area | Resource |
|
||||
|----------|------|----------|
|
||||
| Must maintain? | ✅ Yes | ❌ No |
|
||||
| Accountability? | ✅ Yes | ❌ No |
|
||||
| Just interested? | ❌ No | ✅ Yes |
|
||||
|
||||
**Example**:
|
||||
- "Professional Development" → Area (responsibility)
|
||||
- "Machine Learning" → Resource (interest/learning)
|
||||
|
||||
---
|
||||
|
||||
## PARA Benefits
|
||||
|
||||
### 1. Fast Capture
|
||||
Don't waste time deciding perfect categories. If unsure → Inbox.
|
||||
|
||||
### 2. Context-Based
|
||||
Information is organized by how you'll use it, not what it's about.
|
||||
|
||||
### 3. Scalable
|
||||
Works with 10 files or 10,000 files.
|
||||
|
||||
### 4. Action-Oriented
|
||||
Focus on what needs attention now (Projects/Areas), not passive information.
|
||||
|
||||
### 5. Dynamic
|
||||
Files move between categories as context changes.
|
||||
|
||||
---
|
||||
|
||||
## PARA in Practice
|
||||
|
||||
### Starting a New Project
|
||||
|
||||
1. Create folder: `01_Projects/[ProjectName]/`
|
||||
2. Add README.md with:
|
||||
- Goal and timeline
|
||||
- Success criteria
|
||||
- Next actions
|
||||
3. Move related notes from Inbox/Resources to project folder
|
||||
4. Work actively until completion
|
||||
5. Archive when done
|
||||
|
||||
### Maintaining an Area
|
||||
|
||||
1. Create folder: `02_Areas/[AreaName]/`
|
||||
2. Add Overview.md with:
|
||||
- Definition of the area
|
||||
- Standards to maintain
|
||||
- Key metrics or indicators
|
||||
3. Link to related projects (many projects may support one area)
|
||||
4. Review during weekly review
|
||||
5. Archive if no longer relevant
|
||||
|
||||
### Building Resources
|
||||
|
||||
1. Capture web content, articles, notes to Inbox
|
||||
2. During processing, ask: "Is this tied to a project/area?"
|
||||
- No? → Move to `03_Resources/[Topic]/`
|
||||
3. Build topic collections over time
|
||||
4. Reference when starting new projects
|
||||
|
||||
---
|
||||
|
||||
## Migration Tips
|
||||
|
||||
### From Folder-Based System
|
||||
|
||||
**Before** (By topic):
|
||||
```
|
||||
Notes/
|
||||
├── Work/
|
||||
├── Personal/
|
||||
├── Learning/
|
||||
└── Reference/
|
||||
```
|
||||
|
||||
**After** (By actionability):
|
||||
```
|
||||
01_Projects/ ← Active work items
|
||||
02_Areas/ ← Ongoing responsibilities
|
||||
03_Resources/ ← Reference materials
|
||||
04_Archive/ ← Completed items
|
||||
```
|
||||
|
||||
### From Tag-Based System
|
||||
|
||||
Keep tags! PARA complements tags:
|
||||
- **PARA**: Primary organization (folders)
|
||||
- **Tags**: Secondary connections (cross-cutting themes)
|
||||
|
||||
Example:
|
||||
- File: `01_Projects/Website_Redesign/wireframes.md`
|
||||
- Tags: `#design #ux #client-work`
|
||||
|
||||
---
|
||||
|
||||
## Common Pitfalls
|
||||
|
||||
### 1. Too Many Projects
|
||||
**Problem**: 20+ active projects
|
||||
**Solution**: Archive inactive projects. Aim for 5-10 active projects max.
|
||||
|
||||
### 2. Areas Become Dumping Grounds
|
||||
**Problem**: "Personal" area has 100+ unrelated notes
|
||||
**Solution**: Break into specific areas or create projects for actionable items.
|
||||
|
||||
### 3. Never Archiving
|
||||
**Problem**: Completed projects stay in Projects folder
|
||||
**Solution**: Move to Archive immediately upon completion.
|
||||
|
||||
### 4. Over-Organizing Resources
|
||||
**Problem**: Spending hours categorizing resources
|
||||
**Solution**: Quick capture to Inbox, batch organize weekly.
|
||||
|
||||
### 5. Treating Areas as Projects
|
||||
**Problem**: Expecting areas to be "completed"
|
||||
**Solution**: Areas are maintained, not completed. Create projects for specific goals.
|
||||
|
||||
---
|
||||
|
||||
## Weekly Review Integration
|
||||
|
||||
During weekly review, ask:
|
||||
|
||||
**Projects**:
|
||||
- [ ] Which projects are complete? → Archive
|
||||
- [ ] Which projects are stalled? → Archive or reactivate
|
||||
- [ ] Do areas need new projects?
|
||||
|
||||
**Areas**:
|
||||
- [ ] Are standards being met?
|
||||
- [ ] Do any areas need attention?
|
||||
- [ ] Should any areas be archived?
|
||||
|
||||
**Resources**:
|
||||
- [ ] Are resources still relevant?
|
||||
- [ ] Can resources be consolidated?
|
||||
- [ ] Archive outdated resources?
|
||||
|
||||
**Inbox**:
|
||||
- [ ] Process all items into PARA
|
||||
|
||||
---
|
||||
|
||||
## Advanced: Cross-Cutting Themes
|
||||
|
||||
PARA handles **vertical organization** (by actionability).
|
||||
Use **tags** for horizontal themes:
|
||||
|
||||
Example:
|
||||
- Project: `01_Projects/Client_Presentation/`
|
||||
- Tags: `#public-speaking #client-work #q1-2026`
|
||||
|
||||
This creates multi-dimensional organization:
|
||||
- Find by project (folder)
|
||||
- Find by theme (tags)
|
||||
- Find by time (date tags)
|
||||
|
||||
---
|
||||
|
||||
## Further Reading
|
||||
|
||||
**Original Creator**: Tiago Forte
|
||||
**Book**: *Building a Second Brain*
|
||||
**Blog**: [Forte Labs](https://fortelabs.com/blog/para/)
|
||||
|
||||
**Related Methods**:
|
||||
- GTD (Getting Things Done) - Task management
|
||||
- Zettelkasten - Note-taking and connections
|
||||
- PARA - Information organization
|
||||
|
||||
**Best Used Together**:
|
||||
- PARA for organization
|
||||
- Zettelkasten for linking ideas
|
||||
- GTD for task execution
|
||||
|
||||
---
|
||||
|
||||
## Quick Reference
|
||||
|
||||
| Category | Question | Timeframe |
|
||||
|----------|----------|-----------|
|
||||
| **Projects** | What am I working on? | Short-term (weeks-months) |
|
||||
| **Areas** | What am I responsible for? | Ongoing (no end) |
|
||||
| **Resources** | What might be useful? | Long-term reference |
|
||||
| **Archive** | What is completed? | Historical |
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: 2026-01-06
|
||||
**See Also**: [[CLAUDE]], [[QUICK_REFERENCE]], [[WEEKLY_REVIEW]]
|
||||
@@ -0,0 +1,679 @@
|
||||
---
|
||||
created: 2026-01-06
|
||||
type: reference
|
||||
tags: [troubleshooting, help, faq]
|
||||
---
|
||||
|
||||
# Troubleshooting Guide
|
||||
|
||||
Common issues and solutions for your Obsidian vault.
|
||||
|
||||
---
|
||||
|
||||
## Quick Diagnostics
|
||||
|
||||
**Before anything else, run**:
|
||||
|
||||
```bash
|
||||
git status # Check Git state
|
||||
git pull # Sync latest changes
|
||||
ls 00_Inbox/ # Check inbox
|
||||
```
|
||||
|
||||
Most issues stem from: Git conflicts, file misplacement, or broken links.
|
||||
|
||||
---
|
||||
|
||||
## Git Issues
|
||||
|
||||
### "Permission denied (publickey)"
|
||||
|
||||
**Problem**: Can't push/pull from remote (SSH key issue)
|
||||
|
||||
**Solution 1: Use HTTPS instead**:
|
||||
```bash
|
||||
git remote set-url origin https://github.com/username/repo.git
|
||||
git pull
|
||||
```
|
||||
|
||||
**Solution 2: Configure SSH key**:
|
||||
```bash
|
||||
# Generate new SSH key
|
||||
ssh-keygen -t ed25519 -C "your_email@example.com"
|
||||
|
||||
# Add to GitHub: Settings → SSH Keys → Add Key
|
||||
# Copy public key:
|
||||
cat ~/.ssh/id_ed25519.pub
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Git Conflicts After Pull
|
||||
|
||||
**Problem**:
|
||||
```
|
||||
CONFLICT (content): Merge conflict in filename.md
|
||||
Automatic merge failed; fix conflicts and then commit the result.
|
||||
```
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Check which files have conflicts
|
||||
git status
|
||||
|
||||
# 2. Open conflicted files
|
||||
# You'll see markers like:
|
||||
# <<<<<<< HEAD
|
||||
# Your local changes
|
||||
# =======
|
||||
# Remote changes
|
||||
# >>>>>>> origin/main
|
||||
|
||||
# 3. Edit files manually, choose which version to keep
|
||||
# Delete conflict markers
|
||||
|
||||
# 4. Stage and commit
|
||||
git add .
|
||||
git commit -m "Resolve merge conflicts"
|
||||
git push
|
||||
```
|
||||
|
||||
**Prevention**:
|
||||
- Always `git pull` before starting work
|
||||
- Commit and push at end of each session
|
||||
- Don't edit same file on multiple devices simultaneously
|
||||
|
||||
---
|
||||
|
||||
### "Your branch is ahead by N commits"
|
||||
|
||||
**Meaning**: You have local commits not pushed to remote
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
git push
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### "Your branch is behind by N commits"
|
||||
|
||||
**Meaning**: Remote has commits you don't have locally
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
git pull
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### "Diverged branches"
|
||||
|
||||
**Meaning**: Both you and remote have different commits
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
git pull # Will attempt auto-merge
|
||||
# If conflicts occur, resolve manually (see above)
|
||||
git add .
|
||||
git commit -m "Resolve merge conflicts"
|
||||
git push
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Accidentally Committed Sensitive File
|
||||
|
||||
**Immediate Action**:
|
||||
```bash
|
||||
# Remove from Git tracking (keep local file)
|
||||
git rm --cached sensitive-file.txt
|
||||
|
||||
# Add to .gitignore
|
||||
echo "sensitive-file.txt" >> .gitignore
|
||||
|
||||
# Commit removal
|
||||
git add .gitignore
|
||||
git commit -m "Remove sensitive file from tracking"
|
||||
git push
|
||||
```
|
||||
|
||||
**⚠️ Warning**: File still exists in Git history. For complete removal, use BFG Repo-Cleaner (advanced).
|
||||
|
||||
---
|
||||
|
||||
### Completely Reset to Remote
|
||||
|
||||
**⚠️ DANGER**: This discards ALL local changes
|
||||
|
||||
**Use when**: Local changes are broken beyond repair
|
||||
|
||||
```bash
|
||||
# Backup first (if anything is valuable)
|
||||
cp -r . ../vault-backup
|
||||
|
||||
# Reset to remote
|
||||
git fetch origin
|
||||
git reset --hard origin/main
|
||||
git clean -fd
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File Organization Issues
|
||||
|
||||
### Inbox Overflow (> 50 items)
|
||||
|
||||
**Problem**: Inbox has too many unprocessed items
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Count items
|
||||
ls 00_Inbox/ | wc -l
|
||||
|
||||
# 2. Schedule 30-60 minute processing session
|
||||
# 3. Quick triage:
|
||||
# - Delete: Low-value items
|
||||
# - Archive: Outdated items
|
||||
# - Quick process: Easy decisions
|
||||
# - Batch process: Similar items together
|
||||
|
||||
# 4. Set calendar reminder for weekly review
|
||||
```
|
||||
|
||||
**Prevention**:
|
||||
- Process inbox weekly (non-negotiable)
|
||||
- Capture fast, don't organize while capturing
|
||||
- Use `#needs-processing` tag for complex items
|
||||
|
||||
---
|
||||
|
||||
### Can't Find a File
|
||||
|
||||
**Scenario**: You know a file exists but can't locate it
|
||||
|
||||
**Solution 1: Obsidian Search**:
|
||||
```
|
||||
Ctrl+Shift+F (or Cmd+Shift+F)
|
||||
```
|
||||
|
||||
**Solution 2: Command line search**:
|
||||
```bash
|
||||
# Search by filename
|
||||
find . -name "*keyword*"
|
||||
|
||||
# Search by content
|
||||
grep -r "keyword" . --include="*.md"
|
||||
|
||||
# Search with context
|
||||
grep -r -C 3 "keyword" . --include="*.md"
|
||||
```
|
||||
|
||||
**Solution 3: Check common locations**:
|
||||
```bash
|
||||
ls 00_Inbox/ # Recently added?
|
||||
ls 04_Archive/ # Already archived?
|
||||
git log --all --full-history -- "*keyword*" # Deleted?
|
||||
```
|
||||
|
||||
**Solution 4: Git history**:
|
||||
```bash
|
||||
# Find when file was moved/deleted
|
||||
git log --all --full-history --summary | grep filename
|
||||
|
||||
# See file contents from past
|
||||
git show <commit-hash>:path/to/file.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Broken Links After Moving Files
|
||||
|
||||
**Problem**: Moved a file, now links are broken
|
||||
|
||||
**Solution 1: Use update script**:
|
||||
```bash
|
||||
pnpm attachments:update-links
|
||||
```
|
||||
|
||||
**Solution 2: Manual search and replace**:
|
||||
```bash
|
||||
# Find all references to old path
|
||||
grep -r "old-filename" . --include="*.md"
|
||||
|
||||
# Update manually in each file
|
||||
```
|
||||
|
||||
**Solution 3: Obsidian's built-in update**:
|
||||
- Obsidian automatically updates `[[wiki-links]]` when you move files in the app
|
||||
- Use Obsidian file explorer to move files when possible
|
||||
|
||||
**Prevention**:
|
||||
- Use Obsidian's file explorer to move files (auto-updates links)
|
||||
- Or use `pnpm attachments:update-links` after moving
|
||||
- Commit changes after any reorganization
|
||||
|
||||
---
|
||||
|
||||
### File in Wrong Folder
|
||||
|
||||
**Problem**: File is in wrong PARA category
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Verify destination exists
|
||||
ls 01_Projects/TargetProject/
|
||||
|
||||
# 2. Move file
|
||||
mv "02_Areas/wrongplace/file.md" "01_Projects/TargetProject/file.md"
|
||||
|
||||
# 3. Update any links (if needed)
|
||||
pnpm attachments:update-links
|
||||
|
||||
# 4. Commit
|
||||
git add .
|
||||
git commit -m "Organize: Moved file.md to correct location"
|
||||
git push
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Attachment Issues
|
||||
|
||||
### Orphaned Attachments
|
||||
|
||||
**Problem**: Attachments in `05_Attachments/` not referenced anywhere
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# Find orphaned files
|
||||
pnpm attachments:orphans
|
||||
|
||||
# Review each orphan:
|
||||
# - Delete if truly unused
|
||||
# - Or add reference to a note
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Broken Image/Attachment Links
|
||||
|
||||
**Problem**: `![[image.png]]` shows as broken link
|
||||
|
||||
**Causes**:
|
||||
1. File doesn't exist
|
||||
2. File path is wrong
|
||||
3. File name has typo
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Check if file exists
|
||||
ls 05_Attachments/ | grep image
|
||||
|
||||
# 2. Check organized folder
|
||||
ls 05_Attachments/Organized/ | grep image
|
||||
|
||||
# 3. Search for file anywhere
|
||||
find . -name "*image*"
|
||||
|
||||
# 4. Update link in note to correct path
|
||||
```
|
||||
|
||||
**Prevention**:
|
||||
- Use Obsidian's drag-and-drop to insert attachments (auto-correct paths)
|
||||
- Keep attachments organized in `05_Attachments/`
|
||||
- Use descriptive file names
|
||||
|
||||
---
|
||||
|
||||
### Attachment Folder Too Large
|
||||
|
||||
**Problem**: `05_Attachments/` is taking up too much space
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Check sizes
|
||||
pnpm attachments:sizes
|
||||
|
||||
# 2. Identify large files
|
||||
find 05_Attachments -type f -size +10M
|
||||
|
||||
# 3. Options:
|
||||
# - Compress images (use online tools)
|
||||
# - Delete unused files (check with orphans script)
|
||||
# - Move large videos outside vault (link externally)
|
||||
```
|
||||
|
||||
**Prevention**:
|
||||
- Compress images before adding
|
||||
- Link to large videos externally (Google Drive, Dropbox)
|
||||
- Regularly clean up unused attachments
|
||||
|
||||
---
|
||||
|
||||
## Command/Script Issues
|
||||
|
||||
### "pnpm: command not found"
|
||||
|
||||
**Problem**: Node.js/pnpm not installed or not in PATH
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# Install pnpm
|
||||
npm install -g pnpm
|
||||
|
||||
# Or use npx instead
|
||||
npx pnpm attachments:list
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Script Fails with "Permission denied"
|
||||
|
||||
**Problem**: Script doesn't have execute permissions
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# Add execute permission
|
||||
chmod +x .scripts/script-name.sh
|
||||
|
||||
# Or run with bash explicitly
|
||||
bash .scripts/script-name.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Firecrawl Scripts Fail
|
||||
|
||||
**Problem**: `pnpm firecrawl:scrape` returns errors
|
||||
|
||||
**Common Causes**:
|
||||
1. API key not set
|
||||
2. Proxy not configured (if behind firewall)
|
||||
3. Invalid URL
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Set up environment
|
||||
source .scripts/setup-firecrawl-env.sh
|
||||
|
||||
# 2. Verify environment
|
||||
echo $FIRECRAWL_API_KEY # Should show your key
|
||||
echo $HTTP_PROXY # Should show proxy (if needed)
|
||||
|
||||
# 3. Test with simple URL
|
||||
pnpm firecrawl:scrape "https://example.com" "test.md"
|
||||
|
||||
# 4. Check output
|
||||
cat 00_Inbox/Clippings/test.md
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Obsidian App Issues
|
||||
|
||||
### Vault Not Syncing Properly
|
||||
|
||||
**Problem**: Changes in Obsidian don't appear in Git
|
||||
|
||||
**Cause**: Obsidian auto-save might be delayed
|
||||
|
||||
**Solution**:
|
||||
1. Manually save note: `Ctrl+S` (or `Cmd+S`)
|
||||
2. Wait 1-2 seconds for file to write
|
||||
3. Then run `git status` to verify
|
||||
|
||||
---
|
||||
|
||||
### "This vault is not an Obsidian vault"
|
||||
|
||||
**Problem**: Obsidian doesn't recognize vault folder
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# Check if .obsidian folder exists
|
||||
ls -la .obsidian/
|
||||
|
||||
# If missing, re-open as vault in Obsidian:
|
||||
# File → Open Folder as Vault → Select vault directory
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Plugins Not Working
|
||||
|
||||
**Problem**: Installed plugins don't appear or function
|
||||
|
||||
**Solution**:
|
||||
1. Check `.obsidian/community-plugins.json` exists
|
||||
2. Settings → Community Plugins → Ensure not in restricted mode
|
||||
3. Restart Obsidian
|
||||
4. Re-enable plugins in Settings
|
||||
|
||||
---
|
||||
|
||||
## Workflow Issues
|
||||
|
||||
### Weekly Review Not Happening
|
||||
|
||||
**Problem**: Haven't done weekly review in weeks
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Schedule 30-45 minutes NOW
|
||||
# 2. Open WEEKLY_REVIEW.md
|
||||
# 3. At minimum, process inbox:
|
||||
ls 00_Inbox/
|
||||
# Move items to proper locations
|
||||
|
||||
# 4. Set recurring calendar reminder:
|
||||
# "Weekly Review - Every Sunday 10am"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Too Many Active Projects
|
||||
|
||||
**Problem**: 20+ projects, feeling overwhelmed
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. List projects
|
||||
ls 01_Projects/
|
||||
|
||||
# 2. For each project, ask:
|
||||
# - Worked on in last 30 days? → Keep active
|
||||
# - Haven't touched in 30+ days? → Archive
|
||||
# - No longer relevant? → Archive
|
||||
|
||||
# 3. Archive inactive projects
|
||||
mv "01_Projects/OldProject" "04_Archive/Projects/OldProject"
|
||||
|
||||
# 4. Aim for 5-10 active projects maximum
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Areas Becoming Dumping Grounds
|
||||
|
||||
**Problem**: An area has 50+ unrelated notes
|
||||
|
||||
**Solution**:
|
||||
1. **Review contents**: What are these notes about?
|
||||
2. **Create sub-areas or projects**: Group related notes
|
||||
3. **Move to resources**: If just reference material
|
||||
4. **Archive**: If outdated
|
||||
|
||||
**Example**:
|
||||
```
|
||||
Before:
|
||||
02_Areas/Personal/
|
||||
├── health-tip-1.md
|
||||
├── health-tip-2.md
|
||||
├── budget-2025.md
|
||||
├── workout-plan.md
|
||||
├── ... (50 more files)
|
||||
|
||||
After:
|
||||
02_Areas/Health/ ← New area
|
||||
├── workout-plan.md
|
||||
└── health-tips/
|
||||
|
||||
02_Areas/Finances/ ← New area
|
||||
└── budget-2025.md
|
||||
|
||||
03_Resources/Health/ ← Reference materials
|
||||
└── health-tips/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Performance Issues
|
||||
|
||||
### Obsidian Slow to Start
|
||||
|
||||
**Causes**:
|
||||
1. Too many plugins
|
||||
2. Vault too large
|
||||
3. Indexing large files
|
||||
|
||||
**Solution**:
|
||||
1. Disable unused plugins: Settings → Community Plugins
|
||||
2. Archive old files: Move to `04_Archive/`
|
||||
3. Exclude large folders from search: Settings → Files & Links → Excluded files
|
||||
|
||||
---
|
||||
|
||||
### Git Operations Slow
|
||||
|
||||
**Causes**:
|
||||
1. Large binary files in repo
|
||||
2. Too many commits in history
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# Check repo size
|
||||
du -sh .git
|
||||
|
||||
# Find large files
|
||||
find . -type f -size +10M
|
||||
|
||||
# Consider:
|
||||
# - Git LFS for large files
|
||||
# - .gitignore for unnecessary files
|
||||
# - Clean up old binary files
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Data Recovery
|
||||
|
||||
### Accidentally Deleted File
|
||||
|
||||
**Solution 1: Git history**:
|
||||
```bash
|
||||
# Find when file was deleted
|
||||
git log --all --full-history -- "path/to/file.md"
|
||||
|
||||
# Restore from specific commit
|
||||
git checkout <commit-hash> -- "path/to/file.md"
|
||||
```
|
||||
|
||||
**Solution 2: Obsidian's file recovery**:
|
||||
- `.obsidian/plugins/file-recovery/` (if plugin enabled)
|
||||
|
||||
**Solution 3: System file recovery**:
|
||||
- Windows: Recycle Bin
|
||||
- Mac: Trash
|
||||
- Linux: `~/.local/share/Trash/`
|
||||
|
||||
---
|
||||
|
||||
### Vault Corrupted
|
||||
|
||||
**⚠️ Extreme Case**:
|
||||
|
||||
**Solution**:
|
||||
```bash
|
||||
# 1. Stop and assess damage
|
||||
git status
|
||||
|
||||
# 2. If Git is intact, reset to last known good state
|
||||
git log --oneline -20
|
||||
git reset --hard <good-commit-hash>
|
||||
|
||||
# 3. If Git is broken, clone from remote
|
||||
cd ..
|
||||
git clone <remote-url> vault-restored
|
||||
cd vault-restored
|
||||
```
|
||||
|
||||
**Prevention**:
|
||||
- Commit daily (creates restore points)
|
||||
- Push to remote (offsite backup)
|
||||
- Optional: External backup (Google Drive, Dropbox)
|
||||
|
||||
---
|
||||
|
||||
## Getting Help
|
||||
|
||||
### Self-Help Checklist
|
||||
|
||||
Before asking for help:
|
||||
|
||||
- [ ] Checked this troubleshooting guide
|
||||
- [ ] Ran `git status` and `git pull`
|
||||
- [ ] Searched Obsidian forums
|
||||
- [ ] Googled the error message
|
||||
- [ ] Checked [[GIT_WORKFLOW]] for Git issues
|
||||
- [ ] Reviewed [[QUICK_REFERENCE]] for commands
|
||||
|
||||
---
|
||||
|
||||
### Ask AI Assistant
|
||||
|
||||
**Effective Questions**:
|
||||
```
|
||||
✅ "How do I move files from Inbox to Projects?"
|
||||
✅ "I'm getting this error: [paste error]. How do I fix it?"
|
||||
✅ "What's the difference between Areas and Resources?"
|
||||
|
||||
❌ "It's broken" (too vague)
|
||||
❌ "Nothing works" (no context)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### External Resources
|
||||
|
||||
**Obsidian Forums**: https://forum.obsidian.md/
|
||||
**Git Documentation**: https://git-scm.com/doc
|
||||
**PARA Method**: https://fortelabs.com/blog/para/
|
||||
|
||||
---
|
||||
|
||||
## Preventive Maintenance
|
||||
|
||||
### Daily
|
||||
- [ ] `git pull` at start
|
||||
- [ ] `git push` at end
|
||||
|
||||
### Weekly
|
||||
- [ ] Process inbox
|
||||
- [ ] Review active projects
|
||||
- [ ] Run `pnpm attachments:orphans`
|
||||
|
||||
### Monthly
|
||||
- [ ] Archive completed projects
|
||||
- [ ] Clean up orphaned attachments
|
||||
- [ ] Review and consolidate resources
|
||||
|
||||
### Quarterly
|
||||
- [ ] Deep archive review
|
||||
- [ ] Check `.gitignore` is up to date
|
||||
- [ ] Update documentation (CLAUDE.md, etc.)
|
||||
|
||||
---
|
||||
|
||||
**Last Updated**: 2026-01-06
|
||||
**See Also**: [[CLAUDE]], [[QUICK_REFERENCE]], [[GIT_WORKFLOW]]
|
||||
+14
-2
@@ -1,3 +1,15 @@
|
||||
---
|
||||
title: Templater 快速参考
|
||||
created: 2026-01-05
|
||||
updated: 2026-01-05
|
||||
tags:
|
||||
- obsidian
|
||||
- templater
|
||||
- quick-reference
|
||||
- reference
|
||||
type: reference
|
||||
---
|
||||
|
||||
# Templater 快速参考
|
||||
|
||||
> 📌 **快速指南**：Templater 插件常用语法和命令速查表
|
||||
@@ -103,8 +115,8 @@ tR += status;
|
||||
|
||||
## 🔗 相关文档
|
||||
|
||||
- [[06_Metadata/Templater-Setup-Guide|Templater Setup Guide]]
|
||||
- [[06_Metadata/Templater-User-Guide|Templater User Guide]]
|
||||
- [[Templater-Setup-Guide|Templater Setup Guide]]
|
||||
- [[Templater-User-Guide|Templater User Guide]]
|
||||
|
||||
---
|
||||
|
||||
+17
-4
@@ -1,3 +1,16 @@
|
||||
---
|
||||
title: Templater 配置步骤
|
||||
created: 2026-01-05
|
||||
updated: 2026-01-05
|
||||
tags:
|
||||
- obsidian
|
||||
- templater
|
||||
- setup
|
||||
- guide
|
||||
- reference
|
||||
type: reference
|
||||
---
|
||||
|
||||
# Templater 配置步骤
|
||||
|
||||
## 🎯 快速开始（3步完成配置）
|
||||
@@ -106,7 +119,7 @@
|
||||
|
||||
1. 在 `06_Metadata/Templates/` 创建新的 `.md` 文件
|
||||
2. 使用 Templater 语法编写模板
|
||||
3. 参考 [[06_Metadata/Templater-User-Guide|Templater User Guide]] 了解语法
|
||||
3. 参考 [[Templater-User-Guide|Templater User Guide]] 了解语法
|
||||
|
||||
## 💡 实用技巧
|
||||
|
||||
@@ -142,12 +155,12 @@
|
||||
**A**: 结合 **Calendar** 或 **Periodic Notes** 插件，设置每日笔记模板为 `daily-note.md`
|
||||
|
||||
### Q: 如何查看所有可用的 Templater 函数？
|
||||
**A**: 阅读 [[06_Metadata/Templater-User-Guide|Templater User Guide]] 或访问官方文档
|
||||
**A**: 阅读 [[Templater-User-Guide|Templater User Guide]] 或访问官方文档
|
||||
|
||||
## 📖 延伸阅读
|
||||
|
||||
- [[06_Metadata/Templater-User-Guide|Templater User Guide]]
|
||||
- [[06_Metadata/Templater-Quick-Reference|Templater Quick Reference]]
|
||||
- [[Templater-User-Guide|Templater User Guide]]
|
||||
- [[Templater-Quick-Reference|Templater Quick Reference]]
|
||||
- 官方文档：https://silentvoid13.github.io/Templater/
|
||||
|
||||
---
|
||||
@@ -1,3 +1,15 @@
|
||||
---
|
||||
title: Templater 使用指南
|
||||
created: 2026-01-05
|
||||
updated: 2026-01-05
|
||||
tags:
|
||||
- obsidian
|
||||
- templater
|
||||
- guide
|
||||
- reference
|
||||
type: reference
|
||||
---
|
||||
|
||||
# Templater 使用指南
|
||||
|
||||
## 什么是 Templater？
|
||||
Reference in New Issue
Block a user