From e449f84a91ec18c5a0442a2097237e7c0579a296 Mon Sep 17 00:00:00 2001
From: yi-ge <a@wyr.me>
Date: Tue, 7 Jul 2026 19:58:02 +0800
Subject: [PATCH] docs: update tool capability docs

---
 .../09-capabilities/01-tool-system.md         |  16 +-
 .../09-capabilities/02-builtin-tools.md       |  87 +++-
 .../06-integrations-overview.md               |   3 +
 .../09-capabilities/07-web-access.md          |  60 +++
 .../09-capabilities/08-media-generation.md    |  59 +++
 .../09-capabilities/09-app-service-catalog.md |  56 +++
 docs/05-more/05-builtin-tools-reference.md    | 458 ++++--------------
 .../09-capabilities/07-web-access.md          |  30 ++
 .../09-capabilities/08-media-generation.md    |  28 ++
 .../09-capabilities/09-app-service-catalog.md |  25 +
 .../05-more/05-builtin-tools-reference.md     | 454 ++++-------------
 11 files changed, 560 insertions(+), 716 deletions(-)
 create mode 100644 docs/02-user-guide/09-capabilities/07-web-access.md
 create mode 100644 docs/02-user-guide/09-capabilities/08-media-generation.md
 create mode 100644 docs/02-user-guide/09-capabilities/09-app-service-catalog.md
 create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/07-web-access.md
 create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/08-media-generation.md
 create mode 100644 i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/09-app-service-catalog.md

diff --git a/docs/02-user-guide/09-capabilities/01-tool-system.md b/docs/02-user-guide/09-capabilities/01-tool-system.md
index 8a10a22..4c6890c 100644
--- a/docs/02-user-guide/09-capabilities/01-tool-system.md
+++ b/docs/02-user-guide/09-capabilities/01-tool-system.md
@@ -33,10 +33,24 @@ DesireCore 的工具系统分为三层，由内到外，能力逐步扩展：
 
 ### 第一层：内置工具
 
-DesireCore 自带的基础能力，开箱即用，无需额外配置。包括文件读写、目录浏览、内容搜索、命令执行、网页获取、用户提问、智能体协作、工作流和调度等核心功能。
+DesireCore 自带的基础能力，开箱即用，无需额外配置。包括文件读写、目录浏览、内容搜索、命令执行、网页获取、PDF 读取、用户提问、智能体协作、工作流、调度、文档导出、媒体生成和任务管理等核心功能。
 
 工具是否进入智能体上下文取决于当前平台、权限和运行环境。例如 PowerShell 只在 Windows 环境注册；当某个工具不可用时，对应能力声明也不会注入给智能体。
 
+### Skill-scoped 工具
+
+有些工具只在对应技能启用后才会暴露给智能体。这类工具称为 Skill-scoped tools。
+
+例如 Web Access v2 启用后，智能体才会看到浏览器控制、CDP 代理、站点经验和本地书签相关工具。这样可以避免普通任务误用重型或高权限工具，也能让能力说明和实际可用工具保持一致。
+
+常见模式：
+
+| 技能 | 激活后可用的能力 |
+|------|------------------|
+| Web Access | Browser 工具族、CDP、SitePattern、LocalBookmarks |
+| Media Generation | GenerateImage、GenerateVideo、BeautifyImage |
+| Office / Documents | 文档渲染、表格/演示文稿处理、PDF 导出 |
+
 ### 第二层：MCP 工具
 
 通过 MCP（Model Context Protocol）协议连接外部服务。MCP 是一个开放标准，让智能体可以安全地访问 GitHub、文件系统、数据库、Slack 等第三方服务。
diff --git a/docs/02-user-guide/09-capabilities/02-builtin-tools.md b/docs/02-user-guide/09-capabilities/02-builtin-tools.md
index 5f4b44c..8548f04 100644
--- a/docs/02-user-guide/09-capabilities/02-builtin-tools.md
+++ b/docs/02-user-guide/09-capabilities/02-builtin-tools.md
@@ -6,7 +6,7 @@ keywords: [内置工具, 工具列表, 文件操作, 搜索, 命令执行, 网
 
 # 内置工具一览
 
-内置工具是 DesireCore 自带的基础能力，随客户端一起安装。智能体会根据当前操作系统、已启用的权限、可用工具和任务上下文自动选择工具；不可用的工具不会进入智能体的能力声明。
+内置工具是 DesireCore 自带的基础能力，随客户端一起安装，无需额外配置即可使用。工具会随客户端版本更新，因此本文按能力域说明常用工具，而不是固定成某个数量。智能体会根据当前操作系统、已启用的权限、可用工具和任务上下文自动选择工具；不可用的工具不会进入智能体的能力声明。
 
 ## 文件操作类
 
@@ -18,7 +18,9 @@ keywords: [内置工具, 工具列表, 文件操作, 搜索, 命令执行, 网
 |------|-----|
 | 风险等级 | 低 |
 | 需要确认 | 否 |
-| 典型场景 | 查看代码、阅读文档、检查配置、预览图片 |
+| 典型场景 | 查看代码、阅读文档、检查配置、预览图片、读取长 PDF 或扫描 PDF |
+
+读取指定路径的文件内容。支持文本文件的行号显示和分页读取，能自动检测图片文件并以视觉方式呈现。PDF 会根据文件大小和内容类型选择读取策略：小文件直接读取，大文件分段读取；扫描页或图表页可按页渲染为图片交给视觉模型。
 
 ### Write — 写入文件
 
@@ -174,6 +176,17 @@ keywords: [内置工具, 工具列表, 文件操作, 搜索, 命令执行, 网
 | 需要确认 | 取决于请求内容 |
 | 典型场景 | 调用 API、检查服务状态、获取结构化数据 |
 
+### Web Access 工具族 — 浏览器访问
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 - 中 |
+| 需要确认 | 视操作而定 |
+
+Web Access 技能启用后，智能体可以使用浏览器标签页访问动态网页、登录态页面和需要 JavaScript 的站点。工具族包含导航、点击、滚动、截图、执行受控脚本、文件上传和关闭标签页等能力。
+
+**典型场景**：阅读需要登录的网页、操作动态表单、采集 SPA 页面、复用站点经验。详见 [Web Access](./web-access)。
+
 ## 智能体协作类
 
 ### Delegate — 委派任务
@@ -256,7 +269,27 @@ keywords: [内置工具, 工具列表, 文件操作, 搜索, 命令执行, 网
 | 需要确认 | 取决于操作内容 |
 | 典型场景 | 组建专业团队、调整团队成员、分配团队任务 |
 
-## 工作空间与数据类
+## 任务与上下文类
+
+### CompactSession — 压缩会话
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 |
+| 需要确认 | 否 |
+
+整理当前长对话，把较早消息压缩成摘要，帮助模型继续处理长任务。详见 [上下文控制](../conversations/context-control)。
+
+### TaskCreate / TaskList / TaskGet / TaskUpdate — 任务板
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 |
+| 需要确认 | 否 |
+
+让智能体维护一次对话内的任务板，记录子任务、状态、优先级、依赖和进度。详见 [执行监控](../04-delegation/03-execution-monitoring.md)。
+
+## 工作空间管理类
 
 ### ManageWorkDirs — 管理工作目录
 
@@ -393,3 +426,51 @@ keywords: [内置工具, 工具列表, 文件操作, 搜索, 命令执行, 网
 | 风险等级 | 低 |
 | 需要确认 | 否 |
 | 典型场景 | 查看流程结构、审查节点配置 |
+
+### HeartbeatRespond — 心跳响应
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 |
+| 需要确认 | 否 |
+| 典型场景 | 提交心跳巡检结果、通知文本、产出文件和下次检查建议 |
+
+让智能体在心跳巡检后提交 outcome、通知文本、产出文件和下次检查建议。详见 [心跳监控](../08-automation/01-heartbeat.md)。
+
+## 文档与媒体类
+
+### ExportDocument — 导出文档
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 - 中 |
+| 需要确认 | 视目标路径而定 |
+
+把 Markdown 或编辑器内容导出为 PDF、DOCX 等格式，使用统一渲染链路保留标题、表格、代码块、图片和公式。
+
+### GenerateImage / GenerateVideo — 生成图像和视频
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 中 |
+| 需要确认 | 视供应商和费用而定 |
+
+调用已配置的图像或视频生成 provider，支持文生图、图生图、文生视频、参考素材和首尾帧等能力。详见 [媒体生成](./media-generation)。
+
+### BeautifyImage — 美化图片
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 中 |
+| 需要确认 | 视供应商和费用而定 |
+
+对图片进行美化、居中、去边框或质量优化，并对输出体积做保护。
+
+### MathCalc — 高精度计算
+
+| 属性 | 值 |
+|------|-----|
+| 风险等级 | 低 |
+| 需要确认 | 否 |
+
+执行确定性的高精度数学计算，适合金额、比例、统计和公式校验。
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 80a148a..7ebe214 100644
--- a/docs/02-user-guide/09-capabilities/06-integrations-overview.md
+++ b/docs/02-user-guide/09-capabilities/06-integrations-overview.md
@@ -14,6 +14,8 @@ DesireCore 不是一个封闭系统。它通过多层集成架构连接外部世
 
 这篇文档帮助你快速了解 DesireCore 所有集成能力的全貌，然后指引你到具体文档深入阅读。
 
+较新的 DesireCore 还提供 [应用与服务目录](./app-service-catalog)，用于管理应用安装、服务注册、健康探测、启停更新和审批请求。
+
 ## 集成能力全景
 
 | 集成类型 | 说明 | 详细文档 |
@@ -24,6 +26,7 @@ DesireCore 不是一个封闭系统。它通过多层集成架构连接外部世
 | **Computer Use** | 通过 HostAgent 操控桌面和移动设备的 GUI | [GUI 桌面自动化](./computer-use) |
 | **邮件** | 统一管理 Gmail / Outlook / IMAP 邮箱 | [邮件管理](../email/overview) |
 | **工作流** | 用可视化 DSL 编排触发器、代码、LLM、Agent 和人工确认节点 | [任务编排](../../concepts/task-orchestration) |
+| **应用与服务目录** | 管理应用安装、派生服务、审批和健康状态 | [应用与服务目录](./app-service-catalog) |
 
 :::tip 一句话理解
 内置工具是"出厂能力"，MCP 是"扩展接口"，技能包是"工作流模板"，Computer Use 是"万能后备"——四者互补，覆盖几乎所有场景。
diff --git a/docs/02-user-guide/09-capabilities/07-web-access.md b/docs/02-user-guide/09-capabilities/07-web-access.md
new file mode 100644
index 0000000..1c16be2
--- /dev/null
+++ b/docs/02-user-guide/09-capabilities/07-web-access.md
@@ -0,0 +1,60 @@
+---
+title: Web Access
+description: 使用 Web Access v2 访问动态网页、登录态页面、本地书签和站点经验。
+keywords: [Web Access, Browser, CDP, SitePattern, LocalBookmarks, 网页访问]
+---
+
+# Web Access
+
+Web Access v2 让智能体在需要时使用受控浏览器访问网页。它适合普通网页抓取无法覆盖的场景：动态页面、需要登录的后台、复杂表单、单页应用、内网系统和需要截图验证的页面。
+
+## 启用方式
+
+Web Access 是 Skill-scoped 能力。只有相关技能启用后，浏览器控制、CDP 代理、站点经验和本地书签工具才会暴露给智能体。
+
+这种设计可以避免普通任务误用浏览器工具，也能让你清楚知道智能体什么时候可能操作网页。
+
+## 能做什么
+
+| 能力 | 说明 |
+|------|------|
+| 标签页控制 | 打开、列出、切换和关闭浏览器标签页 |
+| 页面操作 | 点击、滚动、输入、选择元素 |
+| 截图观察 | 截取页面或元素状态，辅助视觉判断 |
+| CDP 代理 | 通过 Chrome DevTools Protocol 读取更细的页面状态 |
+| 文件上传 | 在需要时选择本地文件上传，通常需要确认 |
+| 本地书签 | 查询 Chrome / Edge 等浏览器的书签和历史线索 |
+| 站点经验 | 记录某个站点的登录入口、选择器、操作路径和注意事项 |
+
+## SitePattern
+
+SitePattern 是站点经验记录。它帮助智能体记住某个网站如何使用，例如：
+
+- 登录入口和常见跳转
+- 搜索框、筛选器、导出按钮的位置
+- 常见错误和弹窗处理方式
+- 哪些页面需要等待动态加载
+
+写入站点经验前会进行校验，避免把无效或过度宽泛的规则保存下来。
+
+## LocalBookmarks
+
+LocalBookmarks 可以从本机浏览器书签和历史中寻找 URL 线索。它不会自动登录网站，也不会绕过权限；只是帮助智能体找到你常用系统的入口。
+
+## 安全边界
+
+- 默认只允许 `http` 和 `https` URL
+- 上传文件、提交表单、删除或发布内容等有外部影响的操作会触发审批
+- 浏览器会尽量隔离会话标签页，避免不同任务互相污染
+- 截图和页面内容会进入当前任务上下文，请避免在敏感页面开启无关任务
+
+## 与 WebFetch / WebSearch 的关系
+
+优先级通常是：
+
+1. `WebSearch` 查找公开信息
+2. `WebFetch` 读取静态网页正文
+3. Web Access 处理动态、登录态或需要操作的页面
+
+如果普通抓取足够完成任务，智能体不需要打开浏览器。
+
diff --git a/docs/02-user-guide/09-capabilities/08-media-generation.md b/docs/02-user-guide/09-capabilities/08-media-generation.md
new file mode 100644
index 0000000..08d1cba
--- /dev/null
+++ b/docs/02-user-guide/09-capabilities/08-media-generation.md
@@ -0,0 +1,59 @@
+---
+title: 媒体生成
+description: 使用 GenerateImage、GenerateVideo 和 BeautifyImage 生成、编辑和优化图片视频。
+keywords: [图像生成, 视频生成, GenerateImage, GenerateVideo, BeautifyImage, 文生图, 文生视频]
+---
+
+# 媒体生成
+
+DesireCore 可以通过已配置的媒体 provider 生成图片、视频，并对已有图片做美化或修复。媒体生成通常由技能或智能体在合适的任务中调用。
+
+## 前置条件
+
+你需要在「设置 > 算力服务」中启用支持对应服务类型的 provider：
+
+| 服务类型 | 用途 |
+|----------|------|
+| `image_gen` | 文生图、图生图、多图融合 |
+| `video_gen` | 文生视频、图生视频、首尾帧视频 |
+| `image_understanding` / `ocr` | 生成后复核、图片理解 |
+
+官方云端算力、第三方 API Key 和自定义 OpenAI-compatible provider 都可以作为来源，具体取决于供应商能力。
+
+## GenerateImage
+
+`GenerateImage` 用于生成或编辑图片。常见能力包括：
+
+- 根据文本提示词生成图片
+- 使用一张或多张参考图生成新图
+- 调整风格、构图、尺寸和细节
+- 自动保存输出并在聊天中展示
+
+## GenerateVideo
+
+`GenerateVideo` 用于生成视频。常见能力包括：
+
+- 文生视频
+- 以图片作为首帧或参考素材生成视频
+- 使用首尾帧约束镜头变化
+- 输出后作为媒体文件附加到对话
+
+## BeautifyImage
+
+`BeautifyImage` 用于优化已有图片，例如：
+
+- 图片居中和裁切
+- 去除多余边框
+- 质量增强或尺寸调整
+- 输出体积保护，避免生成异常大文件
+
+## 审批与费用
+
+媒体生成可能消耗 API 额度或账号 credit。涉及付费 provider、上传参考素材或写入本地文件时，系统会按风险和权限策略请求确认。
+
+## 使用建议
+
+- 需要“看懂图片”时使用视觉模型，而不是图像生成模型
+- 需要聊天回复时选择 chat 模型，图像/视频生成模型不会出现在普通对话模型选择器中
+- 对正式素材，生成后让智能体用视觉理解工具复核一次，检查文字、构图和明显错误
+
diff --git a/docs/02-user-guide/09-capabilities/09-app-service-catalog.md b/docs/02-user-guide/09-capabilities/09-app-service-catalog.md
new file mode 100644
index 0000000..bd4fda9
--- /dev/null
+++ b/docs/02-user-guide/09-capabilities/09-app-service-catalog.md
@@ -0,0 +1,56 @@
+---
+title: 应用与服务目录
+description: 了解应用安装、服务注册、运行状态、审批和更新管理。
+keywords: [应用目录, 服务目录, Apps, Services, 安装, 审批, MCP]
+---
+
+# 应用与服务目录
+
+应用与服务目录把第三方应用、MCP 服务和由应用派生的本地服务集中管理。它不只是一个列表，而是从安装、注册、审批到启停更新的闭环。
+
+## 目录里有什么
+
+| 条目 | 说明 |
+|------|------|
+| 应用 | 可安装的第三方能力包或集成入口 |
+| 服务 | 应用安装后注册出的 MCP、HTTP 或本地服务 |
+| 待审批项 | 服务注册、调用、提权或测试连接时需要你确认的请求 |
+| 安装记录 | 已安装、失败、运行中、已停止、可更新等状态 |
+
+## 安装流程
+
+1. 在 Marketplace 或应用目录中选择应用
+2. DesireCore 委派核心智能体执行安装
+3. 安装记录写回本地
+4. 应用派生的服务被 watcher 发现并注册
+5. 需要权限的服务进入待审批面板
+
+安装完成后，你可以从目录中打开、启动、停止、重启或更新应用/服务。
+
+## 服务审批
+
+服务可能请求以下操作：
+
+- 注册新服务
+- 调用外部 API
+- 访问本地文件或端口
+- 提升权限
+- 执行健康探测
+
+这些请求会进入审批流程。你可以批准、拒绝或查看详情。未经审批的 stdio 服务不会被后台静默执行。
+
+## 状态与排障
+
+常见状态包括：
+
+| 状态 | 含义 |
+|------|------|
+| Installed | 已安装但不一定运行中 |
+| Running | 服务正在运行 |
+| Stopped | 已停止 |
+| Failed | 安装或启动失败 |
+| Update available | 有可用更新 |
+| Pending approval | 等待你审批 |
+
+如果服务不可用，可以先查看详情页中的健康检查结果、日志摘要和审批状态。
+
diff --git a/docs/05-more/05-builtin-tools-reference.md b/docs/05-more/05-builtin-tools-reference.md
index 7967851..817f069 100644
--- a/docs/05-more/05-builtin-tools-reference.md
+++ b/docs/05-more/05-builtin-tools-reference.md
@@ -1,363 +1,111 @@
 ---
 title: 内置工具参考
-description: DesireCore 内置工具的完整参考，包含功能说明、使用场景、风险等级和确认行为。
+description: DesireCore 内置工具的参考说明，包含功能、风险等级和使用场景。
 keywords: [工具, Tool, 内置工具, Builtin Tools, 参考]
 ---
 
 # 内置工具参考
 
-DesireCore 的内置工具随客户端提供，智能体无需额外安装即可使用。工具是否出现在智能体上下文中取决于平台、权限、审批策略、当前运行环境和任务上下文；例如 PowerShell 与 HttpRequest 主要面向 Windows 环境。
+DesireCore 的内置工具会随客户端版本更新。本文按能力域列出常用工具和用户需要理解的边界；实际可用工具会根据智能体、已启用技能、权限策略和当前平台动态变化。
 
-## 快速索引
-
-| 类别 | 工具 |
-|------|------|
-| 文件操作 | Read、Write、Edit、NotebookEdit |
-| 搜索与发现 | Glob、Grep、Ls、ToolSearch |
-| 命令、等待与网络 | Bash、PowerShell、Which、Sleep、WebFetch、WebSearch、HttpRequest |
-| 智能体协作 | Delegate、spawn_agent、handoff、request_help、SendMessage、SendUserMessage、AskUserQuestion、ManageTeam |
-| 工作空间与数据 | ManageWorkDirs、GenerateUUID、RecallConversation、JsonRepair |
-| 技能与调度 | Skill、CreateSchedule |
-| MCP | McpListResources、McpReadResource、McpListPrompts、McpGetPrompt |
-| 工作流 | WorkflowCreate、WorkflowValidate、WorkflowTest、WorkflowRun、WorkflowView |
-
-## 风险和确认
-
-| 风险等级 | 常见工具 | 默认确认 |
-|----------|----------|----------|
-| 低 | Read、Glob、Grep、Ls、Which、Sleep、WebFetch、WebSearch、GenerateUUID、JsonRepair | 通常不需要 |
-| 中 | Write、Edit、NotebookEdit、ManageWorkDirs、CreateSchedule、WorkflowRun、HttpRequest | 写入、目录管理或后台任务类通常需要更谨慎 |
-| 高 | Bash、PowerShell | 通常需要确认 |
-| 继承配置 | Skill、MCP 工具、工作流节点 | 取决于技能、MCP Server 或工作流节点声明 |
-
-实际确认行为还会受到你的权限设置、审批模式和操作内容影响。命令执行、文件写入、外部发送和高影响操作应在确认前检查工作目录、命令内容和意图。
-
-## 文件操作
-
-### Read（读取文件）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 读取文本、代码、配置、图片和 Notebook 内容；支持范围读取和分页 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 查看代码、阅读文档、检查配置、预览图片、理解 Notebook |
-
-### Write（写入文件）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 创建新文件或完整覆盖已有文件；目录不存在时可自动创建 |
-| 风险等级 | 中 |
-| 需要确认 | 通常需要 |
-| 使用场景 | 创建文档、生成报告、保存配置、写入完整文件 |
-
-### Edit（编辑文件）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 对文件做精确文本替换，适合局部修改 |
-| 风险等级 | 中 |
-| 需要确认 | 通常需要 |
-| 使用场景 | 修复代码片段、更新配置项、修改文档中的特定段落 |
-
-### NotebookEdit（编辑 Jupyter Notebook）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 替换、插入或删除 Jupyter Notebook 的指定单元格 |
-| 风险等级 | 中 |
-| 需要确认 | 通常需要 |
-| 使用场景 | 调整数据分析 Notebook、补充实验代码、整理计算步骤 |
-
-## 搜索与发现
-
-### Glob（搜索文件名）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 使用 glob 模式搜索文件名，支持 `**/*.ts` 这类递归匹配 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 查找配置文件、定位测试文件、浏览项目结构 |
-
-### Grep（搜索文件内容）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 在文件内容中搜索文本或正则表达式，支持上下文和文件类型过滤 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 查找函数调用、定位错误信息、搜索文档关键词 |
-
-### Ls（列出目录）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 列出目录中的文件和子目录，可按需递归显示 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 浏览工作区、确认文件位置、查看目录结构 |
-
-### ToolSearch（搜索延迟工具）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 搜索可延迟加载的工具、连接器和外部能力 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 查找 GitHub、浏览器调试、文档查询等按需加载工具 |
-
-## 命令、等待与网络
-
-### Bash（执行 Shell 命令）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 在 macOS/Linux 或支持 Shell 的环境中执行命令；支持超时、后台运行和输出截断 |
-| 风险等级 | 高 |
-| 需要确认 | 通常需要 |
-| 使用场景 | 运行测试、构建项目、安装依赖、执行脚本 |
-
-### PowerShell（执行 Windows PowerShell 命令）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 在 Windows 上执行 PowerShell 命令和脚本 |
-| 风险等级 | 高 |
-| 需要确认 | 通常需要 |
-| 使用场景 | Windows 系统管理、运行 PowerShell 脚本、检查本机环境 |
-
-### Which（检查命令是否可用）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 检查一个或多个命令行工具是否存在，并返回可执行路径 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 执行命令前确认依赖是否安装 |
-
-### Sleep（当前会话等待）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 在当前会话中等待 0.1 到 300 秒，等待结束后继续原任务链 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 等待构建完成、轮询部署状态、控制请求频率 |
-
-:::tip Sleep 与 CreateSchedule
-`Sleep` 是当前会话内的短等待，适合“等几秒后继续检查”。`CreateSchedule` 是后台异步调度，到点后创建新的执行任务，适合提醒、定期检查和独立汇报。
-:::
-
-### WebFetch（获取网页）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 获取网页内容并转换为 Markdown，支持正文提取、缓存和超时控制 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 阅读在线文档、查看 API 参考、摘取网页正文 |
-
-### WebSearch（网页搜索）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 搜索互联网并返回结果，支持结果数量和域名过滤 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 获取最新资料、检索公开信息、查找问题解决方案 |
-
-### HttpRequest（HTTP 请求）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 在 Windows 环境中发起 HTTP 请求，适合缺少常用命令行网络工具的场景 |
-| 风险等级 | 中 |
-| 需要确认 | 取决于请求内容 |
-| 使用场景 | 调用 API、检查服务状态、获取结构化数据 |
-
-## 智能体协作
-
-### Delegate（委派任务）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 将任务委派给其他智能体、团队或预设流程，支持同步、异步、handoff 和 Explore 模式 |
-| 风险等级 | 中 |
-| 需要确认 | 取决于权限和任务内容 |
-| 使用场景 | 跨专业分工、并行调研、让 Explore 预设只读分析代码库 |
-
-### spawn_agent（启动子智能体）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 启动临时子智能体处理明确子任务，拥有独立上下文 |
-| 风险等级 | 中 |
-| 需要确认 | 取决于权限 |
-| 使用场景 | 并行阅读多个模块、拆分大型问题、隔离探索任务 |
-
-### handoff（转交会话）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 将当前会话交给另一个智能体，并携带原因和上下文摘要 |
-| 风险等级 | 低 |
-| 需要确认 | 通常不需要 |
-| 使用场景 | 当前智能体判断另一个专业智能体更适合继续处理 |
-
-### request_help / SendMessage（智能体间沟通）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 向另一个持久智能体请求帮助或发送消息，可选择等待回复 |
-| 风险等级 | 低 |
-| 需要确认 | 通常不需要 |
-| 使用场景 | 多智能体协作、向领域专家征询建议、回传任务结果 |
-
-### SendUserMessage（向用户发送消息）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 向用户发送 Markdown 消息，可附带文件附件，并能作为主动通知展示 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 汇报阶段性结果、发送带附件的说明、主动提醒关注事项 |
-
-### AskUserQuestion（向用户提问）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 在当前会话中显示结构化问题卡片，收集确认、选择或补充信息 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 澄清需求、确认方案、收集多个字段答案 |
-
-### ManageTeam（管理团队）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 创建和调整智能体团队，设置主管、成员和团队任务 |
-| 风险等级 | 中 |
-| 需要确认 | 取决于操作内容 |
-| 使用场景 | 组建专业团队、调整团队成员、分配团队任务 |
-
-## 工作空间与数据
-
-### ManageWorkDirs（管理工作目录）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 列出、添加、移除和设置智能体的主工作目录 |
-| 风险等级 | 中 |
-| 需要确认 | 通常需要 |
-| 使用场景 | 添加项目目录、切换主工作区、移除不再使用的路径 |
-
-### GenerateUUID（生成唯一标识）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 生成一个或多个 UUID v4 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 创建唯一 ID、生成测试数据、命名资源 |
-
-### RecallConversation（检索对话历史）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 按关键词和时间范围检索历史对话记录 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 回顾之前的讨论、查找历史决策、恢复上下文 |
-
-### JsonRepair（修复 JSON）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 修复常见 JSON 格式问题，并可按预期结构整理输出 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 修复模型生成的 JSON、整理配置片段 |
-
-## 技能与调度
-
-### Skill（加载技能）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 加载并执行指定技能包；技能可声明可用工具、触发限制、上下文模式、模型和供应商偏好 |
-| 风险等级 | 继承技能配置 |
-| 需要确认 | 继承技能和其调用工具的配置 |
-| 使用场景 | 执行专业流程、调用自定义能力、应用内置全局技能 |
-
-### CreateSchedule（创建调度任务）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 创建后台定时任务，支持指定时间、延迟、固定间隔和 Cron 规则 |
-| 风险等级 | 中 |
-| 需要确认 | 取决于审批策略 |
-| 使用场景 | 设置提醒、定期生成报告、安排独立 Prompt 检查 |
-
-## MCP 集成
-
-### McpListResources / McpReadResource
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 列出或读取 MCP Server 暴露的资源 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 查看外部服务资源、读取连接器提供的数据 |
-
-### McpListPrompts / McpGetPrompt
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 列出或获取 MCP Server 提供的 Prompt 模板 |
-| 风险等级 | 低 |
-| 需要确认 | 否 |
-| 使用场景 | 复用外部服务提供的标准提示模板 |
-
-## 工作流
-
-### WorkflowCreate（创建工作流）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 根据 DSL 创建工作流文件，并可同时写入说明文档 |
-| 风险等级 | 低 |
-| 使用场景 | 新建可复用自动化流程 |
-
-### WorkflowValidate（校验工作流）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 校验工作流 DSL 的结构、节点、边和引用关系 |
-| 风险等级 | 低 |
-| 使用场景 | 保存前检查工作流配置是否有效 |
-
-### WorkflowTest（测试工作流）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 使用参数测试工作流执行路径，确认节点配置和输入输出 |
-| 风险等级 | 低 |
-| 使用场景 | 调试自动化流程、验证节点输出 |
-
-### WorkflowRun（运行工作流）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 执行工作流并返回结构化结果 |
-| 风险等级 | 中 |
-| 使用场景 | 执行包含代码、LLM、Agent 或人工确认节点的流程 |
-
-### WorkflowView（打开工作流）
-
-| 属性 | 说明 |
-|------|------|
-| 功能 | 打开工作流画布进行查看，不直接编辑内容 |
-| 风险等级 | 低 |
-| 使用场景 | 查看流程结构、审查节点配置 |
+## 文件与搜索
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `Read` | 读取文本、图片、PDF 和大文件片段 | 低 | 否 |
+| `Write` | 创建或覆盖文件 | 中 | 默认需要 |
+| `Edit` | 精确替换文件中的文本片段 | 中 | 默认需要 |
+| `NotebookEdit` | 编辑 Jupyter Notebook 单元格 | 中 | 默认需要 |
+| `Ls` | 列出目录内容 | 低 | 否 |
+| `Glob` | 按文件名模式搜索 | 低 | 否 |
+| `Grep` | 按文本或正则搜索文件内容 | 低 | 否 |
+| `ToolSearch` | 搜索延迟加载的工具、连接器和外部能力 | 低 | 否 |
+
+`Read` 会按文件类型选择策略：文本走分页读取，图片走视觉输入，PDF 会在文本提取、按页渲染、目录定位和大文件分段读取之间切换。
+
+## 系统与工作目录
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `Bash` | 执行 Shell 命令 | 高 | 是 |
+| `PowerShell` | 在 Windows 上执行 PowerShell 命令 | 高 | 是 |
+| `Which` | 检查命令是否可用 | 低 | 否 |
+| `ManageWorkDirs` | 添加、移除或设置工作目录 | 中 | 默认需要 |
+| `GenerateUUID` | 生成 UUID | 低 | 否 |
+| `JsonRepair` | 修复常见 JSON 格式问题 | 低 | 否 |
+
+命令执行始终需要你查看完整命令后确认。工作目录决定智能体可以安全操作哪些本地文件。
+
+## 网络与浏览器
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `WebFetch` | 获取网页并转换为 Markdown | 低 | 否 |
+| `WebSearch` | 搜索互联网 | 低 | 否 |
+| `HttpRequest` | 发起 HTTP 请求，主要用于 Windows 环境 | 中 | 视请求而定 |
+| `Browser*` | 控制浏览器标签页、点击、滚动、截图 | 低 - 中 | 视操作而定 |
+| `SitePattern*` | 读取或写入站点经验 | 低 - 中 | 写入时可能需要 |
+| `LocalBookmarks` | 查询本机浏览器书签和历史线索 | 低 | 否 |
+
+`Browser*`、`SitePattern*` 和 `LocalBookmarks` 属于 Web Access v2 的 Skill-scoped 工具，只有对应技能启用后才会暴露。详见 [Web Access](../user-guide/capabilities/web-access)。
+
+## 协作与任务
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `Delegate` | 委派任务给其他智能体、团队或预设流程 | 中 | 视任务而定 |
+| `SpawnAgent` | 创建临时子智能体 | 中 | 默认需要 |
+| `Handoff` | 把任务移交给另一个智能体 | 中 | 默认需要 |
+| `RequestHelp` | 向持久智能体请求协助 | 中 | 默认需要 |
+| `SendMessage` / `SendUserMessage` | 智能体间沟通或主动向用户发送消息 | 低 | 否 |
+| `AskUserQuestion` | 向用户发起结构化问答 | 低 | 否 |
+| `ManageTeam` | 创建或调整智能体团队 | 中 | 视操作而定 |
+| `TaskCreate` / `TaskUpdate` | 维护悬浮任务板 | 低 | 否 |
+| `TaskList` / `TaskGet` | 查询任务板状态 | 低 | 否 |
+
+任务工具用于让长任务透明可见，不会自行执行外部副作用。真正有影响的文件、命令、网络或服务调用仍受对应工具权限控制。
+
+## 上下文、记忆与技能
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `RecallConversation` | 检索历史对话 | 低 | 否 |
+| `CompactSession` | 压缩长会话上下文 | 低 | 否 |
+| `Skill` | 加载或调用技能 | 视技能而定 | 视技能而定 |
+
+`CompactSession` 会保留可见历史，只改变后续模型读取旧消息的方式。技能可以携带自己的工具声明和风险策略。
+
+## 自动化
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `CreateSchedule` | 创建延迟、指定时间、间隔或 cron 调度 | 中 | 是 |
+| `HeartbeatRespond` | 提交心跳巡检结果、通知和文件链接 | 低 | 否 |
+| `WorkflowCreate` | 创建工作流定义 | 中 | 默认需要 |
+| `WorkflowValidate` / `WorkflowTest` | 校验或测试工作流定义 | 低 | 否 |
+| `WorkflowRun` | 运行已定义工作流 | 中 | 默认需要 |
+| `WorkflowView` | 打开工作流画布查看结构 | 低 | 否 |
+
+监控类需求优先使用心跳；定时执行类需求使用调度。调度触发后会在新会话里执行，不继承你当前输入框里的临时上下文。
+
+## 文档、PDF 与媒体
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `ExportDocument` | 导出 PDF、DOCX 等文档 | 低 - 中 | 视目标路径而定 |
+| `GenerateImage` | 生成或编辑图片 | 中 | 视费用和 provider 而定 |
+| `GenerateVideo` | 生成视频 | 中 | 视费用和 provider 而定 |
+| `BeautifyImage` | 美化、裁切或优化图片 | 中 | 视费用和 provider 而定 |
+| `UnderstandImage` | 调用视觉理解 provider | 低 - 中 | 视 provider 而定 |
+| `MathCalc` | 高精度确定性计算 | 低 | 否 |
+
+媒体生成工具需要对应的 `image_gen`、`video_gen` 或图像处理 provider。详见 [媒体生成](../user-guide/capabilities/media-generation)。
+
+## MCP 资源
+
+| 工具 | 功能 | 风险 | 确认 |
+|------|------|------|------|
+| `McpListResources` / `McpReadResource` | 列出和读取 MCP 资源 | 低 | 否 |
+| `McpListPrompts` / `McpGetPrompt` | 列出和展开 MCP Prompt | 低 | 否 |
+
+MCP 工具来自你连接的外部服务。它们的权限、风险和审批策略由服务声明与 DesireCore 的本地权限层共同决定。
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/07-web-access.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/07-web-access.md
new file mode 100644
index 0000000..52b8536
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/07-web-access.md
@@ -0,0 +1,30 @@
+---
+title: Web Access
+description: Use Web Access v2 for dynamic pages, signed-in sites, local bookmarks, and site patterns.
+keywords: [Web Access, Browser, CDP, SitePattern, LocalBookmarks]
+---
+
+# Web Access
+
+Web Access v2 lets agents use a controlled browser when static fetching is not enough. It is useful for dynamic pages, signed-in dashboards, complex forms, internal systems, and pages that require screenshots.
+
+## Skill-scoped Tools
+
+Web Access tools are exposed only when the related skill is active. This prevents regular tasks from using heavy or higher-permission browser tools by accident.
+
+## Capabilities
+
+| Capability | Description |
+|------------|-------------|
+| Tab control | Open, list, switch, and close tabs |
+| Page actions | Click, scroll, type, and inspect elements |
+| Screenshots | Capture page state for visual reasoning |
+| CDP proxy | Use Chrome DevTools Protocol for richer page state |
+| File upload | Select local files when approved |
+| Local bookmarks | Search browser bookmarks and history hints |
+| Site patterns | Reuse known selectors, entry points, and workflow notes |
+
+## Safety
+
+Only `http` and `https` URLs are allowed by default. Actions with external impact, such as uploads, submissions, deletion, or publishing, go through approval.
+
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/08-media-generation.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/08-media-generation.md
new file mode 100644
index 0000000..3e39928
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/08-media-generation.md
@@ -0,0 +1,28 @@
+---
+title: Media Generation
+description: Generate, edit, and improve images or videos with GenerateImage, GenerateVideo, and BeautifyImage.
+keywords: [image generation, video generation, GenerateImage, GenerateVideo, BeautifyImage]
+---
+
+# Media Generation
+
+DesireCore can use configured media providers to generate images, generate videos, and improve existing images.
+
+## Requirements
+
+Enable providers for the relevant service type in Settings > Compute Service:
+
+| Service type | Use |
+|--------------|-----|
+| `image_gen` | Text-to-image, image-to-image, multi-image fusion |
+| `video_gen` | Text-to-video, image-to-video, first/last-frame video |
+| `image_understanding` / `ocr` | Reviewing generated images and understanding input images |
+
+## Tools
+
+- `GenerateImage`: creates or edits images from prompts and references
+- `GenerateVideo`: creates videos from text, images, or frame constraints
+- `BeautifyImage`: centers, crops, removes borders, enhances quality, and guards output size
+
+Media generation can consume API quota or account credits, so provider, cost, and file-write approvals may apply.
+
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/09-app-service-catalog.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/09-app-service-catalog.md
new file mode 100644
index 0000000..37b44c0
--- /dev/null
+++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/09-capabilities/09-app-service-catalog.md
@@ -0,0 +1,25 @@
+---
+title: App and Service Catalog
+description: Manage app installation, service registration, runtime status, approvals, and updates.
+keywords: [apps, services, catalog, approvals, MCP]
+---
+
+# App and Service Catalog
+
+The App and Service Catalog manages third-party apps, MCP services, and services derived from installed apps. It covers installation, registration, approval, runtime status, and updates.
+
+## What It Contains
+
+| Entry | Description |
+|-------|-------------|
+| Apps | Installable third-party capability packages or integration entry points |
+| Services | MCP, HTTP, or local services registered by apps |
+| Pending approvals | Requests to register, invoke, test, or elevate services |
+| Install records | Installed, failed, running, stopped, and update-available states |
+
+Unapproved stdio services are not executed silently in the background.
+
+## Common Actions
+
+You can open, start, stop, restart, update, inspect health checks, and review pending approvals from the catalog.
+
diff --git a/i18n/en/docusaurus-plugin-content-docs/current/05-more/05-builtin-tools-reference.md b/i18n/en/docusaurus-plugin-content-docs/current/05-more/05-builtin-tools-reference.md
index f783b5d..f574659 100644
--- a/i18n/en/docusaurus-plugin-content-docs/current/05-more/05-builtin-tools-reference.md
+++ b/i18n/en/docusaurus-plugin-content-docs/current/05-more/05-builtin-tools-reference.md
@@ -1,363 +1,103 @@
 ---
 title: Built-in Tools Reference
-description: Complete reference for DesireCore built-in tools, including functionality, usage scenarios, risk levels, and confirmation behavior.
-keywords: [tools, Tool, built-in tools, Builtin Tools, reference]
+description: Reference for DesireCore built-in tools, including function, risk level, and use cases.
+keywords: [tools, built-in tools, reference]
 ---
 
 # Built-in Tools Reference
 
-DesireCore built-in tools ship with the client and require no extra installation. A tool appears in agent context only when it is available for the current platform, permission policy, runtime environment, and task context. For example, PowerShell and HttpRequest are primarily Windows-oriented.
-
-## Quick Index
-
-| Category | Tools |
-|----------|-------|
-| File Operations | Read, Write, Edit, NotebookEdit |
-| Search and Discovery | Glob, Grep, Ls, ToolSearch |
-| Commands, Waiting, and Network | Bash, PowerShell, Which, Sleep, WebFetch, WebSearch, HttpRequest |
-| Agent Collaboration | Delegate, spawn_agent, handoff, request_help, SendMessage, SendUserMessage, AskUserQuestion, ManageTeam |
-| Workspace and Data | ManageWorkDirs, GenerateUUID, RecallConversation, JsonRepair |
-| Skills and Scheduling | Skill, CreateSchedule |
-| MCP | McpListResources, McpReadResource, McpListPrompts, McpGetPrompt |
-| Workflows | WorkflowCreate, WorkflowValidate, WorkflowTest, WorkflowRun, WorkflowView |
-
-## Risk And Confirmation
-
-| Risk Level | Common Tools | Default Confirmation |
-|------------|--------------|----------------------|
-| Low | Read, Glob, Grep, Ls, Which, Sleep, WebFetch, WebSearch, GenerateUUID, JsonRepair | Usually no |
-| Medium | Write, Edit, NotebookEdit, ManageWorkDirs, CreateSchedule, WorkflowRun, HttpRequest | Use more care for writes, directory management, or background tasks |
-| High | Bash, PowerShell | Usually yes |
-| Inherited | Skill, MCP tools, workflow nodes | Depends on skill, MCP server, or workflow node declarations |
-
-Actual confirmation behavior depends on permission settings, approval mode, and operation content. Before approving command execution, file writes, external sends, or high-impact operations, review the command, working directory, and intent.
-
-## File Operations
-
-### Read
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Reads text, code, configuration files, images, and notebook content; supports ranged reads and pagination |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Inspect code, read docs, check configuration, preview images, understand notebooks |
-
-### Write
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Creates a new file or fully overwrites an existing file; missing directories can be created automatically |
-| Risk Level | Medium |
-| Requires Confirmation | Usually yes |
-| Usage Scenarios | Create docs, generate reports, save configuration, write complete files |
-
-### Edit
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Performs precise text replacement for local patches |
-| Risk Level | Medium |
-| Requires Confirmation | Usually yes |
-| Usage Scenarios | Patch code, update configuration, fix a section of a document |
-
-### NotebookEdit
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Replaces, inserts, or deletes a specific Jupyter Notebook cell |
-| Risk Level | Medium |
-| Requires Confirmation | Usually yes |
-| Usage Scenarios | Adjust analysis notebooks, update experiments, organize computation steps |
-
-## Search And Discovery
-
-### Glob
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Finds files with glob patterns such as `**/*.ts` |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Find config files, locate tests, inspect project structure |
-
-### Grep
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Searches text or regular expressions in files with context and file-type filters |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Find function calls, locate error messages, search documentation |
-
-### Ls
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Lists files and subdirectories, optionally recursively |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Browse workspaces, confirm paths, inspect folders |
-
-### ToolSearch
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Searches deferred tools, connectors, and external capabilities |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Find GitHub, browser debugging, documentation lookup, or other lazy-loaded tools |
-
-## Commands, Waiting, And Network
-
-### Bash
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Runs shell commands; supports timeouts, background execution, and output truncation |
-| Risk Level | High |
-| Requires Confirmation | Usually yes |
-| Usage Scenarios | Run tests, build projects, install dependencies, execute scripts |
-
-### PowerShell
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Runs PowerShell commands and scripts on Windows |
-| Risk Level | High |
-| Requires Confirmation | Usually yes |
-| Usage Scenarios | Windows administration, PowerShell scripts, local environment checks |
-
-### Which
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Checks whether one or more command-line tools are installed and returns executable paths |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Verify dependencies before running commands |
-
-### Sleep
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Waits 0.1 to 300 seconds inside the current session, then continues the same task chain |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Wait for builds, poll deployment status, rate-limit requests |
-
-:::tip Sleep vs. CreateSchedule
-Use `Sleep` for a short wait before continuing the current task. Use `CreateSchedule` for independent background reminders, reports, and recurring tasks.
-:::
-
-### WebFetch
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Fetches a web page and converts it to Markdown with content extraction, caching, and timeout controls |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Read online docs, inspect API references, extract page text |
-
-### WebSearch
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Searches the web with result limits and domain filters |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Find current information, public references, troubleshooting material |
-
-### HttpRequest
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Sends HTTP requests in Windows-oriented environments where common command-line network tools may be unavailable |
-| Risk Level | Medium |
-| Requires Confirmation | Depends on request content |
-| Usage Scenarios | Call APIs, check service status, retrieve structured data |
-
-## Agent Collaboration
-
-### Delegate
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Delegates work to another agent, a team, or a preset; supports sync, async, handoff, and Explore modes |
-| Risk Level | Medium |
-| Requires Confirmation | Depends on permissions and task content |
-| Usage Scenarios | Cross-domain collaboration, parallel research, read-only Explore analysis |
-
-### spawn_agent
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Starts a temporary sub-agent with isolated context for a concrete subtask |
-| Risk Level | Medium |
-| Requires Confirmation | Depends on permissions |
-| Usage Scenarios | Read multiple modules in parallel, split large investigations, isolate exploration |
-
-### handoff
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Transfers the current conversation to another agent with reason and context summary |
-| Risk Level | Low |
-| Requires Confirmation | Usually no |
-| Usage Scenarios | Move a task to a more suitable specialist agent |
-
-### request_help / SendMessage
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Requests help from or sends messages to another persistent agent, optionally waiting for a reply |
-| Risk Level | Low |
-| Requires Confirmation | Usually no |
-| Usage Scenarios | Multi-agent collaboration, specialist advice, result handoff |
-
-### SendUserMessage
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Sends a Markdown message to the user, optionally with file attachments and proactive status |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Report progress, send attached material, proactively surface important context |
-
-### AskUserQuestion
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Displays structured question cards to collect confirmation, choices, or extra fields |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Clarify requirements, confirm plans, collect multiple answers |
-
-### ManageTeam
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Creates and adjusts agent teams, supervisors, members, and team tasks |
-| Risk Level | Medium |
-| Requires Confirmation | Depends on operation content |
-| Usage Scenarios | Form specialist teams, adjust members, assign team-level work |
-
-## Workspace And Data
-
-### ManageWorkDirs
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Lists, adds, removes, and sets primary work directories |
-| Risk Level | Medium |
-| Requires Confirmation | Usually yes |
-| Usage Scenarios | Add project folders, switch primary workspace, remove paths |
-
-### GenerateUUID
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Generates one or more UUID v4 identifiers |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Create IDs, generate test data, name resources |
-
-### RecallConversation
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Retrieves historical conversations by keyword and time range |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Review prior discussions, find past decisions, restore context |
-
-### JsonRepair
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Repairs common JSON formatting issues and can shape output toward an expected structure |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Fix model-generated JSON, clean configuration snippets |
-
-## Skills And Scheduling
-
-### Skill
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Loads and executes an installed skill pack; skills may declare tools, trigger restrictions, context mode, model, and provider preferences |
-| Risk Level | Inherits skill configuration |
-| Requires Confirmation | Inherits the skill and any tools it invokes |
-| Usage Scenarios | Run professional workflows, invoke custom capabilities, apply built-in global skills |
-
-### CreateSchedule
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Creates a background scheduled task using an exact time, delay, interval, or Cron rule |
-| Risk Level | Medium |
-| Requires Confirmation | Depends on approval policy |
-| Usage Scenarios | Set reminders, generate periodic reports, schedule independent prompt checks |
-
-## MCP Integration
-
-### McpListResources / McpReadResource
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Lists or reads resources exposed by MCP servers |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Inspect external service resources, read connector-provided data |
-
-### McpListPrompts / McpGetPrompt
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Lists or expands prompt templates provided by MCP servers |
-| Risk Level | Low |
-| Requires Confirmation | No |
-| Usage Scenarios | Reuse prompt templates exposed by external services |
-
-## Workflows
-
-### WorkflowCreate
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Creates a workflow DSL file and can write accompanying documentation |
-| Risk Level | Low |
-| Usage Scenarios | Build reusable automation flows |
-
-### WorkflowValidate
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Validates workflow DSL structure, nodes, edges, and references |
-| Risk Level | Low |
-| Usage Scenarios | Check workflow configuration before saving |
-
-### WorkflowTest
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Tests workflow execution paths with parameters |
-| Risk Level | Low |
-| Usage Scenarios | Debug automation flows, verify node output |
-
-### WorkflowRun
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Executes a workflow and returns structured results |
-| Risk Level | Medium |
-| Usage Scenarios | Run flows containing code, LLM, agent, or human-gate nodes |
-
-### WorkflowView
-
-| Attribute | Description |
-|-----------|-------------|
-| Function | Opens the workflow canvas for viewing without directly editing content |
-| Risk Level | Low |
-| Usage Scenarios | Inspect flow structure and node configuration |
+DesireCore built-in tools evolve with the client. This page groups common tools by capability area; the exact tools available to an agent depend on the agent, enabled skills, permissions, and platform.
+
+## Files and Search
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `Read` | Read text, images, PDFs, and large file ranges | Low | No |
+| `Write` | Create or overwrite files | Medium | Usually |
+| `Edit` | Replace precise text ranges | Medium | Usually |
+| `NotebookEdit` | Edit Jupyter Notebook cells | Medium | Usually |
+| `Ls` | List directory contents | Low | No |
+| `Glob` | Search by filename pattern | Low | No |
+| `Grep` | Search file contents | Low | No |
+| `ToolSearch` | Search deferred tools, connectors, and external capabilities | Low | No |
+
+`Read` chooses a strategy by file type. PDFs may be read as text, rendered page by page for vision models, or loaded by range for large files.
+
+## System and Workspace
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `Bash` | Run shell commands | High | Yes |
+| `PowerShell` | Run PowerShell commands on Windows | High | Yes |
+| `Which` | Check command availability | Low | No |
+| `ManageWorkDirs` | Manage working directories | Medium | Usually |
+| `GenerateUUID` | Generate UUIDs | Low | No |
+| `JsonRepair` | Repair common JSON formatting problems | Low | No |
+
+## Web and Browser
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `WebFetch` | Fetch a webpage as Markdown | Low | No |
+| `WebSearch` | Search the web | Low | No |
+| `HttpRequest` | Send HTTP requests, primarily for Windows environments | Medium | Depends |
+| `Browser*` | Control browser tabs, clicks, scrolling, screenshots | Low-Medium | Depends |
+| `SitePattern*` | Read or write site usage patterns | Low-Medium | May be needed |
+| `LocalBookmarks` | Search local browser bookmarks/history hints | Low | No |
+
+Browser, SitePattern, and LocalBookmarks tools are Web Access skill-scoped tools. See [Web Access](../user-guide/capabilities/web-access).
+
+## Collaboration and Tasks
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `Delegate` | Delegate work to another agent, team, or preset flow | Medium | Depends |
+| `SpawnAgent` | Create a temporary sub-agent | Medium | Usually |
+| `Handoff` | Transfer work to another agent | Medium | Usually |
+| `RequestHelp` | Ask a persistent agent for help | Medium | Usually |
+| `SendMessage` / `SendUserMessage` | Communicate between agents or proactively message the user | Low | No |
+| `AskUserQuestion` | Ask the user a structured question | Low | No |
+| `ManageTeam` | Create or adjust an agent team | Medium | Depends |
+| `TaskCreate` / `TaskUpdate` | Maintain the floating task board | Low | No |
+| `TaskList` / `TaskGet` | Query task board state | Low | No |
+
+## Context, Memory, and Skills
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `RecallConversation` | Retrieve conversation history | Low | No |
+| `CompactSession` | Compact long conversation context | Low | No |
+| `Skill` | Load or invoke a skill | Depends | Depends |
+
+## Automation
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `CreateSchedule` | Create delay, at, interval, or cron schedules | Medium | Yes |
+| `HeartbeatRespond` | Submit heartbeat outcome, notifications, and file links | Low | No |
+| `WorkflowCreate` | Create workflow definitions | Medium | Usually |
+| `WorkflowValidate` / `WorkflowTest` | Validate or test workflow definitions | Low | No |
+| `WorkflowRun` | Run workflows | Medium | Usually |
+| `WorkflowView` | Open the workflow canvas for inspection | Low | No |
+
+## Documents and Media
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `ExportDocument` | Export PDF, DOCX, or related formats | Low-Medium | Depends |
+| `GenerateImage` | Generate or edit images | Medium | Depends on provider/cost |
+| `GenerateVideo` | Generate videos | Medium | Depends on provider/cost |
+| `BeautifyImage` | Improve, crop, center, or optimize images | Medium | Depends |
+| `UnderstandImage` | Use a vision provider | Low-Medium | Depends |
+| `MathCalc` | Deterministic high-precision calculation | Low | No |
+
+Media generation tools require a configured `image_gen`, `video_gen`, or image processing provider. See [Media Generation](../user-guide/capabilities/media-generation).
+
+## MCP Resources
+
+| Tool | Function | Risk | Confirmation |
+|------|----------|------|--------------|
+| `McpListResources` / `McpReadResource` | List and read MCP resources | Low | No |
+| `McpListPrompts` / `McpGetPrompt` | List and expand MCP prompts | Low | No |
+
+MCP tools come from connected external services. Their permissions, risks, and approval behavior depend on the service declaration and DesireCore local permission policy.