diff --git a/docs/02-user-guide/01-interface/01-layout-overview.md b/docs/02-user-guide/01-interface/01-layout-overview.md index ff4feb6..4aee91b 100644 --- a/docs/02-user-guide/01-interface/01-layout-overview.md +++ b/docs/02-user-guide/01-interface/01-layout-overview.md @@ -1,96 +1,113 @@ --- title: 主界面布局 -description: 了解 DesireCore 的三栏式主界面布局结构和各区域职责。 -keywords: [布局, 三栏布局, 界面结构, NavRail, 对话列表, 聊天区域] +description: DesireCore 对话模式主窗口分区：左导航、中间列表、右侧聊天与底栏。 --- # 主界面布局 -DesireCore 采用**单窗口三栏布局**，所有功能都在一个窗口内完成，无需在多个窗口之间切换。 +DesireCore 主窗口为**单窗口四区布局**：左侧窄导航栏、中间智能体/对话列表、右侧主聊天区，以及窗口最底部的状态栏。日常发任务、看回复都在「对话」模式中完成，无需另开窗口。 -对话界面展开右侧工具工作区后，面板顶部会显示一排**工作区标签**。每个标签对应一个文件、终端、网页或审阅页面；点击标签即可切换，也可以新建或关闭标签。它们与左侧的“对话、资源、应用”等功能导航不同：功能导航切换模块，工作区标签切换当前对话里的资源。 +![DesireCore 对话模式主界面：左导航、中间列表、右侧聊天与底栏](/img/user-guide/interface/main-layout-chat.png) -## 布局示意 +对话界面若展开右侧工具工作区，面板顶部会出现一排**工作区标签**（文件、终端、网页、审阅等）。点击标签可切换当前对话里的资源。它们与左侧**功能导航**不同：功能导航切换模块，工作区标签切换本会话内的资源。 -![DesireCore 基础三栏布局示意图（未展开右侧资源工作区）](/img/user-guide/interface/three-column-layout.svg) +## 分区一览 -``` -+--------------------------------------------------------------+ -| +------+--------------+----------------------------------+ | -| | Nav | 对话列表 | 聊天区域 | | -| | Rail | | | | -| | | | 头部（Agent 信息 + 操作按钮） | | -| | 62px | 290px | --------------------------------| | -| | | | 消息列表 | | -| | | | | | -| | | | --------------------------------| | -| | | | 输入区域 | | -| +------+--------------+----------------------------------+ | -+--------------------------------------------------------------+ -``` +| 区域 | 对话模式下的作用 | +|------|------------------| +| 左侧导航栏 | 切换功能模块（当前为「对话」）；底部有通知、设置等入口 | +| 中间列表 | 搜索与选择智能体 / 对话；常见「专业 Agent」等分组 | +| 右侧主区 | 聊天头部、消息流、输入区；可展开文件等工作区 | +| 底栏 | 终端入口、常用快捷键提示、后台任务状态 | -## 三栏职责 +中间栏可折叠；左侧导航栏保持较窄的固定宽度；右侧主区随窗口剩余宽度自适应。各模块入口细节见 [左侧导航栏](./02-navigation-rail.md) 与 [功能入口与操作路径](./07-feature-entry.md)。 -### 左侧：导航栏（NavRail） +## 左侧：导航栏 -宽度固定为 **62px**，是整个应用的功能入口。从上到下依次排列着 Logo、功能导航按钮和底部工具区。详见[左侧导航栏](./02-navigation-rail.md)。 +窗口最左侧是一列图标导航：顶部为头像与模块入口，其中**对话**（气泡）在对话模式下高亮；中段为其他功能入口；底部常见通知铃铛（可带未读角标）与设置等。 -### 中间：内容列表区 +点击左侧其他入口会更换中间栏与右侧主区内容；具体按钮名称与路径以实机为准，见 [左侧导航栏](./02-navigation-rail.md)、[功能入口](./07-feature-entry.md)。通知见 [通知中心](./06-notifications.md)。 -默认宽度 **290px**，根据当前所在的功能模块显示不同内容： +## 中间：智能体 / 对话列表 -| 导航 Tab | 中间栏显示内容 | -|----------|--------------| -| 对话 | 对话列表（按智能体分组） | -| 关系 | 智能体/联系人关系图 | -| 资源 | 资源管理器 | -| 应用 | 应用与插件工作区，按同级页签显示已安装应用或插件 | -| 市场 | 智能体/技能市场 | -| 活动 | 活动记录时间线 | +**对话模式下，中间栏是智能体与对话列表**，不是旧版文档中的「关系 / 资源 / 应用 / 市场 / 活动」矩阵。 -当你处于"对话"Tab 时，这里显示的就是你和所有智能体的对话列表。 +典型结构： -### 右侧：主内容区 +- 顶部：搜索框、「+」新建、列表折叠/展开控件 +- 列表：近期对话（如 DesireCore、通用助手等） +- 分组：**专业 Agent** 等分区下列出专用智能体；每项含名称、最近消息摘要与时间 -占据窗口剩余空间，是你的主工作区域。在对话模式下，这里是聊天区域；切换到其他 Tab 时，会显示对应功能的完整界面。 +选中某一智能体后，右侧主区切换到对应聊天。列表交互详见 [对话列表](./03-conversation-list.md)。 -在对话模式下，右侧工具工作区展开为聊天区旁的面板，面板顶部显示资源标签。打开文件、终端、网页或审阅时，会出现对应的标签；点击标签切换资源，关闭标签时按资源类型处理尚未保存或仍在运行的内容。工作区标签会随会话恢复，重新打开会话时可继续访问已登记的资源。 +## 右侧：聊天主区 + +### 头部 + +左侧显示当前智能体名称与在线状态（如「在线」）；右侧常见 **沉浸式交互** 等操作。点击「沉浸式交互」可进入数字人界面，详见 [数字人界面](./05-digital-avatar.md)。 + +### 消息区 + +消息流中除普通回复外，还常见： + +- **命令执行**折叠条（如「执行了 2 条命令」） +- 附件链接（Markdown / PDF 等） +- **文件编辑卡片**（如「已编辑 1 个文件」），右侧可 **审阅 / 撤销** + +消息与卡片说明见 [聊天区域](./04-chat-area.md)。 + +### 输入区 + +底部输入区用于发消息与附件，大致包括： + +| 控件 | 说明 | +|------|------| +| 文本框 | 占位「输入消息…」；`Enter` 发送，`Shift+Enter` 换行 | +| 附件 / 工具入口 | 「+」、图片等（以实机图标为准） | +| 审批 / 放行 | 如「全部放行 · 无限制」（具体选项随策略变化） | +| 工作目录 | 显示当前目录（路径过长时截断） | +| 模型 | 当前模型名（截图示例为 DeepSeek V4.1） | +| 麦克风 / 发送 | 语音与发送按钮 | + +行首输入 `/` 可调出斜杠命令；快捷键提示也在底栏可见。发送与附件细节见 [发送消息](../02-conversations/01-sending-messages.md)。 + +## 底栏 + +窗口最底部为状态栏： + +- **左侧**：终端入口（「终端」） +- **中部**：快捷键提示，如 `/ 命令`、`Enter` 发送、`Shift+Enter` 换行 +- **右侧**：连接与后台状态（如「无后台任务」） ## 文件工作区 -打开文件标签后，在内容区点击「文件操作」浮动按钮，查看当前格式支持的操作。Markdown、超级文书、代码、PDF 和画板使用同一入口，具体编辑和预览能力因格式而异。 +打开文件标签后，在内容区使用「文件操作」入口查看当前格式支持的操作。Markdown、超级文书、代码、PDF、画板共用该入口，编辑与预览能力因格式而异。 | 需要做什么 | 操作或界面表现 | |---|---| -| 查看文档目录、任务关联或文件动作 | 打开「文件操作」，选择当前格式提供的操作 | +| 查看目录、任务关联或文件动作 | 打开「文件操作」，选当前格式提供的项 | | 定位文档章节 | 展开默认收起的目录 | | 翻阅 PDF | 使用预览中的分页导航 | | 用键盘操作菜单 | 聚焦入口并打开菜单；关闭后焦点返回入口 | -| 在窄面板中切换标签 | 当前标签会自动滚动到可见位置；文件操作不占用标签栏宽度 | +| 在窄面板中切换标签 | 当前标签会滚入可见区；文件操作不占标签栏宽度 | ### 终端接回后的输出提示 -应用重启后接回终端，如果离线期间的输出超出保留上限，当前终端标签会显示「接回时有输出被省略」，并注明省略的字节数。此时回放的内容不完整。查看提示后，可点击「知道了」关闭。 +应用重启后接回终端，若离线期间输出超出保留上限，当前终端标签会提示「接回时有输出被省略」并注明省略字节数。回放内容可能不完整；确认后可关闭提示。 ## 响应式行为 -DesireCore 会根据窗口大小自动调整布局： - -- **导航栏**始终保持 62px 宽度 -- **对话列表**在窗口较窄时可以折叠 -- **聊天区域**自适应剩余宽度 -- 窗口最小尺寸为 **960 x 640 像素** -- 聊天头部在窗口宽度不足 640px 时进入紧凑模式（compact mode），部分按钮会收入"更多"菜单 - -:::info 翻转视图 -在对话界面中，点击头部的"沉浸式交互"按钮可以翻转到数字人界面（Digital Human），这是一个独立的 3D 交互视图。翻转动画约 1 秒，背景色会随之切换。详见[数字人界面](./05-digital-avatar.md)。 -::: +- 左侧导航栏较窄、宽度基本固定 +- 中间列表可在窗口变窄时折叠，给主区腾空间 +- 右侧聊天区占用剩余宽度 +- 窗口过窄时，聊天头部部分按钮可能收入「更多」类菜单 -## 设计风格 +最小可用窗口尺寸与紧凑模式阈值可能随版本调整，以实机为准。 -DesireCore 的界面采用 **Liquid Glass** 设计语言，你会注意到以下视觉特征： +## 相关页面 -- **半透明玻璃材质**：面板和卡片带有高斯模糊效果，背景色彩隐约可见 -- **精细边框**：面板之间使用 0.5px 的细分隔线 -- **高光反射**：部分元素顶部有微妙的光泽效果 -- **柔和阴影**：多层阴影营造出悬浮感 +- [左侧导航栏](./02-navigation-rail.md) +- [对话列表](./03-conversation-list.md) +- [聊天区域](./04-chat-area.md) +- [数字人界面](./05-digital-avatar.md) +- [功能入口与操作路径](./07-feature-entry.md) diff --git a/docs/02-user-guide/01-interface/07-feature-entry.md b/docs/02-user-guide/01-interface/07-feature-entry.md index f0e460c..e74aeed 100644 --- a/docs/02-user-guide/01-interface/07-feature-entry.md +++ b/docs/02-user-guide/01-interface/07-feature-entry.md @@ -1,435 +1,128 @@ ---- -title: 功能入口与操作路径 -description: 快速了解 DesireCore 的三大功能区域（对话界面、资源管理器、应用与服务）及常用操作路径。 -keywords: [功能入口, 操作路径, 对话界面, 资源管理器, 应用与服务, 新手引导] ---- - # 功能入口与操作路径 -按任务查找入口。对话界面用于发送任务和查看结果；资源管理器用于管理智能体、技能等资源；应用与服务用于安装应用和接入服务。 - -| 我想做什么 | 从哪里进入 | 最短操作路径 | -| -------- | ----- | --------------------------------- | -| 和智能体开始对话 | 对话界面 | 左侧选择智能体 → 底部输入任务 → 查看回复 | -| 查找历史对话 | 对话界面 | 左侧列表或搜索框 → 点击历史对话 | -| 切换文件、终端或网页 | 工作区标签 | 打开右侧工作区 → 点击资源标签；见[主界面布局](./01-layout-overview.md) | -| 审阅文档修改 | 文档内容区 | 展开待审阅计数 → 接受或拒绝修改；见[逐条审阅](../05-super-document/04-review-changes.md) | -| 调用快捷命令 | 对话界面 | 输入框输入 `/` → 选择命令 → 发送 | -| 管理智能体 | 资源管理器 | 左侧“文件夹”图标 → 智能体 | -| 导入或配置技能 | 资源管理器 | 左侧“文件夹”图标 → 技能 → 导入或配置 | -| 查看自动化任务 | 资源管理器 | 左侧“文件夹”图标 → 自动化 | -| 安装应用 | 应用与服务 | 左侧“四宫格”图标 → 应用 → 安装 | -| 接入外部服务 | 应用与服务 | 左侧“四宫格”图标 → 服务 → 选择 HTTP / MCP 服务 | - -![对话界面操作路径示意图](/img/user-guide/feature-entry/main1.png) - -## 一、对话界面的三个区域 - -下图中的 ①、②、③ 分别对应选择智能体、查看结果和发送消息。 - -| 编号 | 区域名称 | 作用 | -| -- | -------- | ------------------------ | -| ① | 智能体与对话列表 | 选择要沟通的智能体，查看历史对话和最近消息 | -| ② | 聊天记录区 | 查看智能体回复、任务执行过程、报告结果和展开内容 | -| ③ | 输入与命令区 | 输入消息、发送任务、上传附件或使用斜杠命令 | - -选择智能体后，在底部输入区发送消息；回复和执行提示会显示在聊天记录区。 - -### ① 智能体与对话列表 - -左侧列表用于选择不同的智能体或历史对话。每一行代表一个智能体或一个对话入口。 - -| 元素 | 说明 | -| ----- | ---------------------------------------- | -| 搜索框 | 输入关键词，查找智能体或历史对话 | -| 加号 | 新建对话或添加新的入口 | -| 智能体头像 | 用颜色和文字区分不同智能体 | -| 智能体名称 | 显示当前可选择的专业智能体，例如 DesireCore、数据分析师、网站生成助手 | -| 绿色状态点 | 显示智能体的状态提示；任务是否完成以回复和执行回执为准 | -| 最近消息 | 显示该智能体最近一次回复或任务摘要 | -| 时间 | 显示最近一次对话或更新的时间 | - -使用方法： - -1. 在左侧列表中找到需要使用的智能体。 -2. 点击智能体名称或对话卡片。 -3. 右侧会切换到对应的聊天页面。 -4. 如果列表较长，可以使用顶部搜索框快速查找。 - -手动多会话模式下，从 Project 行点击「新建会话」，或使用项目选择器选择项目。会话保存、归档和目录设置见[管理对话](../02-conversations/06-managing-conversations.md)。 - -示例： - -| 想做什么 | 可以选择 | -| --------------- | ---------- | -| 让系统分配任务或协调多个智能体 | DesireCore | -| 分析表格、生成图表或报告 | 数据分析师 | -| 生成网站或页面 | 网站生成助手 | -| 识别票据图片 | 票据 OCR 助手 | -| 抓取网页内容 | 网页采集专家 | -| 发送提醒或通知 | 消息通知助手 | - -### ② 对话结果区 - -右侧上方是对话结果区，用于展示智能体的回复内容、任务过程和结果报告。 - -| 元素 | 说明 | -| ---- | --------------------- | -| 消息卡片 | 展示智能体返回的回复、提醒、报告或任务结果 | -| 标题 | 显示本次回复的主题，例如“心跳检查” | -| 摘要内容 | 展示关键结论、评分、状态或说明 | -| 展开全部 | 卡片提供此按钮时，展开被折叠的内容 | -| 历史记录 | 按时间顺序保留之前的对话和执行过程 | - -查看回复中的任务名称、结果和异常提示。若卡片提供「展开全部」按钮，可点击查看折叠内容。 - -常见结果类型： - -| 类型 | 说明 | -| ---- | --------------------------- | -| 普通回复 | 智能体对问题的直接回答 | -| 执行过程 | 展示任务正在处理、检查或生成的过程 | -| 结果报告 | 展示分析报告、检查结果、表格或总结 | -| 异常提示 | 当任务失败或信息不足时，说明原因和下一步需要补充的内容 | -| 操作回执 | 说明任务是否完成、是否等待确认或是否需要继续操作 | - -创作文档导出： - -当智能体完成文档创作、报告整理或内容生成后，可以在结果卡片中使用导出入口，将文档保存为不同格式，方便后续编辑、分享或归档。 - -| 导出格式 | 适合场景 | -| -------- | --------------------- | -| Markdown | 适合继续在文档系统、知识库或代码仓库中维护 | -| PDF | 适合正式分享、归档或发送给外部人员阅读 | -| Word | 适合继续编辑、批注或进行多人协作修改 | - -下面的动图演示了创作文档完成后，从结果卡片中选择导出格式并保存文件的过程。 - -![创作文档导出](/img/user-guide/feature-entry/20260610-173817.gif) - -阅读建议： - -1. 先看标题，确认这条消息属于哪个任务。 -2. 再看摘要，快速判断结果是否正常。 -3. 如果卡片提供「展开全部」按钮，点击查看折叠内容。 -4. 如果智能体要求补充信息，可以在底部输入区继续回复。 - -### ③ 输入与命令区 - -底部是输入与命令区，用于向智能体发送消息、上传内容或调用快捷命令。 - -| 图标 / 元素 | 说明 | -| ------- | -------------- | -| 加号 | 添加附件或打开更多输入工具 | -| 图片图标 | 上传图片，让智能体识别或处理 | -| 剪刀图标 | 截图、剪裁或截取内容 | -| 输入框 | 输入问题、任务要求或补充说明 | -| 纸飞机按钮 | 发送当前消息 | -| `/` 命令 | 输入斜杠后显示可用命令列表 | - -截图中输入框里输入了 `/`，因此系统显示了可用命令列表。常见命令包括： - -| 命令 | 作用 | -| ---------- | ------------------------------ | -| `/skill` | 调用指定技能 | -| `/new` | 开始一段全新对话，和之前的对话互不影响 | -| `/compact` | 精简聊天记录，保留重要信息，释放空间 | -| `/steer` | 在智能体执行任务中途补充指导或约束，注入到下一轮思考与行动中 | -| `/help` | 显示帮助信息 | - -基础操作步骤： - -1. 在输入框中输入你的问题或任务。 -2. 如果需要上传图片，点击图片图标。 -3. 如果需要使用命令，先输入 `/`，再选择对应命令。 -4. 点击右侧纸飞机按钮发送。 -5. 等待智能体在 ② 区域返回结果。 - -示例： - -```text -帮我检查这份报告有没有遗漏重点。 -``` - -```text -帮我把这张票据图片识别成表格。 -``` - -```text -/help -``` - -## 二、入门使用示例 - -如果你想和某个智能体开始对话，可以按照以下步骤操作： - -1. 在 ① 区域选择一个智能体，例如 DesireCore 或数据分析师。 -2. 在 ③ 区域输入你的问题或任务。 -3. 点击纸飞机按钮发送消息。 -4. 在 ② 区域查看智能体回复、任务进度或生成结果。 -5. 如果结果不完整，可以继续在 ③ 区域补充要求。 - -**记忆要点** - -初次使用时，只需要记住图中的三个位置： - -| 位置 | 用途 | -| -- | ----------- | -| ① | 选智能体或历史对话 | -| ② | 看回复、任务结果和报告 | -| ③ | 发消息、传文件、用命令 | - -掌握这三个区域后，就可以完成大部分基础对话和任务操作。 - -完成一次基础对话后，可以用下面几个标志判断操作是否成功： - -| 成功标志 | 说明 | -| ------------------- | ------------------ | -| 右侧出现新的消息卡片 | 说明消息已经发送并进入处理流程 | -| 消息卡片中有摘要、结果或操作回执 | 说明智能体已经返回可读结果 | -| 可以继续追问或补充要求 | 说明当前对话仍然可继续推进 | -| 如果任务需要更多信息，系统会提示你补充 | 说明任务没有失败，只是需要进一步输入 | - -## 三、资源管理器 - -资源管理器用于集中查看和管理 DesireCore 中的各类资源，包括智能体、技能、自动化任务、工作流、算力服务、邮箱、存储和代码仓库等。 - -![资源管理器示意图](/img/user-guide/feature-entry/resource-manager.png) - -点击左侧导航栏中的“文件夹”图标，进入到“资源管理器”页面。 - -资源管理器和“应用与服务”的区别可以这样理解： - -| 模块 | 主要作用 | 什么时候用 | -| ----- | ------------- | ---------------------------- | -| 资源管理器 | 管理已经在系统里的资源 | 查看、配置、启用、分配智能体、技能、自动化、工作流等 | -| 应用与服务 | 添加新的应用或接入外部服务 | 安装应用、连接 API、接入 MCP / HTTP 服务 | - -资源管理器页面中的 1 到 8 分别代表以下功能： - -| 编号 | 功能名称 | 作用 | -| -- | -------------- | ----------------------------------- | -| ① | 智能体 Agents | 查看和管理当前系统中的智能体，包括在线状态、最近活跃智能体和智能体数量 | -| ② | 技能 Skills | 查看已启用的技能和工具能力，例如创建智能体、删除智能体、头脑风暴等 | -| ③ | 自动化 Automation | 查看和管理定时任务、周期任务和自动触发的任务 | -| ④ | 工作流 Workflows | 查看和管理工作流，用于把多个步骤编排成可重复执行的流程 | -| ⑤ | 算力 Compute | 查看可用的 AI 服务、模型服务或基础算力资源 | -| ⑥ | 邮箱 Emails | 查看已连接的邮箱账号，用于邮件同步、发送或相关自动化任务 | -| ⑦ | 存储 Storage | 查看和管理存储连接，用于文件保存、读取或外部存储接入 | -| ⑧ | 代码托管 / 代码仓库 | 查看已连接的代码仓库，例如 GitHub 仓库，用于代码相关任务 | - -### ① 智能体 - -“智能体”卡片展示当前系统中可用的 Agent。用户可以在这里查看智能体数量、在线状态，以及最近活跃的智能体。 - -适合场景： - -| 场景 | 说明 | -| ------- | ------------------ | -| 找专业助手 | 查看当前有哪些智能体可以使用 | -| 判断是否在线 | 查看状态点提示；发送任务后检查执行状态和回执 | -| 进入智能体管理 | 点击卡片或箭头进入更详细的智能体列表 | - -### ② 技能 - -“技能”卡片展示系统已经启用的能力。技能可以理解为智能体能调用的工具或操作能力。 - -常见技能包括： - -| 技能类型 | 作用 | -| ------- | -------------- | -| 创建智能体 | 根据需求创建新的专业智能体 | -| 删除智能体 | 删除不再需要的智能体 | -| 头脑风暴 | 辅助生成思路、方案或创意 | -| 文件与数据处理 | 帮助读取、整理或生成文件内容 | - -技能导入常见方式： - -| 导入方式 | 操作说明 | -| ------ | -------------------------- | -| 本地文件导入 | 点击技能页面中的导入入口，选择本地技能文件并确认导入 | -| 从链接导入 | 粘贴技能包或技能配置的访问链接，系统读取后完成导入 | -| 从资源库导入 | 在技能资源库中搜索或选择已有技能，点击添加或导入 | -| 对话中导入 | 在对话中说明需要导入的技能，由智能体根据指令协助完成 | - -导入后，可以在技能列表中查看新技能，并根据需要启用、配置或分配给对应智能体。 - -判断技能导入是否成功，可以看以下几个位置： - -| 成功标志 | 说明 | -| ----------------------- | -------------- | -| 技能列表中出现新技能 | 说明技能已经进入系统 | -| 技能状态显示为可用或已启用 | 说明技能可以被调用 | -| 可以在对话中通过 `/skill` 找到该技能 | 说明技能已经进入可调用范围 | -| 可以分配给指定智能体 | 说明技能可以参与后续任务执行 | - -下面的动图演示了从技能页面进入导入入口、选择导入方式并完成导入的过程。 - -![技能导入](/img/user-guide/feature-entry/skill-import.gif) - -### ③ 自动化 - -“自动化”卡片用于查看已经设置的定时任务或周期任务。截图中显示有一个“每日发票自动识别任务”，表示系统会在指定时间自动执行。 - -适合场景： - -| 场景 | 示例 | -| ---- | ----------------- | -| 定时提醒 | 每天早上 9 点提醒开会 | -| 周期执行 | 每天自动识别发票 | -| 定期检查 | 每隔一段时间检查系统状态或数据变化 | - -### ④ 工作流 - -“工作流”用于把多个步骤组合成一个可重复执行的流程。适合处理固定流程、多步骤任务或需要多个智能体协作的工作。 - -示例： - -```text -收集网页资料 → 整理表格 → 生成报告 → 发送邮件 -``` - -如果当前没有工作流，页面会显示暂无工作流。后续可以在对话中通过 AI 创建和管理工作流。 - -### ⑤ 算力 - -“算力”卡片展示当前可用的 AI 服务或模型资源，例如 DeepSeek、Kimi、MiniMax Coding Plan 等。 - -用户通常不需要手动配置算力。只有在需要切换模型、调整能力来源或查看服务状态时，才需要进入这个区域。 - -### ⑥ 邮箱 - -“邮箱”卡片展示已经连接的邮箱账号。连接邮箱后，系统可以配合智能体完成邮件相关任务。 - -适合场景： - -| 场景 | 说明 | -| ----- | ------------- | -| 邮件通知 | 通过邮箱发送任务结果或提醒 | -| 邮件同步 | 读取或同步指定邮箱内容 | -| 邮件自动化 | 配合自动化任务定期处理邮件 | - -### ⑦ 存储 - -“存储”卡片用于管理文件存储连接。如果连接了外部存储，系统可以读取、保存或同步相关文件。 - -适合场景： - -| 场景 | 说明 | -| ------ | ---------------- | -| 保存任务结果 | 将报告、表格或图片保存到指定位置 | -| 读取资料 | 从存储中读取文件供智能体处理 | -| 连接外部空间 | 接入云存储或其他文件系统 | - -### ⑧ 代码托管 - -“代码托管”卡片展示已经连接的代码仓库，例如 GitHub。连接后，智能体可以辅助处理代码、仓库文件和开发任务。 - -适合场景： - -| 场景 | 说明 | -| ------ | -------------------- | -| 查看仓库连接 | 确认 GitHub 等代码平台是否已连接 | -| 处理代码任务 | 让智能体读取、分析或修改代码 | -| 项目协作 | 配合网站生成、自动化或工作流任务使用 | - -新手使用资源管理器时，可以先重点关注三个入口：智能体、技能和自动化。智能体决定“谁来做”，技能决定“能做什么”，自动化决定“什么时候做”。 - -## 四、应用与服务 - -“应用与服务”是独立的功能模块，用于集中管理可安装的应用和可连接的服务。它把常用能力分成两类：一类是可以直接安装和使用的应用，另一类是可以接入系统的外部服务。 - -![应用与服务示意图](/img/user-guide/feature-entry/app-service.png) - -进入方式： - -1. 点击左侧导航栏中的“四宫格”图标。 -2. 进入“应用与服务”页面。 -3. 通过顶部分类标签或搜索框查找目标应用或服务。 - -页面中的两个重点区域： - -| 编号 | 区域 | 作用 | -| -- | -- | ---------------------------------------------------- | -| ① | 应用 | 展示可安装或可使用的应用，例如 AnythingLLM、Coze、Dify、LobeChat、n8n 等 | -| ② | 服务 | 展示可接入的服务，例如地图 API、数据库 MCP、HTTP 服务等 | - -顶部分类标签用于快速筛选不同类型的资源： - -| 标签 | 说明 | -| ------- | ------------- | -| 全部 | 查看所有应用与服务 | -| AI 平台 | 只看 AI 平台类应用 | -| RAG | 只看与知识库检索相关的应用 | -| 工作流 | 只看工作流类应用 | -| 工具 | 只看工具类应用 | -| 对话 | 只看对话类应用 | -| MCP 服务 | 只看 MCP 接入服务 | -| HTTP 服务 | 只看 HTTP 接入服务 | - -选择应用或服务时，可以先用下面的判断方式： - -| 需求 | 优先查看 | -| --------------------------- | -------------------- | -| 想直接使用一个完整工具 | 应用 | -| 想让智能体获得外部能力 | 服务 | -| 想搭建知识库、RAG 或工作流 | 应用中的 AI 平台、RAG、工作流分类 | -| 想连接地图、数据库、HTTP API 或 MCP 工具 | 服务中的 HTTP 服务、MCP 服务 | - -### ① 应用 - -应用区展示的是可以直接安装或使用的成品能力。每张卡片通常包含名称、简介、分类标签和安装按钮。 - -常见示例： - -| 应用 | 说明 | -| ----------- | -------------------------------- | -| AnythingLLM | 全能型 AI 桌面应用，支持 RAG、Agent 和文档对话 | -| Coze | 字节跳动 AI Bot 开发平台 | -| Dify | 开源 AI 应用开发平台，支持 RAG、Agent 和工作流编排 | -| LobeChat | 开源多 Agent 协作工作空间 | -| n8n | 可视化工作流自动化平台 | -| Open WebUI | 自托管 AI 对话界面 | -| OpenClaw | 开源个人 AI 助手，支持多渠道网关和本地优先架构 | -| RagFlow | 基于深度文档理解的开源 RAG 引擎 | - -使用建议： - -| 场景 | 说明 | -| ----------- | ------------------------------ | -| 想快速试用某个现成工具 | 直接查看应用卡片并安装 | -| 想判断应用类型 | 看卡片上的标签，例如 AI 平台、工具、对话、工作流、RAG | -| 想找可替代方案 | 通过搜索和分类标签对比不同应用 | - -### ② 服务 - -服务区展示的是可以接入系统的外部能力，例如地图接口、数据库服务、MCP 服务或 HTTP 服务。 - -常见示例： - -| 服务 | 说明 | -| ------------ | ------------------------- | -| 百度地图 API | 提供地理位置、路线规划和 POI 搜索能力 | -| Database MCP | 提供 PostgreSQL 等数据库查询和管理能力 | - -服务区常见标识： - -| 标识 | 说明 | -| ------- | --------------- | -| HTTP | 通过 HTTP 接入的服务 | -| MCP | 通过 MCP 协议接入的服务 | -| 注册表 | 通过注册表方式管理或发现的服务 | -| 在线 / 离线 | 显示服务当前是否可用 | - -新手可以先这样理解：应用更像“可以直接用的软件”，服务更像“可以接到系统里的能力接口”。如果你想扩展系统功能，先看应用区；如果你想让智能体连接外部能力，重点看服务区。 - -## 五、常见问题 - -| 问题 | 可以怎么处理 | -| ---------------- | ------------------------------------------ | -| 左侧找不到想用的智能体 | 先使用搜索框查找；如果仍然没有，进入资源管理器的“智能体”查看是否已创建或启用 | -| 输入 `/` 后没有出现命令列表 | 确认光标在输入框内，重新输入 `/`；如果仍然没有出现，可以尝试使用 `/help` | -| 技能导入后找不到 | 回到资源管理器的“技能”列表检查是否导入成功，并确认技能是否已启用 | -| 应用安装后不知道从哪里打开 | 回到“应用与服务”的应用区，查看应用卡片上的打开、启动或管理入口 | -| 服务显示离线 | 检查服务配置、网络连接、API Key 或 MCP / HTTP 服务地址是否正确 | -| 智能体返回结果不完整 | 在同一对话中继续补充要求，或使用更明确的目标、文件和输出格式描述 | +本页只回答一件事：**我想做某件事，该从哪进、最短怎么走。** +界面分区、按钮说明见 [主界面布局](./01-layout-overview.md) 和 [左侧导航栏](./02-navigation-rail.md)。 + +左侧主导航（自上而下，文案以实机 / zh-CN 为准）： + +| 入口 | 用来做什么 | +| --- | --- | +| 头像（顶部） | 打开个人资料；游客模式提示 | +| 对话 | 选智能体、发任务、看回复 | +| 全局任务板 | 能力开启时固定出现在对话下方（内置应用，非旧「关系」Tab） | +| 资源管理器 | 管理已有智能体、技能、自动化、服务、提示词等 | +| 市场 | 浏览并安装数字员工、团队、技能、应用或服务（插件经「产品类型」筛选） | +| 应用 | 「应用」与「插件」两个页签：打开应用、管理插件（工作区标题为「应用与插件」） | +| 自定义应用钉选 | 主导航中段可钉常用应用；可从「我的应用」拖入 | +| 通知（底部） | 通知中心 | +| 运行中心（底部） | 合并原「活动」与「任务管理器」：任务 / 活动 / 系统 / 诊断 | +| 更多（底部菜单） | 设置、资料 / 登录、钱包与算力（按登录态显示） | + +:::note 已迁出主导航的入口 +- **智能体社会化关系**（旧称「关系」）：不再是固定 NavRail Tab，而是内置应用「agent-society」，从「应用」或钉选进入。 +- **设置**：不在主导航底部单独齿轮位，而在「更多」菜单中。 +::: + +## 按任务找入口 + +| 我想做什么 | 从哪里进入 | 最短路径 | +| --- | --- | --- | +| 和智能体开始对话 | 对话 | 左侧选智能体 → 底部输入 → 发送；见 [发送消息](../02-conversations/01-sending-messages.md) | +| 查找或管理历史对话 | 对话 | 列表或搜索 → 点开对话；归档等见 [管理对话](../02-conversations/06-managing-conversations.md) | +| 调用斜杠命令 | 对话 | 输入框行首输入 `/` → 选命令 → 发送（内置：`/skill` `/new` `/compact` `/reset` `/recall` `/rewind` `/steer` `/subtask` `/help`；另有 `/skill:…` 与 `/技能名`） | +| 切换文件、终端或网页 | 工作区 / 资源 | 对话右侧工作区切标签；或「资源管理器 → 文件」进文件工作台；见 [主界面布局](./01-layout-overview.md) | +| 审阅文档修改 | 文档内容区 | 展开待审阅 → 接受或拒绝；见 [逐条审阅](../05-super-document/04-review-changes.md) | +| 管理智能体 | 资源 | 导航「资源管理器」→ 智能体；见 [智能体](../06-agents/01-agent-types.md) | +| 编辑系统提示词 | 资源 | 资源 → 提示词（全局 / 团队 / 智能体） | +| 导入或配置技能 | 资源 / 市场 | 已有技能：资源 → 技能；获取新技能：市场 → 技能；见 [技能管理](../06-agents/07-skills-management.md) | +| 查看或设置自动化 | 资源 | 资源 → 自动化；见 [自动化](../08-automation/) | +| 管理服务连接与诊断 | 资源 | 资源 → 服务；见 [应用、插件与服务](../09-capabilities/09-app-service-catalog.md) | +| 打开已安装应用 | 应用 | 导航「应用」→「应用」页签 → 打开 | +| 启用或配置插件 | 应用 | 导航「应用」→「插件」页签 → 启停与配置；可用页内市场按钮发现插件 | +| 安装新的应用 / 插件 / 智能体 | 市场 | 导航「市场」→ 选类型（数字员工 / 团队 / 技能 / 应用 / 服务）→ 安装；插件：市场筛「产品类型：插件」或从插件页「市场」按钮进入 | +| 查看执行与后台任务 | 运行中心 | 导航栏底部「运行中心」→ 任务 / 活动 / 系统 / 诊断 | +| 看智能体协作关系 | 应用（内置） | 「应用」中打开「智能体社会化关系」，或钉到主导航 | +| 打开全局任务板 | 主导航 | 能力开启时主导航「全局任务板」；否则从应用能力入口启用 | +| 改主题、模型算力、快捷键等 | 设置 | 导航栏底部「更多」→ 设置 | +| 切换实例 | 实例选择器 / 设置 | 启动时的实例选择器，或设置 → 连接相关项 | + +![对话界面示意](/img/user-guide/feature-entry/main1.png) + +## 对话：发任务与看结果 + +对话页分三块（与上图对应）： + +| 区域 | 作用 | +| --- | --- | +| 左侧列表 | 选智能体或历史对话；可用搜索 | +| 中间记录区 | 看回复、执行过程、结果卡片 | +| 底部输入区 | 发消息、附件、斜杠命令 | + +日常路径：左侧选人 → 底部说明任务 → 在记录区看结果；不够就接着补充。 +列表细节见 [对话列表](./03-conversation-list.md)，消息与卡片见 [聊天区域](./04-chat-area.md)。 + +## 资源：管已经在系统里的东西 + +点导航「资源管理器」（Boxes 图标）进入资源选择器。这里管的是**已经装好或接好的资源**，不是去商店逛新东西。 + +常见卡片（名称以界面为准；邮箱 / 对象存储 / 工作流可能受能力或部署开关影响而不显示）： + +| 卡片 | 典型用途 | +| --- | --- | +| 智能体 | 查看、进入管理 | +| 提示词 | 全局 / 团队 / 智能体三层系统提示词 | +| 应用 | 已安装应用实例、健康与生命周期 | +| 服务 | MCP / HTTP 等已接入服务与审批 | +| 文件 | 文件工作台（工作目录、编辑与预览） | +| 技能 | 查看、导入、启用、分配 | +| 自动化 | 定时 / Webhook / 心跳 | +| 工作流 | 多步骤流程（部署启用时） | +| 算力 | 模型与算力来源 | +| 账号 | 站点账号与取值授权 | +| 邮箱 | 已连接邮箱（能力开启时） | +| 存储 | 对象存储连接（能力开启时） | +| 代码托管 | 已连接的代码托管 | + +![资源管理器示意](/img/user-guide/feature-entry/resource-manager.png) + +和「应用 / 市场」怎么分： + +| 我要… | 去哪 | +| --- | --- | +| 配置、启用、排查已有资源 | 资源管理器 | +| 打开已装应用，或管插件贡献 | 应用（两个页签；标题「应用与插件」） | +| 发现并安装新能力 | 市场 | + +## 应用、插件与市场 + +- **应用**页签：打开、整理已安装的独立应用。 +- **插件**页签：看接入状态，启用或停用贡献，改配置；可用市场按钮跳转并筛「产品类型：插件」。 +- **市场**：主分类为数字员工、团队、技能、应用、服务；插件不是顶层分类，而是应用类下的产品类型筛选。 + +安装不等于已授权调用；服务是否可调，仍以资源里的连接、审批和当前智能体权限为准。细则见 [应用、插件与服务](../09-capabilities/09-app-service-catalog.md)。 + +![应用与插件示意](/img/user-guide/feature-entry/app-service.png) + +:::note 截图 +配图文件名与部分旧文案可能仍写「应用与服务」或含已迁出主导航的「关系 / 活动」图标。工作区现行标题为「应用与插件」；底部入口为「运行中心」。请以实机为准，并择机更换本页配图。 +::: + +## 常见问题 + +| 问题 | 怎么处理 | +| --- | --- | +| 左侧找不到某个智能体 | 先在对话列表搜索；仍没有则到「资源 → 智能体」看是否已创建或启用，或到市场安装 | +| 输入 `/` 没有命令列表 | 确认光标在输入框**行首**再输入 `/`；仍没有可试 `/help`，并以当前版本列表为准 | +| 技能导入后找不到 | 「资源 → 技能」核对是否导入成功、是否启用；对话里也可用 `/skill` 查找 | +| 应用装完不知道从哪打开 | 「应用 → 应用」页签；插件则在「插件」页签；也可钉到主导航 | +| 服务显示在线但智能体调不了 | 在线 ≠ 当前智能体有权；查资源里的服务连接、审批与工具范围 | +| 想装新东西却在资源里找 | 获取走「市场」；资源只管理已有项 | +| 找不到「关系」或「活动」Tab | 「关系」已改为内置应用「智能体社会化关系」；「活动」已并入底部「运行中心」 | +| 找不到设置齿轮 | 底部「更多」→ 设置 | + +## 相关文档 + +- [左侧导航栏](./02-navigation-rail.md) — 每个 Tab 的职责 +- [应用、插件与服务](../09-capabilities/09-app-service-catalog.md) — 安装、启停、审批与排障 +- [技能管理](../06-agents/07-skills-management.md) / [技能包](../09-capabilities/04-skill-packs.md) +- [管理对话](../02-conversations/06-managing-conversations.md) diff --git a/static/img/user-guide/interface/main-layout-chat.png b/static/img/user-guide/interface/main-layout-chat.png new file mode 100644 index 0000000..15aa076 Binary files /dev/null and b/static/img/user-guide/interface/main-layout-chat.png differ