Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion docs/02-user-guide/01-interface/04-chat-area.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜
| **资源管理** | 管理智能体的文件和资源 |
| **运行状态** | 查看当前运行中的任务和历史话题 |
| **发布/API** | 发布智能体或查看 API 接入信息 |
| **更多** | 展开更多操作(聊天记录、清除历史、删除智能体等) |
| **更多** | 展开更多操作(聊天记录、导出、多选、上下文压缩、Rewind、清除历史、删除智能体等) |

:::info 紧凑模式
当聊天区域宽度不足 640px 时,中间的按钮会自动收入"更多"菜单,只保留"更多"按钮,避免界面拥挤。
Expand Down Expand Up @@ -94,6 +94,10 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜

- **工作流卡片**(绿色边框):展示任务执行步骤和进度
- **行动回执卡片**(绿/橙/蓝边框):展示操作结果(成功/警告/待处理)
- **问答卡片**:智能体需要你补充信息或做选择时展示
- **审批卡片**:高风险操作执行前请求你的确认
- **任务板**:长任务拆分后的子任务、状态和进度
- **图表预览**:Mermaid、draw.io 等图表的预览和全屏查看
- **教学卡片**(紫色边框):展示你教给智能体的规则
- **已学习卡片**(紫色边框):确认智能体已学会的内容
- **委派卡片**(蓝色边框):展示任务在不同智能体之间的流转
Expand All @@ -111,6 +115,7 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜
- 自动伸缩的文本框,最小一行,最大高度 120px
- 聚焦时边框变为绿色并带外发光效果
- 支持多行输入
- 空闲时可能显示下一条消息预测,点击、`Tab` 或 `→` 可采纳

### 左侧按钮

Expand Down Expand Up @@ -150,9 +155,23 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜
- 点击图片按钮选择文件
- 直接将图片**粘贴**到输入框(Ctrl/Cmd + V)
- 将图片**拖拽**到输入区域
- 将文件或文件夹拖到整个聊天区,高亮后松手添加为附件或工作目录引用

已附加的图片会以缩略图展示在输入框上方,悬停可删除,点击可预览大图。

:::warning 文件引用 vs 图片上传
"+" 按钮添加的文件是**路径引用**——只告诉智能体文件在哪里;图片按钮是**真正上传**——智能体能看到图片内容。
:::

## 消息操作栏

悬停消息时会显示操作栏。窄屏下操作栏会收起为图标,避免文字逐字换行。

常见操作包括:

- 复制纯文本或复制 Markdown
- 重试上一轮回复
- 编辑用户消息,包括增删图片附件
- 朗读消息
- 多选消息并导出
- 从某条用户消息前执行 Rewind
6 changes: 4 additions & 2 deletions docs/02-user-guide/01-interface/06-notifications.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,21 +38,23 @@ keywords: [通知中心, 通知, 未读, 消息提醒, NotificationCenter]

## 通知类型

通知分为三个类别
通知分为多个类别

| 类别 | 说明 | 示例 |
|------|------|------|
| **消息** | 来自智能体的对话消息通知 | "法律助手向你发送了合同审查结果" |
| **系统** | 系统级别的通知 | "DesireCore 已更新到 v2.1.0" |
| **任务** | 任务执行相关的通知 | "数据分析报告生成完成" |
| **审批** | 高风险操作或服务权限请求 | "邮件发送前需要你确认" |

每种类型有独特的图标和颜色标识,方便快速区分。
每种类型有独特的图标和颜色标识,方便快速区分。审批通知会显示 pending、approved、rejected、timeout 等状态,并支持在通知中心内直接批准或拒绝。

## 通知管理

### 查看通知

- 点击通知项可标记为已读,并跳转到相关内容
- 支持 Markdown 预览的通知会保留标题、列表和链接
- 未读通知有浅色高亮背景,已读通知为普通背景

### 批量操作
Expand Down
47 changes: 38 additions & 9 deletions docs/02-user-guide/02-conversations/01-sending-messages.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,14 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片

1. **点击图片按钮** --- 输入框左侧的图片图标,点击后打开系统文件选择器,支持选择多张图片
2. **粘贴图片** --- 直接在输入框中使用 `Ctrl/Cmd + V` 粘贴剪贴板中的图片
3. **拖拽图片** --- 将图片文件拖拽到输入框区域
3. **拖拽图片** --- 将图片文件拖拽到输入框区域,或拖到整个聊天区域出现高亮后松手

上传后的图片会以缩略图形式显示在输入框上方。你可以:

- 点击缩略图查看大图预览
- 悬停在缩略图上,点击右上角的关闭按钮移除图片
- 发送前查看上传进度和压缩后的文件大小
- 编辑已发送的用户消息时,删除原有图片或追加新图片

:::info 支持的图片格式
支持常见的图片格式,包括 JPEG、PNG、WebP、GIF 等。图片会以 Base64 编码发送给 AI 模型进行视觉理解。
Expand All @@ -62,6 +64,26 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片
「文件引用」只是告诉 Companion 你引用了哪个文件的路径,Companion 会自行读取。而「图片上传」会真正读取图片内容并发送给 AI 模型。如果你想让 AI 分析一张图片,请使用图片上传而非文件引用。
:::

### 拖拽到聊天区

当你把本地文件或文件夹拖到聊天区时,整个聊天框会进入高亮状态。松手后:

- 图片会作为图片附件加入输入框
- 普通文件会作为文件引用加入输入框
- 文件夹会作为工作目录引用加入输入框

这种方式适合把桌面、下载目录或文件管理器中的素材直接交给当前智能体处理。

## 智能预测

当你刚完成一轮对话、输入框为空且智能体处于空闲状态时,DesireCore 可能会在输入框上方显示一条「下一条消息」预测芯片。

- 点击预测芯片、按 `Tab` 或按 `→` 可以采纳预测内容
- 继续手动输入时,预测会自动隐藏
- 预测使用轻量模型生成,只用于补全你可能要发送的下一句话

如果你不需要这项能力,可以在设置中关闭智能预测。

## 斜杠命令

在输入框中输入 `/`(斜杠),会弹出命令自动补全菜单。斜杠命令让你快速调用系统功能和 Companion 技能。
Expand All @@ -76,21 +98,23 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片

| 类型 | 语法 | 说明 |
|------|------|------|
| 系统命令 | `/命令名` | 内置功能,如 `/help`、`/skill`、`/plan` 等 |
| 系统命令 | `/命令名` | 内置功能,如 `/plan`、`/new`、`/compact`、`/rewind`、`/steer`、`/help` 等 |
| 技能调用 | `/skill:技能名` | 调用已安装的技能 |
| 快捷调用 | `/技能名` | 直接输入技能名称快速调用 |

输入 `/skill:` 后会自动显示当前 Companion 可用的技能列表,继续输入可过滤匹配。

### 常用系统命令

| 命令 | 作用 |
|------|------|
| `/plan` | 强制 Companion 先制定计划再动手(详见[计划确认](../04-delegation/02-plan-confirmation.md#主动要求先做计划)) |
| `/new` | 开启一个新的对话,与当前对话上下文隔离 |
| `/compact` | 手动压缩当前对话历史,释放上下文空间 |
| `/steer` | 在 Companion 思考过程中插入一条引导消息(不打断生成) |
| `/help` | 查看可用命令完整列表 |
| 命令 | 用途 | 适合场景 |
|------|------|----------|
| `/plan` | 强制 Companion 先制定计划再动手 | 希望先确认方案,再允许智能体执行 |
| `/new` | 开启新的上下文边界 | 想换话题,但保留可见历史 |
| `/compact` | 手动压缩当前会话上下文 | 长对话接近模型上下文上限 |
| `/rewind` | 回撤到某条用户消息前的检查点 | 智能体走错方向,想回到之前状态 |
| `/steer` | 给正在运行的智能体追加方向指令 | 不想中断任务,只想调整执行方向 |
| `/skill:技能名` | 显式加载指定技能 | 已知道当前任务需要某个技能 |
| `/help` | 查看可用命令完整列表 | 不确定当前有哪些可用命令 |

:::tip `/plan` 的两种用法
- 单独发送 `/plan`:开启计划模式,不发任何消息
Expand All @@ -99,6 +123,8 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片
计划被批准(或拒绝)后,强制模式会自动关闭。
:::

`/steer` 只在智能体运行中生效。发送后它会作为运行中的 steer 指令进入当前任务,并在历史中以专门标记展示。

## 快捷键速查

| 操作 | 默认快捷键 (macOS) | 默认快捷键 (Windows/Linux) |
Expand All @@ -109,10 +135,13 @@ DesireCore 的输入区域支持多种消息发送方式,包括文本、图片
| 取消/关闭 | `Esc` | `Esc` |
| 截图 | 可在设置中配置 | 可在设置中配置 |
| 粘贴图片 | `Cmd + V` | `Ctrl + V` |
| 采纳预测 | `Tab` 或 `→` | `Tab` 或 `→` |
| 回撤检查点 | `Cmd + Alt + Z` | `Ctrl + Alt + Z` |

输入框底部也会显示当前的快捷键提示,方便你随时查看。

## 下一步

- 了解[消息类型识别](./02-message-types.md),区分不同角色的消息
- 查看[交互卡片详解](./03-cards.md),了解 Companion 回复中的各种卡片
- 了解[上下文控制](./context-control)和 [Rewind / Checkpoint](./rewind-checkpoints)
34 changes: 32 additions & 2 deletions docs/02-user-guide/02-conversations/02-message-types.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,21 @@ Companion 的回复显示在对话的**左侧**,采用白色半透明玻璃材
- 左上角为尖角(4px),其余三角为圆角(20px),指向左侧头像
- 最大宽度为聊天区域的 78%
- 左侧显示 Companion 的头像
- 支持 Markdown 富文本渲染(标题、列表、代码块、表格等)
- 支持 Markdown 富文本渲染(标题、列表、代码块、表格、Mermaid 图表、KaTeX/LaTeX 公式等)

### 富文本内容

Companion 的消息可以包含多种结构化内容:

| 内容 | 行为 |
|------|------|
| Markdown | 标题、列表、表格、代码块会自动排版 |
| Mermaid | 自动渲染为图表,点击可全屏缩放和平移 |
| KaTeX / LaTeX | 行内和块级公式会以数学排版显示 |
| `.md` 路径 | 可信助手回复中的本地 Markdown 路径可点击打开 |
| 图片 | 图片附件可预览,也会参与对话导出 |

消息操作栏中「复制」会复制纯文本,「复制 Markdown」会保留 Markdown 结构。详见 [Markdown 与图表渲染](./markdown-rendering)。

### 思考过程

Expand Down Expand Up @@ -74,9 +88,24 @@ Companion 的回复显示在对话的**左侧**,采用白色半透明玻璃材

当 Companion 需要执行可能有风险的操作时,会向你发送一个审批请求卡片。你可以选择批准或拒绝,也可以查看具体的操作内容。已经通过 AI 自动审批的操作会标注为"自动批准"或"自动拒绝"。

## 结构化问答消息

当 Companion 需要你补充信息,但并不涉及高风险操作时,会发送结构化问答卡片。常见场景包括选择方案、确认偏好、补充缺失参数。

问答卡片可能处于以下状态:

| 状态 | 说明 |
|------|------|
| 待回答 | 等待你选择或输入答案 |
| 已回答 | 你的回答已进入当前任务 |
| 已取消 | 任务不再等待该问题 |
| 已超时 | 超过等待时间后智能体按无人值守策略继续 |

如果你断线或刷新页面,未完成的问题会在重连后继续显示。部分问题带倒计时;当你开始输入时,倒计时会暂停或取消,避免正在回答时被自动跳过。

## 心跳消息

Companion 的心跳(Heartbeat)系统会定期检查状态并汇报。心跳消息以特殊的卡片形式展示,包含状态摘要和可能需要你关注的事项
Companion 的心跳(Heartbeat)系统会定期检查状态并汇报。需要你关注的结果通常以顶部横幅或通知形式出现,并会记录到心跳历史和回执中;普通无变化的检查只记录历史,不打扰你

## 会话分隔符

Expand All @@ -90,3 +119,4 @@ Companion 的心跳(Heartbeat)系统会定期检查状态并汇报。心跳

- 深入了解[交互卡片详解](./03-cards.md),掌握各种功能卡片的用途
- 学习如何[选择 AI 模型](./04-model-selection.md)
- 阅读 [Markdown 与图表渲染](./markdown-rendering)
30 changes: 29 additions & 1 deletion docs/02-user-guide/02-conversations/03-cards.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ keywords: [交互卡片, 工作流卡片, 行动回执, 教学卡片, 已学习

# 交互卡片详解

DesireCore 的对话不只是简单的文字往来。Companion 在工作时会产生各种结构化的交互卡片,每种卡片都有明确的颜色编码和含义。本页是你理解这些卡片的速查手册
DesireCore 的对话不只是简单的文字往来。Companion 在工作时会产生各种结构化组件:有些是卡片,有些是悬浮面板或全屏预览。本页是你理解这些组件的速查手册

## 卡片总览

Expand All @@ -16,12 +16,39 @@ DesireCore 的对话不只是简单的文字往来。Companion 在工作时会
|---------|--------|---------|------|
| [工作流执行卡片](#工作流执行卡片) | 绿色 | Companion 按计划执行多步骤任务 | "我正在按步骤做" |
| [行动回执卡片](#行动回执卡片) | 绿/橙/蓝 | 操作完成后汇报结果 | "我做了什么,结果如何" |
| [问答卡片](#问答卡片) | 蓝色 | Companion 需要你补充信息 | "我需要你选一下" |
| [审批卡片](#审批卡片) | 橙/红 | 高风险操作执行前 | "请确认是否允许" |
| [任务板](#任务板) | 绿色/蓝色 | 长任务拆解和执行中 | "这些子任务正在推进" |
Comment on lines 17 to +21
| [教学卡片](#教学卡片) | 紫色 | 你教 Companion 新规则时 | "你教了我这个" |
| [已学习卡片](#已学习卡片) | 紫绿混合 | Companion 确认学到新知识 | "我学会了" |
| [委派卡片](#委派卡片) | 蓝色 | 任务被转交给另一个 Companion | "我转交给了专业的同事" |

---

## 问答卡片

当 Companion 缺少必要信息时,会显示问答卡片。它可能让你选择方案、补充文件、确认偏好或决定是否继续等待。

问答卡片支持待回答、已回答、已取消和已超时状态。带超时的问题会显示倒计时;你开始输入后,倒计时会暂停或取消。

---

## 审批卡片

审批卡片用于人闸门确认。它会展示操作类型、影响范围、风险等级和具体参数。你可以批准、拒绝,或按界面提供的方式调整参数后再继续。

审批状态也会同步到通知中心,避免你在模态窗口或其他页面中错过关键确认。

---

## 任务板

长任务会出现悬浮任务板,展示智能体拆分出的子任务及状态。任务板包含 pending、in_progress、completed、failed 等状态,并可能显示优先级、负责人、依赖和当前进度。

如果任务走偏,可以使用 `/steer` 调整方向,或通过 Rewind 回到较早检查点。

---

## 工作流执行卡片

**主色调:绿色 (#34C759)**
Expand Down Expand Up @@ -173,3 +200,4 @@ DesireCore 会自动识别这些内容属于教学意图,无需手动切换模

- 学习如何[选择 AI 模型](./04-model-selection.md)获得不同的回复体验
- 查看[对话历史](./05-chat-history.md)回顾过去的交互卡片
- 了解[执行监控](../04-delegation/03-execution-monitoring.md)中的任务板
21 changes: 19 additions & 2 deletions docs/02-user-guide/02-conversations/04-model-selection.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ DesireCore 支持接入多家 AI 模型供应商(Provider),你可以在对

## 选择模型

下拉面板中的模型按供应商(Provider)分组展示
下拉面板中的模型按供应商(Provider)和模型厂商分组展示

1. **使用默认** --- 顶部选项,恢复为系统默认模型(不手动指定)
2. **各供应商分组** --- 每个供应商名称下列出该供应商可用的模型
Expand All @@ -33,14 +33,28 @@ DesireCore 支持接入多家 AI 模型供应商(Provider),你可以在对

- 模型显示名
- 服务类型标签(如 chat、completion)
- 价格信息(如有)
- 能力标签(如 vision、tool use、reasoning、long context)
- 价格、credit 消耗倍率或相对成本(如有)
- 默认模型标识和验证状态

点击任一模型即切换当前对话使用的模型。选中状态用绿色圆点标识。

将鼠标悬停在模型上,可以查看模型信息卡。信息卡通常包含模型描述、上下文窗口、输入/输出/cache 价格、能力标签和来源说明。

:::tip 作用范围
模型选择是**当前会话级别**的临时覆盖,不会影响其他对话或全局默认设置。关闭对话后会恢复默认。
:::

## 能力与可用性

模型选择器会根据模型能力和当前场景过滤模型:

- 已验证失败的模型会被隐藏或标记为不可用
- 已废弃或被供应商移除的模型不会作为推荐项出现
- 图像生成、视频生成、语音合成等非聊天模型不会作为对话模型选择
- 支持视觉输入的模型会显示对应能力标签,适合图片理解和扫描 PDF 任务
- 官方云端算力模型会显示 credit 或相对消耗信息

## 模型不可用警告

如果你之前选择的模型因为以下原因不可用,下拉面板顶部会显示橙色警告条:
Expand All @@ -55,6 +69,8 @@ DesireCore 支持接入多家 AI 模型供应商(Provider),你可以在对

如果某个 Provider 未配置 API Key,下拉面板中会显示橙色提示。该 Provider 的模型仍会列出,但可能无法正常使用。前往「设置 > 算力服务」配置对应的 API Key。

登录后,官方云端模型会自动以 `desirecore-cloud` 形式绑定到资源面板;这类模型不需要你手动填写 API Key,但会消耗账号中的 credit 或订阅额度。

## 配置默认模型

要修改全局默认使用的模型:
Expand All @@ -80,3 +96,4 @@ DesireCore 的模型配置存储在本地。你配置的 API Key 通过系统凭

- 了解[对话历史](./05-chat-history.md)功能
- 查看[管理对话](./06-managing-conversations.md)了解对话的组织方式
- 查看[算力服务配置](../10-settings/04-compute-service.md)了解云端算力、API Key 和模型验证
13 changes: 13 additions & 0 deletions docs/02-user-guide/02-conversations/05-chat-history.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ DesireCore 会保存你与每个 Companion 的所有对话记录。你可以随

- 每条记录显示:预览文字、消息数量、创建时间
- 点击「定位到聊天位置」可直接跳转到对话中对应的位置
- 支持查看 failed、running、aborted 等非完成状态的历史消息
- 支持删除整个会话记录

## 搜索历史消息
Expand Down Expand Up @@ -71,6 +72,18 @@ DesireCore 会保存你与每个 Companion 的所有对话记录。你可以随
- 标注会话 ID
- 帮助你理解消息的时间上下文

## 多选和导出

聊天记录支持进入多选模式。你可以选择一组消息或一个运行片段,然后导出为 Markdown 或 PDF。

- Markdown 适合继续编辑和归档
- PDF 适合分享给他人或提交报告
- 图片附件可以随导出嵌入
- 工具调用可选择隐藏、摘要或完整展开

详见 [导出对话](./exporting-conversations)。

## 下一步

- 了解如何[管理对话](./06-managing-conversations.md),包括新建、删除和清除上下文
- 学习[上下文控制](./context-control),区分历史、压缩和新上下文
Loading
Loading