夜雨聆风
我现在写东西基本都在 Obsidian 里。
它的社区插件很多，刚开始很容易看到什么都想装。用了一段时间以后，我真正频繁使用的主要是两个：Editing Toolbar 和 Claudian。
Editing Toolbar 管编辑格式，Claudian 帮我改稿、润色和整理笔记。它们不是什么必须一起安装的组合，只是刚好解决了我在 Obsidian 里遇到最多的两类问题。
这篇主要写给刚开始用 Obsidian 的人。我不会把每一个设置都讲一遍，只讲这两个插件是什么、怎么装、我怎么用，以及使用过程中需要注意什么。
Editing Toolbar：先不用背那么多 Markdown
Editing Toolbar 是一个可视化编辑工具栏。安装以后，加粗、颜色、标题、清单、序号等操作都可以做成按钮，写东西时直接点，不用专门记 Markdown 语法和快捷键。
它有点像把 Word 里的那排格式按钮搬进了 Obsidian，但这里有个区别：按钮最后还是要往笔记里写入 Markdown 或 HTML。Obsidian 里看起来一样的格式，换到其他 Markdown 工具里，不一定还会按同样的方式显示。
对刚开始用 Obsidian 的人来说，这个插件的作用很直接。先把内容写起来，暂时不用停下来回忆清单怎么写、序号后面要不要加空格，或者某个格式该输入什么符号。
怎么安装
打开 Obsidian 的「设置」，进入「第三方插件」或「社区插件」。如果还处在安全模式，需要先允许安装社区插件。
点击「浏览」，搜索 Editing Toolbar，安装以后再点「启用」。安装和启用是两步，只安装没有启用，工具栏不会出现。
启用后进入 Editing Toolbar 的设置，可以选择工具栏的位置，也可以增加、删除和调整按钮顺序。
社区插件会以当前用户的权限运行，安装前最好确认插件名称、作者和仓库，不要只看一篇教程里的截图就安装同名文件。
我把它放在顶部，只留下常用按钮
Editing Toolbar 可以固定显示，也可以跟随光标。我把它放在编辑区顶部，因为位置比较稳定，写长文时不需要追着浮动工具栏找按钮。
我最常用的是标颜色、清单和序号。
标颜色主要用于整理笔记，先把需要回来处理的内容标出来。清单和序号的用量更大，列步骤、记待办或者整理一段内容时，点一下就能用，不需要来回切换输入状态。
插件支持的命令远不止这些，但我没有把按钮全部放上去。工具栏一长，找按钮的时间也会变长。常用的留在外面，偶尔才用一次的格式没有必要占位置。
新版 Editing Toolbar 也加入了 AI 功能，我把这部分去掉了。改稿和整理内容已经交给 Claudian，同一种功能没有必要在两个插件里都配置一遍。
用好它的关键，不是把按钮全部放上去
刚安装时，可以先把工具栏位置调好，再删除不认识或者暂时用不到的按钮。写几天以后，发现某个操作总要去命令面板里找，再把它加回来。
这种做法比照着别人的完整配置抄一遍省事。工具栏应该跟着自己的写作习惯调整，不需要追求功能齐全。
另一个需要留意的是按钮写入了什么格式。
加粗、标题、清单和序号这类常见 Markdown，通常比较容易迁移。文字颜色、对齐等效果可能依赖 HTML、CSS 或插件自己的处理方式。只在 Obsidian 里使用，一般不用太担心。如果笔记还要转到 MkDocs、公众号编辑器或其他发布工具，最好先拿一小段内容测试，不要只看 Obsidian 里的显示效果。
我自己从 Obsidian 转到 MkDocs 时就遇到过换行显示不同的问题。不过那是两边对 Markdown 换行的处理差异，不是 Editing Toolbar 造成的。遇到显示不一致时，先看原始 Markdown 写了什么，再判断是工具栏、主题，还是目标平台的解析规则。
工具栏不见了，先按顺序排查
如果安装以后没有看到工具栏，先确认插件是否已经启用，再进入插件设置检查工具栏位置。
如果之前一直正常，更新或重启以后突然不显示，可以先重新加载插件，或者重启一次 Obsidian。还不行，再暂时切换到默认主题、关闭相关 CSS 片段，看看是不是界面样式发生了冲突。
GitHub 上能找到工具栏在更新或重启后不显示的用户报告，但这不代表每个人都会遇到。把主题、CSS 和其他界面插件一次全部关掉，也不容易找到原因，逐项排查更快。
移动端虽然可以安装 Editing Toolbar，界面空间和操作方式与电脑不同，按钮多时更容易挤在一起。准备在电脑和手机上共用一套配置，最好分别看一下实际效果。
Claudian：在 Obsidian 里处理正在写的内容
Claudian 是一个把 AI 命令行工具接进 Obsidian 的社区插件。它可以在侧边栏对话，也能结合当前笔记和选中的文字做修改。
它不是装完就自带一套免费模型。Claudian 负责提供 Obsidian 里的交互界面，底下还要调用本机已经配置好的 AI CLI。使用哪个模型、走哪个接口，以及相应的费用和额度，取决于底下的配置。
我的模型配置主要通过 CCSwitch 管理，平时会使用 DeepSeek、Kimi、GLM 等国内模型。CCSwitch 的 API Key 和模型切换我之前单独写过，这里不再重复。
有一点需要说清楚：这不等于 Claudian 原生内置了 DeepSeek、Kimi 和 GLM。我的使用方式是先通过 CCSwitch 配好接口和模型，再由 Claudian 调用对应的 CLI 环境。
当前版本的 Claudian 也不只支持 Claude provider，还在扩展其他 provider。不同 provider 的安装要求、工具调用能力和兼容情况可能不同，所以我不会把自己能用的配置写成所有模型都能直接照抄的方案。
怎么安装
安装 Claudian 之前，先确认底下的 CLI 已经能用。
我的顺序是先在 CCSwitch 里完成模型和接口配置，再到终端运行对应的 CLI，确认可以正常发出问题并收到回答。终端这一关没有通过，先不要在 Obsidian 里反复重装插件，因为问题通常还没有到 Claudian 这一层。
确认 CLI 正常以后，打开 Obsidian 的「设置」，进入「社区插件」，搜索 Claudian，安装并启用。启用后打开它的侧边栏，先发一个简单请求，确认它能够读取当前笔记并正常返回内容。
如果终端里可以使用，Claudian 里却找不到命令，再检查插件设置中的 CLI 路径。macOS 和 Windows 的图形界面程序有时拿不到终端里的完整环境变量，这种情况下可能需要填写 CLI 可执行文件的绝对路径。
路径不是 API Key，也不是模型地址。它只是告诉 Claudian，应该从电脑的哪个位置启动已经安装好的 CLI。没有遇到「终端能用、插件不能用」，不必一开始就改这一项。
Claudian 依赖桌面系统上的 CLI 进程，目前属于桌面端插件，手机和平板上的 Obsidian 不能照搬这套用法。
简单的修改，我直接用行内编辑
一句话的问题比较明确时，我会直接用行内编辑。
比如句子读起来不顺、重复说了两遍，或者想压缩得短一点，这些任务不需要讨论太多。选中对应内容，告诉它要改什么，改完马上看结果。
我不会只写一句「帮我润色」。要求太宽，模型很容易把一句本来没什么问题的话改得更完整、更工整，原来的语气反而没了。
我一般会把目标说具体，比如：
或者：
把这句话压短一些，保留现在的说话方式，不要改成书面总结。
简单修改用行内编辑，省掉复制和替换的步骤。不过改完以后还是要看一遍，不能因为它直接写回原文，就默认修改一定成立。
复杂一点，就把选中的内容带进侧边栏
一段话如果有不止一个问题，或者我自己也没有确定修改方向，我会选中这段内容，把它带进 Claudian 的侧边栏对话。
这样原文还留在正文里，修改结果单独出现在侧边栏，可以来回比较。需要换一个方向时，也能继续补充要求，不用让它反复覆盖正文。
目标明确的时候，我直接用行内编辑。还需要讨论方向，就放进侧边栏。
例如一段话同时存在顺序不清、句子太长和语气变硬的问题，我会这样说：
请润色我选中的这段文字。
不要改变原意，保留原来的说话方式，先理顺句子之间的顺序，再删掉重复和空泛的表达。不要补充原文没有的经历和判断，只返回修改后的内容。
返回结果不合适，我会指出具体哪一句有问题，而不是不断重复「再自然一点」。修改要求越具体，结果越容易判断。
全文修改之前，先让它列方案
处理全文时，我更常用的方式不是让 Claudian 马上改，而是先让它检查。
我会要求它列出修改方案，说明哪一段有问题、为什么需要调整，以及建议怎么处理，但先不要动原文。
先检查这篇文章，不要直接修改。
请列出需要调整的位置，分别说明原文是什么、存在什么问题、建议怎么处理。不要补充文章中没有出现的经历、数据和判断，也不要为了结构整齐增加总结句。
这些建议不需要全部接受。我看完以后，判断哪些问题确实存在，再自己修改。
改完后，我会让 Claudian 再检查一遍。这一轮主要看原来的问题有没有解决，修改过程中有没有带出新的重复、断句或前后矛盾。
这种用法对我更合适。Claudian 负责把可能有问题的位置找出来，我来决定改不改，以及最后应该写成什么样。
让它直接改全文，我会要求列对照清单
有时候文章已经比较完整，问题也比较集中，我会让 Claudian 直接修改全文。
这种情况下，我会在要求里加一项：改完以后列出对照清单，每一处实质修改都要写清楚原文是什么、改完以后是什么，以及为什么修改。
请在不改变原意和作者语气的前提下修改全文。
完成后列出所有实质修改：
原文：
修改后：
修改原因：
错别字和单纯的标点修正可以合并说明。删句、调整顺序或者可能影响原意的修改，需要单独列出。
我会按这份清单逐项对照，再通读一次修改后的全文。
对照清单也是模型自己整理的，有时可能漏掉一两处，所以它只能帮助检查，不能代替检查。尤其是涉及观点、数据和个人经历的句子，不能只看修改后的文字更顺，就直接接受。
Claudian 最需要注意的几个问题
第一个是文件权限。
Claudian 不是只处理聊天框里的一小段文字。它调用的 AI CLI 可以围绕整个 Obsidian 仓库读取、搜索和修改文件，也可能执行命令。实际能访问到哪里，还取决于 provider、权限设置、外部目录和 MCP 配置。
刚开始使用时，不要直接让它批量整理整个仓库。先从当前笔记和选中的一段文字开始，确认它每次准备做什么，再逐步增加范围。重要内容动手前至少保留一份副本，不要打开跳过权限确认后再让它自由处理整个目录。
第二个是模型差异。
通过 CCSwitch 换成不同模型以后，普通问答能返回，不代表文件读取、工具调用和长文本修改都一样稳定。换模型时先用一篇测试笔记检查读取、修改和中文输出，再交给它处理正式内容。
第三个是故障排查顺序。
Claudian 没有响应时，先到终端运行同一个 CLI。终端也不能用，就检查模型配置、登录、接口和网络。终端能用而插件不能用，再检查 CLI 路径、Claudian 版本和 Obsidian 的启动环境。
这个顺序比反复卸载插件有效，因为它先判断问题到底发生在底下的 CLI，还是 Obsidian 里的这一层。
我为什么留下这两个
Editing Toolbar 和 Claudian 的功能其实都有继续扩展的空间。Editing Toolbar 已经加入 AI，Claudian 也不只会改一段文字。
但我日常使用时没有把它们的能力全部打开。
Editing Toolbar 放在顶部，只留下颜色、清单和序号这些经常点击的格式。Claudian 负责内容处理，简单问题用行内编辑，复杂一点就放进侧边栏，全文修改先看方案，或者在修改后逐项对照。
一个处理编辑动作，一个帮我检查和修改内容，分工够清楚，我也不用在两套 AI 功能之间来回切换配置。
刚开始用 Obsidian 时，不必先装一长串别人推荐的插件。遇到一个反复打断自己的操作，再找一个插件解决它，用几天，不顺手就删掉。我的工具栏和 Claudian 也是这样留下来的。