Note Companion：把 Obsidian 的 Inbox 变成自动整理流水线
Note Companion：Obsidian 的人工智能助手，不仅仅是聊天。 （以前的文件管理器 2000）。
秒懂
- 它是什么？
- Note Companion 是一个面向 Obsidian 的 AI 助手插件，主打音频/YouTube 转录、笔记整理和基于 vault 上下文的聊天。它支持云服务和自托管两种模式，但桌面端限定，且 AI 密钥配置在服务端而非插件内。
- 适合谁用？
- 适合研究人员、学生和会议密集的用户，尤其是那些在 Obsidian 里积压了大量未处理笔记的人。它能把音频和链接变成结构化笔记，减少手动整理的时间。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 5 天前。
- 用什么语言写的？
- 主要是 TypeScript（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月14日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决的是 Obsidian 里的“收件箱堆积”问题
很多 Obsidian 用户有一个共同习惯：把临时想到的内容、会议录音、YouTube 链接一股脑丢进一个 Inbox 文件夹，打算“之后整理”。这个之后往往永远不会来。Note Companion 就是冲着这个场景来的。它把转录、摘要、标签建议和文件移动做成了插件内的自动化流程。你丢一个链接进去，它给你转录稿加摘要。你录一段会议，它给你讨论点和行动项。你放一篇草稿，它建议文件夹和标签。这个项目的定位很明确：不是又一个聊天机器人，而是一个处理未整理笔记的流水线。它原名 File Organizer 2000，改名后功能范围扩大，但核心目标没变。
三条路径：云、自托管、本地 Ollama
Note Companion 提供了三种运行方式，区别在于 AI 密钥放在哪里。第一条是默认的 Note Companion Cloud，你需要在 notecompanion.ai 注册账号，把仪表盘里的 license key 粘贴到插件的 General 选项卡，然后激活。第二条是自托管，你部署自己的后端，在服务器的 .env 文件里配置 OPENAI_API_KEY、ANTHROPIC_API_KEY、MODEL_PROVIDER、MODEL_NAME 等变量，然后在插件设置里启用 Self-Hosting 并填写 Server URL。第三条是本地 Ollama，属于实验性质，需要设置 OPENAI_API_BASE 指向本地地址，或者启用插件里的 Local LLM Integration（后者需要 Catalyst 权限）。注意一个关键点：插件本身没有粘贴 API 密钥的界面，密钥只存在于后端。这个设计把安全边界划得很清楚，但也意味着如果你不想用云服务，就必须自己跑一个后端。
工作流：从链接到结构化笔记的实际路径
项目 README 给出了三个具体工作流。第一个是 YouTube 转笔记：复制链接，粘贴到聊天窗口，得到转录、摘要和可选的结构化笔记。第二个是会议记录：在 Meetings 选项卡开始录音，停止后选择一条笔记并点击 Enhance Note，输出包含嵌入音频、转录文本、讨论点和行动项。第三个是 Inbox 自动整理：把原始笔记或链接放进配置好的 Inbox 文件夹，插件会建议文件夹、标签、标题和格式，也可以设置成自动应用。这些工作流不是概念，而是插件界面上直接可操作的功能。其中会议记录被 README 称为“best demo”，因为它把录音、转录和结构化输出串在了一条链路上，最能体现这个插件区别于普通聊天助手的价值。
一个明确的边界：桌面端限定
这个插件在 manifest 里标记为 desktop-only，这意味着 Obsidian 的 iOS 和 Android 版本不会加载它。README 明确说：“We do not test or support the Obsidian plugin on mobile today.” 这不是一个模糊的“移动体验不佳”，而是功能层面的不支持。如果你主要用手机或平板上的 Obsidian 做笔记，这个插件对你没有意义。仓库里确实有一个单独的 Note Companion mobile app，但开发已经暂停，而且它不是 Obsidian 插件的移动替代品。这个限制对很多用户来说是硬伤，但反过来看，它也说明插件依赖桌面环境，比如某些本地集成。如果你需要移动端捕获，那得另想办法，比如用其他工具先记录，再同步到桌面处理。
自托管的运维成本：不只是装个 Docker
自托管路径看起来简单，但 README 里藏着不少运维细节。你需要部署后端，参考 SELF-HOSTING.md 里的 Docker 和 service 示例。配置 .env 时，除了基本的 provider key，还要注意 OPENAI_API_BASE 可以指向 Ollama 或任何 OpenAI 兼容端点。服务器端还有一个 ENABLE_USER_MANAGEMENT 开关，设为 false 时不需要云 license，也没有云使用追踪。这个开关直接决定你是否需要注册 Note Companion Cloud 账号。故障排查部分列出了一些常见问题：转录失败要检查文件大小，超过 25MB 需要拆分或压缩；YouTube 导入失败要尝试备用方法；本地模型无响应要检查 Base URL 和 CORS 设置。这些提示说明，自托管不是一个“一键部署”的事，你需要具备基本的网络和服务排查能力。
隐私边界：数据在哪，谁说了算
隐私是这个项目的一个核心卖点，但它的实现方式比宣传语更复杂。云模式下，文件通过 Note Companion 的 API 处理，会收集使用统计用于计费和限流，但 README 强调 vault 内容只在明确使用插件功能时才被处理。自托管模式下，所有 AI 处理都在你控制的基础设施上运行，且当 ENABLE_USER_MANAGEMENT=false 时没有云使用追踪。这里有一个明显的权衡：云模式省事，但你的笔记内容会经过第三方服务器；自托管模式掌控力强，但你要自己维护服务。插件没有提供“本地模型但用云服务”的混合选项，要么全云，要么全自托管。另外，插件的 License Key 字段只用于云访问，不是 API 密钥，这个区分容易混淆，文档里特意强调了一遍。
替代方案：与 Obsidian 原生 AI 插件的根本差异
Obsidian 社区里有很多 AI 插件，比如 Copilot for Obsidian 或 Smart Connections，但 Note Companion 的差异在于它不只是聊天。大多数同类插件把 AI 当作一个对话窗口，你需要手动把笔记内容复制进去。Note Companion 则把 AI 嵌入到文件处理流程中：转录、标签建议、自动移动文件。它的 YouTube 转录功能尤其特别，README 声称支持多语言，并且“works even when captions aren't available in the usual way”，这意味着它可能用了备用方法获取字幕。相比之下，其他插件通常只能处理你已经有的文本内容。这个差异决定了适用场景：如果你只是想在 Obsidian 里问问题，那其他插件可能更轻量；如果你要处理大量未整理的音频和链接，Note Companion 的自动化流程更有针对性。
编辑结论
适合研究人员、学生和会议密集的用户，尤其是那些在 Obsidian 里积压了大量未处理笔记的人。它能把音频和链接变成结构化笔记，减少手动整理的时间。不适合移动端用户，因为插件明确不支持手机和平板。也不适合希望把所有 AI 配置都放在 Obsidian 界面里的人，因为 API 密钥必须在自托管后端设置。采用前先确认你的工作流是否依赖移动端，以及你是否愿意维护一个后端服务。如果选云服务，要接受数据经过 Note Companion 服务器处理。如果自托管，先检查 .env 里的模型配置和 ENABLE_USER_MANAGEMENT 设置，再用 curl http://localhost:3000/api/health 验证后端是否可访问。
社区笔记