Initial TrueGrowth source import

openspec/changes/archive/2026-04-29-refactor-ppt-image-first-editing/specs/ppt-editing/spec.md

@@ -0,0 +1,57 @@
+## ADDED Requirements
+
+### Requirement: Image-First PPT Generation
+The system SHALL generate PPT pages as slide Frames whose primary visual content is a complete 16:9 generated image containing the page text, layout, background, and visual design.
+
+#### Scenario: Generate PPT pages from content
+- **GIVEN** the user invokes PPT generation from a topic or mindmap
+- **WHEN** the system creates the PPT pages
+- **THEN** it SHALL create one Frame per page
+- **AND** it SHALL associate each Frame with the whole-slide generation prompt
+- **AND** it SHALL generate or enqueue one full-slide image for each page
+- **AND** it SHALL insert the resulting image into the corresponding Frame as the primary slide image
+
+#### Scenario: Page image generation fails
+- **GIVEN** a PPT page image generation task fails
+- **WHEN** the PPT editing panel shows the page
+- **THEN** the page SHALL remain available with its original generation prompt
+- **AND** the user SHALL be able to regenerate that page without recreating the whole PPT
+
+### Requirement: PPT Editing Panel
+The system SHALL present Frame-based PPT pages through a PPT editing panel that previews and manages pages in deck order.
+
+#### Scenario: Preview PPT pages
+- **GIVEN** the current canvas contains PPT Frames
+- **WHEN** the user opens the PPT editing panel
+- **THEN** each PPT page SHALL show a page card with its index, name, dimensions, and preview image when available
+- **AND** clicking a page card SHALL focus/select the corresponding Frame on the canvas
+
+#### Scenario: Hide obsolete PPT actions
+- **GIVEN** the current canvas contains PPT Frames
+- **WHEN** the PPT editing panel renders actions
+- **THEN** it SHALL NOT show PPT background image controls
+- **AND** it SHALL NOT show single-page PPT export actions
+- **AND** it SHALL keep full-deck PPT export available
+
+### Requirement: PPT Page Regeneration
+The system SHALL replace single-page PPT export with page regeneration that uses the existing page image as a reference.
+
+#### Scenario: Open regeneration dialog
+- **GIVEN** a PPT page has a stored generation prompt
+- **WHEN** the user clicks “重新生成” for that page
+- **THEN** the AI image generation dialog SHALL open with the stored prompt prefilled
+- **AND** the current primary slide image SHALL be attached as a reference image when available
+- **AND** the target Frame id and dimensions SHALL be passed for automatic回填
+
+#### Scenario: Regeneration succeeds
+- **GIVEN** a PPT page regeneration task completes successfully
+- **WHEN** the generated image is inserted back into the target Frame
+- **THEN** the previous primary slide image SHALL be replaced by the new image
+- **AND** the page preview SHALL show the new image
+- **AND** the Frame SHALL remain in the same deck order
+
+#### Scenario: Regeneration fails or is cancelled
+- **GIVEN** a PPT page regeneration task fails or is cancelled
+- **WHEN** the task finishes without a usable image
+- **THEN** the previous primary slide image SHALL remain unchanged
+- **AND** the page SHALL remain available for another regeneration attempt