Obsidian

本地优先的笔记应用，通过 Smart Composer 插件获得 AI 写作助手。

这是什么

Obsidian 是一款本地优先的 Markdown 笔记应用。它本身不带 AI，但有个叫 Smart Composer 的社区插件，能加上一个 AI 助手，可以读你的笔记、帮你写作。把 Smart Composer 指向 TokenMix，你就能在笔记里用 Claude、GPT 或 DeepSeek 起草、改写和提问。

开始之前

• 从 obsidian.md 安装 Obsidian。它能在桌面端和移动端运行。
• 在 tokenmix.ai 注册，打开控制台，进入 API Keys，创建一个以 sk-tm- 开头的密钥。

安装 Smart Composer 插件

1. 在 Obsidian 里打开 Settings（设置），进入 Community plugins（社区插件），如果开着 Restricted mode（受限模式）就把它关掉。
2. 点 Browse（浏览），搜索 Smart Composer，安装它，然后启用。

接入 TokenMix

1. 打开 Settings（设置），进入 Smart Composer，打开 Providers（提供方）标签页。
2. 点 Add custom provider（添加自定义提供方）。
3. Type（类型）：选 OpenAI Compatible（OpenAI 兼容）。
4. Base URL（基础地址）：填 https://api.tokenmix.ai/v1，保留末尾的 /v1。
5. API Key（密钥）：粘贴你以 sk-tm- 开头的密钥，然后保存。
6. 打开 Models（模型）标签页，点 Add custom model（添加自定义模型），选你刚建好的那个 provider，再填一个 TokenMix 模型 id，比如 claude-sonnet-4.6。

验证是否生效

打开右侧栏的 Smart Composer 聊天，选好你的模型，让它总结一下当前笔记。能给出有用的回复就说明接好了。花费可以在 TokenMix 控制台里看到。

常见问题

没有回复或者报错：确认 Base URL 是 https://api.tokenmix.ai/v1，带上 /v1，并且你已经在 Models 标签页里给这个 provider 添加了一个模型。

为什么用 Smart Composer：它把 provider 和 model 分开管理，对 OpenAI 兼容的接口支持得很干净，所以和 TokenMix 配合得很好。

选哪些模型：写作的话，Claude Opus 4.8、Claude Sonnet 4.6 和 DeepSeek V4 Pro 都是不错的起点。