Merge pull request #22 from desirecore/codex/docs-conversation-task-workflows

docs: update conversation workflow docs

Author: yi-ge

docs/02-user-guide/01-interface/04-chat-area.md

@@ -60,7 +60,7 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜
 | **资源管理** | 管理智能体的文件和资源 |
 | **运行状态** | 查看当前运行中的任务和历史话题 |
 | **发布/API** | 发布智能体或查看 API 接入信息 |
-| **更多** | 展开更多操作（聊天记录、清除历史、删除智能体等） |
+| **更多** | 展开更多操作（聊天记录、导出、多选、上下文压缩、Rewind、清除历史、删除智能体等） |
 
 :::info 紧凑模式
 当聊天区域宽度不足 640px 时，中间的按钮会自动收入"更多"菜单，只保留"更多"按钮，避免界面拥挤。
@@ -94,6 +94,10 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜
 
 - **工作流卡片**（绿色边框）：展示任务执行步骤和进度
 - **行动回执卡片**（绿/橙/蓝边框）：展示操作结果（成功/警告/待处理）
+- **问答卡片**：智能体需要你补充信息或做选择时展示
+- **审批卡片**：高风险操作执行前请求你的确认
+- **任务板**：长任务拆分后的子任务、状态和进度
+- **图表预览**：Mermaid、draw.io 等图表的预览和全屏查看
 - **教学卡片**（紫色边框）：展示你教给智能体的规则
 - **已学习卡片**（紫色边框）：确认智能体已学会的内容
 - **委派卡片**（蓝色边框）：展示任务在不同智能体之间的流转
@@ -111,6 +115,7 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜
 - 自动伸缩的文本框，最小一行，最大高度 120px
 - 聚焦时边框变为绿色并带外发光效果
 - 支持多行输入
+- 空闲时可能显示下一条消息预测，点击、`Tab` 或 `→` 可采纳
 
 ### 左侧按钮
 
@@ -150,9 +155,23 @@ keywords: [聊天区域, 消息输入, 消息气泡, 模型选择, ChatArea, 斜
 - 点击图片按钮选择文件
 - 直接将图片**粘贴**到输入框（Ctrl/Cmd + V）
 - 将图片**拖拽**到输入区域
+- 将文件或文件夹拖到整个聊天区，高亮后松手添加为附件或工作目录引用
 
 已附加的图片会以缩略图展示在输入框上方，悬停可删除，点击可预览大图。
 
 :::warning 文件引用 vs 图片上传
 "+" 按钮添加的文件是**路径引用**——只告诉智能体文件在哪里；图片按钮是**真正上传**——智能体能看到图片内容。
 :::
+
+## 消息操作栏
+
+悬停消息时会显示操作栏。窄屏下操作栏会收起为图标，避免文字逐字换行。
+
+常见操作包括：
+
+- 复制纯文本或复制 Markdown
+- 重试上一轮回复
+- 编辑用户消息，包括增删图片附件
+- 朗读消息
+- 多选消息并导出
+- 从某条用户消息前执行 Rewind

docs/02-user-guide/01-interface/06-notifications.md

@@ -38,21 +38,23 @@ keywords: [通知中心, 通知, 未读, 消息提醒, NotificationCenter]
 
 ## 通知类型
 
-通知分为三个类别：
+通知分为多个类别：
 
 | 类别 | 说明 | 示例 |
 |------|------|------|
 | **消息** | 来自智能体的对话消息通知 | "法律助手向你发送了合同审查结果" |
 | **系统** | 系统级别的通知 | "DesireCore 已更新到 v2.1.0" |
 | **任务** | 任务执行相关的通知 | "数据分析报告生成完成" |
+| **审批** | 高风险操作或服务权限请求 | "邮件发送前需要你确认" |
 
-每种类型有独特的图标和颜色标识，方便快速区分。
+每种类型有独特的图标和颜色标识，方便快速区分。审批通知会显示 pending、approved、rejected、timeout 等状态，并支持在通知中心内直接批准或拒绝。
 
 ## 通知管理
 
 ### 查看通知
 
 - 点击通知项可标记为已读，并跳转到相关内容
+- 支持 Markdown 预览的通知会保留标题、列表和链接
 - 未读通知有浅色高亮背景，已读通知为普通背景
 
 ### 批量操作

docs/02-user-guide/02-conversations/01-sending-messages.md

@@ -30,12 +30,14 @@ DesireCore 的输入区域支持多种消息发送方式，包括文本、图片
 
 1. **点击图片按钮** --- 输入框左侧的图片图标，点击后打开系统文件选择器，支持选择多张图片
 2. **粘贴图片** --- 直接在输入框中使用 `Ctrl/Cmd + V` 粘贴剪贴板中的图片
-3. **拖拽图片** --- 将图片文件拖拽到输入框区域
+3. **拖拽图片** --- 将图片文件拖拽到输入框区域，或拖到整个聊天区域出现高亮后松手
 
 上传后的图片会以缩略图形式显示在输入框上方。你可以：
 
 - 点击缩略图查看大图预览
 - 悬停在缩略图上，点击右上角的关闭按钮移除图片
+- 发送前查看上传进度和压缩后的文件大小
+- 编辑已发送的用户消息时，删除原有图片或追加新图片
 
 :::info 支持的图片格式
 支持常见的图片格式，包括 JPEG、PNG、WebP、GIF 等。图片会以 Base64 编码发送给 AI 模型进行视觉理解。
@@ -62,6 +64,26 @@ DesireCore 的输入区域支持多种消息发送方式，包括文本、图片
 「文件引用」只是告诉 Companion 你引用了哪个文件的路径，Companion 会自行读取。而「图片上传」会真正读取图片内容并发送给 AI 模型。如果你想让 AI 分析一张图片，请使用图片上传而非文件引用。
 :::
 
+### 拖拽到聊天区
+
+当你把本地文件或文件夹拖到聊天区时，整个聊天框会进入高亮状态。松手后：
+
+- 图片会作为图片附件加入输入框
+- 普通文件会作为文件引用加入输入框
+- 文件夹会作为工作目录引用加入输入框
+
+这种方式适合把桌面、下载目录或文件管理器中的素材直接交给当前智能体处理。
+
+## 智能预测
+
+当你刚完成一轮对话、输入框为空且智能体处于空闲状态时，DesireCore 可能会在输入框上方显示一条「下一条消息」预测芯片。
+
+- 点击预测芯片、按 `Tab` 或按 `→` 可以采纳预测内容
+- 继续手动输入时，预测会自动隐藏
+- 预测使用轻量模型生成，只用于补全你可能要发送的下一句话
+
+如果你不需要这项能力，可以在设置中关闭智能预测。
+
 ## 斜杠命令
 
 在输入框中输入 `/`（斜杠），会弹出命令自动补全菜单。斜杠命令让你快速调用系统功能和 Companion 技能。
@@ -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`：开启计划模式，不发任何消息
@@ -99,6 +123,8 @@ DesireCore 的输入区域支持多种消息发送方式，包括文本、图片
 计划被批准（或拒绝）后，强制模式会自动关闭。
 :::
 
+`/steer` 只在智能体运行中生效。发送后它会作为运行中的 steer 指令进入当前任务，并在历史中以专门标记展示。
+
 ## 快捷键速查
 
 | 操作 | 默认快捷键 (macOS) | 默认快捷键 (Windows/Linux) |
@@ -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)

docs/02-user-guide/02-conversations/02-message-types.md

@@ -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)。
 
 ### 思考过程
 
@@ -74,9 +88,24 @@ Companion 的回复显示在对话的**左侧**，采用白色半透明玻璃材
 
 当 Companion 需要执行可能有风险的操作时，会向你发送一个审批请求卡片。你可以选择批准或拒绝，也可以查看具体的操作内容。已经通过 AI 自动审批的操作会标注为"自动批准"或"自动拒绝"。
 
+## 结构化问答消息
+
+当 Companion 需要你补充信息，但并不涉及高风险操作时，会发送结构化问答卡片。常见场景包括选择方案、确认偏好、补充缺失参数。
+
+问答卡片可能处于以下状态：
+
+| 状态 | 说明 |
+|------|------|
+| 待回答 | 等待你选择或输入答案 |
+| 已回答 | 你的回答已进入当前任务 |
+| 已取消 | 任务不再等待该问题 |
+| 已超时 | 超过等待时间后智能体按无人值守策略继续 |
+
+如果你断线或刷新页面，未完成的问题会在重连后继续显示。部分问题带倒计时；当你开始输入时，倒计时会暂停或取消，避免正在回答时被自动跳过。
+
 ## 心跳消息
 
-Companion 的心跳（Heartbeat）系统会定期检查状态并汇报。心跳消息以特殊的卡片形式展示，包含状态摘要和可能需要你关注的事项。
+Companion 的心跳（Heartbeat）系统会定期检查状态并汇报。需要你关注的结果通常以顶部横幅或通知形式出现，并会记录到心跳历史和回执中；普通无变化的检查只记录历史，不打扰你。
 
 ## 会话分隔符
 
@@ -90,3 +119,4 @@ Companion 的心跳（Heartbeat）系统会定期检查状态并汇报。心跳
 
 - 深入了解[交互卡片详解](./03-cards.md)，掌握各种功能卡片的用途
 - 学习如何[选择 AI 模型](./04-model-selection.md)
+- 阅读 [Markdown 与图表渲染](./markdown-rendering)

docs/02-user-guide/02-conversations/03-cards.md

@@ -6,7 +6,7 @@ keywords: [交互卡片, 工作流卡片, 行动回执, 教学卡片, 已学习
 
 # 交互卡片详解
 
-DesireCore 的对话不只是简单的文字往来。Companion 在工作时会产生各种结构化的交互卡片，每种卡片都有明确的颜色编码和含义。本页是你理解这些卡片的速查手册。
+DesireCore 的对话不只是简单的文字往来。Companion 在工作时会产生各种结构化组件：有些是卡片，有些是悬浮面板或全屏预览。本页是你理解这些组件的速查手册。
 
 ## 卡片总览
 
@@ -16,12 +16,39 @@ DesireCore 的对话不只是简单的文字往来。Companion 在工作时会
 |---------|--------|---------|------|
 | [工作流执行卡片](#工作流执行卡片) | 绿色 | Companion 按计划执行多步骤任务 | "我正在按步骤做" |
 | [行动回执卡片](#行动回执卡片) | 绿/橙/蓝 | 操作完成后汇报结果 | "我做了什么，结果如何" |
+| [问答卡片](#问答卡片) | 蓝色 | Companion 需要你补充信息 | "我需要你选一下" |
+| [审批卡片](#审批卡片) | 橙/红 | 高风险操作执行前 | "请确认是否允许" |
+| [任务板](#任务板) | 绿色/蓝色 | 长任务拆解和执行中 | "这些子任务正在推进" |
 | [教学卡片](#教学卡片) | 紫色 | 你教 Companion 新规则时 | "你教了我这个" |
 | [已学习卡片](#已学习卡片) | 紫绿混合 | Companion 确认学到新知识 | "我学会了" |
 | [委派卡片](#委派卡片) | 蓝色 | 任务被转交给另一个 Companion | "我转交给了专业的同事" |
 
 ---
 
+## 问答卡片
+
+当 Companion 缺少必要信息时，会显示问答卡片。它可能让你选择方案、补充文件、确认偏好或决定是否继续等待。
+
+问答卡片支持待回答、已回答、已取消和已超时状态。带超时的问题会显示倒计时；你开始输入后，倒计时会暂停或取消。
+
+---
+
+## 审批卡片
+
+审批卡片用于人闸门确认。它会展示操作类型、影响范围、风险等级和具体参数。你可以批准、拒绝，或按界面提供的方式调整参数后再继续。
+
+审批状态也会同步到通知中心，避免你在模态窗口或其他页面中错过关键确认。
+
+---
+
+## 任务板
+
+长任务会出现悬浮任务板，展示智能体拆分出的子任务及状态。任务板包含 pending、in_progress、completed、failed 等状态，并可能显示优先级、负责人、依赖和当前进度。
+
+如果任务走偏，可以使用 `/steer` 调整方向，或通过 Rewind 回到较早检查点。
+
+---
+
 ## 工作流执行卡片
 
 **主色调：绿色 (#34C759)**
@@ -173,3 +200,4 @@ DesireCore 会自动识别这些内容属于教学意图，无需手动切换模
 
 - 学习如何[选择 AI 模型](./04-model-selection.md)获得不同的回复体验
 - 查看[对话历史](./05-chat-history.md)回顾过去的交互卡片
+- 了解[执行监控](../04-delegation/03-execution-monitoring.md)中的任务板

docs/02-user-guide/02-conversations/04-model-selection.md

@@ -24,7 +24,7 @@ DesireCore 支持接入多家 AI 模型供应商（Provider），你可以在对
 
 ## 选择模型
 
-下拉面板中的模型按供应商（Provider）分组展示：
+下拉面板中的模型按供应商（Provider）和模型厂商分组展示：
 
 1. **使用默认** --- 顶部选项，恢复为系统默认模型（不手动指定）
 2. **各供应商分组** --- 每个供应商名称下列出该供应商可用的模型
@@ -33,14 +33,28 @@ DesireCore 支持接入多家 AI 模型供应商（Provider），你可以在对
 
 - 模型显示名
 - 服务类型标签（如 chat、completion）
-- 价格信息（如有）
+- 能力标签（如 vision、tool use、reasoning、long context）
+- 价格、credit 消耗倍率或相对成本（如有）
+- 默认模型标识和验证状态
 
 点击任一模型即切换当前对话使用的模型。选中状态用绿色圆点标识。
 
+将鼠标悬停在模型上，可以查看模型信息卡。信息卡通常包含模型描述、上下文窗口、输入/输出/cache 价格、能力标签和来源说明。
+
 :::tip 作用范围
 模型选择是**当前会话级别**的临时覆盖，不会影响其他对话或全局默认设置。关闭对话后会恢复默认。
 :::
 
+## 能力与可用性
+
+模型选择器会根据模型能力和当前场景过滤模型：
+
+- 已验证失败的模型会被隐藏或标记为不可用
+- 已废弃或被供应商移除的模型不会作为推荐项出现
+- 图像生成、视频生成、语音合成等非聊天模型不会作为对话模型选择
+- 支持视觉输入的模型会显示对应能力标签，适合图片理解和扫描 PDF 任务
+- 官方云端算力模型会显示 credit 或相对消耗信息
+
 ## 模型不可用警告
 
 如果你之前选择的模型因为以下原因不可用，下拉面板顶部会显示橙色警告条：
@@ -55,6 +69,8 @@ DesireCore 支持接入多家 AI 模型供应商（Provider），你可以在对
 
 如果某个 Provider 未配置 API Key，下拉面板中会显示橙色提示。该 Provider 的模型仍会列出，但可能无法正常使用。前往「设置 > 算力服务」配置对应的 API Key。
 
+登录后，官方云端模型会自动以 `desirecore-cloud` 形式绑定到资源面板；这类模型不需要你手动填写 API Key，但会消耗账号中的 credit 或订阅额度。
+
 ## 配置默认模型
 
 要修改全局默认使用的模型：
@@ -80,3 +96,4 @@ DesireCore 的模型配置存储在本地。你配置的 API Key 通过系统凭
 
 - 了解[对话历史](./05-chat-history.md)功能
 - 查看[管理对话](./06-managing-conversations.md)了解对话的组织方式
+- 查看[算力服务配置](../10-settings/04-compute-service.md)了解云端算力、API Key 和模型验证

docs/02-user-guide/02-conversations/05-chat-history.md

@@ -32,6 +32,7 @@ DesireCore 会保存你与每个 Companion 的所有对话记录。你可以随
 
 - 每条记录显示：预览文字、消息数量、创建时间
 - 点击「定位到聊天位置」可直接跳转到对话中对应的位置
+- 支持查看 failed、running、aborted 等非完成状态的历史消息
 - 支持删除整个会话记录
 
 ## 搜索历史消息
@@ -71,6 +72,18 @@ DesireCore 会保存你与每个 Companion 的所有对话记录。你可以随
 - 标注会话 ID
 - 帮助你理解消息的时间上下文
 
+## 多选和导出
+
+聊天记录支持进入多选模式。你可以选择一组消息或一个运行片段，然后导出为 Markdown 或 PDF。
+
+- Markdown 适合继续编辑和归档
+- PDF 适合分享给他人或提交报告
+- 图片附件可以随导出嵌入
+- 工具调用可选择隐藏、摘要或完整展开
+
+详见 [导出对话](./exporting-conversations)。
+
 ## 下一步
 
 - 了解如何[管理对话](./06-managing-conversations.md)，包括新建、删除和清除上下文
+- 学习[上下文控制](./context-control)，区分历史、压缩和新上下文