第 3 章 · 工作台对接自研底座
本章目标:小紫工作台连上 运行中 的自研底座;对话 + SRX 小任务 实测通过;理解 平台默认(自研底座)免费 与会员关系。
学时建议:1.5~2 小时
前置:local-deploy ch02 文本模型 运行中;quick-start ch05 会开设置。
前提:已记下底座顶栏地址(如 http://127.0.0.1:8080/v1)。
3.1 场景说明:底座运行中,工作台却「连接失败」
90% 是 URL 不一致(缺 /v1、端口错)、底座未运行、或防火墙。本章逐步对接并 对话 + SRX 双验证。
3.2 学完你能
| 能力 | 验收 |
|---|---|
| 入口 | Ctrl+, → 模型管理 |
| 提供商 | 选 平台默认(自研底座) |
| URL | Base URL 与底座顶栏一致 |
| 模型 | 刷新列表并选主模型 |
| 验证 | 对话 OK + SRX 出现审阅条 |
3.3 打开模型管理
| 入口 | 操作 |
|---|---|
| Ctrl+, | 模型管理 |
| AI ⚙️ | tool → 模型设置 |
3.4 选择平台默认(自研底座)
卡片:平台默认(自研底座) — 登录即可,无需高级会员。
勿与量子模型、第三方 API 混淆。
3.5 填写 Base URL(关键)
http://127.0.0.1:8080/v1
- 必须含
/v1 - 底座改 Host/端口 → 此处完全一致
- 勿用占位默认端口,以底座顶栏为准
3.6 API Key
| 底座 | 工作台 |
|---|---|
| 留空 | 留空 |
| 已设 Key | 填相同 Key(Bearer) |
3.7 跟练:保存并双验证(必做)
- 刷新模型列表 → 主模型 选运行中 GGUF 名
- 保存
- Ctrl+J → 发:
你好,请回复 OK→ 有流式回复 - 项目 → 打开项目 → SRX 小改动 → 审阅条 出现
成功标志:对话通 + SRX 可执行。
3.8 向量 API(可选)
底座 向量模型 页若单独启动(常 8081):
- 模型管理 → 向量 API 地址 如
http://127.0.0.1:8081/v1 - 用于语义搜索,非 SRX 必需
3.9 场景速查
| 场景 | 要点 |
|---|---|
| 仅本机 | Host 127.0.0.1 |
| 台式机跑模型、笔记本写代码 | 底座 0.0.0.0,工作台填局域网 IP(ch04) |
| 临时换云端 | 模型管理改提供商(需会员) |
| 连接失败 | 底座运行中?curl /v1/models? |
3.10 与会员
| 能力 | 会员 |
|---|---|
| 平台默认自研底座 | 免费 |
| 量子 / 外部 API | 见 quick-start ch02 |
SRX 改代码能力不绑会员。
跟练任务
- 完成 3.7 双验证。
- 故意填错端口,记录报错,再改回。
- 写
local-deploy-notes/ch03.md:Base URL 与模型名。
自检清单
- [ ] 选平台默认自研底座
- [ ] URL 含 /v1
- [ ] 对话测试通过
- [ ] SRX 审阅条测过
- [ ] 知 SRX 不绑会员
本章小结
- 底座运行中 → 平台默认 → URL → 刷新模型 → 保存 → 实测。
- 下一章 ch04:调优、局域网、安全。