
一个.bone文件到完整后端SmallCode如何将15次工具调用压缩到2次【免费下载链接】smallcodeAI coding agent optimized for small LLMs. 87% benchmark with 4B-active model.项目地址: https://gitcode.com/gh_mirrors/sm/smallcodeSmallCode 是一款专为小型本地模型7B-20B优化的 AI 编程代理。它内置的 BoneScript 集成让你只需编写一个.bone文件就能把它编译成包含路由、认证、数据库、迁移、Docker 的完整后端项目——把传统 AI 编程代理需要的 8~15 次工具调用直接压缩到 1~2 次。为什么小模型写后端总是卡在半路传统 AI 编程代理的工作方式是逐文件施工读目录 → 建package.json→ 写入口文件 → 建路由 → 加中间件 → 写认证 → 建数据模型 → 加数据库迁移 → 写 Dockerfile……一个像样的 REST 后端模型平均要发起8~15 次工具调用。对旗舰大模型来说这不是问题但对 4B~8B 的本地小模型每一次调用都是一次失手机会工具调用 JSON 格式写错整个任务报废上下文窗口被前面的文件塞满后面的代码开始幻觉连续调用超过 3 次后推理连贯性急剧下降COMPARISON.md 中的基准测试显示引入 BoneScript 之前4B 激活参数的小模型在多文件全栈任务上的成功率是0%引入之后直接拉到80%。上图对应bone_compile工具源码它正是这次压缩的主角。什么是 .bone 文件用一个文件描述整个后端.bone文件采用 BoneScript 声明式语法不再让模型写代码而是让它描述需求。一份简短的语法速查表可以直接看 bonescript_guide.jssystem: 后端顶层容器 entity: 数据模型字段、约束、状态机、认证方式 capability: 操作前置条件、效果、事件 event: 服务间的持久化消息 channel: WebSocket 实时通道 policy: 限流、审计、加密 store: 数据库引擎postgres / sqlite / mysql flow: 带补偿的多步事务模型不需要记住 Express 中间件的写法、Prisma 迁移的格式它只需要把要什么声明清楚——正确的代码由编译器保证而不是由模型即兴发挥。SmallCode 如何把 15 次调用压缩到 2 次核心就两个内置工具第 1 步bone_check —— 先校验再动手bone_check在不生成任何代码的情况下检查.bone文件的类型错误、约束冲突和语法问题。源码见 bone_check.ms。校验失败时它会把错误结构化地回传给模型——SmallCode 的改进循环重试 → 分解 → 升级会让模型带着明确的报错信息自动修复小模型不需要第一次就写对。第 2 步bone_compile —— 一次编译完整交付bone_compile调用 BoneScript 编译器一次性生成完整 Node.js/TypeScript 项目路由、模型、认证、事件、迁移、SDK、管理面板、Docker、CI 全部到位。实现见 bone_compile.ms支持express默认、nakama、prisma、sqlite四种目标。传统代理SmallCode BoneScript工具调用次数8~15 次1~2 次格式出错风险每次调用都可能编译器兜底全栈任务成功率4B 激活模型0%80%更妙的是你甚至不用主动提 BoneScript。SmallCode 内置了任务分类器见 bonescript_guide.js 中的shouldUseBoneScript当你说出创建一个 Express API、build a backend with auth这类话时它会自动识别后端任务并把约 400 token 的 BoneScript 语法速查表注入系统提示词——对 8k 上下文的模型来说这点开销完全可控。幕后功臣两阶段工具路由与上下文预算小模型的上下文寸土寸金工具 Schema 本身就是一种负担。SmallCode 的 two_stage_router.js 把 Schema 开销减半模型先选一个大类读 / 写 / 搜索 / 运行 / 规划系统再只注入该类工具的定义。bone_compile和bone_check就挂在规划类下对 ≤16k 上下文的模型自动启用。再配合上下文预算引擎自动摘要大文件、驱逐旧消息、实时追踪 token 用量和 TODO 驱动的原子步骤规划15 次调用链里上下文爆掉、跑偏、截断的连锁故障被从根上拆掉了。上手体验三步生成你的后端# 第 1 步安装Node.js 18 npm install -g smallcode # 第 2 步项目根目录创建 .env # SMALLCODE_MODELyour-model-name # SMALLCODE_BASE_URLhttp://localhost:1234/v1 # 第 3 步启动并用一句话描述需求 smallcode # → 用 SQLite 建一个带 JWT 认证的用户 CRUD API接下来的对话里模型只产出一个.bone文件bone_check校验通过后bone_compile一键编译output/目录里就是可以直接跑起来的完整后端。小结小模型的杠杆不在参数而在架构SmallCode 给出的答案很清楚与其让小模型硬写 15 步不如让它把 1 步做到极致。一个.bone文件 两次工具调用配合宽容的多格式解析器、自动校验回环和硬失败保护让消费级硬件上的本地模型也具备了稳定的后端交付能力——这正是它能在 4B 激活参数模型上跑出 87% 单文件基准详见 COMPARISON.md 与 polyglot-mini.md的关键。对新手来说这意味着更低的门槛不用等旗舰 API不用手写脚手架一句需求、两次调用后端项目就已经立起来了。【免费下载链接】smallcodeAI coding agent optimized for small LLMs. 87% benchmark with 4B-active model.项目地址: https://gitcode.com/gh_mirrors/sm/smallcode创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考