# idea-light

**Repository Path**: chearnee/idea-light

## Basic Information

- **Project Name**: idea-light
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Idea Light

基于 FastAPI 的 Claude Code 云端 HTTP 流式服务平台。

## 项目简介

Idea Light 是一个为 Claude Code 设计的云端 HTTP 流式服务后端，支持多模型切换、多轮对话会话管理、Skill 技能版本控制等功能。

## 技术栈

- **框架**: FastAPI
- **数据库**: SQLite
- **API 协议**: HTTP + Server-Sent Events (SSE)

## 核心功能

### 1. 查询接口 (`/query`)

- 单次同步查询
- 流式响应支持

### 2. 会话管理 (`/sessions`)

- 创建会话
- 发送消息
- 获取会话事件
- 关闭会话

### 3. 模型管理 (`/models`)

- 列出可用模型和提供商
- 设置用户模型配置

### 4. Skill 技能管理 (`/skills`)

- 创建、读取、更新、删除技能
- 技能导入/导出
- 版本历史与回滚

## 支持的 LLM 提供商

- OpenAI (`gpt-4`, `gpt-4o` 等)
- Anthropic (`claude-3-5-sonnet-20241022` 等)
- Google Gemini
- 自定义兼容 OpenAI API 的提供商

## 安装部署

### 本地开发

```bash
# 安装依赖
pip install -r requirements.txt

# 启动服务
python run.py
```

服务默认运行在 `http://localhost:8765`

### Docker 部署

```bash
docker build -t idea-light -f claude-code-scripts/Dockerfile .
docker run -p 8765:8765 idea-light
```

## API 接口文档

启动服务后访问 `http://localhost:8765/docs` 查看完整的 Swagger 文档。

## 项目结构

```
claude-code-scripts/
├── app/
│   ├── main.py              # FastAPI 应用入口
│   ├── models/
│   │   └── schemas.py      # Pydantic 数据模型
│   ├── providers/         # LLM 提供商适配层
│   │   ├── base.py
│   │   ├── openai_provider.py
│   │   ├── anthropic_provider.py
│   │   ├── google_provider.py
│   │   └── custom_provider.py
│   ├── routers/           # API 路由
│   │   ├── health.py
│   │   ├── query.py
│   │   ├── sessions.py
│   │   ├── models.py
│   │   └── skills.py
│   └── services/         # 业务逻辑服务
│       ├── agent_service.py
│       ├── llm_router.py
│       ├── session_service.py
│       └── skill_service.py
├── data/                # 数据库文件
│   ├── models.db
│   └── skills.db
└── run.py               # 启动脚本
```

## 配置说明

主要配置通过环境变量或配置文件管理：

- `API_KEY`: LLM 服务 API 密钥
- `BASE_URL`: 自定义 API 端点
- 数据库文件位于 `data/` 目录下