From 7671037c30dd7324ec300d89376e0fc1f43b5ddb Mon Sep 17 00:00:00 2001 From: yi-ge Date: Wed, 29 Jul 2026 12:20:22 +0800 Subject: [PATCH 1/2] docs(settings): add SVG diagrams for appearance, language, and permissions pages Replace previously reverted AI-generated settings screenshots with clean SVG diagrams (dark theme, consistent with repo style). Changes: - Add settings-appearance.svg: theme selector + glassmorphism preview - Add settings-language.svg: language dropdown + info box - Add settings-permissions.svg: permission list with status indicators - Update ZH/EN markdown files to reference new SVGs - Add cross-references between settings pages --- .../10-settings/01-appearance.md | 2 + docs/02-user-guide/10-settings/02-language.md | 2 + .../10-settings/05-permissions.md | 2 + .../10-settings/01-appearance.md | 2 + .../02-user-guide/10-settings/02-language.md | 2 + .../10-settings/05-permissions.md | 2 + .../10-settings/img/settings-appearance.svg | 51 ++++++++++++++++++ .../10-settings/img/settings-language.svg | 33 ++++++++++++ .../10-settings/img/settings-permissions.svg | 53 +++++++++++++++++++ .../settings/settings-appearance.svg | 51 ++++++++++++++++++ .../user-guide/settings/settings-language.svg | 33 ++++++++++++ .../settings/settings-permissions.svg | 53 +++++++++++++++++++ 12 files changed, 286 insertions(+) create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg create mode 100644 static/img/user-guide/settings/settings-appearance.svg create mode 100644 static/img/user-guide/settings/settings-language.svg create mode 100644 static/img/user-guide/settings/settings-permissions.svg diff --git a/docs/02-user-guide/10-settings/01-appearance.md b/docs/02-user-guide/10-settings/01-appearance.md index 470320e..6ab1304 100644 --- a/docs/02-user-guide/10-settings/01-appearance.md +++ b/docs/02-user-guide/10-settings/01-appearance.md @@ -13,6 +13,8 @@ DesireCore 支持三种主题模式，你可以随时在设置中切换，找到 1. 点击左下角的 **齿轮图标** 打开设置面板 2. 找到 **外观** 分区 +![外观设置界面](/img/user-guide/settings/settings-appearance.svg) + ## 主题模式 DesireCore 提供三种主题模式： diff --git a/docs/02-user-guide/10-settings/02-language.md b/docs/02-user-guide/10-settings/02-language.md index a5dfa47..e8edf47 100644 --- a/docs/02-user-guide/10-settings/02-language.md +++ b/docs/02-user-guide/10-settings/02-language.md @@ -24,6 +24,8 @@ DesireCore 支持多语言界面，你可以随时切换。 3. 点击 **语言 / Language** 右侧的下拉菜单 4. 选择目标语言 +![语言设置界面](/img/user-guide/settings/settings-language.svg) + 切换后，界面所有文案会立即更新为所选语言，无需重启。 ## 语言切换的影响范围 diff --git a/docs/02-user-guide/10-settings/05-permissions.md b/docs/02-user-guide/10-settings/05-permissions.md index 94b6e14..69d0ffc 100644 --- a/docs/02-user-guide/10-settings/05-permissions.md +++ b/docs/02-user-guide/10-settings/05-permissions.md @@ -13,6 +13,8 @@ DesireCore 的部分功能需要操作系统授予相应权限才能正常工作 1. 打开 **设置** 面板 2. 点击 **权限管理** 分区中的 **系统权限** +![权限设置界面](/img/user-guide/settings/settings-permissions.svg) + ## 权限列表 | 权限 | 用途 | 何时需要 | diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md index 92be2f9..358d8e4 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md @@ -13,6 +13,8 @@ DesireCore supports three theme modes. You can switch between them in settings a 1. Click the **gear icon** in the bottom-left corner to open the settings panel 2. Find the **Appearance** section +![Appearance Settings](/img/user-guide/settings/settings-appearance.svg) + ## Theme Modes DesireCore offers three theme modes: diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md index 4c3aff5..6ce00b8 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md @@ -24,6 +24,8 @@ More languages will be added in future versions based on community feedback. 3. Click the dropdown menu to the right of **Language** 4. Select your target language +![Language Settings](/img/user-guide/settings/settings-language.svg) + After switching, all interface text will immediately update to the selected language. ## Scope of Language Switching diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md index 9275cba..4f2056b 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md @@ -13,6 +13,8 @@ Some DesireCore features require the operating system to grant corresponding per 1. Open the **Settings** panel 2. Click **System Permissions** in the **Permission Management** section +![Permission Settings](/img/user-guide/settings/settings-permissions.svg) + ## Permission List | Permission | Purpose | When Needed | diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg new file mode 100644 index 0000000..01aebf1 --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg @@ -0,0 +1,51 @@ + + + + + + + + + + + 外观设置 + + + + 主题 + 跟随系统（默认） + + + 跟随系统 + + + + 主题预览 + + + + + + 浅色 + + + + + + 暗色 + + + + + + 跟随系统 ✓ + + + 毛玻璃效果（Glassmorphism） + + 半透明面板 + + 背景模糊 + + 柔和阴影 + \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg new file mode 100644 index 0000000..8f1367a --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg @@ -0,0 +1,33 @@ + + + + + + + + + + 语言设置 + + + + 语言 / Language + + 简体中文 + + + + 支持的语言 + + + 🇨🇳 简体中文 (zh-CN) + ✓ + + + 🇺🇸 English (en-US) + + + ℹ️ 语言切换只影响应用 UI 文案 + 智能体的对话语言取决于其角色设定，不受界面语言影响。 + 翻译回退：缺少翻译时自动回退到简体中文。 + \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg new file mode 100644 index 0000000..56c9f3c --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg @@ -0,0 +1,53 @@ + + + + + + + + + + 权限设置 + + + + + ✓ + 屏幕录制 + 截屏、屏幕共享等功能 + 已授权 + + + + ✓ + 麦克风 + 语音输入、语音通话 + 已授权 + + + + ! + 摄像头 + 视频通话、拍照 + 未授权 + + + + ! + 辅助功能 + 自动化操作、全局快捷键 + 未授权 + + + + ✓ + 通知 + 桌面通知推送 + 已授权 + + + + ℹ️ 平台差异 + macOS：屏幕录制授权后需重启应用生效 + Windows：大部分权限通过「设置 → 隐私」管理 + \ No newline at end of file diff --git a/static/img/user-guide/settings/settings-appearance.svg b/static/img/user-guide/settings/settings-appearance.svg new file mode 100644 index 0000000..01aebf1 --- /dev/null +++ b/static/img/user-guide/settings/settings-appearance.svg @@ -0,0 +1,51 @@ + + + + + + + + + + + 外观设置 + + + + 主题 + 跟随系统（默认） + + + 跟随系统 + + + + 主题预览 + + + + + + 浅色 + + + + + + 暗色 + + + + + + 跟随系统 ✓ + + + 毛玻璃效果（Glassmorphism） + + 半透明面板 + + 背景模糊 + + 柔和阴影 + \ No newline at end of file diff --git a/static/img/user-guide/settings/settings-language.svg b/static/img/user-guide/settings/settings-language.svg new file mode 100644 index 0000000..8f1367a --- /dev/null +++ b/static/img/user-guide/settings/settings-language.svg @@ -0,0 +1,33 @@ + + + + + + + + + + 语言设置 + + + + 语言 / Language + + 简体中文 + + + + 支持的语言 + + + 🇨🇳 简体中文 (zh-CN) + ✓ + + + 🇺🇸 English (en-US) + + + ℹ️ 语言切换只影响应用 UI 文案 + 智能体的对话语言取决于其角色设定，不受界面语言影响。 + 翻译回退：缺少翻译时自动回退到简体中文。 + \ No newline at end of file diff --git a/static/img/user-guide/settings/settings-permissions.svg b/static/img/user-guide/settings/settings-permissions.svg new file mode 100644 index 0000000..56c9f3c --- /dev/null +++ b/static/img/user-guide/settings/settings-permissions.svg @@ -0,0 +1,53 @@ + + + + + + + + + + 权限设置 + + + + + ✓ + 屏幕录制 + 截屏、屏幕共享等功能 + 已授权 + + + + ✓ + 麦克风 + 语音输入、语音通话 + 已授权 + + + + ! + 摄像头 + 视频通话、拍照 + 未授权 + + + + ! + 辅助功能 + 自动化操作、全局快捷键 + 未授权 + + + + ✓ + 通知 + 桌面通知推送 + 已授权 + + + + ℹ️ 平台差异 + macOS：屏幕录制授权后需重启应用生效 + Windows：大部分权限通过「设置 → 隐私」管理 + \ No newline at end of file From ef5243c3906073b04f652a2bcf762afc1f254cc6 Mon Sep 17 00:00:00 2001 From: Yige Date: Sun, 16 Aug 2026 11:13:24 +0800 Subject: [PATCH 2/2] fix(docs): use localized SVG assets for English settings pages Address Codex review on PR #48: English-locale markdown referenced the shared `static/img/.../*.svg` assets via absolute `/img/...` URLs, which always resolve to the Chinese-default SVG. Switch English markdown to relative `./img/...` paths so Docusaurus picks up the i18n-scoped copies, and re-localize the SVG text (titles, options, status labels, info boxes) so the English page actually renders an English diagram. --- .../10-settings/01-appearance.md | 4 +- .../02-user-guide/10-settings/02-language.md | 4 +- .../10-settings/05-permissions.md | 4 +- .../10-settings/img/settings-appearance.svg | 24 ++++++------ .../10-settings/img/settings-language.svg | 28 +++++++------- .../10-settings/img/settings-permissions.svg | 38 +++++++++---------- 6 files changed, 51 insertions(+), 51 deletions(-) diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md index 358d8e4..f235dc5 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/01-appearance.md @@ -13,7 +13,7 @@ DesireCore supports three theme modes. You can switch between them in settings a 1. Click the **gear icon** in the bottom-left corner to open the settings panel 2. Find the **Appearance** section -![Appearance Settings](/img/user-guide/settings/settings-appearance.svg) +![Appearance Settings](./img/settings-appearance.svg) ## Theme Modes @@ -37,4 +37,4 @@ If your usage environment differs significantly between day and night, we recomm Regardless of which theme you choose, DesireCore adopts a Glassmorphism design language, with interface elements featuring semi-transparent and blur effects to create a sense of depth and modernity. -The glassmorphism effect is more pronounced in dark mode, suitable for immersive use. +The glassmorphism effect is more pronounced in dark mode, suitable for immersive use. \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md index 6ce00b8..0a32f59 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/02-language.md @@ -24,7 +24,7 @@ More languages will be added in future versions based on community feedback. 3. Click the dropdown menu to the right of **Language** 4. Select your target language -![Language Settings](/img/user-guide/settings/settings-language.svg) +![Language Settings](./img/settings-language.svg) After switching, all interface text will immediately update to the selected language. @@ -42,4 +42,4 @@ Language switching **does not** affect the agent's conversation language. The la ## Contributing Translations -DesireCore's interface text is stored in the `app/data/i18n/` directory. If you'd like to help improve translations or contribute new languages, welcome to submit a Pull Request via GitHub. +DesireCore's interface text is stored in the `app/data/i18n/` directory. If you'd like to help improve translations or contribute new languages, welcome to submit a Pull Request via GitHub. \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md index 4f2056b..c35717f 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/05-permissions.md @@ -13,7 +13,7 @@ Some DesireCore features require the operating system to grant corresponding per 1. Open the **Settings** panel 2. Click **System Permissions** in the **Permission Management** section -![Permission Settings](/img/user-guide/settings/settings-permissions.svg) +![Permission Settings](./img/settings-permissions.svg) ## Permission List @@ -51,4 +51,4 @@ Each permission item displays its current status: ## Web Mode Note -When running DesireCore in Web mode, permissions are managed by the browser. Browsers usually automatically popup to ask when you first use hardware like microphone or camera. You can view and manage granted permissions in the browser's site settings. +When running DesireCore in Web mode, permissions are managed by the browser. Browsers usually automatically popup to ask when you first use hardware like microphone or camera. You can view and manage granted permissions in the browser's site settings. \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg index 01aebf1..9b54100 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-appearance.svg @@ -8,44 +8,44 @@ - 外观设置 + Appearance - 主题 - 跟随系统（默认） + Theme + Follow System (default) - 跟随系统 + Follow System - 主题预览 + Theme Preview - 浅色 + Light - 暗色 + Dark - 跟随系统 ✓ + Follow System ✓ - 毛玻璃效果（Glassmorphism） + Glassmorphism - 半透明面板 + Translucent - 背景模糊 + Blur - 柔和阴影 + Soft Shadow \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg index 8f1367a..d0f9657 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-language.svg @@ -7,27 +7,27 @@ - 语言设置 + Language - 语言 / Language + Language - 简体中文 + English - 支持的语言 - - - 🇨🇳 简体中文 (zh-CN) - ✓ - - - 🇺🇸 English (en-US) + Supported Languages + + + 🇺🇸 English (en-US) + ✓ + + + 🇨🇳 Simplified Chinese (zh-CN) - ℹ️ 语言切换只影响应用 UI 文案 - 智能体的对话语言取决于其角色设定，不受界面语言影响。 - 翻译回退：缺少翻译时自动回退到简体中文。 + ℹ️ Language switching only affects the app UI text + The agent's reply language follows its Persona, not the UI language. + Fallback: missing translations fall back to Simplified Chinese. \ No newline at end of file diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg index 56c9f3c..2117b9c 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/img/settings-permissions.svg @@ -7,47 +7,47 @@ - 权限设置 + Permissions ✓ - 屏幕录制 - 截屏、屏幕共享等功能 - 已授权 + Screen Recording + Screenshots, screen sharing + Authorized ✓ - 麦克风 - 语音输入、语音通话 - 已授权 + Microphone + Voice input, voice calls + Authorized ! - 摄像头 - 视频通话、拍照 - 未授权 + Camera + Video calls, photos + Not Authorized ! - 辅助功能 - 自动化操作、全局快捷键 - 未授权 + Accessibility + Automation, global shortcuts + Not Authorized ✓ - 通知 - 桌面通知推送 - 已授权 + Notifications + Desktop notification push + Authorized - ℹ️ 平台差异 - macOS：屏幕录制授权后需重启应用生效 - Windows：大部分权限通过「设置 → 隐私」管理 + ℹ️ Platform notes + macOS: Screen Recording needs an app restart after granting. + Windows: Most permissions live under Settings → Privacy. \ No newline at end of file