MiniCode

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 的文章，但大多停留在概念层面。这个项目不同：

你将学到什么

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. 克隆项目

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

2. 获取 API Key

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

前往 智谱 AI 注册并获取 API Key

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

方式二：使用其他平台

MiniCode 支持多种 LLM 平台，详见 配置示例：

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

快速切换配置：

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

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

3. 运行

go run .

操作说明：

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

教程目录

技术架构

┌─────────────────────────────────────────────────────────────────┐
│                         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  - 代码编辑    │                                    │
│   └────────────────────────┘                                    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

技术栈

项目结构

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/                 # 静态资源

常见问题

贡献

欢迎参与贡献！

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

学习资源

• Fantasy SDK 文档
• Bubble Tea 教程
• 智谱 AI 开放平台
• Go 语言圣经

License

MIT License

_{Made with ❤️ by JiayuXu0}