# Skill Factory 技术库

> **配置模板**：请根据你自己的 AI 服务填写具体的密钥和地址。
> 此文件包含 API 密钥等敏感信息，请勿提交到公开仓库。

---

## 使用说明

skill-factory 运行时会读取此文件获取 AI 服务的 API 配置。

**配置规则**：
- 所有服务统一使用 OpenAI 兼容格式
- 不同密钥对应不同模型族，按密钥分组配置
- 调用时根据任务类型选择对应的密钥 + 模型组合
- 选择逻辑详见 `call-guide.md` 的场景-AI 对照表

---

## 统一入口

| 配置项 | 值 |
|--------|-----|
| 主力站 | `https://<你的主力API地址>` |
| 主力 endpoint | `https://<你的主力API地址>/v1/chat/completions` |
| 备用站 | `https://<你的备用API地址>`（可选） |
| 备用 endpoint | `https://<你的备用API地址>/v1/chat/completions` |
| 协议 | OpenAI 兼容格式 |

---

## 密钥与模型配置

### 1. GPT 系列

| 配置项 | 值 |
|--------|-----|
| api_key | `<你的GPT系列API密钥>` |
| max_tokens | `4096` |
| temperature | `0.7` |

**可用模型（示例）**：

| 模型 | 类型 | 适用场景 |
|------|------|---------|
| `gpt-4o` | 通用 | 长文写作、内容生成 |
| `gpt-4o-mini` | 轻量 | 快速草稿、翻译 |
| `codex` | 代码 | 代码生成、重构 |

---

### 2. Google Gemini

| 配置项 | 值 |
|--------|-----|
| api_key | `<你的Gemini API密钥>` |
| max_tokens | `4096` |
| temperature | `0.7` |

**可用模型（示例）**：

| 模型 | 类型 | 适用场景 |
|------|------|---------|
| `gemini-pro` | 深度 | 深度推理、素材分析 |
| `gemini-flash` | 快速 | 快速生成、摘要 |

---

### 3. Claude 系列

| 配置项 | 值 |
|--------|-----|
| api_key | `<你的Claude API密钥>` |
| max_tokens | `4096` |
| temperature | `0.7` |

**可用模型（示例）**：

| 模型 | 类型 | 适用场景 |
|------|------|---------|
| `claude-sonnet` | 通用 | 写作、分析 |
| `claude-opus` | 旗舰 | 最高质量输出 |
| `claude-sonnet-thinking` | 思考链 | 复杂推理 |

---

### 4. 降级保险（Fallback）

| 配置项 | 值 |
|--------|-----|
| 执行方式 | AI 自身（无需 API） |
| 备注 | 所有外部 AI 都不可用时，直接在上下文中完成任务 |

---

## 默认降级链

```
任务进来 → 根据 call-guide.md 场景表选择密钥+模型
│
├─ 首选组合调用成功 → 返回结果
└─ 首选失败（连续2次）→ 降级到同组备选模型
    └─ 仍失败 → 降级到其他密钥组的对应模型
        └─ 全部失败 → AI 自身执行
```

**降级路径示例**：
- 写作任务：主力 GPT → 备用 GPT → Gemini → AI 自身
- 素材整理：主力 Gemini → 备用 Gemini → AI 自身
- 代码任务：Codex → 备用代码模型 → AI 自身
- 高质量输出：Claude 首选 → Claude 备选 → AI 自身

---

## 配置状态总览

| 密钥组 | 角色 | 状态 | 最后验证时间 |
|--------|------|------|------------|
| GPT 系列 | 写作/代码主力 | 待配置 | - |
| Google Gemini | 深度研究/备用 | 待配置 | - |
| Claude 系列 | 高质量输出 | 待配置 | - |
| AI 自身 | Fallback | 始终可用 | - |

> 每次配置新 key 后，运行一次验证调用并更新此表。