SmallCode 是一款专为轻量级大语言模型（7B–20B 参数）设计的终端原生 AI 编程代理工具。它不依赖云端 API，也不强求超长上下文或完美 JSON 输出——而是用精巧的架构，在你的笔记本电脑上就跑得动、干得实。对于想在本地安全地用 AI 辅助写代码、又买不起 A100 服务器的开发者来说，它填补了一个长期被忽视的空白：不是所有 AI 编程工具，都非得“越大越好”。
核心功能
- 本地全离线运行：无需联网、不调用任何云 API，代码和项目文件全程留在你自己的硬盘里，隐私零泄露
- 小模型友好架构：针对 7B–20B 级别消费级显卡可运行的模型深度优化，比如 Qwen2-7B、DeepSeek-Coder-14B 等，实测在 4B 活跃参数模型上仍能完成 87% 的基准任务
- 智能上下文预算管理：自动摘要、裁剪、分块输入代码，避免小模型因上下文过载而“忘记重点”，告别“把整个 node_modules 塞给 AI”的低效做法
- 容错型工具解析器：不苛求模型输出严格 JSON，能识别 Markdown 列表、注释式指令、甚至带口语化描述的命令，大幅降低对模型格式生成能力的依赖
- TODO 驱动的渐进式规划：将复杂需求拆解为可验证的待办步骤（写入 .smallcode-todo 文件），每步执行后自动更新状态，让小模型也能稳扎稳打完成多步开发
- 精准搜索替换式编辑：不粗暴重写整文件，而是通过语义搜索定位目标代码段，再执行增量 patch，避免误删逻辑、破坏格式或引入意外变更
适合哪些人用
如果你符合以下任意一条，SmallCode 很可能就是你一直在找的那款工具：
✅ 在家用 RTX 4070 / MacBook M1/M2 运行本地 LLM，不想开 VPN 或充 OpenAI 订阅；
✅ 关注数据隐私，拒绝把公司内部项目上传到第三方服务；
✅ 已尝试过 Cursor、Continue.dev 等工具，但发现它们对小模型支持差、容易崩溃或提示词失灵；
✅ 是前端/脚本/运维工程师，日常高频操作是改配置、修 Bug、写 CLI 工具——不需要“造轮子级”创造力，但需要稳定可靠的执行力；
✅ 厌倦了反复调试 system prompt 和 temperature，想要一个开箱即用、专注“干活”的 AI 编程搭档。
快速上手
安装极其简单，两种方式任选其一：
- 有 Node.js？一行搞定：
npm install -g smallcode && smallcode - 没装 Node.js？更方便：前往 GitHub Release 页面 下载预编译二进制包（Windows/macOS/Linux 全平台支持），解压即用，自带 Node.js 运行时，无需 Python、C++ 构建环境或 node-gyp
进入你的项目目录后直接运行 smallcode，它会自动加载当前代码结构，并以自然语言交互方式帮你生成函数、修复报错、补充测试或重构模块——全程在终端内完成，无缝融入你的日常开发流。
项目信息
AI coding agent optimized for small LLMs. 87% benchmark with 4B-active model.
编程语言：JavaScript｜Star 数：744｜开源协议：MIT｜GitHub 项目地址
SmallCode 不是另一个“更大更快更强”的 AI 编程幻梦，而是一次务实回归：用工程智慧弥补模型能力边界，让真正的生产力，从你的本地终端里稳稳生长出来。
