# html-editor-service-go

**Repository Path**: devqiaoyu/html-editor-service-go

## Basic Information

- **Project Name**: html-editor-service-go
- **Description**: 一个基于 Go 语言的高性能 HTML 编辑器服务，提供安全、直观的可视化编辑体验。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-26
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HTML Editor Service

一个基于 Go 语言的高性能 HTML 编辑器服务，提供安全、直观的可视化编辑体验。

## 功能特性

- ✅ 自动扫描并列出指定目录中的HTML文件
- ⚠️ 文本编辑模式（可视化编辑模式开发中）
- ✅ 支持手动刷新文件列表
- ✅ 修改后立即保存到原始文件
- ✅ 响应式设计，支持移动端

## 快速开始

### 本地运行

```bash
# 克隆项目
git clone <repository-url>
cd html-editor-service-go

# 安装依赖
go mod download

# 运行应用
go run cmd/main.go
```

### Docker 运行

```bash
# 构建镜像
docker build -t html-editor-service-go .

# 运行容器
docker run -p 3000:3000 -v $(pwd)/html-files:/app/html-files html-editor-service-go
```

## 项目结构

```
├── cmd/
│   └── main.go              # 应用入口
├── internal/
│   ├── api/                 # API 处理器
│   ├── configs/            # 配置管理
│   ├── models/             # 数据模型
│   └── security/           # 安全处理
├── web/
│   ├── static/             # 静态资源
│   └── templates/          # HTML 模板
├── html-files/             # HTML 文件目录（用户内容）
├── Dockerfile              # Docker 构建文件
├── go.mod                  # Go 模块定义
└── AGENTS.md               # 开发者指南
```

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/health` | 健康检查 |
| GET | `/api/files` | 获取HTML文件列表 |
| POST | `/api/files/content` | 读取文件内容 |
| POST | `/api/files/save` | 保存文件 |

## 环境变量

| 变量 | 默认值 | 说明 |
|------|--------|------|
| `HOST` | `0.0.0.0` | 服务器地址 |
| `PORT` | `3000` | 服务器端口 |
| `HTML_DIR` | `./html-files` | HTML 文件目录 |
| `GIN_MODE` | `release` | 运行模式 |

## 开发指南

详细的开发指南请参考 [AGENTS.md](./AGENTS.md)。

## 许可证

MIT License