From 8e1b426fb536551e3f45f202a291204fd5ad7f63 Mon Sep 17 00:00:00 2001 From: yi-ge Date: Tue, 7 Jul 2026 19:58:19 +0800 Subject: [PATCH 1/3] docs: update account automation setup docs --- .../01-system-requirements.md | 2 +- .../02-installation/01-windows.md | 8 ++ .../02-installation/03-linux.md | 17 +++- .../04-configure-api-key.md | 11 ++- .../08-automation/01-heartbeat.md | 20 +++++ .../08-automation/02-notifications.md | 37 ++++++++- .../08-automation/03-scheduled-tasks.md | 18 ++++- .../10-settings/03-keyboard-shortcuts.md | 2 + .../10-settings/04-compute-service.md | 78 ++++++++++++++----- .../10-settings/06-data-privacy.md | 15 +++- .../10-settings/07-user-profile.md | 21 ++++- docs/04-concepts/08-compute-model.md | 21 ++++- docs/05-more/02-keyboard-shortcuts.md | 2 + docs/05-more/04-supported-providers.md | 8 +- docs/05-more/07-data-locations.md | 13 ++++ docs/06-faq/02-api-key.md | 2 +- .../01-system-requirements.md | 2 +- .../10-settings/07-user-profile.md | 17 +++- 18 files changed, 250 insertions(+), 44 deletions(-) diff --git a/docs/01-getting-started/01-system-requirements.md b/docs/01-getting-started/01-system-requirements.md index 4b2845a..0743368 100644 --- a/docs/01-getting-started/01-system-requirements.md +++ b/docs/01-getting-started/01-system-requirements.md @@ -56,7 +56,7 @@ DesireCore 需要连接互联网来调用 AI 服务。请确保你的网络环 - **能够访问 DesireCore 的更新服务器**：例如 `download.desirecore.net`，以便获取最新版本和安全补丁 - **能够访问 Github 代码托管服务**：如果你需要从 Github 获取市场Agent或Skills等资源，确保能够访问 `github.com` 和相关的 CDN 服务。系统会自动检测网络环境，并在无法访问某些服务时提供替代方案（如使用安全的CDN访问白名单中的仓库）。 -**注意：** DesireCore 不内置 AI 模型，而是通过 API 接入第三方服务来提供智能能力。截至当前版本（v10.1.0），DesireCore 仍为纯客户端软件，不包含任何服务器组件；官方也未提供后端 API，更新服务依赖对象存储与 CDN。因此，无需额外部署服务器环境，只要能够访问上述 API，即可正常使用。 +**注意：** DesireCore 不内置 AI 模型，而是通过 API 接入第三方服务或官方云端算力来提供智能能力。核心数据仍本地优先保存；账号登录、credit/订阅、云端模型列表和更新服务需要访问 DesireCore 在线服务。你也可以只使用自备 API Key 和本地数据运行大部分功能。 :::tip 网络不太好？ 如果你的网络访问海外服务不太顺畅，可以考虑使用国内供应商（如 阿里云、智谱 GLM、月之暗面 Kimi、DeepSeek、MiniMax、硅基流动等），它们的 API 服务器在国内，延迟更低。 diff --git a/docs/01-getting-started/02-installation/01-windows.md b/docs/01-getting-started/02-installation/01-windows.md index fc81e2d..834d053 100644 --- a/docs/01-getting-started/02-installation/01-windows.md +++ b/docs/01-getting-started/02-installation/01-windows.md @@ -52,6 +52,14 @@ keywords: [Windows, 安装, NSIS, SmartScreen] +## 更新和受保护目录 + +如果使用默认安装位置（`%LOCALAPPDATA%\Programs\DesireCore`），自动更新通常不需要管理员权限。 + +如果你把 DesireCore 安装到 `C:\Program Files\` 等受保护目录，更新安装器需要管理员权限。此时 Windows 会弹出 UAC 确认窗口；确认后安装器会以管理员身份继续更新。 + +更新前 DesireCore 会尝试关闭旧进程和相关子进程，避免旧文件被占用。如果更新失败，可以先完全退出 DesireCore，必要时重启电脑后重新运行安装包。 + ## 卸载 如果你需要卸载 DesireCore： diff --git a/docs/01-getting-started/02-installation/03-linux.md b/docs/01-getting-started/02-installation/03-linux.md index 4b762cc..7ddcae5 100644 --- a/docs/01-getting-started/02-installation/03-linux.md +++ b/docs/01-getting-started/02-installation/03-linux.md @@ -40,7 +40,22 @@ DesireCore 已在统信 UOS、银河麒麟（Kylin）、深度 Deepin、openKyli AppImage 是一种便携式应用格式——不需要安装，下载后直接运行。你可以把它放在任何你喜欢的目录里。 ::: -## 创建桌面快捷方式 +## 推荐：安装 AppImage 启动器 + +较新的 Linux 包提供 AppImage 启动器安装脚本。它会把 AppImage 放到固定位置，并创建命令行入口、应用菜单项和桌面快捷方式。 + +典型安装结果： + +| 路径 | 用途 | +|------|------| +| `~/.local/share/desirecore/DesireCore.AppImage` | 固定 AppImage 路径 | +| `~/.local/bin/desirecore` | 命令行启动入口 | +| `~/.local/share/applications/desirecore.desktop` | 应用菜单入口 | +| `launcher.env` | 沙箱或启动参数配置 | + +如果脚本不可用，也可以继续按下面的方式手动创建桌面快捷方式。 + +## 手动创建桌面快捷方式 如果你希望从应用菜单中启动 DesireCore，可以手动创建一个桌面入口文件： diff --git a/docs/01-getting-started/04-configure-api-key.md b/docs/01-getting-started/04-configure-api-key.md index 81e6801..ff99bb0 100644 --- a/docs/01-getting-started/04-configure-api-key.md +++ b/docs/01-getting-started/04-configure-api-key.md @@ -6,14 +6,21 @@ keywords: [API Key, 配置, OpenAI, Claude, DeepSeek, Gemini, 硅基流动, 供 # 配置 API Key -DesireCore 是一个本地优先的应用——你的数据存储在本地，AI 能力通过你自己的 API Key 来接入。配置 API Key 是开始使用 DesireCore 前最关键的一步。 +DesireCore 是一个本地优先的应用——你的核心数据存储在本地。AI 能力可以通过两种方式接入：登录后使用官方云端算力，或配置你自己的 API Key。配置 API Key 仍然是高级用户和企业用户最常用的方式，但它已经不是唯一入口。 + +## 快速开始：云端算力或自备 Key + +| 方式 | 适合谁 | 说明 | +|------|--------|------| +| 官方云端算力 | 不想先注册各家供应商的新用户 | 登录后自动绑定 `desirecore-cloud`，按订阅或 credit 使用 | +| 自备 API Key | 已有供应商账号、需要自控成本或企业合规 | API Key 存储在本机系统凭据管理器中 | ## 什么是 API Key？ API Key 就像是你访问 AI 服务的"钥匙"。每个 AI 供应商（如 OpenAI、Anthropic、DeepSeek 等）都提供 API 服务，你需要在它们的网站上注册并获取一个 API Key，然后在 DesireCore 中填入，DesireCore 就能调用对应的 AI 模型了。 :::info 费用说明 -使用 API Key 调用 AI 服务会按用量计费，费用直接由对应的供应商收取，DesireCore 本身不收费。不同模型的价格差异很大，从每百万 Token 几分钱到几十美元不等。 +使用自备 API Key 调用 AI 服务会按用量计费，费用直接由对应供应商收取。使用官方云端算力时，会消耗你的订阅额度或 credit。不同模型的价格和消耗倍率差异很大。 ::: ## 在 DesireCore 中配置 diff --git a/docs/02-user-guide/08-automation/01-heartbeat.md b/docs/02-user-guide/08-automation/01-heartbeat.md index 0c1eabf..69dd07e 100644 --- a/docs/02-user-guide/08-automation/01-heartbeat.md +++ b/docs/02-user-guide/08-automation/01-heartbeat.md @@ -63,6 +63,22 @@ tasks: 如果 `HEARTBEAT.md` 为空或只有注释，心跳不会发起实际检查。 +## 结构化结果 + +心跳检查会由智能体通过 `HeartbeatRespond` 提交结构化结果。它不只是“有无通知”，还会说明当前巡检的 outcome、是否需要提醒、产出文件和下次检查建议。 + +常见 outcome： + +| Outcome | 含义 | 通常行为 | +|---------|------|----------| +| `no_change` | 没有重要变化 | 只记录历史，不打扰 | +| `progress` | 有进展但无需你处理 | 记录摘要，必要时轻提醒 | +| `done` | 监控事项已完成 | 可发送完成通知 | +| `blocked` | 卡住或需要外部条件 | 提醒你处理 | +| `needs_attention` | 需要你关注或决策 | 顶部通知或审批入口 | + +心跳结果可以附带 `notificationText`、文件链接、优先级和建议下次检查时间。旧文档中的 OK / Notify / Action 可以理解为这些结构化结果的用户可见层级。 + ## 心跳结果 智能体完成检查后会自主判断：这次有没有需要打扰你的事情。 @@ -141,6 +157,10 @@ tasks: 3. **数据源是否可用**：对应的工具、MCP 服务或账户连接是否正常 4. **是否被抑制**：检查是否处于专注模式、安静时段或 Snooze 状态 +### 历史汇总文件 + +心跳会维护历史汇总文件，例如 `heartbeat/history.md`。当心跳发现文件产物、报告或需要你查看的资料时，通知和历史记录中会展示可点击文件链接。 + ## 瞬态错误处理 心跳遇到网络超时、限流或服务暂不可用等临时错误时会自动重试，最多 4 次，退避间隔依次为 3 秒、8 秒、20 秒和 60 秒。周期性心跳不会因为单次失败而停止。 diff --git a/docs/02-user-guide/08-automation/02-notifications.md b/docs/02-user-guide/08-automation/02-notifications.md index 3d78dd9..f55308d 100644 --- a/docs/02-user-guide/08-automation/02-notifications.md +++ b/docs/02-user-guide/08-automation/02-notifications.md @@ -18,7 +18,34 @@ keywords: [通知, 提醒, 通知中心, 桌面通知, 审批通知] | **审批请求** | 命令执行、外部发送、敏感操作等需要确认 | 会话内审批卡片、通知中心跳转、桌面提醒 | | **系统错误** | 后台服务、工具调用或连接器异常 | 系统通知、活动记录错误日志 | -心跳 OK 结果默认静默记录，不主动推送。心跳 Alert 会以卡片形式出现在对应智能体的对话流中，并可被持久化到该智能体的主对话；它不会写入通知中心。只有心跳执行失败时，才会以系统通知提醒你检查算力、网络或数据源。定时任务查询结果会根据成功或失败进入任务通知或系统通知。 +心跳 `no_change` 结果默认静默记录，不主动推送。需要你关注的心跳结果会显示为顶部横幅、对话流卡片或通知；心跳失败、审批和任务类事件也会进入通知中心。定时任务查询结果会根据成功或失败进入任务通知或系统通知。 + +### 消息通知 + +来自智能体的对话消息通知。 + +- **图标**：蓝色铃铛 +- **场景**：智能体在对话中发送了新消息 + +### 系统通知 + +来自系统层面的通知。 + +- **图标**：绿色信息图标 +- **来源**：心跳检查失败、定时任务执行失败、测试通知等 +- **场景**：智能体的心跳检查出现错误、定时任务执行报错 + +### 任务通知 + +来自定时任务的完成通知。 + +- **图标**：紫色勾选图标 +- **来源**：定时任务成功执行后的结果 +- **场景**：每日早报生成完毕、定时查询返回了结果 + +:::info 心跳提醒 +心跳检查没有重要变化时只记录历史；需要你关注的结果会显示为顶部横幅或通知，失败、审批和任务类事件也会进入通知中心。详见[心跳监控](./01-heartbeat.md)。 +::: ## 通知中心 @@ -36,9 +63,11 @@ keywords: [通知, 提醒, 通知中心, 桌面通知, 审批通知] - 分类图标和颜色 - 通知标题 -- 相对时间，例如“刚刚”“3 分钟前”“2 小时前” -- 通知正文摘要 -- 未读指示 +- 相对时间（如"刚刚"、"3 分钟前"、"2 小时前"） +- 通知正文（支持 Markdown 预览，最多显示两行） +- 未读指示（蓝色圆点） + +点击通知可以标记为已读，并跳转到对应对话、审批或任务。审批类通知可以在通知中心内直接批准或拒绝。按 **ESC** 键或点击空白区域可关闭通知中心。 ![通知中心面板](./img/notification-center.png) diff --git a/docs/02-user-guide/08-automation/03-scheduled-tasks.md b/docs/02-user-guide/08-automation/03-scheduled-tasks.md index bdaba1a..9f64dc3 100644 --- a/docs/02-user-guide/08-automation/03-scheduled-tasks.md +++ b/docs/02-user-guide/08-automation/03-scheduled-tasks.md @@ -18,8 +18,8 @@ keywords: [定时任务, 调度, 自动化, 定时提醒, 周期任务, 模板, 如果你想“每天 9 点生成日报”，使用定时任务。如果你想“每 30 分钟看看有没有重要邮件，并且没有变化时别打扰我”，使用[心跳监控](./01-heartbeat.md)。如果智能体只是需要“等 10 秒再继续检查构建结果”，使用 `Sleep`。 -:::info 当前上下文不会自动延续 -`CreateSchedule` 创建任务后会立即返回。真正到点时，DesireCore 会启动新的执行任务来发送 Prompt，不会继承当前对话里的临时上下文。定时任务的 Prompt 应写成独立可执行的指令。 +:::info 调度是异步任务 +`CreateSchedule` 只负责创建异步调度。任务到期后会在新的运行会话中执行，不继承你当前输入框里的临时上下文。如果是长期监控某个数据源，优先使用心跳；如果是到点执行一段指令，使用定时任务。 ::: ## 创建方式 @@ -117,8 +117,6 @@ AgentFS 的调度定义结构还可以表示更高级的字段，例如 `starts_ 普通定时任务触发时会向目标智能体发送一段 Prompt。智能体会像收到一条新的任务消息一样执行它，执行结果会进入对应的会话、通知或执行记录。 -定时任务触发时会向目标智能体发送 Prompt，智能体会像收到一条新的任务消息一样执行它。 - 写 Prompt 时建议包含足够上下文： ```text @@ -128,6 +126,12 @@ AgentFS 的调度定义结构还可以表示更高级的字段，例如 `starts_ 定时任务适合独立执行的内容。需要依赖当前对话临时上下文时，不要把它拆成定时任务；让智能体在当前会话里继续执行，或使用 `Sleep` 做短等待。 +创建调度后，智能体会在当前聊天中显示调度创建回执。调度真正触发时，会生成独立运行记录和执行历史。 + +:::info 心跳调度的唯一性 +每个智能体只能有一个心跳类型的调度任务。创建新的心跳调度时，旧的会被自动替换。 +::: + ## 典型场景 ### 每日早报 @@ -304,6 +308,12 @@ AgentFS 的调度定义结构还可以表示更高级的字段，例如 `starts_ 通知的展示取决于任务结果和智能体输出。 +如果调度任务产出了文件，通知和执行历史会展示文件链接。失败、跳过、补偿触发也会记录在执行历史中。 + +:::tip 实时同步 +调度任务的状态变化（如触发、暂停、完成）会通过实时通道即时同步到界面，无需手动刷新。 +::: + ## 文件位置 每个调度任务保存为智能体仓库中的 JSON 文件： diff --git a/docs/02-user-guide/10-settings/03-keyboard-shortcuts.md b/docs/02-user-guide/10-settings/03-keyboard-shortcuts.md index 994c9fe..eafa8dc 100644 --- a/docs/02-user-guide/10-settings/03-keyboard-shortcuts.md +++ b/docs/02-user-guide/10-settings/03-keyboard-shortcuts.md @@ -33,6 +33,8 @@ DesireCore 内置了三种编辑器快捷键模式，适应不同用户的操作 | 发送消息 | `Enter` | | 换行 | `Shift + Enter` | | 取消输入 | `Esc` | +| 采纳预测 | `Tab` 或 `→` | +| Rewind 到检查点 | `Cmd/Ctrl + Alt + Z` | ### 超级文书 diff --git a/docs/02-user-guide/10-settings/04-compute-service.md b/docs/02-user-guide/10-settings/04-compute-service.md index 23bfa14..9e8fcd9 100644 --- a/docs/02-user-guide/10-settings/04-compute-service.md +++ b/docs/02-user-guide/10-settings/04-compute-service.md @@ -6,7 +6,7 @@ keywords: [算力, AI 供应商, API Key, 模型, Provider, LLM, 设置] # 算力服务配置 -算力服务（Compute Service）负责管理 AI 供应商、API Key、模型列表和默认模型映射。智能体需要至少一个可用模型才能理解你的意图、生成回复、调用工具并执行任务；图片、语音、视频、音乐等媒体能力也在这里统一配置。 +算力服务（Compute Service）负责管理 AI 供应商、API Key、模型列表和默认模型映射。智能体需要至少一个可用模型才能理解你的意图、生成回复、调用工具并执行任务；图片、语音、视频、音乐等媒体能力也在这里统一配置。你可以配置自己的供应商，也可以登录后使用官方云端算力。 ## 基本概念 @@ -17,6 +17,8 @@ keywords: [算力, AI 供应商, API Key, 模型, Provider, LLM, 设置] | **API Key** | 供应商颁发的访问密钥，保存在系统凭据管理器中 | | **模型（Model）** | 具体模型名称，可用于对话、工具调用、图像、语音、视频或音乐等服务 | | **默认映射** | 为不同任务用途选择默认模型 | +| **官方云端算力** | 登录后自动绑定的 `desirecore-cloud` provider，按订阅或 credit 使用 | +| **服务类型** | 模型用途，例如 chat、tool use、vision、tts、asr、image_gen、video_gen、music_gen | ## 进入算力服务配置 @@ -46,17 +48,6 @@ DesireCore 内置多家主流供应商模板，也支持自定义 OpenAI 兼容 3. 如有需要，设置 API 格式、媒体 API 地址和服务类型 4. 点击验证，确认 Key 和模型可用 -验证结果会显示： - -| 状态 | 含义 | -|------|------| -| **可用** | 模型或服务验证通过 | -| **异常** | Key 无权限、地址错误、模型不存在或供应商返回错误 | -| **超时** | 网络或供应商响应超时 | -| **检测中** | 正在验证 | - -模型验证会按模型类型选择合适的验证方式。图片、语音、视频、音乐等媒体模型会使用媒体服务路径；当供应商的普通 Base URL 指向非 OpenAI 兼容端点时，`mediaBaseUrl` 可用于媒体请求和验证。 - ### 自定义供应商 当你的供应商不在内置模板中，或公司内部通过统一网关代理模型时，可以添加自定义供应商。配置时通常需要确认： @@ -73,15 +64,66 @@ DesireCore 内置多家主流供应商模板，也支持自定义 OpenAI 兼容 某些供应商区分按量 API Key 与 Token Plan Key。界面会提示 Key 类型是否疑似放错位置，避免配置后模型一直验证失败。 ::: -## API Key 安全 +## 官方云端算力 + +登录后，资源面板会自动出现官方云端算力分组。它会同步你当前账号可用的模型，并显示余额、credit、临期额度和相对消耗信息。 + +云端算力适合： + +- 不想手动配置 API Key 的新用户 +- 临时试用模型能力 +- 使用订阅或 credit 包统一管理消耗 + +手动 API Key 和官方云端算力可以并存。你仍然可以为某些任务指定自己的供应商。 + +## 管理 API Key + +你的 API Key 通过以下方式得到保护： + +- API Key 存储在本地设备的系统凭据管理器中（macOS Keychain / Windows Credential Manager / Linux Secret Service） +- 配置文件中只保存加密引用，不保存明文 +- API Key 不会上传到 DesireCore 服务器或任何第三方 + +修改 API Key：选择供应商后，点击 **编辑** 按钮，输入新的 Key 即可覆盖旧值。 + +删除供应商实例会移除该实例配置；如果某个智能体仍引用它，需要重新选择可用供应商或调整默认映射。建议按供应商或用途拆分 Key，不要把同一个高权限 Key 同时用于测试、日常任务和生产任务。这样更容易定位账单、限流和权限问题。 + +## 模型验证 + +配置完供应商后，建议验证模型是否可用： + +1. 选择一个已配置的供应商 +2. 点击 **验证全部模型** 按钮 +3. 系统会逐一检测每个模型的可用性 + +验证结果会以状态标签显示： + +| 状态 | 含义 | +|------|------| +| **可用** | 模型或服务验证通过 | +| **异常** | Key 无权限、地址错误、模型不存在或供应商返回错误 | +| **超时** | 网络或供应商响应超时 | +| **检测中** | 正在验证 | + +模型验证会按模型类型选择合适的验证方式。图片、语音、视频、音乐等媒体模型会使用媒体服务路径；当供应商的普通 Base URL 指向非 OpenAI 兼容端点时，`mediaBaseUrl` 可用于媒体请求和验证。 + +验证结果会持久化到模型配置中。明确验证失败的模型不会优先出现在聊天模型选择器中，避免误选不可用模型。 + +## 服务类型和媒体模型 -- API Key 使用系统凭据管理器保存（macOS Keychain / Windows Credential Manager / Linux Secret Service） -- 配置文件中只保存引用，不保存明文 -- API Key 不会上传到 DesireCore 服务器 +不同模型用途不同： -修改 API Key 时，选择对应供应商实例并进入编辑状态，输入新 Key 后保存即可覆盖旧凭据。删除供应商实例会移除该实例配置；如果某个智能体仍引用它，需要重新选择可用供应商或调整默认映射。 +| 服务类型 | 用途 | +|----------|------| +| `chat` | 普通对话和文本生成 | +| `tool_use` | 支持工具调用的对话 | +| `vision` / `image_understanding` | 图片理解、扫描 PDF 识别 | +| `tts` / `asr` | 语音合成和语音识别 | +| `image_gen` | 图像生成 | +| `video_gen` | 视频生成 | +| `music_gen` | 音乐生成 | -建议按供应商或用途拆分 Key，不要把同一个高权限 Key 同时用于测试、日常任务和生产任务。这样更容易定位账单、限流和权限问题。 +图像、视频、音乐等生成类模型不会作为普通聊天模型出现在对话模型选择器中，但可以被对应工具或技能调用。 ## 默认模型映射 diff --git a/docs/02-user-guide/10-settings/06-data-privacy.md b/docs/02-user-guide/10-settings/06-data-privacy.md index f1a55e2..564b736 100644 --- a/docs/02-user-guide/10-settings/06-data-privacy.md +++ b/docs/02-user-guide/10-settings/06-data-privacy.md @@ -6,7 +6,7 @@ keywords: [数据, 隐私, 备份, 导出, 导入, 清除, 本地存储] # 数据与隐私 -DesireCore 采用本地优先架构。智能体、技能、对话、配置、审计和缓存默认保存在你的设备上。AI 推理请求只会发送给你配置的模型供应商。 +DesireCore 采用**本地优先**（Local-first）架构。智能体、技能、对话、配置、审计和缓存默认保存在你的设备上。AI 推理请求只会发送给你配置的模型供应商。登录账号后，订阅、credit、云端模型列表等账号资源会从在线服务同步；这不会改变本地对话和智能体文件的存储位置。 ## 数据存储位置 @@ -26,6 +26,8 @@ DesireCore 采用本地优先架构。智能体、技能、对话、配置、审 | `config/` | 用户配置、算力配置、供应商配置引用 | | `runs/` | 对话、执行记录、回执和审计数据 | | `market/` | 市场资源缓存 | +| `apps/` / `services/` | 已安装应用、派生服务、审批状态和健康检查信息 | +| `notifications/` / `schedules/` | 通知中心状态、定时任务配置和触发历史 | | `cache/` | 可重建缓存 | | `logs/` | 本地日志和错误排查信息 | @@ -49,7 +51,7 @@ DesireCore 采用本地优先架构。智能体、技能、对话、配置、审 导出流程会提示保存位置、数据体积和处理进度。运行时目录、缓存、设备标识、明文密钥等不适合迁移的内容会被排除或单独处理。 :::tip 备份建议 -升级系统、迁移设备或批量调整智能体前，建议导出智能体、用户数据、技能、系统配置和审计日志。 +升级系统、迁移设备或批量调整智能体前，建议导出智能体、用户数据、技能、系统配置和审计日志。出于安全原因，导出文件不会包含系统凭据管理器中的明文 API Key；迁移后需要重新授权或重新输入部分密钥。 ::: ## 导入数据 @@ -80,7 +82,12 @@ DesireCore 采用本地优先架构。智能体、技能、对话、配置、审 | **代码托管** | GitHub、Gitee、Gitea 等连接配置 | | **用户档案** | 用户身份、头像、个人记忆库和审批偏好 | | **市场数据** | 官方市场仓库缓存 | -| **缓存与日志** | 用量索引、关系图谱缓存、日志和可重建数据 | +| **应用与服务** | 已安装应用、派生服务状态和审批缓存 | +| **通知与调度** | 通知中心记录、定时任务配置和执行历史 | +| **缓存与日志** | 用量统计索引、关系图谱缓存和日志文件 | + +4. 确认选择后，点击 **清除选中数据** +5. 系统会依次停止后台服务、删除数据、重启应用 :::danger 清除操作不可恢复。处理异常时优先清除“缓存与日志”，不要直接删除智能体或用户档案。 @@ -93,6 +100,8 @@ DesireCore 采用本地优先架构。智能体、技能、对话、配置、审 - **调用透明**：AI 请求、工具调用和外部服务交互可在活动记录中审计 - **最小统计**：启动统计只用于安装量和平台分布，不包含对话内容 - **可审计导出**：审计日志可作为独立类别导出，便于合规留存 +- **数据不出本地**：所有数据默认存储在你的设备上，不会自动上传到云端 +- **账号能力可选**：登录、云端算力、订阅和 credit 需要在线服务，但不强制上传本地对话和智能体文件 ## 敏感场景建议 diff --git a/docs/02-user-guide/10-settings/07-user-profile.md b/docs/02-user-guide/10-settings/07-user-profile.md index 6e6c985..085c17f 100644 --- a/docs/02-user-guide/10-settings/07-user-profile.md +++ b/docs/02-user-guide/10-settings/07-user-profile.md @@ -46,8 +46,23 @@ DesireCore 支持自定义头像： DesireCore 支持免登录使用，所有核心功能在游客模式下都完全可用。 - **游客模式**：数据保存在本地，无需注册账号 -- **登录用户**：未来登录后可将数据同步到云端（功能开发中） +- **登录用户**：可使用官方云端算力、订阅/credit、账号资料和部分在线服务 -:::info -当前版本的登录功能正在开发中，所有功能均可在免登录状态下正常使用。你的数据安全存储在本地设备上。 +## 注册和登录 + +你可以使用邮箱注册或登录账号。注册时需要完成邮箱 OTP 验证，并设置二次确认密码。忘记密码时，也可以通过邮箱 OTP 找回。 + +登录后，DesireCore 会自动同步账号相关资源： + +- 官方云端模型 provider +- credit 余额和临期额度 +- 订阅状态 +- 可用的合作伙伴模型 + +## 登出 + +登出会清理本地的云端 provider 会话状态，避免继续使用过期 token。你的本地对话、智能体、文件和自定义 API Key 不会因为登出而被删除。 + +:::info 本地优先 +登录只影响账号、订阅和云端算力等在线能力。你的核心数据仍保存在本地设备上。 ::: diff --git a/docs/04-concepts/08-compute-model.md b/docs/04-concepts/08-compute-model.md index fe9673b..51f7c7e 100644 --- a/docs/04-concepts/08-compute-model.md +++ b/docs/04-concepts/08-compute-model.md @@ -8,9 +8,9 @@ keywords: [算力, Compute, BYOK, 供应商, 模型选择, API Key] ## 什么是算力模型 -DesireCore 本身不提供 AI 模型，而是帮你**连接和管理**各种 AI 服务。就像一台电脑本身不产生电力，但它能使用不同的电源 -- 你可以接市电、用电池，甚至太阳能。 +DesireCore 本身不内置 AI 模型，而是帮你**连接和管理**各种 AI 服务。就像一台电脑本身不产生电力，但它能使用不同的电源 -- 你可以接市电、用电池，甚至太阳能。 -DesireCore 的算力模型让你可以自由选择 AI 服务供应商，用自己的 API Key 直接对接，不需要通过任何中间商。 +DesireCore 的算力模型有两条路径：你可以用自己的 API Key 直接对接供应商，也可以登录后使用官方云端算力和 credit。 ## BYOK -- 自带钥匙模式 @@ -40,6 +40,19 @@ BYOK 是 **Bring Your Own Key**（自带钥匙）的缩写，这是 DesireCore | **数据安全** | 你的数据直接发给供应商，不经过第三方 | | **成本可控** | 在供应商后台就能看到消费明细 | +## 官方云端算力 + +如果你不想自己注册供应商账号，可以登录 DesireCore 账号使用官方云端算力。云端算力会以 `desirecore-cloud` provider 的形式出现在资源面板中，并同步当前账号可用模型。 + +云端算力的特点： + +- 按订阅或 credit 使用 +- 模型列表由账号接口同步 +- 模型选择器显示相对消耗倍率 +- 可以和 BYOK 供应商并存 + +BYOK 模式始终可用，你不会被锁定在任何单一供应商上。 + ## 多供应商支持 DesireCore 支持超过 20 家 AI 供应商，覆盖全球主流服务： @@ -105,9 +118,9 @@ DesireCore 支持超过 20 家 AI 供应商，覆盖全球主流服务： 你可以在设置中自定义这些映射，比如把日常对话指向便宜的模型，把重要任务指向最强的模型。 -## 预置算力包 +## 生成类模型与聊天模型 -如果你不想自己注册供应商账号，DesireCore 也计划提供预置算力包 -- 开箱即用，按用量付费。但 BYOK 模式始终可用，你不会被锁定在任何单一供应商上。 +图像、视频、音乐、TTS 等生成类模型不会作为普通聊天模型出现。它们会被 `GenerateImage`、`GenerateVideo`、TTS 或音乐生成技能调用。聊天模型选择器只展示适合对话的模型，并会过滤明确验证失败或已废弃的条目。 ## 下一步 diff --git a/docs/05-more/02-keyboard-shortcuts.md b/docs/05-more/02-keyboard-shortcuts.md index 81f0ef0..f5a2337 100644 --- a/docs/05-more/02-keyboard-shortcuts.md +++ b/docs/05-more/02-keyboard-shortcuts.md @@ -32,6 +32,8 @@ DesireCore 提供三种快捷键模式，你可以在「设置 > 快捷键 > 编 | 发送消息 | `Enter` | `Enter` | 在输入框中发送消息 | | 换行 | `Shift+Enter` | `Shift+Enter` | 在输入框中插入换行 | | 取消输入 | `Escape` | `Escape` | 取消当前输入 | +| 采纳预测 | `Tab` 或 `→` | `Tab` 或 `→` | 接受下一条消息预测 | +| Rewind | `Cmd+Alt+Z` | `Ctrl+Alt+Z` | 回撤到检查点 | ## 超级文书 diff --git a/docs/05-more/04-supported-providers.md b/docs/05-more/04-supported-providers.md index 4b9ecbc..7122ec9 100644 --- a/docs/05-more/04-supported-providers.md +++ b/docs/05-more/04-supported-providers.md @@ -6,7 +6,13 @@ keywords: [供应商, Provider, AI 模型, API, OpenAI, Claude, DeepSeek] # 支持的 AI 供应商列表 -DesireCore 支持 **23 家** AI 供应商，涵盖对话、推理、视觉、嵌入、语音、图像生成、视频生成等多种服务类型。 +DesireCore 的供应商和模型列表由 config-center 持续更新，实际可用项会随客户端、账号权限和远端配置变化。本文列出常见供应商和能力类型，作为配置参考；具体模型、价格和上下文长度请以「设置 > 算力服务」中的实时列表为准。 + +支持的服务类型包括对话、推理、工具调用、视觉理解、嵌入、语音合成、语音识别、图像生成、视频生成、音乐生成、OCR、Computer Use 等。 + +:::tip 生成类模型 +`image_gen`、`video_gen`、`music_gen`、`tts`、`asr` 等模型不会作为普通聊天模型出现。它们由对应工具或技能调用。 +::: ## 国际供应商 diff --git a/docs/05-more/07-data-locations.md b/docs/05-more/07-data-locations.md index e5a8aac..e56e015 100644 --- a/docs/05-more/07-data-locations.md +++ b/docs/05-more/07-data-locations.md @@ -8,6 +8,8 @@ keywords: [数据存储, 文件路径, macOS, Windows, Linux, 目录] DesireCore 将所有数据存储在本地文件系统中，不依赖云端服务器存储你的个人数据。 +登录账号后，订阅、credit、云端模型列表等账号资源会从 DesireCore 在线服务同步；本地对话、智能体、文件和自定义 API Key 仍保存在本机。 + ## 各平台数据根目录 | 平台 | 数据根目录 | @@ -18,6 +20,8 @@ DesireCore 将所有数据存储在本地文件系统中，不依赖云端服务 > `~` 表示用户主目录。例如 macOS 上 `/Users/你的用户名/.desirecore/` +如果设置了 `DESIRECORE_HOME`，DesireCore 会优先使用该路径。开发版和生产版默认隔离：生产版通常使用 `~/.desirecore/`，开发版通常使用 `~/.desirecore-dev/`。 + ## 目录结构详解 | 目录 | 用途 | 包含内容 | 可否删除 | @@ -32,6 +36,8 @@ DesireCore 将所有数据存储在本地文件系统中，不依赖云端服务 | `cache/` | 缓存 | 索引缓存、关系图谱缓存 | 可安全删除（自动重建） | | `logs/` | 日志 | 运行日志和错误排查信息 | 可安全删除 | | `market/` | 市场数据 | 官方市场仓库缓存 | 可安全删除（重新拉取） | +| `registry/` | 注册表缓存 | 模型、服务、市场元数据 | 可安全删除（重新同步） | +| `apps/` / `services/` | 应用与服务 | 已安装应用、派生服务和状态 | 删除后需重新安装 | ## 应用程序目录 @@ -50,6 +56,9 @@ DesireCore 应用本身的安装路径： | 用户配置 | `config/user-profile.json` | 用户基本信息和偏好 | | 算力配置 | `config/compute/` | API Key 和供应商配置 | | 快捷键配置 | `config/shortcuts.json` | 自定义快捷键 | +| 通知数据 | `config/notifications.json` | 通知中心状态和未读记录 | +| 密钥引用 | `config/secrets.json` | 凭据引用和授权关系，不应导出明文 | +| 调度状态 | `config/schedules/` 或运行记录目录 | 定时任务配置、触发历史和状态 | ## 备份建议 @@ -82,3 +91,7 @@ DesireCore 应用本身的安装路径： | 缓存与日志 | 索引缓存、日志文件、错误排查信息 | 自动重建 | 审计日志可以在导出数据中作为独立类别导出；当前清除入口没有独立的审计日志类别，相关执行记录会随对话记录、缓存与日志等实际存储位置一并处理。 + +:::warning 密钥与导出 +数据导出不会把系统凭据管理器中的明文 API Key 直接写进备份文件。迁移到新设备后，你可能需要重新授权或重新输入部分密钥。 +::: diff --git a/docs/06-faq/02-api-key.md b/docs/06-faq/02-api-key.md index f693232..21e8443 100644 --- a/docs/06-faq/02-api-key.md +++ b/docs/06-faq/02-api-key.md @@ -57,7 +57,7 @@ DesireCore 支持兼容 OpenAI API 格式的自定义 Provider（如本地部署 ## API 调用会产生费用吗？ -DesireCore 本身不收费，但调用 AI 模型 API 的费用由对应的供应商收取。费用取决于： +如果你使用自备 API Key，调用 AI 模型 API 的费用由对应供应商收取；如果使用官方云端算力，会消耗订阅额度或 credit。费用取决于： - 你选择的模型（不同模型价格不同） - 消息的长度（按 Token 计费） diff --git a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/01-system-requirements.md b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/01-system-requirements.md index ba68b5e..cde0a0a 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/01-system-requirements.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/01-getting-started/01-system-requirements.md @@ -56,7 +56,7 @@ DesireCore requires an internet connection to access AI services. Ensure your ne - **Access to DesireCore's update server**: e.g., `download.desirecore.net`, for receiving the latest versions and security patches - **Access to GitHub**: If you need to fetch marketplace Agents, Skills, or other resources from GitHub, ensure access to `github.com` and related CDN services. The system will automatically detect network conditions and provide fallback options when certain services are unavailable (e.g., using a secure CDN to access whitelisted repositories). -**Note:** DesireCore does not include built-in AI models — it connects to third-party services via API to provide AI capabilities. As of the current version (v10.1.0), DesireCore remains a pure client-side application with no server components; the official team does not provide a backend API, and update services rely on object storage and CDN. Therefore, no server deployment is needed — as long as you can access the APIs listed above, everything will work. +**Note:** DesireCore does not include built-in AI models. It connects to third-party APIs or official cloud compute for AI capabilities. Core data remains local-first; account sign-in, credits/subscriptions, cloud model lists, and update services require access to DesireCore online services. You can still use most core workflows with your own API keys and local data. :::tip Network Issues? If you have difficulty accessing overseas services, consider using providers with servers in your region for lower latency. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md index 6bbbf28..1b6c101 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md @@ -49,5 +49,20 @@ DesireCore supports usage without login, all core functions are fully available - **Logged-in User**: Future login will allow data sync to cloud (feature in development) :::info -Current version's login feature is under development, all functions can be used normally without login. Your data is securely stored on your local device. +Login is available for account-related capabilities such as official cloud compute, subscriptions, credits, account profile, and selected online services. Core local workflows still work without signing in. + +## Sign Up and Sign In + +You can sign up or sign in with email. Registration uses an email OTP code, and password recovery also uses email OTP. + +After signing in, DesireCore can sync account resources such as: + +- official cloud model provider +- credit balance and expiring credits +- subscription status +- available partner models + +## Sign Out + +Signing out clears the local cloud-provider session state so expired tokens are not reused. It does not delete your local conversations, agents, files, or custom API keys. ::: From a3d23398827d117739fcd31f5918328b5b6eea96 Mon Sep 17 00:00:00 2001 From: Yige Date: Tue, 7 Jul 2026 20:28:17 +0800 Subject: [PATCH 2/3] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/01-getting-started/02-installation/03-linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/01-getting-started/02-installation/03-linux.md b/docs/01-getting-started/02-installation/03-linux.md index 7ddcae5..763ae6e 100644 --- a/docs/01-getting-started/02-installation/03-linux.md +++ b/docs/01-getting-started/02-installation/03-linux.md @@ -51,7 +51,7 @@ AppImage 是一种便携式应用格式——不需要安装，下载后直接 | `~/.local/share/desirecore/DesireCore.AppImage` | 固定 AppImage 路径 | | `~/.local/bin/desirecore` | 命令行启动入口 | | `~/.local/share/applications/desirecore.desktop` | 应用菜单入口 | -| `launcher.env` | 沙箱或启动参数配置 | +| `~/.local/share/desirecore/launcher.env` | 沙箱或启动参数配置 | 如果脚本不可用，也可以继续按下面的方式手动创建桌面快捷方式。 From 381afd67ba5ec4847e850882ffc8405936b0c117 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 7 Jul 2026 12:30:06 +0000 Subject: [PATCH 3/3] fix: update en user-profile doc structure and logged-in user description --- .../current/02-user-guide/10-settings/07-user-profile.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md index 1b6c101..37b4325 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/07-user-profile.md @@ -46,10 +46,7 @@ Click **Save** after modifying the name to take effect. DesireCore supports usage without login, all core functions are fully available in guest mode. - **Guest Mode**: Data saved locally, no account registration needed -- **Logged-in User**: Future login will allow data sync to cloud (feature in development) - -:::info -Login is available for account-related capabilities such as official cloud compute, subscriptions, credits, account profile, and selected online services. Core local workflows still work without signing in. +- **Logged-in User**: Access official cloud compute, subscriptions, credits, account profile, and selected online services ## Sign Up and Sign In @@ -65,4 +62,7 @@ After signing in, DesireCore can sync account resources such as: ## Sign Out Signing out clears the local cloud-provider session state so expired tokens are not reused. It does not delete your local conversations, agents, files, or custom API keys. + +:::info Local-first +Login only affects account, subscription, and cloud compute capabilities. Your core data remains stored on your local device. :::