Initial TrueGrowth source import

openspec/changes/archive/2026-04-29-add-tool-window-multi-instance/specs/toolbox-plugin-runtime/spec.md

@@ -0,0 +1,25 @@
+## MODIFIED Requirements
+
+### Requirement: iframe 与内部工具必须共享统一运行时协议
+系统 SHALL 允许 `iframe` 工具和内部 React 工具通过同一工具定义模型被打开、最小化和嵌入画布，并允许被标记为支持多实例的工具同时打开多个独立窗口实例。
+
+#### Scenario: 打开内部工具
+- **WHEN** 用户从工具箱打开内部工具
+- **THEN** 系统根据注册中心解析对应内部组件
+
+#### Scenario: 打开 iframe 工具
+- **WHEN** 用户从工具箱打开 URL 工具
+- **THEN** 系统根据工具定义渲染 iframe
+
+#### Scenario: 多实例工具新开窗口
+- **GIVEN** 某工具被标记为支持多实例
+- **WHEN** 用户从工具栏图标右键选择“新窗口打开”
+- **THEN** 系统为该工具创建新的窗口实例
+- **AND** 新旧实例各自维护独立的位置、尺寸和最小化状态
+- **AND** 工具栏分别显示对应实例图标
+
+#### Scenario: 单实例工具保持兼容
+- **GIVEN** 某工具尚未标记为支持多实例
+- **WHEN** 用户通过已有入口再次打开该工具
+- **THEN** 系统继续复用或聚焦现有窗口行为
+- **AND** 不暴露可点击的“新窗口打开”入口

openspec/changes/archive/2026-04-29-add-tool-window-multi-instance/specs/toolbox/spec.md

@@ -0,0 +1,25 @@
+## ADDED Requirements
+
+### Requirement: 工具栏必须展示同工具的多个窗口实例
+系统 SHALL 在左侧工具栏中将同一工具的多个已打开或最小化实例显示为多个独立图标，并在图标上提供实例序号标识。
+
+#### Scenario: 多个实例并列显示
+- **GIVEN** 用户已为同一个工具打开两个窗口实例
+- **WHEN** 左侧工具栏渲染工具实例
+- **THEN** 工具栏显示两个独立图标
+- **AND** 两个图标使用相同工具图标并带有不同的实例序号角标
+
+#### Scenario: 常驻工具无实例时回退为启动图标
+- **GIVEN** 某工具被常驻到工具栏且当前没有打开实例
+- **WHEN** 左侧工具栏渲染该工具
+- **THEN** 工具栏仅显示一个关闭态启动图标
+- **AND** 用户点击该图标时系统新建一个窗口实例
+
+### Requirement: 工具栏右键菜单必须支持新窗口打开
+系统 SHALL 在支持多实例的工具图标右键菜单中提供“新窗口打开”操作，用于从当前工具直接新建窗口实例。
+
+#### Scenario: 从工具图标右键新开实例
+- **GIVEN** 某工具支持多实例并已在工具栏显示
+- **WHEN** 用户右键该工具图标并选择“新窗口打开”
+- **THEN** 系统新建一个该工具的窗口实例
+- **AND** 新实例默认以级联偏移方式打开，避免与已有实例完全重叠