# Clavue 别名模型使用说明（v1 · 2026-09-11）

一套冻结引擎，多个领域人格。别名只在服务层换系统提示词，不换权重；调用方按"要做什么"选别名。

> **2026-09-11 晚**：裸引擎 `qwen3.8:27b` / `qwen3.6:35b-a3b` **零注入**。作词、caption、简谱、封面视觉简报、TTS 口播稿打裸名 + 调用方 system，不再被 mill「内容引擎」叠一层。产品名 `clavue-2.1` / `clavue-2.1-fast` / `tools-clean` 仍注 mill。小说 / 画图 / 音乐 / TTS 别名继续 `prompt: null`。

## 在哪可用

| 入口 | Base URL | 说明 |
|---|---|---|
| 集群（内网/隧道） | `http://192.168.2.100:11401/v1` | 源头，29 个别名全量在位 |
| 公网·ttkk | `https://ttkk.inping.com/v1` | New API 直连集群，**16 个 clavue-3 别名**已可用 |
| 公网·ttqq | `https://ttqq.inping.com/v1` | New API 中转 ttkk，同 16 个别名 |
| 内网别名手册 | `http://192.168.2.100:8099/clavue-alias-playbook/` | playbook HTML |

三处 API 用法完全一致（OpenAI 兼容 `POST /v1/chat/completions`），换 Base URL 即可迁移。

## 谁会叠系统提示词

| model | 注入 | 用途 |
|---|---|---|
| 裸 `qwen3.8:27b` / `qwen3.6:35b-a3b` | **无** | 作词、caption、简谱、封面 brief、TTS 稿；调用方自带 system |
| `clavue-3-novel` / `*-novel-edit` / `clavue-3-judge` / `*-raw` | **无** | 小说写手/编辑/判官/探底 |
| `clavue-img-*` / `clavue-mus-*` / `clavue-tts-*` | **无** | 图/曲/语音只做路由，不拼风格预设 |
| `clavue-3-seo` / `geo` / `chat` / `wiki` / `code` 等 | 有 | 品牌 + 领域任务规则。不要拿来写词 |
| `clavue-2.1` / `clavue-2.1-fast` / `tools-clean` | 有 mill | 产品人设。不要拿来写词 / brief |

## 快速开始

```bash
# 小说：自带写手 system（无注入）
curl -sS https://ttkk.inping.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" -H 'Content-Type: application/json' \
  -d '{"model":"clavue-3-novel","messages":[{"role":"system","content":"你是连载小说写手，只输出正文，不写章名与作者注。"},{"role":"user","content":"写一个第一章开头，主角是修表匠。"}]}'

# 作词：裸 35b + 自己的作词 system（零注入）
curl -sS https://ttkk.inping.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" -H 'Content-Type: application/json' \
  -d '{"model":"qwen3.6:35b-a3b","messages":[{"role":"system","content":"你是这首歌的作词家。只输出歌词。"},{"role":"user","content":"写四句副歌，主题雨夜码头。"}]}'
```

ttqq 用户把 Base URL 换成 `https://ttqq.inping.com/v1`，其余不变。

## 选别名

**内容生产（clavue-3-*，快线 qwen3.6:35b-a3b，ctx 32k）**

| 别名 | 领域 |
|---|---|
| `clavue-3-novel` | 连载小说正文（**无注入**，system 由调用方自带） |
| `clavue-3-novel-edit` | 文学编辑（**无注入**） |
| `clavue-3-manhua` | 条漫分镜与漫画脚本 |
| `clavue-3-film` | 电影/短剧剧情与剧本 |
| `clavue-3-content` | 内容规划 |
| `clavue-3-seo` | SEO 文章与 SEO 标题 |
| `clavue-3-geo` | GEO 内容 |
| `clavue-3-title` | 标题族谱 |
| `clavue-3-chat` | 陪伴/客服式多轮聊天 |
| `clavue-3-wiki` | 百科/词条 |
| `clavue-3-travel` | 旅游行程、攻略 |
| `clavue-3-teach` | 教学讲解 |
| `clavue-3-medical` | 医疗健康信息（非诊疗） |
| `clavue-3-industry` | 工业/制造业文案 |

**无注入**：`clavue-3-judge`、`clavue-3-raw`、`clavue-2-raw`、`clavue-img-*`、`clavue-mus-*`、`clavue-tts-*`。

ttkk / ttqq 当前上线 16 个 clavue-3 别名。质量线 clavue-2-* 与 `clavue-2.1` 在集群可用。

## 怎么用得对

1. **注入别名**：不要再叠一套同名人设。**小说线无注入**，必须自己给写手/编辑 system。
2. **作词 / caption / 封面 brief / TTS 稿**：打裸 27b/35b，自己给 system。不要用 `clavue-3-chat` 或 `clavue-2.1-fast`。
3. **判官用 `clavue-3-judge`**，只回 JSON。
4. **超时**：短轮 60s；长文 ≥ 180s。流式可用。
5. **品牌与语言**只约束仍注入的别名。null 别名和裸引擎由调用方 system 自己管。

## 验证

```bash
# 裸 35b 无 system → 通义/助手，不是「内容引擎」
# 裸 35b + 作词 system → 「我是这首歌的作词家」
# clavue-3-chat → 「我是 Clavue」（注入线未关）
```

## 运维备忘

- 链路：客户端 → New API → 集群 11401 → 30081 shim（唯一注入点）→ vLLM。
- 注册表：`/opt/clavue-alias-registry.json` + `/opt/clavue-prompts/`（29 别名）。
- 裸引擎零注入脚本备份：`/opt/packing_http10_buffer.py.bak-20260911-bare-clean`。
- 内网手册：`http://192.168.2.100:8099/clavue-alias-playbook/`（含 `docs/CREATIVE-CLEAN.md`）。