Devika 实战指南：让 AI 软件工程师独立交付一个电商首页

Devika 实战指南：让 AI 软件工程师独立交付一个电商首页

【免费下载链接】devikaDevika is the first open-source implementation of an Agentic Software Engineer. Initially started as an open-source alternative to Devin.项目地址: https://gitcode.com/GitHub_Trending/de/devika

Devika 是一款开源的 AI 软件工程师，能读懂自然语言指令、自行拆解任务、检索资料并一路写出可运行代码。它最初是作为 Devin 的开源实现启动的，也在 SWE-bench 上跑出了基准成绩。你只需丢给它一个"做一个电商首页"这样的目标，内部一组核心智能体就会接力完成规划、检索、编码、修补全流程，过程还能在网页界面里实时围观。这篇文章带你走一遍从跑起来到喂它领域知识的最短路径。

🚀 五分钟跑通 Devika 安装教程

先备齐环境：Python 需在 3.10 到 3.12 之间，Node 18 以上，另外装好 uv 和 bun 两个运行时。以下命令可以顺序执行。

git clone https://gitcode.com/GitHub_Trending/de/devika cd devika

预期：本地生成项目目录。失败的话先检查网络与 git 状态。

uv venv source .venv/bin/activate uv pip install -r requirements.txt

预期：全部 Python 依赖装入 .venv 虚拟环境。报版本冲突时检查 Python 的主次版本。

playwright install --with-deps

预期：下载 Chromium 及其系统依赖。Devika 用这个浏览器去爬取搜索结果。

python devika.py

预期：终端打印 Devika is up and running!，首次运行会在根目录生成 config.toml。

再开一个终端启动前端：

cd ui bun install bun run start

预期：Web 服务启动，浏览器打开 127.0.0.1:3001 即见 Devika 工作界面。

🔧 一次任务的幕后：9 个核心智能体如何接力

多智能体协作实时进度，状态存本地 SQLite

把一句高层指令打进聊天框后，Devika 并不直接把它丢给模型。Planner 先把需求拆成一串可执行的步骤并提取聚焦领域。Researcher 接着对检索词排序，走 Bing 或 Google 拉回头部结果，Formatter 再把爬到的网页整理成干净上下文。这份上下文连同计划一起交给 Coder，后者把代码切分到对应文件、附上注释，落盘到项目目录。你追加一句"跑起来"或"修掉这个 bug"时，Action 智能体会判定意图，转交 Runner 或 Patcher：前者在沙箱执行代码并把输出流式回传，后者定位根因、最小改动修复。全程的内部独白和状态写入 SQLite 数据库，断线也能回放。各智能体源码在 src/agents/，一智能体一目录。

📚 把 Devika 接上你的领域知识

先选一个搜索引擎

Devika 支持三种检索源，选型前对比一下：

Bing 的 Key 在 Azure 的 "Keys and Endpoint" 页面：

Key1/Key2 与 Endpoint 都在此页

Google 则要在 GCP 控制台启用 Custom Search API 并建一个搜索引擎：

启用 Custom Search API 并创建密钥

拿到密钥后在 UI 的设置页填写即可，不用手改 config.toml。什么都不想申请就直接选 DuckDuckGo，开箱即用。详细步骤见 docs/Installation/search_engine.md。

再把你的资料写进知识库

Devika 在 src/experts/ 内置了一组领域专家，覆盖 web-design、stackoverflow、math、physics、chemistry 等场景。自己的资料也能写进知识库：

from src.memory.knowledge_base import KnowledgeBase kb = KnowledgeBase() kb.add_knowledge("e-commerce", "站点用 React 18 + Tailwind，币种统一美元")

预期：知识写入本地 SQLite，任务执行时可按标签取出。

两个可直接复制的 Devika 实操案例

案例一：搭一个网页

新建项目后输入最短指令：

创建一个响应式电商首页，使用 Tailwind CSS 和 React

预期：data/projects/ 下生成一套产物，含页面组件、样式与 README。配好 Netlify 密钥后可让它直接部署出公网地址。

案例二：数据分析

数据类任务同样一句话描述：

读取目录下的 sales.csv，画出销量前十品类柱状图并输出统计摘要

预期：产出绘图脚本、图片文件与文字摘要。想快速迭代可切到 Ollama 本地模型，免密钥、数据不出本机。

⚡ 模型选择与安全：让 Devika 又快又稳

模型怎么选，看这张表：

安全上守住三条：代码执行留在 src/sandbox/ 沙箱里；config.toml 满是密钥，别提交进版本库；需要换 Key 时直接在 UI 设置页替换。项目仍处于实验阶段，跑大任务前备份一下 data 目录。官方 README 提到第二代版本已在路上，值得持续跟进。

• 你已经跑通"规划 → 检索 → 编码 → 修补"的完整闭环，只需在网页界面盯着它干活。
• 变领域专家只有两个抓手：搜索引擎 API 与知识库。
• 效果不稳时先看智能体状态日志，SQLite 里全都记着。

【免费下载链接】devikaDevika is the first open-source implementation of an Agentic Software Engineer. Initially started as an open-source alternative to Devin.项目地址: https://gitcode.com/GitHub_Trending/de/devika