# nowcoding

**Repository Path**: xusuai/nowcoding

## Basic Information

- **Project Name**: nowcoding
- **Description**: 快兔算力代码创作与展示平台：在线代码编辑器、作品榜单、AI 对话助手，纯单文件架构零框架依赖
- **Primary Language**: HTML
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NowCoding - 快兔算力代码创作与展示平台

一个轻量级的在线代码创作与展示平台：内置 AI 对话助手，支持代码编辑、语法高亮、实时预览、多设备模拟和一键分享。

## ✨ 功能特性

- **代码编辑器**：支持多语言语法高亮，内置 HTML/CSS/JS 编辑
- **实时预览**：编辑代码后自动渲染预览结果
- **设备模拟**：桌面 / 平板 / 手机多端预览
- **一键分享**：生成分享链接，快速展示你的代码片段
- **AI 对话助手**：内置大模型聊天，自然语言描述即可生成代码
- **作品榜单**：浏览和发现社区创作的项目
- **简洁界面**：现代化 UI 设计，响应式布局，支持移动端
- **零依赖部署**：基于 Python 标准库，无需安装任何第三方依赖

## 🚀 快速部署

### 方式一：直接运行

```bash
python3 server.py
```

直接运行默认监听 `127.0.0.1:3000`；生产环境由 systemd 以 `SHOWCODE_PORT=13000` 启动（监听 `127.0.0.1:13000`），由 nginx 反代对外提供服务。

### 方式二：一键部署脚本（推荐）

```bash
sudo ./deploy.sh
```

自动完成 nginx 配置软链、reload 和启动后端，一条命令搞定。

## 📁 项目结构

```
nowcoding/
├── index.html               # 首页 - 快兔算力导航页
├── ui.html            # 主应用 - 代码编辑器与展示界面
├── quota.html               # 我的算力额度（占位页）
├── guide.html               # 算力接入指南（占位页）
├── server.py                # Python 后端（标准库，处理 /api/save）
├── projects/                # 保存的作品落盘目录（自动创建）
├── nginx.nowcoding.conf     # nginx 站点配置（新服务器一键软链）
├── deploy.sh                # 全功能部署/运维脚本（见下表）
├── README.md                # 项目说明（中文）
├── README.en.md             # 项目说明（英文）
└── README.zh.md             # 项目说明（中文备份）
```

## 🔁 迁移到新服务器（标准流程）

业务代码与 nginx 完全解耦：nginx 只做反向代理和静态服务，所有业务逻辑写在 `server.py` 里。
新机器只要装 nginx + Python，把本文件夹拷过去就能跑：

```bash
# 1) 目标服务器：装标准 nginx 和 Python
sudo apt update && sudo apt install -y nginx python3

# 2) 把整个 nowcoding/ 目录拷到目标服务器（路径随意，例如 /opt/nowcoding）
sudo mkdir -p /opt && sudo cp -r nowcoding /opt/

# 3) 进目录跑一键部署脚本
cd /opt/nowcoding && sudo ./deploy.sh
```

`deploy.sh` 子命令（systemd 单元、启停脚本都合并进来）：

| 命令 | 用途 |
|------|------|
| `sudo ./deploy.sh` | 完整部署：软链 nginx 配置 + reload + 启动后端 |
| `sudo ./deploy.sh start` / `stop` / `restart` / `status` | 后端运维 |
| `sudo ./deploy.sh service` | 安装为 systemd 开机自启服务（不需单独 .service 文件）|

### 调端口/目录

只需改 `nginx.nowcoding.conf` 两处：

- `root /nowcoding;` → 改成实际目录
- `proxy_pass http://127.0.0.1:13000/api/;` → 后端端口（生产 13000，与 deploy.sh 的 PORT 保持一致）

后端代码默认端口 3000（环境变量 `SHOWCODE_PORT`/`SHOWCODE_BIND` 可调），生产 systemd 配置为 13000；改端口时同步改 `nginx.nowcoding.conf` 里 `proxy_pass` 的端口。

## 🔧 技术栈

- **前端**: HTML + CSS + JavaScript（原生，无框架依赖）
- **后端**: Python 标准库 http.server
- **部署**: systemd（支持开机自启）

## 📝 配置说明

### 修改端口

通过环境变量修改端口与监听地址（不设置时默认 `SHOWCODE_PORT=3000` / `SHOWCODE_BIND=127.0.0.1`；生产 systemd 已配置为 `SHOWCODE_PORT=13000`）：

```bash
SHOWCODE_PORT=13000 SHOWCODE_BIND=127.0.0.1 python3 server.py
```

### Nginx 反向代理（可选）

```nginx
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:13000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

## 📄 许可证

MIT License