diff --git a/docs/01-getting-started/01-system-requirements.md b/docs/01-getting-started/01-system-requirements.md index a3b0f60..0ea76f4 100644 --- a/docs/01-getting-started/01-system-requirements.md +++ b/docs/01-getting-started/01-system-requirements.md @@ -8,6 +8,10 @@ keywords: [系统要求, 硬件, 操作系统, 兼容性] DesireCore 桌面客户端支持 macOS、Windows、Linux 三大平台。下面列出了各平台的环境要求。 +:::tip 快速判断 +如果你的电脑是近 3 年内购买的，基本都能流畅运行 DesireCore。最低只需要 8 GB 内存和 2 GB 磁盘空间。 +::: + ## 桌面版 ### macOS diff --git a/docs/01-getting-started/02-installation/01-windows.md b/docs/01-getting-started/02-installation/01-windows.md index e7b9d70..f3b7bf0 100644 --- a/docs/01-getting-started/02-installation/01-windows.md +++ b/docs/01-getting-started/02-installation/01-windows.md @@ -8,6 +8,10 @@ keywords: [Windows, 安装, NSIS, SmartScreen] 本指南介绍如何在 Windows 上安装 DesireCore。 +:::tip 预计耗时 +整个安装过程通常只需 **1-2 分钟**（取决于下载速度）。 +::: + ## 安装步骤 1. **下载安装包** @@ -39,13 +43,25 @@ keywords: [Windows, 安装, NSIS, SmartScreen] ## 随安装包提供的本地组件 -Windows 版会随包提供可移植 Git、推荐的 Python/Node.js 运行时归档，以及用于本机 GUI 自动化的 CUA Driver。它们是独立第三方组件，不会要求你提前安装系统 Git、Python、Node.js 或 HostAgent。 +Windows 版会随包提供以下独立第三方组件，不需要你提前安装系统 Git、Python、Node.js 或 HostAgent。 + +### 可移植 Git + +安装包内含便携版 Git。首次启动后，DesireCore 会在系统版本与内置版本中自动选择可用且较新的来源。你也可以在 **资源管理器** → **算力** → **运行环境** 手动切换。 + +### Python / Node.js 运行时 + +DesireCore 会在首次启动后，将推荐的 Python 和 Node.js 版本导入其管理目录（后台完成）。这不会替换你系统全局安装的版本。 -- 首次启动后，DesireCore 会在后台把推荐的 Python 和 Node.js 导入其管理目录；这不会替换系统全局版本。 -- Git 默认在系统版本与内置版本中自动选择可用且较新的来源，你也可以在运行环境页手动切换。 -- CUA Driver 仅用于当前 Windows 电脑的 GUI 自动化，默认启用。它是 Windows HostAgent 完成前的权宜/过渡实现，让 Windows 用户先具备相关能力；macOS 当前仍由 HostAgent 承载 GUI 操作，Windows、Linux 和其他平台的 HostAgent 仍在开发。 +### CUA Driver（GUI 自动化） -这些归档和可执行程序会增加安装包与首次启动后的磁盘占用。安全软件也可能在首次解包或运行时再次扫描它们；请等待扫描完成，不要通过关闭系统防护来强行绕过告警。你可以在 **资源管理器** → **算力** → **运行环境** 查看实际版本与路径。许可和来源说明见 [第三方软件与许可](../../05-more/09-third-party-software.md)。 +CUA Driver 仅用于当前 Windows 电脑的 GUI 自动化，默认启用。它是 Windows HostAgent 完成前的过渡实现，让 Windows 用户先具备 GUI 操作能力。macOS 当前仍由 HostAgent 承载 GUI 操作，Windows、Linux 和其他平台的 HostAgent 仍在开发中。 + +:::note 磁盘占用与安全扫描 +这些归档和可执行程序会增加安装包与首次启动后的磁盘占用。安全软件也可能在首次解包或运行时再次扫描它们；请等待扫描完成，不要通过关闭系统防护来强行绕过告警。 +::: + +你可以在 **资源管理器** → **算力** → **运行环境** 查看实际版本与路径。许可和来源说明见 [第三方软件与许可](../../05-more/09-third-party-software.md)。 ## 处理 Windows SmartScreen 提示 @@ -83,4 +99,10 @@ Windows 版会随包提供可移植 Git、推荐的 Python/Node.js 运行时归 卸载时会提示是否同时删除应用数据。如果你计划重新安装，建议保留数据；如果确定不再使用，可以选择一并删除。 ::: +## 遇到问题？ + +- **安装程序无法打开**：确认文件下载完整（大小约 100-200 MB），尝试重新下载。 +- **杀毒软件拦截**：将 DesireCore 安装目录加入白名单，或暂时关闭实时防护后重试。 +- **其他问题**：前往 [常见问题](../../06-faq/index.md) 或联系支持团队。 + 安装完成后，前往 [首次启动](../03-first-run.md) 了解启动后的引导流程。 diff --git a/docs/01-getting-started/02-installation/02-macos.md b/docs/01-getting-started/02-installation/02-macos.md index 3ea7f2a..6be5cda 100644 --- a/docs/01-getting-started/02-installation/02-macos.md +++ b/docs/01-getting-started/02-installation/02-macos.md @@ -8,6 +8,10 @@ keywords: [macOS, 安装, DMG, Gatekeeper, Apple Silicon, Intel] 本指南介绍如何在 macOS 上安装 DesireCore。 +:::tip 预计耗时 +整个安装过程通常只需 **1 分钟**——下载 DMG、拖入 Applications 即完成。 +::: + ## 安装步骤 1. **下载 DMG 文件** @@ -72,4 +76,11 @@ DesireCore 的安装包已经过 Apple 公证（Notarization），是安全的 ~/.desirecore/ ``` +## 遇到问题？ + +- **DMG 无法打开**：确认文件下载完整，尝试重新下载。 +- **"已损坏，无法打开"提示**：这通常是 Gatekeeper 拦截，按上方"处理 Gatekeeper 提示"操作即可。 +- **Apple Silicon 用户运行缓慢**：确认下载的是 arm64 版本而非 x64 版本（Rosetta 转译会有性能损耗）。 +- **其他问题**：前往 [常见问题](../../06-faq/index.md) 或联系支持团队。 + 安装完成后，前往 [首次启动](../03-first-run.md) 了解启动后的引导流程。 diff --git a/docs/01-getting-started/02-installation/03-linux.md b/docs/01-getting-started/02-installation/03-linux.md index 763ae6e..25f125d 100644 --- a/docs/01-getting-started/02-installation/03-linux.md +++ b/docs/01-getting-started/02-installation/03-linux.md @@ -8,6 +8,15 @@ keywords: [Linux, 安装, AppImage, Ubuntu, Fedora, ARM64, 统信UOS, 银河麒 本指南介绍如何在 Linux 上安装 DesireCore。DesireCore 以 AppImage 格式分发，支持 x64 和 ARM64 架构，兼容大多数主流 Linux 发行版，同时也支持统信 UOS、银河麒麟、深度 Deepin、openKylin 等国产操作系统。 +:::tip 老手速览 +```bash +# 下载后两步即可运行 +chmod +x DesireCore_x86_64_*.AppImage +./DesireCore_x86_64_*.AppImage +``` +如遇沙箱报错，请直接跳到 [常见问题排查](#常见问题排查)。 +::: + :::tip 国产操作系统用户 DesireCore 已在统信 UOS、银河麒麟（Kylin）、深度 Deepin、openKylin 等国产操作系统上完成适配测试。如需了解国产系统专属的安装说明和兼容性信息，请访问 [DesireCore 中国官网](https://www.desirecore.cn)。 ::: @@ -112,6 +121,9 @@ Trace/breakpoint trap (core dumped) 这是因为 DesireCore 基于 Electron 构建，其 Chromium 内核需要 Linux **unprivileged user namespaces** 支持来运行沙箱。部分发行版（尤其是 Ubuntu 24.04+）默认通过 AppArmor 限制了此功能。 +
+🔧 完整排查与修复步骤（点击展开） + #### 第一步：诊断问题 在终端运行以下命令，确认系统的 user namespaces 状态： @@ -172,7 +184,9 @@ sudo sysctl --system ~/Apps/DesireCore/DesireCore.AppImage ``` -#### 临时验证：快速测试应用能否运行 +
+ +#### 快速验证：临时测试应用能否运行 如果你只想先确认应用本身是否正常，可以临时禁用沙箱运行（**仅用于测试，不建议日常使用**）： @@ -188,7 +202,7 @@ echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns ``` :::warning -`--no-sandbox` 会关闭 Chromium 的进程沙箱隔离，降低安全性。请仅用于排查问题，不要作为日常启动方式。建议按照上述方案一或方案二进行正式配置。 +`--no-sandbox` 会关闭 Chromium 的进程沙箱隔离，降低安全性。请仅用于排查问题，不要作为日常启动方式。建议按照 [上方的完整排查步骤](#完整排查与修复步骤点击展开) 进行正式配置。 ::: ## 卸载 diff --git a/docs/01-getting-started/02-installation/index.md b/docs/01-getting-started/02-installation/index.md index 83e2643..18132ce 100644 --- a/docs/01-getting-started/02-installation/index.md +++ b/docs/01-getting-started/02-installation/index.md @@ -8,6 +8,10 @@ keywords: [安装, 下载, macOS, Windows, Linux] DesireCore 桌面客户端支持 macOS、Windows 和 Linux 三大平台。 +:::info 安装前确认 +请先确保你的设备满足 [系统要求](../01-system-requirements.md)（8 GB 内存、2 GB 磁盘空间、可访问互联网）。 +::: + ## 下载 前往 DesireCore 官网，点击下载按钮即可获取最新版本： diff --git a/docs/01-getting-started/03-first-run.md b/docs/01-getting-started/03-first-run.md index 891be51..a200e96 100644 --- a/docs/01-getting-started/03-first-run.md +++ b/docs/01-getting-started/03-first-run.md @@ -1,7 +1,7 @@ --- title: 首次启动 description: DesireCore 首次启动后的欢迎引导流程和主界面概览。 -keywords: [首次启动, 欢迎, 引导, 界面, 主窗口] +keywords: [首次启动, 欢迎, 引导, 界面, 主窗口, 权限, 三栏布局, 导航栏] --- # 首次启动 @@ -18,23 +18,50 @@ keywords: [首次启动, 欢迎, 引导, 界面, 主窗口] 这个过程通常只需要几秒钟，你会看到一个简短的加载画面。 +## 权限授予 + +根据你的操作系统，DesireCore 首次运行时可能会请求以下权限： + +| 权限 | 平台 | 用途 | 是否必需 | +|------|------|------|----------| +| **辅助功能（Accessibility）** | macOS | GUI 自动化——让智能体操控其他应用窗口 | 可选，用到 GUI 自动化时才需要 | +| **屏幕录制（Screen Recording）** | macOS | 屏幕截图——让智能体看到屏幕内容 | 可选，用到屏幕感知时才需要 | +| **网络访问** | 全平台 | 调用 AI 模型 API、同步数据 | 必需 | +| **本地文件访问** | 全平台 | 读写工作文件和知识库 | 必需 | + +:::info macOS 用户 +macOS 会在首次请求时弹出系统权限对话框。如果拒绝了某项权限，后续可以在 **系统设置** → **隐私与安全性** 中随时开启。你也可以稍后在 DesireCore 的 **设置** → **系统权限** 中查看和管理权限状态。 +::: + +:::tip 最小权限原则 +DesireCore 采用最小权限设计——只在实际需要时才请求权限。初次体验时，即使不授予辅助功能和屏幕录制权限，对话、智能体管理等核心功能也能正常使用。 +::: + ## 主界面概览 启动完成后，你会进入 DesireCore 的主界面。它采用三栏布局： -![主界面布局](/img/getting-started/main-layout.svg) +![主界面布局示意图](/img/getting-started/main-layout.svg) + +下面是真实界面截图（深色模式）： + +![DesireCore 主界面](/img/getting-started/main-interface-clean.png) ### 导航栏（左侧） -最左侧的窄条是导航栏，从上到下依次是： +最左侧的窄条是导航栏，包含核心功能入口。从上到下依次是： -- **Logo**：DesireCore 图标 +- **Logo**：DesireCore 图标（点击可回到首页） - **对话**：聊天界面（默认页面） - **智能体**：管理你的 AI 同伴 -- **知识库**：查看和管理知识资料 -- **监控**：查看智能体运行状态 -- **设置**：应用设置（底部） -- **头像**：你的个人信息（底部） +- **文件**：查看和管理知识资料与工作文件 +- **通知**：查看系统通知和消息提醒 +- **设置**：应用设置（底部区域） +- **头像**：你的个人信息和账号管理（最底部） + +:::info 更多入口 +导航栏中还可能包含市场、自动化、算力管理等入口，具体项目会随版本更新而变化。将鼠标悬停在图标上可查看功能名称。 +::: ### 对话列表（中间） @@ -42,7 +69,16 @@ keywords: [首次启动, 欢迎, 引导, 界面, 主窗口] ### 聊天区域（右侧） -这是你和 AI 同伴交流的主要区域。顶部显示当前对话的智能体信息，底部是消息输入框。 +这是你和 AI 同伴交流的主要区域： + +- **顶部**：显示当前对话的智能体名称、在线状态和简介 +- **中间**：对话消息流（首次启动时为空） +- **底部输入框**：输入消息并按 **Enter** 发送，**Shift + Enter** 换行。输入框下方还有附件（+）、图片上传、模型选择等辅助按钮 +- **状态栏**（最底部）：显示快捷键提示，如 `↵ 发送`、`⇧ 换行` + +:::tip 提示 +将鼠标悬停在导航栏图标上可查看功能名称。界面各区域的详细介绍见 [界面导航](../02-user-guide/01-interface/01-layout-overview.md)。 +::: ## 下一步 diff --git a/docs/01-getting-started/04-configure-api-key.md b/docs/01-getting-started/04-configure-api-key.md index a2e2ca1..e1e75b5 100644 --- a/docs/01-getting-started/04-configure-api-key.md +++ b/docs/01-getting-started/04-configure-api-key.md @@ -8,6 +8,16 @@ keywords: [API Key, 配置, OpenAI, Claude, DeepSeek, Gemini, 硅基流动, 供 DesireCore 是一个本地优先的应用——你的核心数据存储在本地。AI 能力可以通过两种方式接入：登录后使用官方云端算力，或配置你自己的 API Key。配置 API Key 仍然是高级用户和企业用户最常用的方式，但它已经不是唯一入口。 +:::info 本页目录 +- [快速开始：云端算力或自备 Key](#快速开始云端算力或自备-key) +- [什么是 API Key？](#什么是-api-key) +- [在 DesireCore 中配置](#在-desirecore-中配置) +- [各供应商 API Key 获取指南](#各供应商-api-key-获取指南) +- [更多供应商](#更多供应商) +- [验证连接](#验证连接) +- [常见问题](#常见问题) +::: + ## 快速开始：云端算力或自备 Key | 方式 | 适合谁 | 说明 | @@ -15,6 +25,54 @@ DesireCore 是一个本地优先的应用——你的核心数据存储在本地 | 官方云端算力 | 不想先注册各家供应商的新用户 | 登录后自动绑定 `desirecore-cloud`，按订阅或 credit 使用 | | 自备 API Key | 已有供应商账号、需要自控成本或企业合规 | API Key 存储在本机受权限保护的 `secrets.json` 中，供应商配置只保存引用 | +### 使用官方云端算力（推荐新手） + +如果你不想先注册各家供应商的账号，可以使用 DesireCore 官方云端算力： + +1. **登录 DesireCore 账号** + - 点击左下角的 **头像** 图标 + - 选择 **登录** 或 **注册** + - 使用邮箱或第三方账号登录 + +2. **自动绑定云端算力** + - 登录成功后，资源面板会自动出现 **官方云端算力** 分组 + - 系统会同步你当前账号可用的模型 + - 显示余额、credit、临期额度和消耗信息 + +3. **开始使用** + - 云端算力会自动配置为默认供应商 + - 你可以直接开始 [第一次对话](./05-first-conversation.md)，无需额外配置 + +:::tip 云端算力优势 +- **无需注册**：不需要在多个供应商网站注册账号 +- **统一计费**：通过 DesireCore 账号统一管理消耗 +- **快速开始**：登录后即可使用，无需手动配置 API Key +- **灵活切换**：后续可以随时添加自备 API Key 作为补充 +::: + +### 使用自备 API Key + +如果你已有供应商账号，或需要自控成本、企业合规，可以配置自己的 API Key： + +1. **获取 API Key**：参考下方的 [各供应商 API Key 获取指南](#各供应商-api-key-获取指南) +2. **配置到 DesireCore**：参考 [在 DesireCore 中配置](#在-desirecore-中配置) +3. **验证连接**：参考 [验证连接](#验证连接) + +:::note 混合使用 +手动 API Key 和官方云端算力可以并存。你可以为某些任务指定自己的供应商，其他任务使用云端算力。 +::: + +## 本页导航 + +| 快速跳转 | 说明 | +|----------|------| +| [什么是 API Key？](#什么是-api-key) | 概念解释 | +| [在 DesireCore 中配置](#在-desirecore-中配置) | 配置步骤 | +| [OpenAI](#openaigpt-系列) · [Anthropic](#anthropicclaude-系列) · [DeepSeek](#deepseek) · [Google](#googlegemini-系列) · [硅基流动](#硅基流动siliconflow) | 热门供应商获取指南 | +| [更多供应商](#更多供应商) | 其他 16+ 供应商列表 | +| [验证连接](#验证连接) | 配置后验证 | +| [常见问题](#常见问题) | 排查指引 | + ## 什么是 API Key？ API Key 就像是你访问 AI 服务的"钥匙"。每个 AI 供应商（如 OpenAI、Anthropic、DeepSeek 等）都提供 API 服务，你需要在它们的网站上注册并获取一个 API Key，然后在 DesireCore 中填入，DesireCore 就能调用对应的 AI 模型了。 @@ -33,12 +91,19 @@ API Key 就像是你访问 AI 服务的"钥匙"。每个 AI 供应商（如 Open +:::note 密钥安全 +你的 API Key 仅保存在本机的 `~/.desirecore/secrets.json` 中（文件权限为 `600`，仅当前用户可读），不会上传到 DesireCore 服务器或任何第三方。 +::: + ## 各供应商 API Key 获取指南 DesireCore 支持超过 20 个 AI 供应商。下面是最常用的几个供应商的获取方法。 ### OpenAI（GPT 系列） +
+点击展开 OpenAI API Key 获取指南 + OpenAI 提供 GPT-5、GPT-4 等模型，是全球最知名的 AI 供应商之一。 | 项目 | 信息 | @@ -60,8 +125,13 @@ OpenAI 提供 GPT-5、GPT-4 等模型，是全球最知名的 AI 供应商之一 API Key 只会显示一次，请立即复制并保存。如果丢失了，你需要重新创建一个。 ::: +
+ ### Anthropic（Claude 系列） +
+点击展开 Anthropic API Key 获取指南 + Anthropic 提供 Claude 系列模型，以安全性和长文本处理能力著称。 | 项目 | 信息 | @@ -78,8 +148,13 @@ Anthropic 提供 Claude 系列模型，以安全性和长文本处理能力著 3. 点击 **Create Key** 4. 复制生成的 Key（以 `sk-ant-` 开头） +
+ ### DeepSeek +
+点击展开 DeepSeek API Key 获取指南 + DeepSeek 是国内领先的 AI 公司，提供高性价比的对话和推理模型，API 服务器在国内，延迟低。 | 项目 | 信息 | @@ -95,8 +170,13 @@ DeepSeek 是国内领先的 AI 公司，提供高性价比的对话和推理模 2. 进入控制台，点击 **API Keys** 3. 创建新的 API Key 并复制 +
+ ### Google（Gemini 系列） +
+点击展开 Google API Key 获取指南 + Google 提供 Gemini 系列模型，拥有超长上下文窗口（最高 100 万 Token）。 | 项目 | 信息 | @@ -113,8 +193,13 @@ Google 提供 Gemini 系列模型，拥有超长上下文窗口（最高 100 万 3. 选择或创建 Google Cloud 项目 4. 复制生成的 API Key +
+ ### 硅基流动（SiliconFlow） +
+点击展开硅基流动 API Key 获取指南 + 硅基流动是国内的 AI 推理服务平台，聚合了多种开源模型（如 Qwen），部分模型提供免费额度。 | 项目 | 信息 | @@ -130,6 +215,8 @@ Google 提供 Gemini 系列模型，拥有超长上下文窗口（最高 100 万 2. 进入控制台，找到 **API 密钥** 页面 3. 创建新的密钥并复制 +
+ ## 更多供应商 除了上面列出的供应商，DesireCore 还支持以下服务： diff --git a/docs/01-getting-started/05-first-conversation.md b/docs/01-getting-started/05-first-conversation.md index e5d8eaf..c269a29 100644 --- a/docs/01-getting-started/05-first-conversation.md +++ b/docs/01-getting-started/05-first-conversation.md @@ -40,7 +40,13 @@ DesireCore 是随应用自带的通用智能体，使用蓝色圆形头像。它 发送后，你会看到一个"DesireCore 思考中"的提示，几秒钟后，智能体的回复就会出现在对话中。 -回复以左侧气泡的形式展示，你发送的消息在右侧。 +回复以左侧气泡的形式展示，你发送的消息在右侧。首次对话的回复通常是纯文字；当你开始让智能体执行任务后，还会看到行动回执、委派通知等更丰富的卡片格式（见下方"理解回复格式"）。 + +![对话界面示例](/img/getting-started/main-interface-real.png) + +:::info 截图说明 +上图展示了实际的对话界面：右侧绿色气泡是你发送的消息，左侧是智能体的回复（包含工具执行回执等内容卡片）。 +::: ## 理解回复格式 @@ -72,4 +78,10 @@ DesireCore 的智能体不仅会回复文字，还可能展示不同类型的内 就这么简单！DesireCore 的核心体验就是自然的对话——你说，它做。随着你使用得越多，它会越来越了解你的偏好和习惯。 +:::tip 对话小技巧 +- 你可以随时在同一对话中切换话题，智能体会记住上下文 +- 如果回复不理想，直接告诉它哪里需要调整即可 +- 想让智能体记住某个偏好？直接说"记住：我喜欢……" +::: + 准备好探索更多功能了吗？看看 [下一步去哪里](./06-whats-next.md)。 diff --git a/docs/01-getting-started/06-whats-next.md b/docs/01-getting-started/06-whats-next.md index 712a3a7..d239192 100644 --- a/docs/01-getting-started/06-whats-next.md +++ b/docs/01-getting-started/06-whats-next.md @@ -8,6 +8,10 @@ keywords: [下一步, 指南, 学习路径, 推荐] 恭喜你完成了快速上手！现在你已经能和 AI 同伴正常对话了。接下来，根据你想做的事情，选择一条适合你的探索路径。 +:::tip 不知道从哪开始？ +建议先试试"教会智能体做事"——告诉 DesireCore 你的名字、工作背景和偏好，它会立刻变得更懂你。这是最快感受到价值的方式。 +::: + ## 按需求选择路径 ### 想熟悉界面操作 diff --git a/docs/01-getting-started/index.md b/docs/01-getting-started/index.md index 911738d..19d324a 100644 --- a/docs/01-getting-started/index.md +++ b/docs/01-getting-started/index.md @@ -17,6 +17,8 @@ DesireCore 是一个"委派式交互的 Agent 操作系统"——你可以像带 按照以下步骤，你很快就能和你的 AI 同伴开始第一次对话： +![快速上手流程：检查系统要求 → 安装 → 首次启动 → 配置 API Key → 第一次对话](/img/getting-started/quickstart-flow.svg) + | 步骤 | 内容 | 预计时间 | |------|------|----------| | **1** | [检查系统要求](./01-system-requirements.md) | 10 秒 | @@ -24,6 +26,7 @@ DesireCore 是一个"委派式交互的 Agent 操作系统"——你可以像带 | **3** | [首次启动](./03-first-run.md) | 10 秒 | | **4** | [配置 API Key](./04-configure-api-key.md) | 2 分钟 | | **5** | [第一次对话](./05-first-conversation.md) | 10 秒 | +| **6** | [下一步去哪里](./06-whats-next.md) | 5 分钟 | 完成这些步骤后，你就可以开始探索 DesireCore 的更多功能了。如果你是老手，可以直接跳到 [配置 API Key](./04-configure-api-key.md) 这一步。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/01-windows.md b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/01-windows.md index 42e76bd..ff9acf9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/01-windows.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/01-windows.md @@ -8,6 +8,10 @@ keywords: [Windows, installation, NSIS, SmartScreen] This guide covers how to install DesireCore on Windows. +:::tip Estimated time +The entire installation typically takes just **1–2 minutes** (depending on download speed). +::: + ## Installation Steps 1. **Download the installer** @@ -39,13 +43,25 @@ This guide covers how to install DesireCore on Windows. ## Local Components Included in the Installer -The Windows package includes portable Git, recommended Python and Node.js runtime archives, and CUA Driver for local GUI automation. These are independent third-party components; you do not need to preinstall system Git, Python, Node.js, or HostAgent. +The Windows package includes the following independent third-party components; you do not need to preinstall system Git, Python, Node.js, or HostAgent. + +### Portable Git + +The installer bundles a portable version of Git. After first startup, DesireCore automatically selects the newer of the system and bundled Git by default. You can change the source on the **Explorer** → **Compute** → **Runtime Environment** page. + +### Python / Node.js Runtimes + +After first startup, DesireCore imports the recommended Python and Node.js versions into its managed directories in the background. This does not replace system-wide installations. -- After first startup, DesireCore imports the recommended Python and Node.js versions into its managed directories in the background. This does not replace system-wide installations. -- Git automatically selects an available, newer source between system and bundled Git by default. You can change the source on the Runtime Environment page. -- CUA Driver is enabled for GUI automation on the current Windows computer. It is a pragmatic transitional implementation that gives Windows users this capability before Windows HostAgent is complete. macOS still uses HostAgent for GUI operations, while HostAgent implementations for Windows, Linux, and other platforms remain under development. +### CUA Driver (GUI Automation) -These archives and executables increase installer and post-import disk usage. Security software may scan them again when they are extracted or first executed. Allow the scan to finish; do not disable system protection merely to bypass a warning. Open **Explorer** → **Compute** → **Runtime Environment** to inspect actual versions and paths. See [Third-Party Software and Licenses](../../05-more/09-third-party-software.md) for sources and license boundaries. +CUA Driver is enabled by default for GUI automation on the current Windows computer. It is a transitional implementation that gives Windows users GUI capabilities before Windows HostAgent is complete. macOS still uses HostAgent for GUI operations, while HostAgent implementations for Windows, Linux, and other platforms remain under development. + +:::note Disk Usage and Security Scans +These archives and executables increase installer and post-import disk usage. Security software may scan them again when they are extracted or first executed. Allow the scan to finish; do not disable system protection merely to bypass a warning. +::: + +Open **Explorer** → **Compute** → **Runtime Environment** to inspect actual versions and paths. See [Third-Party Software and Licenses](../../05-more/09-third-party-software.md) for sources and license boundaries. ## Handling Windows SmartScreen Prompts @@ -81,4 +97,10 @@ To uninstall DesireCore: During uninstallation, you'll be asked whether to also delete application data. If you plan to reinstall, it's recommended to keep the data; if you're sure you won't use it again, you can choose to delete everything. ::: +## Troubleshooting + +- **Installer won't open**: Verify the download completed successfully (file size ~100–200 MB), then try downloading again. +- **Antivirus blocks installation**: Add the DesireCore install directory to your antivirus allowlist, or temporarily disable real-time protection and retry. +- **Other issues**: Visit the [FAQ](../../06-faq/index.md) or contact our support team. + After installation, head to [First Run](../03-first-run.md) to learn about the post-launch onboarding flow. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/02-macos.md b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/02-macos.md index f51f43f..e05840e 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/02-macos.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/02-macos.md @@ -8,6 +8,10 @@ keywords: [macOS, installation, DMG, Gatekeeper, Apple Silicon, Intel] This guide covers how to install DesireCore on macOS. +:::tip Estimated time +The entire installation typically takes just **1 minute** — download the DMG, drag to Applications, done. +::: + ## Installation Steps 1. **Download the DMG file** @@ -76,4 +80,11 @@ To also remove application data, delete the following directories: ~/.desirecore/ ``` +## Troubleshooting + +- **DMG won't open**: Verify the download completed successfully, then try downloading again. +- **"is damaged and can't be opened" message**: This is usually Gatekeeper blocking the app — follow the "Handling Gatekeeper Prompts" section above. +- **Slow performance on Apple Silicon**: Confirm you downloaded the arm64 version, not x64 (Rosetta translation incurs a performance penalty). +- **Other issues**: Visit the [FAQ](../../06-faq/index.md) or contact our support team. + After installation, head to [First Run](../03-first-run.md) to learn about the post-launch onboarding flow. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/03-linux.md b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/03-linux.md index 2f42295..14d4a3d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/03-linux.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/02-installation/03-linux.md @@ -8,6 +8,15 @@ keywords: [Linux, installation, AppImage, Ubuntu, Fedora, ARM64, UnionTech UOS, This guide covers how to install DesireCore on Linux. DesireCore is distributed as an AppImage, supporting both x64 and ARM64 architectures, and is compatible with most mainstream Linux distributions, including Chinese domestic operating systems such as UnionTech UOS, Kylin OS, Deepin, and openKylin. +:::tip Experienced users — quick start +```bash +# Two commands after downloading: +chmod +x DesireCore_x86_64_*.AppImage +./DesireCore_x86_64_*.AppImage +``` +If you hit a sandbox error, jump to [Troubleshooting](#troubleshooting-sandbox-errors). +::: + :::tip Chinese Domestic OS Users DesireCore has been tested and verified on UnionTech UOS, Kylin OS, Deepin, openKylin, and other Chinese domestic operating systems. For platform-specific installation instructions and compatibility details, please visit the [DesireCore China website](https://www.desirecore.cn). ::: @@ -40,6 +49,21 @@ DesireCore has been tested and verified on UnionTech UOS, Kylin OS, Deepin, open AppImage is a portable application format — no installation required, just download and run. You can place it in any directory you prefer. ::: +## Recommended: Install the AppImage Launcher + +Newer builds include an AppImage launcher setup script. It places the AppImage in a fixed location and creates a command-line entry, application menu item, and desktop shortcut for you. + +Typical installation result: + +| Path | Purpose | +|------|---------| +| `~/.local/share/desirecore/DesireCore.AppImage` | Fixed AppImage path | +| `~/.local/bin/desirecore` | Command-line launcher | +| `~/.local/share/applications/desirecore.desktop` | Application menu entry | +| `~/.local/share/desirecore/launcher.env` | Sandbox or launch parameter configuration | + +If the script is not available, you can continue with the manual approach below. + ## Creating a Desktop Shortcut If you'd like to launch DesireCore from the application menu, you can manually create a desktop entry file: @@ -97,6 +121,9 @@ Trace/breakpoint trap (core dumped) This occurs because DesireCore is built on Electron, whose Chromium engine requires Linux **unprivileged user namespaces** for sandboxing. Some distributions (especially Ubuntu 24.04+) restrict this feature by default via AppArmor. +
+🔧 Full diagnosis and fix steps (click to expand) + #### Step 1: Diagnose the Issue Run the following commands to check your system's user namespaces status: @@ -157,6 +184,8 @@ This option is for Ubuntu 24.04 and later. It grants user namespace access only ~/Apps/DesireCore/DesireCore.AppImage ``` +
+ #### Quick Test: Verify the App Can Run If you just want to confirm the application itself works, you can temporarily disable sandboxing (**for testing only, not recommended for daily use**): @@ -173,7 +202,7 @@ echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns ``` :::warning -`--no-sandbox` disables Chromium's process sandbox isolation, reducing security. Use it only for troubleshooting. For regular use, configure Option 1 or Option 2 above. +`--no-sandbox` disables Chromium's process sandbox isolation, reducing security. Use it only for troubleshooting. For regular use, follow the [full diagnosis and fix steps above](#full-diagnosis-and-fix-steps-click-to-expand). ::: ## Uninstall diff --git a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/03-first-run.md b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/03-first-run.md index 1e9c222..3cb1219 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/03-first-run.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/03-first-run.md @@ -1,7 +1,7 @@ --- title: First Run description: What to expect after launching DesireCore for the first time — the welcome flow and main interface overview. -keywords: [first run, welcome, onboarding, interface, main window] +keywords: [first run, welcome, onboarding, interface, main window, permissions, three-column layout, navigation bar] --- # First Run @@ -18,34 +18,50 @@ On the first launch, DesireCore performs some initialization: This process usually takes only a few seconds, during which you'll see a brief loading screen. +## Permissions + +Depending on your operating system, DesireCore may request the following permissions on first run: + +| Permission | Platform | Purpose | Required? | +|-----------|----------|---------|-----------| +| **Accessibility** | macOS | GUI automation — lets agents control other app windows | Optional, only needed for GUI automation | +| **Screen Recording** | macOS | Screen capture — lets agents see screen content | Optional, only needed for screen awareness | +| **Network Access** | All platforms | Calling AI model APIs, syncing data | Required | +| **Local File Access** | All platforms | Reading and writing work files and knowledge base | Required | + +:::info macOS Users +macOS will display a system permission dialog when first requested. If you deny a permission, you can always enable it later in **System Settings** → **Privacy & Security**. You can also check and manage permission status in DesireCore's **Settings** → **System Permissions**. +::: + +:::tip Principle of Least Privilege +DesireCore follows a principle of least privilege — it only requests permissions when actually needed. For your initial experience, even without granting Accessibility and Screen Recording permissions, core features like conversation and agent management work perfectly fine. +::: + ## Main Interface Overview After startup, you'll enter DesireCore's main interface. It uses a three-column layout: - +![Main Interface Layout](/img/getting-started/main-layout.svg) -``` -┌─────┬──────────────┬────────────────────────────┐ -│ │ │ │ -│ Nav │ Conversation│ Chat Area │ -│ Bar │ List │ │ -│ │ │ │ -│ │ │ │ -│ │ │ │ -└─────┴──────────────┴────────────────────────────┘ -``` +Below is a real interface screenshot (dark mode): + +![DesireCore Main Interface](/img/getting-started/main-interface-clean.png) ### Navigation Bar (Left) The narrow strip on the far left is the navigation bar, with the following items from top to bottom: -- **Logo**: DesireCore icon +- **Logo**: DesireCore icon (click to return to home) - **Conversations**: Chat interface (default page) - **Agents**: Manage your AI companions - **Knowledge Base**: View and manage knowledge resources -- **Monitor**: View agent execution status -- **Settings**: Application settings (bottom) -- **Avatar**: Your profile (bottom) +- **Notifications**: View system notifications and alerts +- **Settings**: Application settings (bottom area) +- **Avatar**: Your profile and account management (very bottom) + +:::info More Entries +The navigation bar may also contain entries for Marketplace, Automation, Compute Management, etc. Specific items may change with version updates. Hover over icons to see feature names. +::: ### Conversation List (Center) @@ -53,7 +69,16 @@ The list displays all your conversation sessions. On first launch, you'll see a ### Chat Area (Right) -This is the main area for interacting with your AI companion. The top shows the current conversation's agent info, and the bottom has the message input box. +This is the main area for interacting with your AI companion: + +- **Top**: Shows the current conversation's agent name, online status, and description +- **Center**: Conversation message stream (empty on first launch) +- **Bottom Input Box**: Type your message and press **Enter** to send, **Shift + Enter** for a new line. Below the input box are auxiliary buttons for attachments (+), image upload, model selection, etc. +- **Status Bar** (very bottom): Shows keyboard shortcuts, such as `↵ Send`, `⇧ New Line` + +:::tip Tip +Hover over navigation bar icons to see feature names. For detailed descriptions of each interface area, see [Interface Navigation](../02-user-guide/01-interface/01-layout-overview.md). +::: ## Next Step diff --git a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/04-configure-api-key.md b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/04-configure-api-key.md index 142d84c..bf5f637 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/04-configure-api-key.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/04-configure-api-key.md @@ -15,6 +15,34 @@ DesireCore is a local-first application: core data is stored locally by default. | Official cloud compute | Users who do not want to register with each model provider first | Sign in to bind the `desirecore-cloud` provider and use a subscription or credits | | Your own API key | Existing provider accounts, direct cost control, or enterprise compliance | The key is stored in the permission-protected local `secrets.json`; provider configuration stores only a reference | +:::info Already using cloud compute? +If you've signed in and bound official cloud compute, you can **skip this page** and go straight to [Your First Conversation](./05-first-conversation.md). Come back anytime to add more providers. +::: + +### Getting Started with Official Cloud Compute + +If you choose official cloud compute, setup is very simple: + +1. Open DesireCore and click **Settings** (bottom-left) > **Account** +2. Click **Sign In** and complete registration/login with your email or third-party account +3. After signing in, DesireCore automatically binds the `desirecore-cloud` provider +4. You can start chatting immediately — no manual API Key configuration needed + +:::tip When do I need my own key? +Cloud compute is great for getting started quickly. If you need a specific model unique to a provider, want direct control over usage and costs, or have enterprise compliance requirements, you can always come back and add your own key later. +::: + +## Page Navigation + +| Jump to | Description | +|---------|-------------| +| [What is an API Key?](#what-is-an-api-key) | Concept explanation | +| [Configuring in DesireCore](#configuring-in-desirecore) | Configuration steps | +| [OpenAI](#openai-gpt-series) · [Anthropic](#anthropic-claude-series) · [DeepSeek](#deepseek) · [Google](#google-gemini-series) · [SiliconFlow](#siliconflow) | Popular provider guides | +| [More Providers](#more-providers) | 16+ other providers | +| [Verifying the Connection](#verifying-the-connection) | Post-configuration verification | +| [Troubleshooting](#troubleshooting) | Issue resolution | + ## What is an API Key? An API Key is like a "key" to access AI services. Each AI provider (such as OpenAI, Anthropic, DeepSeek, etc.) offers API services — you need to register on their website, obtain an API Key, and then enter it in DesireCore so it can call the corresponding AI models. @@ -33,6 +61,10 @@ Calls made with your own API key are billed by the corresponding provider. Offic +:::note Key Security +Your API Key is stored only in the local file `~/.desirecore/secrets.json` (file permission `600`, readable only by the current user). It is never uploaded to DesireCore servers or any third party. +::: + ## Provider API Key Guides DesireCore supports over 20 AI providers. Below are instructions for the most commonly used ones. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/index.md b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/index.md index 5ed1655..a8f7826 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/index.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/index.md @@ -17,6 +17,8 @@ DesireCore is a "delegation-based interactive Agent OS" — you can train your A Follow these steps to start your first conversation with your AI companion: +![Quickstart flow: Check requirements → Install → First launch → Configure API Key → First conversation](/img/getting-started/quickstart-flow-en.svg) + | Step | Content | Estimated Time | |------|---------|----------------| | **1** | [Check system requirements](./01-system-requirements.md) | 10 seconds | @@ -24,6 +26,7 @@ Follow these steps to start your first conversation with your AI companion: | **3** | [First run](./03-first-run.md) | 10 seconds | | **4** | [Configure API Key](./04-configure-api-key.md) | 2 minutes | | **5** | [First conversation](./05-first-conversation.md) | 10 seconds | +| **6** | [What's next](./06-whats-next.md) | 5 minutes | After completing these steps, you can start exploring more of DesireCore's features. If you're experienced, feel free to jump straight to [Configure API Key](./04-configure-api-key.md). diff --git a/static/img/getting-started/SNAPSHOT-GUIDE.md b/static/img/getting-started/SNAPSHOT-GUIDE.md new file mode 100644 index 0000000..4eac854 --- /dev/null +++ b/static/img/getting-started/SNAPSHOT-GUIDE.md @@ -0,0 +1,136 @@ +# Getting Started 截图规范 + +> 版本：1.0 +> 更新日期：2026-07-26 +> 适用范围：`docs/01-getting-started/` 及 `i18n/en/.../01-getting-started/` 下所有截图 + +--- + +## 一、基本参数 + +| 参数 | 要求 | 说明 | +|------|------|------| +| **分辨率** | 2x Retina（如 2880×1800 截 1440×900 区域） | 确保在高分屏上清晰 | +| **格式** | PNG（截图）/ SVG（流程图、示意图） | 照片类用 PNG，矢量用 SVG | +| **最大宽度** | 1200px（截图实际内容区） | 超出部分浏览器会缩放，但文字可能模糊 | +| **文件命名** | 小写英文 + 短横线，如 `windows-download.png` | 不使用中文、空格或驼峰 | + +--- + +## 二、界面截图规范 + +### 2.1 拍摄前准备 + +| # | 操作 | 原因 | +|---|------|------| +| 1 | **关闭 DevTools 面板** | DevTools 会遮挡界面、暴露技术细节 | +| 2 | **使用浅色主题** | 与文档整体浅色风格一致；若产品默认深色，可切换后截图 | +| 3 | **隐藏书签栏** | 减少无关信息干扰 | +| 4 | **使用默认窗口大小** | 不要全屏或极小窗口，保持典型用户视角 | +| 5 | **清除浏览器缓存提示** | 不要出现"离线可用"等非预期提示 | + +### 2.2 敏感信息处理 + +| # | 规则 | 处理方式 | +|---|------|---------| +| 1 | **API Key 必须脱敏** | 使用 `sk-xxxx...xxxx` 或完全遮盖 | +| 2 | **个人邮箱/用户名** | 模糊处理或使用示例账号 `user@example.com` | +| 3 | **文件路径中的用户名** | 若暴露本机用户名，需模糊或替换为通用路径 | +| 4 | **token/session** | 确保截图中无任何可识别的认证令牌 | + +### 2.3 截图内容要求 + +| # | 要点 | +|---|------| +| 1 | **聚焦核心操作**：截图应展示用户需要看到的关键区域，不要截整个大页面 | +| 2 | **适当裁剪**：去掉无关的系统状态栏、多余空白 | +| 3 | **必要时加标注**：用箭头/高亮框标注关键按钮或区域（标注颜色建议 `#1677FF` 蓝色） | +| 4 | **保持一致风格**：同一章节的截图应使用相同的窗口大小和主题 | + +--- + +## 三、流程图/示意图规范 + +| 参数 | 要求 | +|------|------| +| **格式** | SVG（首选）或 PNG | +| **工具** | draw.io / Figma / Mermaid 导出 | +| **配色** | 使用 DesireCore 品牌色或中性灰蓝色系 | +| **文字** | 中文版用中文标签，英文版用英文标签（两套 SVG） | +| **尺寸** | 宽度 ≤ 800px，高度自适应 | +| **可访问性** | SVG 需包含 `` 标签 | + +--- + +## 四、当前截图清单 + +### 已有资源 + +| 文件 | 状态 | 说明 | +|------|------|------| +| `main-layout.svg` | ✅ 已有 | 三栏布局示意图（中英文共用） | +| `quickstart-flow.svg` | ✅ 已有 | 快速上手流程图（中文版） | +| `quickstart-flow-en.svg` | ✅ 已有 | 快速上手流程图（英文版） | + +### 待截图（按优先级排序） + +| # | 文件名 | 页面 | 描述 | 状态 | +|---|--------|------|------|------| +| 1 | `windows-download.png` | Windows 安装 | 官网下载页，Windows 被自动检测 | ⏸️ 待截图 | +| 2 | `windows-install-options.png` | Windows 安装 | NSIS 安装向导选项界面 | ⏸️ 待截图 | +| 3 | `windows-smartscreen.png` | Windows 安装 | SmartScreen 弹窗处理 | ⏸️ 待截图 | +| 4 | `macos-drag-install.png` | macOS 安装 | DMG 拖拽安装窗口 | ⏸️ 待截图 | +| 5 | `configure-api-key.png` | 配置 API Key | 设置→算力服务→配置界面 | ⏸️ 待截图 | +| 6 | `api-key-verify.png` | 配置 API Key | 验证成功状态 | ⏸️ 待截图 | +| 7 | `select-agent.png` | 第一次对话 | 对话列表选择智能体 | ⏸️ 待截图 | +| 8 | `send-first-message.png` | 第一次对话 | 发送消息并收到回复 | ⏸️ 待截图 | + +--- + +## 五、截图工作流 + +``` +1. 准备环境 + ├── 关闭 DevTools + ├── 切换浅色主题 + ├── 清理无关标签页/书签栏 + └── 准备测试账号（无敏感数据） + +2. 拍摄截图 + ├── 按页面顺序逐个截取 + ├── 每张截图即时命名（不后续批量重命名） + └── 截图后立即检查：敏感信息？清晰度？关键区域是否完整？ + +3. 后处理 + ├── 裁剪无关区域 + ├── 如需标注：使用统一的蓝色 (#1677FF) 箭头/框 + └── 导出为 PNG（2x） + +4. 提交 + ├── 放入 static/img/getting-started/ + ├── 更新对应 .md 文件中的占位符 + ├── 中英文页面同步更新引用 + └── 本地预览确认图片可见 +``` + +--- + +## 六、占位符约定 + +当截图尚未就绪时，在 Markdown 中使用 HTML 注释作为占位： + +```markdown +<!-- 截图占位: 简短描述 (文件名.png) --> +``` + +占位符格式：`<!-- 截图占位: <描述> (<文件名>) -->` + +截图就绪后，替换为： + +```markdown +![Alt 文本](/img/getting-started/<文件名>) +``` + +--- + +*本规范适用于 DesireCore 文档项目所有截图工作。* diff --git a/static/img/getting-started/assets/quickstart-flow.drawio b/static/img/getting-started/assets/quickstart-flow.drawio new file mode 100644 index 0000000..6949024 --- /dev/null +++ b/static/img/getting-started/assets/quickstart-flow.drawio @@ -0,0 +1,51 @@ +<mxfile host="DesireCore" modified="2026-07-26T00:00:00.000Z" agent="DesireCore Docs" version="1.0"> + <diagram name="快速上手流程" id="quickstart-flow"> + <mxGraphModel dx="1200" dy="400" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1200" pageHeight="400" math="0" shadow="0"> + <root> + <mxCell id="0"/> + <mxCell id="1" parent="0"/> + <!-- Step 1: 系统要求 --> + <mxCell id="step1" value="① 检查系统要求 10 秒" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;fontSize=13;fontStyle=1;verticalAlign=middle;spacingTop=2;spacingBottom=2;" vertex="1" parent="1"> + <mxGeometry x="40" y="140" width="160" height="70" as="geometry"/> + </mxCell> + <!-- Step 2: 安装 --> + <mxCell id="step2" value="② 安装 DesireCore 1-2 分钟" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;fontSize=13;fontStyle=1;verticalAlign=middle;spacingTop=2;spacingBottom=2;" vertex="1" parent="1"> + <mxGeometry x="260" y="140" width="160" height="70" as="geometry"/> + </mxCell> + <!-- Step 3: 首次启动 --> + <mxCell id="step3" value="③ 首次启动 10 秒" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#fff2cc;strokeColor=#d6b656;fontSize=13;fontStyle=1;verticalAlign=middle;spacingTop=2;spacingBottom=2;" vertex="1" parent="1"> + <mxGeometry x="480" y="140" width="160" height="70" as="geometry"/> + </mxCell> + <!-- Step 4: 配置 API Key --> + <mxCell id="step4" value="④ 配置 API Key 2 分钟" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#f8cecc;strokeColor=#b85450;fontSize=13;fontStyle=1;verticalAlign=middle;spacingTop=2;spacingBottom=2;" vertex="1" parent="1"> + <mxGeometry x="700" y="140" width="160" height="70" as="geometry"/> + </mxCell> + <!-- Step 5: 第一次对话 --> + <mxCell id="step5" value="⑤ 第一次对话 10 秒" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#e1d5e7;strokeColor=#9673a6;fontSize=13;fontStyle=1;verticalAlign=middle;spacingTop=2;spacingBottom=2;" vertex="1" parent="1"> + <mxGeometry x="920" y="140" width="160" height="70" as="geometry"/> + </mxCell> + <!-- Arrows --> + <mxCell id="arrow1" style="edgeStyle=orthogonalEdgeStyle;rounded=1;orthogonalLoop=1;jettySize=auto;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;strokeWidth=2;strokeColor=#333333;" edge="1" parent="1" source="step1" target="step2"> + <mxGeometry relative="1" as="geometry"/> + </mxCell> + <mxCell id="arrow2" style="edgeStyle=orthogonalEdgeStyle;rounded=1;orthogonalLoop=1;jettySize=auto;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;strokeWidth=2;strokeColor=#333333;" edge="1" parent="1" source="step2" target="step3"> + <mxGeometry relative="1" as="geometry"/> + </mxCell> + <mxCell id="arrow3" style="edgeStyle=orthogonalEdgeStyle;rounded=1;orthogonalLoop=1;jettySize=auto;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;strokeWidth=2;strokeColor=#333333;" edge="1" parent="1" source="step3" target="step4"> + <mxGeometry relative="1" as="geometry"/> + </mxCell> + <mxCell id="arrow4" style="edgeStyle=orthogonalEdgeStyle;rounded=1;orthogonalLoop=1;jettySize=auto;exitX=1;exitY=0.5;exitDx=0;exitDy=0;entryX=0;entryY=0.5;entryDx=0;entryDy=0;strokeWidth=2;strokeColor=#333333;" edge="1" parent="1" source="step4" target="step5"> + <mxGeometry relative="1" as="geometry"/> + </mxCell> + <!-- Title --> + <mxCell id="title" value="🚀 快速上手：5 分钟完成全部设置" style="text;html=1;align=center;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontSize=16;fontStyle=1;" vertex="1" parent="1"> + <mxGeometry x="400" y="60" width="300" height="40" as="geometry"/> + </mxCell> + <!-- Completion badge --> + <mxCell id="done" value="🎉 完成！" style="text;html=1;align=center;verticalAlign=middle;resizable=0;points=[];autosize=1;strokeColor=none;fillColor=none;fontSize=14;fontStyle=1;fontColor=#9673a6;" vertex="1" parent="1"> + <mxGeometry x="955" y="230" width="90" height="40" as="geometry"/> + </mxCell> + </root> + </mxGraphModel> + </diagram> +</mxfile> diff --git a/static/img/getting-started/main-interface-clean.png b/static/img/getting-started/main-interface-clean.png new file mode 100644 index 0000000..e6920ed Binary files /dev/null and b/static/img/getting-started/main-interface-clean.png differ diff --git a/static/img/getting-started/main-interface-real.png b/static/img/getting-started/main-interface-real.png new file mode 100644 index 0000000..78a5205 Binary files /dev/null and b/static/img/getting-started/main-interface-real.png differ diff --git a/static/img/getting-started/quickstart-flow-en.svg b/static/img/getting-started/quickstart-flow-en.svg new file mode 100644 index 0000000..131bdc5 --- /dev/null +++ b/static/img/getting-started/quickstart-flow-en.svg @@ -0,0 +1,57 @@ +<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1120 300" width="1120" height="300" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif"> + <!-- Background --> + <rect width="1120" height="300" fill="#fafbfc" rx="12"/> + + <!-- Title --> + <text x="560" y="52" text-anchor="middle" font-size="18" font-weight="bold" fill="#1a1a2e">🚀 Quick Start: Fully Set Up in 5 Minutes</text> + + <!-- Step 1 --> + <rect x="40" y="100" width="160" height="72" rx="12" fill="#dae8fc" stroke="#6c8ebf" stroke-width="1.5"/> + <text x="120" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">① System Requirements</text> + <text x="120" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">10 seconds</text> + + <!-- Arrow 1→2 --> + <path d="M200,136 L240,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead-en)"/> + + <!-- Step 2 --> + <rect x="250" y="100" width="160" height="72" rx="12" fill="#d5e8d4" stroke="#82b366" stroke-width="1.5"/> + <text x="330" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">② Install DesireCore</text> + <text x="330" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">1–2 minutes</text> + + <!-- Arrow 2→3 --> + <path d="M410,136 L450,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead-en)"/> + + <!-- Step 3 --> + <rect x="460" y="100" width="160" height="72" rx="12" fill="#fff2cc" stroke="#d6b656" stroke-width="1.5"/> + <text x="540" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">③ First Run</text> + <text x="540" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">10 seconds</text> + + <!-- Arrow 3→4 --> + <path d="M620,136 L660,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead-en)"/> + + <!-- Step 4 --> + <rect x="670" y="100" width="160" height="72" rx="12" fill="#f8cecc" stroke="#b85450" stroke-width="1.5"/> + <text x="750" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">④ Configure API Key</text> + <text x="750" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">2 minutes</text> + + <!-- Arrow 4→5 --> + <path d="M830,136 L870,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead-en)"/> + + <!-- Step 5 --> + <rect x="880" y="100" width="160" height="72" rx="12" fill="#e1d5e7" stroke="#9673a6" stroke-width="1.5"/> + <text x="960" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">⑤ First Conversation</text> + <text x="960" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">10 seconds</text> + + <!-- Completion badge --> + <text x="960" y="210" text-anchor="middle" font-size="14" font-weight="bold" fill="#9673a6">🎉 Done!</text> + + <!-- Subtitle --> + <text x="560" y="260" text-anchor="middle" font-size="12" fill="#8899aa">~5 minutes total · No coding experience needed · macOS / Windows / Linux</text> + + <!-- Arrow marker definition --> + <defs> + <marker id="arrowhead-en" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"> + <polygon points="0 0, 10 3.5, 0 7" fill="#333"/> + </marker> + </defs> +</svg> diff --git a/static/img/getting-started/quickstart-flow.svg b/static/img/getting-started/quickstart-flow.svg new file mode 100644 index 0000000..24d2c34 --- /dev/null +++ b/static/img/getting-started/quickstart-flow.svg @@ -0,0 +1,57 @@ +<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1120 300" width="1120" height="300" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif"> + <!-- Background --> + <rect width="1120" height="300" fill="#fafbfc" rx="12"/> + + <!-- Title --> + <text x="560" y="52" text-anchor="middle" font-size="18" font-weight="bold" fill="#1a1a2e">🚀 快速上手：5 分钟完成全部设置</text> + + <!-- Step 1: 系统要求 --> + <rect x="40" y="100" width="160" height="72" rx="12" fill="#dae8fc" stroke="#6c8ebf" stroke-width="1.5"/> + <text x="120" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">① 检查系统要求</text> + <text x="120" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">10 秒</text> + + <!-- Arrow 1→2 --> + <path d="M200,136 L240,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead)"/> + + <!-- Step 2: 安装 --> + <rect x="250" y="100" width="160" height="72" rx="12" fill="#d5e8d4" stroke="#82b366" stroke-width="1.5"/> + <text x="330" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">② 安装 DesireCore</text> + <text x="330" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">1-2 分钟</text> + + <!-- Arrow 2→3 --> + <path d="M410,136 L450,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead)"/> + + <!-- Step 3: 首次启动 --> + <rect x="460" y="100" width="160" height="72" rx="12" fill="#fff2cc" stroke="#d6b656" stroke-width="1.5"/> + <text x="540" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">③ 首次启动</text> + <text x="540" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">10 秒</text> + + <!-- Arrow 3→4 --> + <path d="M620,136 L660,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead)"/> + + <!-- Step 4: 配置 API Key --> + <rect x="670" y="100" width="160" height="72" rx="12" fill="#f8cecc" stroke="#b85450" stroke-width="1.5"/> + <text x="750" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">④ 配置 API Key</text> + <text x="750" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">2 分钟</text> + + <!-- Arrow 4→5 --> + <path d="M830,136 L870,136" stroke="#333" stroke-width="2" fill="none" marker-end="url(#arrowhead)"/> + + <!-- Step 5: 第一次对话 --> + <rect x="880" y="100" width="160" height="72" rx="12" fill="#e1d5e7" stroke="#9673a6" stroke-width="1.5"/> + <text x="960" y="130" text-anchor="middle" font-size="13" font-weight="bold" fill="#2c3e50">⑤ 第一次对话</text> + <text x="960" y="152" text-anchor="middle" font-size="12" fill="#5a6c7d">10 秒</text> + + <!-- Completion badge --> + <text x="960" y="210" text-anchor="middle" font-size="14" font-weight="bold" fill="#9673a6">🎉 完成！</text> + + <!-- Subtitle --> + <text x="560" y="260" text-anchor="middle" font-size="12" fill="#8899aa">总计约 5 分钟 · 无需编程经验 · 支持 macOS / Windows / Linux</text> + + <!-- Arrow marker definition --> + <defs> + <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"> + <polygon points="0 0, 10 3.5, 0 7" fill="#333"/> + </marker> + </defs> +</svg>