@a3s-lab/office 0.7.3 → 0.8.0

package/COLLABORATION_ROADMAP.md

@@ -22,9 +22,9 @@ which tracks editor capability parity with WPS.
   the local binding origin, so one participant cannot undo another
   participant's operation.
 - `view`, `comment`, `suggest`, and `edit` are explicit session modes. A format
-  enables a mode only after its durable model exists. Document now enables
-  durable review-only `comment`; unsupported mode/format pairs remain
-  read-only.
+  enables a mode only after its durable model exists. Document enables durable
+  review-only `comment` plus actor-attributed `suggest`; unsupported
+  mode/format pairs remain read-only.
 - Editors never collaborate by repeatedly replacing one serialized OOXML file
   or one universal JSON blob. Each format gets a typed, conflict-local model.
 
@@ -44,6 +44,7 @@ Protocol v1 reserves the `a3s.office` namespace.
 | `document.content` | `Y.XmlFragment` | ProseMirror document, including section layout, comment anchors, and tracked-change marks. |
 | `document.options` | `Y.Map` | Document-level editable options such as page color and tracking mode. |
 | `document.comments` / `document.comment-order` | `Y.Map` / `Y.Array` | ID-keyed durable comment/reply records and deterministic presentation order. |
+| `document.change-decisions` / `document.change-decision-order` | `Y.Map` / `Y.Array` | Immutable accept/reject audit records and deterministic decision order. |
 | `document.bibliography*` | Typed maps/arrays | Bibliography settings and ID-keyed citation sources. |
 | `spreadsheet.*` | Typed maps/arrays | Sheet order, field-addressed sparse cells, formulas, styles, objects, names, and print state. |
 | `presentation.*` | Typed maps/arrays | Slide/master/layout order, ID-keyed scene objects, notes, transitions, and comments. |
@@ -92,11 +93,11 @@ Status: implemented in the browser library.
   Origin validation, permission enforcement, WebSocket rooms, durable Yrs
   persistence, ephemeral Awareness relay, reconnect repair, and service-owned
   durable update polling. Version-2 tickets bind actor display name and the
-  durable store semantically authorizes Document comment-mode updates under
-  the room lock before persistence or broadcast. Its browser adapter converts
-  bounded base64 wire payloads back to the package's typed `Uint8Array`
-  transport envelope and verifies the ready identity against the local
-  session.
+  durable store semantically authorizes Document comment- and suggestion-mode
+  updates under the room lock before persistence or broadcast. Its browser
+  adapter converts bounded base64 wire payloads back to the package's typed
+  `Uint8Array` transport envelope and verifies the ready identity against the
+  local session.
 - Convergence, offline/reconnect, transport-boundary, presence, permission,
   StrictMode, framework-parity, ownership, backend persistence, room broadcast,
   ticket tamper, and read-only authorization tests.
@@ -109,9 +110,9 @@ Redis/NATS fan-out plus a distributed writer/lock policy.
 
 Status: browser collaboration foundation, participant roster, remote
 selection/caret projection, participant navigation, durable review-only
-comment mode, and native text/options/bounded structural paragraph/comment
-mutations implemented; rich native parity and suggestion authorization are
-pending.
+comment and suggestion modes, immutable suggestion-decision audit, and native
+text/options/bounded structural paragraph/comment mutations implemented; rich
+native mutation parity remains pending.
 
 - TipTap is bound to `document.content` through
   `@tiptap/extension-collaboration`; StarterKit undo/redo is disabled and the
@@ -152,6 +153,19 @@ pending.
   immutable creation claim; removing an anchor through an authorized content
   edit retains a detached thread. Remote review changes do not enter local undo
   history.
+- Authenticated Document `suggest` sessions create attributed insertion,
+  deletion, and replacement proposals as `documentChange` marks. Their
+  canonical projection is unchanged until an `edit` participant decides the
+  proposal. Suggesters may withdraw their own insertion proposals, but cannot
+  change canonical text, structure, non-suggestion formatting, options,
+  comments, bibliography, another actor's proposal, or a deletion proposal's
+  targeted canonical text.
+- Accepting or rejecting a suggestion applies the tracked change and appends
+  one immutable actor-attributed record to `document.change-decisions` plus its
+  deterministic order root in the same transaction. Identical offline retries
+  converge, a second conflicting final decision fails closed, old Documents
+  without the additive roots remain readable, and a final decision clears
+  local history that could otherwise resurrect the decided mark.
 - Rust, CLI, MCP, and A3S Code expose `document-comment-create`,
   `document-comment-reply`, `document-comment-set-resolved`, and
   `document-comment-delete`. Projection schema v2 returns attributable threads,
@@ -159,16 +173,20 @@ pending.
   offsets, resolution, and detached state. Native and browser fixtures cover
   restart, reordered delivery, stale anchor guards, idempotent retries,
   ownership failures, and cross-language convergence.
-- The A3S Boot backend permits `edit` content/review updates and semantically
-  validated Document `comment` review-only updates. Signed actor display name
-  must match the session actor and every new record author. Forged roots,
-  content, structure, options, authorship, order, claims, anchors, or foreign
-  deletion fail before the durable store changes.
+- The A3S Boot backend permits `edit` content/review updates, semantically
+  validated Document `comment` review-only updates, and semantically validated
+  Document `suggest` proposal updates. Signed actor identity and display name
+  must match every new comment, reply, or suggestion. Forged roots, canonical
+  content, structure, options, non-suggestion formatting, authorship, order,
+  claims, anchors, foreign deletion, or foreign suggestion changes fail before
+  the durable store changes.
 
 Remaining:
 
-- Add suggestion-only authorization and durable accept/reject decision audit
-  records; `suggest` remains read-only until that model exists.
+- Add closed typed native projection and mutation variants for creating
+  Document suggestions and deciding them through CLI/MCP/A3S Code. The current
+  typed native mutation set can synchronize the resulting Yjs state but does
+  not originate these two workflows.
 - Prove concurrent full-table, list-restructure, section, comment, and revision
   workflows, plus DOCX import/export after merged edits.
 - Expand native convergence from bounded paragraph edits to complete table,
@@ -369,11 +387,12 @@ destructive actions remain attributable, reviewable, and non-retryable.
 ### Phase 6: CLI, MCP, and coding agents
 
 Status: native Yrs replica store, resumable CLI/MCP event streams, `a3s code`
-projection, a host-injected live CLI transport session, and typed Markdown,
-Document content/comment, Spreadsheet cell, Presentation scene-element, PDF
-annotation/form-value, and PDF redaction/page-operation review mutation
-surfaces are implemented; the remaining format mutations and native presence
-projection are pending.
+projection, a host-injected live CLI transport session, authenticated browser
+suggestion-update authorization, and typed Markdown, Document content/comment,
+Spreadsheet cell, Presentation scene-element, PDF annotation/form-value, and
+PDF redaction/page-operation review mutation surfaces are implemented; typed
+native Document suggestion/decision mutations, the remaining format mutations,
+and native presence projection are pending.
 
 - Yrs `0.27.3` now uses 53-bit Yjs-compatible client IDs and exchanges standard
   Yjs v1 updates, state vectors, and y-sync `SyncStep1`/`Update` messages with
@@ -422,6 +441,13 @@ projection are pending.
   require `edit`; Document review mutations accept `edit` or `comment`, with
   ownership-restricted deletion in `comment`. Raw remote updates remain
   receivable in every mode so read-only peers still converge.
+- Host-authenticated Document `suggest` transport updates are semantically
+  checked in Yrs before commit: only attributed insertion/deletion/replacement
+  proposals owned by the authenticated actor may be added or withdrawn, while
+  canonical state and every non-suggestion root remain protected. This is a
+  transport authorization path, not a `NativeOfficeCollaborationMutation`;
+  `collab mutate`, `office_collaboration_mutate`, and projection v2 do not yet
+  expose native typed suggestion creation or final-decision operations.
 - Rust `project`, `collab read`, and `office_collaboration_read` interpret the
   Office-owned browser schema inside Office rather than in a product host.
   Markdown returns its exact canonical source. Document returns bounded
@@ -483,8 +509,9 @@ Remaining:
 
 - Extend typed format-model mutations to Spreadsheet and remaining Presentation
   structural/rich-text operations plus PDF signatures; deepen Document
-  mutations to additional nested structures and tracked suggestion decisions
-  before enabling `suggest` for local mutation.
+  mutations to additional nested structures and add typed suggestion creation,
+  suggestion projection, and tracked final-decision operations for native
+  clients.
 - Project editor-visible presence and selection state while keeping Awareness
   ephemeral and outside native replica persistence.
 
@@ -506,5 +533,5 @@ valid update delivery orders.
 - Shipping a hosted collaboration backend inside the component package.
 - Treating awareness as authorization or durable audit history.
 - Hiding provider synchronization behind editor mount.
-- Claiming comments or suggestions are supported by a format until its durable
-  review schema and accept/reject semantics are implemented.
+- Claiming comments or suggestions are supported by a format that lacks a
+  durable review schema and, for suggestions, explicit accept/reject semantics.

package/README.md

@@ -46,6 +46,9 @@ workflows, and a separate Rust automation plane.
   permissions, collaboration, and model providers.
 - **Collaborate across every editor** with shared Yjs/Yrs content, Awareness
   participants and remote locations, plus browser, CLI, MCP, and A3S Code peers.
+  Document reviewers can submit attributed insertions, deletions, and
+  replacements without directly changing canonical text; editors accept or
+  reject each proposal with an immutable shared decision record.
 - **Automate deterministically** through the native CLI, standard MCP server,
   or packaged Office Skill.
 
@@ -162,7 +165,15 @@ bindings, local undo, validated presence, and conflict-local typed mutations.
 An authenticated Document `comment` session can select text, create a durable
 thread, reply, resolve or reopen it, and delete only review records owned by
 its actor while canonical content remains read-only. The server independently
-validates that review-only boundary before persistence and broadcast.
+validates that review-only boundary before persistence and broadcast. An
+authenticated Document `suggest` session can submit attributed insertions,
+deletions, and replacements while canonical text, structure, formatting,
+options, comments, and other actors' suggestions remain protected. An `edit`
+participant accepts or rejects a proposal and appends the final actor-attributed
+decision to the immutable `document.change-decisions` audit trail. The A3S Boot
+service validates both comment and suggestion semantics under the durable room
+lock before it persists or broadcasts caller-supplied Yjs bytes. `suggest` on
+non-Document formats remains receive-only.
 See the bilingual [real-time collaboration guide](https://a3s-lab.github.io/Office/docs/components/collaboration.html)
 for React, Vue, Web Component, reconnect, security, and native-agent setup.
 The repository also ships a runnable
@@ -1258,6 +1269,7 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.8.0 documentation](https://a3s-lab.github.io/Office/docs/0.8.0/)
 - [A3S Office 0.7.3 documentation](https://a3s-lab.github.io/Office/docs/0.7.3/)
 - [A3S Office 0.7.2 documentation](https://a3s-lab.github.io/Office/docs/0.7.2/)
 - [A3S Office 0.7.1 documentation](https://a3s-lab.github.io/Office/docs/0.7.1/)

package/dist/0~document-editor.js

@@ -605,7 +605,7 @@ function DocumentTaskPane({ ariaLabel, title, description, closeLabel, className
 const DOCUMENT_CHANGE_ITEM_HEIGHT = 84;
 const DOCUMENT_CHANGE_ITEM_GAP = 7;
 const DOCUMENT_CHANGE_LIST_PADDING_TOP = 10;
-function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesChange, onClose }) {
+function DocumentChangesPanel({ editor, changes, decisions = [], trackChanges, suggestionOnly = false, onDecideChanges, onTrackChangesChange, onClose }) {
     const officeDialog = useOfficeDialog();
     const decisionButtonRefs = useRef(new Map());
     const pendingFocusRef = useRef(null);
@@ -654,7 +654,9 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
             decision
         };
         setRovingChangeKey(nextChangeKey);
-        const handled = 'accept' === decision ? editor.commands.acceptDocumentChange(change.id) : editor.commands.rejectDocumentChange(change.id);
+        const handled = onDecideChanges ? onDecideChanges([
+            change
+        ], decision) : 'accept' === decision ? editor.commands.acceptDocumentChange(change.id) : editor.commands.rejectDocumentChange(change.id);
         if (!handled) {
             pendingFocusRef.current = null;
             setRovingChangeKey(currentChangeKey);
@@ -673,7 +675,8 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
             confirmLabel: '全部接受'
         });
         if (confirmed && !editor.isDestroyed) {
-            editor.commands.acceptAllDocumentChanges();
+            if (onDecideChanges) onDecideChanges(changes, 'accept');
+            else editor.commands.acceptAllDocumentChanges();
             requestAnimationFrame(()=>{
                 if (!editor.isDestroyed) editor.view.dom.focus();
             });
@@ -687,7 +690,8 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
             confirmTone: 'danger'
         });
         if (confirmed && !editor.isDestroyed) {
-            editor.commands.rejectAllDocumentChanges();
+            if (onDecideChanges) onDecideChanges(changes, 'reject');
+            else editor.commands.rejectAllDocumentChanges();
             requestAnimationFrame(()=>{
                 if (!editor.isDestroyed) editor.view.dom.focus();
             });
@@ -698,11 +702,11 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
             /*#__PURE__*/ jsxs(DocumentTaskPane, {
                 className: "work-document-changes-panel",
                 title: "修订审阅",
-                description: changes.length ? `${changes.length} 项待处理` : '没有待处理的修订',
+                description: changes.length ? `${changes.length} 项待处理 · ${decisions.length} 项已决定` : decisions.length ? `没有待处理的修订 · ${decisions.length} 项已决定` : '没有待处理的修订',
                 closeLabel: "关闭修订审阅",
                 onClose: onClose,
                 children: [
-                    changes.length > 0 && /*#__PURE__*/ jsxs("div", {
+                    changes.length > 0 && !suggestionOnly && /*#__PURE__*/ jsxs("div", {
                         className: "work-document-changes-bulk-actions",
                         children: [
                             /*#__PURE__*/ jsxs(button_Button, {
@@ -778,7 +782,7 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
                                             })
                                         ]
                                     }),
-                                    /*#__PURE__*/ jsxs("div", {
+                                    !suggestionOnly && /*#__PURE__*/ jsxs("div", {
                                         children: [
                                             /*#__PURE__*/ jsxs(button_Button, {
                                                 ref: (element)=>{
@@ -822,7 +826,7 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
                         children: /*#__PURE__*/ jsx(CollectionState, {
                             className: "work-document-changes-empty",
                             icon: /*#__PURE__*/ jsx(FileDiff, {}),
-                            actions: /*#__PURE__*/ jsx(button_Button, {
+                            actions: suggestionOnly ? void 0 : /*#__PURE__*/ jsx(button_Button, {
                                 size: "compact",
                                 tone: trackChanges ? 'quiet' : 'primary',
                                 onClick: ()=>onTrackChangesChange(!trackChanges),
@@ -830,8 +834,11 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
                             }),
                             tone: trackChanges ? 'info' : 'neutral',
                             role: "status",
-                            children: trackChanges ? '正在记录新的改动。' : '当前没有记录新的改动。'
+                            children: suggestionOnly ? '建议模式会自动记录带身份的新改动。' : trackChanges ? '正在记录新的改动。' : '当前没有记录新的改动。'
                         })
+                    }),
+                    decisions.length > 0 && /*#__PURE__*/ jsx(DocumentChangeDecisionHistory, {
+                        decisions: decisions
                     })
                 ]
             }),
@@ -839,6 +846,49 @@ function DocumentChangesPanel({ editor, changes, trackChanges, onTrackChangesCha
         ]
     });
 }
+function DocumentChangeDecisionHistory({ decisions }) {
+    const visible = decisions.slice(-20).reverse();
+    return /*#__PURE__*/ jsxs("section", {
+        className: "work-document-change-decisions",
+        "aria-label": "修订决定记录",
+        children: [
+            /*#__PURE__*/ jsxs("header", {
+                children: [
+                    /*#__PURE__*/ jsx("strong", {
+                        children: "决定记录"
+                    }),
+                    /*#__PURE__*/ jsxs("span", {
+                        children: [
+                            decisions.length,
+                            " 项"
+                        ]
+                    })
+                ]
+            }),
+            /*#__PURE__*/ jsx("ol", {
+                children: visible.map((decision)=>/*#__PURE__*/ jsxs("li", {
+                        "data-document-change-decision": decision.decision,
+                        children: [
+                            /*#__PURE__*/ jsx("span", {
+                                children: 'accept' === decision.decision ? '已接受' : '已拒绝'
+                            }),
+                            /*#__PURE__*/ jsx("strong", {
+                                children: decision.text.trim() || '（空白字符）'
+                            }),
+                            /*#__PURE__*/ jsxs("small", {
+                                children: [
+                                    decision.suggestedBy,
+                                    " → ",
+                                    decision.decidedBy,
+                                    decision.decidedAt ? ` · ${formatChangeDate(decision.decidedAt)}` : ''
+                                ]
+                            })
+                        ]
+                    }, decision.id))
+            })
+        ]
+    });
+}
 function documentChangeDecisionKey(changeKey, decision) {
     return `${changeKey}:${decision}`;
 }
@@ -11696,7 +11746,7 @@ function headingLevelForShortcut(code, key) {
     if ('3' === value) return 3;
     return null;
 }
-function DocumentToolbar({ editor, defaultRibbonCollapsed = false, reviewOnly = false, history, layoutOpen, layout, layoutFonts = [], navigationOpen, pageColor, showPageNumbers, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onLayoutChange, onOpenLayout, onToggleNavigation, onTogglePageNumbers, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onZoomFit, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onOpenWordCount, onOpenFindReplace }) {
+function DocumentToolbar({ editor, defaultRibbonCollapsed = false, reviewOnly = false, suggestionOnly = false, history, layoutOpen, layout, layoutFonts = [], navigationOpen, pageColor, showPageNumbers, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onLayoutChange, onOpenLayout, onToggleNavigation, onTogglePageNumbers, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onZoomFit, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onDecideChange, onOpenWordCount, onOpenFindReplace }) {
     const [activeTab, setActiveTab] = useState(reviewOnly ? 'review' : 'home');
     const officeDialog = useOfficeDialog();
     const prompt = officeDialog.prompt;
@@ -11901,7 +11951,7 @@ function DocumentToolbar({ editor, defaultRibbonCollapsed = false, reviewOnly =
             changes[index + 1]?.id,
             changes[index - 1]?.id
         ].filter((id)=>Boolean(id));
-        const handled = 'accept' === decision ? editor.commands.acceptDocumentChange(change.id) : editor.commands.rejectDocumentChange(change.id);
+        const handled = onDecideChange ? onDecideChange(change, decision) : 'accept' === decision ? editor.commands.acceptDocumentChange(change.id) : editor.commands.rejectDocumentChange(change.id);
         if (!handled) return;
         const remaining = collectDocumentChanges(editor.state.doc);
         const next = nextIds.map((id)=>remaining.find((candidate)=>candidate.id === id)).find((candidate)=>Boolean(candidate));
@@ -11925,7 +11975,7 @@ function DocumentToolbar({ editor, defaultRibbonCollapsed = false, reviewOnly =
                 adaptive: true,
                 collapsible: true,
                 fileActions: fileActions,
-                quickAccessActions: reviewOnly ? [] : [
+                quickAccessActions: reviewOnly && !suggestionOnly ? [] : [
                     {
                         id: undoCommand.id,
                         label: undoCommand.label,
@@ -12180,7 +12230,7 @@ function DocumentToolbar({ editor, defaultRibbonCollapsed = false, reviewOnly =
                                     })
                                 })
                             }),
-                            /*#__PURE__*/ jsxs(document_toolbar_RibbonGroup, {
+                            !suggestionOnly && /*#__PURE__*/ jsxs(document_toolbar_RibbonGroup, {
                                 label: "批注",
                                 priority: "high",
                                 children: [
@@ -12207,18 +12257,20 @@ function DocumentToolbar({ editor, defaultRibbonCollapsed = false, reviewOnly =
                                     })
                                 ]
                             }),
-                            !reviewOnly && /*#__PURE__*/ jsxs(Fragment, {
+                            (!reviewOnly || suggestionOnly) && /*#__PURE__*/ jsxs(Fragment, {
                                 children: [
                                     /*#__PURE__*/ jsxs(document_toolbar_RibbonGroup, {
                                         label: "修订",
                                         priority: "high",
                                         children: [
                                             /*#__PURE__*/ jsx(document_toolbar_ToolbarButton, {
-                                                label: "修订模式",
+                                                label: suggestionOnly ? '建议模式' : '修订模式',
                                                 displayLabel: true,
                                                 shortcut: trackChangesCommand.shortcut?.label,
                                                 ariaKeyShortcuts: trackChangesCommand.shortcut?.aria,
-                                                active: trackChanges,
+                                                active: suggestionOnly || trackChanges,
+                                                disabled: suggestionOnly,
+                                                title: suggestionOnly ? '建议模式始终记录带身份的文字修订' : void 0,
                                                 onClick: onToggleTrackChanges,
                                                 children: /*#__PURE__*/ jsx(FileDiff, {
                                                     size: 19
@@ -12235,7 +12287,7 @@ function DocumentToolbar({ editor, defaultRibbonCollapsed = false, reviewOnly =
                                             })
                                         ]
                                     }),
-                                    /*#__PURE__*/ jsxs(document_toolbar_RibbonGroup, {
+                                    !suggestionOnly && /*#__PURE__*/ jsxs(document_toolbar_RibbonGroup, {
                                         label: "更改",
                                         priority: "high",
                                         children: [
@@ -14186,10 +14238,13 @@ function DocumentReviewConflictNotice({ conflicts, onDismiss }) {
 }
 const EMPTY_DOCUMENT_LAYOUT_FONTS = [];
 const EMPTY_DOCUMENT_EXTENSIONS = [];
-function createTrackedDocumentChange(_kind) {
+function createTrackedDocumentChange(_kind, actor) {
     return {
         id: createWorkId('change'),
-        author: 'A3S Work 用户',
+        ...actor ? {
+            actorId: actor.id
+        } : {},
+        author: actor?.name ?? 'A3S Work 用户',
         date: new Date().toISOString()
     };
 }
@@ -14212,7 +14267,7 @@ function CollaborativeDocumentEditor(props) {
     if (!initial.current) initial.current = readWorkOfficeDocumentCollaboration(collaboration);
     const bridge = useRef({
         getContent: ()=>initial.current,
-        isTracking: ()=>Boolean(initial.current?.trackChanges),
+        isTracking: ()=>'suggest' === collaboration.mode || Boolean(initial.current?.trackChanges),
         onContentChange: ()=>void 0,
         onTrackingChange: ()=>void 0
     });
@@ -14226,7 +14281,7 @@ function CollaborativeDocumentEditor(props) {
             workExtensions: {
                 getContent: ()=>bridge.current.getContent(),
                 isTracking: ()=>bridge.current.isTracking(),
-                createChange: createTrackedDocumentChange,
+                createChange: (kind)=>createTrackedDocumentChange(kind, collaboration.actor),
                 onContentChange: (content)=>bridge.current.onContentChange(content),
                 onTrackingChange: (enabled)=>bridge.current.onTrackingChange(enabled)
             }
@@ -14256,11 +14311,13 @@ function CollaborativeDocumentEditor(props) {
     });
 }
 function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, collaborationBinding, collaborationBridge, collaborationInitialContent, content, extensions = EMPTY_DOCUMENT_EXTENSIONS, preview: requestedPreview, defaultRibbonCollapsed = false, saveStatus = '已自动保存', kernelWasmUrl, layoutFonts = EMPTY_DOCUMENT_LAYOUT_FONTS, fileActions, getSelectionMenuItems, onChange, onAgentRequest, onReviewConflict }) {
-    const reviewOnly = collaboration?.mode === 'comment' && !requestedPreview;
-    const collaborationInteractive = !collaboration || 'edit' === collaboration.mode || 'comment' === collaboration.mode;
+    const commentOnly = collaboration?.mode === 'comment' && !requestedPreview;
+    const suggestionOnly = collaboration?.mode === 'suggest' && Boolean(collaboration.actor) && !requestedPreview;
+    const collaborationInteractive = !collaboration || 'edit' === collaboration.mode || 'comment' === collaboration.mode || 'suggest' === collaboration.mode && Boolean(collaboration.actor);
     const preview = requestedPreview || !collaborationInteractive;
     const canEditDocument = !preview && (!collaboration || 'edit' === collaboration.mode);
     const canCommentDocument = !preview && (!collaboration || 'edit' === collaboration.mode || 'comment' === collaboration.mode && Boolean(collaboration.actor));
+    const canReviewDocumentChanges = canEditDocument || suggestionOnly;
     const readOnly = preview;
     const initialContentRef = useRef(collaborationInitialContent ?? content);
     const effectiveContent = collaboration ? initialContentRef.current : content;
@@ -14277,7 +14334,7 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
     const statisticsInvokerRef = useRef(null);
     const contentRef = useRef(effectiveContent);
     const onChangeRef = useRef(onChange);
-    const trackChangesRef = useRef(Boolean(effectiveContent.trackChanges));
+    const trackChangesRef = useRef(suggestionOnly || Boolean(effectiveContent.trackChanges));
     const collaborationBindingRef = useRef(collaborationBinding);
     const normalizedContent = useMemo(()=>normalizeDocumentHtml(effectiveContent), [
         effectiveContent
@@ -14312,7 +14369,7 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
     const loadedLayoutFontIds = useDocumentLayoutFonts(layoutFonts);
     if (!collaboration) contentRef.current = content;
     onChangeRef.current = onChange;
-    trackChangesRef.current = Boolean(contentRef.current.trackChanges);
+    trackChangesRef.current = suggestionOnly || Boolean(contentRef.current.trackChanges);
     const commitContentChange = useCallback((next)=>{
         const previous = contentRef.current;
         const binding = collaborationBindingRef.current;
@@ -14323,9 +14380,10 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
     collaborationBindingRef.current = collaborationBinding;
     if (collaborationBridge) collaborationBridge.current = {
         getContent: ()=>contentRef.current,
-        isTracking: ()=>trackChangesRef.current,
+        isTracking: ()=>suggestionOnly || trackChangesRef.current,
         onContentChange: (next)=>commitContentChange(next),
         onTrackingChange: (trackChanges)=>{
+            if (suggestionOnly) return;
             trackChangesRef.current = trackChanges;
             commitContentChange({
                 ...contentRef.current,
@@ -14337,11 +14395,12 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
             ...collaborationBinding?.extensions ?? createWorkDocumentExtensions({
                 getContent: ()=>contentRef.current,
                 isTracking: ()=>trackChangesRef.current,
-                createChange: createTrackedDocumentChange,
+                createChange: (kind)=>createTrackedDocumentChange(kind, collaboration?.actor),
                 onContentChange: (next)=>{
                     commitContentChange(next);
                 },
                 onTrackingChange: (trackChanges)=>{
+                    if (suggestionOnly) return;
                     trackChangesRef.current = trackChanges;
                     const next = {
                         ...contentRef.current,
@@ -14364,12 +14423,12 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
             attributes: {
                 'aria-label': '文档正文',
                 'aria-multiline': 'true',
-                'aria-readonly': reviewOnly ? 'true' : 'false',
+                'aria-readonly': commentOnly ? 'true' : 'false',
                 role: 'textbox',
                 spellcheck: 'true'
             }
         }), [
-        reviewOnly
+        commentOnly
     ]);
     const editor = useEditor({
         extensions: editorExtensions,
@@ -14450,7 +14509,7 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
     const documentComments = useDocumentComments({
         actor: collaboration?.actor,
         contentRef,
-        deleteOwnOnly: reviewOnly,
+        deleteOwnOnly: commentOnly,
         editor,
         enabled: canCommentDocument,
         onBeforeDraft: ()=>setTaskPane(null)
@@ -14463,7 +14522,7 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
         const unsubscribeChange = collaborationBinding.subscribe((change)=>{
             pendingCollaborationContentRef.current = change.content;
             contentRef.current = change.content;
-            trackChangesRef.current = Boolean(change.content.trackChanges);
+            trackChangesRef.current = suggestionOnly || Boolean(change.content.trackChanges);
             setCollaborationVersion((value)=>value + 1);
         });
         const unsubscribeError = collaborationBinding.subscribeError((error)=>{
@@ -14488,7 +14547,7 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
         const next = pendingCollaborationContentRef.current;
         pendingCollaborationContentRef.current = void 0;
         contentRef.current = next;
-        trackChangesRef.current = Boolean(next.trackChanges);
+        trackChangesRef.current = suggestionOnly || Boolean(next.trackChanges);
         onChangeRef.current(next);
     }, [
         collaborationVersion
@@ -14689,7 +14748,7 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
             editor.setEditable(!readOnly);
             const editorDom = editor.view.dom;
             editorDom.setAttribute('role', preview ? 'document' : 'textbox');
-            editorDom.setAttribute('aria-readonly', String(reviewOnly || preview));
+            editorDom.setAttribute('aria-readonly', String(commentOnly || preview));
             if (preview) editorDom.removeAttribute('aria-multiline');
             else editorDom.setAttribute('aria-multiline', 'true');
         };
@@ -14699,10 +14758,10 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
             editor.off('mount', applyEditableState);
         };
     }, [
+        commentOnly,
         editor,
         preview,
-        readOnly,
-        reviewOnly
+        readOnly
     ]);
     useEffect(()=>{
         if (!editor) return;
@@ -14810,6 +14869,11 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
     });
     const finalPageNumber = pagination.pages.at(-1)?.pageNumber ?? Math.max(1, layout.pageNumberStart ?? 1) + pageCount - 1;
     const changes = collectDocumentChanges(editor.state.doc);
+    const decideDocumentChanges = (selectedChanges, decision)=>{
+        if (collaborationBinding) return collaborationBinding.decideChanges(editor, selectedChanges.map(({ id })=>id), decision);
+        const ids = selectedChanges.map(({ id })=>id);
+        return 'accept' === decision ? editor.commands.acceptDocumentChanges(ids) : editor.commands.rejectDocumentChanges(ids);
+    };
     const citationCount = documentCitationCount(editor);
     const textStatistics = documentTextStatistics(editor);
     const paragraphIndent = documentParagraphIndent(editor);
@@ -14943,8 +15007,9 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
             }) : /*#__PURE__*/ jsx(DocumentToolbar, {
                 editor: editor,
                 defaultRibbonCollapsed: defaultRibbonCollapsed,
-                reviewOnly: reviewOnly,
-                history: collaborationBinding && !reviewOnly ? {
+                reviewOnly: commentOnly || suggestionOnly,
+                suggestionOnly: suggestionOnly,
+                history: collaborationBinding && !commentOnly ? {
                     canRedo: collaborationBinding.canRedo(),
                     canUndo: collaborationBinding.canUndo(),
                     redo: ()=>collaborationBinding.redo(),
@@ -14996,7 +15061,7 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
                 commentsOpen: documentComments.open,
                 commentCount: documentComments.comments.length,
                 onToggleComments: ()=>void toggleCommentsPanel(),
-                trackChanges: Boolean(currentContent.trackChanges),
+                trackChanges: suggestionOnly || Boolean(currentContent.trackChanges),
                 changesOpen: changesOpen,
                 changeCount: changes.length,
                 findReplaceMode: findReplaceMode,
@@ -15005,10 +15070,14 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
                     return requestEditorViewChange(keepCurrentPane ? taskPane : null, 'review' !== tab);
                 },
                 onToggleTrackChanges: ()=>{
+                    if (suggestionOnly) return;
                     editor.commands.toggleDocumentTrackChanges();
                     restoreDocumentBodyFocus();
                 },
                 onToggleChanges: ()=>void toggleTaskPane('changes'),
+                onDecideChange: (change, decision)=>decideDocumentChanges([
+                        change
+                    ], decision),
                 onOpenWordCount: openDocumentStatistics,
                 onOpenFindReplace: openFindReplace
             }),
@@ -15174,12 +15243,12 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
                                                                     editor: editor,
                                                                     kind: "document"
                                                                 }),
-                                                                !preview && /*#__PURE__*/ jsx(DocumentSelectionToolbar, {
+                                                                !preview && (canEditDocument || canCommentDocument) && /*#__PURE__*/ jsx(DocumentSelectionToolbar, {
                                                                     editor: editor,
                                                                     canInsertComment: documentComments.canInsert,
                                                                     layoutFonts: layoutFonts,
                                                                     onInsertComment: ()=>void startCommentDraft(),
-                                                                    reviewOnly: reviewOnly
+                                                                    reviewOnly: commentOnly
                                                                 })
                                                             ]
                                                         }),
@@ -15259,11 +15328,14 @@ function DocumentEditorSurface({ artifactId, autoFocus = true, collaboration, co
                         onClose: closeTaskPane,
                         onDirtyChange: setCitationsDirty
                     }),
-                    canEditDocument && changesOpen && /*#__PURE__*/ jsx(DocumentChangesPanel, {
+                    canReviewDocumentChanges && changesOpen && /*#__PURE__*/ jsx(DocumentChangesPanel, {
                         editor: editor,
                         changes: changes,
-                        trackChanges: Boolean(currentContent.trackChanges),
-                        onTrackChangesChange: (enabled)=>editor.commands.setDocumentTrackChanges(enabled),
+                        decisions: currentContent.changeDecisions,
+                        trackChanges: suggestionOnly || Boolean(currentContent.trackChanges),
+                        suggestionOnly: suggestionOnly,
+                        onDecideChanges: canEditDocument ? decideDocumentChanges : void 0,
+                        onTrackChangesChange: (enabled)=>suggestionOnly ? false : editor.commands.setDocumentTrackChanges(enabled),
                         onClose: closeTaskPane
                     }),
                     canEditDocument && layoutOpen && section && /*#__PURE__*/ jsx(DocumentLayoutPanel, {