diff --git a/docs/02-user-guide/01-interface/04-chat-area.md b/docs/02-user-guide/01-interface/04-chat-area.md index 9fa1775..7a63c6e 100644 --- a/docs/02-user-guide/01-interface/04-chat-area.md +++ b/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 diff --git a/docs/02-user-guide/01-interface/06-notifications.md b/docs/02-user-guide/01-interface/06-notifications.md index ce10de5..e38af03 100644 --- a/docs/02-user-guide/01-interface/06-notifications.md +++ b/docs/02-user-guide/01-interface/06-notifications.md @@ -38,21 +38,23 @@ keywords: [通知中心, 通知, 未读, 消息提醒, NotificationCenter] ## 通知类型 -通知分为三个类别： +通知分为多个类别： | 类别 | 说明 | 示例 | |------|------|------| | **消息** | 来自智能体的对话消息通知 | "法律助手向你发送了合同审查结果" | | **系统** | 系统级别的通知 | "DesireCore 已更新到 v2.1.0" | | **任务** | 任务执行相关的通知 | "数据分析报告生成完成" | +| **审批** | 高风险操作或服务权限请求 | "邮件发送前需要你确认" | -每种类型有独特的图标和颜色标识，方便快速区分。 +每种类型有独特的图标和颜色标识，方便快速区分。审批通知会显示 pending、approved、rejected、timeout 等状态，并支持在通知中心内直接批准或拒绝。 ## 通知管理 ### 查看通知 - 点击通知项可标记为已读，并跳转到相关内容 +- 支持 Markdown 预览的通知会保留标题、列表和链接 - 未读通知有浅色高亮背景，已读通知为普通背景 ### 批量操作 diff --git a/docs/02-user-guide/02-conversations/01-sending-messages.md b/docs/02-user-guide/02-conversations/01-sending-messages.md index 5ddbf88..ddb6d6a 100644 --- a/docs/02-user-guide/02-conversations/01-sending-messages.md +++ b/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,7 +98,7 @@ DesireCore 的输入区域支持多种消息发送方式，包括文本、图片 | 类型 | 语法 | 说明 | |------|------|------| -| 系统命令 | `/命令名` | 内置功能，如 `/help`、`/skill`、`/plan` 等 | +| 系统命令 | `/命令名` | 内置功能，如 `/plan`、`/new`、`/compact`、`/rewind`、`/steer`、`/help` 等 | | 技能调用 | `/skill:技能名` | 调用已安装的技能 | | 快捷调用 | `/技能名` | 直接输入技能名称快速调用 | @@ -84,13 +106,15 @@ DesireCore 的输入区域支持多种消息发送方式，包括文本、图片 ### 常用系统命令 -| 命令 | 作用 | -|------|------| -| `/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,6 +135,8 @@ DesireCore 的输入区域支持多种消息发送方式，包括文本、图片 | 取消/关闭 | `Esc` | `Esc` | | 截图 | 可在设置中配置 | 可在设置中配置 | | 粘贴图片 | `Cmd + V` | `Ctrl + V` | +| 采纳预测 | `Tab` 或 `→` | `Tab` 或 `→` | +| 回撤检查点 | `Cmd + Alt + Z` | `Ctrl + Alt + Z` | 输入框底部也会显示当前的快捷键提示，方便你随时查看。 @@ -116,3 +144,4 @@ DesireCore 的输入区域支持多种消息发送方式，包括文本、图片 - 了解[消息类型识别](./02-message-types.md)，区分不同角色的消息 - 查看[交互卡片详解](./03-cards.md)，了解 Companion 回复中的各种卡片 +- 了解[上下文控制](./context-control)和 [Rewind / Checkpoint](./rewind-checkpoints) diff --git a/docs/02-user-guide/02-conversations/02-message-types.md b/docs/02-user-guide/02-conversations/02-message-types.md index f44aad6..465c81c 100644 --- a/docs/02-user-guide/02-conversations/02-message-types.md +++ b/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) diff --git a/docs/02-user-guide/02-conversations/03-cards.md b/docs/02-user-guide/02-conversations/03-cards.md index 280502d..b23644f 100644 --- a/docs/02-user-guide/02-conversations/03-cards.md +++ b/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)中的任务板 diff --git a/docs/02-user-guide/02-conversations/04-model-selection.md b/docs/02-user-guide/02-conversations/04-model-selection.md index 8e3cf81..6a85b18 100644 --- a/docs/02-user-guide/02-conversations/04-model-selection.md +++ b/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 和模型验证 diff --git a/docs/02-user-guide/02-conversations/05-chat-history.md b/docs/02-user-guide/02-conversations/05-chat-history.md index 2a42e7b..da56ef5 100644 --- a/docs/02-user-guide/02-conversations/05-chat-history.md +++ b/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)，区分历史、压缩和新上下文 diff --git a/docs/02-user-guide/02-conversations/06-managing-conversations.md b/docs/02-user-guide/02-conversations/06-managing-conversations.md index 778c9a9..ef71027 100644 --- a/docs/02-user-guide/02-conversations/06-managing-conversations.md +++ b/docs/02-user-guide/02-conversations/06-managing-conversations.md @@ -58,6 +58,20 @@ DesireCore 的对话以 Companion 为单位组织 --- 每个 Companion 对应一 清除聊天记录是不可逆操作。清除后无法恢复历史消息，但 Companion 学到的知识（Playbook）不受影响。 ::: +## 上下文管理 + +不要把「清除聊天记录」当作日常上下文管理手段。较新的 DesireCore 提供了更温和的方式： + +| 操作 | 作用 | 是否保留可见历史 | +|------|------|------------------| +| `/new` | 开启新的上下文边界，适合换话题 | 是 | +| `/compact` | 手动压缩旧上下文，适合长任务 | 是 | +| 自动压缩 | 上下文接近上限时后台整理 | 是 | +| Rewind | 回到某条用户消息前的检查点 | 保留旧分支 | +| 清除聊天记录 | 删除当前 Companion 的历史消息 | 否 | + +详见 [上下文控制](./context-control) 和 [Rewind 与 Checkpoint](./rewind-checkpoints)。 + ## 删除对话 如果你想彻底删除一个 Companion 及其对话： @@ -95,4 +109,5 @@ DesireCore 的对话支持跨会话的上下文延续： - 返回查看[发送消息](./01-sending-messages.md)的详细操作 - 了解[交互卡片](./03-cards.md)的含义 +- 学习[导出对话](./exporting-conversations) - 遇到问题？查看[常见问题](../../06-faq/index.md) diff --git a/docs/02-user-guide/02-conversations/07-markdown-rendering.md b/docs/02-user-guide/02-conversations/07-markdown-rendering.md new file mode 100644 index 0000000..b7709b1 --- /dev/null +++ b/docs/02-user-guide/02-conversations/07-markdown-rendering.md @@ -0,0 +1,61 @@ +--- +title: Markdown 与图表渲染 +description: 了解 DesireCore 对 Markdown、Mermaid、KaTeX、文件路径和图表预览的支持。 +keywords: [Markdown, Mermaid, KaTeX, LaTeX, 图表, 公式, 文件链接] +--- + +# Markdown 与图表渲染 + +Companion 的回复会以 Markdown 富文本展示。你可以直接阅读标题、列表、表格、代码块、数学公式和图表，也可以把内容复制为纯文本或保留 Markdown 格式。 + +## 支持的内容 + +| 内容类型 | 支持方式 | +|----------|----------| +| 标题、列表、引用 | 按 Markdown 结构渲染 | +| 表格 | 自动保持列对齐，窄屏下可横向滚动 | +| 代码块 | 语法高亮，支持一键复制 | +| 数学公式 | 支持行内和块级 KaTeX / LaTeX | +| Mermaid 图表 | 在消息内渲染，可打开全屏预览 | +| 图片附件 | 在消息中展示缩略图，可点击预览 | +| `.md` 文件路径 | 可信助手回复中的本地 Markdown 路径可点击打开 | + +## Mermaid 图表 + +当回复中包含 Mermaid 代码块时，DesireCore 会自动渲染为图表。点击图表可以打开全屏预览： + +- 鼠标滚轮缩放 +- 拖拽平移画布 +- 双击或点击重置按钮恢复适配屏幕 +- 关闭预览后回到原对话位置 + +如果 Mermaid 代码存在语法错误，消息会保留原始代码块，方便你让 Companion 继续修正。 + +## 数学公式 + +DesireCore 支持常见 LaTeX 写法： + +- 行内公式：`$E = mc^2$` +- 块级公式：`$$\int_a^b f(x) dx$$` + +长公式会在气泡内横向滚动，不会撑破消息布局。 + +## 文件路径和链接 + +助手回复中的本地 `.md` 文件路径会显示为可点击链接。点击后，DesireCore 会在应用内打开对应文件或跳转到系统文件位置。 + +:::info 安全边界 +路径点击只对可信助手回复中的本地 Markdown 路径启用。普通文本、用户消息和不明确的路径不会自动执行任何操作。 +::: + +## 复制内容 + +消息操作栏提供两种复制方式： + +| 操作 | 结果 | +|------|------| +| 复制 | 复制适合粘贴到聊天或普通文档的纯文本 | +| 复制 Markdown | 保留标题、列表、代码块、表格和图表源码 | + +当你要把回复继续交给其他 Markdown 编辑器处理时，优先使用「复制 Markdown」。 + diff --git a/docs/02-user-guide/02-conversations/08-exporting-conversations.md b/docs/02-user-guide/02-conversations/08-exporting-conversations.md new file mode 100644 index 0000000..6479114 --- /dev/null +++ b/docs/02-user-guide/02-conversations/08-exporting-conversations.md @@ -0,0 +1,53 @@ +--- +title: 导出对话 +description: 将 DesireCore 对话导出为 Markdown 或 PDF，并控制导出范围和内容细节。 +keywords: [导出对话, Markdown 导出, PDF 导出, 多选消息, 聊天记录] +--- + +# 导出对话 + +你可以把对话保存为 Markdown 或 PDF，用于归档、分享、提交报告或继续编辑。 + +## 导出入口 + +在聊天头部点击「更多」，选择「导出对话」。如果你已经进入多选模式，也可以只导出选中的对话范围。 + +导出前可以选择： + +- 导出格式：Markdown 或 PDF +- 导出范围：当前会话、完整对话历史或选中消息相关的 run +- 工具调用：隐藏、摘要或完整展开 +- 是否包含 thinking / system 类辅助信息 +- 是否嵌入图片附件 + +:::info 多选导出的范围 +多选导出会按选中消息所属的 run 聚合导出，确保上下文、工具结果和图片引用完整。它不是简单地逐条拼接消息。 +::: + +## Markdown 导出 + +Markdown 导出适合继续编辑或交给其他系统处理。它会保留： + +- 消息角色和时间 +- 标题、列表、表格、代码块 +- Mermaid 图表源码 +- 图片引用 +- 工具调用摘要或完整内容 + +## PDF 导出 + +PDF 导出适合正式归档和分享。桌面端会使用统一的文档渲染链路生成 PDF，尽量保持 Markdown 的标题、表格、代码块、图片和公式样式。 + +:::tip 图片和 thinking +较新的导出流程会把对话中的图片嵌入 PDF，并正确处理 thinking 块。若图片来自本地文件，请确认文件仍然存在。 +::: + +## 导出建议 + +| 目标 | 建议 | +|------|------| +| 继续写作 | 导出 Markdown | +| 发送给非技术同事 | 导出 PDF | +| 调试智能体行为 | 导出完整工具调用 | +| 做会议纪要或报告 | 隐藏工具调用，仅保留摘要 | + diff --git a/docs/02-user-guide/02-conversations/09-context-control.md b/docs/02-user-guide/02-conversations/09-context-control.md new file mode 100644 index 0000000..a5331ae --- /dev/null +++ b/docs/02-user-guide/02-conversations/09-context-control.md @@ -0,0 +1,55 @@ +--- +title: 上下文控制 +description: 使用 /new、/compact 和自动压缩管理长对话上下文。 +keywords: [上下文, 压缩, /new, /compact, CompactSession, 长对话] +--- + +# 上下文控制 + +DesireCore 会保存完整对话历史，但模型每次只能读取有限长度的上下文。上下文控制用于在不丢失可见历史的前提下，让长对话继续稳定运行。 + +## `/new`：开启新上下文 + +输入 `/new` 会在当前对话中创建新的上下文边界。 + +- 可见历史仍保留在聊天界面 +- 后续模型调用不再自动读取边界之前的完整消息 +- 适合换话题、重新开始任务或避免旧讨论影响新任务 + +## `/compact`：手动压缩 + +输入 `/compact` 会让 Companion 总结较早的消息，并把摘要作为后续上下文的一部分。 + +- 原始历史仍能在界面和聊天记录中查看 +- 模型后续主要读取压缩摘要和最近几轮消息 +- 适合长任务、连续写作、长代码审查和多轮资料分析 + +手动压缩会尽量执行，即使当前上下文还没有达到上限，也可以用来主动整理长期任务。 + +## 自动长上下文压缩 + +当对话接近模型上下文上限时，DesireCore 会自动触发压缩。自动压缩的目标是： + +- 避免长对话突然因上下文超限失败 +- 保留任务目标、关键决策、已完成步骤和待办事项 +- 减少重复读取旧消息造成的成本浪费 + +自动压缩不会清空聊天记录，也不会删除文件或记忆。 + +## CompactSession 工具 + +部分智能体可以主动调用 `CompactSession` 工具整理当前会话。这通常发生在： + +- 智能体发现任务跨度很长 +- 工具调用和文件输出很多 +- 后续需要稳定保留阶段性结论 + +## 与清除历史的区别 + +| 操作 | 是否保留可见历史 | 是否影响模型上下文 | 是否可恢复 | +|------|------------------|--------------------|------------| +| `/new` | 保留 | 开启新上下文边界 | 可继续查看旧消息 | +| `/compact` | 保留 | 用摘要替代旧消息细节 | 可查看原始历史 | +| 自动压缩 | 保留 | 后台压缩旧上下文 | 可查看原始历史 | +| 清除聊天记录 | 删除 | 删除对应历史 | 通常不可恢复 | + diff --git a/docs/02-user-guide/02-conversations/10-rewind-checkpoints.md b/docs/02-user-guide/02-conversations/10-rewind-checkpoints.md new file mode 100644 index 0000000..3c23990 --- /dev/null +++ b/docs/02-user-guide/02-conversations/10-rewind-checkpoints.md @@ -0,0 +1,57 @@ +--- +title: Rewind 与 Checkpoint +description: 使用回撤检查点恢复对话和智能体工作状态。 +keywords: [Rewind, Checkpoint, 回撤, 检查点, 恢复状态] +--- + +# Rewind 与 Checkpoint + +Rewind / Checkpoint 让你在智能体走错方向时回到之前的稳定状态。它不只是删除几条聊天消息，还可以恢复当时的文件、媒体、AgentFS、记忆和技能状态。 + +## 什么时候用 + +- 智能体误解需求，后续执行都偏了 +- 一次大改动影响了文件或文档状态 +- 想比较两个方案，但保留旧分支 +- 需要撤回刚才的自动学习或技能变更 + +## 入口 + +你可以通过以下方式打开回撤： + +- 在输入框输入 `/rewind` +- 在消息操作栏选择 Rewind +- 在聊天头部「更多」菜单中选择回撤 +- 使用快捷键 `Cmd + Alt + Z`（macOS）或 `Ctrl + Alt + Z`（Windows/Linux） + +## 回撤模式 + +| 模式 | 作用 | +|------|------| +| 仅对话 | 回到某条用户消息前的对话状态 | +| 仅状态 | 恢复文件、媒体、AgentFS、记忆或技能状态 | +| 对话 + 状态 | 同时恢复对话和工作状态 | + +执行前会显示影响范围预览。确认后，DesireCore 会从目标检查点创建新的运行分支，旧分支仍保留在历史中。 + +## 自动检查点 + +DesireCore 会在关键操作前后自动建立检查点，例如： + +- 用户发送新任务 +- 智能体开始修改文件 +- 写入记忆或技能 +- 生成媒体或导出文档 + +你不需要手动创建检查点。 + +## 限制 + +Rewind 主要恢复 DesireCore 管理的本地状态。以下外部副作用通常不会被撤销： + +- 已发送的邮件或已调用的外部 API +- 已推送到远程仓库的变更 +- 通过命令行在 DesireCore 管理范围外手动修改的文件 +- 第三方服务内部已经完成的交易或审批 + +如果回撤涉及外部副作用，建议查看审计记录后再决定下一步处理方式。 diff --git a/docs/02-user-guide/04-delegation/03-execution-monitoring.md b/docs/02-user-guide/04-delegation/03-execution-monitoring.md index d241622..832f0f9 100644 --- a/docs/02-user-guide/04-delegation/03-execution-monitoring.md +++ b/docs/02-user-guide/04-delegation/03-execution-monitoring.md @@ -6,7 +6,7 @@ keywords: [执行, 监控, 固化步骤, 灵活步骤, 暂停, 恢复, 进度, # 执行监控 -确认计划后，智能体开始执行任务。你可以实时监控每一步的进展，并在需要时随时介入。 +确认计划后，智能体开始执行任务。你可以实时监控每一步的进展，并在需要时随时介入。较新的 DesireCore 会把复杂任务同步到悬浮任务板，方便你在长任务中看到全局进度。 ## 执行过程的实时展示 @@ -94,6 +94,23 @@ keywords: [执行, 监控, 固化步骤, 灵活步骤, 暂停, 恢复, 进度, 如果你让多个智能体协作完成一件大事（比如组队任务），每个智能体管理自己的清单，**通过消息和回执互相通报进度**——不是直接读取彼此的清单。这与现实中的团队协作一致：每个人有自己的待办，靠汇报和回执对齐。详见[跨智能体协作](./06-cross-agent.md)。 ::: +## 悬浮任务板 + +当智能体把任务拆成多个子任务时，聊天区会出现悬浮任务板。任务板不是简单的加载动画，而是智能体通过任务工具维护的真实执行状态。 + +任务板通常显示： + +- 当前任务标题和整体进度 +- 每个子任务的状态：`pending`、`in_progress`、`completed`、`failed` +- 优先级、负责人、依赖关系和更新时间 +- 当前正在执行的任务和失败原因 + +你可以把它理解为一次对话内的轻量项目看板。它适合代码修改、资料调研、文档批量处理、跨智能体协作等长任务。 + +:::tip 与工作流卡片的区别 +工作流卡片展示智能体计划中的步骤；任务板展示运行中不断更新的任务状态。一个任务可能先有计划，再在执行过程中被拆成更多任务。 +::: + ## 固化步骤与灵活步骤 这是 DesireCore 最核心的设计之一——每个执行步骤都被明确分类，让你知道哪些结果是确定的，哪些包含 AI 判断。 @@ -208,6 +225,12 @@ keywords: [执行, 监控, 固化步骤, 灵活步骤, 暂停, 恢复, 进度, 当前步骤不受影响，将在步骤 5（综合评估）中纳入。" ``` +如果任务正在运行，你也可以使用 `/steer` 发送方向调整。它会作为运行中的 steer 指令进入当前任务，不会像重新发送普通消息那样开启新任务。 + +## 回撤执行状态 + +如果你发现智能体已经沿着错误方向执行了一段时间，优先使用 [Rewind 与 Checkpoint](../conversations/rewind-checkpoints)。Rewind 会基于检查点恢复对话和工作状态，而不是只在进度面板中“回滚某一步”。 + :::info 下一步 在执行过程中，某些高风险操作会触发"人闸门"确认。前往 [人闸门确认机制](./04-human-gate.md) 了解详情。 ::: 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 d8c4eb7..1c6419a 100644 --- a/docs/02-user-guide/04-delegation/04-human-gate.md +++ b/docs/02-user-guide/04-delegation/04-human-gate.md @@ -27,6 +27,17 @@ keywords: [人闸门, Human Gate, 确认, 权限, 风险等级, 安全] 读取文件、分析数据、生成草稿等只读操作通常不需要确认。智能体会自主完成这些低风险操作，提高效率。 ::: +## 问答卡与人闸门的区别 + +有时智能体只是需要你补充信息，例如“选择哪个方案”“是否要继续等待”“缺少哪个文件”。这类场景会使用结构化问答卡，而不是人闸门审批。 + +| 机制 | 目的 | 是否代表高风险 | +|------|------|----------------| +| 问答卡（AskUserQuestion） | 澄清需求、收集选择、等待补充信息 | 否 | +| 人闸门（Human Gate） | 在执行有影响的操作前请求授权 | 是 | + +问答卡可以设置超时。无人值守时，智能体会按问题中定义的策略继续、跳过或等待；超时本身不等于任务失败。刷新或断线后，未回答的问题会在重连后继续显示。 + ## 确认对话框 当人闸门被触发时，你会看到一个确认对话框： diff --git a/docs/02-user-guide/04-delegation/05-receipts.md b/docs/02-user-guide/04-delegation/05-receipts.md index deeb1db..4748657 100644 --- a/docs/02-user-guide/04-delegation/05-receipts.md +++ b/docs/02-user-guide/04-delegation/05-receipts.md @@ -19,6 +19,19 @@ keywords: [回执, Receipt, 审计, 回滚, 执行记录, 追溯] **有了回执，委派才是可信的。** 没有回执的委派就像把钱交给别人但没拿到收据——你不知道钱花在了哪里。 +## 回执类型 + +除了一次性任务，DesireCore 还会为自动化和后台行为生成回执： + +| 回执类型 | 记录内容 | +|----------|----------| +| 任务回执 | 智能体执行任务的步骤、工具、结果和风险 | +| 心跳回执 | 巡检 outcome、通知文本、产出文件、下次检查时间 | +| 调度回执 | 定时任务创建、触发、跳过、失败或完成情况 | +| 审批回执 | 人闸门请求、批准/拒绝状态、审批来源 | + +如果回执关联了文件，聊天卡片和历史记录中会显示可点击文件链接。 + ## 回执包含哪些信息 一份完整的回执包含以下内容： @@ -31,6 +44,8 @@ keywords: [回执, Receipt, 审计, 回滚, 执行记录, 追溯] 任务完成后，智能体会在对话中展示回执摘要。你可以点击展开查看完整信息。 +心跳和调度回执通常还会写入对应的历史文件，例如心跳的 `heartbeat/history.md`，便于长期审计。 + ### 查看历史回执 ``` @@ -65,9 +80,9 @@ keywords: [回执, Receipt, 审计, 回滚, 执行记录, 追溯] | **依据追溯** | 确认智能体是否基于正确的规则做出判断 | | **执行耗时** | 异常的长耗时可能意味着任务复杂度超出预期 | -## 通过回执进行回滚 +## 通过回执追溯和恢复 -如果你对执行结果不满意，可以基于回执进行回滚。DesireCore 支持多个粒度的回滚： +如果你对执行结果不满意，先用回执确认影响范围，再使用 Rewind / Checkpoint 恢复到合适状态。较新的 DesireCore 会优先基于检查点恢复，而不是依赖单个步骤的手工回滚。 | 回滚级别 | 含义 | 适用场景 | |---------|------|---------| @@ -87,8 +102,8 @@ keywords: [回执, Receipt, 审计, 回滚, 执行记录, 追溯] 确认回滚？" ``` -:::tip 回滚前先查看回执 -在决定回滚之前，先仔细查看回执中的步骤明细和依据追溯。有时候问题不是出在执行上，而是出在规则上——这时候修改规则比回滚更有效。 +:::tip 恢复前先查看回执 +在决定 Rewind 或恢复版本之前，先仔细查看回执中的步骤明细、文件链接和依据追溯。有时候问题不是出在执行上，而是出在规则上——这时候修改规则比恢复状态更有效。 ::: :::info 下一步 diff --git a/docs/02-user-guide/05-super-document/02-collaborative-writing.md b/docs/02-user-guide/05-super-document/02-collaborative-writing.md index fbff88b..0e444b5 100644 --- a/docs/02-user-guide/05-super-document/02-collaborative-writing.md +++ b/docs/02-user-guide/05-super-document/02-collaborative-writing.md @@ -83,12 +83,18 @@ keywords: [协作写作, AI 写作, 文档编辑, 多轮迭代] 完成文档后，你可以导出为 docx 或 PDF 格式，方便在其他场景使用。详见 [版本历史](./05-version-history.md)。 ::: +较新的导出流程会复用统一文档渲染链路。Markdown、SuperDoc 编辑器和智能体导出的 PDF 会尽量保持一致的标题、表格、代码块、图片和公式样式；DOCX 导出会通过 HTML 到 DOCX 的管线保留常见排版结构。 + ## 编辑和修改 除了通过对话让智能体修改，你也可以直接在编辑器中手动编辑文档内容。手动编辑的内容同样会被记录在版本历史中。 **智能体修改和手动编辑可以混合使用**——比如让智能体生成初稿后，你手动微调措辞，再让智能体补充一个段落。 +## 历史按钮 + +Markdown 和 SuperDoc 编辑器中会显示「历史」按钮。点击后可以查看当前文件的提交历史、对比版本差异，或恢复到某个历史版本。详见 [版本历史](./05-version-history.md)。 + ## 下一步 - [Diff 可视化](./03-diff-view.md) — 深入了解如何阅读修改对比视图 diff --git a/docs/02-user-guide/05-super-document/03-diff-view.md b/docs/02-user-guide/05-super-document/03-diff-view.md index 569d9d3..d6140f8 100644 --- a/docs/02-user-guide/05-super-document/03-diff-view.md +++ b/docs/02-user-guide/05-super-document/03-diff-view.md @@ -8,6 +8,12 @@ keywords: [Diff 视图, 修改对比, 可视化, 变更追踪] 超级文书的 Diff 视图让你清楚看到智能体修改了什么。每一处新增、删除和替换都用颜色标记出来，就像代码的 diff 一样直观。 +较新的 SuperDoc 使用原地 inline diff：删除内容以红色标记，新增内容以绿色标记，修改位置直接出现在正文中。这样你不需要在多个面板之间来回切换，就能逐条接受或拒绝。 + +:::info 流式编辑期间 +智能体仍在流式写入时，接受/拒绝按钮会暂时禁用，避免你在内容尚未稳定时确认局部变更。 +::: + ## 什么是 Diff 视图 当智能体修改你的文档后，超级文书不会直接替换原文，而是以 Diff（差异）的形式展示修改前后的对比。这样你可以： 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 c376a29..b3ab36b 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 @@ -10,14 +10,16 @@ keywords: [版本历史, 版本管理, 回溯, 版本对比, 回滚] ## 查看文档的版本历史 -点击编辑器右上角的"版本历史"按钮，打开版本时间线面板。你会看到： +点击编辑器右上角的"历史"或"版本历史"按钮，打开版本时间线面板。你会看到： - **版本列表**：按时间倒序排列，最新的版本在最上方 - **版本摘要**：每个版本附带一句简短说明（例如"润色第二段措辞"） - **操作人**：标记是智能体修改还是你手动编辑 - **时间戳**：精确到分钟 -超级文书的版本分为三个粒度层级： +在当前实现中，版本历史基于文件的 Git 提交记录。每次智能体修改、手动编辑、导出前的重要保存点都会形成可追溯记录。 + +超级文书可能按以下粒度展示版本： | 粒度 | 说明 | 示例 | |---|---|---| @@ -76,8 +78,9 @@ keywords: [版本历史, 版本管理, 回溯, 版本对比, 回滚] | 格式 | 说明 | |---|---| +| **Markdown** | 保留源文档结构，适合继续编辑 | | **docx** | Word 文档格式，支持标题、段落、列表、图片和表格 | -| **PDF** | 通过 Markdown 渲染生成 PDF | +| **PDF** | 使用统一渲染链路生成，保留标题、表格、代码块、图片和公式 | 点击编辑器右上角的"导出"按钮，选择目标格式即可。 diff --git a/docs/05-more/06-file-formats.md b/docs/05-more/06-file-formats.md index 9c56acc..6d8d1d6 100644 --- a/docs/05-more/06-file-formats.md +++ b/docs/05-more/06-file-formats.md @@ -8,7 +8,22 @@ keywords: [文件格式, AgentFS, agent.json, SKILL.md, 记忆, 准则] AgentFS 把智能体的身份、行为、记忆、技能和运行策略保存为普通文件。你可以通过界面编辑，也可以在了解字段含义后直接修改文件。 -## agent.json -- 智能体入口配置 +## 读取与导出格式矩阵 + +| 格式 | 读取支持 | 导出支持 | 说明 | +|------|----------|----------|------| +| Markdown (`.md`) | 是 | 是 | 聊天、文档和 Skill 的主要文本格式 | +| PDF (`.pdf`) | 是 | 是 | 支持文本提取、按页视觉读取、长 PDF 分段读取 | +| Word (`.docx`) | 是 | 是 | Office 类技能可读写，SuperDoc 可导出 | +| Excel / CSV | 是 | 视技能而定 | 数据分析和表格处理常用 | +| PowerPoint | 是 | 视技能而定 | 演示文稿技能可处理 | +| 图片 | 是 | 是 | 支持视觉理解、对话嵌入、图像生成 | +| draw.io (`.drawio`) | 是 | 是 | 图表可在本地 draw.io 编辑器中打开 | +| ZIP | 是 | 是 | Agent、Team、Skill 导入导出 | + +PDF 读取会根据文件大小和内容选择策略：文字页优先文本提取，扫描页或图表页可渲染为图片交给视觉模型；大文件会按范围读取，避免一次性加载过多内容。 + +## agent.json -- 智能体身份配置 每个智能体根目录下都有 `agent.json`，用于定义智能体身份、默认模型、权限和运行时注入策略。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/07-markdown-rendering.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/07-markdown-rendering.md new file mode 100644 index 0000000..08ff36b --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/07-markdown-rendering.md @@ -0,0 +1,42 @@ +--- +title: Markdown and Chart Rendering +description: Learn how DesireCore renders Markdown, Mermaid, KaTeX, local file paths, and chart previews. +keywords: [Markdown, Mermaid, KaTeX, LaTeX, charts, formulas, file links] +--- + +# Markdown and Chart Rendering + +Companion replies are rendered as rich Markdown. Headings, lists, tables, code blocks, formulas, and diagrams can be read directly in the chat, and copied either as plain text or as Markdown. + +## Supported Content + +| Content | Behavior | +|---------|----------| +| Markdown | Headings, lists, tables, and code blocks are formatted automatically | +| Mermaid | Rendered as diagrams with fullscreen preview | +| KaTeX / LaTeX | Inline and block math are typeset | +| `.md` paths | Trusted assistant replies can expose clickable local Markdown paths | +| Images | Image attachments can be previewed and exported | + +## Mermaid Diagrams + +Mermaid blocks are rendered inline. Click a diagram to open fullscreen preview, then zoom with the wheel, drag to pan, or reset the view to fit the screen. + +If rendering fails, DesireCore keeps the original code block so you can ask the Companion to fix it. + +## Math Formulas + +DesireCore supports common LaTeX syntax: + +- Inline: `$E = mc^2$` +- Block: `$$\int_a^b f(x) dx$$` + +Long formulas scroll inside the message bubble instead of breaking the layout. + +## Copying + +| Action | Result | +|--------|--------| +| Copy | Plain text for chat or regular documents | +| Copy Markdown | Preserves headings, lists, code blocks, tables, and diagram source | + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/08-exporting-conversations.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/08-exporting-conversations.md new file mode 100644 index 0000000..1190ffa --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/08-exporting-conversations.md @@ -0,0 +1,32 @@ +--- +title: Exporting Conversations +description: Export DesireCore conversations as Markdown or PDF with control over scope and detail. +keywords: [conversation export, Markdown export, PDF export, multi-select, chat history] +--- + +# Exporting Conversations + +You can save conversations as Markdown or PDF for archiving, sharing, reports, or further editing. + +## Entry Points + +Open the chat header menu and choose Export Conversation. If multi-select mode is active, you can export the selected run range. + +Before exporting, choose: + +- Format: Markdown or PDF +- Scope: current session, full history, or selected run range +- Tool calls: hidden, summarized, or fully expanded +- Whether to include thinking / system details +- Whether to embed image attachments + +:::info Multi-select scope +Multi-select export groups messages by their run so tool results, context, and image references remain complete. It is not a naive line-by-line message concatenation. +::: + +## Markdown vs PDF + +Markdown is best when you want to keep editing. PDF is best for sharing with people who do not need the source structure. + +Desktop PDF export uses the unified document rendering pipeline and preserves common Markdown structures such as headings, tables, code blocks, images, and formulas. + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/09-context-control.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/09-context-control.md new file mode 100644 index 0000000..77f0b9a --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/09-context-control.md @@ -0,0 +1,34 @@ +--- +title: Context Control +description: Use /new, /compact, and automatic compaction to manage long conversations. +keywords: [context, compaction, /new, /compact, CompactSession, long conversations] +--- + +# Context Control + +DesireCore keeps the visible conversation history, but each model call has a finite context window. Context control lets long conversations continue without deleting the visible history. + +## `/new` + +`/new` creates a new context boundary in the same conversation. + +- Visible history remains available +- Future model calls stop automatically reading the full content before the boundary +- Useful when switching topics or starting a fresh task + +## `/compact` + +`/compact` summarizes older messages and uses that summary as part of future context. + +- Original history remains visible +- The model mainly reads the summary plus recent turns +- Useful for long tasks, writing sessions, and multi-step reviews + +## Automatic Compaction + +When a conversation approaches the model's context limit, DesireCore can compact old context automatically. This prevents sudden failures while retaining goals, decisions, completed steps, and open tasks. + +## CompactSession + +Some agents can call `CompactSession` themselves when they detect a long-running task. It keeps the UI history intact and only changes what future model calls read. + diff --git a/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/10-rewind-checkpoints.md b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/10-rewind-checkpoints.md new file mode 100644 index 0000000..1973a1d --- /dev/null +++ b/i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/10-rewind-checkpoints.md @@ -0,0 +1,31 @@ +--- +title: Rewind and Checkpoints +description: Use rewind checkpoints to restore conversation and agent working state. +keywords: [Rewind, Checkpoint, rollback, restore state] +--- + +# Rewind and Checkpoints + +Rewind / Checkpoint lets you return to a stable point when an agent goes in the wrong direction. It can restore conversation state as well as files, media, AgentFS, memory, and skills managed by DesireCore. + +## Entry Points + +- Type `/rewind` +- Use the message action bar +- Open the chat header menu +- Press `Cmd + Alt + Z` on macOS or `Ctrl + Alt + Z` on Windows/Linux + +## Modes + +| Mode | Effect | +|------|--------| +| Conversation only | Return to before a selected user message | +| State only | Restore files, media, AgentFS, memory, or skills | +| Conversation + state | Restore both | + +Before applying, DesireCore shows an impact preview. The old branch remains in history. + +## Limits + +Rewind restores DesireCore-managed local state. It usually cannot undo external side effects such as sent emails, pushed commits, external API calls, or third-party approvals. +