diff --git a/AGENTS.md b/AGENTS.md index d9e20e1..e4d8ba1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,7 +13,7 @@ PR 合并到 `main` 或推送到 `main` 后会自动部署。用户要求部署 - 已有明确生效版本时保留真实版本号；无法确定生效版本时统一使用 `v10.0.178+`。不要把已明确的版本改成默认值，例如长期指令保留 `v10.0.179+`。 - 提示框放在对应页面或章节的开头附近，注明具体功能范围。只约束某一功能时，不要写成整页功能都受该版本限制。提示框独立成块，不嵌入正文段落或其他提示框。 - 两种语言原文都已有同一功能的版本约束时，标注的版本和功能范围应一致；不要仅为对齐格式而向原文无版本约束的译文新增标注。 -- 保留开发状态、安装包可用性、平台、权限和供应商授权等既有条件。生效版本标注不代表安装包已经公开发行，也不代表功能自动获得授权。 +- 生效版本直接说明用户需要的客户端版本。不要附加“开发分支已实现”“实际可用以安装包为准”“确认安装包包含该能力”等无法由普通用户判断的内部说明。保留确实影响使用的平台、权限和供应商授权条件，并写成用户能判断或操作的要求；尚未开放的功能直接说明暂不可用。 - 更新日志、未实现的规划、操作系统或运行时要求、协议修订号、配置版本及示例内容版本保留各自的含义和编号，不改写成客户端生效版本。 中文格式： @@ -33,3 +33,10 @@ PR 合并到 `main` 或推送到 `main` 后会自动部署。用户要求部署 ``` README.md 的贡献说明维护同一规范，修改时保持两处一致。 + +## 面向普通用户的写作规范 + +- 优先说明功能能做什么、在哪里使用、需要什么条件、遇到问题怎么办。 +- 不把开发分支、代码合入、源码配置快照、内部发布门控、组件迁移计划等开发细节作为使用说明，也不要要求用户检查这些细节。 +- 将实现状态说明改成明确的生效版本、当前支持范围或可见的操作步骤；组件名称和技术细节仅在帮助用户配置、排查问题或理解权限与许可时保留。 +- 避免把写给文档作者的告诫放进用户正文。中英文按同一原则修订，保留真实的功能限制和授权条件。 diff --git a/README.md b/README.md index 84c039f..1bb87cb 100644 --- a/README.md +++ b/README.md @@ -100,7 +100,7 @@ Follow the same convention as [AGENTS.md](./AGENTS.md) when writing or revising - Keep a documented introduction version. When the effective version is uncertain, use `v10.0.178+`. Do not replace a known version with the default; standing instructions retain `v10.0.179+`. - Place the callout near the beginning of the relevant page or section and name the affected feature. A constraint on one feature must not imply that every feature on the page requires that version. Keep the callout separate from prose paragraphs and other callouts. - When both locales already state a constraint for the same feature, their version and feature scope must agree. Do not add a constraint to a translation that had none merely to match formatting. -- Preserve existing development status, installed-package availability, platform, permission, and provider eligibility conditions. An effective-version label does not prove public release or grant authorization. +- State the client version the user needs directly. Omit internal caveats such as “implemented on the development branch,” “availability depends on the installed package,” or “confirm that the package includes this capability.” Preserve platform, permission, and provider eligibility conditions that affect use, expressed as requirements users can understand or check. For a feature that is not available, say so directly. - Release history, unimplemented plans, OS/runtime requirements, agreement revisions, configuration versions, and example content versions retain their own meaning and numbering. Use the following format, replacing the example version and feature name as appropriate: @@ -117,6 +117,13 @@ Use the following format, replacing the example version and feature name as appr Keep this convention and AGENTS.md consistent when updating either file. +### Writing for end users + +- Explain what a feature does, where to use it, what it requires, and how to resolve problems. +- Keep development branches, merge status, source configuration snapshots, internal release gates, and component migration plans out of user instructions. Never ask users to check these details. +- Replace implementation-status caveats with an effective version, current support scope, or visible steps. Keep component names and technical details when they help with configuration, troubleshooting, permissions, or licenses. +- Keep advice for documentation authors out of user-facing prose. Apply this approach in both languages while preserving actual limitations and authorization conditions. + ## License - Source code, theme customizations, and project configuration in this repository are licensed under the [MIT License](LICENSE). diff --git a/docs/01-getting-started/01-system-requirements.md b/docs/01-getting-started/01-system-requirements.md index 0ea76f4..ee8056b 100644 --- a/docs/01-getting-started/01-system-requirements.md +++ b/docs/01-getting-started/01-system-requirements.md @@ -41,7 +41,7 @@ macOS 的 GUI 自动化当前由 HostAgent 承载。首次使用相关能力时 | 磁盘空间 | 2GB | 20 GB 及以上 | :::info Windows 本机 GUI 自动化 -Windows 安装包已内置并默认启用 CUA Driver，本机 GUI 自动化不需要另装 HostAgent。这是 Windows HostAgent 完成前的过渡实现；macOS 当前仍使用 HostAgent，Windows、Linux 和其他平台的 HostAgent 仍在开发。详见 [GUI 桌面自动化](../02-user-guide/09-capabilities/05-computer-use.md)。 +Windows 安装包已内置并默认启用 CUA Driver，本机 GUI 自动化不需要另装 HostAgent。macOS 的 GUI 自动化使用 HostAgent，需要授予相应系统权限。详见 [GUI 桌面自动化](../02-user-guide/09-capabilities/05-computer-use.md)。 ::: ### Linux diff --git a/docs/01-getting-started/02-installation/01-windows.md b/docs/01-getting-started/02-installation/01-windows.md index d431904..466dd44 100644 --- a/docs/01-getting-started/02-installation/01-windows.md +++ b/docs/01-getting-started/02-installation/01-windows.md @@ -55,7 +55,7 @@ DesireCore 会在首次启动后，将推荐的 Python 和 Node.js 版本导入 ### CUA Driver（GUI 自动化） -CUA Driver 仅用于当前 Windows 电脑的 GUI 自动化，默认启用。它是 Windows HostAgent 完成前的过渡实现，让 Windows 用户先具备 GUI 操作能力。macOS 当前仍由 HostAgent 承载 GUI 操作，Windows、Linux 和其他平台的 HostAgent 仍在开发中。 +CUA Driver 默认启用，用于操作当前 Windows 电脑上的应用界面。你可以直接向智能体描述任务，例如“打开记事本并输入会议摘要”。 :::note 磁盘占用与安全扫描 这些归档和可执行程序会增加安装包与首次启动后的磁盘占用。安全软件也可能在首次解包或运行时再次扫描它们；请等待扫描完成，不要通过关闭系统防护来强行绕过告警。 diff --git a/docs/01-getting-started/02-installation/02-macos.md b/docs/01-getting-started/02-installation/02-macos.md index 6be5cda..c303251 100644 --- a/docs/01-getting-started/02-installation/02-macos.md +++ b/docs/01-getting-started/02-installation/02-macos.md @@ -34,9 +34,9 @@ keywords: [macOS, 安装, DMG, Gatekeeper, Apple Silicon, Intel] ## GUI 自动化与 HostAgent -macOS 版本当前由 **HostAgent** 承载本机 GUI 操作和相关设备能力。HostAgent 是现行执行组件，并未被 Windows 使用的 CUA Driver 取代。 +macOS 通过 **HostAgent** 操作本机应用界面。使用前请确认 HostAgent 已连接到 DesireCore。 -首次使用界面读取、点击、输入或截图等能力时，macOS 可能要求授予 **辅助功能**、**屏幕录制**等权限。请只按实际任务需要授权；如果权限变更后能力没有立即恢复，重新启动 HostAgent 或 DesireCore 后再试。Windows 暂时使用内置 CUA Driver，是 Windows HostAgent 完成前让用户先获得 GUI 能力的过渡方案。 +首次使用界面读取、点击、输入或截图等能力时，macOS 可能要求授予 **辅助功能**、**屏幕录制**等权限。请只按实际任务需要授权；如果权限变更后能力没有立即恢复，重新启动 HostAgent 或 DesireCore 后再试。 ## 处理 Gatekeeper 提示 diff --git a/docs/02-user-guide/04-delegation/04-human-gate.md b/docs/02-user-guide/04-delegation/04-human-gate.md index 78d2b16..99ddec9 100644 --- a/docs/02-user-guide/04-delegation/04-human-gate.md +++ b/docs/02-user-guide/04-delegation/04-human-gate.md @@ -65,7 +65,7 @@ keywords: [人闸门, Human Gate, 确认, 权限, 风险等级, 安全] 智能体："好的，正在执行..." ``` -对于支持记忆的命令审批，还可选择 **“总是允许”**。当前实现会记住这一次完整命令的精确规则，不会自动扩大为“同一目录”或“同一可执行文件”的全部操作。 +对于支持记忆的命令审批，还可选择 **“总是允许”**。系统会记住这一次完整命令的精确规则，不会自动扩大为“同一目录”或“同一可执行文件”的全部操作。 ### 拒绝 diff --git a/docs/02-user-guide/05-super-document/05-version-history.md b/docs/02-user-guide/05-super-document/05-version-history.md index b3ab36b..4ae890a 100644 --- a/docs/02-user-guide/05-super-document/05-version-history.md +++ b/docs/02-user-guide/05-super-document/05-version-history.md @@ -17,7 +17,7 @@ keywords: [版本历史, 版本管理, 回溯, 版本对比, 回滚] - **操作人**：标记是智能体修改还是你手动编辑 - **时间戳**：精确到分钟 -在当前实现中，版本历史基于文件的 Git 提交记录。每次智能体修改、手动编辑、导出前的重要保存点都会形成可追溯记录。 +每次智能体修改、手动编辑，以及导出前的重要保存点都会记录在版本历史中，方便你比较修改或恢复旧稿。 超级文书可能按以下粒度展示版本： diff --git a/docs/02-user-guide/06-agents/03-create-agent.md b/docs/02-user-guide/06-agents/03-create-agent.md index e8c0f26..72f81d2 100644 --- a/docs/02-user-guide/06-agents/03-create-agent.md +++ b/docs/02-user-guide/06-agents/03-create-agent.md @@ -7,7 +7,7 @@ keywords: [创建智能体, 自定义 Agent, 对话创建, 模板] # 创建自定义智能体 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: 当市场上没有满足你需求的智能体时，你可以创建一个完全自定义的智能体。DesireCore 提供两种创建方式。 diff --git a/docs/02-user-guide/06-agents/04-edit-persona.md b/docs/02-user-guide/06-agents/04-edit-persona.md index 3c11595..1a6ba8f 100644 --- a/docs/02-user-guide/06-agents/04-edit-persona.md +++ b/docs/02-user-guide/06-agents/04-edit-persona.md @@ -7,7 +7,7 @@ keywords: [人格设定, Persona, 角色定位, 性格特征, 智能体配置] # 编辑人格设定 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: 人格设定（Persona）定义了智能体"是谁"——它的语气、风格、专业领域和行为方式。这不是一段人设文案，而是一份**可执行的行为规范**。 diff --git a/docs/02-user-guide/06-agents/05-edit-principles.md b/docs/02-user-guide/06-agents/05-edit-principles.md index a873bb4..4c16fe4 100644 --- a/docs/02-user-guide/06-agents/05-edit-principles.md +++ b/docs/02-user-guide/06-agents/05-edit-principles.md @@ -7,7 +7,7 @@ keywords: [行为准则, Principles, L0, L1, L2, 安全规则, 优先级] # 编辑行为准则 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: 行为准则（Principles）是智能体的"行为手册"——它规定了智能体必须遵守的规则、禁止触碰的红线，以及决策时的优先级排序。 diff --git a/docs/02-user-guide/06-agents/06-agent-files.md b/docs/02-user-guide/06-agents/06-agent-files.md index 0081827..a8816ef 100644 --- a/docs/02-user-guide/06-agents/06-agent-files.md +++ b/docs/02-user-guide/06-agents/06-agent-files.md @@ -7,7 +7,7 @@ keywords: [AgentFS, 文件系统, 资源管理器, 智能体文件, 文件结构 # 文件资源管理器 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: 每个智能体的所有配置、记忆和技能都以文件的形式存储在 AgentFS（智能体文件系统）中。资源管理器让你可以直观地浏览和管理这些文件。 diff --git a/docs/02-user-guide/06-agents/09-clone-and-sync.md b/docs/02-user-guide/06-agents/09-clone-and-sync.md index 3f8c76f..9ee1fc2 100644 --- a/docs/02-user-guide/06-agents/09-clone-and-sync.md +++ b/docs/02-user-guide/06-agents/09-clone-and-sync.md @@ -7,7 +7,7 @@ keywords: [Clone, 克隆智能体, 同步, 冲突解决, Agent Git] # Clone 与同步 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: Clone 用于基于现有智能体创建一个新副本。它适合做实验、为不同项目准备变体，或把市场智能体调整成自己的版本。 diff --git a/docs/02-user-guide/06-agents/12-prompt-center.md b/docs/02-user-guide/06-agents/12-prompt-center.md index 606dcdf..2cdfb4a 100644 --- a/docs/02-user-guide/06-agents/12-prompt-center.md +++ b/docs/02-user-guide/06-agents/12-prompt-center.md @@ -7,7 +7,7 @@ keywords: [提示词中心, 系统提示词, 全局提示词, 团队提示词, P # 提示词中心与内容归属 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: 提示词中心把分散在用户、团队和智能体目录中的提示词来源放到同一个界面中管理。打开 **资源管理器 → 提示词中心**，左侧选择作用范围，右侧编辑内容或预览组合结果。 @@ -89,7 +89,7 @@ L0/L1/L2 表示加载粒度，不是权限或安全等级。分层文件没有 | 预览中看到重复内容 | 同一要求写到了多个作用范围；保留在真正归属的位置 | | 团队提示词不生效 | 确认智能体已加入该团队；多团队时检查对应来源 | | 分层源码提示格式问题 | 检查标题是否严格为 `## L0`、`## L1`、`## L2`；长期指令无需这些标题 | -| 找不到长期指令入口 | 升级至 `v10.0.179+`，并确认安装包包含长期指令能力 | +| 找不到长期指令入口 | 在 **设置 → 关于** 中检查版本，升级至 `v10.0.179+` 后重试 | | 长期指令超出预算 | 精简正文，把详细步骤移到技能；它不会通过截断或 L2 隐藏来继续执行 | :::caution 提示词 ≠ 权限 diff --git a/docs/02-user-guide/09-capabilities/05-computer-use.md b/docs/02-user-guide/09-capabilities/05-computer-use.md index 0821d25..97bd91a 100644 --- a/docs/02-user-guide/09-capabilities/05-computer-use.md +++ b/docs/02-user-guide/09-capabilities/05-computer-use.md @@ -1,6 +1,6 @@ --- title: GUI 桌面自动化 -description: 了解 DesireCore 如何在 macOS 上通过 HostAgent、在 Windows 上暂时通过内置 CUA Driver 操作本机图形界面。 +description: 了解 DesireCore 如何在 macOS 上通过 HostAgent、在 Windows 上通过内置 CUA Driver 操作本机图形界面。 keywords: [Computer Use, CUA Driver, GUI, Windows, macOS, 桌面自动化, HostAgent] --- @@ -8,42 +8,32 @@ keywords: [Computer Use, CUA Driver, GUI, Windows, macOS, 桌面自动化, HostA ## 当前可用范围 -DesireCore 当前可以在 **macOS 和 Windows 本机**操作原生应用的图形界面，例如读取窗口与可访问性元素、点击控件、输入文字、发送按键以及获取界面状态。两个平台使用的执行载体不同： +DesireCore 当前可以在 **macOS 和 Windows 本机**操作原生应用的图形界面，例如读取窗口与可访问性元素、点击控件、输入文字、发送按键以及获取界面状态。两个平台的使用要求不同： -- **macOS**：HostAgent 是现行 GUI 操作载体，通过 macOS 原生系统能力执行操作。 -- **Windows**：在 Windows HostAgent 完成前，DesireCore 暂时使用内置 CUA Driver，让 Windows 用户可以先使用本机 GUI 自动化。 +- **macOS**：需要连接 HostAgent，并授予辅助功能、屏幕录制等任务所需权限。 +- **Windows**：使用内置 CUA Driver 操作本机应用界面，无需另外安装 HostAgent。 Windows 安装包已内置并默认启用 [CUA Driver](https://github.com/trycua/cua)。正常情况下，Windows 用户不需要另行下载安装驱动或 HostAgent，直接向智能体描述任务即可。 -:::info 为什么 Windows 本机不需要 HostAgent？ -HostAgent 并未被 CUA Driver 取代：macOS 当前仍通过 HostAgent 承载 GUI 操作。只是 Windows 版 HostAgent 尚在开发，DesireCore 才暂时通过 CUA Driver MCP 子进程提供本机能力。待 Windows HostAgent 完成后，平台载体和能力边界可能继续调整。 -::: - | 场景 | 当前状态 | 所需组件 | |------|---------|---------| | macOS 本机 GUI 自动化 | 已支持 | macOS HostAgent；需授予相应系统权限 | -| Windows 本机 GUI 自动化 | 已支持（过渡实现） | DesireCore 内置 CUA Driver，零安装 | -| Windows、Linux HostAgent | 开发中 | 后续原生 HostAgent 实现 | -| 其他桌面系统与 Android、iOS、HarmonyOS HostAgent | 开发中 | 后续平台实现 | +| Windows 本机 GUI 自动化 | 已支持 | DesireCore 内置 CUA Driver，零安装 | +| Linux、其他桌面系统与 Android、iOS、HarmonyOS GUI 自动化 | 暂不支持 | — | ## 工作原理 -两个已支持平台的任务入口相同，但执行路径不同。 - ### macOS：HostAgent 路径 -1. 你在 DesireCore 中描述 GUI 操作任务。 -2. 智能体规划步骤，并通过设备能力链路调用 macOS HostAgent。 -3. HostAgent 使用 macOS 原生 Framework 和已授予的辅助功能、屏幕录制等权限执行操作。 -4. HostAgent 返回界面或执行结果，智能体据此继续任务并核对状态。 +1. 在 DesireCore 中描述要完成的任务。 +2. HostAgent 已连接并获得所需权限后，智能体读取界面，执行点击、输入或截图等操作。 +3. 智能体在每一步后检查界面，并向你报告结果；需要确认时会暂停等待。 -### Windows：CUA Driver 过渡路径 +### Windows：CUA Driver 路径 -1. 你在 DesireCore 中描述任务，例如“打开记事本并输入会议摘要”。 -2. 智能体规划步骤，并从系统 MCP 中选择 CUA Driver 提供的工具。 -3. DesireCore 在本机启动独立的 `cua-driver` 子进程，通过标准输入输出与其通信。 -4. CUA Driver 调用 Windows UI Automation、窗口和输入相关能力，返回窗口、元素或截图结果。 -5. 智能体根据结果继续操作并核对最终状态。 +1. 在 DesireCore 中描述任务，例如“打开记事本并输入会议摘要”。 +2. 智能体使用可用的桌面操作工具读取窗口、点击控件、输入文字或获取截图。 +3. 智能体在每一步后检查界面，确认操作结果。 如果你的 `PATH` 中已有自行安装的 `cua-driver`，DesireCore 会优先使用它；否则回退到安装包内置版本。两者都不可用时，系统会跳过该能力，不会反复弹出连接错误。 @@ -102,7 +92,7 @@ GUI 自动化依赖目标平台提供的可访问性、窗口和输入能力， - 对业务关键流程先在测试账号或副本数据上验证。 :::warning 第三方组件 -Windows 当前使用的 CUA Driver 是由其权利人提供、按其自身许可证分发的独立第三方程序，并非 DesireCore 自有组件或 HostAgent。它是 Windows HostAgent 完成前的过渡载体；其版本、兼容性和上游支持可能变化，具体以随软件提供的第三方声明及 [第三方软件与许可](../../05-more/10-third-party-software.md) 为准。 +Windows 当前使用的 CUA Driver 是由其权利人提供、按其自身许可证分发的独立第三方程序，并非 DesireCore 自有组件或 HostAgent。其版本、兼容性和上游支持可能变化，具体以随软件提供的第三方声明及 [第三方软件与许可](../../05-more/10-third-party-software.md) 为准。 ::: ## 下一步 diff --git a/docs/02-user-guide/09-capabilities/06-integrations-overview.md b/docs/02-user-guide/09-capabilities/06-integrations-overview.md index 419d99d..a718af6 100644 --- a/docs/02-user-guide/09-capabilities/06-integrations-overview.md +++ b/docs/02-user-guide/09-capabilities/06-integrations-overview.md @@ -73,11 +73,11 @@ DesireCore 内置完整的邮件管理能力，支持 Gmail、Outlook 和 IMAP/S ## 桌面与移动设备 -当没有现成的 API 或工具可用时，DesireCore 可以通过 Computer Use 操作图形界面。目前 **macOS 由 HostAgent 承载 GUI 操作**；**Windows 暂时由内置并默认启用的 CUA Driver 承载**，让 Windows 用户在原生 HostAgent 完成前先具备本机能力。Windows、Linux、其他桌面系统及移动端 HostAgent 仍在开发。 +当没有现成的 API 或工具可用时，DesireCore 可以通过 Computer Use 操作本机图形界面。目前支持 **macOS 和 Windows**：macOS 需连接 HostAgent 并授予系统权限，Windows 已内置并启用 CUA Driver。 - **macOS 桌面应用操控** — 由 HostAgent 通过 macOS 原生能力执行，需要相应系统权限 -- **Windows 桌面应用操控** — 由 CUA Driver 过渡实现，通过可访问性元素、鼠标和键盘操作当前电脑上的 GUI 应用 -- **Linux、其他桌面与移动设备** — 属于后续 HostAgent 平台路线，当前不应按已经可用理解 +- **Windows 桌面应用操控** — 通过内置 CUA Driver 操作当前电脑上的 GUI 应用 +- **Linux、其他桌面与移动设备** — 暂不支持 GUI 自动化 - **屏幕感知** — 截屏、识别界面元素，理解当前画面内容 Computer Use 适合没有开放 API、需要跨多个桌面应用完成的任务，但并非所有界面都能可靠操控。自绘控件、UAC 安全桌面、锁屏、管理员应用和受保护内容可能不可访问；发送、支付、删除、发布等外部副作用仍应由用户确认。 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 78b841e..057996b 100644 --- a/docs/02-user-guide/10-settings/04-compute-service.md +++ b/docs/02-user-guide/10-settings/04-compute-service.md @@ -79,31 +79,25 @@ DesireCore 内置多家主流供应商模板，也支持自定义 OpenAI 兼容 ## Claude Pro / Max 订阅 :::info 生效版本 -`v10.0.178+`（Claude 订阅接入实现）。实际入口是否开放仍取决于下文的授权条件与发布策略。 +`v10.0.178+`（Claude 订阅接入）。使用前请阅读下文的授权条件。 ::: -算力服务可显示 **Claude 订阅** 供应商。该路径使用 Anthropic 官方的 `@anthropic-ai/claude-agent-sdk` 发起模型请求，不会通过伪造 Claude Code 请求头来直连 Anthropic。 +如果算力服务中显示 **Claude 订阅** 供应商，可以按界面提示连接账号。使用此入口需要符合 Anthropic 的订阅与授权规则，具体条件见下文。 ### 运行方式与 Claude Code 的区别 -从执行边界看，这是一条双运行时协作链路： +选择 Claude 订阅模型后，你仍然在 DesireCore 中对话。智能体继续使用 DesireCore 的记忆、技能、工具、审批设置和审计记录，不会因此启用 Claude Code 自带的工具、插件或斜杠命令。 -1. **DesireCore Agent 运行时**负责系统提示词、记忆、Skill、工具注册、权限审批、委派和执行审计 -2. **Claude Agent SDK 运行时**负责使用 Claude 订阅身份完成模型请求并返回文本或 `tool_use` -3. `tool_use` 会交回 DesireCore，由 DesireCore 的工具和审批链执行 - -Claude Agent SDK 自带的工具、Skill、Plugin、子 Agent、斜杠命令和连接器不会在这条路径中使用；SDK 也不会代替 DesireCore 执行文件、命令或外部服务操作。因此，Claude 订阅模型在 DesireCore 中的上下文、工具集合、权限边界和最终效果，和直接使用 Claude Code 有本质区别。 - -如果你需要在 DesireCore 中使用完整的 Claude Code 编程工作流，请让 **DesireCore 智能体调用本机的 Claude Code**；不要把“选择 Claude 订阅模型”理解为直接进入 Claude Code。 +如果你需要完整的 Claude Code 编程工作流，请让 **DesireCore 智能体调用本机安装的 Claude Code**。 ### 连接方式 -界面会优先检测本机 Claude Code 登录状态。根据平台、授权条件和发布策略，还可能提供应用内登录或粘贴 `claude setup-token` 的高级连接方式。连接后可使用 Claude 订阅供应商提供的模型；断开、过期或刷新失败时，界面会提示重新检测或重新登录。 +界面会优先检测本机 Claude Code 登录状态。如果页面提供“登录”或粘贴 `claude setup-token` 的选项，按相应提示完成连接。连接后可使用 Claude 订阅供应商提供的模型；断开、过期或刷新失败时，界面会提示重新检测或重新登录。 ### 条款、授权与账户风险 :::warning 使用资格以 Anthropic 的规则为准 -使用官方 SDK 说明 DesireCore 按官方技术接口实现该路径，**不等于 Anthropic 已允许第三方产品转发 Claude Free、Pro 或 Max 凭据**。截至本文更新时，Anthropic 的 [Claude Code 法律与合规说明](https://code.claude.com/docs/en/legal-and-compliance)明确要求构建第三方产品的开发者使用 API Key 或受支持的云平台认证，并不允许第三方向用户提供 Claude.ai 登录或代用户转发 Free、Pro、Max 凭据。因此，Claude 订阅入口在取得适用于 DesireCore 场景的明确授权前应保持发布门控；该能力是否开放取决于后续官方授权、当时有效的条款、地区、账户和 DesireCore 发布策略。 +**使用 Claude 订阅需符合 Anthropic 的授权要求**。截至本文更新时，Anthropic 的 [Claude Code 法律与合规说明](https://code.claude.com/docs/en/legal-and-compliance)明确要求构建第三方产品的开发者使用 API Key 或受支持的云平台认证，并不允许第三方向用户提供 Claude.ai 登录或代用户转发 Free、Pro、Max 凭据。Claude 订阅仅可在获得适用授权、并符合条款及地区和账号条件时使用。如果你无法使用此入口，请改用 Anthropic API Key 或其明确支持的云平台认证。 ::: 你应自行确认订阅用途、账户类型、使用地区和自动化方式符合 Anthropic 的现行条款。因订阅使用方式、账户状态或供应商政策导致的限流、功能限制、凭据失效、账户暂停或封禁风险由用户承担；DesireCore 无法控制 Anthropic 的账户处置。需要稳定的商业或组织级接入时，优先使用 Anthropic API Key 或其明确支持的云平台认证。 diff --git a/docs/02-user-guide/11-security/05-ai-approval.md b/docs/02-user-guide/11-security/05-ai-approval.md index 1c9cccf..e7047af 100644 --- a/docs/02-user-guide/11-security/05-ai-approval.md +++ b/docs/02-user-guide/11-security/05-ai-approval.md @@ -9,7 +9,7 @@ keywords: [AI 审批, 工具审批, 命令审批, 无人值守, 委派, 权限] 每个智能体都有独立的审批偏好。审批决定某次操作是否放行；执行方的工具授权、文件范围、拒绝规则和专用授权仍须满足。 :::info 生效版本 -`v10.0.178+`（无人委派读取直接上级审批设置）。该行为已在开发分支实现，实际可用以安装包为准。更早的客户端仍可能读取执行方设置。 +`v10.0.178+`（无人委派读取直接上级审批设置）。更早的客户端仍可能读取执行方设置。 ::: ## 审批设置从谁读取 diff --git a/docs/04-concepts/03-agentfs.md b/docs/04-concepts/03-agentfs.md index a1c6016..e0561ab 100644 --- a/docs/04-concepts/03-agentfs.md +++ b/docs/04-concepts/03-agentfs.md @@ -7,7 +7,7 @@ keywords: [AgentFS, 文件系统, 数据存储, Git, 智能体仓库] # AgentFS 文件系统 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: ## AgentFS 就像每个智能体的"家" diff --git a/docs/04-concepts/06-self-evolution.md b/docs/04-concepts/06-self-evolution.md index f16cf60..5da74fe 100644 --- a/docs/04-concepts/06-self-evolution.md +++ b/docs/04-concepts/06-self-evolution.md @@ -7,7 +7,7 @@ keywords: [自我进化, Self-Evolution, 学习, 记忆, 经验积累] # 自我进化 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: ## 智能体不是静态的 diff --git a/docs/04-concepts/12-agent-permission-boundary.md b/docs/04-concepts/12-agent-permission-boundary.md index e0bbe95..57f1494 100644 --- a/docs/04-concepts/12-agent-permission-boundary.md +++ b/docs/04-concepts/12-agent-permission-boundary.md @@ -86,7 +86,7 @@ keywords: [权限, 边界, 委派, 协作, 安全, 责任, Permission, Boundary] ## 审批设置来源与执行权限分开 -无人委派读取直接上级的审批模式和记忆规则，不意味着继承上级的执行身份或扩大权限。有人值守沿用原审批来源；`SendMessage` 不传递审批设置。来源与七种模式的完整表格见[工具与命令审批模式](../02-user-guide/11-security/05-ai-approval.md)。本次开发变更尚不代表客户端安装包已发布。 +无人委派读取直接上级的审批模式和记忆规则，不意味着继承上级的执行身份或扩大权限。有人值守沿用原审批来源；`SendMessage` 不传递审批设置。来源与七种模式的完整表格见[工具与命令审批模式](../02-user-guide/11-security/05-ai-approval.md)。 ## 下一步 diff --git a/docs/04-concepts/13-business-ontology.md b/docs/04-concepts/13-business-ontology.md index d4838dc..0cb56a8 100644 --- a/docs/04-concepts/13-business-ontology.md +++ b/docs/04-concepts/13-business-ontology.md @@ -81,8 +81,8 @@ DesireCore 不要求把本体资产放进一个额外的黑盒系统，而是让 | Hook / Policy / Human Gate | 限制高风险动作和系统回写 | 策略命中、审批、拒绝与临时授权 | | [回执系统](./receipt-system) | 记录本体驱动任务使用了什么信息、规则与动作 | 输入输出、工具调用、证据和异常记录 | -:::warning 不要把方法写成不存在的产品能力 -当项目只使用文件、记忆、Skill 和 Workflow 来组织业务语境时，应准确描述这些资产如何组合。只有在实际实现了专门的数据模型、编辑器、查询接口或运行时之后，才能进一步声称提供对应的“本体平台”能力。 +:::info 确认项目需要的能力 +你可以用文件、记忆、Skill 和 Workflow 组织业务语境，连接信息、规则与执行步骤。如果项目需要专门的数据模型、编辑器或查询接口，请在项目方案中明确这些需求，并确认所选工具能够提供这些能力。 ::: ## FDE 式落地：从最小可用本体开始 diff --git a/docs/05-more/03-glossary.md b/docs/05-more/03-glossary.md index 2ddac21..45fa927 100644 --- a/docs/05-more/03-glossary.md +++ b/docs/05-more/03-glossary.md @@ -100,7 +100,7 @@ DesireCore 的核心交互范式。不是"我问你答"，而是"我教你做" ### Instructions（长期指令） :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: 智能体根目录下的可选 `instructions.md`，保存 Agent 专属的长期职责、默认工作策略和交付标准。使用普通 Markdown，获准加载时全文进入上下文，不解析 L0/L1/L2、不摘要或截断，也不授予权限。详见[文件格式说明](./06-file-formats.md)。 diff --git a/docs/05-more/04-supported-providers.md b/docs/05-more/04-supported-providers.md index 4163ecc..59e5b80 100644 --- a/docs/05-more/04-supported-providers.md +++ b/docs/05-more/04-supported-providers.md @@ -6,11 +6,11 @@ keywords: [供应商, Provider, AI 模型, API, OpenAI, Claude, DeepSeek] # 支持的 AI 供应商列表 -DesireCore 的供应商和模型列表由 config-center 持续更新，实际可用项会随客户端、账号权限和远端配置变化。本文列出常见供应商和能力类型，作为配置参考；具体模型、价格和上下文长度请以「设置 > 算力服务」中的实时列表为准。 +DesireCore 会自动更新供应商和模型列表。你能使用哪些模型，取决于客户端版本、供应商连接状态和账号权限。本文列出常见供应商和能力类型，作为配置参考；具体模型、价格和上下文长度请以「设置 > 算力服务」中的实时列表为准。 支持的服务类型包括对话、推理、工具调用、视觉理解、嵌入、语音合成、语音识别、图像生成、视频生成、音乐生成、OCR、Computer Use 等。 -源码随附的配置中心版本 123（2026-10-01）已包含 GPT-6.1 Sol、Claude Sonnet 5.5 和 Claude Opus 5.5。GPT-6.1 Sol 的工具调用使用 Responses API，请确认所用网关支持该协议。模型是否出现在列表中，还取决于配置同步、来源启用状态、凭据和账号权限。 +查找 GPT-6.1 Sol、Claude Sonnet 5.5 或 Claude Opus 5.5 等模型时，先打开 **设置 → 算力服务**，连接并启用对应供应商，再查看模型列表。若使用网关接入 GPT-6.1 Sol，请选择支持 Responses API 的网关。 下方型号和价格表是配置示例，并非完整的最新目录或实时报价。选择新模型时以应用当前列表为准，实际费用以供应商最新计价规则为准。 diff --git a/docs/05-more/06-file-formats.md b/docs/05-more/06-file-formats.md index 49a61c9..b78c849 100644 --- a/docs/05-more/06-file-formats.md +++ b/docs/05-more/06-file-formats.md @@ -7,7 +7,7 @@ keywords: [文件格式, AgentFS, agent.json, instructions.md, SKILL.md, 记忆, # 文件格式说明 :::info 生效版本 -`v10.0.179+`（长期指令 `instructions.md`）。该能力已在开发分支实现，使用前请确认安装包包含该能力。 +`v10.0.179+`（长期指令 `instructions.md`）。 ::: AgentFS 把智能体的身份、行为、记忆、技能和运行策略保存为普通文件。你可以通过界面编辑，也可以在了解字段含义后直接修改文件。 diff --git a/docs/05-more/08-system-requirements-detail.md b/docs/05-more/08-system-requirements-detail.md index ff1eb30..f31962a 100644 --- a/docs/05-more/08-system-requirements-detail.md +++ b/docs/05-more/08-system-requirements-detail.md @@ -52,7 +52,7 @@ DesireCore 桌面版会随包提供完成核心工作所需的基础组件，通 | Python | 是 | 随包提供推荐版离线归档，首次启动后由 Hatch 静默导入到 DesireCore 管理目录 | | Node.js | 是 | 随包提供推荐版官方归档，首次启动后由 Volta 静默导入到 DesireCore 管理目录 | | macOS HostAgent | macOS 使用 | macOS 当前 GUI 操作载体；需要相应系统权限 | -| CUA Driver | 仅 Windows | Windows HostAgent 完成前的本机 GUI 自动化过渡载体，默认启用 | +| CUA Driver | 仅 Windows | Windows 本机 GUI 自动化，默认启用 | 当前内置清单为 Git 2.53.0、Python 3.13.9、Node.js 24.18.0 和 CUA Driver 0.7.1。确切补丁版本会随 DesireCore 发布更新，以 **资源管理器** → **算力** → **运行环境** 和安装包随附声明为准。 @@ -76,7 +76,7 @@ Python 与 Node.js 的导入在服务启动后异步进行，不阻塞 DesireCor Git 检测会展示版本、路径和实际来源。默认“自动”模式会分别验证系统 Git 与随包 Git，并使用版本较高者；版本相同时优先系统 Git。你也可以在运行环境页明确选择“系统”或“内置”，首选项不可用时系统会提示并回退到另一来源。 -macOS 当前通过 HostAgent 承载本机 GUI 操作，需要辅助功能、屏幕录制等相应系统权限。Windows 的 CUA Driver 则优先使用 `PATH` 中用户自行安装的可用版本，再回退到 DesireCore 内置版本；它是 Windows HostAgent 完成前的过渡实现，只服务于当前 Windows 电脑。Windows、Linux、其他桌面与移动端 HostAgent 仍在开发。详见 [GUI 桌面自动化](../02-user-guide/09-capabilities/05-computer-use.md)。 +macOS 当前通过 HostAgent 承载本机 GUI 操作，需要辅助功能、屏幕录制等相应系统权限。Windows 的 CUA Driver 则优先使用 `PATH` 中用户自行安装的可用版本，再回退到 DesireCore 内置版本；它只操作当前 Windows 电脑。Linux 和移动设备暂不支持 GUI 自动化。详见 [GUI 桌面自动化](../02-user-guide/09-capabilities/05-computer-use.md)。 缺少 Docker、Podman 或你任务指定的特殊版本时，相关脚本、MCP 服务或工作流仍可能不可用。 diff --git a/docs/05-more/09-open-source-repos.md b/docs/05-more/09-open-source-repos.md index 1e28005..9273f22 100644 --- a/docs/05-more/09-open-source-repos.md +++ b/docs/05-more/09-open-source-repos.md @@ -18,7 +18,7 @@ DesireCore 项目在 GitHub 上维护了多个官方仓库，欢迎关注和参 | `desirecore-hostagent` | 原生 HostAgent 平台代码，用于 GUI 操作、设备能力、发现、配对与常驻执行 | macOS 实现当前已作为 GUI 操作载体；Windows、Linux、其他桌面与移动端实现仍在开发。初步计划稳定后开源，根据公司融资情况和经营战略决定，不作为最终承诺 | :::info 不同平台的当前载体 -macOS 当前仍由 HostAgent 承载 GUI 操作。Windows 为了让用户在原生 HostAgent 完成前先使用本机 GUI 自动化，暂时采用 DesireCore 随附的独立第三方 CUA Driver；这不表示 HostAgent 已被弃用或替代。第三方组件不属于 DesireCore 官方仓库，详见 [第三方软件与许可](./10-third-party-software.md)。 +macOS 的 GUI 操作使用 DesireCore HostAgent；Windows 使用安装包内的独立第三方 CUA Driver。第三方组件的来源和许可证请查看 [第三方软件与许可](./10-third-party-software.md)。 ::: ## 文档与分发 diff --git a/docs/05-more/10-third-party-software.md b/docs/05-more/10-third-party-software.md index 38e4212..2c5cb36 100644 --- a/docs/05-more/10-third-party-software.md +++ b/docs/05-more/10-third-party-software.md @@ -14,14 +14,14 @@ DesireCore 为提供开箱即用的本地能力，会随安装包提供若干独 | 组件 | 在 DesireCore 中的用途 | 当前来源与许可概要 | |------|-----------------------|-------------------| -| CUA Driver | Windows HostAgent 完成前的本机 GUI 自动化过渡载体；作为独立 MCP 子进程运行 | [trycua/cua](https://github.com/trycua/cua)，上游仓库标注 MIT License | +| CUA Driver | Windows 本机 GUI 自动化；作为独立 MCP 子进程运行 | [trycua/cua](https://github.com/trycua/cua)，上游仓库标注 MIT License | | Git | AgentFS 版本记录、检查点及仓库操作；作为独立命令行子进程运行 | [Git](https://git-scm.com/about) 为 GPLv2；当前可移植构建来自 [dugite-native](https://github.com/desktop/dugite-native) | | Python | 由 Hatch 管理的推荐 Python 运行时，可从安装包内归档离线导入 | CPython 主要适用 [PSF License Version 2](https://docs.python.org/3/license.html)；归档来自 [python-build-standalone](https://github.com/astral-sh/python-build-standalone)，并含多项依赖许可 | | Node.js | 由 Volta 管理的推荐 Node.js 运行时，可从安装包内官方归档离线导入 | Node.js 主体使用 MIT License，官方归档同时包含多项 [第三方许可](https://github.com/nodejs/node/blob/main/LICENSE) | 当前发布清单对应 CUA Driver 0.7.1、Git 2.53.0、Python 3.13.9 和 Node.js 24.18.0。后续版本可能升级这些组件，请以当前安装包显示的版本和随附声明为准。 -CUA Driver 只描述当前 Windows 过渡路径。macOS 的 GUI 操作仍由 DesireCore HostAgent 承载；Windows、Linux、其他桌面与移动端 HostAgent 的后续实现不属于 CUA Driver 的许可或责任范围。 +CUA Driver 用于 Windows 本机 GUI 操作，macOS 使用 DesireCore HostAgent。这是不同的组件，各自适用的许可和责任范围应分别查看。 ## 为什么许可不能只看一个名称 diff --git a/docs/05-more/11-changelog/index.md b/docs/05-more/11-changelog/index.md index 30c51c4..0911f82 100644 --- a/docs/05-more/11-changelog/index.md +++ b/docs/05-more/11-changelog/index.md @@ -107,7 +107,7 @@ keywords: [更新日志, 版本历史, changelog] | [v10.0.86](./v10.0.86) | 2026-07-14 | 修复：了 Windows 上应用内升级时进度窗口无法显示、升级过程静默进行的问题，现在升级时会正常弹出进度提示窗口。 | | [v10.0.85](./v10.0.85) | 2026-07-14 | Windows 升级进度窗、公告弹窗登录入口，修复 3 项问题 | | [v10.0.84](./v10.0.84) | 2026-07-13 | 运行时加密包装，修复 1 项问题 | -| [v10.0.83](./v10.0.83) | 2026-07-11 | Claude 订阅技术适配（发布门控）、Windows GUI 自动化、思考深度控制、三层提示词体系、迁移到新设备、运行环境离线安装、算力预置更新通知、文件打开方式、套餐... | +| [v10.0.83](./v10.0.83) | 2026-07-11 | Claude 订阅接入（暂不可用）、Windows GUI 自动化、思考深度控制、三层提示词体系、迁移到新设备、运行环境离线安装、算力预置更新通知、文件打开方式、套餐... | | [v10.0.82](./v10.0.82) | 2026-06-29 | 市场页面视觉升级，修复 5 项问题，改进 1 项 | | [v10.0.81](./v10.0.81) | 2026-06-28 | 回撤（Rewind）、文生图/视频工具、任务板、历史版本查看、运营公告，修复 17 项问题，改进 5 项 | | [v10.0.80](./v10.0.80) | 2026-06-24 | 修复：stabilize local user identity (#889)、Update Docs Changelog 字体安装去 sudo + 整段... | diff --git a/docs/05-more/11-changelog/v10.0.83.md b/docs/05-more/11-changelog/v10.0.83.md index c98df24..5d68448 100644 --- a/docs/05-more/11-changelog/v10.0.83.md +++ b/docs/05-more/11-changelog/v10.0.83.md @@ -10,8 +10,8 @@ sidebar_position: 17 ![v10.0.83 更新概览](/img/changelog/v10.0.83.png) ## 新功能 -- **Claude 订阅技术适配**：新增通过官方 Claude Agent SDK 连接 Claude 会话的技术路径。使用官方 SDK 不等于获得第三方转发 Pro/Max 凭据的授权；按 Anthropic 当前规则，该入口在取得适用于 DesireCore 的明确授权前保持发布门控。 -- **Claude SDK 后端优化**：对话历史可以续接已缓存的 Claude 会话并传递图片。当前能力边界不启用 SDK 内置工具，搜索、文件、Shell 等操作仍由 DesireCore 工具和审批链负责。 +- **Claude 订阅接入（暂不可用）**：增加 Claude 会话接入支持。该入口须获得适用于 DesireCore 的 Anthropic 授权后才能使用；普通用户请使用 Anthropic API Key 或其支持的云平台认证。 +- **Claude 对话体验优化**：可以续接已有 Claude 对话并发送图片。搜索、文件和命令等操作仍使用 DesireCore 的工具，并遵循你的审批设置。 - **Windows GUI 自动化**：Windows 客户端内置 cua-driver，Agent 可直接操作原生应用界面（截图、点击、输入），零安装开箱即用。 - **三层提示词体系**：新增全局层（用户级）和团队层提示词，与 Agent 层叠加生效；提示词中心统一管理三层内容，支持结构化编辑与实时预览。 - **思考深度控制**：输入区新增思考深度选择按钮（自动/关闭/五档深度），支持会话级、Agent 级和全局默认三级优先级，适配 OpenAI、Anthropic 及国产模型方言。 diff --git a/docs/06-faq/01-installation.md b/docs/06-faq/01-installation.md index 354503d..81d95d2 100644 --- a/docs/06-faq/01-installation.md +++ b/docs/06-faq/01-installation.md @@ -37,7 +37,7 @@ DesireCore 的安装包托管在多个下载源上（CDN、构建服务器、Git ## Windows GUI 自动化还需要安装 HostAgent 吗？ -不需要。Windows 安装包已内置并默认启用 CUA Driver，当前电脑上的 GUI 自动化可直接使用。CUA Driver 是 Windows HostAgent 完成前的权宜/过渡实现，让 Windows 用户先具备相关能力；它不代表 HostAgent 被弃用。macOS 当前仍由 HostAgent 承载 GUI 操作，Windows、Linux、其他桌面与移动端 HostAgent 仍在开发。 +不需要。Windows 安装包已内置并默认启用 CUA Driver，可以直接操作当前电脑上的应用界面。若功能不可用，请在 **资源管理器 → 算力 → 运行环境** 中检查 CUA Driver 的状态。macOS 用户则需连接 HostAgent 并授予相应系统权限。 如果智能体找不到 GUI 工具，请打开 **资源管理器** → **算力** → **运行环境**，刷新并检查 CUA Driver： diff --git a/docs/06-faq/06-performance.md b/docs/06-faq/06-performance.md index 32748d0..2b42247 100644 --- a/docs/06-faq/06-performance.md +++ b/docs/06-faq/06-performance.md @@ -10,7 +10,7 @@ keywords: [性能, 内存占用, 响应速度, 优化, GPU, 卡顿, 磁盘, 风 DesireCore 桌面客户端基于 Electron 构建，会占用一定的基础内存（通常 200–400 MB）。如果内存占用异常偏高： -1. **检查版本** --- 确保你使用的是最新版本，开发团队会持续优化性能 +1. **检查版本** --- 在 **设置 → 关于** 中检查更新，升级后重新尝试 2. **检查智能体数量** --- 同时运行超过 300 个智能体会显著增加内存开销 3. **关闭不用的对话** --- 每个活跃对话都会占用渲染内存，关闭不需要的对话标签页 4. **重启应用** --- 长时间运行后内存可能逐渐增长，定期重启可以释放累积的内存 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 f9e86af..a95f2b0 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 @@ -37,7 +37,7 @@ macOS GUI automation currently runs through HostAgent. The first time you use th | Disk Space | 2 GB | 20 GB or more | :::info Local Windows GUI automation -The Windows installer bundles and enables CUA Driver by default, so local GUI automation does not require a separate HostAgent installation. This is a transitional implementation until Windows HostAgent is complete. macOS still uses HostAgent today, while HostAgent implementations for Windows, Linux, and other platforms remain under development. See [GUI Desktop Automation](../02-user-guide/09-capabilities/05-computer-use.md). +The Windows installer bundles and enables CUA Driver by default, so local GUI automation does not require a separate HostAgent installation. macOS GUI automation uses HostAgent and requires applicable system permissions. See [GUI Desktop Automation](../02-user-guide/09-capabilities/05-computer-use.md). ::: ### Linux 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 69415f4..3349781 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 @@ -55,7 +55,7 @@ After first startup, DesireCore imports the recommended Python and Node.js versi ### CUA Driver (GUI Automation) -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. +CUA Driver is enabled by default to operate application interfaces on the current Windows computer. Describe the task directly to your agent, for example: “Open Notepad and type the meeting summary.” :::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. 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 e05840e..753ead8 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 @@ -38,9 +38,9 @@ The entire installation typically takes just **1 minute** — download the DMG, ## GUI Automation and HostAgent -The macOS version currently uses **HostAgent** as the carrier for local GUI operations and related device capabilities. HostAgent is an active execution component and has not been replaced by the CUA Driver used on Windows. +macOS uses **HostAgent** to operate local application interfaces. Before using GUI automation, check that HostAgent is connected to DesireCore. -The first time you use interface inspection, clicking, typing, screenshots, or similar capabilities, macOS may request **Accessibility**, **Screen Recording**, or other permissions. Grant only what the task requires. If a capability does not recover immediately after a permission change, restart HostAgent or DesireCore and try again. Windows temporarily uses the bundled CUA Driver as a transitional way to provide GUI capability before Windows HostAgent is complete. +The first time you use interface inspection, clicking, typing, screenshots, or similar capabilities, macOS may request **Accessibility**, **Screen Recording**, or other permissions. Grant only what the task requires. If a capability does not recover immediately after a permission change, restart HostAgent or DesireCore and try again. ## Handling Gatekeeper Prompts diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/04-delegation/04-human-gate.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/04-delegation/04-human-gate.md index 5e1c347..9facfe7 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/04-delegation/04-human-gate.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/04-delegation/04-human-gate.md @@ -85,7 +85,7 @@ You: [Click ✓ Allow] Agent: "Okay, executing now..." ``` -For command approvals that support remembering, you can also choose **Always Allow**. The current implementation stores an exact rule for the complete command; it does not automatically broaden authority to every operation in the same directory or every invocation of the executable. +For command approvals that support remembering, you can also choose **Always Allow**. DesireCore remembers an exact rule for the complete command; it does not automatically broaden authority to every operation in the same directory or every invocation of the executable. ### Deny diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/03-create-agent.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/03-create-agent.md index 66666e6..926a9c6 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/03-create-agent.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/03-create-agent.md @@ -7,7 +7,7 @@ keywords: [Create Agent, Custom Agent, Conversation Creation, Template] # Create Custom Agent :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: When there is no Agent in the marketplace that meets your needs, you can create a fully custom Agent. DesireCore provides two creation methods. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/04-edit-persona.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/04-edit-persona.md index e911c31..0d47391 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/04-edit-persona.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/04-edit-persona.md @@ -7,7 +7,7 @@ keywords: [Persona, Role Positioning, Personality Traits, Agent Configuration] # Edit Persona :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: Persona defines "who" the Agent is—its tone, style, professional domain, and behavior. This is not a character description, but an **executable behavioral specification**. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/05-edit-principles.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/05-edit-principles.md index 92b5173..133a055 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/05-edit-principles.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/05-edit-principles.md @@ -7,7 +7,7 @@ keywords: [Principles, L0, L1, L2, Safety Rules, Priority] # Edit Principles :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: Principles are the Agent's "behavior manual"—they specify the rules the Agent must follow, the red lines it must not cross, and the priority order when making decisions. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/06-agent-files.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/06-agent-files.md index a53e389..3aa944a 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/06-agent-files.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/06-agent-files.md @@ -7,7 +7,7 @@ keywords: [AgentFS, File System, File Explorer, Agent Files, File Structure] # File Explorer :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: Each Agent's configuration, memory, and skills are stored as files in AgentFS (Agent File System). The file explorer lets you intuitively browse and manage these files. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/09-clone-and-sync.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/09-clone-and-sync.md index 2a510b9..979c4d6 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/09-clone-and-sync.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/09-clone-and-sync.md @@ -7,7 +7,7 @@ keywords: [Clone, agent clone, sync, conflicts, Agent Git] # Clone and Sync :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: Clone creates a new copy based on an existing agent. It is useful for experiments, preparing variants for different projects, or customizing a marketplace agent into your own version. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/12-prompt-center.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/12-prompt-center.md index aaa4452..e10c461 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/12-prompt-center.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/06-agents/12-prompt-center.md @@ -7,7 +7,7 @@ keywords: [Prompt Center, system prompt, global prompt, team prompt, Persona, Pr # Prompt Center and Content Ownership :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: Prompt Center brings prompt sources stored across user, team, and agent directories into one management surface. Open **Explorer → Prompt Center**, select a scope on the left, and edit or preview it on the right. @@ -89,7 +89,7 @@ A documentation engineer can keep each requirement in its own scope instead of p | Preview shows duplicate content | The same requirement is stored in multiple scopes. Keep it in the scope that owns it. | | A team prompt does not take effect | Confirm membership and check the corresponding source when the agent belongs to multiple teams. | | Layered source reports a format issue | Check for exact `## L0`, `## L1`, and `## L2` headings; standing instructions need none. | -| Standing Instructions is unavailable | Update to `v10.0.179+` and confirm that the installed package includes standing instructions. | +| Standing Instructions is unavailable | Check your version under **Settings → About**, update to `v10.0.179+`, and try again. | | Standing instructions exceed the budget | Shorten the body and move detailed steps into skills. Execution does not proceed by truncating it or hiding an L2 section. | :::caution Prompts Are Not Permissions diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/05-computer-use.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/05-computer-use.md index 65f47dc..655e93f 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/05-computer-use.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/05-computer-use.md @@ -1,6 +1,6 @@ --- title: GUI Desktop Automation -description: Learn how DesireCore uses HostAgent on macOS and the bundled CUA Driver as a temporary Windows carrier for local GUI automation. +description: Learn how DesireCore uses HostAgent on macOS and the bundled CUA Driver on Windows for local GUI automation. keywords: [Computer Use, CUA Driver, GUI, Windows, macOS, desktop automation, HostAgent] --- @@ -8,42 +8,32 @@ keywords: [Computer Use, CUA Driver, GUI, Windows, macOS, desktop automation, Ho ## Current Availability -DesireCore can currently operate native application interfaces on **local macOS and Windows computers**. It can inspect windows and accessibility elements, click controls, type text, send keys, and capture interface state. The execution carrier differs by platform: +DesireCore can currently operate native application interfaces on **local macOS and Windows computers**. It can inspect windows and accessibility elements, click controls, type text, send keys, and capture interface state. The setup requirements differ by platform: -- **macOS**: HostAgent is the current GUI-operation carrier and uses native macOS system capabilities. -- **Windows**: Until the Windows HostAgent is ready, DesireCore temporarily uses the bundled CUA Driver so Windows users can access local GUI automation now. +- **macOS**: Connect HostAgent and grant the permissions your task requires, such as Accessibility and Screen Recording. +- **Windows**: The bundled CUA Driver operates local application interfaces; no separate HostAgent installation is required. The Windows installer bundles and enables [CUA Driver](https://github.com/trycua/cua) by default. Under normal circumstances, Windows users do not need to install a separate driver or HostAgent. -:::info Why is HostAgent not required for local Windows automation? -CUA Driver has not replaced HostAgent: macOS GUI operations still run through HostAgent today. DesireCore uses the CUA Driver MCP subprocess on Windows only because the Windows HostAgent remains under development. The Windows carrier and capability boundary may change after that HostAgent is completed. -::: - | Scenario | Current status | Component | |----------|----------------|-----------| | Local macOS GUI automation | Supported | macOS HostAgent; applicable system permissions are required | -| Local Windows GUI automation | Supported as a transitional implementation | Bundled CUA Driver; no separate installation | -| Windows and Linux HostAgent | In development | Future native HostAgent implementations | -| HostAgent for other desktop systems, Android, iOS, and HarmonyOS | In development | Future platform implementations | +| Local Windows GUI automation | Supported | Bundled CUA Driver; no separate installation | +| GUI automation on Linux, other desktop systems, Android, iOS, and HarmonyOS | Not yet available | — | ## How It Works -The entry point is the same on both supported platforms, but the execution path differs. - ### macOS: HostAgent path -1. Describe a GUI task in DesireCore. -2. The Agent plans the steps and invokes macOS HostAgent through the device-capability path. -3. HostAgent uses native macOS frameworks and the granted Accessibility, Screen Recording, or other applicable permissions. -4. HostAgent returns interface or execution results so the Agent can continue and verify the state. +1. Describe the task in DesireCore. +2. With HostAgent connected and the required permissions granted, the agent reads the interface and performs the requested clicks, typing, or screenshots. +3. The agent checks the interface after each step and reports the result or asks for confirmation when needed. -### Windows: transitional CUA Driver path +### Windows: CUA Driver path -1. You describe a task in DesireCore, such as “Open Notepad and enter the meeting summary.” -2. The agent plans the steps and selects tools exposed by CUA Driver through the system MCP configuration. -3. DesireCore starts an independent `cua-driver` subprocess and communicates with it over standard input and output. -4. CUA Driver uses Windows UI Automation, window, and input capabilities, then returns window, element, or screenshot results. -5. The agent continues based on those results and verifies the final state. +1. Describe the task, for example: “Open Notepad and type the meeting summary.” +2. The agent uses the available desktop tools to read windows, click controls, type text, and take screenshots. +3. It checks the interface after each step and confirms the final result. If a separately installed `cua-driver` is already on your `PATH`, DesireCore prefers it. Otherwise, it falls back to the bundled version. If neither is available, the capability is skipped without repeatedly producing connection errors. @@ -102,7 +92,7 @@ Recommended practices: - Test business-critical workflows with a test account or copied data first. :::warning Third-party component -The CUA Driver currently used on Windows is an independent third-party program supplied under its own license. It is not a DesireCore-owned component or HostAgent and serves as the transitional Windows carrier until Windows HostAgent is ready. Its version, compatibility, and upstream support may change. See the notices supplied with the software and [Third-Party Software and Licenses](../../05-more/10-third-party-software.md). +The CUA Driver currently used on Windows is an independent third-party program supplied under its own license. It is not a DesireCore-owned component or HostAgent. Its version, compatibility, and upstream support may change. See the notices supplied with the software and [Third-Party Software and Licenses](../../05-more/10-third-party-software.md). ::: ## Next Steps diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/06-integrations-overview.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/06-integrations-overview.md index c5fe4dd..86a6064 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/06-integrations-overview.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/06-integrations-overview.md @@ -40,11 +40,11 @@ MCP services can connect S3-compatible and other object-storage systems for uplo ## Desktop and Mobile Devices -When no suitable API or tool exists, Computer Use can operate a graphical interface. **macOS GUI operations currently run through HostAgent**. **Windows temporarily uses the bundled, default-enabled CUA Driver** so users have local capability before the native Windows HostAgent is complete. HostAgent implementations for Windows, Linux, other desktop systems, and mobile platforms remain under development. +When no suitable API or tool exists, Computer Use can operate local graphical interfaces on **macOS and Windows**. On macOS, connect HostAgent and grant the required system permissions. On Windows, CUA Driver is bundled and enabled by default. - **Local macOS applications**: operated by HostAgent through native macOS capabilities and applicable system permissions -- **Local Windows applications**: temporarily operated by CUA Driver through accessibility elements, mouse, and keyboard -- **Linux, other desktops, and mobile devices**: part of the future HostAgent roadmap and should not be treated as currently available +- **Local Windows applications**: operated by the bundled CUA Driver through accessibility elements, mouse, and keyboard +- **Linux, other desktops, and mobile devices**: GUI automation is not yet available - **Screen awareness**: screenshots and accessible UI text may enter model context and can contain sensitive data Computer Use is not reliable for every interface. Custom-drawn controls, the UAC secure desktop, locked screens, elevated applications, and protected content may be unavailable. External effects such as sending, payment, deletion, or publication should remain user-confirmed. See [GUI Desktop Automation](./computer-use). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/04-compute-service.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/04-compute-service.md index 651bf01..543aab8 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/04-compute-service.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/10-settings/04-compute-service.md @@ -74,31 +74,25 @@ Some providers distinguish pay-as-you-go API keys and Token Plan keys. The UI wa ## Claude Pro / Max Subscription :::info Effective version -`v10.0.178+` (Claude subscription integration implementation). Access remains subject to the authorization conditions and release policy described below. +`v10.0.178+` (Claude subscription integration). Read the authorization conditions below before use. ::: -Compute Service may show a **Claude Subscription** provider. This route sends model requests through Anthropic's official `@anthropic-ai/claude-agent-sdk`; it does not imitate Claude Code by forging request headers. +If Compute Service shows a **Claude Subscription** provider, follow the on-screen steps to connect your account. Use of this entry must comply with Anthropic's subscription and authorization rules; see the conditions below. -### Runtime model and how it differs from Claude Code +### How this differs from Claude Code -At the execution boundary, this is a dual-runtime collaboration: +Selecting a Claude subscription model keeps your conversation in DesireCore. The agent continues to use DesireCore's memory, skills, tools, approval settings, and audit records. It does not enable Claude Code's tools, plugins, or slash commands. -1. The **DesireCore Agent runtime** owns system prompts, memory, skills, tool registration, approvals, delegation, and execution audit. -2. The **Claude Agent SDK runtime** uses the Claude subscription identity for model requests and returns text or `tool_use`. -3. Every `tool_use` is handed back to DesireCore and executed through DesireCore's tools and approval pipeline. - -The SDK's bundled tools, skills, plugins, subagents, slash commands, and connectors are not enabled on this route, and the SDK does not execute file, command, or external-service actions for DesireCore. The context, tools, permission boundary, and resulting behavior therefore differ fundamentally from using Claude Code directly. - -If you need the full Claude Code programming workflow inside DesireCore, have a **DesireCore Agent invoke the locally installed Claude Code**. Selecting a Claude subscription model does not place the conversation inside Claude Code. +If you need the full Claude Code programming workflow, ask a **DesireCore Agent to invoke the locally installed Claude Code**. ### Connecting -The UI first detects a local Claude Code login. Depending on platform, authorization conditions, and release policy, advanced options may also offer in-app login or a `claude setup-token` paste. When a credential expires, refresh fails, or the connection is removed, use the re-detect or sign-in action shown in the panel. +The UI first detects a local Claude Code login. If the panel offers sign-in or a `claude setup-token` field, follow the instructions shown there. When a credential expires, refresh fails, or the connection is removed, use the re-detect or sign-in action shown in the panel. ### Terms, authorization, and account risk :::warning Eligibility is governed by Anthropic's rules -Use of the official SDK shows that DesireCore implements this route through an official technical interface. It **does not authorize a third-party product to relay Claude Free, Pro, or Max credentials**. As of this update, Anthropic's [Claude Code legal and compliance guidance](https://code.claude.com/docs/en/legal-and-compliance) directs developers building third-party products to use API-key authentication or a supported cloud provider and says they may not offer Claude.ai login or relay Free, Pro, or Max credentials on users' behalf. The subscription entry should therefore remain release-gated until DesireCore has explicit authorization for this use case. Later availability depends on official authorization, then-current terms, region, account, and DesireCore release policy. +**Claude subscription use must comply with Anthropic's authorization requirements**. As of this update, Anthropic's [Claude Code legal and compliance guidance](https://code.claude.com/docs/en/legal-and-compliance) directs developers building third-party products to use API-key authentication or a supported cloud provider and says they may not offer Claude.ai login or relay Free, Pro, or Max credentials on users' behalf. Claude subscription access requires applicable authorization and compliance with the terms, region, and account conditions. If this entry is unavailable, use an Anthropic API key or an explicitly supported cloud authentication method. ::: You are responsible for confirming that your subscription use, account type, region, and automation comply with Anthropic's current terms. Rate limits, feature restrictions, credential invalidation, account suspension, or bans arising from subscription use or provider policy are risks borne by the user; DesireCore cannot control Anthropic's account decisions. For stable commercial or organizational access, prefer an Anthropic API key or an explicitly supported cloud authentication method. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/11-security/05-ai-approval.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/11-security/05-ai-approval.md index 50abf2b..aff6f61 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/11-security/05-ai-approval.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/11-security/05-ai-approval.md @@ -9,7 +9,7 @@ keywords: [AI approval, tool approval, unattended, delegation, permissions] Each Agent has independent approval preferences. Approval decides whether an operation may proceed; the executor must still satisfy tool access, file scope, deny rules, and dedicated authorization gates. :::info Effective version -`v10.0.178+` (unattended delegation reads the immediate parent's approval settings). Implemented on the development branch; availability depends on the installed package. Earlier clients may still read the executor's settings. +`v10.0.178+` (unattended delegation reads the immediate parent's approval settings). Earlier clients may still read the executor's settings. ::: ## Whose settings apply? diff --git a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/03-agentfs.md b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/03-agentfs.md index 35e75d5..8588438 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/03-agentfs.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/03-agentfs.md @@ -7,7 +7,7 @@ keywords: [AgentFS, filesystem, data storage, Git, agent repository] # AgentFS Filesystem :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: ## AgentFS is Like Each Agent's "Home" diff --git a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/06-self-evolution.md b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/06-self-evolution.md index 10e86f0..46bfa0e 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/06-self-evolution.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/06-self-evolution.md @@ -7,7 +7,7 @@ keywords: [self-evolution, Self-Evolution, learning, memory, experience accumula # Self-Evolution :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: ## Agents Are Not Static diff --git a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/12-agent-permission-boundary.md b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/12-agent-permission-boundary.md index 543221f..839e17a 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/12-agent-permission-boundary.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/12-agent-permission-boundary.md @@ -86,7 +86,7 @@ When the calendar assistant asks the writing companion to "turn today's meeting ## Approval settings and execution permissions are separate -Unattended delegation reads the immediate parent's approval mode and remembered rules. It does not inherit the parent's execution identity or expand permissions. Attended runs retain their original approval source; `SendMessage` does not convey approval settings. See [Tool and Command Approval Modes](../02-user-guide/11-security/05-ai-approval.md) for the source and seven-mode tables. This development change does not mean a client installer has been released. +Unattended delegation reads the immediate parent's approval mode and remembered rules. It does not inherit the parent's execution identity or expand permissions. Attended runs retain their original approval source; `SendMessage` does not convey approval settings. See [Tool and Command Approval Modes](../02-user-guide/11-security/05-ai-approval.md) for the source and seven-mode tables. ## Next steps diff --git a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/13-business-ontology.md b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/13-business-ontology.md index b704fd9..d5addae 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/13-business-ontology.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/04-concepts/13-business-ontology.md @@ -81,8 +81,8 @@ DesireCore does not require ontology assets to be placed in another opaque syste | Hook / Policy / Human Gate | Constrain high-risk action and system write-back | Policy decisions, approvals, denial, temporary grants | | [Receipt System](./receipt-system) | Record which information, rules, and actions were used | Inputs, outputs, tool calls, evidence, exceptions | -:::warning Do not document a method as a product capability that does not exist -When a project uses files, memory, Skills, and Workflows to organize business context, describe that composition accurately. A dedicated ontology platform should only be claimed after the corresponding data model, editor, query surface, or runtime has actually been implemented. +:::info Confirm the capabilities your project needs +Files, memory, Skills, and Workflows can organize business context and connect information, rules, and execution steps. If your project needs a dedicated data model, editor, or query interface, specify those requirements in the project plan and check that your chosen tools provide them. ::: ## FDE-style delivery: start with a minimum viable ontology diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/03-glossary.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/03-glossary.md index 1a3253d..fa2ec33 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/03-glossary.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/03-glossary.md @@ -100,7 +100,7 @@ One of three step types. Steps requiring user personal confirmation. Execution a ### Instructions (Standing Instructions) :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: Optional `instructions.md` at the agent root stores agent-specific stable responsibilities, default work strategies, and delivery standards. It uses ordinary Markdown and loads in full when allowed, without L0/L1/L2 parsing, summarization, or truncation. It grants no permissions. See [File Format Reference](./06-file-formats.md). diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/04-supported-providers.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/04-supported-providers.md index 45b1b88..8e2310f 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/04-supported-providers.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/04-supported-providers.md @@ -6,9 +6,9 @@ keywords: [providers, Provider, AI models, API, OpenAI, Claude, DeepSeek] # Supported AI Providers -DesireCore's provider and model catalog is updated through config-center. Availability depends on the client, account permissions, and synchronized configuration. Supported services include chat, reasoning, tool use, vision, embeddings, voice, image generation, video generation, and other types. +DesireCore updates its provider and model catalog automatically. Available models depend on your client version, provider connection, and account permissions. Supported services include chat, reasoning, tool use, vision, embeddings, voice, image generation, video generation, and other types. -The source-bundled config-center version 123 (2026-10-01) includes GPT-6.1 Sol, Claude Sonnet 5.5, and Claude Opus 5.5. GPT-6.1 Sol uses Responses API for tool calling; verify that your gateway supports it. Whether a model appears also depends on configuration sync, enabled providers, credentials, and account permissions. +To find models such as GPT-6.1 Sol, Claude Sonnet 5.5, or Claude Opus 5.5, open **Settings → Compute Service**, connect and enable the relevant provider, then check its model list. For GPT-6.1 Sol through a gateway, choose a gateway that supports Responses API. The model and price tables below are configuration examples, not a complete current catalog or live quotes. Select models from the application's current list and consult the provider's current pricing for actual charges. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/06-file-formats.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/06-file-formats.md index 4870c76..2be323d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/06-file-formats.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/06-file-formats.md @@ -7,7 +7,7 @@ keywords: [file format, AgentFS, agent.json, instructions.md, SKILL.md, memory, # File Format Reference :::info Effective version -`v10.0.179+` (standing instructions in `instructions.md`). Implemented on the development branch; confirm that your installed package includes this capability before use. +`v10.0.179+` (standing instructions in `instructions.md`). ::: AgentFS stores agent identity, behavior, memory, skills, and runtime policy as ordinary files. You can edit them through the UI or directly when you understand the fields. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/08-system-requirements-detail.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/08-system-requirements-detail.md index 91e2bdb..a2301bb 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/08-system-requirements-detail.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/08-system-requirements-detail.md @@ -52,7 +52,7 @@ The DesireCore desktop package includes the baseline components needed for core | Python | Yes | A recommended offline archive is bundled and silently imported into a Hatch-managed directory after first startup | | Node.js | Yes | A recommended official archive is bundled and silently imported into a Volta-managed directory after first startup | | macOS HostAgent | Used on macOS | Current carrier for macOS GUI operations; applicable system permissions are required | -| CUA Driver | Windows only | Transitional local GUI carrier until Windows HostAgent is complete; enabled by default | +| CUA Driver | Windows only | Local Windows GUI automation; enabled by default | The current bundled manifest identifies Git 2.53.0, Python 3.13.9, Node.js 24.18.0, and CUA Driver 0.7.1. Exact patch versions can change with a DesireCore release. Check **Explorer** → **Compute** → **Runtime Environment** and the notices supplied with your installer. @@ -74,7 +74,7 @@ Open **Explorer** -> **Compute** -> **Runtime Environment** to inspect local too Git detection shows the version, path, and actual source. In the default Auto mode, DesireCore validates both system and bundled Git and uses the newer version; if their versions match, it prefers system Git. You can explicitly choose System or Bundled on the Runtime Environment page. If that source is unavailable, DesireCore reports the fallback and uses the other source. -macOS currently uses HostAgent for local GUI operations and requires applicable permissions such as Accessibility and Screen Recording. On Windows, CUA Driver prefers a usable user-installed version on `PATH`, then falls back to the bundled version. It is a transitional implementation until Windows HostAgent is complete and controls only the current Windows computer. HostAgent implementations for Windows, Linux, other desktops, and mobile platforms remain under development. See [GUI Desktop Automation](../02-user-guide/09-capabilities/05-computer-use.md). +macOS currently uses HostAgent for local GUI operations and requires applicable permissions such as Accessibility and Screen Recording. On Windows, CUA Driver prefers a usable user-installed version on `PATH`, then falls back to the bundled version. It controls only the current Windows computer. GUI automation is not yet available on Linux or mobile devices. See [GUI Desktop Automation](../02-user-guide/09-capabilities/05-computer-use.md). Docker, Podman, and task-specific runtime versions may still need to be installed separately. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/09-open-source-repos.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/09-open-source-repos.md index 29fb04f..bbe604c 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/09-open-source-repos.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/09-open-source-repos.md @@ -18,7 +18,7 @@ The DesireCore project maintains several official repositories on GitHub. Feel f | `desirecore-hostagent` | Native HostAgent platform code for GUI operations, device capabilities, discovery, pairing, and persistent execution | The macOS implementation is currently the GUI-operation carrier. Windows, Linux, other desktop, and mobile implementations remain under development. Tentatively planned to open source after stabilization, subject to company funding and business strategy, and not a final commitment | :::info Current platform carriers -macOS GUI operations still run through HostAgent. To give Windows users local GUI automation before the native HostAgent is complete, Windows temporarily uses the independent third-party CUA Driver bundled with DesireCore. This does not mean HostAgent has been deprecated or replaced. Third-party components are not DesireCore official repositories; see [Third-Party Software and Licenses](./10-third-party-software.md). +macOS GUI operations use DesireCore HostAgent; Windows uses the independent third-party CUA Driver included in the installer. See [Third-Party Software and Licenses](./10-third-party-software.md) for component sources and licenses. ::: ## Documentation & Distribution diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/10-third-party-software.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/10-third-party-software.md index 6372729..5158efb 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/10-third-party-software.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/10-third-party-software.md @@ -14,14 +14,14 @@ This page is a user-facing summary. It does not replace the complete license tex | Component | Use in DesireCore | Current source and license summary | |-----------|-------------------|------------------------------------| -| CUA Driver | Transitional local Windows GUI carrier until Windows HostAgent is complete, run as an independent MCP subprocess | [trycua/cua](https://github.com/trycua/cua); the upstream repository identifies the project as MIT-licensed | +| CUA Driver | Local Windows GUI automation, run as an independent MCP subprocess | [trycua/cua](https://github.com/trycua/cua); the upstream repository identifies the project as MIT-licensed | | Git | AgentFS history, checkpoints, and repository operations, run as an independent command-line subprocess | [Git](https://git-scm.com/about) is GPLv2; the current portable build comes from [dugite-native](https://github.com/desktop/dugite-native) | | Python | Recommended Hatch-managed Python runtime that can be imported offline from an archive in the installer | CPython is primarily under the [PSF License Version 2](https://docs.python.org/3/license.html); the archive comes from [python-build-standalone](https://github.com/astral-sh/python-build-standalone) and contains dependencies under additional licenses | | Node.js | Recommended Volta-managed Node.js runtime that can be imported offline from an official archive in the installer | The Node.js core is MIT-licensed; the official archive also includes software under multiple [third-party licenses](https://github.com/nodejs/node/blob/main/LICENSE) | The current release manifest identifies CUA Driver 0.7.1, Git 2.53.0, Python 3.13.9, and Node.js 24.18.0. Future releases may upgrade these components. Refer to the versions and notices supplied with the installed release. -CUA Driver describes only the current transitional Windows path. macOS GUI operations still run through DesireCore HostAgent. Future HostAgent implementations for Windows, Linux, other desktop systems, and mobile platforms are outside CUA Driver's license and responsibility boundary. +CUA Driver provides local Windows GUI operations; macOS uses DesireCore HostAgent. These are separate components with separate license and responsibility boundaries. ## Why One License Name Is Not Enough diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/index.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/index.md index 7d31a58..5986c89 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/index.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/index.md @@ -107,7 +107,7 @@ This page records important changes in each version of DesireCore. | [v10.0.86](./v10.0.86) | 2026-07-14 | 修复：Fixed an issue on Windows where the progress window would not appear durin... | | [v10.0.85](./v10.0.85) | 2026-07-14 | Windows Upgrade Progress Window、Announcement Pop-up Login Entry，修复 3 项问题 | | [v10.0.84](./v10.0.84) | 2026-07-13 | Runtime Encrypted Packaging，修复 1 项问题 | -| [v10.0.83](./v10.0.83) | 2026-07-11 | Claude subscription technical adapter (release-gated)、Windows GUI automation、Thinking depth control... | +| [v10.0.83](./v10.0.83) | 2026-07-11 | Claude subscription integration (not yet available)、Windows GUI automation、Thinking depth control... | | [v10.0.82](./v10.0.82) | 2026-06-29 | Marketplace page visual upgrade: The marketplace list and detail pages have b... | | [v10.0.81](./v10.0.81) | 2026-06-28 | Rewind、Text-to-Image/Video Tools、Task Board、History Version Viewer、Operationa... | | [v10.0.80](./v10.0.80) | 2026-06-24 | 修复：stabilize local user identity (#889)、Update Docs Changelog 字体安装去 sudo + 整段... | diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/v10.0.83.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/v10.0.83.md index e75095f..378c1db 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/v10.0.83.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/11-changelog/v10.0.83.md @@ -10,8 +10,8 @@ sidebar_position: 17 ![v10.0.83 更新概览](/img/changelog/v10.0.83-en.png) ## New Features -- **Claude Subscription Technical Adapter**: Added a technical path for Claude sessions through the official Claude Agent SDK. Use of the official SDK does not authorize third-party relay of Pro/Max credentials; under Anthropic's current rules, the entry remains release-gated until DesireCore has explicit authorization for this use case. -- **Claude SDK Backend Optimization**: Conversation history can resume a cached Claude session and pass images. The current boundary does not enable SDK-built-in tools; search, files, shell, and other operations remain under DesireCore tools and approvals. +- **Claude Subscription Integration (Not Yet Available)**: Added support for connecting Claude sessions. This entry requires applicable Anthropic authorization for DesireCore before use; users should use an Anthropic API key or a supported cloud authentication method. +- **Claude Conversation Improvements**: Resume an existing Claude conversation and send images. Search, file, and command operations continue to use DesireCore tools and follow your approval settings. - **Windows GUI Automation**: The Windows client includes a built-in cua-driver. Agents can directly operate native application interfaces (screenshot, click, input) with zero installation and out‑of‑the‑box use. - **Three‑tier Prompt System**: A new global tier (user‑level) and team‑tier prompts are added, applied together with the Agent tier. The Prompt Center manages all three tiers with structured editing and live preview. - **Thinking Depth Control**: A thinking depth selector (Auto/Off/five depth levels) has been added to the input area. Supports three‑level priority: session, Agent, and global default, and works with OpenAI, Anthropic, and domestic model dialects. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/06-faq/01-installation.md b/i18n/en/docusaurus-plugin-content-docs/current/06-faq/01-installation.md index 2ab61b0..c46cedf 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/06-faq/01-installation.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/06-faq/01-installation.md @@ -37,7 +37,7 @@ You can still install or use system versions. Git compares system and bundled so ## Does Windows GUI automation require HostAgent? -No. The Windows installer bundles and enables CUA Driver by default, so GUI automation on the current computer can be used directly. CUA Driver is a pragmatic transitional implementation that gives Windows users this capability before Windows HostAgent is complete; it does not mean HostAgent has been deprecated. macOS GUI operations still run through HostAgent, while HostAgent implementations for Windows, Linux, other desktops, and mobile platforms remain under development. +No. The Windows installer bundles and enables CUA Driver by default, so you can directly operate application interfaces on the current computer. If it is unavailable, check CUA Driver under **Explorer → Compute → Runtime Environment**. On macOS, connect HostAgent and grant the required system permissions. If an agent cannot find the GUI tools, open **Explorer** → **Compute** → **Runtime Environment**, refresh, and check CUA Driver: diff --git a/i18n/en/docusaurus-plugin-content-docs/current/06-faq/06-performance.md b/i18n/en/docusaurus-plugin-content-docs/current/06-faq/06-performance.md index 8471522..5605f2d 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/06-faq/06-performance.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/06-faq/06-performance.md @@ -10,7 +10,7 @@ keywords: [performance, memory usage, response speed, optimization, GPU, lag, di The DesireCore desktop client is built on Electron and uses a baseline amount of memory (typically 200–400 MB). If memory usage is abnormally high: -1. **Check your version** --- Ensure you're running the latest version; the development team continuously optimizes performance +1. **Check your version** --- Check for updates under **Settings → About**, update the app, and try again 2. **Check Agent count** --- Running more than 300 Agents simultaneously significantly increases memory overhead 3. **Close unused conversations** --- Each active conversation occupies rendering memory; close tabs you don't need 4. **Restart the app** --- Memory may gradually grow over long sessions; periodic restarts release accumulated memory