自定义模型使用
Flowix 把"Agent CLI"做成抽象层,但如果你不想装 CLI,直接配一个 OpenAI 兼容的 HTTP 端点也行。
这条路径覆盖:本地 Ollama / LM Studio / Jan.ai,以及国产模型的代理服务(DeepSeek、智谱、月之暗面等)。
1. 通用配置方式
打开 Flowix 设置 > AI > 自定义,点 + 新建端点,填写:
| 字段 | 必填 | 说明 |
|---|---|---|
名称 |
✓ | 显示在 Agent 下拉里,如 本地 Ollama |
Base URL |
✓ | 形如 http://localhost:11434/v1 |
Model |
✓ | 模型 ID,服务端决定 |
API key |
- | 服务端不验证就填 EMPTY |
Stream |
✓ | 一般开,长输出更顺 |
Max tokens |
- | 服务端上限,留空默认 |
System prompt 模板 |
- | 给所有调用追加前缀,见下文 |
保存即可。Flowix 会 POST 到 {base_url}/chat/completions,完全照 OpenAI Chat Completion 接口规范。
2. 几个常见配置
Ollama
Name: 本地 Ollama
Base URL: http://localhost:11434/v1
Model: qwen2.5:14b
API key: EMPTY
注意:需要
ollama serve后台运行。
LM Studio
Name: LM Studio
Base URL: http://localhost:1234/v1
Model: qwen2.5-coder-32b-instruct
API key: lm-studio
DeepSeek 官方
Name: DeepSeek
Base URL: https://api.deepseek.com/v1
Model: deepseek-chat
API key: sk-...
智谱 GLM
Name: 智谱 GLM-4
Base URL: https://open.bigmodel.cn/api/paas/v4
Model: glm-4-plus
API key: 你的 API key
注:智谱 Base URL 不是
/v1结尾,记住,Flowix 会自动补全/chat/completions。
3. System prompt 模板
每篇文档调用时,可以在你的端点设置一个全局前缀,适合做行为塑形:
你正在 Flowix(本地优先 Markdown 笔记)里运行。
回答一律用简体中文;代码用 ```代码块``` 包裹。
不要解释 Markdown 语法本身。
与文档里具体 prompt 协同 -- 文档级 prompt 写在光标附近,系统级 prompt 在设置中,后者先生效。
4. 与 Hermes 路径的区别
| 自定义端点 | Hermes | |
|---|---|---|
| 走协议 | HTTP | 调用 hermes-cli |
| 支持工具调用 | 视模型 | 内置 |
| 多步 Agent | 否 | 是 |
| 适合什么 | 单纯 "Q&A" 续写 | 复杂多文件任务 |
简单写作 / 翻译 / 解释用自定义端点。改代码、跑命令、多文件编辑还是用 Claude Code 或 Codex。
5. 调试
在 设置 > AI > 自定义 > [端点] > 调试,勾选后下次调用会把完整请求 / 响应 dump 到 ~/Library/Logs/Flowix/custom.log(macOS):
{
"request": { "model": "qwen2.5:14b", "messages": [...] },
"response": { "choices": [{ "message": { "content": "..." } }] },
"ms": 1820
}
排查超时、配额错误时很有用。
6. 安全提醒
- 别把生产 key 写到 git 仓库 -- 即使是私有的,git 备份会跟着泄漏
- 公司代理走系统代理时,在
Base URL里用http://127.0.0.1:7890,不要把真实地址硬编码 - 不再用的端点及时删除,避免后面误用