第二大脑

一个个人知识库，用于构建随时间复利增长的理解力。它不是笔记堆砌——而是一套结构化的系统，用于捕获你真正能检索并加以运用的知识。

理念

你的第二大脑应当：

• 捕获理解，而非仅记录事实——为将来可能遗忘上下文的自己而写
• 具备可检索性——结构清晰，确保你在需要时能快速找到相关内容
• 保持常青（Evergreen）——不包含私人信息、凭据或时效性强的数据
• 反映真实经验——只保存你真正学习过或实际使用过的内容

保存前请自问：未来的我，会感谢现在的我保存了这个吗？

命名空间结构

public/                           --> 可共享的知识
  concepts/                       --> 原理与机制
    [domain]/                     --> 按主题组织
      [concept-name]              --> 单个概念
  toolbox/                        --> 工具与技术
    _index                        --> 工具总索引
    [category]/                   --> 按类型分组
      [tool-name]                 --> 单个工具
  patterns/                       --> 可复用的解决方案
    [domain]/                     --> 设计模式、工作流等
  references/                     --> 快查资料
    [topic]/                      --> 速查表、语法、API 文档

private/                          --> 仅限个人使用
  notes/                          --> 草稿与临时笔记
  journal/                        --> 带日期的反思记录

示例领域：programming、devops、design、business、data、security、productivity

内容格式

概念（Concepts）

用于深入理解某事物的工作原理：

CONCEPT NAME
============

What it is:
[一句话定义]

Why it matters:
[它解决什么问题？在何种场景下需要它？]

How it works:
[带示例的解释]
[在有助于说明架构或流程时，使用 ASCII 图表]

+----------+      +----------+
| Client   | ---> | Server   |
+----------+      +----------+

Key insight:
[“顿悟时刻”——是什么让你真正理解了它？]

Related: [相关概念链接]

工具箱条目（Toolbox Entries）

仅记录你实际使用过的工具与技术：

TOOL NAME

Category: [category]
Website: [url]
Cost: [free/paid/freemium]

What it does:
[简要描述]

Why I use it:
[个人经验——它为你解决了什么问题？]

When to reach for it:
[适用该工具的具体场景]

Quick start:
[最小化配置/使用步骤，助你快速上手]

Gotchas:
[曾让你踩坑的细节]

模式（Patterns）

用于记录可复用的解决方案：

PATTERN NAME

Problem:
[触发该模式的典型场景]

Solution:
[具体做法，必要时附代码/伪代码]

Trade-offs:
[优缺点分析；哪些情况下不应使用它]

Example:
[具体实现示例]

参考（References）

用于快速查阅的高密度信息：

REFERENCE: [TOPIC]

[结构清晰、易于扫读的内容]
[表格、列表、代码片段]
[行文极简，信息密度极高]

交互规则

保存知识

每次保存前必须确认：

1. “是否将此内容保存至你的第二大脑？”
2. 展示即将保存内容的草稿
3. 获得确认后执行保存
4. 保存完成后，明确告知已保存内容及位置

检索知识

当相关主题出现时：

• 搜索已有知识
• 呈现关联概念
• 将新学习内容与既有理解建立连接

质量维护

保存前须验证以下几点：

• 是否为“遗忘上下文的未来自己”而写
• 是否阐明了 WHY，而不仅是 WHAT
• 是否包含具体示例
• 是否不含凭据、API 密钥或私有路径
• 是否按便于检索的方式组织

反模式（Anti-Patterns）

1. 禁止自动保存——必须始终先询问
2. 禁止保存未使用的工具——仅收录你真正用过的工具
3. 禁止保存尚未吃透的概念——先学懂，再保存
4. 禁止包含密钥信息——不得出现 API keys、密码、tokens
5. 禁止创建浅层条目——若无法清晰解释，就不应保存
6. 禁止重复创建——保存前先检查是否已存在，必要时更新而非新建

API 使用方式

使用封装脚本：

{baseDir}/scripts/ensue-api.sh  ''

操作说明

搜索知识：

{baseDir}/scripts/ensue-api.sh discover_memories '{"query": "how does X work", "limit": 5}'

按命名空间列出条目：

{baseDir}/scripts/ensue-api.sh list_keys '{"prefix": "public/concepts/", "limit": 20}'

获取指定条目：

{baseDir}/scripts/ensue-api.sh get_memory '{"key_names": ["public/concepts/programming/recursion"]}'

创建新条目：

{baseDir}/scripts/ensue-api.sh create_memory '{"items":[
  {"key_name":"public/concepts/domain/name","description":"Short description","value":"Full content","embed":true}
]}'

更新条目：

{baseDir}/scripts/ensue-api.sh update_memory '{"key_name": "public/toolbox/_index", "value": "Updated content"}'

删除条目：

{baseDir}/scripts/ensue-api.sh delete_memory '{"key_name": "public/notes/old-draft"}'

工具箱索引

维护 public/toolbox/_index 作为主索引：

TOOLBOX INDEX
=============

Categories:
  languages/      编程语言
  frameworks/     库与框架
  devtools/       开发工具
  infrastructure/ 部署、托管、CI/CD
  productivity/   工作流与效率工具
  data/           数据库、数据分析、数据工具

Recent additions:
  [tool] - [一句话简介]

浏览方式：说 “show my toolbox” 或 “what tools do I have for [category]”

意图映射（Intent Mapping）

初始化设置

需配置环境变量 ENSUE_API_KEY。

获取密钥地址：https://www.ensue-network.ai/dashboard

在 clawdbot.json 中配置：

"skills": {
  "entries": {
    "second-brain": {
      "apiKey": "your-ensue-api-key"
    }
  }
}

安全规范

• 严禁 记录或显示 API 密钥
• 严禁 在知识条目中存储凭据、tokens 或其他密钥信息
• 严禁 包含个人文件路径或系统细节