@@ -1,6 +1,6 @@
 {
   "name": "excalidraw",
-  "version": "0.2.3",
+  "version": "0.3.4",
   "description": "让 Agent 生成图形，在对话侧栏用 Excalidraw 编辑、引用选区、继续修改并导出。",
   "author": {
     "name": "zcoder"
 
@@ -15,17 +15,23 @@ pnpm install --frozen-lockfile
 pnpm build
 ```
 
-在 ZCode 插件商店添加 `dist/local-marketplace` 的绝对路径作为本地 marketplace 来源，安装并启用 `excalidraw`。不要添加仓库根目录，其官方来源名称属于保留名称。源码更新后重新构建、刷新来源、重新安装插件，并在新会话测试。发布时使用 `dist/external_plugins/excalidraw/<version>/plugin.zip`。MCP 与编辑器已打包，运行时无需安装 npm 依赖。当前交互面板支持桌面本地工作区；其他平台使用宿主普通 MCP 记录回退。
+在 ZCode 插件商店添加 `dist/local-marketplace` 的绝对路径作为本地 marketplace 来源，安装并启用 `excalidraw`。不要添加仓库根目录，其官方来源名称属于保留名称。源码更新后重新构建、刷新来源、重新安装插件，并在新会话测试。发布时使用 `dist/plugins/excalidraw/<version>/plugin.zip`。MCP 与编辑器已打包，运行时无需安装 npm 依赖。当前交互面板支持桌面本地工作区；其他平台使用宿主普通 MCP 记录回退。
 
 启用后可发送：“用 Excalidraw 画一个 API、缓存和数据库的架构图”。生成结果会打开侧栏。手工修改自动保存；选中元素后右键“引用选区到对话”，再发送指令，Agent 可以按稳定元素 ID 修改。未选中元素时可引用整图，文档菜单中也提供引用入口。
 
-点击顶部画板标题可新建、导入或切换文档；“导出”打开格式与文件路径对话框，支持 `.excalidraw`、PNG、SVG。导出路径相对于当前工作区，覆盖已有文件需勾选“覆盖同名文件”。画布下方只保留 Excalidraw 自身的缩放、撤销/重做控件。
+顶部左侧的三横线图标是「菜单」，可新建、导入、重命名或切换文档；旁边「+」可直接新建，右侧向下箭头图标可导出。这三个按钮使用统一的圆角方形样式，悬停可查看名称。画板名称统一显示在标签页中，只有 1 张画板时也显示；最近打开的最多 8 张画板在顶部同一行显示，位于「+」与保存状态之间。空间不足时，鼠标停在标签区域滚动滚轮即可左右移动，触控板横向滚动也可使用；点击标签切换画板。双击当前标签名称可重命名，也可从菜单选择重命名或在当前标签按 F2。名称在保存确认后同步更新，保留画板 ID、内容和当前撤销历史。空画板以 100% 缩放打开。
+
+标签右侧「×」只关闭标签，不删除画板，可随时从菜单重新打开。关闭当前标签时先等待保存，再切到相邻标签；关闭最后一个标签后显示空画布。保存失败时保留标签和草稿。关闭状态随标签列表在会话内恢复，旧工具结果不会自动重新打开已关闭的标签。
+
+打开、切换或重命名画板后，插件通过 `updateModelContext` 将当前画板 ID、名称、版本加入当前会话的对话输入框，替换本面板之前的引用；手动“引用选区”再补充元素 ID。关闭最后一个标签时发送 `documentId: null`，表示没有当前画板。下一次发送时模型能读到目标画板，修改前仍需重新读取最新版本。切换标签不会改变已经发出的模型请求。用户移除输入框上下文后，可再次引用当前画板。最近标签和当前选择由宿主 `widgetState` 在会话内恢复，不保证应用重启后恢复标签列表。
+
+“导出”打开格式与文件路径对话框，支持 `.excalidraw`、PNG、SVG。导出路径相对于当前工作区，覆盖已有文件需勾选“覆盖同名文件”。画布下方保留 Excalidraw 自身的缩放、撤销/重做控件。
 
 ## 保存与恢复
 
 文档存放在宿主分配的插件数据目录 `ZCODE_PLUGIN_DATA`（ZCode 下为 `~/.zcode/cli/plugins/data/<plugin-id>`，卸载插件时默认一并删除）的 `<workspace-key-hash>/documents.sqlite`；脱离宿主单独运行时退到 `~/.zcode/plugin-data/excalidraw`。`ZCODE_WORKSPACE_ROOT` 指定工作区文件路径；可信启动方可提供 `ZCODE_WORKSPACE_IDENTITY` 隔离同路径的工作区身份。
 
-显示“已保存”表示后端已确认。强制关闭时仅保证已确认内容恢复。多窗口同时改图时，版本冲突会保留本页草稿，可以另存副本或放弃草稿后重载。
+右上角圆点表示保存状态：绿色为已保存（后端已确认），黄色为保存中，红色为保存失败，灰色为未打开画板；悬停可查看文字，读屏也会播报状态。强制关闭时仅保证已确认内容恢复。多窗口同时改图时，版本冲突会保留本页草稿，可以另存副本或放弃草稿后重载。
 
 手工修改与工具修改共用当前画板的撤销/重做，撤销后的内容照常保存为新版本。同一文档的新内容更新保留已有历史和视角；切换文档、关闭重开或放弃草稿重载后重新开始历史。撤销栈不跨窗口或重启持久化。升级时移除旧的独立 AI 恢复字段和工具，保留既有画板内容、版本与幂等记录。
 
 
@@ -8,7 +8,7 @@ description: 生成与编辑 Excalidraw 架构图、流程图、关系图，在
 用户要画图、使用 Excalidraw 或引用画板选区时使用本插件工具。生成的是可编辑元素，不是截图。
 
 1. 新图调用 create_diagram(title, elements)。元素使用稳定的短 id；形状支持 rectangle/ellipse/diamond、x/y/width/height、backgroundColor、strokeColor。容器文字使用 label: {text}，会生成 `<id>-label` 的绑定文本。箭头用 type: arrow、points: [[0,0],[dx,dy]]，并提供匹配的 width/height。
-2. 修改前 read_scene(id, elementIds?)，拿到当前 revision、元素 ID、绑定文字与箭头。用户的选区引用包含文档 id、revision、elementIds；引用可能过期，仍然先读。
+2. 修改前 read_scene(id, elementIds?)，拿到当前 revision、元素 ID、绑定文字与箭头。面板打开、切换或改名时会提供 `kind: active-diagram` 的上下文，含 documentId、title、revision；“当前画板”以本轮最新上下文的 documentId 为准，不从名称或旧工具结果猜测。关闭最后一个标签后 documentId 为 null，表示没有当前画板；关闭标签不删除文档。用户的选区引用另含 elementIds；引用可能过期，仍然先读。一次编辑固定该文档 ID，不因后续切换标签改写另一张画板；没有明确目标时先确认。
 3. apply_operations(id, expectedRevision, operationId, operations)：使用 add / update / delete，按元素 ID 局部修改。文字修改作用于 text 元素；不要用全量重建覆盖用户布局。位置调整保留未选中元素。
 4. revision_conflict 时重新读取后重新规划；重试同一已发送操作时保留 operationId 和全部参数，避免重复提交。不要把已有文档 revision 当作元素 version。
 5. 工具修改和手工修改使用画板内同一套撤销/重做。一次 apply_operations 应包含一个完整的编辑动作；不要为每个字段拆成独立提交。撤销产生新 revision，后续仍需重新读取。
 
@@ -817,7 +817,7 @@
         "en": "Excalidraw",
         "zh-CN": "Excalidraw"
       },
-      "version": "0.2.3",
+      "version": "0.3.4",
       "source": "./external_plugins/excalidraw",
       "description": "让 Agent 生成图形，在对话侧栏用 Excalidraw 编辑、引用选区、继续修改并导出。",
       "description_i18n": {
 
@@ -1,6 +1,6 @@
 {
   "name": "@zcode/plugin-excalidraw",
-  "version": "0.2.3",
+  "version": "0.3.4",
   "private": true,
   "license": "MIT",
   "type": "module",
 
@@ -79,11 +79,15 @@ export async function startFixture() {
       const value = await response.json(); if(!response.ok) throw Error(value.error); return value;
     }
     window.__contexts = [];
+    window.__activeContexts = [];
     window.__pluginClient = {
       theme: 'light', locale: 'zh-CN', toolCancelled: null, ...${JSON.stringify(bootstrap)},
       readResource: (uri) => rpc('readResource', {uri}),
       callTool: (name, args) => rpc('callTool', {name, arguments:args}),
-      updateModelContext: async (value) => { window.__contexts.push(value); },
+      updateModelContext: async (value) => {
+        window.__latestContext = value;
+        (value.structuredContent.kind === 'active-diagram' ? window.__activeContexts : window.__contexts).push(value);
+      },
       setWidgetState: async (value) => { window.__pluginClient.widgetState = value; },
       notifyIntrinsicHeight: () => {},
     };
 
@@ -45,6 +45,14 @@ const key = async (value) => {
 try {
   await page.goto(fixture.url);
   await saved();
+  await page.waitForFunction(() => window.__latestContext?.structuredContent.documentId === "demo");
+  assert.equal(await page.getByRole("tab").count(), 1);
+  assert.equal(
+    await page
+      .getByRole("tab", { name: "应用启动流程", exact: true })
+      .getAttribute("aria-selected"),
+    "true",
+  );
   assert.ok(
     !(await fixture.client.listTools()).tools.some(
       (tool) => tool.name === "restore_last_agent_edit",
@@ -216,23 +224,161 @@ try {
   await page.locator("#new-document").click();
   await page.waitForFunction(() => window.__excalidrawPanel.state().document?.id !== "demo");
   await saved();
+  const blankId = await page.evaluate(() => window.__excalidrawPanel.state().document.id);
+  assert.equal(await page.evaluate(() => window.__excalidrawPanel.api.getAppState().zoom.value), 1);
+  await page.waitForFunction(
+    (id) => window.__latestContext?.structuredContent.documentId === id,
+    blankId,
+  );
+  assert.equal(
+    await page.evaluate(() => window.__latestContext.structuredContent.elementIds),
+    undefined,
+  );
+  // 双击当前标签重命名；取消、空名称及保存都通过真实表单交互。
+  await page.getByRole("tab", { name: "未命名画板", exact: true }).dblclick();
+  await page.locator("#rename-input").fill("Discard this name");
+  await page.keyboard.press("Escape");
+  assert.equal(await page.getByRole("tab", { name: "未命名画板", exact: true }).count(), 1);
+  await page.getByRole("tab", { name: "未命名画板", exact: true }).dblclick();
+  await page.locator("#rename-input").fill("   ");
+  assert.equal(await page.locator("#rename-button").isDisabled(), true);
+  await page.locator("#rename-input").fill("我的新画板");
+  await page.keyboard.press("Enter");
+  await page.waitForFunction(() => !document.querySelector("dialog[open]"));
+  await saved();
+  assert.equal((await fixture.call("read_scene", { id: blankId })).document.title, "我的新画板");
+  await page.waitForFunction(
+    () => window.__latestContext?.structuredContent.title === "我的新画板",
+  );
   await key("ControlOrMeta+z");
   assert.equal(
     await page.evaluate(() => window.__excalidrawPanel.api.getSceneElements().length),
     0,
   );
-  await page.locator(".document-menu summary").click();
-  await page.getByRole("button", { name: "应用启动流程", exact: true }).click();
+  await page.getByRole("tab", { name: "应用启动流程", exact: true }).click();
   await page.waitForFunction(() => window.__excalidrawPanel.state().document?.id === "demo");
   await saved();
+  await page.waitForFunction(() => window.__latestContext?.structuredContent.documentId === "demo");
   assert.equal(await field("box", "backgroundColor"), "#ffc9c9");
+  await page.getByRole("tab", { name: "我的新画板", exact: true }).click();
+  await page.waitForFunction((id) => window.__excalidrawPanel.state().document?.id === id, blankId);
+  await saved();
+  assert.equal(await page.evaluate(() => window.__excalidrawPanel.api.getAppState().zoom.value), 1);
+  await page.getByRole("tab", { name: "我的新画板", exact: true }).dblclick();
+  await page.locator("#rename-input").fill("重命名后的画板");
+  await page.keyboard.press("Enter");
+  await page.waitForFunction(() => !document.querySelector("dialog[open]"));
+  await saved();
+  // 快捷新建在菜单外可直接使用；原有画板可通过 tab 返回。
+  await page.locator("#new-document-shortcut").click();
+  await page.waitForFunction((id) => window.__excalidrawPanel.state().document?.id !== id, blankId);
+  await saved();
+  assert.equal(await page.evaluate(() => window.__excalidrawPanel.api.getAppState().zoom.value), 1);
+  const widgetState = await page.evaluate(() => window.__pluginClient.widgetState);
+  fixture.setBootstrap({ toolOutput: changed, widgetState });
+  await page.reload();
+  await saved();
+  assert.equal(
+    await page.evaluate(() => window.__excalidrawPanel.state().document.id),
+    widgetState.documentId,
+  );
+  await page.getByRole("tab", { name: "重命名后的画板", exact: true }).waitFor();
+  assert.equal(await page.getByRole("tab").count(), 3);
+  assert.equal(await page.evaluate(() => document.documentElement.scrollWidth <= innerWidth), true);
+  // A regular vertical wheel scrolls overflowing tabs without moving the canvas;
+  // native horizontal trackpad gestures still work.
+  const tabs = page.getByRole("tablist");
+  const canvasView = await page.evaluate(() => {
+    const { scrollX, scrollY, zoom } = window.__excalidrawPanel.api.getAppState();
+    return { scrollX, scrollY, zoom };
+  });
+  await tabs.evaluate((element) => {
+    element.scrollLeft = 0;
+  });
+  await tabs.hover();
+  await page.mouse.wheel(0, 120);
+  await page.waitForFunction(() => document.querySelector(".document-tabs").scrollLeft > 0);
+  await page.mouse.wheel(0, -1200);
+  await page.waitForFunction(() => document.querySelector(".document-tabs").scrollLeft === 0);
+  await page.mouse.wheel(120, 0);
+  await page.waitForFunction(() => document.querySelector(".document-tabs").scrollLeft > 0);
+  assert.deepEqual(
+    await page.evaluate(() => {
+      const { scrollX, scrollY, zoom } = window.__excalidrawPanel.api.getAppState();
+      return { scrollX, scrollY, zoom };
+    }),
+    canvasView,
+  );
+  await page.getByRole("tab", { name: "未命名画板", exact: true }).scrollIntoViewIfNeeded();
+  await page.screenshot({ path: join(artifacts, "narrow-tabs.png") });
+  await page.setViewportSize({ width: 1100, height: 800 });
+  await page.getByRole("tab", { name: "应用启动流程", exact: true }).click();
+  await page.waitForFunction(() => window.__excalidrawPanel.state().document?.id === "demo");
+  await saved();
+  await page.screenshot({ path: join(artifacts, "wide-tabs.png") });
   const exportData = await readFile(join(fixture.workspace, "diagram.excalidraw"));
   await page
     .locator('input[type="file"]')
     .setInputFiles({ name: "import.excalidraw", mimeType: "application/json", buffer: exportData });
   await page.waitForFunction(() => window.__excalidrawPanel.state().document?.id !== "demo");
   await saved();
   assert.equal(await field("box", "backgroundColor"), "#ffc9c9");
+  // Closing tabs preserves documents, the active canvas, and the restored tab list.
+  const importedId = await page.evaluate(() => window.__excalidrawPanel.state().document.id);
+  const diagramIds = (await fixture.call("list_diagrams")).documents.map((doc) => doc.id).sort();
+  await page.getByRole("button", { name: "关闭标签 应用启动流程", exact: true }).click();
+  await page.waitForFunction(() => !document.getElementById("diagram-tab-demo"));
+  assert.equal(await page.evaluate(() => window.__excalidrawPanel.state().document.id), importedId);
+  await page.waitForFunction(() => !document.getElementById("new-document-shortcut").disabled);
+  fixture.setBootstrap({
+    toolOutput: changed,
+    widgetState: await page.evaluate(() => window.__pluginClient.widgetState),
+  });
+  await page.reload();
+  await saved();
+  assert.equal(await page.getByRole("tab", { name: "应用启动流程", exact: true }).count(), 0);
+  await page.locator(".document-menu summary").click();
+  await page.locator(".document-list button").filter({ hasText: "应用启动流程" }).click();
+  await page.waitForFunction(() => window.__excalidrawPanel.state().document?.id === "demo");
+  await saved();
+  assert.equal(await field("box", "backgroundColor"), "#ffc9c9");
+  await page.getByRole("button", { name: "关闭标签 应用启动流程", exact: true }).click();
+  await page.waitForFunction(
+    (id) => window.__excalidrawPanel.state().document?.id === id,
+    importedId,
+  );
+  await page.waitForFunction(
+    (id) => window.__latestContext?.structuredContent.documentId === id,
+    importedId,
+  );
+  while (await page.locator(".document-tab-close").count()) {
+    await page.locator(".document-tab-close").first().click();
+    await page.waitForFunction(() => !document.getElementById("new-document-shortcut").disabled);
+  }
+  await page.waitForFunction(() => window.__latestContext?.structuredContent.documentId === null);
+  assert.equal(await page.evaluate(() => window.__excalidrawPanel.state().document), null);
+  assert.equal(
+    await page.evaluate(() => window.__excalidrawPanel.api.getSceneElements().length),
+    0,
+  );
+  assert.deepEqual(
+    (await fixture.call("list_diagrams")).documents.map((doc) => doc.id).sort(),
+    diagramIds,
+  );
+  const closedState = await page.evaluate(() => window.__pluginClient.widgetState);
+  assert.equal(closedState.documentId, null);
+  assert.deepEqual(closedState.recentDocumentIds, []);
+  fixture.setBootstrap({ toolOutput: changed, widgetState: closedState });
+  await page.reload();
+  await page.waitForLoadState("networkidle");
+  assert.equal(await page.evaluate(() => window.__excalidrawPanel.state().document), null);
+  assert.equal(await page.getByRole("tab").count(), 0);
+  await page.screenshot({ path: join(artifacts, "closed-tabs.png") });
+  await page.locator(".document-menu summary").click();
+  await page.locator(".document-list button").filter({ hasText: "应用启动流程" }).click();
+  await page.waitForFunction(() => window.__excalidrawPanel.state().document?.id === "demo");
+  await saved();
+  assert.equal(await field("box", "backgroundColor"), "#ffc9c9");
   assert.deepEqual(errors, []);
   console.log(
     `PASS: mixed undo/redo + persistence, context menu, document switch, all exports, themes and narrow layout. Screenshots: ${artifacts}`,
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "excalidraw",`
`3`		`- "version": "0.2.3",`
	`3`	`+ "version": "0.3.4",`
`4`	`4`	`"description": "让 Agent 生成图形，在对话侧栏用 Excalidraw 编辑、引用选区、继续修改并导出。",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "zcoder"`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@zcode/plugin-excalidraw",`
`3`		`- "version": "0.2.3",`
	`3`	`+ "version": "0.3.4",`
`4`	`4`	`"private": true,`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"type": "module",`