MiniCode

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 71 Open GitHub ↗

30天实现一个claude code

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

30 天从零打造你自己的 Claude Code (Day 7/30)

如果这个项目对你有帮助，请给一个 ⭐️

---

## Demo

**核心特性：**

- **流式输出** - 打字机效果，实时显示 AI 思考过程
- **工具调用** - Glob/Grep/View/Bash/Write/Edit 六大工具
- **权限系统** - 危险操作确认，支持持久授权
- **主题切换** - Ctrl+T 切换暗色/亮色主题
- **多轮对话** - 完整的上下文记忆
- **取消支持** - Esc 随时中断，不浪费 Token

---

## 为什么做这个项目

> **"Talk is cheap, show me the code."** — Linus Torvalds

市面上有很多讲 AI Agent 的文章，但大多停留在概念层面。这个项目不同：

| 其他教程 | MiniCode |
|---------|----------|
| 讲概念、画架构图 | **3600+ 行教程 + 完整可运行代码** |
| 用 Python/LangChain | **Go 语言 + Fantasy SDK** |
| Hello World 级别 | **真正可用的 AI 编程助手** |
| 一篇文章讲完 | **30 天渐进式学习** |

### 你将学到什么

```
Day 1-4:   基础篇 ─────────────────────────────────────
           ├── AI Agent 核心概念
           ├── 工具系统设计与实现
           ├── TUI 交互界面 (Bubble Tea)
           └── 流式输出 + 取消机制

Day 5-10:  工具篇 ─────────────────────────────────────
           ├── 文件读写 (Read/Write)
           ├── 代码编辑 (Edit with diff)
           ├── 命令执行 (Bash)
           └── 内容搜索 (Grep)

Day 11-20: 进阶篇 ─────────────────────────────────────
           ├── Agent 循环与决策
           ├── 上下文管理与压缩
           ├── 错误恢复机制
           └── 并行工具调用

Day 21-30: 高级篇 ─────────────────────────────────────
           ├── 子 Agent 调度
           ├── 记忆系统
           ├── 性能优化
           └── 生产级部署
```

---

## 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/JiayuXu0/MiniCode.git
cd MiniCode
```

### 2. 获取 API Key

**方式一：使用智谱 GLM（推荐，有免费额度）**

前往 [智谱 AI](https://bigmodel.cn/) 注册并获取 API Key

```bash
# 创建 .env 文件
echo "OPENAI_API_KEY=你的智谱API_KEY" > .env
```

**方式二：使用其他平台**

MiniCode 支持多种 LLM 平台，详见 [配置示例](docs/config-examples.md)：

- **OpenRouter**: 支持多种模型（Claude、GPT-4 等）
- **阿里云百炼**: 通义千问系列模型
- **OpenAI**: GPT-4o、GPT-4o-mini 等

快速切换配置：

```bash
# 使用 OpenRouter
cp minicode.openrouter.json minicode.json
# 编辑并填入你的 API Key

# 使用阿里云百炼
cp minicode.bailian.json minicode.json
# 编辑并填入你的 API Key
```

### 3. 运行

```bash
go run .
```

**操作说明：**
- `Enter` - 发送消息
- `Tab` - 切换焦点（输入框 / 消息区）
- `Ctrl+T` - 切换暗色/亮色主题
- `Esc` - 取消当前请求 / 退出
- `↑↓` - 滚动查看历史消息

---

## 教程目录

| Day | 主题 | 内容 | 状态 |
|-----|------|------|:----:|
| **Day 1** | [创建第一个 AI Agent](docs/01.md) | Fantasy SDK、Provider、Agent 基础 | ✅ |
| **Day 2** | [给 Agent 添加工具](docs/02.md) | Tool 系统、Glob 文件搜索、AgentResult | ✅ |
| **Day 3** | [构建交互式 TUI](docs/03.md) | Bubble Tea、Elm 架构、多轮对话 | ✅ |
| **Day 4** | [实现流式输出](docs/04.md) | Streaming API、跨 goroutine 通信、取消机制 | ✅ |
| **Day 5** | [统一样式系统](docs/05.md) | Lip Gloss 主题、渐变色、主题切换 | ✅ |
| **Day 6** | [权限系统](docs/06.md) | Channel 阻塞、危险命令检测、权限对话框 | ✅ |
| **Day 7** | [配置系统](docs/07.md) | JSON 配置、变量解析、层级合并 | ✅ |
| Day 8-10 | 高级工具 | 搜索优化、并行执行 | 📋 |
| Day 11-20 | Agent 循环 | 决策引擎、上下文管理 | 📋 |
| Day 21-30 | 高级特性 | 子 Agent、记忆、部署 | 📋 |

---

## 技术架构

```
┌─────────────────────────────────────────────────────────────────┐
│                         MiniCode                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│   main.go                        tui/                           │
│   ┌──────────────┐               ┌──────────────────────────┐   │
│   │ Provider     │               │ model.go   - 状态管理     │   │
│   │ (智谱 GLM)   │               │ update.go  - 事件处理     │   │
│   │      ↓       │               │ view.go    - 界面渲染     │   │
│   │ Agent        │◄─────────────▶│ stream.go  - 流式处理     │   │
│   │ (Fantasy)    │               │ message.go - 消息类型     │   │
│   └──────────────┘               └──────────────────────────┘   │
│          │                                                      │
│          ▼                                                      │
│   tools/                         internal/                      │
│   ┌────────────────────────┐     ┌──────────────────────────┐   │
│   │ glob.go  - 文件搜索    │     │ styles/    - 主题样式     │   │
│   │ view.go  - 文件查看    │     │ permission/- 权限系统     │   │
│   │ grep.go  - 内容搜索    │◄───▶│   ├─ permission.go       │   │
│   │ bash.go  - 命令执行    │     │   └─ dangerous.go        │   │
│   │ write.go - 文件写入    │     └──────────────────────────┘   │
│   │ edit.go  - 代码编辑    │                                    │
│   └────────────────────────┘                                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘
```

### 技术栈

| 组件 | 技术 | 说明 |
|------|------|------|
| 语言 | Go 1.21+ | 高性能、强类型、并发原生支持 |
| AI SDK | [Fantasy](https://charm.land/fantasy) | Charmbracelet 出品，统一多 Provider |
| TUI | [Bubble Tea](https://github.com/charmbracelet/bubbletea) | Elm 架构的终端 UI 框架 |
| 样式 | [Lipgloss](https://github.com/charmbracelet/lipgloss) | 终端样式库 |
| LLM | 智谱 GLM-4 | 国产大模型，OpenAI 兼容接口 |

---

## 项目结构

```
MiniCode/
├── main.go                 # 程序入口
├── tui/                    # TUI 界面
│   ├── model.go            # Model 定义
│   ├── update.go           # Update 逻辑
│   ├── view.go             # View 渲染
│   ├── stream.go           # 流式处理
│   ├── message.go          # 消息类型
│   └── util.go             # 工具函数
├── tools/                  # 工具集
│   ├── glob.go             # 文件搜索
│   ├── view.go             # 文件查看
│   ├── grep.go             # 内容搜索
│   ├── bash.go             # 命令执行
│   ├── write.go            # 文件写入
│   └── edit.go             # 代码编辑
├── internal/               # 内部模块
│   ├── styles/             # 样式系统
│   │   ├── theme.go        # 主题定义
│   │   ├── styles.go       # 样式工厂
│   │   └── gradient.go     # 渐变效果
│   └── permission/         # 权限系统
│       ├── permission.go   # 权限服务
│       └── dangerous.go    # 危险命令检测
├── docs/                   # 教程文档
│   ├── 01.md ~ 06.md       # Day 1-6 教程
│   └── ...
└── assets/                 # 静态资源
```

---

## 常见问题

通过 Fantasy 的 `openaicompat` Provider，支持所有 OpenAI 兼容接口：
- 智谱 GLM（默认）
- 阿里通义千问
- 百度文心一言
- DeepSeek
- 本地模型（Ollama、vLLM 等）

修改 `main.go` 中的 `baseURL` 和 `modelID` 即可切换。
</details>

<details>
<summary>Q: 为什么不用 Python？</summary>

1. **性能**: Go 编译后是原生二进制，启动快、内存小
2. **部署**: 无需安装运行时，复制一个文件就能跑
3. **并发**: goroutine 处理流式输出比 async/await 更自然
4. **类型安全**: 编译时发现错误，不用等运行时踩坑
</details>

<details>
<summary>Q: 和 Claude Code 差距在哪？</summary>

MiniCode 是教学项目，目标是让你理解原理。和 Claude Code 的差距：
- 模型能力（Claude 4 vs GLM-4）
- 工具数量（6 个 vs 20+）
- 上下文管理（简单 vs 复杂压缩算法）
- 错误恢复（基础 vs 生产级）

但核心架构是一致的，学完你可以自己扩展。
</details>

<details>
<summary>Q: 教程更新频率？</summary>

目前已完成 Day 1-7，后续内容持续更新中。欢迎 Watch & Star 项目获取更新通知。
</details>

---

## 贡献

欢迎参与贡献！

- **Star** - 如果觉得有帮助，点个 Star 支持一下
- **Issue** - 发现 Bug 或有建议，欢迎提 Issue
- **PR** - 修复问题或添加功能，欢迎提 PR
- **分享** - 觉得教程有价值，分享给更多人

---

## 学习资源

- [Fantasy SDK 文档](https://charm.land/fantasy)
- [Bubble Tea 教程](https://github.com/charmbracelet/bubbletea)
- [智谱 AI 开放平台](https://bigmodel.cn/)
- [Go 语言圣经](https://gopl.io/)

---

## License

MIT License

---

Made with ❤️ by <a href="https://github.com/JiayuXu0">JiayuXu0</a>

MiniCode

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README