前言
当'本地知识库管理'与'AI 智能分析'结合，本地笔记将不再只是静态文字。通过插件配合 API，可实现自动总结核心内容、智能回答专业疑问，甚至挖掘隐藏关联。本文将拆解 Obsidian 联动蓝耘 API 的玩法，帮助本地文件从'信息仓库'变身'智能助手'。
蓝耘 API Key 创建
- 访问蓝耘平台进行注册。
- 进入主页，点击上方的 MaaS 平台。
- 在平台中查看可用大模型，涵盖文本生成、音频理解、视频理解及生成等。
- 查看模型介绍及价格示例，部分模型支持在线体验，效率较高。
- 查看 Token 消耗可视化界面。
- 进入 API Key 管理，点击创建 API Key。复制生成的 Key，格式通常为
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。
Obsidian Copilot 配置
- 进入 Obsidian 主页，点击左下角齿轮进入设置。
- 在第三方插件中，点击社区插件市场。
- 搜索 Copilot，选择第一个插件。
- 查看插件信息，点击安装并等待完成。
- 点击启用插件。
- 在第三方插件设置中，找到 API 设置区域。
- 进入 Model 设置，点击 Add Custom Model 添加对话模型。
- 填写模型信息，点击 Verify 测试连接。若成功，右上角反馈 successful。
- 参考配置数据：
Model Name: /maas/qwen/Qwen3-235B-A22B Provider: OpenAI Format: Base URL: https://maas-api.lanyun.net/v1 API KEY: 需在蓝耘 MAAS 平台创建 - 点击 Add Model 添加模型，随后在 Basic 设置中将 Default Chat Model 设为刚添加的模型。
- 其他参数默认即可。嵌入模型无需添加。
文件分析测试
- 安装 Copilot 插件后，左侧会出现对话按钮。
- 点击按钮，右侧显示对话框。
- 输入
[[引用文件。 - 输入问题并点击 Chat 询问。
- AI 分析文件内容，提供优化建议，并可生成可视化图表。
- 对于长文章或大项目（如 C++ 日志系统），若 Token 超限，需调整 Copilot Settings 中的上传 Token 数参数。
- 若项目过大，可创建项目简介文件进行分析。
- 复制 AI 回答至文章，效果良好。
AI Prompt 设置
使用 Ctrl+P 唤出命令菜单，输入 copilot add 添加命令。
自定义 Prompt 变量说明：
{activeNote}：指定当前窗口下激活的文章。{[[]]}：指定具体文章。{}：指定光标选中的段落。{#tag1,tag2}：指定包含特定标签的文章。{FolderPage}：指定文件夹路径下的所有文档。 可在此为 AI 设置角色设定，使其更智能化地回答固定问题。
总结
通过 Obsidian 插件搭桥、蓝耘 API 赋能，实现了本地文件从'被动存储'到'主动交互'的蜕变。自动总结、智能问答等功能重塑了知识管理的效率边界。
