v0.1.6 78 Stars

自然语言
搞定任何事的 AI 编程助理

你只管说想做什么,剩下的交给它。Codelf 内置自主式 AI Agent,能读懂你的意图、拆解步骤、调用工具,把复杂任务从头做到尾。开源的轻量级桌面 IDE,数据完全本地化。

codelf — agent session
$
0
GitHub Stars
MIT
开源许可证
v0.1.6
最新版本
100%
数据本地化
核心特性

不止好用,更懂你的实际需求

从国内能直接用的网络优化,到企业级的本地知识库——每一个功能都为真实场景而生

🌏

国内网络友好

原生支持 DeepSeek 等国内可直连模型,兼容任意 OpenAI 兼容接口。国内中转、自建网关、公司内网代理,配好即用,无需科学上网。

多模型原生支持

DeepSeek、Claude、ChatGPT、Azure OpenAI、Dify 全部内置。哪个便宜用哪个,哪个聪明用哪个,一键切换,从不绑定订阅。

💰

上下文缓存优化

专门优化的对话组织方式,为每个会话生成稳定缓存键。长上下文命中缓存后 API 费用降低数倍,长期编码省下真金白银。

🤖

操控浏览器 & 桌面

内置 Playwright 浏览器自动化与桌面操控。Agent 能自己打开网页、点按钮、填表单,也能启动和操作本地桌面程序,像真正的数字管家。

🔒

数据全在本地

纯本地桌面应用,所有代码与文件不经过任何第三方。知识库向量数据库完全本地化,企业敏感资料零泄露风险,内网也能用。

📚

企业知识库 RAG

内置本地向量数据库 + bge-small-zh-v1.5 中文语义检索。支持 docx/xlsx/pdf/md 等格式导入,表格完整保留,让 AI 真正懂你们的业务文档。

如何使用

三步开始,极度简单

下载 → 配置 → 开工,不到 5 分钟就能用起来

1

下载安装

从 GitHub Releases 下载对应平台的安装包。Windows 双击安装,macOS 拖入 Applications。无需额外运行时。

2

配置 API Key

打开设置,填入 DeepSeek / Claude / OpenAI 任意一个 API Key。支持第三方中转和自定义接口地址,国内直连。

3

开始对话

用大白话说出需求——"帮我搭一个电商网站"或"把这份文档翻译成英文"。Agent 自动拆解步骤并完成任务。

效率对比

传统方式 vs Codelf 方式

想搭一个带数据库的 REST API?看看两种方式需要做什么

❌ 传统方式:手动搭建
# 你需要手动完成:
# 1. mkdir project && cd project
# 2. npm init -y
# 3. npm install express prisma ...
# 4. 手写 src/index.ts
# 5. 手写 prisma schema
# 6. 手写所有路由
# 7. 手写错误处理
# 8. 调试、查文档、改 bug
# ...
⏱ 通常需要 2-4 小时
✅ Codelf 方式:一句话搞定
> 帮我基于 Express + Prisma 搭一个
RESTful API,带用户认证和 CRUD


Codelf 会自动完成:
• 创建项目结构 + 安装依赖
• 编写 Express 路由 + Prisma Schema
• 实现 JWT 认证中间件
• 生成完整的 CRUD 接口
• 添加输入验证 + 错误处理
• 配置 .env + 运行指令

⏱ 3-5 分钟,你只需要审核结果
产品能力

既是 AI 助理,也是专业工具台

AI Agent 替你完成多步骤任务,专业的编辑器与工具链让你随时接管控制权

01

自主式 AI Agent

用一句话描述需求,Agent 自己拆解步骤、读写文件、跑终端命令、搜索代码库、调用外部工具——把需要几十步手动操作的任务从头做到尾。内置 Plan 模式,复杂任务先调研出方案让你确认后再动手。每个回合都有检查点,搞砸了随时撤销回滚。

自动规划Plan 模式检查点撤销 Agent SkillsMCP 协议产物预览
Codelf Agent 主界面
02

本地知识库 RAG

导入公司的技术文档、业务手册、产品规范和历史项目资料。AI 回答问题时自动检索相关内容并引用来源。内置 bge-small-zh-v1.5 中文语义检索,比关键词搜索准确得多。表格、流程图等结构化信息完整保留——新人入职培训、技术答疑、规范查阅,效率翻倍。

docxxlsxpdfmdtxtdoc 本地向量化中文语义检索
knowledge_base.py — bge-small-zh-v1.5 检索流程
import numpy as np
 
# 本地向量化 — 数据不离开你的机器
def search_knowledge(query: str, top_k=5):
embedding = model.encode(query)
results = db.search(embedding, top_k)
return [r["content"] for r in results]
03

专业编辑器 + 工具链

AI 搞不定时随时上手接管。Monaco 编辑器(VSCode 同款)+ LSP 智能感知 + xterm.js 终端 + Git + 全局搜索 + 命令面板——一个完整 IDE 该有的它都不缺。Python 环境自动发现,TypeScript / Vue / JSON / YAML 语言服务全部内置。

TypeScriptPythonVue JSONYAML行内补全 自动修错Git 集成
Codelf 编辑器界面
04

扩展生态:Skills & MCP

通过 Agent Skills 一键安装可复用的 AI 技能包——代码审查、TDD 开发、前端设计、系统调试等场景开箱即用。同时支持 MCP(Model Context Protocol)标准协议接入第三方工具与数据源,Dify 工作流也原生集成。

Agent SkillsMCP 协议 Dify 集成第三方中转 自定义工具
skills-lock.json — 已安装的 Agent Skills
"brainstorming": "v1.0 — 创意规划"
"frontend-design": "v1.0 — 前端设计"
"tdd": "v1.0 — 测试驱动开发"
"debugging": "v1.0 — 系统调试"
"git-worktrees": "v1.0 — 隔离开发"
// ... 更多技能一键安装
应用场景

一个工具,覆盖多种工作流

无论你是什么角色,Codelf 都能帮你把想法变成实际产出

Vibe Coding
用大白话描述想要的功能,Agent 自动生成代码、跑测试、修 bug,像跟同事聊天一样编程。
📚
企业知识管理
把公司文档导入知识库,AI 回答问题时自动引用。新人培训、技术答疑、规范查阅一站式。
🔄
代码重构
"把 src/api 改成 async/await"——一句话重构整个目录,自动运行测试确保零回归。
📄
文档处理
"把这份 50 页 PDF 翻译成英文并生成摘要"——Agent 逐页处理,输出结构化的 Markdown 文档。
🤖
自动化脚本
"帮我写一个每天统计 GitHub issue 并生成报表的脚本"——Agent 编写、测试、配置定时任务。
🌐
网页抓取与分析
"去这个网站抓取所有产品价格,导出 Excel 并在浏览器中预览"——Agent 操控浏览器自动完成。
🐞
Bug 排查
"线上这个页面白屏了,帮我排查原因"——Agent 读取日志、复现问题、定位根因并给出修复方案。
🎨
前端原型设计
"设计一个暗色主题的 Landing Page"——Agent 直接生成 HTML/CSS/JS,并在应用内实时预览效果。
界面一览

简洁、高效、沉浸式

对话、编辑、终端、Agent 面板,一应俱全

Codelf 对话模式
开发者

从源码构建

Node.js >= 18,Windows 或 macOS

终端 — 克隆并启动
git clone https://github.com/Liuchun-oss/codelf-agent.git
cd codelf-agent
npm install
npm run dev
# 热更新模式启动应用窗口
构建 & 打包
npm run dist
# Windows 安装包 (NSIS)

npm run dist:mac
# macOS 安装包 (dmg, arm64/x64)

# 产物 → release/ 目录
下载

选择你的平台

Windows 和 macOS 都支持,完全免费开源

平台支持

跨平台,原生体验

基于 Electron 33,在两个主流桌面平台上都有一致的体验

🪟
Windows
支持 Windows 10 及以上版本。提供 NSIS 安装包和免安装版两种分发方式。原生系统通知与托盘支持。
🍎
macOS
支持 macOS 11 Big Sur 及以上版本。原生适配 Apple Silicon (arm64) 和 Intel (x64) 双架构。DMG 安装,支持深色模式。
更新日志

持续迭代,越来越好用

每次更新都来自真实用户反馈。你提需求,我们来实现。

加载中...
技术栈

现代技术栈,极致体验

Electron + React + TypeScript 驱动,AI 能力与本地工具链深度整合

Electron 33
桌面框架
React 18
前端 UI
TypeScript
类型系统
Monaco
代码编辑器
Playwright
浏览器自动化
xterm.js
集成终端
sqlite-vec
本地向量数据库
OpenAI SDK
AI 模型接口
MCP SDK
工具协议
Zustand
状态管理
Shiki
语法高亮
HuggingFace
本地向量化
常见问题

你可能想问

完全免费。Codelf 采用 MIT 开源许可证,你可以自由阅读、修改和分发源码。你只需要支付所选 AI 模型的 API 费用(如 DeepSeek 或 OpenAI),应用本身没有任何收费。
完全不需要。Codelf 原生支持 DeepSeek 等国内可直连的大模型,也兼容国内各种第三方 API 中转站和自建网关。只要你能正常访问 DeepSeek 官网,就能用 Codelf。
绝对安全。Codelf 是纯本地桌面应用,所有代码和文件都存储在你自己电脑上,不经过任何第三方服务器。知识库的向量数据库也完全本地化,企业敏感文档不会上传到云端。
Codelf 的定位是「自主式 AI Agent」而不只是代码补全。它能自己规划任务步骤、读写文件、跑终端命令、操控浏览器和桌面程序,把多步骤任务从头做到尾。同时它开箱支持国内网络环境,不需要任何代理配置。
支持 docx、xlsx、xls、pdf、doc、md、txt 等常见企业文档格式。表格和流程图在导入后完整保留。基于 sqlite-vec 的本地向量数据库理论上支持百万级文档,实际取决于你的磁盘和内存。无文件大小硬性限制。
可以。Skills 本质上是一组 Markdown 格式的指令文件,你可以自己编写专属技能(比如特定框架的模板、公司内部规范),也能从社区一键安装其他人分享的技能包。

还等什么?现在就试试

开源免费 · MIT 许可证 · Windows & macOS 双平台 · 78 Stars