入门
这篇指南会带你完成 Deskmate 的第一次成功体验：安装应用、连接模型、创建 Agent，并让它完成一个简单任务。整个流程大约需要 5 分钟，最终你会从“刚安装”走到“创建 Agent 并发送第一条任务”。
Deskmate 当前处于早期开发阶段。首次使用建议选择可恢复的测试任务，不要把唯一重要数据只保存在预览版本中。
前置条件
开始之前，请确认你具备以下条件：
- 一台 macOS 或 Windows 桌面设备。
- 已下载并安装 Deskmate。
- 至少一个可用模型 provider 凭证或登录方式。
- 可选：一个你愿意让 Agent 读取的测试文件夹。
不确定模型 provider 怎么配置？先完成安装，再到“设置 → Provider”中查看应用内支持的 provider 和模型列表。
Step 1：下载安装
前往下载页，选择适合你系统的版本。macOS 版本面向 Apple Silicon；Windows 用户通常选择 x64。
下载 Deskmate →
/download
安装提示：
- macOS：首次打开可能出现系统安全提示。
- Windows：早期版本可能触发 SmartScreen。
Step 2：首次启动
启动 Deskmate 后，应用会准备本地 profile、数据目录和运行时状态。默认数据目录位于 ~/.deskmate/。
几个你会反复遇到的概念：
- Profile：承载设置、凭证和 Agent。
- Agent：你的专用 AI 工作单元。
- Session：一次普通聊天或任务执行记录。
这里不必深入架构细节。
想了解数据位置？阅读 数据与隐私。
Step 3：连接模型 provider
Deskmate 需要模型 provider 执行 AI 推理。进入 Settings / Provider，选择你要使用的 provider，并按应用内提示完成 OAuth 或 API key 配置。
注意：
- 具体 provider 和模型以应用内列表为准。
- 不同模型支持的工具、图片、reasoning 能力不同。
- 凭证保存在本地 profile 中。
故障提示：
- 如果模型调用提示未认证，回到 Provider 设置检查登录状态。
- 如果模型不支持工具，换用支持工具调用的模型。
阅读 模型与认证 文档。
Step 4：创建第一个 Agent
推荐从一个默认 Agent 开始，名称设为 Project Helper。
System prompt 示例：
你是我的项目助手。回答时先给结论，再列出依据和下一步。涉及文件或命令时，先说明计划，再执行。不要假设未读取过的文件内容。配置建议：
- 选择一个支持工具调用的模型。
- 初始不必连接太多 MCP server。
- 先只给它一个明确任务域。
Agent 不是一次性 prompt。它会逐步承载固定任务域的提示词、知识、工具和自动化配置。
Step 5：发送第一条任务
下面三段任务可以直接复制到对话框，挑一个开始即可。
推荐任务 1：非破坏性文件理解
请介绍这个项目的目录结构，并告诉我从哪里开始阅读。不要修改任何文件。推荐任务 2：研究型任务
帮我整理一份 MCP 是什么的简短说明，列出它适合连接哪些工具和服务。推荐任务 3：Agent 配置任务
根据我的目标"每周整理项目风险"，帮我设计一个专用 Agent 的 system prompt 和工作流程。第一次任务建议选择只读或规划型任务，确认模型、工具和输出风格正常后，再让 Agent 执行文件修改或 shell 命令。
Step 6：添加知识材料（可选）
如果你希望 Agent 长期记住项目规范、个人偏好或背景资料，可以把它们添加为 Agent knowledge。
适合放入：
- 项目 README。
- 代码风格约定。
- 产品背景。
- 常见命令。
- 个人输出偏好。
不建议放入：
- 未脱敏密钥。
- 不想发送给模型 provider 的敏感资料。
- 大量无关文件。
Step 7：连接 MCP server（可选）
MCP server 可以让 Agent 访问外部工具和数据源。初次使用建议只连接你明确需要且来源可信的 server。
流程：
- 打开 MCP 设置。
- 添加 server。
- 完成必要授权。
- 在 Agent 配置中启用该 server。
- 发送一个只读测试任务。
阅读 MCP 指南。
常见问题
一定要登录 provider 吗？
需要至少一个可用模型 provider，否则 Agent 无法生成回复。具体 provider 以应用内列表为准。
第一次应该连接 MCP 吗？
不必。建议先完成基础聊天和 Agent 创建，再按任务需要连接 MCP。
Agent 能修改我的文件吗？
在工具和权限允许的范围内可以。首次使用建议先做只读任务，并要求 Agent 在修改前说明计划。
数据在哪里？
默认在本机 ~/.deskmate/。阅读 数据与隐私 文档了解详情。