@arronqzy/abuilder-vue 0.1.21 → 0.1.23

package/README.md

@@ -95,11 +95,39 @@ validateWorkspaceData(workspace);
 |------|------|----------|
 | `workspace:add` | `AbuilderEvents.workspaceAdd` | 创建成功 |
 | `workspace:sync` | `AbuilderEvents.workspaceSync` | 同步成功 |
+| `workspace:delete` | `AbuilderEvents.workspaceDelete` | 删除工作区（界面删除，或调用 `deleteWorkspaceProject` / `clearWorkspaceProjects`），参数 `{ ids, nameSpace }` |
 
 `validate*` 只检查。`parseWorkspaceData` 会补齐 `id`、时间戳和空字段。只检查视图用 `validateViewData` / `parseViewData`；只检查蓝图用 `validateBlueprintData` / `parseBlueprintData`。
 
 `WorkspaceData` 字段与 React 版相同：`id`、`name`、`createdAt`、`updatedAt`、`panelState`、`blueprintDocument`、`blueprintMeta`、`productName`、`titleIconDataUrl`。
 
+### 清理浏览器里的本地数据
+
+编辑器把工作区、蓝图库、蓝图执行日志、接口集合四类数据存在 IndexedDB 里，按 `nameSpace` 隔离。以后端为准时，可以清理本地副本，避免堆积：
+
+| 数据 | 列出 / 读取 | 删除单条 | 清空 |
+|------|-------------|----------|------|
+| 工作区 | `listWorkspaceProjects` / `getWorkspaceProject` | `deleteWorkspaceProject` | `clearWorkspaceProjects` |
+| 蓝图库 | `listBlueprintLibrary` / `getBlueprintLibraryRecord` | `deleteBlueprintLibraryRecord` | `clearBlueprintLibrary` |
+| 蓝图执行日志 | `listExecutionRunRecords` / `getExecutionRunRecord` | `deleteExecutionRunRecord` | `clearAllExecutionRunRecords` |
+| 接口集合 | `listApiCollectionRecords` | `deleteApiCollection` | `clearApiCollections` |
+
+```ts
+import {
+  listWorkspaceProjects,
+  deleteWorkspaceProject,
+  clearWorkspaceProjects,
+  clearAbuilderStorage,
+} from "@arronqzy/abuilder-vue";
+
+const items = await listWorkspaceProjects(nameSpace);
+await deleteWorkspaceProject(items[0].id, nameSpace);
+const removed = await clearWorkspaceProjects(nameSpace); // 返回删除数量
+const result = await clearAbuilderStorage(nameSpace); // { workspaces, blueprints, executionRuns, apiCollections }
+```
+
+`nameSpace` 要和 `<App :name-space>` 一致。清空函数返回删除数量；`clearAbuilderStorage` 不动主题、字号等偏好设置。删除工作区或蓝图库后，已挂载的编辑器会自动刷新列表，删除工作区还会发出 `workspace:delete` 事件。执行日志可用 `purgeExecutionRunsOlderThan` / `trimExecutionRunRecordsToMax` 按时间或条数清理，保留策略用 `readExecutionLogSettings` / `writeExecutionLogSettings` 读写。
+
 ## 和 React 版的差别
 
 - **没有** `getPreviewSnapshot`。要缩略图就自己截预览 DOM，不要假设有同名导出。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arronqzy/abuilder-vue",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Abuilder Vue 3 可视化编辑器入口包",
   "license": "MIT",
   "type": "module",
@@ -14,8 +14,8 @@
   "dependencies": {
     "ant-design-vue": "^4.2.6",
     "vue": "^3.5.13",
-    "@arronqzy/vue-view": "0.1.22",
-    "@arronqzy/i18n": "0.1.17"
+    "@arronqzy/i18n": "0.1.17",
+    "@arronqzy/vue-view": "0.1.24"
   },
   "peerDependencies": {
     "vue": "^3.4.0"

package/src/index.ts

@@ -15,16 +15,44 @@ export {
   parseWorkspaceData,
   createEmptyWorkspace,
   createWorkspaceProjectId,
+  listWorkspaceProjects,
+  getWorkspaceProject,
+  deleteWorkspaceProject,
+  clearWorkspaceProjects,
+  listBlueprintLibrary,
+  getBlueprintLibraryRecord,
+  deleteBlueprintLibraryRecord,
+  clearBlueprintLibrary,
+  listExecutionRunRecords,
+  getExecutionRunRecord,
+  deleteExecutionRunRecord,
+  clearAllExecutionRunRecords,
+  purgeExecutionRunsOlderThan,
+  trimExecutionRunRecordsToMax,
+  readExecutionLogSettings,
+  writeExecutionLogSettings,
+  listApiCollectionRecords,
+  deleteApiCollection,
+  clearApiCollections,
+  clearAbuilderStorage,
   addEventSubscription,
   AbuilderEvents,
 } from "@arronqzy/vue-view";
 export type {
   ParseCheckResult,
   WorkspaceParseCheckResult,
+  WorkspaceProjectListItem,
+  AbuilderStorageClearResult,
+  BlueprintLibraryListItem,
+  BlueprintLibraryRecord,
+  ExecutionRunRecord,
+  ExecutionLogSettings,
+  ApiCollectionRecord,
   AbuilderEventName,
   AbuilderEventPayloadMap,
   WorkspaceAddEventPayload,
   WorkspaceSyncEventPayload,
+  WorkspaceDeleteEventPayload,
   ApiCollectionUploadStartEventPayload,
   ApiCollectionUploadSuccessEventPayload,
   WorkspaceData,