Note Companion：Obsidian 内的 AI 笔记整理插件

File Organizer 2000 更名后的定位

README 标题 Note Companion (formerly File Organizer 2000)，Turn messy captures into clean searchable notes。能力：transcribe audio/YouTube、chat with vault、auto-organize files；Works with Note Companion Cloud or self-hosted backend where you configure own AI provider keys。

Best for researchers、students、meeting-heavy workflows、Inbox full of unprocessed notes。What you can do 列 YouTube transcribe multi-language、audio/video large files、chat with vault context mention files/folders/tags、auto-organize folder/tag/title/template、Meeting recorder Enhance note、Multiple AI providers OpenAI Claude Gemini Groq Ollama custom base URLs、Self-hosting Docker。

插件价值在 ingest 与结构化，不是通用 chatbot。选型前确认工作流是否主要在 Obsidian vault 内完成。

Obsidian Community plugins 安装 Note Companion 后，Settings Advanced 可切换 Self-Hosting。

Inbox 自动整理先启用建议模式，确认 folder 推荐正确再打开 auto-apply。

Note Companion 试装记录 #1：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #7：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #13：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #19：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #25：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #31：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

桌面 Obsidian 独占

Install：Obsidian Settings Community plugins Browse Note Companion Install Enable。Platform support：desktop only Windows macOS Linux，manifest desktop-only，iPhone iPad Android will not load。

Some features assume desktop environment local integrations。We do not test or support Obsidian plugin on mobile。Separate Note Companion mobile app for capture，development on pause，not replacement for plugin inside mobile Obsidian。

若依赖 iOS Obsidian 编辑，当前不可用，应规划 desktop 处理 Inbox 再 sync vault。

Cloud 路径 License Key 来自 notecompanion.ai dashboard API Keys，粘贴到 General tab。

Ollama 路径需 OPENAI_API_BASE=http://localhost:11434/v1 并在 chat picker 选本地模型。

Note Companion 维护笔记 #2：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #8：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #14：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #20：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #26：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #32：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Path 1 Cloud 与 Path 2 自托管

Setup：Settings Note Companion。Important：Obsidian plugin does not have screen to paste OpenAI Claude Gemini API keys directly；keys configured on self-hosted backend see SELF-HOSTING.md。Path 1 Cloud：account notecompanion.ai，License Key from dashboard API Keys paste General tab。

Path 2 Self-hosted：Deploy backend SELF-HOSTING.md Docker or pnpm build:self-host；server .env OPENAI_API_KEY ANTHROPIC_API_KEY MODEL_PROVIDER MODEL_NAME optional OPENAI_API_BASE for Ollama；Obsidian Advanced Enable Self-Hosting，Server URL e.g. http://localhost:3000；License Key empty or dummy when ENABLE_USER_MANAGEMENT=false。

Providers 表：Cloud keys on Note Companion servers with License Key；Self-hosted keys on your server .env。Privacy 取决于所选模式。

自托管 backend .env 设置 OPENAI_API_KEY 与 MODEL_NAME 后 docker compose restart 再测 Chat。

插件 manifest 标记 desktop-only，iPhone Obsidian 不会加载 Note Companion UI。

Note Companion 合规条目 #3：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #9：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #15：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #21：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #27：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #33：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Path 3 Ollama 与工作流

Path 3 Local Ollama chat only experimental：Run Ollama；self-host OPENAI_API_BASE=http://localhost:11434/v1 or Experiment Local LLM Integration requires Catalyst for in-plugin Ollama。Quick workflows：YouTube link in Chat get transcript summary；Meetings Start Recording Stop Enhance Note embedded audio action items；Inbox auto-organization suggest folder tags title。

Quick test Command Palette Note Companion Open Chat ask Summarize this note and suggest tags。试 YouTube 流程用公开短视频，检查生成 note 路径，避免 auto-apply 误移动文件。

自托管 curl http://localhost:3000/health 应返回 200，再测 Chat prompt。

Server URL 设为 http://localhost:3000 时，curl /health 应返回 200 再开 Obsidian Chat。

SELF-HOSTING.md 中 ENABLE_USER_MANAGEMENT=false 时 License Key 可填任意字符串。

Note Companion 试装记录 #4：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #10：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #16：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #22：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

Note Companion 试装记录 #28：在隔离环境执行 README 给出的主命令，把版本号、监听端口、退出码与 stderr 原文写入内部表格，便于下次升级 diff。

MIT 许可与密钥安全

license MIT，插件可 fork，Cloud 服务条款独立。Obsidian plugin 不存 provider keys 于 Cloud 模式 keys 在服务商侧。

Self-hosted .env 含生产密钥勿提交 git。处理 vault 全文时查 backend 日志是否记录 prompt，SELF-HOSTING.md 指导限制 Server URL 可达范围。

Meeting 录音涉及语音数据分类，自托管时应加密磁盘并限制 backend 网络 egress。

YouTube 流程在 Note Companion Chat 粘贴公开短视频链接，检查 transcript 是否写入 vault。

Note Companion 维护笔记 #5：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #11：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #17：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #23：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 维护笔记 #29：对照 GitHub Releases 页面与本地试装日期，确认未使用已归档分支，并保留 primary 来源 URL 备查。

Note Companion 插件验收

桌面 Obsidian 安装启用，自托管 docker compose 起 backend .env 写 OPENAI_API_KEY，Advanced Server URL http://localhost:3000。Command Palette Note Companion Open Chat 对当前 note summarize。

Meetings 录 30 秒音频 Enhance Note 检查 transcript 插入。记录 Obsidian 版本、插件版本、Server URL、MODEL_NAME。

Cloud 路径填 notecompanion.ai License Key 后重复 Chat 测试，对比延迟与 vault 写入路径。

Meetings 录音 Enhance Note 后，action items 段落应可编辑而非只读 HTML 块。

Note Companion 合规条目 #6：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #12：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #18：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #24：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

Note Companion 合规条目 #30：阅读仓库 LICENSE 文件中对再分发与署名要求，不要把 SPDX 缩写误当成上游应用数据的许可。

編輯結論

Note Companion 适合桌面 Obsidian 用户有大量 Inbox 待整理、需要 YouTube 转录或会议增强。它不适合手机 Obsidian 或不愿配置 Cloud 许可/自托管后端的人。Community plugins 安装后，Path 2 部署 Docker backend 并设 Server URL http://localhost:3000，Command Palette 打开 Chat 试 summarize。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes