@ai_mind/ade-plugin-sdk 0.2.0 → 0.2.1

package/README.md

@@ -82,7 +82,7 @@ main 和 renderer 是两个独立实例。它们不共享变量、服务注册
 ### 2.3 当前边界
 
 - 功能区域是 ADE 布局中的 React 区域。注册区域不会创建 Git worktree。
-- 插件区域排在核心区域之后。当前不能用 `registerView` 替换核心编辑器或聊天区域。
+- 插件区域与核心区域使用同一布局。用户可以移动插件区域。`registerView` 不能替换核心编辑器或聊天组件。
 - UI 上下文只提供项目、worktree 和当前文件的路径。它不提供编辑器实例、未保存正文或选区。
 - 读取文件得到磁盘内容。统计未保存草稿需要以后提供的编辑器扩展 API。
 - API 添加项目或创建 worktree，不会自动切换界面的当前选择。
@@ -417,14 +417,31 @@ renderer 和 main 都可以 `registerCommand`。main 上下文没有 `executeCom
 | `title` | 中文区域标题 |
 | `component` | React 组件，接收 `PluginComponentProps` |
 | `defaultVisible` | 初始可见状态；用户之后可以修改 |
-| `defaultSize` | 初始区域大小，按布局百分比设置 |
-| `minSize` / `maxSize` | 区域大小限制 |
-| `order` | 插件区域排序，数值越小越靠前 |
+| `defaultSize` | 首次放置时参考的相对大小；不会覆盖用户保存的大小 |
+| `minSize` / `maxSize` | 旧单行布局的尺寸字段；继续接受，但 ADE 0.47 起不作为停靠布局的硬限制 |
+| `order` | 首次新增插件区域时的排列顺序，数值越小越靠前；不会重排已有区域 |
 
-宿主为区域 ID 加上插件命名空间。不同插件可以使用相同局部 ID。布局由 ADE 保存。
+宿主为区域 ID 加上插件命名空间。不同插件可以使用相同局部 ID。请保持区域 `id` 不变。用户保存的位置与这个 ID 关联。
 
 view 没有 `when` 字段。需要空状态时，在组件中检查上下文。用户通过「视图」菜单控制区域可见性。
 
+**ADE 0.47 起的区域布局：**项目、worktree、目录、编辑、对话、Aone 看板和插件区域使用同一停靠布局。项目与 worktree 是两个独立区域。用户可以调整每个区域的位置、顺序和大小。插件无需增加布局接口。按 SDK 0.2 开发的区域可以直接使用这个布局。
+
+| 用户操作 | 操作方法 |
+| --- | --- |
+| 移动并分屏 | 拖拽区域标签到目标区域的左侧、右侧、上方或下方，确认预览后松开 |
+| 合并为标签页 | 拖拽区域标签到目标区域的中间或标签栏 |
+| 调整标签顺序 | 在同一标签栏中拖拽标签到所需位置 |
+| 调整大小 | 拖拽区域之间的分隔线 |
+| 隐藏或显示区域 | 点击区域标签的隐藏按钮，或使用标题栏「视图」菜单 |
+| 恢复默认布局 | 打开「视图 → 恢复默认布局」，恢复区域的位置、顺序和大小；保留显示开关 |
+
+ADE 自动保存分屏结构、标签顺序和区域大小。重新打开 ADE 后恢复布局。布局在全 ADE 共用，切换项目或 worktree 不会切换布局。停用插件时，ADE 保留区域的位置记录。重新启用插件后，区域恢复到保存的位置。
+
+`defaultSize` 和 `order` 只用于首次放置。更新配置、重新安装插件或修改这些声明，不会强制重排用户已有的区域。`minSize` 和 `maxSize` 保留给旧客户端使用。新停靠布局允许用户自由调整大小，不把这些旧百分比作为限制。当前不提供浮动区域或独立窗口。
+
+不要假定插件区域始终在右侧。让组件适应不同的宽度和高度。内容过长时，在区域内提供滚动。区域移动、标签切换和最大化不应触发新的业务任务。用户隐藏区域或停用插件时，组件可能卸载。持久业务数据按第 7 节保存。资源按第 9 节清理。
+
 ### 6.2 注册内置 slot
 
 `ctx.registerSlot(name, registration)` 在指定位置追加组件。

package/package.json

@@ -1,23 +1,47 @@
 {
   "name": "@ai_mind/ade-plugin-sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "ADE 可信插件 SDK、类型与 React 插件构建工具",
   "license": "MIT",
   "author": "sepmini",
-  "engines": { "node": ">=18" },
-  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "type": "module",
   "main": "./index.mjs",
   "types": "./index.d.ts",
-  "exports": { ".": { "types": "./index.d.ts", "default": "./index.mjs" } },
-  "bin": { "ade-plugin-build": "./cli/build.mjs" },
-  "files": ["index.mjs", "index.d.ts", "types", "cli", "README.md", "LICENSE"],
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.mjs"
+    }
+  },
+  "bin": {
+    "ade-plugin-build": "./cli/build.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "index.d.ts",
+    "types",
+    "cli",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "sync:types": "node scripts/sync-types.mjs",
     "release:preflight": "node scripts/release-preflight.mjs",
     "release:dry-run": "node scripts/release-preflight.mjs --dry-run",
     "prepublishOnly": "node scripts/release-preflight.mjs"
   },
-  "dependencies": { "esbuild": "^0.25.0" },
-  "peerDependencies": { "react": "^19.0.0", "react-dom": "^19.0.0" }
+  "dependencies": {
+    "esbuild": "^0.25.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  }
 }

package/types/ade-types.d.ts

@@ -486,6 +486,41 @@ export interface AppSettings {
     editor: EditorSettings;
     agents: AgentSettings;
 }
+/** 可持久化的区域布局；只保存位置、比例和标签，不保存插件业务参数。 */
+export interface AdeDockPanel {
+    id: string;
+    contentComponent: 'area';
+    renderer: 'always';
+    title?: string;
+}
+export interface AdeDockGroup {
+    id: string;
+    views: string[];
+    activeView?: string;
+}
+export type AdeDockNode = {
+    type: 'leaf';
+    data: AdeDockGroup;
+    size?: number;
+} | {
+    type: 'branch';
+    data: AdeDockNode[];
+    size?: number;
+};
+export interface AdeDockLayout {
+    grid: {
+        root: AdeDockNode;
+        width: number;
+        height: number;
+        orientation: 'HORIZONTAL' | 'VERTICAL';
+    };
+    panels: Record<string, AdeDockPanel>;
+    activeGroup?: string;
+}
+export interface AdeWorkspaceLayout {
+    version: 1;
+    dock: AdeDockLayout;
+}
 /** 应用状态（原 state.json + localStorage ade-areas 的统一归宿） */
 export interface AdeState {
     projects: Project[];
@@ -493,6 +528,8 @@ export interface AdeState {
     worktreeTabs: Record<string, WorktreeTabState>;
     /** 插件功能区域的显示状态，以插件 ID 和区域 ID 组合为 key。 */
     pluginAreasVisible?: Record<string, boolean>;
+    /** 完整布局保留隐藏及暂不可用的区域；null 表示使用默认布局。 */
+    workspaceLayout?: AdeWorkspaceLayout | null;
 }
 /** ~/.ade/settings.json 的完整结构 */
 export interface AdeSettingsFile {