简体中文 | English

https://www.youtube.com/watch?v=FN8d_2q4evo

Canvas Banana (Obsidian Plugin)

Canvas Banana 是一个原名为 Obsidian Canvas AI 的插件，现在它不仅仅为 Canvas（白板）提供 AI 增强，更是一个全能的 Obsidian AI 助手。它深度集成了 Gemini / OpenAI / Antigravity 等先进 AI 模型，让你可以在 白板 和 笔记 中无缝进行智能对话、文本创作和图像生成。

该插件的核心理念是"上下文感知"——无论是白板中的节点，还是笔记中的选段，它都能精准理解并以此为背景协助你的创作。

🌟 核心功能

• 🤖 上下文感知对话 (Chat)

  • 智能识别选中的 Canvas 节点内容作为对话背景。
  • 在白板中直接与 AI 探讨想法、总结内容或扩展思路。
  • 支持调节 "Temperature" 以控制回答的创造性。
  • 流式响应 (Streaming)：支持主流 Provider (Gemini, OpenAI 等) 的流式输出。

• 🎨 AI 图像生成 (Image Generation)

  • 将文字描述转化为高质量图片。
  • 提供丰富的 纵横比 (Ratio) 选择：1:1, 16:9, 4:3, 9:16 等。
  • 支持多种 分辨率 (Resolution)：1K, 2K, 4K。
  • 支持引用选中节点的文本作为图像生成的 Prompt。

• 🎨 canvas 节点生成 (Node Generation)

• • 让llm以脑图的形式回答你的问题。

• ⚡ 高效的工作流

  • 多任务并发：支持“发射后不管”，你可以同时发起多个生成任务，无需等待上一个完成。
  • 提示词预设 (Prompt Presets)：内置预设管理功能，支持保存、重命名和快速调用常用的提示词。

• 📝 笔记 AI 助手 (Note AI Assistant) [NEW]

  • 侧边栏副驾驶 (Sidebar Co-pilot): 类似 Google Gemini Canvas 的侧边栏体验。
    • Chat: 与当前文档进行多轮对话，支持引用选中内容。
    • Edit: 全文级或段落级修改建议，支持 Diff 视图审阅，确认后才应用。
    • Image: "所见即所得"的文档内生图，支持基于上下文生成配图。
  • 智能悬浮编辑: 选中笔记文本即可唤起 AI 进行润色、翻译或改写。支持实时显示 AI 思考过程 (Thinking Process)。

• ⚡ 增强的 Canvas 编辑

  • 节点级原位编辑: 直接在 Canvas 节点内部选中文字进行 AI 修改，AI 会同时参考连线节点的上下文。
  • 文件节点支持: 支持直接编辑 Canvas 中引用的 .md 文件节点。

• 🌍 多 API 支持

  • 支持 Gemini (Google), OpenRouter 等多种 API 提供商。
  • 支持自定义 Base URL 以适配各种 OpenAI 兼容接口。

⚠️ 免责声明 (Disclaimer)

使用本插件即代表您同意以下条款：

1. 第三方服务：本插件的功能实现依赖于第三方 API 服务（如 OpenRouter 等）。插件作者与这些服务提供商无直接关联。
2. 费用自理：调用 AI 模型可能产生 API 使用费用，该费用由 API 服务商收取，请用户自行在对应平台充值和管理。
3. 内容合规：用户应确保使用生成的内容符合当地法律法规及 OpenAI/Google 等模型提供商的使用政策。插件作者不对用户生成的内容承担法律责任。
4. 隐私安全：您的 API Key 仅保存在本地 Obsidian 配置中，插件不会将其上传至除此之外的任何服务器。但请注意，对话内容会被发送至第三方 API 此外进行处理。

📥 安装指南 (手动安装)

由于本插件目前可能处于测试阶段或未上架社区商店，请按照以下步骤手动安装：

1. 插件下载

   • 在releases中下载最新版本的插件 zip。

2. 创建插件文件夹

   • 打开你的 Obsidian 仓库目录。
   • 进入 .obsidian/plugins/ 目录。
   • 把zip包解压进去。
     

3. 启用插件

   • 重启 Obsidian。
   • 进入 设置 -> 第三方插件。
   • 关闭 "安全模式"（如果尚未关闭）。
   • 在插件列表中找到 "Canvas Banana" 并点击开关启用。
     

🚀 功能操作指南

1. 配置 API Key

首次使用前，请先配置 API：

1. 打开 Obsidian 设置 -> Canvas Banana。
2. 选择 API Provider 。
3. 填入你的 API Key。
4. (可选) 选择或自定义你偏好的 Text/Image 模型。

• 获得api yunwu | gptgod

2. 唤起操作面板

1. 打开一个 Canvas (白板) 文件。

2. 使用鼠标框选或点击选中一个或多个节点。

3. 在节点上方自动弹出的原生菜单条中，点击 香蕉图标 (🍌)。
   

4. Canvas Banana 悬浮面板将会出现在选中框的右侧。

5. 只选中text node， 且prompt中没有内容时，则把text node本身的内容作为prompt。

3. 使用 AI 对话 (Text Mode)

• 切换到 Text 标签页。
• 在输入框中输入你的指令或问题。
• (可选) 选择一个 Preset (预设) 快速填入 Prompt。
• 点击 Generate。
• AI 的回复将作为一个新的卡片节点生成在白板上。

4. 生成图像 (Image Mode)

• 切换到 Image 标签页。
• 在输入框描述你想要的画面（留空则默认使用选中节点的文本）。
• 调整 Resolution (分辨率) 和 Ratio (比例)。
• 点击 Generate。
• 生成的图片将作为图片节点插入到白板中。

5. 管理 Prompt 预设

在面板输入框上方有一排工具按钮：

• + (Add): 将当前输入框的内容保存为新预设。
• 💾 (Save): 更新当前选中的预设内容。
• ❌ (Delete): 删除当前选中的预设。
• 📖 (Rename): 重命名当前预设。
• 📌 (Pin): 固定悬浮面板（避免自动关闭）。

6. 笔记 AI 助手 (Note Mode)

插件不仅支持 Canvas，也完美适配普通 Markdown 笔记编辑：

• 侧边栏副驾驶 (Sidebar Co-pilot): 点击 Obsidian 右侧边栏的 🍌 图标打开 Side Panel。
  • Chat: 纯对话模式，基于文档上下文进行问答。支持 "Insert to cursor" 将 AI 回复插入文档。
  • Edit: 选中一段文本（或不选以针对全文），输入指令。AI 的修改建议会以 Diff 形式呈现，点击 "Confirm" 应用修改。支持 Thinking 模型流式输出。
  • Image: 在文档中生成图片。支持选中一段文字作为 Prompt，或者直接输入描述。
• 悬浮编辑: 在笔记中选中文本，点击浮现的 🍌 图标，即可快速唤起悬浮面板进行 AI 编辑或生图。

📄 License (开源协议)

本项目采用 GNU General Public License v3.0 开源协议，详情请参阅 LICENSE 文件。