Canvas Banana

by liuyangart
5
4
3
2
1
Score: 35/100

Description

This plugin has not been manually reviewed by Obsidian staff. Canvas AI Plugin - use Gemini AI in Canvas view, support text / image / node generation.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

README file from

Github

简体中文 | 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 模型。

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 文件。