外观
下载与安装
系统要求
| 系统 | 要求 | 安装包 |
|---|---|---|
| macOS | macOS 12.0 及以上，Apple 芯片（M 系列） | .dmg |
| Windows | Windows 10 21H2 及以上 / Windows 11，64 位（x64） | .exe 安装程序 |
- 暂不提供 Linux 版本和 Intel 芯片的 Mac 版本。
- 安装包经过签名校验。请只从 秩一官网 下载，各平台的最新可用情况以官网为准。
在 macOS 上安装
- 从官网下载
.dmg安装包并双击打开。 - 将「小一智能体」图标拖入「应用程序」文件夹。
- 在启动台或「应用程序」中打开小一智能体。
macOS 版本已经过 Apple 公证。如果系统仍提示无法验证开发者，请确认安装包来自官网，然后在 系统设置 → 隐私与安全性 中选择「仍要打开」。
在 Windows 上安装
- 从官网下载安装程序并双击运行。
- 选择安装语言（简体中文 / English），按向导完成安装。
- 从开始菜单或桌面快捷方式打开小一智能体。
安装说明：
- 小一安装在当前用户目录（
%LOCALAPPDATA%\Programs\Z1X-Agent），不需要管理员权限。 - 小一依赖系统的 WebView2 组件。Windows 11 已自带；如果电脑上没有，安装程序会自动下载，此时需要联网。
准备运行环境
小一在你的电脑上处理文档、运行代码和生成文件，需要一组本地工具。第一次启动时，小一会弹出「准备运行环境」对话框，自动在当前用户目录下安装以下组件：
- Git、Python
- 文档工具、LibreOffice、Noto 字体、LaTeX
- Chromium（用于网页渲染和截图）
| 按钮 | 作用 |
|---|---|
| 开始准备 | 立即准备，通常需要 1–2 分钟 |
| 继续浏览，后台安装 | 关闭对话框，准备在后台继续 |
| 稍后再说 | 暂不准备，需要时再安装 |
这些组件只为小一使用，不会修改你系统中已有的 Python 或其他软件。
检查与修复
打开 设置 → 版本与运行环境，可以看到「基础运行环境」和「文档处理环境」的状态：
| 状态 | 含义与处理 |
|---|---|
| 可用 | 环境正常，无需操作 |
| 尚未安装 | 点击准备按钮完成安装 |
| 需要更新 | 新版本需要更新组件，按提示更新 |
| 需要修复 | 组件损坏或不完整，点击「修复运行环境」 |
如果修复仍然失败，展开 高级诊断 → 环境诊断，点击「检查运行环境」，再点击 「复制诊断信息」，把内容通过反馈或邮件发给我们。
更新小一
- 小一每次启动时自动检查更新。发现新版本时会提示「发现新版本」，点击「立即更新」即可下载并安装；也可以选择「稍后」。
- 也可以在 设置 → 版本与运行环境 中点击「检查更新」手动检查。
- 更新完成后，部分版本会要求同步更新运行环境，按提示操作即可。
注意
如果提示「更新下载或安装失败」，请检查网络后重试。也可以从官网重新下载最新安装包覆盖安装，你的项目、任务和数据不会丢失。
卸载
- macOS：退出小一，将「应用程序」中的「小一智能体」移到废纸篓。
- Windows：在 设置 → 应用 → 已安装的应用 中找到「小一智能体」并卸载。
卸载应用不会删除你的数据。项目、任务、数据集和知识库保存在用户目录下的 ~/.z1x/ 中（Windows 为 C:\Users\<用户名>\.z1x\）。如需彻底清除，请在确认已备份后手动删除该目录。