先上干货






跑在你自己电脑上的 AI 编程助手,一个 Go 程序 + 浏览器界面,代码不出本机。既能像 ChatGPT 一样聊天问代码,也能像 Agent 一样改文件、跑命令,还有一套「先规划、再并行干活、自动提 PR」的完整流程。
当前项目的核心优点
1. 部署简单,数据在自己手里
- 一个二进制文件就能跑,前端也内嵌进去了,不用搭一堆服务。
- 代码、会话、记忆都存在项目目录的
.minicode/ 里,不依赖云端 IDE。
- 适合:公司内网、隐私敏感项目、想自己控模型的团队。
2. 长对话不容易「失忆」或「爆 Token」
普通 AI 助手聊久了,要么上下文塞满、要么越聊越贵。MiniCode 专门做了上下文工程:
- Agent 记忆:把聊过的内容整理成「主题 → 概念 → 事实」的知识图谱,下次按需召回,不用整段历史重塞。
- 调用图:需要时按函数关系查代码,而不是盲目全文搜索。
- 历史压缩:对话太长时自动摘要,省 Token。
3. Plan 模式:从「聊想法」到「自动提 PR」一条龙
这是和传统工具差别最大的地方之一:
- 在 Plan 页描述目标,和规划 Agent 讨论方案
- 满意后锁定计划
- 自动拆成带依赖的任务(S/M/L/XL),上 Kanban 看板
- 并行执行(Git worktree 隔离,避免互相改同一文件)
- 完成后自动 commit、push、创建 GitHub PR
相当于内置了「产品经理 + 项目经理 + 多个开发 Agent」的协作流程。
4. 对代码库理解更深
- 调用图:函数/类/接口级关系,支持 Go、Java、TS、Rust 等多种语言,还能可视化。
- 文档索引:PDF 和 30+ 种源码文件做语义索引,Agent 用
codebase_map 先看「地图」再读文件,少瞎猜路径。
- 笔记系统:项目知识可以沉淀在
<span class="ui-markdown__inline-path-prefix ui-1heor9g md-inline-path-prefix">.minicode/notes/</span>,跨会话复用。
5. 模型自由、切换方便
- 支持 Claude、GPT、OpenRouter、Ollama 本地模型、自定义 OpenAI 兼容接口。
- 在 Web 设置里改 API Key 热重载,不用重启服务。
- 不被单一厂商绑死。
6. 安全可控
- Chat 模式:只读,只能查代码,不能改、不能跑 shell。
- Agent 模式:写文件、改代码、跑 bash 等危险操作要逐项批准。
- 比「Agent 一上来就改你代码」更可控。
7. 可脚本化、可集成
minicode run "你的 prompt" 适合 CI、脚本、自动化。
- MCP 配置格式和 Cursor 兼容,现有 MCP 工具能复用。
- 支持 Unix socket、路径前缀部署,方便挂反向代理。
8. 内置网页搜索
- 百度 / 搜狗 / Bing 并发检索,还能抓页面正文(含 JS 渲染)。
- 查文档、查 API 不用自己切浏览器。
对比 Cursor、OpenCode 等传统工具
| 维度 |
MiniCode |
Cursor |
OpenCode 等 CLI Agent |
| 形态 |
本地 Web 工作台 |
VS Code 系 IDE,深度集成编辑器 |
终端 / CLI 为主 |
| 代码在哪 |
全在本机 |
本地编辑,但依赖 Cursor 云服务 |
本地 |
| 部署 |
单二进制自托管 |
装桌面客户端 + 订阅 |
通常 npm/源码安装 |
| 模型 |
多厂商 + 本地 Ollama,热切换 |
主要走 Cursor 提供的模型 |
通常自己配 API |
| Plan → 并行 → PR |
✅ 内置完整流程 |
❌ 无同等内置流程(靠 Agent 聊天) |
❌ 一般没有 |
| 跨会话记忆 |
✅ 知识图谱 + 向量检索 |
有 Rules/Memory,但偏 IDE 场景 |
通常较弱或没有 |
| 代码关系理解 |
✅ 调用图 + 文档索引 |
有索引,但无同等调用图/Plan 看板 |
主要靠 grep/read |
| 编辑器体验 |
浏览器界面,不是 IDE |
✅ 强项:补全、内联编辑、Diff |
无 IDE 体验 |
| 权限控制 |
危险操作逐项批准 |
有 Agent 模式,策略不同 |
通常更「全自动」 |
| 适合谁 |
要自托管、要 Plan 并行交付、要深度上下文 |
日常写代码、要最好 IDE 体验 |
终端党、轻量自动化 |
用更直白的话说
MiniCode 强在哪:
- 不是「又一个聊天改代码的工具」,而是带记忆、带地图、带项目管理的 AI 开发工作台。
- Plan 模式是它最独特的卖点:大需求可以拆任务、并行干、自动提 PR,Cursor / OpenCode 一般得自己 orchestrate。
- 上下文工程做得比较系统:知识图谱、调用图、压缩,长项目不容易越聊越乱、越聊越贵。
- 自托管 + 单文件部署,数据和模型都自己控。
Cursor 强在哪:
- 你是「在写代码」,Cursor 是「AI 嵌进编辑器里」——补全、Tab、内联改代码体验更好。
- 日常单文件改动、边写边问,Cursor 更顺手。
OpenCode 等 CLI 强在哪:
- 轻、快、终端里直接用,适合个人开发者或小脚本。
- 但一般没有 Plan 看板、调用图可视化、知识图谱记忆这些「重型能力」。
总结一句
MiniCode = 自托管的 AI 编程工作台,重点不是替代 IDE,而是:让 AI 更懂你的项目、更记得住历史、能把大需求拆成并行任务并自动交付 PR。
如果你在意数据隐私、模型自由、或者要做「规划 → 拆解 → 并行开发」这类流程,MiniCode 比 Cursor / OpenCode 更有针对性;如果你主要需求是「在 IDE 里边写边补全」,Cursor 仍然是更自然的选择。
下载地址
飞牛应用开源地址: https://gitee.com/yanfanVIP/fn-minicode
飞牛打包应用下载地址:https://gitee.com/yanfanVIP/fn-minicode/raw/master/build/minicode.fpk
MiniCode项目地址:https://gitee.com/yanfanVIP/minicode