Obsidian Copilot 配置蓝耘 API 实现本地文件智能交互

前言

当'本地知识库管理'与'AI 智能分析'结合，本地笔记将不再只是静态文字。通过插件配合 API，可实现自动总结核心内容、智能回答专业疑问，甚至挖掘隐藏关联。本文将拆解 Obsidian 联动蓝耘 API 的玩法，帮助本地文件从'信息仓库'变身'智能助手'。

蓝耘 API Key 创建

1. 访问蓝耘平台进行注册。
2. 进入主页，点击上方的 MaaS 平台。
3. 在平台中查看可用大模型，涵盖文本生成、音频理解、视频理解及生成等。
4. 查看模型介绍及价格示例，部分模型支持在线体验，效率较高。
5. 查看 Token 消耗可视化界面。
6. 进入 API Key 管理，点击创建 API Key。复制生成的 Key，格式通常为 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。

Obsidian Copilot 配置

1. 进入 Obsidian 主页，点击左下角齿轮进入设置。
2. 在第三方插件中，点击社区插件市场。
3. 搜索 Copilot，选择第一个插件。
4. 查看插件信息，点击安装并等待完成。
5. 点击启用插件。
6. 在第三方插件设置中，找到 API 设置区域。
7. 进入 Model 设置，点击 Add Custom Model 添加对话模型。
8. 填写模型信息，点击 Verify 测试连接。若成功，右上角反馈 successful。
9. 参考配置数据：

   Model Name: /maas/qwen/Qwen3-235B-A22B
   Provider: OpenAI
   Format: Base URL: https://maas-api.lanyun.net/v1
   API KEY: 需在蓝耘 MAAS 平台创建
   

10. 点击 Add Model 添加模型，随后在 Basic 设置中将 Default Chat Model 设为刚添加的模型。
11. 其他参数默认即可。嵌入模型无需添加。

文件分析测试

1. 安装 Copilot 插件后，左侧会出现对话按钮。
2. 点击按钮，右侧显示对话框。
3. 输入 [[ 引用文件。
4. 输入问题并点击 Chat 询问。
5. AI 分析文件内容，提供优化建议，并可生成可视化图表。
6. 对于长文章或大项目（如 C++ 日志系统），若 Token 超限，需调整 Copilot Settings 中的上传 Token 数参数。
7. 若项目过大，可创建项目简介文件进行分析。
8. 复制 AI 回答至文章，效果良好。

AI Prompt 设置

使用 Ctrl+P 唤出命令菜单，输入 copilot add 添加命令。 自定义 Prompt 变量说明：

• {activeNote}：指定当前窗口下激活的文章。
• {[[]]}：指定具体文章。
• {}：指定光标选中的段落。
• {#tag1,tag2}：指定包含特定标签的文章。
• {FolderPage}：指定文件夹路径下的所有文档。 可在此为 AI 设置角色设定，使其更智能化地回答固定问题。

总结

通过 Obsidian 插件搭桥、蓝耘 API 赋能，实现了本地文件从'被动存储'到'主动交互'的蜕变。自动总结、智能问答等功能重塑了知识管理的效率边界。