我写了一个 Obsidian 插件：Chisel，让 AI 真正融入你的笔记工作流

1. 为什么要做这个插件

用 Obsidian 写东西的人应该都经历过这种场景：

写到一半，想让 AI 帮你润色一段话。于是你复制文本，切换到 ChatGPT 或 Claude 的网页，粘贴进去，等结果，再复制回来，粘贴到 Obsidian……

这一套操作走下来，思路断了，心情也断了。

市面上有一些 AI 插件，但大多数的交互逻辑是：打开一个侧边栏，输入指令，等待回复，再手动处理结果。还是绕了一圈。

我想要的很简单：选中文字，弹出菜单，点一下，搞定。 不要打断我的写作流，不要让我记住一堆快捷键，不要让我在多个窗口之间来回跳。

在动手开发这个插件之前，我也尝试找了一些类似的插件，但是体验下来不能说不好，只能说不符合我个人的使用习惯，之前在做welight和 notion 的时候，已经习惯使用里面的划词功能，我感觉那种方式对我来说会更高效，所以打算做一个类似的插件去实现这个需求。

Chisel 就是这么来的。

2. Chisel 是什么

Chisel 是一个以「选中文本」为核心触发点的 Obsidian 社区插件。

名字来自凿子——雕刻的工具，精准，克制，不废话。

核心逻辑只有一句话：选中文本 → 弹出浮动菜单 → 选择操作 → 结果直接处理到笔记中。

没有侧边栏，没有对话框，没有多余的 UI。

3. 功能拆解

3.1 浮动操作菜单

选中编辑器里的任意文字，就会弹出一个浮动菜单（也可以用 Cmd/Ctrl + Shift + A 手动触发）。菜单里是你配置好的 AI 操作，点一下就开始跑。

3.2 内置操作

开箱即用，内置了以下常见操作：

• 翻译：支持多语言目标选择，不是那种"翻译成中文"写死的

• 润色：帮你把写得磕巴的句子说顺

• 扩写：一句话不够？让它给你展开

• 总结：长段落提炼核心

• 解释：看到陌生概念，选中，让 AI 解释给你听

• 续写：写到一半卡住了，让它接着写

• 校对：语法、拼写、表达问题一次找出来

• 生成问题：读完一段，生成几个复习问题，适合学习场景

• 打标签：自动给内容打标签，方便归档

3.3 流式输出 + 随时取消

结果是流式输出的，不是等一会儿突然蹦出来一大段文字。看着不对劲？按 Escape 随时取消，不用等它跑完。

3.4 四种结果处理方式

这个设计是我觉得最实用的地方。AI 跑完之后，结果可以：

• 弹窗展示：看一眼，不污染你的笔记

• 替换原文：直接覆盖你选中的内容

• 追加到末尾：在文档最后加上结果

• 插入到当前段落下方：结果紧跟在你选中的内容后面

不同场景用不同模式，每个操作都可以单独配置。

3.5 支持主流 AI 提供商

不绑定某一家：

• OpenAI

• Anthropic（Claude）

• Google Gemini

• DeepSeek

• XiaomiMiMo

• MiniMax

• Z.ai

• 自定义 OpenAI 兼容接口

支持自动拉取模型列表，也支持手动输入模型名。用哪家的 API，自己决定。

3.6 自定义操作

内置操作不够用？可以自己写。支持几个内置变量：

 {{selection}}       // 选中的文本
 {{language}}        // 目标语言
 {{filename}}        // 当前文件名
 {{date}}            // 当前日期
 {{sourceLanguage}}  // 来源语言
 {{targetLanguage}}  // 目标语言

写好之后可以导出成 JSON，分享给别人，或者导入别人写的操作集。

3.7 中英文界面切换

插件 UI 支持中文和英文切换，不需要装其他语言包。

4. 隐私说明

API Key 存在 Obsidian 本地的插件数据文件里，不上传到任何地方。

选中的文本只会发送给你自己配置的 AI 提供商，用哪家的 API 就发给哪家。

Chisel 不收集任何遥测数据。 你的笔记内容不经过我的任何服务器。

5. 安装方式

目前 Chisel 还在等待 Obsidian 官方插件市场的审核，在这之前可以手动安装：

1. 去 GitHub Release 页面 下载最新版本的 main.js、manifest.json、styles.css

2. 在你的 Vault 目录下找到 .obsidian/plugins/，新建文件夹 chisel

3. 把三个文件放进去

4. 重启 Obsidian，在「社区插件」设置中找到 Chisel 并启用

6. 写在最后

Chisel 对我自己来说，是一个真正解决了实际问题的工具。从动手写到现在，功能上还有很多可以做的，但核心体验——选中即触发，结果即处理——已经是我想要的样子了。

如果你也在用 Obsidian，可以试试看。如果觉得有帮助，去 GitHub 给个 Star，或者在 Ko-fi 请我喝杯咖啡，都行。

Bug 反馈和功能建议欢迎直接在 GitHub Issues 提。

感谢阅读，期待下次与你再见!