# aigcpanel-server-dev-skill

**Repository Path**: modstart-lib/aigcpanel-server-dev-skill

## Basic Information

- **Project Name**: aigcpanel-server-dev-skill
- **Description**: AIGCPanel AI模型 开发技能
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-06
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# aigcpanel-server-dev 技能

AIGCPanel 模型服务开发技能，用于引导用户从零开发 AIGCPanel 平台的自定义 AI 模型服务（模型服务器）。

## 技能用途

当用户需要以下能力时，加载本技能：

- 🆕 **从零开发模型服务**：创建工程目录、`config.json`、`run.py`、`requirements.txt`
- ⚙️ **配置服务端**：`config.json` 的服务名称/版本/平台/入口/功能列表/`mode.type = watch` 队列模式
- 🔌 **开发任务处理**：`appPrepare` → `while watchNext()` 队列循环 → 按 `modelConfig.type` 分发 → `result` 输出
- 📚 **使用基础库**：`aigcpanelserver.py`（官方 `_aigcpanel.lib` 的轻量自包含复刻）全部接口速查
- 🧪 **测试与调试**：单次模式（`*.example.json`）、队列模式（`aigcpanel-queue/` 投递）、结果协议校验
- 🚀 **接入真实模型**：循环外加载重模型、替换模拟推理、环境依赖、发布到 AIGCPanel

## 覆盖内容

| 模块 | 说明 |
|------|------|
| 工程目录结构 | `run.py` + `aigcpanelserver.py` + `config.json` + `example-config/` + `tests/` |
| config.json 服务端配置 | name/version/platform/mode/entry/launcher/functions/settings 全字段说明 |
| 任务配置格式 | `id` / `mode` / `modelConfig.type` / `modelConfig.param` 结构 |
| 队列模式原理 | 首次返回启动配置 → 轮询 `aigcpanel-queue/*.queue.json` → 空闲超时退出 |
| 基础库接口 | `appPrepare` / `watchNext` / `result` / `resultEnd` / `resultEnv` / `urlForResult` / `localCache` / `filterText` / `end` 等 |
| 功能类型接入 | soundTts / soundClone / asr / videoGen / textToImage / imageToImage / textToVideo / imageToVideo |
| 结果输出协议 | `AigcPanelRunResult[id][base64]` 供 launcher/UI 解析 |
| 测试调试 | `tests/single.py`、`tests/queue.py`、`AIGCPANEL_SERVER_DEBUG` 调试日志 |
| 最佳实践 | 模型加载一次、结果走缓存目录、远程输入先缓存、SDK 无缝替换 |

## 文件结构

```
aigcpanel-server-dev/
├── SKILL.md           # 技能核心指令：开发流程、配置参考、接口速查、最佳实践
├── README.md          # 本文件：技能说明
└── aigcpanelserver.py # 基础库参考：官方 _aigcpanel.lib 的轻量自包含复刻版
```

## 使用方法

在会话中描述 AIGCPanel 模型服务开发需求，AI 将按 SKILL.md 中的「开发流程模板」引导：

1. 明确模型需求（功能类型、输入输出、平台设备、推理方式）
2. 创建工程骨架（参考 `aigcpanel-server-demo`，复制 `aigcpanelserver.py` 作基础库）
3. 配置 `config.json`（服务信息、`functions`、`mode.type = watch` 队列模式）
4. 开发 `run.py` 并用 `*.example.json` 单次模式验证
5. 队列联调（启动常驻服务 → 投递 `aigcpanel-queue/` 任务 → 校验结果）
6. 接入真实模型（循环外加载 → 替换模拟推理 → 建环境 → 导入 AIGCPanel 发布）

## 关联资源

- 参考工程：`aigcpanel-server-demo`（本技能文档与基础库均源自该工程）
- 基础库：`aigcpanelserver.py`（函数名/签名与官方 `_aigcpanel.lib` 一致，开发调试期使用，上线可无缝替换为官方包）