logancyang/obsidian-copilot

概述

Obsidian Copilot 是一个开源插件，为 Obsidian 笔记应用添加 AI 驱动的“代理”。代理可以读写笔记、运行工具并保持多轮对话，让你直接在笔记库中使用大型语言模型（LLM）进行研究、写作和知识管理。

核心功能

功能	说明	工作原理（根据 README）
Agent 模式	多步骤 AI 助手，可以检查笔记、创建文件和使用工具。	选择一个 Agent（opencode、Claude Code 或 Codex）。代理在聊天窗口中运行，保持跨轮上下文，并尊重你设置的权限。
项目	具有自己的指令、上下文和聊天历史的独立工作区。	项目与选定的代理绑定，并保持进行中任务的状态。
技能	跨代理共享的可复用能力（例如 Markdown 处理、Canvas、CLI）。	添加一次技能；任何已安装的代理都可以启用它。
命令和快速提问	保存可重复的提示；通过 / 或从编辑器调用。	命令可以在代理聊天中运行，或在命令面板中显示。快速提问允许你针对选中的文本提问并插入答案。
多个会话	同时运行多个代理选项卡。	使用 Plus 许可证，你可以提及（@）其他代理以进行只读请求。
模型选项	使用 Copilot 托管模型、自带密钥（BYOK）提供商或本地模型。	设置 → BYOK 将密钥存储在 Obsidian 的钥匙串中。Claude Code 和 Codex 使用自己的 CLI 登录。
快速聊天	简单的单次 LLM 对话（无代理）。	可用于桌面端和移动端。
隐私控制	提示仅发送到你选择的模型/提供商；托管服务是可选的。	免费使用将数据发送到所选提供商；付费托管功能将数据发送到 Brevilabs，并遵循临时处理政策。

设置流程

1. 从 Obsidian 的社区插件页面安装插件。
2. 打开 设置 → Copilot → 基本 → 代理。
3. 选择后端：
   • 下载 opencode（推荐）– 可使用 Copilot 托管、BYOK 或本地模型。
   • Claude Code – 自动检测本地安装并使用其登录。
   • Codex – 通过 @agentclientprotocol/codex-acp 适配器连接。
4. 通过功能区图标或命令 打开 Copilot Agent 聊天窗口 打开代理聊天。
5. （可选）创建项目、添加技能或定义命令以自定义工作流。

商业模式

插件本身是开源的，如果你提供自己的模型访问权限，则无需付费计划即可使用。付费计划（Copilot Plus）解锁：

• Brevilabs 提供的托管 opencode/快速聊天模型。
• 多代理支持和云备份工具。
• 优先访问预览功能。 所有付费功能都是可选的；核心代理功能保持免费。

适用人群

• 知识工作者、研究人员、作家，以及任何已经使用 Obsidian 并希望在不离开应用的情况下获得 AI 辅助的人。
• 需要一致“助手”的团队，该助手可以读取笔记库、生成内容并保持交互历史。

限制

• 完整 Agent 模式仅在桌面端运行，因为它会生成本地进程。
• 移动端仅保留快速聊天、命令和快速提问。
• 托管模型是专有的；只有插件前端是开源的。

链接与资源

• 安装： https://obsidian.md/plugins?id=copilot
• 文档： ./docs/（入门、Agent 模式、项目、技能、命令等）
• Discord / 支持： https://www.obsidiancopilot.com/en/register
• 定价 / 计划： https://www.obsidiancopilot.com/en/pricing
• 隐私政策： https://www.obsidiancopilot.com/en/privacy

---

以上所有信息均直接取自仓库的 README。