基于大模型实现的对话智能编程助手，支持多种大模型调用、工具集成和智能上下文管理。
- 自然语音对话: 支持自然语音对话编程
- 提示词自定义: 支持自定义提示词，修改prompts对应的文件即可
- 统一大模型接口: 支持 OpenAI、DeepSeek、Claude、Ollama
- 丰富工具生态: 文件操作、搜索发现、任务管理、系统执行等
- 智能上下文管理: 自动压缩、持久化存储
- 灵活提示词管理: 文件化存储，支持热更新
- 流式响应: 支持实时流式对话
- MCP协议支持: 可扩展工具集成
nala-coder/
├── cmd/ # 命令行入口
├── internal/ # 内部包
│ ├── agent/ # Agent核心调度层
│ ├── llm/ # 大模型调用封装
│ ├── tools/ # 工具引擎
│ ├── context/ # 上下文管理
│ └── interfaces/ # 用户交互接口
├── pkg/ # 公共包
│ ├── types/ # 类型定义
│ └── utils/ # 工具函数
├── prompts/ # 提示词文件
├── configs/ # 配置文件
├── web/ # Web界面
└── storage/ # 存储目录
- Go 1.24.5+
- 大模型API密钥（OpenAI、DeepSeek、Claude或本地Ollama）
- 克隆项目
git clone github.com/zboya/nala-coder
cd nala-coder- 安装使用
make install- 配置API密钥
# 编辑配置文件，设置你的API密钥
vi ~/.nala-coder/config.yaml- 运行服务
cd 你需要编辑代码的目录
nala-coder启动后会自动打开的页面，允许网页使用麦克风，唤醒小娜后就可以对话编程了。
NaLa Coder 将所有配置和数据文件统一存放在 ~/.nala-coder 目录下：
~/.nala-coder/
├── config.yaml # 主配置文件
├── storage/ # 数据存储目录
│ ├── sessions.db # 会话数据库（SQLite）
│ └── CODE_AGENT.md # 持久化上下文文件
├── logs/ # 日志文件目录
│ └── nala-coder.log # 应用日志
└── prompts/ # 提示词文件目录
├── en/ # 英文提示词
│ ├── system.md # 系统提示词
│ ├── compression.md # 压缩提示词
│ └── user_info.md # 用户信息提示词
└── ch/ # 中文提示词
├── system.md
├── compression.md
└── user_info.md
支持多种大模型提供商，可以同时配置多个：
llm:
default_provider: "deepseek" # 默认使用的提供商
openai:
api_key: "sk-xxx"
base_url: "https://api.openai.com/v1"
model: "gpt-4"
max_tokens: 4096
temperature: 0.3
deepseek:
api_key: "sk-xxx"
base_url: "https://api.deepseek.com"
model: "deepseek-chat"
# 更多配置...可以启用/禁用特定工具：
tools:
enabled_tools:
- "read" # 文件读取
- "write" # 文件写入
- "edit" # 文件编辑
- "bash" # 命令执行
# 更多工具...
timeouts:
bash: 120000 # 2分钟超时
web_fetch: 30000 # 30秒超时可以通过环境变量覆盖配置：
export OPENAI_API_KEY="your-key"
export LLM_DEFAULT_PROVIDER="openai"
export SERVER_PORT="8888"- read: 读取文件内容，支持分页
- write: 写入文件内容
- edit: 精确编辑文件特定部分
- multi_edit: 对同一文件进行多处编辑
- glob: 使用模式匹配查找文件
- grep: 在文件内容中搜索文本模式
- ls: 列出目录内容
- bash: 执行系统命令，支持超时控制
- web_search: 网络搜索（需要API支持）
- web_fetch: 获取网页内容
# 构建二进制文件
make build- 在
internal/tools/下创建新的工具文件 - 实现
ToolExecutor接口 - 在
engine.go中注册工具 - 更新配置文件中的
enabled_tools
- 在
prompts/目录下创建.md文件 - 使用Go模板语法支持动态内容
- 支持热重载，修改后立即生效
NaLa Coder 系统架构
┌─────────────────────────────────────────────────────────────────┐
│ 用户交互层 │
│ ┌─────────────┐ │
│ │ CLI/HTTP │ │
│ │ Interface │ │
│ └─────────────┘ │
└─────────────┬───────────────┬───────────────┬───────────────────┘
│ │ │
┌─────────────▼───────────────▼───────────────▼───────────────────┐
│ Agent核心调度层 │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ 主循环引擎 │◄────────┤ 消息队列 │ │
│ │ (AgentLoop) │ │ (AsyncQueue) │ │
│ └─────────────────┘ └─────────────────┘ │
└─────────────┬───────────────────────┬─────────────────────────────┘
│ │
┌─────────────▼───────────────────────▼─────────────────────────────┐
│ 工具执行与管理层 │
│ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌─────────────────┐│
│ │ 工具引擎 │ │ 并发控制 │ │ LLM调用 │ │ 上下文管理 ││
│ │(ToolEngine)│ │(Scheduler) │ │ (LLMClient)│ │(ContextManager) ││
│ └────────────┘ └────────────┘ └────────────┘ └─────────────────┘│
└─────────────┬─────────────────────────────────────────────────────┘
│
┌─────────────▼─────────────────────────────────────────────────────┐
│ 存储与持久化层 │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │短期记忆存储 │ │ 中期压缩历史 │ │ 长期持久存储 │ │状态缓存系统 │ │
│ │(Messages) │ │(Compressed) │ │(Persistence)│ │(StateCache) │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└───────────────────────────────────────────────────────────────────┘
- Fork 项目
- 创建特性分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
- 查看 Issues 获取帮助