第二大脑操作系统 · 详细使用指南 v2.0.0

一句话:你只管「丢素材」和「说任务」,系统替你记、连、长、清——每一次输入变资产,每一次输出驱动下一次迭代。
本文档是 second-brain-os 技能的完整说明书,照着用即可,不懂术语看文末「术语表」。

目录
  1. 这是什么(为什么你需要它)
  2. 系统全景(组件 + 数据流)
  3. 八阶闭环详解(每一阶怎么做)
  4. 知识卡片格式(完整模板 + 真机样例)
  5. 加载分层与生命周期管理
  6. 变异类型详解(效率/能力/网络)
  7. 命令速查大全(flywheel.py 全部命令)
  8. 与其他系统的集成
  9. 端到端实战演练(三个剧本)
  10. 日常配置建议
  11. 故障排查与 FAQ
  12. 术语表(代码小白白话注解)

一、这是什么(为什么你需要它)

你的第二大脑不是笔记软件、不是收藏夹。笔记软件只会越存越乱、越久越找不到;收藏夹是「存了等于读了」的错觉。

对比收藏夹 / 笔记软件第二大脑操作系统(飞轮)
输入存进去就完了丢进去后会被「编译」成干净知识卡片
检索靠关键词翻找任务启动自动查历史,复用旧路径
成长静止的每次任务后自动沉淀 + 变异,越用越聪明
过期永远堆着有保质期,过期自动归档但保留原文(不删)
连接孤立知识互相双链,可视化成「星链」

三大铁律(高于一切):

  1. 知识有保质期 —— 每张卡片有 保质期,过期必须标记、可替代,但不删除。
  2. 加载有分层 —— 知识分热/温/冷,检索优先热层,冷层只读不主动调起。
  3. 旧知识不被删除,只被覆盖/关联 —— 冲突观点用 替代 双链指向新卡片,原文保留。

二、系统全景(组件 + 数据流)

2.1 组件一览

<ROOT> 是什么:你的知识库根目录。默认 ~/second-brain-os-data(即用即建)。也可用任意命令的 --root <路径> 或环境变量 SECOND_BRAIN_ROOT 临时指定。
部件路径你该怎么对待
原始素材层/rw/只往里丢,AI 不修改,像收件箱
AI 编译知识层(知识库本体)/wiki/按主题归档的「干净知识卡片」,带生命周期字段
读书脑图/读书脑图/每本书一张可缩放/点击的交互式思维导图 HTML
星链图workbench/star-chain.html(工作台「🌌 第二大脑星链」)知识宇宙可视化:主脑居中、领域大球环绕、可拖拽牵拉
飞轮账本/compound/变异/沉淀/生命周期快照/八阶流水(loop_log),证明你在复利
工作台/workbench/index.html入口门户,聚合星链、AI 学习等可视化面板

2.2 首次运行后的状态示例(供对照)

以下为一份典型 status 输出的样子,主题名仅为示例,你的实际目录因人而异。

2.3 数据流

     你丢素材                你下任务
        │                      │
        ▼                      ▼
   [① 采集] rw/          [② 检索] 查 compound/cases.json(复用旧路径)
        │                      │
        │                      ▼
        │                 [③ 执行] 多AI协作Loop / 动态议事厅
        │                      │
        ▼                      ▼
   [编译] → wiki/ 知识卡片  [④ 沉淀] 写 wiki/ + 记 cases.json
                                  │
                                  ▼
                          [⑤ 复盘] 能力六芒星 + 质量趋势
                                  │
                                  ▼
                          [⑥ 变异] 强制打标→ mutations.json
                                  │
        ┌─────────────────────────┘
        ▼
   [⓪ 日更] 每日扫 wiki/ 卡片 → 刷新分层 → lifecycle.json
        │
        ▼
   [⑦ 清理] 过期卡标记归档(保留原文+替代双链)
        │
        ▼
   [星链] build_star_chain.py 重建可视化(知识长出来、连起来)

三、八阶闭环详解(每一阶怎么做)

顺序固定、不可省略。你在 ①采集 和 ③执行 出手,其余阶飞轮自动转。

⓪ 日更(Daily)

① 采集(Collect)

② 检索(Retrieve)

③ 执行(Execute)

④ 沉淀(Deposit)

⑤ 复盘(Review)

⑥ 变异(Mutate)⚠️ 强制

⑦ 清理(Cleanup)

四、知识卡片格式(完整模板 + 真机样例)

每张知识卡片 = YAML 前台(给机器读的元数据)+ Markdown 正文(给人读的概念)。

4.1 推荐 v2 格式(带生命周期字段)

---
title: 概念名
source: "[[rw/原始文件]]"          # 或 "[[读书脑图/书名]]",溯源用
created: 2026-07-17
tags: [标签1, 标签2]
related: [[相关页面]]
保质期: 2026-12-31                # 或写 "长期有效"
置信度: 5                          # 1~5 星整数
最后更新: 2026-07-17
替代: 新概念名                     # 可选;有冲突/更新时指向替代卡片
status: 活跃                       # 活跃|临期|沉淀|已归档(日更/清理自动维护,一般别手填)
---

# 概念名
**定义**:一句话说清是什么
**场景**:什么时候会用到它
**动作**:可执行的具体步骤
**关联**:[[双链]]
**保质期**:2026-12-31(或"长期有效")
**置信度**:⭐⭐⭐⭐⭐
**最后更新**:2026-07-17
**替代/补充观点**:[[新概念名]](若有冲突)
白话:YAML 前台那几个同名字段(保质期/置信度/最后更新/替代/status)是给 daily/cleanup 机器扫的;正文里再写一遍是给你自己一眼看懂。两者保持一致即可。

4.2 字段填写说明

字段怎么填作用
title概念名卡片标题、双链锚点
source[[rw/...]] 或 [[读书脑图/...]]溯源:这张卡从哪来
created首次建立日期冷层判定的辅助
tags标签数组检索归类
related[[页面名]]跨卡双链
保质期日期 或 长期有效过期判定核心
置信度1~5热层判定(≥4 才进热层)
最后更新日期热/温/冷分层核心
替代新概念名冲突/更新时指向新版(不删旧)
status别手填日更/清理自动写

4.3 真机样例(现有卡片风格)

当前知识库里可已有 Obsidian 风格卡片(如 wiki/ai-learning/某领域每日洞察.md),采用「追更日志 + 概念索引 + 跨源双链」结构,不带 YAML 前台也能被识别为知识卡(靠正文 定义 或标题判定)。两种格式系统都兼容,新卡建议用 4.1 的 v2 格式以启用生命周期管理。

五、加载分层与生命周期管理

daily 按下面规则给每张卡打分层,status 自动维护。检索时优先热层。

5.1 分层判定规则

层图标判定条件检索行为
热层🔥未过期 且 最后更新 ≤30天 且 置信度≥4优先调起、主动关联
温层🌤未过期,但更新 30~90天 或 置信度 2~3正常检索命中即取
冷层❄未过期,但最后更新 >90天(沉淀未维护)仅显式点名才调,提示「可能过时」
过期🪦保质期 < 今日 且 ≠ 长期有效标记已归档,经 替代 双链导向新版,不主动呈现
临期:保质期剩 <30 天的卡,即使热层也会被降为温层并提示「临期」。

5.2 日更如何刷新

跑 daily 时:

5.3 清理如何归档(保留不删)

跑 cleanup 时:

5.4 冲突观点怎么处理

两个观点打架时,不删旧、不覆盖,而是:

  1. 旧卡 替代: [[新概念名]];
  2. 新卡正文写「补充/替代观点见 [[旧概念名]]」;
  3. 两者经双链互指,检索任一方都能跳到另一方。

六、变异类型详解(强制,但你可指定)

每次飞轮收尾必须打标签。三选一或组合(逗号分隔,至少一种)。

类型触发信号真实例子
效率「更快了」「少步骤了」「自动化了」把周报生成脚本化;把 sync.py 做成定时任务;模板化某类报告
能力「以前做不了,现在能了」学会用 VideoGen 出真视频;掌握动态议事厅多专家调度;接入新模型
网络「连起来了」「能互相引用了」星链生长让两主题互链;技能编排串联多个 Skill;跨项目复用案例
组合示例:--type 效率,网络(既提速又打通连接)。当前账本里就有一条 效率+网络 的变异(星链同步时把构建脚本与增强渲染器对齐,防重跑丢交互)。

七、命令速查大全(flywheel.py v2.0.0)

脚本位置:你的技能目录/second-brain-os/scripts/flywheel.py
账本根目录默认 ,可用 --root <路径> 覆盖(自测沙箱时用)。

7.0 search —— ② 检索复用(内置零依赖)

python flywheel.py search --keyword "知识管理" [--root <ROOT>]

7.1 daily —— ⓪ 日更

python flywheel.py daily [--root ]

7.2 cleanup —— ⑦ 清理

python flywheel.py cleanup [--root ...] [--path wiki/x/《旧》.md] [--superseded-by "新概念名"]

7.3 mutate —— ⑥ 变异(类型强制)

python flywheel.py mutate --type 效率 --action "把周报生成脚本化" --detail "防重跑丢模板" --task "周报自动化"
参数必填说明
--type✅效率/能力/网络,可逗号组合,非法值直接报错退出
--action推荐做了什么变异
--detail可选细节/背景
--task可选关联任务名

7.4 deposit —— ④ 沉淀

python flywheel.py deposit --request "周报自动化" --skills second-brain-os --summary "..." --score 95
参数必填说明
--request✅任务/需求描述
--skills可选用到的技能名(空格分隔多个)
--summary可选结果摘要
--score可选质量分 0~100,默认 100

7.5 log —— 八阶流水任意一笔

python flywheel.py log --stage retrieve --note "命中案例 case_xxx"

7.6 status —— 总览

python flywheel.py status [--root ...]

实测输出样例:

🧠 第二大脑操作系统 v2.0.0 · 变异分布
========================================
   变异总数: 1
   效率: 1 次
   能力: 0 次
   网络: 1 次
   沉淀案例总数: 0

📅 生命周期快照(最后日更: 2026-07-17)
   热层: 0 张
   温层: 6 张
   冷层: 0 张
   过期: 0 张

7.7 账本文件一览(compound/)

文件内容
mutations.json变异记录(强制类型)
cases.json沉淀记录(指令→技能→结果)
lifecycle.json卡片生命周期快照(daily 产出)
loop_log.md每次 Loop 的八阶执行流水

八、与其他系统的集成

系统怎么连
多 AI 协作 Loop飞轮前置挂载(AI-1 前先检索)+ 后置挂载(AI-3 后沉淀→复盘→变异→清理)
动态议事厅复杂议题走无领导小组讨论,结论沉淀进 wiki/ 并跑飞轮
工作台星链workbench/build_star_chain.py 扫描各主题子库 + wiki/ 生成图谱;跑完飞轮后重建即可见知识生长
技能编排交付(可选)②检索复用已内置 flywheel.py search;装此 Skill 后可做跨 Skill 全局检索增强 + ④沉淀归档
快速阅读 SKILL读书 → 脑图 HTML → 编译进 wiki/<主题>/ → 跑 build 长进星链
能力六芒星ai-learning/capability_assessment.py 给 ⑤复盘 提供量化趋势

关键路径速查:

九、端到端实战演练

剧本 A · 精读一本书(最常用,从说到星链)

你:精读《置身事内》
系统:搜书 → 拆结构 → 出脑图 HTML → 分级「历史/经济」→ 入库 wiki/ → 跑 build_star_chain.py
你得到:一张可反复看的脑图 + 星链里对应知识库大球变大
收尾:飞轮自动 deposit + mutate(本次属「能力/网络」复利)

剧本 B · 交一个报告任务(检索复用 → 执行 → 沉淀变异)

你:帮我做一份「行业复盘 + 趋势」分析视频脚本
系统:② 先在 cases.json 搜「行业 复盘」→ 命中旧案例复用结构
     → ③ 走多AI协作Loop生成脚本
     → ④ deposit 记案例
     → ⑤ 看六芒星
     → ⑥ mutate --type 效率,网络(脚本模板化 + 跨项目复用)
你得到:比从零快一倍的脚本 + 下次同类任务直接复用

剧本 C · 发现知识过期(日更报警 → 清理归档 → 替代链接)

定时任务跑 daily → 终端提示:⚠️ 过期卡片:wiki/economics/《旧模型评测》.md(替代: 未指定)
你:python flywheel.py cleanup --path wiki/economics/《旧模型评测》.md --superseded-by "新模型评测2026"
结果:旧卡 status=已归档,原文保留,顶部加溯源提示,双链指向新卡;检索时旧卡不再主动呈现,但点名可溯源

十、日常配置建议

10.1 把日更挂成每日定时任务(推荐)

在 WorkBuddy 建一个每日定时任务,命令等价于:

python 你的技能目录/second-brain-os/scripts/flywheel.py daily
频率:每天一次,例如 09:00。这样分层永远新鲜,过期卡不漏网。

10.2 复盘节奏

10.3 让飞轮越转越快的 6 条心法

  1. 采样即丢:看到好东西立刻丢 rw/,整理交给 AI。
  2. 读书必走精读:自动进星链,知识看得见连得上。
  3. 任务前给关键词:带领域词,检索更准。
  4. 每周看一次 status:偏了就调投入方向。
  5. 别怕重复:飞轮靠「重复 + 变异」迭代,同一类任务做第二遍自动比第一遍快。
  6. 信任强制标签:变异类型是能力成长唯一刻度。

十一、故障排查与 FAQ

Q:我丢进 rw/ 的东西什么时候会被处理?
A:你主动说「把 rw/ 里的 XX 编译成知识」时;或读书/任务中被引用时。AI 不会擅自改 rw/ 原始文件。

Q:星链图里看不到我新加的书/卡?
A:跑一次 python workbench/build_star_chain.py 重建(已修过模板,重跑不丢交互效果)。

Q:变异标签打错了能改吗?
A:mutations.json 是追加式账本,改需手动编辑该文件。打错不影响运转,只是统计略偏——打前想清类型。

Q:daily 把我的卡 status 改了,会不会动我正文?
A:daily 只改 YAML 前台的 status 字段,不动正文。cleanup 仅在过期卡正文顶部追加一行溯源提示,原文保留。

Q:飞轮会拖慢我交任务吗?
A:检索/沉淀/变异都是轻量本地操作(毫秒~秒级),几乎无感。换来下次同类任务直接复用,总体更快。

Q:知识卡一定要 YAML 前台吗?
A:不强制。系统靠「有 title 前台」或「正文含『定义』」识别知识卡。但只有带生命周期字段的卡才能被 daily/cleanup 分层管理,新卡建议用 v2 格式。

Q:compound/ 文件损坏了怎么办?
A:ensure_json 会在文件缺失/损坏时自动重建为默认空结构,不会崩。损坏仅丢失历史统计,不影响知识库本体。

十二、术语表(代码小白白话注解)

术语白话解释
飞轮这套第二大脑系统,像转轮一样转一圈就积累一次,越转越快
复利这次的成果变成下次的地基,雪球越滚越大(不是利滚利那种钱,是能力/知识滚雪球)
双链知识卡片之间互相「@」引用,点一个能跳到另一个,像网页超链接
YAML 前台卡片最上方 --- 包裹的那块机器可读的「标签信息」(保质期/置信度等),人不用细看
置信度你对这张卡内容有多确定,1~5 星;越高越值得优先用
星链把知识画成「宇宙图」:主脑居中、各领域是大球、卡片是节点,连线就是关系
挂载点飞轮「插」在多 AI 协作流程的哪个位置(任务前先检索=前置挂载,任务后沉淀=后置挂载)
生命周期一张知识卡从建立→活跃→临期→过期归档的整个过程
已归档过期卡被打上的状态:不主动显示,但原文留着、能溯源,不是删除
rw/raw 原始素材文件夹,你只丢不删,AI 不改动
wiki/知识库本体文件夹,AI 把素材编译成的干净知识都在这里
compound/复利账本文件夹,记录你所有的变异/沉淀/流水,证明在成长
六芒星能力评估雷达图(6 个维度),用来复盘你能力增长趋势
动态议事厅多个 AI 专家无领导小组讨论的功能,复杂议题用它碰撞
SkillWorkBuddy 里的「技能包」,封装好一套专用能力,飞轮本身就是一个 Skill

本指南随 Skill second-brain-os 一起维护。飞轮越用越聪明——先丢一个素材、精读一本书试试。
版本:v2.0.0 · 最后更新:2026-07-17