Releases: KineiChou/obsidian-homing
Release list
Homing 0.2.8
中文说明见下方。
Highlights in 0.2.8
- Better suggestions with OpenRouter, OpenAI-compatible services, Anthropic and Ollama. These providers now report how likely each folder is, as TypeSafe Jev already did. Before, every note looked like a close call: Organize inbox pre-checked nothing and the pill always listed alternatives. Now clear suggestions are pre-checked, and alternatives only appear when the model is unsure. Suggestions you saved earlier keep working; choose Analyze again on a note to get the new scores.
- Works with more services. If a service doesn't support structured output, Homing retries that request once in plain JSON mode. The retry counts as one more request.
- A cleaner Analyze inbox notes dialog, in the same style as the link card: note count, requests per note and requests left today at a glance, and each note's folder and date in the list.
- In the default theme, note titles and Change in Organize inbox no longer look like grey buttons.
- Link underlines look the same across supported Obsidian versions.
- Release files now carry GitHub build provenance. Check them with
gh attestation verify main.js -R KineiChou/obsidian-homing.
Install
Update Homing from Settings → Community plugins, or download main.js, manifest.json and styles.css below into <your vault>/.obsidian/plugins/homing/. Requires Obsidian 1.11.4 or later on desktop.
中文说明
0.2.8 主要内容
- OpenRouter、OpenAI 兼容服务、Anthropic 和 Ollama 的建议更准确:这些服务现在会像 TypeSafe Jev 一样给出每个目录的可能性。以前每篇笔记都像是“拿不准”,整理收件箱时一篇都不预先勾选,胶囊也总是列出备选目录;现在明确的建议会默认勾选,只有模型确实犹豫时才显示备选。之前保存的建议照常可用,对笔记选择“重新分析”即可得到新的判断。
- 兼容更多服务:服务不支持结构化输出时,Homing 会以普通 JSON 模式重试一次,多计一次请求。
- “分析收件箱笔记”弹窗更清爽,与链接卡片风格一致:篇数、每篇请求数和今日剩余次数一目了然,列表中显示每篇笔记所在目录和日期。
- 默认主题下,“整理收件箱”中的笔记标题和“更改”不再显示成灰色按钮。
- 链接下划线在各个支持的 Obsidian 版本中显示一致。
- 发布文件附带 GitHub 构建来源证明,可用
gh attestation verify main.js -R KineiChou/obsidian-homing校验。
安装:在“设置 → 第三方插件”中更新 Homing,或下载下方三个文件放入 <知识库>/.obsidian/plugins/homing/。需要 Obsidian 1.11.4+ 桌面版。
许可证:Copyright 2026 KineiChou,Apache-2.0。
Homing 0.2.7
中文说明见下方。
Highlights in 0.2.7
-
Finds your folders after a restart. Right after Obsidian started, filing could report "no eligible destination folders" and drop saved suggestions until a folder changed. Fixed.
-
Attachments move with the note. When Obsidian keeps attachments next to notes (same folder or a subfolder), filing moves the note's inbox attachments too, into the matching place at the destination. Only attachments no other file uses move. The pill shows how many will move before you confirm, and Undo moves them back. Attachment folders are no longer offered as filing destinations.
-
New folders get a second look. Creating a folder that can hold notes re-analyzes existing suggestions once in the background (automatic filing only). The current suggestion stays until a new one arrives.
-
Link and unlink from the keyboard. New commands: Link or unlink at cursor… (
homing:link-menu) opens a keyboard list of actions, and Remove link at cursor (homing:unlink) turns a link back into its text. No default hotkeys. Map them in Vim with Vimrc Support:exmap hominglink obcommand homing:link-menu nmap <Space>l :hominglink<CR>
-
A lighter link card. Title and actions share one row, with a small Link button and icon buttons. For ambiguous mentions, clicking a candidate links it.
-
The filed pill stays on one line for long folder paths.
Install
Install Homing from Settings → Community plugins, or download main.js, manifest.json and styles.css below into <your vault>/.obsidian/plugins/homing/. Requires Obsidian 1.11.4 or later on desktop.
中文说明
0.2.7 主要内容
- 重启后能找到目录:修复了 Obsidian 刚启动时归档提示“没有可用的归档目录”、已保存建议丢失,直到目录发生变化才恢复的问题。
- 附件随笔记移动:Obsidian 的附件位置设为“当前文件所在文件夹”或“其下子文件夹”时,归档会把笔记在收件箱里的附件一起移到目标处对应的位置。只移动没有被其他文件引用的附件;确认前胶囊会显示将移动的数量,撤销时一并移回。附件文件夹不再出现在归档目标中。
- 新目录后重新判断:新建可归档的目录后,已有建议会在后台重新判断一次(仅在自动归档开启时)。新结果出来前,原建议保持不变。
- 键盘建立、取消链接:新增“在光标处建立或取消链接…”(
homing:link-menu)与“取消光标处的链接”(homing:unlink)。默认不绑定快捷键,可用 Vimrc Support 映射到 leader 键,示例见上方。 - 更轻的链接卡片:标题与操作在同一行,小号“链接”按钮配图标按钮;有歧义时点选候选即链接。
- 归档完成的胶囊在目录路径较长时保持单行。
安装:在“设置 → 第三方插件”中搜索 Homing 安装,或下载下方三个文件放入 <知识库>/.obsidian/plugins/homing/。需要 Obsidian 1.11.4+ 桌面版。
许可证:Copyright 2026 KineiChou,Apache-2.0。
Homing 0.2.5
中文说明见下方。
What Homing does
Homing files inbox notes into the folders you already have, and links mentions to the right notes as you write. Nothing moves and no link is inserted until you confirm it.
Highlights
- File from the editor. A small pill in the note's top-right corner shows the suggested folder, in every view mode. Confirm, pick another folder, undo, or jump to the next inbox note, all without leaving the note.
- Organize inbox, anywhere. Review every destination in one dialog and file several notes at once. Or right-click notes and the inbox folder in Obsidian's file explorer or in Notebook Navigator.
- Analyze on open. Opening an inbox note that has no suggestion yet analyzes that note once.
- Local-first link suggestions. Title, alias, plural and keyphrase matches, with Chinese word boundaries, are found locally and never make a request. Clear matches are linked directly. Ambiguous ones are checked by the model only when you hover them, and the answer is cached per sentence.
[[?queries. Type[[?keyword|display textto search note titles, aliases and title keyphrases, with one model recommendation after you pause. A standard link is inserted only when you pick a row.- Bring your own model. TypeSafe Jev, OpenRouter, OpenAI-compatible services, Anthropic, or a local Ollama, with a daily request cap.
- Renamed from Note Organizer. Homing now ships under the Apache-2.0 license.
Install
- Download
main.js,manifest.jsonandstyles.cssbelow. - Put them in
<your vault>/.obsidian/plugins/homing/. - Enable Homing in Settings → Community plugins.
This release requires Obsidian 1.11.4 or later on desktop.
Upgrading from Note Organizer: on first start, Homing imports its settings and history read-only from .obsidian/plugins/note-organizer/. Then disable and remove the old plugin.
Privacy and cost
The provider you choose receives only what an analysis needs: the note being filed, or the sentence around an ambiguous link, plus candidate folder or note metadata. The README lists exactly what is sent and when. Hosted providers may charge per request. Homing collects no telemetry.
License
Copyright 2026 KineiChou. Licensed under Apache-2.0. You may use, modify and redistribute Homing; redistributions must keep the NOTICE crediting KineiChou and state what changed.
中文说明
Homing(归位)为收件箱笔记推荐已有目录,并在写作时把提及指向正确的笔记。所有移动和插入都要经你确认。
主要内容
- 在编辑器里归档:笔记右上角的小胶囊显示建议目录,任何视图模式下都可见。确认、改选、撤销、跳到下一篇,都不用离开笔记。
- 多种整理入口:“整理收件箱”弹窗可一次核对并归档多篇。也可以在 Obsidian 文件栏或 Notebook Navigator 中右键笔记和收件箱文件夹。
- 打开即分析:打开一篇还没有建议的收件箱笔记时,只分析这一篇。
- 本地优先的双链提示:标题、别名、复数和关键词匹配,以及中文分词,全部在本地完成,不发请求。明确的匹配直接链接;有歧义的只在悬停时请模型判断一次,结论按句子缓存。
[[?查询:输入[[?关键词|显示文字,在笔记标题、别名和标题关键词中搜索,停顿后给出一次推荐,选中才插入标准链接。- 自选模型:支持 TypeSafe Jev、OpenRouter、OpenAI 兼容服务、Anthropic 和本地 Ollama,并有每日请求上限。
- 更名:由 Note Organizer 更名为 Homing,采用 Apache-2.0 许可证。
安装:下载下方的 main.js、manifest.json、styles.css,放入 <知识库>/.obsidian/plugins/homing/,然后在“设置 → 第三方插件”中启用 Homing。需要 Obsidian 1.11.4+ 桌面版。
从 Note Organizer 升级:Homing 首次启动时会只读导入 .obsidian/plugins/note-organizer/ 中的设置与记录,之后请停用并删除旧插件。
隐私与费用:只把分析所需的内容发送给你选定的服务,发送范围见 README。托管服务可能按请求收费。插件不收集遥测。
许可证:Copyright 2026 KineiChou,Apache-2.0。允许使用、修改和再发布;再发布须保留署名 KineiChou 的 NOTICE,并注明改动。