Tolaria 完全指南 2026：开源 Markdown 知识库桌面应用

# 通过 Homebrew 安装（最简单）
brew install --cask tolaria

# 或者从官网下载
# 访问 https://refactoringhq.github.io/tolaria/download/

# 下载 AppImage（推荐）
wget https://github.com/refactoringhq/tolaria/releases/latest/download/Tolaria-x86_64.AppImage
chmod +x Tolaria-x86_64.AppImage
./Tolaria-x86_64.AppImage

# 或者使用 Flatpak（如果可用）
flatpak install flathub com.refactoringhq.tolaria

# 克隆仓库
git clone https://github.com/refactoringhq/tolaria.git
cd tolaria

# 安装依赖（需要 Node.js 18+）
npm install

# 开发模式运行
npm run dev

# 构建生产版本
npm run build

# 手动创建空白 vault（命令行方式）
mkdir ~/my-knowledge-base
cd ~/my-knowledge-base
git init
echo "# My Knowledge Base" > README.md
git add .
git commit -m "Initial commit"

my-vault/
├── .git/                  # Git 仓库（自动生成）
├── AGENTS.md              # AI 助手配置文件
├── types/                 # 类型定义文件夹
│   ├── note.type.yaml     # 笔记类型模板
│   └── task.type.yaml     # 任务类型模板
├── inbox/                 # 收件箱（快速捕获想法）
├── projects/              # 项目笔记
├── areas/                 # 责任领域
├── resources/             # 参考资料
└── archive/               # 归档内容

---
title: Tolaria 学习笔记
type: note
created: 2026-06-10
tags:
  - tolaria
  - knowledge-base
---

# Tolaria 核心功能

Tolaria 是一个...

## 关键特性

- 文件优先
- Git 优先
- 离线优先

## 相关链接

- [[另一条笔记]]  <!-- 双向链接 -->
- [Tolaria GitHub](https://github.com/refactoringhq/tolaria)

# 在 vault 目录下执行
cd ~/my-knowledge-base

# 添加远程仓库（GitHub/GitLab/Gitee）
git remote add origin https://github.com/yourusername/my-vault.git

# 推送
git push -u origin main

# 在任何编辑器中打开
code ~/my-vault/inbox/idea.md
vim ~/my-vault/projects/project-a.md

# 用 grep 搜索
grep -r "关键词" ~/my-vault/

# 批量处理
find ~/my-vault -name "*.md" -exec sed -i 's/旧词/新词/g' {} \;

# 查看变更
git status
git diff

# 提交变更
git add .
git commit -m "更新项目笔记"

# 查看历史
git log --oneline

# 回滚到某个版本
git checkout <commit-hash> -- filename.md

# 在笔记 A 中
参见 [[笔记 B]] 了解更多。

# 在笔记 B 中
这是被 [[笔记 A]] 引用的内容。

# types/note.type.yaml
name: Note
icon: 📝
color: blue
fields:
  - name: created
    type: date
  - name: tags
    type: list

---
title: 我的笔记
type: note
created: 2026-06-10
tags:
  - learning
---

# 在 vault 目录下
cd ~/my-vault

# 初始化 Claude Code（如果尚未安装）
claude

# Claude Code 会自动读取 AGENTS.md 了解你的笔记结构

# AGENTS.md - Tolaria Vault Guide

This vault uses the PARA method for organization:

- **Projects/**: Active projects with deadlines
- **Areas/**: Ongoing responsibilities
- **Resources/**: Reference materials
- **Archive/**: Completed or inactive items

## Note Format

All notes are Markdown files with YAML frontmatter:

```yaml
---
title: Note Title
type: note|task|resource
created: YYYY-MM-DD
tags: [tag1, tag2]
---

### 实战：用 AI 整理笔记

```bash
# 在 vault 目录中运行 Claude Code
claude

# 然后提问：
# "帮我总结 projects/ 目录下所有未完成的项目"
# "找出所有包含 'TODO' 的笔记"
# "为我的 Python 学习笔记添加标签"

# 示例：快速捕获
# 按 Cmd/Ctrl + N，输入标题，保存为 inbox/quick-thought.md

# 定期整理
mv inbox/quick-thought.md projects/project-alpha/
git add .
git commit -m "整理 inbox：移动笔记到项目"

// Bookmarklet 代码（保存到浏览器书签）
javascript:(function(){
  const title = document.title;
  const url = window.location.href;
  const content = document.getSelection().toString() || document.body.innerText;

  const markdown = `---
title: ${title}
type: resource
created: ${new Date().toISOString().split('T')[0]}
source: ${url}
---

# ${title}

${content}
`;

  // 复制到剪贴板，然后粘贴到 Tolaria
  navigator.clipboard.writeText(markdown);
  alert('已复制到剪贴板，请在 Tolaria 中粘贴');
})();

# templates/meeting-note.md
---
title: {{title}}
type: meeting
created: {{date}}
attendees: []
---

# {{title}}

**日期：** {{date}}
**参与者：** 

## 议程

1. 
2. 

## 讨论要点

## 行动项

- [ ] 

# 使用 MkDocs
pip install mkdocs
mkdocs new my-site
cp -r ~/my-vault/* my-site/docs/
mkdocs serve

# 或使用 Hugo
hugo new site my-blog
cp -r ~/my-vault/* my-blog/content/
hugo server

# 设备 A（推送）
cd ~/my-vault
git add .
git commit -m "更新笔记"
git push

# 设备 B（拉取）
cd ~/my-vault
git pull

# 复制 Obsidian vault 到 Tolaria
cp -r ~/obsidian-vault ~/tolaria-vault
cd ~/tolaria-vault
git init
git add .
git commit -m "从 Obsidian 迁移"

![示意图](assets/diagram.png)

# 复制图片到 assets 目录
cp ~/Downloads/diagram.png ~/my-vault/assets/
git add assets/diagram.png
git commit -m "添加示意图"