📖 Vermes 使用指南

Vermes 全面使用说明

**Vermes** — 开箱即用的桌面 AI 助手，零配置即可开始对话。

|

📋 目录

快速开始

三步开始对话

1. 下载安装 → 双击安装包

2. 打开 Vermes → 自动进入对话界面

3. 输入问题 → 开始聊天

微信扫码登录即可免费体验，无需单独注册。

下载安装

Windows

1. 访问 https://vbit.top

2. 点击 Windows 安装包 下载 (Vermes-Setup-x64.exe, ~58MB)

3. 双击安装包 → 按向导完成安装

4. 桌面出现 Vermes 图标，双击即可使用

系统要求： Windows 10/11 64位

macOS (Apple Silicon)

1. 访问 https://vbit.top

2. 点击 macOS 安装包 下载 (Vermes--macos-arm64.dmg, ~56MB)

3. 双击 DMG → 拖动 Vermes 到 Applications 文件夹

4. 首次打开可能提示"无法验证开发者"：

- 进入 系统设置 → 隐私与安全性

- 找到 Vermes，点击 仍要打开

系统要求： macOS 12.0+ (M1/M2/M3/M4 芯片)

免费试用

Vermes 提供免费体验，微信扫码登录即可使用：

项目	说明
每日积分	100 积分
默认模型	DeepSeek Chat (高性能中文模型)
有效期	持续三个月
是否需要注册	微信扫码登录（免费）

积分用完了怎么办？

三种方式继续使用：

1. 微信扫码续杯 — 扫码关注公众号，每日积分提升至 500 积分

2. 配置自己的 API Key — 使用 DeepSeek、小米 MiMo 等模型的自有 Key

3. 明天再来 — 每日额度自动重置

配置自己的模型

支持的模型提供商

提供商	模型示例	获取 Key
DeepSeek	deepseek-chat, deepseek-reasoner	https://platform.deepseek.com
小米 MiMo	mimo-v2.5-pro	https://mimo.xiaomi.com
通义千问	qwen-turbo, qwen-plus	https://dashscope.console.aliyun.com
OpenAI	gpt-4o, gpt-4.1	https://platform.openai.com
Anthropic	claude-sonnet-4	https://console.anthropic.com
Google Gemini	gemini-2.5-pro	https://aistudio.google.com
OpenRouter	100+ 模型聚合	https://openrouter.ai
Ollama	本地模型	https://ollama.com

配置步骤

1. 点击左下角 ⚙️ 设置

2. 找到你的模型提供商

3. 点击展开，输入 API Key

4. 点击 🔄 同步模型 获取可用模型列表

5. 点击模型旁边的 ✓ 设为当前

设置 max_tokens（输出上限）

在设置页面顶部的 ⚙️ 模型设置 区域：

- 不设置（推荐）— 让模型自己决定输出长度

- 设置固定值 — 如 8192，控制输出长度和成本

核心功能

💬 智能对话

- 多轮对话 — 自动记住上下文

- 流式输出 — 实时显示回复，打字机效果

- Markdown 渲染 — 代码高亮、表格、列表

🖼️ 图片识别

- 拖拽上传 — 直接拖拽图片到输入框

- 多图支持 — 一次可上传多张图片

- 上下文保留 — 最近 5 条图片保持在对话中

📎 文件上传

支持以下格式：

格式	说明
PDF	自动提取文字内容
DOCX	Word 文档内容提取
XLSX	Excel 表格数据提取
TXT/MD	纯文本直接读取
JSON/YAML	结构化数据
图片	PNG/JPG/GIF/WebP

使用方法： 点击输入框左侧的 📎 图标，或直接拖拽文件到输入框。

🧠 Agent 工具调用

Vermes 内置 AI Agent，可以：

- 🔍 搜索网络 — 实时获取最新信息

- 📁 读写文件 — 操作本地文件

- 💻 执行代码 — 运行 Python/Shell 脚本

- 🌐 浏览网页 — 访问和分析网页内容

📚 会话管理

- 多会话 — 左侧边栏创建和切换会话

- 会话历史 — 自动保存所有对话记录

- 搜索会话 — 快速查找历史对话

- 导出会话 — 导出为 Markdown 文件

- 右键菜单 — 右键点击会话可重命名、删除、移动到分组（最常用操作）

🔄 自更新

Vermes 支持自动更新：

1. 有新版本时，右上角显示更新提示

2. 点击 立即更新

3. 自动下载 → 安装 → 重启

设置说明

提供商配置

在设置页面可以：

- 添加/删除模型提供商

- 配置自定义 Base URL（支持私有部署）

- 管理 API Key

- 同步可用模型列表

模型设置

- max_tokens — 控制单次回复最大长度

- 不设置 = 让模型自己决定（推荐）

- 设置值 = 如 4096（约 2000 中文字）

微信登录

- 扫码关注公众号，解锁更多额度

- 登录后自动同步配置

常见问题

Q: 白屏 / 打不开？

Windows：

- 确保系统是 Windows 10/11 64位

- 尝试以管理员身份运行

- 检查杀毒软件是否拦截

macOS：

- 进入系统设置 → 隐私与安全性 → 仍要打开

- 如果提示"已损坏"，运行：sudo xattr -r -d com.apple.quarantine /Applications/Vermes.app

Q: 对话没有回复？

1. 检查网络连接

2. 检查 API Key 是否正确配置

3. 检查积分是否用完

4. 查看设置页面的模型状态

Q: 图片识别不工作？

- 确保使用支持视觉的模型（如 DeepSeek Chat、GPT-4o、Claude Sonnet）

- 图片大小不超过 10MB

- 支持 PNG/JPG/GIF/WebP 格式

Q: 子 Agent 调用失败？

- 确保 API Key 有足够额度

- 检查 Base URL 配置是否正确

- 子 Agent 会继承父 Agent 的凭证配置

Q: 如何清除缓存？

1. 打开设置

2. 点击 清除所有本地配置

3. 重启 Vermes

Q: 如何卸载？

Windows：

- 控制面板 → 程序 → 卸载 Vermes

macOS：

- 直接从 Applications 删除 Vermes.app

- 用户数据在 ~/.vermes/ 目录，可手动删除

高级功能

自定义系统提示词

在新会话中可以设置自定义系统提示词，定制 AI 的行为方式。

快捷键

快捷键	功能
`Enter`	发送消息
`Shift + Enter`	换行
`Ctrl/Cmd + K`	新建会话
`Ctrl/Cmd + /`	搜索会话

配置文件位置

平台	路径
Windows	`C:\Users\<用户名>\.vermes\`
macOS	`~/.vermes/`

主要文件：

- config.yaml — 模型和提供商配置

- .env — API Key 和敏感配置

- sessions/ — 会话数据

模型推荐

场景	推荐模型	说明
日常对话	DeepSeek Chat	性价比最高
编程开发	DeepSeek Chat	代码能力强
复杂推理	DeepSeek Reasoner	深度思考
图片识别	GPT-4o / Claude Sonnet	视觉能力最强
免费使用	MiMo-V2.5-Pro	倍率 0.00，积分不扣，等于无限

反馈与支持

- GitHub: https://github.com/donghzs/vermes

- 公众号: 胜比特

- 官网: https://vbit.top

**Vermes** — 让 AI 触手可及。

← 返回产品页