> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 从下载到第一个任务交付，5 分钟体验完整流程。

QoderWork 是一款本地运行的桌面应用，更像一位真正能"把活干完"的 AI 队友，而不只是聊天工具。这篇指南会带你走完一遍完整流程：下载安装、登录账号、熟悉工作界面，最后亲手提交第一个任务。

读完这一页，你的电脑上会有一份可用的 QoderWork、一个登录好的账户，以及一项正在本地运行的真实任务。

## 1. 下载 QoderWork

在浏览器中打开 [qoderwork.com](https://qoderwork.com/)，点击对应你系统的 macOS 或 Windows 按钮下载安装包。

<Frame>
  <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-download-page-zh.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=c6a5cbefea3cb10ede325034a89922de" alt="Qoder 下载页：QoderWork 区块同时提供 macOS 与 Windows 安装包" width="2000" height="1182" data-path="images/qoderwork-download-page-zh.png" />
</Frame>

目前支持两个平台：

* **macOS 14 及以上**，同时兼容 Apple Silicon 和 Intel 芯片。
* **Windows 10 及以上**，仅 64 位版本。

请确认磁盘空间至少 500 MB，并保持网络稳定——QoderWork 在使用过程中会从云端拉取模型、技能与连接器。

<Note>
  **Windows** 安装包分 **系统版**（为电脑上所有用户安装，需要管理员权限）和 **用户版**（仅为当前用户安装，无需管理员权限）——没有管理员权限就选用户版。**macOS** 安装包则按芯片区分(Apple Silicon / Intel),下载页会自动标出与你的 Mac 匹配的版本。详见 [Windows 安装指南](/zh/qoderwork/install-windows) 或 [macOS 安装指南](/zh/qoderwork/install-macos)。
</Note>

<Tabs>
  <Tab title="macOS">
    下载完成后，双击 `.dmg` 文件，将 **QoderWork** 图标拖入 **Applications** 文件夹。等待拷贝结束后弹出磁盘映像，然后从启动台或 `/Applications/QoderWork.app` 启动应用。

    首次启动时，macOS 可能提示"应用来自互联网"或"无法验证开发者"。前往 **系统设置 → 隐私与安全性**，下拉到底部找到 QoderWork 的提示，点击 **仍然打开** 即可。这一步只会出现一次。
  </Tab>

  <Tab title="Windows">
    运行 `.exe` 安装包，按默认选项一路下一步即可。安装完成后，可以在开始菜单和桌面找到 QoderWork 的快捷方式。

    如果 SmartScreen 提示"未识别的发布者"，点击 **更多信息 → 仍要运行** 继续即可。
  </Tab>
</Tabs>

## 2. 登录账号

首次启动 QoderWork 时，会出现欢迎页提示你登录。左侧是 **登录/注册** 按钮、语言切换，以及用于配置代理的 **网络设置** 入口；右侧展示产品标语。

<Frame>
  <img src="https://mintcdn.com/qoder/s6dTwci-_mbx57qw/images/qoderwork-sign-in-zh.png?fit=max&auto=format&n=s6dTwci-_mbx57qw&q=85&s=ef6823c0a788a42741b87c543dec996c" alt="QoderWork 欢迎页，左侧为登录/注册、语言切换与网络设置" width="1540" height="920" data-path="images/qoderwork-sign-in-zh.png" />
</Frame>

点击 **登录/注册** 在浏览器中完成认证，回到 QoderWork 后会自动进入主界面。已登录用户则会直接跳过这一步，本机的历史任务也会被自动恢复。

<Note>
  历史任务保存在本地设备，不会跨设备同步。换一台电脑登录，不会看到此前在其他设备上的历史任务。
</Note>

QoderWork 与 Qoder 桌面端、Qoder CLI 等其他 Qoder 产品共用同一套账户体系，因此 Credits 余额和会员权益会在所有产品之间共享。

## 3. 认识工作界面

QoderWork 主窗口由两部分组成：左侧是垂直的导航侧边栏，右侧是承载对话、任务监控和产物的工作区。

<Frame>
  <img src="https://mintcdn.com/qoder/s6dTwci-_mbx57qw/images/qoderwork-sidebar-entry-zh.png?fit=max&auto=format&n=s6dTwci-_mbx57qw&q=85&s=4150a184f2a0878eb9e6bbf727bf8869" alt="QoderWork 主窗口，左侧为导航侧边栏，右侧为新任务工作区" width="2000" height="1212" data-path="images/qoderwork-sidebar-entry-zh.png" />
</Frame>

侧边栏自上而下集中了高频入口：**新任务**、**扩展**（专家套件 / 技能 / 连接器）、**定时任务**、**IM 频道**，以及 **任务 / 频道** 历史的切换；左下角是 **账户区域** 和 **设置** 齿轮。

每个入口的详细介绍——包括账户快捷菜单——见 [界面布局](/zh/qoderwork/ui-overview)。

## 4. 跑通第一个任务

万事俱备，下面就来让 QoderWork 真正干一件活。点击侧边栏中的 **新任务**，进入任务编辑界面。

界面是一个干净的画布，主标题写着 **"不止聊天，搞定一切"**，下方是一个输入框。第一次跑任务，保持默认的 **通用工作台 + 标准模型** 就够用，用一段以"想要什么结果"为出发点的描述，按下 **回车**：

```plaintext theme={null}
帮我调研一下目前市面上的 AI 桌面助手产品，包括 QoderWork、
Cursor、Windsurf、GitHub Copilot。
分别整理每个产品的核心功能、定价模式和目标用户。
汇总成一张对比表格，并导出为 Excel 文件。
```

<Frame>
  <img src="https://mintcdn.com/qoder/hjCzjGvcnHE5UJIx/images/qoderwork-new-task-flow-zh.png?fit=max&auto=format&n=hjCzjGvcnHE5UJIx&q=85&s=2f8fe30019a1c0e2e73d72b43fe0385e" alt="QoderWork 空状态界面：上方是主标题「不止聊天，搞定一切」与副标题「本地运行、自主规划、安全可控的 AI 工作搭子」，下方输入框中已填入一段调研 Prompt，左下选择「通用」工作台、右下选择「标准」模型，输入框下方还有「选择工作目录」按钮" width="2000" height="1127" data-path="images/qoderwork-new-task-flow-zh.png" />
</Frame>

从这一刻起，你只需要观察、回答澄清问题、收取产物，不用自己操心每一步该怎么做。

工作台、模型选择以及选择工作目录的详细用法见 [任务对话](/zh/qoderwork/chat-basics)。

### 按下回车之后会发生什么

<Steps>
  <Step title="澄清问题（视情况而定）">
    遇到复杂或不够明确的需求时，QoderWork 不会立刻动手，而是先抛出一两个澄清问题，例如：*"是否需要把开源同类产品也包含进来？"* *"价格用美元还是本地货币？"* 先花十几秒澄清，能省掉之后大段的返工。直接在同一个对话里回答即可，回复送达后任务正式开始。如果需求本身已经足够清晰，这一步会自动跳过。
  </Step>

  <Step title="任务监控">
    任务执行过程中，工作区会一分为二：左侧仍是对话，展示 AI 的解释和阶段性回复；右侧的 **任务监控** 会实时显示真正的执行内容——任务计划、产物、当下使用的 **技能 & MCP** 服务。

    <Frame>
      <img src="https://mintcdn.com/qoder/s6dTwci-_mbx57qw/images/qoderwork-task-monitor-zh.png?fit=max&auto=format&n=s6dTwci-_mbx57qw&q=85&s=459758fbaf7db2a3d75e50d03083d59c" alt="任务监控面板：右侧展示调研 AI 桌面助手任务的待办计划、产物以及使用中的 技能与 MCP" width="2000" height="1212" data-path="images/qoderwork-task-monitor-zh.png" />
    </Frame>

    一切都是透明的——你看到的不只是答案，而是 QoderWork 是怎么得到这个答案的。如果中途发现方向不对，直接在对话里追加一句话即可——它会排入队列，等当前这一轮结束后接着执行，QoderWork 会保留完整上下文，不必从头再来。
  </Step>

  <Step title="收取产物">
    任务结束后，QoderWork 会同时给你两件东西：一段在对话里的总结，说明它都做了什么；以及一个或多个 **产物**——具体的可下载文件，比如这次要的 Excel 表格。产物是真实的本地文件，直接创建并保存在你电脑上，可随时打开、编辑或转移。

    <Frame>
      <img src="https://mintcdn.com/qoder/s6dTwci-_mbx57qw/images/qoderwork-task-result-zh.png?fit=max&auto=format&n=s6dTwci-_mbx57qw&q=85&s=3352aa451f7e22db8fe26168624d0f36" alt="完成后的任务：对话区给出对比总结、AI-Desktop-Assistants-Comparison.xlsx 产物卡片和信息来源链接" width="2000" height="1212" data-path="images/qoderwork-task-result-zh.png" />
    </Frame>

    点击产物卡片可以直接预览或下载。产物会一直附着在这个任务上，之后从侧边栏的 **任务** 能找回来。
  </Step>
</Steps>

<Tip>
  对结果不满意？不用重来，直接在同一个对话里继续说就行。比如 *"按价格从低到高排序"* 或 *"再加一列免费版的额度限制"*。QoderWork 会基于完整的任务上下文继续修改产物，迭代效率非常高。
</Tip>

## 三个需要记住的概念

下面这三个词会贯穿整个产品。理解了它们，你看 QoderWork 的任何界面都会清楚很多。

| 概念                     | 含义                            | 出现在哪里                      |
| ---------------------- | ----------------------------- | -------------------------- |
| **澄清（Clarification）**  | 任务开始前的简短确认，用来对齐模糊的需求。         | 对话中，刚提交任务之后。               |
| **任务监控（Task Monitor）** | 实时展示计划、工具调用、使用的技能和被操作文件的执行面板。 | 任务运行时，工作区右侧。               |
| **产物（Artifacts）**      | 任务输出的具体文件——表格、幻灯片、报告、代码等。     | 任务结束后的对话区，以及历史 **任务** 列表中。 |

## 下一步

<CardGroup cols={2}>
  <Card title="典型案例" icon="lightbulb" href="/zh/qoderwork/use-cases">
    现成的提示词模板，按场景挑一个直接试。
  </Card>

  <Card title="用户案例" icon="users" href="/zh/qoderwork/user-stories">
    看看其他 QoFounder 如何用 QoderWork 解决实际问题。
  </Card>

  <Card title="界面布局" icon="airplay" href="/zh/qoderwork/ui-overview">
    熟悉 QoderWork 的窗口结构与各功能区域。
  </Card>

  <Card title="任务对话" icon="comments" href="/zh/qoderwork/chat-basics">
    了解如何与 QoderWork 高效对话——附件、上下文与结果查看。
  </Card>
</CardGroup>
