自定义模型使用

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,不要把真实地址硬编码
  • 不再用的端点及时删除,避免后面误用