feat: add fs-backend service

2026-07-29 10:07:13 +08:00
parent 59a1b5e4d4
commit a4e4e5b0db
12 changed files with 915 additions and 0 deletions
@@ -0,0 +1,68 @@
+# OpenCode Backend
+
+基于 Python + FastAPI 的后端服务项目
+
+## 项目结构
+
+```
+OpenCode-backend/
+├── app/
+│   ├── __init__.py
+│   ├── main.py              # 应用主入口
+│   ├── core/                # 核心配置
+│   │   ├── __init__.py
+│   │   └── config.py        # 应用配置
+│   ├── routers/             # 路由模块
+│   │   ├── __init__.py
+│   │   └── fs.py            # 文件系统路由
+│   └── schemas/             # Pydantic 模式
+│       ├── __init__.py
+│       └── project.py       # 项目相关模式
+├── requirements.txt
+└── README.md
+```
+
+## 快速开始
+
+### 1. 安装依赖
+
+```bash
+pip install -r requirements.txt
+```
+
+### 2. 启动服务
+
+```bash
+uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
+```
+
+### 3. 访问 API 文档
+
+启动后访问：http://localhost:8000/docs
+
+## API 接口
+
+### 创建项目
+
+**接口：** `POST /fs/project/create`
+
+**请求体：**
+```json
+{
+  "project_name": "我的项目"
+}
+```
+
+**响应：**
+```json
+{
+  "success": true,
+  "message": "项目 '我的项目' 创建成功",
+  "project_path": "/root/workspace/我的项目"
+}
+```
+
+**校验规则：**
+- 项目名称仅允许：中英文、数字、下划线 (_)、横杠 (-)
+- 禁止包含路径逃逸字符：`../`、`/`、`\`
+- 所有项目被锁定在 `/root/workspace` 目录内