Windows 上从零开始：Obsidian + Copilot（Icompify）+ 客户洞察实战 · 图文指南
本指南全部截图来自真实操作：Windows 11 全新安装 Obsidian 1.14.4 → 安装 Copilot v4.0.15 插件 → 接入 Icompify（Custom OpenAI-compatible）→ 基于模版完成一份"客户洞察报告"。全程大约 15--20 分钟。
说明：
- 文中示例 API Key
sk-icompifydemo是占位符，请替换为你自己的密钥（在 Icompify 后台获取）。- 截图中的设置页在新版本中可能以独立窗口（如图所示）或应用内弹窗形式出现，操作步骤相同。
0. 准备工作
| 项目 | 要求 |
|---|---|
| 系统 | Windows 10 / 11 |
| 网络 | 能访问 obsidian.md 官网与 GitHub（社区插件在线安装需要） |
| 账号 | 一个 OpenAI 兼容的 API 密钥（本文以 Icompify 为例：Base URL: https://api.icompify.com/v1，模型 deepseek-v4.1-flash） |
最终效果一览（智能体自动生成客户洞察报告）：
1. 下载 Obsidian
打开官网 https://obsidian.md/download，点击紫色按钮 Download for Windows：
下载完成后，在"下载"文件夹中可以看到安装包 Obsidian-1.14.4.exe（约 326 MB）：
2. 安装 Obsidian
双击安装包。第一步是安装选项：
- 【为使用这台电脑的任何人安装（所有用户）】需要管理员权限（会弹 UAC）；
- 普通用户可以选 【仅为我安装】（装到当前用户目录，不需要管理员权限）。
选好后点【下一步】：
确认安装位置（默认即可），点【安装】：
等待进度条走完：
看到完成页后点 【完成】。勾选"运行 Obsidian"会立即启动（初次使用可以先取消勾选，按下一步手动打开）：
3. 首次启动：创建你的笔记库（Vault）
首次启动界面（会自动识别系统语言，此处为简体中文；也可用底部下拉框切换）：
在"新建仓库"一行点击【创建】，输入仓库名称，然后点【浏览】选择存放位置：
在弹出的文件夹选择框中定位到目标文件夹（可以直接在底部"文件夹"输入框粘贴路径），点【选择文件夹】：
确认"名称 + 位置"无误后，点【创建】：
几秒钟后你的笔记库就创建好了（左侧是文件列表，中间是默认的"欢迎"笔记）：
小提示：左下角的 ⚙ 是设置入口（快捷键
Ctrl + ,）。
4. 安装 Copilot 插件
进入 设置 → 第三方插件 。默认处于"受限模式"，阅读安全提示后点击 【退出受限模式】：
受限模式关闭后，点击 【浏览】 进入社区插件市场：
插件市场中共有约 9,000 个插件，可以按下载量浏览：
在顶部搜索框输入 Copilot：
点击第一条 Copilot（作者 Logan Yang）卡片，进入详情页：
点击 【安装】，等待几秒钟安装完成：
安装完成后按钮变为 【启用】，点击启用：
按钮变为"禁用/卸载"即代表插件已启用成功。
注意：在线安装/更新插件需要访问 GitHub，网络不稳定时可能耗时较长，重试即可。
5. 配置 Icompify 模型（Custom OpenAI-compatible）
在插件详情页点击 【选项】（或：设置 → 第三方插件 → Copilot → 选项）打开 Copilot 设置：
切换到 BYOK 选项卡，点击右上角 【+ Add a provider】：
在提供商列表底部选择 【+ Add a custom provider】：
出现"Configure Custom OpenAI-compatible"表单：
按下面填写：
| 字段 | 填写内容 |
|---|---|
| Display name | Icompify |
| API key | 你的密钥（示例：sk-icompifydemo） |
| Base URL | https://api.icompify.com/v1 |
| Model ID | deepseek-v4.1-flash → 点【Add】加入模型列表 |
点击 【Save】 保存。插件会联网校验密钥 ------密钥无效会提示 Authentication failed；校验通过后 BYOK 列表会出现 Icompify（Verified）：
常见报错：
Authentication failed= 密钥不对；无法保存 = Base URL 少了/v1或网络不可达。
6. 实战：基于模版做"客户洞察报告"
先准备两个文件（本指南使用示例文件，也可替换为你自己的）：
客户洞察/客户洞察报告模版.md------ 报告结构模版（一句话判断 / 基本信息 / 业务与产品 / 现状与挑战 / 商机切入 / 联系人 / 风险提示）；客户资料-恒锐智造.md------ 客户素材（本例为虚构数据）。
6.1 打开 Copilot 对话
点击左侧竖栏底部的 Copilot 图标，右侧会打开 "Copilot Agent" 对话面板。第一次使用需要先配置 opencode 后端：
点击 【Configure】 ，在弹窗中保持默认（Managed by Copilot），点击 【Download & install】（Copilot 自动下载并管理 opencode 二进制）：
看到 ✓ Ready / opencode v2.0.22 installed 后点 【Done】：
对话界面如下：顶部是 agent（opencode），输入框下方从左到右依次是 +（附件）／模型选择器／模式（Safe）／发送按钮：
若右下角出现 "opencode backend exited unexpectedly"，点 【Retry】 重试即可（首次启动偶发）。
6.2 确认模型
点击模型选择器，确认选中 Icompify/deepseek-v4.1-flash（前面有 ✓）：
6.3 输入指令并发送
在输入框中输入下面这句指令，然后点击发送（↑）：
参考 \[客户洞察报告模版] 的结构和格式，阅读 \[客户资料-恒锐智造]，帮我生成一份完整的客户洞察报告，保存到「客户洞察」文件夹，文件名为 \[恒锐智造-客户洞察报告]。
6.4 智能体自动执行
发送后智能体会自动：定位文件 → 读取模版与客户资料 → 按模版结构开始撰写。执行过程在对话中实时可见：
写文件之前会弹出权限确认卡片 （可见即将写入内容的差异预览），确认无误后点 【Always allow】（或 Allow once）：
6.5 完成
约 1~2 分钟后任务完成。智能体会给出报告结构摘要、标注推断项，并附上生成的文件卡片（图中 +55 表示新增 55 行）：
点击文件卡片（或左侧文件列表中的新笔记）即可查看成品------一份结构完整、按模版逐节填充的客户洞察报告：
7. 常见问题（FAQ）
Q1：插件市场打不开 / 安装插件失败？
需要能访问 GitHub。可以重试、更换网络或配置系统代理后再试。
Q2：保存 provider 时报 Authentication failed？
① 密钥是否正确；② Base URL 必须是完整的 https://api.icompify.com/v1（含 /v1）；③ 本机能否访问该 API（可先浏览器打开测试）。
Q3：对话没反应 / 右下角报 opencode 错误？
点错误卡片上的 【Retry】。opencode 后端首次启动偶发退出，重试即恢复。
Q4：如何让智能体联网搜索？
Copilot 的 plus 搜索、或 BYOK 环境下的搜索服务（Exa / Tavily / Parallel 等）可选配；不配时智能体也可用网页抓取方式补充信息。
Q5：模版怎么换成我自己的？
把你的报告结构写成一份 Markdown 模版放进库中，指令里写"参考 \[你的模版]"即可（示例指令见 6.3）。
Q6：我的数据安全吗？
笔记保存在你本机；除模型调用外不会上传。API 密钥仅保存在本机的加密存储中。
附：示例文件内容
markdown
# 客户洞察报告：{{customer}}
## 一、一句话判断
> 用 2-3 句话概括这家客户的核心特征、与我方的相关度与总体判断。
## 二、公司基本信息
| 项目 | 内容 |
|---|---|
| 公司全称 | |
| 所属行业 | |
| 成立时间 | |
| 注册地 | |
| 人员规模 | |
| 主营产品/业务 | |
## 三、业务与产品分析
## 四、业务现状与挑战
## 五、商机与切入分析
## 六、关键联系人 / 触达路径
## 七、风险提示客户资料-恒锐智造.md（摘要）
markdown
# 客户资料：四川恒锐智造科技有限公司
- 工业机器人系统集成；成都高新区；约 420 人
- 2026 年 6 月完成 B 轮融资 2.3 亿元
- 第二生产基地在建；大量招聘 GPU/边缘计算方向
- 机器视觉质检模型训练依赖外部 GPU 云（成本高、数据敏感）
- 备注：本文件为演示用虚构资料