obos

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Obsidian Best Practices (obos)

Obsidian 最佳实践 (obos)

Manage an Obsidian vault with AI-friendly structure.

使用适配AI的结构管理Obsidian库。

Commands

命令

Command	Description
`/obos init`	Initialize vault structure + interactive onboarding
`/obos daily [date]`	Create/open daily note with carry-forward
`/obos save [type]`	Save conversation insight (fast default, `--deep` for guided)
`/obos weekly [range]`	Generate weekly review ( `--reflect` for guided reflection)
`/obos sync`	Sync index files + health report ( `--status` for read-only)
`/obos refine [note]`	Socratic note refinement (draft → refined)
`/obos ask "question"`	Query your knowledge base
`/obos link [note]`	Smart link suggestions
`/obos draft "topic"`	Writing assist from notes

No argument → show grouped command list:

记录：daily, save
加工：refine, link
产出：ask, draft
维护：sync, weekly
设置：init

命令	描述
`/obos init`	初始化库结构 + 交互式引导
`/obos daily [date]`	创建/打开带有内容延续的日常笔记
`/obos save [type]`	保存对话见解（默认快速保存， `--deep` 参数启用引导式保存）
`/obos weekly [range]`	生成周复盘报告（ `--reflect` 参数启用引导式反思）
`/obos sync`	同步索引文件 + 健康报告（ `--status` 参数启用只读模式）
`/obos refine [note]`	苏格拉底式笔记优化（草稿 → 精加工）
`/obos ask "question"`	查询你的知识库
`/obos link [note]`	智能链接建议
`/obos draft "topic"`	基于笔记的写作辅助

无参数时 → 显示分组命令列表：

记录：daily, save
加工：refine, link
产出：ask, draft
维护：sync, weekly
设置：init

Vault Path Discovery

库路径识别逻辑

All commands share this logic:

Current working directory — if it contains
```
CLAUDE.md
```
with vault-related content or has
```
.obsidian/
```

Fallback:

/Users/hansonmei/OneDrive/obsidian-vault/

If neither exists, ask user with AskUserQuestion

所有命令遵循以下逻辑：

当前工作目录 — 若目录中包含带有库相关内容的
```
CLAUDE.md
```
文件或存在
```
.obsidian/
```
文件夹

备选路径：

/Users/hansonmei/OneDrive/obsidian-vault/

若上述路径均不存在，通过AskUserQuestion询问用户

Vault Structure

库结构

Vault/
├── CLAUDE.md          # AI context file
├── Index.md           # AI-readable index (auto-generated)
├── Daily/             # Daily notes + weekly reviews
├── Notes/             # Evergreen notes
├── Clippings/         # Web clippings
├── References/        # Source materials
├── Attachments/       # Images and files
├── Categories/        # MOC index pages
└── Templates/         # Note templates

Vault/
├── CLAUDE.md          # AI上下文文件
├── Index.md           # AI可读索引（自动生成）
├── Daily/             # 日常笔记 + 周复盘
├── Notes/             # 常青笔记
├── Clippings/         # 网页剪藏
├── References/        # 源材料
├── Attachments/       # 图片与文件
├── Categories/        # MOC索引页面
└── Templates/         # 笔记模板

Knowledge Maturity Model

知识成熟度模型

Two-level system tracked in frontmatter

status

field:

```
draft
```
— captured but not deeply processed
```
refined
```
— processed through guided reflection or
```
/obos refine
```

两级体系，通过前置元数据

status

字段追踪：

```
draft
```
— 已记录但未深度处理
```
refined
```
— 经引导式反思或
```
/obos refine
```
处理完成

Evergreen Note Template

常青笔记模板

markdown

---
status: {{draft|refined}}
source: {{attribution}}
created: {{YYYY-MM-DD}}
---

markdown

---
status: {{draft|refined}}
source: {{attribution}}
created: {{YYYY-MM-DD}}
---

Core Idea

核心观点

One sentence in your own words.

用你自己的话总结成一句话。

My Understanding

我的理解

Why it matters. What you agree/disagree with.

它的重要性是什么。你同意/不同意哪些内容。

Open Questions

待解问题

What new questions does this raise?

这引发了哪些新问题？

Command Routing

命令路由

Parse the first argument after

/obos

and load the matching

commands/{command}.md

file. If no argument, show the grouped command list above and ask what the user wants to do.

解析

/obos

后的第一个参数，加载匹配的

commands/{command}.md

文件。若未提供参数，显示上方分组命令列表并询问用户需求。