下载、安装与第一次连接
选择正确的客户端和浏览器扩展，完成安装、登录、建库与首次网页采集。
这篇指南适合第一次使用 DraPub 的用户。完成后，你会拥有一个可以工作的 DraPub 客户端、一个知识库，以及一份从浏览器采集进来的真实素材。
安装包尚未公开的平台会在下载中心明确显示“即将提供”。请不要从聊天群、网盘或第三方镜像安装来历不明的文件。
先决定要安装什么
| 你的需求 | 建议安装 |
|---|---|
| 在电脑上整理素材、写作和审核 | macOS、Windows 或 Linux 客户端 |
| 保存正在浏览的网页 | 浏览器扩展 |
| 把已审核内容放进平台草稿箱 | 客户端或 Web + 浏览器扩展 |
| 只使用在线工作区 | Web 控制台，扩展按需安装 |
桌面客户端是完整工作台，浏览器扩展是它的采集和草稿交付助手。多数用户适合两者都安装。
第一步：下载正确的客户端
打开下载中心，找到你的系统。
- M1、M2、M3、M4 或后续 M 系列 Mac，选择 macOS · Apple silicon。
- 较早的 Intel 处理器 Mac，选择 macOS · Intel。
- 普通 64 位 Windows 电脑，选择 Windows x64。
- 64 位 Linux 电脑，选择与你的发行版匹配的 AppImage 或 DEB。
Mac 用户如果不确定芯片类型，打开系统的“关于本机”，查看“芯片”或“处理器”。下载按钮显示“即将提供”时，说明正式安装包还没有通过发布流程，不是浏览器故障。
第二步：核对文件并安装
- 确认文件名中的系统与架构和你的设备一致。
- 页面提供校验值时，先核对下载文件，再打开安装包。
- 按系统安装向导完成安装。
- 从系统应用列表启动 DraPub，不要反复运行安装文件。
如果系统警告显示的开发者、签名状态或文件来源与官网发布说明不一致，请停止安装并重新从下载中心获取。
第三步：登录并选择工作区
打开客户端后登录 DraPub 账户，然后选择工作区：
- 内容只保存在当前设备、希望离线也能打开：选择本地工作区。
- 需要在 Web、其他设备或团队成员之间使用：选择在线工作区。
本地工作区的数据保存在设备 SQLite 中，不会因为登录而自动上传。在线工作区通过 DraPub Cloud 同步。工作区保存在哪里，与 Agent 在本地还是云端运行是两件事。
看到客户端首页和当前工作区名称，说明登录和工作区初始化完成。
第四步：创建第一个知识库
进入知识库，选择新建知识库。名称尽量描述长期主题，例如“产品教程素材”或“品牌内容研究”，不要使用“临时”“新建文件夹”这类过几天就看不懂的名称。
第一次使用只建一个知识库即可。创建完成后，你应当能在知识库列表中看到它，并能打开空的知识库概览。
第五步：安装浏览器扩展
- 从下载中心进入扩展商店或下载 ZIP。
- 按浏览器要求完成安装，并把 DraPub 固定到工具栏。
- 登录 Web 控制台，让扩展建立 DraPub 会话。
- 打开一篇你有权保存的网页。
- 点击 DraPub 扩展，检查标题、正文预览和来源地址。
- 选择刚创建的知识库，然后确认采集。
扩展只把你确认的页面内容交给 DraPub。平台 Cookie、token 和 ticket 不会上传到 DraPub Backend。
如何判断第一次连接成功
回到 DraPub，打开收集箱。你应当看到刚采集的素材，并看到以下一种状态：
- 处理中：正在解析正文或媒体，稍后刷新状态。
- 可用：正文已经可以预览，可以加入知识库并用于创作。
- 失败：保留了失败原因，按提示重试或改用文件、链接方式导入。
打开素材，核对标题、来源地址和正文开头。三项都正确，并且素材已经加入目标知识库，就完成了第一次连接。
常见问题
安装包打不开
先确认系统和 CPU 架构是否选错，再确认文件是否完整。不要通过修改扩展名或关闭全部系统安全功能来强行安装。
扩展里没有可选知识库
确认你登录的是同一个 DraPub 账户和在线工作区。本地工作区不会自动出现在 Web 扩展的云端列表中。
网页正文为空或混入评论
动态页面优先使用扩展从当前页面采集。提交前检查预览；范围明显不对时不要确认，可以改用链接导入，或把需要的内容整理成文件再上传。
换电脑后看不到本地内容
这是本地工作区的预期行为。本地工作区不会自动上传。需要跨设备访问的内容应放在在线工作区。
继续完成10 分钟快速开始，从这份素材生成第一篇母稿。