第二大脑

一个用于构建随时间复利增长的认知的个人知识库。它不是一个笔记垃圾场，而是一个结构化的系统，用于捕获你真正能够检索和使用的知识。

理念

你的第二大脑应该：

• 捕获理解，而不仅仅是事实- 为你那个忘记了背景的未来自己而写
• 具备可检索性- 结构化，以便你可以在需要时找到东西
• 保持常青- 不包含私人细节、凭证或有时效性的数据
• 反映真实经验- 只保存你真正学过或用过的东西

在保存之前，请思考：未来的我会为此感谢我吗？

命名空间结构

public/                           --> Shareable knowledge
  concepts/                       --> How things work
    [domain]/                     --> Organize by topic
      [concept-name]              --> Individual concepts
  toolbox/                        --> Tools and technologies
    _index                        --> Master index of tools
    [category]/                   --> Group by type
      [tool-name]                 --> Individual tools
  patterns/                       --> Reusable solutions
    [domain]/                     --> Design patterns, workflows
  references/                     --> Quick-reference material
    [topic]/                      --> Cheatsheets, syntax, APIs

private/                          --> Personal only
  notes/                          --> Scratchpad, drafts
  journal/                        --> Dated reflections

示例领域： 编程、运维设计商业数据安全生产力内容格式概念用于理解某物如何运作：工具箱条目用于您实际使用过的工具和技术：

模式

用于可复用的解决方案：

参考资料

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

What it is:
[One-line definition]

Why it matters:
[What problem it solves, when you'd need it]

How it works:
[Explanation with examples]
[ASCII diagrams for architecture/flows where helpful]

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

Key insight:
[The "aha" moment - what makes this click]

Related: [links to related concepts]

用于快速查阅的材料：

交互规则

TOOL NAME

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

What it does:
[Brief description]

Why I use it:
[Personal experience - what problem it solved for you]

When to reach for it:
[Scenarios where this is the right choice]

Quick start:
[Minimal setup/usage to get going]

Gotchas:
[Things that tripped you up]

保存知识

保存前始终确认：

PATTERN NAME

Problem:
[What situation triggers this pattern]

Solution:
[The approach, with code/pseudocode if relevant]

Trade-offs:
[Pros and cons, when NOT to use it]

Example:
[Concrete implementation]

“您想让我把这个保存到您的第二大脑吗？”

显示将要保存内容的草稿

REFERENCE: [TOPIC]

[Organized, scannable content]
[Tables, lists, code snippets]
[Minimal prose, maximum signal]

确认后保存

Saving Knowledge

Always confirm before saving:

1. "Want me to save this to your second brain?"
2. Show draft of what will be saved
3. Save after confirmation
4. 确认保存内容和位置

检索知识

当相关主题出现时：

• 搜索现有知识
• 呈现相关概念
• 将新知识与现有理解相连接

保持质量

保存前，请确认：

• 为将来忘记上下文的自己而写
• 包含原因（WHY），而不仅仅是内容（WHAT）
• 包含具体示例
• 不包含凭证、API密钥或私有路径
• 为检索而结构化

反模式

1. 不要自动保存- 务必先询问
2. 不要保存未使用的工具- 仅保存实际使用过的工具
3. 不要保存一知半解的概念- 先学习，后保存
4. 不要包含机密信息- 不包含API密钥、密码、令牌
5. 不要创建浅层条目- 如果无法解释清楚，就不要保存
6. 不要重复- 先检查是否存在，必要时更新

API 使用

使用封装脚本：

{baseDir}/scripts/ensue-api.sh <method> '<json_args>'

操作

搜索知识：

{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/      Programming languages
  frameworks/     Libraries and frameworks
  devtools/       Development utilities
  infrastructure/ Deployment, hosting, CI/CD
  productivity/   Workflow and productivity tools
  data/           Databases, analytics, data tools

Recent additions:
  [tool] - [one-line description]

Browse: "show my toolbox" or "what tools do I have for [category]"

意图映射

设置

要求ENSUE_API_KEY环境变量。

在此获取您的密钥：https://www.ensue-network.ai/dashboard

在 clawdbot.json 中配置：

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

安全

• 切勿记录或显示 API 密钥
• 切勿在条目中存储凭据、令牌或密钥
• 绝不包含个人文件路径或系统详情