Ratel

by golddream-y
5
4
3
2
1
Score: 57/100

Description

An AI agent that indexes, searches, links, and curates your Obsidian vault with semantic understanding. Supports local Ollama for privacy-first usage.

Reviews

No reviews yet.

Stats

4
stars
972
downloads
0
forks
98
days
2
days
2
days
6
total PRs
0
open PRs
3
closed PRs
3
merged PRs
0
total issues
0
open issues
0
closed issues
857
commits

Latest Version

3 days ago

Changelog

更新日志

[1.5.6] - 2026-11-17

Fixed

  • 压缩停不下来、切会话还在显示:点停止后摘要请求仍在跑,切到别的会话也继续显示「压缩中」;现在停止或切换会话都会真正中断压缩,提示只跟着它所属的会话显示。
  • 长笔记写入失败提示:长内容一次提交失败后,助手会反复重试同样的写法;现在会明确改用分段写入,不再原地打转。

[1.5.5] - 2026-11-15

Added

  • 自定义请求头:OpenCode Go 等端点要求的额外请求头,在对话配置末尾填一行即可;直连官方地址会自动补齐。

Fixed

  • 粘贴链接显示乱码:从浏览器复制的中文笔记路径会变成 %E6%9E%B6…;现在粘进输入框会解码成可打开的 @笔记。
  • 大库索引更新慢:索引现在随笔记数量自动分块,升级后首次打开需稍等整理。
  • 长路径换行时输入框错位:中文、空格混排的长路径折行后文字与光标对不齐,删一个字符会删到别处;现在光标与文字始终一致。
  • 库外文件不给办法:关闭「允许访问库外」时,会提示开权限或直接贴内容。

[1.5.4] - 2026-11-14

修好对话里的链接打不开,并让索引的体积、进度与计数口径都对得上。

Fixed

  • 对话面板里的链接点了没反应。 回复正文中的内部笔记链接和外链此前都不会跳转;现在内部链接直接打开对应笔记,外链交给系统浏览器。
  • 带公式的图表变回 $$ 原文。 Mermaid 图里的公式此前只显示源码,现在正常排版;图形内的文字也不再被安全清洗误删。
  • 删掉的笔记每次启动都被重新检查。 已失效的路径以前每轮都要再走一遍删除,现在只处理一次。
  • GPU 预热实例退出后空等满 120 秒。 预热过的实例退出后不再被重新接管,下个请求直接重建。
  • GPU 推理中途失败会拖垮整轮。 超时或设备丢失时改由 CPU 完成本轮,完成后图标如实显示当前后端。
  • 改过配置目录名的库把插件目录当成笔记。 默认忽略规则改为跟随当前配置目录,自定义目录下的插件与缓存不再被索引。
  • 长时间使用后定时器越积越多。 请求结算、条目回收、心跳停止与插件卸载时都会成对清理,镜像探测遗留的计时器也一并修掉。
  • 索引状态行只能用鼠标展开。 现在支持 Enter / 空格,并带焦点描边。
  • 清理索引目录时偶发报错。 关闭索引会等内部预热链路结算完再释放,不再出现未处理拒绝。
  • 升级有安全公告的依赖。 DOMPurify 修掉一组清洗绕过(含 DOM XSS),@grpc/grpc-js、undici、KaTeX 与 js-yaml 一并升到公告范围之外;另清除一处未使用变量。

Changed

  • 安装包小了约 6.1 MiB(15.35 → 9.21 MiB)。 主包里两份从不参与运行的检索模型与词表被移除,搜索结果与既有行为不变。注意主文件仍超过 Obsidian Sync Standard 的 5 MB 限制,main.js 不会随 Sync 同步,仍需商店、BRAT 或手动复制安装。
  • 索引进度不再报假速率。 核对旧索引时按篇推进,真正写索引时按块推进并显示块/秒;此前会算出「40 篇/秒」这类与推理速度无关的数字。主界面只显示本轮完成进度,总量未定时不显示精确百分比或速率;落盘、提交和复用计数移到折叠诊断中。
  • 分块计数恢复为词表精确计数。 线程装配早于词表就绪,此前会提前捕获空词表、静默退化成按字符估算,英文与代码为主的笔记被切得偏碎;改为线程启动时再读取词表,切块与设置里的块大小口径一致。首次启动可能重新切块并重建索引,进度条会显示实际进度。

[1.5.3] - 2026-11-10

让索引状态说清自己在做什么:核对已有索引与真正生成向量分开显示,改一个文件后不会再停在「索引中」。

Added

  • 推理后端显示图标。 GPU 推理是闪电,CPU 推理是芯片,不必细看文字也能分辨。
  • 启动核对单独提示。 重新打开时先核对已有索引,顶部显示「核对中…」,与真正生成向量的「索引中」区分开。

Changed

  • 处理中与已完成用不同颜色。 进度条在处理时是警示色,全部完成后才变成完成色;此前部分主题下两者都是绿色,看不出区别。
  • 记忆功能也优先使用 GPU。 记忆的写入与检索以前固定走 CPU,现在与笔记索引一致,GPU 可用时优先,失败再回退。

Fixed

  • 改一个文件后状态停在「索引中」。 增量处理其实已经完成,但界面没有收到收尾更新,于是一直显示处理中;现在会正常回到「就绪」。
  • 启动核对的进度分母算进了已删除的笔记。 那些路径永远不会被处理,却让核对始终差几篇并报「未恢复」;现在只统计当前库里存在的笔记。
  • GPU 预热失败仍被当成可用。 预热失败说明这个执行器跑不通推理,以前会被继续投入使用并反复失败;现在直接回退 CPU。

[1.5.2] - 2026-11-09

修复 1.5.1 引入的索引变慢,并让检索在推理后端出问题时仍能给出结果。

Fixed

  • 索引速度恢复。 1.5.1 为修检索超时,在后台常驻了一份 CPU 推理会话;它和 GPU 抢资源,导致每块推理慢十几倍、内存占用翻倍。现在改回只在真正需要时才准备。
  • 检索不再整条链路干等。 查询拿不到结果时会在十几秒内改由 CPU 完成,而不是一直等到工具超时;用户主动取消不会被当成故障。

Changed

  • 检索仍优先使用 GPU。 实测 GPU 处理单条查询只要约 80 毫秒,1.5.1 把它整体挪到 CPU 的判断不成立,已撤回。

[1.5.1] - 2026-11-08

修复 1.5.0 引入的检索超时:语义搜索会卡住直到超时,而关键词搜索正常。

Fixed

  • 语义搜索超时。 1.5.0 把向量推理交给 GPU 后,查询用的小批量文本会在 GPU 上挂住不返回,导致检索一直等到超时。现在索引仍走 GPU,查询改回 CPU 完成 —— 查询量小,CPU 本来就够快,也不必冒 GPU 形状切换的风险。

[1.5.0] - 2026-11-08

索引速度打底:本地向量推理改由 GPU 执行,并把推理不再是瓶颈之后暴露出来的浪费一并收掉。

已有索引不需要重建:模型、维度、分块参数都没变,升级后直接接着用,已完成的笔记不会重新生成向量。

Added

  • 本地向量推理默认使用 GPU。 支持 WebGPU 的机器上,向量推理交给 GPU 执行;不支持、只有软件模拟、或初始化失败时自动回落到 CPU,索引照常可用。
  • 状态抽屉标出推理后端。 「知识库索引」右上角直接显示 GPU 推理 或 CPU 推理,快慢是否符合预期一眼可判。
  • 重启后显示索引进度恢复。 重新打开会先核对已完成的笔记,这期间明确显示「正在恢复已索引进度(N / M 篇)」,不再让人误以为从零重来。

Changed

  • 向量不再一律按 512 个 token 计算。 以前不管笔记多短都按满长度算,短块白算好几倍;现在按本批真实长度取档位填充,GPU 与 CPU 都更快。
  • 索引进度按篇上涨。 刷新间隔从 500 毫秒降到 250 毫秒,不再一次跳两篇。
  • 下载改为国内优先、失败自动换源。 模型与推理运行时都先走国内镜像,失败再切国际源,每个源还会重试;下载记录会被记住,下次优先用上次成功的那个。

Fixed

  • 下载中断留下半截文件。 模型以前直接写目标文件,中途失败会留下损坏文件且下次被当成已完成;现在先写临时文件再替换。
  • GPU 运行时下载失败会让索引整体不可用。 现在它只是可选组件,失败仅意味着这一轮走 CPU。
  • 同一段文本被分词两次。 生成向量时重复分词,纯属白费算力,已复用首轮结果。
  • 索引区篇数重复显示。 右上角已有「已索引 N / M 篇」,下方不再重复报同一个数字。
  • 控制台被推理日志刷屏。 每次装载模型都会打一屏算子分配提示,已压到只保留错误。

[1.4.0] - 2026-11-07

为 2.0 的大批量文件内容索引打底:索引写入移出主线程,改为分片存储。

Breaking

  • 索引写入默认走独立线程。 新增 indexThreadMode,默认开启。1.3.0 并没有开启线程索引——它只在后台线程做向量推理,分块、日志、清单与向量库写入都还在主线程。设置页可关闭,装配失败自动回落。

Added

  • 索引写入全部移入 Worker。 分块、日志、清单、向量库读写都不再占用主线程,索引期间界面保持可响应。
  • 分片存储。 按路径拆成 8–64 片,单次只写目标分片。这是支撑大批量文件索引的基础。
  • 状态面板显示每块耗时与模型加载阶段。 问题文件先跳过、最多重试 3 次后放弃,不再卡住整轮。

Changed

  • 索引按篇提交。 进度逐篇推进,不再整批跳。
  • 状态抽屉改版。 嵌入来源与「压缩上下文」移到分组标题右侧,索引区去重,统一字号层级。

Fixed

  • 索引文件被反复整份重写。 以前每处理一篇笔记,都要把整份索引重写一遍(大库是 200 MB 级),越往后越慢、磁盘写入量成倍增长;现在只写这篇笔记所在的那一小片。
  • 状态面板高频重渲染。 索引期间每秒重绘 4 次 → 只在计数变化时发布。
  • 索引没跑完就完全无法检索。 状态条写着「已完成的笔记可用于搜索」,检索工具却整体拒绝;现在只要嵌入可用且已有提交文件就能检索,空库仍拒绝。
  • 设置里的默认模型名写错。 说明文字写的是 XNova/jina-embeddings-v2-base-zh,实际默认是 Xenova/bge-small-zh-v1.5。

[1.3.0] - 2026-11-02

Added

  • 索引尚未建完,也能在中断后继续。 关闭、重启或意外中断后,会核对并复用已完成且未变化的笔记,继续处理剩余内容;已完成的笔记可以先用于搜索。
  • 索引不可用时可以单独重试。 插件会说明索引不可用的原因,其余功能仍可使用;可在命令面板运行“重试索引装配”重新尝试。
  • 新增“清理非活动索引代际(危险)”命令,可在确认后清理未生效的索引副本,保留当前活动索引。

Changed

  • 索引状态更清楚。 展开后统一显示已索引篇数、完成比例、剩余与失败数,并区分暂停、停滞和正在停止;聊天上下文占用率单独标明。
  • “清空索引”改为“重建当前索引”:逐篇核对并更新,不先清空已有索引。
  • 已编辑的笔记在新版本索引就绪前暂不参与检索,避免引用旧文本;其余已核对的笔记仍可搜索。

Fixed

  • 修复 API 嵌入模式下,检索未初始化却返回空结果的问题。
  • 修复关闭“自动索引”后仍可能创建或改写索引文件的问题;已有可核验的索引仍可用于搜索。

升级说明

  • 修改嵌入模型或分块参数后,需要重新加载插件并建立匹配的索引。新配置核对期间,旧配置索引不会直接参与搜索。

已知限制

  • 首次建立索引和重载后的核对仍可能较慢,性能优化尚未完成。

[1.2.1] - 2026-10-29

Fixed

  • 修复长时间索引导致重复重建、进度回退和失败误报完成;成功保存后,重启复用未修改笔记的索引。

[1.2.0] - 2026-10-28

Added

  • 精排支持当前对话模型,无需另配专用精排密钥;候选不超过 3 条时自动跳过。

Fixed

  • 移除 BM25 的重复初始化,避免内存膨胀,降低连续对话后的白屏风险。
  • 修复分块大小与重叠设置不生效,按模型长度限制切分,避免索引内容被截断。

Changed

  • 分块大小支持「精细 / 均衡 / 粗粒度 / 自定义」档位,并显示实际 token 数。升级后首次启动会重建索引,期间搜索暂不可用。

[1.1.1] - 2026-10-16

Changed

  • 等回答的时候,状态条改说诗句 — 新墨研开,风从远处来,归雁过山,檐雨一行一行数。话还在路上,这些句子轮着出现。以前翻来覆去只有「正在想下一步」。

Fixed

  • 刚发出的话会先存进这次对话 — 以前要等这一轮全部做完才保存。中途窗口闪退时,新开的对话会整场消失;现在重新打开后,这句还在。

[1.1.0] - 2026-10-11

Added

  • 断网时也能新建和修改模型配置 — 没有网络时新建配置默认按「自定义」处理,可以立刻填写接口地址、密钥、模型名和上下文长度,不用等供应商名单加载;打开已有配置时供应商选择会锁定并提示离线,地址、密钥、模型和窗口仍可照常修改保存。恢复网络后重选一次供应商或模型,窗口等字段即按名单校正。
  • 模型配置页新增「测试连接」 — 填好地址、密钥和模型名后点一下,只发一次最小请求验证能否连通:成功显示耗时;失败直接说明原因(密钥无效、模型不存在、网络不通、请求超时等)并给出排查建议,不用先到对话里试错。

Changed

  • 新建配置确定后直接进入配置页 — 以前确定名称后停在配置列表,还要再点一行;现在直接打开详情页开始填写。

Fixed

  • 长对话里反复用补丁改笔记时,旧补丁不再每轮重复发送 — 以前压缩上下文时漏掉了补丁正文的剥离,旧补丁会随对话历史反复占用发送额度,长任务更早触及上下文上限;现在与其他写入工具一样只保留必要信息。
  • 新建配置的名称弹窗按回车没有反应 — 现在回车等同点击「确定」;中文输入法组词时按回车仍然是选词,不会误提交。
  • 供应商选择页的说明文字不再贴住卡片边缘 — 说明改用设置框架的标准行承载,与「本机」等列表行左缘对齐,间距与其他设置项一致。

[1.0.3] - 2026-10-11

Changed

  • 子目录里的写作约定在这次对话里一直有效 — 读过或改过某个子目录里的笔记后,该目录的约定会在这次对话中继续生效。以前每发一条新消息就会忘掉,下一轮要重新碰到那个目录。对话被压缩之后,再碰到该目录会重新读取。

[1.0.2] - 2026-10-08

Changed

  • 对话模型名单超过一天会重新拉取 — 打开对话模型页时,本地名单超过 24 小时就向 models.dev 要一份新的。这次没要到仍用上次成功的名单。

[1.0.1] - 2026-10-04

Fixed

  • 新建模型配置从空白开始 — 不再自动复制上一套配置的地址、模型或密钥,也不会自动切换当前模型;需要沿用配置时,在详情页使用“复制配置”,副本有独立的密钥存储。
  • 技能停用后可以在同一场对话中重新激活 — 重复停用会明确提示当前未激活,不再把历史上使用过的技能误判为仍在启用。

Changed

  • 更新说明给出可以直接尝试的任务 — 从带来源查找笔记、整理文档、配置日记到继续长任务,说明如何开始;同时说明默认权限,版本与最低 Obsidian 要求随插件版本信息更新。
  • 减少技能收尾时重复回答 — 调整助手指引,避免每次回复都额外停用技能;需要停用时先完成操作,再输出一次最终答复。

[1.0.0] - 2026-10-04

Ratel 1.0:让积累的笔记参与工作。 在 Obsidian 里,从查找资料、整理文档到配置工作环境,用对话把事情做完。笔记保持 Markdown,模型由你选择,操作由你掌控。需要 Obsidian 1.13.1 或更新。

Added

  • 用补丁局部修改已有笔记 — 一次可以修改同一篇笔记的多处内容,全部匹配成功后才写入;格式错误会指出具体行号和标记要求,匹配失败会提示重新读取原文。

  • 保存多套对话模型配置,在顶栏切换 — 每套配置有自己的地址、模型和密钥;按供应商选择模型,自动填写已知的上下文窗口和单次输出上限,也可手动调整。密钥在模型设置里填写,并保存到钥匙串。

  • 在对话里移动、复制笔记 — 移动已有笔记会按 Obsidian 的设置处理链接;复制直接保留文件内容,无需让模型重新生成正文。

  • 写笔记时遵守目录里的写作约定 — 读取目标目录及上级目录的 AGENTS.md,让本轮修改遵守这些约定;修改约定文件仍需确认。

  • 写入、追加和替换后返回字数 — 助手可以根据实际汉字数和拉丁词数核对篇幅。

  • 长任务临近步数上限时先收束 — 回复只有提纲、还未完成写入时,会在同一轮继续尝试;工具超时会返回错误供助手处理。

  • 安装或升级后打开更新说明 — 在独立标签页查看这一版变化和模型配置入口。

Changed

  • 长对话减少重复发送已写入的正文和旧思考过程 — 聊天气泡保留原记录,模型需要原文时重新读取笔记。
  • 上下文进度条按当前实际发送量计算 — 支持时用模型接口返回的用量校准,并区分估算与接口用量。
  • 设置主页更简洁 — 每套模型配置、工具权限、提示词和诊断等长设置进入各自页面;供应商支持分组和中文别名搜索。
  • 对话状态随执行进度变化 — 状态行显示当前任务进展,继续目标按钮与目标标题不再重复显示。

Fixed

  • 工具参数格式错误时不会拿去改文件 — 区分非法 JSON、参数类型错误与输出长度限制,给出对应纠错信息;再次发送历史时不把失败参数当作正常调用。
  • 压缩后的占位说明不会误写进笔记 — 需要正文时先读取原笔记。
  • 隔天接着聊能对上日期 — 用户消息带上当时的发送时间,避免把历史里的“今天”当成当前日期。
  • 工具失败不会重复显示两行,输入光标不再被技能标签挡住。

[0.10.0] - 2026-09-24

这一版:可以在你允许之后,读取库外的文件,或在这台电脑上运行命令。

Added

  • 库外访问默认关闭 — 在设置 → 记忆与权限打开「允许访问库外」之后,对话里可以列出库外目录、读取库外文本、把文件原样拷进当前库、运行本机命令。读到的内容可能发给已配置的模型。每次使用仍按现在的权限确认:安全档和自动档都会问,危险档不再问,单个工具设成拒绝仍然拒绝。对话里的配置不能代开这个开关。技能脚本仍然不能借这条路读盘或跑命令。

Changed

  • 从访达复制的绝对路径可以贴进输入框 — 以前会直接拦住,并要求改成库内相对路径。现在路径会留下。开关还关着时会提示去打开;打开之后不再提示。它不会被当成一篇库内笔记。

[0.9.1] - 2026-09-24

这一版:插件简介不再写 Obsidian,商店审核才能通过。

Fixed

  • 商店简介去掉了 “Obsidian” — 社区插件目录里这个词是多余的,写上会被拒。

[0.9.0] - 2026-09-24

这一版:可以说出一种用法,让 Ratel 把对应的插件和设置装进当前库。

Added

  • 在对话里搜索、安装、更新、卸载社区插件 — 更新时保留对方已有的设置。每次变更可以回滚。
  • 按字段改其他插件的设置 — 只改点名的字段,不整份覆盖。密钥一类字段不会代填。插件已经有配置文件时也能改。
  • 把一套已经验证过的工作方式放进技能 — 说出用法,Ratel 按技能装插件、写模板、打开开关、建目录,并记下位置。内置的日记场景:说「装日记插件」,会装上 Templater、Dataview 和 Day Planner,写好日记模板和月报模板,把核心日记指到同一目录。Day Planner 的标题改完后,必须完全退出 Obsidian 再打开。另一个技能用来安排今天、收尾和月末复盘。
  • 斜杠菜单可以选择技能 — 选中后先落到输入框,再按一次回车才发送。没有后续内容的命令仍然选中就执行。
  • 内置工具默认允许 — 不用每一步都确认。之后改成询问或拒绝仍然有效。外部工具仍会询问。

Changed

  • 说明改成现在的产品 — Ratel 是 Obsidian 里的 Agent,用来把使用和配置变简单。使用手册分成中文和英文两份。

Fixed

  • 技能脚本不能再改配置目录。
  • 找不到文件时,不再把本机绝对路径显示在对话里。

[0.8.0] - 2026-09-17

这一版:隔天再打开同一场对话,能看出哪一段是哪一天。

Added

  • 消息流按本地日期插入分割线 — 跨了自然日会出现「今天 / 昨天 / 某月某日」;第二天再打开,「今天」会变成「昨天」。当天列表仍是相对时间,隔天才写日历日。
  • 隔很久再问时,助手能对上「现在」 — 隔天,或同一天里空了四小时以上,会带上距上一轮用户发言有多久,避免把历史里的「今天」当成现在。

[0.7.2] - 2026-09-16

这一版:网络不稳时能看见在重试;空索引不再空转嵌入。

Added

  • 接口抖动时,打字行会提示正在重试 — 以前仍显示「撰写中…」;出字或点停止后提示消失。

Changed

  • 发消息更省 — 同一场对话不再反复解析整份记录;本地嵌入空闲后会收起来。
  • 诊断演进 — 本机记下发送阶段(不含正文),诊断页能看上次是否像异常退出。内存偏高会提示一次。

Fixed

  • 主题索引为空或嵌入未就绪时,不再自动做主题向量 — 以前一发消息就可能空转占内存。

[0.7.1] - 2026-09-11

这一版:思考时点停止会马上停,接口抖一下也不再整轮作废。

Fixed

  • 思考中、刚发出去、工具一轮接一轮时,停止钮会真正停下来 — 以前模型还在想、一个字都没出来时,点多少次停止都没反应;后面的工具也会继续跑。现在会马上断开请求,后面的工具也不再开。正在跑的那一个工具仍会跑完再停。
  • 模型接口抖动或限流时会自动再试 — 以前偶发断连、网关错误或 429 会直接废掉这一轮,只能自己再发一条;现在会在还没开始打字前悄悄重试几次。已经开始出字的不会重试,避免气泡里出现重复半句。点停止会立刻打断等待。

[0.7.0] - 2026-09-09

这一版:可以立一个跨对话还在的长期目标,贴图也会直接发给当前模型。

Added

  • 长期目标 /goal
    • 先复述完成标准和回合上限,你点头后才创建;聊天里看到的就是你打的命令
    • 同时只一条未完成;和新目标冲突时当面问放弃还是继续
    • 跟着库走,换会话、关聊天也不丢;底栏和输入区上方会提醒,新对话里点接管接着干
    • 完成标准钉在这场对话里,压缩也不会忘;简单目标可以很快收工
    • 授权过的目录批量改笔记少弹窗,暂停即收回
    • 列表在状态抽屉「目标」或设置「查看目标」;完成后即关闭,归档只在列表里人手点
    • 回合用尽问加轮、先停或放弃,不当成做完;加轮只抬这一条的上限

Changed

  • 贴图会直接发给当前对话模型,不再需要「视觉输入」开关 — 本地 Ollama 与远端视觉模型都能看图;纯文本模型(如默认 DeepSeek)会在接口拒绝后提示你去掉图片或换模型
  • 索引只收 Markdown — 库里的图片不再当笔记切块进检索,避免无意义的图片路径噪声

Fixed

  • 粘贴电脑上的绝对路径不会再被当成库内笔记引用 — @ 补全只认库内相对路径,不会把 /Users/… 一类盘符路径当成一篇笔记

[0.6.1] - 2026-09-05

这一版:同一轮里不会把刚读过的笔记再打开一遍。

Fixed

  • 同一轮里不会反复打开已经读过的笔记 — 以前上下文一瘦身,助手会把刚看过的几篇再「查看」多遍;现在全文还在就不会再读。链接关系问句仍用链接图,不会为了凑引用把邻居整表再搜再读一遍

[0.6.0] - 2026-09-05

这一版:聊天里多了一只会看人的捣蛋鬼。忙闲、打字、报错时眼睛形状会变;个别汉字在流式回复里花成菱形问号的问题一并修了。

Added

  • 消息区有一只可拖的捣蛋鬼 — 跟鼠标看、表情跟对话忙闲走(等待、思考、干活、回答、听你打字、报错、停止);默认开着,可在外观里关掉
  • 位置会记住 — 拖到聊天窗里任意处,重载后还在;双击回到右下角;贴近左右边缘时会轻轻吸住

Changed

  • 闲着时更像活的 — 会连眨、轻晃,指针离开聊天窗也还自己瞟
  • 点一下会弹,忙的时候眼睛更好认 — 单击轻轻压扁再弹回(拖动不会误弹);思考是横缝、报错是内八、停止是月牙,不再都是同一个圆点

Fixed

  • 个别汉字在回复里变成三个菱形问号 — 原文里的「就」一类字,以前在打字机输出中会花掉;现在会完整显示

[0.5.2] - 2026-08-30

Fixed

  • 社区插件审核的依赖检查能过了 — 补齐锁定文件,并换掉有安全公告的间接依赖;日常使用与 0.5.1 相同

[0.5.1] - 2026-08-30

这一版:聊天贴图真正发给模型。输入区一直能贴图,但图经常发不出去或发错格式;这次把这条链路修好,并补上远端视觉开关。

Changed

  • 远端增加「视觉输入」开关,默认关闭 — 本地 Ollama 视觉模型仍自动发图;OpenRouter 等远端视觉模型需要打开此开关。避免 DeepSeek 这类纯文本接口误收图片报错

Fixed

  • 贴图会真正发给视觉模型 — 以前只扣额度、模型只看到字
  • 当前模型看不了图时会明确告诉你 — 不会悄悄当纯文本继续聊;可去掉图片、换视觉模型,或打开上述开关
  • 远端视觉模型看图不再整轮失败 — 以前误用本地 Ollama 的发图方式,OpenRouter 一类网关会返回 500
  • 点发送后图片预览立刻消失 — 以前要等整轮回答结束,预览栏才清空

[0.5.0] - 2026-08-20

这一批改动:技能从「说明书」变成「可执行的扩展」。技能可以自带脚本与参考资料;AI 用到时直接运行脚本——先经你授权、沙箱隔离、超时与熔断兜底——或按需翻阅参考资料。

Added

  • 技能可以自带脚本,AI 需要时直接运行 — 以前技能只是写给 AI 看的工作方法说明;现在技能还能附带 JavaScript 脚本,AI 用到时自动运行并把结果带回回答;参考资料(模板、清单等文本)也可以随技能附带,AI 按需查阅
  • 脚本第一次运行前会征求你的同意 — 弹窗写明是哪个技能、要运行哪个脚本、来自哪里;可选「允许并记住」(之后不再询问)、「仅此次」或「拒绝」
  • 脚本在隔离沙箱里运行,出不了你的笔记库 — 断网、不能加载外部程序库、文件访问仅限你的笔记库与该技能自身目录
  • 失控的脚本会被自动拦下 — 完全无进展超过时限(默认 30 秒,可在设置调整)判定卡死立即终止;任何脚本最长运行 10 分钟;同一脚本连续失败 3 次后熔断、不再执行
  • 持续有进展的长任务不会被一刀切杀掉 — 到时限时 AI 会拿到运行进度,由它判断继续等还是终止,并告诉你
  • Python、Shell 等其他语言的脚本不会被运行 — 会说明原因并引导改用 MCP

Fixed

  • 放进笔记库的技能现在能被正常识别了 — 之前放在库内 .ratel/skills/ 下的技能装了等于没装:这类隐藏文件夹不进 Obsidian 的文件索引,读取技能说明时被误判为「文件不存在」而静默跳过;现在改为直接从磁盘读取,技能加载与资料查阅恢复正常
  • 库内技能自带的脚本现在能正常运行了 — 之前无论怎么传路径都报「脚本路径非法」:工具把笔记库内的相对技能目录当绝对路径解析,拼出了错误位置;现在先拼上笔记库根目录再解析。顺带修正:不存在的脚本路径不会再弹授权确认框
  • 弹层不再带一圈阴影 — 会话历史下拉、消息位置预览、引用悬停提示这些浮层外围的大块投影去掉了,改用细边框勾轮廓,界面观感更干净一致

[0.4.0] - 2026-08-19

这一版:记忆开始分层。重要偏好「钉住」永不截断;每轮提问自动带上最相关的主题记忆,不用等 AI 主动去查;技能推荐也按相关性排序,在对的时刻更容易被用上。

Added

  • 重要记忆可以「钉住」,再长也不会被截掉 — 以前全局记忆超过容量上限时整段裁剪,关键偏好可能悄悄丢失;现在段落标题后加 [pinned](如 ## 输出风格 [pinned]),该段永远完整带入每一轮对话
  • 每轮提问自动带上最相关的主题记忆 — 以前主题记忆要等 AI 主动去查;现在提问时自动检索最相关的几条(名称+摘要)直接注入对话;「自动注入相关主题数」可调(0–10,0 关闭,也可让 AI 代改)
  • 记忆面板显示每个主题「命中 N 次」 — 哪些主题记忆真的在被用到,一眼看清

Changed

  • 「+ 新对话」挪到了会话名称左侧 — 不再挤在 logo 旁边;还没发过消息的空白对话本来就在新会话里,此时不再显示加号
  • 改会话标题移进了会话列表 — 鼠标悬停某条会话,行内直接出现 ✎ 编辑和 × 删除;顶栏不再常驻编辑按钮,不抢注意力
  • 技能推荐按与当前提问的相关性排序 — 最相关的技能排在前面优先展示,更容易在对的时刻被用上;单条技能说明过长时自动截短,不再挤占对话空间

Fixed

  • 设置里改「记忆返回上限」立即生效 — 之前要重载插件,记忆搜索才会按新上限截断返回内容
  • 钉住段落里包含代码块时不再失效 — 之前代码块里以 # 开头的行(如 shell 注释)会被误当成标题,钉住的正文仍可能被截掉;现在只要标了 [pinned] 就完整保留

[0.3.0] - 2026-08-17

这一版:AI 能直接帮你打开笔记、改设置,以及技能装了就生效。聊到哪篇笔记说一声就翻开;设置白名单内的项问一句就能代改;技能不再需要手动开关。

Added

  • 说一声「打开那篇笔记」— AI 直接在 Obsidian 里翻开并定位 — 聊到哪篇开哪篇,还能跳到指定标题或段落,不用自己在文件列表里找
  • 对话式配置与排障 — 问「帮我换个模型」「索引怎么不跑了」,AI 会先读当前配置和密钥状态再下结论;白名单内的设置(模型 / 分块 / 索引 / 记忆 / 外观)可以代改,每次都会先征求你的同意
  • API 密钥只引导、不代填 — AI 只能看到「配没配」,拿不到也填不了明文;需要时会告诉你去哪里添加、该加哪个条目
  • AI 能把设置页带到你眼前 — 需要你手动改的项(密钥、MCP、工具权限),AI 直接定位打开对应的设置页,不用自己翻菜单
  • 状态抽屉新增「技能」入口 — 统一管理已装技能:每个技能可单独开关(立即生效、重启后保持)、查看全文、编辑或删除(删除需两击确认);内置技能只读,随插件更新

Changed

  • 单条超长工具结果先截短再发给模型 — 一次搜出几千个文件时,发给模型的正文保留头尾要点,聊天气泡里仍是全文;需要中段时模型会自己再查
  • 技能装了就生效 — 安装后自动可用,不再需要去设置里打开总开关(旧设置项已移除)
  • 聊天与提示文案中「激活技能」改为「使用技能」 — 语义更直白

Removed

  • 移除 /skill、/skills、/skill off 斜杠命令 — 原命令无实际功能;需要时直接用自然语言点名技能即可

Fixed

  • 窗口再大、工具输出再长,你的提问也不会被挤出对话 — 之前历史上限按 32K 时代写死,占用才 1% 时一轮大搜索就可能先砍掉你刚发的问题,模型回「你还没提问」;现在按你设置的模型窗口留足空间
  • 刚发出请求点暂停立即生效 — 之前要等模型开始输出才能停,现在一点就掐断请求
  • AI 改设置时,开着的设置面板立刻显示新值 — 不用关掉重开面板

[0.2.4] - 2026-08-16

这一版:聊天反应快了。长回复生成时不再冻住界面,写完的段落立刻排好版;几百条消息的长会话滚动、回跳也依旧顺滑。

Changed

  • 生成几千字的长回复不再卡住界面 — 流式文字轻量追加,一段写完才渲染成 Markdown;生成中随时可滚动、切笔记、点停止
  • 流式输出中写完的段落立刻排好版 — 标题、代码块、表格在生成过程中就呈现最终格式,不用等工具调用或整轮回答结束
  • 几百条消息的长会话滚动依旧顺滑 — 只有屏幕附近的内容参与渲染,翻到很久以前也不卡
  • 会话右侧的小圆点,点哪个就跳回哪一轮提问 — 哪怕那轮已经被翻到很远之前,也能一击定位、高亮一下

Fixed

  • 设置里改了上下文长度,抽屉不再被旧值盖回去 — 之前一轮回答结束时会把这轮开始时的旧上限写回状态抽屉,自定义长度看起来「没生效」;现在抽屉始终按当前设置显示

[0.2.3] - 2026-08-14

这一版:助手消息里的代码、流程图、表格怎么展示。以前代码和流程图几乎是贴在正文里,现在各自成块,能复制、能看清。

Added

  • 代码块独立展示 — 有语言名,一键复制源码
  • 流程图独立展示 — 能复制 mermaid 源码;跟着库的亮色 / 暗色;节点上的字会画出来
  • 宽表格可以左右滑 — 窄侧栏里不再把气泡撑破

[0.2.2] - 2026-08-14

Fixed

  • 能正常从社区商店更新到这版 — 修复几个会卡住商店审核的问题

[0.2.0] - 2026-08-14

这一版两件大事:聊天看起来不一样了(空态舞台、入场、扫光和发送烟花),以及 压缩不再毁掉对话(只压发给模型的上下文,记录全部留着)。

Added

  • 空会话有欢迎舞台 — 中央铜色能量球(灰底能透出)、玻璃托盘上写「想从库里查找什么?」、副句轮换;发出第一条后背景卸掉
  • 消息与引用柔和入场 — 气泡和 cite 芯片淡入,不再硬切;用户气泡带一圈细描边微光
  • 会话标题落定有过渡 — AI 总结替换占位标题时交叉溶解,而不是瞬间跳字
  • 空态词标粒子聚拢、顶栏扫光、发送烟花 — 空态「Ratel.」从远处聚成字;有对话后顶栏残影收拢再扫光;发送钮悬停扫光;发送成功放一小簇火花(点停止不放)
  • 占用数字会跳着涨 — 状态条上下文百分比平滑计数;斜杠命令和会话列表错落入场
  • 聊天装饰动效可关 — 外观设置一键关掉;系统开了「减少动态效果」时自动静默
  • 上下文快满时会自动压缩 — 默认开启,可在「对话模型」关掉;压的是发给模型的内容,聊天气泡全部留着

Changed

  • **/compact 不再清空对话** — 不再弹「不可撤销」确认;记录一条不删,对话流出现「正在压缩 / 已压缩」分隔;模型仍报太长时会先压再试一轮

Fixed

  • 权限三档重新合成一颗胶囊 — 不再被 Obsidian 默认按钮拆成三个灰钮
  • 压过的会话重开后占用不再虚高 — 按实际发给模型的上下文计算,避免进度条被历史气泡撑满
  • 生成中的停止钮能点到 — 发送火花不再盖住停止方块
  • 空态「Ratel.」聚完不再跳位 — 落在原处,标点和旁边的图形错开一点

[0.1.19] - 2026-08-11

Added

  • 右侧点列可跳回某一轮提问 — 悬停看摘要,一键回底;设置里可关或改到左边
  • 工具权限三档:安全 / 自动 / 危险 — 自动档读写少打断,删除仍会确认
  • 思考球动画 — 模型在想、在写、在调工具时显示点阵小球,替代原来的小黄点

Changed

  • 发送钮改为 ↑,生成中为停止方块 — 窄侧栏不再被「发送」二字撑宽
  • 聊天底栏避开 Obsidian 状态栏 — 权限开关与提示不再被挡
  • 引用编号悬停显示笔记路径 — [n] 是检索序号,不是章节号

Fixed

  • 跟进回答里的 [n] 也能点开 — 沿用本场最近一次检索结果,不再变灰
  • AI 标题总结与 ✎ 编辑框一致 — 不再卡在开场白截断的临时标题上

[0.1.18] - 2026-08-09

Added

  • 可编辑会话标题 — 顶栏会话名旁的 ✎ 打开简洁编辑框;可手改,也可一键「AI 总结」
  • 生成中切换会话会先确认 — 避免默默打断正在写的回复;确认后才会停止并切换

Changed

  • 「本次会话不再询问」按工具放行整场 — 同一工具读多篇笔记不再反复弹窗
  • MCP 开启/添加后立刻同步工具列表 — 不再出现刚开却显示「无工具」的竞态
  • MCP 管理去掉多余「停止」 — 关开关即可;「刷新」负责强制重连
  • 「来源 N 篇」改成 pill 样式 — 不再被 Obsidian 默认按钮样式切穿中文

Fixed

  • 对话正文可以拖选复制 — 覆盖 Obsidian 全局禁选,消息与思考/工具详情可选中
  • DeepSeek V4 标题总结不再常失败 — 短任务不再启用思考模式,避免思考占满输出上限后标题退回开场白截断

[0.1.17] - 2026-08-04

Fixed

  • 社区商店刷新 / 更新不再卡在检查报错 — 修复一处不符合商店规则的问题

[0.1.16] - 2026-08-04

Added

  • 接入 MCP 服务器 — 在状态抽屉管理 HTTP / 本地命令 MCP,也可粘贴 Claude / Cursor 配置一键导入;工具进入对话,时间线里带 MCP 标识,权限可设允许 / 询问 / 拒绝

Fixed

  • 改设置后界面会跟着刷新 — 模型芯片、上下文上限等不再卡在旧值
  • 重启后仍能看到当前对话占了多少上下文 — 打开历史会话会重算占用,并滚到最新消息

[0.1.15] - 2026-07-31

Added

  • 问题反馈入口 — 状态抽屉可打开反馈窗口:复制诊断摘要(不含笔记正文)并跳转 GitHub Issues

Changed

  • 记忆管理并入聊天 — 不再单独开记忆侧栏;从状态抽屉或设置打开同一记忆窗口(筛选 / 搜索 / 编辑 / 清理能力不变)

Fixed

  • 记忆窗口会跟着写入刷新 — 模型写入主题记忆后,已打开的管理界面马上看到新条目,不用关再开
  • 设置页密钥提示不再重复堆叠 — 改设置时提示区先清空再画,避免挤成窄列

Removed

  • 记忆专用侧栏图标 — 去掉 ribbon 上的大脑图标入口

[0.1.14] - 2026-07-29

Changed

  • 有正文引用时不再重复露出来源芯片 — 回答里已经写了可点的 [1][2] 时,底部来源条会隐藏,只留正文引用
  • 没有内联引用时来源默认折叠 — 先显示「来源 N 篇」,点开再展开芯片;悬停仍可看完整笔记路径
  • 换场或重开侧栏后引用仍可点 — 从本场检索记录还原来源,不用重新搜一遍才能打开笔记

Fixed

  • 同一回合再次搜空时清掉旧来源 — 避免还点到上一轮的笔记
  • 引用编号与检索结果对齐 — 发给模型的 [n] 清单与界面芯片用同一套编号

[0.1.13] - 2026-07-25

Added

  • 关掉侧栏再开还能续聊 — 回到你上一场对话,思考过程与工具步骤也会一起回来,不用从头再说一遍
  • 多场对话可切换 — 右上角短标题芯片打开最近列表;可开新对话、点回旧场、删除不要的场
  • 首轮自动起标题 — 开场后会生成短标题(芯片上)和正常标题(列表里);失败时用你的第一句话截断顶上

Changed

  • **/new 与菜单「新对话」同一套逻辑** — 有内容的旧场会留在列表里;空白场不会堆一堆空对话
  • 切换时有加载反馈 — 消息区先淡出,短暂「加载会话… / 新对话…」,再淡入;减少动态效果时仍有加载提示
  • Skill 跟这场对话走 — 激活过的技能指令留在本场;换场或新开对话不会把上一场的技能串过来

[0.1.10 – 0.1.12] - 2026-07-18

含中间发版 0.1.10 / 0.1.11;请以 0.1.12 为准。

Added

  • 聊天外观可调 — 设置新增「外观」页:颜色模式(跟随 Obsidian / 浅色 / 深色)与强调色色块;改完立刻作用在侧栏,不用重启
  • 铜色强调 — 新增「铜」色块;深色下选「跟随」时默认用接近原型的暖铜调

Changed

  • 深色更接近设计稿 — Ratel 深色(以及 Obsidian 暗色 +「跟随」)用暖墨底与浅纸色文字,不再是冷灰一块
  • 发送钮跟强调色走 — 点色块后发送按钮、引用编号、芯片会一起变色

Fixed

  • 能正常从社区商店安装 / 更新这版 — 修复商店校验发布包失败的问题

[0.1.9] - 2026-07-17

Added

  • 点开工具步骤能看懂在干什么 — 例如列目录会写成「在 Adventurer 找到 3 个文件」,并列出文件名;不再默认展开一长串 JSON
  • 思考模式跑完工具还能继续聊 — 用 DeepSeek 等带「思考过程」的模型时,助手查完笔记、列完目录后可以正常接着回答;以前会中途报错停住

Changed

  • 思考与工具排成一条工作轨迹 — 连续的「思考 → 列目录 → 再思考」共用一根细左边线,一眼能扫完整段过程,不再每一步各自一条粗边框
  • 界面文案更齐全 — 侧栏标题、设置里的语言与嵌入提供方选项会跟着中/英文切换

Fixed

  • 笔记很少时搜索不再报错 — 小库自动改用语义检索,搜索结果仍可用

[0.1.8] - 2026-07-17

Changed

  • 对话优先的聊天侧栏 — 状态条沉到输入框上方,不再夹在消息中间;标题更简洁,忙的时候不再整栏抢戏
  • 一体输入区 — 加号、输入框、发送/停止在同一圆角壳里,slash 与 @ 菜单贴着输入框打开
  • 出处更好点 — 检索结果变成可点的笔记芯片;回答里的 [1][2] 也能一点打开同一篇笔记
  • 工具过程更好扫 — 思考与工具调用收成细时间线,而不是厚卡片堆

Fixed

  • 自定义技能目录能正常加载 — 之前把技能目录设在笔记库内会导致加载失败;目录不存在时也不再反复告警

[0.1.7] - 2026-07-16

Added

  • 顺着链接找笔记 — 看一篇的出链、反链、未解析链接;按标签或属性筛笔记;一眼看库目录与孤儿笔记
  • 检索更懂结构 — 语义搜索结果带上标签与反链数,方便判断哪篇更「权威」

Changed

  • 状态抽屉文案 — 去掉几处易误导的技术性提示

[0.1.6] - 2026-07-15

Added

  • 设置分四页 — 对话模型 / 笔记索引 / 记忆与权限 / 高级;一键场景预设(DeepSeek / Ollama / 自定义)
  • 用 @ 点名笔记 — 输入时补全,发送时带上路径;文件菜单也可「添加到 Ratel」

Fixed

  • 重启不再无故全量重索引 — 未改动的笔记会跳过,启动更快
  • 压缩对话后模型报错 — 之前压缩过的对话接着聊容易触发 DeepSeek 等模型接口报错,现在压缩后仍能正常继续
  • 设置页切换标签没反应 — 之前点了不切换,现在能正常切换
  • 对话时状态条重复提示 — 忙时只保留一条清晰提示,不再同时刷出几条

[0.1.5] - 2026-07-14

Added

  • 更懂当前上下文 — 每轮知道本地时间;能用当前笔记、日记路径、最近编辑、大纲,少绕弯
  • 日记路径约定 — 可在设置里指定日记文件夹与日期格式(只探测,不擅自建文件)

Changed

  • 使用手册按场景重组 — 不再逐项罗列菜单,改为按你想做的事组织,方便按需查阅;安装说明以社区商店为主

[0.1.4] - 2026-07-14

Fixed

  • 首次安装可能加载失败 — 无本地数据时的空值错误已修复;卸载时也不再二次报错

[0.1.3] - 2026-07-14

Added

  • Skill 扩展 — 在 .ratel/skills/ 等处放 SKILL.md,用 /skill 开关工作流
  • 跨会话记忆 — 可以说「记住我喜欢…」,存在库内 Markdown,可在记忆面板查看编辑
  • 中英文界面 — 设置里切换语言;工具步骤显示本地化友好名
  • 更聪明的索引 — 未改动的笔记启动时跳过;损坏索引会自动降级重建

Fixed

  • 社区商店安装后无法加载 — 与 Obsidian 1.13+ 的安装包检查冲突已解决,装完可正常启用
  • 几处索引操作的小问题 — 手动全量重索引、关闭自动索引、删除旧索引条目时不再出错

[0.1.0] - 2026-06-28

Added

  • 和知识库对话 — 自然语言提问,流式回答,带来源
  • 多步办事 — 自动检索多篇笔记再综述;深度可配置
  • 混合检索 — 语义 + 关键词 + 链接信号
  • 默认本地嵌入 — 不把笔记内容发去嵌入云(除非你改成 API)
  • 自选模型 — DeepSeek / Claude / Ollama;密钥进钥匙串
  • 可控改库 — 每个工具可单独设「允许 / 询问 / 拒绝」;配合状态条与诊断面板,改了什么一目了然

已知限制

  • 仅桌面端
  • 超大库首次索引较慢
  • Claude 侧思考块尚未接入(DeepSeek 思考过程已支持)

README file from

Github

Ratel — Let knowledge grow. Let creation happen. A connected note workspace, illustrated.

English · 简体中文

License Obsidian Desktop only

Find your notes, finish the work, and set up your Obsidian workflow.

Ratel is an AI assistant that can read notes and take action inside Obsidian. Ask it to find information across your notes, develop ideas, and turn scattered material into a document, or install and configure a daily-note workflow. It remembers your folders and preferences, answers with sources you can open, and follows your tool permissions.

Your notes remain ordinary Markdown files. Choose DeepSeek, Ollama, or an OpenAI-compatible chat endpoint. The search index is generated locally by default. Indexing saves progress note by note, so it can resume after an interruption; completed notes are available for search while the rest are being indexed.

Get started · User guide · Changelog

Requires Obsidian 1.13.1+. Desktop only.

Set up a workflow you can actually use

Set up daily notes and monthly reviews.

A daily-note workflow often needs several plugins to work together: templates create notes, a timeline displays today's plan, and a monthly ledger tracks goals. Installing the plugins still leaves folders and settings to align.

Ratel's built-in diary skill installs Templater, Dataview, and Day Planner, writes daily and monthly templates, configures the core daily-note folder, and remembers those locations. The skill explains the changes and asks about your folder convention before proceeding. Existing templates are not overwritten automatically.

Once configured, you can ask:

  • “Plan today's work.” Draft time blocks from monthly goals and yesterday's unfinished tasks.
  • “Sync today's ledger.” Extract work records from your daily note and update monthly progress.
  • “Review this month.” Draft a review and next month's goals from your notes and ledger.

Set up and use the diary workflow

You can package a working setup as a skill: plugins, settings, templates, and instructions for ongoing use. Share the skill folder so others can run it in their own vault. Write a scene skill

Turn accumulated notes into answers and useful documents

Turn my notes about this project into a background document. Keep the sources, and show me a draft first.

You do not need to remember the title. Ratel searches using meaning, keywords, and link relationships, reads the relevant notes, and organizes the material into an answer or document. Citations open the original notes so you can check the conclusions.

Ask it to summarize the active note, filter by tags or properties, inspect backlinks, or open a note at a specific heading. When writing back, specify the destination and scope. Tool permissions govern the changes.

Existing notes can be edited by matching a unique passage, moved, or copied without regenerating their content.

Find, understand, and organize notes

Keep your working conventions and continue longer tasks

Remember: project material belongs in Projects. Show a draft before writing a summary.

Preferences and folder conventions can become memory shared across chats. Memory is stored locally as Markdown you can inspect, edit, or delete.

For work that takes several rounds, use /goal to agree on completion criteria. Goals stay with the vault and can be taken over in a new chat. Paused or exhausted goals show their status. This supports ongoing work; it does not promise background execution while Obsidian is closed.

Memory and long-running goals

Get started

  1. In Obsidian, open Settings → Community plugins → Browse, search for Ratel, install, and enable it. Ratel's main plugin file is about 9.2 MiB. Obsidian Sync Standard limits a single file to 5 MB, so main.js is not synced; install or update through the community catalog, BRAT, or a manual copy instead.
  2. In Settings → Ratel → Chat model, open the current row under Saved setups and select a provider and model. Enter the remote model's API key in that setup's model settings. It is automatically synced to Obsidian Keychain for encrypted storage; local Ollama usually needs no key.
  3. Wait for the first index, open chat with the 🦡 ribbon icon, and ask: “Find notes about a topic in this vault and list the sources.”

Local embeddings need an initial download of the model and runtime assets. Open the answer's sources to verify the results before trying writing or setup tasks.

Review tool permissions before first use. Built-in tools default to Allow, including writing, deleting notes, and changing plugins. Safe mode also permits tools set to Allow. To require confirmation, set the relevant tools to Ask in Settings → Ratel → Memory & permissions and use Safe mode. Permission details

Control your data and changes

  • Local storage: indexes, chats, and memory stay on this machine. No telemetry. Embeddings are local by default; remote chat still receives the content needed for the task.
  • Model calls: chat and its context go to your configured chat endpoint. Remote embedding or reranking, if enabled, sends the relevant text to those endpoints.
  • Optional connections: local models and runtime assets are downloaded initially. Enabled MCP tools connect to their servers. Plugin installation and updates access the official catalog and the selected plugin's GitHub release.
  • Recorded changes: plugin installation, updates, removal, and configuration changes keep change records and recovery backups. Ask Ratel to inspect the history and restore a specific change.
  • Host access: reading or importing outside files and running local commands are off by default. Enable access manually; tool permissions still apply. Danger mode skips confirmation. A tool set to Deny stays blocked.

Full permission and privacy details

Extend your workflow

Configure chat, embedding, and reranking models independently. Skills store reusable instructions in Markdown, with optional references and JavaScript run in a restricted vm context (not a hard security boundary). MCP can connect external tools such as web search. Subagents can assist with retrieval, review, and organization. Attached images go to the current chat model, which must support vision.

Use extensions · Product direction and capabilities not yet delivered · Architecture · Repository layout · Decision records

Support and contribute

See Troubleshooting and reference, or open a GitHub issue. Sharing a scene skill you have tested helps others use Obsidian too.

Optional sponsorship: Afdian · Ko-fi. Sponsorship does not change any feature. Details

License: Apache-2.0