Albert Intelligence

OpenClaw中长期记忆插件和短期记忆插件的比较

Mon, 06 Apr 2026 00:00:00 +0000

Memory-lancedb-pro 与 Lossless-Claw: 统一对立分析

分析框架: 从统一与对立的维度，分析这两个 OpenClaw 插件的本质关系

核心问题: 它们是竞争关系还是互补关系？应该选一个还是两个都用？

🎯 一句话总结

Memory-lancedb-pro = 跨会话的长期记忆（外脑）Openclaw长期记忆插件：memory-lancedb-pro
Lossless-Claw = 单会话内的上下文管理（内脑）OpenClaw短期记忆插件：ossless-claw

两者结合 = 完整的认知系统

🔄 统一对立的本质

统一性：共同目标

┌─────────────────────────────────────────────────────────────┐
│ 共同目标 │
│ │
│ 让 AI 助手 "记住" 更多信息 │
│ │
└─────────────────────────────────────────────────────────────┘

对立性：不同维度

维度	Memory-lancedb-pro	Lossless-Claw
时间跨度	跨会话 (weeks, months)	单会话 (minutes, hours)
记忆类型	显式捕获 (Explicit)	连续压缩 (Continuous)
存储方式	向量数据库	SQLite + DAG
检索方式	语义搜索	摘要展开
衰减机制	Weibull 衰减	立即压缩
作用范围	跨 Agent 共享	单会话内部

📊 深度对比分析

1. 时间维度对比

时间轴
│
├─ 第1次对话 (Day 1)
│ ├─ Memory: 捕获偏好 → 持久存储
│ └─ LCM: 消息1-100 → 摘要A
│
├─ 第2次对话 (Day 2)
│ ├─ Memory: 捕获新偏好 → 持久存储
│ └─ LCM: 消息1-200 → 摘要B (压缩消息1-100)
│
├─ 第3次对话 (Day 30)
│ ├─ Memory: 检索历史决策 → 注入
│ └─ LCM: 消息1-300 → 摘要C (压缩消息1-200)
│
└─ 第10次对话 (Day 180)
 ├─ Memory: 检索所有历史偏好 → 注入
 └─ LCM: 消息1-N → 根摘要 (压缩消息1-300)

2. 记忆形成机制对比

┌─────────────────────────────────────────────────────────────┐
│ Memory-lancedb-pro 的记忆形成 │
│ │
│ 对话 → LLM提取 → 分类(6类) → 向量化 → 存储 │
│ │
│ 特点: │
│ • 显式提取（需要 LLM 判断） │
│ • 分类存储（profile/prefs/entities/events/cases/patterns）│
│ • 向量化（可语义搜索） │
│ • 智能去重（向量预过滤 + LLM 判断） │
│ │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│ Lossless-Claw 的记忆形成 │
│ │
│ 消息 → 达到阈值 → LLM摘要 → DAG构建 → 压缩 │
│ │
│ 特点: │
│ • 自动压缩（不需 LLM 判断） │
│ • 层次存储（L0/L1/L2） │
│ • 保留原文（DAG 可展开） │
│ • 时间衰减（Weibull 模型） │
│ │
└─────────────────────────────────────────────────────────────┘

3. 检索方式对比

┌─────────────────────────────────────────────────────────────┐
│ Memory-lancedb-pro 的检索 │
│ │
│ 查询 → 向量化 → 混合搜索 → 重排序 → 注入 │
│ │
│ 特点: │
│ • 语义相似度搜索 │
│ • BM25 全文搜索 │
│ • Cross-Encoder 重排序 │
│ • 显式记忆条目 │
│ │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│ Lossless-Claw 的检索 │
│ │
│ 查询 → 摘要展开 → 搜索摘要 → 展开原文 → 注入 │
│ │
│ 特点: │
│ • 基于摘要的搜索 │
│ • 可展开恢复原文 │
│ • 时间顺序保留 │
│ • 结构化记忆 │
│ │
└─────────────────────────────────────────────────────────────┘

🔗 统一性：互补关系

记忆层次模型

┌─────────────────────────────────────────────────────────────┐
│ │
│ 记忆金字塔 │
│ │
│ ▲ │
│ ╱ ╲ │
│ ╱ ╲ │
│ ╱ 核心╲ │
│ ╱ 记忆 ╲ │
│ ╱─────────╲ │
│ ╱ 工作记忆 ╲ │
│ ╱ (Working) ╲ │
│ ╱───────────────╲ │
│ ╱ 感知记忆 ╲ │
│ ╱ (Perceptual) ╲ │
│ ╱─────────────────────╲ │
│ │
│ Memory-lancedb-pro: 核心记忆 (长期、跨会话) │
│ Lossless-Claw: 工作记忆 (当前会话上下文) │
│ │
└─────────────────────────────────────────────────────────────┘

认知系统完整模型

┌─────────────────────────────────────────────────────────────┐
│ │
│ 完整的认知系统 │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 长期记忆 (Memory) │ │
│ │ • 用户偏好 │ │
│ │ • 项目历史 │ │
│ │ • 决策记录 │ │
│ │ • 实体关系 │ │
│ └─────────────────────────────────────────────────────┘ │
│ ▲ │
│ │ 提取 │
│ │ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 上下文 (Lossless-Claw) │ │
│ │ • 当前会话消息 │ │
│ │ • 对话历史 │ │
│ │ • 上下文摘要 │ │
│ │ • 任务状态 │ │
│ └─────────────────────────────────────────────────────┘ │
│ ▲ │
│ │ 接收 │
│ │ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 输入 (User Input) │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘

⚔️ 对立性：潜在冲突

场景1: 记忆重叠

用户说: "我用 tab 缩进，不要用空格"

┌─────────────────────────────────────────────────────────────┐
│ Memory-lancedb-pro 处理: │
│ • 提取为 "偏好" 记忆 │
│ • 存储为向量: [0.1, 0.2, ...] │
│ • 标签: preferences, coding-style │
│ │
│ Lossless-Claw 处理: │
│ • 原始消息存储 │
│ • 如果对话过长，压缩为摘要 │
│ • 保留在 DAG 中 │
│ │
│ 结果: │
│ • 两条相同信息的记录 │
│ • Memory 是结构化记忆 │
│ • LCM 是原始消息压缩 │
│ │
└─────────────────────────────────────────────────────────────┘

场景2: 检索冲突

用户问: "我上次说了什么？"

┌─────────────────────────────────────────────────────────────┐
│ Memory 检索结果: │
│ • 匹配到 3 条相关记忆 │
│ • 按相关性排序 │
│ │
│ LCM 检索结果: │
│ • 找到最近的对话摘要 │
│ • 可展开查看原文 │
│ │
│ 冲突: │
│ • 两个来源的 "上次" 可能不同 │
│ • Memory 的是结构化记忆 │
│ • LCM 的是原始对话压缩 │
│ │
└─────────────────────────────────────────────────────────────┘

🎯 统一性：协同关系

协同工作流程

┌─────────────────────────────────────────────────────────────┐
│ │
│ 协同工作流程 │
│ │
│ 用户输入 │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Phase 1: 上下文组装 (Lossless-Claw) │ │
│ │ • 加载当前会话摘要 │ │
│ │ • 组装最近消息 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Phase 2: 记忆注入 (Memory-lancedb-pro) │ │
│ │ • 检索相关长期记忆 │ │
│ │ • 注入用户偏好和历史 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Phase 3: LLM 处理 │ │
│ │ • 接收完整上下文 │ │
│ │ • 生成个性化回复 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ Phase 4: 记忆保存 │ │
│ │ • Lossless-Claw: 压缩消息到摘要 │ │
│ │ • Memory: 提取新记忆到向量库 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ 输出回复 │
│ │
└─────────────────────────────────────────────────────────────┘

互补优势

优势维度	Memory-lancedb-pro	Lossless-Claw	协同效果
跨会话	✅ 强	❌ 弱	Memory 补 LCM
上下文	❌ 弱	✅ 强	LCM 补 Memory
检索速度	✅ 快 (向量)	❌ 慢 (摘要)	Memory 补 LCM
信息保真	❌ 提取有损	✅ 压缩无损	LCM 补 Memory
结构化	✅ 强	❌ 弱	Memory 补 LCM

📊 选择建议

场景推荐矩阵

使用场景	推荐方案	原因
短期项目	Lossless-Claw 单独	上下文管理足够
长期项目	两者结合	跨会话记忆 + 上下文管理
个人助手	Memory 优先	学习用户偏好
团队协作	两者结合	共享知识 + 会话管理
客服系统	Memory 优先	记住客户历史
代码审查	LCM 优先	保留完整上下文
学术研究	两者结合	文献记忆 + 讨论管理

配置推荐

┌─────────────────────────────────────────────────────────────┐
│ 推荐配置方案 │
│ │
│ 方案1: 全功能 (推荐) │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ • Memory-lancedb-pro: 启用 │ │
│ │ • Lossless-Claw: 启用 │ │
│ │ • 配置: Jina + OpenAI │ │
│ │ • 效果: 最佳，但成本较高 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ 方案2: 经济版 │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ • Memory-lancedb-pro: 启用 (SiliconFlow 免费) │ │
│ │ • Lossless-Claw: 启用 │ │
│ │ • 配置: 简单模式 │ │
│ │ • 效果: 良好，成本低 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ 方案3: 本地优先 │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ • Memory-lancedb-pro: 启用 (Ollama) │ │
│ │ • Lossless-Claw: 启用 (本地模型) │ │
│ │ • 配置: 完全离线 │ │
│ │ • 效果: 取决于本地模型质量 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘

🎓 最佳实践

1. 避免重复存储

{
 "plugins": {
 "entries": {
 "memory-lancedb-pro": {
 "config": {
 "sessionMemory": { "enabled": false }
 }
 },
 "lossless-claw": {
 "config": {
 "ignoreSessionPatterns": ["agent:*:memory:*"]
 }
 }
 }
 }
}

2. 配置协作

┌─────────────────────────────────────────────────────────────┐
│ 协作配置 │
│ │
│ Memory: │
│ • 提取: 从 LCM 压缩后的摘要中提取 │
│ • 检索: 跨会话历史记忆 │
│ │
│ LCM: │
│ • 处理: 当前会话的消息压缩 │
│ • 排除: 避免压缩 memory 的自动提取过程 │
│ │
└─────────────────────────────────────────────────────────────┘

3. 性能优化

优化点	建议
嵌入模型	使用同一提供商，避免重复调用
向量库	共享 LanceDB 实例
配置	统一使用环境变量
监控	统一日志级别

📈 未来展望

统一架构可能性

┌─────────────────────────────────────────────────────────────┐
│ │
│ 统一记忆系统 (未来) │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 统一记忆层 │ │
│ │ • 跨会话记忆 (Memory) │ │
│ │ • 会话上下文 (LCM) │ │
│ │ • 统一检索接口 │ │
│ │ • 协同衰减机制 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │ │
│ ├─→ 向量存储层 │
│ ├─→ 摘要存储层 │
│ └─→ 元数据层 │
│ │
└─────────────────────────────────────────────────────────────┘

💬 总结

统一性

┌─────────────────────────────────────────────────────────────┐
│ │
│ 两者都是为了 让 AI "记住" 更多 │
│ 两者都使用 LLM 进行处理 │
│ 两者都追求 减少信息丢失 │
│ │
└─────────────────────────────────────────────────────────────┘

对立性

┌─────────────────────────────────────────────────────────────┐
│ │
│ Memory: 跨会话、显式捕获、向量存储 │
│ LCM: 单会话、连续压缩、DAG 存储 │
│ │
└─────────────────────────────────────────────────────────────┘

统一后的价值

┌─────────────────────────────────────────────────────────────┐
│ │
│ 两个插件结合 = 完整的认知系统 │
│ │
│ • 长期记忆 + 短期上下文 │
│ • 跨会话 + 单会话 │
│ • 结构化记忆 + 原始消息 │
│ • 语义搜索 + 摘要展开 │
│ │
└─────────────────────────────────────────────────────────────┘

🎯 最终建议

不要选择，而要组合。

Memory-lancedb-pro 和 Lossless-Claw 不是竞争关系，而是 认知系统的两个层次。

Memory-lancedb-pro = 外脑（跨会话的长期记忆）

Lossless-Claw = 内脑（单会话的上下文管理）

推荐：两者都启用，让 AI 助手拥有完整的记忆能力。

本文档创建于 2026-03-30

从零搭建Obsidian全栈知识系统

Mon, 06 Apr 2026 00:00:00 +0000

从零搭建 Obsidian 全栈知识系统：同步、博客、AI 一体化实战指南

核心理念

笔记不应该被困在一台设备里。 本文记录如何用一台云服务器，打通 Obsidian 的多端同步、自动博客发布、在线阅读、AI Agent 协作，构建一个完整的个人知识管理系统。

一、系统全景架构

1.1 整体架构图

┌─────────────────────────────────────────────────────────────────┐
│ Albert Intelligence 知识系统 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Windows │ │ iPhone │ │ Chrome │ │
│ │ Obsidian │ │ Obsidian │ │ Web Clip │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │
│ │ Remotely Save │ Remotely Save │ WebDAV │
│ │ (插件) │ (插件) │ │
│ └───────┬───────┘───────┬───────┘ │
│ │ │ │
│ ┌─────▼───────────────▼─────┐ │
│ │ 阿里云服务器 (Ubuntu) │ │
│ │ 47.250.14.82 │ │
│ │ │ │
│ │ ┌─────────────────────┐ │ │
│ │ │ Nginx WebDAV :18080│ │ ┌──────────────────┐ │
│ │ │ + fancyindex UI │──┼───→│ 浏览器在线阅读 │ │
│ │ │ + Markdown Viewer │ │ │ /_viewer/ │ │
│ │ └────────┬────────────┘ │ └──────────────────┘ │
│ │ │ │ │
│ │ ┌────────▼────────────┐ │ │
│ │ │ inotify 文件监听 │ │ │
│ │ │ (2秒防抖) │ │ │
│ │ └────────┬────────────┘ │ │
│ │ │ │ │
│ │ ┌────────▼────────────┐ │ │
│ │ │ Python 处理器 │ │ │
│ │ │ · 过滤 public:true │ │ │
│ │ │ · 转换 wikilinks │ │ │
│ │ │ · 注入 title/date │ │ │
│ │ └────────┬────────────┘ │ │
│ │ │ │ │
│ │ ┌────────▼────────────┐ │ ┌──────────────────┐ │
│ │ │ Hugo 静态站点生成 │──┼───→│ 公开博客 :18081 │ │
│ │ │ Stack 主题 │ │ │ 搜索/归档/标签 │ │
│ │ └─────────────────────┘ │ └──────────────────┘ │
│ │ │ │
│ │ ┌─────────────────────┐ │ │
│ │ │ Let's Encrypt SSL │ │ │
│ │ │ Certbot + DNS-01 │ │ │
│ │ │ (Cloudflare API) │ │ │
│ │ └─────────────────────┘ │ │
│ └───────────────────────────┘ │
│ │
│ ┌──────────┐ ┌──────────────┐ │
│ │ Claude │ │ Obsidian │ │
│ │ Code │◄──►│ Agent Client │ AI 协作层 │
│ │ (终端) │ │ (ACP 协议) │ │
│ └──────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘

1.2 技术栈一览

层级	组件	用途
客户端	Obsidian (Win/iOS)	笔记编辑器
客户端	Chrome + Obsidian Web Clipper	网页剪藏
客户端	Agent Client 插件	AI Agent 交互
同步层	Remotely Save 插件	WebDAV 双向同步
存储层	Nginx WebDAV	文件存储和访问
展示层	fancyindex + Viewer	在线浏览笔记
发布层	Hugo + Stack 主题	静态博客生成
自动化	inotify + systemd	文件变更监听和自动构建
安全层	Let’s Encrypt + Cloudflare	HTTPS 加密 + DNS 管理
AI 层	Claude Code + OpenCode	AI 辅助写作和开发

1.3 端口规划

端口	服务	域名	访问权限
18080	WebDAV + 在线阅读	obsidian.hialbert.online	Basic Auth (私密)
18081	Hugo 博客	blog.hialbert.online	公开访问
2026	SSH	—	密钥认证

二、核心数据流

2.1 写作 → 同步 → 发布流程

你在 Obsidian 写了一篇笔记
 │
 ▼
 在 frontmatter 加入 public: true
 │
 ▼
 Remotely Save 自动同步到阿里云 WebDAV
 (/var/www/webdav/obsidian/)
 │
 ▼
 inotify 检测到文件变化（2秒防抖）
 │
 ▼
 obsidian-to-hugo.sh 启动：
 ├─ 1. 清空 Hugo content/post/ 目录
 ├─ 2. 扫描所有 .md 文件
 ├─ 3. 过滤出 public: true 的文件
 ├─ 4. Python 处理器：
 │ ├─ 规范化 frontmatter
 │ ├─ 自动注入 title（从文件名）
 │ ├─ 自动注入 date（从 created 字段）
 │ ├─ 转换 wikilinks 为标准链接
 │ └─ 移除 !嵌入 语法
 └─ 5. 复制到 Hugo content/post/
 │
 ▼
 Hugo 构建静态站点 → /var/www/hugo-blog/public/
 │
 ▼
 博客自动更新 ✅
 https://blog.hialbert.online:18081/

2.2 下架文章的三种方式

方式	操作	效果
改为 `public: false`	修改 frontmatter	笔记保留，博客消失（推荐）
删除 `public` 字段	删掉那一行	笔记保留，博客消失
删除整篇笔记	Obsidian 里删除	笔记和博客都消失

💡 安全机制

同步脚本每次运行都会先清空再重建 Hugo 的文章目录。没有 public: true 标记的笔记绝对不会出现在博客上。

2.3 在线阅读流程（Markdown Viewer）

浏览器访问 fancyindex 文件目录
 │
 ▼
 点击 .md 文件（链接已被 JS 重写）
 │
 ▼
 跳转到 /_viewer/?file=Diary/领域/xxx.md
 │
 ▼
 viewer.html 加载：
 ├─ fetch GET 读取原始 .md 文件（只读，不修改原文件）
 ├─ 去掉 YAML frontmatter
 ├─ marked.js 渲染 Markdown → HTML
 ├─ highlight.js 代码高亮
 └─ 显示渲染后的页面
 │
 ▼
 工具栏：← 返回目录 | 📥 下载原文 | 🌙 深浅色切换

📌 只读保证

Viewer 只发 HTTP GET 请求，绝不会修改、删除、覆盖原始文件。你的 Obsidian 笔记安全无虞。

三、Obsidian Vault 目录结构

3.1 本地 Vault 结构

Diary/ ← Vault 根目录
├── .obsidian/ ← Obsidian 配置（插件、主题、快捷键等）
│ └── plugins/
│ ├── remotely-save/ ← WebDAV 同步插件
│ ├── obsidian-local-rest-api/ ← REST API 插件
│ ├── agent-client/ ← AI Agent 客户端插件
│ └── obsidian42-brat/ ← Beta 插件管理器
├── 收件箱/ ← 📥 临时笔记、快速捕捉
├── Clippings/ ← 📰 Chrome Web Clipper 剪藏
├── 领域/ ← 🎯 深度研究主题
│ ├── Obsidian多端同步搭建全记录.md
│ ├── Obsidian核心用法指南.md
│ ├── 大模型记忆与检索机制研究/
│ └── 新agent/
├── 收藏夹/ ← ⭐ 精选内容
├── 项目/ ← 📁 进行中的项目
├── 归档/ ← 🗄️ 已完成的内容
├── 永久笔记.md ← 📝 MOC 索引
└── MOC.md ← 🗺️ 全局地图

3.2 服务器端目录结构

/var/www/
├── webdav/obsidian/ ← WebDAV 同步根目录
│ └── Diary/ ← Vault 内容（与客户端实时同步）
│ ├── 收件箱/
│ ├── Clippings/
│ ├── 领域/
│ └── ...
├── hugo-blog/ ← Hugo 博客项目
│ ├── hugo.yaml ← Hugo 配置
│ ├── content/
│ │ ├── post/ ← 自动同步的博客文章（public: true）
│ │ ├── page/
│ │ │ └── search/ ← 搜索页面
│ │ ├── about/ ← 关于页面
│ │ └── archives/ ← 归档页面
│ ├── static/img/ ← 头像等静态资源
│ ├── themes/stack/ ← Stack 主题（Git submodule）
│ ├── layouts/_partials/ ← 主题覆写（sidebar 头像修复）
│ └── public/ ← Hugo 构建输出（Nginx 直接 serve）
└── obsidian-ui/ ← WebDAV 美化 UI
 ├── header.html ← fancyindex 页头（导航栏 + CSS）
 ├── footer.html ← fancyindex 页脚（.md 链接重写 JS）
 ├── viewer.html ← Markdown 在线阅读器
 └── avatar.jpg ← 头像（WebDAV UI 用）

四、功能模块详解

4.1 多端同步（Remotely Save + WebDAV）

原理： 每台设备上的 Obsidian 通过 Remotely Save 插件连接到同一个 WebDAV 服务器，实现双向增量同步。

配置要点：

# Remotely Save 插件设置
服务类型: WebDAV
地址: https://obsidian.hialbert.online:18080/obsidian/
用户名: obsidian
密码: ******
Depth Header: infinity

安全措施：

HTTPS 全链路加密（Let’s Encrypt 证书）
Basic Auth 身份验证
非标准端口 18080（避开常见扫描）
DNS-01 验证方式（无需开放 80 端口）

💡 冲突解决

Remotely Save 根据文件的修改时间戳判断版本新旧。如果两端同时修改同一文件，会保留最新的版本。建议一次只在一台设备编辑。

4.2 WebDAV 文件管理界面（fancyindex）

访问 https://obsidian.hialbert.online:18080/obsidian/ 即可看到 GitHub 风格的深色目录列表，特性包括：

📁 文件夹图标和 📝 Markdown 文件图标自动识别
🖼️ 图片、🎬 视频、🎵 音频文件类型图标
圆形头像 + “Personal Knowledge Base by Albert” 品牌展示
按名称、日期、大小排序
响应式布局，手机端也能用

4.3 Markdown 在线阅读器（Viewer）

点击任意 .md 文件即可在浏览器中渲染阅读，无需下载。

技术实现：

marked.js — Markdown → HTML 实时渲染
highlight.js — 代码块语法高亮（支持 Python、JavaScript、Bash 等）
纯前端 — 零后端依赖，不占服务器资源
只读 — 只发 GET 请求，绝不修改原文件

功能：

面包屑导航（obsidian / Diary / 领域 / xxx.md）
← 返回目录按钮
📥 下载原文按钮
🌙/☀️ 深浅色切换（localStorage 记忆）
自动剥离 YAML frontmatter
图片相对路径自动转换
wikilinks 和 !embeds 显示为行内代码

4.4 Hugo 静态博客（Stack 主题）

访问 https://blog.hialbert.online:18081/ 即可看到自动发布的博客。

博客特性：

🔍 全文搜索 — 侧栏搜索框，Fuse.js 模糊匹配
📂 分类和标签 — 自动从 frontmatter 提取
📅 归档 — 按时间线展示所有文章
🌗 深浅色切换 — 跟随系统或手动切换
📱 响应式 — 手机端完美适配
📖 目录导航 — 文章内自动生成 TOC
⏱️ 阅读时长 — 自动计算
🔗 RSS 订阅 — 支持全文 RSS

发布控制：

只需在 Obsidian 笔记的 frontmatter 中加一行：

---
public: "true" # 加这一行，文章自动发布到博客
---

不加或改为 false，文章只存在于你的私人 Vault 中。

4.5 自动构建管道（inotify + systemd）

┌──────────────┐ ┌───────────────┐ ┌──────────────┐
│ inotify │────→│ 防抖 2秒 │────→│ obsidian-to- │
│ 监听文件 │ │ 合并多次 │ │ hugo.sh │
│ 变更事件 │ │ 触发 │ │ 过滤+转换 │
└──────────────┘ └───────────────┘ └──────┬───────┘
 │
 ┌──────▼───────┐
 │ Hugo 构建 │
 │ 静态 HTML │
 └──────────────┘

systemd 保障：

Restart=always — 进程崩溃自动重启
RestartSec=5 — 5 秒后重启
开机自动启动
日志记录到 /var/log/obsidian-hugo.log

查看实时日志：

tail -f /var/log/obsidian-hugo.log

4.6 SSL 证书管理（Certbot + Cloudflare DNS-01）

为什么用 DNS-01 而不是 HTTP-01？

HTTP-01 需要开放 80 端口（安全风险）
DNS-01 通过 Cloudflare API 验证域名所有权，无需开放任何额外端口

证书信息：

域名	用途	证书路径
obsidian.hialbert.online	WebDAV	`/etc/letsencrypt/live/obsidian.hialbert.online/`
blog.hialbert.online	博客	`/etc/letsencrypt/live/blog.hialbert.online/`

自动续期： Certbot 自带 systemd timer，每 12 小时检查一次是否需要续期。

五、Chrome Web Clipper — 一键剪藏到 Obsidian

5.1 是什么？

Obsidian Web Clipper 是 Chrome 浏览器扩展，可以一键将网页内容保存为 Markdown 格式，直接存入 Obsidian Vault。

5.2 工作流程

在 Chrome 中浏览文章
 │
 ▼
 点击 Web Clipper 扩展图标
 │
 ▼
 选择保存模板（剪藏/书签/高亮）
 │
 ▼
 自动转换为 Markdown 格式
 │
 ▼
 保存到 Vault 的 Clippings/ 目录
 │
 ▼
 Remotely Save 同步到云端
 │
 ▼
 所有设备都能看到这篇剪藏 ✅

5.3 Frontmatter 自动生成

Web Clipper 剪藏的笔记会自动生成结构化的 frontmatter：

---
title: "文章标题"
source: https://原文链接
author: 作者名
published: 2026-04-01
created: 2026-04-06T13:26:35+08:00
tags:
 - 状态/收件箱
 - 来源/文章
 - 主题/
---

💡 配合 Inbox 工作流

剪藏的文章默认打上 状态/收件箱 标签，提醒你稍后阅读和整理。处理完后改为 状态/完成 并移动到对应的领域文件夹。

六、AI 协作层 — Agent Client + Claude Code

6.1 Agent Client 插件

Agent Client 插件通过 Agent Client Protocol (ACP) 将 AI Agent（如 Claude Code、Codex、Gemini CLI）引入 Obsidian，实现直接在编辑器中与 AI 对话。

核心功能：

@笔记引用 — 在对话中用 @笔记名 引用 Vault 中的笔记内容
图片粘贴 — 直接拖拽图片到对话框
斜杠命令 — 使用 / 调用 Agent 提供的命令
多 Agent 切换 — 同时运行 Claude Code、Codex 等
会话历史 — 恢复或分叉之前的对话
导出为笔记 — 将对话保存为 Markdown

安装方式：

先安装 BRAT 插件（Beta 插件管理器）
BRAT → Add Beta Plugin → 粘贴 https://github.com/RAIT-09/obsidian-agent-client
启用 Agent Client

6.2 Local REST API 插件

让外部程序（如 Claude Code、脚本）通过 HTTP API 操控 Obsidian。

API 端点：

端点	方法	用途
`/vault/`	GET	列出 Vault 根目录文件
`/vault/{path}`	GET	读取指定文件内容
`/vault/{path}`	PUT	创建或更新文件
`/vault/{path}`	DELETE	删除文件
`/vault/{path}`	PATCH	追加内容到文件

示例 — 用 curl 读取笔记：

curl http://127.0.0.1:27123/vault/领域/Obsidian核心用法指南.md \
 -H "Authorization: Bearer YOUR_API_KEY" \
 -H "Accept: text/markdown"

示例 — 用 curl 创建笔记：

curl -X PUT http://127.0.0.1:27123/vault/收件箱/新笔记.md \
 -H "Authorization: Bearer YOUR_API_KEY" \
 -H "Content-Type: text/markdown" \
 -d "# 新笔记标题

这是正文内容。"

6.3 Claude Code + Obsidian 联动

Claude Code（终端 AI 助手）可以通过 Local REST API 直接与 Obsidian 交互：

用户在终端对 Claude Code 说：
 "在 Obsidian 里面创建一篇关于 XXX 的笔记"
 │
 ▼
 Claude Code 调用 REST API：
 PUT /vault/领域/XXX.md
 Content-Type: text/markdown
 Body: 生成的 Markdown 内容
 │
 ▼
 笔记立即出现在 Obsidian 中 ✅
 │
 ▼
 Remotely Save 同步到所有设备
 │
 ▼
 如果 frontmatter 包含 public: true
 → 自动发布到博客 🚀

📝 实际使用体验

本文就是通过 Claude Code 调用 Obsidian REST API 直接创建的——写作、保存、同步、发布，全链路自动化。

七、安全架构

7.1 多层安全防护

Internet
 │
 ▼
┌───────────────────┐
│ Cloudflare DNS │ DNS 层：隐藏真实 IP（Proxy 模式可选）
└────────┬──────────┘
 │
┌────────▼──────────┐
│ 阿里云防火墙 │ 网络层：只开放 18080、18081、2026
└────────┬──────────┘
 │
┌────────▼──────────┐
│ Let's Encrypt SSL │ 传输层：TLS 1.2/1.3 加密
│ (DNS-01 验证) │ 无需开放 80 端口
└────────┬──────────┘
 │
┌────────▼──────────┐
│ Nginx Basic Auth │ 应用层：用户名密码认证
│ (.htpasswd) │ WebDAV 和 Viewer 都受保护
└────────┬──────────┘
 │
┌────────▼──────────┐
│ SSH Key Only │ 管理层：仅密钥登录，禁用密码
│ (Port 2026) │ 非标准端口
└───────────────────┘

7.2 公私分离设计

内容	访问方式	认证
全部 Vault 笔记	WebDAV (:18080)	Basic Auth 必须
在线阅读 Viewer	/_viewer/ (:18080)	Basic Auth 必须
博客文章 (public: true)	Hugo (:18081)	无需认证，公开
博客搜索	/search/ (:18081)	无需认证，公开

核心原则：私密笔记永远不会意外暴露。 只有你明确标记 public: true 的文章才会通过 Hugo 发布到公开博客。

八、核心配置文件速览

8.1 Nginx 配置（双域名双端口）

# WebDAV + 在线阅读
server {
 listen 18080 ssl;
 server_name obsidian.hialbert.online;

 location /_viewer/ {
 # Markdown 在线阅读器（Basic Auth 保护）
 }

 location /obsidian/ {
 # WebDAV 文件同步
 dav_methods PUT DELETE MKCOL COPY MOVE;
 dav_ext_methods PROPFIND OPTIONS;
 fancyindex on;
 }
}

# Hugo 博客
server {
 listen 18081 ssl;
 server_name blog.hialbert.online;
 root /var/www/hugo-blog/public;
}

8.2 Hugo 配置（核心参数）

baseURL: "https://blog.hialbert.online:18081/"
title: "Albert Intelligence"
theme: "stack"
defaultContentLanguage: "zh"

params:
 sidebar:
 subtitle: "Knowledge, AI & Life"
 avatar: "/img/avatar.jpg"
 widgets:
 homepage:
 - type: search  # 全文搜索
 - type: archives  # 归档
 - type: categories  # 分类
 - type: tag-cloud  # 标签云

8.3 发布控制（frontmatter 标记）

---
tags:
 - 类型/永久笔记
 - 主题/Obsidian
created: 2026-04-06
public: "true" # ← 这一行控制是否发布
---

九、已安装的 Obsidian 插件清单

插件	用途	必要性
Remotely Save	WebDAV 多端同步	必须
Local REST API	外部程序控制 Obsidian	推荐（AI 协作必需）
Agent Client	在 Obsidian 内使用 AI Agent	可选（提升效率）
BRAT	安装 Beta 插件	可选（Agent Client 依赖）
Obsidian Web Clipper	Chrome 网页剪藏	推荐

十、常见问题 FAQ

Q1: 同步冲突怎么办？

Remotely Save 以最后修改时间为准。建议同一时间只在一台设备上编辑。如果发生冲突，可以在 Remotely Save 设置中查看同步日志。

Q2: 博客文章标题/日期显示异常？

确保 frontmatter 中包含 title 和 date（或 created）字段。同步脚本会自动从文件名和 created 字段注入，但手动指定更可靠：

---
title: "你的文章标题"
date: 2026-04-06
---

Q3: SSL 证书过期了怎么办？

Certbot 会自动续期。如果手动续期：

certbot renew --dns-cloudflare \
 --dns-cloudflare-credentials /etc/letsencrypt/cloudflare/credentials.ini

Q4: 在线阅读器会修改我的笔记吗？

绝对不会。 Viewer 只发 HTTP GET 请求读取文件，渲染过程完全在浏览器端完成。服务器上的 .md 文件纹丝不动，不会影响任何设备的 Obsidian 同步。

Q5: 服务器配置要求？

最低 1 核 1G 就够用。当前使用阿里云 2 核 2G（马来西亚），内存占用约 445MB（28%），磁盘 3.4G/40G（10%），非常轻量。

Q6: 这套系统的运行成本？

项目	费用
域名 (.online)	¥7/年（首年）
阿里云服务器	视套餐而定
SSL 证书	免费（Let’s Encrypt）
Cloudflare DNS	免费
Hugo + Stack 主题	免费开源
Obsidian 客户端	免费
所有插件	免费

十一、未来可扩展方向

Excalidraw 支持 — 在线渲染手绘图
评论系统 — 博客接入 Giscus (GitHub Discussions)
图床 — 将笔记中的图片上传到 CDN
全文搜索增强 — 在 WebDAV 端也加搜索功能
移动端 PWA — 博客添加 manifest.json 支持离线访问
自动备份 — 定期将 Vault 备份到 S3 或 OSS
Graph View 在线版 — 用 D3.js 渲染 Vault 的关系图谱

十二、总结

这套系统的核心理念是 “写一次，到处用”：

写 — 在任意设备的 Obsidian 中写笔记
同步 — Remotely Save 自动同步到云端
阅读 — 浏览器在线阅读，无需安装 Obsidian
发布 — 加一行 public: true 自动变成博客
剪藏 — Chrome 一键保存网页到 Vault
AI — Claude Code 直接读写你的笔记

所有环节都是自动化的。 你只需要专注于一件事——写好你的笔记。

Quote

“The best note-taking system is the one you actually use.” 最好的笔记系统，是你真正会用的那个。

本文由 Claude Code 通过 Obsidian Local REST API 自动创建，写作 → 保存 → 同步 → 发布，全链路自动化。

Obsidian核心用法指南

Sun, 05 Apr 2026 00:00:00 +0000

Obsidian 核心用法指南

一句话定位

Obsidian 不是用来「存笔记」的，是用来「连接想法」的。标签帮你分类，链接帮你思考。

一、标签 `#tag` — 分类与筛选

基础用法

在正文任意位置加 # 即可打标签：

今天读了一篇关于记忆的论文 #读书笔记 #认知科学

嵌套标签（推荐）

用 / 建立层级结构，便于管理大量笔记：

#主题/AI/大模型
#状态/收件箱
#状态/完成
#来源/书籍
#类型/永久笔记

Frontmatter 写法（更规范）

---
tags:
 - 主题/Obsidian
 - 状态/完成
 - 来源/实践
---

💡 实用场景

左侧「标签」面板点击 #状态/收件箱，瞬间列出所有待处理笔记。相当于一个动态收件箱，不用手动整理文件夹。

二、双向链接 `[[]]` — 建立连接与图谱

基本语法

今天学习了 间隔重复 的原理，和 费曼学习法 有很多相通之处。

图谱连线规则

只要有一篇笔记写了 间隔重复，图谱里就会出现连线：

笔记A ——连线—— 间隔重复

被链接的笔记甚至可以不存在（虚链），图谱里依然有连线。

多篇笔记共同链接一个概念

笔记A 写了 间隔重复
笔记B 也写了 间隔重复

图谱效果：

笔记A ——— 间隔重复 ——— 笔记B

这就是 Obsidian 图谱的魅力

你能一眼看出哪些笔记围绕同一个概念展开，发现你自己都没意识到的知识关联。

链接变体语法

写法	效果
`笔记名`	基础链接
`显示别名`	链接但显示不同文字
`笔记名`	链接到指定标题
`笔记名^块ID`	链接到指定段落块

三、标签 vs 链接 — 核心区别

对比项	标签 `#`	链接 `[[]]`
作用	分类、筛选	建立关联
图谱连线	❌ 不会	✅ 会
使用场景	「这是什么类型的笔记」	「这篇笔记和谁有关」
典型例子	`#状态/收件箱`	`费曼学习法`

实际写法示例
今天读了《刻意练习》#读书笔记 #主题/学习方法

书中的核心观点和 间隔重复 高度契合，
作者 Anders Ericsson 认为……
标签说明「这是一篇读书笔记」

链接说明「这篇笔记和间隔重复、作者有关联」

四、其他实用语法

任务清单

- [ ] 待办事项
- [x] 已完成
- [/] 进行中（部分主题支持）

效果：

整理《刻意练习》摘要
搭建 WebDAV 同步
建立间隔重复复习系统

高亮块 / Callout

> [!note] 普通笔记
> 内容

> [!tip] 小技巧
> 内容

> [!warning] 注意
> 内容

> [!important] 重要
> 内容

> [!question] 疑问
> 内容

💡 常用类型速查

note tip warning important question example quote info success failure

嵌入笔记 `![[]]`

!Obsidian多端同步搭建全记录

直接把另一篇笔记的内容嵌入当前笔记，不是跳转，是「内联显示」。

💡 用途

做「MOC（内容地图）」笔记时非常有用，把多篇子笔记聚合在一页浏览。

块引用 `^`

在段落末尾加 ^块ID 来标记：

间隔重复是一种利用遗忘曲线的记忆方法。^spaced-rep-def

然后在其他笔记中精确引用这一段：

间隔重复

五、关系图谱操作入门

💡 3 步打开图谱

快捷键 Ctrl + G（全局图谱）

右上角命令面板 Ctrl + P → 搜索「图谱」

当前笔记的「本地图谱」在右侧面板

让图谱有意义的关键

图谱空洞的原因通常是：笔记之间没有 链接

从今天开始的行动：

打开任意一篇笔记
找到一个概念名词，用 [[]] 包起来
按 Ctrl + G 看图谱里是否出现了连线

六、推荐的标签体系（参考）

#类型/永久笔记 ← 经过加工的成熟想法
#类型/文献笔记 ← 读书/看视频的摘要
#类型/闪念笔记 ← 随手记的想法，待加工

#状态/收件箱 ← 待处理
#状态/完成 ← 已整理

#主题/学习方法
#主题/AI
#主题/Obsidian

#来源/书籍
#来源/视频
#来源/实践