Obsidian Copilot / Text Generator 接不墨 Router：配置与报错排查
在 Obsidian 用 Copilot 或 Text Generator 自带 Key 接不墨 Router：BYOK 填法、Base Path、模型 ID，以及 401、404、无响应怎么查。
Obsidian 本身没有模型设置，要装自带 Key 的插件。Copilot 在 Settings → Copilot → BYOK 里添加自定义供应商，Text Generator 在设置里选 OpenAI Chat 并填 Base Path，两者都填 https://router.bumo.cc/v1 和 Router Key。 Copilot 适合对话、改稿，Text Generator 适合模板和批量生成。
核验日期：2026-10-25。Router 当日 /v1/models 返回 28 个模型；本文模型 ID 均来自该列表。插件界面以你安装的版本为准。
先选插件
| 插件 | 适合 | 配置入口 |
|---|---|---|
| Copilot | 对话、选区改写、Agent 读笔记 | Settings → Copilot → BYOK |
| Text Generator | 模板生成、批量写、快捷键 | Settings → Text Generator → LLM Provider → OpenAI Chat |
两个都可以只用自己的 Key，不需要订阅插件方的托管模型。装一个就够，不必同时配。
Copilot：BYOK 添加自定义供应商
- 打开 Settings → Copilot → BYOK
- 点 Add a provider，选 Add a custom provider
- 填 API Key 和 Base URL：
https://router.bumo.cc/v1 - 填至少一个模型 ID，例如
deepseek/deepseek-flash - 点 Test，通过后 Save
保存后还要在 Basic → Agents → Quick Chat 里勾选这个模型并设默认。如果 Agent Chat 走 OpenCode，模型也要在 OpenCode 的模型列表里启用，否则普通聊天能用、Agent 选不到。
Copilot 的模型发现读的是端点的 /v1/models，Router 支持这个接口，所以 Test 通常能直接通过。模型没自动列出来时，手填完整 ID。
Key 存在本机 Obsidian Keychain，不在 vault 的 data.json 里。换电脑同步 vault 不会带走 Key，需要重新填。
Text Generator：Base Path 指向 Router
- 打开 Settings → Text Generator → LLM Provider
- 选择 OpenAI Chat
- API Key 填 Router Key
- Base Path 填
https://router.bumo.cc/v1 - 在模型下拉里选完整 ID，或手动填
deepseek/deepseek-flash
Base Path 只到 /v1。Text Generator 会自己请求 Base Path/models 取模型列表，运行模板时再拼聊天路径。填成 /v1/chat/completions 会让它拼出重复路径。
模板里如果写死了模型名，同样要改成 Router 的完整 ID，不能沿用 gpt-4o 这类原厂名字。
报错排查
| 现象 | 先查 |
|---|---|
| 401 / Invalid API key | Key 是否完整、有没有空格；确认是 Router Key 而不是原厂 Key |
| 404 / model not found | 模型 ID 是否带前缀、大小写是否一致 |
| Test 通过但 Quick Chat 无响应 | 在 Copilot 供应商设置里打开 Enable CORS 再试 |
| Base URL 报错 | 是否误填成 /chat/completions；两个插件都只要基础地址 |
| 回复很慢或中断 | 选区或上下文是否过长；先用一句话测试，再缩小选中范围 |
| 手机上 Agent 不可用 | Copilot 的 Agent 是桌面功能，Quick Chat 等不受影响 |
关于 Enable CORS
Copilot 官方文档给的处理是：Test 成功、但 Quick Chat 发不出消息时，编辑该供应商并打开 Enable CORS，之后回复会在完成时整段出现，而不是逐字流式显示。
Router 的接口返回了允许跨域的响应头，正常情况下不需要额外处理；但插件版本、Obsidian 桌面端与移动端的行为不完全一致，遇到问题就按上面这条先排除。
不写成实测的原因
本文只核对了两个插件的官方说明、Router 的公开模型列表和接口响应，没有在你的 Obsidian 里安装插件，也没有用付费 Key 跑一次生成。配置步骤可照做，实际效果以你的插件版本和调用结果为准。
先把选区缩到一小段、用最短的提示词验证；通了再放开长文和批量模板。
前往不墨 Router 获取 Key。Obsidian 这边的最短路径是：装一个自带 Key 的插件、填 /v1 地址和 Key、选完整模型 ID。
