使用说明

这份文档写给日常使用这个第二大脑的你。目标是让记录、整理、回顾尽量顺手，而不是把知识库维护成一份额外工作。

日常捕捉

不同入口各司其职：

• 临时想法、随手片段、本地材料：先放 Notion。
• 看文章时只想摘几句、记一点灵感：先放 Notion。
• 当天经历、心情、流水账：先放 Notion 或临时记录。
• 已经确定有长期价值的方法、概念、案例：直接进入对应主题目录（AI/、个人成长/ 等）。

不要在捕捉阶段追求完美分类。先留下来，再整理。

正式笔记

正式笔记进入对应主题目录（AI/、个人成长/ 等），使用 templates/正式笔记模板.md。

需要 AI 帮你判断目录、补充正文或从材料整理时，直接说：

新建正式笔记：标题《...》，类型 practice，主题 AI实践技巧，来源 ...

如果自己手动创建，至少保留这些字段：

---
type:
status: seed
tags: []
source:
created:
updated:
---

正文优先写清楚三件事：

• 这是什么。
• 对我有什么用。
• 下次我怎么复用。

Notion 到本地的升格

Notion 只做轻量捕捉，不要求每条都搬到本地。

当同一主题的 Notion 碎片足够多时，再让 AI 整理：

整理主题笔记：把下面这些 Notion 碎片整理成《主题名》，保留关键原话，提炼我的观点，生成一篇可读的长期笔记。

整理时要区分：

• 原文摘录：别人说了什么。
• 我的理解：我怎么看。
• 可复用方法：以后怎么用。
• 待验证问题：哪里还不确定。

Obsidian 怎么用

Obsidian 主要用于看笔记、查笔记和建立连接。

推荐习惯：

• 打开 Obsidian 时先看 README.md。
• 用全局搜索找主题，而不是强迫自己记目录。
• 对核心概念使用 [[双链]]，比如 [[Harness Engineering]]、[[Claude Code]]。
• 只给真正值得回看的概念和主题加链接，不追求密集链接。
• 用 Properties 查看 type、status、tags。

周整理

每周花一小段时间做轻整理：

• 看 Notion 最近是否有同主题碎片积累。
• 给正式笔记补齐元数据。
• 把明显已完成、过时或只剩历史价值的内容标记为 archived。
• 从本周记录中提炼 1-3 条真正有复用价值的经验。

月体检

每月让 AI 帮你扫一次仓库：

请按 docs/HARNESS.md 对这个知识库做月度体检：找重复主题、命名混乱、孤立笔记、过期信息、值得升格的材料，以及可能误提交的敏感内容。

月体检不是为了把仓库变完美，而是为了防止它慢慢变成杂物间。

私有站点（jacky-brain-site）

笔记的只读网页版，托管在 ../jacky-brain-site（Quartz 5），Cloudflare Access 邮箱墙保护，只有你能看。

动线是全自动的，你唯一要做的事就是照常写笔记、push：

写笔记 → git push → GitHub Actions 同步 → CF Pages 自动构建 → 网站更新

• 站点内容 = 全库减去排除清单（.skillshare/、templates/、private/、配置目录）。
• 派生页由 CI 自动生成：首页、仪表盘/Skills 一览，不含技能源码。
• 想看最新构建状态：gh run list --workflow sync-site。
• public/ 是未来公开分享的白名单目录，默认空。
• 每周日 12:00 自动化会产出周报 + 「本周知识库看点」，周报在 复盘计划/2026/周复盘/。

同步和隐私

• GitHub 只做私有同步和版本记录。
• 敏感材料放 private/，不要提交。
• 账号、密钥、cookie、token、私人聊天原文不要进入仓库。
• 不确定能否提交时，默认先放 private/ 或询问 AI 做隐私检查。