第二大脑

一个用于构建随时间累积的理解力的个人知识库。不是笔记堆砌——而是一个结构化的系统，用于捕获你能够实际检索和使用的知识。

核心理念

你的第二大脑应该：

• - 捕获理解，而非仅仅事实——为忘记上下文的未来自己而写
• 可检索——结构化设计，让你在需要时能找到内容
• 保持常青——不包含私人细节、凭证或时效性数据
• 反映真实经验——只保存你实际学习或使用过的内容

保存前自问：未来的我会为此感谢我吗？

命名空间结构

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

内容格式

概念

用于理解事物的运作方式：

概念名称
============

它是什么：
[一句话定义]

为什么重要：
[它解决了什么问题，何时需要它]

工作原理：
[带示例的解释]
[架构/流程的ASCII图表（如有帮助）]

+----------+ +----------+
| 客户端 | ---> | 服务器 |
+----------+ +----------+

关键洞察：
[顿悟时刻——是什么让你豁然开朗]

相关概念：[链接到相关概念]

工具箱条目

用于你实际使用过的工具和技术：

工具名称

类别：[类别]
网址：[URL]
费用：[免费/付费/免费增值]

功能：
[简要描述]

使用原因：
[个人经验——它为你解决了什么问题]

适用场景：
[选择此工具的合适场景]

快速入门：
[最小化设置/使用方法]

注意事项：
[曾经困扰过你的问题]

模式

用于可复用的解决方案：

模式名称

问题：
[什么情况触发此模式]

解决方案：
[方法，附相关代码/伪代码]

权衡：
[优缺点，何时不应使用]

示例：
[具体实现]

参考资料

用于快速查阅的材料：

参考资料：[主题]

[组织有序、可快速浏览的内容]
[表格、列表、代码片段]
[最少文字，最大信息量]

交互规则

保存知识

保存前务必确认：

1. 1. 是否将此内容保存到你的第二大脑？
2. 显示将要保存的草稿
3. 确认后保存
4. 确认保存内容及位置

检索知识

当相关主题出现时：

• - 搜索现有知识
• 展示相关概念
• 将新学习与已有理解建立联系

质量维护

保存前验证：

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

反模式

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

API 使用

使用封装脚本：

bash
{baseDir}/scripts/ensue-api.sh <方法>

操作

搜索知识：
bash
{baseDir}/scripts/ensue-api.sh discover_memories {query: X是如何工作的, limit: 5}

按命名空间列出：
bash
{baseDir}/scripts/ensue-api.sh list_keys {prefix: public/concepts/, limit: 20}

获取特定条目：
bash
{baseDir}/scripts/ensue-api.sh getmemory {keynames: [public/concepts/programming/recursion]}

创建条目：
bash
{baseDir}/scripts/ensue-api.sh create_memory {items:[
{key_name:public/concepts/domain/name,description:简短描述,value:完整内容,embed:true}
]}

更新条目：
bash
{baseDir}/scripts/ensue-api.sh updatememory {keyname: public/toolbox/_index, value: 更新后的内容}

删除条目：
bash
{baseDir}/scripts/ensue-api.sh deletememory {keyname: public/notes/old-draft}

工具箱索引

维护 public/toolbox/_index 作为主参考：

工具箱索引
=============

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

最近添加：
[工具] - [一句话描述]

浏览：显示我的工具箱 或 我在[类别]有哪些工具

意图映射

设置

需要 ENSUEAPIKEY 环境变量。

在以下网址获取密钥：https://www.ensue-network.ai/dashboard

在 clawdbot.json 中配置：
json
skills: {
entries: {
second-brain: {
apiKey: your-ensue-api-key
}
}
}

安全

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