docs: update conversation workflow docs#22
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
yi-ge
force-pushed
the
codex/docs-conversation-task-workflows
branch
from
2d9336a to
edfe35a
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates DesireCore’s user-facing documentation to reflect recent conversation workflow and task execution UX changes, including context management, export, rewind/checkpoints, richer rendering, and updated SuperDoc/history behaviors. It also adds English mirrors for the new conversation workflow pages.
Changes:
- Added new conversation docs pages covering Markdown/chart rendering, exporting conversations, context control, and rewind/checkpoints (CN + EN mirrors).
- Updated delegation docs to document newer execution monitoring UI (task board), ask-vs-human-gate distinction, and expanded receipts guidance.
- Updated SuperDoc docs (diff view, version history, export pipeline notes) and added a file-format support matrix.
Reviewed changes
Copilot reviewed 23 out of 23 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/10-rewind-checkpoints.md | Adds EN doc for rewind/checkpoints. |
| i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/09-context-control.md | Adds EN doc for /new, /compact, and compaction concepts. |
| i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/08-exporting-conversations.md | Adds EN doc for exporting conversations (Markdown/PDF). |
| i18n/en/docusaurus-plugin-content-docs/current/02-user-guide/02-conversations/07-markdown-rendering.md | Adds EN doc for Markdown/Mermaid/KaTeX rendering behaviors. |
| docs/05-more/06-file-formats.md | Adds a read/export format matrix and clarifies file-format handling. |
| docs/02-user-guide/05-super-document/05-version-history.md | Updates version history description and export format notes. |
| docs/02-user-guide/05-super-document/03-diff-view.md | Documents newer inline diff behavior and streaming edit constraints. |
| docs/02-user-guide/05-super-document/02-collaborative-writing.md | Notes unified rendering pipeline and adds “历史按钮” guidance. |
| docs/02-user-guide/04-delegation/05-receipts.md | Expands receipt types and updates rollback/recovery guidance. |
| docs/02-user-guide/04-delegation/04-human-gate.md | Clarifies ask-card vs human-gate approval distinctions and behaviors. |
| docs/02-user-guide/04-delegation/03-execution-monitoring.md | Adds task-board documentation and steer/rewind guidance for long tasks. |
| docs/02-user-guide/02-conversations/10-rewind-checkpoints.md | Adds CN doc for rewind/checkpoints. |
| docs/02-user-guide/02-conversations/09-context-control.md | Adds CN doc for context control (/new, /compact, auto compaction). |
| docs/02-user-guide/02-conversations/08-exporting-conversations.md | Adds CN doc for exporting conversations. |
| docs/02-user-guide/02-conversations/07-markdown-rendering.md | Adds CN doc for Markdown/chart rendering behavior and safety boundary. |
| docs/02-user-guide/02-conversations/06-managing-conversations.md | Adds guidance on context management vs clearing chat history. |
| docs/02-user-guide/02-conversations/05-chat-history.md | Adds multi-select/export coverage and non-completed run visibility. |
| docs/02-user-guide/02-conversations/04-model-selection.md | Updates model picker grouping/metadata and availability rules. |
| docs/02-user-guide/02-conversations/03-cards.md | Expands cards/components coverage (ask/approval/task board) and links. |
| docs/02-user-guide/02-conversations/02-message-types.md | Expands rich-content and ask-card/heartbeat behavior documentation. |
| docs/02-user-guide/02-conversations/01-sending-messages.md | Adds drag-to-chat behaviors, next-message prediction, and updated slash commands/shortcuts. |
| docs/02-user-guide/01-interface/06-notifications.md | Expands notification categories and approval/Markdown-preview behavior. |
| docs/02-user-guide/01-interface/04-chat-area.md | Updates chat header/menu capabilities and message action bar behaviors. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
17
to
+21
| | [工作流执行卡片](#工作流执行卡片) | 绿色 | Companion 按计划执行多步骤任务 | "我正在按步骤做" | | ||
| | [行动回执卡片](#行动回执卡片) | 绿/橙/蓝 | 操作完成后汇报结果 | "我做了什么，结果如何" | | ||
| | [问答卡片](#问答卡片) | 蓝色 | Companion 需要你补充信息 | "我需要你选一下" | | ||
| | [审批卡片](#审批卡片) | 橙/红 | 高风险操作执行前 | "请确认是否允许" | | ||
| | [任务板](#任务板) | 绿色/蓝色 | 长任务拆解和执行中 | "这些子任务正在推进" | |
Comment on lines
+3
to
+9
| 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. |
Comment on lines
+83
to
87
| ## 通过回执追溯和恢复 | ||
|
|
||
| 如果你对执行结果不满意，可以基于回执进行回滚。DesireCore 支持多个粒度的回滚： | ||
| 如果你对执行结果不满意，先用回执确认影响范围，再使用 Rewind / Checkpoint 恢复到合适状态。较新的 DesireCore 会优先基于检查点恢复，而不是依赖单个步骤的手工回滚。 | ||
|
|
||
| | 回滚级别 | 含义 | 适用场景 | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updates the user-facing conversation and task workflow documentation based on recent v10.0.46-v10.0.82 product changes.
Validation
npm run typechecknpm run buildThis is the first PR in the functional-docs stack.