AI 配置

添加 Provider、映射任务模型、Embedding 与测试连接

​

用途

Pro 要在 设置 → AI 配好可用的 Provider 和任务映射。Chat 和 Embedding 是两套映射，配一个不等于配另一个。

设置 → AI：Provider 列表、任务映射、测试连接

截图待补充 · images/screenshots/ai-features/configuration.webp

​

怎么配

1. 从列表添加 Provider（OpenAI / 兼容接口、DeepSeek、OpenRouter、Gemini、Ollama、LM Studio 等，以列表为准）。填 API Key。自建端点再填 Base URL。
2. 刷新已发现模型。必要时改温度等行内参数。
3. 映射默认任务（名称以界面为准）：摘要、标签、对话；Embedding（语义 / RAG）；翻译。
4. 先测连接，再到详情用 ⇧⌘A 做一次真实调用。

Key 进 macOS Keychain。更多：BYOK。

​

Embedding

没有可用 Embedding 时：

• 语义搜索 不可用
• RAG 索引 向量侧建不起来

Chat 配好但 Embedding 空着，是最常见的「开了 Pro 仍不能语义 / RAG」原因。

​

RAG 提示词

在 RAG 工作台 设置里可编辑问答、规划、压缩和标题模板：

• 可对照并复制只读默认提示词
• 自定义模板会标明支持的占位符；没写的不会静默注入
• Starcat 不会自动改写你保存的自定义内容

摘要、标签、翻译若开放自定义提示词，先对单个仓库试验，再用于 Auto Tidy。

输出语言默认跟界面，也可单独指定。见 AI 设置。

​

注意

• App Store 渠道不能帮你拉起本机 CLI；本地推理（Ollama 等）要自己先把服务跑起来。
• 换 Embedding 模型后，旧向量可能对不齐，按界面重建索引。

​

相关

• Auto Tidy
• FAQ · AI