sqfcyily / deva

**简体中文** | English
# Deva
**对话式 AI 助手 · All in Chat**
把 Agent 能力装进对话里，无需复杂配置，像聊天一样使用 Agent。 
挂载文件夹即可阅读代码、修改文件、执行命令；定时任务按时自动运行，离开电脑也能在手机上继续对话。
 下载 ·
 快速开始 ·
 功能一览 ·
 使用须知 ·
 从源码运行 
---
## ✨ 亮点
 🗣️ All in Chat 
 要做的事都在对话里说一句：建角色、建定时任务、记住习惯、挂载文件夹……不用翻设置页，你点个确认就办好。
 🎭 多角色，各有所长 
 内置全能助手 Deva 和安全研究专家小码酱；也能自己建角色，每个都有独立的性格、头像和常用模型。
 🤖 子智能体，自动派发多 Agent 
 大任务自动拆开，派给多个子智能体并行跑，不急着要结果的还能放到后台；内置通用、检索、调研、方案四种，各有独立上下文，只把结论交回来。
 ⏪ 改坏了能退回去 
 /rewind 回到任意一轮之前，代码、对话可分开恢复，回退了还能撤销。
 ⏰ 定时任务 
 一句话建任务，到点自动跑，跑完弹通知；支持每天、每周、每月、cron。
 📱 IM 里接着聊 
 把常用的聊天工具接进来，人不在电脑前，用手机发消息就是在电脑上的 Deva 里对话。
---
## 🚀 快速开始
1. 到 Releases 下载安装包并安装（见下方 安装）
2. 打开 **设置 → 模型**，选一个服务商，填上 API 密钥，把要用的模型加进来
3. 回到对话，在输入框上方选模型，就可以开始聊了
已预置的服务商：
其他兼容 OpenAI 接口的服务可以自己添加。
---
## 📖 功能一览
### 🗣️ All in Chat：要做的事，说一句就行
Deva 的大部分功能都能直接在对话里完成，不用去翻设置页、填表单：
| 你说 | 它做 |
| --- | --- |
| 「帮我建一个写周报的角色，语气正式一点」 | 一步步问清楚，给你一张角色名片确认 |
| 「每天早上 9 点把昨天的提交整理成日报」 | 生成一张任务卡片，你核对后就建好了 |
| 「记住：我习惯用 pnpm」 | 记下来，以后每次对话都会参考 |
| 「帮我看看 my-app 项目的代码」 | 请你挂载这个项目的文件夹，挂上就围绕它干活 |
建角色、建定时任务、挂载文件夹这类事，它会先给你一张卡片，你点确认才生效。
### 🎭 多角色，各有所长
每个对话都会跟一个「角色」聊。角色不只是换个名字：它有自己的性格、说话风格和常用模型，同一个问题交给不同的角色，会得到不同视角的回答。开新对话时选好角色，这个对话就一直由它负责。
**内置角色，开箱即用：**
| 角色 | 擅长 | 风格 |
| --- | --- | --- |
| **Deva** | 全能型工作助手：编程、写作、查资料、整理文件、数据分析、跑命令，样样能上手 | 亦师亦友，简洁有力、亲切自然；发现你的想法有问题会温和指出，给出更好的建议 |
| **小码酱** | 红队 / 安全研究与逆向工程，兼顾全栈开发与深度技术 | 技术宅的硬核风格，适合钻研底层、啃难题 |
> [!NOTE]
> **关于小码酱：** 角色提示词来自 YuJunZhiXue/dsh-purge，**仅对国产模型生效**（如 DeepSeek、Kimi、智谱 GLM、通义千问），在其他模型上效果不保证。提示词需要更新时，可以关注该项目。
**自己建角色：** 给它起名字、写性格和说话风格、定一个常用模型，头像可以捏也可以传图片。懒得填表的话，点「通过对话添加」，或者直接在对话里说「帮我建一个……的角色」，它会一步步问你，最后给你一张角色名片确认。
角色列表可以拖拽排序、置顶，暂时用不上的可以先停用。
### 💬 像聊天软件一样用
左边是对话列表，聊天里可以附上图片、PDF、代码或文本文件（模型能不能看图，取决于你选的模型）。回复里的代码有高亮和复制按钮，长对话右边有目录可以跳转。
### 🛠️ 给它一个文件夹，让它干活
不挂文件夹时，它是个面向整台电脑的通用助手；挂上一个文件夹，它就会围绕这个项目工作：
- 🔍 找文件、搜内容、读代码
- ✏️ 新建和修改文件
- ▶️ 运行命令（装依赖、跑测试、打包之类）
- 🌐 打开你给的网页链接读内容
事情比较大的时候，它会先看一圈，列个计划给你，你点「批准并执行」它才开始动手，不满意可以让它接着改计划。中途遇到需要你拍板的地方，它会弹出选项让你选，也可以自己输入答案。
步骤多的活儿它会列一张待办清单，边做边勾：输入框上方的小胶囊显示当前进度，点开能看全部条目，不想做了可以点「取消清单」。全部做完后，对话里留一张「已完成清单」卡片。
> [!TIP]
> 如果项目根目录有 `AGENTS.md`，它会当成项目说明来读，按里面的约定做事。
### 🤖 子智能体：把大任务拆开并行跑
遇到要翻很多文件、或者能拆成几块互不相关的活儿时，它会派出几个「子智能体」同时去做，自己只负责分派和汇总：
| 子智能体 | 干什么 | 能动手吗 |
| --- | --- | --- |
| **General** | 通用型，按交代的任务独立完成一件事 | 能，工具和主对话一样 |
| **Explore** | 在代码库或文件夹（文档、笔记、数据）里广撒网地找：在哪、有几处、怎么命名的，逐条回报「路径:行号」 | 只读，不改文件 |
| **Research** | 查官方文档、更新日志和开源源码，回答第三方库 / 工具怎么用、哪个版本改了什么，结论附出处链接 | 只读，不改文件 |
| **Plan** | 先摸清现状，再写出分步实施方案、关键文件和取舍 | 只读，只出方案 |
- 🪞 **要不要带前文**：上面这几种都从零开始，只看交代给它的任务；得先了解来龙去脉的活儿，它会派一个「分身」，带着当前对话的全部前文、同一套工具和模型去做，中间过程照样不进主对话
- ⚡ **真并行**：互不依赖的子任务在同一轮一起发出，一起跑
- 💬 **能接着聊**：派出去的子智能体做完了还能再找它，它记得之前查过、做过什么，追问或补一段任务不用从头来
- 🌙 **后台运行**：不急着要结论的活儿，它会把子智能体放到后台跑，自己接着干别的或先回你；后台跑完会自动通知它，对话里多出一行完成通知，它再接着处理。卡片上的「停止」按钮可以单独停掉某个后台子智能体（主对话的停止键不会停它）
- ♾️ **不限步数**：子智能体不设工具调用步数上限，大范围检索、长任务一路跑到做完
- 🧹 **不占主对话**：每个子智能体有自己独立的上下文，中间翻过的文件、跑过的命令都不进主对话，只把结论交回来
- 🔍 **过程看得见**：每个子智能体的过程折叠成一张卡片，可以点开看它查了什么
- 🧠 **模型跟着走**：子智能体用的就是当前对话选的模型，不用另外配置
### ⏪ 改坏了可以退回去
输入 `/rewind`（或者连按两次 Esc 、在聊天区右键「回到此处」），选一轮，就能回到这一轮开始之前。可以只恢复代码、只恢复对话，或者两个一起。回退完