# AI 持久上下文管理框架

`Claude Code` `AI工作流` `项目管理` `上下文记忆` `效率工具`

# Nexus

> **快速开始：**[使用此模板](https://github.com/DorianSchlede/nexus-template/generate) → 克隆仓库 → 在 VS Code 中打开 → 启动 Claude Code → 说"hi"

---

## 你现在面临的问题

每次开启新的 Claude 会话时：
- 你要重新介绍自己是谁、做什么的
- 你要重新描述项目及进度
- 你要从头搭建相同的工作流
- 你会丢失上下文、洞察和工作动力

**如果 Claude 能记住一切，会怎样？**

---

## 看看效果（2 分钟）

**第一次使用：**
```
你："hi"

AI：显示 Nexus 菜单：
    🧠 记忆 - 未配置 ▸ '设置目标'
    📦 项目 - 暂无 ▸ '创建项目'
    🔧 技能 - 26 个可用

    💡 建议：'设置目标' 让 Nexus 了解你

你："为启动 v2.0 仪表板创建项目"

AI：[创建项目结构，引导规划]
    ✅ 项目已创建：01-dashboard-launch
```

**下次会话：**
```
你："hi"

AI：显示你的上下文：
    🧠 记忆 - 角色：SaaS 产品经理 | 目标：发布 v2.0
    📦 项目 - • dashboard-launch | 进行中 | 42%

    💡 建议：'继续 dashboard-launch' - 从 42% 处恢复

你："继续 dashboard-launch"

AI：[加载全部上下文，精确显示上次进度]
    "你正处于第 2 阶段：设计。下一个任务：审查线框图。"
```

**这就是魔法所在。** 永远不用重新解释。

---

## 实现这一切的原理

Nexus 为你提供三样东西：

### 1. 持久化记忆
你的角色、目标和学习成果保存在文件中。每次会话，Claude 自动加载它们。你永远不会从零开始。

### 2. 结构化项目
工作在**项目**中进行——包含规划文档、任务列表和进度跟踪。一切自动保存。

### 3. 可复用技能
捕获你重复执行的工作流。做完某件有用的事后说"创建技能"，它就永远变成一个单命令操作。

---

## 快速开始

### 前置条件

- [ ] **Claude Code 账号** — [在此注册](https://claude.ai)
- [ ] **Visual Studio Code** — [下载](https://code.visualstudio.com/)
- [ ] **Claude Code VS Code 扩展** — 从 VS Code 应用商店安装
- [ ] **Python 3.x** — [下载](https://python.org)

### 第一步：创建你的 Nexus

1. 点击 **[使用此模板](https://github.com/DorianSchlede/nexus-template/generate)**
2. 为仓库命名（如 `my-nexus`），点击 **创建仓库**
3. 克隆并打开：
   ```bash
   git clone https://github.com/YOUR-USERNAME/my-nexus.git
   cd my-nexus
   code .
   ```

### 第二步：启动 Claude Code

1. 通过 Claude Code 扩展**打开 Claude 聊天**（点击侧边栏的 Claude 图标）
2. **说：** `hi`

系统自动激活并显示菜单。

### 第三步：开始工作

你可以**立即**开始工作——无需任何设置！

| 你说 | 发生什么 |
|------|----------|
| `"创建项目"` | 通过引导开始新项目 |
| `"设置目标"` | 用你的角色和目标个性化 Nexus |
| `"设置工作区"` | 整理你的文件夹 |
| `"完成"` | 保存进度，结束会话 |

### 可选：学习系统

准备好后，6 个可选学习技能带你全面掌握系统：

| 技能 | 触发词 | 时长 |
|------|--------|------|
| **setup-goals** | "设置目标" | 8-10 分钟 |
| **setup-workspace** | "设置工作区" | 5-8 分钟 |
| **learn-integrations** | "学习集成" | 10-12 分钟 |
| **learn-projects** | "学习项目" | 8-10 分钟 |
| **learn-skills** | "学习技能" | 10-12 分钟 |
| **learn-nexus** | "学习 nexus" | 15-18 分钟 |

---

## 三大核心概念

### 记忆——你的持久上下文

`01-memory/` 文件夹存储你的信息（首次运行时自动创建）：

```
01-memory/
├── goals.md           ← 你的角色、目标、成功指标
├── user-config.yaml   ← 语言和偏好设置
├── core-learnings.md  ← 随时间积累的规律
└── session-reports/   ← 自动生成的会话历史
```

每次会话，Claude 首先加载这些文件。在你开口之前，它就已了解你的上下文。

### 项目——结构化工作

项目有开始、中间和结束：

```
02-projects/01-dashboard-launch/
├── 01-planning/       ← overview.md、plan.md、steps.md
├── 02-resources/      ← 参考资料
├── 03-working/        ← 进行中的工作
└── 04-outputs/        ← 最终交付物
```

### 技能——可复用工作流

技能捕获你重复执行的操作：

```
你："生成状态报告"

AI：[加载技能 → 按步骤执行 → 生成报告]
```

做完有用的事后用 `"创建技能"` 来创建你自己的技能。

---

## 会话工作流程

```
┌─────────────────────────────────────────────────────────────┐
│  开始："hi"                                                  │
│  → 系统加载你的记忆                                          │
│  → 显示你的活跃项目和技能                                    │
│  → 根据你的状态建议下一步                                    │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│  工作："继续 [项目]" 或 "[技能触发词]"                       │
│  → 加载相关上下文                                            │
│  → 系统化执行                                                │
│  → 跟踪进度                                                  │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│  结束："完成"                                                │
│  → 保存所有进度                                              │
│  → 用学习内容更新记忆                                        │
│  → 创建会话报告                                              │
│  → 准备好下次恢复                                            │
└─────────────────────────────────────────────────────────────┘
```

---

## 集成

用自然语言连接你的工具：

| 集成 | 触发词 | 功能 |
|------|--------|------|
| **Notion** | "连接 notion" | 查询数据库、创建页面、管理内容 |
| **Airtable** | "连接 airtable" | 查询表格、管理记录、批量操作 |
| **Beam AI** | "连接 beam" | 管理智能体、创建任务、查看分析 |
| **任意 REST API** | "添加集成" | 自动发现端点，创建实现方案 |

引导式设置带你完成 API 密钥和配置。

---

## 工作区地图

你的 `04-workspace/` 文件夹在 `workspace-map.md` 中有完整记录——这是你文件结构的动态地图。

**为什么重要：**
- Nexus 通过它了解你的文件位置
- 无需询问即可找到并整理文件
- 新文件和文件夹会被自动识别

**保持同步：**
```
你："更新工作区地图"

AI：[扫描 04-workspace/，更新文档]
    ✅ 工作区地图已更新。发现 3 个新文件夹。
```

重新整理文件后偶尔运行一次。

---

## 系统要求

**必需：**
- Claude Code 账号（[注册](https://claude.ai)）
- Visual Studio Code（[下载](https://code.visualstudio.com/)）
- Claude Code VS Code 扩展（从应用商店安装）
- Python 3.x（[下载](https://python.org)）

**可选：**
- 用于集成的 MCP 服务器（Notion、Airtable、Linear）
- 用于版本控制的 Git

---

## 深入了解

- **[产品概述](00-system/documentation/product-overview.md)** — Nexus 解决的问题
- **[框架概述](00-system/documentation/framework-overview.md)** — 技术深度解析

---

## 获取 Nexus

### 方式一：使用模板（推荐）

1. 前往 [Nexus GitHub 仓库](https://github.com/DorianSchlede/nexus-template)
2. 点击 **"使用此模板"** → **"创建新仓库"**
3. 命名仓库，设置可见性，点击 **"创建仓库"**
4. 克隆你的新仓库：
   ```bash
   git clone https://github.com/YOUR-USERNAME/YOUR-REPO-NAME.git
   cd YOUR-REPO-NAME
   code .
   ```

这样你就有了自己的副本，可以提交个人数据（目标、项目、技能）。

### 方式二：直接克隆（用于体验）

```bash
git clone https://github.com/DorianSchlede/nexus-template.git
cd nexus-template
code .
```

注意：直接克隆无法将更改推送到原始仓库。

---

## 获取更新

Nexus 会定期进行系统更新（新技能、改进、修复）。更新过程中**绝不会触碰**你的个人数据。

### 更新内容

| 更新（来自上游） | 受保护（你的数据） |
|----------------|------------------|
| `00-system/` | `01-memory/` |
| `CLAUDE.md` | `02-projects/` |
| `README.md` | `03-skills/` |
| | `04-workspace/` |
| | `.env`、`.claude/` |

### 自动检查更新

启动时自动检查更新。有可用更新时，你会看到：
```
⚡ 有可用更新：v0.9.0 → v0.10.0
   说 'update nexus' 获取最新改进
```

### 如何更新

只需说：
```
你："update nexus"

AI：有可用更新：v0.9.0 → v0.10.0
    将更新 12 个文件

    是否继续？(yes/no)

你："yes"

AI：✅ 更新完成！备份位于：.sync-backup/2024-01-15/
```

---

# 技术参考

*以下章节供希望深入了解的用户阅读。*

---

## 文件夹结构

```
Nexus/
│
├── CLAUDE.md                    # 入口点 - 启动时加载
│
├── 00-system/                   # 框架（请勿修改）
│   ├── core/                    # 引擎脚本
│   │   ├── orchestrator.md      # AI 决策逻辑
│   │   └── nexus-loader.py      # 上下文加载器 + 状态机
│   ├── skills/                  # 内置系统技能（26+）
│   │   ├── learning/            # 引导技能
│   │   ├── projects/            # 项目管理
│   │   ├── skill-dev/           # 技能创建
│   │   ├── system/              # 系统工具
│   │   ├── notion/              # Notion 集成
│   │   ├── airtable/            # Airtable 集成
│   │   └── tools/               # 思维模型、生成器
│   └── documentation/           # 框架指南
│
├── 01-memory/                   # 你的持久上下文
│   ├── goals.md                 # 角色、目标（自动创建）
│   ├── user-config.yaml         # 偏好 + 学习跟踪
│   ├── core-learnings.md        # 规律（持续增长）
│   └── session-reports/         # 自动生成的摘要
│
├── 02-projects/                 # 你的阶段性工作
│   └── {id}-{name}/             # 每个项目
│
├── 03-skills/                   # 你的自定义技能
│   └── {skill-name}/            # 你的可复用工作流
│
└── 04-workspace/                # 你的文件
    └── [你的组织方式]            # 文档、数据、输出
```

---

## 项目生命周期

| 状态 | 含义 |
|------|------|
| `PLANNING` | 规划设计中 |
| `IN_PROGRESS` | 积极推进中 |
| `COMPLETE` | 所有任务完成 |
| `ARCHIVED` | 已归档 |

---

## 内置系统技能

### 核心技能
| 技能 | 触发词 | 功能 |
|------|--------|------|
| `create-project` | "创建项目" | 引导式项目创建 |
| `create-skill` | "创建技能" | 捕获工作流以便复用 |
| `execute-project` | "继续 [名称]" | 系统化项目执行 |
| `close-session` | "完成" | 保存进度，生成报告 |

### 学习技能
| 技能 | 触发词 | 功能 |
|------|--------|------|
| `setup-goals` | "设置目标" | 个性化你的目标 |
| `setup-workspace` | "设置工作区" | 配置文件夹结构 |
| `learn-integrations` | "学习集成" | 连接外部工具 |
| `learn-projects` | "学习项目" | 项目系统教程 |
| `learn-skills` | "学习技能" | 技能系统教程 |
| `learn-nexus` | "学习 nexus" | 系统全面掌握 |

### 集成技能
| 技能 | 触发词 | 功能 |
|------|--------|------|
| `notion-master` | "连接 notion" | Notion 数据库集成 |
| `airtable-master` | "连接 airtable" | Airtable 表格集成 |
| `add-integration` | "添加集成" | MCP 服务器设置指南 |

---

## 常用命令参考

| 命令 | 效果 |
|------|------|
| `"hi"` | 加载系统，显示菜单 |
| `"创建项目"` | 启动引导式项目创建 |
| `"创建技能"` | 捕获可复用工作流 |
| `"继续 [名称]"` | 恢复项目 |
| `"设置目标"` | 个性化你的上下文 |
| `"完成"` | 保存一切，结束会话 |
| `"验证系统"` | 检查完整性 |

---

**Nexus** — 以最优方式与 AI 协作。一次构建，永久复用。永不从零开始。